1dpkg-gencontrol(1) dpkg suite dpkg-gencontrol(1)
2
6 dpkg-gencontrol - generate Debian control files
7
9 dpkg-gencontrol [option...]
10
12 dpkg-gencontrol reads information from an unpacked Debian source tree
13 and generates a binary package control file (which defaults to
14 debian/tmp/DEBIAN/control); during this process it will simplify the
15 relation fields.
16 Thus Pre-Depends, Depends, Recommends and Suggests are simplified in
18 this order by removing dependencies which are known to be true
19 according to the stronger dependencies already parsed. It will also
20 remove any self-dependency (in fact it will remove any dependency which
21 evaluates to true given the current version of the package as
22 installed). Logically it keeps the intersection of multiple
23 dependencies on the same package. The order of dependencies is
24 preserved as best as possible: if any dependency must be discarded due
25 to another dependency appearing further in the field, the superseding
26 dependency will take the place of the discarded one.
27 The other relation fields (Enhances, Conflicts, Breaks, Replaces and
29 Provides) are also simplified individually by computing the union of
30 the various dependencies when a package is listed multiple times in the
31 field.
32 dpkg-gencontrol also adds an entry for the binary package to
34 debian/files.
35
37 -vversion
38 Sets the version number of the binary package which will be
39 generated.
40 -Vname=value
42 Set an output substitution variable. See deb-substvars(5) for
43 discussion of output substitution.
44 -Tsubstvars-file
46 Read substitution variables in substvars-file; the default is
47 debian/substvars. This option can be used multiple times to
48 read substitution variables from multiple files (since dpkg
49 1.15.6).
50 -Dfield=value
52 Override or add an output control file field.
53 -Ufield
55 Remove an output control file field.
56 -ccontrol-file
58 Specifies the main source control file to read information from.
59 The default is debian/control.
60 -lchangelog-file
62 Specifies the changelog file to read information from. The
63 default is debian/changelog.
64 -ffiles-list-file
66 Read or write the list of files to be uploaded here, rather than
67 using debian/files.
68 -Fchangelog-format
70 Specifies the format of the changelog. See
71 dpkg-parsechangelog(1) for information about alternative
72 formats.
73 -ppackage
75 Generate information for the binary package package. If the
76 source control file lists only one binary package then this
77 option may be omitted; otherwise it is essential to select which
78 binary package's information to generate.
79 -nfilename
81 Assume the filename of the package will be filename instead of
82 the normal package_version_arch.deb filename.
83 -is, -ip, -isp
85 These options are ignored for compatibility with older versions
86 of the dpkg build scripts but are now deprecated. Previously
87 they were used to tell dpkg-gencontrol to include the Section
88 and Priority fields in the control file. This is now the default
89 behaviour. If you want to get the old behaviour you can use the
90 -U option to delete the fields from the control file.
91 -Ppackage-build-dir
93 Tells dpkg-source that the package is being built in package-
94 build-dir instead of debian/tmp. This value is used to find the
95 default value of the Installed-Size substitution variable and
96 control file field (using du), and for the default location of
97 the output file.
98 -O[filename]
100 Print the control file to standard output (or filename if
101 specified, since dpkg 1.17.2), rather than to
102 debian/tmp/DEBIAN/control (or package-build-dir/DEBIAN/control
103 if -P was used).
104 -?, --help
106 Show the usage message and exit.
107 --version
109 Show the version and exit.
110
112 DPKG_COLORS
113 Sets the color mode (since dpkg 1.18.5). The currently accepted
114 values are: auto (default), always and never.
115 DPKG_NLS
117 If set, it will be used to decide whether to activate Native
118 Language Support, also known as internationalization (or i18n)
119 support (since dpkg 1.19.0). The accepted values are: 0 and 1
120 (default).
121
123 debian/control
124 The main source control information file, giving version-
125 independent information about the source package and the binary
126 packages it can produce.
127 debian/files
129 The list of generated files which are part of the upload being
130 prepared. dpkg-gencontrol adds the presumed filenames of binary
131 packages whose control files it generates here.
132
134 deb-substvars(5), deb-src-control(5), deb-changelog(5), deb-control(5).
1351.19.7 2019-06-03 dpkg-gencontrol(1)