1dpkg-gencontrol(1)                dpkg suite                dpkg-gencontrol(1)
2
3
4

NAME

6       dpkg-gencontrol - generate Debian control files
7

SYNOPSIS

9       dpkg-gencontrol [option...]
10

DESCRIPTION

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
17       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
28       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
33       dpkg-gencontrol also adds an entry for the binary package to
34       debian/files.
35

OPTIONS

37       -vversion
38           Sets the version number of the binary package which will be
39           generated.
40
41       -Vname=value
42           Set an output substitution variable. See deb-substvars(5) for
43           discussion of output substitution.
44
45       -Tsubstvars-file
46           Read substitution variables in substvars-file; the default is
47           debian/substvars.  This option can be used multiple times to read
48           substitution variables from multiple files (since dpkg 1.15.6).
49
50       -Dfield=value
51           Override or add an output control file field.
52
53       -Ufield
54           Remove an output control file field.
55
56       -ccontrol-file
57           Specifies the main source control file to read information from.
58           The default is debian/control.
59
60       -lchangelog-file
61           Specifies the changelog file to read information from. The default
62           is debian/changelog.
63
64       -ffiles-list-file
65           Read or write the list of files to be uploaded here, rather than
66           using debian/files.
67
68       -Fchangelog-format
69           Specifies the format of the changelog. See dpkg-parsechangelog(1)
70           for information about alternative formats.
71
72       -ppackage
73           Generate information for the binary package package.  If the source
74           control file lists only one binary package then this option may be
75           omitted; otherwise it is essential to select which binary package's
76           information to generate.
77
78       -nfilename
79           Assume the filename of the package will be filename instead of the
80           normal package_version_arch.deb filename.
81
82       -is, -ip, -isp
83           These options are ignored for compatibility with older versions of
84           the dpkg build scripts but are now deprecated. Previously they were
85           used to tell dpkg-gencontrol to include the Section and Priority
86           fields in the control file. This is now the default behaviour. If
87           you want to get the old behaviour you can use the -U option to
88           delete the fields from the control file.
89
90       -Ppackage-build-dir
91           Scan package-build-dir instead of debian/tmp.  This value is used
92           to find the default value of the Installed-Size substitution
93           variable and control file field, and for the default location of
94           the output file.
95
96       -O[filename]
97           Print the control file to standard output (or filename if
98           specified, since dpkg 1.17.2), rather than to
99           debian/tmp/DEBIAN/control (or package-build-dir/DEBIAN/control if
100           -P was used).
101
102       -?, --help
103           Show the usage message and exit.
104
105       --version
106           Show the version and exit.
107

ENVIRONMENT

109       DPKG_COLORS
110           Sets the color mode (since dpkg 1.18.5).  The currently accepted
111           values are: auto (default), always and never.
112
113       DPKG_NLS
114           If set, it will be used to decide whether to activate Native
115           Language Support, also known as internationalization (or i18n)
116           support (since dpkg 1.19.0).  The accepted values are: 0 and 1
117           (default).
118

FILES

120       debian/control
121           The main source control information file, giving version-
122           independent information about the source package and the binary
123           packages it can produce.
124
125       debian/files
126           The list of generated files which are part of the upload being
127           prepared.  dpkg-gencontrol adds the presumed filenames of binary
128           packages whose control files it generates here.
129

SEE ALSO

131       deb-substvars(5), deb-src-control(5), deb-changelog(5), deb-control(5).
132
133
134
1351.21.21                           2023-02-25                dpkg-gencontrol(1)
Impressum