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
48              read  substitution  variables  from  multiple  files (since dpkg
49              1.15.6).
50
51       -Dfield=value
52              Override or add an output control file field.
53
54       -Ufield
55              Remove an output control file field.
56
57       -ccontrol-file
58              Specifies the main source control file to read information from.
59              The default is debian/control.
60
61       -lchangelog-file
62              Specifies  the  changelog  file  to  read  information from. The
63              default is debian/changelog.
64
65       -ffiles-list-file
66              Read or write the list of files to be uploaded here, rather than
67              using debian/files.
68
69       -Fchangelog-format
70              Specifies     the     format     of     the    changelog.    See
71              dpkg-parsechangelog(1)   for   information   about   alternative
72              formats.
73
74       -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
80       -nfilename
81              Assume the filename of the package will be filename  instead  of
82              the normal package_version_arch.deb filename.
83
84       -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
92       -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
99       -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
105       -?, --help
106              Show the usage message and exit.
107
108       --version
109              Show the version and exit.
110

FILES

112       debian/control
113              The  main  source  control  information  file,  giving  version-
114              independent information about the source package and the  binary
115              packages it can produce.
116
117       debian/files
118              The  list  of generated files which are part of the upload being
119              prepared.  dpkg-gencontrol adds the presumed filenames of binary
120              packages whose control files it generates here.
121

SEE ALSO

123       deb-substvars(5), deb-src-control(5), deb-changelog(5), deb-control(5).
124
125
126
1271.18.25                           2018-06-26                dpkg-gencontrol(1)
Impressum