summaryrefslogtreecommitdiffstats
path: root/man/dpkg-genbuildinfo.pod
blob: f7b3e5323fe8ca56aeb93e81fe5327a240073154 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
# dpkg manual page - dpkg-genbuildinfo(1)
#
# Copyright © 1995-1996 Ian Jackson <ian@chiark.chu.cam.ac.uk>
# Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
# Copyright © 2008-2010 Raphaël Hertzog <hertzog@debian.org>
# Copyright © 2006-2016 Guillem Jover <guillem@debian.org>
# Copyright © 2015 Jérémy Bobbio <lunar@debian.org>
#
# This is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

=encoding utf8

=head1 NAME

dpkg-genbuildinfo - generate Debian .buildinfo files

=head1 SYNOPSIS

B<dpkg-genbuildinfo>
[I<option>...]

=head1 DESCRIPTION

B<dpkg-genbuildinfo>
reads information from an unpacked and built Debian source tree and
from the files it has generated and generates a Debian control
file describing the build environment and the build artifacts
(B<.buildinfo> file).

This program was introduced in dpkg 1.18.11.

=head1 OPTIONS

=over

=item B<--build=>I<type>

Specifies the build I<type> from a comma-separated list of components.

The allowed values are:

=over

=item B<any>

Generate build information including unqualified build dependencies
(B<Build-Depends>) and architecture specific build dependencies
(B<Build-Depends-Arch>).

=item B<all>

Generate build information including unqualified build dependencies
(B<Build-Depends>) and architecture independent build dependencies
(B<Build-Depends-Indep>).

=item B<source>

Effectively ignored; generate build information with just the unqualified
build dependencies (B<Build-Depends>).

=item B<binary>

Generate build information with all three types of build dependencies.
This is an alias for B<any,all>.

=item B<full>

Generate build information with all three types of build dependencies.
This is an alias for B<any,all,source>, and the same as the default
case when no build option is specified.

=back

=item B<-c>I<controlfile>

Specifies the main source control file to read information from.
The
default is
B<debian/control>.

=item B<-l>I<changelog-file>

Specifies the changelog file to read information from.
The
default is
B<debian/changelog>.

=item B<-f>I<files-list-file>

Specifies where is the list of files that have been produced by the build,
rather than using
B<debian/files>.

=item B<-F>I<changelog-format>

Specifies the format of the changelog.
See L<dpkg-parsechangelog(1)>
for information about alternative formats.

=item B<-O>[I<filename>]

Print the buildinfo file to standard output (or I<filename> if specified)
rather than to
I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo>
(where I<dir> is B<..> by default or I<upload-files-dir>
if B<-u> was used).

=item B<-u>I<upload-files-dir>

Look for the files to be uploaded in
I<upload-files-dir>
rather than
B<..>
(B<dpkg-genbuildinfo> needs to find these files so that it can include
their sizes and checksums in the B<.buildinfo> file).

=item B<--always-include-kernel>

By default, the B<Build-Kernel-Version> field will not be written out.

Specify this option (since dpkg 1.19.0) to always write a
B<Build-Kernel-Version> field when generating the B<.buildinfo>.

=item B<--always-include-path>

By default, the B<Build-Path> field will only be written if the current
directory starts with an allowed pattern.

On Debian and derivatives the pattern matches on B</build/> at the start
of the pathname.

Specify this option to always write a B<Build-Path> field when generating
the B<.buildinfo>.

=item B<--admindir=>I<dir>

Change the location of the B<dpkg> database.
The default location is
I</var/lib/dpkg>.

=item B<-q>

B<dpkg-genbuildinfo>
might produce informative messages on standard error.
B<-q>
suppresses these messages.

=item B<-?>, B<--help>

Show the usage message and exit.

=item B<--version>

Show the version and exit.

=back

=head1 ENVIRONMENT

=over

=item B<DEB_BUILD_OPTIONS>

This variable can be used to enable or disable various features that affect
the information included in the .buildinfo file, via the B<buildinfo>
option (since dpkg 1.18.19).
This option contains a comma-separated list of features, prefixed with the
‘B<+>’ or ‘B<->’ modifiers, to denote whether to enable or disable
them.
The special feature “B<all>” can be used to enable or disable all other
features.
The feature “B<path>” controls whether to unconditionally include the
B<Build-Path> field.

=item B<DEB_BUILD_ARCH>

Sets the build architecture.
This affects the value for the B<Build-Architecture> field,
and the check for the cross-compilation mode.

=item B<DEB_HOST_ARCH>

Sets the host architecture.
This affects the filename used for the .buildinfo file,
and the check for the cross-compilation mode.

=item B<DPKG_COLORS>

Sets the color mode (since dpkg 1.18.5).
The currently accepted values are: B<auto> (default), B<always> and
B<never>.

=item B<DPKG_NLS>

If set, it will be used to decide whether to activate Native Language Support,
also known as internationalization (or i18n) support (since dpkg 1.19.0).
The accepted values are: B<0> and B<1> (default).

=back

=head1 FILES

=over

=item B<debian/files>

The list of generated files.
B<dpkg-genbuildinfo>
reads the data here when producing a
B<.buildinfo>
file.

=back

=head1 SEE ALSO

L<deb-buildinfo(5)>.