dpkg (1.18.25) stretch; urgency=medium
[dpkg] / man / po / dpkg-man.pot
CommitLineData
1479465f
GJ
1# SOME DESCRIPTIVE TITLE
2# Copyright (C) YEAR Dpkg Developers
3# This file is distributed under the same license as the dpkg-man package.
4# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5#
6#, fuzzy
7msgid ""
8msgstr ""
9"Project-Id-Version: dpkg-man 1.18.25\n"
10"Report-Msgid-Bugs-To: debian-dpkg@lists.debian.org\n"
11"POT-Creation-Date: 2018-06-26 10:10+0000\n"
12"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14"Language-Team: LANGUAGE <LL@li.org>\n"
15"Language: \n"
16"MIME-Version: 1.0\n"
17"Content-Type: text/plain; charset=UTF-8\n"
18"Content-Transfer-Encoding: 8bit\n"
19
20#. type: TH
21#: deb.man:1
22#, no-wrap
23msgid "deb"
24msgstr ""
25
26#. type: TH
27#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
28#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
29#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
30#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
31#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
32#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
33#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
34#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
35#: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
36#: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
37#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
38#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
39#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
40#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
41#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
42#: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
43#, no-wrap
44msgid "%RELEASE_DATE%"
45msgstr ""
46
47#. type: TH
48#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
49#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
50#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
51#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
52#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
53#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
54#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
55#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
56#: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
57#: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
58#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
59#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
60#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
61#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
62#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
63#: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
64#, no-wrap
65msgid "%VERSION%"
66msgstr ""
67
68#. type: TH
69#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
70#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
71#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
72#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
73#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
74#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
75#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
76#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
77#: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
78#: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
79#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
80#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
81#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
82#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
83#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
84#: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
85#, no-wrap
86msgid "dpkg suite"
87msgstr ""
88
89#. type: SH
90#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
91#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
92#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
93#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
94#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
95#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
96#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
97#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
98#: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
99#: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
100#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
101#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
102#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
103#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
104#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
105#: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
106#, no-wrap
107msgid "NAME"
108msgstr ""
109
110#. type: Plain text
111#: deb.man:1
112msgid "deb - Debian binary package format"
113msgstr ""
114
115#. type: SH
116#: deb.man:1 deb-buildinfo.man:1 deb-changelog.man:1 deb-changes.man:1
117#: deb-control.man:1 deb-conffiles.man:1 deb-src-control.man:1
118#: deb-src-files.man:1 deb-split.man:1 deb-version.man:1 deb-old.man:1
119#: deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
120#: deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1 deb-postrm.man:1
121#: deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1 dsc.man:1 dpkg.man:1
122#: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
123#: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
124#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
125#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
126#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
127#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
128#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
129#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
130#: start-stop-daemon.man:1 update-alternatives.man:1
131#, no-wrap
132msgid "SYNOPSIS"
133msgstr ""
134
135#. type: Plain text
136#: deb.man:1 deb-split.man:1 deb-old.man:1
137msgid "I<filename>B<.deb>"
138msgstr ""
139
140#. type: SH
141#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
142#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
143#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
144#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
145#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
146#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
147#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
148#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
149#: dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1 dpkg-deb.man:1
150#: dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
151#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1
152#: dpkg-mergechangelogs.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
153#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-scansources.man:1
154#: dpkg-shlibdeps.man:1 dpkg-source.man:1 dpkg-split.man:1
155#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
156#: dselect.cfg.man:1 start-stop-daemon.man:1 update-alternatives.man:1
157#, no-wrap
158msgid "DESCRIPTION"
159msgstr ""
160
161#. type: Plain text
162#: deb.man:1
163msgid ""
164"The B<.deb> format is the Debian binary package file format. It is "
165"understood since dpkg 0.93.76, and is generated by default since dpkg 1.2.0 "
166"and 1.1.1elf (i386/ELF builds)."
167msgstr ""
168
169#. type: Plain text
170#: deb.man:1
171msgid ""
172"The format described here is used since Debian 0.93; details of the old "
173"format are described in B<deb-old>(5)."
174msgstr ""
175
176#. type: SH
177#: deb.man:1 deb-split.man:1 deb-old.man:1
178#, no-wrap
179msgid "FORMAT"
180msgstr ""
181
182#. type: Plain text
183#: deb.man:1
184msgid ""
185"The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. Only "
186"the common B<ar> archive format is supported, with no long file name "
187"extensions, but with file names containing an optional trailing slash, which "
188"limits their length to 15 characters (from the 16 allowed). File sizes are "
189"limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 "
190"MiB member files."
191msgstr ""
192
193#. type: Plain text
194#: deb.man:1
195msgid ""
196"The B<tar> archives currently allowed are, the old-style (v7) format, the "
197"pre-POSIX ustar format, a subset of the GNU format (new style long pathnames "
198"and long linknames, supported since dpkg 1.4.1.17; large file metadata since "
199"dpkg 1.18.24), and the POSIX ustar format (long names supported since dpkg "
200"1.15.0). Unrecognized tar typeflags are considered an error. Each tar "
201"entry size inside a tar archive is limited to 11 ASCII octal digits, "
202"allowing for up to 8 GiB tar entries. The GNU large file metadata support "
203"permits 95-bit tar entry sizes and negative timestamps, and 63-bit UID, GID "
204"and device numbers."
205msgstr ""
206
207#. type: Plain text
208#: deb.man:1
209msgid ""
210"The first member is named B<debian-binary> and contains a series of lines, "
211"separated by newlines. Currently only one line is present, the format "
212"version number, B<2.0> at the time this manual page was written. Programs "
213"which read new-format archives should be prepared for the minor number to be "
214"increased and new lines to be present, and should ignore these if this is "
215"the case."
216msgstr ""
217
218#. type: Plain text
219#: deb.man:1
220msgid ""
221"If the major number has changed, an incompatible change has been made and "
222"the program should stop. If it has not, then the program should be able to "
223"safely continue, unless it encounters an unexpected member in the archive "
224"(except at the end), as described below."
225msgstr ""
226
227#. type: Plain text
228#: deb.man:1
229msgid ""
230"The second required member is named B<control.tar>. It is a tar archive "
231"containing the package control information, either not compressed (supported "
232"since dpkg 1.17.6), or compressed with gzip (with B<.gz> extension) or xz "
233"(with B<.xz> extension, supported since 1.17.6), as a series of plain files, "
234"of which the file B<control> is mandatory and contains the core control "
235"information, the B<conffiles>, B<triggers>, B<shlibs> and B<symbols> files "
236"contain optional control information, and the B<preinst>, B<postinst>, "
237"B<prerm> and B<postrm> files are optional maintainer scripts. The control "
238"tarball may optionally contain an entry for ‘B<.>’, the current directory."
239msgstr ""
240
241#. type: Plain text
242#: deb.man:1
243msgid ""
244"The third, last required member is named B<data.tar>. It contains the "
245"filesystem as a tar archive, either not compressed (supported since dpkg "
246"1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> "
247"extension, supported since dpkg 1.15.6), bzip2 (with B<.bz2> extension, "
248"supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported "
249"since dpkg 1.13.25)."
250msgstr ""
251
252#. type: Plain text
253#: deb.man:1
254msgid ""
255"These members must occur in this exact order. Current implementations should "
256"ignore any additional members after B<data.tar>. Further members may be "
257"defined in the future, and (if possible) will be placed after these "
258"three. Any additional members that may need to be inserted after "
259"B<debian-binary> and before B<control.tar> or B<data.tar> and which should "
260"be safely ignored by older programs, will have names starting with an "
261"underscore, ‘B<_>’."
262msgstr ""
263
264#. type: Plain text
265#: deb.man:1
266msgid ""
267"Those new members which won't be able to be safely ignored will be inserted "
268"before B<data.tar> with names starting with something other than "
269"underscores, or will (more likely) cause the major version number to be "
270"increased."
271msgstr ""
272
273#. type: SH
274#: deb.man:1
275#, no-wrap
276msgid "MEDIA TYPE"
277msgstr ""
278
279#. type: SS
280#: deb.man:1
281#, no-wrap
282msgid "Current"
283msgstr ""
284
285#. type: Plain text
286#: deb.man:1
287msgid "application/vnd.debian.binary-package"
288msgstr ""
289
290#. type: SS
291#: deb.man:1
292#, no-wrap
293msgid "Deprecated"
294msgstr ""
295
296#. type: Plain text
297#: deb.man:1
298msgid "application/x-debian-package"
299msgstr ""
300
301#. type: Plain text
302#: deb.man:1
303msgid "application/x-deb"
304msgstr ""
305
306#. type: SH
307#: deb.man:1 deb822.man:1 deb-buildinfo.man:1 deb-changelog.man:1
308#: deb-changes.man:1 deb-control.man:1 deb-conffiles.man:1
309#: deb-src-control.man:1 deb-src-files.man:1 deb-split.man:1 deb-version.man:1
310#: deb-old.man:1 deb-origin.man:1 deb-override.man:1 deb-extra-override.man:1
311#: deb-shlibs.man:1 deb-substvars.man:1 deb-symbols.man:1 deb-postinst.man:1
312#: deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1 deb-triggers.man:1
313#: dsc.man:1 dpkg.man:1 dpkg-architecture.man:1 dpkg.cfg.man:1
314#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1
315#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
316#: dpkg-gensymbols.man:1 dpkg-maintscript-helper.man:1 dpkg-name.man:1
317#: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
318#: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
319#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
320#: dpkg-vendor.man:1 dselect.man:1 dselect.cfg.man:1 update-alternatives.man:1
321#, no-wrap
322msgid "SEE ALSO"
323msgstr ""
324
325#. type: Plain text
326#: deb.man:1
327msgid ""
328"B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5), B<deb-conffiles>(5) "
329"B<deb-triggers>(5), B<deb-shlibs>(5), B<deb-symbols>(5), B<deb-preinst>(5), "
330"B<deb-postinst>(5), B<deb-prerm>(5), B<deb-postrm>(5)."
331msgstr ""
332
333#. type: TH
334#: deb822.man:1
335#, no-wrap
336msgid "deb822"
337msgstr ""
338
339#. type: Plain text
340#: deb822.man:1
341msgid "deb822 - Debian RFC822 control data format"
342msgstr ""
343
344#. type: Plain text
345#: deb822.man:1
346msgid ""
347"The package management system manipulates data represented in a common "
348"format, known as I<control data>, stored in I<control files>. Control files "
349"are used for source packages, binary packages and the B<.changes> files "
350"which control the installation of uploaded files (B<dpkg>'s internal "
351"databases are in a similar format)."
352msgstr ""
353
354#. type: SH
355#: deb822.man:1
356#, no-wrap
357msgid "SYNTAX"
358msgstr ""
359
360#. type: Plain text
361#: deb822.man:1
362msgid ""
363"A control file consists of one or more paragraphs of fields (the paragraphs "
364"are also sometimes referred to as stanzas). The paragraphs are separated by "
365"empty lines. Parsers may accept lines consisting solely of U+0020 B<SPACE> "
366"and U+0009 B<TAB> as paragraph separators, but control files should use "
367"empty lines. Some control files allow only one paragraph; others allow "
368"several, in which case each paragraph usually refers to a different "
369"package. (For example, in source packages, the first paragraph refers to "
370"the source package, and later paragraphs refer to binary packages generated "
371"from the source.) The ordering of the paragraphs in control files is "
372"significant."
373msgstr ""
374
375#. type: Plain text
376#: deb822.man:1
377msgid ""
378"Each paragraph consists of a series of data fields. Each field consists of "
379"the field name followed by a colon (U+003A ‘B<:>’), and then the data/value "
380"associated with that field. The field name is composed of US-ASCII "
381"characters excluding control characters, space, and colon (i.e., characters "
382"in the ranges U+0021 ‘B<!>’ through U+0039 ‘B<9>’, and U+003B ‘B<;>’ through "
383"U+007E ‘B<~>’, inclusive). Field names must not begin with the comment "
384"character (U+0023 ‘B<#>’), nor with the hyphen character (U+002D ‘B<->’)."
385msgstr ""
386
387#. type: Plain text
388#: deb822.man:1
389msgid ""
390"The field ends at the end of the line or at the end of the last continuation "
391"line (see below). Horizontal whitespace (U+0020 B<SPACE> and U+0009 B<TAB>) "
392"may occur immediately before or after the value and is ignored there; it is "
393"conventional to put a single space after the colon. For example, a field "
394"might be:"
395msgstr ""
396
397#. type: Plain text
398#: deb822.man:1
399#, no-wrap
400msgid "Package: dpkg\n"
401msgstr ""
402
403#. type: Plain text
404#: deb822.man:1
405msgid "the field name is B<Package> and the field value B<dpkg>."
406msgstr ""
407
408#. type: Plain text
409#: deb822.man:1
410msgid ""
411"Empty field values are only permitted in source package control files "
412"(I<debian/control>). Such fields are ignored."
413msgstr ""
414
415#. type: Plain text
416#: deb822.man:1
417msgid ""
418"A paragraph must not contain more than one instance of a particular field "
419"name."
420msgstr ""
421
422#. type: Plain text
423#: deb822.man:1
424msgid "There are three types of fields:"
425msgstr ""
426
427#. type: TP
428#: deb822.man:1
429#, no-wrap
430msgid "B<simple>"
431msgstr ""
432
433#. type: Plain text
434#: deb822.man:1
435msgid ""
436"The field, including its value, must be a single line. Folding of the field "
437"is not permitted. This is the default field type if the definition of the "
438"field does not specify a different type."
439msgstr ""
440
441#. type: TP
442#: deb822.man:1
443#, no-wrap
444msgid "B<folded>"
445msgstr ""
446
447#. type: Plain text
448#: deb822.man:1
449msgid ""
450"The value of a folded field is a logical line that may span several lines. "
451"The lines after the first are called continuation lines and must start with "
452"a U+0020 B<SPACE> or a U+0009 B<TAB>. Whitespace, including any newlines, "
453"is not significant in the field values of folded fields."
454msgstr ""
455
456#. type: Plain text
457#: deb822.man:1
458msgid ""
459"This folding method is similar to RFC5322, allowing control files that "
460"contain only one paragraph and no multiline fields to be read by parsers "
461"written for RFC5322."
462msgstr ""
463
464#. type: TP
465#: deb822.man:1
466#, no-wrap
467msgid "B<multiline>"
468msgstr ""
469
470#. type: Plain text
471#: deb822.man:1
472msgid ""
473"The value of a multiline field may comprise multiple continuation lines. "
474"The first line of the value, the part on the same line as the field name, "
475"often has special significance or may have to be empty. Other lines are "
476"added following the same syntax as the continuation lines of the folded "
477"fields. Whitespace, including newlines, is significant in the values of "
478"multiline fields."
479msgstr ""
480
481#. type: Plain text
482#: deb822.man:1
483msgid ""
484"Whitespace must not appear inside names (of packages, architectures, files "
485"or anything else) or version numbers, or between the characters of "
486"multi-character version relationships."
487msgstr ""
488
489#. type: Plain text
490#: deb822.man:1
491msgid ""
492"The presence and purpose of a field, and the syntax of its value may differ "
493"between types of control files."
494msgstr ""
495
496#. type: Plain text
497#: deb822.man:1
498msgid ""
499"Field names are not case-sensitive, but it is usual to capitalize the field "
500"names using mixed case as shown below. Field values are case-sensitive "
501"unless the description of the field says otherwise."
502msgstr ""
503
504#. type: Plain text
505#: deb822.man:1
506msgid ""
507"Paragraph separators (empty lines) and lines consisting only of U+0020 "
508"B<SPACE> and U+0009 B<TAB>, are not allowed within field values or between "
509"fields. Empty lines in field values are usually escaped by representing "
510"them by a U+0020 B<SPACE> followed by a dot (U+002E ‘B<.>’)."
511msgstr ""
512
513#. type: Plain text
514#: deb822.man:1
515msgid ""
516"Lines starting with U+0023 ‘B<#>’, without any preceding whitespace are "
517"comments lines that are only permitted in source package control files "
518"(I<debian/control>) and in B<deb-origin>(5) files. These comment lines are "
519"ignored, even between two continuation lines. They do not end logical "
520"lines."
521msgstr ""
522
523#. type: Plain text
524#: deb822.man:1
525msgid "All control files must be encoded in UTF-8."
526msgstr ""
527
528#. type: Plain text
529#: deb822.man:1
530msgid "B<RFC822>, B<RFC5322>."
531msgstr ""
532
533#. type: TH
534#: deb-buildinfo.man:1
535#, no-wrap
536msgid "deb-buildinfo"
537msgstr ""
538
539#. type: Plain text
540#: deb-buildinfo.man:1
541msgid "deb-buildinfo - Debian build information file format"
542msgstr ""
543
544#. type: Plain text
545#: deb-buildinfo.man:1
546msgid "I<filename>B<.buildinfo>"
547msgstr ""
548
549#. type: Plain text
550#: deb-buildinfo.man:1
551msgid ""
552"Each Debian source package build can record the build information in a "
553"B<.buildinfo> control file, which contains a number of fields. Each field "
554"begins with a tag, such as B<Source> or B<Binary> (case insensitive), "
555"followed by a colon, and the body of the field. Fields are delimited only "
556"by field tags. In other words, field text may be multiple lines in length, "
557"but the installation tools will generally join lines when processing the "
558"body of the field (except in case of the multiline fields "
559"B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>, "
560"B<Checksums-Md5>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below)."
561msgstr ""
562
563#. type: Plain text
564#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
565msgid ""
566"The control data might be enclosed in an OpenPGP ASCII Armored signature, as "
567"specified in RFC4880."
568msgstr ""
569
570#. type: Plain text
571#: deb-buildinfo.man:1
572msgid ""
573"The name of the B<.buildinfo> file will depend on the type of build and will "
574"be as specific as necessary but not more; for a build that includes B<any> "
575"the name will be "
576"I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo>, or otherwise "
577"for a build that includes B<all> the name will be "
578"I<source-name>B<_>I<binary-version>B<_>B<all.buildinfo>, or otherwise for a "
579"build that includes B<source> the name will be "
580"I<source-name>B<_>I<source-version>B<_>B<source.buildinfo>."
581msgstr ""
582
583#. type: SH
584#: deb-buildinfo.man:1 deb-changes.man:1 deb-control.man:1 deb-origin.man:1
585#: dsc.man:1
586#, no-wrap
587msgid "FIELDS"
588msgstr ""
589
590#. type: TP
591#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
592#, no-wrap
593msgid "B<Format:> I<format-version> (required)"
594msgstr ""
595
596#. type: Plain text
597#: deb-buildinfo.man:1
598msgid ""
599"The value of this field declares the format version of the file. The syntax "
600"of the field value is a version number with a major and minor component. "
601"Backward incompatible changes to the format will bump the major version, and "
602"backward compatible changes (such as field additions) will bump the minor "
603"version. The current format version is B<1.0>."
604msgstr ""
605
606#. type: TP
607#: deb-buildinfo.man:1 deb-changes.man:1
608#, no-wrap
609msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)"
610msgstr ""
611
612#. type: Plain text
613#: deb-buildinfo.man:1
614msgid ""
615"The name of the source package. If the source version differs from the "
616"binary version, then the I<source-name> will be followed by a "
617"I<source-version> in parenthesis. This can happen when the build is for a "
618"binary-only non-maintainer upload."
619msgstr ""
620
621#. type: TP
622#: deb-buildinfo.man:1 deb-changes.man:1
623#, no-wrap
624msgid "B<Binary:> I<binary-package-list> (required)"
625msgstr ""
626
627#. type: Plain text
628#: deb-buildinfo.man:1
629msgid "This folded field is a space-separated list of binary packages built."
630msgstr ""
631
632#. type: TP
633#: deb-buildinfo.man:1
634#, no-wrap
635msgid "B<Architecture:> I<arch-list> (required)"
636msgstr ""
637
638#. type: Plain text
639#: deb-buildinfo.man:1
640msgid ""
641"This space-separated field lists the architectures of the files currently "
642"being built. Common architectures are B<amd64>, B<armel>, B<i386>, etc. "
643"Note that the B<all> value is meant for packages that are architecture "
644"independent. If the source for the package is also being built, the special "
645"entry B<source> is also present. Architecture wildcards must never be "
646"present in the list."
647msgstr ""
648
649#. type: TP
650#: deb-buildinfo.man:1 deb-changes.man:1 deb-control.man:1 dsc.man:1
651#, no-wrap
652msgid "B<Version:> I<version-string> (required)"
653msgstr ""
654
655#. type: Plain text
656#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
657msgid ""
658"Typically, this is the original package's version number in whatever form "
659"the program's author uses. It may also include a Debian revision number "
660"(for non-native packages). The exact format and sorting algorithm are "
661"described in B<deb-version>(5)."
662msgstr ""
663
664#. type: TP
665#: deb-buildinfo.man:1
666#, no-wrap
667msgid "B<Binary-Only-Changes:>"
668msgstr ""
669
670#. type: TQ
671#: deb-buildinfo.man:1
672#, no-wrap
673msgid "I<changelog-entry>"
674msgstr ""
675
676#. type: Plain text
677#: deb-buildinfo.man:1
678msgid ""
679"This multiline field contains the concatenated text of the changelog entry "
680"for a binary-only non-maintainer upload (binNMU) if that is the case. To "
681"make this a valid multiline field empty lines are replaced with a single "
682"full stop (‘.’) and all lines are indented by one space character. The "
683"exact content depends on the changelog format."
684msgstr ""
685
686#. type: TP
687#: deb-buildinfo.man:1
688#, no-wrap
689msgid "B<Checksums-Md5:> (required)"
690msgstr ""
691
692#. type: TQ
693#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
694#, no-wrap
695msgid "B<Checksums-Sha1:> (required)"
696msgstr ""
697
698#. type: TQ
699#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
700#, no-wrap
701msgid "B<Checksums-Sha256:> (required)"
702msgstr ""
703
704#. type: TQ
705#: deb-buildinfo.man:1 deb-changes.man:1 dsc.man:1
706#, no-wrap
707msgid " I<checksum> I<size> I<filename>"
708msgstr ""
709
710#. type: Plain text
711#: deb-buildinfo.man:1
712msgid ""
713"These multiline fields contain a list of files with a checksum and size for "
714"each one. These fields have the same syntax and differ only in the checksum "
715"algorithm used: MD5 for B<Checksums-Md5>, SHA-1 for B<Checksums-Sha1> and "
716"SHA-256 for B<Checksums-Sha256>."
717msgstr ""
718
719#. type: Plain text
720#: deb-buildinfo.man:1 deb-changes.man:1
721msgid ""
722"The first line of the field value (the part on the same line as the field "
723"name followed by a colon) is always empty. The content of the field is "
724"expressed as continuation lines, one line per file. Each line consists of "
725"space-separated entries describing the file: the checksum, the file size, "
726"and the file name."
727msgstr ""
728
729#. type: Plain text
730#: deb-buildinfo.man:1
731msgid "These fields list all files that make up the build."
732msgstr ""
733
734#. type: TP
735#: deb-buildinfo.man:1
736#, no-wrap
737msgid "B<Build-Origin:> I<name>"
738msgstr ""
739
740#. type: Plain text
741#: deb-buildinfo.man:1 deb-control.man:1 dsc.man:1
742msgid "The name of the distribution this package is originating from."
743msgstr ""
744
745#. type: TP
746#: deb-buildinfo.man:1
747#, no-wrap
748msgid "B<Build-Architecture:> I<arch> (required)"
749msgstr ""
750
751#. type: Plain text
752#: deb-buildinfo.man:1
753msgid ""
754"The Debian architecture for the installation the packages is being built "
755"in. Common architectures are B<amd64>, B<armel>, B<i386>, etc."
756msgstr ""
757
758#. type: TP
759#: deb-buildinfo.man:1
760#, no-wrap
761msgid "B<Build-Date:> I<build-date>"
762msgstr ""
763
764#. type: Plain text
765#: deb-buildinfo.man:1
766msgid ""
767"The date the package was built. It must be in the same format as the date "
768"in a B<deb-changelog>(5) entry."
769msgstr ""
770
771#. type: TP
772#: deb-buildinfo.man:1
773#, no-wrap
774msgid "B<Build-Path:> I<build-path>"
775msgstr ""
776
777#. type: Plain text
778#: deb-buildinfo.man:1
779msgid ""
780"The absolute build path, which correspond to the unpacked source tree. This "
781"field is only going to be present if the vendor has whitelisted it via some "
782"pattern match to avoid leaking possibly sensitive information."
783msgstr ""
784
785#. type: Plain text
786#: deb-buildinfo.man:1
787msgid ""
788"On Debian and derivatives only build paths starting with I</build/> will "
789"emit this field."
790msgstr ""
791
792#. type: TP
793#: deb-buildinfo.man:1
794#, no-wrap
795msgid "B<Installed-Build-Depends:> (required)"
796msgstr ""
797
798#. type: TQ
799#: deb-buildinfo.man:1
800#, no-wrap
801msgid "I<package-list>"
802msgstr ""
803
804#. type: Plain text
805#: deb-buildinfo.man:1
806msgid ""
807"The list of installed and configured packages that might affect the package "
808"build process."
809msgstr ""
810
811#. type: Plain text
812#: deb-buildinfo.man:1
813msgid ""
814"The list consists of each package name, optionally arch-qualified for "
815"foreign architectures, with an exact version restriction, separated by "
816"commas."
817msgstr ""
818
819#. type: Plain text
820#: deb-buildinfo.man:1
821msgid ""
822"The list includes all essential packages, packages listed in "
823"B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> source "
824"control fields, any vendor specific builtin dependencies, and all their "
825"recursive dependencies. On Debian and derivatives the dependency builtin is "
826"B<build-essential>."
827msgstr ""
828
829#. type: Plain text
830#: deb-buildinfo.man:1
831msgid ""
832"For dependencies coming from the source control fields, all dependency "
833"alternatives and all providers of virtual packages depended on will be "
834"included."
835msgstr ""
836
837#. type: TP
838#: deb-buildinfo.man:1
839#, no-wrap
840msgid "B<Environment:>"
841msgstr ""
842
843#. type: TQ
844#: deb-buildinfo.man:1
845#, no-wrap
846msgid "I<variable-list>"
847msgstr ""
848
849#. type: Plain text
850#: deb-buildinfo.man:1
851msgid ""
852"The list of environment variables that are known to affect the package build "
853"process, with each environment variable followed by an equal sign (‘=’) and "
854"the variable's quoted value, using double quotes (‘\"’), and backslashes "
855"escaped (‘\\e\\e’)."
856msgstr ""
857
858#. type: Plain text
859#: deb-buildinfo.man:1
860msgid "B<deb-changes>(5), B<deb-version>(5), B<dpkg-genbuildinfo>(1)."
861msgstr ""
862
863#. type: TH
864#: deb-changelog.man:1
865#, no-wrap
866msgid "deb-changelog"
867msgstr ""
868
869#. type: Plain text
870#: deb-changelog.man:1
871msgid "deb-changelog - dpkg source packages' changelog file format"
872msgstr ""
873
874#. type: Plain text
875#: deb-changelog.man:1
876msgid "changelog"
877msgstr ""
878
879#. type: Plain text
880#: deb-changelog.man:1
881msgid ""
882"Changes in the packaged version of a project are explained in the changelog "
883"file I<debian/changelog>. This includes modifications made in the source "
884"package compared to the upstream one as well as other changes and updates to "
885"the package."
886msgstr ""
887
888#. type: Plain text
889#: deb-changelog.man:1
890msgid ""
891"The format of the I<debian/changelog> allows the package building tools to "
892"discover which version of the package is being built and find out other "
893"release-specific information."
894msgstr ""
895
896#. type: Plain text
897#: deb-changelog.man:1
898msgid "That format is a series of entries like this:"
899msgstr ""
900
901#. type: Plain text
902#: deb-changelog.man:1
903#, no-wrap
904msgid ""
905"I<package> (I<version>) I<distributions>; I<metadata>\n"
906" [optional blank line(s), stripped]\n"
907" * I<change-details>\n"
908" I<more-change-details>\n"
909" [blank line(s), included in output of B<dpkg-parsechangelog>(1)]\n"
910" * I<even-more-change-details>\n"
911" [optional blank line(s), stripped]\n"
912" -- I<maintainer-name> E<lt>I<email-address>E<gt> I<date>\n"
913msgstr ""
914
915#. type: Plain text
916#: deb-changelog.man:1
917msgid "I<package> and I<version> are the source package name and version number."
918msgstr ""
919
920#. type: Plain text
921#: deb-changelog.man:1
922msgid ""
923"I<distributions> lists one or more space-separated distributions where this "
924"version should be installed when it is uploaded; it is copied to the "
925"B<Distribution> field in the I<.changes> file."
926msgstr ""
927
928#. type: Plain text
929#: deb-changelog.man:1
930msgid ""
931"I<metadata> is a comma-separated list of I<keyword>=I<value> items. The "
932"only I<keyword>s currently supported by B<dpkg> are B<urgency> and "
933"B<binary-only>. B<urgency>'s value is used for the B<Urgency> field in the "
934"I<.changes> file for the upload. B<binary-only> with a B<yes> value, is "
935"used to denote that this changelog entry is for a binary-only non-maintainer "
936"upload (an automatic binary rebuild with the only change being the changelog "
937"entry)."
938msgstr ""
939
940#. type: Plain text
941#: deb-changelog.man:1
942msgid ""
943"The change details may in fact be any series of lines starting with at least "
944"two spaces, but conventionally each change starts with an asterisk and a "
945"separating space and continuation lines are indented so as to bring them in "
946"line with the start of the text above. Blank lines may be used here to "
947"separate groups of changes, if desired."
948msgstr ""
949
950#. type: Plain text
951#: deb-changelog.man:1
952msgid ""
953"If this upload resolves bugs recorded in the distribution bug tracking "
954"system, they may be automatically closed on the inclusion of this package "
955"into the distribution archive by including the string:"
956msgstr ""
957
958#. type: Plain text
959#: deb-changelog.man:1
960#, no-wrap
961msgid " B<Closes: Bug#>I<nnnnn>\n"
962msgstr ""
963
964#. type: Plain text
965#: deb-changelog.man:1
966msgid ""
967"in the change details (the exact Perl regular expression is "
968"B</closes:\\es*(?:bug)?\\e#?\\es?\\ed+(?:,\\es*(?:bug)?\\e#?\\es?\\ed+)*/i>). "
969"This information is conveyed via the B<Closes> field in the I<.changes> "
970"file."
971msgstr ""
972
973#. type: Plain text
974#: deb-changelog.man:1
975msgid ""
976"The maintainer name and email address used in the changelog should be the "
977"details of the person who prepared this release of the package. They are "
978"B<not> necessarily those of the uploader or usual package maintainer. The "
979"information here will be copied to the B<Changed-By> field in the "
980"I<.changes> file, and then later might be used to send an acknowledgement "
981"when the upload has been installed in the distribution archive."
982msgstr ""
983
984#. type: Plain text
985#: deb-changelog.man:1
986msgid ""
987"The I<date> has the following format (compatible and with the same semantics "
988"of RFC2822 and RFC5322, or what «date -R» generates):"
989msgstr ""
990
991#. type: Plain text
992#: deb-changelog.man:1
993msgid ""
994"I<day-of-week>B<,> I<dd> I<month> I<yyyy> I<hh>B<:>I<mm>B<:>I<ss> "
995"B<+>I<zzzz>"
996msgstr ""
997
998#. type: Plain text
999#: deb-changelog.man:1
1000msgid "where:"
1001msgstr ""
1002
1003#. type: TP
1004#: deb-changelog.man:1
1005#, no-wrap
1006msgid "I<day-of-week>"
1007msgstr ""
1008
1009#. type: Plain text
1010#: deb-changelog.man:1
1011msgid "Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>."
1012msgstr ""
1013
1014#. type: TP
1015#: deb-changelog.man:1
1016#, no-wrap
1017msgid "I<dd>"
1018msgstr ""
1019
1020#. type: Plain text
1021#: deb-changelog.man:1
1022msgid "Is a one- or two-digit day of the month (B<01>-B<31>)."
1023msgstr ""
1024
1025#. type: TP
1026#: deb-changelog.man:1
1027#, no-wrap
1028msgid "I<month>"
1029msgstr ""
1030
1031#. type: Plain text
1032#: deb-changelog.man:1
1033msgid ""
1034"Is one of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, "
1035"B<Sep>, B<Oct>, B<Nov>, B<Dec>."
1036msgstr ""
1037
1038#. type: TP
1039#: deb-changelog.man:1
1040#, no-wrap
1041msgid "I<yyyy>"
1042msgstr ""
1043
1044#. type: Plain text
1045#: deb-changelog.man:1
1046msgid "Is the four-digit year (e.g. 2010)."
1047msgstr ""
1048
1049#. type: TP
1050#: deb-changelog.man:1
1051#, no-wrap
1052msgid "I<hh>"
1053msgstr ""
1054
1055#. type: Plain text
1056#: deb-changelog.man:1
1057msgid "Is the two-digit hour (B<00>-B<23>)."
1058msgstr ""
1059
1060#. type: TP
1061#: deb-changelog.man:1
1062#, no-wrap
1063msgid "I<mm>"
1064msgstr ""
1065
1066#. type: Plain text
1067#: deb-changelog.man:1
1068msgid "Is the two-digit minutes (B<00>-B<59>)."
1069msgstr ""
1070
1071#. type: TP
1072#: deb-changelog.man:1
1073#, no-wrap
1074msgid "I<ss>"
1075msgstr ""
1076
1077#. type: Plain text
1078#: deb-changelog.man:1
1079msgid "Is the two-digit seconds (B<00>-B<60>)."
1080msgstr ""
1081
1082#. type: TP
1083#: deb-changelog.man:1
1084#, no-wrap
1085msgid "[B<+->]I<zzzz>"
1086msgstr ""
1087
1088#. type: Plain text
1089#: deb-changelog.man:1
1090msgid ""
1091"Is the time zone offset from Coordinated Universal Time (UTC). ‘B<+>’ "
1092"indicates that the time is ahead of (i.e., east of) UTC and ‘B<->’ indicates "
1093"that the time is behind (i.e., west of) UTC. The first two digits indicate "
1094"the hour difference from UTC and the last two digits indicate the number of "
1095"additional minutes difference from UTC. The last two digits must be in the "
1096"range B<00>-B<59>."
1097msgstr ""
1098
1099#. type: Plain text
1100#: deb-changelog.man:1
1101msgid ""
1102"The first “title” line with the package name must start at the left hand "
1103"margin. The “trailer” line with the maintainer and date details must be "
1104"preceded by exactly one space. The maintainer details and the date must be "
1105"separated by exactly two spaces."
1106msgstr ""
1107
1108#. type: Plain text
1109#: deb-changelog.man:1
1110msgid "The entire changelog must be encoded in UTF-8."
1111msgstr ""
1112
1113#. type: SH
1114#: deb-changelog.man:1 deb-substvars.man:1 dpkg.man:1 dpkg-architecture.man:1
1115#: dpkg.cfg.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
1116#: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-divert.man:1
1117#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-parsechangelog.man:1
1118#: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1 dselect.cfg.man:1
1119#: update-alternatives.man:1
1120#, no-wrap
1121msgid "FILES"
1122msgstr ""
1123
1124#. type: TP
1125#: deb-changelog.man:1
1126#, no-wrap
1127msgid "I<debian/changelog>"
1128msgstr ""
1129
1130#. type: SH
1131#: deb-changelog.man:1 deb-shlibs.man:1 deb-symbols.man:1 dpkg.man:1
1132#: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-divert.man:1
1133#: dpkg-name.man:1 update-alternatives.man:1
1134#, no-wrap
1135msgid "EXAMPLES"
1136msgstr ""
1137
1138#. type: Plain text
1139#: deb-changelog.man:1
1140#, no-wrap
1141msgid "dpkg (1.17.18) unstable; urgency=low\n"
1142msgstr ""
1143
1144#. type: Plain text
1145#: deb-changelog.man:1
1146#, no-wrap
1147msgid ""
1148" [ Guillem Jover ]\n"
1149" * Handle empty minimum versions when initializing dependency versions,\n"
1150" as the code is mapping the minimum version 0 to '' to avoid outputting\n"
1151" useless versions. Regression introduced in dpkg 1.17.17. Closes: "
1152"#764929\n"
1153msgstr ""
1154
1155#. type: Plain text
1156#: deb-changelog.man:1
1157#, no-wrap
1158msgid ""
1159" [ Updated programs translations ]\n"
1160" * Catalan (Guillem Jover).\n"
1161msgstr ""
1162
1163#. type: Plain text
1164#: deb-changelog.man:1
1165#, no-wrap
1166msgid ""
1167" [ Updated dselect translations ]\n"
1168" * Catalan (Guillem Jover).\n"
1169" * German (Sven Joachim).\n"
1170msgstr ""
1171
1172#. type: Plain text
1173#: deb-changelog.man:1
1174#, no-wrap
1175msgid ""
1176" -- Guillem Jover E<lt>guillem@debian.orgE<gt> Sun, 12 Oct 2014 15:47:44 "
1177"+0200\n"
1178msgstr ""
1179
1180#. type: Plain text
1181#: deb-changelog.man:1
1182msgid "B<deb-version>(5), B<deb-changes>(5), B<dpkg-parsechangelog>(1)."
1183msgstr ""
1184
1185#. type: TH
1186#: deb-changes.man:1
1187#, no-wrap
1188msgid "deb-changes"
1189msgstr ""
1190
1191#. type: Plain text
1192#: deb-changes.man:1
1193msgid "deb-changes - Debian changes file format"
1194msgstr ""
1195
1196#. type: Plain text
1197#: deb-changes.man:1
1198msgid "I<filename>B<.changes>"
1199msgstr ""
1200
1201#. type: Plain text
1202#: deb-changes.man:1
1203msgid ""
1204"Each Debian upload is composed of a .changes control file, which contains a "
1205"number of fields. Each field begins with a tag, such as B<Source> or "
1206"B<Binary> (case insensitive), followed by a colon, and the body of the "
1207"field. Fields are delimited only by field tags. In other words, field text "
1208"may be multiple lines in length, but the installation tools will generally "
1209"join lines when processing the body of the field (except in case of the "
1210"multiline fields B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> and "
1211"B<Checksums-Sha256>, see below)."
1212msgstr ""
1213
1214#. type: Plain text
1215#: deb-changes.man:1
1216msgid ""
1217"The value of this field declares the format version of the file. The syntax "
1218"of the field value is a version number with a major and minor component. "
1219"Backward incompatible changes to the format will bump the major version, and "
1220"backward compatible changes (such as field additions) will bump the minor "
1221"version. The current format version is B<1.8>."
1222msgstr ""
1223
1224#. type: TP
1225#: deb-changes.man:1
1226#, no-wrap
1227msgid "B<Date:> I<release-date> (required)"
1228msgstr ""
1229
1230#. type: Plain text
1231#: deb-changes.man:1
1232msgid ""
1233"The date the package was built or last edited. It must be in the same "
1234"format as the date in a B<deb-changelog>(5) entry."
1235msgstr ""
1236
1237#. type: Plain text
1238#: deb-changes.man:1
1239msgid ""
1240"The value of this field is usually extracted from the I<debian/changelog> "
1241"file."
1242msgstr ""
1243
1244#. type: Plain text
1245#: deb-changes.man:1
1246msgid ""
1247"The name of the source package. If the source version differs from the "
1248"binary version, then the I<source-name> will be followed by a "
1249"I<source-version> in parenthesis. This can happen when the upload is a "
1250"binary-only non-maintainer upload."
1251msgstr ""
1252
1253#. type: Plain text
1254#: deb-changes.man:1
1255msgid "This folded field is a space-separated list of binary packages to upload."
1256msgstr ""
1257
1258#. type: TP
1259#: deb-changes.man:1
1260#, no-wrap
1261msgid "B<Architecture:> I<arch-list>"
1262msgstr ""
1263
1264#. type: Plain text
1265#: deb-changes.man:1
1266msgid ""
1267"Lists the architectures of the files currently being uploaded. Common "
1268"architectures are B<amd64>, B<armel>, B<i386>, etc. Note that the B<all> "
1269"value is meant for packages that are architecture independent. If the "
1270"source for the package is also being uploaded, the special entry B<source> "
1271"is also present. Architecture wildcards must never be present in the list."
1272msgstr ""
1273
1274#. type: TP
1275#: deb-changes.man:1
1276#, no-wrap
1277msgid "B<Distribution:> I<distribution>s (required)"
1278msgstr ""
1279
1280#. type: Plain text
1281#: deb-changes.man:1
1282msgid ""
1283"Lists one or more space-separated distributions where this version should be "
1284"installed when it is uploaded to the archive."
1285msgstr ""
1286
1287#. type: TP
1288#: deb-changes.man:1
1289#, no-wrap
1290msgid "B<Urgency:> I<urgency> (recommended)"
1291msgstr ""
1292
1293#. type: Plain text
1294#: deb-changes.man:1
1295msgid ""
1296"The urgency of the upload. The currently known values, in increasing order "
1297"of urgency, are: B<low>, B<medium>, B<high>, B<critical> and B<emergency>."
1298msgstr ""
1299
1300#. type: TP
1301#: deb-changes.man:1
1302#, no-wrap
1303msgid "B<Maintainer:> I<fullname-email> (required)"
1304msgstr ""
1305
1306#. type: Plain text
1307#: deb-changes.man:1
1308msgid ""
1309"Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
1310"typically the person who created the package, as opposed to the author of "
1311"the software that was packaged."
1312msgstr ""
1313
1314#. type: TP
1315#: deb-changes.man:1
1316#, no-wrap
1317msgid "B<Changed-By:>I< fullname-email>"
1318msgstr ""
1319
1320#. type: Plain text
1321#: deb-changes.man:1
1322msgid ""
1323"Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
1324"typically the person who prepared the package changes for this release."
1325msgstr ""
1326
1327#. type: TP
1328#: deb-changes.man:1
1329#, no-wrap
1330msgid "B<Description:> (recommended)"
1331msgstr ""
1332
1333#. type: TQ
1334#: deb-changes.man:1
1335#, no-wrap
1336msgid " I<binary-package-name> B<-> I<binary-package-summary>"
1337msgstr ""
1338
1339#. type: Plain text
1340#: deb-changes.man:1
1341msgid ""
1342"This multiline field contains a list of binary package names followed by a "
1343"space, a dash (‘B<->’) and their possibly truncated short descriptions."
1344msgstr ""
1345
1346#. type: TP
1347#: deb-changes.man:1
1348#, no-wrap
1349msgid "B<Closes:>I< bug-number-list>"
1350msgstr ""
1351
1352#. type: Plain text
1353#: deb-changes.man:1
1354msgid ""
1355"A space-separated list of bug report numbers that have been resolved with "
1356"this upload. The distribution archive software might use this field to "
1357"automatically close the referred bug numbers in the distribution bug "
1358"tracking system."
1359msgstr ""
1360
1361#. type: TP
1362#: deb-changes.man:1
1363#, no-wrap
1364msgid "B<Binary-Only: yes>"
1365msgstr ""
1366
1367#. type: Plain text
1368#: deb-changes.man:1
1369msgid ""
1370"This field denotes that the upload is a binary-only non-maintainer build. "
1371"It originates from the B<binary-only=yes> key/value from the changelog "
1372"matadata entry."
1373msgstr ""
1374
1375#. type: TP
1376#: deb-changes.man:1
1377#, no-wrap
1378msgid "B<Built-For-Profiles:>I< profile-list>"
1379msgstr ""
1380
1381#. type: Plain text
1382#: deb-changes.man:1
1383msgid ""
1384"This field specifies a whitespace separated list of build profiles that this "
1385"upload was built with."
1386msgstr ""
1387
1388#. type: TP
1389#: deb-changes.man:1
1390#, no-wrap
1391msgid "B<Changes:> (required)"
1392msgstr ""
1393
1394#. type: TQ
1395#: deb-changes.man:1
1396#, no-wrap
1397msgid "I<changelog-entries>"
1398msgstr ""
1399
1400#. type: Plain text
1401#: deb-changes.man:1
1402msgid ""
1403"This multiline field contains the concatenated text of all changelog entries "
1404"that are part of the upload. To make this a valid multiline field empty "
1405"lines are replaced with a single full stop (‘.’) and all lines are indented "
1406"by one space character. The exact content depends on the changelog format."
1407msgstr ""
1408
1409#. type: TP
1410#: deb-changes.man:1 dsc.man:1
1411#, no-wrap
1412msgid "B<Files:> (required)"
1413msgstr ""
1414
1415#. type: TQ
1416#: deb-changes.man:1
1417#, no-wrap
1418msgid " I<md5sum> I<size> I<section> I<priority> I<filename>"
1419msgstr ""
1420
1421#. type: Plain text
1422#: deb-changes.man:1
1423msgid ""
1424"This multiline field contains a list of files with an md5sum, size, section "
1425"and priority for each one."
1426msgstr ""
1427
1428#. type: Plain text
1429#: deb-changes.man:1
1430msgid ""
1431"The first line of the field value (the part on the same line as the field "
1432"name followed by a colon) is always empty. The content of the field is "
1433"expressed as continuation lines, one line per file. Each line consists of "
1434"space-separated entries describing the file: the md5sum, the file size, the "
1435"file section, the file priority, and the file name."
1436msgstr ""
1437
1438#. type: Plain text
1439#: deb-changes.man:1
1440msgid ""
1441"This field lists all files that make up the upload. The list of files in "
1442"this field must match the list of files in the other related B<Checksums> "
1443"fields."
1444msgstr ""
1445
1446#. type: Plain text
1447#: deb-changes.man:1
1448msgid ""
1449"These multiline fields contain a list of files with a checksum and size for "
1450"each one. These fields have the same syntax and differ only in the checksum "
1451"algorithm used: SHA-1 for B<Checksums-Sha1> and SHA-256 for "
1452"B<Checksums-Sha256>."
1453msgstr ""
1454
1455#. type: Plain text
1456#: deb-changes.man:1
1457msgid ""
1458"These fields list all files that make up the upload. The list of files in "
1459"these fields must match the list of files in the B<Files> field and the "
1460"other related B<Checksums> fields."
1461msgstr ""
1462
1463#. type: SH
1464#: deb-changes.man:1 dsc.man:1 dpkg.man:1 dpkg-buildpackage.man:1
1465#: dpkg-deb.man:1 dpkg-name.man:1 dpkg-source.man:1 dpkg-split.man:1
1466#: dselect.man:1
1467#, no-wrap
1468msgid "BUGS"
1469msgstr ""
1470
1471#. type: Plain text
1472#: deb-changes.man:1
1473msgid ""
1474"The B<Files> field is inconsistent with the other B<Checksums> fields. The "
1475"B<Change-By> and B<Maintainer> fields have confusing names. The "
1476"B<Distribution> field contains information about what is commonly referred "
1477"to as a suite."
1478msgstr ""
1479
1480#. type: Plain text
1481#: deb-changes.man:1
1482msgid "B<deb-src-control>(5), B<deb-version>(5)."
1483msgstr ""
1484
1485#. type: TH
1486#: deb-control.man:1
1487#, no-wrap
1488msgid "deb-control"
1489msgstr ""
1490
1491#. type: Plain text
1492#: deb-control.man:1
1493msgid "deb-control - Debian binary packages' master control file format"
1494msgstr ""
1495
1496#. type: Plain text
1497#: deb-control.man:1
1498msgid "control"
1499msgstr ""
1500
1501#. type: Plain text
1502#: deb-control.man:1
1503msgid ""
1504"Each Debian binary package contains the master I<control> file, which "
1505"contains a number of fields. Each field begins with a tag, such as "
1506"B<Package> or B<Version> (case insensitive), followed by a colon, and the "
1507"body of the field. Fields are delimited only by field tags. In other words, "
1508"field text may be multiple lines in length, but the installation tools will "
1509"generally join lines when processing the body of the field (except in the "
1510"case of the B<Description> field, see below)."
1511msgstr ""
1512
1513#. type: TP
1514#: deb-control.man:1
1515#, no-wrap
1516msgid "B<Package:> I<package-name> (required)"
1517msgstr ""
1518
1519#. type: Plain text
1520#: deb-control.man:1 dsc.man:1
1521msgid ""
1522"The value of this field determines the package name, and is used to generate "
1523"file names by most installation tools."
1524msgstr ""
1525
1526#. type: Plain text
1527#: deb-control.man:1
1528msgid ""
1529"Typically, this is the original package's version number in whatever form "
1530"the program's author uses. It may also include a Debian revision number (for "
1531"non-native packages). The exact format and sorting algorithm are described "
1532"in B<deb-version>(5)."
1533msgstr ""
1534
1535#. type: TP
1536#: deb-control.man:1 deb-src-control.man:1 dsc.man:1
1537#, no-wrap
1538msgid "B<Maintainer:> I<fullname-email> (recommended)"
1539msgstr ""
1540
1541#. type: Plain text
1542#: deb-control.man:1 dsc.man:1
1543msgid ""
1544"Should be in the format “Joe Bloggs E<lt>jbloggs@foo.comE<gt>”, and is "
1545"typically the person who created the package, as opposed to the author of "
1546"the software that was packaged."
1547msgstr ""
1548
1549#. type: TQ
1550#: deb-control.man:1 deb-src-control.man:1
1551#, no-wrap
1552msgid "B<Description:> I<short-description> (recommended)"
1553msgstr ""
1554
1555#. type: TQ
1556#: deb-control.man:1
1557#, no-wrap
1558msgid "B< >I<long-description>"
1559msgstr ""
1560
1561#. type: Plain text
1562#: deb-control.man:1
1563msgid ""
1564"The format for the package description is a short brief summary on the first "
1565"line (after the B<Description> field). The following lines should be used as "
1566"a longer, more detailed description. Each line of the long description must "
1567"be preceded by a space, and blank lines in the long description must contain "
1568"a single ‘B<.>’ following the preceding space."
1569msgstr ""
1570
1571#. type: TP
1572#: deb-control.man:1 deb-src-control.man:1
1573#, no-wrap
1574msgid "B<Section:>I< section>"
1575msgstr ""
1576
1577#. type: Plain text
1578#: deb-control.man:1 deb-src-control.man:1
1579msgid ""
1580"This is a general field that gives the package a category based on the "
1581"software that it installs. Some common sections are B<utils>, B<net>, "
1582"B<mail>, B<text>, B<x11>, etc."
1583msgstr ""
1584
1585#. type: TP
1586#: deb-control.man:1 deb-src-control.man:1
1587#, no-wrap
1588msgid "B<Priority:>I< priority>"
1589msgstr ""
1590
1591#. type: Plain text
1592#: deb-control.man:1 deb-src-control.man:1
1593msgid ""
1594"Sets the importance of this package in relation to the system as a whole. "
1595"Common priorities are B<required>, B<standard>, B<optional>, B<extra>, etc."
1596msgstr ""
1597
1598#. type: Plain text
1599#: deb-control.man:1 deb-src-control.man:1
1600msgid ""
1601"The B<Section> and B<Priority> fields usually have a defined set of accepted "
1602"values based on the specific distribution policy."
1603msgstr ""
1604
1605#. type: TP
1606#: deb-control.man:1
1607#, no-wrap
1608msgid "B<Installed-Size:> size"
1609msgstr ""
1610
1611#. type: Plain text
1612#: deb-control.man:1
1613msgid "The approximate total size of the package's installed files, in KiB units."
1614msgstr ""
1615
1616#. type: TP
1617#: deb-control.man:1 deb-src-control.man:1
1618#, no-wrap
1619msgid "B<Essential:> B<yes>|B<no>"
1620msgstr ""
1621
1622#. type: Plain text
1623#: deb-control.man:1
1624msgid ""
1625"This field is usually only needed when the answer is B<yes>. It denotes a "
1626"package that is required for proper operation of the system. Dpkg or any "
1627"other installation tool will not allow an B<Essential> package to be removed "
1628"(at least not without using one of the force options)."
1629msgstr ""
1630
1631#. type: TQ
1632#: deb-control.man:1 deb-src-control.man:1
1633#, no-wrap
1634msgid "B<Build-Essential:> B<yes>|B<no>"
1635msgstr ""
1636
1637#. type: Plain text
1638#: deb-control.man:1
1639msgid ""
1640"This field is usually only needed when the answer is B<yes>, and is commonly "
1641"injected by the archive software. It denotes a package that is required "
1642"when building other packages."
1643msgstr ""
1644
1645#. type: TP
1646#: deb-control.man:1
1647#, no-wrap
1648msgid "B<Architecture:> I<arch>|B<all> (recommended)"
1649msgstr ""
1650
1651#. type: Plain text
1652#: deb-control.man:1
1653msgid ""
1654"The architecture specifies which type of hardware this package was compiled "
1655"for. Common architectures are B<amd64>, B<armel>, B<i386>, B<powerpc>, "
1656"etc. Note that the B<all> value is meant for packages that are architecture "
1657"independent. Some examples of this are shell and Perl scripts, and "
1658"documentation."
1659msgstr ""
1660
1661#. type: TP
1662#: deb-control.man:1 deb-src-control.man:1 dsc.man:1
1663#, no-wrap
1664msgid "B<Origin:>I< name>"
1665msgstr ""
1666
1667#. type: TP
1668#: deb-control.man:1 deb-src-control.man:1
1669#, no-wrap
1670msgid "B<Bugs:>I< url>"
1671msgstr ""
1672
1673#. type: Plain text
1674#: deb-control.man:1
1675msgid ""
1676"The I<url> of the bug tracking system for this package. The current used "
1677"format is I<bts-type>B<://>I<bts-address>, like "
1678"B<debbugs://bugs.debian.org>."
1679msgstr ""
1680
1681#. type: TP
1682#: deb-control.man:1 deb-src-control.man:1 dsc.man:1
1683#, no-wrap
1684msgid "B<Homepage:>I< url>"
1685msgstr ""
1686
1687#. type: Plain text
1688#: deb-control.man:1 dsc.man:1
1689msgid "The upstream project home page I<url>."
1690msgstr ""
1691
1692#. type: TQ
1693#: deb-control.man:1 deb-src-control.man:1
1694#, no-wrap
1695msgid "B<Tag:>I< tag-list>"
1696msgstr ""
1697
1698#. type: Plain text
1699#: deb-control.man:1
1700msgid ""
1701"List of tags describing the qualities of the package. The description and "
1702"list of supported tags can be found in the B<debtags> package."
1703msgstr ""
1704
1705#. type: TP
1706#: deb-control.man:1
1707#, no-wrap
1708msgid "B<Multi-Arch:> B<no>|B<same>|B<foreign>|B<allowed>"
1709msgstr ""
1710
1711#. type: Plain text
1712#: deb-control.man:1
1713msgid ""
1714"This field is used to indicate how this package should behave on a "
1715"multi-arch installations."
1716msgstr ""
1717
1718#. type: TP
1719#: deb-control.man:1
1720#, no-wrap
1721msgid "B<no>"
1722msgstr ""
1723
1724#. type: Plain text
1725#: deb-control.man:1
1726msgid ""
1727"This value is the default when the field is omitted, in which case adding "
1728"the field with an explicit B<no> value is generally not needed."
1729msgstr ""
1730
1731#. type: TP
1732#: deb-control.man:1
1733#, no-wrap
1734msgid "B<same>"
1735msgstr ""
1736
1737#. type: Plain text
1738#: deb-control.man:1
1739msgid ""
1740"This package is co-installable with itself, but it must not be used to "
1741"satisfy the dependency of any package of a different architecture from "
1742"itself."
1743msgstr ""
1744
1745#. type: TP
1746#: deb-control.man:1
1747#, no-wrap
1748msgid "B<foreign>"
1749msgstr ""
1750
1751#. type: Plain text
1752#: deb-control.man:1
1753msgid ""
1754"This package is not co-installable with itself, but should be allowed to "
1755"satisfy a non-arch-qualified dependency of a package of a different arch "
1756"from itself (if a dependency has an explicit arch-qualifier then the value "
1757"B<foreign> is ignored)."
1758msgstr ""
1759
1760#. type: TP
1761#: deb-control.man:1
1762#, no-wrap
1763msgid "B<allowed>"
1764msgstr ""
1765
1766#. type: Plain text
1767#: deb-control.man:1
1768msgid ""
1769"This allows reverse-dependencies to indicate in their B<Depends> field that "
1770"they accept this package from a foreign architecture by qualifying the "
1771"package name with B<:any>, but has no effect otherwise."
1772msgstr ""
1773
1774#. type: TP
1775#: deb-control.man:1
1776#, no-wrap
1777msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>]"
1778msgstr ""
1779
1780#. type: Plain text
1781#: deb-control.man:1
1782msgid ""
1783"The name of the source package that this binary package came from, if it is "
1784"different than the name of the package itself. If the source version "
1785"differs from the binary version, then the I<source-name> will be followed by "
1786"a I<source-version> in parenthesis. This can happen for example on a "
1787"binary-only non-maintainer upload, or when setting a different binary "
1788"version via «B<dpkg-gencontrol -v>»."
1789msgstr ""
1790
1791#. type: TP
1792#: deb-control.man:1 deb-src-control.man:1
1793#, no-wrap
1794msgid "B<Subarchitecture:>I< value>"
1795msgstr ""
1796
1797#. type: TQ
1798#: deb-control.man:1 deb-src-control.man:1
1799#, no-wrap
1800msgid "B<Kernel-Version:>I< value>"
1801msgstr ""
1802
1803#. type: TQ
1804#: deb-control.man:1 deb-src-control.man:1
1805#, no-wrap
1806msgid "B<Installer-Menu-Item:>I< value>"
1807msgstr ""
1808
1809#. type: Plain text
1810#: deb-control.man:1 deb-src-control.man:1
1811msgid ""
1812"These fields are used by the debian-installer and are usually not needed. "
1813"See /usr/share/doc/debian-installer/devel/modules.txt from the "
1814"B<debian-installer> package for more details about them."
1815msgstr ""
1816
1817#. type: TP
1818#: deb-control.man:1 deb-src-control.man:1
1819#, no-wrap
1820msgid "B<Depends:>I< package-list>"
1821msgstr ""
1822
1823#. type: Plain text
1824#: deb-control.man:1
1825msgid ""
1826"List of packages that are required for this package to provide a non-trivial "
1827"amount of functionality. The package maintenance software will not allow a "
1828"package to be installed if the packages listed in its B<Depends> field "
1829"aren't installed (at least not without using the force options). In an "
1830"installation, the postinst scripts of packages listed in B<Depends> fields "
1831"are run before those of the packages which depend on them. On the opposite, "
1832"in a removal, the prerm script of a package is run before those of the "
1833"packages listed in its B<Depends> field."
1834msgstr ""
1835
1836#. type: TQ
1837#: deb-control.man:1 deb-src-control.man:1
1838#, no-wrap
1839msgid "B<Pre-Depends:>I< package-list>"
1840msgstr ""
1841
1842#. type: Plain text
1843#: deb-control.man:1
1844msgid ""
1845"List of packages that must be installed B<and> configured before this one "
1846"can be installed. This is usually used in the case where this package "
1847"requires another package for running its preinst script."
1848msgstr ""
1849
1850#. type: TQ
1851#: deb-control.man:1 deb-src-control.man:1
1852#, no-wrap
1853msgid "B<Recommends:>I< package-list>"
1854msgstr ""
1855
1856#. type: Plain text
1857#: deb-control.man:1
1858msgid ""
1859"Lists packages that would be found together with this one in all but unusual "
1860"installations. The package maintenance software will warn the user if they "
1861"install a package without those listed in its B<Recommends> field."
1862msgstr ""
1863
1864#. type: TQ
1865#: deb-control.man:1 deb-src-control.man:1
1866#, no-wrap
1867msgid "B<Suggests:>I< package-list>"
1868msgstr ""
1869
1870#. type: Plain text
1871#: deb-control.man:1
1872msgid ""
1873"Lists packages that are related to this one and can perhaps enhance its "
1874"usefulness, but without which installing this package is perfectly "
1875"reasonable."
1876msgstr ""
1877
1878#. type: Plain text
1879#: deb-control.man:1
1880msgid ""
1881"The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> "
1882"fields is a list of groups of alternative packages. Each group is a list of "
1883"packages separated by vertical bar (or “pipe”) symbols, ‘B<|>’. The groups "
1884"are separated by commas. Commas are to be read as “AND”, and pipes as “OR”, "
1885"with pipes binding more tightly. Each package name is optionally followed "
1886"by an architecture qualifier appended after a colon ‘B<:>’, optionally "
1887"followed by a version number specification in parentheses."
1888msgstr ""
1889
1890#. type: Plain text
1891#: deb-control.man:1
1892msgid ""
1893"An architecture qualifier name can be a real Debian architecture name (since "
1894"dpkg 1.16.5) or B<any> (since dpkg 1.16.2). If omitted, the default is the "
1895"current binary package architecture. A real Debian architecture name will "
1896"match exactly that architecture for that package name, B<any> will match any "
1897"architecture for that package name if the package has been marked as "
1898"B<Multi-Arch: allowed>."
1899msgstr ""
1900
1901#. type: Plain text
1902#: deb-control.man:1 deb-src-control.man:1
1903msgid ""
1904"A version number may start with a ‘B<E<gt>E<gt>>’, in which case any later "
1905"version will match, and may specify or omit the Debian packaging revision "
1906"(separated by a hyphen). Accepted version relationships are ‘B<E<gt>E<gt>>’ "
1907"for greater than, ‘B<E<lt>E<lt>>’ for less than, ‘B<E<gt>=>’ for greater "
1908"than or equal to, ‘B<E<lt>=>’ for less than or equal to, and ‘B<=>’ for "
1909"equal to."
1910msgstr ""
1911
1912#. type: TQ
1913#: deb-control.man:1 deb-src-control.man:1
1914#, no-wrap
1915msgid "B<Breaks:>I< package-list>"
1916msgstr ""
1917
1918#. type: Plain text
1919#: deb-control.man:1
1920msgid ""
1921"Lists packages that this one breaks, for example by exposing bugs when the "
1922"named packages rely on this one. The package maintenance software will not "
1923"allow broken packages to be configured; generally the resolution is to "
1924"upgrade the packages named in a B<Breaks> field."
1925msgstr ""
1926
1927#. type: TQ
1928#: deb-control.man:1 deb-src-control.man:1
1929#, no-wrap
1930msgid "B<Conflicts:>I< package-list>"
1931msgstr ""
1932
1933#. type: Plain text
1934#: deb-control.man:1
1935msgid ""
1936"Lists packages that conflict with this one, for example by containing files "
1937"with the same names. The package maintenance software will not allow "
1938"conflicting packages to be installed at the same time. Two conflicting "
1939"packages should each include a B<Conflicts> line mentioning the other."
1940msgstr ""
1941
1942#. type: TQ
1943#: deb-control.man:1 deb-src-control.man:1
1944#, no-wrap
1945msgid "B<Replaces:>I< package-list>"
1946msgstr ""
1947
1948#. type: Plain text
1949#: deb-control.man:1
1950msgid ""
1951"List of packages files from which this one replaces. This is used for "
1952"allowing this package to overwrite the files of another package and is "
1953"usually used with the B<Conflicts> field to force removal of the other "
1954"package, if this one also has the same files as the conflicted package."
1955msgstr ""
1956
1957#. type: Plain text
1958#: deb-control.man:1
1959msgid ""
1960"The syntax of B<Breaks>, B<Conflicts> and B<Replaces> is a list of package "
1961"names, separated by commas (and optional whitespace). In the B<Breaks> and "
1962"B<Conflicts> fields, the comma should be read as “OR”. An optional "
1963"architecture qualifier can also be appended to the package name with the "
1964"same syntax as above, but the default is B<any> instead of the binary "
1965"package architecture. An optional version can also be given with the same "
1966"syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields."
1967msgstr ""
1968
1969#. type: TQ
1970#: deb-control.man:1 deb-src-control.man:1
1971#, no-wrap
1972msgid "B<Provides:>I< package-list>"
1973msgstr ""
1974
1975#. type: Plain text
1976#: deb-control.man:1
1977msgid ""
1978"This is a list of virtual packages that this one provides. Usually this is "
1979"used in the case of several packages all providing the same service. For "
1980"example, sendmail and exim can serve as a mail server, so they provide a "
1981"common package (“mail-transport-agent”) on which other packages can depend. "
1982"This will allow sendmail or exim to serve as a valid option to satisfy the "
1983"dependency. This prevents the packages that depend on a mail server from "
1984"having to know the package names for all of them, and using ‘B<|>’ to "
1985"separate the list."
1986msgstr ""
1987
1988#. type: Plain text
1989#: deb-control.man:1
1990msgid ""
1991"The syntax of B<Provides> is a list of package names, separated by commas "
1992"(and optional whitespace). An optional architecture qualifier can also be "
1993"appended to the package name with the same syntax as above. If omitted, the "
1994"default is the current binary package architecture. An optional exact "
1995"(equal to) version can also be given with the same syntax as above (honored "
1996"since dpkg 1.17.11)."
1997msgstr ""
1998
1999#. type: TQ
2000#: deb-control.man:1 deb-src-control.man:1
2001#, no-wrap
2002msgid "B<Built-Using:>I< package-list>"
2003msgstr ""
2004
2005#. type: Plain text
2006#: deb-control.man:1
2007msgid ""
2008"This field lists extra source packages that were used during the build of "
2009"this binary package. This is an indication to the archive maintenance "
2010"software that these extra source packages must be kept whilst this binary "
2011"package is maintained. This field must be a list of source package names "
2012"with strict ‘B<=>’ version relationships. Note that the archive maintenance "
2013"software is likely to refuse to accept an upload which declares a "
2014"B<Built-Using> relationship which cannot be satisfied within the archive."
2015msgstr ""
2016
2017#. type: TP
2018#: deb-control.man:1
2019#, no-wrap
2020msgid "B<Built-For-Profiles:>I< profile-list (obsolete)>"
2021msgstr ""
2022
2023#. type: Plain text
2024#: deb-control.man:1
2025msgid ""
2026"This field used to specify a whitespace separated list of build profiles "
2027"that this binary packages was built with (since dpkg 1.17.2 until 1.18.18). "
2028"The information previously found in this field can now be found in the "
2029"B<.buildinfo> file, which supersedes it."
2030msgstr ""
2031
2032#. type: TP
2033#: deb-control.man:1
2034#, no-wrap
2035msgid "B<Auto-Built-Package:>I< reason-list>"
2036msgstr ""
2037
2038#. type: Plain text
2039#: deb-control.man:1
2040msgid ""
2041"This field specifies a whitespace separated list of reasons why this package "
2042"was auto-generated. Binary packages marked with this field will not appear "
2043"in the I<debian/control> master source control file. The only currently "
2044"used reason is B<debug-symbols>."
2045msgstr ""
2046
2047#. type: SH
2048#: deb-control.man:1 deb-conffiles.man:1 deb-src-control.man:1 deb-origin.man:1
2049#: start-stop-daemon.man:1
2050#, no-wrap
2051msgid "EXAMPLE"
2052msgstr ""
2053
2054#. type: Plain text
2055#: deb-control.man:1
2056#, no-wrap
2057msgid ""
2058"# Comment\n"
2059"Package: grep\n"
2060"Essential: yes\n"
2061"Priority: required\n"
2062"Section: base\n"
2063"Maintainer: Wichert Akkerman E<lt>wakkerma@debian.orgE<gt>\n"
2064"Architecture: sparc\n"
2065"Version: 2.4-1\n"
2066"Pre-Depends: libc6 (E<gt>= 2.0.105)\n"
2067"Provides: rgrep\n"
2068"Conflicts: rgrep\n"
2069"Description: GNU grep, egrep and fgrep.\n"
2070" The GNU family of grep utilities may be the \"fastest grep in the west\".\n"
2071" GNU grep is based on a fast lazy-state deterministic matcher (about\n"
2072" twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper\n"
2073" search for a fixed string that eliminates impossible text from being\n"
2074" considered by the full regexp matcher without necessarily having to\n"
2075" look at every character. The result is typically many times faster\n"
2076" than Unix grep or egrep. (Regular expressions containing backreferencing\n"
2077" will run more slowly, however).\n"
2078msgstr ""
2079
2080#. type: Plain text
2081#: deb-control.man:1
2082msgid "B<deb>(5), B<deb-version>(5), B<debtags>(1), B<dpkg>(1), B<dpkg-deb>(1)."
2083msgstr ""
2084
2085#. type: TH
2086#: deb-conffiles.man:1
2087#, no-wrap
2088msgid "deb-conffiles"
2089msgstr ""
2090
2091#. type: Plain text
2092#: deb-conffiles.man:1
2093msgid "deb-conffiles - package conffiles"
2094msgstr ""
2095
2096#. type: Plain text
2097#: deb-conffiles.man:1
2098msgid "conffiles"
2099msgstr ""
2100
2101#. type: Plain text
2102#: deb-conffiles.man:1
2103msgid ""
2104"A package declares its list of conffiles by including a I<conffiles> file in "
2105"its control archive (i.e. I<DEBIAN/conffiles> during package creation)."
2106msgstr ""
2107
2108#. type: Plain text
2109#: deb-conffiles.man:1
2110msgid ""
2111"This file contains a list of files, one per line. They should be listed as "
2112"absolute pathnames, and should exist in the binary package, otherwise "
2113"B<dpkg>(1) will ignore them (although by default B<dpkg-deb>(1) will refuse "
2114"to build such binary packages). Trailing whitespace will be trimmed, and "
2115"empty lines will be ignored."
2116msgstr ""
2117
2118#. type: Plain text
2119#: deb-conffiles.man:1
2120#, no-wrap
2121msgid ""
2122"%CONFDIR%/alternatives/README\n"
2123"%CONFDIR%/cron.daily/dpkg\n"
2124"%PKGCONFDIR%/dpkg.cfg\n"
2125"%CONFDIR%/logrotate.d/dpkg\n"
2126msgstr ""
2127
2128#. type: Plain text
2129#: deb-conffiles.man:1
2130msgid "B<dpkg-deb>(1), B<dpkg>(1)."
2131msgstr ""
2132
2133#. type: TH
2134#: deb-src-control.man:1
2135#, no-wrap
2136msgid "deb-src-control"
2137msgstr ""
2138
2139#. type: Plain text
2140#: deb-src-control.man:1
2141msgid "deb-src-control - Debian source packages' master control file format"
2142msgstr ""
2143
2144#. type: Plain text
2145#: deb-src-control.man:1
2146msgid "debian/control"
2147msgstr ""
2148
2149#. type: Plain text
2150#: deb-src-control.man:1
2151msgid ""
2152"Each Debian source package contains the master «control» file, which "
2153"contains at least 2 paragraphs, separated by a blank line. The first "
2154"paragraph lists all information about the source package in general, while "
2155"each following paragraph describes exactly one binary package. Each "
2156"paragraph consists of at least one field. A field starts with a fieldname, "
2157"such as B<Package> or B<Section> (case insensitive), followed by a colon, "
2158"the body of the field and a newline. Multi-line fields are also allowed, "
2159"but each supplementary line, without a fieldname, should start with at least "
2160"one space. The content of the multi-line fields is generally joined to a "
2161"single line by the tools (except in the case of the B<Description> field, "
2162"see below). To insert empty lines into a multi-line field, insert a dot "
2163"after the space. Lines starting with a ‘B<#>’ are treated as comments."
2164msgstr ""
2165
2166#. type: SH
2167#: deb-src-control.man:1
2168#, no-wrap
2169msgid "SOURCE FIELDS"
2170msgstr ""
2171
2172#. type: TP
2173#: deb-src-control.man:1
2174#, no-wrap
2175msgid "B<Source:> I<source-package-name> (required)"
2176msgstr ""
2177
2178#. type: Plain text
2179#: deb-src-control.man:1
2180msgid ""
2181"The value of this field is the name of the source package, and should match "
2182"the name of the source package in the debian/changelog file. A package name "
2183"must consist only of lower case letters (a-z), digits (0-9), plus (+) and "
2184"minus (-) signs, and periods (.). Package names must be at least two "
2185"characters long and must start with an alphanumeric character."
2186msgstr ""
2187
2188#. type: Plain text
2189#: deb-src-control.man:1
2190msgid ""
2191"Should be in the format «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», and "
2192"references the person who currently maintains the package, as opposed to the "
2193"author of the software or the original packager."
2194msgstr ""
2195
2196#. type: TP
2197#: deb-src-control.man:1
2198#, no-wrap
2199msgid "B<Uploaders:>I< fullname-email>"
2200msgstr ""
2201
2202#. type: Plain text
2203#: deb-src-control.man:1 dsc.man:1
2204msgid ""
2205"Lists all the names and email addresses of co-maintainers of the package, in "
2206"the same format as the B<Maintainer> field. Multiple co-maintainers should "
2207"be separated by a comma."
2208msgstr ""
2209
2210#. type: TP
2211#: deb-src-control.man:1
2212#, no-wrap
2213msgid "B<Standards-Version:>I< version-string>"
2214msgstr ""
2215
2216#. type: Plain text
2217#: deb-src-control.man:1 dsc.man:1
2218msgid ""
2219"This documents the most recent version of the distribution policy standards "
2220"this package complies with."
2221msgstr ""
2222
2223#. type: Plain text
2224#: deb-src-control.man:1
2225msgid "The upstream project home page URL."
2226msgstr ""
2227
2228#. type: Plain text
2229#: deb-src-control.man:1
2230msgid ""
2231"The I<url> of the bug tracking system for this package. The current used "
2232"format is I<bts-type>B<://>I<bts-address>, like "
2233"B<debbugs://bugs.debian.org>. This field is usually not needed."
2234msgstr ""
2235
2236#. type: TP
2237#: deb-src-control.man:1 dsc.man:1
2238#, no-wrap
2239msgid "B<Vcs-Arch:>I< url>"
2240msgstr ""
2241
2242#. type: TQ
2243#: deb-src-control.man:1 dsc.man:1
2244#, no-wrap
2245msgid "B<Vcs-Bzr:>I< url>"
2246msgstr ""
2247
2248#. type: TQ
2249#: deb-src-control.man:1 dsc.man:1
2250#, no-wrap
2251msgid "B<Vcs-Cvs:>I< url>"
2252msgstr ""
2253
2254#. type: TQ
2255#: deb-src-control.man:1 dsc.man:1
2256#, no-wrap
2257msgid "B<Vcs-Darcs:>I< url>"
2258msgstr ""
2259
2260#. type: TQ
2261#: deb-src-control.man:1 dsc.man:1
2262#, no-wrap
2263msgid "B<Vcs-Git:>I< url>"
2264msgstr ""
2265
2266#. type: TQ
2267#: deb-src-control.man:1 dsc.man:1
2268#, no-wrap
2269msgid "B<Vcs-Hg:>I< url>"
2270msgstr ""
2271
2272#. type: TQ
2273#: deb-src-control.man:1 dsc.man:1
2274#, no-wrap
2275msgid "B<Vcs-Mtn:>I< url>"
2276msgstr ""
2277
2278#. type: TQ
2279#: deb-src-control.man:1 dsc.man:1
2280#, no-wrap
2281msgid "B<Vcs-Svn:>I< url>"
2282msgstr ""
2283
2284#. type: Plain text
2285#: deb-src-control.man:1
2286msgid ""
2287"The I<url> of the Version Control System repository used to maintain this "
2288"package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, "
2289"B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> "
2290"(Subversion). Usually this field points to the latest version of the "
2291"package, such as the main branch or the trunk."
2292msgstr ""
2293
2294#. type: TP
2295#: deb-src-control.man:1 dsc.man:1
2296#, no-wrap
2297msgid "B<Vcs-Browser:>I< url>"
2298msgstr ""
2299
2300#. type: Plain text
2301#: deb-src-control.man:1
2302msgid ""
2303"The I<url> of a webinterface to browse the Version Control System "
2304"repository."
2305msgstr ""
2306
2307#. type: Plain text
2308#: deb-src-control.man:1
2309msgid ""
2310"The name of the distribution this package is originating from. This field is "
2311"usually not needed."
2312msgstr ""
2313
2314#. type: TP
2315#: deb-src-control.man:1 dsc.man:1
2316#, no-wrap
2317msgid "B<Build-Depends:>I< package-list>"
2318msgstr ""
2319
2320#. type: Plain text
2321#: deb-src-control.man:1
2322msgid ""
2323"A list of packages that need to be installed and configured to be able to "
2324"build from source package. These dependencies need to be satisfied when "
2325"building binary architecture dependent or independent packages and source "
2326"packages. Including a dependency in this field does not have the exact same "
2327"effect as including it in both B<Build-Depends-Arch> and "
2328"B<Build-Depends-Indep>, because the dependency also needs to be satisfied "
2329"when building the source package."
2330msgstr ""
2331
2332#. type: TQ
2333#: deb-src-control.man:1 dsc.man:1
2334#, no-wrap
2335msgid "B<Build-Depends-Arch:>I< package-list>"
2336msgstr ""
2337
2338#. type: Plain text
2339#: deb-src-control.man:1
2340msgid ""
2341"Same as B<Build-Depends>, but they are only needed when building the "
2342"architecture dependent packages. The B<Build-Depends> are also installed in "
2343"this case. This field is supported since dpkg 1.16.4; in order to build with "
2344"older dpkg versions, B<Build-Depends> should be used instead."
2345msgstr ""
2346
2347#. type: TQ
2348#: deb-src-control.man:1 dsc.man:1
2349#, no-wrap
2350msgid "B<Build-Depends-Indep:>I< package-list>"
2351msgstr ""
2352
2353#. type: Plain text
2354#: deb-src-control.man:1
2355msgid ""
2356"Same as B<Build-Depends>, but they are only needed when building the "
2357"architecture independent packages. The B<Build-Depends> are also installed "
2358"in this case."
2359msgstr ""
2360
2361#. type: TQ
2362#: deb-src-control.man:1 dsc.man:1
2363#, no-wrap
2364msgid "B<Build-Conflicts:>I< package-list>"
2365msgstr ""
2366
2367#. type: Plain text
2368#: deb-src-control.man:1
2369msgid ""
2370"A list of packages that should not be installed when the package is built, "
2371"for example because they interfere with the build system used. Including a "
2372"dependency in this list has the same effect as including it in both "
2373"B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional "
2374"effect of being used for source-only builds."
2375msgstr ""
2376
2377#. type: TQ
2378#: deb-src-control.man:1 dsc.man:1
2379#, no-wrap
2380msgid "B<Build-Conflicts-Arch:>I< package-list>"
2381msgstr ""
2382
2383#. type: Plain text
2384#: deb-src-control.man:1
2385msgid ""
2386"Same as B<Build-Conflicts>, but only when building the architecture "
2387"dependent packages. This field is supported since dpkg 1.16.4; in order to "
2388"build with older dpkg versions, B<Build-Conflicts> should be used instead."
2389msgstr ""
2390
2391#. type: TQ
2392#: deb-src-control.man:1 dsc.man:1
2393#, no-wrap
2394msgid "B<Build-Conflicts-Indep:>I< package-list>"
2395msgstr ""
2396
2397#. type: Plain text
2398#: deb-src-control.man:1
2399msgid ""
2400"Same as B<Build-Conflicts>, but only when building the architecture "
2401"independent packages."
2402msgstr ""
2403
2404#. type: Plain text
2405#: deb-src-control.man:1
2406msgid ""
2407"The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and "
2408"B<Build-Depends-Indep> fields is a list of groups of alternative packages. "
2409"Each group is a list of packages separated by vertical bar (or “pipe”) "
2410"symbols, ‘B<|>’. The groups are separated by commas. Commas are to be read "
2411"as “AND”, and pipes as “OR”, with pipes binding more tightly. Each package "
2412"name is optionally followed by an architecture qualifier appended after a "
2413"colon ‘B<:>’, optionally followed by a version number specification in "
2414"parentheses, an architecture specification in square brackets, and a "
2415"restriction formula consisting of one or more lists of profile names in "
2416"angle brackets."
2417msgstr ""
2418
2419#. type: Plain text
2420#: deb-src-control.man:1
2421msgid ""
2422"The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and "
2423"B<Build-Conflicts-Indep> fields is a list of comma-separated package names, "
2424"where the comma is read as an “AND”. Specifying alternative packages using "
2425"a “pipe” is not supported. Each package name is optionally followed by a "
2426"version number specification in parentheses, an architecture specification "
2427"in square brackets, and a restriction formula consisting of one or more "
2428"lists of profile names in angle brackets."
2429msgstr ""
2430
2431#. type: Plain text
2432#: deb-src-control.man:1
2433msgid ""
2434"An architecture qualifier name can be a real Debian architecture name (since "
2435"dpkg 1.16.5), B<any> (since dpkg 1.16.2) or B<native> (since dpkg 1.16.5). "
2436"If omitted, the default for B<Build-Depends> fields is the current host "
2437"architecture, the default for B<Build-Conflicts> fields is B<any>. A real "
2438"Debian architecture name will match exactly that architecture for that "
2439"package name, B<any> will match any architecture for that package name if "
2440"the package is marked with B<Multi-Arch: allowed>, and B<native> will match "
2441"the current build architecture if the package is not marked with "
2442"B<Multi-Arch: foreign>."
2443msgstr ""
2444
2445#. type: Plain text
2446#: deb-src-control.man:1
2447msgid ""
2448"An architecture specification consists of one or more architecture names, "
2449"separated by whitespace. Exclamation marks may be prepended to each of the "
2450"names, meaning “NOT”."
2451msgstr ""
2452
2453#. type: Plain text
2454#: deb-src-control.man:1
2455msgid ""
2456"A restriction formula consists of one or more restriction lists, separated "
2457"by whitespace. Each restriction list is enclosed in angle brackets. Items in "
2458"the restriction list are build profile names, separated by whitespace and "
2459"can be prefixed with an exclamation mark, meaning “NOT”. A restriction "
2460"formula represents a disjunctive normal form expression."
2461msgstr ""
2462
2463#. type: Plain text
2464#: deb-src-control.man:1
2465msgid ""
2466"Note that dependencies on packages in the B<build-essential> set can be "
2467"omitted and that declaring build conflicts against them is impossible. A "
2468"list of these packages is in the build-essential package."
2469msgstr ""
2470
2471#. type: SH
2472#: deb-src-control.man:1
2473#, no-wrap
2474msgid "BINARY FIELDS"
2475msgstr ""
2476
2477#. type: Plain text
2478#: deb-src-control.man:1
2479msgid ""
2480"Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in "
2481"a binary paragraph to override the global value from the source package."
2482msgstr ""
2483
2484#. type: TP
2485#: deb-src-control.man:1
2486#, no-wrap
2487msgid "B<Package:> I<binary-package-name> (required)"
2488msgstr ""
2489
2490#. type: Plain text
2491#: deb-src-control.man:1
2492msgid ""
2493"This field is used to name the binary package name. The same restrictions as "
2494"to a source package name apply."
2495msgstr ""
2496
2497#. type: TP
2498#: deb-src-control.man:1
2499#, no-wrap
2500msgid "B<Architecture:> I<arch>|B<all>|B<any> (required)"
2501msgstr ""
2502
2503#. type: Plain text
2504#: deb-src-control.man:1
2505msgid ""
2506"The architecture specifies on which type of hardware this package runs. For "
2507"packages that run on all architectures, use the B<any> value. For packages "
2508"that are architecture independent, such as shell and Perl scripts or "
2509"documentation, use the B<all> value. To restrict the packages to a certain "
2510"set of architectures, specify the architecture names, separated by a "
2511"space. It's also possible to put architecture wildcards in that list (see "
2512"B<dpkg-architecture>(1) for more information about them)."
2513msgstr ""
2514
2515#. type: TP
2516#: deb-src-control.man:1
2517#, no-wrap
2518msgid "B<Build-Profiles:> I<restriction-formula>"
2519msgstr ""
2520
2521#. type: Plain text
2522#: deb-src-control.man:1
2523msgid ""
2524"This field specifies the conditions for which this binary package does or "
2525"does not build. To express that condition, the same restriction formula "
2526"syntax from the B<Build-Depends> field is used."
2527msgstr ""
2528
2529#. type: Plain text
2530#: deb-src-control.man:1
2531msgid ""
2532"If a binary package paragraph does not contain this field, then it "
2533"implicitly means that it builds with all build profiles (including none at "
2534"all)."
2535msgstr ""
2536
2537#. type: Plain text
2538#: deb-src-control.man:1
2539msgid ""
2540"In other words, if a binary package paragraph is annotated with a non-empty "
2541"B<Build-Profiles> field, then this binary package is generated if and only "
2542"if the condition expressed by the conjunctive normal form expression "
2543"evaluates to true."
2544msgstr ""
2545
2546#. type: TP
2547#: deb-src-control.man:1
2548#, no-wrap
2549msgid "B<Package-Type:> B<deb>|B<udeb>"
2550msgstr ""
2551
2552#. type: Plain text
2553#: deb-src-control.man:1
2554msgid ""
2555"This field defines the type of the package. B<udeb> is for size-constrained "
2556"packages used by the debian installer. B<deb> is the default value, it is "
2557"assumed if the field is absent. More types might be added in the future."
2558msgstr ""
2559
2560#. type: TQ
2561#: deb-src-control.man:1
2562#, no-wrap
2563msgid "B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>"
2564msgstr ""
2565
2566#. type: Plain text
2567#: deb-src-control.man:1
2568msgid ""
2569"These fields are described in the B<deb-control>(5) manual page, as they "
2570"are copied literally to the control file of the binary package."
2571msgstr ""
2572
2573#. type: TQ
2574#: deb-src-control.man:1
2575#, no-wrap
2576msgid "B<Enhances:>I< package-list>"
2577msgstr ""
2578
2579#. type: Plain text
2580#: deb-src-control.man:1
2581msgid ""
2582"These fields declare relationships between packages. They are discussed in "
2583"the B<deb-control>(5) manpage."
2584msgstr ""
2585
2586#. type: SH
2587#: deb-src-control.man:1
2588#, no-wrap
2589msgid "USER-DEFINED FIELDS"
2590msgstr ""
2591
2592#. type: Plain text
2593#: deb-src-control.man:1
2594msgid ""
2595"It is allowed to add additional user-defined fields to the control file. The "
2596"tools will ignore these fields. If you want the fields to be copied over to "
2597"the output files, such as the binary packages, you need to use a custom "
2598"naming scheme: the fields should start with an B<X>, followed by zero or "
2599"more of the letters B<BCS> and a hyphen."
2600msgstr ""
2601
2602#. type: TP
2603#: deb-src-control.man:1
2604#, no-wrap
2605msgid "B<B>"
2606msgstr ""
2607
2608#. type: Plain text
2609#: deb-src-control.man:1
2610msgid ""
2611"The field will appear in the control file in the binary package, see "
2612"B<deb-control>(5)."
2613msgstr ""
2614
2615#. type: TP
2616#: deb-src-control.man:1
2617#, no-wrap
2618msgid "B<S>"
2619msgstr ""
2620
2621#. type: Plain text
2622#: deb-src-control.man:1
2623msgid "The field will appear in the source package control file, see B<dsc>(5)."
2624msgstr ""
2625
2626#. type: TP
2627#: deb-src-control.man:1
2628#, no-wrap
2629msgid "B<C>"
2630msgstr ""
2631
2632#. type: Plain text
2633#: deb-src-control.man:1
2634msgid ""
2635"The field will appear in the upload control (.changes) file, see "
2636"B<deb-changes>(5)."
2637msgstr ""
2638
2639#. type: Plain text
2640#: deb-src-control.man:1
2641msgid ""
2642"Note that the B<X>[B<BCS>]B<-> prefixes are stripped when the fields are "
2643"copied over to the output files. A field B<XC-Approved-By> will appear as "
2644"B<Approved-By> in the changes file and will not appear in the binary or "
2645"source package control files."
2646msgstr ""
2647
2648#. type: Plain text
2649#: deb-src-control.man:1
2650msgid ""
2651"Take into account that these user-defined fields will be using the global "
2652"namespace, which might at some point in the future collide with officially "
2653"recognized fields. To avoid such potential situation you can prefix those "
2654"fields with B<Private->, such as B<XB-Private-New-Field>."
2655msgstr ""
2656
2657#. type: Plain text
2658#: deb-src-control.man:1
2659#, no-wrap
2660msgid ""
2661"# Comment\n"
2662"Source: dpkg\n"
2663"Section: admin\n"
2664"Priority: required\n"
2665"Maintainer: Dpkg Developers E<lt>debian-dpkg@lists.debian.orgE<gt>\n"
2666"# this field is copied to the binary and source packages\n"
2667"XBS-Upstream-Release-Status: stable\n"
2668"Homepage: https://wiki.debian.org/Teams/Dpkg\n"
2669"Vcs-Browser: https://git.dpkg.org/cgit/dpkg/dpkg.git\n"
2670"Vcs-Git: https://git.dpkg.org/git/dpkg/dpkg.git\n"
2671"Standards-Version: 3.7.3\n"
2672"Build-Depends: pkg-config, debhelper (E<gt>= 4.1.81),\n"
2673" libselinux1-dev (E<gt>= 1.28-4) [!linux-any]\n"
2674msgstr ""
2675
2676#. type: Plain text
2677#: deb-src-control.man:1
2678#, no-wrap
2679msgid ""
2680"Package: dpkg-dev\n"
2681"Section: utils\n"
2682"Priority: optional\n"
2683"Architecture: all\n"
2684"# this is a custom field in the binary package\n"
2685"XB-Mentoring-Contact: Raphael Hertzog E<lt>hertzog@debian.orgE<gt>\n"
2686"Depends: dpkg (E<gt>= 1.14.6), perl5, perl-modules, cpio (E<gt>= 2.4.2-2),\n"
2687" bzip2, lzma, patch (E<gt>= 2.2-1), make, binutils, libtimedate-perl\n"
2688"Recommends: gcc | c-compiler, build-essential\n"
2689"Suggests: gnupg, debian-keyring\n"
2690"Conflicts: dpkg-cross (E<lt>E<lt> 2.0.0), devscripts (E<lt>E<lt> 2.10.26)\n"
2691"Replaces: manpages-pl (E<lt>= 20051117-1)\n"
2692"Description: Debian package development tools\n"
2693" This package provides the development tools (including dpkg-source)\n"
2694" required to unpack, build and upload Debian source packages.\n"
2695" .\n"
2696" Most Debian source packages will require additional tools to build;\n"
2697" for example, most packages need make and the C compiler gcc.\n"
2698msgstr ""
2699
2700#. type: Plain text
2701#: deb-src-control.man:1
2702msgid "B<deb-control>(5), B<deb-version>(5), B<dpkg-source>(1)"
2703msgstr ""
2704
2705#. type: TH
2706#: deb-src-files.man:1
2707#, no-wrap
2708msgid "deb-src-files"
2709msgstr ""
2710
2711#. type: Plain text
2712#: deb-src-files.man:1
2713msgid "deb-src-files - Debian distribute files format"
2714msgstr ""
2715
2716#. type: Plain text
2717#: deb-src-files.man:1
2718msgid "debian/files"
2719msgstr ""
2720
2721#. type: Plain text
2722#: deb-src-files.man:1
2723msgid ""
2724"This file contains the list of artifacts that are to be distributed via the "
2725"B<.changes> control file."
2726msgstr ""
2727
2728#. type: Plain text
2729#: deb-src-files.man:1
2730msgid "The I<debian/files> file has a simple whitespace-delimited format."
2731msgstr ""
2732
2733#. type: Plain text
2734#: deb-src-files.man:1
2735msgid "I<filename> I<section> I<priority>"
2736msgstr ""
2737
2738#. type: Plain text
2739#: deb-src-files.man:1
2740msgid "I<filename> is the name of the artifact to distribute."
2741msgstr ""
2742
2743#. type: Plain text
2744#: deb-src-files.man:1
2745msgid ""
2746"I<section> and I<priority> correspond to the respective control fields "
2747"available in the .deb. The allowed values are specific to each distribution "
2748"archive."
2749msgstr ""
2750
2751#. type: SH
2752#: deb-src-files.man:1 deb-version.man:1 dpkg-architecture.man:1
2753#: dpkg-buildpackage.man:1 dpkg-deb.man:1 dpkg-divert.man:1
2754#: dpkg-parsechangelog.man:1
2755#, no-wrap
2756msgid "NOTES"
2757msgstr ""
2758
2759#. type: Plain text
2760#: deb-src-files.man:1
2761msgid ""
2762"This file is not intended to be modified directly, please use one of "
2763"B<dpkg-gencontrol> or B<dpkg-distaddfile> to add entries to it."
2764msgstr ""
2765
2766#. type: Plain text
2767#: deb-src-files.man:1
2768msgid "B<dpkg-genchanges>(1), B<dpkg-distaddfile>(1)."
2769msgstr ""
2770
2771#. type: TH
2772#: deb-split.man:1
2773#, no-wrap
2774msgid "deb-split"
2775msgstr ""
2776
2777#. type: Plain text
2778#: deb-split.man:1
2779msgid "deb-split - Debian multi-part binary package format"
2780msgstr ""
2781
2782#. type: Plain text
2783#: deb-split.man:1
2784msgid ""
2785"The multi-part B<.deb> format is used to split big packages into smaller "
2786"pieces to ease transport in small media."
2787msgstr ""
2788
2789#. type: Plain text
2790#: deb-split.man:1
2791msgid ""
2792"The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. The "
2793"file names might contain a trailing slash (since dpkg 1.15.6)."
2794msgstr ""
2795
2796#. type: Plain text
2797#: deb-split.man:1
2798msgid ""
2799"The first member is named B<debian-split> and contains a series of lines, "
2800"separated by newlines. Currently eight lines are present:"
2801msgstr ""
2802
2803#. type: IP
2804#: deb-split.man:1 deb-split.man:1 deb-split.man:1 deb-split.man:1
2805#: deb-split.man:1 deb-split.man:1 deb-split.man:1 deb-split.man:1
2806#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
2807#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
2808#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
2809#, no-wrap
2810msgid "•"
2811msgstr ""
2812
2813#. type: Plain text
2814#: deb-split.man:1
2815msgid "The format version number, B<2.1> at the time this manual page was written."
2816msgstr ""
2817
2818#. type: Plain text
2819#: deb-split.man:1
2820msgid "The package name."
2821msgstr ""
2822
2823#. type: Plain text
2824#: deb-split.man:1
2825msgid "The package version."
2826msgstr ""
2827
2828#. type: Plain text
2829#: deb-split.man:1
2830msgid "The md5sum of the package."
2831msgstr ""
2832
2833#. type: Plain text
2834#: deb-split.man:1
2835msgid "The total size of the package."
2836msgstr ""
2837
2838#. type: Plain text
2839#: deb-split.man:1
2840msgid "The maximum part size."
2841msgstr ""
2842
2843#. type: Plain text
2844#: deb-split.man:1
2845msgid ""
2846"The current part number, followed by a slash and the total amount of parts "
2847"(as in ‘1/10’)."
2848msgstr ""
2849
2850#. type: Plain text
2851#: deb-split.man:1
2852msgid "The package architecture (since dpkg 1.16.1)."
2853msgstr ""
2854
2855#. type: Plain text
2856#: deb-split.man:1
2857msgid ""
2858"Programs which read multi-part archives should be prepared for the minor "
2859"format version number to be increased and additional lines to be present, "
2860"and should ignore these if this is the case."
2861msgstr ""
2862
2863#. type: Plain text
2864#: deb-split.man:1
2865msgid ""
2866"If the major format version number has changed, an incompatible change has "
2867"been made and the program should stop. If it has not, then the program "
2868"should be able to safely continue, unless it encounters an unexpected member "
2869"in the archive (except at the end), as described below."
2870msgstr ""
2871
2872#. type: Plain text
2873#: deb-split.man:1
2874msgid ""
2875"The second, last required member is named B<data.>I<N>, where I<N> denotes "
2876"the part number. It contains the raw part data."
2877msgstr ""
2878
2879#. type: Plain text
2880#: deb-split.man:1
2881msgid ""
2882"These members must occur in this exact order. Current implementations should "
2883"ignore any additional members after B<data.>I<N>. Further members may be "
2884"defined in the future, and (if possible) will be placed after these two."
2885msgstr ""
2886
2887#. type: Plain text
2888#: deb-split.man:1
2889msgid "B<deb>(5), B<dpkg-split>(1)."
2890msgstr ""
2891
2892#. type: TH
2893#: deb-version.man:1
2894#, no-wrap
2895msgid "deb-version"
2896msgstr ""
2897
2898#. type: Plain text
2899#: deb-version.man:1
2900msgid "deb-version - Debian package version number format"
2901msgstr ""
2902
2903#. type: Plain text
2904#: deb-version.man:1
2905msgid "[I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]"
2906msgstr ""
2907
2908#. type: Plain text
2909#: deb-version.man:1
2910msgid ""
2911"Version numbers as used for Debian binary and source packages consist of "
2912"three components. These are:"
2913msgstr ""
2914
2915#. type: TP
2916#: deb-version.man:1
2917#, no-wrap
2918msgid "I<epoch>"
2919msgstr ""
2920
2921#. type: Plain text
2922#: deb-version.man:1
2923msgid ""
2924"This is a single (generally small) unsigned integer. It may be omitted, in "
2925"which case zero is assumed. If it is omitted then the I<upstream-version> "
2926"may not contain any colons."
2927msgstr ""
2928
2929#. type: Plain text
2930#: deb-version.man:1
2931msgid ""
2932"It is provided to allow mistakes in the version numbers of older versions of "
2933"a package, and also a package's previous version numbering schemes, to be "
2934"left behind."
2935msgstr ""
2936
2937#. type: TP
2938#: deb-version.man:1
2939#, no-wrap
2940msgid "I<upstream-version>"
2941msgstr ""
2942
2943#. type: Plain text
2944#: deb-version.man:1
2945msgid ""
2946"This is the main part of the version number. It is usually the version "
2947"number of the original (“upstream”) package from which the I<.deb> file has "
2948"been made, if this is applicable. Usually this will be in the same format "
2949"as that specified by the upstream author(s); however, it may need to be "
2950"reformatted to fit into the package management system's format and "
2951"comparison scheme."
2952msgstr ""
2953
2954#. type: Plain text
2955#: deb-version.man:1
2956msgid ""
2957"The comparison behavior of the package management system with respect to the "
2958"I<upstream-version> is described below. The I<upstream-version> portion of "
2959"the version number is mandatory."
2960msgstr ""
2961
2962#. type: Plain text
2963#: deb-version.man:1
2964msgid ""
2965"The I<upstream-version> may contain only alphanumerics (“A-Za-z0-9”) and the "
2966"characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) "
2967"and should start with a digit. If there is no I<debian-revision> then "
2968"hyphens are not allowed; if there is no I<epoch> then colons are not "
2969"allowed."
2970msgstr ""
2971
2972#. type: TP
2973#: deb-version.man:1
2974#, no-wrap
2975msgid "I<debian-revision>"
2976msgstr ""
2977
2978#. type: Plain text
2979#: deb-version.man:1
2980msgid ""
2981"This part of the version number specifies the version of the Debian package "
2982"based on the upstream version. It may contain only alphanumerics and the "
2983"characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the "
2984"same way as the I<upstream-version> is."
2985msgstr ""
2986
2987#. type: Plain text
2988#: deb-version.man:1
2989msgid ""
2990"It is optional; if it isn't present then the I<upstream-version> may not "
2991"contain a hyphen. This format represents the case where a piece of software "
2992"was written specifically to be turned into a Debian package, and so there is "
2993"only one “debianization” of it and therefore no revision indication is "
2994"required."
2995msgstr ""
2996
2997#. type: Plain text
2998#: deb-version.man:1
2999msgid ""
3000"It is conventional to restart the I<debian-revision> at ‘1’ each time the "
3001"I<upstream-version> is increased."
3002msgstr ""
3003
3004#. type: Plain text
3005#: deb-version.man:1
3006msgid ""
3007"Dpkg will break the version number apart at the last hyphen in the string "
3008"(if there is one) to determine the I<upstream-version> and "
3009"I<debian-revision>. The absence of a I<debian-revision> compares earlier "
3010"than the presence of one (but note that the I<debian-revision> is the least "
3011"significant part of the version number)."
3012msgstr ""
3013
3014#. type: SS
3015#: deb-version.man:1
3016#, no-wrap
3017msgid "Sorting algorithm"
3018msgstr ""
3019
3020#. type: Plain text
3021#: deb-version.man:1
3022msgid ""
3023"The I<upstream-version> and I<debian-revision> parts are compared by the "
3024"package management system using the same algorithm:"
3025msgstr ""
3026
3027#. type: Plain text
3028#: deb-version.man:1
3029msgid "The strings are compared from left to right."
3030msgstr ""
3031
3032#. type: Plain text
3033#: deb-version.man:1
3034msgid ""
3035"First the initial part of each string consisting entirely of non-digit "
3036"characters is determined. These two parts (one of which may be empty) are "
3037"compared lexically. If a difference is found it is returned. The lexical "
3038"comparison is a comparison of ASCII values modified so that all the letters "
3039"sort earlier than all the non-letters and so that a tilde sorts before "
3040"anything, even the end of a part. For example, the following parts are in "
3041"sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’."
3042msgstr ""
3043
3044#. type: Plain text
3045#: deb-version.man:1
3046msgid ""
3047"Then the initial part of the remainder of each string which consists "
3048"entirely of digit characters is determined. The numerical values of these "
3049"two parts are compared, and any difference found is returned as the result "
3050"of the comparison. For these purposes an empty string (which can only occur "
3051"at the end of one or both version strings being compared) counts as zero."
3052msgstr ""
3053
3054#. type: Plain text
3055#: deb-version.man:1
3056msgid ""
3057"These two steps (comparing and removing initial non-digit strings and "
3058"initial digit strings) are repeated until a difference is found or both "
3059"strings are exhausted."
3060msgstr ""
3061
3062#. type: Plain text
3063#: deb-version.man:1
3064msgid ""
3065"Note that the purpose of epochs is to allow us to leave behind mistakes in "
3066"version numbering, and to cope with situations where the version numbering "
3067"scheme changes. It is B<not> intended to cope with version numbers "
3068"containing strings of letters which the package management system cannot "
3069"interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings."
3070msgstr ""
3071
3072#. type: Plain text
3073#: deb-version.man:1
3074msgid ""
3075"The tilde character and its special sorting properties were introduced in "
3076"dpkg 1.10 and some parts of the dpkg build scripts only gained support for "
3077"it later in the 1.10.x series."
3078msgstr ""
3079
3080#. type: Plain text
3081#: deb-version.man:1
3082msgid "B<deb-control>(5), B<deb>(5), B<dpkg>(1)"
3083msgstr ""
3084
3085#. type: TH
3086#: deb-old.man:1
3087#, no-wrap
3088msgid "deb-old"
3089msgstr ""
3090
3091#. type: Plain text
3092#: deb-old.man:1
3093msgid "deb-old - old style Debian binary package format"
3094msgstr ""
3095
3096#. type: Plain text
3097#: deb-old.man:1
3098msgid ""
3099"The B<.deb> format is the Debian binary package file format. This manual "
3100"page describes the B<old> format, used before Debian 0.93. Please see "
3101"B<deb>(5) for details of the new format."
3102msgstr ""
3103
3104#. type: Plain text
3105#: deb-old.man:1
3106msgid ""
3107"The file is two lines of format information as ASCII text, followed by two "
3108"concatenated gzipped ustar files."
3109msgstr ""
3110
3111#. type: Plain text
3112#: deb-old.man:1
3113msgid ""
3114"The first line is the format version number padded to 8 digits, and is "
3115"B<0.939000> for all old-format archives."
3116msgstr ""
3117
3118#. type: Plain text
3119#: deb-old.man:1
3120msgid ""
3121"The second line is a decimal string (without leading zeroes) giving the "
3122"length of the first gzipped tarfile."
3123msgstr ""
3124
3125#. type: Plain text
3126#: deb-old.man:1
3127msgid "Each of these lines is terminated with a single newline character."
3128msgstr ""
3129
3130#. type: Plain text
3131#: deb-old.man:1
3132msgid ""
3133"The first tarfile contains the control information, as a series of ordinary "
3134"files. The file B<control> must be present, as it contains the core control "
3135"information."
3136msgstr ""
3137
3138#. type: Plain text
3139#: deb-old.man:1
3140msgid ""
3141"In some very old archives, the files in the control tarfile may optionally "
3142"be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory "
3143"will be in the control tarfile too, and the control tarfile will have only "
3144"files in that directory. Optionally the control tarfile may contain an entry "
3145"for ‘B<.>’, that is, the current directory."
3146msgstr ""
3147
3148#. type: Plain text
3149#: deb-old.man:1
3150msgid ""
3151"The second gzipped tarfile is the filesystem archive, containing pathnames "
3152"relative to the root directory of the system to be installed on. The "
3153"pathnames do not have leading slashes."
3154msgstr ""
3155
3156#. type: Plain text
3157#: deb-old.man:1
3158msgid "B<deb>(5), B<dpkg-deb>(1), B<deb-control>(5)."
3159msgstr ""
3160
3161#. type: TH
3162#: deb-origin.man:1
3163#, no-wrap
3164msgid "deb-origin"
3165msgstr ""
3166
3167#. type: Plain text
3168#: deb-origin.man:1
3169msgid "deb-origin - Vendor-specific information files"
3170msgstr ""
3171
3172#. type: Plain text
3173#: deb-origin.man:1
3174msgid "B<%PKGCONFDIR%/origins/>I<filename>"
3175msgstr ""
3176
3177#. type: Plain text
3178#: deb-origin.man:1
3179msgid ""
3180"The files in B<%PKGCONFDIR%/origins> can provide information about various "
3181"vendors who are providing Debian packages."
3182msgstr ""
3183
3184#. type: Plain text
3185#: deb-origin.man:1
3186msgid ""
3187"They contain a number of fields, or comments when the line starts with "
3188"‘B<#>’. Each field begins with a tag, such as B<Vendor> or B<Parent>, "
3189"followed by a colon and the body of the field. Fields are delimited only by "
3190"field tags. In other words, field text may be multiple lines in length, but "
3191"the tools will join lines when processing the body of the field."
3192msgstr ""
3193
3194#. type: Plain text
3195#: deb-origin.man:1
3196msgid ""
3197"The file should be named according to the vendor name. The usual convention "
3198"is to name the vendor file using the vendor name in all lowercase, but some "
3199"variation is permitted. Namely, spaces are mapped to dashes (‘B<->’), and "
3200"the file can have the same casing as the value in B<Vendor> field, or it can "
3201"be capitalized."
3202msgstr ""
3203
3204#. type: TP
3205#: deb-origin.man:1
3206#, no-wrap
3207msgid "B<Vendor:> I<vendor-name> (required)"
3208msgstr ""
3209
3210#. type: Plain text
3211#: deb-origin.man:1
3212msgid "The value of this field determines the vendor name."
3213msgstr ""
3214
3215#. type: TP
3216#: deb-origin.man:1
3217#, no-wrap
3218msgid "B<Vendor-URL:>I< vendor-url>"
3219msgstr ""
3220
3221#. type: Plain text
3222#: deb-origin.man:1
3223msgid "The value of this field determines the vendor URL."
3224msgstr ""
3225
3226#. type: TP
3227#: deb-origin.man:1
3228#, no-wrap
3229msgid "B<Bugs:>I< bug-url>"
3230msgstr ""
3231
3232#. type: Plain text
3233#: deb-origin.man:1
3234msgid ""
3235"The value of this field determines the type and address of the bug tracking "
3236"system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., "
3237"debbugs://bugs.debian.org/)."
3238msgstr ""
3239
3240#. type: TP
3241#: deb-origin.man:1
3242#, no-wrap
3243msgid "B<Parent:>I< vendor-name>"
3244msgstr ""
3245
3246#. type: Plain text
3247#: deb-origin.man:1
3248msgid ""
3249"The value of this field determines the vendor name of the vendor that this "
3250"vendor derives from."
3251msgstr ""
3252
3253#. type: Plain text
3254#: deb-origin.man:1
3255#, no-wrap
3256msgid ""
3257"Vendor: Debian\n"
3258"Vendor-URL: https://www.debian.org/\n"
3259"Bugs: debbugs://bugs.debian.org\n"
3260msgstr ""
3261
3262#. type: Plain text
3263#: deb-origin.man:1
3264msgid "B<dpkg-vendor>(1)"
3265msgstr ""
3266
3267#. type: TH
3268#: deb-override.man:1
3269#, no-wrap
3270msgid "deb-override"
3271msgstr ""
3272
3273#. type: Plain text
3274#: deb-override.man:1
3275msgid "deb-override - Debian archive override file"
3276msgstr ""
3277
3278#. type: Plain text
3279#: deb-override.man:1 deb-extra-override.man:1
3280msgid "override"
3281msgstr ""
3282
3283#. type: Plain text
3284#: deb-override.man:1
3285msgid ""
3286"While most information about a package can be found in the control file, "
3287"some is managed centrally by the distribution czars rather than by the "
3288"maintainer in order to offer some global consistency. This information is "
3289"found in the override file."
3290msgstr ""
3291
3292#. type: Plain text
3293#: deb-override.man:1
3294msgid ""
3295"The override file has a simple whitespace-delimited format. Comments are "
3296"allowed (denoted with a B<#>)."
3297msgstr ""
3298
3299#. type: Plain text
3300#: deb-override.man:1
3301msgid "I<package> I<priority> I<section> [I<maintainerinfo>]"
3302msgstr ""
3303
3304#. type: Plain text
3305#: deb-override.man:1
3306msgid ""
3307"I<package> is the name of the package. Entries in the override file for "
3308"packages not found in the tree of binary packages are ignored."
3309msgstr ""
3310
3311#. type: Plain text
3312#: deb-override.man:1
3313msgid ""
3314"I<priority> and I<section> correspond to the respective control fields "
3315"available in the .deb. The allowed values are specific to each distribution "
3316"archive."
3317msgstr ""
3318
3319#. type: Plain text
3320#: deb-override.man:1
3321msgid ""
3322"I<maintainerinfo>, if present, can be either the name of a maintainer for an "
3323"unconditional override, or else I<oldmaintainer> B<=E<gt>> I<newmaintainer> "
3324"to perform a substitution."
3325msgstr ""
3326
3327#. type: Plain text
3328#: deb-override.man:1
3329msgid ""
3330"The override files used to make the official Packages lists may be found in "
3331"the I<indices> directory on any Debian mirror."
3332msgstr ""
3333
3334#. type: Plain text
3335#: deb-override.man:1 deb-extra-override.man:1
3336msgid "B<dpkg-scanpackages>(1), B<dpkg-scansources>(1), B<apt-ftparchive>(1)."
3337msgstr ""
3338
3339#. type: TH
3340#: deb-extra-override.man:1
3341#, no-wrap
3342msgid "deb-extra-override"
3343msgstr ""
3344
3345#. type: Plain text
3346#: deb-extra-override.man:1
3347msgid "deb-extra-override - Debian archive extra override file"
3348msgstr ""
3349
3350#. type: Plain text
3351#: deb-extra-override.man:1
3352msgid ""
3353"While most information about a binary/source package can be found in the "
3354"control/.dsc file, all of it can be overridden when it's exported to "
3355"Packages/Sources files. The extra override file contains those overrides."
3356msgstr ""
3357
3358#. type: Plain text
3359#: deb-extra-override.man:1
3360msgid ""
3361"The extra override file has a simple whitespace-delimited format. Comments "
3362"are allowed (denoted with a B<#>)."
3363msgstr ""
3364
3365#. type: Plain text
3366#: deb-extra-override.man:1
3367msgid "I<package> I<field-name> I<value>"
3368msgstr ""
3369
3370#. type: Plain text
3371#: deb-extra-override.man:1
3372msgid "I<package> is the name of the binary/source package."
3373msgstr ""
3374
3375#. type: Plain text
3376#: deb-extra-override.man:1
3377msgid ""
3378"I<field-name> is the name of the field that is overridden. I<value> is the "
3379"value to put in the field. It can contain spaces as the line is split in no "
3380"more than 3 columns when it's parsed."
3381msgstr ""
3382
3383#. type: Plain text
3384#: deb-extra-override.man:1
3385msgid ""
3386"The extra override files used to make the official Packages lists may be "
3387"found in the I<indices> directory on any Debian mirror."
3388msgstr ""
3389
3390#. type: TH
3391#: deb-shlibs.man:1
3392#, no-wrap
3393msgid "deb-shlibs"
3394msgstr ""
3395
3396#. type: Plain text
3397#: deb-shlibs.man:1
3398msgid "deb-shlibs - Debian shared library information file"
3399msgstr ""
3400
3401#. type: Plain text
3402#: deb-shlibs.man:1
3403msgid ""
3404"B<shlibs> files map shared library names and versions (I<sonames>) to "
3405"dependencies suitable for a package control file. There is one entry per "
3406"line. Blank lines are B<not> allowed. Lines beginning with an B<#> "
3407"character are considered commentary, and are ignored. All other lines must "
3408"have the format"
3409msgstr ""
3410
3411#. type: Plain text
3412#: deb-shlibs.man:1
3413msgid "[I<type>B<:>] I<library> I<version> I<dependencies>"
3414msgstr ""
3415
3416#. type: Plain text
3417#: deb-shlibs.man:1
3418msgid ""
3419"The I<library> and I<version> fields are whitespace-delimited, but the "
3420"I<dependencies> field extends to the end of the line. The I<type> field is "
3421"optional and normally not needed."
3422msgstr ""
3423
3424#. type: Plain text
3425#: deb-shlibs.man:1
3426msgid ""
3427"The I<dependencies> field has the same syntax as the B<Depends> field in a "
3428"binary control file, see B<deb-control>(5)."
3429msgstr ""
3430
3431#. type: Plain text
3432#: deb-shlibs.man:1
3433msgid ""
3434"The B<shlibs> file for a typical library package, named I<libcrunch1>, that "
3435"provides one library whose soname is I<libcrunch.so.1>, might read"
3436msgstr ""
3437
3438#. type: Plain text
3439#: deb-shlibs.man:1
3440msgid "libcrunch 1 libcrunch1 (E<gt>= 1.2-1)"
3441msgstr ""
3442
3443#. type: Plain text
3444#: deb-shlibs.man:1
3445msgid ""
3446"The I<dependencies> must mention the most recent version of the package that "
3447"added new symbols to the library: in the above example, new symbols were "
3448"added to version 1.2 of I<libcrunch>. This is not the only reason the "
3449"dependencies might need to be tightened."
3450msgstr ""
3451
3452#. type: Plain text
3453#: deb-shlibs.man:1
3454msgid "B<deb-control>(5), B<dpkg-shlibdeps>(1), B<deb-symbols>(5)."
3455msgstr ""
3456
3457#. type: TH
3458#: deb-substvars.man:1
3459#, no-wrap
3460msgid "deb-substvars"
3461msgstr ""
3462
3463#. type: Plain text
3464#: deb-substvars.man:1
3465msgid "deb-substvars - Debian source substitution variables"
3466msgstr ""
3467
3468#. type: Plain text
3469#: deb-substvars.man:1
3470msgid "substvars"
3471msgstr ""
3472
3473#. type: Plain text
3474#: deb-substvars.man:1
3475msgid ""
3476"Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their "
3477"control information (to the source control file B<.dsc> for B<dpkg-source> "
3478"and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>) they "
3479"perform some variable substitutions on the output file."
3480msgstr ""
3481
3482#. type: Plain text
3483#: deb-substvars.man:1
3484msgid ""
3485"A variable substitution has the form B<${>I<variable-name>B<}>. Variable "
3486"names consist of alphanumerics, hyphens and colons and start with an "
3487"alphanumeric. Variable substitutions are performed repeatedly until none are "
3488"left; the full text of the field after the substitution is rescanned to look "
3489"for more substitutions."
3490msgstr ""
3491
3492#. type: Plain text
3493#: deb-substvars.man:1
3494msgid ""
3495"After all the substitutions have been done each occurrence of the string "
3496"B<${}> (which is not a legal substitution) is replaced with a B<$> sign."
3497msgstr ""
3498
3499#. type: Plain text
3500#: deb-substvars.man:1
3501msgid ""
3502"While variable substitution is done on all control fields, some of those "
3503"fields are used and needed during the build when the substitution did not "
3504"yet occur. That's why you can't use variables in the B<Package>, B<Source> "
3505"and B<Architecture> fields."
3506msgstr ""
3507
3508#. type: Plain text
3509#: deb-substvars.man:1
3510msgid ""
3511"Variable substitution happens on the content of the fields after they have "
3512"been parsed, thus if you want a variable to expand over multiple lines you "
3513"do not have to include a space after the newline. This is done implicitly "
3514"when the field is output. For example, if the variable B<${Description}> is "
3515"set to \"foo is bar.${Newline}foo is great.\" and if you have the following "
3516"field:"
3517msgstr ""
3518
3519#. type: Plain text
3520#: deb-substvars.man:1
3521#, no-wrap
3522msgid ""
3523" Description: foo application\n"
3524" ${Description}\n"
3525" .\n"
3526" More text.\n"
3527msgstr ""
3528
3529#. type: Plain text
3530#: deb-substvars.man:1
3531msgid "It will result in:"
3532msgstr ""
3533
3534#. type: Plain text
3535#: deb-substvars.man:1
3536#, no-wrap
3537msgid ""
3538" Description: foo application\n"
3539" foo is bar.\n"
3540" foo is great.\n"
3541" .\n"
3542" More text.\n"
3543msgstr ""
3544
3545#. type: Plain text
3546#: deb-substvars.man:1
3547msgid ""
3548"Variables can be set using the B<-V> common option. They can be also "
3549"specified in the file B<debian/substvars> (or whatever other file is "
3550"specified using the B<-T> option). This file consists of lines of the form "
3551"I<name>B<=>I<value>. Trailing whitespace on each line, blank lines, and "
3552"lines starting with a B<#> symbol (comments) are ignored."
3553msgstr ""
3554
3555#. type: Plain text
3556#: deb-substvars.man:1
3557msgid "Additionally, the following standard variables are available:"
3558msgstr ""
3559
3560#. type: TP
3561#: deb-substvars.man:1
3562#, no-wrap
3563msgid "B<Arch>"
3564msgstr ""
3565
3566#. type: Plain text
3567#: deb-substvars.man:1
3568msgid ""
3569"The current host architecture (i.e. the architecture the package is being "
3570"built for, the equivalent of B<DEB_HOST_ARCH>)."
3571msgstr ""
3572
3573#. type: TP
3574#: deb-substvars.man:1 dpkg-query.man:1
3575#, no-wrap
3576msgid "B<source:Version>"
3577msgstr ""
3578
3579#. type: Plain text
3580#: deb-substvars.man:1
3581msgid "The source package version (since dpkg 1.13.19)."
3582msgstr ""
3583
3584#. type: TP
3585#: deb-substvars.man:1 dpkg-query.man:1
3586#, no-wrap
3587msgid "B<source:Upstream-Version>"
3588msgstr ""
3589
3590#. type: Plain text
3591#: deb-substvars.man:1
3592msgid ""
3593"The upstream source package version, including the Debian version epoch if "
3594"any (since dpkg 1.13.19)."
3595msgstr ""
3596
3597#. type: TP
3598#: deb-substvars.man:1
3599#, no-wrap
3600msgid "B<binary:Version>"
3601msgstr ""
3602
3603#. type: Plain text
3604#: deb-substvars.man:1
3605msgid ""
3606"The binary package version (which may differ from source:Version in a binNMU "
3607"for example; since dpkg 1.13.19)."
3608msgstr ""
3609
3610#. type: TP
3611#: deb-substvars.man:1
3612#, no-wrap
3613msgid "B<Source-Version>"
3614msgstr ""
3615
3616#. type: Plain text
3617#: deb-substvars.man:1
3618msgid ""
3619"The source package version (from the changelog file). This variable is now "
3620"B<obsolete> and emits an error when used as its meaning is different from "
3621"its function, please use the B<source:Version> or B<binary:Version> as "
3622"appropriate."
3623msgstr ""
3624
3625#. type: TP
3626#: deb-substvars.man:1
3627#, no-wrap
3628msgid "B<Installed-Size>"
3629msgstr ""
3630
3631#. type: Plain text
3632#: deb-substvars.man:1
3633msgid ""
3634"The approximate total size of the package's installed files. This value is "
3635"copied into the corresponding control file field; setting it will modify the "
3636"value of that field. If this variable is not set B<dpkg-gencontrol> will "
3637"compute the default value by accumulating the size of each regular file and "
3638"symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other "
3639"filesystem object type."
3640msgstr ""
3641
3642#. type: Plain text
3643#: deb-substvars.man:1
3644msgid ""
3645"B<Note:> Take into account that this can only ever be an approximation, as "
3646"the actual size used on the installed system will depend greatly on the "
3647"filesystem used and its parameters, which might end up using either more or "
3648"less space than the specified in this field."
3649msgstr ""
3650
3651#. type: TP
3652#: deb-substvars.man:1
3653#, no-wrap
3654msgid "B<Extra-Size>"
3655msgstr ""
3656
3657#. type: Plain text
3658#: deb-substvars.man:1
3659msgid ""
3660"Additional disk space used when the package is installed. If this variable "
3661"is set its value is added to that of the B<Installed-Size> variable (whether "
3662"set explicitly or using the default value) before it is copied into the "
3663"B<Installed-Size> control file field."
3664msgstr ""
3665
3666#. type: TP
3667#: deb-substvars.man:1
3668#, no-wrap
3669msgid "B<S:>I<fieldname>"
3670msgstr ""
3671
3672#. type: Plain text
3673#: deb-substvars.man:1
3674msgid ""
3675"The value of the source stanza field I<fieldname> (which must be given in "
3676"the canonical capitalisation; since dpkg 1.18.11). Setting these variables "
3677"has no effect other than on places where they are expanded explicitly. "
3678"These variables are only available when generating binary control files."
3679msgstr ""
3680
3681#. type: TP
3682#: deb-substvars.man:1
3683#, no-wrap
3684msgid "B<F:>I<fieldname>"
3685msgstr ""
3686
3687#. type: Plain text
3688#: deb-substvars.man:1
3689msgid ""
3690"The value of the output field I<fieldname> (which must be given in the "
3691"canonical capitalisation). Setting these variables has no effect other than "
3692"on places where they are expanded explicitly."
3693msgstr ""
3694
3695#. type: TP
3696#: deb-substvars.man:1
3697#, no-wrap
3698msgid "B<Format>"
3699msgstr ""
3700
3701#. type: Plain text
3702#: deb-substvars.man:1
3703msgid ""
3704"The B<.changes> file format version generated by this version of the source "
3705"packaging scripts. If you set this variable the contents of the B<Format> "
3706"field in the B<.changes> file will change too."
3707msgstr ""
3708
3709#. type: TP
3710#: deb-substvars.man:1
3711#, no-wrap
3712msgid "B<Newline>, B<Space>, B<Tab>"
3713msgstr ""
3714
3715#. type: Plain text
3716#: deb-substvars.man:1
3717msgid "These variables each hold the corresponding character."
3718msgstr ""
3719
3720#. type: TP
3721#: deb-substvars.man:1
3722#, no-wrap
3723msgid "B<shlibs:>I<dependencyfield>"
3724msgstr ""
3725
3726#. type: Plain text
3727#: deb-substvars.man:1
3728msgid ""
3729"Variable settings with names of this form are generated by "
3730"B<dpkg-shlibdeps>."
3731msgstr ""
3732
3733#. type: TP
3734#: deb-substvars.man:1
3735#, no-wrap
3736msgid "B<dpkg:Upstream-Version>"
3737msgstr ""
3738
3739#. type: Plain text
3740#: deb-substvars.man:1
3741msgid "The upstream version of dpkg (since dpkg 1.13.19)."
3742msgstr ""
3743
3744#. type: TP
3745#: deb-substvars.man:1
3746#, no-wrap
3747msgid "B<dpkg:Version>"
3748msgstr ""
3749
3750#. type: Plain text
3751#: deb-substvars.man:1
3752msgid "The full version of dpkg (since dpkg 1.13.19)."
3753msgstr ""
3754
3755#. type: Plain text
3756#: deb-substvars.man:1
3757msgid ""
3758"If a variable is referred to but not defined it generates a warning and an "
3759"empty value is assumed."
3760msgstr ""
3761
3762#. type: TP
3763#: deb-substvars.man:1
3764#, no-wrap
3765msgid "B<debian/substvars>"
3766msgstr ""
3767
3768#. type: Plain text
3769#: deb-substvars.man:1
3770msgid "List of substitution variables and values."
3771msgstr ""
3772
3773#. type: Plain text
3774#: deb-substvars.man:1
3775msgid ""
3776"B<dpkg>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), "
3777"B<dpkg-shlibdeps>(1), B<dpkg-source>(1)."
3778msgstr ""
3779
3780#. type: TH
3781#: deb-symbols.man:1
3782#, no-wrap
3783msgid "deb-symbols"
3784msgstr ""
3785
3786#. type: Plain text
3787#: deb-symbols.man:1
3788msgid "deb-symbols - Debian's extended shared library information file"
3789msgstr ""
3790
3791#. type: Plain text
3792#: deb-symbols.man:1
3793msgid "symbols"
3794msgstr ""
3795
3796#. type: Plain text
3797#: deb-symbols.man:1
3798msgid ""
3799"The symbol files are shipped in Debian binary packages, and its format is a "
3800"subset of the template symbol files used by B<dpkg-gensymbols>(1) in Debian "
3801"source packages."
3802msgstr ""
3803
3804#. type: Plain text
3805#: deb-symbols.man:1
3806msgid ""
3807"The format for an extended shared library dependency information entry in "
3808"these files is:"
3809msgstr ""
3810
3811#. type: Plain text
3812#: deb-symbols.man:1
3813msgid "I<library-soname main-dependency-template>"
3814msgstr ""
3815
3816#. type: Plain text
3817#: deb-symbols.man:1
3818msgid "[| I<alternative-dependency-template>]"
3819msgstr ""
3820
3821#. type: Plain text
3822#: deb-symbols.man:1
3823msgid "[...]"
3824msgstr ""
3825
3826#. type: Plain text
3827#: deb-symbols.man:1
3828msgid "[* I<field-name>: I<field-value>]"
3829msgstr ""
3830
3831#. type: Plain text
3832#: deb-symbols.man:1
3833#, no-wrap
3834msgid ""
3835"[...]\n"
3836" I<symbol> I<minimal-version> [I<id-of-dependency-template>]\n"
3837msgstr ""
3838
3839#. type: Plain text
3840#: deb-symbols.man:1
3841msgid ""
3842"The I<library-soname> is exactly the value of the SONAME field as exported "
3843"by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> "
3844"is dynamically replaced either by a version check like “(E<gt>= "
3845"I<minimal-version>)” or by nothing (if an unversioned dependency is deemed "
3846"sufficient)."
3847msgstr ""
3848
3849#. type: Plain text
3850#: deb-symbols.man:1
3851msgid ""
3852"Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being "
3853"“Base” if the library is not versioned) is associated to a "
3854"I<minimal-version> of its dependency template (the main dependency template "
3855"is always used and will end up being combined with the dependency template "
3856"referenced by I<id-of-dependency-template> if present). The first "
3857"alternative dependency template is numbered 1, the second one 2, etc."
3858msgstr ""
3859
3860#. type: Plain text
3861#: deb-symbols.man:1
3862msgid ""
3863"Each entry for a library can also have some fields of meta-information. "
3864"Those fields are stored on lines starting with an asterisk. Currently, the "
3865"only valid fields are:"
3866msgstr ""
3867
3868#. type: TP
3869#: deb-symbols.man:1
3870#, no-wrap
3871msgid "B<Build-Depends-Package>"
3872msgstr ""
3873
3874#. type: Plain text
3875#: deb-symbols.man:1
3876msgid ""
3877"It indicates the name of the “-dev” package associated to the library and is "
3878"used by B<dpkg-shlibdeps> to make sure that the dependency generated is at "
3879"least as strict as the corresponding build dependency (since dpkg 1.14.13)."
3880msgstr ""
3881
3882#. type: TP
3883#: deb-symbols.man:1
3884#, no-wrap
3885msgid "B<Ignore-Blacklist-Groups>"
3886msgstr ""
3887
3888#. type: Plain text
3889#: deb-symbols.man:1
3890msgid ""
3891"It indicates what blacklist groups should be ignored, as a whitespace "
3892"separated list, so that the symbols contained in those groups get included "
3893"in the output file (since dpkg 1.17.6). This should only be necessary for "
3894"toolchain packages providing those blacklisted symbols. The available groups "
3895"are system dependent, for ELF and GNU-based systems these are B<aeabi> and "
3896"B<gomp>."
3897msgstr ""
3898
3899#. type: SS
3900#: deb-symbols.man:1
3901#, no-wrap
3902msgid "Simple symbols file"
3903msgstr ""
3904
3905#. type: Plain text
3906#: deb-symbols.man:1
3907#, no-wrap
3908msgid ""
3909"libftp.so.3 libftp3 #MINVER#\n"
3910" DefaultNetbuf@Base 3.1-1-6\n"
3911" FtpAccess@Base 3.1-1-6\n"
3912" [...]\n"
3913msgstr ""
3914
3915#. type: SS
3916#: deb-symbols.man:1
3917#, no-wrap
3918msgid "Advanced symbols file"
3919msgstr ""
3920
3921#. type: Plain text
3922#: deb-symbols.man:1
3923msgid "libGL.so.1 libgl1"
3924msgstr ""
3925
3926#. type: Plain text
3927#: deb-symbols.man:1
3928msgid "| libgl1-mesa-glx #MINVER#"
3929msgstr ""
3930
3931#. type: Plain text
3932#: deb-symbols.man:1
3933#, no-wrap
3934msgid ""
3935"* Build-Depends-Package: libgl1-mesa-dev\n"
3936" publicGlSymbol@Base 6.3-1\n"
3937" [...]\n"
3938" implementationSpecificSymbol@Base 6.5.2-7 1\n"
3939" [...]\n"
3940msgstr ""
3941
3942#. type: Plain text
3943#: deb-symbols.man:1
3944msgid "B<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>"
3945msgstr ""
3946
3947#. type: Plain text
3948#: deb-symbols.man:1
3949msgid "B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
3950msgstr ""
3951
3952#. type: TH
3953#: deb-postinst.man:1
3954#, no-wrap
3955msgid "deb-postinst"
3956msgstr ""
3957
3958#. type: Plain text
3959#: deb-postinst.man:1
3960msgid "deb-postinst - package post-installation maintainer script"
3961msgstr ""
3962
3963#. type: Plain text
3964#: deb-postinst.man:1
3965msgid "postinst"
3966msgstr ""
3967
3968#. type: Plain text
3969#: deb-postinst.man:1
3970msgid ""
3971"A package can perform several post-installation actions via maintainer "
3972"scripts, by including an executable I<postinst> file in its control archive "
3973"(i.e. I<DEBIAN/postinst> during package creation)."
3974msgstr ""
3975
3976#. type: Plain text
3977#: deb-postinst.man:1 deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1
3978msgid "The script can be called in the following ways:"
3979msgstr ""
3980
3981#. type: TP
3982#: deb-postinst.man:1
3983#, no-wrap
3984msgid "I<postinst> B<configure> I<old-version>"
3985msgstr ""
3986
3987#. type: Plain text
3988#: deb-postinst.man:1
3989msgid "After the package was installed."
3990msgstr ""
3991
3992#. type: TP
3993#: deb-postinst.man:1
3994#, no-wrap
3995msgid "I<postinst> B<triggered> I<trigger-name...>"
3996msgstr ""
3997
3998#. type: Plain text
3999#: deb-postinst.man:1
4000msgid "After the package was triggered."
4001msgstr ""
4002
4003#. type: TP
4004#: deb-postinst.man:1
4005#, no-wrap
4006msgid "I<old-postinst> B<abort-upgrade> I<new-version>"
4007msgstr ""
4008
4009#. type: Plain text
4010#: deb-postinst.man:1
4011msgid "If I<prerm> fails during upgrade or fails on failed upgrade."
4012msgstr ""
4013
4014#. type: TP
4015#: deb-postinst.man:1
4016#, no-wrap
4017msgid "I<old-postinst> B<abort-remove>"
4018msgstr ""
4019
4020#. type: Plain text
4021#: deb-postinst.man:1
4022msgid "If I<prerm> fails during removal."
4023msgstr ""
4024
4025#. type: TP
4026#: deb-postinst.man:1
4027#, no-wrap
4028msgid "I<postinst> B<abort-deconfigure in-favour> I<new-package new-version>"
4029msgstr ""
4030
4031#. type: TQ
4032#: deb-postinst.man:1
4033#, no-wrap
4034msgid " [ B<removing> I<old-package old-version> ]"
4035msgstr ""
4036
4037#. type: Plain text
4038#: deb-postinst.man:1
4039msgid "If I<prerm> fails during deconfiguration of a package."
4040msgstr ""
4041
4042#. type: TP
4043#: deb-postinst.man:1
4044#, no-wrap
4045msgid "I<postinst> B<abort-remove in-favour> I<new-package new-version>"
4046msgstr ""
4047
4048#. type: Plain text
4049#: deb-postinst.man:1
4050msgid "If I<prerm> fails during replacement due to conflict."
4051msgstr ""
4052
4053#. type: Plain text
4054#: deb-postinst.man:1 deb-postrm.man:1 deb-preinst.man:1 deb-prerm.man:1
4055#: dpkg.cfg.man:1 dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
4056msgid "B<dpkg>(1)."
4057msgstr ""
4058
4059#. type: TH
4060#: deb-postrm.man:1
4061#, no-wrap
4062msgid "deb-postrm"
4063msgstr ""
4064
4065#. type: Plain text
4066#: deb-postrm.man:1
4067msgid "deb-postrm - package post-removal maintainer script"
4068msgstr ""
4069
4070#. type: Plain text
4071#: deb-postrm.man:1
4072msgid "postrm"
4073msgstr ""
4074
4075#. type: Plain text
4076#: deb-postrm.man:1
4077msgid ""
4078"A package can perform several post-removal actions via maintainer scripts, "
4079"by including an executable I<postrm> file in its control archive "
4080"(i.e. I<DEBIAN/postrm> during package creation)."
4081msgstr ""
4082
4083#. type: TP
4084#: deb-postrm.man:1
4085#, no-wrap
4086msgid "I<postrm> B<remove>"
4087msgstr ""
4088
4089#. type: Plain text
4090#: deb-postrm.man:1
4091msgid "After the package was removed."
4092msgstr ""
4093
4094#. type: TP
4095#: deb-postrm.man:1
4096#, no-wrap
4097msgid "I<postrm> B<purge>"
4098msgstr ""
4099
4100#. type: Plain text
4101#: deb-postrm.man:1
4102msgid "After the package was purged."
4103msgstr ""
4104
4105#. type: TP
4106#: deb-postrm.man:1
4107#, no-wrap
4108msgid "I<old-postrm> B<upgrade> I<new-version>"
4109msgstr ""
4110
4111#. type: Plain text
4112#: deb-postrm.man:1
4113msgid "After the package was upgraded."
4114msgstr ""
4115
4116#. type: TP
4117#: deb-postrm.man:1
4118#, no-wrap
4119msgid "I<new-postrm >B<failed-upgrade>I< old-version new-version>"
4120msgstr ""
4121
4122#. type: Plain text
4123#: deb-postrm.man:1
4124msgid "If the above B<upgrade> call fails."
4125msgstr ""
4126
4127#. type: TP
4128#: deb-postrm.man:1
4129#, no-wrap
4130msgid "I<postrm> B<disappear> I<overwriter-package> I<overwriter-version>"
4131msgstr ""
4132
4133#. type: Plain text
4134#: deb-postrm.man:1
4135msgid "After all of the packages files have been replaced."
4136msgstr ""
4137
4138#. type: TP
4139#: deb-postrm.man:1
4140#, no-wrap
4141msgid "I<new-postrm> B<abort-install>"
4142msgstr ""
4143
4144#. type: Plain text
4145#: deb-postrm.man:1
4146msgid "If I<preinst> fails during install."
4147msgstr ""
4148
4149#. type: TP
4150#: deb-postrm.man:1
4151#, no-wrap
4152msgid "I<new-postrm> B<abort-install> I<old-version new-version>"
4153msgstr ""
4154
4155#. type: Plain text
4156#: deb-postrm.man:1
4157msgid "If I<preinst> fails during upgrade of removed package."
4158msgstr ""
4159
4160#. type: TP
4161#: deb-postrm.man:1
4162#, no-wrap
4163msgid "I<new-postrm> B<abort-upgrade> I<old-version new-version>"
4164msgstr ""
4165
4166#. type: Plain text
4167#: deb-postrm.man:1
4168msgid "If I<preinst> fails during upgrade."
4169msgstr ""
4170
4171#. type: TH
4172#: deb-preinst.man:1
4173#, no-wrap
4174msgid "deb-preinst"
4175msgstr ""
4176
4177#. type: Plain text
4178#: deb-preinst.man:1
4179msgid "deb-preinst - package pre-installation maintainer script"
4180msgstr ""
4181
4182#. type: Plain text
4183#: deb-preinst.man:1
4184msgid "preinst"
4185msgstr ""
4186
4187#. type: Plain text
4188#: deb-preinst.man:1
4189msgid ""
4190"A package can perform several pre-installation actions via maintainer "
4191"scripts, by including an executable I<preinst> file in its control archive "
4192"(i.e. I<DEBIAN/preinst> during package creation)."
4193msgstr ""
4194
4195#. type: TP
4196#: deb-preinst.man:1
4197#, no-wrap
4198msgid "I<new-preinst> B<install>"
4199msgstr ""
4200
4201#. type: Plain text
4202#: deb-preinst.man:1
4203msgid "Before the package is installed."
4204msgstr ""
4205
4206#. type: TP
4207#: deb-preinst.man:1
4208#, no-wrap
4209msgid "I<new-preinst> B<install> I<old-version new-version>"
4210msgstr ""
4211
4212#. type: Plain text
4213#: deb-preinst.man:1
4214msgid "Before removed package is upgraded."
4215msgstr ""
4216
4217#. type: TP
4218#: deb-preinst.man:1
4219#, no-wrap
4220msgid "I<new-preinst> B<upgrade> I<old-version new-version>"
4221msgstr ""
4222
4223#. type: Plain text
4224#: deb-preinst.man:1
4225msgid "Before the package is upgraded."
4226msgstr ""
4227
4228#. type: TP
4229#: deb-preinst.man:1
4230#, no-wrap
4231msgid "I<old-preinst> B<abort-upgrade> I<new-version>"
4232msgstr ""
4233
4234#. type: Plain text
4235#: deb-preinst.man:1
4236msgid "If I<postrm> fails during upgrade or fails on failed upgrade."
4237msgstr ""
4238
4239#. type: TH
4240#: deb-prerm.man:1
4241#, no-wrap
4242msgid "deb-prerm"
4243msgstr ""
4244
4245#. type: Plain text
4246#: deb-prerm.man:1
4247msgid "deb-prerm - package pre-removal maintainer script"
4248msgstr ""
4249
4250#. type: Plain text
4251#: deb-prerm.man:1
4252msgid "prerm"
4253msgstr ""
4254
4255#. type: Plain text
4256#: deb-prerm.man:1
4257msgid ""
4258"A package can perform several pre-removal actions via maintainer scripts, by "
4259"including an executable I<prerm> file in its control archive "
4260"(i.e. I<DEBIAN/prerm> during package creation)."
4261msgstr ""
4262
4263#. type: TP
4264#: deb-prerm.man:1
4265#, no-wrap
4266msgid "I<prerm> B<remove>"
4267msgstr ""
4268
4269#. type: Plain text
4270#: deb-prerm.man:1
4271msgid "Before the package is removed."
4272msgstr ""
4273
4274#. type: TP
4275#: deb-prerm.man:1
4276#, no-wrap
4277msgid "I<old-prerm> B<upgrade> I<new-version>"
4278msgstr ""
4279
4280#. type: Plain text
4281#: deb-prerm.man:1
4282msgid "Before an upgrade."
4283msgstr ""
4284
4285#. type: TP
4286#: deb-prerm.man:1
4287#, no-wrap
4288msgid "I<new-prerm> B<failed-upgrade> I<old-version new-version>"
4289msgstr ""
4290
4291#. type: Plain text
4292#: deb-prerm.man:1
4293msgid "If the above B<upgrade> fails."
4294msgstr ""
4295
4296#. type: TP
4297#: deb-prerm.man:1
4298#, no-wrap
4299msgid "I<prerm> B<deconfigure in-favour> I<new-package new-version>"
4300msgstr ""
4301
4302#. type: TQ
4303#: deb-prerm.man:1
4304#, no-wrap
4305msgid " [ B<removing> I<old-package old-version> ]"
4306msgstr ""
4307
4308#. type: Plain text
4309#: deb-prerm.man:1
4310msgid "Before package is deconfigured while dependency is replaced due to conflict."
4311msgstr ""
4312
4313#. type: TP
4314#: deb-prerm.man:1
4315#, no-wrap
4316msgid "I<prerm> B<remove in-favour> I<new-package new-version>"
4317msgstr ""
4318
4319#. type: Plain text
4320#: deb-prerm.man:1
4321msgid "Before the package is replaced due to conflict."
4322msgstr ""
4323
4324#. type: TH
4325#: deb-triggers.man:1
4326#, no-wrap
4327msgid "deb-triggers"
4328msgstr ""
4329
4330#. type: Plain text
4331#: deb-triggers.man:1
4332msgid "deb-triggers - package triggers"
4333msgstr ""
4334
4335#. type: Plain text
4336#: deb-triggers.man:1
4337msgid "triggers"
4338msgstr ""
4339
4340#. type: Plain text
4341#: deb-triggers.man:1
4342msgid ""
4343"A package declares its relationship to some trigger(s) by including a "
4344"I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during "
4345"package creation)."
4346msgstr ""
4347
4348#. type: Plain text
4349#: deb-triggers.man:1
4350msgid ""
4351"This file contains directives, one per line. Leading and trailing whitespace "
4352"and everything after the first B<#> on any line will be trimmed, and empty "
4353"lines will be ignored."
4354msgstr ""
4355
4356#. type: Plain text
4357#: deb-triggers.man:1
4358msgid "The trigger control directives currently supported are:"
4359msgstr ""
4360
4361#. type: TP
4362#: deb-triggers.man:1
4363#, no-wrap
4364msgid "B<interest> I<trigger-name>"
4365msgstr ""
4366
4367#. type: TQ
4368#: deb-triggers.man:1
4369#, no-wrap
4370msgid "B<interest-await> I<trigger-name>"
4371msgstr ""
4372
4373#. type: TQ
4374#: deb-triggers.man:1
4375#, no-wrap
4376msgid "B<interest-noawait> I<trigger-name>"
4377msgstr ""
4378
4379#. type: Plain text
4380#: deb-triggers.man:1
4381msgid ""
4382"Specifies that the package is interested in the named trigger. All triggers "
4383"in which a package is interested must be listed using this directive in the "
4384"triggers control file. The “noawait” variant does not put the triggering "
4385"packages in triggers-awaited state. This should be used when the "
4386"functionality provided by the trigger is not crucial."
4387msgstr ""
4388
4389#. type: TP
4390#: deb-triggers.man:1
4391#, no-wrap
4392msgid "B<activate> I<trigger-name>"
4393msgstr ""
4394
4395#. type: TQ
4396#: deb-triggers.man:1
4397#, no-wrap
4398msgid "B<activate-await> I<trigger-name>"
4399msgstr ""
4400
4401#. type: TQ
4402#: deb-triggers.man:1
4403#, no-wrap
4404msgid "B<activate-noawait> I<trigger-name>"
4405msgstr ""
4406
4407#. type: Plain text
4408#: deb-triggers.man:1
4409msgid ""
4410"Arranges that changes to this package's state will activate the specified "
4411"trigger. The trigger will be activated at the start of the following "
4412"operations: unpack, configure, remove (including for the benefit of a "
4413"conflicting package), purge and deconfigure. The “noawait” variant does not "
4414"put the triggering packages in triggers-awaited state. This should be used "
4415"when the functionality provided by the trigger is not crucial."
4416msgstr ""
4417
4418#. type: Plain text
4419#: deb-triggers.man:1
4420msgid ""
4421"If this package disappears during the unpacking of another package the "
4422"trigger will be activated when the disappearance is noted towards the end of "
4423"the unpack. Trigger processing, and transition from triggers-awaited to "
4424"installed, does not cause activations. In the case of unpack, triggers "
4425"mentioned in both the old and new versions of the package will be activated."
4426msgstr ""
4427
4428#. type: Plain text
4429#: deb-triggers.man:1
4430msgid ""
4431"Unknown directives are an error which will prevent installation of the "
4432"package."
4433msgstr ""
4434
4435#. type: Plain text
4436#: deb-triggers.man:1
4437msgid ""
4438"The “-noawait” variants should always be favored when possible since "
4439"triggering packages are not put in triggers-awaited state and can thus be "
4440"immediately configured without requiring the processing of the trigger. If "
4441"the triggering packages are dependencies of other upgraded packages, it will "
4442"avoid an early trigger processing run and make it possible to run the "
4443"trigger only once as one of the last steps of the upgrade."
4444msgstr ""
4445
4446#. type: Plain text
4447#: deb-triggers.man:1
4448msgid ""
4449"The “-noawait” variants are only supported since dpkg 1.16.1, and will lead "
4450"to errors if used with an older dpkg. It is thus recommended to add a "
4451"“Pre-Depends: dpkg (E<gt>= 1.16.1)” to any package that wish to use those "
4452"directives."
4453msgstr ""
4454
4455#. type: Plain text
4456#: deb-triggers.man:1
4457msgid ""
4458"The “-await” alias variants are only supported since dpkg 1.17.21, and will "
4459"lead to errors if used with an older dpkg. It is thus recommended to add a "
4460"“Pre-Depends: dpkg (E<gt>= 1.17.21)” to any package that wish to use those "
4461"directives."
4462msgstr ""
4463
4464#. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
4465#. type: Plain text
4466#: deb-triggers.man:1
4467msgid "B<dpkg-trigger>(1), B<dpkg>(1), B</usr/share/doc/dpkg-dev/triggers.txt.gz>."
4468msgstr ""
4469
4470#. type: TH
4471#: dsc.man:1
4472#, no-wrap
4473msgid "dsc"
4474msgstr ""
4475
4476#. type: Plain text
4477#: dsc.man:1
4478msgid "dsc - Debian source packages' control file format"
4479msgstr ""
4480
4481#. type: Plain text
4482#: dsc.man:1
4483msgid "I<filename>B<.dsc>"
4484msgstr ""
4485
4486#. type: Plain text
4487#: dsc.man:1
4488msgid ""
4489"Each Debian source package is composed of a .dsc control file, which "
4490"contains a number of fields. Each field begins with a tag, such as "
4491"B<Source> or B<Binary> (case insensitive), followed by a colon, and the body "
4492"of the field. Fields are delimited only by field tags. In other words, "
4493"field text may be multiple lines in length, but the installation tools will "
4494"generally join lines when processing the body of the field (except in case "
4495"of the multiline fields B<Package-List>, B<Files>, B<Checksums-Sha1> and "
4496"B<Checksums-Sha256>, see below)."
4497msgstr ""
4498
4499#. type: Plain text
4500#: dsc.man:1
4501msgid ""
4502"The value of this field declares the format version of the source package. "
4503"The field value is used by programs acting on a source package to interpret "
4504"the list of files in the source package and determine how to unpack it. The "
4505"syntax of the field value is a numeric major revision, a period, a numeric "
4506"minor revision, and then an optional subtype after whitespace, which if "
4507"specified is an alphanumeric word in parentheses. The subtype is optional "
4508"in the syntax but may be mandatory for particular source format revisions."
4509msgstr ""
4510
4511#. type: Plain text
4512#: dsc.man:1
4513msgid ""
4514"The source formats currently supported by B<dpkg> are B<1.0>, B<2.0>, B<3.0 "
4515"(native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> and B<3.0 (custom)>."
4516msgstr ""
4517
4518#. type: TP
4519#: dsc.man:1
4520#, no-wrap
4521msgid "B<Source:> I<source-name> (required)"
4522msgstr ""
4523
4524#. type: TP
4525#: dsc.man:1
4526#, no-wrap
4527msgid "B<Binary:>I< binary-package-list>"
4528msgstr ""
4529
4530#. type: Plain text
4531#: dsc.man:1
4532msgid ""
4533"This folded field lists binary packages which this source package can "
4534"produce, separated by commas."
4535msgstr ""
4536
4537#. type: Plain text
4538#: dsc.man:1
4539msgid ""
4540"This field has now been superseded by the B<Package-List> field, which gives "
4541"enough information about what binary packages are produced on which "
4542"architecture, build-profile and other involved restrictions."
4543msgstr ""
4544
4545#. type: TP
4546#: dsc.man:1
4547#, no-wrap
4548msgid "B<Architecture:> I<arch-list> (recommended)"
4549msgstr ""
4550
4551#. type: Plain text
4552#: dsc.man:1
4553msgid ""
4554"A list of architectures and architecture wildcards separated by spaces which "
4555"specify the type of hardware this package can be compiled for. Common "
4556"architecture names and architecture wildcards are B<amd64>, B<armel>, "
4557"B<i386>, B<linux-any>, B<any-amd64>, etc."
4558msgstr ""
4559
4560#. type: Plain text
4561#: dsc.man:1
4562msgid ""
4563"Note that the B<all> value is meant for packages that are architecture "
4564"independent, and B<any> for packages that are architecture dependent. The "
4565"list may include (or consist solely of) the special value B<all>. When the "
4566"list contains the architecture wildcard B<any>, the only other value allowed "
4567"in the list is B<all>."
4568msgstr ""
4569
4570#. type: Plain text
4571#: dsc.man:1
4572msgid ""
4573"The field value is generally generated from B<Architecture> fields from in "
4574"the I<debian/control> in the source package."
4575msgstr ""
4576
4577#. type: TP
4578#: dsc.man:1
4579#, no-wrap
4580msgid "B<Uploaders:>I< fullname-email-list>"
4581msgstr ""
4582
4583#. type: TP
4584#: dsc.man:1
4585#, no-wrap
4586msgid "B<Standards-Version:> I<version-string> (recommended)"
4587msgstr ""
4588
4589#. type: Plain text
4590#: dsc.man:1
4591msgid ""
4592"The I<url> of a web interface to browse the Version Control System "
4593"repository."
4594msgstr ""
4595
4596#. type: Plain text
4597#: dsc.man:1
4598msgid ""
4599"These fields declare the I<url> of the Version Control System repository "
4600"used to maintain this package. See B<deb-src-control>(5) for more details."
4601msgstr ""
4602
4603#. type: TP
4604#: dsc.man:1
4605#, no-wrap
4606msgid "B<Testsuite:>I< name-list>"
4607msgstr ""
4608
4609#. type: Plain text
4610#: dsc.man:1
4611msgid ""
4612"This field declares that the source package contains the specified test "
4613"suites. The value is a space-separated list of test suites. If the "
4614"B<autopkgtest> value is present, a I<debian/tests/control> is expected to be "
4615"present, if the file is present but not the value, then B<dpkg-source> will "
4616"automatically add it, preserving previous values."
4617msgstr ""
4618
4619#. type: TP
4620#: dsc.man:1
4621#, no-wrap
4622msgid "B<Testsuite-Triggers:>I< package-list>"
4623msgstr ""
4624
4625#. type: Plain text
4626#: dsc.man:1
4627msgid ""
4628"This field declares the comma-separated union of all test dependencies "
4629"(B<Depends> fields in I<debian/tests/control> file), with all restrictions "
4630"removed, and OR dependencies flattened, except for binaries generated by "
4631"this source package and meta-dependencies such as B<@> or B<@builddeps@>."
4632msgstr ""
4633
4634#. type: Plain text
4635#: dsc.man:1
4636msgid ""
4637"Rationale: this field is needed because otherwise to be able to get the test "
4638"dependencies, each source package would need to be unpacked."
4639msgstr ""
4640
4641#. type: Plain text
4642#: dsc.man:1
4643msgid ""
4644"These fields declare relationships between the source package and packages "
4645"used to build it. They are discussed in the B<deb-src-control>(5) manpage."
4646msgstr ""
4647
4648#. type: TP
4649#: dsc.man:1
4650#, no-wrap
4651msgid "B<Package-List:>"
4652msgstr ""
4653
4654#. type: TQ
4655#: dsc.man:1
4656#, no-wrap
4657msgid " I<package> I<package-type> I<section> I<priority> I<key-value-list>"
4658msgstr ""
4659
4660#. type: Plain text
4661#: dsc.man:1
4662msgid ""
4663"This multiline field contains a list of binary packages generated by this "
4664"source package."
4665msgstr ""
4666
4667#. type: Plain text
4668#: dsc.man:1
4669msgid "The I<package> is the binary package name."
4670msgstr ""
4671
4672#. type: Plain text
4673#: dsc.man:1
4674msgid ""
4675"The I<package-type> is the binary package type, usually B<deb>, another "
4676"common value is B<udeb>."
4677msgstr ""
4678
4679#. type: Plain text
4680#: dsc.man:1
4681msgid ""
4682"The I<section> and I<priority> match the binary package fields of the same "
4683"name."
4684msgstr ""
4685
4686#. type: Plain text
4687#: dsc.man:1
4688msgid ""
4689"The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the "
4690"currently known optional keys are:"
4691msgstr ""
4692
4693#. type: TP
4694#: dsc.man:1
4695#, no-wrap
4696msgid "B<arch>"
4697msgstr ""
4698
4699#. type: Plain text
4700#: dsc.man:1
4701msgid ""
4702"The architecture restriction from the binary package B<Architecture> field, "
4703"with spaces converted to ‘,’."
4704msgstr ""
4705
4706#. type: TP
4707#: dsc.man:1
4708#, no-wrap
4709msgid "B<profile>"
4710msgstr ""
4711
4712#. type: Plain text
4713#: dsc.man:1
4714msgid ""
4715"The normalized build-profile restriction formula from the binary package "
4716"B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’."
4717msgstr ""
4718
4719#. type: TP
4720#: dsc.man:1
4721#, no-wrap
4722msgid "B<essential>"
4723msgstr ""
4724
4725#. type: Plain text
4726#: dsc.man:1
4727msgid ""
4728"If the binary package is essential, this key will contain the value of the "
4729"B<Essential> field, that is a B<yes> value."
4730msgstr ""
4731
4732#. type: Plain text
4733#: dsc.man:1
4734msgid ""
4735"These multiline fields contain a list of files with a checksum and size for "
4736"each one. These fields have the same syntax and differ only in the checksum "
4737"algorithm used: MD5 for B<Files>, SHA-1 for B<Checksums-Sha1> and SHA-256 "
4738"for B<Checksums-Sha256>."
4739msgstr ""
4740
4741#. type: Plain text
4742#: dsc.man:1
4743msgid ""
4744"The first line of the field value (the part on the same line as the field "
4745"name followed by a colon) is always empty. The content of the field is "
4746"expressed as continuation lines, one line per file. Each line consists of "
4747"the checksum, a space, the file size, a space, and the file name."
4748msgstr ""
4749
4750#. type: Plain text
4751#: dsc.man:1
4752msgid ""
4753"These fields list all files that make up the source package. The list of "
4754"files in these fields must match the list of files in the other related "
4755"fields."
4756msgstr ""
4757
4758#. type: Plain text
4759#: dsc.man:1
4760msgid ""
4761"The B<Format> field conflates the format for the B<.dsc> file itself and the "
4762"format of the extracted source package."
4763msgstr ""
4764
4765#. type: Plain text
4766#: dsc.man:1
4767msgid "B<deb-src-control>(5), B<deb-version>(5), B<dpkg-source>(1)."
4768msgstr ""
4769
4770#. type: TH
4771#: dpkg.man:1
4772#, no-wrap
4773msgid "dpkg"
4774msgstr ""
4775
4776#. type: Plain text
4777#: dpkg.man:1
4778msgid "dpkg - package manager for Debian"
4779msgstr ""
4780
4781#. type: Plain text
4782#: dpkg.man:1
4783msgid "B<dpkg> [I<option>...] I<action>"
4784msgstr ""
4785
4786#. type: SH
4787#: dpkg.man:1
4788#, no-wrap
4789msgid "WARNING"
4790msgstr ""
4791
4792#. type: Plain text
4793#: dpkg.man:1
4794msgid ""
4795"This manual is intended for users wishing to understand B<dpkg>'s command "
4796"line options and package states in more detail than that provided by B<dpkg "
4797"--help>."
4798msgstr ""
4799
4800#. type: Plain text
4801#: dpkg.man:1
4802msgid ""
4803"It should I<not> be used by package maintainers wishing to understand how "
4804"B<dpkg> will install their packages. The descriptions of what B<dpkg> does "
4805"when installing and removing packages are particularly inadequate."
4806msgstr ""
4807
4808#. type: Plain text
4809#: dpkg.man:1
4810msgid ""
4811"B<dpkg> is a tool to install, build, remove and manage Debian packages. The "
4812"primary and more user-friendly front-end for B<dpkg> is "
4813"B<aptitude>(1). B<dpkg> itself is controlled entirely via command line "
4814"parameters, which consist of exactly one action and zero or more "
4815"options. The action-parameter tells B<dpkg> what to do and options control "
4816"the behavior of the action in some way."
4817msgstr ""
4818
4819#. type: Plain text
4820#: dpkg.man:1
4821msgid ""
4822"B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and "
4823"B<dpkg-query>(1). The list of supported actions can be found later on in the "
4824"B<ACTIONS> section. If any such action is encountered B<dpkg> just runs "
4825"B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no "
4826"specific options are currently passed to them, to use any such option the "
4827"back-ends need to be called directly."
4828msgstr ""
4829
4830#. type: SH
4831#: dpkg.man:1
4832#, no-wrap
4833msgid "INFORMATION ABOUT PACKAGES"
4834msgstr ""
4835
4836#. type: Plain text
4837#: dpkg.man:1
4838msgid ""
4839"B<dpkg> maintains some usable information about available packages. The "
4840"information is divided in three classes: B<states>, B<selection states> and "
4841"B<flags>. These values are intended to be changed mainly with B<dselect>."
4842msgstr ""
4843
4844#. type: SS
4845#: dpkg.man:1
4846#, no-wrap
4847msgid "Package states"
4848msgstr ""
4849
4850#. type: TP
4851#: dpkg.man:1
4852#, no-wrap
4853msgid "B<not-installed>"
4854msgstr ""
4855
4856#. type: Plain text
4857#: dpkg.man:1
4858msgid "The package is not installed on your system."
4859msgstr ""
4860
4861#. type: TP
4862#: dpkg.man:1
4863#, no-wrap
4864msgid "B<config-files>"
4865msgstr ""
4866
4867#. type: Plain text
4868#: dpkg.man:1
4869msgid "Only the configuration files of the package exist on the system."
4870msgstr ""
4871
4872#. type: TP
4873#: dpkg.man:1
4874#, no-wrap
4875msgid "B<half-installed>"
4876msgstr ""
4877
4878#. type: Plain text
4879#: dpkg.man:1
4880msgid ""
4881"The installation of the package has been started, but not completed for some "
4882"reason."
4883msgstr ""
4884
4885#. type: TP
4886#: dpkg.man:1
4887#, no-wrap
4888msgid "B<unpacked>"
4889msgstr ""
4890
4891#. type: Plain text
4892#: dpkg.man:1
4893msgid "The package is unpacked, but not configured."
4894msgstr ""
4895
4896#. type: TP
4897#: dpkg.man:1
4898#, no-wrap
4899msgid "B<half-configured>"
4900msgstr ""
4901
4902#. type: Plain text
4903#: dpkg.man:1
4904msgid ""
4905"The package is unpacked and configuration has been started, but not yet "
4906"completed for some reason."
4907msgstr ""
4908
4909#. type: TP
4910#: dpkg.man:1
4911#, no-wrap
4912msgid "B<triggers-awaited>"
4913msgstr ""
4914
4915#. type: Plain text
4916#: dpkg.man:1
4917msgid "The package awaits trigger processing by another package."
4918msgstr ""
4919
4920#. type: TP
4921#: dpkg.man:1
4922#, no-wrap
4923msgid "B<triggers-pending>"
4924msgstr ""
4925
4926#. type: Plain text
4927#: dpkg.man:1
4928msgid "The package has been triggered."
4929msgstr ""
4930
4931#. type: TP
4932#: dpkg.man:1
4933#, no-wrap
4934msgid "B<installed>"
4935msgstr ""
4936
4937#. type: Plain text
4938#: dpkg.man:1
4939msgid "The package is correctly unpacked and configured."
4940msgstr ""
4941
4942#. type: SS
4943#: dpkg.man:1
4944#, no-wrap
4945msgid "Package selection states"
4946msgstr ""
4947
4948#. type: TP
4949#: dpkg.man:1
4950#, no-wrap
4951msgid "B<install>"
4952msgstr ""
4953
4954#. type: Plain text
4955#: dpkg.man:1
4956msgid "The package is selected for installation."
4957msgstr ""
4958
4959#. type: TP
4960#: dpkg.man:1
4961#, no-wrap
4962msgid "B<hold>"
4963msgstr ""
4964
4965#. type: Plain text
4966#: dpkg.man:1
4967msgid ""
4968"A package marked to be on B<hold> is not handled by B<dpkg>, unless forced "
4969"to do that with option B<--force-hold>."
4970msgstr ""
4971
4972#. type: TP
4973#: dpkg.man:1
4974#, no-wrap
4975msgid "B<deinstall>"
4976msgstr ""
4977
4978#. type: Plain text
4979#: dpkg.man:1
4980msgid ""
4981"The package is selected for deinstallation (i.e. we want to remove all "
4982"files, except configuration files)."
4983msgstr ""
4984
4985#. type: TP
4986#: dpkg.man:1
4987#, no-wrap
4988msgid "B<purge>"
4989msgstr ""
4990
4991#. type: Plain text
4992#: dpkg.man:1
4993msgid ""
4994"The package is selected to be purged (i.e. we want to remove everything from "
4995"system directories, even configuration files)."
4996msgstr ""
4997
4998#. type: SS
4999#: dpkg.man:1
5000#, no-wrap
5001msgid "Package flags"
5002msgstr ""
5003
5004#. type: TP
5005#: dpkg.man:1
5006#, no-wrap
5007msgid "B<ok>"
5008msgstr ""
5009
5010#. type: Plain text
5011#: dpkg.man:1
5012msgid ""
5013"A package marked B<ok> is in a known state, but might need further "
5014"processing."
5015msgstr ""
5016
5017#. type: TP
5018#: dpkg.man:1
5019#, no-wrap
5020msgid "B<reinstreq>"
5021msgstr ""
5022
5023#. type: Plain text
5024#: dpkg.man:1
5025msgid ""
5026"A package marked B<reinstreq> is broken and requires reinstallation. These "
5027"packages cannot be removed, unless forced with option "
5028"B<--force-remove-reinstreq>."
5029msgstr ""
5030
5031#. type: SH
5032#: dpkg.man:1
5033#, no-wrap
5034msgid "ACTIONS"
5035msgstr ""
5036
5037#. type: TP
5038#: dpkg.man:1
5039#, no-wrap
5040msgid "B<-i>, B<--install> I<package-file>..."
5041msgstr ""
5042
5043#. type: Plain text
5044#: dpkg.man:1
5045msgid ""
5046"Install the package. If B<--recursive> or B<-R> option is specified, "
5047"I<package-file> must refer to a directory instead."
5048msgstr ""
5049
5050#. type: Plain text
5051#: dpkg.man:1
5052msgid "Installation consists of the following steps:"
5053msgstr ""
5054
5055#. type: Plain text
5056#: dpkg.man:1
5057msgid "B<1.> Extract the control files of the new package."
5058msgstr ""
5059
5060#. type: Plain text
5061#: dpkg.man:1
5062msgid ""
5063"B<2.> If another version of the same package was installed before the new "
5064"installation, execute I<prerm> script of the old package."
5065msgstr ""
5066
5067#. type: Plain text
5068#: dpkg.man:1
5069msgid "B<3.> Run I<preinst> script, if provided by the package."
5070msgstr ""
5071
5072#. type: Plain text
5073#: dpkg.man:1
5074msgid ""
5075"B<4.> Unpack the new files, and at the same time back up the old files, so "
5076"that if something goes wrong, they can be restored."
5077msgstr ""
5078
5079#. type: Plain text
5080#: dpkg.man:1
5081msgid ""
5082"B<5.> If another version of the same package was installed before the new "
5083"installation, execute the I<postrm> script of the old package. Note that "
5084"this script is executed after the I<preinst> script of the new package, "
5085"because new files are written at the same time old files are removed."
5086msgstr ""
5087
5088#. type: Plain text
5089#: dpkg.man:1
5090msgid ""
5091"B<6.> Configure the package. See B<--configure> for detailed information "
5092"about how this is done."
5093msgstr ""
5094
5095#. type: TP
5096#: dpkg.man:1
5097#, no-wrap
5098msgid "B<--unpack >I<package-file>..."
5099msgstr ""
5100
5101#. type: Plain text
5102#: dpkg.man:1
5103msgid ""
5104"Unpack the package, but don't configure it. If B<--recursive> or B<-R> "
5105"option is specified, I<package-file> must refer to a directory instead."
5106msgstr ""
5107
5108#. type: TP
5109#: dpkg.man:1
5110#, no-wrap
5111msgid "B<--configure >I<package>...|B<-a>|B<--pending>"
5112msgstr ""
5113
5114#. type: Plain text
5115#: dpkg.man:1
5116msgid ""
5117"Configure a package which has been unpacked but not yet configured. If "
5118"B<-a> or B<--pending> is given instead of I<package>, all unpacked but "
5119"unconfigured packages are configured."
5120msgstr ""
5121
5122#. type: Plain text
5123#: dpkg.man:1
5124msgid ""
5125"To reconfigure a package which has already been configured, try the "
5126"B<dpkg-reconfigure>(8) command instead."
5127msgstr ""
5128
5129#. type: Plain text
5130#: dpkg.man:1
5131msgid "Configuring consists of the following steps:"
5132msgstr ""
5133
5134#. type: Plain text
5135#: dpkg.man:1
5136msgid ""
5137"B<1.> Unpack the conffiles, and at the same time back up the old conffiles, "
5138"so that they can be restored if something goes wrong."
5139msgstr ""
5140
5141#. type: Plain text
5142#: dpkg.man:1
5143msgid "B<2.> Run I<postinst> script, if provided by the package."
5144msgstr ""
5145
5146#. type: TP
5147#: dpkg.man:1
5148#, no-wrap
5149msgid "B<--triggers-only> I<package>...|B<-a>|B<--pending>"
5150msgstr ""
5151
5152#. type: Plain text
5153#: dpkg.man:1
5154msgid ""
5155"Processes only triggers (since dpkg 1.14.17). All pending triggers will be "
5156"processed. If package names are supplied only those packages' triggers will "
5157"be processed, exactly once each where necessary. Use of this option may "
5158"leave packages in the improper B<triggers-awaited> and B<triggers-pending> "
5159"states. This can be fixed later by running: B<dpkg --configure --pending>."
5160msgstr ""
5161
5162#. type: TP
5163#: dpkg.man:1
5164#, no-wrap
5165msgid "B<-r>, B<--remove> I<package>...|B<-a>|B<--pending>"
5166msgstr ""
5167
5168#. type: Plain text
5169#: dpkg.man:1
5170msgid ""
5171"Remove an installed package. This removes everything except conffiles, which "
5172"may avoid having to reconfigure the package if it is reinstalled later "
5173"(conffiles are configuration files that are listed in the "
5174"I<DEBIAN/conffiles> control file). If B<-a> or B<--pending> is given "
5175"instead of a package name, then all packages unpacked, but marked to be "
5176"removed in file I<%ADMINDIR%/status>, are removed."
5177msgstr ""
5178
5179#. type: Plain text
5180#: dpkg.man:1
5181msgid "Removing of a package consists of the following steps:"
5182msgstr ""
5183
5184#. type: Plain text
5185#: dpkg.man:1
5186msgid "B<1.> Run I<prerm> script"
5187msgstr ""
5188
5189#. type: Plain text
5190#: dpkg.man:1
5191msgid "B<2.> Remove the installed files"
5192msgstr ""
5193
5194#. type: Plain text
5195#: dpkg.man:1
5196msgid "B<3.> Run I<postrm> script"
5197msgstr ""
5198
5199#. type: TP
5200#: dpkg.man:1
5201#, no-wrap
5202msgid "B<-P>, B<--purge> I<package>...|B<-a>|B<--pending>"
5203msgstr ""
5204
5205#. type: Plain text
5206#: dpkg.man:1
5207msgid ""
5208"Purge an installed or already removed package. This removes everything, "
5209"including conffiles. If B<-a> or B<--pending> is given instead of a package "
5210"name, then all packages unpacked or removed, but marked to be purged in file "
5211"I<%ADMINDIR%/status>, are purged."
5212msgstr ""
5213
5214#. type: Plain text
5215#: dpkg.man:1
5216msgid ""
5217"Note: some configuration files might be unknown to B<dpkg> because they are "
5218"created and handled separately through the configuration scripts. In that "
5219"case, B<dpkg> won't remove them by itself, but the package's I<postrm> "
5220"script (which is called by B<dpkg>), has to take care of their removal "
5221"during purge. Of course, this only applies to files in system directories, "
5222"not configuration files written to individual users' home directories."
5223msgstr ""
5224
5225#. type: Plain text
5226#: dpkg.man:1
5227msgid "Purging of a package consists of the following steps:"
5228msgstr ""
5229
5230#. type: Plain text
5231#: dpkg.man:1
5232msgid ""
5233"B<1.> Remove the package, if not already removed. See B<--remove> for "
5234"detailed information about how this is done."
5235msgstr ""
5236
5237#. type: Plain text
5238#: dpkg.man:1
5239msgid "B<2.> Run I<postrm> script."
5240msgstr ""
5241
5242#. type: TP
5243#: dpkg.man:1
5244#, no-wrap
5245msgid "B<-V>, B<--verify> [I<package-name>...]"
5246msgstr ""
5247
5248#. type: Plain text
5249#: dpkg.man:1
5250msgid ""
5251"Verifies the integrity of I<package-name> or all packages if omitted, by "
5252"comparing information from the files installed by a package with the files "
5253"metadata information stored in the B<dpkg> database (since dpkg 1.17.2). "
5254"The origin of the files metadata information in the database is the binary "
5255"packages themselves. That metadata gets collected at package unpack time "
5256"during the installation process."
5257msgstr ""
5258
5259#. type: Plain text
5260#: dpkg.man:1
5261msgid ""
5262"Currently the only functional check performed is an md5sum verification of "
5263"the file contents against the stored value in the files database. It will "
5264"only get checked if the database contains the file md5sum. To check for any "
5265"missing metadata in the database, the B<--audit> command can be used."
5266msgstr ""
5267
5268#. type: Plain text
5269#: dpkg.man:1
5270msgid ""
5271"The output format is selectable with the B<--verify-format> option, which by "
5272"default uses the B<rpm> format, but that might change in the future, and as "
5273"such, programs parsing this command output should be explicit about the "
5274"format they expect."
5275msgstr ""
5276
5277#. type: TP
5278#: dpkg.man:1
5279#, no-wrap
5280msgid "B<-C>, B<--audit> [I<package-name>...]"
5281msgstr ""
5282
5283#. type: Plain text
5284#: dpkg.man:1
5285msgid ""
5286"Performs database sanity and consistency checks for I<package-name> or all "
5287"packages if omitted (per package checks since dpkg 1.17.10). For example, "
5288"searches for packages that have been installed only partially on your system "
5289"or that have missing, wrong or obsolete control data or files. B<dpkg> will "
5290"suggest what to do with them to get them fixed."
5291msgstr ""
5292
5293#. type: TP
5294#: dpkg.man:1
5295#, no-wrap
5296msgid "B<--update-avail> [I<Packages-file>]"
5297msgstr ""
5298
5299#. type: TQ
5300#: dpkg.man:1
5301#, no-wrap
5302msgid "B<--merge-avail> [I<Packages-file>]"
5303msgstr ""
5304
5305#. type: Plain text
5306#: dpkg.man:1
5307msgid ""
5308"Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With "
5309"action B<--merge-avail>, old information is combined with information from "
5310"I<Packages-file>. With action B<--update-avail>, old information is replaced "
5311"with the information in the I<Packages-file>. The I<Packages-file> "
5312"distributed with Debian is simply named «I<Packages>». If the "
5313"I<Packages-file> argument is missing or named «B<->» then it will be read "
5314"from standard input (since dpkg 1.17.7). B<dpkg> keeps its record of "
5315"available packages in I<%ADMINDIR%/available>."
5316msgstr ""
5317
5318#. type: Plain text
5319#: dpkg.man:1
5320msgid ""
5321"A simpler one-shot command to retrieve and update the I<available> file is "
5322"B<dselect update>. Note that this file is mostly useless if you don't use "
5323"B<dselect> but an APT-based frontend: APT has its own system to keep track "
5324"of available packages."
5325msgstr ""
5326
5327#. type: TP
5328#: dpkg.man:1
5329#, no-wrap
5330msgid "B<-A>, B<--record-avail> I<package-file>..."
5331msgstr ""
5332
5333#. type: Plain text
5334#: dpkg.man:1
5335msgid ""
5336"Update B<dpkg> and B<dselect>'s idea of which packages are available with "
5337"information from the package I<package-file>. If B<--recursive> or B<-R> "
5338"option is specified, I<package-file> must refer to a directory instead."
5339msgstr ""
5340
5341#. type: TP
5342#: dpkg.man:1
5343#, no-wrap
5344msgid "B<--forget-old-unavail>"
5345msgstr ""
5346
5347#. type: Plain text
5348#: dpkg.man:1
5349msgid ""
5350"Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled "
5351"unavailable packages (since dpkg 1.15.4), but only those that do not contain "
5352"user information such as package selections."
5353msgstr ""
5354
5355#. type: TP
5356#: dpkg.man:1
5357#, no-wrap
5358msgid "B<--clear-avail>"
5359msgstr ""
5360
5361#. type: Plain text
5362#: dpkg.man:1
5363msgid "Erase the existing information about what packages are available."
5364msgstr ""
5365
5366#. type: TP
5367#: dpkg.man:1
5368#, no-wrap
5369msgid "B<--get-selections> [I<package-name-pattern>...]"
5370msgstr ""
5371
5372#. type: Plain text
5373#: dpkg.man:1
5374msgid ""
5375"Get list of package selections, and write it to stdout. Without a pattern, "
5376"non-installed packages (i.e. those which have been previously purged) will "
5377"not be shown."
5378msgstr ""
5379
5380#. type: TP
5381#: dpkg.man:1 update-alternatives.man:1
5382#, no-wrap
5383msgid "B<--set-selections>"
5384msgstr ""
5385
5386#. type: Plain text
5387#: dpkg.man:1
5388msgid ""
5389"Set package selections using file read from stdin. This file should be in "
5390"the format “I<package> I<state>”, where state is one of B<install>, B<hold>, "
5391"B<deinstall> or B<purge>. Blank lines and comment lines beginning with "
5392"‘B<#>’ are also permitted."
5393msgstr ""
5394
5395#. type: Plain text
5396#: dpkg.man:1
5397msgid ""
5398"The I<available> file needs to be up-to-date for this command to be useful, "
5399"otherwise unknown packages will be ignored with a warning. See the "
5400"B<--update-avail> and B<--merge-avail> commands for more information."
5401msgstr ""
5402
5403#. type: TP
5404#: dpkg.man:1
5405#, no-wrap
5406msgid "B<--clear-selections>"
5407msgstr ""
5408
5409#. type: Plain text
5410#: dpkg.man:1
5411msgid ""
5412"Set the requested state of every non-essential package to deinstall (since "
5413"dpkg 1.13.18). This is intended to be used immediately before "
5414"B<--set-selections>, to deinstall any packages not in list given to "
5415"B<--set-selections>."
5416msgstr ""
5417
5418#. type: TP
5419#: dpkg.man:1
5420#, no-wrap
5421msgid "B<--yet-to-unpack>"
5422msgstr ""
5423
5424#. type: Plain text
5425#: dpkg.man:1
5426msgid ""
5427"Searches for packages selected for installation, but which for some reason "
5428"still haven't been installed."
5429msgstr ""
5430
5431#. type: TP
5432#: dpkg.man:1
5433#, no-wrap
5434msgid "B<--predep-package>"
5435msgstr ""
5436
5437#. type: Plain text
5438#: dpkg.man:1
5439msgid ""
5440"Print a single package which is the target of one or more relevant "
5441"pre-dependencies and has itself no unsatisfied pre-dependencies."
5442msgstr ""
5443
5444#. type: Plain text
5445#: dpkg.man:1
5446msgid ""
5447"If such a package is present, output it as a Packages file entry, which can "
5448"be massaged as appropriate."
5449msgstr ""
5450
5451#. type: Plain text
5452#: dpkg.man:1
5453msgid ""
5454"Returns 0 when a package is printed, 1 when no suitable package is available "
5455"and 2 on error."
5456msgstr ""
5457
5458#. type: TP
5459#: dpkg.man:1
5460#, no-wrap
5461msgid "B<--add-architecture >I<architecture>"
5462msgstr ""
5463
5464#. type: Plain text
5465#: dpkg.man:1
5466msgid ""
5467"Add I<architecture> to the list of architectures for which packages can be "
5468"installed without using B<--force-architecture> (since dpkg 1.16.2). The "
5469"architecture B<dpkg> is built for (i.e. the output of "
5470"B<--print-architecture>) is always part of that list."
5471msgstr ""
5472
5473#. type: TP
5474#: dpkg.man:1
5475#, no-wrap
5476msgid "B<--remove-architecture >I<architecture>"
5477msgstr ""
5478
5479#. type: Plain text
5480#: dpkg.man:1
5481msgid ""
5482"Remove I<architecture> from the list of architectures for which packages can "
5483"be installed without using B<--force-architecture> (since dpkg 1.16.2). If "
5484"the architecture is currently in use in the database then the operation will "
5485"be refused, except if B<--force-architecture> is specified. The architecture "
5486"B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never "
5487"be removed from that list."
5488msgstr ""
5489
5490#. type: TP
5491#: dpkg.man:1
5492#, no-wrap
5493msgid "B<--print-architecture>"
5494msgstr ""
5495
5496#. type: Plain text
5497#: dpkg.man:1
5498msgid "Print architecture of packages B<dpkg> installs (for example, “i386”)."
5499msgstr ""
5500
5501#. type: TP
5502#: dpkg.man:1
5503#, no-wrap
5504msgid "B<--print-foreign-architectures>"
5505msgstr ""
5506
5507#. type: Plain text
5508#: dpkg.man:1
5509msgid ""
5510"Print a newline-separated list of the extra architectures B<dpkg> is "
5511"configured to allow packages to be installed for (since dpkg 1.16.2)."
5512msgstr ""
5513
5514#. type: TP
5515#: dpkg.man:1
5516#, no-wrap
5517msgid "B<--assert->I<feature>"
5518msgstr ""
5519
5520#. type: Plain text
5521#: dpkg.man:1
5522msgid ""
5523"Asserts that B<dpkg> supports the requested feature. Returns 0 if the "
5524"feature is fully supported, 1 if the feature is known but B<dpkg> cannot "
5525"provide support for it yet, and 2 if the feature is unknown. The current "
5526"list of assertable features is:"
5527msgstr ""
5528
5529#. type: TP
5530#: dpkg.man:1
5531#, no-wrap
5532msgid "B<support-predepends>"
5533msgstr ""
5534
5535#. type: Plain text
5536#: dpkg.man:1
5537msgid "Supports the B<Pre-Depends> field (since dpkg 1.1.0)."
5538msgstr ""
5539
5540#. type: TP
5541#: dpkg.man:1
5542#, no-wrap
5543msgid "B<working-epoch>"
5544msgstr ""
5545
5546#. type: Plain text
5547#: dpkg.man:1
5548msgid "Supports epochs in version strings (since dpkg 1.4.0.7)."
5549msgstr ""
5550
5551#. type: TP
5552#: dpkg.man:1
5553#, no-wrap
5554msgid "B<long-filenames>"
5555msgstr ""
5556
5557#. type: Plain text
5558#: dpkg.man:1
5559msgid "Supports long filenames in B<deb>(5) archives (since dpkg 1.4.1.17)."
5560msgstr ""
5561
5562#. type: TP
5563#: dpkg.man:1
5564#, no-wrap
5565msgid "B<multi-conrep>"
5566msgstr ""
5567
5568#. type: Plain text
5569#: dpkg.man:1
5570msgid "Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19)."
5571msgstr ""
5572
5573#. type: TP
5574#: dpkg.man:1
5575#, no-wrap
5576msgid "B<multi-arch>"
5577msgstr ""
5578
5579#. type: Plain text
5580#: dpkg.man:1
5581msgid "Supports multi-arch fields and semantics (since dpkg 1.16.2)."
5582msgstr ""
5583
5584#. type: TP
5585#: dpkg.man:1
5586#, no-wrap
5587msgid "B<versioned-provides>"
5588msgstr ""
5589
5590#. type: Plain text
5591#: dpkg.man:1
5592msgid "Supports versioned B<Provides> (since dpkg 1.17.11)."
5593msgstr ""
5594
5595#. type: TP
5596#: dpkg.man:1
5597#, no-wrap
5598msgid "B<--validate->I<thing string>"
5599msgstr ""
5600
5601#. type: Plain text
5602#: dpkg.man:1
5603msgid ""
5604"Validate that the I<thing> I<string> has a correct syntax (since dpkg "
5605"1.18.16). Returns 0 if the I<string> is valid, 1 if the I<string> is "
5606"invalid but might be accepted in lax contexts, and 2 if the I<string> is "
5607"invalid. The current list of validatable I<thing>s is:"
5608msgstr ""
5609
5610#. type: TP
5611#: dpkg.man:1
5612#, no-wrap
5613msgid "B<pkgname>"
5614msgstr ""
5615
5616#. type: Plain text
5617#: dpkg.man:1
5618msgid "Validates the given package name (since dpkg 1.18.16)."
5619msgstr ""
5620
5621#. type: TP
5622#: dpkg.man:1
5623#, no-wrap
5624msgid "B<trigname>"
5625msgstr ""
5626
5627#. type: Plain text
5628#: dpkg.man:1
5629msgid "Validates the given trigger name (since dpkg 1.18.16)."
5630msgstr ""
5631
5632#. type: TP
5633#: dpkg.man:1
5634#, no-wrap
5635msgid "B<archname>"
5636msgstr ""
5637
5638#. type: Plain text
5639#: dpkg.man:1
5640msgid "Validates the given architecture name (since dpkg 1.18.16)."
5641msgstr ""
5642
5643#. type: TP
5644#: dpkg.man:1
5645#, no-wrap
5646msgid "B<version>"
5647msgstr ""
5648
5649#. type: Plain text
5650#: dpkg.man:1
5651msgid "Validates the given version (since dpkg 1.18.16)."
5652msgstr ""
5653
5654#. type: TP
5655#: dpkg.man:1
5656#, no-wrap
5657msgid "B<--compare-versions >I<ver1 op ver2>"
5658msgstr ""
5659
5660#. .TP
5661#. .B \-\-command\-fd \fIn\fP
5662#. Accept a series of commands on input file descriptor \fIn\fP. Note:
5663#. additional options set on the command line, and through this file descriptor,
5664#. are not reset for subsequent commands executed during the same run.
5665#. type: Plain text
5666#: dpkg.man:1
5667msgid ""
5668"Compare version numbers, where I<op> is a binary operator. B<dpkg> returns "
5669"true (B<0>) if the specified condition is satisfied, and false (B<1>) "
5670"otherwise. There are two groups of operators, which differ in how they treat "
5671"an empty I<ver1> or I<ver2>. These treat an empty version as earlier than "
5672"any version: B<lt le eq ne ge gt>. These treat an empty version as later "
5673"than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for "
5674"compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= "
5675"E<gt>E<gt> E<gt>>. The B<E<lt>> and B<E<gt>> operators are obsolete and "
5676"should B<not> be used, due to confusing semantics. To illustrate: B<0.1 "
5677"E<lt> 0.1> evaluates to true."
5678msgstr ""
5679
5680#. type: TP
5681#: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildpackage.man:1
5682#: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
5683#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
5684#: dpkg-gensymbols.man:1 dpkg-name.man:1 dpkg-parsechangelog.man:1
5685#: dpkg-query.man:1 dpkg-scanpackages.man:1 dpkg-shlibdeps.man:1
5686#: dpkg-source.man:1 dpkg-split.man:1 dpkg-trigger.man:1 dselect.man:1
5687#, no-wrap
5688msgid "B<-?>, B<--help>"
5689msgstr ""
5690
5691#. type: Plain text
5692#: dpkg.man:1
5693msgid "Display a brief help message."
5694msgstr ""
5695
5696#. type: TP
5697#: dpkg.man:1
5698#, no-wrap
5699msgid "B<--force-help>"
5700msgstr ""
5701
5702#. type: Plain text
5703#: dpkg.man:1
5704msgid "Give help about the B<--force->I<thing> options."
5705msgstr ""
5706
5707#. type: TP
5708#: dpkg.man:1
5709#, no-wrap
5710msgid "B<-Dh>, B<--debug=help>"
5711msgstr ""
5712
5713#. type: Plain text
5714#: dpkg.man:1
5715msgid "Give help about debugging options."
5716msgstr ""
5717
5718#. type: TP
5719#: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildflags.man:1
5720#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1
5721#: dpkg-distaddfile.man:1 dpkg-deb.man:1 dpkg-divert.man:1
5722#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
5723#: dpkg-mergechangelogs.man:1 dpkg-parsechangelog.man:1 dpkg-query.man:1
5724#: dpkg-scanpackages.man:1 dpkg-scansources.man:1 dpkg-shlibdeps.man:1
5725#: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
5726#: dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1 update-alternatives.man:1
5727#, no-wrap
5728msgid "B<--version>"
5729msgstr ""
5730
5731#. type: Plain text
5732#: dpkg.man:1
5733msgid "Display B<dpkg> version information."
5734msgstr ""
5735
5736#. type: TP
5737#: dpkg.man:1
5738#, no-wrap
5739msgid "B<dpkg-deb actions>"
5740msgstr ""
5741
5742#. type: Plain text
5743#: dpkg.man:1
5744msgid "See B<dpkg-deb>(1) for more information about the following actions."
5745msgstr ""
5746
5747#. type: Plain text
5748#: dpkg.man:1
5749#, no-wrap
5750msgid ""
5751"B<-b>, B<--build> I<directory> [I<archive>|I<directory>]\n"
5752" Build a deb package.\n"
5753"B<-c>, B<--contents> I<archive>\n"
5754" List contents of a deb package.\n"
5755"B<-e>, B<--control> I<archive> [I<directory>]\n"
5756" Extract control-information from a package.\n"
5757"B<-x>, B<--extract> I<archive directory>\n"
5758" Extract the files contained by package.\n"
5759"B<-X>, B<--vextract> I<archive directory>\n"
5760" Extract and display the filenames contained by a\n"
5761" package.\n"
5762"B<-f>, B<--field> I<archive> [I<control-field>...]\n"
5763" Display control field(s) of a package.\n"
5764"B<--ctrl-tarfile> I<archive>\n"
5765" Output the control tar-file contained in a Debian package.\n"
5766"B<--fsys-tarfile> I<archive>\n"
5767" Output the filesystem tar-file contained by a Debian package.\n"
5768"B<-I>, B<--info> I<archive> [I<control-file>...]\n"
5769" Show information about a package.\n"
5770msgstr ""
5771
5772#. type: TP
5773#: dpkg.man:1
5774#, no-wrap
5775msgid "B<dpkg-query actions>"
5776msgstr ""
5777
5778#. type: Plain text
5779#: dpkg.man:1
5780msgid "See B<dpkg-query>(1) for more information about the following actions."
5781msgstr ""
5782
5783#. type: Plain text
5784#: dpkg.man:1
5785#, no-wrap
5786msgid ""
5787"B<-l>, B<--list> I<package-name-pattern>...\n"
5788" List packages matching given pattern.\n"
5789"B<-s>, B<--status> I<package-name>...\n"
5790" Report status of specified package.\n"
5791"B<-L>, B<--listfiles> I<package-name>...\n"
5792" List files installed to your system from I<package-name>.\n"
5793"B<-S>, B<--search> I<filename-search-pattern>...\n"
5794" Search for a filename from installed packages.\n"
5795"B<-p>, B<--print-avail> I<package-name>...\n"
5796" Display details about I<package-name>, as found in\n"
5797" I<%ADMINDIR%/available>. Users of APT-based frontends\n"
5798" should use B<apt-cache show> I<package-name> instead.\n"
5799msgstr ""
5800
5801#. type: SH
5802#: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildpackage.man:1
5803#: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
5804#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
5805#: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
5806#: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
5807#: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
5808#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
5809#: dpkg-vendor.man:1 dselect.man:1 start-stop-daemon.man:1
5810#: update-alternatives.man:1
5811#, no-wrap
5812msgid "OPTIONS"
5813msgstr ""
5814
5815#. type: Plain text
5816#: dpkg.man:1
5817msgid ""
5818"All options can be specified both on the command line and in the B<dpkg> "
5819"configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names "
5820"matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration directory "
5821"I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration file is either "
5822"an option (exactly the same as the command line option but without leading "
5823"hyphens) or a comment (if it starts with a ‘B<#>’)."
5824msgstr ""
5825
5826#. type: TP
5827#: dpkg.man:1
5828#, no-wrap
5829msgid "B<--abort-after=>I<number>"
5830msgstr ""
5831
5832#. type: Plain text
5833#: dpkg.man:1
5834msgid "Change after how many errors B<dpkg> will abort. The default is 50."
5835msgstr ""
5836
5837#. type: TP
5838#: dpkg.man:1
5839#, no-wrap
5840msgid "B<-B>, B<--auto-deconfigure>"
5841msgstr ""
5842
5843#. type: Plain text
5844#: dpkg.man:1
5845msgid ""
5846"When a package is removed, there is a possibility that another installed "
5847"package depended on the removed package. Specifying this option will cause "
5848"automatic deconfiguration of the package which depended on the removed "
5849"package."
5850msgstr ""
5851
5852#. type: TP
5853#: dpkg.man:1
5854#, no-wrap
5855msgid "B<-D>I<octal>B<, --debug=>I<octal>"
5856msgstr ""
5857
5858#. type: Plain text
5859#: dpkg.man:1
5860msgid ""
5861"Switch debugging on. I<octal> is formed by bitwise-oring desired values "
5862"together from the list below (note that these values may change in future "
5863"releases). B<-Dh> or B<--debug=help> display these debugging values."
5864msgstr ""
5865
5866#. type: Plain text
5867#: dpkg.man:1
5868#, no-wrap
5869msgid ""
5870" Number Description\n"
5871" 1 Generally helpful progress information\n"
5872" 2 Invocation and status of maintainer scripts\n"
5873" 10 Output for each file processed\n"
5874" 100 Lots of output for each file processed\n"
5875" 20 Output for each configuration file\n"
5876" 200 Lots of output for each configuration file\n"
5877" 40 Dependencies and conflicts\n"
5878" 400 Lots of dependencies/conflicts output\n"
5879" 10000 Trigger activation and processing\n"
5880" 20000 Lots of output regarding triggers\n"
5881" 40000 Silly amounts of output regarding triggers\n"
5882" 1000 Lots of drivel about e.g. the dpkg/info dir\n"
5883" 2000 Insane amounts of drivel\n"
5884msgstr ""
5885
5886#. type: TP
5887#: dpkg.man:1
5888#, no-wrap
5889msgid "B<--force->I<things>"
5890msgstr ""
5891
5892#. type: TQ
5893#: dpkg.man:1
5894#, no-wrap
5895msgid "B<--no-force->I<things>, B<--refuse->I<things>"
5896msgstr ""
5897
5898#. type: Plain text
5899#: dpkg.man:1
5900msgid ""
5901"Force or refuse (B<no-force> and B<refuse> mean the same thing) to do some "
5902"things. I<things> is a comma separated list of things specified "
5903"below. B<--force-help> displays a message describing them. Things marked "
5904"with (*) are forced by default."
5905msgstr ""
5906
5907#. type: Plain text
5908#: dpkg.man:1
5909msgid ""
5910"I<Warning: These options are mostly intended to be used by experts "
5911"only. Using them without fully understanding their effects may break your "
5912"whole system.>"
5913msgstr ""
5914
5915#. type: Plain text
5916#: dpkg.man:1
5917msgid "B<all>: Turns on (or off) all force options."
5918msgstr ""
5919
5920#. type: Plain text
5921#: dpkg.man:1
5922msgid ""
5923"B<downgrade>(*): Install a package, even if newer version of it is already "
5924"installed."
5925msgstr ""
5926
5927#. type: Plain text
5928#: dpkg.man:1
5929msgid ""
5930"I<Warning: At present >B<dpkg>I< does not do any dependency checking on "
5931"downgrades and therefore will not warn you if the downgrade breaks the "
5932"dependency of some other package. This can have serious side effects, "
5933"downgrading essential system components can even make your whole system "
5934"unusable. Use with care.>"
5935msgstr ""
5936
5937#. type: Plain text
5938#: dpkg.man:1
5939msgid ""
5940"B<configure-any>: Configure also any unpacked but unconfigured packages on "
5941"which the current package depends."
5942msgstr ""
5943
5944#. type: Plain text
5945#: dpkg.man:1
5946msgid "B<hold>: Process packages even when marked “hold”."
5947msgstr ""
5948
5949#. type: Plain text
5950#: dpkg.man:1
5951msgid ""
5952"B<remove-reinstreq>: Remove a package, even if it's broken and marked to "
5953"require reinstallation. This may, for example, cause parts of the package to "
5954"remain on the system, which will then be forgotten by B<dpkg>."
5955msgstr ""
5956
5957#. type: Plain text
5958#: dpkg.man:1
5959msgid ""
5960"B<remove-essential>: Remove, even if the package is considered "
5961"essential. Essential packages contain mostly very basic Unix "
5962"commands. Removing them might cause the whole system to stop working, so use "
5963"with caution."
5964msgstr ""
5965
5966#. type: Plain text
5967#: dpkg.man:1
5968msgid "B<depends>: Turn all dependency problems into warnings."
5969msgstr ""
5970
5971#. type: Plain text
5972#: dpkg.man:1
5973msgid "B<depends-version>: Don't care about versions when checking dependencies."
5974msgstr ""
5975
5976#. type: Plain text
5977#: dpkg.man:1
5978msgid ""
5979"B<breaks>: Install, even if this would break another package (since dpkg "
5980"1.14.6)."
5981msgstr ""
5982
5983#. type: Plain text
5984#: dpkg.man:1
5985msgid ""
5986"B<conflicts>: Install, even if it conflicts with another package. This is "
5987"dangerous, for it will usually cause overwriting of some files."
5988msgstr ""
5989
5990#. type: Plain text
5991#: dpkg.man:1
5992msgid ""
5993"B<confmiss>: Always install the missing conffile without prompting. This is "
5994"dangerous, since it means not preserving a change (removing) made to the "
5995"file."
5996msgstr ""
5997
5998#. type: Plain text
5999#: dpkg.man:1
6000msgid ""
6001"B<confnew>: If a conffile has been modified and the version in the package "
6002"did change, always install the new version without prompting, unless the "
6003"B<--force-confdef> is also specified, in which case the default action is "
6004"preferred."
6005msgstr ""
6006
6007#. type: Plain text
6008#: dpkg.man:1
6009msgid ""
6010"B<confold>: If a conffile has been modified and the version in the package "
6011"did change, always keep the old version without prompting, unless the "
6012"B<--force-confdef> is also specified, in which case the default action is "
6013"preferred."
6014msgstr ""
6015
6016#. type: Plain text
6017#: dpkg.man:1
6018msgid ""
6019"B<confdef>: If a conffile has been modified and the version in the package "
6020"did change, always choose the default action without prompting. If there is "
6021"no default action it will stop to ask the user unless B<--force-confnew> or "
6022"B<--force-confold> is also been given, in which case it will use that to "
6023"decide the final action."
6024msgstr ""
6025
6026#. type: Plain text
6027#: dpkg.man:1
6028msgid ""
6029"B<confask>: If a conffile has been modified always offer to replace it with "
6030"the version in the package, even if the version in the package did not "
6031"change (since dpkg 1.15.8). If any of B<--force-confnew>, "
6032"B<--force-confold>, or B<--force-confdef> is also given, it will be used to "
6033"decide the final action."
6034msgstr ""
6035
6036#. type: Plain text
6037#: dpkg.man:1
6038msgid "B<overwrite>: Overwrite one package's file with another's file."
6039msgstr ""
6040
6041#. type: Plain text
6042#: dpkg.man:1
6043msgid "B<overwrite-dir>: Overwrite one package's directory with another's file."
6044msgstr ""
6045
6046#. type: Plain text
6047#: dpkg.man:1
6048msgid "B<overwrite-diverted>: Overwrite a diverted file with an undiverted version."
6049msgstr ""
6050
6051#. type: Plain text
6052#: dpkg.man:1
6053msgid ""
6054"B<unsafe-io>: Do not perform safe I/O operations when unpacking (since dpkg "
6055"1.15.8.6). Currently this implies not performing file system syncs before "
6056"file renames, which is known to cause substantial performance degradation on "
6057"some file systems, unfortunately the ones that require the safe I/O on the "
6058"first place due to their unreliable behaviour causing zero-length files on "
6059"abrupt system crashes."
6060msgstr ""
6061
6062#. type: Plain text
6063#: dpkg.man:1
6064msgid ""
6065"I<Note>: For ext4, the main offender, consider using instead the mount "
6066"option B<nodelalloc>, which will fix both the performance degradation and "
6067"the data safety issues, the latter by making the file system not produce "
6068"zero-length files on abrupt system crashes with any software not doing syncs "
6069"before atomic renames."
6070msgstr ""
6071
6072#. type: Plain text
6073#: dpkg.man:1
6074msgid ""
6075"I<Warning: Using this option might improve performance at the cost of losing "
6076"data, use with care.>"
6077msgstr ""
6078
6079#. type: Plain text
6080#: dpkg.man:1
6081msgid ""
6082"B<script-chrootless>: Run maintainer scrips without B<chroot>(2)ing into "
6083"B<instdir> even if the package does not support this mode of operation "
6084"(since dpkg 1.18.5)."
6085msgstr ""
6086
6087#. type: Plain text
6088#: dpkg.man:1
6089msgid "I<Warning: This can destroy your host system, use with extreme care.>"
6090msgstr ""
6091
6092#. type: Plain text
6093#: dpkg.man:1
6094msgid "B<architecture>: Process even packages with wrong or no architecture."
6095msgstr ""
6096
6097#. type: Plain text
6098#: dpkg.man:1
6099msgid ""
6100"B<bad-version>: Process even packages with wrong versions (since dpkg "
6101"1.16.1)."
6102msgstr ""
6103
6104#. type: Plain text
6105#: dpkg.man:1
6106msgid "B<bad-path>: B<PATH> is missing important programs, so problems are likely."
6107msgstr ""
6108
6109#. type: Plain text
6110#: dpkg.man:1
6111msgid "B<not-root>: Try to (de)install things even when not root."
6112msgstr ""
6113
6114#. type: Plain text
6115#: dpkg.man:1
6116msgid "B<bad-verify>: Install a package even if it fails authenticity check."
6117msgstr ""
6118
6119#. type: TP
6120#: dpkg.man:1
6121#, no-wrap
6122msgid "B<--ignore-depends>=I<package>,..."
6123msgstr ""
6124
6125#. type: Plain text
6126#: dpkg.man:1
6127msgid ""
6128"Ignore dependency-checking for specified packages (actually, checking is "
6129"performed, but only warnings about conflicts are given, nothing else)."
6130msgstr ""
6131
6132#. type: TP
6133#: dpkg.man:1
6134#, no-wrap
6135msgid "B<--no-act>, B<--dry-run>, B<--simulate>"
6136msgstr ""
6137
6138#. type: Plain text
6139#: dpkg.man:1
6140msgid ""
6141"Do everything which is supposed to be done, but don't write any "
6142"changes. This is used to see what would happen with the specified action, "
6143"without actually modifying anything."
6144msgstr ""
6145
6146#. type: Plain text
6147#: dpkg.man:1
6148msgid ""
6149"Be sure to give B<--no-act> before the action-parameter, or you might end up "
6150"with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first "
6151"purge package foo and then try to purge package --no-act, even though you "
6152"probably expected it to actually do nothing)"
6153msgstr ""
6154
6155#. type: TP
6156#: dpkg.man:1
6157#, no-wrap
6158msgid "B<-R>, B<--recursive>"
6159msgstr ""
6160
6161#. type: Plain text
6162#: dpkg.man:1
6163msgid ""
6164"Recursively handle all regular files matching pattern B<*.deb> found at "
6165"specified directories and all of its subdirectories. This can be used with "
6166"B<-i>, B<-A>, B<--install>, B<--unpack> and B<--record-avail> actions."
6167msgstr ""
6168
6169#. type: TP
6170#: dpkg.man:1 dpkg-buildpackage.man:1 dpkg-genchanges.man:1
6171#, no-wrap
6172msgid "B<-G>"
6173msgstr ""
6174
6175#. type: Plain text
6176#: dpkg.man:1
6177msgid ""
6178"Don't install a package if a newer version of the same package is already "
6179"installed. This is an alias of B<--refuse-downgrade>."
6180msgstr ""
6181
6182#. type: TP
6183#: dpkg.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
6184#: dpkg-checkbuilddeps.man:1 dpkg-query.man:1 dpkg-shlibdeps.man:1
6185#: dpkg-trigger.man:1
6186#, no-wrap
6187msgid "B<--admindir=>I<dir>"
6188msgstr ""
6189
6190#. type: Plain text
6191#: dpkg.man:1
6192msgid ""
6193"Change default administrative directory, which contains many files that give "
6194"information about status of installed or uninstalled packages, etc. "
6195"(Defaults to «I<%ADMINDIR%>»)"
6196msgstr ""
6197
6198#. type: TP
6199#: dpkg.man:1
6200#, no-wrap
6201msgid "B<--instdir=>I<dir>"
6202msgstr ""
6203
6204#. type: Plain text
6205#: dpkg.man:1
6206msgid ""
6207"Change default installation directory which refers to the directory where "
6208"packages are to be installed. B<instdir> is also the directory passed to "
6209"B<chroot>(2) before running package's installation scripts, which means that "
6210"the scripts see B<instdir> as a root directory. (Defaults to «I</>»)"
6211msgstr ""
6212
6213#. type: TP
6214#: dpkg.man:1
6215#, no-wrap
6216msgid "B<--root=>I<dir>"
6217msgstr ""
6218
6219#. type: Plain text
6220#: dpkg.man:1
6221msgid ""
6222"Changing B<root> changes B<instdir> to «I<dir>» and B<admindir> to "
6223"«I<dir>B<%ADMINDIR%>»."
6224msgstr ""
6225
6226#. type: TP
6227#: dpkg.man:1
6228#, no-wrap
6229msgid "B<-O>, B<--selected-only>"
6230msgstr ""
6231
6232#. type: Plain text
6233#: dpkg.man:1
6234msgid ""
6235"Only process the packages that are selected for installation. The actual "
6236"marking is done with B<dselect> or by B<dpkg>, when it handles packages. For "
6237"example, when a package is removed, it will be marked selected for "
6238"deinstallation."
6239msgstr ""
6240
6241#. type: TP
6242#: dpkg.man:1
6243#, no-wrap
6244msgid "B<-E>, B<--skip-same-version>"
6245msgstr ""
6246
6247#. type: Plain text
6248#: dpkg.man:1
6249msgid ""
6250"Don't install the package if the same version of the package is already "
6251"installed."
6252msgstr ""
6253
6254#. type: TP
6255#: dpkg.man:1
6256#, no-wrap
6257msgid "B<--pre-invoke=>I<command>"
6258msgstr ""
6259
6260#. type: TQ
6261#: dpkg.man:1
6262#, no-wrap
6263msgid "B<--post-invoke=>I<command>"
6264msgstr ""
6265
6266#. type: Plain text
6267#: dpkg.man:1
6268msgid ""
6269"Set an invoke hook I<command> to be run via ``sh -c'' before or after the "
6270"B<dpkg> run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, "
6271"I<remove>, I<purge>, I<add-architecture> and I<remove-architecture> B<dpkg> "
6272"actions (since dpkg 1.15.4; I<add-architecture> and I<remove-architecture> "
6273"actions since dpkg 1.17.19). This option can be specified multiple "
6274"times. The order the options are specified is preserved, with the ones from "
6275"the configuration files taking precedence. The environment variable "
6276"B<DPKG_HOOK_ACTION> is set for the hooks to the current B<dpkg> "
6277"action. Note: front-ends might call B<dpkg> several times per invocation, "
6278"which might run the hooks more times than expected."
6279msgstr ""
6280
6281#. type: TP
6282#: dpkg.man:1
6283#, no-wrap
6284msgid "B<--path-exclude=>I<glob-pattern>"
6285msgstr ""
6286
6287#. type: TQ
6288#: dpkg.man:1
6289#, no-wrap
6290msgid "B<--path-include=>I<glob-pattern>"
6291msgstr ""
6292
6293#. type: Plain text
6294#: dpkg.man:1
6295msgid ""
6296"Set I<glob-pattern> as a path filter, either by excluding or re-including "
6297"previously excluded paths matching the specified patterns during install "
6298"(since dpkg 1.15.8)."
6299msgstr ""
6300
6301#. type: Plain text
6302#: dpkg.man:1
6303msgid ""
6304"I<Warning: take into account that depending on the excluded paths you might "
6305"completely break your system, use with caution.>"
6306msgstr ""
6307
6308#. type: Plain text
6309#: dpkg.man:1
6310msgid ""
6311"The glob patterns use the same wildcards used in the shell, were ‘*’ matches "
6312"any sequence of characters, including the empty string and also ‘/’. For "
6313"example, «I</usr/*/READ*>» matches «I</usr/share/doc/package/README>». As "
6314"usual, ‘?’ matches any single character (again, including ‘/’). And ‘[’ "
6315"starts a character class, which can contain a list of characters, ranges and "
6316"complementations. See B<glob>(7) for detailed information about "
6317"globbing. Note: the current implementation might re-include more directories "
6318"and symlinks than needed, to be on the safe side and avoid possible unpack "
6319"failures; future work might fix this."
6320msgstr ""
6321
6322#. type: Plain text
6323#: dpkg.man:1
6324msgid ""
6325"This can be used to remove all paths except some particular ones; a typical "
6326"case is:"
6327msgstr ""
6328
6329#. type: Plain text
6330#: dpkg.man:1
6331#, no-wrap
6332msgid ""
6333"B<--path-exclude=/usr/share/doc/*>\n"
6334"B<--path-include=/usr/share/doc/*/copyright>\n"
6335msgstr ""
6336
6337#. type: Plain text
6338#: dpkg.man:1
6339msgid "to remove all documentation files except the copyright files."
6340msgstr ""
6341
6342#. type: Plain text
6343#: dpkg.man:1
6344msgid ""
6345"These two options can be specified multiple times, and interleaved with each "
6346"other. Both are processed in the given order, with the last rule that "
6347"matches a file name making the decision."
6348msgstr ""
6349
6350#. type: Plain text
6351#: dpkg.man:1
6352msgid ""
6353"The filters are applied when unpacking the binary packages, and as such only "
6354"have knowledge of the type of object currently being filtered (e.g. a normal "
6355"file or a directory) and have not visibility of what objects will come "
6356"next. Because these filters have side effects (in contrast to B<find>(1) "
6357"filters), excluding an exact pathname that happens to be a directory object "
6358"like I</usr/share/doc> will not have the desired result, and only that "
6359"pathname will be excluded (which could be automatically reincluded if the "
6360"code sees the need). Any subsequent files contained within that directory "
6361"will fail to unpack."
6362msgstr ""
6363
6364#. type: Plain text
6365#: dpkg.man:1
6366msgid "Hint: make sure the globs are not expanded by your shell."
6367msgstr ""
6368
6369#. type: TP
6370#: dpkg.man:1
6371#, no-wrap
6372msgid "B<--verify-format>I< format-name>"
6373msgstr ""
6374
6375#. type: Plain text
6376#: dpkg.man:1
6377msgid "Sets the output format for the B<--verify> command (since dpkg 1.17.2)."
6378msgstr ""
6379
6380#. type: Plain text
6381#: dpkg.man:1
6382msgid ""
6383"The only currently supported output format is B<rpm>, which consists of a "
6384"line for every path that failed any check. The lines start with 9 "
6385"characters to report each specific check result, a ‘B<?>’ implies the check "
6386"could not be done (lack of support, file permissions, etc), ‘B<.>’ implies "
6387"the check passed, and an alphanumeric character implies a specific check "
6388"failed; the md5sum verification failure (the file contents have changed) is "
6389"denoted with a ‘B<5>’ on the third character. The line is followed by a "
6390"space and an attribute character (currently ‘B<c>’ for conffiles), another "
6391"space and the pathname."
6392msgstr ""
6393
6394#. type: TP
6395#: dpkg.man:1
6396#, no-wrap
6397msgid "B<--status-fd >I<n>"
6398msgstr ""
6399
6400#. type: Plain text
6401#: dpkg.man:1
6402msgid ""
6403"Send machine-readable package status and progress information to file "
6404"descriptor I<n>. This option can be specified multiple times. The "
6405"information is generally one record per line, in one of the following forms:"
6406msgstr ""
6407
6408#. type: TP
6409#: dpkg.man:1
6410#, no-wrap
6411msgid "B<status: >I<package>B<: >I<status>"
6412msgstr ""
6413
6414#. type: Plain text
6415#: dpkg.man:1
6416msgid "Package status changed; I<status> is as in the status file."
6417msgstr ""
6418
6419#. type: TP
6420#: dpkg.man:1
6421#, no-wrap
6422msgid "B<status: >I<package>B< : error : >I<extended-error-message>"
6423msgstr ""
6424
6425#. type: Plain text
6426#: dpkg.man:1
6427msgid ""
6428"An error occurred. Any possible newlines in I<extended-error-message> will "
6429"be converted to spaces before output."
6430msgstr ""
6431
6432#. type: TP
6433#: dpkg.man:1
6434#, no-wrap
6435msgid ""
6436"B<status: >I<file>B< : conffile-prompt : '>I<real-old>B<' '>I<real-new>B<' "
6437">I<useredited>B< >I<distedited>"
6438msgstr ""
6439
6440#. type: Plain text
6441#: dpkg.man:1
6442msgid "User is being asked a conffile question."
6443msgstr ""
6444
6445#. type: TP
6446#: dpkg.man:1
6447#, no-wrap
6448msgid "B<processing: >I<stage>B<: >I<package>"
6449msgstr ""
6450
6451#. type: Plain text
6452#: dpkg.man:1
6453msgid ""
6454"Sent just before a processing stage starts. I<stage> is one of B<upgrade>, "
6455"B<install> (both sent before unpacking), B<configure>, B<trigproc>, "
6456"B<disappear>, B<remove>, B<purge>."
6457msgstr ""
6458
6459#. type: TP
6460#: dpkg.man:1
6461#, no-wrap
6462msgid "B<--status-logger>=I<command>"
6463msgstr ""
6464
6465#. type: Plain text
6466#: dpkg.man:1
6467msgid ""
6468"Send machine-readable package status and progress information to the shell "
6469"I<command>'s standard input, to be run via ``sh -c'' (since dpkg 1.16.0). "
6470"This option can be specified multiple times. The output format used is the "
6471"same as in B<--status-fd>."
6472msgstr ""
6473
6474#. type: TP
6475#: dpkg.man:1
6476#, no-wrap
6477msgid "B<--log=>I<filename>"
6478msgstr ""
6479
6480#. type: Plain text
6481#: dpkg.man:1
6482msgid ""
6483"Log status change updates and actions to I<filename>, instead of the default "
6484"I<%LOGDIR%/dpkg.log>. If this option is given multiple times, the last "
6485"filename is used. Log messages are of the form:"
6486msgstr ""
6487
6488#. type: TP
6489#: dpkg.man:1
6490#, no-wrap
6491msgid "YYYY-MM-DD HH:MM:SS B<startup> I<type> I<command>"
6492msgstr ""
6493
6494#. type: Plain text
6495#: dpkg.man:1
6496msgid ""
6497"For each dpkg invocation where I<type> is B<archives> (with a I<command> of "
6498"B<unpack> or B<install>) or B<packages> (with a I<command> of B<configure>, "
6499"B<triggers-only>, B<remove> or B<purge>)."
6500msgstr ""
6501
6502#. type: TP
6503#: dpkg.man:1
6504#, no-wrap
6505msgid "YYYY-MM-DD HH:MM:SS B<status> I<state> I<pkg> I<installed-version>"
6506msgstr ""
6507
6508#. type: Plain text
6509#: dpkg.man:1
6510msgid "For status change updates."
6511msgstr ""
6512
6513#. type: TP
6514#: dpkg.man:1
6515#, no-wrap
6516msgid ""
6517"YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> "
6518"I<available-version>"
6519msgstr ""
6520
6521#. type: Plain text
6522#: dpkg.man:1
6523msgid ""
6524"For actions where I<action> is one of B<install>, B<upgrade>, B<configure>, "
6525"B<trigproc>, B<disappear>, B<remove> or B<purge>."
6526msgstr ""
6527
6528#. type: TP
6529#: dpkg.man:1
6530#, no-wrap
6531msgid "YYYY-MM-DD HH:MM:SS B<conffile> I<filename> I<decision>"
6532msgstr ""
6533
6534#. type: Plain text
6535#: dpkg.man:1
6536msgid "For conffile changes where I<decision> is either B<install> or B<keep>."
6537msgstr ""
6538
6539#. type: TP
6540#: dpkg.man:1
6541#, no-wrap
6542msgid "B<--no-debsig>"
6543msgstr ""
6544
6545#. type: Plain text
6546#: dpkg.man:1
6547msgid "Do not try to verify package signatures."
6548msgstr ""
6549
6550#. type: TP
6551#: dpkg.man:1
6552#, no-wrap
6553msgid "B<--no-triggers>"
6554msgstr ""
6555
6556#. type: Plain text
6557#: dpkg.man:1
6558msgid ""
6559"Do not run any triggers in this run (since dpkg 1.14.17), but activations "
6560"will still be recorded. If used with B<--configure> I<package> or "
6561"B<--triggers-only> I<package> then the named package postinst will still be "
6562"run even if only a triggers run is needed. Use of this option may leave "
6563"packages in the improper B<triggers-awaited> and B<triggers-pending> "
6564"states. This can be fixed later by running: B<dpkg --configure --pending>."
6565msgstr ""
6566
6567#. type: TP
6568#: dpkg.man:1
6569#, no-wrap
6570msgid "B<--triggers>"
6571msgstr ""
6572
6573#. type: Plain text
6574#: dpkg.man:1
6575msgid "Cancels a previous B<--no-triggers> (since dpkg 1.14.17)."
6576msgstr ""
6577
6578#. type: SH
6579#: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
6580#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
6581#: start-stop-daemon.man:1 update-alternatives.man:1
6582#, no-wrap
6583msgid "EXIT STATUS"
6584msgstr ""
6585
6586#. type: TP
6587#: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
6588#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
6589#: start-stop-daemon.man:1 start-stop-daemon.man:1 update-alternatives.man:1
6590#, no-wrap
6591msgid "B<0>"
6592msgstr ""
6593
6594#. type: Plain text
6595#: dpkg.man:1 dpkg-trigger.man:1
6596msgid ""
6597"The requested action was successfully performed. Or a check or assertion "
6598"command returned true."
6599msgstr ""
6600
6601#. type: TP
6602#: dpkg.man:1 dpkg-query.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
6603#: dpkg-trigger.man:1 start-stop-daemon.man:1 start-stop-daemon.man:1
6604#, no-wrap
6605msgid "B<1>"
6606msgstr ""
6607
6608#. type: Plain text
6609#: dpkg.man:1 dpkg-trigger.man:1
6610msgid "A check or assertion command returned false."
6611msgstr ""
6612
6613#. type: TP
6614#: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
6615#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
6616#: start-stop-daemon.man:1 update-alternatives.man:1
6617#, no-wrap
6618msgid "B<2>"
6619msgstr ""
6620
6621#. type: Plain text
6622#: dpkg.man:1 dpkg-deb.man:1 dpkg-divert.man:1 dpkg-query.man:1
6623#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dselect.man:1
6624msgid ""
6625"Fatal or unrecoverable error due to invalid command-line usage, or "
6626"interactions with the system, such as accesses to the database, memory "
6627"allocations, etc."
6628msgstr ""
6629
6630#. type: SH
6631#: dpkg.man:1 dpkg-architecture.man:1 dpkg-buildflags.man:1
6632#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1
6633#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-gensymbols.man:1 dpkg-query.man:1
6634#: dpkg-source.man:1 dpkg-split.man:1 dpkg-statoverride.man:1
6635#: dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1 update-alternatives.man:1
6636#, no-wrap
6637msgid "ENVIRONMENT"
6638msgstr ""
6639
6640#. type: SS
6641#: dpkg.man:1 dpkg-buildpackage.man:1
6642#, no-wrap
6643msgid "External environment"
6644msgstr ""
6645
6646#. type: TP
6647#: dpkg.man:1
6648#, no-wrap
6649msgid "B<PATH>"
6650msgstr ""
6651
6652#. type: Plain text
6653#: dpkg.man:1
6654msgid ""
6655"This variable is expected to be defined in the environment and point to the "
6656"system paths where several required programs are to be found. If it's not "
6657"set or the programs are not found, B<dpkg> will abort."
6658msgstr ""
6659
6660#. type: TP
6661#: dpkg.man:1 dselect.man:1
6662#, no-wrap
6663msgid "B<HOME>"
6664msgstr ""
6665
6666#. type: Plain text
6667#: dpkg.man:1
6668msgid ""
6669"If set, B<dpkg> will use it as the directory from which to read the user "
6670"specific configuration file."
6671msgstr ""
6672
6673#. type: TP
6674#: dpkg.man:1 dpkg-deb.man:1
6675#, no-wrap
6676msgid "B<TMPDIR>"
6677msgstr ""
6678
6679#. type: Plain text
6680#: dpkg.man:1
6681msgid ""
6682"If set, B<dpkg> will use it as the directory in which to create temporary "
6683"files and directories."
6684msgstr ""
6685
6686#. type: TP
6687#: dpkg.man:1
6688#, no-wrap
6689msgid "B<PAGER>"
6690msgstr ""
6691
6692#. type: Plain text
6693#: dpkg.man:1
6694msgid "The program B<dpkg> will execute when displaying the conffiles."
6695msgstr ""
6696
6697#. type: TP
6698#: dpkg.man:1
6699#, no-wrap
6700msgid "B<SHELL>"
6701msgstr ""
6702
6703#. type: Plain text
6704#: dpkg.man:1
6705msgid "The program B<dpkg> will execute when starting a new interactive shell."
6706msgstr ""
6707
6708#. type: TP
6709#: dpkg.man:1 dpkg-query.man:1
6710#, no-wrap
6711msgid "B<COLUMNS>"
6712msgstr ""
6713
6714#. type: Plain text
6715#: dpkg.man:1
6716msgid ""
6717"Sets the number of columns B<dpkg> should use when displaying formatted "
6718"text. Currently only used by B<--list>."
6719msgstr ""
6720
6721#. type: TP
6722#: dpkg.man:1 dpkg-buildpackage.man:1
6723#, no-wrap
6724msgid "B<DPKG_COLORS>"
6725msgstr ""
6726
6727#. type: Plain text
6728#: dpkg.man:1 dpkg-buildpackage.man:1
6729msgid ""
6730"Sets the color mode (since dpkg 1.18.5). The currently accepted values are: "
6731"B<auto> (default), B<always> and B<never>."
6732msgstr ""
6733
6734#. type: SS
6735#: dpkg.man:1 dpkg-buildpackage.man:1
6736#, no-wrap
6737msgid "Internal environment"
6738msgstr ""
6739
6740#. type: TP
6741#: dpkg.man:1
6742#, no-wrap
6743msgid "B<DPKG_ROOT>"
6744msgstr ""
6745
6746#. type: Plain text
6747#: dpkg.man:1
6748msgid ""
6749"Defined by B<dpkg> on the maintainer script environment to indicate which "
6750"installation to act on (since dpkg 1.18.5). The value is intended to be "
6751"prepended to any path maintainer scripts operate on. During normal "
6752"operation, this variable is empty. When installing packages into a "
6753"different B<instdir>, B<dpkg> normally invokes maintainer scripts using "
6754"B<chroot>(2) and leaves this variable empty, but if "
6755"B<--force-script-chrootless> is specified then the B<chroot>(2) call is "
6756"skipped and B<instdir> is non-empty."
6757msgstr ""
6758
6759#. type: TP
6760#: dpkg.man:1 dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
6761#: dpkg-trigger.man:1 update-alternatives.man:1
6762#, no-wrap
6763msgid "B<DPKG_ADMINDIR>"
6764msgstr ""
6765
6766#. type: Plain text
6767#: dpkg.man:1
6768msgid ""
6769"Defined by B<dpkg> on the maintainer script environment to indicate the "
6770"B<dpkg> administrative directory to use (since dpkg 1.16.0). This variable "
6771"is always set to the current B<--admindir> value."
6772msgstr ""
6773
6774#. type: TP
6775#: dpkg.man:1
6776#, no-wrap
6777msgid "B<DPKG_SHELL_REASON>"
6778msgstr ""
6779
6780#. type: Plain text
6781#: dpkg.man:1
6782msgid ""
6783"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
6784"the situation (since dpkg 1.15.6). Current valid value: B<conffile-prompt>."
6785msgstr ""
6786
6787#. type: TP
6788#: dpkg.man:1
6789#, no-wrap
6790msgid "B<DPKG_CONFFILE_OLD>"
6791msgstr ""
6792
6793#. type: Plain text
6794#: dpkg.man:1
6795msgid ""
6796"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
6797"the situation (since dpkg 1.15.6). Contains the path to the old conffile."
6798msgstr ""
6799
6800#. type: TP
6801#: dpkg.man:1
6802#, no-wrap
6803msgid "B<DPKG_CONFFILE_NEW>"
6804msgstr ""
6805
6806#. type: Plain text
6807#: dpkg.man:1
6808msgid ""
6809"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
6810"the situation (since dpkg 1.15.6). Contains the path to the new conffile."
6811msgstr ""
6812
6813#. type: TP
6814#: dpkg.man:1
6815#, no-wrap
6816msgid "B<DPKG_HOOK_ACTION>"
6817msgstr ""
6818
6819#. type: Plain text
6820#: dpkg.man:1
6821msgid ""
6822"Defined by B<dpkg> on the shell spawned when executing a hook action (since "
6823"dpkg 1.15.4). Contains the current B<dpkg> action."
6824msgstr ""
6825
6826#. type: TP
6827#: dpkg.man:1
6828#, no-wrap
6829msgid "B<DPKG_RUNNING_VERSION>"
6830msgstr ""
6831
6832#. type: Plain text
6833#: dpkg.man:1
6834msgid ""
6835"Defined by B<dpkg> on the maintainer script environment to the version of "
6836"the currently running B<dpkg> instance (since dpkg 1.14.17)."
6837msgstr ""
6838
6839#. type: TP
6840#: dpkg.man:1 dpkg-divert.man:1
6841#, no-wrap
6842msgid "B<DPKG_MAINTSCRIPT_PACKAGE>"
6843msgstr ""
6844
6845#. type: Plain text
6846#: dpkg.man:1
6847msgid ""
6848"Defined by B<dpkg> on the maintainer script environment to the "
6849"(non-arch-qualified) package name being handled (since dpkg 1.14.17)."
6850msgstr ""
6851
6852#. type: TP
6853#: dpkg.man:1
6854#, no-wrap
6855msgid "B<DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT>"
6856msgstr ""
6857
6858#. type: Plain text
6859#: dpkg.man:1
6860msgid ""
6861"Defined by B<dpkg> on the maintainer script environment to the package "
6862"reference count, i.e. the number of package instances with a state greater "
6863"than B<not-installed> (since dpkg 1.17.2)."
6864msgstr ""
6865
6866#. type: TP
6867#: dpkg.man:1
6868#, no-wrap
6869msgid "B<DPKG_MAINTSCRIPT_ARCH>"
6870msgstr ""
6871
6872#. type: Plain text
6873#: dpkg.man:1
6874msgid ""
6875"Defined by B<dpkg> on the maintainer script environment to the architecture "
6876"the package got built for (since dpkg 1.15.4)."
6877msgstr ""
6878
6879#. type: TP
6880#: dpkg.man:1
6881#, no-wrap
6882msgid "B<DPKG_MAINTSCRIPT_NAME>"
6883msgstr ""
6884
6885#. type: Plain text
6886#: dpkg.man:1
6887msgid ""
6888"Defined by B<dpkg> on the maintainer script environment to the name of the "
6889"script running, one of B<preinst>, B<postinst>, B<prerm> or B<postrm> (since "
6890"dpkg 1.15.7)."
6891msgstr ""
6892
6893#. type: TP
6894#: dpkg.man:1
6895#, no-wrap
6896msgid "B<DPKG_MAINTSCRIPT_DEBUG>"
6897msgstr ""
6898
6899#. type: Plain text
6900#: dpkg.man:1
6901msgid ""
6902"Defined by B<dpkg> on the maintainer script environment to a value (‘B<0>’ "
6903"or ‘B<1>’) noting whether debugging has been requested (with the B<--debug> "
6904"option) for the maintainer scripts (since dpkg 1.18.4)."
6905msgstr ""
6906
6907#. type: Plain text
6908#: dpkg.man:1 dpkg.cfg.man:1
6909#, no-wrap
6910msgid "I<%PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*>"
6911msgstr ""
6912
6913#. type: Plain text
6914#: dpkg.man:1
6915msgid "Configuration fragment files (since dpkg 1.15.4)."
6916msgstr ""
6917
6918#. type: Plain text
6919#: dpkg.man:1 dpkg.cfg.man:1
6920#, no-wrap
6921msgid "I<%PKGCONFDIR%/dpkg.cfg>"
6922msgstr ""
6923
6924#. type: Plain text
6925#: dpkg.man:1
6926msgid "Configuration file with default options."
6927msgstr ""
6928
6929#. type: TP
6930#: dpkg.man:1
6931#, no-wrap
6932msgid "I<%LOGDIR%/dpkg.log>"
6933msgstr ""
6934
6935#. type: Plain text
6936#: dpkg.man:1
6937msgid "Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>)."
6938msgstr ""
6939
6940#. type: Plain text
6941#: dpkg.man:1
6942msgid ""
6943"The other files listed below are in their default directories, see option "
6944"B<--admindir> to see how to change locations of these files."
6945msgstr ""
6946
6947#. type: TP
6948#: dpkg.man:1
6949#, no-wrap
6950msgid "I<%ADMINDIR%/available>"
6951msgstr ""
6952
6953#. type: Plain text
6954#: dpkg.man:1
6955msgid "List of available packages."
6956msgstr ""
6957
6958#. type: TP
6959#: dpkg.man:1
6960#, no-wrap
6961msgid "I<%ADMINDIR%/status>"
6962msgstr ""
6963
6964#. type: Plain text
6965#: dpkg.man:1
6966msgid ""
6967"Statuses of available packages. This file contains information about whether "
6968"a package is marked for removing or not, whether it is installed or not, "
6969"etc. See section B<INFORMATION ABOUT PACKAGES> for more info."
6970msgstr ""
6971
6972#. type: Plain text
6973#: dpkg.man:1
6974msgid ""
6975"The status file is backed up daily in I</var/backups>. It can be useful if "
6976"it's lost or corrupted due to filesystems troubles."
6977msgstr ""
6978
6979#. type: Plain text
6980#: dpkg.man:1
6981msgid "The format and contents of a binary package are described in B<deb>(5)."
6982msgstr ""
6983
6984#. type: Plain text
6985#: dpkg.man:1
6986msgid "B<--no-act> usually gives less information than might be helpful."
6987msgstr ""
6988
6989#. type: Plain text
6990#: dpkg.man:1
6991msgid ""
6992"To list installed packages related to the editor B<vi>(1) (note that "
6993"B<dpkg-query> does not load the I<available> file anymore by default, and "
6994"the B<dpkg-query> B<--load-avail> option should be used instead for that):"
6995msgstr ""
6996
6997#. type: Plain text
6998#: dpkg.man:1
6999#, no-wrap
7000msgid " B<dpkg -l '*vi*'>\n"
7001msgstr ""
7002
7003#. type: Plain text
7004#: dpkg.man:1
7005msgid "To see the entries in I<%ADMINDIR%/available> of two packages:"
7006msgstr ""
7007
7008#. type: Plain text
7009#: dpkg.man:1
7010#, no-wrap
7011msgid " B<dpkg --print-avail elvis vim | less>\n"
7012msgstr ""
7013
7014#. type: Plain text
7015#: dpkg.man:1
7016msgid "To search the listing of packages yourself:"
7017msgstr ""
7018
7019#. type: Plain text
7020#: dpkg.man:1
7021#, no-wrap
7022msgid " B<less %ADMINDIR%/available>\n"
7023msgstr ""
7024
7025#. type: Plain text
7026#: dpkg.man:1
7027msgid "To remove an installed elvis package:"
7028msgstr ""
7029
7030#. type: Plain text
7031#: dpkg.man:1
7032#, no-wrap
7033msgid " B<dpkg -r elvis>\n"
7034msgstr ""
7035
7036#. type: Plain text
7037#: dpkg.man:1
7038msgid ""
7039"To install a package, you first need to find it in an archive or CDROM. The "
7040"I<available> file shows that the vim package is in section B<editors>:"
7041msgstr ""
7042
7043#. type: Plain text
7044#: dpkg.man:1
7045#, no-wrap
7046msgid ""
7047" B<cd /media/cdrom/pool/main/v/vim>\n"
7048" B<dpkg -i vim_4.5-3.deb>\n"
7049msgstr ""
7050
7051#. type: Plain text
7052#: dpkg.man:1
7053msgid "To make a local copy of the package selection states:"
7054msgstr ""
7055
7056#. type: Plain text
7057#: dpkg.man:1
7058#, no-wrap
7059msgid " B<dpkg --get-selections E<gt>myselections>\n"
7060msgstr ""
7061
7062#. type: Plain text
7063#: dpkg.man:1
7064msgid ""
7065"You might transfer this file to another computer, and after having updated "
7066"the I<available> file there with your package manager frontend of choice "
7067"(see https://wiki.debian.org/Teams/Dpkg/FAQ for more details), for example:"
7068msgstr ""
7069
7070#. type: Plain text
7071#: dpkg.man:1
7072#, no-wrap
7073msgid " B<apt-cache dumpavail | dpkg --merge-avail>\n"
7074msgstr ""
7075
7076#. type: Plain text
7077#: dpkg.man:1
7078msgid "or with dpkg 1.17.6 and earlier:"
7079msgstr ""
7080
7081#. type: Plain text
7082#: dpkg.man:1
7083#, no-wrap
7084msgid ""
7085" B<avail=`mktemp`>\n"
7086" B<apt-cache dumpavail E<gt>\"$avail\">\n"
7087" B<dpkg --merge-avail \"$avail\">\n"
7088" B<rm \"$avail\">\n"
7089msgstr ""
7090
7091#. type: Plain text
7092#: dpkg.man:1
7093msgid "you can install it with:"
7094msgstr ""
7095
7096#. type: Plain text
7097#: dpkg.man:1
7098#, no-wrap
7099msgid ""
7100" B<dpkg --clear-selections>\n"
7101" B<dpkg --set-selections E<lt>myselections>\n"
7102msgstr ""
7103
7104#. type: Plain text
7105#: dpkg.man:1
7106msgid ""
7107"Note that this will not actually install or remove anything, but just set "
7108"the selection state on the requested packages. You will need some other "
7109"application to actually download and install the requested packages. For "
7110"example, run B<apt-get dselect-upgrade>."
7111msgstr ""
7112
7113#. type: Plain text
7114#: dpkg.man:1
7115msgid ""
7116"Ordinarily, you will find that B<dselect>(1) provides a more convenient way "
7117"to modify the package selection states."
7118msgstr ""
7119
7120#. type: SH
7121#: dpkg.man:1
7122#, no-wrap
7123msgid "ADDITIONAL FUNCTIONALITY"
7124msgstr ""
7125
7126#. type: Plain text
7127#: dpkg.man:1
7128msgid ""
7129"Additional functionality can be gained by installing any of the following "
7130"packages: B<apt>, B<aptitude> and B<debsums>."
7131msgstr ""
7132
7133#. type: Plain text
7134#: dpkg.man:1
7135msgid ""
7136"B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), "
7137"B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8)."
7138msgstr ""
7139
7140#. type: SH
7141#: dpkg.man:1
7142#, no-wrap
7143msgid "AUTHORS"
7144msgstr ""
7145
7146#. type: Plain text
7147#: dpkg.man:1
7148msgid ""
7149"See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to "
7150"B<dpkg>."
7151msgstr ""
7152
7153#. type: TH
7154#: dpkg-architecture.man:1
7155#, no-wrap
7156msgid "dpkg-architecture"
7157msgstr ""
7158
7159#. type: Plain text
7160#: dpkg-architecture.man:1
7161msgid "dpkg-architecture - set and determine the architecture for package building"
7162msgstr ""
7163
7164#. type: Plain text
7165#: dpkg-architecture.man:1
7166msgid "B<dpkg-architecture> [I<option>...] [I<command>]"
7167msgstr ""
7168
7169#. type: Plain text
7170#: dpkg-architecture.man:1
7171msgid ""
7172"B<dpkg-architecture> provides a facility to determine and set the build and "
7173"host architecture for package building."
7174msgstr ""
7175
7176#. type: Plain text
7177#: dpkg-architecture.man:1
7178msgid ""
7179"The build architecture is always determined by an external call to "
7180"B<dpkg>(1), and cannot be set at the command line."
7181msgstr ""
7182
7183#. type: Plain text
7184#: dpkg-architecture.man:1
7185msgid ""
7186"You can specify the host architecture by providing one or both of the "
7187"options B<--host-arch> and B<--host-type>. The default is determined by an "
7188"external call to B<gcc>(1), or the same as the build architecture if B<CC> "
7189"or gcc are both not available. One out of B<--host-arch> and B<--host-type> "
7190"is sufficient, the value of the other will be set to a usable "
7191"default. Indeed, it is often better to only specify one, because "
7192"B<dpkg-architecture> will warn you if your choice does not match the "
7193"default."
7194msgstr ""
7195
7196#. type: SH
7197#: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-deb.man:1
7198#: dpkg-divert.man:1 dpkg-query.man:1 dpkg-source.man:1 dpkg-split.man:1
7199#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1 dselect.man:1
7200#: start-stop-daemon.man:1 update-alternatives.man:1
7201#, no-wrap
7202msgid "COMMANDS"
7203msgstr ""
7204
7205#. type: TP
7206#: dpkg-architecture.man:1
7207#, no-wrap
7208msgid "B<-l>, B<--list>"
7209msgstr ""
7210
7211#. type: Plain text
7212#: dpkg-architecture.man:1
7213msgid ""
7214"Print the environment variables, one each line, in the format "
7215"I<VARIABLE=value>. This is the default action."
7216msgstr ""
7217
7218#. type: TP
7219#: dpkg-architecture.man:1
7220#, no-wrap
7221msgid "B<-e>, B<--equal> I<architecture>"
7222msgstr ""
7223
7224#. type: Plain text
7225#: dpkg-architecture.man:1
7226msgid ""
7227"Check for equality of architecture (since dpkg 1.13.13). It compares the "
7228"current or specified Debian host architecture against I<architecture>, to "
7229"check if they are equal. This action will not expand the architecture "
7230"wildcards. Command finishes with an exit status of 0 if matched, 1 if not "
7231"matched."
7232msgstr ""
7233
7234#. type: TP
7235#: dpkg-architecture.man:1
7236#, no-wrap
7237msgid "B<-i>, B<--is> I<architecture-wildcard>"
7238msgstr ""
7239
7240#. type: Plain text
7241#: dpkg-architecture.man:1
7242msgid ""
7243"Check for identity of architecture (since dpkg 1.13.13). It compares the "
7244"current or specified Debian host architecture against "
7245"I<architecture-wildcard> after having expanded it as an architecture "
7246"wildcard, to check if they match. Command finishes with an exit status of 0 "
7247"if matched, 1 if not matched."
7248msgstr ""
7249
7250#. type: TP
7251#: dpkg-architecture.man:1
7252#, no-wrap
7253msgid "B<-q>, B<--query> I<variable-name>"
7254msgstr ""
7255
7256#. type: Plain text
7257#: dpkg-architecture.man:1
7258msgid "Print the value of a single variable."
7259msgstr ""
7260
7261#. type: TP
7262#: dpkg-architecture.man:1
7263#, no-wrap
7264msgid "B<-s>, B<--print-set>"
7265msgstr ""
7266
7267#. type: Plain text
7268#: dpkg-architecture.man:1
7269msgid ""
7270"Print an export command. This can be used to set the environment variables "
7271"using eval."
7272msgstr ""
7273
7274#. type: TP
7275#: dpkg-architecture.man:1
7276#, no-wrap
7277msgid "B<-u>, B<--print-unset>"
7278msgstr ""
7279
7280#. type: Plain text
7281#: dpkg-architecture.man:1
7282msgid "Print a similar command to B<--print-unset> but to unset all variables."
7283msgstr ""
7284
7285#. type: TP
7286#: dpkg-architecture.man:1
7287#, no-wrap
7288msgid "B<-c>, B<--command> I<command>"
7289msgstr ""
7290
7291#. type: Plain text
7292#: dpkg-architecture.man:1
7293msgid ""
7294"Execute a I<command> in an environment which has all variables set to the "
7295"determined value."
7296msgstr ""
7297
7298#. type: TP
7299#: dpkg-architecture.man:1
7300#, no-wrap
7301msgid "B<-L>, B<--list-known>"
7302msgstr ""
7303
7304#. type: Plain text
7305#: dpkg-architecture.man:1
7306msgid ""
7307"Print a list of valid architecture names. Possibly restricted by one or "
7308"more of the matching options B<--match-wildcard>, B<--match-bits> or "
7309"B<--match-endian> (since dpkg 1.17.14)."
7310msgstr ""
7311
7312#. type: Plain text
7313#: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
7314#: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
7315#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
7316#: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
7317#: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
7318#: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-split.man:1
7319#: dpkg-statoverride.man:1 dpkg-trigger.man:1 dpkg-vendor.man:1
7320#: update-alternatives.man:1
7321msgid "Show the usage message and exit."
7322msgstr ""
7323
7324#. type: Plain text
7325#: dpkg-architecture.man:1 dpkg-buildflags.man:1 dpkg-buildpackage.man:1
7326#: dpkg-genbuildinfo.man:1 dpkg-checkbuilddeps.man:1 dpkg-distaddfile.man:1
7327#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
7328#: dpkg-gensymbols.man:1 dpkg-mergechangelogs.man:1 dpkg-name.man:1
7329#: dpkg-parsechangelog.man:1 dpkg-query.man:1 dpkg-scanpackages.man:1
7330#: dpkg-scansources.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
7331#: dpkg-split.man:1 dpkg-statoverride.man:1 dpkg-trigger.man:1
7332#: dpkg-vendor.man:1 update-alternatives.man:1
7333msgid "Show the version and exit."
7334msgstr ""
7335
7336#. type: TP
7337#: dpkg-architecture.man:1 dpkg-buildpackage.man:1
7338#, no-wrap
7339msgid "B<-a>, B<--host-arch> I<architecture>"
7340msgstr ""
7341
7342#. type: Plain text
7343#: dpkg-architecture.man:1
7344msgid "Set the host Debian architecture."
7345msgstr ""
7346
7347#. type: TP
7348#: dpkg-architecture.man:1 dpkg-buildpackage.man:1
7349#, no-wrap
7350msgid "B<-t>, B<--host-type> I<gnu-system-type>"
7351msgstr ""
7352
7353#. type: Plain text
7354#: dpkg-architecture.man:1
7355msgid "Set the host GNU system type."
7356msgstr ""
7357
7358#. type: TP
7359#: dpkg-architecture.man:1
7360#, no-wrap
7361msgid "B<-A>, B<--target-arch> I<architecture>"
7362msgstr ""
7363
7364#. type: Plain text
7365#: dpkg-architecture.man:1
7366msgid "Set the target Debian architecture (since dpkg 1.17.14)."
7367msgstr ""
7368
7369#. type: TP
7370#: dpkg-architecture.man:1
7371#, no-wrap
7372msgid "B<-T>, B<--target-type> I<gnu-system-type>"
7373msgstr ""
7374
7375#. type: Plain text
7376#: dpkg-architecture.man:1
7377msgid "Set the target GNU system type (since dpkg 1.17.14)."
7378msgstr ""
7379
7380#. type: TP
7381#: dpkg-architecture.man:1
7382#, no-wrap
7383msgid "B<-W>, B<--match-wildcard> I<architecture-wildcard>"
7384msgstr ""
7385
7386#. type: Plain text
7387#: dpkg-architecture.man:1
7388msgid ""
7389"Restrict the architectures listed by B<--list-known> to ones matching the "
7390"specified architecture wildcard (since dpkg 1.17.14)."
7391msgstr ""
7392
7393#. type: TP
7394#: dpkg-architecture.man:1
7395#, no-wrap
7396msgid "B<-B>, B<--match-bits> I<architecture-bits>"
7397msgstr ""
7398
7399#. type: Plain text
7400#: dpkg-architecture.man:1
7401msgid ""
7402"Restrict the architectures listed by B<--list-known> to ones with the "
7403"specified CPU bits (since dpkg 1.17.14). Either B<32> or B<64>."
7404msgstr ""
7405
7406#. type: TP
7407#: dpkg-architecture.man:1
7408#, no-wrap
7409msgid "B<-E>, B<--match-endian> I<architecture-endianness>"
7410msgstr ""
7411
7412#. type: Plain text
7413#: dpkg-architecture.man:1
7414msgid ""
7415"Restrict the architectures listed by B<--list-known> to ones with the "
7416"specified endianness (since dpkg 1.17.14). Either B<little> or B<big>."
7417msgstr ""
7418
7419#. type: TP
7420#: dpkg-architecture.man:1
7421#, no-wrap
7422msgid "B<-f>, B<--force>"
7423msgstr ""
7424
7425#. type: Plain text
7426#: dpkg-architecture.man:1
7427msgid ""
7428"Values set by existing environment variables with the same name as used by "
7429"the scripts are honored (i.e. used by B<dpkg-architecture>), except if this "
7430"force flag is present. This allows the user to override a value even when "
7431"the call to B<dpkg-architecture> is buried in some other script (for example "
7432"B<dpkg-buildpackage>(1))."
7433msgstr ""
7434
7435#. type: SH
7436#: dpkg-architecture.man:1
7437#, no-wrap
7438msgid "TERMS"
7439msgstr ""
7440
7441#. type: IP
7442#: dpkg-architecture.man:1
7443#, no-wrap
7444msgid "build machine"
7445msgstr ""
7446
7447#. type: Plain text
7448#: dpkg-architecture.man:1
7449msgid "The machine the package is built on."
7450msgstr ""
7451
7452#. type: IP
7453#: dpkg-architecture.man:1
7454#, no-wrap
7455msgid "host machine"
7456msgstr ""
7457
7458#. type: Plain text
7459#: dpkg-architecture.man:1
7460msgid "The machine the package is built for."
7461msgstr ""
7462
7463#. type: IP
7464#: dpkg-architecture.man:1
7465#, no-wrap
7466msgid "target machine"
7467msgstr ""
7468
7469#. type: Plain text
7470#: dpkg-architecture.man:1
7471msgid ""
7472"The machine the compiler is building for. This is only needed when building "
7473"a cross-toolchain, one that will be built on the build architecture, to be "
7474"run on the host architecture, and to build code for the target architecture."
7475msgstr ""
7476
7477#. type: IP
7478#: dpkg-architecture.man:1
7479#, no-wrap
7480msgid "Debian architecture"
7481msgstr ""
7482
7483#. type: Plain text
7484#: dpkg-architecture.man:1
7485msgid ""
7486"The Debian architecture string, which specifies the binary tree in the FTP "
7487"archive. Examples: i386, sparc, hurd-i386."
7488msgstr ""
7489
7490#. type: IP
7491#: dpkg-architecture.man:1
7492#, no-wrap
7493msgid "Debian architecture tuple"
7494msgstr ""
7495
7496#. type: Plain text
7497#: dpkg-architecture.man:1
7498msgid ""
7499"A Debian architecture tuple is the fully qualified architecture with all its "
7500"components spelled out. This differs with Debian architectures in that at "
7501"least the I<cpu> component does not embed the I<abi>. The current tuple has "
7502"the form I<abi>-I<libc>-I<os>-I<cpu>. Examples: base-gnu-linux-amd64, "
7503"eabihf-musl-linux-arm."
7504msgstr ""
7505
7506#. type: IP
7507#: dpkg-architecture.man:1
7508#, no-wrap
7509msgid "Debian architecture wildcard"
7510msgstr ""
7511
7512#. type: Plain text
7513#: dpkg-architecture.man:1
7514msgid ""
7515"A Debian architecture wildcard is a special architecture string that will "
7516"match any real architecture being part of it. The general form is a Debian "
7517"architecture tuple with four or less elements, and with at least one of them "
7518"being B<any>. Missing elements of the tuple are prefixed implicitly as "
7519"B<any>, and thus the following pairs are equivalent:"
7520msgstr ""
7521
7522#. type: Plain text
7523#: dpkg-architecture.man:1
7524#, no-wrap
7525msgid ""
7526" B<any>-B<any>-B<any>-B<any> = B<any>\n"
7527" B<any>-B<any>-I<os>-B<any> = I<os>-B<any>\n"
7528" B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>\n"
7529msgstr ""
7530
7531#. type: Plain text
7532#: dpkg-architecture.man:1
7533msgid "Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any."
7534msgstr ""
7535
7536#. type: IP
7537#: dpkg-architecture.man:1
7538#, no-wrap
7539msgid "GNU system type"
7540msgstr ""
7541
7542#. type: Plain text
7543#: dpkg-architecture.man:1
7544msgid ""
7545"An architecture specification string consisting of two parts separated by a "
7546"hyphen: cpu and system. Examples: i586-linux-gnu, sparc-linux-gnu, "
7547"i686-gnu, x86_64-netbsd."
7548msgstr ""
7549
7550#. type: IP
7551#: dpkg-architecture.man:1
7552#, no-wrap
7553msgid "multiarch triplet"
7554msgstr ""
7555
7556#. type: Plain text
7557#: dpkg-architecture.man:1
7558msgid ""
7559"The clarified GNU system type, used for filesystem paths. This triplet does "
7560"not change even when the baseline ISA gets bumped, so that the resulting "
7561"paths are stable over time. The only current difference with the GNU system "
7562"type is that the CPU part for i386 based systems is always i386. Examples: "
7563"i386-linux-gnu, x86_64-linux-gnu. Example paths: "
7564"/lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-gnu/."
7565msgstr ""
7566
7567#. type: SH
7568#: dpkg-architecture.man:1
7569#, no-wrap
7570msgid "VARIABLES"
7571msgstr ""
7572
7573#. type: Plain text
7574#: dpkg-architecture.man:1
7575msgid "The following variables are set by B<dpkg-architecture>:"
7576msgstr ""
7577
7578#. type: IP
7579#: dpkg-architecture.man:1
7580#, no-wrap
7581msgid "B<DEB_BUILD_ARCH>"
7582msgstr ""
7583
7584#. type: Plain text
7585#: dpkg-architecture.man:1
7586msgid "The Debian architecture of the build machine."
7587msgstr ""
7588
7589#. type: IP
7590#: dpkg-architecture.man:1
7591#, no-wrap
7592msgid "B<DEB_BUILD_ARCH_ABI>"
7593msgstr ""
7594
7595#. type: Plain text
7596#: dpkg-architecture.man:1
7597msgid "The Debian abi name of the build machine (since dpkg 1.18.11)."
7598msgstr ""
7599
7600#. type: IP
7601#: dpkg-architecture.man:1
7602#, no-wrap
7603msgid "B<DEB_BUILD_ARCH_LIBC>"
7604msgstr ""
7605
7606#. type: Plain text
7607#: dpkg-architecture.man:1
7608msgid "The Debian libc name of the build machine (since dpkg 1.18.11)."
7609msgstr ""
7610
7611#. type: IP
7612#: dpkg-architecture.man:1
7613#, no-wrap
7614msgid "B<DEB_BUILD_ARCH_OS>"
7615msgstr ""
7616
7617#. type: Plain text
7618#: dpkg-architecture.man:1
7619msgid "The Debian system name of the build machine (since dpkg 1.13.2)."
7620msgstr ""
7621
7622#. type: IP
7623#: dpkg-architecture.man:1
7624#, no-wrap
7625msgid "B<DEB_BUILD_ARCH_CPU>"
7626msgstr ""
7627
7628#. type: Plain text
7629#: dpkg-architecture.man:1
7630msgid "The Debian cpu name of the build machine (since dpkg 1.13.2)."
7631msgstr ""
7632
7633#. type: IP
7634#: dpkg-architecture.man:1
7635#, no-wrap
7636msgid "B<DEB_BUILD_ARCH_BITS>"
7637msgstr ""
7638
7639#. type: Plain text
7640#: dpkg-architecture.man:1
7641msgid "The pointer size of the build machine (in bits; since dpkg 1.15.4)."
7642msgstr ""
7643
7644#. type: IP
7645#: dpkg-architecture.man:1
7646#, no-wrap
7647msgid "B<DEB_BUILD_ARCH_ENDIAN>"
7648msgstr ""
7649
7650#. type: Plain text
7651#: dpkg-architecture.man:1
7652msgid "The endianness of the build machine (little / big; since dpkg 1.15.4)."
7653msgstr ""
7654
7655#. type: IP
7656#: dpkg-architecture.man:1
7657#, no-wrap
7658msgid "B<DEB_BUILD_GNU_CPU>"
7659msgstr ""
7660
7661#. type: Plain text
7662#: dpkg-architecture.man:1
7663msgid "The CPU part of B<DEB_BUILD_GNU_TYPE>."
7664msgstr ""
7665
7666#. type: IP
7667#: dpkg-architecture.man:1
7668#, no-wrap
7669msgid "B<DEB_BUILD_GNU_SYSTEM>"
7670msgstr ""
7671
7672#. type: Plain text
7673#: dpkg-architecture.man:1
7674msgid "The System part of B<DEB_BUILD_GNU_TYPE>."
7675msgstr ""
7676
7677#. type: IP
7678#: dpkg-architecture.man:1
7679#, no-wrap
7680msgid "B<DEB_BUILD_GNU_TYPE>"
7681msgstr ""
7682
7683#. type: Plain text
7684#: dpkg-architecture.man:1
7685msgid "The GNU system type of the build machine."
7686msgstr ""
7687
7688#. type: IP
7689#: dpkg-architecture.man:1
7690#, no-wrap
7691msgid "B<DEB_BUILD_MULTIARCH>"
7692msgstr ""
7693
7694#. type: Plain text
7695#: dpkg-architecture.man:1
7696msgid ""
7697"The clarified GNU system type of the build machine, used for filesystem "
7698"paths (since dpkg 1.16.0)."
7699msgstr ""
7700
7701#. type: IP
7702#: dpkg-architecture.man:1
7703#, no-wrap
7704msgid "B<DEB_HOST_ARCH>"
7705msgstr ""
7706
7707#. type: Plain text
7708#: dpkg-architecture.man:1
7709msgid "The Debian architecture of the host machine."
7710msgstr ""
7711
7712#. type: IP
7713#: dpkg-architecture.man:1
7714#, no-wrap
7715msgid "B<DEB_HOST_ARCH_ABI>"
7716msgstr ""
7717
7718#. type: Plain text
7719#: dpkg-architecture.man:1
7720msgid "The Debian abi name of the host machine (since dpkg 1.18.11)."
7721msgstr ""
7722
7723#. type: IP
7724#: dpkg-architecture.man:1
7725#, no-wrap
7726msgid "B<DEB_HOST_ARCH_LIBC>"
7727msgstr ""
7728
7729#. type: Plain text
7730#: dpkg-architecture.man:1
7731msgid "The Debian libc name of the host machine (since dpkg 1.18.11)."
7732msgstr ""
7733
7734#. type: IP
7735#: dpkg-architecture.man:1
7736#, no-wrap
7737msgid "B<DEB_HOST_ARCH_OS>"
7738msgstr ""
7739
7740#. type: Plain text
7741#: dpkg-architecture.man:1
7742msgid "The Debian system name of the host machine (since dpkg 1.13.2)."
7743msgstr ""
7744
7745#. type: IP
7746#: dpkg-architecture.man:1
7747#, no-wrap
7748msgid "B<DEB_HOST_ARCH_CPU>"
7749msgstr ""
7750
7751#. type: Plain text
7752#: dpkg-architecture.man:1
7753msgid "The Debian cpu name of the host machine (since dpkg 1.13.2)."
7754msgstr ""
7755
7756#. type: IP
7757#: dpkg-architecture.man:1
7758#, no-wrap
7759msgid "B<DEB_HOST_ARCH_BITS>"
7760msgstr ""
7761
7762#. type: Plain text
7763#: dpkg-architecture.man:1
7764msgid "The pointer size of the host machine (in bits; since dpkg 1.15.4)."
7765msgstr ""
7766
7767#. type: IP
7768#: dpkg-architecture.man:1
7769#, no-wrap
7770msgid "B<DEB_HOST_ARCH_ENDIAN>"
7771msgstr ""
7772
7773#. type: Plain text
7774#: dpkg-architecture.man:1
7775msgid "The endianness of the host machine (little / big; since dpkg 1.15.4)."
7776msgstr ""
7777
7778#. type: IP
7779#: dpkg-architecture.man:1
7780#, no-wrap
7781msgid "B<DEB_HOST_GNU_CPU>"
7782msgstr ""
7783
7784#. type: Plain text
7785#: dpkg-architecture.man:1
7786msgid "The CPU part of B<DEB_HOST_GNU_TYPE>."
7787msgstr ""
7788
7789#. type: IP
7790#: dpkg-architecture.man:1
7791#, no-wrap
7792msgid "B<DEB_HOST_GNU_SYSTEM>"
7793msgstr ""
7794
7795#. type: Plain text
7796#: dpkg-architecture.man:1
7797msgid "The System part of B<DEB_HOST_GNU_TYPE>."
7798msgstr ""
7799
7800#. type: IP
7801#: dpkg-architecture.man:1
7802#, no-wrap
7803msgid "B<DEB_HOST_GNU_TYPE>"
7804msgstr ""
7805
7806#. type: Plain text
7807#: dpkg-architecture.man:1
7808msgid "The GNU system type of the host machine."
7809msgstr ""
7810
7811#. type: IP
7812#: dpkg-architecture.man:1
7813#, no-wrap
7814msgid "B<DEB_HOST_MULTIARCH>"
7815msgstr ""
7816
7817#. type: Plain text
7818#: dpkg-architecture.man:1
7819msgid ""
7820"The clarified GNU system type of the host machine, used for filesystem paths "
7821"(since dpkg 1.16.0)."
7822msgstr ""
7823
7824#. type: IP
7825#: dpkg-architecture.man:1
7826#, no-wrap
7827msgid "B<DEB_TARGET_ARCH>"
7828msgstr ""
7829
7830#. type: Plain text
7831#: dpkg-architecture.man:1
7832msgid "The Debian architecture of the target machine (since dpkg 1.17.14)."
7833msgstr ""
7834
7835#. type: IP
7836#: dpkg-architecture.man:1
7837#, no-wrap
7838msgid "B<DEB_TARGET_ARCH_ABI>"
7839msgstr ""
7840
7841#. type: Plain text
7842#: dpkg-architecture.man:1
7843msgid "The Debian abi name of the target machine (since dpkg 1.18.11)."
7844msgstr ""
7845
7846#. type: IP
7847#: dpkg-architecture.man:1
7848#, no-wrap
7849msgid "B<DEB_TARGET_ARCH_LIBC>"
7850msgstr ""
7851
7852#. type: Plain text
7853#: dpkg-architecture.man:1
7854msgid "The Debian libc name of the target machine (since dpkg 1.18.11)."
7855msgstr ""
7856
7857#. type: IP
7858#: dpkg-architecture.man:1
7859#, no-wrap
7860msgid "B<DEB_TARGET_ARCH_OS>"
7861msgstr ""
7862
7863#. type: Plain text
7864#: dpkg-architecture.man:1
7865msgid "The Debian system name of the target machine (since dpkg 1.17.14)."
7866msgstr ""
7867
7868#. type: IP
7869#: dpkg-architecture.man:1
7870#, no-wrap
7871msgid "B<DEB_TARGET_ARCH_CPU>"
7872msgstr ""
7873
7874#. type: Plain text
7875#: dpkg-architecture.man:1
7876msgid "The Debian cpu name of the target machine (since dpkg 1.17.14)."
7877msgstr ""
7878
7879#. type: IP
7880#: dpkg-architecture.man:1
7881#, no-wrap
7882msgid "B<DEB_TARGET_ARCH_BITS>"
7883msgstr ""
7884
7885#. type: Plain text
7886#: dpkg-architecture.man:1
7887msgid "The pointer size of the target machine (in bits; since dpkg 1.17.14)."
7888msgstr ""
7889
7890#. type: IP
7891#: dpkg-architecture.man:1
7892#, no-wrap
7893msgid "B<DEB_TARGET_ARCH_ENDIAN>"
7894msgstr ""
7895
7896#. type: Plain text
7897#: dpkg-architecture.man:1
7898msgid "The endianness of the target machine (little / big; since dpkg 1.17.14)."
7899msgstr ""
7900
7901#. type: IP
7902#: dpkg-architecture.man:1
7903#, no-wrap
7904msgid "B<DEB_TARGET_GNU_CPU>"
7905msgstr ""
7906
7907#. type: Plain text
7908#: dpkg-architecture.man:1
7909msgid "The CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
7910msgstr ""
7911
7912#. type: IP
7913#: dpkg-architecture.man:1
7914#, no-wrap
7915msgid "B<DEB_TARGET_GNU_SYSTEM>"
7916msgstr ""
7917
7918#. type: Plain text
7919#: dpkg-architecture.man:1
7920msgid "The System part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
7921msgstr ""
7922
7923#. type: IP
7924#: dpkg-architecture.man:1
7925#, no-wrap
7926msgid "B<DEB_TARGET_GNU_TYPE>"
7927msgstr ""
7928
7929#. type: Plain text
7930#: dpkg-architecture.man:1
7931msgid "The GNU system type of the target machine (since dpkg 1.17.14)."
7932msgstr ""
7933
7934#. type: IP
7935#: dpkg-architecture.man:1
7936#, no-wrap
7937msgid "B<DEB_TARGET_MULTIARCH>"
7938msgstr ""
7939
7940#. type: Plain text
7941#: dpkg-architecture.man:1
7942msgid ""
7943"The clarified GNU system type of the target machine, used for filesystem "
7944"paths (since dpkg 1.17.14)."
7945msgstr ""
7946
7947#. type: SS
7948#: dpkg-architecture.man:1
7949#, no-wrap
7950msgid "Architecture tables"
7951msgstr ""
7952
7953#. type: Plain text
7954#: dpkg-architecture.man:1
7955msgid ""
7956"All these files have to be present for B<dpkg-architecture> to work. Their "
7957"location can be overridden at runtime with the environment variable "
7958"B<DPKG_DATADIR>. These tables contain a format B<Version> pseudo-field on "
7959"their first line to mark their format, so that parsers can check if they "
7960"understand it, such as \"# Version=1.0\"."
7961msgstr ""
7962
7963#. type: TP
7964#: dpkg-architecture.man:1
7965#, no-wrap
7966msgid "I<%PKGDATADIR%/cputable>"
7967msgstr ""
7968
7969#. type: Plain text
7970#: dpkg-architecture.man:1
7971msgid ""
7972"Table of known CPU names and mapping to their GNU name. Format version 1.0 "
7973"(since dpkg 1.13.2)."
7974msgstr ""
7975
7976#. type: TP
7977#: dpkg-architecture.man:1
7978#, no-wrap
7979msgid "I<%PKGDATADIR%/ostable>"
7980msgstr ""
7981
7982#. type: Plain text
7983#: dpkg-architecture.man:1
7984msgid ""
7985"Table of known operating system names and mapping to their GNU name. Format "
7986"version 2.0 (since dpkg 1.18.11)."
7987msgstr ""
7988
7989#. type: TP
7990#: dpkg-architecture.man:1
7991#, no-wrap
7992msgid "I<%PKGDATADIR%/tupletable>"
7993msgstr ""
7994
7995#. type: Plain text
7996#: dpkg-architecture.man:1
7997msgid ""
7998"Mapping between Debian architecture tuples and Debian architecture names. "
7999"Format version 1.0 (since dpkg 1.18.11)."
8000msgstr ""
8001
8002#. type: TP
8003#: dpkg-architecture.man:1
8004#, no-wrap
8005msgid "I<%PKGDATADIR%/abitable>"
8006msgstr ""
8007
8008#. type: Plain text
8009#: dpkg-architecture.man:1
8010msgid ""
8011"Table of Debian architecture ABI attribute overrides. Format version 2.0 "
8012"(since dpkg 1.18.11)."
8013msgstr ""
8014
8015#. type: SS
8016#: dpkg-architecture.man:1 dpkg-buildflags.man:1
8017#, no-wrap
8018msgid "Packaging support"
8019msgstr ""
8020
8021#. type: TP
8022#: dpkg-architecture.man:1
8023#, no-wrap
8024msgid "I<%PKGDATADIR%/architecture.mk>"
8025msgstr ""
8026
8027#. type: Plain text
8028#: dpkg-architecture.man:1
8029msgid ""
8030"Makefile snippet that properly sets and exports all the variables that "
8031"B<dpkg-architecture> outputs (since dpkg 1.16.1)."
8032msgstr ""
8033
8034#. type: Plain text
8035#: dpkg-architecture.man:1
8036msgid ""
8037"B<dpkg-buildpackage> accepts the B<-a> option and passes it to "
8038"B<dpkg-architecture>. Other examples:"
8039msgstr ""
8040
8041#. type: Plain text
8042#: dpkg-architecture.man:1
8043msgid "CC=i386-gnu-gcc dpkg-architecture -c debian/rules build"
8044msgstr ""
8045
8046#. type: Plain text
8047#: dpkg-architecture.man:1
8048msgid "eval \\`dpkg-architecture -u\\`"
8049msgstr ""
8050
8051#. type: Plain text
8052#: dpkg-architecture.man:1
8053msgid ""
8054"Check if the current or specified host architecture is equal to an "
8055"architecture:"
8056msgstr ""
8057
8058#. type: Plain text
8059#: dpkg-architecture.man:1
8060msgid "dpkg-architecture -elinux-alpha"
8061msgstr ""
8062
8063#. type: Plain text
8064#: dpkg-architecture.man:1
8065msgid "dpkg-architecture -amips -elinux-mips"
8066msgstr ""
8067
8068#. type: Plain text
8069#: dpkg-architecture.man:1
8070msgid "Check if the current or specified host architecture is a Linux system:"
8071msgstr ""
8072
8073#. type: Plain text
8074#: dpkg-architecture.man:1
8075msgid "dpkg-architecture -ilinux-any"
8076msgstr ""
8077
8078#. type: Plain text
8079#: dpkg-architecture.man:1
8080msgid "dpkg-architecture -ai386 -ilinux-any"
8081msgstr ""
8082
8083#. type: SS
8084#: dpkg-architecture.man:1 dpkg-buildflags.man:1
8085#, no-wrap
8086msgid "Usage in debian/rules"
8087msgstr ""
8088
8089#. type: Plain text
8090#: dpkg-architecture.man:1
8091msgid ""
8092"The environment variables set by B<dpkg-architecture> are passed to "
8093"I<debian/rules> as make variables (see make documentation). However, you "
8094"should not rely on them, as this breaks manual invocation of the "
8095"script. Instead, you should always initialize them using "
8096"B<dpkg-architecture> with the B<-q> option. Here are some examples, which "
8097"also show how you can improve the cross compilation support in your package:"
8098msgstr ""
8099
8100#. type: Plain text
8101#: dpkg-architecture.man:1
8102msgid "Retrieving the GNU system type and forwarding it to ./configure:"
8103msgstr ""
8104
8105#. type: Plain text
8106#: dpkg-architecture.man:1
8107#, no-wrap
8108msgid ""
8109"DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)\n"
8110"DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)\n"
8111"[...]\n"
8112"ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))\n"
8113" confflags += --build=$(DEB_HOST_GNU_TYPE)\n"
8114"else\n"
8115" confflags += --build=$(DEB_BUILD_GNU_TYPE) \\e\n"
8116" --host=$(DEB_HOST_GNU_TYPE)\n"
8117"endif\n"
8118"[...]\n"
8119"\\&./configure $(confflags)\n"
8120msgstr ""
8121
8122#. type: Plain text
8123#: dpkg-architecture.man:1
8124msgid "Doing something only for a specific architecture:"
8125msgstr ""
8126
8127#. type: Plain text
8128#: dpkg-architecture.man:1
8129#, no-wrap
8130msgid "DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)\n"
8131msgstr ""
8132
8133#. type: Plain text
8134#: dpkg-architecture.man:1 dpkg-architecture.man:1
8135#, no-wrap
8136msgid ""
8137"ifeq ($(DEB_HOST_ARCH),alpha)\n"
8138" [...]\n"
8139"endif\n"
8140msgstr ""
8141
8142#. type: Plain text
8143#: dpkg-architecture.man:1
8144msgid ""
8145"or if you only need to check the CPU or OS type, use the "
8146"B<DEB_HOST_ARCH_CPU> or B<DEB_HOST_ARCH_OS> variables."
8147msgstr ""
8148
8149#. type: Plain text
8150#: dpkg-architecture.man:1
8151msgid ""
8152"Note that you can also rely on an external Makefile snippet to properly set "
8153"all the variables that B<dpkg-architecture> can provide:"
8154msgstr ""
8155
8156#. type: Plain text
8157#: dpkg-architecture.man:1
8158#, no-wrap
8159msgid "include %PKGDATADIR%/architecture.mk\n"
8160msgstr ""
8161
8162#. type: Plain text
8163#: dpkg-architecture.man:1
8164msgid ""
8165"In any case, you should never use B<dpkg --print-architecture> to get "
8166"architecture information during a package build."
8167msgstr ""
8168
8169#. type: TP
8170#: dpkg-architecture.man:1
8171#, no-wrap
8172msgid "B<DPKG_DATADIR>"
8173msgstr ""
8174
8175#. type: Plain text
8176#: dpkg-architecture.man:1
8177msgid ""
8178"If set, it will be used as the B<dpkg> data directory, where the "
8179"architecture tables are located (since dpkg 1.14.17). Defaults to "
8180"«%PKGDATADIR%»."
8181msgstr ""
8182
8183#. type: Plain text
8184#: dpkg-architecture.man:1
8185msgid "All long command and option names available only since dpkg 1.17.17."
8186msgstr ""
8187
8188#. type: Plain text
8189#: dpkg-architecture.man:1
8190msgid "B<dpkg-buildpackage>(1), B<dpkg-cross>(1)."
8191msgstr ""
8192
8193#. type: TH
8194#: dpkg.cfg.man:1
8195#, no-wrap
8196msgid "dpkg.cfg"
8197msgstr ""
8198
8199#. type: Plain text
8200#: dpkg.cfg.man:1
8201msgid "dpkg.cfg - dpkg configuration file"
8202msgstr ""
8203
8204#. type: Plain text
8205#: dpkg.cfg.man:1
8206msgid ""
8207"This file contains default options for dpkg. Each line contains a single "
8208"option which is exactly the same as a normal command line option for dpkg "
8209"except for the leading hyphens which are not used here. Quotes surrounding "
8210"option values are stripped. Comments are allowed by starting a line with a "
8211"hash sign (‘B<#>’)."
8212msgstr ""
8213
8214#. type: Plain text
8215#: dpkg.cfg.man:1
8216msgid "I<~/.dpkg.cfg>"
8217msgstr ""
8218
8219#. type: TH
8220#: dpkg-buildflags.man:1
8221#, no-wrap
8222msgid "dpkg-buildflags"
8223msgstr ""
8224
8225#. type: Plain text
8226#: dpkg-buildflags.man:1
8227msgid "dpkg-buildflags - returns build flags to use during package build"
8228msgstr ""
8229
8230#. type: Plain text
8231#: dpkg-buildflags.man:1
8232msgid "B<dpkg-buildflags> [I<option>...] [I<command>]"
8233msgstr ""
8234
8235#. type: Plain text
8236#: dpkg-buildflags.man:1
8237msgid ""
8238"B<dpkg-buildflags> is a tool to retrieve compilation flags to use during "
8239"build of Debian packages."
8240msgstr ""
8241
8242#. type: Plain text
8243#: dpkg-buildflags.man:1
8244msgid ""
8245"The default flags are defined by the vendor but they can be "
8246"extended/overridden in several ways:"
8247msgstr ""
8248
8249#. type: IP
8250#: dpkg-buildflags.man:1
8251#, no-wrap
8252msgid "1."
8253msgstr ""
8254
8255#. type: Plain text
8256#: dpkg-buildflags.man:1
8257msgid "system-wide with B<%PKGCONFDIR%/buildflags.conf>;"
8258msgstr ""
8259
8260#. type: IP
8261#: dpkg-buildflags.man:1
8262#, no-wrap
8263msgid "2."
8264msgstr ""
8265
8266#. type: Plain text
8267#: dpkg-buildflags.man:1
8268msgid ""
8269"for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where "
8270"B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;"
8271msgstr ""
8272
8273#. type: IP
8274#: dpkg-buildflags.man:1
8275#, no-wrap
8276msgid "3."
8277msgstr ""
8278
8279#. type: Plain text
8280#: dpkg-buildflags.man:1
8281msgid ""
8282"temporarily by the user with environment variables (see section "
8283"B<ENVIRONMENT>);"
8284msgstr ""
8285
8286#. type: IP
8287#: dpkg-buildflags.man:1
8288#, no-wrap
8289msgid "4."
8290msgstr ""
8291
8292#. type: Plain text
8293#: dpkg-buildflags.man:1
8294msgid ""
8295"dynamically by the package maintainer with environment variables set via "
8296"B<debian/rules> (see section B<ENVIRONMENT>)."
8297msgstr ""
8298
8299#. type: Plain text
8300#: dpkg-buildflags.man:1
8301msgid "The configuration files can contain four types of directives:"
8302msgstr ""
8303
8304#. type: TP
8305#: dpkg-buildflags.man:1
8306#, no-wrap
8307msgid "B<SET>I< flag value>"
8308msgstr ""
8309
8310#. type: Plain text
8311#: dpkg-buildflags.man:1
8312msgid "Override the flag named I<flag> to have the value I<value>."
8313msgstr ""
8314
8315#. type: TP
8316#: dpkg-buildflags.man:1
8317#, no-wrap
8318msgid "B<STRIP>I< flag value>"
8319msgstr ""
8320
8321#. type: Plain text
8322#: dpkg-buildflags.man:1
8323msgid "Strip from the flag named I<flag> all the build flags listed in I<value>."
8324msgstr ""
8325
8326#. type: TP
8327#: dpkg-buildflags.man:1
8328#, no-wrap
8329msgid "B<APPEND>I< flag value>"
8330msgstr ""
8331
8332#. type: Plain text
8333#: dpkg-buildflags.man:1
8334msgid ""
8335"Extend the flag named I<flag> by appending the options given in I<value>. A "
8336"space is prepended to the appended value if the flag's current value is "
8337"non-empty."
8338msgstr ""
8339
8340#. type: TP
8341#: dpkg-buildflags.man:1
8342#, no-wrap
8343msgid "B<PREPEND>I< flag value>"
8344msgstr ""
8345
8346#. type: Plain text
8347#: dpkg-buildflags.man:1
8348msgid ""
8349"Extend the flag named I<flag> by prepending the options given in I<value>. "
8350"A space is appended to the prepended value if the flag's current value is "
8351"non-empty."
8352msgstr ""
8353
8354#. type: Plain text
8355#: dpkg-buildflags.man:1
8356msgid ""
8357"The configuration files can contain comments on lines starting with a hash "
8358"(#). Empty lines are also ignored."
8359msgstr ""
8360
8361#. type: TP
8362#: dpkg-buildflags.man:1
8363#, no-wrap
8364msgid "B<--dump>"
8365msgstr ""
8366
8367#. type: Plain text
8368#: dpkg-buildflags.man:1
8369msgid ""
8370"Print to standard output all compilation flags and their values. It prints "
8371"one flag per line separated from its value by an equal sign "
8372"(“I<flag>=I<value>”). This is the default action."
8373msgstr ""
8374
8375#. type: TP
8376#: dpkg-buildflags.man:1
8377#, no-wrap
8378msgid "B<--list>"
8379msgstr ""
8380
8381#. type: Plain text
8382#: dpkg-buildflags.man:1
8383msgid ""
8384"Print the list of flags supported by the current vendor (one per line). See "
8385"the B<SUPPORTED FLAGS> section for more information about them."
8386msgstr ""
8387
8388#. type: TP
8389#: dpkg-buildflags.man:1
8390#, no-wrap
8391msgid "B<--status>"
8392msgstr ""
8393
8394#. type: Plain text
8395#: dpkg-buildflags.man:1
8396msgid ""
8397"Display any information that can be useful to explain the behaviour of "
8398"B<dpkg-buildflags> (since dpkg 1.16.5): relevant environment variables, "
8399"current vendor, state of all feature flags. Also print the resulting "
8400"compiler flags with their origin."
8401msgstr ""
8402
8403#. type: Plain text
8404#: dpkg-buildflags.man:1
8405msgid ""
8406"This is intended to be run from B<debian/rules>, so that the build log keeps "
8407"a clear trace of the build flags used. This can be useful to diagnose "
8408"problems related to them."
8409msgstr ""
8410
8411#. type: TP
8412#: dpkg-buildflags.man:1
8413#, no-wrap
8414msgid "B<--export=>I<format>"
8415msgstr ""
8416
8417#. type: Plain text
8418#: dpkg-buildflags.man:1
8419msgid ""
8420"Print to standard output commands that can be used to export all the "
8421"compilation flags for some particular tool. If the I<format> value is not "
8422"given, B<sh> is assumed. Only compilation flags starting with an upper case "
8423"character are included, others are assumed to not be suitable for the "
8424"environment. Supported formats:"
8425msgstr ""
8426
8427#. type: TP
8428#: dpkg-buildflags.man:1
8429#, no-wrap
8430msgid "B<sh>"
8431msgstr ""
8432
8433#. type: Plain text
8434#: dpkg-buildflags.man:1
8435msgid ""
8436"Shell commands to set and export all the compilation flags in the "
8437"environment. The flag values are quoted so the output is ready for "
8438"evaluation by a shell."
8439msgstr ""
8440
8441#. type: TP
8442#: dpkg-buildflags.man:1
8443#, no-wrap
8444msgid "B<cmdline>"
8445msgstr ""
8446
8447#. type: Plain text
8448#: dpkg-buildflags.man:1
8449msgid ""
8450"Arguments to pass to a build program's command line to use all the "
8451"compilation flags (since dpkg 1.17.0). The flag values are quoted in shell "
8452"syntax."
8453msgstr ""
8454
8455#. type: TP
8456#: dpkg-buildflags.man:1
8457#, no-wrap
8458msgid "B<configure>"
8459msgstr ""
8460
8461#. type: Plain text
8462#: dpkg-buildflags.man:1
8463msgid "This is a legacy alias for B<cmdline>."
8464msgstr ""
8465
8466#. type: TP
8467#: dpkg-buildflags.man:1
8468#, no-wrap
8469msgid "B<make>"
8470msgstr ""
8471
8472#. type: Plain text
8473#: dpkg-buildflags.man:1
8474msgid ""
8475"Make directives to set and export all the compilation flags in the "
8476"environment. Output can be written to a makefile fragment and evaluated "
8477"using an B<include> directive."
8478msgstr ""
8479
8480#. type: TP
8481#: dpkg-buildflags.man:1
8482#, no-wrap
8483msgid "B<--get>I< flag>"
8484msgstr ""
8485
8486#. type: Plain text
8487#: dpkg-buildflags.man:1
8488msgid ""
8489"Print the value of the flag on standard output. Exits with 0 if the flag is "
8490"known otherwise exits with 1."
8491msgstr ""
8492
8493#. type: TP
8494#: dpkg-buildflags.man:1
8495#, no-wrap
8496msgid "B<--origin>I< flag>"
8497msgstr ""
8498
8499#. type: Plain text
8500#: dpkg-buildflags.man:1
8501msgid ""
8502"Print the origin of the value that is returned by B<--get>. Exits with 0 if "
8503"the flag is known otherwise exits with 1. The origin can be one of the "
8504"following values:"
8505msgstr ""
8506
8507#. type: TP
8508#: dpkg-buildflags.man:1
8509#, no-wrap
8510msgid "B<vendor>"
8511msgstr ""
8512
8513#. type: Plain text
8514#: dpkg-buildflags.man:1
8515msgid "the original flag set by the vendor is returned;"
8516msgstr ""
8517
8518#. type: TP
8519#: dpkg-buildflags.man:1
8520#, no-wrap
8521msgid "B<system>"
8522msgstr ""
8523
8524#. type: Plain text
8525#: dpkg-buildflags.man:1
8526msgid "the flag is set/modified by a system-wide configuration;"
8527msgstr ""
8528
8529#. type: TP
8530#: dpkg-buildflags.man:1
8531#, no-wrap
8532msgid "B<user>"
8533msgstr ""
8534
8535#. type: Plain text
8536#: dpkg-buildflags.man:1
8537msgid "the flag is set/modified by a user-specific configuration;"
8538msgstr ""
8539
8540#. type: TP
8541#: dpkg-buildflags.man:1
8542#, no-wrap
8543msgid "B<env>"
8544msgstr ""
8545
8546#. type: Plain text
8547#: dpkg-buildflags.man:1
8548msgid "the flag is set/modified by an environment-specific configuration."
8549msgstr ""
8550
8551#. type: TP
8552#: dpkg-buildflags.man:1
8553#, no-wrap
8554msgid "B<--query-features>I< area>"
8555msgstr ""
8556
8557#. type: Plain text
8558#: dpkg-buildflags.man:1
8559msgid ""
8560"Print the features enabled for a given area (since dpkg 1.16.2). The only "
8561"currently recognized areas on Debian and derivatives are B<qa>, "
8562"B<reproducible>, B<sanitize> and B<hardening>, see the B<FEATURE AREAS> "
8563"section for more details. Exits with 0 if the area is known otherwise exits "
8564"with 1."
8565msgstr ""
8566
8567#. type: Plain text
8568#: dpkg-buildflags.man:1
8569msgid "The output is in RFC822 format, with one section per feature. For example:"
8570msgstr ""
8571
8572#. type: Plain text
8573#: dpkg-buildflags.man:1
8574#, no-wrap
8575msgid ""
8576" Feature: pie\n"
8577" Enabled: yes\n"
8578msgstr ""
8579
8580#. type: Plain text
8581#: dpkg-buildflags.man:1
8582#, no-wrap
8583msgid ""
8584" Feature: stackprotector\n"
8585" Enabled: yes\n"
8586msgstr ""
8587
8588#. type: TP
8589#: dpkg-buildflags.man:1 dpkg-mergechangelogs.man:1 dpkg-scansources.man:1
8590#: dpkg-statoverride.man:1 dpkg-vendor.man:1 update-alternatives.man:1
8591#, no-wrap
8592msgid "B<--help>"
8593msgstr ""
8594
8595#. type: SH
8596#: dpkg-buildflags.man:1
8597#, no-wrap
8598msgid "SUPPORTED FLAGS"
8599msgstr ""
8600
8601#. type: TP
8602#: dpkg-buildflags.man:1
8603#, no-wrap
8604msgid "B<CFLAGS>"
8605msgstr ""
8606
8607#. type: Plain text
8608#: dpkg-buildflags.man:1
8609msgid ""
8610"Options for the C compiler. The default value set by the vendor includes "
8611"B<-g> and the default optimization level (B<-O2> usually, or B<-O0> if the "
8612"B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>)."
8613msgstr ""
8614
8615#. type: TP
8616#: dpkg-buildflags.man:1
8617#, no-wrap
8618msgid "B<CPPFLAGS>"
8619msgstr ""
8620
8621#. type: Plain text
8622#: dpkg-buildflags.man:1
8623msgid "Options for the C preprocessor. Default value: empty."
8624msgstr ""
8625
8626#. type: TP
8627#: dpkg-buildflags.man:1
8628#, no-wrap
8629msgid "B<CXXFLAGS>"
8630msgstr ""
8631
8632#. type: Plain text
8633#: dpkg-buildflags.man:1
8634msgid "Options for the C++ compiler. Same as B<CFLAGS>."
8635msgstr ""
8636
8637#. type: TP
8638#: dpkg-buildflags.man:1
8639#, no-wrap
8640msgid "B<OBJCFLAGS>"
8641msgstr ""
8642
8643#. type: Plain text
8644#: dpkg-buildflags.man:1
8645msgid "Options for the Objective C compiler. Same as B<CFLAGS>."
8646msgstr ""
8647
8648#. type: TP
8649#: dpkg-buildflags.man:1
8650#, no-wrap
8651msgid "B<OBJCXXFLAGS>"
8652msgstr ""
8653
8654#. type: Plain text
8655#: dpkg-buildflags.man:1
8656msgid "Options for the Objective C++ compiler. Same as B<CXXFLAGS>."
8657msgstr ""
8658
8659#. type: TP
8660#: dpkg-buildflags.man:1
8661#, no-wrap
8662msgid "B<GCJFLAGS>"
8663msgstr ""
8664
8665#. type: Plain text
8666#: dpkg-buildflags.man:1
8667msgid "Options for the GNU Java compiler (gcj). A subset of B<CFLAGS>."
8668msgstr ""
8669
8670#. type: TP
8671#: dpkg-buildflags.man:1
8672#, no-wrap
8673msgid "B<FFLAGS>"
8674msgstr ""
8675
8676#. type: Plain text
8677#: dpkg-buildflags.man:1
8678msgid "Options for the Fortran 77 compiler. A subset of B<CFLAGS>."
8679msgstr ""
8680
8681#. type: TP
8682#: dpkg-buildflags.man:1
8683#, no-wrap
8684msgid "B<FCFLAGS>"
8685msgstr ""
8686
8687#. type: Plain text
8688#: dpkg-buildflags.man:1
8689msgid "Options for the Fortran 9x compiler. Same as B<FFLAGS>."
8690msgstr ""
8691
8692#. type: TP
8693#: dpkg-buildflags.man:1
8694#, no-wrap
8695msgid "B<LDFLAGS>"
8696msgstr ""
8697
8698#. type: Plain text
8699#: dpkg-buildflags.man:1
8700msgid ""
8701"Options passed to the compiler when linking executables or shared objects "
8702"(if the linker is called directly, then B<-Wl> and B<,> have to be stripped "
8703"from these options). Default value: empty."
8704msgstr ""
8705
8706#. type: Plain text
8707#: dpkg-buildflags.man:1
8708msgid ""
8709"New flags might be added in the future if the need arises (for example to "
8710"support other languages)."
8711msgstr ""
8712
8713#. type: SH
8714#: dpkg-buildflags.man:1
8715#, no-wrap
8716msgid "FEATURE AREAS"
8717msgstr ""
8718
8719#. type: Plain text
8720#: dpkg-buildflags.man:1
8721msgid ""
8722"Each area feature can be enabled and disabled in the B<DEB_BUILD_OPTIONS> "
8723"and B<DEB_BUILD_MAINT_OPTIONS> environment variable's area value with the "
8724"‘B<+>’ and ‘B<->’ modifier. For example, to enable the B<hardening> “pie” "
8725"feature and disable the “fortify” feature you can do this in "
8726"B<debian/rules>:"
8727msgstr ""
8728
8729#. type: Plain text
8730#: dpkg-buildflags.man:1
8731#, no-wrap
8732msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify\n"
8733msgstr ""
8734
8735#. type: Plain text
8736#: dpkg-buildflags.man:1
8737msgid ""
8738"The special feature B<all> (valid in any area) can be used to enable or "
8739"disable all area features at the same time. Thus disabling everything in "
8740"the B<hardening> area and enabling only “format” and “fortify” can be "
8741"achieved with:"
8742msgstr ""
8743
8744#. type: Plain text
8745#: dpkg-buildflags.man:1
8746#, no-wrap
8747msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify\n"
8748msgstr ""
8749
8750#. type: SS
8751#: dpkg-buildflags.man:1
8752#, no-wrap
8753msgid "qa"
8754msgstr ""
8755
8756#. type: Plain text
8757#: dpkg-buildflags.man:1
8758msgid ""
8759"Several compile-time options (detailed below) can be used to help detect "
8760"problems in the source code or build system."
8761msgstr ""
8762
8763#. type: TP
8764#: dpkg-buildflags.man:1
8765#, no-wrap
8766msgid "B<bug>"
8767msgstr ""
8768
8769#. type: Plain text
8770#: dpkg-buildflags.man:1
8771msgid ""
8772"This setting (disabled by default) adds any warning option that reliably "
8773"detects problematic source code. The warnings are fatal. The only currently "
8774"supported flags are B<CFLAGS> and B<CXXFLAGS> with flags set to "
8775"B<-Werror=array-bounds>, B<-Werror=clobbered>, "
8776"B<-Werror=implicit-function-declaration> and "
8777"B<-Werror=volatile-register-var>."
8778msgstr ""
8779
8780#. type: TP
8781#: dpkg-buildflags.man:1
8782#, no-wrap
8783msgid "B<canary>"
8784msgstr ""
8785
8786#. type: Plain text
8787#: dpkg-buildflags.man:1
8788msgid ""
8789"This setting (disabled by default) adds dummy canary options to the build "
8790"flags, so that the build logs can be checked for how the build flags "
8791"propagate and to allow finding any omission of normal build flag settings. "
8792"The only currently supported flags are B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, "
8793"B<CXXFLAGS> and B<OBJCXXFLAGS> with flags set to "
8794"B<-D__DEB_CANARY_>I<flag>_I<random-id>B<__>, and B<LDFLAGS> set to "
8795"B<-Wl,-z,deb-canary->I<random-id>."
8796msgstr ""
8797
8798#. type: SS
8799#: dpkg-buildflags.man:1
8800#, no-wrap
8801msgid "sanitize"
8802msgstr ""
8803
8804#. type: Plain text
8805#: dpkg-buildflags.man:1
8806msgid ""
8807"Several compile-time options (detailed below) can be used to help sanitize a "
8808"resulting binary against memory corruptions, memory leaks, use after free, "
8809"threading data races and undefined behavior bugs."
8810msgstr ""
8811
8812#. type: TP
8813#: dpkg-buildflags.man:1
8814#, no-wrap
8815msgid "B<address>"
8816msgstr ""
8817
8818#. type: Plain text
8819#: dpkg-buildflags.man:1
8820msgid ""
8821"This setting (disabled by default) adds B<-fsanitize=address> to B<LDFLAGS> "
8822"and B<-fsanitize=address -fno-omit-frame-pointer> to B<CFLAGS> and "
8823"B<CXXFLAGS>."
8824msgstr ""
8825
8826#. type: TP
8827#: dpkg-buildflags.man:1
8828#, no-wrap
8829msgid "B<thread>"
8830msgstr ""
8831
8832#. type: Plain text
8833#: dpkg-buildflags.man:1
8834msgid ""
8835"This setting (disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, "
8836"B<CXXFLAGS> and B<LDFLAGS>."
8837msgstr ""
8838
8839#. type: TP
8840#: dpkg-buildflags.man:1
8841#, no-wrap
8842msgid "B<leak>"
8843msgstr ""
8844
8845#. type: Plain text
8846#: dpkg-buildflags.man:1
8847msgid ""
8848"This setting (disabled by default) adds B<-fsanitize=leak> to B<LDFLAGS>. It "
8849"gets automatically disabled if either the B<address> or the B<thread> "
8850"features are enabled, as they imply it."
8851msgstr ""
8852
8853#. type: TP
8854#: dpkg-buildflags.man:1
8855#, no-wrap
8856msgid "B<undefined>"
8857msgstr ""
8858
8859#. type: Plain text
8860#: dpkg-buildflags.man:1
8861msgid ""
8862"This setting (disabled by default) adds B<-fsanitize=undefined> to "
8863"B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>."
8864msgstr ""
8865
8866#. type: SS
8867#: dpkg-buildflags.man:1
8868#, no-wrap
8869msgid "hardening"
8870msgstr ""
8871
8872#. type: Plain text
8873#: dpkg-buildflags.man:1
8874msgid ""
8875"Several compile-time options (detailed below) can be used to help harden a "
8876"resulting binary against memory corruption attacks, or provide additional "
8877"warning messages during compilation. Except as noted below, these are "
8878"enabled by default for architectures that support them."
8879msgstr ""
8880
8881#. type: TP
8882#: dpkg-buildflags.man:1
8883#, no-wrap
8884msgid "B<format>"
8885msgstr ""
8886
8887#. type: Plain text
8888#: dpkg-buildflags.man:1
8889msgid ""
8890"This setting (enabled by default) adds B<-Wformat -Werror=format-security> "
8891"to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> and B<OBJCXXFLAGS>. This will warn "
8892"about improper format string uses, and will fail when format functions are "
8893"used in a way that represent possible security problems. At present, this "
8894"warns about calls to B<printf> and B<scanf> functions where the format "
8895"string is not a string literal and there are no format arguments, as in "
8896"B<printf(foo);> instead of B<printf(\"%s\", foo);> This may be a security "
8897"hole if the format string came from untrusted input and contains ‘%n’."
8898msgstr ""
8899
8900#. type: TP
8901#: dpkg-buildflags.man:1
8902#, no-wrap
8903msgid "B<fortify>"
8904msgstr ""
8905
8906#. type: Plain text
8907#: dpkg-buildflags.man:1
8908msgid ""
8909"This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to "
8910"B<CPPFLAGS>. During code generation the compiler knows a great deal of "
8911"information about buffer sizes (where possible), and attempts to replace "
8912"insecure unlimited length buffer function calls with length-limited "
8913"ones. This is especially useful for old, crufty code. Additionally, format "
8914"strings in writable memory that contain ‘%n’ are blocked. If an application "
8915"depends on such a format string, it will need to be worked around."
8916msgstr ""
8917
8918#. type: Plain text
8919#: dpkg-buildflags.man:1
8920msgid ""
8921"Note that for this option to have any effect, the source must also be "
8922"compiled with B<-O1> or higher. If the environment variable "
8923"B<DEB_BUILD_OPTIONS> contains I<noopt>, then B<fortify> support will be "
8924"disabled, due to new warnings being issued by glibc 2.16 and later."
8925msgstr ""
8926
8927#. type: TP
8928#: dpkg-buildflags.man:1
8929#, no-wrap
8930msgid "B<stackprotector>"
8931msgstr ""
8932
8933#. type: Plain text
8934#: dpkg-buildflags.man:1
8935msgid ""
8936"This setting (enabled by default if stackprotectorstrong is not in use) adds "
8937"B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS>, B<CXXFLAGS>, "
8938"B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>. This "
8939"adds safety checks against stack overwrites. This renders many potential "
8940"code injection attacks into aborting situations. In the best case this turns "
8941"code injection vulnerabilities into denial of service or into non-issues "
8942"(depending on the application)."
8943msgstr ""
8944
8945#. type: Plain text
8946#: dpkg-buildflags.man:1
8947msgid ""
8948"This feature requires linking against glibc (or another provider of "
8949"B<__stack_chk_fail>), so needs to be disabled when building with "
8950"B<-nostdlib> or B<-ffreestanding> or similar."
8951msgstr ""
8952
8953#. type: TP
8954#: dpkg-buildflags.man:1
8955#, no-wrap
8956msgid "B<stackprotectorstrong>"
8957msgstr ""
8958
8959#. type: Plain text
8960#: dpkg-buildflags.man:1
8961msgid ""
8962"This setting (enabled by default) adds B<-fstack-protector-strong> to "
8963"B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> "
8964"and B<FCFLAGS>. This is a stronger variant of B<stackprotector>, but "
8965"without significant performance penalties."
8966msgstr ""
8967
8968#. type: Plain text
8969#: dpkg-buildflags.man:1
8970msgid "Disabling B<stackprotector> will also disable this setting."
8971msgstr ""
8972
8973#. type: Plain text
8974#: dpkg-buildflags.man:1
8975msgid ""
8976"This feature has the same requirements as B<stackprotector>, and in addition "
8977"also requires gcc 4.9 and later."
8978msgstr ""
8979
8980#. type: TP
8981#: dpkg-buildflags.man:1
8982#, no-wrap
8983msgid "B<relro>"
8984msgstr ""
8985
8986#. type: Plain text
8987#: dpkg-buildflags.man:1
8988msgid ""
8989"This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>. "
8990"During program load, several ELF memory sections need to be written to by "
8991"the linker. This flags the loader to turn these sections read-only before "
8992"turning over control to the program. Most notably this prevents GOT "
8993"overwrite attacks. If this option is disabled, B<bindnow> will become "
8994"disabled as well."
8995msgstr ""
8996
8997#. type: TP
8998#: dpkg-buildflags.man:1
8999#, no-wrap
9000msgid "B<bindnow>"
9001msgstr ""
9002
9003#. type: Plain text
9004#: dpkg-buildflags.man:1
9005msgid ""
9006"This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During "
9007"program load, all dynamic symbols are resolved, allowing for the entire PLT "
9008"to be marked read-only (due to B<relro> above). The option cannot become "
9009"enabled if B<relro> is not enabled."
9010msgstr ""
9011
9012#. type: TP
9013#: dpkg-buildflags.man:1
9014#, no-wrap
9015msgid "B<pie>"
9016msgstr ""
9017
9018#. type: Plain text
9019#: dpkg-buildflags.man:1
9020msgid ""
9021"This setting (with no default since dpkg 1.18.23, and injected by default by "
9022"gcc on the amd64, arm64, armel, armhf, i386, kfreebsd-amd64, kfreebsd-i386, "
9023"mips, mipsel, mips64el, ppc64el, s390x, sparc and sparc64 Debian "
9024"architectures) adds the required options via gcc specs files if needed to "
9025"enable or disable PIE. When enabled and injected by gcc, adds nothing. When "
9026"enabled and not injected by gcc, adds B<-fPIE> to B<CFLAGS>, B<CXXFLAGS>, "
9027"B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>, and "
9028"B<-fPIE -pie> to B<LDFLAGS>. When disabled and injected by gcc, adds "
9029"B<-fno-PIE> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, "
9030"B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>, and B<-fno-PIE -no-pie> to "
9031"B<LDFLAGS>."
9032msgstr ""
9033
9034#. type: Plain text
9035#: dpkg-buildflags.man:1
9036msgid ""
9037"Position Independent Executable are needed to take advantage of Address "
9038"Space Layout Randomization, supported by some kernel versions. While ASLR "
9039"can already be enforced for data areas in the stack and heap (brk and mmap), "
9040"the code areas must be compiled as position-independent. Shared libraries "
9041"already do this (B<-fPIC>), so they gain ASLR automatically, but binary "
9042".text regions need to be build PIE to gain ASLR. When this happens, ROP "
9043"(Return Oriented Programming) attacks are much harder since there are no "
9044"static locations to bounce off of during a memory corruption attack."
9045msgstr ""
9046
9047#. type: Plain text
9048#: dpkg-buildflags.man:1
9049msgid ""
9050"PIE is not compatible with B<-fPIC>, so in general care must be taken when "
9051"building shared objects. But because the PIE flags emitted get injected via "
9052"gcc specs files, it should always be safe to unconditionally set them "
9053"regardless of the object type being compiled or linked."
9054msgstr ""
9055
9056#. type: Plain text
9057#: dpkg-buildflags.man:1
9058msgid ""
9059"Static libraries can be used by programs or other shared libraries. "
9060"Depending on the flags used to compile all the objects within a static "
9061"library, these libraries will be usable by different sets of objects:"
9062msgstr ""
9063
9064#. type: TP
9065#: dpkg-buildflags.man:1
9066#, no-wrap
9067msgid "none"
9068msgstr ""
9069
9070#. type: Plain text
9071#: dpkg-buildflags.man:1
9072msgid "Cannot be linked into a PIE program, nor a shared library."
9073msgstr ""
9074
9075#. type: TP
9076#: dpkg-buildflags.man:1
9077#, no-wrap
9078msgid "B<-fPIE>"
9079msgstr ""
9080
9081#. type: Plain text
9082#: dpkg-buildflags.man:1
9083msgid "Can be linked into any program, but not a shared library (recommended)."
9084msgstr ""
9085
9086#. type: TP
9087#: dpkg-buildflags.man:1
9088#, no-wrap
9089msgid "B<-fPIC>"
9090msgstr ""
9091
9092#. type: Plain text
9093#: dpkg-buildflags.man:1
9094msgid "Can be linked into any program and shared library."
9095msgstr ""
9096
9097#. type: Plain text
9098#: dpkg-buildflags.man:1
9099msgid ""
9100"If there is a need to set these flags manually, bypassing the gcc specs "
9101"injection, there are several things to take into account. Unconditionally "
9102"and explicitly passing B<-fPIE>, B<-fpie> or B<-pie> to a build-system using "
9103"libtool is safe as these flags will get stripped when building shared "
9104"libraries. Otherwise on projects that build both programs and shared "
9105"libraries you might need to make sure that when building the shared "
9106"libraries B<-fPIC> is always passed last (so that it overrides any previous "
9107"B<-PIE>) to compilation flags such as B<CFLAGS>, and B<-shared> is passed "
9108"last (so that it overrides any previous B<-pie>) to linking flags such as "
9109"B<LDFLAGS>. B<Note:> This should not be needed with the default gcc specs "
9110"machinery."
9111msgstr ""
9112
9113#. type: Plain text
9114#: dpkg-buildflags.man:1
9115msgid ""
9116"Additionally, since PIE is implemented via a general register, some register "
9117"starved architectures (but not including i386 anymore since optimizations "
9118"implemented in gcc E<gt>= 5) can see performance losses of up to 15% in very "
9119"text-segment-heavy application workloads; most workloads see less than "
9120"1%. Architectures with more general registers (e.g. amd64) do not see as "
9121"high a worst-case penalty."
9122msgstr ""
9123
9124#. type: SS
9125#: dpkg-buildflags.man:1
9126#, no-wrap
9127msgid "reproducible"
9128msgstr ""
9129
9130#. type: Plain text
9131#: dpkg-buildflags.man:1
9132msgid ""
9133"The compile-time options detailed below can be used to help improve build "
9134"reproducibility or provide additional warning messages during "
9135"compilation. Except as noted below, these are enabled by default for "
9136"architectures that support them."
9137msgstr ""
9138
9139#. type: TP
9140#: dpkg-buildflags.man:1
9141#, no-wrap
9142msgid "B<timeless>"
9143msgstr ""
9144
9145#. type: Plain text
9146#: dpkg-buildflags.man:1
9147msgid ""
9148"This setting (enabled by default) adds B<-Wdate-time> to B<CPPFLAGS>. This "
9149"will cause warnings when the B<__TIME__>, B<__DATE__> and B<__TIMESTAMP__> "
9150"macros are used."
9151msgstr ""
9152
9153#. type: TP
9154#: dpkg-buildflags.man:1
9155#, no-wrap
9156msgid "B<fixdebugpath>"
9157msgstr ""
9158
9159#. type: Plain text
9160#: dpkg-buildflags.man:1
9161msgid ""
9162"This setting (enabled by default) adds "
9163"B<-fdebug-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, "
9164"B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS> where "
9165"B<BUILDPATH> is set to the top-level directory of the package being built. "
9166"This has the effect of removing the build path from any generated debug "
9167"symbols."
9168msgstr ""
9169
9170#. type: Plain text
9171#: dpkg-buildflags.man:1
9172msgid ""
9173"There are 2 sets of environment variables doing the same operations, the "
9174"first one (DEB_I<flag>_I<op>) should never be used within "
9175"B<debian/rules>. It's meant for any user that wants to rebuild the source "
9176"package with different build flags. The second set (DEB_I<flag>_MAINT_I<op>) "
9177"should only be used in B<debian/rules> by package maintainers to change the "
9178"resulting build flags."
9179msgstr ""
9180
9181#. type: TP
9182#: dpkg-buildflags.man:1
9183#, no-wrap
9184msgid "B<DEB_>I<flag>B<_SET>"
9185msgstr ""
9186
9187#. type: TQ
9188#: dpkg-buildflags.man:1
9189#, no-wrap
9190msgid "B<DEB_>I<flag>B<_MAINT_SET>"
9191msgstr ""
9192
9193#. type: Plain text
9194#: dpkg-buildflags.man:1
9195msgid "This variable can be used to force the value returned for the given I<flag>."
9196msgstr ""
9197
9198#. type: TP
9199#: dpkg-buildflags.man:1
9200#, no-wrap
9201msgid "B<DEB_>I<flag>B<_STRIP>"
9202msgstr ""
9203
9204#. type: TQ
9205#: dpkg-buildflags.man:1
9206#, no-wrap
9207msgid "B<DEB_>I<flag>B<_MAINT_STRIP>"
9208msgstr ""
9209
9210#. type: Plain text
9211#: dpkg-buildflags.man:1
9212msgid ""
9213"This variable can be used to provide a space separated list of options that "
9214"will be stripped from the set of flags returned for the given I<flag>."
9215msgstr ""
9216
9217#. type: TP
9218#: dpkg-buildflags.man:1
9219#, no-wrap
9220msgid "B<DEB_>I<flag>B<_APPEND>"
9221msgstr ""
9222
9223#. type: TQ
9224#: dpkg-buildflags.man:1
9225#, no-wrap
9226msgid "B<DEB_>I<flag>B<_MAINT_APPEND>"
9227msgstr ""
9228
9229#. type: Plain text
9230#: dpkg-buildflags.man:1
9231msgid ""
9232"This variable can be used to append supplementary options to the value "
9233"returned for the given I<flag>."
9234msgstr ""
9235
9236#. type: TP
9237#: dpkg-buildflags.man:1
9238#, no-wrap
9239msgid "B<DEB_>I<flag>B<_PREPEND>"
9240msgstr ""
9241
9242#. type: TQ
9243#: dpkg-buildflags.man:1
9244#, no-wrap
9245msgid "B<DEB_>I<flag>B<_MAINT_PREPEND>"
9246msgstr ""
9247
9248#. type: Plain text
9249#: dpkg-buildflags.man:1
9250msgid ""
9251"This variable can be used to prepend supplementary options to the value "
9252"returned for the given I<flag>."
9253msgstr ""
9254
9255#. type: TP
9256#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1
9257#, no-wrap
9258msgid "B<DEB_BUILD_OPTIONS>"
9259msgstr ""
9260
9261#. type: TQ
9262#: dpkg-buildflags.man:1
9263#, no-wrap
9264msgid "B<DEB_BUILD_MAINT_OPTIONS>"
9265msgstr ""
9266
9267#. type: Plain text
9268#: dpkg-buildflags.man:1
9269msgid ""
9270"These variables can be used by a user or maintainer to disable/enable "
9271"various area features that affect build flags. The "
9272"B<DEB_BUILD_MAINT_OPTIONS> variable overrides any setting in the "
9273"B<DEB_BUILD_OPTIONS> feature areas. See the B<FEATURE AREAS> section for "
9274"details."
9275msgstr ""
9276
9277#. type: TP
9278#: dpkg-buildflags.man:1 dpkg-vendor.man:1
9279#, no-wrap
9280msgid "B<DEB_VENDOR>"
9281msgstr ""
9282
9283#. type: Plain text
9284#: dpkg-buildflags.man:1
9285msgid ""
9286"This setting defines the current vendor. If not set, it will discover the "
9287"current vendor by reading B<%PKGCONFDIR%/origins/default>."
9288msgstr ""
9289
9290#. type: TP
9291#: dpkg-buildflags.man:1
9292#, no-wrap
9293msgid "B<DEB_BUILD_PATH>"
9294msgstr ""
9295
9296#. type: Plain text
9297#: dpkg-buildflags.man:1
9298msgid ""
9299"This variable sets the build path (since dpkg 1.18.8) to use in features "
9300"such as B<fixdebugpath> so that they can be controlled by the caller. This "
9301"variable is currently Debian and derivatives-specific."
9302msgstr ""
9303
9304#. type: SS
9305#: dpkg-buildflags.man:1
9306#, no-wrap
9307msgid "Configuration files"
9308msgstr ""
9309
9310#. type: TP
9311#: dpkg-buildflags.man:1
9312#, no-wrap
9313msgid "B<%PKGCONFDIR%/buildflags.conf>"
9314msgstr ""
9315
9316#. type: Plain text
9317#: dpkg-buildflags.man:1
9318msgid "System wide configuration file."
9319msgstr ""
9320
9321#. type: TP
9322#: dpkg-buildflags.man:1
9323#, no-wrap
9324msgid "B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or "
9325msgstr ""
9326
9327#. type: TQ
9328#: dpkg-buildflags.man:1
9329#, no-wrap
9330msgid "B<$HOME/.config/dpkg/buildflags.conf>"
9331msgstr ""
9332
9333#. type: Plain text
9334#: dpkg-buildflags.man:1 dpkg-buildpackage.man:1
9335msgid "User configuration file."
9336msgstr ""
9337
9338#. type: TP
9339#: dpkg-buildflags.man:1
9340#, no-wrap
9341msgid "B<%PKGDATADIR%/buildflags.mk>"
9342msgstr ""
9343
9344#. type: Plain text
9345#: dpkg-buildflags.man:1
9346msgid ""
9347"Makefile snippet that will load (and optionally export) all flags supported "
9348"by B<dpkg-buildflags> into variables (since dpkg 1.16.1)."
9349msgstr ""
9350
9351#. type: Plain text
9352#: dpkg-buildflags.man:1
9353msgid "To pass build flags to a build command in a makefile:"
9354msgstr ""
9355
9356#. type: Plain text
9357#: dpkg-buildflags.man:1
9358#, no-wrap
9359msgid "$(MAKE) $(shell dpkg-buildflags --export=cmdline)\n"
9360msgstr ""
9361
9362#. type: Plain text
9363#: dpkg-buildflags.man:1
9364#, no-wrap
9365msgid "\\&./configure $(shell dpkg-buildflags --export=cmdline)\n"
9366msgstr ""
9367
9368#. type: Plain text
9369#: dpkg-buildflags.man:1
9370msgid ""
9371"To set build flags in a shell script or shell fragment, B<eval> can be used "
9372"to interpret the output and to export the flags in the environment:"
9373msgstr ""
9374
9375#. type: Plain text
9376#: dpkg-buildflags.man:1
9377#, no-wrap
9378msgid "eval \"$(dpkg-buildflags --export=sh)\" && make\n"
9379msgstr ""
9380
9381#. type: Plain text
9382#: dpkg-buildflags.man:1
9383msgid "or to set the positional parameters to pass to a command:"
9384msgstr ""
9385
9386#. type: Plain text
9387#: dpkg-buildflags.man:1
9388#, no-wrap
9389msgid ""
9390"eval \"set -- $(dpkg-buildflags --export=cmdline)\"\n"
9391"for dir in a b c; do (cd $dir && ./configure \"$@\" && make); done\n"
9392msgstr ""
9393
9394#. type: Plain text
9395#: dpkg-buildflags.man:1
9396msgid ""
9397"You should call B<dpkg-buildflags> or include B<buildflags.mk> from the "
9398"B<debian/rules> file to obtain the needed build flags to pass to the build "
9399"system. Note that older versions of B<dpkg-buildpackage> (before dpkg "
9400"1.16.1) exported these flags automatically. However, you should not rely on "
9401"this, since this breaks manual invocation of B<debian/rules>."
9402msgstr ""
9403
9404#. type: Plain text
9405#: dpkg-buildflags.man:1
9406msgid ""
9407"For packages with autoconf-like build systems, you can pass the relevant "
9408"options to configure or B<make>(1) directly, as shown above."
9409msgstr ""
9410
9411#. type: Plain text
9412#: dpkg-buildflags.man:1
9413msgid ""
9414"For other build systems, or when you need more fine-grained control about "
9415"which flags are passed where, you can use B<--get>. Or you can include "
9416"B<buildflags.mk> instead, which takes care of calling B<dpkg-buildflags> and "
9417"storing the build flags in make variables."
9418msgstr ""
9419
9420#. type: Plain text
9421#: dpkg-buildflags.man:1
9422msgid ""
9423"If you want to export all buildflags into the environment (where they can be "
9424"picked up by your build system):"
9425msgstr ""
9426
9427#. type: Plain text
9428#: dpkg-buildflags.man:1
9429#, no-wrap
9430msgid ""
9431"DPKG_EXPORT_BUILDFLAGS = 1\n"
9432"include %PKGDATADIR%/buildflags.mk\n"
9433msgstr ""
9434
9435#. type: Plain text
9436#: dpkg-buildflags.man:1
9437msgid ""
9438"For some extra control over what is exported, you can manually export the "
9439"variables (as none are exported by default):"
9440msgstr ""
9441
9442#. type: Plain text
9443#: dpkg-buildflags.man:1
9444#, no-wrap
9445msgid ""
9446"include %PKGDATADIR%/buildflags.mk\n"
9447"export CPPFLAGS CFLAGS LDFLAGS\n"
9448msgstr ""
9449
9450#. type: Plain text
9451#: dpkg-buildflags.man:1
9452msgid "And you can of course pass the flags to commands manually:"
9453msgstr ""
9454
9455#. type: Plain text
9456#: dpkg-buildflags.man:1
9457#, no-wrap
9458msgid ""
9459"include %PKGDATADIR%/buildflags.mk\n"
9460"build-arch:\n"
9461"\\&\t$(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)\n"
9462msgstr ""
9463
9464#. type: TH
9465#: dpkg-buildpackage.man:1
9466#, no-wrap
9467msgid "dpkg-buildpackage"
9468msgstr ""
9469
9470#. type: Plain text
9471#: dpkg-buildpackage.man:1
9472msgid "dpkg-buildpackage - build binary or source packages from sources"
9473msgstr ""
9474
9475#. type: Plain text
9476#: dpkg-buildpackage.man:1
9477msgid "B<dpkg-buildpackage> [I<option>...]"
9478msgstr ""
9479
9480#. type: Plain text
9481#: dpkg-buildpackage.man:1
9482msgid ""
9483"B<dpkg-buildpackage> is a program that automates the process of building a "
9484"Debian package. It consists of the following steps:"
9485msgstr ""
9486
9487#. type: IP
9488#: dpkg-buildpackage.man:1
9489#, no-wrap
9490msgid "B<1.>"
9491msgstr ""
9492
9493#. type: Plain text
9494#: dpkg-buildpackage.man:1
9495msgid ""
9496"It prepares the build environment by setting various environment variables "
9497"(see B<ENVIRONMENT>), runs the B<init> hook, and calls B<dpkg-source "
9498"--before-build> (unless B<-T> or B<--target> has been used)."
9499msgstr ""
9500
9501#. type: IP
9502#: dpkg-buildpackage.man:1
9503#, no-wrap
9504msgid "B<2.>"
9505msgstr ""
9506
9507#. type: Plain text
9508#: dpkg-buildpackage.man:1
9509msgid ""
9510"It checks that the build-dependencies and build-conflicts are satisfied "
9511"(unless B<-d> or B<--no-check-builddeps> is specified)."
9512msgstr ""
9513
9514#. type: IP
9515#: dpkg-buildpackage.man:1
9516#, no-wrap
9517msgid "B<3.>"
9518msgstr ""
9519
9520#. type: Plain text
9521#: dpkg-buildpackage.man:1
9522msgid ""
9523"If one or more specific targets have been selected with the B<-T> or "
9524"B<--target> option, it calls those targets and stops here. Otherwise it runs "
9525"the B<preclean> hook and calls B<fakeroot debian/rules clean> to clean the "
9526"build-tree (unless B<-nc> or B<--no-pre-clean> is specified)."
9527msgstr ""
9528
9529#. type: IP
9530#: dpkg-buildpackage.man:1
9531#, no-wrap
9532msgid "B<4.>"
9533msgstr ""
9534
9535#. type: Plain text
9536#: dpkg-buildpackage.man:1
9537msgid ""
9538"It runs the B<source> hook and calls B<dpkg-source -b> to generate the "
9539"source package (if a B<source> build has been requested with B<--build> or "
9540"equivalent options)."
9541msgstr ""
9542
9543#. type: IP
9544#: dpkg-buildpackage.man:1
9545#, no-wrap
9546msgid "B<5.>"
9547msgstr ""
9548
9549#. type: Plain text
9550#: dpkg-buildpackage.man:1
9551msgid ""
9552"It runs the B<build> hook and calls B<debian/rules> I<build-target>, then "
9553"runs the B<binary> hook followed by B<fakeroot debian/rules> "
9554"I<binary-target> (unless a source-only build has been requested with "
9555"B<--build=source> or equivalent options). Note that I<build-target> and "
9556"I<binary-target> are either B<build> and B<binary> (default case, or if an "
9557"B<any> and B<all> build has been requested with B<--build> or equivalent "
9558"options), or B<build-arch> and B<binary-arch> (if an B<any> and not B<all> "
9559"build has been requested with B<--build> or equivalent options), or "
9560"B<build-indep> and B<binary-indep> (if an B<all> and not B<any> build has "
9561"been requested with B<--build> or equivalent options)."
9562msgstr ""
9563
9564#. type: IP
9565#: dpkg-buildpackage.man:1
9566#, no-wrap
9567msgid "B<6.>"
9568msgstr ""
9569
9570#. type: Plain text
9571#: dpkg-buildpackage.man:1
9572msgid ""
9573"It runs the B<buildinfo> hook and calls B<dpkg-genbuildinfo> to generate a "
9574"B<.buildinfo> file. Several B<dpkg-buildpackage> options are forwarded to "
9575"B<dpkg-genbuildinfo>."
9576msgstr ""
9577
9578#. type: IP
9579#: dpkg-buildpackage.man:1
9580#, no-wrap
9581msgid "B<7.>"
9582msgstr ""
9583
9584#. type: Plain text
9585#: dpkg-buildpackage.man:1
9586msgid ""
9587"It runs the B<changes> hook and calls B<dpkg-genchanges> to generate a "
9588"B<.changes> file. The name of the B<.changes> file will depend on the type "
9589"of build and will be as specific as necessary but not more; for a build that "
9590"includes B<any> the name will be "
9591"I<source-name>B<_>I<binary-version>B<_>I<arch>B<.changes>, or otherwise for "
9592"a build that includes B<all> the name will be "
9593"I<source-name>B<_>I<binary-version>B<_>B<all.changes>, or otherwise for a "
9594"build that includes B<source> the name will be "
9595"I<source-name>B<_>I<source-version>B<_>B<source.changes>. Many "
9596"B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>."
9597msgstr ""
9598
9599#. type: IP
9600#: dpkg-buildpackage.man:1
9601#, no-wrap
9602msgid "B<8.>"
9603msgstr ""
9604
9605#. type: Plain text
9606#: dpkg-buildpackage.man:1
9607msgid ""
9608"It runs the B<postclean> hook and if B<-tc> or B<--post-clean> is specified, "
9609"it will call B<fakeroot debian/rules clean> again."
9610msgstr ""
9611
9612#. type: IP
9613#: dpkg-buildpackage.man:1
9614#, no-wrap
9615msgid "B<9.>"
9616msgstr ""
9617
9618#. type: Plain text
9619#: dpkg-buildpackage.man:1
9620msgid "It calls B<dpkg-source --after-build>."
9621msgstr ""
9622
9623#. type: IP
9624#: dpkg-buildpackage.man:1
9625#, no-wrap
9626msgid "B<10.>"
9627msgstr ""
9628
9629#. type: Plain text
9630#: dpkg-buildpackage.man:1
9631msgid ""
9632"It runs the B<check> hook and calls a package checker for the B<.changes> "
9633"file (if a command is specified in B<DEB_CHECK_COMMAND> or with "
9634"B<--check-command>)."
9635msgstr ""
9636
9637#. type: IP
9638#: dpkg-buildpackage.man:1
9639#, no-wrap
9640msgid "B<11.>"
9641msgstr ""
9642
9643#. type: Plain text
9644#: dpkg-buildpackage.man:1
9645msgid ""
9646"It runs the B<sign> hook and calls B<gpg2> or B<gpg> (as long as it is not "
9647"an UNRELEASED build, or B<--no-sign> is specified) to sign the B<.dsc> file "
9648"(if any, unless B<-us> or B<--unsigned-source> is specified), the "
9649"B<.buildinfo> file (unless B<-ui>, B<--unsigned-buildinfo>, B<-uc> or "
9650"B<--unsigned-changes> is specified) and the B<.changes> file (unless B<-uc> "
9651"or B<--unsigned-changes> is specified)."
9652msgstr ""
9653
9654#. type: IP
9655#: dpkg-buildpackage.man:1
9656#, no-wrap
9657msgid "B<12.>"
9658msgstr ""
9659
9660#. type: Plain text
9661#: dpkg-buildpackage.man:1
9662msgid "It runs the B<done> hook."
9663msgstr ""
9664
9665#. type: Plain text
9666#: dpkg-buildpackage.man:1
9667msgid ""
9668"All long options can be specified both on the command line and in the "
9669"B<dpkg-buildpackage> system and user configuration files. Each line in the "
9670"configuration file is either an option (exactly the same as the command line "
9671"option but without leading hyphens) or a comment (if it starts with a "
9672"‘B<#>’)."
9673msgstr ""
9674
9675#. type: TP
9676#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9677#, no-wrap
9678msgid "B<--build=>I<type>"
9679msgstr ""
9680
9681#. type: Plain text
9682#: dpkg-buildpackage.man:1
9683msgid ""
9684"Specifies the build I<type> from a comma-separated list of components (since "
9685"dpkg 1.18.5). Passed to B<dpkg-genchanges>."
9686msgstr ""
9687
9688#. type: Plain text
9689#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9690msgid "The allowed values are:"
9691msgstr ""
9692
9693#. type: TP
9694#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9695#, no-wrap
9696msgid "B<source>"
9697msgstr ""
9698
9699#. type: Plain text
9700#: dpkg-buildpackage.man:1
9701msgid ""
9702"Builds the source package. Note: when using this value standalone and if "
9703"what you want is simply to (re-)build the source package, using "
9704"B<dpkg-source> is always better as it does not require any build "
9705"dependencies to be installed to be able to call the B<clean> target."
9706msgstr ""
9707
9708#. type: TP
9709#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9710#, no-wrap
9711msgid "B<any>"
9712msgstr ""
9713
9714#. type: Plain text
9715#: dpkg-buildpackage.man:1
9716msgid "Builds the architecture specific binary packages."
9717msgstr ""
9718
9719#. type: TP
9720#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9721#, no-wrap
9722msgid "B<all>"
9723msgstr ""
9724
9725#. type: Plain text
9726#: dpkg-buildpackage.man:1
9727msgid "Builds the architecture independent binary packages."
9728msgstr ""
9729
9730#. type: TP
9731#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9732#, no-wrap
9733msgid "B<binary>"
9734msgstr ""
9735
9736#. type: Plain text
9737#: dpkg-buildpackage.man:1
9738msgid ""
9739"Builds the architecture specific and independent binary packages. This is "
9740"an alias for B<any,all>."
9741msgstr ""
9742
9743#. type: TP
9744#: dpkg-buildpackage.man:1 dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
9745#, no-wrap
9746msgid "B<full>"
9747msgstr ""
9748
9749#. type: Plain text
9750#: dpkg-buildpackage.man:1
9751msgid ""
9752"Builds everything. This is an alias for B<source,any,all>, and the same as "
9753"the default case when no build option is specified."
9754msgstr ""
9755
9756#. type: TP
9757#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9758#, no-wrap
9759msgid "B<-g>"
9760msgstr ""
9761
9762#. type: Plain text
9763#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9764msgid "Equivalent to B<--build=source,all> (since dpkg 1.17.11)."
9765msgstr ""
9766
9767#. type: Plain text
9768#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9769msgid "Equivalent to B<--build=source,any> (since dpkg 1.17.11)."
9770msgstr ""
9771
9772#. type: TP
9773#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9774#, no-wrap
9775msgid "B<-b>"
9776msgstr ""
9777
9778#. type: Plain text
9779#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9780msgid "Equivalent to B<--build=binary> or B<--build=any,all>."
9781msgstr ""
9782
9783#. type: TP
9784#: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-genchanges.man:1
9785#, no-wrap
9786msgid "B<-B>"
9787msgstr ""
9788
9789#. type: Plain text
9790#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9791msgid "Equivalent to B<--build=any>."
9792msgstr ""
9793
9794#. type: TP
9795#: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-genchanges.man:1
9796#, no-wrap
9797msgid "B<-A>"
9798msgstr ""
9799
9800#. type: Plain text
9801#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9802msgid "Equivalent to B<--build=all>."
9803msgstr ""
9804
9805#. type: TP
9806#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9807#, no-wrap
9808msgid "B<-S>"
9809msgstr ""
9810
9811#. type: Plain text
9812#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9813msgid "Equivalent to B<--build=source>."
9814msgstr ""
9815
9816#. type: TP
9817#: dpkg-buildpackage.man:1
9818#, no-wrap
9819msgid "B<-F>"
9820msgstr ""
9821
9822#. type: Plain text
9823#: dpkg-buildpackage.man:1
9824msgid ""
9825"Equivalent to B<--build=full>, B<--build=source,binary> or "
9826"B<--build=source,any,all> (since dpkg 1.15.8)."
9827msgstr ""
9828
9829#. type: TP
9830#: dpkg-buildpackage.man:1
9831#, no-wrap
9832msgid "B<--target=>I<target>[,...]"
9833msgstr ""
9834
9835#. type: TQ
9836#: dpkg-buildpackage.man:1
9837#, no-wrap
9838msgid "B<--target >I<target>[,...]"
9839msgstr ""
9840
9841#. type: TQ
9842#: dpkg-buildpackage.man:1
9843#, no-wrap
9844msgid "B<-T>, B<--rules-target=>I<target>[,...]"
9845msgstr ""
9846
9847#. type: Plain text
9848#: dpkg-buildpackage.man:1
9849msgid ""
9850"Calls B<debian/rules> I<target> once per target specified, after having "
9851"setup the build environment (except for calling B<dpkg-source "
9852"--before-build>), and stops the package build process here (since dpkg "
9853"1.15.0, long option since dpkg 1.18.8, multi-target support since dpkg "
9854"1.18.16). If B<--as-root> is also given, then the command is executed as "
9855"root (see B<--root-command>). Note that known targets that are required to "
9856"be run as root do not need this option (i.e. the B<clean>, B<binary>, "
9857"B<binary-arch> and B<binary-indep> targets)."
9858msgstr ""
9859
9860#. type: TP
9861#: dpkg-buildpackage.man:1
9862#, no-wrap
9863msgid "B<--as-root>"
9864msgstr ""
9865
9866#. type: Plain text
9867#: dpkg-buildpackage.man:1
9868msgid ""
9869"Only meaningful together with B<--target> (since dpkg 1.15.0). Requires "
9870"that the target be run with root rights."
9871msgstr ""
9872
9873#. type: TP
9874#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9875#, no-wrap
9876msgid "B<-si>"
9877msgstr ""
9878
9879#. type: TP
9880#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9881#, no-wrap
9882msgid "B<-sa>"
9883msgstr ""
9884
9885#. type: TP
9886#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9887#, no-wrap
9888msgid "B<-sd>"
9889msgstr ""
9890
9891#. type: TP
9892#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
9893#: dpkg-gensymbols.man:1
9894#, no-wrap
9895msgid "B<-v>I<version>"
9896msgstr ""
9897
9898#. type: TP
9899#: dpkg-buildpackage.man:1 dpkg-genchanges.man:1
9900#, no-wrap
9901msgid "B<-C>I<changes-description>"
9902msgstr ""
9903
9904#. type: TQ
9905#: dpkg-buildpackage.man:1
9906#, no-wrap
9907msgid "B<-m>, B<--release-by=>I<maintainer-address>"
9908msgstr ""
9909
9910#. type: TQ
9911#: dpkg-buildpackage.man:1
9912#, no-wrap
9913msgid "B<-e>, B<--build-by=>I<maintainer-address>"
9914msgstr ""
9915
9916#. type: Plain text
9917#: dpkg-buildpackage.man:1
9918msgid "Passed unchanged to B<dpkg-genchanges>. See its manual page."
9919msgstr ""
9920
9921#. type: Plain text
9922#: dpkg-buildpackage.man:1
9923msgid ""
9924"Specify the Debian architecture we build for (long option since dpkg "
9925"1.17.17). The architecture of the machine we build on is determined "
9926"automatically, and is also the default for the host machine."
9927msgstr ""
9928
9929#. type: Plain text
9930#: dpkg-buildpackage.man:1
9931msgid ""
9932"Specify the GNU system type we build for (long option since dpkg 1.17.17). "
9933"It can be used in place of B<--host-arch> or as a complement to override the "
9934"default GNU system type of the host Debian architecture."
9935msgstr ""
9936
9937#. type: TP
9938#: dpkg-buildpackage.man:1
9939#, no-wrap
9940msgid "B<--target-arch> I<architecture>"
9941msgstr ""
9942
9943#. type: Plain text
9944#: dpkg-buildpackage.man:1
9945msgid ""
9946"Specify the Debian architecture the binaries built will build for (since "
9947"dpkg 1.17.17). The default value is the host machine."
9948msgstr ""
9949
9950#. type: TP
9951#: dpkg-buildpackage.man:1
9952#, no-wrap
9953msgid "B<--target-type> I<gnu-system-type>"
9954msgstr ""
9955
9956#. type: Plain text
9957#: dpkg-buildpackage.man:1
9958msgid ""
9959"Specify the GNU system type the binaries built will build for (since dpkg "
9960"1.17.17). It can be used in place of B<--target-arch> or as a complement to "
9961"override the default GNU system type of the target Debian architecture."
9962msgstr ""
9963
9964#. type: TP
9965#: dpkg-buildpackage.man:1
9966#, no-wrap
9967msgid "B<-P>, B<--build-profiles=>I<profile>[B<,>...]"
9968msgstr ""
9969
9970#. type: Plain text
9971#: dpkg-buildpackage.man:1
9972msgid ""
9973"Specify the profile(s) we build, as a comma-separated list (since dpkg "
9974"1.17.2, long option since dpkg 1.18.8). The default behavior is to build "
9975"for no specific profile. Also sets them (as a space separated list) as the "
9976"B<DEB_BUILD_PROFILES> environment variable which allows, for example, "
9977"B<debian/rules> files to use this information for conditional builds."
9978msgstr ""
9979
9980#. type: TP
9981#: dpkg-buildpackage.man:1
9982#, no-wrap
9983msgid "B<-j>, B<--jobs>[=I<jobs>|B<auto>]"
9984msgstr ""
9985
9986#. type: Plain text
9987#: dpkg-buildpackage.man:1
9988msgid ""
9989"Number of jobs allowed to be run simultaneously, number of jobs matching the "
9990"number of online processors if B<auto> is specified (since dpkg 1.17.10), or "
9991"unlimited number if I<jobs> is not specified, equivalent to the B<make>(1) "
9992"option of the same name (since dpkg 1.14.7, long option since dpkg 1.18.8). "
9993"Will add itself to the B<MAKEFLAGS> environment variable, which should cause "
9994"all subsequent make invocations to inherit the option, thus forcing the "
9995"parallel setting on the packaging (and possibly the upstream build system if "
9996"that uses make) regardless of their support for parallel builds, which "
9997"might cause build failures. Also adds B<parallel=>I<jobs> or B<parallel> to "
9998"the B<DEB_BUILD_OPTIONS> environment variable which allows debian/rules "
9999"files to use this information for their own purposes. The B<-j> value will "
10000"override the B<parallel=>I<jobs> or B<parallel> option in the "
10001"B<DEB_BUILD_OPTIONS> environment variable. Note that the B<auto> value will "
10002"get replaced by the actual number of currently active processors, and as "
10003"such will not get propagated to any child process. If the number of online "
10004"processors cannot be inferred then the code will fallback to using serial "
10005"execution (since dpkg 1.18.15), although this should only happen on exotic "
10006"and unsupported systems."
10007msgstr ""
10008
10009#. type: TP
10010#: dpkg-buildpackage.man:1
10011#, no-wrap
10012msgid "B<-J>, B<--jobs-try>[=I<jobs>|B<auto>]"
10013msgstr ""
10014
10015#. type: Plain text
10016#: dpkg-buildpackage.man:1
10017msgid ""
10018"This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent "
10019"to the B<-j> option except that it does not set the B<MAKEFLAGS> environment "
10020"variable, and as such it is safer to use with any package including those "
10021"that are not parallel-build safe."
10022msgstr ""
10023
10024#. type: Plain text
10025#: dpkg-buildpackage.man:1
10026msgid ""
10027"B<auto> is the default behavior (since dpkg 1.18.11). Setting the number of "
10028"jobs to 1 will restore a serial behavior."
10029msgstr ""
10030
10031#. type: TP
10032#: dpkg-buildpackage.man:1
10033#, no-wrap
10034msgid "B<-D>, B<--check-builddeps>"
10035msgstr ""
10036
10037#. type: Plain text
10038#: dpkg-buildpackage.man:1
10039msgid ""
10040"Check build dependencies and conflicts; abort if unsatisfied (long option "
10041"since dpkg 1.18.8). This is the default behavior."
10042msgstr ""
10043
10044#. type: TP
10045#: dpkg-buildpackage.man:1
10046#, no-wrap
10047msgid "B<-d>, B<--no-check-builddeps>"
10048msgstr ""
10049
10050#. type: Plain text
10051#: dpkg-buildpackage.man:1
10052msgid ""
10053"Do not check build dependencies and conflicts (long option since dpkg "
10054"1.18.8)."
10055msgstr ""
10056
10057#. type: TP
10058#: dpkg-buildpackage.man:1
10059#, no-wrap
10060msgid "B<--ignore-builtin-builddeps>"
10061msgstr ""
10062
10063#. type: Plain text
10064#: dpkg-buildpackage.man:1
10065msgid ""
10066"Do not check built-in build dependencies and conflicts (since dpkg 1.18.2). "
10067"These are the distribution specific implicit build dependencies usually "
10068"required in a build environment, the so called Build-Essential package set."
10069msgstr ""
10070
10071#. type: TP
10072#: dpkg-buildpackage.man:1
10073#, no-wrap
10074msgid "B<-nc>, B<--no-pre-clean>"
10075msgstr ""
10076
10077#. type: Plain text
10078#: dpkg-buildpackage.man:1
10079msgid ""
10080"Do not clean the source tree (long option since dpkg 1.18.8). Implies B<-b> "
10081"if nothing else has been selected among B<-F>, B<-g>, B<-G>, B<-B>, B<-A> or "
10082"B<-S>. Implies B<-d> with B<-S> (since dpkg 1.18.0)."
10083msgstr ""
10084
10085#. type: TP
10086#: dpkg-buildpackage.man:1
10087#, no-wrap
10088msgid "B<--pre-clean>"
10089msgstr ""
10090
10091#. type: Plain text
10092#: dpkg-buildpackage.man:1
10093msgid "Clean the source tree before building (since dpkg 1.18.8)."
10094msgstr ""
10095
10096#. type: TP
10097#: dpkg-buildpackage.man:1
10098#, no-wrap
10099msgid "B<-tc>, B<--post-clean>"
10100msgstr ""
10101
10102#. type: Plain text
10103#: dpkg-buildpackage.man:1
10104msgid ""
10105"Clean the source tree (using I<gain-root-command> B<debian/rules clean>) "
10106"after the package has been built (long option since dpkg 1.18.8)."
10107msgstr ""
10108
10109#. type: TP
10110#: dpkg-buildpackage.man:1
10111#, no-wrap
10112msgid "B<-r>, B<--root-command=>I<gain-root-command>"
10113msgstr ""
10114
10115#. type: Plain text
10116#: dpkg-buildpackage.man:1
10117msgid ""
10118"When B<dpkg-buildpackage> needs to execute part of the build process as "
10119"root, it prefixes the command it executes with I<gain-root-command> if one "
10120"has been specified (long option since dpkg 1.18.8). Otherwise, if none has "
10121"been specified, B<fakeroot> will be used by default, if the command is "
10122"present. I<gain-root-command> should start with the name of a program on "
10123"the B<PATH> and will get as arguments the name of the real command to run "
10124"and the arguments it should take. I<gain-root-command> can include "
10125"parameters (they must be space-separated) but no shell metacharacters. "
10126"I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or "
10127"B<really>. B<su> is not suitable, since it can only invoke the user's shell "
10128"with B<-c> instead of passing arguments individually to the command to be "
10129"run."
10130msgstr ""
10131
10132#. type: TP
10133#: dpkg-buildpackage.man:1
10134#, no-wrap
10135msgid "B<-R>, B<--rules-file=>I<rules-file>"
10136msgstr ""
10137
10138#. type: Plain text
10139#: dpkg-buildpackage.man:1
10140msgid ""
10141"Building a Debian package usually involves invoking B<debian/rules> as a "
10142"command with several standard parameters (since dpkg 1.14.17, long option "
10143"since dpkg 1.18.8). With this option it's possible to use another program "
10144"invocation to build the package (it can include space separated "
10145"parameters). Alternatively it can be used to execute the standard rules "
10146"file with another make program (for example by using B</usr/local/bin/make "
10147"-f debian/rules> as I<rules-file>)."
10148msgstr ""
10149
10150#. type: TP
10151#: dpkg-buildpackage.man:1
10152#, no-wrap
10153msgid "B<--check-command=>I<check-command>"
10154msgstr ""
10155
10156#. type: Plain text
10157#: dpkg-buildpackage.man:1
10158msgid ""
10159"Command used to check the B<.changes> file itself and any artifact built "
10160"referenced in the file (since dpkg 1.17.6). The command should take the "
10161"B<.changes> pathname as an argument. This command will usually be "
10162"B<lintian>."
10163msgstr ""
10164
10165#. type: TP
10166#: dpkg-buildpackage.man:1
10167#, no-wrap
10168msgid "B<--check-option=>I<opt>"
10169msgstr ""
10170
10171#. type: Plain text
10172#: dpkg-buildpackage.man:1
10173msgid ""
10174"Pass option I<opt> to the I<check-command> specified with "
10175"B<DEB_CHECK_COMMAND> or B<--check-command> (since dpkg 1.17.6). Can be used "
10176"multiple times."
10177msgstr ""
10178
10179#. type: TP
10180#: dpkg-buildpackage.man:1
10181#, no-wrap
10182msgid "B<--hook->I<hook-name>B<=>I<hook-command>"
10183msgstr ""
10184
10185#. type: Plain text
10186#: dpkg-buildpackage.man:1
10187msgid ""
10188"Set the specified shell code I<hook-command> as the hook I<hook-name>, which "
10189"will run at the times specified in the run steps (since dpkg 1.17.6). The "
10190"hooks will always be executed even if the following action is not performed "
10191"(except for the B<binary> hook). All the hooks will run in the unpacked "
10192"source directory."
10193msgstr ""
10194
10195#. type: Plain text
10196#: dpkg-buildpackage.man:1
10197msgid ""
10198"Note: Hooks can affect the build process, and cause build failures if their "
10199"commands fail, so watch out for unintended consequences."
10200msgstr ""
10201
10202#. type: Plain text
10203#: dpkg-buildpackage.man:1
10204msgid "The current I<hook-name> supported are:"
10205msgstr ""
10206
10207#. type: Plain text
10208#: dpkg-buildpackage.man:1
10209msgid ""
10210"B<init preclean source build binary buildinfo changes postclean check sign "
10211"done>"
10212msgstr ""
10213
10214#. type: Plain text
10215#: dpkg-buildpackage.man:1
10216msgid ""
10217"The I<hook-command> supports the following substitution format string, which "
10218"will get applied to it before execution:"
10219msgstr ""
10220
10221#. type: TP
10222#: dpkg-buildpackage.man:1
10223#, no-wrap
10224msgid "B<%%>"
10225msgstr ""
10226
10227#. type: Plain text
10228#: dpkg-buildpackage.man:1
10229msgid "A single % character."
10230msgstr ""
10231
10232#. type: TP
10233#: dpkg-buildpackage.man:1
10234#, no-wrap
10235msgid "B<%a>"
10236msgstr ""
10237
10238#. type: Plain text
10239#: dpkg-buildpackage.man:1
10240msgid ""
10241"A boolean value (0 or 1), representing whether the following action is being "
10242"performed."
10243msgstr ""
10244
10245#. type: TP
10246#: dpkg-buildpackage.man:1
10247#, no-wrap
10248msgid "B<%p>"
10249msgstr ""
10250
10251#. type: Plain text
10252#: dpkg-buildpackage.man:1
10253msgid "The source package name."
10254msgstr ""
10255
10256#. type: TP
10257#: dpkg-buildpackage.man:1
10258#, no-wrap
10259msgid "B<%v>"
10260msgstr ""
10261
10262#. type: Plain text
10263#: dpkg-buildpackage.man:1
10264msgid "The source package version."
10265msgstr ""
10266
10267#. type: TP
10268#: dpkg-buildpackage.man:1
10269#, no-wrap
10270msgid "B<%s>"
10271msgstr ""
10272
10273#. type: Plain text
10274#: dpkg-buildpackage.man:1
10275msgid "The source package version (without the epoch)."
10276msgstr ""
10277
10278#. type: TP
10279#: dpkg-buildpackage.man:1
10280#, no-wrap
10281msgid "B<%u>"
10282msgstr ""
10283
10284#. type: Plain text
10285#: dpkg-buildpackage.man:1
10286msgid "The upstream version."
10287msgstr ""
10288
10289#. type: TP
10290#: dpkg-buildpackage.man:1
10291#, no-wrap
10292msgid "B<--buildinfo-option=>I<opt>"
10293msgstr ""
10294
10295#. type: Plain text
10296#: dpkg-buildpackage.man:1
10297msgid ""
10298"Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11). Can be "
10299"used multiple times."
10300msgstr ""
10301
10302#. type: TP
10303#: dpkg-buildpackage.man:1
10304#, no-wrap
10305msgid "B<-p>, B<--sign-command=>I<sign-command>"
10306msgstr ""
10307
10308#. type: Plain text
10309#: dpkg-buildpackage.man:1
10310msgid ""
10311"When B<dpkg-buildpackage> needs to execute GPG to sign a source control "
10312"(B<.dsc>) file or a B<.changes> file it will run I<sign-command> (searching "
10313"the B<PATH> if necessary) instead of B<gpg2> or B<gpg> (long option since "
10314"dpkg 1.18.8). I<sign-command> will get all the arguments that B<gpg2> or "
10315"B<gpg> would have gotten. I<sign-command> should not contain spaces or any "
10316"other shell metacharacters."
10317msgstr ""
10318
10319#. type: TP
10320#: dpkg-buildpackage.man:1
10321#, no-wrap
10322msgid "B<-k>, B<--sign-key=>I<key-id>"
10323msgstr ""
10324
10325#. type: Plain text
10326#: dpkg-buildpackage.man:1
10327msgid ""
10328"Specify a key-ID to use when signing packages (long option since dpkg "
10329"1.18.8)."
10330msgstr ""
10331
10332#. type: TP
10333#: dpkg-buildpackage.man:1
10334#, no-wrap
10335msgid "B<-us>, B<--unsigned-source>"
10336msgstr ""
10337
10338#. type: Plain text
10339#: dpkg-buildpackage.man:1
10340msgid "Do not sign the source package (long option since dpkg 1.18.8)."
10341msgstr ""
10342
10343#. type: TP
10344#: dpkg-buildpackage.man:1
10345#, no-wrap
10346msgid "B<-ui>, B<--unsigned-buildinfo>"
10347msgstr ""
10348
10349#. type: Plain text
10350#: dpkg-buildpackage.man:1
10351msgid "Do not sign the B<.buildinfo> file (since dpkg 1.18.19)."
10352msgstr ""
10353
10354#. type: TP
10355#: dpkg-buildpackage.man:1
10356#, no-wrap
10357msgid "B<-uc>, B<--unsigned-changes>"
10358msgstr ""
10359
10360#. type: Plain text
10361#: dpkg-buildpackage.man:1
10362msgid ""
10363"Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg "
10364"1.18.8)."
10365msgstr ""
10366
10367#. type: TP
10368#: dpkg-buildpackage.man:1
10369#, no-wrap
10370msgid "B<--no-sign>"
10371msgstr ""
10372
10373#. type: Plain text
10374#: dpkg-buildpackage.man:1
10375msgid ""
10376"Do not sign any file, this includes the source package, the B<.buildinfo> "
10377"file and the B<.changes> file (since dpkg 1.18.20)."
10378msgstr ""
10379
10380#. type: TP
10381#: dpkg-buildpackage.man:1
10382#, no-wrap
10383msgid "B<--force-sign>"
10384msgstr ""
10385
10386#. type: Plain text
10387#: dpkg-buildpackage.man:1
10388msgid ""
10389"Force the signing of the resulting files (since dpkg 1.17.0), regardless of "
10390"B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, "
10391"B<--unsigned-changes> or other internal heuristics."
10392msgstr ""
10393
10394#. type: TP
10395#: dpkg-buildpackage.man:1 dpkg-source.man:1 dpkg-source.man:1
10396#, no-wrap
10397msgid "B<-sn>"
10398msgstr ""
10399
10400#. type: TP
10401#: dpkg-buildpackage.man:1 dpkg-source.man:1
10402#, no-wrap
10403msgid "B<-ss>"
10404msgstr ""
10405
10406#. type: TQ
10407#: dpkg-buildpackage.man:1
10408#, no-wrap
10409msgid "B<-sA>"
10410msgstr ""
10411
10412#. type: TP
10413#: dpkg-buildpackage.man:1 dpkg-source.man:1
10414#, no-wrap
10415msgid "B<-sk>"
10416msgstr ""
10417
10418#. type: TP
10419#: dpkg-buildpackage.man:1 dpkg-source.man:1 dpkg-source.man:1
10420#, no-wrap
10421msgid "B<-su>"
10422msgstr ""
10423
10424#. type: TP
10425#: dpkg-buildpackage.man:1 dpkg-source.man:1
10426#, no-wrap
10427msgid "B<-sr>"
10428msgstr ""
10429
10430#. type: TQ
10431#: dpkg-buildpackage.man:1
10432#, no-wrap
10433msgid "B<-sK>"
10434msgstr ""
10435
10436#. type: TQ
10437#: dpkg-buildpackage.man:1
10438#, no-wrap
10439msgid "B<-sU>"
10440msgstr ""
10441
10442#. type: TQ
10443#: dpkg-buildpackage.man:1
10444#, no-wrap
10445msgid "B<-sR>"
10446msgstr ""
10447
10448#. type: TQ
10449#: dpkg-buildpackage.man:1
10450#, no-wrap
10451msgid "B<-i>, B<--diff-ignore>[=I<regex>]"
10452msgstr ""
10453
10454#. type: TQ
10455#: dpkg-buildpackage.man:1
10456#, no-wrap
10457msgid "B<-I>, B<--tar-ignore>[=I<pattern>]"
10458msgstr ""
10459
10460#. type: TQ
10461#: dpkg-buildpackage.man:1
10462#, no-wrap
10463msgid "B<-z>, B<--compression-level=>I<level>"
10464msgstr ""
10465
10466#. type: TQ
10467#: dpkg-buildpackage.man:1
10468#, no-wrap
10469msgid "B<-Z>, B<--compression=>I<compressor>"
10470msgstr ""
10471
10472#. type: Plain text
10473#: dpkg-buildpackage.man:1
10474msgid "Passed unchanged to B<dpkg-source>. See its manual page."
10475msgstr ""
10476
10477#. type: TP
10478#: dpkg-buildpackage.man:1
10479#, no-wrap
10480msgid "B<--source-option=>I<opt>"
10481msgstr ""
10482
10483#. type: Plain text
10484#: dpkg-buildpackage.man:1
10485msgid ""
10486"Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6). Can be used "
10487"multiple times."
10488msgstr ""
10489
10490#. type: TP
10491#: dpkg-buildpackage.man:1
10492#, no-wrap
10493msgid "B<--changes-option=>I<opt>"
10494msgstr ""
10495
10496#. type: Plain text
10497#: dpkg-buildpackage.man:1
10498msgid ""
10499"Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6). Can be used "
10500"multiple times."
10501msgstr ""
10502
10503#. type: TQ
10504#: dpkg-buildpackage.man:1
10505#, no-wrap
10506msgid "B<--admindir >I<dir>"
10507msgstr ""
10508
10509#. type: Plain text
10510#: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1 dpkg-shlibdeps.man:1
10511msgid ""
10512"Change the location of the B<dpkg> database (since dpkg 1.14.0). The "
10513"default location is I<%ADMINDIR%>."
10514msgstr ""
10515
10516#. type: TP
10517#: dpkg-buildpackage.man:1
10518#, no-wrap
10519msgid "B<DEB_CHECK_COMMAND>"
10520msgstr ""
10521
10522#. type: Plain text
10523#: dpkg-buildpackage.man:1
10524msgid ""
10525"If set, it will be used as the command to check the B<.changes> file (since "
10526"dpkg 1.17.6). Overridden by the B<--check-command> option."
10527msgstr ""
10528
10529#. type: TP
10530#: dpkg-buildpackage.man:1
10531#, no-wrap
10532msgid "B<DEB_SIGN_KEYID>"
10533msgstr ""
10534
10535#. type: Plain text
10536#: dpkg-buildpackage.man:1
10537msgid ""
10538"If set, it will be used to sign the B<.changes> and B<.dsc> files (since "
10539"dpkg 1.17.2). Overridden by the B<--sign-key> option."
10540msgstr ""
10541
10542#. type: Plain text
10543#: dpkg-buildpackage.man:1
10544msgid ""
10545"If set, it will contain a space-separated list of options that might affect "
10546"the build process in I<debian/rules>, and the behavior of some dpkg "
10547"commands."
10548msgstr ""
10549
10550#. type: Plain text
10551#: dpkg-buildpackage.man:1
10552msgid ""
10553"With B<nocheck> the B<DEB_CHECK_COMMAND> variable will be ignored. With "
10554"B<parallel=>I<N> the parallel jobs will be set to I<N>, overridden by the "
10555"B<--jobs-try> option."
10556msgstr ""
10557
10558#. type: TP
10559#: dpkg-buildpackage.man:1 dpkg-checkbuilddeps.man:1
10560#, no-wrap
10561msgid "B<DEB_BUILD_PROFILES>"
10562msgstr ""
10563
10564#. type: Plain text
10565#: dpkg-buildpackage.man:1
10566msgid ""
10567"If set, it will be used as the active build profile(s) for the package being "
10568"built (since dpkg 1.17.2). It is a space separated list of profile names. "
10569"Overridden by the B<-P> option."
10570msgstr ""
10571
10572#. type: Plain text
10573#: dpkg-buildpackage.man:1
10574msgid ""
10575"Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should "
10576"not rely on their presence and should instead use the respective interface "
10577"to retrieve the needed values, because that file is the main entry point to "
10578"build packages and running it standalone should be supported."
10579msgstr ""
10580
10581#. type: TP
10582#: dpkg-buildpackage.man:1
10583#, no-wrap
10584msgid "B<DEB_BUILD_*>"
10585msgstr ""
10586
10587#. type: TQ
10588#: dpkg-buildpackage.man:1
10589#, no-wrap
10590msgid "B<DEB_HOST_*>"
10591msgstr ""
10592
10593#. type: TQ
10594#: dpkg-buildpackage.man:1
10595#, no-wrap
10596msgid "B<DEB_TARGET_*>"
10597msgstr ""
10598
10599#. type: Plain text
10600#: dpkg-buildpackage.man:1
10601msgid ""
10602"B<dpkg-architecture> is called with the B<-a> and B<-t> parameters "
10603"forwarded. Any variable that is output by its B<-s> option is integrated in "
10604"the build environment."
10605msgstr ""
10606
10607#. type: TP
10608#: dpkg-buildpackage.man:1 dpkg-deb.man:1 dpkg-source.man:1 dpkg-split.man:1
10609#, no-wrap
10610msgid "B<SOURCE_DATE_EPOCH>"
10611msgstr ""
10612
10613#. type: Plain text
10614#: dpkg-buildpackage.man:1
10615msgid ""
10616"This variable is set to the Unix timestamp since the epoch of the latest "
10617"entry in I<debian/changelog>, if it is not already defined."
10618msgstr ""
10619
10620#. type: TP
10621#: dpkg-buildpackage.man:1
10622#, no-wrap
10623msgid "I<%PKGCONFDIR%/buildpackage.conf>"
10624msgstr ""
10625
10626#. type: Plain text
10627#: dpkg-buildpackage.man:1
10628msgid "System wide configuration file"
10629msgstr ""
10630
10631#. type: TP
10632#: dpkg-buildpackage.man:1
10633#, no-wrap
10634msgid "I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or"
10635msgstr ""
10636
10637#. type: TQ
10638#: dpkg-buildpackage.man:1
10639#, no-wrap
10640msgid "I<$HOME/.config/dpkg/buildpackage.conf>"
10641msgstr ""
10642
10643#. type: SS
10644#: dpkg-buildpackage.man:1
10645#, no-wrap
10646msgid "Compiler flags are no longer exported"
10647msgstr ""
10648
10649#. type: Plain text
10650#: dpkg-buildpackage.man:1
10651msgid ""
10652"Between dpkg 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler "
10653"flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with "
10654"values as returned by B<dpkg-buildflags>. This is no longer the case."
10655msgstr ""
10656
10657#. type: SS
10658#: dpkg-buildpackage.man:1
10659#, no-wrap
10660msgid "Default build targets"
10661msgstr ""
10662
10663#. type: Plain text
10664#: dpkg-buildpackage.man:1
10665msgid ""
10666"B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets "
10667"since dpkg 1.16.2. Those targets are thus mandatory. But to avoid breakages "
10668"of existing packages, and ease the transition, if the source package does "
10669"not build both architecture independent and dependent binary packages (since "
10670"dpkg 1.18.8) it will fallback to use the B<build> target if B<make -f "
10671"debian/rules -qn> I<build-target> returns 2 as exit code."
10672msgstr ""
10673
10674#. type: Plain text
10675#: dpkg-buildpackage.man:1
10676msgid ""
10677"It should be possible to specify spaces and shell metacharacters and initial "
10678"arguments for I<gain-root-command> and I<sign-command>."
10679msgstr ""
10680
10681#. type: Plain text
10682#: dpkg-buildpackage.man:1
10683msgid ""
10684"B<dpkg-source>(1), B<dpkg-architecture>(1), B<dpkg-buildflags>(1), "
10685"B<dpkg-genbuildinfo>(1), B<dpkg-genchanges>(1), B<fakeroot>(1), "
10686"B<lintian>(1), B<gpg2>(1), B<gpg>(1)."
10687msgstr ""
10688
10689#. type: TH
10690#: dpkg-genbuildinfo.man:1
10691#, no-wrap
10692msgid "dpkg-genbuildinfo"
10693msgstr ""
10694
10695#. type: Plain text
10696#: dpkg-genbuildinfo.man:1
10697msgid "dpkg-genbuildinfo - generate Debian .buildinfo files"
10698msgstr ""
10699
10700#. type: Plain text
10701#: dpkg-genbuildinfo.man:1
10702msgid "B<dpkg-genbuildinfo> [I<option>...]"
10703msgstr ""
10704
10705#. type: Plain text
10706#: dpkg-genbuildinfo.man:1
10707msgid ""
10708"B<dpkg-genbuildinfo> reads information from an unpacked and built Debian "
10709"source tree and from the files it has generated and generates a Debian "
10710"control file describing the build environment and the build artifacts "
10711"(B<.buildinfo> file)."
10712msgstr ""
10713
10714#. type: Plain text
10715#: dpkg-genbuildinfo.man:1
10716msgid "This command was introduced in dpkg 1.18.11."
10717msgstr ""
10718
10719#. type: Plain text
10720#: dpkg-genbuildinfo.man:1
10721msgid "Specifies the build I<type> from a comma-separated list of components."
10722msgstr ""
10723
10724#. type: Plain text
10725#: dpkg-genbuildinfo.man:1
10726msgid ""
10727"Generate build information including unqualified build dependencies "
10728"(B<Build-Depends>) and architecture specific build dependencies "
10729"(B<Build-Depends-Arch>)."
10730msgstr ""
10731
10732#. type: Plain text
10733#: dpkg-genbuildinfo.man:1
10734msgid ""
10735"Generate build information including unqualified build dependencies "
10736"(B<Build-Depends>) and architecture independent build dependencies "
10737"(B<Build-Depends-Indep>)."
10738msgstr ""
10739
10740#. type: Plain text
10741#: dpkg-genbuildinfo.man:1
10742msgid ""
10743"Effectively ignored; generate build information with just the unqualified "
10744"build dependencies (B<Build-Depends>)."
10745msgstr ""
10746
10747#. type: Plain text
10748#: dpkg-genbuildinfo.man:1
10749msgid ""
10750"Generate build information with all three types of build dependencies. This "
10751"is an alias for B<any,all>."
10752msgstr ""
10753
10754#. type: Plain text
10755#: dpkg-genbuildinfo.man:1
10756msgid ""
10757"Generate build information with all three types of build dependencies. This "
10758"is an alias for B<any,all,source>, and the same as the default case when no "
10759"build option is specified."
10760msgstr ""
10761
10762#. type: TP
10763#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
10764#, no-wrap
10765msgid "B<-c>I<controlfile>"
10766msgstr ""
10767
10768#. type: Plain text
10769#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10770msgid ""
10771"Specifies the main source control file to read information from. The default "
10772"is B<debian/control>."
10773msgstr ""
10774
10775#. type: TP
10776#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10777#: dpkg-source.man:1
10778#, no-wrap
10779msgid "B<-l>I<changelog-file>"
10780msgstr ""
10781
10782#. type: Plain text
10783#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10784msgid ""
10785"Specifies the changelog file to read information from. The default is "
10786"B<debian/changelog>."
10787msgstr ""
10788
10789#. type: TP
10790#: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-genchanges.man:1
10791#: dpkg-gencontrol.man:1
10792#, no-wrap
10793msgid "B<-f>I<files-list-file>"
10794msgstr ""
10795
10796#. type: Plain text
10797#: dpkg-genbuildinfo.man:1
10798msgid ""
10799"Specifies where is the list of files that have been produced by the build, "
10800"rather than using B<debian/files>."
10801msgstr ""
10802
10803#. type: TP
10804#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10805#: dpkg-source.man:1
10806#, no-wrap
10807msgid "B<-F>I<changelog-format>"
10808msgstr ""
10809
10810#. type: Plain text
10811#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10812#: dpkg-source.man:1
10813msgid ""
10814"Specifies the format of the changelog. See B<dpkg-parsechangelog>(1) for "
10815"information about alternative formats."
10816msgstr ""
10817
10818#. type: TP
10819#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gencontrol.man:1
10820#: dpkg-gensymbols.man:1 dpkg-shlibdeps.man:1
10821#, no-wrap
10822msgid "B<-O>[I<filename>]"
10823msgstr ""
10824
10825#. type: Plain text
10826#: dpkg-genbuildinfo.man:1
10827msgid ""
10828"Print the buildinfo file to standard output (or I<filename> if specified) "
10829"rather than to "
10830"I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo> (where "
10831"I<dir> is B<..> by default or I<upload-files-dir> if B<-u> was used)."
10832msgstr ""
10833
10834#. type: TP
10835#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1
10836#, no-wrap
10837msgid "B<-u>I<upload-files-dir>"
10838msgstr ""
10839
10840#. type: Plain text
10841#: dpkg-genbuildinfo.man:1
10842msgid ""
10843"Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
10844"(B<dpkg-genbuildinfo> needs to find these files so that it can include their "
10845"sizes and checksums in the B<.buildinfo> file)."
10846msgstr ""
10847
10848#. type: TP
10849#: dpkg-genbuildinfo.man:1
10850#, no-wrap
10851msgid "B<--always-include-path>"
10852msgstr ""
10853
10854#. type: Plain text
10855#: dpkg-genbuildinfo.man:1
10856msgid ""
10857"By default, the B<Build-Path> field will only be written if the current "
10858"directory starts with a whitelisted pattern."
10859msgstr ""
10860
10861#. type: Plain text
10862#: dpkg-genbuildinfo.man:1
10863msgid ""
10864"On Debian and derivatives the pattern matches on B</build/> at the start of "
10865"the pathname."
10866msgstr ""
10867
10868#. type: Plain text
10869#: dpkg-genbuildinfo.man:1
10870msgid ""
10871"Specify this option to always write a B<Build-Path> field when generating "
10872"the B<.buildinfo>."
10873msgstr ""
10874
10875#. type: Plain text
10876#: dpkg-genbuildinfo.man:1
10877msgid ""
10878"Change the location of the B<dpkg> database. The default location is "
10879"I</var/lib/dpkg>."
10880msgstr ""
10881
10882#. type: TP
10883#: dpkg-genbuildinfo.man:1 dpkg-genchanges.man:1 dpkg-gensymbols.man:1
10884#, no-wrap
10885msgid "B<-q>"
10886msgstr ""
10887
10888#. type: Plain text
10889#: dpkg-genbuildinfo.man:1
10890msgid ""
10891"B<dpkg-genbuildinfo> might produce informative messages on standard error. "
10892"B<-q> suppresses these messages."
10893msgstr ""
10894
10895#. type: Plain text
10896#: dpkg-genbuildinfo.man:1
10897msgid ""
10898"This variable can be used to enable or disable various features that affect "
10899"the information included in the .buildinfo file, via the B<buildinfo> option "
10900"(since dpkg 1.18.19). This option contains a comma-separated list of "
10901"features, prefixed with the ‘B<+>’ or ‘B<->’ modifiers, to denote whether to "
10902"enable or disable them. The special feature “B<all>” can be used to enable "
10903"or disable all other features. The feature “B<path>” controls whether to "
10904"unconditionally include the B<Build-Path> field."
10905msgstr ""
10906
10907#. type: TP
10908#: dpkg-genbuildinfo.man:1 dpkg-distaddfile.man:1 dpkg-genchanges.man:1
10909#: dpkg-gencontrol.man:1
10910#, no-wrap
10911msgid "B<debian/files>"
10912msgstr ""
10913
10914#. type: Plain text
10915#: dpkg-genbuildinfo.man:1
10916msgid ""
10917"The list of generated files. B<dpkg-genbuildinfo> reads the data here when "
10918"producing a B<.buildinfo> file."
10919msgstr ""
10920
10921#. type: Plain text
10922#: dpkg-genbuildinfo.man:1
10923msgid "B<deb-buildinfo>(5)."
10924msgstr ""
10925
10926#. type: TH
10927#: dpkg-checkbuilddeps.man:1
10928#, no-wrap
10929msgid "dpkg-checkbuilddeps"
10930msgstr ""
10931
10932#. type: Plain text
10933#: dpkg-checkbuilddeps.man:1
10934msgid "dpkg-checkbuilddeps - check build dependencies and conflicts"
10935msgstr ""
10936
10937#. type: Plain text
10938#: dpkg-checkbuilddeps.man:1
10939msgid "B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]"
10940msgstr ""
10941
10942#. type: Plain text
10943#: dpkg-checkbuilddeps.man:1
10944msgid ""
10945"This program checks the installed packages in the system against the build "
10946"dependencies and build conflicts listed in the control file. If any are not "
10947"met, it displays them and exits with a nonzero return code."
10948msgstr ""
10949
10950#. type: Plain text
10951#: dpkg-checkbuilddeps.man:1
10952msgid ""
10953"By default, B<debian/control> is read, but an alternate control filename may "
10954"be specified on the command line."
10955msgstr ""
10956
10957#. type: Plain text
10958#: dpkg-checkbuilddeps.man:1
10959msgid ""
10960"Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch> lines (since dpkg "
10961"1.16.4). Use when only arch-indep packages will be built, or combine with "
10962"B<-B> when only a source package is to be built."
10963msgstr ""
10964
10965#. type: Plain text
10966#: dpkg-checkbuilddeps.man:1
10967msgid ""
10968"Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep> lines. Use when "
10969"only arch-dep packages will be built, or combine with B<-A> when only a "
10970"source package is to be built."
10971msgstr ""
10972
10973#. type: TP
10974#: dpkg-checkbuilddeps.man:1
10975#, no-wrap
10976msgid "B<-I>"
10977msgstr ""
10978
10979#. type: Plain text
10980#: dpkg-checkbuilddeps.man:1
10981msgid ""
10982"Ignore built-in build depends and conflicts (since dpkg 1.18.2). These are "
10983"implicit dependencies that are usually required on a specific distribution, "
10984"the so called Build-Essential package set."
10985msgstr ""
10986
10987#. type: TP
10988#: dpkg-checkbuilddeps.man:1
10989#, no-wrap
10990msgid "B<-d >I<build-depends-string>"
10991msgstr ""
10992
10993#. type: TP
10994#: dpkg-checkbuilddeps.man:1
10995#, no-wrap
10996msgid "B<-c >I<build-conflicts-string>"
10997msgstr ""
10998
10999#. type: Plain text
11000#: dpkg-checkbuilddeps.man:1
11001msgid ""
11002"Use the given build dependencies/conflicts instead of those contained in the "
11003"I<debian/control> file (since dpkg 1.14.17)."
11004msgstr ""
11005
11006#. type: TP
11007#: dpkg-checkbuilddeps.man:1
11008#, no-wrap
11009msgid "B<-a >I<arch>"
11010msgstr ""
11011
11012#. type: Plain text
11013#: dpkg-checkbuilddeps.man:1
11014msgid ""
11015"Check build dependencies/conflicts assuming that the package described in "
11016"the control file is to be built for the given host architecture instead of "
11017"the architecture of the current system (since dpkg 1.16.2)."
11018msgstr ""
11019
11020#. type: TP
11021#: dpkg-checkbuilddeps.man:1
11022#, no-wrap
11023msgid "B<-P >I<profile>[B<,>...]"
11024msgstr ""
11025
11026#. type: Plain text
11027#: dpkg-checkbuilddeps.man:1
11028msgid ""
11029"Check build dependencies/conflicts assuming that the package described in "
11030"the control file is to be built for the given build profile(s) (since dpkg "
11031"1.17.2). The argument is a comma-separated list of profile names."
11032msgstr ""
11033
11034#. type: Plain text
11035#: dpkg-checkbuilddeps.man:1
11036msgid ""
11037"If set, it will be used as the active build profile(s) for the package being "
11038"built. It is a space separated list of profile names. Overridden by the "
11039"B<-P> option."
11040msgstr ""
11041
11042#. type: TH
11043#: dpkg-distaddfile.man:1
11044#, no-wrap
11045msgid "dpkg-distaddfile"
11046msgstr ""
11047
11048#. type: Plain text
11049#: dpkg-distaddfile.man:1
11050msgid "dpkg-distaddfile - add entries to debian/files"
11051msgstr ""
11052
11053#. type: Plain text
11054#: dpkg-distaddfile.man:1
11055msgid "B<dpkg-distaddfile> [I<option>...]I< filename section priority>"
11056msgstr ""
11057
11058#. type: Plain text
11059#: dpkg-distaddfile.man:1
11060msgid "B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>."
11061msgstr ""
11062
11063#. type: Plain text
11064#: dpkg-distaddfile.man:1
11065msgid ""
11066"It takes three non-option arguments, the filename and the section and "
11067"priority for the B<.changes> file."
11068msgstr ""
11069
11070#. type: Plain text
11071#: dpkg-distaddfile.man:1
11072msgid ""
11073"The filename should be specified relative to the directory where "
11074"B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than "
11075"being a pathname relative to the current directory when B<dpkg-distaddfile> "
11076"is run."
11077msgstr ""
11078
11079#. type: Plain text
11080#: dpkg-distaddfile.man:1 dpkg-gencontrol.man:1
11081msgid ""
11082"Read or write the list of files to be uploaded here, rather than using "
11083"B<debian/files>."
11084msgstr ""
11085
11086#. type: Plain text
11087#: dpkg-distaddfile.man:1
11088msgid ""
11089"The list of generated files which are part of the upload being prepared. "
11090"B<dpkg-distaddfile> can be used to add additional files."
11091msgstr ""
11092
11093#. type: Plain text
11094#: dpkg-distaddfile.man:1
11095msgid "B<deb-src-files>(5)."
11096msgstr ""
11097
11098#. type: TH
11099#: dpkg-deb.man:1
11100#, no-wrap
11101msgid "dpkg-deb"
11102msgstr ""
11103
11104#. type: Plain text
11105#: dpkg-deb.man:1
11106msgid "dpkg-deb - Debian package archive (.deb) manipulation tool"
11107msgstr ""
11108
11109#. type: Plain text
11110#: dpkg-deb.man:1
11111msgid "B<dpkg-deb> [I<option>...] I<command>"
11112msgstr ""
11113
11114#. type: Plain text
11115#: dpkg-deb.man:1
11116msgid "B<dpkg-deb> packs, unpacks and provides information about Debian archives."
11117msgstr ""
11118
11119#. type: Plain text
11120#: dpkg-deb.man:1
11121msgid "Use B<dpkg> to install and remove packages from your system."
11122msgstr ""
11123
11124#. type: Plain text
11125#: dpkg-deb.man:1
11126msgid ""
11127"You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you "
11128"want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> "
11129"and run it for you."
11130msgstr ""
11131
11132#. type: Plain text
11133#: dpkg-deb.man:1
11134msgid ""
11135"For most commands taking an input archive argument, the archive can be read "
11136"from standard input if the archive name is given as a single minus character "
11137"(«B<->»); otherwise lack of support will be documented in their respective "
11138"command description."
11139msgstr ""
11140
11141#. type: TP
11142#: dpkg-deb.man:1
11143#, no-wrap
11144msgid "B<-b>, B<--build> I<binary-directory> [I<archive>|I<directory>]"
11145msgstr ""
11146
11147#. type: Plain text
11148#: dpkg-deb.man:1
11149msgid ""
11150"Creates a debian archive from the filesystem tree stored in "
11151"I<binary-directory>. I<binary-directory> must have a B<DEBIAN> subdirectory, "
11152"which contains the control information files such as the control file "
11153"itself. This directory will I<not> appear in the binary package's filesystem "
11154"archive, but instead the files in it will be put in the binary package's "
11155"control information area."
11156msgstr ""
11157
11158#. type: Plain text
11159#: dpkg-deb.man:1
11160msgid ""
11161"Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and "
11162"parse it. It will check the file for syntax errors and other problems, and "
11163"display the name of the binary package being built. B<dpkg-deb> will also "
11164"check the permissions of the maintainer scripts and other files found in the "
11165"B<DEBIAN> control information directory."
11166msgstr ""
11167
11168#. type: Plain text
11169#: dpkg-deb.man:1
11170msgid ""
11171"If no I<archive> is specified then B<dpkg-deb> will write the package into "
11172"the file I<binary-directory>B<.deb>."
11173msgstr ""
11174
11175#. type: Plain text
11176#: dpkg-deb.man:1
11177msgid "If the archive to be created already exists it will be overwritten."
11178msgstr ""
11179
11180#. type: Plain text
11181#: dpkg-deb.man:1
11182msgid ""
11183"If the second argument is a directory then B<dpkg-deb> will write to the "
11184"file I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> When a "
11185"target directory is specified, rather than a file, the B<--nocheck> option "
11186"may not be used (since B<dpkg-deb> needs to read and parse the package "
11187"control file to determine which filename to use)."
11188msgstr ""
11189
11190#. type: TP
11191#: dpkg-deb.man:1
11192#, no-wrap
11193msgid "B<-I>, B<--info> I<archive> [I<control-file-name>...]"
11194msgstr ""
11195
11196#. type: Plain text
11197#: dpkg-deb.man:1
11198msgid "Provides information about a binary package archive."
11199msgstr ""
11200
11201#. type: Plain text
11202#: dpkg-deb.man:1
11203msgid ""
11204"If no I<control-file-name>s are specified then it will print a summary of "
11205"the contents of the package as well as its control file."
11206msgstr ""
11207
11208#. type: Plain text
11209#: dpkg-deb.man:1
11210msgid ""
11211"If any I<control-file-name>s are specified then B<dpkg-deb> will print them "
11212"in the order they were specified; if any of the components weren't present "
11213"it will print an error message to stderr about each one and exit with status "
11214"2."
11215msgstr ""
11216
11217#. type: TP
11218#: dpkg-deb.man:1
11219#, no-wrap
11220msgid "B<-W>, B<--show> I<archive>"
11221msgstr ""
11222
11223#. type: Plain text
11224#: dpkg-deb.man:1
11225msgid ""
11226"Provides information about a binary package archive in the format specified "
11227"by the B<--showformat> argument. The default format displays the package's "
11228"name and version on one line, separated by a tabulator."
11229msgstr ""
11230
11231#. type: TP
11232#: dpkg-deb.man:1
11233#, no-wrap
11234msgid "B<-f>, B<--field> I<archive> [I<control-field-name>...]"
11235msgstr ""
11236
11237#. type: Plain text
11238#: dpkg-deb.man:1
11239msgid "Extracts control file information from a binary package archive."
11240msgstr ""
11241
11242#. type: Plain text
11243#: dpkg-deb.man:1
11244msgid ""
11245"If no I<control-field-name>s are specified then it will print the whole "
11246"control file."
11247msgstr ""
11248
11249#. type: Plain text
11250#: dpkg-deb.man:1
11251msgid ""
11252"If any are specified then B<dpkg-deb> will print their contents, in the "
11253"order in which they appear in the control file. If more than one "
11254"I<control-field-name> is specified then B<dpkg-deb> will precede each with "
11255"its field name (and a colon and space)."
11256msgstr ""
11257
11258#. type: Plain text
11259#: dpkg-deb.man:1
11260msgid "No errors are reported for fields requested but not found."
11261msgstr ""
11262
11263#. type: TP
11264#: dpkg-deb.man:1
11265#, no-wrap
11266msgid "B<-c>, B<--contents> I<archive>"
11267msgstr ""
11268
11269#. type: Plain text
11270#: dpkg-deb.man:1
11271msgid ""
11272"Lists the contents of the filesystem tree archive portion of the package "
11273"archive. It is currently produced in the format generated by B<tar>'s "
11274"verbose listing."
11275msgstr ""
11276
11277#. type: TP
11278#: dpkg-deb.man:1
11279#, no-wrap
11280msgid "B<-x>, B<--extract> I<archive directory>"
11281msgstr ""
11282
11283#. type: Plain text
11284#: dpkg-deb.man:1
11285msgid ""
11286"Extracts the filesystem tree from a package archive into the specified "
11287"directory."
11288msgstr ""
11289
11290#. type: Plain text
11291#: dpkg-deb.man:1
11292msgid ""
11293"Note that extracting a package to the root directory will I<not> result in a "
11294"correct installation! Use B<dpkg> to install packages."
11295msgstr ""
11296
11297#. type: Plain text
11298#: dpkg-deb.man:1
11299msgid ""
11300"I<directory> (but not its parents) will be created if necessary, and its "
11301"permissions modified to match the contents of the package."
11302msgstr ""
11303
11304#. type: TP
11305#: dpkg-deb.man:1
11306#, no-wrap
11307msgid "B<-X>, B<--vextract> I<archive directory>"
11308msgstr ""
11309
11310#. type: Plain text
11311#: dpkg-deb.man:1
11312msgid ""
11313"Is like B<--extract> (B<-x>) with B<--verbose> (B<-v>) which prints a "
11314"listing of the files extracted as it goes."
11315msgstr ""
11316
11317#. type: TP
11318#: dpkg-deb.man:1
11319#, no-wrap
11320msgid "B<-R>, B<--raw-extract> I<archive directory>"
11321msgstr ""
11322
11323#. type: Plain text
11324#: dpkg-deb.man:1
11325msgid ""
11326"Extracts the filesystem tree from a package archive into a specified "
11327"directory, and the control information files into a B<DEBIAN> subdirectory "
11328"of the specified directory (since dpkg 1.16.1)."
11329msgstr ""
11330
11331#. type: Plain text
11332#: dpkg-deb.man:1 dpkg-deb.man:1
11333msgid "The target directory (but not its parents) will be created if necessary."
11334msgstr ""
11335
11336#. type: Plain text
11337#: dpkg-deb.man:1
11338msgid ""
11339"The input archive is not (currently) processed sequentially, so reading it "
11340"from standard input («B<->») is B<not> supported."
11341msgstr ""
11342
11343#. type: TP
11344#: dpkg-deb.man:1
11345#, no-wrap
11346msgid "B<--ctrl-tarfile> I<archive>"
11347msgstr ""
11348
11349#. type: Plain text
11350#: dpkg-deb.man:1
11351msgid ""
11352"Extracts the control data from a binary package and sends it to standard "
11353"output in B<tar> format (since dpkg 1.17.14). Together with B<tar>(1) this "
11354"can be used to extract a particular control file from a package archive. "
11355"The input archive will always be processed sequentially."
11356msgstr ""
11357
11358#. type: TP
11359#: dpkg-deb.man:1
11360#, no-wrap
11361msgid "B<--fsys-tarfile> I<archive>"
11362msgstr ""
11363
11364#. type: Plain text
11365#: dpkg-deb.man:1
11366msgid ""
11367"Extracts the filesystem tree data from a binary package and sends it to "
11368"standard output in B<tar> format. Together with B<tar>(1) this can be used "
11369"to extract a particular file from a package archive. The input archive will "
11370"always be processed sequentially."
11371msgstr ""
11372
11373#. type: TP
11374#: dpkg-deb.man:1
11375#, no-wrap
11376msgid "B<-e>, B<--control> I<archive> [I<directory>]"
11377msgstr ""
11378
11379#. type: Plain text
11380#: dpkg-deb.man:1
11381msgid ""
11382"Extracts the control information files from a package archive into the "
11383"specified directory."
11384msgstr ""
11385
11386#. type: Plain text
11387#: dpkg-deb.man:1
11388msgid ""
11389"If no directory is specified then a subdirectory B<DEBIAN> in the current "
11390"directory is used."
11391msgstr ""
11392
11393#. type: TP
11394#: dpkg-deb.man:1
11395#, no-wrap
11396msgid "B<--showformat=>I<format>"
11397msgstr ""
11398
11399#. type: Plain text
11400#: dpkg-deb.man:1 dpkg-query.man:1
11401msgid ""
11402"This option is used to specify the format of the output B<--show> will "
11403"produce. The format is a string that will be output for each package listed."
11404msgstr ""
11405
11406#. type: Plain text
11407#: dpkg-deb.man:1
11408msgid ""
11409"The string may reference any status field using the “${I<field-name>}” form, "
11410"a list of the valid fields can be easily produced using B<-I> on the same "
11411"package. A complete explanation of the formatting options (including escape "
11412"sequences and field tabbing) can be found in the explanation of the "
11413"B<--showformat> option in B<dpkg-query>(1)."
11414msgstr ""
11415
11416#. type: Plain text
11417#: dpkg-deb.man:1
11418msgid "The default for this field is “${Package}\\et${Version}\\en”."
11419msgstr ""
11420
11421#. type: TP
11422#: dpkg-deb.man:1
11423#, no-wrap
11424msgid "B<-z>I<compress-level>"
11425msgstr ""
11426
11427#. type: Plain text
11428#: dpkg-deb.man:1
11429msgid ""
11430"Specify which compression level to use on the compressor backend, when "
11431"building a package (default is 9 for gzip, 6 for xz). The accepted values "
11432"are 0-9 with: 0 being mapped to compressor none for gzip. Before dpkg "
11433"1.16.2 level 0 was equivalent to compressor none for all compressors."
11434msgstr ""
11435
11436#. type: TP
11437#: dpkg-deb.man:1
11438#, no-wrap
11439msgid "B<-S>I<compress-strategy>"
11440msgstr ""
11441
11442#. type: Plain text
11443#: dpkg-deb.man:1
11444msgid ""
11445"Specify which compression strategy to use on the compressor backend, when "
11446"building a package (since dpkg 1.16.2). Allowed values are B<none> (since "
11447"dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> and B<fixed> for gzip (since "
11448"dpkg 1.17.0) and B<extreme> for xz."
11449msgstr ""
11450
11451#. type: TP
11452#: dpkg-deb.man:1
11453#, no-wrap
11454msgid "B<-Z>I<compress-type>"
11455msgstr ""
11456
11457#. type: Plain text
11458#: dpkg-deb.man:1
11459msgid ""
11460"Specify which compression type to use when building a package. Allowed "
11461"values are B<gzip>, B<xz> (since dpkg 1.15.6), and B<none> (default is "
11462"B<xz>)."
11463msgstr ""
11464
11465#. type: TP
11466#: dpkg-deb.man:1
11467#, no-wrap
11468msgid "B<--uniform-compression>"
11469msgstr ""
11470
11471#. type: Plain text
11472#: dpkg-deb.man:1
11473msgid ""
11474"Specify that the same compression parameters should be used for all archive "
11475"members (i.e. B<control.tar> and B<data.tar>; since dpkg 1.17.6). Otherwise "
11476"only the B<data.tar> member will use those parameters. The only supported "
11477"compression types allowed to be uniformly used are B<none>, B<gzip> and "
11478"B<xz>."
11479msgstr ""
11480
11481#. type: TP
11482#: dpkg-deb.man:1
11483#, no-wrap
11484msgid "B<--deb-format=>I<format>"
11485msgstr ""
11486
11487#. type: Plain text
11488#: dpkg-deb.man:1
11489msgid ""
11490"Set the archive format version used when building (since dpkg 1.17.0). "
11491"Allowed values are B<2.0> for the new format, and B<0.939000> for the old "
11492"one (default is B<2.0>)."
11493msgstr ""
11494
11495#. type: Plain text
11496#: dpkg-deb.man:1
11497msgid ""
11498"The old archive format is less easily parsed by non-Debian tools and is now "
11499"obsolete; its only use is when building packages to be parsed by versions of "
11500"dpkg older than 0.93.76 (September 1995), which was released as i386 a.out "
11501"only."
11502msgstr ""
11503
11504#. type: TP
11505#: dpkg-deb.man:1
11506#, no-wrap
11507msgid "B<--nocheck>"
11508msgstr ""
11509
11510#. type: Plain text
11511#: dpkg-deb.man:1
11512msgid ""
11513"Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an "
11514"archive. You can build any archive you want, no matter how broken, this way."
11515msgstr ""
11516
11517#. type: TP
11518#: dpkg-deb.man:1 start-stop-daemon.man:1
11519#, no-wrap
11520msgid "B<-v>, B<--verbose>"
11521msgstr ""
11522
11523#. type: Plain text
11524#: dpkg-deb.man:1
11525msgid ""
11526"Enables verbose output (since dpkg 1.16.1). This currently only affects "
11527"B<--extract> making it behave like B<--vextract>."
11528msgstr ""
11529
11530#. type: TP
11531#: dpkg-deb.man:1
11532#, no-wrap
11533msgid "B<-D>, B<--debug>"
11534msgstr ""
11535
11536#. type: Plain text
11537#: dpkg-deb.man:1
11538msgid "Enables debugging output. This is not very interesting."
11539msgstr ""
11540
11541#. type: Plain text
11542#: dpkg-deb.man:1 dpkg-divert.man:1 dpkg-statoverride.man:1
11543#: update-alternatives.man:1
11544msgid "The requested action was successfully performed."
11545msgstr ""
11546
11547#. type: Plain text
11548#: dpkg-deb.man:1
11549msgid ""
11550"If set, B<dpkg-deb> will use it as the directory in which to create "
11551"temporary files and directories."
11552msgstr ""
11553
11554#. type: Plain text
11555#: dpkg-deb.man:1
11556msgid ""
11557"If set, it will be used as the timestamp (as seconds since the epoch) in the "
11558"B<deb>(5)'s B<ar>(5) container and used to clamp the mtime in the B<tar>(5) "
11559"file entries."
11560msgstr ""
11561
11562#. type: Plain text
11563#: dpkg-deb.man:1
11564msgid ""
11565"Do not attempt to use just B<dpkg-deb> to install software! You must use "
11566"B<dpkg> proper to ensure that all the files are correctly placed and the "
11567"package's scripts run and its status and contents recorded."
11568msgstr ""
11569
11570#. type: Plain text
11571#: dpkg-deb.man:1
11572msgid "B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing."
11573msgstr ""
11574
11575#. type: Plain text
11576#: dpkg-deb.man:1
11577msgid ""
11578"There is no authentication on B<.deb> files; in fact, there isn't even a "
11579"straightforward checksum. (Higher level tools like APT support "
11580"authenticating B<.deb> packages retrieved from a given repository, and most "
11581"packages nowadays provide an md5sum control file generated by "
11582"debian/rules. Though this is not directly supported by the lower level "
11583"tools.)"
11584msgstr ""
11585
11586#. type: Plain text
11587#: dpkg-deb.man:1
11588msgid "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dselect>(1)."
11589msgstr ""
11590
11591#. type: TH
11592#: dpkg-divert.man:1
11593#, no-wrap
11594msgid "dpkg-divert"
11595msgstr ""
11596
11597#. type: Plain text
11598#: dpkg-divert.man:1
11599msgid "dpkg-divert - override a package's version of a file"
11600msgstr ""
11601
11602#. type: Plain text
11603#: dpkg-divert.man:1
11604msgid "B<dpkg-divert> [I<option>...] I<command>"
11605msgstr ""
11606
11607#. type: Plain text
11608#: dpkg-divert.man:1
11609msgid ""
11610"B<dpkg-divert> is the utility used to set up and update the list of "
11611"diversions."
11612msgstr ""
11613
11614#. type: Plain text
11615#: dpkg-divert.man:1
11616msgid ""
11617"File I<diversions> are a way of forcing B<dpkg>(1) not to install a file "
11618"into its location, but to a I<diverted> location. Diversions can be used "
11619"through the Debian package scripts to move a file away when it causes a "
11620"conflict. System administrators can also use it to override some package's "
11621"configuration file, or whenever some files (which aren't marked as "
11622"“conffiles”) need to be preserved by B<dpkg>, when installing a newer "
11623"version of a package which contains those files."
11624msgstr ""
11625
11626#. type: TP
11627#: dpkg-divert.man:1
11628#, no-wrap
11629msgid "[B<--add>] I<file>"
11630msgstr ""
11631
11632#. type: Plain text
11633#: dpkg-divert.man:1
11634msgid "Add a diversion for I<file>."
11635msgstr ""
11636
11637#. type: TP
11638#: dpkg-divert.man:1
11639#, no-wrap
11640msgid "B<--remove>I< file>"
11641msgstr ""
11642
11643#. type: Plain text
11644#: dpkg-divert.man:1
11645msgid "Remove a diversion for I<file>."
11646msgstr ""
11647
11648#. type: TP
11649#: dpkg-divert.man:1
11650#, no-wrap
11651msgid "B<--list>I< glob-pattern>"
11652msgstr ""
11653
11654#. type: Plain text
11655#: dpkg-divert.man:1
11656msgid "List diversions matching I<glob-pattern>."
11657msgstr ""
11658
11659#. type: TP
11660#: dpkg-divert.man:1
11661#, no-wrap
11662msgid "B<--listpackage>I< file>"
11663msgstr ""
11664
11665#. type: Plain text
11666#: dpkg-divert.man:1
11667msgid ""
11668"Print the name of the package that diverts I<file> (since dpkg 1.15.0). "
11669"Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not "
11670"diverted."
11671msgstr ""
11672
11673#. type: TP
11674#: dpkg-divert.man:1
11675#, no-wrap
11676msgid "B<--truename>I< file>"
11677msgstr ""
11678
11679#. type: Plain text
11680#: dpkg-divert.man:1
11681msgid "Print the real name for a diverted file."
11682msgstr ""
11683
11684#. type: TP
11685#: dpkg-divert.man:1 dpkg-statoverride.man:1 dselect.man:1
11686#: update-alternatives.man:1
11687#, no-wrap
11688msgid "B<--admindir>I< directory>"
11689msgstr ""
11690
11691#. type: Plain text
11692#: dpkg-divert.man:1
11693msgid "Set the B<dpkg> data directory to I<directory> (default: I<%ADMINDIR%>)."
11694msgstr ""
11695
11696#. type: TP
11697#: dpkg-divert.man:1
11698#, no-wrap
11699msgid "B<--divert>I< divert-to>"
11700msgstr ""
11701
11702#. type: Plain text
11703#: dpkg-divert.man:1
11704msgid ""
11705"I<divert-to> is the location where the versions of I<file>, as provided by "
11706"other packages, will be diverted."
11707msgstr ""
11708
11709#. type: TP
11710#: dpkg-divert.man:1
11711#, no-wrap
11712msgid "B<--local>"
11713msgstr ""
11714
11715#. type: Plain text
11716#: dpkg-divert.man:1
11717msgid ""
11718"Specifies that all packages' versions of this file are diverted. This "
11719"means, that there are no exceptions, and whatever package is installed, the "
11720"file is diverted. This can be used by an admin to install a locally modified "
11721"version."
11722msgstr ""
11723
11724#. type: TP
11725#: dpkg-divert.man:1
11726#, no-wrap
11727msgid "B<--package>I< package>"
11728msgstr ""
11729
11730#. type: Plain text
11731#: dpkg-divert.man:1
11732msgid ""
11733"I<package> is the name of a package whose copy of I<file> will not be "
11734"diverted. i.e. I<file> will be diverted for all packages except I<package>."
11735msgstr ""
11736
11737#. type: TP
11738#: dpkg-divert.man:1 dpkg-statoverride.man:1 update-alternatives.man:1
11739#, no-wrap
11740msgid "B<--quiet>"
11741msgstr ""
11742
11743#. type: Plain text
11744#: dpkg-divert.man:1
11745msgid "Quiet mode, i.e. no verbose output."
11746msgstr ""
11747
11748#. type: TP
11749#: dpkg-divert.man:1
11750#, no-wrap
11751msgid "B<--rename>"
11752msgstr ""
11753
11754#. type: Plain text
11755#: dpkg-divert.man:1
11756msgid ""
11757"Actually move the file aside (or back). B<dpkg-divert> will abort operation "
11758"in case the destination file already exists."
11759msgstr ""
11760
11761#. type: TP
11762#: dpkg-divert.man:1
11763#, no-wrap
11764msgid "B<--test>"
11765msgstr ""
11766
11767#. type: Plain text
11768#: dpkg-divert.man:1
11769msgid "Test mode, i.e. don't actually perform any changes, just demonstrate."
11770msgstr ""
11771
11772#. type: Plain text
11773#: dpkg-divert.man:1 dpkg-query.man:1 dpkg-statoverride.man:1
11774#: dpkg-trigger.man:1
11775msgid ""
11776"If set and the B<--admindir> option has not been specified, it will be used "
11777"as the B<dpkg> data directory."
11778msgstr ""
11779
11780#. type: Plain text
11781#: dpkg-divert.man:1
11782msgid ""
11783"If set and the B<--local> and B<--package> options have not been specified, "
11784"B<dpkg-divert> will use it as the package name."
11785msgstr ""
11786
11787#. type: TP
11788#: dpkg-divert.man:1
11789#, no-wrap
11790msgid "I<%ADMINDIR%/diversions>"
11791msgstr ""
11792
11793#. type: Plain text
11794#: dpkg-divert.man:1
11795msgid ""
11796"File which contains the current list of diversions of the system. It is "
11797"located in the B<dpkg> administration directory, along with other files "
11798"important to B<dpkg>, such as I<status> or I<available>."
11799msgstr ""
11800
11801#. type: Plain text
11802#: dpkg-divert.man:1
11803msgid ""
11804"Note: B<dpkg-divert> preserves the old copy of this file, with extension "
11805"I<-old>, before replacing it with the new one."
11806msgstr ""
11807
11808#. type: Plain text
11809#: dpkg-divert.man:1
11810msgid ""
11811"When adding, default is B<--local> and B<--divert> "
11812"I<original>B<.distrib>. When removing, B<--package> or B<--local> and "
11813"B<--divert> must match if specified."
11814msgstr ""
11815
11816#. type: Plain text
11817#: dpkg-divert.man:1
11818msgid "Directories can't be diverted with B<dpkg-divert>."
11819msgstr ""
11820
11821#. type: Plain text
11822#: dpkg-divert.man:1
11823msgid ""
11824"Care should be taken when diverting shared libraries, B<ldconfig>(8) "
11825"creates a symbolic link based on the DT_SONAME field embedded in the "
11826"library. Because B<ldconfig> doesn't honour diverts (only B<dpkg> does), "
11827"the symlink may end up pointing at the diverted library, if a diverted "
11828"library has the same SONAME as the undiverted one."
11829msgstr ""
11830
11831#. type: Plain text
11832#: dpkg-divert.man:1
11833msgid ""
11834"To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, "
11835"i.e. directs all packages providing I</usr/bin/example> to install it as "
11836"I</usr/bin/example.foo>, performing the rename if required:"
11837msgstr ""
11838
11839#. type: Plain text
11840#: dpkg-divert.man:1
11841msgid "dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example"
11842msgstr ""
11843
11844#. type: Plain text
11845#: dpkg-divert.man:1 dpkg-divert.man:1
11846msgid "To remove that diversion:"
11847msgstr ""
11848
11849#. type: Plain text
11850#: dpkg-divert.man:1
11851msgid "dpkg-divert --rename --remove /usr/bin/example"
11852msgstr ""
11853
11854#. type: Plain text
11855#: dpkg-divert.man:1
11856msgid ""
11857"To divert any package trying to install I</usr/bin/example> to "
11858"I</usr/bin/example.foo>, except your own I<wibble> package:"
11859msgstr ""
11860
11861#. type: Plain text
11862#: dpkg-divert.man:1
11863msgid ""
11864"dpkg-divert --package wibble --divert /usr/bin/example.foo --rename "
11865"/usr/bin/example"
11866msgstr ""
11867
11868#. type: Plain text
11869#: dpkg-divert.man:1
11870msgid "dpkg-divert --package wibble --rename --remove /usr/bin/example"
11871msgstr ""
11872
11873#. type: TH
11874#: dpkg-genchanges.man:1
11875#, no-wrap
11876msgid "dpkg-genchanges"
11877msgstr ""
11878
11879#. type: Plain text
11880#: dpkg-genchanges.man:1
11881msgid "dpkg-genchanges - generate Debian .changes files"
11882msgstr ""
11883
11884#. type: Plain text
11885#: dpkg-genchanges.man:1
11886msgid "B<dpkg-genchanges> [I<option>...]"
11887msgstr ""
11888
11889#. type: Plain text
11890#: dpkg-genchanges.man:1
11891msgid ""
11892"B<dpkg-genchanges> reads information from an unpacked and built Debian "
11893"source tree and from the files it has generated and generates a Debian "
11894"upload control file (B<.changes> file)."
11895msgstr ""
11896
11897#. type: Plain text
11898#: dpkg-genchanges.man:1
11899msgid ""
11900"Specifies the build I<type> from a comma-separated list of components (since "
11901"dpkg 1.18.5)."
11902msgstr ""
11903
11904#. type: Plain text
11905#: dpkg-genchanges.man:1
11906msgid "Upload the source package."
11907msgstr ""
11908
11909#. type: Plain text
11910#: dpkg-genchanges.man:1
11911msgid "Upload the architecture specific binary packages."
11912msgstr ""
11913
11914#. type: Plain text
11915#: dpkg-genchanges.man:1
11916msgid "Upload the architecture independent binary packages."
11917msgstr ""
11918
11919#. type: Plain text
11920#: dpkg-genchanges.man:1
11921msgid ""
11922"Upload the architecture specific and independent binary packages. This is "
11923"an alias for B<any,all>."
11924msgstr ""
11925
11926#. type: Plain text
11927#: dpkg-genchanges.man:1
11928msgid ""
11929"Upload everything. This is alias for B<source,any,all>, and the same as the "
11930"default case when no build option is specified."
11931msgstr ""
11932
11933#. type: Plain text
11934#: dpkg-genchanges.man:1
11935msgid ""
11936"The B<-s>I<x> options control whether the original source archive is "
11937"included in the upload if any source is being generated (i.e. B<-b> or "
11938"B<-B> haven't been used)."
11939msgstr ""
11940
11941#. type: Plain text
11942#: dpkg-genchanges.man:1
11943msgid ""
11944"By default, or if specified, the original source will be included only if "
11945"the upstream version number (the version without epoch and without Debian "
11946"revision) differs from the upstream version number of the previous changelog "
11947"entry."
11948msgstr ""
11949
11950#. type: Plain text
11951#: dpkg-genchanges.man:1
11952msgid "Forces the inclusion of the original source."
11953msgstr ""
11954
11955#. type: Plain text
11956#: dpkg-genchanges.man:1
11957msgid "Forces the exclusion of the original source and includes only the diff."
11958msgstr ""
11959
11960#. type: Plain text
11961#: dpkg-genchanges.man:1
11962msgid ""
11963"Causes changelog information from all versions strictly later than "
11964"I<version> to be used."
11965msgstr ""
11966
11967#. type: Plain text
11968#: dpkg-genchanges.man:1
11969msgid ""
11970"Read the description of the changes from the file I<changes-description> "
11971"rather than using the information from the source tree's changelog file."
11972msgstr ""
11973
11974#. type: TP
11975#: dpkg-genchanges.man:1
11976#, no-wrap
11977msgid "B<-m>I<maintainer-address>"
11978msgstr ""
11979
11980#. type: Plain text
11981#: dpkg-genchanges.man:1
11982msgid ""
11983"Use I<maintainer-address> as the name and email address of the maintainer "
11984"for this package, rather than using the information from the source tree's "
11985"control file."
11986msgstr ""
11987
11988#. type: TP
11989#: dpkg-genchanges.man:1
11990#, no-wrap
11991msgid "B<-e>I<maintainer-address>"
11992msgstr ""
11993
11994#. type: Plain text
11995#: dpkg-genchanges.man:1
11996msgid ""
11997"Use I<maintainer-address> as the name and email address of the maintainer "
11998"for this upload, rather than using the information from the source tree's "
11999"changelog."
12000msgstr ""
12001
12002#. type: TP
12003#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
12004#, no-wrap
12005msgid "B<-V>I<name>B<=>I<value>"
12006msgstr ""
12007
12008#. type: Plain text
12009#: dpkg-genchanges.man:1 dpkg-source.man:1
12010msgid ""
12011"Set an output substitution variable. See B<deb-substvars>(5) for a "
12012"discussion of output substitution."
12013msgstr ""
12014
12015#. type: TP
12016#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-shlibdeps.man:1
12017#: dpkg-source.man:1
12018#, no-wrap
12019msgid "B<-T>I<substvars-file>"
12020msgstr ""
12021
12022#. type: Plain text
12023#: dpkg-genchanges.man:1
12024msgid ""
12025"Read substitution variables in I<substvars-file>; the default is "
12026"B<debian/substvars>. No variable substitution is done on any of the fields "
12027"that are output, however the special variable I<Format> will override the "
12028"field of the same name. This option can be used multiple times to read "
12029"substitution variables from multiple files (since dpkg 1.15.6)."
12030msgstr ""
12031
12032#. type: TP
12033#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
12034#, no-wrap
12035msgid "B<-D>I<field>B<=>I<value>"
12036msgstr ""
12037
12038#. type: Plain text
12039#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
12040msgid "Override or add an output control file field."
12041msgstr ""
12042
12043#. type: TP
12044#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
12045#, no-wrap
12046msgid "B<-U>I<field>"
12047msgstr ""
12048
12049#. type: Plain text
12050#: dpkg-genchanges.man:1 dpkg-gencontrol.man:1 dpkg-source.man:1
12051msgid "Remove an output control file field."
12052msgstr ""
12053
12054#. type: Plain text
12055#: dpkg-genchanges.man:1
12056msgid ""
12057"Read the list of files to be uploaded here, rather than using "
12058"B<debian/files>."
12059msgstr ""
12060
12061#. type: Plain text
12062#: dpkg-genchanges.man:1
12063msgid ""
12064"Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
12065"(B<dpkg-genchanges> needs to find these files so that it can include their "
12066"sizes and checksums in the B<.changes> file)."
12067msgstr ""
12068
12069#. type: Plain text
12070#: dpkg-genchanges.man:1
12071msgid ""
12072"Usually B<dpkg-genchanges> will produce informative messages on standard "
12073"error, for example about how many of the package's source files are being "
12074"uploaded. B<-q> suppresses these messages."
12075msgstr ""
12076
12077#. type: Plain text
12078#: dpkg-genchanges.man:1
12079msgid ""
12080"Print the changes file to standard output (the default) or to I<filename> if "
12081"specified (since dpkg 1.18.5)."
12082msgstr ""
12083
12084#. type: Plain text
12085#: dpkg-genchanges.man:1
12086msgid ""
12087"The list of generated files which are part of the upload being prepared. "
12088"B<dpkg-genchanges> reads the data here when producing a B<.changes> file."
12089msgstr ""
12090
12091#. type: Plain text
12092#: dpkg-genchanges.man:1
12093msgid ""
12094"B<deb-substvars>(5), B<deb-src-control>(5), B<deb-src-files>(5), "
12095"B<deb-changelog>(5), B<deb-changes>(5)."
12096msgstr ""
12097
12098#. type: TH
12099#: dpkg-gencontrol.man:1
12100#, no-wrap
12101msgid "dpkg-gencontrol"
12102msgstr ""
12103
12104#. type: Plain text
12105#: dpkg-gencontrol.man:1
12106msgid "dpkg-gencontrol - generate Debian control files"
12107msgstr ""
12108
12109#. type: Plain text
12110#: dpkg-gencontrol.man:1
12111msgid "B<dpkg-gencontrol> [I<option>...]"
12112msgstr ""
12113
12114#. type: Plain text
12115#: dpkg-gencontrol.man:1
12116msgid ""
12117"B<dpkg-gencontrol> reads information from an unpacked Debian source tree and "
12118"generates a binary package control file (which defaults to "
12119"debian/tmp/DEBIAN/control); during this process it will simplify the "
12120"relation fields."
12121msgstr ""
12122
12123#. type: Plain text
12124#: dpkg-gencontrol.man:1
12125msgid ""
12126"Thus B<Pre-Depends>, B<Depends>, B<Recommends> and B<Suggests> are "
12127"simplified in this order by removing dependencies which are known to be true "
12128"according to the stronger dependencies already parsed. It will also remove "
12129"any self-dependency (in fact it will remove any dependency which evaluates "
12130"to true given the current version of the package as installed). Logically it "
12131"keeps the intersection of multiple dependencies on the same package. The "
12132"order of dependencies is preserved as best as possible: if any dependency "
12133"must be discarded due to another dependency appearing further in the field, "
12134"the superseding dependency will take the place of the discarded one."
12135msgstr ""
12136
12137#. type: Plain text
12138#: dpkg-gencontrol.man:1
12139msgid ""
12140"The other relation fields (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> "
12141"and B<Provides>) are also simplified individually by computing the union of "
12142"the various dependencies when a package is listed multiple times in the "
12143"field."
12144msgstr ""
12145
12146#. type: Plain text
12147#: dpkg-gencontrol.man:1
12148msgid ""
12149"B<dpkg-gencontrol> also adds an entry for the binary package to "
12150"B<debian/files>."
12151msgstr ""
12152
12153#. type: Plain text
12154#: dpkg-gencontrol.man:1
12155msgid "Sets the version number of the binary package which will be generated."
12156msgstr ""
12157
12158#. type: Plain text
12159#: dpkg-gencontrol.man:1
12160msgid ""
12161"Set an output substitution variable. See B<deb-substvars>(5) for discussion "
12162"of output substitution."
12163msgstr ""
12164
12165#. type: Plain text
12166#: dpkg-gencontrol.man:1
12167msgid ""
12168"Read substitution variables in I<substvars-file>; the default is "
12169"B<debian/substvars>. This option can be used multiple times to read "
12170"substitution variables from multiple files (since dpkg 1.15.6)."
12171msgstr ""
12172
12173#. type: TP
12174#: dpkg-gencontrol.man:1 dpkg-source.man:1
12175#, no-wrap
12176msgid "B<-c>I<control-file>"
12177msgstr ""
12178
12179#. type: TP
12180#: dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
12181#, no-wrap
12182msgid "B<-p>I<package>"
12183msgstr ""
12184
12185#. type: Plain text
12186#: dpkg-gencontrol.man:1
12187msgid ""
12188"Generate information for the binary package I<package>. If the source "
12189"control file lists only one binary package then this option may be omitted; "
12190"otherwise it is essential to select which binary package's information to "
12191"generate."
12192msgstr ""
12193
12194#. type: TP
12195#: dpkg-gencontrol.man:1
12196#, no-wrap
12197msgid "B<-n>I<filename>"
12198msgstr ""
12199
12200#. type: Plain text
12201#: dpkg-gencontrol.man:1
12202msgid ""
12203"Assume the filename of the package will be I<filename> instead of the normal "
12204"package_version_arch.deb filename."
12205msgstr ""
12206
12207#. type: TP
12208#: dpkg-gencontrol.man:1
12209#, no-wrap
12210msgid "B<-is>, B<-ip>, B<-isp>"
12211msgstr ""
12212
12213#. type: Plain text
12214#: dpkg-gencontrol.man:1
12215msgid ""
12216"These options are ignored for compatibility with older versions of the dpkg "
12217"build scripts but are now deprecated. Previously they were used to tell "
12218"B<dpkg-gencontrol> to include the Section and Priority fields in the control "
12219"file. This is now the default behaviour. If you want to get the old "
12220"behaviour you can use the B<-U> option to delete the fields from the control "
12221"file."
12222msgstr ""
12223
12224#. type: TP
12225#: dpkg-gencontrol.man:1 dpkg-gensymbols.man:1
12226#, no-wrap
12227msgid "B<-P>I<package-build-dir>"
12228msgstr ""
12229
12230#. type: Plain text
12231#: dpkg-gencontrol.man:1
12232msgid ""
12233"Tells B<dpkg-source> that the package is being built in I<package-build-dir> "
12234"instead of B<debian/tmp>. This value is used to find the default value of "
12235"the B<Installed-Size> substitution variable and control file field (using "
12236"B<du>), and for the default location of the output file."
12237msgstr ""
12238
12239#. type: Plain text
12240#: dpkg-gencontrol.man:1
12241msgid ""
12242"Print the control file to standard output (or I<filename> if specified, "
12243"since dpkg 1.17.2), rather than to B<debian/tmp/DEBIAN/control> (or "
12244"I<package-build-dir>B</DEBIAN/control> if B<-P> was used)."
12245msgstr ""
12246
12247#. type: TP
12248#: dpkg-gencontrol.man:1
12249#, no-wrap
12250msgid "B<debian/control>"
12251msgstr ""
12252
12253#. type: Plain text
12254#: dpkg-gencontrol.man:1
12255msgid ""
12256"The main source control information file, giving version-independent "
12257"information about the source package and the binary packages it can produce."
12258msgstr ""
12259
12260#. type: Plain text
12261#: dpkg-gencontrol.man:1
12262msgid ""
12263"The list of generated files which are part of the upload being prepared. "
12264"B<dpkg-gencontrol> adds the presumed filenames of binary packages whose "
12265"control files it generates here."
12266msgstr ""
12267
12268#. type: Plain text
12269#: dpkg-gencontrol.man:1
12270msgid ""
12271"B<deb-substvars>(5), B<deb-src-control>(5), B<deb-changelog>(5), "
12272"B<deb-control>(5)."
12273msgstr ""
12274
12275#. type: TH
12276#: dpkg-gensymbols.man:1
12277#, no-wrap
12278msgid "dpkg-gensymbols"
12279msgstr ""
12280
12281#. type: Plain text
12282#: dpkg-gensymbols.man:1
12283msgid ""
12284"dpkg-gensymbols - generate symbols files (shared library dependency "
12285"information)"
12286msgstr ""
12287
12288#. type: Plain text
12289#: dpkg-gensymbols.man:1
12290msgid "B<dpkg-gensymbols> [I<option>...]"
12291msgstr ""
12292
12293#. type: Plain text
12294#: dpkg-gensymbols.man:1
12295msgid ""
12296"B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) "
12297"looking for libraries and generates a I<symbols> file describing them. This "
12298"file, if non-empty, is then installed in the DEBIAN subdirectory of the "
12299"build tree so that it ends up included in the control information of the "
12300"package."
12301msgstr ""
12302
12303#. type: Plain text
12304#: dpkg-gensymbols.man:1
12305msgid ""
12306"When generating those files, it uses as input some symbols files provided by "
12307"the maintainer. It looks for the following files (and uses the first that is "
12308"found):"
12309msgstr ""
12310
12311#. type: Plain text
12312#: dpkg-gensymbols.man:1
12313msgid "debian/I<package>.symbols.I<arch>"
12314msgstr ""
12315
12316#. type: Plain text
12317#: dpkg-gensymbols.man:1
12318msgid "debian/symbols.I<arch>"
12319msgstr ""
12320
12321#. type: Plain text
12322#: dpkg-gensymbols.man:1
12323msgid "debian/I<package>.symbols"
12324msgstr ""
12325
12326#. type: Plain text
12327#: dpkg-gensymbols.man:1
12328msgid "debian/symbols"
12329msgstr ""
12330
12331#. type: Plain text
12332#: dpkg-gensymbols.man:1
12333msgid ""
12334"The main interest of those files is to provide the minimal version "
12335"associated to each symbol provided by the libraries. Usually it corresponds "
12336"to the first version of that package that provided the symbol, but it can be "
12337"manually incremented by the maintainer if the ABI of the symbol is extended "
12338"without breaking backwards compatibility. It's the responsibility of the "
12339"maintainer to keep those files up-to-date and accurate, but "
12340"B<dpkg-gensymbols> helps with that."
12341msgstr ""
12342
12343#. type: Plain text
12344#: dpkg-gensymbols.man:1
12345msgid ""
12346"When the generated symbols files differ from the maintainer supplied one, "
12347"B<dpkg-gensymbols> will print a diff between the two versions. Furthermore "
12348"if the difference is too significant, it will even fail (you can customize "
12349"how much difference you can tolerate, see the B<-c> option)."
12350msgstr ""
12351
12352#. type: SH
12353#: dpkg-gensymbols.man:1
12354#, no-wrap
12355msgid "MAINTAINING SYMBOLS FILES"
12356msgstr ""
12357
12358#. type: Plain text
12359#: dpkg-gensymbols.man:1
12360msgid ""
12361"The symbols files are really useful only if they reflect the evolution of "
12362"the package through several releases. Thus the maintainer has to update them "
12363"every time that a new symbol is added so that its associated minimal version "
12364"matches reality. The diffs contained in the build logs can be used as a "
12365"starting point, but the maintainer, additionally, has to make sure that the "
12366"behaviour of those symbols has not changed in a way that would make anything "
12367"using those symbols and linking against the new version, stop working with "
12368"the old version. In most cases, the diff applies directly to the "
12369"debian/I<package>.symbols file. That said, further tweaks are usually "
12370"needed: it's recommended for example to drop the Debian revision from the "
12371"minimal version so that backports with a lower version number but the same "
12372"upstream version still satisfy the generated dependencies. If the Debian "
12373"revision can't be dropped because the symbol really got added by the Debian "
12374"specific change, then one should suffix the version with ‘B<~>’."
12375msgstr ""
12376
12377#. type: Plain text
12378#: dpkg-gensymbols.man:1
12379msgid ""
12380"Before applying any patch to the symbols file, the maintainer should "
12381"double-check that it's sane. Public symbols are not supposed to disappear, "
12382"so the patch should ideally only add new lines."
12383msgstr ""
12384
12385#. type: Plain text
12386#: dpkg-gensymbols.man:1
12387msgid ""
12388"Note that you can put comments in symbols files: any line with ‘#’ as the "
12389"first character is a comment except if it starts with ‘#include’ (see "
12390"section B<Using includes>). Lines starting with ‘#MISSING:’ are special "
12391"comments documenting symbols that have disappeared."
12392msgstr ""
12393
12394#. type: Plain text
12395#: dpkg-gensymbols.man:1
12396msgid ""
12397"Do not forget to check if old symbol versions need to be increased. There "
12398"is no way B<dpkg-gensymbols> can warn about this. Blindly applying the diff "
12399"or assuming there is nothing to change if there is no diff, without checking "
12400"for such changes, can lead to packages with loose dependencies that claim "
12401"they can work with older packages they cannot work with. This will introduce "
12402"hard to find bugs with (partial) upgrades."
12403msgstr ""
12404
12405#. type: SS
12406#: dpkg-gensymbols.man:1
12407#, no-wrap
12408msgid "Using #PACKAGE# substitution"
12409msgstr ""
12410
12411#. type: Plain text
12412#: dpkg-gensymbols.man:1
12413msgid ""
12414"In some rare cases, the name of the library varies between architectures. "
12415"To avoid hardcoding the name of the package in the symbols file, you can use "
12416"the marker I<#PACKAGE#>. It will be replaced by the real package name during "
12417"installation of the symbols files. Contrary to the I<#MINVER#> marker, "
12418"I<#PACKAGE#> will never appear in a symbols file inside a binary package."
12419msgstr ""
12420
12421#. type: SS
12422#: dpkg-gensymbols.man:1
12423#, no-wrap
12424msgid "Using symbol tags"
12425msgstr ""
12426
12427#. type: Plain text
12428#: dpkg-gensymbols.man:1
12429msgid ""
12430"Symbol tagging is useful for marking symbols that are special in some way. "
12431"Any symbol can have an arbitrary number of tags associated with it. While "
12432"all tags are parsed and stored, only some of them are understood by "
12433"B<dpkg-gensymbols> and trigger special handling of the symbols. See "
12434"subsection B<Standard symbol tags> for reference of these tags."
12435msgstr ""
12436
12437#. type: Plain text
12438#: dpkg-gensymbols.man:1
12439msgid ""
12440"Tag specification comes right before the symbol name (no whitespace is "
12441"allowed in between). It always starts with an opening bracket B<(>, ends "
12442"with a closing bracket B<)> and must contain at least one tag. Multiple tags "
12443"are separated by the B<|> character. Each tag can optionally have a value "
12444"which is separated form the tag name by the B<=> character. Tag names and "
12445"values can be arbitrary strings except they cannot contain any of the "
12446"special B<)> B<|> B<=> characters. Symbol names following a tag "
12447"specification can optionally be quoted with either B<'> or B<\"> characters "
12448"to allow whitespaces in them. However, if there are no tags specified for "
12449"the symbol, quotes are treated as part of the symbol name which continues up "
12450"until the first space."
12451msgstr ""
12452
12453#. type: Plain text
12454#: dpkg-gensymbols.man:1
12455#, no-wrap
12456msgid ""
12457" (tag1=i am marked|tag name with space)\"tagged quoted symbol\"@Base 1.0\n"
12458" (optional)tagged_unquoted_symbol@Base 1.0 1\n"
12459" untagged_symbol@Base 1.0\n"
12460msgstr ""
12461
12462#. type: Plain text
12463#: dpkg-gensymbols.man:1
12464msgid ""
12465"The first symbol in the example is named I<tagged quoted symbol> and has two "
12466"tags: I<tag1> with value I<i am marked> and I<tag name with space> that has "
12467"no value. The second symbol named I<tagged_unquoted_symbol> is only tagged "
12468"with the tag named I<optional>. The last symbol is an example of the normal "
12469"untagged symbol."
12470msgstr ""
12471
12472#. type: Plain text
12473#: dpkg-gensymbols.man:1
12474msgid ""
12475"Since symbol tags are an extension of the B<deb-symbols>(5) format, they can "
12476"only be part of the symbols files used in source packages (those files "
12477"should then be seen as templates used to build the symbols files that are "
12478"embedded in binary packages). When B<dpkg-gensymbols> is called without the "
12479"B<-t> option, it will output symbols files compatible to the "
12480"B<deb-symbols>(5) format: it fully processes symbols according to the "
12481"requirements of their standard tags and strips all tags from the output. On "
12482"the contrary, in template mode (B<-t>) all symbols and their tags (both "
12483"standard and unknown ones) are kept in the output and are written in their "
12484"original form as they were loaded."
12485msgstr ""
12486
12487#. type: SS
12488#: dpkg-gensymbols.man:1
12489#, no-wrap
12490msgid "Standard symbol tags"
12491msgstr ""
12492
12493#. type: TP
12494#: dpkg-gensymbols.man:1
12495#, no-wrap
12496msgid "B<optional>"
12497msgstr ""
12498
12499#. type: Plain text
12500#: dpkg-gensymbols.man:1
12501msgid ""
12502"A symbol marked as optional can disappear from the library at any time and "
12503"that will never cause B<dpkg-gensymbols> to fail. However, disappeared "
12504"optional symbols will continuously appear as MISSING in the diff in each new "
12505"package revision. This behaviour serves as a reminder for the maintainer "
12506"that such a symbol needs to be removed from the symbol file or readded to "
12507"the library. When the optional symbol, which was previously declared as "
12508"MISSING, suddenly reappears in the next revision, it will be upgraded back "
12509"to the “existing” status with its minimum version unchanged."
12510msgstr ""
12511
12512#. type: Plain text
12513#: dpkg-gensymbols.man:1
12514msgid ""
12515"This tag is useful for symbols which are private where their disappearance "
12516"do not cause ABI breakage. For example, most of C++ template instantiations "
12517"fall into this category. Like any other tag, this one may also have an "
12518"arbitrary value: it could be used to indicate why the symbol is considered "
12519"optional."
12520msgstr ""
12521
12522#. type: TP
12523#: dpkg-gensymbols.man:1
12524#, no-wrap
12525msgid "B<arch=>I<architecture-list>"
12526msgstr ""
12527
12528#. type: TQ
12529#: dpkg-gensymbols.man:1
12530#, no-wrap
12531msgid "B<arch-bits=>I<architecture-bits>"
12532msgstr ""
12533
12534#. type: TQ
12535#: dpkg-gensymbols.man:1
12536#, no-wrap
12537msgid "B<arch-endian=>I<architecture-endianness>"
12538msgstr ""
12539
12540#. type: Plain text
12541#: dpkg-gensymbols.man:1
12542msgid ""
12543"These tags allow one to restrict the set of architectures where the symbol "
12544"is supposed to exist. The B<arch-bits> and B<arch-endian> tags are supported "
12545"since dpkg 1.18.0. When the symbols list is updated with the symbols "
12546"discovered in the library, all arch-specific symbols which do not concern "
12547"the current host architecture are treated as if they did not exist. If an "
12548"arch-specific symbol matching the current host architecture does not exist "
12549"in the library, normal procedures for missing symbols apply and it may cause "
12550"B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol "
12551"is found when it was not supposed to exist (because the current host "
12552"architecture is not listed in the tag or does not match the endianness and "
12553"bits), it is made arch neutral (i.e. the arch, arch-bits and arch-endian "
12554"tags are dropped and the symbol will appear in the diff due to this change), "
12555"but it is not considered as new."
12556msgstr ""
12557
12558#. type: Plain text
12559#: dpkg-gensymbols.man:1
12560msgid ""
12561"When operating in the default non-template mode, among arch-specific symbols "
12562"only those that match the current host architecture are written to the "
12563"symbols file. On the contrary, all arch-specific symbols (including those "
12564"from foreign arches) are always written to the symbol file when operating in "
12565"template mode."
12566msgstr ""
12567
12568#. type: Plain text
12569#: dpkg-gensymbols.man:1
12570msgid ""
12571"The format of I<architecture-list> is the same as the one used in the "
12572"B<Build-Depends> field of I<debian/control> (except the enclosing square "
12573"brackets []). For example, the first symbol from the list below will be "
12574"considered only on alpha, any-amd64 and ia64 architectures, the second only "
12575"on linux architectures, while the third one anywhere except on armel."
12576msgstr ""
12577
12578#. type: Plain text
12579#: dpkg-gensymbols.man:1
12580#, no-wrap
12581msgid ""
12582" (arch=alpha any-amd64 ia64)64bit_specific_symbol@Base 1.0\n"
12583" (arch=linux-any)linux_specific_symbol@Base 1.0\n"
12584" (arch=!armel)symbol_armel_does_not_have@Base 1.0\n"
12585msgstr ""
12586
12587#. type: Plain text
12588#: dpkg-gensymbols.man:1
12589msgid "The I<architecture-bits> is either B<32> or B<64>."
12590msgstr ""
12591
12592#. type: Plain text
12593#: dpkg-gensymbols.man:1
12594#, no-wrap
12595msgid ""
12596" (arch-bits=32)32bit_specific_symbol@Base 1.0\n"
12597" (arch-bits=64)64bit_specific_symbol@Base 1.0\n"
12598msgstr ""
12599
12600#. type: Plain text
12601#: dpkg-gensymbols.man:1
12602msgid "The I<architecture-endianness> is either B<little> or B<big>."
12603msgstr ""
12604
12605#. type: Plain text
12606#: dpkg-gensymbols.man:1
12607#, no-wrap
12608msgid ""
12609" (arch-endian=little)little_endian_specific_symbol@Base 1.0\n"
12610" (arch-endian=big)big_endian_specific_symbol@Base 1.0\n"
12611msgstr ""
12612
12613#. type: Plain text
12614#: dpkg-gensymbols.man:1
12615msgid "Multiple restrictions can be chained."
12616msgstr ""
12617
12618#. type: Plain text
12619#: dpkg-gensymbols.man:1
12620#, no-wrap
12621msgid " (arch-bits=32|arch-endian=little)32bit_le_symbol@Base 1.0\n"
12622msgstr ""
12623
12624#. type: TP
12625#: dpkg-gensymbols.man:1
12626#, no-wrap
12627msgid "B<ignore-blacklist>"
12628msgstr ""
12629
12630#. type: Plain text
12631#: dpkg-gensymbols.man:1
12632msgid ""
12633"dpkg-gensymbols has an internal blacklist of symbols that should not appear "
12634"in symbols files as they are usually only side-effects of implementation "
12635"details of the toolchain. If for some reason, you really want one of those "
12636"symbols to be included in the symbols file, you should tag the symbol with "
12637"B<ignore-blacklist>. It can be necessary for some low level toolchain "
12638"libraries like libgcc."
12639msgstr ""
12640
12641#. type: TP
12642#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
12643#, no-wrap
12644msgid "B<c++>"
12645msgstr ""
12646
12647#. type: Plain text
12648#: dpkg-gensymbols.man:1
12649msgid ""
12650"Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection "
12651"below."
12652msgstr ""
12653
12654#. type: TP
12655#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
12656#, no-wrap
12657msgid "B<symver>"
12658msgstr ""
12659
12660#. type: Plain text
12661#: dpkg-gensymbols.man:1
12662msgid ""
12663"Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol "
12664"patterns> subsection below."
12665msgstr ""
12666
12667#. type: TP
12668#: dpkg-gensymbols.man:1 dpkg-gensymbols.man:1
12669#, no-wrap
12670msgid "B<regex>"
12671msgstr ""
12672
12673#. type: Plain text
12674#: dpkg-gensymbols.man:1
12675msgid ""
12676"Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection "
12677"below."
12678msgstr ""
12679
12680#. type: SS
12681#: dpkg-gensymbols.man:1
12682#, no-wrap
12683msgid "Using symbol patterns"
12684msgstr ""
12685
12686#. type: Plain text
12687#: dpkg-gensymbols.man:1
12688msgid ""
12689"Unlike a standard symbol specification, a pattern may cover multiple real "
12690"symbols from the library. B<dpkg-gensymbols> will attempt to match each "
12691"pattern against each real symbol that does I<not> have a specific symbol "
12692"counterpart defined in the symbol file. Whenever the first matching pattern "
12693"is found, all its tags and properties will be used as a basis specification "
12694"of the symbol. If none of the patterns matches, the symbol will be "
12695"considered as new."
12696msgstr ""
12697
12698#. type: Plain text
12699#: dpkg-gensymbols.man:1
12700msgid ""
12701"A pattern is considered lost if it does not match any symbol in the "
12702"library. By default this will trigger a B<dpkg-gensymbols> failure under "
12703"B<-c1> or higher level. However, if the failure is undesired, the pattern "
12704"may be marked with the I<optional> tag. Then if the pattern does not match "
12705"anything, it will only appear in the diff as MISSING. Moreover, like any "
12706"symbol, the pattern may be limited to the specific architectures with the "
12707"I<arch> tag. Please refer to B<Standard symbol tags> subsection above for "
12708"more information."
12709msgstr ""
12710
12711#. type: Plain text
12712#: dpkg-gensymbols.man:1
12713msgid ""
12714"Patterns are an extension of the B<deb-symbols>(5) format hence they are "
12715"only valid in symbol file templates. Pattern specification syntax is not any "
12716"different from the one of a specific symbol. However, symbol name part of "
12717"the specification serves as an expression to be matched against "
12718"I<name@version> of the real symbol. In order to distinguish among different "
12719"pattern types, a pattern will typically be tagged with a special tag."
12720msgstr ""
12721
12722#. type: Plain text
12723#: dpkg-gensymbols.man:1
12724msgid "At the moment, B<dpkg-gensymbols> supports three basic pattern types:"
12725msgstr ""
12726
12727#. type: Plain text
12728#: dpkg-gensymbols.man:1
12729msgid ""
12730"This pattern is denoted by the I<c++> tag. It matches only C++ symbols by "
12731"their demangled symbol name (as emitted by B<c++filt>(1) utility). This "
12732"pattern is very handy for matching symbols which mangled names might vary "
12733"across different architectures while their demangled names remain the "
12734"same. One group of such symbols is I<non-virtual thunks> which have "
12735"architecture specific offsets embedded in their mangled names. A common "
12736"instance of this case is a virtual destructor which under diamond "
12737"inheritance needs a non-virtual thunk symbol. For example, even if "
12738"_ZThn8_N3NSB6ClassDD1Ev@Base on 32bit architectures will probably be "
12739"_ZThn16_N3NSB6ClassDD1Ev@Base on 64bit ones, it can be matched with a single "
12740"I<c++> pattern:"
12741msgstr ""
12742
12743#. type: Plain text
12744#: dpkg-gensymbols.man:1
12745#, no-wrap
12746msgid ""
12747"libdummy.so.1 libdummy1 #MINVER#\n"
12748" [...]\n"
12749" (c++)\"non-virtual thunk to NSB::ClassD::~ClassD()@Base\" 1.0\n"
12750" [...]\n"
12751msgstr ""
12752
12753#. type: Plain text
12754#: dpkg-gensymbols.man:1
12755msgid "The demangled name above can be obtained by executing the following command:"
12756msgstr ""
12757
12758#. type: Plain text
12759#: dpkg-gensymbols.man:1
12760#, no-wrap
12761msgid " $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt\n"
12762msgstr ""
12763
12764#. type: Plain text
12765#: dpkg-gensymbols.man:1
12766msgid ""
12767"Please note that while mangled name is unique in the library by definition, "
12768"this is not necessarily true for demangled names. A couple of distinct real "
12769"symbols may have the same demangled name. For example, that's the case with "
12770"non-virtual thunk symbols in complex inheritance configurations or with most "
12771"constructors and destructors (since g++ typically generates two real symbols "
12772"for them). However, as these collisions happen on the ABI level, they should "
12773"not degrade quality of the symbol file."
12774msgstr ""
12775
12776#. type: Plain text
12777#: dpkg-gensymbols.man:1
12778msgid ""
12779"This pattern is denoted by the I<symver> tag. Well maintained libraries have "
12780"versioned symbols where each version corresponds to the upstream version "
12781"where the symbol got added. If that's the case, you can use a I<symver> "
12782"pattern to match any symbol associated to the specific version. For example:"
12783msgstr ""
12784
12785#. type: Plain text
12786#: dpkg-gensymbols.man:1
12787#, no-wrap
12788msgid ""
12789"libc.so.6 libc6 #MINVER#\n"
12790" (symver)GLIBC_2.0 2.0\n"
12791" [...]\n"
12792" (symver)GLIBC_2.7 2.7\n"
12793" access@GLIBC_2.0 2.2\n"
12794msgstr ""
12795
12796#. type: Plain text
12797#: dpkg-gensymbols.man:1
12798msgid ""
12799"All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to "
12800"minimal version of 2.0 and 2.7 respectively with the exception of the symbol "
12801"access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 "
12802"version 2.2 despite being in the scope of the \"(symver)GLIBC_2.0\" pattern "
12803"because specific symbols take precedence over patterns."
12804msgstr ""
12805
12806#. type: Plain text
12807#: dpkg-gensymbols.man:1
12808msgid ""
12809"Please note that while old style wildcard patterns (denoted by \"*@version\" "
12810"in the symbol name field) are still supported, they have been deprecated by "
12811"new style syntax \"(symver|optional)version\". For example, \"*@GLIBC_2.0 "
12812"2.0\" should be written as \"(symver|optional)GLIBC_2.0 2.0\" if the same "
12813"behaviour is needed."
12814msgstr ""
12815
12816#. type: Plain text
12817#: dpkg-gensymbols.man:1
12818msgid ""
12819"Regular expression patterns are denoted by the I<regex> tag. They match by "
12820"the perl regular expression specified in the symbol name field. A regular "
12821"expression is matched as it is, therefore do not forget to start it with the "
12822"I<^> character or it may match any part of the real symbol I<name@version> "
12823"string. For example:"
12824msgstr ""
12825
12826#. type: Plain text
12827#: dpkg-gensymbols.man:1
12828#, no-wrap
12829msgid ""
12830"libdummy.so.1 libdummy1 #MINVER#\n"
12831" (regex)\"^mystack_.*@Base$\" 1.0\n"
12832" (regex|optional)\"private\" 1.0\n"
12833msgstr ""
12834
12835#. type: Plain text
12836#: dpkg-gensymbols.man:1
12837msgid ""
12838"Symbols like \"mystack_new@Base\", \"mystack_push@Base\", "
12839"\"mystack_pop@Base\" etc. will be matched by the first pattern while "
12840"e.g. \"ng_mystack_new@Base\" won't. The second pattern will match all "
12841"symbols having the string \"private\" in their names and matches will "
12842"inherit I<optional> tag from the pattern."
12843msgstr ""
12844
12845#. type: Plain text
12846#: dpkg-gensymbols.man:1
12847msgid ""
12848"Basic patterns listed above can be combined where it makes sense. In that "
12849"case, they are processed in the order in which the tags are specified. For "
12850"example, both"
12851msgstr ""
12852
12853#. type: Plain text
12854#: dpkg-gensymbols.man:1
12855#, no-wrap
12856msgid ""
12857" (c++|regex)\"^NSA::ClassA::Private::privmethod\\ed\\e(int\\e)@Base\" 1.0\n"
12858" (regex|c++)N3NSA6ClassA7Private11privmethod\\edEi@Base 1.0\n"
12859msgstr ""
12860
12861#. type: Plain text
12862#: dpkg-gensymbols.man:1
12863msgid ""
12864"will match symbols \"_ZN3NSA6ClassA7Private11privmethod1Ei@Base\" and "
12865"\"_ZN3NSA6ClassA7Private11privmethod2Ei@Base\". When matching the first "
12866"pattern, the raw symbol is first demangled as C++ symbol, then the demangled "
12867"name is matched against the regular expression. On the other hand, when "
12868"matching the second pattern, regular expression is matched against the raw "
12869"symbol name, then the symbol is tested if it is C++ one by attempting to "
12870"demangle it. A failure of any basic pattern will result in the failure of "
12871"the whole pattern. Therefore, for example, "
12872"\"__N3NSA6ClassA7Private11privmethod\\edEi@Base\" will not match either of "
12873"the patterns because it is not a valid C++ symbol."
12874msgstr ""
12875
12876#. type: Plain text
12877#: dpkg-gensymbols.man:1
12878msgid ""
12879"In general, all patterns are divided into two groups: aliases (basic I<c++> "
12880"and I<symver>) and generic patterns (I<regex>, all combinations of multiple "
12881"basic patterns). Matching of basic alias-based patterns is fast (O(1)) "
12882"while generic patterns are O(N) (N - generic pattern count) for each "
12883"symbol. Therefore, it is recommended not to overuse generic patterns."
12884msgstr ""
12885
12886#. type: Plain text
12887#: dpkg-gensymbols.man:1
12888msgid ""
12889"When multiple patterns match the same real symbol, aliases (first I<c++>, "
12890"then I<symver>) are preferred over generic patterns. Generic patterns are "
12891"matched in the order they are found in the symbol file template until the "
12892"first success. Please note, however, that manual reordering of template "
12893"file entries is not recommended because B<dpkg-gensymbols> generates diffs "
12894"based on the alphanumerical order of their names."
12895msgstr ""
12896
12897#. type: SS
12898#: dpkg-gensymbols.man:1
12899#, no-wrap
12900msgid "Using includes"
12901msgstr ""
12902
12903#. type: Plain text
12904#: dpkg-gensymbols.man:1
12905msgid ""
12906"When the set of exported symbols differ between architectures, it may become "
12907"inefficient to use a single symbol file. In those cases, an include "
12908"directive may prove to be useful in a couple of ways:"
12909msgstr ""
12910
12911#. type: Plain text
12912#: dpkg-gensymbols.man:1
12913msgid ""
12914"You can factorize the common part in some external file and include that "
12915"file in your I<package>.symbols.I<arch> file by using an include directive "
12916"like this:"
12917msgstr ""
12918
12919#. type: Plain text
12920#: dpkg-gensymbols.man:1
12921msgid "#include \"I<packages>.symbols.common\""
12922msgstr ""
12923
12924#. type: Plain text
12925#: dpkg-gensymbols.man:1
12926msgid "The include directive may also be tagged like any symbol:"
12927msgstr ""
12928
12929#. type: Plain text
12930#: dpkg-gensymbols.man:1
12931msgid "(tag|...|tagN)#include \"file-to-include\""
12932msgstr ""
12933
12934#. type: Plain text
12935#: dpkg-gensymbols.man:1
12936msgid ""
12937"As a result, all symbols included from I<file-to-include> will be considered "
12938"to be tagged with I<tag> ... I<tagN> by default. You can use this feature to "
12939"create a common I<package>.symbols file which includes architecture specific "
12940"symbol files:"
12941msgstr ""
12942
12943#. type: Plain text
12944#: dpkg-gensymbols.man:1
12945#, no-wrap
12946msgid ""
12947" common_symbol1@Base 1.0\n"
12948" (arch=amd64 ia64 alpha)#include \"package.symbols.64bit\"\n"
12949" (arch=!amd64 !ia64 !alpha)#include \"package.symbols.32bit\"\n"
12950" common_symbol2@Base 1.0\n"
12951msgstr ""
12952
12953#. type: Plain text
12954#: dpkg-gensymbols.man:1
12955msgid ""
12956"The symbols files are read line by line, and include directives are "
12957"processed as soon as they are encountered. This means that the content of "
12958"the included file can override any content that appeared before the include "
12959"directive and that any content after the directive can override anything "
12960"contained in the included file. Any symbol (or even another #include "
12961"directive) in the included file can specify additional tags or override "
12962"values of the inherited tags in its tag specification. However, there is no "
12963"way for the symbol to remove any of the inherited tags."
12964msgstr ""
12965
12966#. type: Plain text
12967#: dpkg-gensymbols.man:1
12968msgid ""
12969"An included file can repeat the header line containing the SONAME of the "
12970"library. In that case, it overrides any header line previously read. "
12971"However, in general it's best to avoid duplicating header lines. One way to "
12972"do it is the following:"
12973msgstr ""
12974
12975#. type: Plain text
12976#: dpkg-gensymbols.man:1
12977#, no-wrap
12978msgid ""
12979"#include \"libsomething1.symbols.common\"\n"
12980" arch_specific_symbol@Base 1.0\n"
12981msgstr ""
12982
12983#. type: SS
12984#: dpkg-gensymbols.man:1
12985#, no-wrap
12986msgid "Good library management"
12987msgstr ""
12988
12989#. type: Plain text
12990#: dpkg-gensymbols.man:1
12991msgid "A well-maintained library has the following features:"
12992msgstr ""
12993
12994#. type: Plain text
12995#: dpkg-gensymbols.man:1
12996msgid ""
12997"its API is stable (public symbols are never dropped, only new public symbols "
12998"are added) and changes in incompatible ways only when the SONAME changes;"
12999msgstr ""
13000
13001#. type: Plain text
13002#: dpkg-gensymbols.man:1
13003msgid ""
13004"ideally, it uses symbol versioning to achieve ABI stability despite internal "
13005"changes and API extension;"
13006msgstr ""
13007
13008#. type: Plain text
13009#: dpkg-gensymbols.man:1
13010msgid ""
13011"it doesn't export private symbols (such symbols can be tagged optional as "
13012"workaround)."
13013msgstr ""
13014
13015#. type: Plain text
13016#: dpkg-gensymbols.man:1
13017msgid ""
13018"While maintaining the symbols file, it's easy to notice appearance and "
13019"disappearance of symbols. But it's more difficult to catch incompatible API "
13020"and ABI change. Thus the maintainer should read thoroughly the upstream "
13021"changelog looking for cases where the rules of good library management have "
13022"been broken. If potential problems are discovered, the upstream author "
13023"should be notified as an upstream fix is always better than a Debian "
13024"specific work-around."
13025msgstr ""
13026
13027#. type: Plain text
13028#: dpkg-gensymbols.man:1
13029msgid "Scan I<package-build-dir> instead of debian/tmp."
13030msgstr ""
13031
13032#. type: Plain text
13033#: dpkg-gensymbols.man:1
13034msgid ""
13035"Define the package name. Required if more than one binary package is listed "
13036"in debian/control (or if there's no debian/control file)."
13037msgstr ""
13038
13039#. type: Plain text
13040#: dpkg-gensymbols.man:1
13041msgid ""
13042"Define the package version. Defaults to the version extracted from "
13043"debian/changelog. Required if called outside of a source package tree."
13044msgstr ""
13045
13046#. type: TP
13047#: dpkg-gensymbols.man:1
13048#, no-wrap
13049msgid "B<-e>I<library-file>"
13050msgstr ""
13051
13052#. type: Plain text
13053#: dpkg-gensymbols.man:1
13054msgid ""
13055"Only analyze libraries explicitly listed instead of finding all public "
13056"libraries. You can use shell patterns used for pathname expansions (see the "
13057"B<File::Glob>(3perl) manual page for details) in I<library-file> to match "
13058"multiple libraries with a single argument (otherwise you need multiple "
13059"B<-e>)."
13060msgstr ""
13061
13062#. type: TP
13063#: dpkg-gensymbols.man:1
13064#, no-wrap
13065msgid "B<-I>I<filename>"
13066msgstr ""
13067
13068#. type: Plain text
13069#: dpkg-gensymbols.man:1
13070msgid ""
13071"Use I<filename> as reference file to generate the symbols file that is "
13072"integrated in the package itself."
13073msgstr ""
13074
13075#. type: Plain text
13076#: dpkg-gensymbols.man:1
13077msgid ""
13078"Print the generated symbols file to standard output or to I<filename> if "
13079"specified, rather than to B<debian/tmp/DEBIAN/symbols> (or "
13080"I<package-build-dir>B</DEBIAN/symbols> if B<-P> was used). If I<filename> is "
13081"pre-existing, its contents are used as basis for the generated symbols "
13082"file. You can use this feature to update a symbols file so that it matches "
13083"a newer upstream version of your library."
13084msgstr ""
13085
13086#. type: TP
13087#: dpkg-gensymbols.man:1
13088#, no-wrap
13089msgid "B<-t>"
13090msgstr ""
13091
13092#. type: Plain text
13093#: dpkg-gensymbols.man:1
13094msgid ""
13095"Write the symbol file in template mode rather than the format compatible "
13096"with B<deb-symbols>(5). The main difference is that in the template mode "
13097"symbol names and tags are written in their original form contrary to the "
13098"post-processed symbol names with tags stripped in the compatibility mode. "
13099"Moreover, some symbols might be omitted when writing a standard "
13100"B<deb-symbols>(5) file (according to the tag processing rules) while all "
13101"symbols are always written to the symbol file template."
13102msgstr ""
13103
13104#. type: TP
13105#: dpkg-gensymbols.man:1
13106#, no-wrap
13107msgid "B<-c>I<[0-4]>"
13108msgstr ""
13109
13110#. type: Plain text
13111#: dpkg-gensymbols.man:1
13112msgid ""
13113"Define the checks to do when comparing the generated symbols file with the "
13114"template file used as starting point. By default the level is 1. Increasing "
13115"levels do more checks and include all checks of lower levels. Level 0 never "
13116"fails. Level 1 fails if some symbols have disappeared. Level 2 fails if some "
13117"new symbols have been introduced. Level 3 fails if some libraries have "
13118"disappeared. Level 4 fails if some libraries have been introduced."
13119msgstr ""
13120
13121#. type: Plain text
13122#: dpkg-gensymbols.man:1
13123msgid ""
13124"This value can be overridden by the environment variable "
13125"B<DPKG_GENSYMBOLS_CHECK_LEVEL>."
13126msgstr ""
13127
13128#. type: Plain text
13129#: dpkg-gensymbols.man:1
13130msgid ""
13131"Keep quiet and never generate a diff between generated symbols file and the "
13132"template file used as starting point or show any warnings about new/lost "
13133"libraries or new/lost symbols. This option only disables informational "
13134"output but not the checks themselves (see B<-c> option)."
13135msgstr ""
13136
13137#. type: TP
13138#: dpkg-gensymbols.man:1
13139#, no-wrap
13140msgid "B<-a>I<arch>"
13141msgstr ""
13142
13143#. type: Plain text
13144#: dpkg-gensymbols.man:1
13145msgid ""
13146"Assume I<arch> as host architecture when processing symbol files. Use this "
13147"option to generate a symbol file or diff for any architecture provided its "
13148"binaries are already available."
13149msgstr ""
13150
13151#. type: TP
13152#: dpkg-gensymbols.man:1
13153#, no-wrap
13154msgid "B<-d>"
13155msgstr ""
13156
13157#. type: Plain text
13158#: dpkg-gensymbols.man:1
13159msgid ""
13160"Enable debug mode. Numerous messages are displayed to explain what "
13161"B<dpkg-gensymbols> does."
13162msgstr ""
13163
13164#. type: TP
13165#: dpkg-gensymbols.man:1
13166#, no-wrap
13167msgid "B<-V>"
13168msgstr ""
13169
13170#. type: Plain text
13171#: dpkg-gensymbols.man:1
13172msgid ""
13173"Enable verbose mode. The generated symbols file contains deprecated symbols "
13174"as comments. Furthermore in template mode, pattern symbols are followed by "
13175"comments listing real symbols that have matched the pattern."
13176msgstr ""
13177
13178#. type: TP
13179#: dpkg-gensymbols.man:1
13180#, no-wrap
13181msgid "B<DPKG_GENSYMBOLS_CHECK_LEVEL>"
13182msgstr ""
13183
13184#. type: Plain text
13185#: dpkg-gensymbols.man:1
13186msgid ""
13187"Overrides the command check level, even if the B<-c> command-line argument "
13188"was given (note that this goes against the common convention of command-line "
13189"arguments having precedence over environment variables)."
13190msgstr ""
13191
13192#. type: Plain text
13193#: dpkg-gensymbols.man:1
13194msgid "B<https://people.redhat.com/drepper/symbol-versioning>"
13195msgstr ""
13196
13197#. type: Plain text
13198#: dpkg-gensymbols.man:1
13199msgid "B<https://people.redhat.com/drepper/goodpractice.pdf>"
13200msgstr ""
13201
13202#. type: Plain text
13203#: dpkg-gensymbols.man:1
13204msgid "B<https://people.redhat.com/drepper/dsohowto.pdf>"
13205msgstr ""
13206
13207#. type: Plain text
13208#: dpkg-gensymbols.man:1
13209msgid "B<deb-symbols>(5), B<dpkg-shlibdeps>(1)."
13210msgstr ""
13211
13212#. type: TH
13213#: dpkg-maintscript-helper.man:1
13214#, no-wrap
13215msgid "dpkg-maintscript-helper"
13216msgstr ""
13217
13218#. type: Plain text
13219#: dpkg-maintscript-helper.man:1
13220msgid ""
13221"dpkg-maintscript-helper - works around known dpkg limitations in maintainer "
13222"scripts"
13223msgstr ""
13224
13225#. type: Plain text
13226#: dpkg-maintscript-helper.man:1
13227msgid ""
13228"B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> "
13229"I<maint-script-parameter>..."
13230msgstr ""
13231
13232#. type: SH
13233#: dpkg-maintscript-helper.man:1
13234#, no-wrap
13235msgid "COMMANDS AND PARAMETERS"
13236msgstr ""
13237
13238#. type: Plain text
13239#: dpkg-maintscript-helper.man:1
13240msgid "B<supports> I<command>"
13241msgstr ""
13242
13243#. type: Plain text
13244#: dpkg-maintscript-helper.man:1
13245msgid "B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]"
13246msgstr ""
13247
13248#. type: Plain text
13249#: dpkg-maintscript-helper.man:1
13250msgid ""
13251"B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> "
13252"[I<package>]]"
13253msgstr ""
13254
13255#. type: Plain text
13256#: dpkg-maintscript-helper.man:1
13257msgid "B<symlink_to_dir> I<pathname> I<old-target> [I<prior-version> [I<package>]]"
13258msgstr ""
13259
13260#. type: Plain text
13261#: dpkg-maintscript-helper.man:1
13262msgid "B<dir_to_symlink> I<pathname> I<new-target> [I<prior-version> [I<package>]]"
13263msgstr ""
13264
13265#. type: Plain text
13266#: dpkg-maintscript-helper.man:1
13267msgid ""
13268"This program is designed to be run within maintainer scripts to achieve some "
13269"tasks that B<dpkg> can't (yet) handle natively either because of design "
13270"decisions or due to current limitations."
13271msgstr ""
13272
13273#. type: Plain text
13274#: dpkg-maintscript-helper.man:1
13275msgid ""
13276"Many of those tasks require coordinated actions from several maintainer "
13277"scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes "
13278"the same call simply needs to be put in all scripts and the program will "
13279"automatically adapt its behaviour based on the environment variable "
13280"B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you "
13281"have to forward after a double hyphen."
13282msgstr ""
13283
13284#. type: SH
13285#: dpkg-maintscript-helper.man:1
13286#, no-wrap
13287msgid "COMMON PARAMETERS"
13288msgstr ""
13289
13290#. type: TP
13291#: dpkg-maintscript-helper.man:1
13292#, no-wrap
13293msgid "I<prior-version>"
13294msgstr ""
13295
13296#. type: Plain text
13297#: dpkg-maintscript-helper.man:1
13298msgid ""
13299"Defines the latest version of the package whose upgrade should trigger the "
13300"operation. It is important to calculate I<prior-version> correctly so that "
13301"the operations are correctly performed even if the user rebuilt the package "
13302"with a local version. If I<prior-version> is empty or omitted, then the "
13303"operation is tried on every upgrade (note: it's safer to give the version "
13304"and have the operation tried only once)."
13305msgstr ""
13306
13307#. type: Plain text
13308#: dpkg-maintscript-helper.man:1
13309msgid ""
13310"If the conffile has not been shipped for several versions, and you are now "
13311"modifying the maintainer scripts to clean up the obsolete file, "
13312"I<prior-version> should be based on the version of the package that you are "
13313"now preparing, not the first version of the package that lacked the "
13314"conffile. This applies to all other actions in the same way."
13315msgstr ""
13316
13317#. type: Plain text
13318#: dpkg-maintscript-helper.man:1
13319msgid ""
13320"For example, for a conffile removed in version B<2.0-1> of a package, "
13321"I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to "
13322"be removed even if the user rebuilt the previous version B<1.0-1> as "
13323"B<1.0-1local1>. Or a package switching a path from a symlink (shipped in "
13324"version B<1.0-1>) to a directory (shipped in version B<2.0-1>), but only "
13325"performing the actual switch in the maintainer scripts in version B<3.0-1>, "
13326"should set I<prior-version> to B<3.0-1~>."
13327msgstr ""
13328
13329#. type: TP
13330#: dpkg-maintscript-helper.man:1
13331#, no-wrap
13332msgid "I<package>"
13333msgstr ""
13334
13335#. type: Plain text
13336#: dpkg-maintscript-helper.man:1
13337msgid ""
13338"The package name. When the package is “Multi-Arch: same” this parameter must "
13339"include the architecture qualifier, otherwise it should B<not> usually "
13340"include the architecture qualifier (as it would disallow cross-grades, or "
13341"switching from being architecture specific to architecture B<all> or vice "
13342"versa). If the parameter is empty or omitted, the "
13343"B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment "
13344"variables (as set by B<dpkg>) will be used to generate an arch-qualified "
13345"package name."
13346msgstr ""
13347
13348#. type: TP
13349#: dpkg-maintscript-helper.man:1
13350#, no-wrap
13351msgid "B<-->"
13352msgstr ""
13353
13354#. type: Plain text
13355#: dpkg-maintscript-helper.man:1
13356msgid ""
13357"All the parameters of the maintainer scripts have to be forwarded to the "
13358"program after B<-->."
13359msgstr ""
13360
13361#. type: SH
13362#: dpkg-maintscript-helper.man:1
13363#, no-wrap
13364msgid "CONFFILE RELATED TASKS"
13365msgstr ""
13366
13367#. type: Plain text
13368#: dpkg-maintscript-helper.man:1
13369msgid ""
13370"When upgrading a package, B<dpkg> will not automatically remove a conffile "
13371"(a configuration file for which B<dpkg> should preserve user changes) if it "
13372"is not present in the newer version. There are two principal reasons for "
13373"this; the first is that the conffile could've been dropped by accident and "
13374"the next version could restore it, users wouldn't want their changes thrown "
13375"away. The second is to allow packages to transition files from a "
13376"dpkg-maintained conffile to a file maintained by the package's maintainer "
13377"scripts, usually with a tool like debconf or ucf."
13378msgstr ""
13379
13380#. type: Plain text
13381#: dpkg-maintscript-helper.man:1
13382msgid ""
13383"This means that if a package is intended to rename or remove a conffile, it "
13384"must explicitly do so and B<dpkg-maintscript-helper> can be used to "
13385"implement graceful deletion and moving of conffiles within maintainer "
13386"scripts."
13387msgstr ""
13388
13389#. type: SS
13390#: dpkg-maintscript-helper.man:1
13391#, no-wrap
13392msgid "Removing a conffile"
13393msgstr ""
13394
13395#. type: Plain text
13396#: dpkg-maintscript-helper.man:1
13397msgid ""
13398"If a conffile is completely removed, it should be removed from disk, unless "
13399"the user has modified it. If there are local modifications, they should be "
13400"preserved. If the package upgrades aborts, the newly obsolete conffile "
13401"should not disappear."
13402msgstr ""
13403
13404#. type: Plain text
13405#: dpkg-maintscript-helper.man:1
13406msgid ""
13407"All of this is implemented by putting the following shell snippet in the "
13408"B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
13409msgstr ""
13410
13411#. type: Plain text
13412#: dpkg-maintscript-helper.man:1
13413#, no-wrap
13414msgid ""
13415" dpkg-maintscript-helper rm_conffile \\e\n"
13416" I<conffile> I<prior-version> I<package> -- \"$@\"\n"
13417msgstr ""
13418
13419#. type: Plain text
13420#: dpkg-maintscript-helper.man:1
13421msgid "I<conffile> is the filename of the conffile to remove."
13422msgstr ""
13423
13424#. type: Plain text
13425#: dpkg-maintscript-helper.man:1
13426msgid ""
13427"Current implementation: in the B<preinst>, it checks if the conffile was "
13428"modified and renames it either to I<conffile>B<.dpkg-remove> (if not "
13429"modified) or to I<conffile>B<.dpkg-backup> (if modified). In the "
13430"B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept "
13431"for reference as it contains user modifications but the former will be "
13432"removed. If the package upgrade aborts, the B<postrm> reinstalls the "
13433"original conffile. During purge, the B<postrm> will also delete the "
13434"B<.dpkg-bak> file kept up to now."
13435msgstr ""
13436
13437#. type: SS
13438#: dpkg-maintscript-helper.man:1
13439#, no-wrap
13440msgid "Renaming a conffile"
13441msgstr ""
13442
13443#. type: Plain text
13444#: dpkg-maintscript-helper.man:1
13445msgid ""
13446"If a conffile is moved from one location to another, you need to make sure "
13447"you move across any changes the user has made. This may seem a simple change "
13448"to the B<preinst> script at first, however that will result in the user "
13449"being prompted by B<dpkg> to approve the conffile edits even though they are "
13450"not responsible of them."
13451msgstr ""
13452
13453#. type: Plain text
13454#: dpkg-maintscript-helper.man:1 dpkg-maintscript-helper.man:1
13455msgid ""
13456"Graceful renaming can be implemented by putting the following shell snippet "
13457"in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
13458msgstr ""
13459
13460#. type: Plain text
13461#: dpkg-maintscript-helper.man:1
13462#, no-wrap
13463msgid ""
13464" dpkg-maintscript-helper mv_conffile \\e\n"
13465" I<old-conffile> I<new-conffile> I<prior-version> I<package> -- "
13466"\"$@\"\n"
13467msgstr ""
13468
13469#. type: Plain text
13470#: dpkg-maintscript-helper.man:1
13471msgid ""
13472"I<old-conffile> and I<new-conffile> are the old and new name of the conffile "
13473"to rename."
13474msgstr ""
13475
13476#. type: Plain text
13477#: dpkg-maintscript-helper.man:1
13478msgid ""
13479"Current implementation: the B<preinst> checks if the conffile has been "
13480"modified, if yes it's left on place otherwise it's renamed to "
13481"I<old-conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes "
13482"I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to "
13483"I<new-conffile> if I<old-conffile> is still available. On "
13484"abort-upgrade/abort-install, the B<postrm> renames "
13485"I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required."
13486msgstr ""
13487
13488#. type: SH
13489#: dpkg-maintscript-helper.man:1
13490#, no-wrap
13491msgid "SYMLINK AND DIRECTORY SWITCHES"
13492msgstr ""
13493
13494#. type: Plain text
13495#: dpkg-maintscript-helper.man:1
13496msgid ""
13497"When upgrading a package, B<dpkg> will not automatically switch a symlink to "
13498"a directory or vice-versa. Downgrades are not supported and the path will be "
13499"left as is."
13500msgstr ""
13501
13502#. type: SS
13503#: dpkg-maintscript-helper.man:1
13504#, no-wrap
13505msgid "Switching a symlink to directory"
13506msgstr ""
13507
13508#. type: Plain text
13509#: dpkg-maintscript-helper.man:1
13510msgid ""
13511"If a symlink is switched to a real directory, you need to make sure before "
13512"unpacking that the symlink is removed. This may seem a simple change to the "
13513"B<preinst> script at first, however that will result in some problems in "
13514"case of admin local customization of the symlink or when downgrading the "
13515"package."
13516msgstr ""
13517
13518#. type: Plain text
13519#: dpkg-maintscript-helper.man:1
13520#, no-wrap
13521msgid ""
13522" dpkg-maintscript-helper symlink_to_dir \\e\n"
13523" I<pathname> I<old-target> I<prior-version> I<package> -- \"$@\"\n"
13524msgstr ""
13525
13526#. type: Plain text
13527#: dpkg-maintscript-helper.man:1
13528msgid ""
13529"I<pathname> is the absolute name of the old symlink (the path will be a "
13530"directory at the end of the installation) and I<old-target> is the target "
13531"name of the former symlink at I<pathname>. It can either be absolute or "
13532"relative to the directory containing I<pathname>."
13533msgstr ""
13534
13535#. type: Plain text
13536#: dpkg-maintscript-helper.man:1
13537msgid ""
13538"Current implementation: the B<preinst> checks if the symlink exists and "
13539"points to I<old-target>, if not then it's left in place, otherwise it's "
13540"renamed to I<pathname>B<.dpkg-backup>. On configuration, the B<postinst> "
13541"removes I<pathname>B<.dpkg-backup> if I<pathname>B<.dpkg-backup> is still a "
13542"symlink. On abort-upgrade/abort-install, the B<postrm> renames "
13543"I<pathname>B<.dpkg-backup> back to I<pathname> if required."
13544msgstr ""
13545
13546#. type: SS
13547#: dpkg-maintscript-helper.man:1
13548#, no-wrap
13549msgid "Switching a directory to symlink"
13550msgstr ""
13551
13552#. type: Plain text
13553#: dpkg-maintscript-helper.man:1
13554msgid ""
13555"If a real directory is switched to a symlink, you need to make sure before "
13556"unpacking that the directory is removed. This may seem a simple change to "
13557"the B<preinst> script at first, however that will result in some problems in "
13558"case the directory contains conffiles, pathnames owned by other packages, "
13559"locally created pathnames, or when downgrading the package."
13560msgstr ""
13561
13562#. type: Plain text
13563#: dpkg-maintscript-helper.man:1
13564msgid ""
13565"Graceful switching can be implemented by putting the following shell snippet "
13566"in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
13567msgstr ""
13568
13569#. type: Plain text
13570#: dpkg-maintscript-helper.man:1
13571#, no-wrap
13572msgid ""
13573" dpkg-maintscript-helper dir_to_symlink \\e\n"
13574" I<pathname> I<new-target> I<prior-version> I<package> -- \"$@\"\n"
13575msgstr ""
13576
13577#. type: Plain text
13578#: dpkg-maintscript-helper.man:1
13579msgid ""
13580"I<pathname> is the absolute name of the old directory (the path will be a "
13581"symlink at the end of the installation) and I<new-target> is the target of "
13582"the new symlink at I<pathname>. It can either be absolute or relative to the "
13583"directory containing I<pathname>."
13584msgstr ""
13585
13586#. type: Plain text
13587#: dpkg-maintscript-helper.man:1
13588msgid ""
13589"Current implementation: the B<preinst> checks if the directory exists, does "
13590"not contain conffiles, pathnames owned by other packages, or locally created "
13591"pathnames, if not then it's left in place, otherwise it's renamed to "
13592"I<pathname>B<.dpkg-backup>, and an empty staging directory named I<pathname> "
13593"is created, marked with a file so that dpkg can track it. On configuration, "
13594"the B<postinst> finishes the switch if I<pathname>B<.dpkg-backup> is still a "
13595"directory and I<pathname> is the staging directory; it removes the staging "
13596"directory mark file, moves the newly created files inside the staging "
13597"directory to the symlink target I<new-target>/, replaces the now empty "
13598"staging directory I<pathname> with a symlink to I<new-target>, and removes "
13599"I<pathname>B<.dpkg-backup>. On abort-upgrade/abort-install, the B<postrm> "
13600"renames I<pathname>B<.dpkg-backup> back to I<pathname> if required."
13601msgstr ""
13602
13603#. type: SH
13604#: dpkg-maintscript-helper.man:1
13605#, no-wrap
13606msgid "INTEGRATION IN PACKAGES"
13607msgstr ""
13608
13609#. type: Plain text
13610#: dpkg-maintscript-helper.man:1
13611msgid ""
13612"When using a packaging helper, please check if it has native "
13613"B<dpkg-maintscript-helper> integration, which might make your life "
13614"easier. See for example B<dh_installdeb>(1)."
13615msgstr ""
13616
13617#. type: Plain text
13618#: dpkg-maintscript-helper.man:1
13619msgid ""
13620"Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it "
13621"unconditionally requires a pre-dependency to ensure that the required "
13622"version of B<dpkg> has been unpacked before. The required version depends on "
13623"the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2, for "
13624"B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14:"
13625msgstr ""
13626
13627#. type: Plain text
13628#: dpkg-maintscript-helper.man:1
13629#, no-wrap
13630msgid " B<Pre-Depends:> dpkg (E<gt>= 1.17.14)\n"
13631msgstr ""
13632
13633#. type: Plain text
13634#: dpkg-maintscript-helper.man:1
13635msgid ""
13636"But in many cases the operation done by the program is not critical for the "
13637"package, and instead of using a pre-dependency we can call the program only "
13638"if we know that the required command is supported by the currently installed "
13639"B<dpkg>:"
13640msgstr ""
13641
13642#. type: Plain text
13643#: dpkg-maintscript-helper.man:1
13644#, no-wrap
13645msgid ""
13646" if dpkg-maintscript-helper supports I<command>; then\n"
13647" dpkg-maintscript-helper I<command> ...\n"
13648" fi\n"
13649msgstr ""
13650
13651#. type: Plain text
13652#: dpkg-maintscript-helper.man:1
13653msgid ""
13654"The command B<supports> will return 0 on success, 1 otherwise. The "
13655"B<supports> command will check if the environment variables as set by dpkg "
13656"and required by the script are present, and will consider it a failure in "
13657"case the environment is not sufficient."
13658msgstr ""
13659
13660#. type: Plain text
13661#: dpkg-maintscript-helper.man:1
13662msgid "B<dh_installdeb>(1)."
13663msgstr ""
13664
13665#. type: TH
13666#: dpkg-mergechangelogs.man:1
13667#, no-wrap
13668msgid "dpkg-mergechangelogs"
13669msgstr ""
13670
13671#. type: Plain text
13672#: dpkg-mergechangelogs.man:1
13673msgid "dpkg-mergechangelogs - 3-way merge of debian/changelog files"
13674msgstr ""
13675
13676#. type: Plain text
13677#: dpkg-mergechangelogs.man:1
13678msgid "B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]"
13679msgstr ""
13680
13681#. type: Plain text
13682#: dpkg-mergechangelogs.man:1
13683msgid ""
13684"This program will use the 3 provided versions of the Debian changelog to "
13685"generate a merged changelog file. The resulting changelog is stored in the "
13686"file I<out> or output to the standard output if that parameter is not given."
13687msgstr ""
13688
13689#. type: Plain text
13690#: dpkg-mergechangelogs.man:1
13691msgid ""
13692"Each entry is identified by its version number and they are assumed to be "
13693"not conflicting, they are simply merged in the right order (by decreasing "
13694"version number). When B<--merge-prereleases> is used, the part of the "
13695"version number after the last tilde is dropped so that 1.0-1~exp1 and "
13696"1.0-1~exp5 are considered to be the same entry. When the same version is "
13697"available in both I<new-a> and I<new-b>, a standard line-based 3-way merge "
13698"is attempted (provided that the module Algorithm::Merge is available — it's "
13699"part of the package libalgorithm-merge-perl — otherwise you get a global "
13700"conflict on the content of the entry)."
13701msgstr ""
13702
13703#. type: TP
13704#: dpkg-mergechangelogs.man:1
13705#, no-wrap
13706msgid "B<-m>, B<--merge-prereleases>"
13707msgstr ""
13708
13709#. type: Plain text
13710#: dpkg-mergechangelogs.man:1
13711msgid ""
13712"Drop the part after the last tilde in the version number when doing version "
13713"comparison to identify if two entries are supposed to be the same or not."
13714msgstr ""
13715
13716#. type: Plain text
13717#: dpkg-mergechangelogs.man:1
13718msgid ""
13719"This is useful when you keep using the same changelog entry but you increase "
13720"its version number regularly. For instance, you might have 2.3-1~exp1, "
13721"2.3-1~exp2, ... until the official release 2.3-1 and they are all the same "
13722"changelog entry that has evolved over time."
13723msgstr ""
13724
13725#. type: SH
13726#: dpkg-mergechangelogs.man:1
13727#, no-wrap
13728msgid "LIMITATIONS"
13729msgstr ""
13730
13731#. type: Plain text
13732#: dpkg-mergechangelogs.man:1
13733msgid ""
13734"Anything that is not parsed by Dpkg::Changelog is lost during the merge. "
13735"This might include stuff like vim modelines, comments which were not "
13736"supposed to be there, etc."
13737msgstr ""
13738
13739#. type: SH
13740#: dpkg-mergechangelogs.man:1
13741#, no-wrap
13742msgid "INTEGRATION WITH GIT"
13743msgstr ""
13744
13745#. type: Plain text
13746#: dpkg-mergechangelogs.man:1
13747msgid ""
13748"If you want to use this program to merge Debian changelog files in a git "
13749"repository, you have first to register a new merge driver in B<.git/config> "
13750"or B<~/.gitconfig>:"
13751msgstr ""
13752
13753#. type: Plain text
13754#: dpkg-mergechangelogs.man:1
13755#, no-wrap
13756msgid ""
13757" [merge \"dpkg-mergechangelogs\"]\n"
13758" name = debian/changelog merge driver\n"
13759" driver = dpkg-mergechangelogs -m %O %A %B %A\n"
13760msgstr ""
13761
13762#. type: Plain text
13763#: dpkg-mergechangelogs.man:1
13764msgid ""
13765"Then you have to setup the merge attribute for the debian/changelog file "
13766"either in B<.gitattributes> in the repository itself, or in "
13767"B<.git/info/attributes>:"
13768msgstr ""
13769
13770#. type: Plain text
13771#: dpkg-mergechangelogs.man:1
13772#, no-wrap
13773msgid " debian/changelog merge=dpkg-mergechangelogs\n"
13774msgstr ""
13775
13776#. type: TH
13777#: dpkg-name.man:1
13778#, no-wrap
13779msgid "dpkg-name"
13780msgstr ""
13781
13782#. type: Plain text
13783#: dpkg-name.man:1
13784msgid "dpkg-name - rename Debian packages to full package names"
13785msgstr ""
13786
13787#. type: Plain text
13788#: dpkg-name.man:1
13789msgid "B<dpkg-name> [I<option>...] [B<-->] I<file>..."
13790msgstr ""
13791
13792#. type: Plain text
13793#: dpkg-name.man:1
13794msgid ""
13795"This manual page documents the B<dpkg-name> program which provides an easy "
13796"way to rename B<Debian> packages into their full package names. A full "
13797"package name consists of "
13798"I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified "
13799"in the control file of the package. The I<version> part of the filename "
13800"consists of the upstream version information optionally followed by a hyphen "
13801"and the revision information. The I<package-type> part comes from that field "
13802"if present or fallbacks to B<deb>."
13803msgstr ""
13804
13805#. type: TP
13806#: dpkg-name.man:1
13807#, no-wrap
13808msgid "B<-a>, B<--no-architecture>"
13809msgstr ""
13810
13811#. type: Plain text
13812#: dpkg-name.man:1
13813msgid "The destination filename will not have the architecture information."
13814msgstr ""
13815
13816#. type: TP
13817#: dpkg-name.man:1
13818#, no-wrap
13819msgid "B<-k>, B<--symlink>"
13820msgstr ""
13821
13822#. type: Plain text
13823#: dpkg-name.man:1
13824msgid "Create a symlink, instead of moving."
13825msgstr ""
13826
13827#. type: TP
13828#: dpkg-name.man:1
13829#, no-wrap
13830msgid "B<-o>, B<--overwrite>"
13831msgstr ""
13832
13833#. type: Plain text
13834#: dpkg-name.man:1
13835msgid ""
13836"Existing files will be overwritten if they have the same name as the "
13837"destination filename."
13838msgstr ""
13839
13840#. type: TP
13841#: dpkg-name.man:1
13842#, no-wrap
13843msgid "B<-s>, B<--subdir> [I<dir>]"
13844msgstr ""
13845
13846#. type: Plain text
13847#: dpkg-name.man:1
13848msgid ""
13849"Files will be moved into a subdirectory. If the directory given as argument "
13850"exists the files will be moved into that directory otherwise the name of the "
13851"target directory is extracted from the section field in the control part of "
13852"the package. The target directory will be "
13853"«unstable/binary-I<architecture>/I<section>». If the section is not found "
13854"in the control, then B<no-section> is assumed, and in this case, as well as "
13855"for sections B<non-free> and B<contrib> the target directory is "
13856"«I<section>/binary-I<architecture>». The section field is not required so a "
13857"lot of packages will find their way to the B<no-section> area. Use this "
13858"option with care, it's messy."
13859msgstr ""
13860
13861#. type: TP
13862#: dpkg-name.man:1
13863#, no-wrap
13864msgid "B<-c>, B<--create-dir>"
13865msgstr ""
13866
13867#. type: Plain text
13868#: dpkg-name.man:1
13869msgid ""
13870"This option can used together with the B<-s> option. If a target directory "
13871"isn't found it will be created automatically. B<Use this option with care.>"
13872msgstr ""
13873
13874#. type: TP
13875#: dpkg-name.man:1
13876#, no-wrap
13877msgid "B<-v>, B<--version>"
13878msgstr ""
13879
13880#. type: Plain text
13881#: dpkg-name.man:1
13882msgid ""
13883"Some packages don't follow the name structure "
13884"I<package>B<_>I<version>B<_>I<architecture>B<.deb>. Packages renamed by "
13885"B<dpkg-name> will follow this structure. Generally this will have no impact "
13886"on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other "
13887"installation tools might depend on this naming structure."
13888msgstr ""
13889
13890#. type: TP
13891#: dpkg-name.man:1
13892#, no-wrap
13893msgid "B<dpkg-name bar-foo.deb>"
13894msgstr ""
13895
13896#. type: Plain text
13897#: dpkg-name.man:1
13898msgid ""
13899"The file B<bar-foo.deb> will be renamed to bar-foo_1.0-2_i386.deb or "
13900"something similar (depending on whatever information is in the control part "
13901"of B<bar-foo.deb>)."
13902msgstr ""
13903
13904#. type: TP
13905#: dpkg-name.man:1
13906#, no-wrap
13907msgid "B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>"
13908msgstr ""
13909
13910#. type: Plain text
13911#: dpkg-name.man:1
13912msgid ""
13913"All files with the extension B<deb> in the directory /root/debian and its "
13914"subdirectory's will be renamed by B<dpkg-name> if required into names with "
13915"no architecture information."
13916msgstr ""
13917
13918#. type: TP
13919#: dpkg-name.man:1
13920#, no-wrap
13921msgid "B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>"
13922msgstr ""
13923
13924#. type: Plain text
13925#: dpkg-name.man:1
13926msgid ""
13927"B<Don't do this.> Your archive will be messed up completely because a lot of "
13928"packages don't come with section information. B<Don't do this.>"
13929msgstr ""
13930
13931#. type: TP
13932#: dpkg-name.man:1
13933#, no-wrap
13934msgid "B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>"
13935msgstr ""
13936
13937#. type: Plain text
13938#: dpkg-name.man:1
13939msgid "This can be used when building new packages."
13940msgstr ""
13941
13942#. type: Plain text
13943#: dpkg-name.man:1
13944msgid ""
13945"B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dpkg-deb>(1), B<find>(1), "
13946"B<xargs>(1)."
13947msgstr ""
13948
13949#. type: TH
13950#: dpkg-parsechangelog.man:1
13951#, no-wrap
13952msgid "dpkg-parsechangelog"
13953msgstr ""
13954
13955#. type: Plain text
13956#: dpkg-parsechangelog.man:1
13957msgid "dpkg-parsechangelog - parse Debian changelog files"
13958msgstr ""
13959
13960#. type: Plain text
13961#: dpkg-parsechangelog.man:1
13962msgid "B<dpkg-parsechangelog> [I<option>...]"
13963msgstr ""
13964
13965#. type: Plain text
13966#: dpkg-parsechangelog.man:1
13967msgid ""
13968"B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian "
13969"source tree and outputs the information in it to standard output in a "
13970"machine-readable form."
13971msgstr ""
13972
13973#. type: TP
13974#: dpkg-parsechangelog.man:1
13975#, no-wrap
13976msgid "B<-l>, B<--file> I<changelog-file>"
13977msgstr ""
13978
13979#. type: Plain text
13980#: dpkg-parsechangelog.man:1
13981msgid ""
13982"Specifies the changelog file to read information from. A ‘-’ can be used to "
13983"specify reading from standard input. The default is B<debian/changelog>."
13984msgstr ""
13985
13986#. type: TP
13987#: dpkg-parsechangelog.man:1
13988#, no-wrap
13989msgid "B<-F> I<changelog-format>"
13990msgstr ""
13991
13992#. type: Plain text
13993#: dpkg-parsechangelog.man:1
13994msgid ""
13995"Specifies the format of the changelog. By default the format is read from a "
13996"special line near the bottom of the changelog or failing that defaults to "
13997"the B<debian> standard format. See also B<CHANGELOG FORMATS>."
13998msgstr ""
13999
14000#. type: TP
14001#: dpkg-parsechangelog.man:1
14002#, no-wrap
14003msgid "B<-L> I<libdir>"
14004msgstr ""
14005
14006#. type: Plain text
14007#: dpkg-parsechangelog.man:1
14008msgid ""
14009"Obsolete option without effect (since dpkg 1.18.8). Setting the perl "
14010"environment variables B<PERL5LIB> or B<PERLLIB> has a similar effect when "
14011"looking for the parser perl modules."
14012msgstr ""
14013
14014#. type: TP
14015#: dpkg-parsechangelog.man:1
14016#, no-wrap
14017msgid "B<-S>, B<--show-field> I<field>"
14018msgstr ""
14019
14020#. type: Plain text
14021#: dpkg-parsechangelog.man:1
14022msgid ""
14023"Specifies the name of the field to show (since dpkg 1.17.0). The field name "
14024"is not printed, only its value."
14025msgstr ""
14026
14027#. type: SS
14028#: dpkg-parsechangelog.man:1
14029#, no-wrap
14030msgid "Parser Options"
14031msgstr ""
14032
14033#. type: Plain text
14034#: dpkg-parsechangelog.man:1
14035msgid ""
14036"The following options can be used to influence the output of the changelog "
14037"parser, e.g. the range of entries or the format of the output."
14038msgstr ""
14039
14040#. type: TP
14041#: dpkg-parsechangelog.man:1
14042#, no-wrap
14043msgid "B<--format>I< output-format>"
14044msgstr ""
14045
14046#. type: Plain text
14047#: dpkg-parsechangelog.man:1
14048msgid ""
14049"Set the output format. Currently supported values are B<dpkg> and "
14050"B<rfc822>. B<dpkg> is the classic output format (from before this option "
14051"existed) and the default. It consists of one paragraph in Debian control "
14052"format (see B<deb-control>(5)). If more than one entry is requested, then "
14053"most fields are taken from the most recent entry, except otherwise stated:"
14054msgstr ""
14055
14056#. type: TP
14057#: dpkg-parsechangelog.man:1
14058#, no-wrap
14059msgid "B<Source:>I< pkg-name>"
14060msgstr ""
14061
14062#. type: TP
14063#: dpkg-parsechangelog.man:1
14064#, no-wrap
14065msgid "B<Version:>I< version>"
14066msgstr ""
14067
14068#. type: TP
14069#: dpkg-parsechangelog.man:1
14070#, no-wrap
14071msgid "B<Distribution:>I< target-distribution>"
14072msgstr ""
14073
14074#. type: TP
14075#: dpkg-parsechangelog.man:1
14076#, no-wrap
14077msgid "B<Urgency:>I< urgency>"
14078msgstr ""
14079
14080#. type: Plain text
14081#: dpkg-parsechangelog.man:1
14082msgid ""
14083"The highest urgency of all included entries is used, followed by the "
14084"concatenated (space-separated) comments from all the versions requested."
14085msgstr ""
14086
14087#. type: TP
14088#: dpkg-parsechangelog.man:1
14089#, no-wrap
14090msgid "B<Maintainer:>I< author>"
14091msgstr ""
14092
14093#. type: TP
14094#: dpkg-parsechangelog.man:1
14095#, no-wrap
14096msgid "B<Date:>I< date>"
14097msgstr ""
14098
14099#. type: Plain text
14100#: dpkg-parsechangelog.man:1
14101msgid ""
14102"The date of the entry as a string, as it appears in the changelog. With a "
14103"B<strptime>(3) format \"B<%a, %d %b %Y %T %z>\", but where the day of the "
14104"week might not actually correspond to the real day obtained from the rest of "
14105"the date string. If you need a more accurate representation of the date, "
14106"use the B<Timestamp> field, but take into account it might not be possible "
14107"to map it back to the exact value in this field."
14108msgstr ""
14109
14110#. type: TP
14111#: dpkg-parsechangelog.man:1
14112#, no-wrap
14113msgid "B<Timestamp:>I< timestamp>"
14114msgstr ""
14115
14116#. type: Plain text
14117#: dpkg-parsechangelog.man:1
14118msgid ""
14119"The date of the entry as a timestamp in seconds since the epoch (since dpkg "
14120"1.18.8)."
14121msgstr ""
14122
14123#. type: TP
14124#: dpkg-parsechangelog.man:1
14125#, no-wrap
14126msgid "B<Closes:>I< bug-number>"
14127msgstr ""
14128
14129#. type: Plain text
14130#: dpkg-parsechangelog.man:1
14131msgid "The Closes fields of all included entries are merged."
14132msgstr ""
14133
14134#. type: TP
14135#: dpkg-parsechangelog.man:1
14136#, no-wrap
14137msgid "B<Changes:>I< changelog-entries>"
14138msgstr ""
14139
14140#. type: Plain text
14141#: dpkg-parsechangelog.man:1
14142msgid ""
14143"The text of all changelog entries is concatenated. To make this field a "
14144"valid Debian control format multiline field empty lines are replaced with a "
14145"single full stop and all lines is intended by one space character. The exact "
14146"content depends on the changelog format."
14147msgstr ""
14148
14149#. type: Plain text
14150#: dpkg-parsechangelog.man:1
14151msgid ""
14152"The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> "
14153"fields are mandatory."
14154msgstr ""
14155
14156#. type: Plain text
14157#: dpkg-parsechangelog.man:1
14158msgid "There might be additional user-defined fields present."
14159msgstr ""
14160
14161#. type: Plain text
14162#: dpkg-parsechangelog.man:1
14163msgid ""
14164"The B<rfc822> format uses the same fields but outputs a separate paragraph "
14165"for each changelog entry so that all metadata for each entry is preserved."
14166msgstr ""
14167
14168#. type: TP
14169#: dpkg-parsechangelog.man:1 update-alternatives.man:1
14170#, no-wrap
14171msgid "B<--all>"
14172msgstr ""
14173
14174#. type: Plain text
14175#: dpkg-parsechangelog.man:1
14176msgid "Include all changes. Note: other options have no effect when this is in use."
14177msgstr ""
14178
14179#. type: TP
14180#: dpkg-parsechangelog.man:1
14181#, no-wrap
14182msgid "B<-s>, B<--since> I<version>"
14183msgstr ""
14184
14185#. type: TQ
14186#: dpkg-parsechangelog.man:1
14187#, no-wrap
14188msgid "B<-v> I<version>"
14189msgstr ""
14190
14191#. type: Plain text
14192#: dpkg-parsechangelog.man:1
14193msgid "Include all changes later than I<version>."
14194msgstr ""
14195
14196#. type: TP
14197#: dpkg-parsechangelog.man:1
14198#, no-wrap
14199msgid "B<-u>, B<--until> I<version>"
14200msgstr ""
14201
14202#. type: Plain text
14203#: dpkg-parsechangelog.man:1
14204msgid "Include all changes earlier than I<version>."
14205msgstr ""
14206
14207#. type: TP
14208#: dpkg-parsechangelog.man:1
14209#, no-wrap
14210msgid "B<-f>, B<--from> I<version>"
14211msgstr ""
14212
14213#. type: Plain text
14214#: dpkg-parsechangelog.man:1
14215msgid "Include all changes equal or later than I<version>."
14216msgstr ""
14217
14218#. type: TP
14219#: dpkg-parsechangelog.man:1
14220#, no-wrap
14221msgid "B<-t>, B<--to> I<version>"
14222msgstr ""
14223
14224#. type: Plain text
14225#: dpkg-parsechangelog.man:1
14226msgid "Include all changes up to or equal than I<version>."
14227msgstr ""
14228
14229#. type: TP
14230#: dpkg-parsechangelog.man:1
14231#, no-wrap
14232msgid "B<-c>, B<--count> I<number>"
14233msgstr ""
14234
14235#. type: TQ
14236#: dpkg-parsechangelog.man:1
14237#, no-wrap
14238msgid "B<-n> I<number>"
14239msgstr ""
14240
14241#. type: Plain text
14242#: dpkg-parsechangelog.man:1
14243msgid ""
14244"Include I<number> entries from the top (or the tail if I<number> is lower "
14245"than 0)."
14246msgstr ""
14247
14248#. type: TP
14249#: dpkg-parsechangelog.man:1
14250#, no-wrap
14251msgid "B<-o>, B<--offset> I<number>"
14252msgstr ""
14253
14254#. type: Plain text
14255#: dpkg-parsechangelog.man:1
14256msgid ""
14257"Change the starting point for B<--count>, counted from the top (or the tail "
14258"if I<number> is lower than 0)."
14259msgstr ""
14260
14261#. type: SH
14262#: dpkg-parsechangelog.man:1
14263#, no-wrap
14264msgid "CHANGELOG FORMATS"
14265msgstr ""
14266
14267#. type: Plain text
14268#: dpkg-parsechangelog.man:1
14269msgid ""
14270"It is possible to use a different format to the standard one, by providing a "
14271"parser for that alternative format."
14272msgstr ""
14273
14274#. type: Plain text
14275#: dpkg-parsechangelog.man:1
14276msgid ""
14277"In order to have B<dpkg-parsechangelog> run the new parser, a line must be "
14278"included within the last 40 lines of the changelog file, matching the Perl "
14279"regular expression: “B<\\eschangelog-format:\\es+([0-9a-z]+)\\eW>”. The "
14280"part in parentheses should be the name of the format. For example:"
14281msgstr ""
14282
14283#. type: Plain text
14284#: dpkg-parsechangelog.man:1
14285#, no-wrap
14286msgid " @@@ changelog-format: I<otherformat> @@@\n"
14287msgstr ""
14288
14289#. type: Plain text
14290#: dpkg-parsechangelog.man:1
14291msgid "Changelog format names are non-empty strings of alphanumerics."
14292msgstr ""
14293
14294#. type: Plain text
14295#: dpkg-parsechangelog.man:1
14296msgid ""
14297"If such a line exists then B<dpkg-parsechangelog> will look for the parser "
14298"as a B<Dpkg::Changelog::>I<Otherformat> perl module; it is an error for it "
14299"not being present. The parser name in the perl module will be automatically "
14300"capitalized. The default changelog format is B<debian>, and a parser for it "
14301"is provided by default."
14302msgstr ""
14303
14304#. type: Plain text
14305#: dpkg-parsechangelog.man:1
14306msgid ""
14307"The parser should be derived from the Dpkg::Changelog class and implement "
14308"the required documented interface."
14309msgstr ""
14310
14311#. type: Plain text
14312#: dpkg-parsechangelog.man:1
14313msgid ""
14314"If the changelog format which is being parsed always or almost always leaves "
14315"a blank line between individual change notes, these blank lines should be "
14316"stripped out, so as to make the resulting output compact."
14317msgstr ""
14318
14319#. type: Plain text
14320#: dpkg-parsechangelog.man:1
14321msgid ""
14322"If the changelog format does not contain date or package name information "
14323"this information should be omitted from the output. The parser should not "
14324"attempt to synthesize it or find it from other sources."
14325msgstr ""
14326
14327#. type: Plain text
14328#: dpkg-parsechangelog.man:1
14329msgid ""
14330"If the changelog does not have the expected format the parser should error "
14331"out, rather than trying to muddle through and possibly generating incorrect "
14332"output."
14333msgstr ""
14334
14335#. type: Plain text
14336#: dpkg-parsechangelog.man:1
14337msgid "A changelog parser may not interact with the user at all."
14338msgstr ""
14339
14340#. type: Plain text
14341#: dpkg-parsechangelog.man:1
14342msgid ""
14343"All B<Parser Options> except for B<-v> are only supported since dpkg "
14344"1.14.16."
14345msgstr ""
14346
14347#. type: Plain text
14348#: dpkg-parsechangelog.man:1
14349msgid ""
14350"Short option parsing with non-bundled values available only since dpkg "
14351"1.18.0."
14352msgstr ""
14353
14354#. type: TP
14355#: dpkg-parsechangelog.man:1
14356#, no-wrap
14357msgid "B<debian/changelog>"
14358msgstr ""
14359
14360#. type: Plain text
14361#: dpkg-parsechangelog.man:1
14362msgid ""
14363"The changelog file, used to obtain version-dependent information about the "
14364"source package, such as the urgency and distribution of an upload, the "
14365"changes made since a particular release, and the source version number "
14366"itself."
14367msgstr ""
14368
14369#. type: Plain text
14370#: dpkg-parsechangelog.man:1
14371msgid "B<deb-changelog>(5)."
14372msgstr ""
14373
14374#. type: TH
14375#: dpkg-query.man:1
14376#, no-wrap
14377msgid "dpkg-query"
14378msgstr ""
14379
14380#. type: Plain text
14381#: dpkg-query.man:1
14382msgid "dpkg-query - a tool to query the dpkg database"
14383msgstr ""
14384
14385#. type: Plain text
14386#: dpkg-query.man:1
14387msgid "B<dpkg-query> [I<option>...] I<command>"
14388msgstr ""
14389
14390#. type: Plain text
14391#: dpkg-query.man:1
14392msgid ""
14393"B<dpkg-query> is a tool to show information about packages listed in the "
14394"B<dpkg> database."
14395msgstr ""
14396
14397#. type: TP
14398#: dpkg-query.man:1
14399#, no-wrap
14400msgid "B<-l>, B<--list> [I<package-name-pattern>...]"
14401msgstr ""
14402
14403#. type: Plain text
14404#: dpkg-query.man:1
14405msgid ""
14406"List packages matching given pattern. If no I<package-name-pattern> is "
14407"given, list all packages in I<%ADMINDIR%/status>, excluding the ones marked "
14408"as not-installed (i.e. those which have been previously purged). Normal "
14409"shell wildcard characters are allowed in I<package-name-pattern>. Please "
14410"note you will probably have to quote I<package-name-pattern> to prevent the "
14411"shell from performing filename expansion. For example this will list all "
14412"package names starting with ``libc6'':"
14413msgstr ""
14414
14415#. type: Plain text
14416#: dpkg-query.man:1
14417#, no-wrap
14418msgid " B<dpkg-query -l 'libc6*'>\n"
14419msgstr ""
14420
14421#. type: Plain text
14422#: dpkg-query.man:1
14423msgid ""
14424"The first three columns of the output show the desired action, the package "
14425"status, and errors, in that order."
14426msgstr ""
14427
14428#. type: Plain text
14429#: dpkg-query.man:1
14430msgid "Desired action:"
14431msgstr ""
14432
14433#. type: Plain text
14434#: dpkg-query.man:1
14435#, no-wrap
14436msgid ""
14437" u = Unknown\n"
14438" i = Install\n"
14439" h = Hold\n"
14440" r = Remove\n"
14441" p = Purge\n"
14442msgstr ""
14443
14444#. type: Plain text
14445#: dpkg-query.man:1
14446msgid "Package status:"
14447msgstr ""
14448
14449#. type: Plain text
14450#: dpkg-query.man:1
14451#, no-wrap
14452msgid ""
14453" n = Not-installed\n"
14454" c = Config-files\n"
14455" H = Half-installed\n"
14456" U = Unpacked\n"
14457" F = Half-configured\n"
14458" W = Triggers-awaiting\n"
14459" t = Triggers-pending\n"
14460" i = Installed\n"
14461msgstr ""
14462
14463#. type: Plain text
14464#: dpkg-query.man:1
14465msgid "Error flags:"
14466msgstr ""
14467
14468#. type: Plain text
14469#: dpkg-query.man:1
14470#, no-wrap
14471msgid ""
14472" E<lt>emptyE<gt> = (none)\n"
14473" R = Reinst-required\n"
14474msgstr ""
14475
14476#. type: Plain text
14477#: dpkg-query.man:1
14478msgid ""
14479"An uppercase status or error letter indicates the package is likely to cause "
14480"severe problems. Please refer to B<dpkg>(1) for information about the above "
14481"states and flags."
14482msgstr ""
14483
14484#. type: Plain text
14485#: dpkg-query.man:1
14486msgid ""
14487"The output format of this option is not configurable, but varies "
14488"automatically to fit the terminal width. It is intended for human readers, "
14489"and is not easily machine-readable. See B<-W> (B<--show>) and "
14490"B<--showformat> for a way to configure the output format."
14491msgstr ""
14492
14493#. type: TP
14494#: dpkg-query.man:1
14495#, no-wrap
14496msgid "B<-W>, B<--show> [I<package-name-pattern>...]"
14497msgstr ""
14498
14499#. type: Plain text
14500#: dpkg-query.man:1
14501msgid ""
14502"Just like the B<--list> option this will list all packages matching the "
14503"given pattern. However the output can be customized using the "
14504"B<--showformat> option. The default output format gives one line per "
14505"matching package, each line having the name (extended with the architecture "
14506"qualifier for B<Multi-Arch> B<same> packages) and installed version of the "
14507"package, separated by a tab."
14508msgstr ""
14509
14510#. type: TP
14511#: dpkg-query.man:1
14512#, no-wrap
14513msgid "B<-s>, B<--status> I<package-name>..."
14514msgstr ""
14515
14516#. type: Plain text
14517#: dpkg-query.man:1
14518msgid ""
14519"Report status of specified package. This just displays the entry in the "
14520"installed package status database. When multiple I<package-name> are listed, "
14521"the requested status entries are separated by an empty line, with the same "
14522"order as specified on the argument list."
14523msgstr ""
14524
14525#. type: TP
14526#: dpkg-query.man:1
14527#, no-wrap
14528msgid "B<-L>, B<--listfiles> I<package-name>..."
14529msgstr ""
14530
14531#. type: Plain text
14532#: dpkg-query.man:1
14533msgid ""
14534"List files installed to your system from I<package-name>. When multiple "
14535"I<package-name> are listed, the requested lists of files are separated by an "
14536"empty line, with the same order as specified on the argument list. However, "
14537"note that files created by package-specific installation-scripts are not "
14538"listed."
14539msgstr ""
14540
14541#. type: TP
14542#: dpkg-query.man:1
14543#, no-wrap
14544msgid "B<--control-list> I<package-name>"
14545msgstr ""
14546
14547#. type: Plain text
14548#: dpkg-query.man:1
14549msgid ""
14550"List control files installed to your system from I<package-name> (since dpkg "
14551"1.16.5). These can be used as input arguments to B<--control-show>."
14552msgstr ""
14553
14554#. type: TP
14555#: dpkg-query.man:1
14556#, no-wrap
14557msgid "B<--control-show> I<package-name> I<control-file>"
14558msgstr ""
14559
14560#. type: Plain text
14561#: dpkg-query.man:1
14562msgid ""
14563"Print the I<control-file> installed to your system from I<package-name> to "
14564"the standard output (since dpkg 1.16.5)."
14565msgstr ""
14566
14567#. type: TP
14568#: dpkg-query.man:1
14569#, no-wrap
14570msgid "B<-c>, B<--control-path> I<package-name> [I<control-file>]"
14571msgstr ""
14572
14573#. type: Plain text
14574#: dpkg-query.man:1
14575msgid ""
14576"List paths for control files installed to your system from I<package-name> "
14577"(since dpkg 1.15.4). If I<control-file> is specified then only list the "
14578"path for that control file if it is present."
14579msgstr ""
14580
14581#. type: Plain text
14582#: dpkg-query.man:1
14583msgid ""
14584"B<Warning>: this command is deprecated as it gives direct access to the "
14585"internal dpkg database, please switch to use B<--control-list> and "
14586"B<--control-show> instead for all cases where those commands might give the "
14587"same end result. Although, as long as there is still at least one case where "
14588"this command is needed (i.e. when having to remove a damaging postrm "
14589"maintainer script), and while there is no good solution for that, this "
14590"command will not get removed."
14591msgstr ""
14592
14593#. type: TP
14594#: dpkg-query.man:1
14595#, no-wrap
14596msgid "B<-S>, B<--search> I<filename-search-pattern>..."
14597msgstr ""
14598
14599#. type: Plain text
14600#: dpkg-query.man:1
14601msgid ""
14602"Search for packages that own files corresponding to the given pattern. "
14603"Standard shell wildcard characters can be used in the pattern, where "
14604"asterisk (B<*>) and question mark (B<?>) will match a slash, and blackslash "
14605"(B<\\e>) will be used as an escape character."
14606msgstr ""
14607
14608#. type: Plain text
14609#: dpkg-query.man:1
14610msgid ""
14611"If the first character in the I<filename-search-pattern> is none of "
14612"‘B<*[?/>’ then it will be considered a substring match and will be "
14613"implicitly surrounded by ‘B<*>’ (as in B<*>I<filename-search-pattern>B<*>). "
14614"If the subsequent string contains any of ‘B<*[?\\e>’, then it will handled "
14615"like a glob pattern, otherwise any trailing ‘B</>’ or ‘B</.>’ will be "
14616"removed and a literal path lookup will be performed."
14617msgstr ""
14618
14619#. type: Plain text
14620#: dpkg-query.man:1
14621msgid ""
14622"This command will not list extra files created by maintainer scripts, nor "
14623"will it list alternatives."
14624msgstr ""
14625
14626#. type: TP
14627#: dpkg-query.man:1
14628#, no-wrap
14629msgid "B<-p>, B<--print-avail> I<package-name>..."
14630msgstr ""
14631
14632#. type: Plain text
14633#: dpkg-query.man:1
14634msgid ""
14635"Display details about I<package-name>, as found in "
14636"I<%ADMINDIR%/available>. When multiple I<package-name> are listed, the "
14637"requested I<available> entries are separated by an empty line, with the same "
14638"order as specified on the argument list."
14639msgstr ""
14640
14641#. type: Plain text
14642#: dpkg-query.man:1
14643msgid ""
14644"Users of APT-based frontends should use B<apt-cache show> I<package-name> "
14645"instead as the I<available> file is only kept up-to-date when using "
14646"B<dselect>."
14647msgstr ""
14648
14649#. type: Plain text
14650#: dpkg-query.man:1 dpkg-trigger.man:1
14651msgid ""
14652"Change the location of the B<dpkg> database. The default location is "
14653"I<%ADMINDIR%>."
14654msgstr ""
14655
14656#. type: TP
14657#: dpkg-query.man:1
14658#, no-wrap
14659msgid "B<--load-avail>"
14660msgstr ""
14661
14662#. type: Plain text
14663#: dpkg-query.man:1
14664msgid ""
14665"Also load the available file when using the B<--show> and B<--list> "
14666"commands, which now default to only querying the status file (since dpkg "
14667"1.16.2)."
14668msgstr ""
14669
14670#. type: TP
14671#: dpkg-query.man:1
14672#, no-wrap
14673msgid "B<-f>, B<--showformat=>I<format>"
14674msgstr ""
14675
14676#. type: Plain text
14677#: dpkg-query.man:1
14678msgid "In the format string, “B<\\e>” introduces escapes:"
14679msgstr ""
14680
14681#. type: Plain text
14682#: dpkg-query.man:1
14683#, no-wrap
14684msgid ""
14685" B<\\en> newline\n"
14686" B<\\er> carriage return\n"
14687" B<\\et> tab\n"
14688msgstr ""
14689
14690#. type: Plain text
14691#: dpkg-query.man:1
14692msgid ""
14693"“B<\\e>” before any other character suppresses any special meaning of the "
14694"following character, which is useful for “B<\\e>” and “B<$>”."
14695msgstr ""
14696
14697#. type: Plain text
14698#: dpkg-query.man:1
14699msgid ""
14700"Package information can be included by inserting variable references to "
14701"package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”. Fields "
14702"are printed right-aligned unless the width is negative in which case left "
14703"alignment will be used. The following I<field>s are recognized but they are "
14704"not necessarily available in the status file (only internal fields or fields "
14705"stored in the binary package end up in it):"
14706msgstr ""
14707
14708#. type: Plain text
14709#: dpkg-query.man:1
14710#, no-wrap
14711msgid ""
14712" B<Architecture>\n"
14713" B<Bugs>\n"
14714" B<Conffiles> (internal)\n"
14715" B<Config-Version> (internal)\n"
14716" B<Conflicts>\n"
14717" B<Breaks>\n"
14718" B<Depends>\n"
14719" B<Description>\n"
14720" B<Enhances>\n"
14721" B<Essential>\n"
14722" B<Filename> (internal, front-end related)\n"
14723" B<Homepage>\n"
14724" B<Installed-Size>\n"
14725" B<MD5sum> (internal, front-end related)\n"
14726" B<MSDOS-Filename> (internal, front-end related)\n"
14727" B<Maintainer>\n"
14728" B<Origin>\n"
14729" B<Package>\n"
14730" B<Pre-Depends>\n"
14731" B<Priority>\n"
14732" B<Provides>\n"
14733" B<Recommends>\n"
14734" B<Replaces>\n"
14735" B<Revision> (obsolete)\n"
14736" B<Section>\n"
14737" B<Size> (internal, front-end related)\n"
14738" B<Source>\n"
14739" B<Status> (internal)\n"
14740" B<Suggests>\n"
14741" B<Tag> (usually not in .deb but in repository Packages files)\n"
14742" B<Triggers-Awaited> (internal)\n"
14743" B<Triggers-Pending> (internal)\n"
14744" B<Version>\n"
14745msgstr ""
14746
14747#. type: Plain text
14748#: dpkg-query.man:1
14749msgid ""
14750"The following are virtual fields, generated by B<dpkg-query> from values "
14751"from other fields (note that these do not use valid names for fields in "
14752"control files):"
14753msgstr ""
14754
14755#. type: TP
14756#: dpkg-query.man:1
14757#, no-wrap
14758msgid "B<binary:Package>"
14759msgstr ""
14760
14761#. type: Plain text
14762#: dpkg-query.man:1
14763msgid ""
14764"It contains the binary package name with a possible architecture qualifier "
14765"like “libc6:amd64” (since dpkg 1.16.2). An architecture qualifier will be "
14766"present to make the package name unambiguous, for example if the package has "
14767"a B<Multi-Arch> field with a value of B<same> or the package is of a foreign "
14768"architecture."
14769msgstr ""
14770
14771#. type: TP
14772#: dpkg-query.man:1
14773#, no-wrap
14774msgid "B<binary:Summary>"
14775msgstr ""
14776
14777#. type: Plain text
14778#: dpkg-query.man:1
14779msgid "It contains the package short description (since dpkg 1.16.2)."
14780msgstr ""
14781
14782#. type: TP
14783#: dpkg-query.man:1
14784#, no-wrap
14785msgid "B<db:Status-Abbrev>"
14786msgstr ""
14787
14788#. type: Plain text
14789#: dpkg-query.man:1
14790msgid ""
14791"It contains the abbreviated package status (as three characters), such as "
14792"“ii ” or “iHR” (since dpkg 1.16.2). See the B<--list> command description "
14793"for more details."
14794msgstr ""
14795
14796#. type: TP
14797#: dpkg-query.man:1
14798#, no-wrap
14799msgid "B<db:Status-Want>"
14800msgstr ""
14801
14802#. type: Plain text
14803#: dpkg-query.man:1
14804msgid ""
14805"It contains the package wanted status, part of the Status field (since dpkg "
14806"1.17.11)."
14807msgstr ""
14808
14809#. type: TP
14810#: dpkg-query.man:1
14811#, no-wrap
14812msgid "B<db:Status-Status>"
14813msgstr ""
14814
14815#. type: Plain text
14816#: dpkg-query.man:1
14817msgid ""
14818"It contains the package status word, part of the Status field (since dpkg "
14819"1.17.11)."
14820msgstr ""
14821
14822#. type: TP
14823#: dpkg-query.man:1
14824#, no-wrap
14825msgid "B<db:Status-Eflag>"
14826msgstr ""
14827
14828#. type: Plain text
14829#: dpkg-query.man:1
14830msgid ""
14831"It contains the package status error flag, part of the Status field (since "
14832"dpkg 1.17.11)."
14833msgstr ""
14834
14835#. type: TP
14836#: dpkg-query.man:1
14837#, no-wrap
14838msgid "B<source:Package>"
14839msgstr ""
14840
14841#. type: Plain text
14842#: dpkg-query.man:1
14843msgid ""
14844"It contains the source package name for this binary package (since dpkg "
14845"1.16.2)."
14846msgstr ""
14847
14848#. type: Plain text
14849#: dpkg-query.man:1
14850msgid ""
14851"It contains the source package version for this binary package (since dpkg "
14852"1.16.2)"
14853msgstr ""
14854
14855#. type: Plain text
14856#: dpkg-query.man:1
14857msgid ""
14858"It contains the source package upstream version for this binary package "
14859"(since dpkg 1.18.16)"
14860msgstr ""
14861
14862#. type: Plain text
14863#: dpkg-query.man:1
14864msgid ""
14865"The default format string is “B<${binary:Package}\\et${Version}\\en>”. "
14866"Actually, all other fields found in the status file (i.e. user defined "
14867"fields) can be requested, too. They will be printed as-is, though, no "
14868"conversion nor error checking is done on them. To get the name of the "
14869"B<dpkg> maintainer and the installed version, you could run:"
14870msgstr ""
14871
14872#. type: Plain text
14873#: dpkg-query.man:1
14874#, no-wrap
14875msgid ""
14876" B<dpkg-query -W -f='${binary:Package} ${Version}\\et${Maintainer}\\en' "
14877"dpkg>\n"
14878msgstr ""
14879
14880#. type: Plain text
14881#: dpkg-query.man:1
14882msgid "The requested query was successfully performed."
14883msgstr ""
14884
14885#. type: Plain text
14886#: dpkg-query.man:1
14887msgid ""
14888"The requested query failed either fully or partially, due to no file or "
14889"package being found (except for B<--control-path>, B<--control-list> and "
14890"B<--control-show> were such errors are fatal)."
14891msgstr ""
14892
14893#. type: Plain text
14894#: dpkg-query.man:1
14895msgid ""
14896"This setting influences the output of the B<--list> option by changing the "
14897"width of its output."
14898msgstr ""
14899
14900#. type: TH
14901#: dpkg-scanpackages.man:1
14902#, no-wrap
14903msgid "dpkg-scanpackages"
14904msgstr ""
14905
14906#. type: Plain text
14907#: dpkg-scanpackages.man:1
14908msgid "dpkg-scanpackages - create Packages index files"
14909msgstr ""
14910
14911#. type: Plain text
14912#: dpkg-scanpackages.man:1
14913msgid ""
14914"B<dpkg-scanpackages> [I<option>...] I<binary-path> [I<override-file> "
14915"[I<path-prefix>]] B<E<gt>> I<Packages>"
14916msgstr ""
14917
14918#. type: Plain text
14919#: dpkg-scanpackages.man:1
14920msgid ""
14921"B<dpkg-scanpackages> sorts through a tree of Debian binary packages and "
14922"creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the "
14923"user what packages are available for installation. These Packages files are "
14924"the same as those found on Debian archive sites and CD-ROMs. You might use "
14925"B<dpkg-scanpackages> yourself if making a directory of local packages to "
14926"install on a cluster of machines."
14927msgstr ""
14928
14929#. type: Plain text
14930#: dpkg-scanpackages.man:1
14931msgid ""
14932"B<Note:> If you want to access the generated Packages file with B<apt> you "
14933"will probably need to compress the file with B<xz>(1) (generating a "
14934"Packages.xz file), B<bzip2>(1) (generating a Packages.bz2 file) or "
14935"B<gzip>(1) (generating a Packages.gz file). apt ignores uncompressed "
14936"Packages files except on local access (i.e. B<file://> sources)."
14937msgstr ""
14938
14939#. type: Plain text
14940#: dpkg-scanpackages.man:1
14941msgid ""
14942"I<binary-path> is the name of the tree of the binary packages to process "
14943"(for example, B<contrib/binary-i386>). It is best to make this relative to "
14944"the root of the Debian archive, because every Filename field in the new "
14945"Packages file will start with this string."
14946msgstr ""
14947
14948#. type: Plain text
14949#: dpkg-scanpackages.man:1
14950msgid ""
14951"I<override-file> is the name of a file to read which contains information "
14952"about how the package fits into the distribution (the file can be compressed "
14953"since dpkg 1.15.5); see B<deb-override>(5)."
14954msgstr ""
14955
14956#. type: Plain text
14957#: dpkg-scanpackages.man:1
14958msgid "I<path-prefix> is an optional string to be prepended to the Filename fields."
14959msgstr ""
14960
14961#. type: Plain text
14962#: dpkg-scanpackages.man:1
14963msgid ""
14964"If more than one version of a package is found only the newest one is "
14965"included in the output. If they have the same version and only differ in "
14966"architecture only the first one found is used."
14967msgstr ""
14968
14969#. type: TP
14970#: dpkg-scanpackages.man:1
14971#, no-wrap
14972msgid "B<-t>, B<--type> I<type>"
14973msgstr ""
14974
14975#. type: Plain text
14976#: dpkg-scanpackages.man:1
14977msgid "Scan for *.I<type> packages, instead of *.deb."
14978msgstr ""
14979
14980#. type: IP
14981#: dpkg-scanpackages.man:1 dpkg-scansources.man:1
14982#, no-wrap
14983msgid "B<-e>, B<--extra-override> I<file>"
14984msgstr ""
14985
14986#. type: Plain text
14987#: dpkg-scanpackages.man:1
14988msgid ""
14989"Scan I<file> to find supplementary overrides (the file can be compressed "
14990"since dpkg 1.15.5). See B<deb-extra-override>(5) for more information on "
14991"its format."
14992msgstr ""
14993
14994#. type: TP
14995#: dpkg-scanpackages.man:1
14996#, no-wrap
14997msgid "B<-a>, B<--arch> I<arch>"
14998msgstr ""
14999
15000#. type: Plain text
15001#: dpkg-scanpackages.man:1
15002msgid ""
15003"Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of "
15004"scanning for all debs."
15005msgstr ""
15006
15007#. type: TP
15008#: dpkg-scanpackages.man:1
15009#, no-wrap
15010msgid "B<-h>, B<--hash> I<hash-list>"
15011msgstr ""
15012
15013#. type: Plain text
15014#: dpkg-scanpackages.man:1
15015msgid ""
15016"Only generate file hashes for the comma-specified list specified (since dpkg "
15017"1.17.14). The default is to generate all currently supported hashes. "
15018"Supported values: B<md5>, B<sha1>, B<sha256>."
15019msgstr ""
15020
15021#. type: TP
15022#: dpkg-scanpackages.man:1
15023#, no-wrap
15024msgid "B<-m>, B<--multiversion>"
15025msgstr ""
15026
15027#. type: Plain text
15028#: dpkg-scanpackages.man:1
15029msgid "Include all found packages in the output."
15030msgstr ""
15031
15032#. type: TP
15033#: dpkg-scanpackages.man:1
15034#, no-wrap
15035msgid "B<-M>, B<--medium> I<id-string>"
15036msgstr ""
15037
15038#. type: Plain text
15039#: dpkg-scanpackages.man:1
15040msgid ""
15041"Add an B<X-Medium> field containing the value I<id-string> (since dpkg "
15042"1.15.5). This field is required if you want to generate B<Packages.cd> "
15043"files for use by the multicd access method of dselect."
15044msgstr ""
15045
15046#. type: SH
15047#: dpkg-scanpackages.man:1 dpkg-shlibdeps.man:1 dpkg-source.man:1
15048#: update-alternatives.man:1
15049#, no-wrap
15050msgid "DIAGNOSTICS"
15051msgstr ""
15052
15053#. type: Plain text
15054#: dpkg-scanpackages.man:1
15055msgid ""
15056"B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also "
15057"warns about packages that are in the wrong subdirectory, are duplicated, "
15058"have a Filename field in their control file, are missing from the override "
15059"file, or have maintainer substitutions which do not take effect."
15060msgstr ""
15061
15062#. type: Plain text
15063#: dpkg-scanpackages.man:1
15064msgid ""
15065"B<dpkg>(1), B<dselect>(1), B<deb-override>(5), B<deb-extra-override>(5), "
15066"B<dpkg-scansources>(1)."
15067msgstr ""
15068
15069#. type: TH
15070#: dpkg-scansources.man:1
15071#, no-wrap
15072msgid "dpkg-scansources"
15073msgstr ""
15074
15075#. type: Plain text
15076#: dpkg-scansources.man:1
15077msgid "dpkg-scansources - create Sources index files"
15078msgstr ""
15079
15080#. type: Plain text
15081#: dpkg-scansources.man:1
15082msgid ""
15083"B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> "
15084"[I<path-prefix>]] B<E<gt>> I<Sources>"
15085msgstr ""
15086
15087#. type: Plain text
15088#: dpkg-scansources.man:1
15089msgid ""
15090"B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files. These "
15091"are used to create a Debian source index, which is output to stdout."
15092msgstr ""
15093
15094#. type: Plain text
15095#: dpkg-scansources.man:1
15096msgid ""
15097"The I<override-file>, if given, is used to set priorities in the resulting "
15098"index records and to override the maintainer field given in the I<.dsc> "
15099"files. The file can be compressed (since dpkg 1.15.5). See "
15100"B<deb-override>(5) for the format of this file. Note: Since the override "
15101"file is indexed by binary, not source packages, there's a bit of a problem "
15102"here. The current implementation uses the highest priority of all the binary "
15103"packages produced by a I<.dsc> file for the priority of the source package, "
15104"and the override entry for the first binary package listed in the I<.dsc> "
15105"file to modify maintainer information. This might change."
15106msgstr ""
15107
15108#. type: Plain text
15109#: dpkg-scansources.man:1
15110msgid ""
15111"The I<path-prefix>, if given, is prepended to the directory field in the "
15112"generated source index. You generally use this to make the directory fields "
15113"contain the path from the top of the Debian archive hierarchy."
15114msgstr ""
15115
15116#. type: Plain text
15117#: dpkg-scansources.man:1
15118msgid ""
15119"B<Note:> If you want to access the generated Sources file with B<apt>(8) "
15120"you will probably need to compress the file with B<gzip>(1) (generating a "
15121"Sources.gz file). apt ignores uncompressed Sources files except on local "
15122"access (i.e. B<file://> sources)."
15123msgstr ""
15124
15125#. type: IP
15126#: dpkg-scansources.man:1
15127#, no-wrap
15128msgid "B<-n>, B<--no-sort>"
15129msgstr ""
15130
15131#. type: Plain text
15132#: dpkg-scansources.man:1
15133msgid ""
15134"Don't sort the index records. Normally they are sorted by source package "
15135"name."
15136msgstr ""
15137
15138#. type: Plain text
15139#: dpkg-scansources.man:1
15140msgid ""
15141"Scan I<file> to find supplementary overrides (since dpkg 1.15.4; the file "
15142"can be compressed since dpkg 1.15.5). See B<deb-extra-override>(5) for "
15143"more information on its format."
15144msgstr ""
15145
15146#. type: IP
15147#: dpkg-scansources.man:1
15148#, no-wrap
15149msgid "B<-s>, B<--source-override> I<file>"
15150msgstr ""
15151
15152#. type: Plain text
15153#: dpkg-scansources.man:1
15154msgid ""
15155"Use I<file> as the source override file (the file can be compressed since "
15156"dpkg 1.15.5). The default is the name of the override file you specified "
15157"with I<.src> appended."
15158msgstr ""
15159
15160#. type: Plain text
15161#: dpkg-scansources.man:1
15162msgid ""
15163"The source override file is in a different format from the binary override "
15164"file. It contains only two whitespace separated fields, the first is the "
15165"source package name and the second is the section. Blank lines and comment "
15166"lines are ignored in the normal manner. If a package appears in both files "
15167"the source override takes precedence for setting the section."
15168msgstr ""
15169
15170#. type: IP
15171#: dpkg-scansources.man:1
15172#, no-wrap
15173msgid "B<--debug>"
15174msgstr ""
15175
15176#. type: Plain text
15177#: dpkg-scansources.man:1
15178msgid "Turn debugging on."
15179msgstr ""
15180
15181#. type: Plain text
15182#: dpkg-scansources.man:1
15183msgid "B<deb-override>(5), B<deb-extra-override>(5), B<dpkg-scanpackages>(1)."
15184msgstr ""
15185
15186#. type: TH
15187#: dpkg-shlibdeps.man:1
15188#, no-wrap
15189msgid "dpkg-shlibdeps"
15190msgstr ""
15191
15192#. type: Plain text
15193#: dpkg-shlibdeps.man:1
15194msgid "dpkg-shlibdeps - generate shared library substvar dependencies"
15195msgstr ""
15196
15197#. type: Plain text
15198#: dpkg-shlibdeps.man:1
15199msgid "B<dpkg-shlibdeps> [I<option>...] [B<-e>]I<executable> [I<option>...]"
15200msgstr ""
15201
15202#. type: Plain text
15203#: dpkg-shlibdeps.man:1
15204msgid ""
15205"B<dpkg-shlibdeps> calculates shared library dependencies for executables "
15206"named in its arguments. The dependencies are added to the substitution "
15207"variables file B<debian/substvars> as variable names "
15208"B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency "
15209"field name. Any other variables starting with B<shlibs:> are removed from "
15210"the file."
15211msgstr ""
15212
15213#. type: Plain text
15214#: dpkg-shlibdeps.man:1
15215msgid ""
15216"B<dpkg-shlibdeps> has two possible sources of information to generate "
15217"dependency information. Either I<symbols> files or I<shlibs> files. For each "
15218"binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries "
15219"that it's linked with. Then, for each library, it looks up either the "
15220"I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if "
15221"debian/shlibs.local contains the relevant dependency). Both files are "
15222"supposed to be provided by the library package and should thus be available "
15223"as %ADMINDIR%/info/I<package>.I<symbols> or "
15224"%ADMINDIR%/info/I<package>.I<shlibs>. The package name is identified in two "
15225"steps: find the library file on the system (looking in the same directories "
15226"that B<ld.so> would use), then use B<dpkg -S >I<library-file> to lookup the "
15227"package providing the library."
15228msgstr ""
15229
15230#. type: SS
15231#: dpkg-shlibdeps.man:1
15232#, no-wrap
15233msgid "Symbols files"
15234msgstr ""
15235
15236#. type: Plain text
15237#: dpkg-shlibdeps.man:1
15238msgid ""
15239"Symbols files contain finer-grained dependency information by providing the "
15240"minimum dependency for each symbol that the library exports. The script "
15241"tries to find a symbols file associated to a library package in the "
15242"following places (first match is used):"
15243msgstr ""
15244
15245#. type: IP
15246#: dpkg-shlibdeps.man:1
15247#, no-wrap
15248msgid "debian/*/DEBIAN/symbols"
15249msgstr ""
15250
15251#. type: Plain text
15252#: dpkg-shlibdeps.man:1
15253msgid ""
15254"Shared library information generated by the current build process that also "
15255"invoked B<dpkg-shlibdeps>. They are generated by B<dpkg-gensymbols>(1). "
15256"They are only used if the library is found in a package's build tree. The "
15257"symbols file in that build tree takes precedence over symbols files from "
15258"other binary packages."
15259msgstr ""
15260
15261#. type: IP
15262#: dpkg-shlibdeps.man:1
15263#, no-wrap
15264msgid "%PKGCONFDIR%/symbols/I<package>.symbols.I<arch>"
15265msgstr ""
15266
15267#. type: IP
15268#: dpkg-shlibdeps.man:1
15269#, no-wrap
15270msgid "%PKGCONFDIR%/symbols/I<package>.symbols"
15271msgstr ""
15272
15273#. type: Plain text
15274#: dpkg-shlibdeps.man:1
15275msgid ""
15276"Per-system overriding shared library dependency information. I<arch> is the "
15277"architecture of the current system (obtained by B<dpkg-architecture "
15278"-qDEB_HOST_ARCH>)."
15279msgstr ""
15280
15281#. type: IP
15282#: dpkg-shlibdeps.man:1
15283#, no-wrap
15284msgid "Output from “B<dpkg-query --control-path> I<package> symbols”"
15285msgstr ""
15286
15287#. type: Plain text
15288#: dpkg-shlibdeps.man:1 dpkg-shlibdeps.man:1
15289msgid ""
15290"Package-provided shared library dependency information. Unless overridden "
15291"by B<--admindir>, those files are located in %ADMINDIR%."
15292msgstr ""
15293
15294#. type: Plain text
15295#: dpkg-shlibdeps.man:1
15296msgid ""
15297"While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers "
15298"the (biggest) minimal version needed for each library. At the end of the "
15299"process, it is able to write out the minimal dependency for every library "
15300"used (provided that the information of the I<symbols> files are accurate)."
15301msgstr ""
15302
15303#. type: Plain text
15304#: dpkg-shlibdeps.man:1
15305msgid ""
15306"As a safe-guard measure, a symbols file can provide a "
15307"B<Build-Depends-Package> meta-information field and B<dpkg-shlibdeps> will "
15308"extract the minimal version required by the corresponding package in the "
15309"B<Build-Depends> field and use this version if it's higher than the minimal "
15310"version computed by scanning symbols."
15311msgstr ""
15312
15313#. type: SS
15314#: dpkg-shlibdeps.man:1
15315#, no-wrap
15316msgid "Shlibs files"
15317msgstr ""
15318
15319#. type: Plain text
15320#: dpkg-shlibdeps.man:1
15321msgid ""
15322"Shlibs files associate directly a library to a dependency (without looking "
15323"at the symbols). It's thus often stronger than really needed but very safe "
15324"and easy to handle."
15325msgstr ""
15326
15327#. type: Plain text
15328#: dpkg-shlibdeps.man:1
15329msgid ""
15330"The dependencies for a library are looked up in several places. The first "
15331"file providing information for the library of interest is used:"
15332msgstr ""
15333
15334#. type: IP
15335#: dpkg-shlibdeps.man:1
15336#, no-wrap
15337msgid "debian/shlibs.local"
15338msgstr ""
15339
15340#. type: Plain text
15341#: dpkg-shlibdeps.man:1
15342msgid "Package-local overriding shared library dependency information."
15343msgstr ""
15344
15345#. type: IP
15346#: dpkg-shlibdeps.man:1
15347#, no-wrap
15348msgid "%PKGCONFDIR%/shlibs.override"
15349msgstr ""
15350
15351#. type: Plain text
15352#: dpkg-shlibdeps.man:1
15353msgid "Per-system overriding shared library dependency information."
15354msgstr ""
15355
15356#. type: IP
15357#: dpkg-shlibdeps.man:1
15358#, no-wrap
15359msgid "debian/*/DEBIAN/shlibs"
15360msgstr ""
15361
15362#. type: Plain text
15363#: dpkg-shlibdeps.man:1
15364msgid ""
15365"Shared library information generated by the current build process that also "
15366"invoked B<dpkg-shlibdeps>. They are only used if the library is found in a "
15367"package's build tree. The shlibs file in that build tree takes precedence "
15368"over shlibs files from other binary packages."
15369msgstr ""
15370
15371#. type: IP
15372#: dpkg-shlibdeps.man:1
15373#, no-wrap
15374msgid "Output from “B<dpkg-query --control-path> I<package> shlibs”"
15375msgstr ""
15376
15377#. type: IP
15378#: dpkg-shlibdeps.man:1
15379#, no-wrap
15380msgid "%PKGCONFDIR%/shlibs.default"
15381msgstr ""
15382
15383#. type: Plain text
15384#: dpkg-shlibdeps.man:1
15385msgid "Per-system default shared library dependency information."
15386msgstr ""
15387
15388#. type: Plain text
15389#: dpkg-shlibdeps.man:1
15390msgid ""
15391"The extracted dependencies are then directly used (except if they are "
15392"filtered out because they have been identified as duplicate, or as weaker "
15393"than another dependency)."
15394msgstr ""
15395
15396#. type: Plain text
15397#: dpkg-shlibdeps.man:1
15398msgid ""
15399"B<dpkg-shlibdeps> interprets non-option arguments as executable names, just "
15400"as if they'd been supplied as B<-e>I<executable>."
15401msgstr ""
15402
15403#. type: TP
15404#: dpkg-shlibdeps.man:1
15405#, no-wrap
15406msgid "B<-e>I<executable>"
15407msgstr ""
15408
15409#. type: Plain text
15410#: dpkg-shlibdeps.man:1
15411msgid ""
15412"Include dependencies appropriate for the shared libraries required by "
15413"I<executable>. This option can be used multiple times."
15414msgstr ""
15415
15416#. type: TP
15417#: dpkg-shlibdeps.man:1
15418#, no-wrap
15419msgid "B<-l>I<directory>"
15420msgstr ""
15421
15422#. type: Plain text
15423#: dpkg-shlibdeps.man:1
15424msgid ""
15425"Prepend I<directory> to the list of directories to search for private shared "
15426"libraries (since dpkg 1.17.0). This option can be used multiple times."
15427msgstr ""
15428
15429#. type: Plain text
15430#: dpkg-shlibdeps.man:1
15431msgid ""
15432"Note: Use this option instead of setting B<LD_LIBRARY_PATH>, as that "
15433"environment variable is used to control the run-time linker and abusing it "
15434"to set the shared library paths at build-time can be problematic when "
15435"cross-compiling for example."
15436msgstr ""
15437
15438#. type: TP
15439#: dpkg-shlibdeps.man:1
15440#, no-wrap
15441msgid "B<-d>I<dependency-field>"
15442msgstr ""
15443
15444#. type: Plain text
15445#: dpkg-shlibdeps.man:1
15446msgid ""
15447"Add dependencies to be added to the control file dependency field "
15448"I<dependency-field>. (The dependencies for this field are placed in the "
15449"variable B<shlibs:>I<dependency-field>.)"
15450msgstr ""
15451
15452#. type: Plain text
15453#: dpkg-shlibdeps.man:1
15454msgid ""
15455"The B<-d>I<dependency-field> option takes effect for all executables after "
15456"the option, until the next B<-d>I<dependency-field>. The default "
15457"I<dependency-field> is B<Depends>."
15458msgstr ""
15459
15460#. type: Plain text
15461#: dpkg-shlibdeps.man:1
15462msgid ""
15463"If the same dependency entry (or set of alternatives) appears in more than "
15464"one of the recognized dependency field names B<Pre-Depends>, B<Depends>, "
15465"B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will "
15466"automatically remove the dependency from all fields except the one "
15467"representing the most important dependencies."
15468msgstr ""
15469
15470#. type: TP
15471#: dpkg-shlibdeps.man:1
15472#, no-wrap
15473msgid "B<-p>I<varname-prefix>"
15474msgstr ""
15475
15476#. type: Plain text
15477#: dpkg-shlibdeps.man:1
15478msgid ""
15479"Start substitution variables with I<varname-prefix>B<:> instead of "
15480"B<shlibs:>. Likewise, any existing substitution variables starting with "
15481"I<varname-prefix>B<:> (rather than B<shlibs:>) are removed from the "
15482"substitution variables file."
15483msgstr ""
15484
15485#. type: Plain text
15486#: dpkg-shlibdeps.man:1
15487msgid ""
15488"Print substitution variable settings to standard output (or I<filename> if "
15489"specified, since dpkg 1.17.2), rather than being added to the substitution "
15490"variables file (B<debian/substvars> by default)."
15491msgstr ""
15492
15493#. type: TP
15494#: dpkg-shlibdeps.man:1
15495#, no-wrap
15496msgid "B<-t>I<type>"
15497msgstr ""
15498
15499#. type: Plain text
15500#: dpkg-shlibdeps.man:1
15501msgid ""
15502"Prefer shared library dependency information tagged for the given package "
15503"type. If no tagged information is available, falls back to untagged "
15504"information. The default package type is B<deb>. Shared library dependency "
15505"information is tagged for a given type by prefixing it with the name of the "
15506"type, a colon, and whitespace."
15507msgstr ""
15508
15509#. type: TP
15510#: dpkg-shlibdeps.man:1
15511#, no-wrap
15512msgid "B<-L>I<local-shlibs-file>"
15513msgstr ""
15514
15515#. type: Plain text
15516#: dpkg-shlibdeps.man:1
15517msgid ""
15518"Read overriding shared library dependency information from "
15519"I<local-shlibs-file> instead of B<debian/shlibs.local>."
15520msgstr ""
15521
15522#. type: Plain text
15523#: dpkg-shlibdeps.man:1
15524msgid ""
15525"Write substitution variables in I<substvars-file>; the default is "
15526"B<debian/substvars>."
15527msgstr ""
15528
15529#. type: TP
15530#: dpkg-shlibdeps.man:1
15531#, no-wrap
15532msgid "B<-v>"
15533msgstr ""
15534
15535#. type: Plain text
15536#: dpkg-shlibdeps.man:1
15537msgid ""
15538"Enable verbose mode (since dpkg 1.14.8). Numerous messages are displayed to "
15539"explain what B<dpkg-shlibdeps> does."
15540msgstr ""
15541
15542#. type: TP
15543#: dpkg-shlibdeps.man:1
15544#, no-wrap
15545msgid "B<-x>I<package>"
15546msgstr ""
15547
15548#. type: Plain text
15549#: dpkg-shlibdeps.man:1
15550msgid ""
15551"Exclude the package from the generated dependencies (since dpkg 1.14.8). "
15552"This is useful to avoid self-dependencies for packages which provide ELF "
15553"binaries (executables or library plugins) using a library contained in the "
15554"same package. This option can be used multiple times to exclude several "
15555"packages."
15556msgstr ""
15557
15558#. type: TP
15559#: dpkg-shlibdeps.man:1
15560#, no-wrap
15561msgid "B<-S>I<package-build-dir>"
15562msgstr ""
15563
15564#. type: Plain text
15565#: dpkg-shlibdeps.man:1
15566msgid ""
15567"Look into I<package-build-dir> first when trying to find a library (since "
15568"dpkg 1.14.15). This is useful when the source package builds multiple "
15569"flavors of the same library and you want to ensure that you get the "
15570"dependency from a given binary package. You can use this option multiple "
15571"times: directories will be tried in the same order before directories of "
15572"other binary packages."
15573msgstr ""
15574
15575#. type: TP
15576#: dpkg-shlibdeps.man:1
15577#, no-wrap
15578msgid "B<-I>I<package-build-dir>"
15579msgstr ""
15580
15581#. type: Plain text
15582#: dpkg-shlibdeps.man:1
15583msgid ""
15584"Ignore I<package-build-dir> when looking for shlibs, symbols, and shared "
15585"library files (since dpkg 1.18.5). You can use this option multiple times."
15586msgstr ""
15587
15588#. type: TP
15589#: dpkg-shlibdeps.man:1
15590#, no-wrap
15591msgid "B<--ignore-missing-info>"
15592msgstr ""
15593
15594#. type: Plain text
15595#: dpkg-shlibdeps.man:1
15596msgid ""
15597"Do not fail if dependency information can't be found for a shared library "
15598"(since dpkg 1.14.8). Usage of this option is discouraged, all libraries "
15599"should provide dependency information (either with shlibs files, or with "
15600"symbols files) even if they are not yet used by other packages."
15601msgstr ""
15602
15603#. type: TP
15604#: dpkg-shlibdeps.man:1
15605#, no-wrap
15606msgid "B<--warnings=>I<value>"
15607msgstr ""
15608
15609#. type: Plain text
15610#: dpkg-shlibdeps.man:1
15611msgid ""
15612"I<value> is a bit field defining the set of warnings that can be emitted by "
15613"B<dpkg-shlibdeps> (since dpkg 1.14.17). Bit 0 (value=1) enables the warning "
15614"“symbol I<sym> used by I<binary> found in none of the libraries”, bit 1 "
15615"(value=2) enables the warning “package could avoid a useless dependency” and "
15616"bit 2 (value=4) enables the warning “I<binary> should not be linked against "
15617"I<library>”. The default I<value> is 3: the first two warnings are active "
15618"by default, the last one is not. Set I<value> to 7 if you want all warnings "
15619"to be active."
15620msgstr ""
15621
15622#. type: SS
15623#: dpkg-shlibdeps.man:1
15624#, no-wrap
15625msgid "Warnings"
15626msgstr ""
15627
15628#. type: Plain text
15629#: dpkg-shlibdeps.man:1
15630msgid ""
15631"Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of "
15632"the generated package, it is able to emit warnings in several cases. They "
15633"inform you of things that can be improved in the package. In most cases, "
15634"those improvements concern the upstream sources directly. By order of "
15635"decreasing importance, here are the various warnings that you can encounter:"
15636msgstr ""
15637
15638#. type: TP
15639#: dpkg-shlibdeps.man:1
15640#, no-wrap
15641msgid "B<symbol>I< sym>B< used by >I<binary>B< found in none of the libraries.>"
15642msgstr ""
15643
15644#. type: Plain text
15645#: dpkg-shlibdeps.man:1
15646msgid ""
15647"The indicated symbol has not been found in the libraries linked with the "
15648"binary. The I<binary> is most likely a library and it needs to be linked "
15649"with an additional library during the build process (option B<-l>I<library> "
15650"of the linker)."
15651msgstr ""
15652
15653#. type: TP
15654#: dpkg-shlibdeps.man:1
15655#, no-wrap
15656msgid ""
15657"I<binary>B< contains an unresolvable reference to symbol >I<sym>B<: it's "
15658"probably a plugin>"
15659msgstr ""
15660
15661#. type: Plain text
15662#: dpkg-shlibdeps.man:1
15663msgid ""
15664"The indicated symbol has not been found in the libraries linked with the "
15665"binary. The I<binary> is most likely a plugin and the symbol is probably "
15666"provided by the program that loads this plugin. In theory a plugin doesn't "
15667"have any SONAME but this binary does have one and as such it could not be "
15668"clearly identified as such. However the fact that the binary is stored in a "
15669"non-public directory is a strong indication that's it's not a normal shared "
15670"library. If the binary is really a plugin, then disregard this warning. But "
15671"there's always the possibility that it's a real library and that programs "
15672"linking to it are using an RPATH so that the dynamic loader finds it. In "
15673"that case, the library is broken and needs to be fixed."
15674msgstr ""
15675
15676#. type: TP
15677#: dpkg-shlibdeps.man:1
15678#, no-wrap
15679msgid ""
15680"B<package could avoid a useless dependency if >I<binary>B< was not linked "
15681"against >I<library>B< (it uses none of the library's symbols)>"
15682msgstr ""
15683
15684#. type: Plain text
15685#: dpkg-shlibdeps.man:1
15686msgid ""
15687"None of the I<binaries> that are linked with I<library> use any of the "
15688"symbols provided by the library. By fixing all the binaries, you would avoid "
15689"the dependency associated to this library (unless the same dependency is "
15690"also generated by another library that is really used)."
15691msgstr ""
15692
15693#. type: TP
15694#: dpkg-shlibdeps.man:1
15695#, no-wrap
15696msgid ""
15697"B<package could avoid a useless dependency if >I<binaries>B< were not linked "
15698"against >I<library>B< (they use none of the library's symbols)>"
15699msgstr ""
15700
15701#. type: Plain text
15702#: dpkg-shlibdeps.man:1
15703msgid "Exactly the same as the above warning, but for multiple binaries."
15704msgstr ""
15705
15706#. type: TP
15707#: dpkg-shlibdeps.man:1
15708#, no-wrap
15709msgid ""
15710"I<binary>B< should not be linked against >I<library>B< (it uses none of the "
15711"library's symbols)>"
15712msgstr ""
15713
15714#. type: Plain text
15715#: dpkg-shlibdeps.man:1
15716msgid ""
15717"The I<binary> is linked to a library that it doesn't need. It's not a "
15718"problem but some small performance improvements in binary load time can be "
15719"obtained by not linking this library to this binary. This warning checks the "
15720"same information as the previous one but does it for each binary instead of "
15721"doing the check globally on all binaries analyzed."
15722msgstr ""
15723
15724#. type: SS
15725#: dpkg-shlibdeps.man:1
15726#, no-wrap
15727msgid "Errors"
15728msgstr ""
15729
15730#. type: Plain text
15731#: dpkg-shlibdeps.man:1
15732msgid ""
15733"B<dpkg-shlibdeps> will fail if it can't find a public library used by a "
15734"binary or if this library has no associated dependency information (either "
15735"shlibs file or symbols file). A public library has a SONAME and is versioned "
15736"(libsomething.so.I<X>). A private library (like a plugin) should not have a "
15737"SONAME and doesn't need to be versioned."
15738msgstr ""
15739
15740#. type: TP
15741#: dpkg-shlibdeps.man:1
15742#, no-wrap
15743msgid ""
15744"B<couldn't find library >I<library-soname>B< needed by >I<binary>B< (its "
15745"RPATH is '>I<rpath>B<')>"
15746msgstr ""
15747
15748#. type: Plain text
15749#: dpkg-shlibdeps.man:1
15750msgid ""
15751"The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> "
15752"has been unable to find the library. B<dpkg-shlibdeps> creates a list of "
15753"directories to check as following: directories listed in the RPATH of the "
15754"binary, directories added by the B<-l> option, directories listed in the "
15755"B<LD_LIBRARY_PATH> environment variable, cross multiarch directories "
15756"(ex. /lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), standard public "
15757"directories (/lib, /usr/lib), directories listed in /etc/ld.so.conf, and "
15758"obsolete multilib directories (/lib32, /usr/lib32, /lib64, /usr/lib64). "
15759"Then it checks those directories in the package's build tree of the binary "
15760"being analyzed, in the packages' build trees indicated with the B<-S> "
15761"command-line option, in other packages' build trees that contains a "
15762"DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory. If "
15763"the library is not found in any of those directories, then you get this "
15764"error."
15765msgstr ""
15766
15767#. type: Plain text
15768#: dpkg-shlibdeps.man:1
15769msgid ""
15770"If the library not found is in a private directory of the same package, then "
15771"you want to add the directory with B<-l>. If it's in another binary package "
15772"being built, you want to make sure that the shlibs/symbols file of this "
15773"package is already created and that B<-l> contains the appropriate directory "
15774"if it also is in a private directory."
15775msgstr ""
15776
15777#. type: TP
15778#: dpkg-shlibdeps.man:1
15779#, no-wrap
15780msgid ""
15781"B<no dependency information found for >I<library-file>B< (used by "
15782">I<binary>B<).>"
15783msgstr ""
15784
15785#. type: Plain text
15786#: dpkg-shlibdeps.man:1
15787msgid ""
15788"The library needed by I<binary> has been found by B<dpkg-shlibdeps> in "
15789"I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency "
15790"information for that library. To find out the dependency, it has tried to "
15791"map the library to a Debian package with the help of B<dpkg -S "
15792">I<library-file>. Then it checked the corresponding shlibs and symbols "
15793"files in %ADMINDIR%/info/, and in the various package's build trees "
15794"(debian/*/DEBIAN/)."
15795msgstr ""
15796
15797#. type: Plain text
15798#: dpkg-shlibdeps.man:1
15799msgid ""
15800"This failure can be caused by a bad or missing shlibs or symbols file in the "
15801"package of the library. It might also happen if the library is built within "
15802"the same source package and if the shlibs files has not yet been created (in "
15803"which case you must fix debian/rules to create the shlibs before calling "
15804"B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under "
15805"a non-canonical name (example: "
15806"/usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of "
15807"/usr/lib/libssl.so.0.9.8) that's not associated to any package, "
15808"B<dpkg-shlibdeps> tries to work around this by trying to fallback on a "
15809"canonical name (using B<realpath>(3)) but it might not always work. It's "
15810"always best to clean up the RPATH of the binary to avoid problems."
15811msgstr ""
15812
15813#. type: Plain text
15814#: dpkg-shlibdeps.man:1
15815msgid ""
15816"Calling B<dpkg-shlibdeps> in verbose mode (B<-v>) will provide much more "
15817"information about where it tried to find the dependency information. This "
15818"might be useful if you don't understand why it's giving you this error."
15819msgstr ""
15820
15821#. type: Plain text
15822#: dpkg-shlibdeps.man:1
15823msgid "B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1)."
15824msgstr ""
15825
15826#. type: TH
15827#: dpkg-source.man:1
15828#, no-wrap
15829msgid "dpkg-source"
15830msgstr ""
15831
15832#. type: Plain text
15833#: dpkg-source.man:1
15834msgid "dpkg-source - Debian source package (.dsc) manipulation tool"
15835msgstr ""
15836
15837#. type: Plain text
15838#: dpkg-source.man:1
15839msgid "B<dpkg-source> [I<option>...] I<command>"
15840msgstr ""
15841
15842#. type: Plain text
15843#: dpkg-source.man:1
15844msgid "B<dpkg-source> packs and unpacks Debian source archives."
15845msgstr ""
15846
15847#. type: Plain text
15848#: dpkg-source.man:1
15849msgid ""
15850"None of these commands allow multiple options to be combined into one, and "
15851"they do not allow the value for an option to be specified in a separate "
15852"argument."
15853msgstr ""
15854
15855#. type: TP
15856#: dpkg-source.man:1
15857#, no-wrap
15858msgid "B<-x>, B<--extract> I<filename>.dsc [I<output-directory>]"
15859msgstr ""
15860
15861#. type: Plain text
15862#: dpkg-source.man:1
15863msgid ""
15864"Extract a source package (B<--extract> since dpkg 1.17.14). One non-option "
15865"argument must be supplied, the name of the Debian source control file "
15866"(B<.dsc>). An optional second non-option argument may be supplied to "
15867"specify the directory to extract the source package to, this must not "
15868"exist. If no output directory is specified, the source package is extracted "
15869"into a directory named I<source>-I<version> under the current working "
15870"directory."
15871msgstr ""
15872
15873#. type: Plain text
15874#: dpkg-source.man:1
15875msgid ""
15876"B<dpkg-source> will read the names of the other file(s) making up the source "
15877"package from the control file; they are assumed to be in the same directory "
15878"as the B<.dsc>."
15879msgstr ""
15880
15881#. type: Plain text
15882#: dpkg-source.man:1
15883msgid ""
15884"The files in the extracted package will have their permissions and "
15885"ownerships set to those which would have been expected if the files and "
15886"directories had simply been created - directories and executable files will "
15887"be 0777 and plain files will be 0666, both modified by the extractors' "
15888"umask; if the parent directory is setgid then the extracted directories will "
15889"be too, and all the files and directories will inherit its group ownership."
15890msgstr ""
15891
15892#. type: Plain text
15893#: dpkg-source.man:1
15894msgid ""
15895"If the source package uses a non-standard format (currently this means all "
15896"formats except “1.0”), its name will be stored in B<debian/source/format> so "
15897"that the following builds of the source package use the same format by "
15898"default."
15899msgstr ""
15900
15901#. type: TP
15902#: dpkg-source.man:1
15903#, no-wrap
15904msgid "B<-b>, B<--build> I<directory> [I<format-specific-parameters>]"
15905msgstr ""
15906
15907#. type: Plain text
15908#: dpkg-source.man:1
15909msgid ""
15910"Build a source package (B<--build> since dpkg 1.17.14). The first "
15911"non-option argument is taken as the name of the directory containing the "
15912"debianized source tree (i.e. with a debian sub-directory and maybe changes "
15913"to the original files). Depending on the source package format used to "
15914"build the package, additional parameters might be accepted."
15915msgstr ""
15916
15917#. type: Plain text
15918#: dpkg-source.man:1
15919msgid ""
15920"B<dpkg-source> will build the source package with the first format found in "
15921"this ordered list: the format indicated with the I<--format> command line "
15922"option, the format indicated in B<debian/source/format>, “1.0”. The "
15923"fallback to “1.0” is deprecated and will be removed at some point in the "
15924"future, you should always document the desired source format in "
15925"B<debian/source/format>. See section B<SOURCE PACKAGE FORMATS> for an "
15926"extensive description of the various source package formats."
15927msgstr ""
15928
15929#. type: TP
15930#: dpkg-source.man:1
15931#, no-wrap
15932msgid "B<--print-format> I<directory>"
15933msgstr ""
15934
15935#. type: Plain text
15936#: dpkg-source.man:1
15937msgid ""
15938"Print the source format that would be used to build the source package if "
15939"B<dpkg-source --build >I<directory> was called (in the same conditions and "
15940"with the same parameters; since dpkg 1.15.5)."
15941msgstr ""
15942
15943#. type: TP
15944#: dpkg-source.man:1
15945#, no-wrap
15946msgid "B<--before-build> I<directory>"
15947msgstr ""
15948
15949#. type: Plain text
15950#: dpkg-source.man:1
15951msgid ""
15952"Run the corresponding hook of the source package format (since dpkg "
15953"1.15.8). This hook is called before any build of the package "
15954"(B<dpkg-buildpackage> calls it very early even before B<debian/rules "
15955"clean>). This command is idempotent and can be called multiple times. Not "
15956"all source formats implement something in this hook, and those that do "
15957"usually prepare the source tree for the build for example by ensuring that "
15958"the Debian patches are applied."
15959msgstr ""
15960
15961#. type: TP
15962#: dpkg-source.man:1
15963#, no-wrap
15964msgid "B<--after-build> I<directory>"
15965msgstr ""
15966
15967#. type: Plain text
15968#: dpkg-source.man:1
15969msgid ""
15970"Run the corresponding hook of the source package format (since dpkg "
15971"1.15.8). This hook is called after any build of the package "
15972"(B<dpkg-buildpackage> calls it last). This command is idempotent and can be "
15973"called multiple times. Not all source formats implement something in this "
15974"hook, and those that do usually use it to undo what B<--before-build> has "
15975"done."
15976msgstr ""
15977
15978#. type: TP
15979#: dpkg-source.man:1
15980#, no-wrap
15981msgid "B<--commit> [I<directory>] ..."
15982msgstr ""
15983
15984#. type: Plain text
15985#: dpkg-source.man:1
15986msgid ""
15987"Record changes in the source tree unpacked in I<directory> (since dpkg "
15988"1.16.1). This command can take supplementary parameters depending on the "
15989"source format. It will error out for formats where this operation doesn't "
15990"mean anything."
15991msgstr ""
15992
15993#. type: Plain text
15994#: dpkg-source.man:1
15995msgid ""
15996"Show the usage message and exit. The format specific build and extract "
15997"options can be shown by using the B<--format> option."
15998msgstr ""
15999
16000#. type: SS
16001#: dpkg-source.man:1
16002#, no-wrap
16003msgid "Generic build options"
16004msgstr ""
16005
16006#. type: Plain text
16007#: dpkg-source.man:1
16008msgid ""
16009"Specifies the main source control file to read information from. The default "
16010"is B<debian/control>. If given with relative pathname this is interpreted "
16011"starting at the source tree's top level directory."
16012msgstr ""
16013
16014#. type: Plain text
16015#: dpkg-source.man:1
16016msgid ""
16017"Specifies the changelog file to read information from. The default is "
16018"B<debian/changelog>. If given with relative pathname this is interpreted "
16019"starting at the source tree's top level directory."
16020msgstr ""
16021
16022#. type: TP
16023#: dpkg-source.man:1
16024#, no-wrap
16025msgid "B<--format=>I<value>"
16026msgstr ""
16027
16028#. type: Plain text
16029#: dpkg-source.man:1
16030msgid ""
16031"Use the given format for building the source package (since dpkg 1.14.17). "
16032"It does override any format given in B<debian/source/format>."
16033msgstr ""
16034
16035#. type: Plain text
16036#: dpkg-source.man:1
16037msgid ""
16038"Read substitution variables in I<substvars-file>; the default is to not read "
16039"any file. This option can be used multiple times to read substitution "
16040"variables from multiple files (since dpkg 1.15.6)."
16041msgstr ""
16042
16043#. type: TP
16044#: dpkg-source.man:1
16045#, no-wrap
16046msgid "B<-Z>I<compression>, B<--compression>=I<compression>"
16047msgstr ""
16048
16049#. type: Plain text
16050#: dpkg-source.man:1
16051msgid ""
16052"Specify the compression to use for created tarballs and diff files "
16053"(B<--compression> since dpkg 1.15.5). Note that this option will not cause "
16054"existing tarballs to be recompressed, it only affects new files. Supported "
16055"values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>. The default is I<xz> for "
16056"formats 2.0 and newer, and I<gzip> for format 1.0. I<xz> is only supported "
16057"since dpkg 1.15.5."
16058msgstr ""
16059
16060#. type: TP
16061#: dpkg-source.man:1
16062#, no-wrap
16063msgid "B<-z>I<level>, B<--compression-level>=I<level>"
16064msgstr ""
16065
16066#. type: Plain text
16067#: dpkg-source.man:1
16068msgid ""
16069"Compression level to use (B<--compression-level> since dpkg 1.15.5). As "
16070"with B<-Z> it only affects newly created files. Supported values are: I<1> "
16071"to I<9>, I<best>, and I<fast>. The default is I<9> for gzip and bzip2, I<6> "
16072"for xz and lzma."
16073msgstr ""
16074
16075#. type: TP
16076#: dpkg-source.man:1
16077#, no-wrap
16078msgid "B<-i>[I<regex>], B<--diff-ignore>[=I<regex>]"
16079msgstr ""
16080
16081#. type: Plain text
16082#: dpkg-source.man:1
16083msgid ""
16084"You may specify a perl regular expression to match files you want filtered "
16085"out of the list of files for the diff (B<--diff-ignore> since dpkg 1.15.6). "
16086"(This list is generated by a find command.) (If the source package is being "
16087"built as a version 3 source package using a VCS, this can be used to ignore "
16088"uncommitted changes on specific files. Using -i.* will ignore all of them.)"
16089msgstr ""
16090
16091#. type: Plain text
16092#: dpkg-source.man:1
16093msgid ""
16094"The B<-i> option by itself enables this setting with a default regex "
16095"(preserving any modification to the default regex done by a previous use of "
16096"B<--extend-diff-ignore>) that will filter out control files and directories "
16097"of the most common revision control systems, backup and swap files and "
16098"Libtool build output directories. There can only be one active regex, of "
16099"multiple B<-i> options only the last one will take effect."
16100msgstr ""
16101
16102#. type: Plain text
16103#: dpkg-source.man:1
16104msgid ""
16105"This is very helpful in cutting out extraneous files that get included in "
16106"the diff, e.g. if you maintain your source in a revision control system and "
16107"want to use a checkout to build a source package without including the "
16108"additional files and directories that it will usually contain (e.g. CVS/, "
16109".cvsignore, .svn/). The default regex is already very exhaustive, but if you "
16110"need to replace it, please note that by default it can match any part of a "
16111"path, so if you want to match the begin of a filename or only full "
16112"filenames, you will need to provide the necessary anchors (e.g. ‘(^|/)’, "
16113"‘($|/)’) yourself."
16114msgstr ""
16115
16116#. type: TP
16117#: dpkg-source.man:1
16118#, no-wrap
16119msgid "B<--extend-diff-ignore>=I<regex>"
16120msgstr ""
16121
16122#. type: Plain text
16123#: dpkg-source.man:1
16124msgid ""
16125"The perl regular expression specified will extend the default value used by "
16126"B<--diff-ignore> and its current value, if set (since dpkg 1.15.6). It does "
16127"this by concatenating “B<|>I<regex>” to the existing value. This option is "
16128"convenient to use in B<debian/source/options> to exclude some auto-generated "
16129"files from the automatic patch generation."
16130msgstr ""
16131
16132#. type: TP
16133#: dpkg-source.man:1
16134#, no-wrap
16135msgid "B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]"
16136msgstr ""
16137
16138#. type: Plain text
16139#: dpkg-source.man:1
16140msgid ""
16141"If this option is specified, the pattern will be passed to B<tar>(1)'s "
16142"B<--exclude> option when it is called to generate a .orig.tar or .tar file "
16143"(B<--tar-ignore> since dpkg 1.15.6). For example, B<-I>CVS will make tar "
16144"skip over CVS directories when generating a .tar.gz file. The option may be "
16145"repeated multiple times to list multiple patterns to exclude."
16146msgstr ""
16147
16148#. type: Plain text
16149#: dpkg-source.man:1
16150msgid ""
16151"B<-I> by itself adds default B<--exclude> options that will filter out "
16152"control files and directories of the most common revision control systems, "
16153"backup and swap files and Libtool build output directories."
16154msgstr ""
16155
16156#. type: Plain text
16157#: dpkg-source.man:1
16158msgid ""
16159"B<Note:> While they have similar purposes, B<-i> and B<-I> have very "
16160"different syntax and semantics. B<-i> can only be specified once and takes a "
16161"perl compatible regular expression which is matched against the full "
16162"relative path of each file. B<-I> can specified multiple times and takes a "
16163"filename pattern with shell wildcards. The pattern is applied to the full "
16164"relative path but also to each part of the path individually. The exact "
16165"semantic of tar's B<--exclude> option is somewhat complicated, see "
16166"https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full "
16167"documentation."
16168msgstr ""
16169
16170#. type: Plain text
16171#: dpkg-source.man:1
16172msgid ""
16173"The default regex and patterns for both options can be seen in the output of "
16174"the B<--help> command."
16175msgstr ""
16176
16177#. type: SS
16178#: dpkg-source.man:1
16179#, no-wrap
16180msgid "Generic extract options"
16181msgstr ""
16182
16183#. type: TP
16184#: dpkg-source.man:1
16185#, no-wrap
16186msgid "B<--no-copy>"
16187msgstr ""
16188
16189#. type: Plain text
16190#: dpkg-source.man:1
16191msgid ""
16192"Do not copy original tarballs near the extracted source package (since dpkg "
16193"1.14.17)."
16194msgstr ""
16195
16196#. type: TP
16197#: dpkg-source.man:1
16198#, no-wrap
16199msgid "B<--no-check>"
16200msgstr ""
16201
16202#. type: Plain text
16203#: dpkg-source.man:1
16204msgid "Do not check signatures and checksums before unpacking (since dpkg 1.14.17)."
16205msgstr ""
16206
16207#. type: TP
16208#: dpkg-source.man:1
16209#, no-wrap
16210msgid "B<--no-overwrite-dir>"
16211msgstr ""
16212
16213#. type: Plain text
16214#: dpkg-source.man:1
16215msgid ""
16216"Do not overwrite the extraction directory if it already exists (since dpkg "
16217"1.18.8)."
16218msgstr ""
16219
16220#. type: TP
16221#: dpkg-source.man:1
16222#, no-wrap
16223msgid "B<--require-valid-signature>"
16224msgstr ""
16225
16226#. type: Plain text
16227#: dpkg-source.man:1
16228msgid ""
16229"Refuse to unpack the source package if it doesn't contain an OpenPGP "
16230"signature that can be verified (since dpkg 1.15.0) either with the user's "
16231"I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of "
16232"the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg> and "
16233"I</usr/share/keyrings/debian-maintainers.gpg>)."
16234msgstr ""
16235
16236#. type: TP
16237#: dpkg-source.man:1
16238#, no-wrap
16239msgid "B<--require-strong-checksums>"
16240msgstr ""
16241
16242#. type: Plain text
16243#: dpkg-source.man:1
16244msgid ""
16245"Refuse to unpack the source package if it does not contain any strong "
16246"checksums (since dpkg 1.18.7). Currently the only known checksum considered "
16247"strong is B<SHA-256>."
16248msgstr ""
16249
16250#. type: TP
16251#: dpkg-source.man:1
16252#, no-wrap
16253msgid "B<--ignore-bad-version>"
16254msgstr ""
16255
16256#. type: Plain text
16257#: dpkg-source.man:1
16258msgid ""
16259"Turns the bad source package version check into a non-fatal warning (since "
16260"dpkg 1.17.7). This option should only be necessary when extracting ancient "
16261"source packages with broken versions, just for backwards compatibility."
16262msgstr ""
16263
16264#. type: SH
16265#: dpkg-source.man:1
16266#, no-wrap
16267msgid "SOURCE PACKAGE FORMATS"
16268msgstr ""
16269
16270#. type: Plain text
16271#: dpkg-source.man:1
16272msgid ""
16273"If you don't know what source format to use, you should probably pick either "
16274"“3.0 (quilt)” or “3.0 (native)”. See "
16275"https://wiki.debian.org/Projects/DebSrc3.0 for information on the deployment "
16276"of those formats within Debian."
16277msgstr ""
16278
16279#. type: SS
16280#: dpkg-source.man:1
16281#, no-wrap
16282msgid "Format: 1.0"
16283msgstr ""
16284
16285#. type: Plain text
16286#: dpkg-source.man:1
16287msgid ""
16288"A source package in this format consists either of a B<.orig.tar.gz> "
16289"associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package "
16290"is said to be I<native>). Optionally the original tarball might be "
16291"accompanied by a detached upstream signature B<.orig.tar.gz.asc>, extraction "
16292"supported since dpkg 1.18.5."
16293msgstr ""
16294
16295#. type: Plain text
16296#: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
16297msgid "B<Extracting>"
16298msgstr ""
16299
16300#. type: Plain text
16301#: dpkg-source.man:1
16302msgid ""
16303"Extracting a native package is a simple extraction of the single tarball in "
16304"the target directory. Extracting a non-native package is done by first "
16305"unpacking the B<.orig.tar.gz> and then applying the patch contained in the "
16306"B<.diff.gz> file. The timestamp of all patched files is reset to the "
16307"extraction time of the source package (this avoids timestamp skews leading "
16308"to problems when autogenerated files are patched). The diff can create new "
16309"files (the whole debian directory is created that way) but can't remove "
16310"files (empty files will be left over)."
16311msgstr ""
16312
16313#. type: Plain text
16314#: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
16315msgid "B<Building>"
16316msgstr ""
16317
16318#. type: Plain text
16319#: dpkg-source.man:1
16320msgid ""
16321"Building a native package is just creating a single tarball with the source "
16322"directory. Building a non-native package involves extracting the original "
16323"tarball in a separate “.orig” directory and regenerating the B<.diff.gz> by "
16324"comparing the source package I<directory> with the .orig directory."
16325msgstr ""
16326
16327#. type: Plain text
16328#: dpkg-source.man:1
16329msgid "B<Build options (with --build):>"
16330msgstr ""
16331
16332#. type: Plain text
16333#: dpkg-source.man:1
16334msgid ""
16335"If a second non-option argument is supplied it should be the name of the "
16336"original source directory or tarfile or the empty string if the package is a "
16337"Debian-specific one and so has no debianization diffs. If no second argument "
16338"is supplied then B<dpkg-source> will look for the original source tarfile "
16339"I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source "
16340"directory I<directory>B<.orig> depending on the B<-sX> arguments."
16341msgstr ""
16342
16343#. type: Plain text
16344#: dpkg-source.man:1
16345msgid ""
16346"B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing "
16347"tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, "
16348"B<-sU> and B<-sR> should be used instead."
16349msgstr ""
16350
16351#. type: Plain text
16352#: dpkg-source.man:1
16353msgid ""
16354"Specifies to expect the original source as a tarfile, by default "
16355"I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>. It will leave "
16356"this original source in place as a tarfile, or copy it to the current "
16357"directory if it isn't already there. The tarball will be unpacked into "
16358"I<directory>B<.orig> for the generation of the diff."
16359msgstr ""
16360
16361#. type: TP
16362#: dpkg-source.man:1 dpkg-source.man:1
16363#, no-wrap
16364msgid "B<-sp>"
16365msgstr ""
16366
16367#. type: Plain text
16368#: dpkg-source.man:1
16369msgid "Like B<-sk> but will remove the directory again afterwards."
16370msgstr ""
16371
16372#. type: Plain text
16373#: dpkg-source.man:1
16374msgid ""
16375"Specifies that the original source is expected as a directory, by default "
16376"I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a "
16377"new original source archive from it."
16378msgstr ""
16379
16380#. type: Plain text
16381#: dpkg-source.man:1
16382msgid "Like B<-su> but will remove that directory after it has been used."
16383msgstr ""
16384
16385#. type: Plain text
16386#: dpkg-source.man:1
16387msgid ""
16388"Specifies that the original source is available both as a directory and as a "
16389"tarfile. B<dpkg-source> will use the directory to create the diff, but the "
16390"tarfile to create the B<.dsc>. This option must be used with care - if the "
16391"directory and tarfile do not match a bad source archive will be generated."
16392msgstr ""
16393
16394#. type: Plain text
16395#: dpkg-source.man:1
16396msgid ""
16397"Specifies to not look for any original source, and to not generate a diff. "
16398"The second argument, if supplied, must be the empty string. This is used for "
16399"Debian-specific packages which do not have a separate upstream source and "
16400"therefore have no debianization diffs."
16401msgstr ""
16402
16403#. type: TP
16404#: dpkg-source.man:1
16405#, no-wrap
16406msgid "B<-sa> or B<-sA>"
16407msgstr ""
16408
16409#. type: Plain text
16410#: dpkg-source.man:1
16411msgid ""
16412"Specifies to look for the original source archive as a tarfile or as a "
16413"directory - the second argument, if any, may be either, or the empty string "
16414"(this is equivalent to using B<-sn>). If a tarfile is found it will unpack "
16415"it to create the diff and remove it afterwards (this is equivalent to "
16416"B<-sp>); if a directory is found it will pack it to create the original "
16417"source and remove it afterwards (this is equivalent to B<-sr>); if neither "
16418"is found it will assume that the package has no debianization diffs, only a "
16419"straightforward source archive (this is equivalent to B<-sn>). If both are "
16420"found then B<dpkg-source> will ignore the directory, overwriting it, if "
16421"B<-sA> was specified (this is equivalent to B<-sP>) or raise an error if "
16422"B<-sa> was specified. B<-sA> is the default."
16423msgstr ""
16424
16425#. type: TP
16426#: dpkg-source.man:1 dpkg-source.man:1
16427#, no-wrap
16428msgid "B<--abort-on-upstream-changes>"
16429msgstr ""
16430
16431#. type: Plain text
16432#: dpkg-source.man:1
16433msgid ""
16434"The process fails if the generated diff contains changes to files outside of "
16435"the debian sub-directory (since dpkg 1.15.8). This option is not allowed in "
16436"B<debian/source/options> but can be used in B<debian/source/local-options>."
16437msgstr ""
16438
16439#. type: Plain text
16440#: dpkg-source.man:1
16441msgid "B<Extract options (with --extract):>"
16442msgstr ""
16443
16444#. type: Plain text
16445#: dpkg-source.man:1
16446msgid "In all cases any existing original source tree will be removed."
16447msgstr ""
16448
16449#. type: Plain text
16450#: dpkg-source.man:1
16451msgid ""
16452"Used when extracting then the original source (if any) will be left as a "
16453"tarfile. If it is not already located in the current directory or if an "
16454"existing but different file is there it will be copied there. (B<This is "
16455"the default>)."
16456msgstr ""
16457
16458#. type: Plain text
16459#: dpkg-source.man:1
16460msgid "Unpacks the original source tree."
16461msgstr ""
16462
16463#. type: Plain text
16464#: dpkg-source.man:1
16465msgid ""
16466"Ensures that the original source is neither copied to the current directory "
16467"nor unpacked. Any original source tree that was in the current directory is "
16468"still removed."
16469msgstr ""
16470
16471#. type: Plain text
16472#: dpkg-source.man:1
16473msgid ""
16474"All the B<-s>I<X> options are mutually exclusive. If you specify more than "
16475"one only the last one will be used."
16476msgstr ""
16477
16478#. type: TP
16479#: dpkg-source.man:1 dpkg-source.man:1
16480#, no-wrap
16481msgid "B<--skip-debianization>"
16482msgstr ""
16483
16484#. type: Plain text
16485#: dpkg-source.man:1
16486msgid ""
16487"Skips application of the debian diff on top of the upstream sources (since "
16488"dpkg 1.15.1)."
16489msgstr ""
16490
16491#. type: SS
16492#: dpkg-source.man:1
16493#, no-wrap
16494msgid "Format: 2.0"
16495msgstr ""
16496
16497#. type: Plain text
16498#: dpkg-source.man:1
16499msgid ""
16500"Extraction supported since dpkg 1.13.9, building supported since dpkg "
16501"1.14.8. Also known as wig&pen. This format is not recommended for "
16502"wide-spread usage, the format “3.0 (quilt)” replaces it. Wig&pen was the "
16503"first specification of a new-generation source package format."
16504msgstr ""
16505
16506#. type: Plain text
16507#: dpkg-source.man:1
16508msgid ""
16509"The behaviour of this format is the same as the “3.0 (quilt)” format except "
16510"that it doesn't use an explicit list of patches. All files in "
16511"B<debian/patches/> matching the perl regular expression B<[\\ew-]+> must be "
16512"valid patches: they are applied at extraction time."
16513msgstr ""
16514
16515#. type: Plain text
16516#: dpkg-source.man:1
16517msgid ""
16518"When building a new source package, any change to the upstream source is "
16519"stored in a patch named B<zz_debian-diff-auto>."
16520msgstr ""
16521
16522#. type: SS
16523#: dpkg-source.man:1
16524#, no-wrap
16525msgid "Format: 3.0 (native)"
16526msgstr ""
16527
16528#. type: Plain text
16529#: dpkg-source.man:1
16530msgid ""
16531"Supported since dpkg 1.14.17. This format is an extension of the native "
16532"package format as defined in the 1.0 format. It supports all compression "
16533"methods and will ignore by default any VCS specific files and directories as "
16534"well as many temporary files (see default value associated to B<-I> option "
16535"in the B<--help> output)."
16536msgstr ""
16537
16538#. type: SS
16539#: dpkg-source.man:1
16540#, no-wrap
16541msgid "Format: 3.0 (quilt)"
16542msgstr ""
16543
16544#. type: Plain text
16545#: dpkg-source.man:1
16546msgid ""
16547"Supported since dpkg 1.14.17. A source package in this format contains at "
16548"least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, "
16549"B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It "
16550"can also contain additional original tarballs "
16551"(B<.orig->I<component>B<.tar.>I<ext>). I<component> can only contain "
16552"alphanumeric characters and hyphens (‘-’). Optionally each original tarball "
16553"can be accompanied by a detached upstream signature "
16554"(B<.orig.tar.>I<ext>B<.asc> and B<.orig->I<component>B<.tar.>I<ext>B<.asc>), "
16555"extraction supported since dpkg 1.17.20, building supported since dpkg "
16556"1.18.5."
16557msgstr ""
16558
16559#. type: Plain text
16560#: dpkg-source.man:1
16561msgid ""
16562"The main original tarball is extracted first, then all additional original "
16563"tarballs are extracted in subdirectories named after the I<component> part "
16564"of their filename (any pre-existing directory is replaced). The debian "
16565"tarball is extracted on top of the source directory after prior removal of "
16566"any pre-existing B<debian> directory. Note that the debian tarball must "
16567"contain a B<debian> sub-directory but it can also contain binary files "
16568"outside of that directory (see B<--include-binaries> option)."
16569msgstr ""
16570
16571#. type: Plain text
16572#: dpkg-source.man:1
16573msgid ""
16574"All patches listed in B<debian/patches/debian.series> or "
16575"B<debian/patches/series> are then applied. If the former file is used and "
16576"the latter one doesn't exist (or is a symlink), then the latter is replaced "
16577"with a symlink to the former. This is meant to simplify usage of B<quilt> to "
16578"manage the set of patches. Note however that while B<dpkg-source> parses "
16579"correctly series files with explicit options used for patch application "
16580"(stored on each line after the patch filename and one or more spaces), it "
16581"does ignore those options and always expect patches that can be applied with "
16582"the B<-p1> option of B<patch>. It will thus emit a warning when it "
16583"encounters such options, and the build is likely to fail."
16584msgstr ""
16585
16586#. type: Plain text
16587#: dpkg-source.man:1
16588msgid ""
16589"The timestamp of all patched files is reset to the extraction time of the "
16590"source package (this avoids timestamp skews leading to problems when "
16591"autogenerated files are patched)."
16592msgstr ""
16593
16594#. type: Plain text
16595#: dpkg-source.man:1
16596msgid ""
16597"Contrary to B<quilt>'s default behaviour, patches are expected to apply "
16598"without any fuzz. When that is not the case, you should refresh such patches "
16599"with B<quilt>, or B<dpkg-source> will error out while trying to apply them."
16600msgstr ""
16601
16602#. type: Plain text
16603#: dpkg-source.man:1
16604msgid "Similarly to B<quilt>'s default behaviour, the patches can remove files too."
16605msgstr ""
16606
16607#. type: Plain text
16608#: dpkg-source.man:1
16609msgid ""
16610"The file B<.pc/applied-patches> is created if some patches have been applied "
16611"during the extraction."
16612msgstr ""
16613
16614#. type: Plain text
16615#: dpkg-source.man:1
16616msgid ""
16617"All original tarballs found in the current directory are extracted in a "
16618"temporary directory by following the same logic as for the unpack, the "
16619"debian directory is copied over in the temporary directory, and all patches "
16620"except the automatic patch (B<debian-changes->I<version> or "
16621"B<debian-changes>, depending on B<--single-debian-patch>) are applied. The "
16622"temporary directory is compared to the source package directory. When the "
16623"diff is non-empty, the build fails unless B<--single-debian-patch> or "
16624"B<--auto-commit> has been used, in which case the diff is stored in the "
16625"automatic patch. If the automatic patch is created/deleted, it's "
16626"added/removed from the series file and from the B<quilt> metadata."
16627msgstr ""
16628
16629#. type: Plain text
16630#: dpkg-source.man:1
16631msgid ""
16632"Any change on a binary file is not representable in a diff and will thus "
16633"lead to a failure unless the maintainer deliberately decided to include that "
16634"modified binary file in the debian tarball (by listing it in "
16635"B<debian/source/include-binaries>). The build will also fail if it finds "
16636"binary files in the debian sub-directory unless they have been whitelisted "
16637"through B<debian/source/include-binaries>."
16638msgstr ""
16639
16640#. type: Plain text
16641#: dpkg-source.man:1
16642msgid ""
16643"The updated debian directory and the list of modified binaries is then used "
16644"to generate the debian tarball."
16645msgstr ""
16646
16647#. type: Plain text
16648#: dpkg-source.man:1
16649msgid ""
16650"The automatically generated diff doesn't include changes on VCS specific "
16651"files as well as many temporary files (see default value associated to B<-i> "
16652"option in the B<--help> output). In particular, the B<.pc> directory used by "
16653"B<quilt> is ignored during generation of the automatic patch."
16654msgstr ""
16655
16656#. type: Plain text
16657#: dpkg-source.man:1
16658msgid ""
16659"Note: B<dpkg-source> B<--before-build> (and B<--build>) will ensure that all "
16660"patches listed in the series file are applied so that a package build always "
16661"has all patches applied. It does this by finding unapplied patches (they are "
16662"listed in the B<series> file but not in B<.pc/applied-patches>), and if the "
16663"first patch in that set can be applied without errors, it will apply them "
16664"all. The option B<--no-preparation> can be used to disable this behavior."
16665msgstr ""
16666
16667#. type: Plain text
16668#: dpkg-source.man:1
16669msgid "B<Recording changes>"
16670msgstr ""
16671
16672#. type: TP
16673#: dpkg-source.man:1
16674#, no-wrap
16675msgid "B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]"
16676msgstr ""
16677
16678#. type: Plain text
16679#: dpkg-source.man:1
16680msgid ""
16681"Generates a patch corresponding to the local changes that are not managed by "
16682"the B<quilt> patch system and integrates it in the patch system under the "
16683"name I<patch-name>. If the name is missing, it will be asked "
16684"interactively. If I<patch-file> is given, it is used as the patch "
16685"corresponding to the local changes to integrate. Once integrated, an editor "
16686"is launched so that you can edit the meta-information in the patch header."
16687msgstr ""
16688
16689#. type: Plain text
16690#: dpkg-source.man:1
16691msgid ""
16692"Passing I<patch-file> is mainly useful after a build failure that "
16693"pre-generated this file, and on this ground the given file is removed after "
16694"integration. Note also that the changes contained in the patch file must "
16695"already be applied on the tree and that the files modified by the patch must "
16696"not have supplementary unrecorded changes."
16697msgstr ""
16698
16699#. type: Plain text
16700#: dpkg-source.man:1
16701msgid ""
16702"If the patch generation detects modified binary files, they will be "
16703"automatically added to B<debian/source/include-binaries> so that they end up "
16704"in the debian tarball (exactly like B<dpkg-source --include-binaries "
16705"--build> would do)."
16706msgstr ""
16707
16708#. type: Plain text
16709#: dpkg-source.man:1 dpkg-source.man:1 dpkg-source.man:1
16710msgid "B<Build options>"
16711msgstr ""
16712
16713#. type: TP
16714#: dpkg-source.man:1
16715#, no-wrap
16716msgid "B<--allow-version-of-quilt-db=>I<version>"
16717msgstr ""
16718
16719#. type: Plain text
16720#: dpkg-source.man:1
16721msgid ""
16722"Allow B<dpkg-source> to build the source package if the version of the "
16723"B<quilt> metadata is the one specified, even if B<dpkg-source> doesn't know "
16724"about it (since dpkg 1.15.5.4). Effectively this says that the given "
16725"version of the B<quilt> metadata is compatible with the version 2 that "
16726"B<dpkg-source> currently supports. The version of the B<quilt> metadata is "
16727"stored in B<.pc/.version>."
16728msgstr ""
16729
16730#. type: TP
16731#: dpkg-source.man:1
16732#, no-wrap
16733msgid "B<--include-removal>"
16734msgstr ""
16735
16736#. type: Plain text
16737#: dpkg-source.man:1
16738msgid ""
16739"Do not ignore removed files and include them in the automatically generated "
16740"patch."
16741msgstr ""
16742
16743#. type: TP
16744#: dpkg-source.man:1
16745#, no-wrap
16746msgid "B<--include-timestamp>"
16747msgstr ""
16748
16749#. type: Plain text
16750#: dpkg-source.man:1
16751msgid "Include timestamp in the automatically generated patch."
16752msgstr ""
16753
16754#. type: TP
16755#: dpkg-source.man:1
16756#, no-wrap
16757msgid "B<--include-binaries>"
16758msgstr ""
16759
16760#. type: Plain text
16761#: dpkg-source.man:1
16762msgid ""
16763"Add all modified binaries in the debian tarball. Also add them to "
16764"B<debian/source/include-binaries>: they will be added by default in "
16765"subsequent builds and this option is thus no more needed."
16766msgstr ""
16767
16768#. type: TP
16769#: dpkg-source.man:1
16770#, no-wrap
16771msgid "B<--no-preparation>"
16772msgstr ""
16773
16774#. type: Plain text
16775#: dpkg-source.man:1
16776msgid ""
16777"Do not try to prepare the build tree by applying patches which are "
16778"apparently unapplied (since dpkg 1.14.18)."
16779msgstr ""
16780
16781#. type: TP
16782#: dpkg-source.man:1
16783#, no-wrap
16784msgid "B<--single-debian-patch>"
16785msgstr ""
16786
16787#. type: Plain text
16788#: dpkg-source.man:1
16789msgid ""
16790"Use B<debian/patches/debian-changes> instead of "
16791"B<debian/patches/debian-changes->I<version> for the name of the automatic "
16792"patch generated during build (since dpkg 1.15.5.4). This option is "
16793"particularly useful when the package is maintained in a VCS and a patch set "
16794"can't reliably be generated. Instead the current diff with upstream should "
16795"be stored in a single patch. The option would be put in "
16796"B<debian/source/local-options> and would be accompanied by a "
16797"B<debian/source/local-patch-header> file explaining how the Debian changes "
16798"can be best reviewed, for example in the VCS that is used."
16799msgstr ""
16800
16801#. type: TP
16802#: dpkg-source.man:1
16803#, no-wrap
16804msgid "B<--create-empty-orig>"
16805msgstr ""
16806
16807#. type: Plain text
16808#: dpkg-source.man:1
16809msgid ""
16810"Automatically create the main original tarball as empty if it's missing and "
16811"if there are supplementary original tarballs (since dpkg 1.15.6). This "
16812"option is meant to be used when the source package is just a bundle of "
16813"multiple upstream software and where there's no “main” software."
16814msgstr ""
16815
16816#. type: TP
16817#: dpkg-source.man:1
16818#, no-wrap
16819msgid "B<--no-unapply-patches, --unapply-patches>"
16820msgstr ""
16821
16822#. type: Plain text
16823#: dpkg-source.man:1
16824msgid ""
16825"By default, B<dpkg-source> will automatically unapply the patches in the "
16826"B<--after-build> hook if it did apply them during B<--before-build> "
16827"(B<--unapply-patches> since dpkg 1.15.8, B<--no-unapply-patches> since dpkg "
16828"1.16.5). Those options allow you to forcefully disable or enable the patch "
16829"unapplication process. Those options are only allowed in "
16830"B<debian/source/local-options> so that all generated source packages have "
16831"the same behavior by default."
16832msgstr ""
16833
16834#. type: Plain text
16835#: dpkg-source.man:1
16836msgid ""
16837"The process fails if an automatic patch has been generated (since dpkg "
16838"1.15.8). This option can be used to ensure that all changes were properly "
16839"recorded in separate B<quilt> patches prior to the source package "
16840"build. This option is not allowed in B<debian/source/options> but can be "
16841"used in B<debian/source/local-options>."
16842msgstr ""
16843
16844#. type: TP
16845#: dpkg-source.man:1
16846#, no-wrap
16847msgid "B<--auto-commit>"
16848msgstr ""
16849
16850#. type: Plain text
16851#: dpkg-source.man:1
16852msgid ""
16853"The process doesn't fail if an automatic patch has been generated, instead "
16854"it's immediately recorded in the B<quilt> series."
16855msgstr ""
16856
16857#. type: Plain text
16858#: dpkg-source.man:1
16859msgid "B<Extract options>"
16860msgstr ""
16861
16862#. type: Plain text
16863#: dpkg-source.man:1
16864msgid ""
16865"Skips extraction of the debian tarball on top of the upstream sources (since "
16866"dpkg 1.15.1)."
16867msgstr ""
16868
16869#. type: TP
16870#: dpkg-source.man:1
16871#, no-wrap
16872msgid "B<--skip-patches>"
16873msgstr ""
16874
16875#. type: Plain text
16876#: dpkg-source.man:1
16877msgid "Do not apply patches at the end of the extraction (since dpkg 1.14.18)."
16878msgstr ""
16879
16880#. type: SS
16881#: dpkg-source.man:1
16882#, no-wrap
16883msgid "Format: 3.0 (custom)"
16884msgstr ""
16885
16886#. type: Plain text
16887#: dpkg-source.man:1
16888msgid ""
16889"Supported since dpkg 1.14.17. This format is special. It doesn't represent "
16890"a real source package format but can be used to create source packages with "
16891"arbitrary files."
16892msgstr ""
16893
16894#. type: Plain text
16895#: dpkg-source.man:1
16896msgid ""
16897"All non-option arguments are taken as files to integrate in the generated "
16898"source package. They must exist and are preferably in the current "
16899"directory. At least one file must be given."
16900msgstr ""
16901
16902#. type: TP
16903#: dpkg-source.man:1
16904#, no-wrap
16905msgid "B<--target-format=>I<value>"
16906msgstr ""
16907
16908#. type: Plain text
16909#: dpkg-source.man:1
16910msgid ""
16911"B<Required>. Defines the real format of the generated source package. The "
16912"generated .dsc file will contain this value in its B<Format> field and not "
16913"“3.0 (custom)”."
16914msgstr ""
16915
16916#. type: SS
16917#: dpkg-source.man:1
16918#, no-wrap
16919msgid "Format: 3.0 (git)"
16920msgstr ""
16921
16922#. type: Plain text
16923#: dpkg-source.man:1
16924msgid "Supported since dpkg 1.14.17. This format is experimental."
16925msgstr ""
16926
16927#. type: Plain text
16928#: dpkg-source.man:1
16929msgid ""
16930"A source package in this format consists of a single bundle of a git "
16931"repository B<.git> to hold the source of a package. There may also be a "
16932"B<.gitshallow> file listing revisions for a shallow git clone."
16933msgstr ""
16934
16935#. type: Plain text
16936#: dpkg-source.man:1
16937msgid ""
16938"The bundle is cloned as a git repository to the target directory. If there "
16939"is a gitshallow file, it is installed as I<.git/shallow> inside the cloned "
16940"git repository."
16941msgstr ""
16942
16943#. type: Plain text
16944#: dpkg-source.man:1
16945msgid ""
16946"Note that by default the new repository will have the same branch checked "
16947"out that was checked out in the original source. (Typically “master”, but "
16948"it could be anything.) Any other branches will be available under "
16949"I<remotes/origin/>."
16950msgstr ""
16951
16952#. type: Plain text
16953#: dpkg-source.man:1 dpkg-source.man:1
16954msgid ""
16955"Before going any further, some checks are done to ensure that we don't have "
16956"any non-ignored uncommitted changes."
16957msgstr ""
16958
16959#. type: Plain text
16960#: dpkg-source.man:1
16961msgid ""
16962"B<git-bundle>(1) is used to generate a bundle of the git repository. By "
16963"default, all branches and tags in the repository are included in the bundle."
16964msgstr ""
16965
16966#. type: TP
16967#: dpkg-source.man:1
16968#, no-wrap
16969msgid "B<--git-ref=>I<ref>"
16970msgstr ""
16971
16972#. type: Plain text
16973#: dpkg-source.man:1
16974msgid ""
16975"Allows specifying a git ref to include in the git bundle. Use disables the "
16976"default behavior of including all branches and tags. May be specified "
16977"multiple times. The I<ref> can be the name of a branch or tag to include. It "
16978"may also be any parameter that can be passed to B<git-rev-list>(1). For "
16979"example, to include only the master branch, use B<--git-ref=>master. To "
16980"include all tags and branches, except for the private branch, use "
16981"B<--git-ref=>--all B<--git-ref=>^private"
16982msgstr ""
16983
16984#. type: TP
16985#: dpkg-source.man:1
16986#, no-wrap
16987msgid "B<--git-depth=>I<number>"
16988msgstr ""
16989
16990#. type: Plain text
16991#: dpkg-source.man:1
16992msgid ""
16993"Creates a shallow clone with a history truncated to the specified number of "
16994"revisions."
16995msgstr ""
16996
16997#. type: SS
16998#: dpkg-source.man:1
16999#, no-wrap
17000msgid "Format: 3.0 (bzr)"
17001msgstr ""
17002
17003#. type: Plain text
17004#: dpkg-source.man:1
17005msgid ""
17006"Supported since dpkg 1.14.17. This format is experimental. It generates a "
17007"single tarball containing the bzr repository."
17008msgstr ""
17009
17010#. type: Plain text
17011#: dpkg-source.man:1
17012msgid "The tarball is unpacked and then bzr is used to checkout the current branch."
17013msgstr ""
17014
17015#. type: Plain text
17016#: dpkg-source.man:1
17017msgid ""
17018"Then the VCS specific part of the source directory is copied over to a "
17019"temporary directory. Before this temporary directory is packed in a tarball, "
17020"various cleanup are done to save space."
17021msgstr ""
17022
17023#. type: SS
17024#: dpkg-source.man:1
17025#, no-wrap
17026msgid "no source format specified in debian/source/format"
17027msgstr ""
17028
17029#. type: Plain text
17030#: dpkg-source.man:1
17031msgid ""
17032"The file B<debian/source/format> should always exist and indicate the "
17033"desired source format. For backwards compatibility, format “1.0” is assumed "
17034"when the file doesn't exist but you should not rely on this: at some point "
17035"in the future B<dpkg-source> will be modified to fail when that file doesn't "
17036"exist."
17037msgstr ""
17038
17039#. type: Plain text
17040#: dpkg-source.man:1
17041msgid ""
17042"The rationale is that format “1.0” is no longer the recommended format, you "
17043"should usually pick one of the newer formats (“3.0 (quilt)”, “3.0 (native)”) "
17044"but B<dpkg-source> will not do this automatically for you. If you want to "
17045"continue using the old format, you should be explicit about it and put “1.0” "
17046"in B<debian/source/format>."
17047msgstr ""
17048
17049#. type: SS
17050#: dpkg-source.man:1
17051#, no-wrap
17052msgid "the diff modifies the following upstream files"
17053msgstr ""
17054
17055#. type: Plain text
17056#: dpkg-source.man:1
17057msgid ""
17058"When using source format “1.0” it is usually a bad idea to modify upstream "
17059"files directly as the changes end up hidden and mostly undocumented in the "
17060".diff.gz file. Instead you should store your changes as patches in the "
17061"debian directory and apply them at build-time. To avoid this complexity you "
17062"can also use the format “3.0 (quilt)” that offers this natively."
17063msgstr ""
17064
17065#. type: SS
17066#: dpkg-source.man:1
17067#, no-wrap
17068msgid "cannot represent change to I<file>"
17069msgstr ""
17070
17071#. type: Plain text
17072#: dpkg-source.man:1
17073msgid ""
17074"Changes to upstream sources are usually stored with patch files, but not all "
17075"changes can be represented with patches: they can only alter the content of "
17076"plain text files. If you try replacing a file with something of a different "
17077"type (for example replacing a plain file with a symlink or a directory), you "
17078"will get this error message."
17079msgstr ""
17080
17081#. type: SS
17082#: dpkg-source.man:1
17083#, no-wrap
17084msgid "newly created empty file I<file> will not be represented in diff"
17085msgstr ""
17086
17087#. type: Plain text
17088#: dpkg-source.man:1
17089msgid ""
17090"Empty files can't be created with patch files. Thus this change is not "
17091"recorded in the source package and you are warned about it."
17092msgstr ""
17093
17094#. type: SS
17095#: dpkg-source.man:1
17096#, no-wrap
17097msgid "executable mode I<perms> of I<file> will not be represented in diff"
17098msgstr ""
17099
17100#. type: Plain text
17101#: dpkg-source.man:1
17102msgid ""
17103"Patch files do not record permissions of files and thus executable "
17104"permissions are not stored in the source package. This warning reminds you "
17105"of that fact."
17106msgstr ""
17107
17108#. type: SS
17109#: dpkg-source.man:1
17110#, no-wrap
17111msgid "special mode I<perms> of I<file> will not be represented in diff"
17112msgstr ""
17113
17114#. type: Plain text
17115#: dpkg-source.man:1
17116msgid ""
17117"Patch files do not record permissions of files and thus modified permissions "
17118"are not stored in the source package. This warning reminds you of that fact."
17119msgstr ""
17120
17121#. type: Plain text
17122#: dpkg-source.man:1
17123msgid ""
17124"If set, it will be used as the timestamp (as seconds since the epoch) to "
17125"clamp the mtime in the B<tar>(5) file entries."
17126msgstr ""
17127
17128#. type: TP
17129#: dpkg-source.man:1
17130#, no-wrap
17131msgid "B<VISUAL>"
17132msgstr ""
17133
17134#. type: TQ
17135#: dpkg-source.man:1
17136#, no-wrap
17137msgid "B<EDITOR>"
17138msgstr ""
17139
17140#. type: Plain text
17141#: dpkg-source.man:1
17142msgid "Used by the “2.0” and “3.0 (quilt)” source format modules."
17143msgstr ""
17144
17145#. type: TP
17146#: dpkg-source.man:1
17147#, no-wrap
17148msgid "B<GIT_DIR>"
17149msgstr ""
17150
17151#. type: TQ
17152#: dpkg-source.man:1
17153#, no-wrap
17154msgid "B<GIT_INDEX_FILE>"
17155msgstr ""
17156
17157#. type: TQ
17158#: dpkg-source.man:1
17159#, no-wrap
17160msgid "B<GIT_OBJECT_DIRECTORY>"
17161msgstr ""
17162
17163#. type: TQ
17164#: dpkg-source.man:1
17165#, no-wrap
17166msgid "B<GIT_ALTERNATE_OBJECT_DIRECTORIES>"
17167msgstr ""
17168
17169#. type: TQ
17170#: dpkg-source.man:1
17171#, no-wrap
17172msgid "B<GIT_WORK_TREE>"
17173msgstr ""
17174
17175#. type: Plain text
17176#: dpkg-source.man:1
17177msgid "Used by the “3.0 (git)” source format modules."
17178msgstr ""
17179
17180#. type: SS
17181#: dpkg-source.man:1
17182#, no-wrap
17183msgid "debian/source/format"
17184msgstr ""
17185
17186#. type: Plain text
17187#: dpkg-source.man:1
17188msgid ""
17189"This file contains on a single line the format that should be used to build "
17190"the source package (possible formats are described above). No leading or "
17191"trailing spaces are allowed."
17192msgstr ""
17193
17194#. type: SS
17195#: dpkg-source.man:1
17196#, no-wrap
17197msgid "debian/source/include-binaries"
17198msgstr ""
17199
17200#. type: Plain text
17201#: dpkg-source.man:1
17202msgid ""
17203"This file contains a list of binary files (one per line) that should be "
17204"included in the debian tarball. Leading and trailing spaces are stripped. "
17205"Lines starting with ‘B<#>’ are comments and are skipped. Empty lines are "
17206"ignored."
17207msgstr ""
17208
17209#. type: SS
17210#: dpkg-source.man:1
17211#, no-wrap
17212msgid "debian/source/options"
17213msgstr ""
17214
17215#. type: Plain text
17216#: dpkg-source.man:1
17217msgid ""
17218"This file contains a list of long options that should be automatically "
17219"prepended to the set of command line options of a B<dpkg-source --build> or "
17220"B<dpkg-source --print-format> call. Options like B<--compression> and "
17221"B<--compression-level> are well suited for this file."
17222msgstr ""
17223
17224#. type: Plain text
17225#: dpkg-source.man:1
17226msgid ""
17227"Each option should be put on a separate line. Empty lines and lines starting "
17228"with ‘B<#>’ are ignored. The leading ‘B<-->’ should be stripped and short "
17229"options are not allowed. Optional spaces are allowed around the ‘B<=>’ "
17230"symbol and optional quotes are allowed around the value. Here's an example "
17231"of such a file:"
17232msgstr ""
17233
17234#. type: Plain text
17235#: dpkg-source.man:1
17236#, no-wrap
17237msgid ""
17238" # let dpkg-source create a debian.tar.bz2 with maximal compression\n"
17239" compression = \"bzip2\"\n"
17240" compression-level = 9\n"
17241" # use debian/patches/debian-changes as automatic patch\n"
17242" single-debian-patch\n"
17243" # ignore changes on config.{sub,guess}\n"
17244" extend-diff-ignore = \"(^|/)(config.sub|config.guess)$\"\n"
17245msgstr ""
17246
17247#. type: Plain text
17248#: dpkg-source.man:1
17249msgid ""
17250"Note: B<format> options are not accepted in this file, you should use "
17251"B<debian/source/format> instead."
17252msgstr ""
17253
17254#. type: SS
17255#: dpkg-source.man:1
17256#, no-wrap
17257msgid "debian/source/local-options"
17258msgstr ""
17259
17260#. type: Plain text
17261#: dpkg-source.man:1
17262msgid ""
17263"Exactly like B<debian/source/options> except that the file is not included "
17264"in the generated source package. It can be useful to store a preference tied "
17265"to the maintainer or to the VCS repository where the source package is "
17266"maintained."
17267msgstr ""
17268
17269#. type: SS
17270#: dpkg-source.man:1
17271#, no-wrap
17272msgid "debian/source/local-patch-header R<and> debian/source/patch-header"
17273msgstr ""
17274
17275#. type: Plain text
17276#: dpkg-source.man:1
17277msgid ""
17278"Free form text that is put on top of the automatic patch generated in "
17279"formats “2.0” or “3.0 (quilt)”. B<local-patch-header> is not included in the "
17280"generated source package while B<patch-header> is."
17281msgstr ""
17282
17283#. type: SS
17284#: dpkg-source.man:1
17285#, no-wrap
17286msgid "debian/patches/series"
17287msgstr ""
17288
17289#. type: Plain text
17290#: dpkg-source.man:1
17291msgid ""
17292"This file lists all patches that have to be applied (in the given order) on "
17293"top of the upstream source package. Leading and trailing spaces are "
17294"stripped. Lines starting with ‘B<#>’ are comments and are skipped. Empty "
17295"lines are ignored. Remaining lines start with a patch filename (relative to "
17296"the B<debian/patches/> directory) up to the first space character or the end "
17297"of line. Optional B<quilt> options can follow up to the end of line or the "
17298"first ‘B<#>’ preceded by one or more spaces (which marks the start of a "
17299"comment up to the end of line)."
17300msgstr ""
17301
17302#. type: Plain text
17303#: dpkg-source.man:1
17304msgid ""
17305"The point at which field overriding occurs compared to certain standard "
17306"output field settings is rather confused."
17307msgstr ""
17308
17309#. type: Plain text
17310#: dpkg-source.man:1
17311msgid "B<deb-src-control>(5), B<deb-changelog>(5), B<dsc>(5)."
17312msgstr ""
17313
17314#. type: TH
17315#: dpkg-split.man:1
17316#, no-wrap
17317msgid "dpkg-split"
17318msgstr ""
17319
17320#. type: Plain text
17321#: dpkg-split.man:1
17322msgid "dpkg-split - Debian package archive split/join tool"
17323msgstr ""
17324
17325#. type: Plain text
17326#: dpkg-split.man:1
17327msgid "B<dpkg-split> [I<option>...] I<command>"
17328msgstr ""
17329
17330#. type: Plain text
17331#: dpkg-split.man:1
17332msgid ""
17333"B<dpkg-split> splits Debian binary package files into smaller parts and "
17334"reassembles them again, to support the storage of large package files on "
17335"small media such as floppy disks."
17336msgstr ""
17337
17338#. type: Plain text
17339#: dpkg-split.man:1
17340msgid ""
17341"It can be operated manually using the B<--split>, B<--join> and B<--info> "
17342"options."
17343msgstr ""
17344
17345#. type: Plain text
17346#: dpkg-split.man:1
17347msgid ""
17348"It also has an automatic mode, invoked using the B<--auto> option, where it "
17349"maintains a queue of parts seen but not yet reassembled and reassembles a "
17350"package file when it has seen all of its parts. The B<--listq> and "
17351"B<--discard> options allow the management of the queue."
17352msgstr ""
17353
17354#. type: Plain text
17355#: dpkg-split.man:1
17356msgid ""
17357"All splitting, joining and queueing operations produce informative messages "
17358"on standard output; these may safely be ignored."
17359msgstr ""
17360
17361#. type: TP
17362#: dpkg-split.man:1
17363#, no-wrap
17364msgid "B<-s>, B<--split> I<complete-archive> [I<prefix>]"
17365msgstr ""
17366
17367#. type: Plain text
17368#: dpkg-split.man:1
17369msgid "Splits a single Debian binary package into several parts."
17370msgstr ""
17371
17372#. type: Plain text
17373#: dpkg-split.man:1
17374msgid ""
17375"The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part "
17376"number, starting at 1, and I<M> is the total number of parts (both in "
17377"decimal)."
17378msgstr ""
17379
17380#. type: Plain text
17381#: dpkg-split.man:1
17382msgid ""
17383"If no I<prefix> is supplied then the I<complete-archive> filename is taken, "
17384"including directory, with any trailing B<.deb> removed."
17385msgstr ""
17386
17387#. type: TP
17388#: dpkg-split.man:1
17389#, no-wrap
17390msgid "B<-j>, B<--join> I<part>..."
17391msgstr ""
17392
17393#. type: Plain text
17394#: dpkg-split.man:1
17395msgid ""
17396"Joins the parts of a package file together, reassembling the original file "
17397"as it was before it was split."
17398msgstr ""
17399
17400#. type: Plain text
17401#: dpkg-split.man:1
17402msgid ""
17403"The part files given as arguments must be all the parts of exactly the same "
17404"original binary file. Each part must occur exactly once in the argument "
17405"list, though the parts to not need to be listed in order."
17406msgstr ""
17407
17408#. type: Plain text
17409#: dpkg-split.man:1
17410msgid ""
17411"The parts must of course all have been generated with the same part size "
17412"specified at split time, which means that they must usually have been "
17413"generated by the same invocation of B<dpkg-split --split>."
17414msgstr ""
17415
17416#. type: Plain text
17417#: dpkg-split.man:1
17418msgid "The parts' filenames are not significant for the reassembly process."
17419msgstr ""
17420
17421#. type: Plain text
17422#: dpkg-split.man:1
17423msgid ""
17424"By default the output file is called "
17425"I<package>B<_>I<version>B<_>I<arch>B<.deb>."
17426msgstr ""
17427
17428#. type: TP
17429#: dpkg-split.man:1
17430#, no-wrap
17431msgid "B<-I>, B<--info> I<part>..."
17432msgstr ""
17433
17434#. type: Plain text
17435#: dpkg-split.man:1
17436msgid ""
17437"Prints information, in a human-readable format, about the part file(s) "
17438"specified. Arguments which are not binary package parts produce a message "
17439"saying so instead (but still on standard output)."
17440msgstr ""
17441
17442#. type: TP
17443#: dpkg-split.man:1
17444#, no-wrap
17445msgid "B<-a>, B<--auto -o> I<complete-output part>"
17446msgstr ""
17447
17448#. type: Plain text
17449#: dpkg-split.man:1
17450msgid "Automatically queue parts and reassemble a package if possible."
17451msgstr ""
17452
17453#. type: Plain text
17454#: dpkg-split.man:1
17455msgid ""
17456"The I<part> specified is examined, and compared with other parts of the same "
17457"package (if any) in the queue of packages file parts."
17458msgstr ""
17459
17460#. type: Plain text
17461#: dpkg-split.man:1
17462msgid ""
17463"If all parts of the package file of which I<part> is a part are available "
17464"then the package is reassembled and written to I<complete-output> (which "
17465"should not usually already exist, though this is not an error)."
17466msgstr ""
17467
17468#. type: Plain text
17469#: dpkg-split.man:1
17470msgid ""
17471"If not then the I<part> is copied into the queue and I<complete-output> is "
17472"not created."
17473msgstr ""
17474
17475#. type: Plain text
17476#: dpkg-split.man:1
17477msgid ""
17478"If I<part> is not a split binary package part then B<dpkg-split> will exit "
17479"with status B<1>; if some other trouble occurs then it will exit with status "
17480"B<2>."
17481msgstr ""
17482
17483#. type: Plain text
17484#: dpkg-split.man:1
17485msgid ""
17486"The B<--output> or B<-o> option must be supplied when using B<--auto>. (If "
17487"this were not mandatory the calling program would not know what output file "
17488"to expect.)"
17489msgstr ""
17490
17491#. type: TP
17492#: dpkg-split.man:1
17493#, no-wrap
17494msgid "B<-l>, B<--listq>"
17495msgstr ""
17496
17497#. type: Plain text
17498#: dpkg-split.man:1
17499msgid "Lists the contents of the queue of packages to be reassembled."
17500msgstr ""
17501
17502#. type: Plain text
17503#: dpkg-split.man:1
17504msgid ""
17505"For each package file of which parts are in the queue the output gives the "
17506"name of the package, the parts in the queue, and the total number of bytes "
17507"stored in the queue."
17508msgstr ""
17509
17510#. type: TP
17511#: dpkg-split.man:1
17512#, no-wrap
17513msgid "B<-d>, B<--discard> [I<package>...]"
17514msgstr ""
17515
17516#. type: Plain text
17517#: dpkg-split.man:1
17518msgid ""
17519"This discards parts from the queue of those waiting for the remaining parts "
17520"of their packages."
17521msgstr ""
17522
17523#. type: Plain text
17524#: dpkg-split.man:1
17525msgid ""
17526"If no I<package> is specified then the queue is cleared completely; if any "
17527"are specified then only parts of the relevant package(s) are deleted."
17528msgstr ""
17529
17530#. type: TP
17531#: dpkg-split.man:1
17532#, no-wrap
17533msgid "B<--depotdir>I< directory>"
17534msgstr ""
17535
17536#. type: Plain text
17537#: dpkg-split.man:1
17538msgid ""
17539"Specifies an alternative directory for the queue of parts awaiting automatic "
17540"reassembly. The default is B<%ADMINDIR%>."
17541msgstr ""
17542
17543#. type: TP
17544#: dpkg-split.man:1
17545#, no-wrap
17546msgid "B<-S>, B<--partsize> I<kibibytes>"
17547msgstr ""
17548
17549#. type: Plain text
17550#: dpkg-split.man:1
17551msgid ""
17552"Specifies the maximum part size when splitting, in kibibytes (1024 "
17553"bytes). The default is 450 KiB."
17554msgstr ""
17555
17556#. type: TP
17557#: dpkg-split.man:1
17558#, no-wrap
17559msgid "B<-o>, B<--output> I<complete-output>"
17560msgstr ""
17561
17562#. type: Plain text
17563#: dpkg-split.man:1
17564msgid "Specifies the output file name for a reassembly."
17565msgstr ""
17566
17567#. type: Plain text
17568#: dpkg-split.man:1
17569msgid ""
17570"This overrides the default for a manual reassembly (B<--join>) and is "
17571"mandatory for an automatic queue-or-reassemble (B<--auto>)."
17572msgstr ""
17573
17574#. type: TP
17575#: dpkg-split.man:1
17576#, no-wrap
17577msgid "B<-Q>, B<--npquiet>"
17578msgstr ""
17579
17580#. type: Plain text
17581#: dpkg-split.man:1
17582msgid ""
17583"When doing automatic queue-or-reassembly B<dpkg-split> usually prints a "
17584"message if it is given a I<part> that is not a binary package part. This "
17585"option suppresses this message, to allow programs such as B<dpkg> to cope "
17586"with both split and unsplit packages without producing spurious messages."
17587msgstr ""
17588
17589#. type: TP
17590#: dpkg-split.man:1
17591#, no-wrap
17592msgid "B<--msdos>"
17593msgstr ""
17594
17595#. type: Plain text
17596#: dpkg-split.man:1
17597msgid "Forces the output filenames generated by B<--split> to be msdos-compatible."
17598msgstr ""
17599
17600#. type: Plain text
17601#: dpkg-split.man:1
17602msgid ""
17603"This mangles the prefix - either the default derived from the input filename "
17604"or the one supplied as an argument: alphanumerics are lowercased, plus signs "
17605"are replaced by B<x>'s and all other characters are discarded."
17606msgstr ""
17607
17608#. type: Plain text
17609#: dpkg-split.man:1
17610msgid ""
17611"The result is then truncated as much as is necessary, and filenames of the "
17612"form I<prefixN>B<of>I<M>B<.deb> are generated."
17613msgstr ""
17614
17615#. type: Plain text
17616#: dpkg-split.man:1
17617msgid ""
17618"The requested split, merge, or other command succeeded. B<--info> commands "
17619"count as successful even if the files are not binary package parts."
17620msgstr ""
17621
17622#. type: Plain text
17623#: dpkg-split.man:1
17624msgid ""
17625"Only occurs with B<--auto> and indicates that the I<part> file was not a "
17626"binary package part."
17627msgstr ""
17628
17629#. type: Plain text
17630#: dpkg-split.man:1
17631msgid ""
17632"Fatal or unrecoverable error due to invalid command-line usage, a file that "
17633"looked like a package part file but was corrupted, or interactions with the "
17634"system, such as accesses to the database, memory allocations, etc."
17635msgstr ""
17636
17637#. type: Plain text
17638#: dpkg-split.man:1
17639msgid ""
17640"If set, it will be used as the timestamp (as seconds since the epoch) in the "
17641"B<deb-split>(5)'s B<ar>(5) container."
17642msgstr ""
17643
17644#. type: TP
17645#: dpkg-split.man:1
17646#, no-wrap
17647msgid "I<%ADMINDIR%/parts>"
17648msgstr ""
17649
17650#. type: Plain text
17651#: dpkg-split.man:1
17652msgid "The default queue directory for part files awaiting automatic reassembly."
17653msgstr ""
17654
17655#. type: Plain text
17656#: dpkg-split.man:1
17657msgid ""
17658"The filenames used in this directory are in a format internal to "
17659"B<dpkg-split> and are unlikely to be useful to other programs, and in any "
17660"case the filename format should not be relied upon."
17661msgstr ""
17662
17663#. type: Plain text
17664#: dpkg-split.man:1
17665msgid ""
17666"Full details of the packages in the queue are impossible to get without "
17667"digging into the queue directory yourself."
17668msgstr ""
17669
17670#. type: Plain text
17671#: dpkg-split.man:1
17672msgid ""
17673"There is no easy way to test whether a file that may be a binary package "
17674"part is one."
17675msgstr ""
17676
17677#. type: Plain text
17678#: dpkg-split.man:1
17679msgid "B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1)."
17680msgstr ""
17681
17682#. type: TH
17683#: dpkg-statoverride.man:1
17684#, no-wrap
17685msgid "dpkg-statoverride"
17686msgstr ""
17687
17688#. type: Plain text
17689#: dpkg-statoverride.man:1
17690msgid "dpkg-statoverride - override ownership and mode of files"
17691msgstr ""
17692
17693#. type: Plain text
17694#: dpkg-statoverride.man:1
17695msgid "B<dpkg-statoverride> [I<option>...] I<command>"
17696msgstr ""
17697
17698#. type: Plain text
17699#: dpkg-statoverride.man:1
17700msgid ""
17701"“B<stat overrides>” are a way to tell B<dpkg>(1) to use a different owner "
17702"or mode for a path when a package is installed (this applies to any "
17703"filesystem object that B<dpkg> handles, including directories, devices, "
17704"etc.). This can be used to force programs that are normally setuid to be "
17705"install without a setuid flag, or only executable by a certain group."
17706msgstr ""
17707
17708#. type: Plain text
17709#: dpkg-statoverride.man:1
17710msgid ""
17711"B<dpkg-statoverride> is a utility to manage the list of stat overrides. It "
17712"has three basic functions: adding, removing and listing overrides."
17713msgstr ""
17714
17715#. type: TP
17716#: dpkg-statoverride.man:1
17717#, no-wrap
17718msgid "B<--add>I< user group mode path>"
17719msgstr ""
17720
17721#. type: Plain text
17722#: dpkg-statoverride.man:1
17723msgid ""
17724"Add an override for I<path>. I<path> does not need to exist when this "
17725"command is used; the override will be stored and used later. Users and "
17726"groups can be specified by their name (for example B<root> or B<nobody>), or "
17727"by their number by prepending the number with a ‘B<#>’ (for example B<#0> or "
17728"B<#65534>). The I<mode> needs to be specified in octal."
17729msgstr ""
17730
17731#. type: Plain text
17732#: dpkg-statoverride.man:1
17733msgid ""
17734"If B<--update> is specified and I<path> exists, it is immediately set to the "
17735"new owner and mode."
17736msgstr ""
17737
17738#. type: TP
17739#: dpkg-statoverride.man:1
17740#, no-wrap
17741msgid "B<--remove>I< path>"
17742msgstr ""
17743
17744#. type: Plain text
17745#: dpkg-statoverride.man:1
17746msgid ""
17747"Remove an override for I<path>, the status of I<path> is left unchanged by "
17748"this command."
17749msgstr ""
17750
17751#. type: TP
17752#: dpkg-statoverride.man:1
17753#, no-wrap
17754msgid "B<--list> [I<glob-pattern>]"
17755msgstr ""
17756
17757#. type: Plain text
17758#: dpkg-statoverride.man:1
17759msgid ""
17760"List all overrides. If a glob pattern is specified restrict the output to "
17761"overrides which match the glob."
17762msgstr ""
17763
17764#. type: Plain text
17765#: dpkg-statoverride.man:1
17766msgid ""
17767"Change the I<directory> of the B<dpkg> database where the statoverride file "
17768"is also stored. Defaults to I<%ADMINDIR%>."
17769msgstr ""
17770
17771#. type: TP
17772#: dpkg-statoverride.man:1 update-alternatives.man:1
17773#, no-wrap
17774msgid "B<--force>"
17775msgstr ""
17776
17777#. type: Plain text
17778#: dpkg-statoverride.man:1
17779msgid ""
17780"Force an action, even if a sanity check would otherwise prohibit it. This "
17781"is necessary to override an existing override."
17782msgstr ""
17783
17784#. type: TP
17785#: dpkg-statoverride.man:1
17786#, no-wrap
17787msgid "B<--update>"
17788msgstr ""
17789
17790#. type: Plain text
17791#: dpkg-statoverride.man:1
17792msgid ""
17793"Immediately try to change the I<path> to the new owner and mode if it "
17794"exists."
17795msgstr ""
17796
17797#. type: Plain text
17798#: dpkg-statoverride.man:1
17799msgid "Be less verbose about what we do."
17800msgstr ""
17801
17802#. type: Plain text
17803#: dpkg-statoverride.man:1
17804msgid "For B<--list>, if there are no overrides or none match the supplied glob."
17805msgstr ""
17806
17807#. type: TP
17808#: dpkg-statoverride.man:1
17809#, no-wrap
17810msgid "I<%ADMINDIR%/statoverride>"
17811msgstr ""
17812
17813#. type: Plain text
17814#: dpkg-statoverride.man:1
17815msgid ""
17816"File which contains the current list of stat overrides of the system. It is "
17817"located in the B<dpkg> administration directory, along with other files "
17818"important to B<dpkg>, such as I<status> or I<available>."
17819msgstr ""
17820
17821#. type: Plain text
17822#: dpkg-statoverride.man:1
17823msgid ""
17824"Note: B<dpkg-statoverride> preserves the old copy of this file, with "
17825"extension “-old”, before replacing it with the new one."
17826msgstr ""
17827
17828#. type: TH
17829#: dpkg-trigger.man:1
17830#, no-wrap
17831msgid "dpkg-trigger"
17832msgstr ""
17833
17834#. type: Plain text
17835#: dpkg-trigger.man:1
17836msgid "dpkg-trigger - a package trigger utility"
17837msgstr ""
17838
17839#. type: Plain text
17840#: dpkg-trigger.man:1
17841msgid "B<dpkg-trigger> [I<option>...] I<trigger-name>"
17842msgstr ""
17843
17844#. type: Plain text
17845#: dpkg-trigger.man:1
17846msgid "B<dpkg-trigger> [I<option>...] I<command>"
17847msgstr ""
17848
17849#. type: Plain text
17850#: dpkg-trigger.man:1
17851msgid ""
17852"B<dpkg-trigger> is a tool to explicitly activate triggers and check for its "
17853"support on the running B<dpkg>."
17854msgstr ""
17855
17856#. type: Plain text
17857#: dpkg-trigger.man:1
17858msgid ""
17859"This can be used by maintainer scripts in complex and conditional situations "
17860"where the file triggers, or the declarative B<activate> triggers control "
17861"file directive, are insufficiently rich. It can also be used for testing and "
17862"by system administrators (but note that the triggers won't actually be run "
17863"by B<dpkg-trigger>)."
17864msgstr ""
17865
17866#. type: Plain text
17867#: dpkg-trigger.man:1
17868msgid "Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>."
17869msgstr ""
17870
17871#. type: TP
17872#: dpkg-trigger.man:1
17873#, no-wrap
17874msgid "B<--check-supported>"
17875msgstr ""
17876
17877#. type: Plain text
17878#: dpkg-trigger.man:1
17879msgid ""
17880"Check if the running B<dpkg> supports triggers (usually called from a "
17881"postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> "
17882"with an error message to stderr if not. Normally, however, it is better just "
17883"to activate the desired trigger with B<dpkg-trigger>."
17884msgstr ""
17885
17886#. type: TP
17887#: dpkg-trigger.man:1
17888#, no-wrap
17889msgid "B<--by-package=>I<package>"
17890msgstr ""
17891
17892#. type: Plain text
17893#: dpkg-trigger.man:1
17894msgid ""
17895"Override trigger awaiter (normally set by B<dpkg> through the "
17896"B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, "
17897"naming the package to which the script belongs, and this will be used by "
17898"default)."
17899msgstr ""
17900
17901#. type: TP
17902#: dpkg-trigger.man:1
17903#, no-wrap
17904msgid "B<--no-await>"
17905msgstr ""
17906
17907#. type: Plain text
17908#: dpkg-trigger.man:1
17909msgid ""
17910"This option arranges that the calling package T (if any) need not await the "
17911"processing of this trigger; the interested package(s) I, will not be added "
17912"to T's trigger processing awaited list and T's status is unchanged. T may "
17913"be considered installed even though I may not yet have processed the "
17914"trigger."
17915msgstr ""
17916
17917#. type: TP
17918#: dpkg-trigger.man:1
17919#, no-wrap
17920msgid "B<--await>"
17921msgstr ""
17922
17923#. type: Plain text
17924#: dpkg-trigger.man:1
17925msgid ""
17926"This option does the inverse of B<--no-await> (since dpkg 1.17.21). It is "
17927"currently the default behavior."
17928msgstr ""
17929
17930#. type: TP
17931#: dpkg-trigger.man:1
17932#, no-wrap
17933msgid "B<--no-act>"
17934msgstr ""
17935
17936#. type: Plain text
17937#: dpkg-trigger.man:1
17938msgid "Just test, do not actually change anything."
17939msgstr ""
17940
17941#. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
17942#. type: Plain text
17943#: dpkg-trigger.man:1
17944msgid "B<dpkg>(1), B<deb-triggers>(5), B</usr/share/doc/dpkg-dev/triggers.txt.gz>."
17945msgstr ""
17946
17947#. type: TH
17948#: dpkg-vendor.man:1
17949#, no-wrap
17950msgid "dpkg-vendor"
17951msgstr ""
17952
17953#. type: Plain text
17954#: dpkg-vendor.man:1
17955msgid "dpkg-vendor - queries information about distribution vendors"
17956msgstr ""
17957
17958#. type: Plain text
17959#: dpkg-vendor.man:1
17960msgid "B<dpkg-vendor> [I<option>...] I<command>"
17961msgstr ""
17962
17963#. type: Plain text
17964#: dpkg-vendor.man:1
17965msgid ""
17966"B<dpkg-vendor> is a tool to query information about vendors listed in "
17967"B<%PKGCONFDIR%/origins>. B<%PKGCONFDIR%/origins/default> contains "
17968"information about the current vendor."
17969msgstr ""
17970
17971#. type: TP
17972#: dpkg-vendor.man:1
17973#, no-wrap
17974msgid "B<--is>I< vendor>"
17975msgstr ""
17976
17977#. type: Plain text
17978#: dpkg-vendor.man:1
17979msgid ""
17980"Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with "
17981"B<1>."
17982msgstr ""
17983
17984#. type: TP
17985#: dpkg-vendor.man:1
17986#, no-wrap
17987msgid "B<--derives-from>I< vendor>"
17988msgstr ""
17989
17990#. type: Plain text
17991#: dpkg-vendor.man:1
17992msgid ""
17993"Exits with B<0> if the current vendor distribution is a derivative of "
17994"I<vendor>, otherwise exits with B<1>. It uses the B<Parent> field to browse "
17995"all ancestors of the current vendor."
17996msgstr ""
17997
17998#. type: TP
17999#: dpkg-vendor.man:1
18000#, no-wrap
18001msgid "B<--query>I< field>"
18002msgstr ""
18003
18004#. type: Plain text
18005#: dpkg-vendor.man:1
18006msgid ""
18007"Print on standard output the value of the vendor-specific I<field> for the "
18008"current vendor."
18009msgstr ""
18010
18011#. type: TP
18012#: dpkg-vendor.man:1
18013#, no-wrap
18014msgid "B<--vendor>I< vendor>"
18015msgstr ""
18016
18017#. type: Plain text
18018#: dpkg-vendor.man:1
18019msgid ""
18020"Assumes the current vendor is I<vendor> instead of discovering it with the "
18021"B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>."
18022msgstr ""
18023
18024#. type: Plain text
18025#: dpkg-vendor.man:1
18026msgid ""
18027"This setting defines the current vendor. If not set, it will discover the "
18028"current vendor by reading B<%PKGCONFDIR%/origins/default>."
18029msgstr ""
18030
18031#. type: Plain text
18032#: dpkg-vendor.man:1
18033msgid "B<deb-origin>(5)."
18034msgstr ""
18035
18036#. type: TH
18037#: dselect.man:1
18038#, no-wrap
18039msgid "dselect"
18040msgstr ""
18041
18042#. type: Plain text
18043#: dselect.man:1
18044msgid "dselect - Debian package management frontend"
18045msgstr ""
18046
18047#. type: Plain text
18048#: dselect.man:1
18049msgid "B<dselect> [I<option>...] [I<command>...]"
18050msgstr ""
18051
18052#. type: Plain text
18053#: dselect.man:1
18054#, no-wrap
18055msgid ""
18056"B<dselect>\n"
18057"is one of the primary user interfaces for managing packages on a Debian\n"
18058"system. At the B<dselect> main menu, the system administrator can:\n"
18059" - Update the list of available package versions,\n"
18060" - View the status of installed and available packages,\n"
18061" - Alter package selections and manage dependencies,\n"
18062" - Install new packages or upgrade to newer versions.\n"
18063msgstr ""
18064
18065#. type: Plain text
18066#: dselect.man:1
18067msgid ""
18068"B<dselect> operates as a front-end to B<dpkg>(1), the low-level Debian "
18069"package handling tool. It features a full-screen package selections manager "
18070"with package depends and conflicts resolver. When run with administrator "
18071"privileges, packages can be installed, upgraded and removed. Various access "
18072"methods can be configured to retrieve available package version information "
18073"and installable packages from package repositories. Depending on the used "
18074"access method, these repositories can be public archive servers on the "
18075"internet, local archive servers or cdroms. The recommended access method is "
18076"I<apt>, which is provided by the package B<apt>."
18077msgstr ""
18078
18079#. type: Plain text
18080#: dselect.man:1
18081msgid ""
18082"Normally B<dselect> is invoked without parameters. An interactive menu is "
18083"presented, offering the user a list of commands. If a command is given as "
18084"argument, then that command is started immediately. Several command line "
18085"parameters are still available to modify the running behaviour of B<dselect> "
18086"or show additional information about the program."
18087msgstr ""
18088
18089#. type: Plain text
18090#: dselect.man:1
18091msgid ""
18092"All options can be specified both on the command line and in the B<dselect> "
18093"configuration file I<%PKGCONFDIR%/dselect.cfg> or the files on the "
18094"configuration directory I<%PKGCONFDIR%/dselect.cfg.d/>. Each line in the "
18095"configuration file is either an option (exactly the same as the command line "
18096"option but without leading hyphens) or a comment (if it starts with a "
18097"‘B<#>’)."
18098msgstr ""
18099
18100#. type: Plain text
18101#: dselect.man:1
18102msgid ""
18103"Changes the directory where the dpkg ‘I<status>’, ‘I<available>’ and similar "
18104"files are located. This defaults to I<%ADMINDIR%> and normally there "
18105"shouldn't be any need to change it."
18106msgstr ""
18107
18108#. type: TP
18109#: dselect.man:1
18110#, no-wrap
18111msgid "B<-D>I<file>, B<--debug> I<file>"
18112msgstr ""
18113
18114#. type: Plain text
18115#: dselect.man:1
18116msgid "Turn on debugging. Debugging information is sent to I<file>."
18117msgstr ""
18118
18119#. type: TP
18120#: dselect.man:1
18121#, no-wrap
18122msgid "B<--expert>"
18123msgstr ""
18124
18125#. type: Plain text
18126#: dselect.man:1
18127msgid "Turns on expert mode, i.e. doesn't display possibly annoying help messages."
18128msgstr ""
18129
18130#. type: TP
18131#: dselect.man:1
18132#, no-wrap
18133msgid ""
18134"B<--colour>|B<--color> "
18135"I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
18136msgstr ""
18137
18138#. type: Plain text
18139#: dselect.man:1
18140msgid ""
18141"Configures screen colors. This works only if your display supports colors. "
18142"This option may be used multiple times (and is best used in "
18143"I<dselect.cfg>). Each use changes the color (and optionally, other "
18144"attributes) of one part of the screen. The parts of the screen (from top to "
18145"bottom) are:"
18146msgstr ""
18147
18148#. type: TP
18149#: dselect.man:1
18150#, no-wrap
18151msgid "B<title>"
18152msgstr ""
18153
18154#. type: Plain text
18155#: dselect.man:1
18156msgid "The screen title."
18157msgstr ""
18158
18159#. type: TP
18160#: dselect.man:1
18161#, no-wrap
18162msgid "B<listhead>"
18163msgstr ""
18164
18165#. type: Plain text
18166#: dselect.man:1
18167msgid "The header line above the list of packages."
18168msgstr ""
18169
18170#. type: TP
18171#: dselect.man:1
18172#, no-wrap
18173msgid "B<list>"
18174msgstr ""
18175
18176#. type: Plain text
18177#: dselect.man:1
18178msgid "The scrolling list of packages (and also some help text)."
18179msgstr ""
18180
18181#. type: TP
18182#: dselect.man:1
18183#, no-wrap
18184msgid "B<listsel>"
18185msgstr ""
18186
18187#. type: Plain text
18188#: dselect.man:1
18189msgid "The selected item in the list."
18190msgstr ""
18191
18192#. type: TP
18193#: dselect.man:1
18194#, no-wrap
18195msgid "B<pkgstate>"
18196msgstr ""
18197
18198#. type: Plain text
18199#: dselect.man:1
18200msgid ""
18201"In the list of packages, the text indicating the current state of each "
18202"package."
18203msgstr ""
18204
18205#. type: TP
18206#: dselect.man:1
18207#, no-wrap
18208msgid "B<pkgstatesel>"
18209msgstr ""
18210
18211#. type: Plain text
18212#: dselect.man:1
18213msgid ""
18214"In the list of packages, the text indicating the current state of the "
18215"currently selected package."
18216msgstr ""
18217
18218#. type: TP
18219#: dselect.man:1
18220#, no-wrap
18221msgid "B<infohead>"
18222msgstr ""
18223
18224#. type: Plain text
18225#: dselect.man:1
18226msgid "The header line that displays the state of the currently selected package."
18227msgstr ""
18228
18229#. type: TP
18230#: dselect.man:1
18231#, no-wrap
18232msgid "B<infodesc>"
18233msgstr ""
18234
18235#. type: Plain text
18236#: dselect.man:1
18237msgid "The package's short description."
18238msgstr ""
18239
18240#. type: TP
18241#: dselect.man:1
18242#, no-wrap
18243msgid "B<info>"
18244msgstr ""
18245
18246#. type: Plain text
18247#: dselect.man:1
18248msgid "Used to display package info such as the package's description."
18249msgstr ""
18250
18251#. type: TP
18252#: dselect.man:1
18253#, no-wrap
18254msgid "B<infofoot>"
18255msgstr ""
18256
18257#. type: Plain text
18258#: dselect.man:1
18259msgid "The last line of the screen when selecting packages."
18260msgstr ""
18261
18262#. type: TP
18263#: dselect.man:1
18264#, no-wrap
18265msgid "B<query>"
18266msgstr ""
18267
18268#. type: Plain text
18269#: dselect.man:1
18270msgid "Used to display query lines"
18271msgstr ""
18272
18273#. type: TP
18274#: dselect.man:1
18275#, no-wrap
18276msgid "B<helpscreen>"
18277msgstr ""
18278
18279#. type: Plain text
18280#: dselect.man:1
18281msgid "Color of help screens."
18282msgstr ""
18283
18284#. type: Plain text
18285#: dselect.man:1
18286msgid ""
18287"After the part of the screen comes a colon and the color specification. You "
18288"can specify either the foreground color, the background color, or both, "
18289"overriding the compiled-in colors. Use standard curses color names."
18290msgstr ""
18291
18292#. type: Plain text
18293#: dselect.man:1
18294msgid ""
18295"Optionally, after the color specification is another colon, and an attribute "
18296"specification. This is a list of one or more attributes, separated by plus "
18297"(‘+’) characters. Available attributes include (not all of these will work "
18298"on all terminals): B<normal>, B<standout>, B<underline>, B<reverse>, "
18299"B<blink>, B<bright>, B<dim>, B<bold>"
18300msgstr ""
18301
18302#. type: Plain text
18303#: dselect.man:1
18304msgid "Print a brief help text and exit successfully."
18305msgstr ""
18306
18307#. type: Plain text
18308#: dselect.man:1
18309msgid "Print version information and exit successfully."
18310msgstr ""
18311
18312#. type: Plain text
18313#: dselect.man:1
18314msgid ""
18315"When B<dselect> is started it can perform the following commands, either "
18316"directly if it was specified on the command line or by prompting the user "
18317"with a menu of available commands if running interactively:"
18318msgstr ""
18319
18320#. type: SS
18321#: dselect.man:1
18322#, no-wrap
18323msgid "access"
18324msgstr ""
18325
18326#. type: Plain text
18327#: dselect.man:1
18328msgid "Choose and configure an access method to access package repositories."
18329msgstr ""
18330
18331#. type: Plain text
18332#: dselect.man:1
18333msgid ""
18334"By default, B<dselect> provides several methods such as I<cdrom>, "
18335"I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, "
18336"I<floppy> or I<ftp>, but other packages may provide additional methods, "
18337"eg. the I<apt> access method provided by the B<apt> package."
18338msgstr ""
18339
18340#. type: Plain text
18341#: dselect.man:1
18342msgid "The use of the I<apt> access method is strongly recommended."
18343msgstr ""
18344
18345#. type: SS
18346#: dselect.man:1
18347#, no-wrap
18348msgid "update"
18349msgstr ""
18350
18351#. type: Plain text
18352#: dselect.man:1
18353msgid "Refresh the available packages database."
18354msgstr ""
18355
18356#. type: Plain text
18357#: dselect.man:1
18358msgid ""
18359"Retrieves a list of available package versions from the package repository, "
18360"configured for the current access method, and update the dpkg database. The "
18361"package lists are commonly provided by the repository as files named "
18362"I<Packages> or I<Packages.gz>. These files can be generated by repository "
18363"maintainers, using the program B<dpkg-scanpackages>(1)."
18364msgstr ""
18365
18366#. type: Plain text
18367#: dselect.man:1
18368msgid ""
18369"Details of the update command depend on the access method's implementation. "
18370"Normally the process is straightforward and requires no user interaction."
18371msgstr ""
18372
18373#. type: SS
18374#: dselect.man:1
18375#, no-wrap
18376msgid "select"
18377msgstr ""
18378
18379#. type: Plain text
18380#: dselect.man:1
18381msgid "View or manage package selections and dependencies."
18382msgstr ""
18383
18384#. type: Plain text
18385#: dselect.man:1
18386msgid ""
18387"This is the main function of B<dselect>. In the select screen, the user can "
18388"review a list of all available and installed packages. When run with "
18389"administrator privileges, it is also possible to interactively change "
18390"packages selection state. B<dselect> tracks the implications of these "
18391"changes to other depending or conflicting packages."
18392msgstr ""
18393
18394#. type: Plain text
18395#: dselect.man:1
18396msgid ""
18397"When a conflict or failed depends is detected, a dependency resolution "
18398"subscreen is prompted to the user. In this screen, a list of conflicting or "
18399"depending packages is shown, and for each package listed, the reason for its "
18400"listing is shown. The user may apply the suggestions proposed by B<dselect>, "
18401"override them, or back out all the changes, including the ones that created "
18402"the unresolved depends or conflicts."
18403msgstr ""
18404
18405#. type: Plain text
18406#: dselect.man:1
18407msgid ""
18408"The use of the interactive package selections management screen is explained "
18409"in more detail below."
18410msgstr ""
18411
18412#. type: SS
18413#: dselect.man:1
18414#, no-wrap
18415msgid "install"
18416msgstr ""
18417
18418#. type: Plain text
18419#: dselect.man:1
18420msgid "Installs selected packages."
18421msgstr ""
18422
18423#. type: Plain text
18424#: dselect.man:1
18425msgid ""
18426"The configured access method will fetch installable or upgradable packages "
18427"from the relevant repositories and install these using B<dpkg>. Depending "
18428"on the implementation of the access method, all packages can be prefetched "
18429"before installation, or fetched when needed. Some access methods may also "
18430"remove packages that were marked for removal."
18431msgstr ""
18432
18433#. type: Plain text
18434#: dselect.man:1
18435msgid ""
18436"If an error occurred during install, it is usually advisable to run install "
18437"again. In most cases, the problems will disappear or be solved. If problems "
18438"persist or the installation performed was incorrect, please investigate into "
18439"the causes and circumstances, and file a bug in the Debian bug tracking "
18440"system. Instructions on how to do this can be found at "
18441"https://bugs.debian.org/ or by reading the documentation for B<bug>(1) or "
18442"B<reportbug>(1), if these are installed."
18443msgstr ""
18444
18445#. type: Plain text
18446#: dselect.man:1
18447msgid ""
18448"Details of the install command depend on the access method's "
18449"implementation. The user's attention and input may be required during "
18450"installation, configuration or removal of packages. This depends on the "
18451"maintainer scripts in the package. Some packages make use of the "
18452"B<debconf>(1) library, allowing for more flexible or even automated "
18453"installation setups."
18454msgstr ""
18455
18456#. type: SS
18457#: dselect.man:1
18458#, no-wrap
18459msgid "config"
18460msgstr ""
18461
18462#. type: Plain text
18463#: dselect.man:1
18464msgid "Configures any previously installed, but not fully configured packages."
18465msgstr ""
18466
18467#. type: SS
18468#: dselect.man:1
18469#, no-wrap
18470msgid "remove"
18471msgstr ""
18472
18473#. type: Plain text
18474#: dselect.man:1
18475msgid "Removes or purges installed packages, that are marked for removal."
18476msgstr ""
18477
18478#. type: SS
18479#: dselect.man:1
18480#, no-wrap
18481msgid "quit"
18482msgstr ""
18483
18484#. type: Plain text
18485#: dselect.man:1
18486msgid "Quit B<dselect>."
18487msgstr ""
18488
18489#. type: Plain text
18490#: dselect.man:1
18491msgid "Exits the program with zero (successful) errorcode."
18492msgstr ""
18493
18494#. type: SH
18495#: dselect.man:1
18496#, no-wrap
18497msgid "PACKAGE SELECTIONS MANAGEMENT"
18498msgstr ""
18499
18500#. type: SS
18501#: dselect.man:1
18502#, no-wrap
18503msgid "Introduction"
18504msgstr ""
18505
18506#. type: Plain text
18507#: dselect.man:1
18508msgid ""
18509"B<dselect> directly exposes the administrator to some of the complexities "
18510"involved with managing large sets of packages with many "
18511"interdependencies. For a user who is unfamiliar with the concepts and the "
18512"ways of the Debian package management system, it can be quite "
18513"overwhelming. Although B<dselect> is aimed at easing package management and "
18514"administration, it is only instrumental in doing so and cannot be assumed to "
18515"be a sufficient substitute for administrator skill and understanding. The "
18516"user is required to be familiar with the concepts underlying the Debian "
18517"packaging system. In case of doubt, consult the B<dpkg>(1) manpage and the "
18518"distribution policy."
18519msgstr ""
18520
18521#. type: Plain text
18522#: dselect.man:1
18523msgid ""
18524"Unless B<dselect> is run in expert or immediate mode, a help screen is first "
18525"displayed when choosing this command from the menu. The user is I<strongly> "
18526"advised to study all of the information presented in the online help "
18527"screens, when one pops up. The online help screens can at any time be "
18528"invoked with the ‘B<?>’ key."
18529msgstr ""
18530
18531#. type: SS
18532#: dselect.man:1
18533#, no-wrap
18534msgid "Screen layout"
18535msgstr ""
18536
18537#. type: Plain text
18538#: dselect.man:1
18539msgid ""
18540"The select screen is by default split in a top and a bottom half. The top "
18541"half shows a list of packages. A cursor bar can select an individual "
18542"package, or a group of packages, if applicable, by selecting the group "
18543"header. The bottom half of the screen shows some details about the package "
18544"currently selected in the top half of the screen. The type of detail that "
18545"is displayed can be varied."
18546msgstr ""
18547
18548#. type: Plain text
18549#: dselect.man:1
18550msgid ""
18551"Pressing the ‘B<I>’ key toggles a full-screen display of the packages list, "
18552"an enlarged view of the package details, or the equally split screen."
18553msgstr ""
18554
18555#. type: SS
18556#: dselect.man:1
18557#, no-wrap
18558msgid "Package details view"
18559msgstr ""
18560
18561#. type: Plain text
18562#: dselect.man:1
18563#, no-wrap
18564msgid ""
18565"The package details view by default shows the extended package description\n"
18566"for the package that is currently selected in the packages status list.\n"
18567"The type of detail can be toggled by pressing the ‘B<i>’ key.\n"
18568"This alternates between:\n"
18569" - the extended description\n"
18570" - the control information for the installed version\n"
18571" - the control information for the available version\n"
18572msgstr ""
18573
18574#. type: Plain text
18575#: dselect.man:1
18576msgid ""
18577"In a dependency resolution screen, there is also the possibility of viewing "
18578"the specific unresolved depends or conflicts related to the package and "
18579"causing it to be listed."
18580msgstr ""
18581
18582#. type: SS
18583#: dselect.man:1
18584#, no-wrap
18585msgid "Packages status list"
18586msgstr ""
18587
18588#. type: Plain text
18589#: dselect.man:1
18590msgid ""
18591"The main select screen displays a list of all packages known to the Debian "
18592"package management system. This includes packages installed on the system "
18593"and packages known from the available packages database."
18594msgstr ""
18595
18596#. type: Plain text
18597#: dselect.man:1
18598msgid ""
18599"For every package, the list shows the package's status, priority, section, "
18600"installed and available architecture, installed and available versions, the "
18601"package name and its short description, all in one line. By pressing the "
18602"‘B<A>’ key, the display of the installed and available architecture can be "
18603"toggled between on an off. By pressing the ‘B<V>’ key, the display of the "
18604"installed and available version can be toggled between on an off. By "
18605"pressing the ‘B<v>’ key, the package status display is toggled between "
18606"verbose and shorthand. Shorthand display is the default."
18607msgstr ""
18608
18609#. type: Plain text
18610#: dselect.man:1
18611msgid ""
18612"The shorthand status indication consists of four parts: an error flag, which "
18613"should normally be clear, the current status, the last selection state and "
18614"the current selection state. The first two relate to the actual state of "
18615"the package, the second pair are about the selections set by the user."
18616msgstr ""
18617
18618#. type: Plain text
18619#: dselect.man:1
18620#, no-wrap
18621msgid ""
18622"These are the meanings of the shorthand package status indicator codes:\n"
18623" Error flag:\n"
18624" I<empty> no error\n"
18625" B<R> serious error, needs reinstallation;\n"
18626" Installed state:\n"
18627" I<empty> not installed;\n"
18628" B<*> fully installed and configured;\n"
18629" B<-> not installed but some config files may remain;\n"
18630" B<U> unpacked but not yet configured;\n"
18631" B<C> half-configured (an error happened);\n"
18632" B<I> half-installed (an error happened).\n"
18633" Current and requested selections:\n"
18634" B<*> marked for installation or upgrade;\n"
18635" B<-> marked for removal, configuration files remain;\n"
18636" B<=> on hold: package will not be processed at all;\n"
18637" B<_> marked for purge, also remove configuration;\n"
18638" B<n> package is new and has yet to be marked.\n"
18639msgstr ""
18640
18641#. type: SS
18642#: dselect.man:1
18643#, no-wrap
18644msgid "Cursor and screen movement"
18645msgstr ""
18646
18647#. type: Plain text
18648#: dselect.man:1
18649msgid ""
18650"The package selection list and the dependency conflict resolution screens "
18651"can be navigated using motion commands mapped to the following keys:"
18652msgstr ""
18653
18654#. type: Plain text
18655#: dselect.man:1
18656#, no-wrap
18657msgid ""
18658" B<p, Up, k> move cursor bar up\n"
18659" B<n, Down, j> move cursor bar down\n"
18660" B<P, Pgup, Backspace> scroll list 1 page up\n"
18661" B<N, Pgdn, Space> scroll list 1 page down\n"
18662" B<^p> scroll list 1 line up\n"
18663" B<^n> scroll list 1 line down\n"
18664" B<t, Home> jump to top of list\n"
18665" B<e, End> jump to end of list\n"
18666" B<u> scroll info 1 page up\n"
18667" B<d> scroll info 1 page down\n"
18668" B<^u> scroll info 1 line up\n"
18669" B<^d> scroll info 1 line down\n"
18670" B<B, Left-arrow> pan display 1/3 screen left\n"
18671" B<F, Right-arrow> pan display 1/3 screen right\n"
18672" B<^b> pan display 1 character left\n"
18673" B<^f> pan display 1 character right\n"
18674msgstr ""
18675
18676#. type: SS
18677#: dselect.man:1
18678#, no-wrap
18679msgid "Searching and sorting"
18680msgstr ""
18681
18682#. type: Plain text
18683#: dselect.man:1
18684msgid ""
18685"The list of packages can be searched by package name. This is done by "
18686"pressing ‘B</>’, and typing a simple search string. The string is "
18687"interpreted as a B<regex>(7) regular expression. If you add ‘B</d>’ to the "
18688"search expression, dselect will also search in descriptions. If you add "
18689"‘B</i>’ the search will be case insensitive. You may combine these two "
18690"suffixes like this: ‘B</id>’. Repeated searching is accomplished by "
18691"repeatedly pressing the ‘B<n>’ or ‘B<\\e>’ keys, until the wanted package is "
18692"found. If the search reaches the bottom of the list, it wraps to the top "
18693"and continues searching from there."
18694msgstr ""
18695
18696#. type: Plain text
18697#: dselect.man:1
18698#, no-wrap
18699msgid ""
18700"The list sort order can be varied by pressing\n"
18701"the ‘B<o>’ and ‘B<O>’ keys repeatedly.\n"
18702"The following nine sort orderings can be selected:\n"
18703" alphabet available status\n"
18704" priority+section available+priority status+priority\n"
18705" section+priority available+section status+section\n"
18706msgstr ""
18707
18708#. type: Plain text
18709#: dselect.man:1
18710msgid ""
18711"Where not listed above explicitly, alphabetic order is used as the final "
18712"subordering sort key."
18713msgstr ""
18714
18715#. type: SS
18716#: dselect.man:1
18717#, no-wrap
18718msgid "Altering selections"
18719msgstr ""
18720
18721#. type: Plain text
18722#: dselect.man:1
18723#, no-wrap
18724msgid ""
18725"The requested selection state of individual packages may be\n"
18726"altered with the following commands:\n"
18727" B<+, Insert> install or upgrade\n"
18728" B<=, H> hold in present state and version\n"
18729" B<:, G> unhold: upgrade or leave uninstalled\n"
18730" B<-, Delete> remove, but leave configuration\n"
18731" B<_> remove & purge configuration\n"
18732msgstr ""
18733
18734#. type: Plain text
18735#: dselect.man:1
18736msgid ""
18737"When the change request results in one or more unsatisfied depends or "
18738"conflicts, B<dselect> prompts the user with a dependency resolution "
18739"screen. This will be further explained below."
18740msgstr ""
18741
18742#. type: Plain text
18743#: dselect.man:1
18744msgid ""
18745"It is also possible to apply these commands to groups of package selections, "
18746"by pointing the cursor bar onto a group header. The exact grouping of "
18747"packages is dependent on the current list ordering settings."
18748msgstr ""
18749
18750#. type: Plain text
18751#: dselect.man:1
18752msgid ""
18753"Proper care should be taken when altering large groups of selections, "
18754"because this can instantaneously create large numbers of unresolved depends "
18755"or conflicts, all of which will be listed in one dependency resolution "
18756"screen, making them very hard to handle. In practice, only hold and unhold "
18757"operations are useful when applied to groups."
18758msgstr ""
18759
18760#. type: SS
18761#: dselect.man:1
18762#, no-wrap
18763msgid "Resolving depends and conflicts"
18764msgstr ""
18765
18766#. type: Plain text
18767#: dselect.man:1
18768msgid ""
18769"When the change request results in one or more unsatisfied depends or "
18770"conflicts, B<dselect> prompts the user with a dependency resolution "
18771"screen. First however, an informative help screen is displayed."
18772msgstr ""
18773
18774#. type: Plain text
18775#: dselect.man:1
18776msgid ""
18777"The top half of this screen lists all the packages that will have unresolved "
18778"depends or conflicts, as a result of the requested change, and all the "
18779"packages whose installation can resolve any of these depends or whose "
18780"removal can resolve any of the conflicts. The bottom half defaults to show "
18781"the depends or conflicts that cause the currently selected package to be "
18782"listed."
18783msgstr ""
18784
18785#. type: Plain text
18786#: dselect.man:1
18787msgid ""
18788"When the sublist of packages is displayed initially, B<dselect> may have "
18789"already set the requested selection status of some of the listed packages, "
18790"in order to resolve the depends or conflicts that caused the dependency "
18791"resolution screen to be displayed. Usually, it is best to follow up the "
18792"suggestions made by B<dselect>."
18793msgstr ""
18794
18795#. type: Plain text
18796#: dselect.man:1
18797msgid ""
18798"The listed packages' selection state may be reverted to the original "
18799"settings, as they were before the unresolved depends or conflicts were "
18800"created, by pressing the ‘B<R>’ key. By pressing the ‘B<D>’ key, the "
18801"automatic suggestions are reset, but the change that caused the dependency "
18802"resolution screen to be prompted is kept as requested. Finally, by pressing "
18803"‘B<U>’, the selections are again set to the automatic suggestion values."
18804msgstr ""
18805
18806#. type: SS
18807#: dselect.man:1
18808#, no-wrap
18809msgid "Establishing the requested selections"
18810msgstr ""
18811
18812#. type: Plain text
18813#: dselect.man:1
18814msgid ""
18815"By pressing B<enter>, the currently displayed set of selections is "
18816"accepted. If B<dselect> detects no unresolved depends as a result of the "
18817"requested selections, the new selections will be set. However, if there are "
18818"any unresolved depends, B<dselect> will again prompt the user with a "
18819"dependency resolution screen."
18820msgstr ""
18821
18822#. type: Plain text
18823#: dselect.man:1
18824msgid ""
18825"To alter a set of selections that creates unresolved depends or conflicts "
18826"and forcing B<dselect> to accept it, press the ‘B<Q>’ key. This sets the "
18827"selections as specified by the user, unconditionally. Generally, don't do "
18828"this unless you've read the fine print."
18829msgstr ""
18830
18831#. type: Plain text
18832#: dselect.man:1
18833msgid ""
18834"The opposite effect, to back out any selections change requests and go back "
18835"to the previous list of selections, is attained by pressing the ‘B<X>’ or "
18836"B<escape> keys. By repeatedly pressing these keys, any possibly detrimental "
18837"changes to the requested package selections can be backed out completely to "
18838"the last established settings."
18839msgstr ""
18840
18841#. type: Plain text
18842#: dselect.man:1
18843msgid ""
18844"If you mistakenly establish some settings and wish to revert all the "
18845"selections to what is currently installed on the system, press the ‘B<C>’ "
18846"key. This is somewhat similar to using the unhold command on all packages, "
18847"but provides a more obvious panic button in cases where the user pressed "
18848"B<enter> by accident."
18849msgstr ""
18850
18851#. type: Plain text
18852#: dselect.man:1
18853msgid "The requested command was successfully performed."
18854msgstr ""
18855
18856#. type: Plain text
18857#: dselect.man:1
18858msgid ""
18859"If set, B<dselect> will use it as the directory from which to read the user "
18860"specific configuration file."
18861msgstr ""
18862
18863#. type: Plain text
18864#: dselect.man:1
18865msgid ""
18866"The B<dselect> package selection interface is confusing to some new users. "
18867"Reportedly, it even makes seasoned kernel developers cry."
18868msgstr ""
18869
18870#. type: Plain text
18871#: dselect.man:1
18872msgid "The documentation is lacking."
18873msgstr ""
18874
18875#. type: Plain text
18876#: dselect.man:1
18877msgid "There is no help option in the main menu."
18878msgstr ""
18879
18880#. type: Plain text
18881#: dselect.man:1
18882msgid "The visible list of available packages cannot be reduced."
18883msgstr ""
18884
18885#. type: Plain text
18886#: dselect.man:1
18887msgid ""
18888"The built in access methods can no longer stand up to current quality "
18889"standards. Use the access method provided by apt, it is not only not broken, "
18890"it is also much more flexible than the built in access methods."
18891msgstr ""
18892
18893#. type: Plain text
18894#: dselect.man:1
18895msgid "B<dpkg>(1), B<apt-get>(8), B<sources.list>(5), B<deb>(5)."
18896msgstr ""
18897
18898#. type: TH
18899#: dselect.cfg.man:1
18900#, no-wrap
18901msgid "dselect.cfg"
18902msgstr ""
18903
18904#. type: Plain text
18905#: dselect.cfg.man:1
18906msgid "dselect.cfg - dselect configuration file"
18907msgstr ""
18908
18909#. type: Plain text
18910#: dselect.cfg.man:1
18911msgid ""
18912"This file contains default options for dselect. Each line contains a single "
18913"option which is exactly the same as a normal command line option for dselect "
18914"except for the leading hyphens which are not used here. Quotes surrounding "
18915"option values are stripped. Comments are allowed by starting a line with a "
18916"hash sign (‘B<#>’)."
18917msgstr ""
18918
18919#. type: Plain text
18920#: dselect.cfg.man:1
18921msgid "I<%PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*>"
18922msgstr ""
18923
18924#. type: Plain text
18925#: dselect.cfg.man:1
18926msgid "I<%PKGCONFDIR%/dselect.cfg>"
18927msgstr ""
18928
18929#. type: Plain text
18930#: dselect.cfg.man:1
18931msgid "I<~/.dselect.cfg>"
18932msgstr ""
18933
18934#. type: Plain text
18935#: dselect.cfg.man:1
18936msgid "B<dselect>(1)."
18937msgstr ""
18938
18939#. type: TH
18940#: start-stop-daemon.man:1
18941#, no-wrap
18942msgid "start-stop-daemon"
18943msgstr ""
18944
18945#. type: Plain text
18946#: start-stop-daemon.man:1
18947msgid "start-stop-daemon - start and stop system daemon programs"
18948msgstr ""
18949
18950#. type: Plain text
18951#: start-stop-daemon.man:1
18952msgid "B<start-stop-daemon> [I<option>...] I<command>"
18953msgstr ""
18954
18955#. type: Plain text
18956#: start-stop-daemon.man:1
18957msgid ""
18958"B<start-stop-daemon> is used to control the creation and termination of "
18959"system-level processes. Using one of the matching options, "
18960"B<start-stop-daemon> can be configured to find existing instances of a "
18961"running process."
18962msgstr ""
18963
18964#. type: Plain text
18965#: start-stop-daemon.man:1
18966msgid ""
18967"Note: unless B<--pid> or B<--pidfile> are specified, B<start-stop-daemon> "
18968"behaves similar to B<killall>(1). B<start-stop-daemon> will scan the "
18969"process table looking for any processes which match the process name, parent "
18970"pid, uid, and/or gid (if specified). Any matching process will prevent "
18971"B<--start> from starting the daemon. All matching processes will be sent the "
18972"TERM signal (or the one specified via B<--signal> or B<--retry>) if "
18973"B<--stop> is specified. For daemons which have long-lived children which "
18974"need to live through a B<--stop>, you must specify a pidfile."
18975msgstr ""
18976
18977#. type: TP
18978#: start-stop-daemon.man:1
18979#, no-wrap
18980msgid "B<-S>, B<--start> [B<-->] I<arguments>"
18981msgstr ""
18982
18983#. type: Plain text
18984#: start-stop-daemon.man:1
18985msgid ""
18986"Check for the existence of a specified process. If such a process exists, "
18987"B<start-stop-daemon> does nothing, and exits with error status 1 (0 if "
18988"B<--oknodo> is specified). If such a process does not exist, it starts an "
18989"instance, using either the executable specified by B<--exec> or, if "
18990"specified, by B<--startas>. Any arguments given after B<--> on the command "
18991"line are passed unmodified to the program being started."
18992msgstr ""
18993
18994#. type: TP
18995#: start-stop-daemon.man:1
18996#, no-wrap
18997msgid "B<-K>, B<--stop>"
18998msgstr ""
18999
19000#. type: Plain text
19001#: start-stop-daemon.man:1
19002msgid ""
19003"Checks for the existence of a specified process. If such a process exists, "
19004"B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits "
19005"with error status 0. If such a process does not exist, B<start-stop-daemon> "
19006"exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is "
19007"specified, then B<start-stop-daemon> will check that the process(es) have "
19008"terminated."
19009msgstr ""
19010
19011#. type: TP
19012#: start-stop-daemon.man:1
19013#, no-wrap
19014msgid "B<-T>, B<--status>"
19015msgstr ""
19016
19017#. type: Plain text
19018#: start-stop-daemon.man:1
19019msgid ""
19020"Check for the existence of a specified process, and returns an exit status "
19021"code, according to the LSB Init Script Actions (since version 1.16.1)."
19022msgstr ""
19023
19024#. type: TP
19025#: start-stop-daemon.man:1
19026#, no-wrap
19027msgid "B<-H>, B<--help>"
19028msgstr ""
19029
19030#. type: Plain text
19031#: start-stop-daemon.man:1
19032msgid "Show usage information and exit."
19033msgstr ""
19034
19035#. type: TP
19036#: start-stop-daemon.man:1
19037#, no-wrap
19038msgid "B<-V>, B<--version>"
19039msgstr ""
19040
19041#. type: Plain text
19042#: start-stop-daemon.man:1
19043msgid "Show the program version and exit."
19044msgstr ""
19045
19046#. type: SS
19047#: start-stop-daemon.man:1
19048#, no-wrap
19049msgid "Matching options"
19050msgstr ""
19051
19052#. type: TP
19053#: start-stop-daemon.man:1
19054#, no-wrap
19055msgid "B<--pid> I<pid>"
19056msgstr ""
19057
19058#. type: Plain text
19059#: start-stop-daemon.man:1
19060msgid ""
19061"Check for a process with the specified I<pid> (since version 1.17.6). The "
19062"I<pid> must be a number greater than 0."
19063msgstr ""
19064
19065#. type: TP
19066#: start-stop-daemon.man:1
19067#, no-wrap
19068msgid "B<--ppid> I<ppid>"
19069msgstr ""
19070
19071#. type: Plain text
19072#: start-stop-daemon.man:1
19073msgid ""
19074"Check for a process with the specified parent pid I<ppid> (since version "
19075"1.17.7). The I<ppid> must be a number greater than 0."
19076msgstr ""
19077
19078#. type: TP
19079#: start-stop-daemon.man:1
19080#, no-wrap
19081msgid "B<-p>, B<--pidfile> I<pid-file>"
19082msgstr ""
19083
19084#. type: Plain text
19085#: start-stop-daemon.man:1
19086msgid ""
19087"Check whether a process has created the file I<pid-file>. Note: using this "
19088"matching option alone might cause unintended processes to be acted on, if "
19089"the old process terminated without being able to remove the I<pid-file>."
19090msgstr ""
19091
19092#. type: TP
19093#: start-stop-daemon.man:1
19094#, no-wrap
19095msgid "B<-x>, B<--exec> I<executable>"
19096msgstr ""
19097
19098#. type: Plain text
19099#: start-stop-daemon.man:1
19100msgid ""
19101"Check for processes that are instances of this I<executable>. The "
19102"I<executable> argument should be an absolute pathname. Note: this might not "
19103"work as intended with interpreted scripts, as the executable will point to "
19104"the interpreter. Take into account processes running from inside a chroot "
19105"will also be matched, so other match restrictions might be needed."
19106msgstr ""
19107
19108#. type: TP
19109#: start-stop-daemon.man:1
19110#, no-wrap
19111msgid "B<-n>, B<--name> I<process-name>"
19112msgstr ""
19113
19114#. type: Plain text
19115#: start-stop-daemon.man:1
19116msgid ""
19117"Check for processes with the name I<process-name>. The I<process-name> is "
19118"usually the process filename, but it could have been changed by the process "
19119"itself. Note: on most systems this information is retrieved from the process "
19120"comm name from the kernel, which tends to have a relatively short length "
19121"limit (assuming more than 15 characters is non-portable)."
19122msgstr ""
19123
19124#. type: TP
19125#: start-stop-daemon.man:1
19126#, no-wrap
19127msgid "B<-u>, B<--user> I<username>|I<uid>"
19128msgstr ""
19129
19130#. type: Plain text
19131#: start-stop-daemon.man:1
19132msgid ""
19133"Check for processes owned by the user specified by I<username> or "
19134"I<uid>. Note: using this matching option alone will cause all processes "
19135"matching the user to be acted on."
19136msgstr ""
19137
19138#. type: SS
19139#: start-stop-daemon.man:1
19140#, no-wrap
19141msgid "Generic options"
19142msgstr ""
19143
19144#. type: TP
19145#: start-stop-daemon.man:1
19146#, no-wrap
19147msgid "B<-g>, B<--group> I<group>|I<gid>"
19148msgstr ""
19149
19150#. type: Plain text
19151#: start-stop-daemon.man:1
19152msgid "Change to I<group> or I<gid> when starting the process."
19153msgstr ""
19154
19155#. type: TP
19156#: start-stop-daemon.man:1
19157#, no-wrap
19158msgid "B<-s>, B<--signal> I<signal>"
19159msgstr ""
19160
19161#. type: Plain text
19162#: start-stop-daemon.man:1
19163msgid ""
19164"With B<--stop>, specifies the signal to send to processes being stopped "
19165"(default TERM)."
19166msgstr ""
19167
19168#. type: TP
19169#: start-stop-daemon.man:1
19170#, no-wrap
19171msgid "B<-R>, B<--retry> I<timeout>|I<schedule>"
19172msgstr ""
19173
19174#. type: Plain text
19175#: start-stop-daemon.man:1
19176msgid ""
19177"With B<--stop>, specifies that B<start-stop-daemon> is to check whether the "
19178"process(es) do finish. It will check repeatedly whether any matching "
19179"processes are running, until none are. If the processes do not exit it will "
19180"then take further action as determined by the schedule."
19181msgstr ""
19182
19183#. type: Plain text
19184#: start-stop-daemon.man:1
19185msgid ""
19186"If I<timeout> is specified instead of I<schedule>, then the schedule "
19187"I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the "
19188"signal specified with B<--signal>."
19189msgstr ""
19190
19191#. type: Plain text
19192#: start-stop-daemon.man:1
19193msgid ""
19194"I<schedule> is a list of at least two items separated by slashes (B</>); "
19195"each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means "
19196"to send that signal, or I<timeout>, which means to wait that many seconds "
19197"for processes to exit, or B<forever>, which means to repeat the rest of the "
19198"schedule forever if necessary."
19199msgstr ""
19200
19201#. type: Plain text
19202#: start-stop-daemon.man:1
19203msgid ""
19204"If the end of the schedule is reached and B<forever> is not specified, then "
19205"B<start-stop-daemon> exits with error status 2. If a schedule is specified, "
19206"then any signal specified with B<--signal> is ignored."
19207msgstr ""
19208
19209#. type: TP
19210#: start-stop-daemon.man:1
19211#, no-wrap
19212msgid "B<-a>, B<--startas> I<pathname>"
19213msgstr ""
19214
19215#. type: Plain text
19216#: start-stop-daemon.man:1
19217msgid ""
19218"With B<--start>, start the process specified by I<pathname>. If not "
19219"specified, defaults to the argument given to B<--exec>."
19220msgstr ""
19221
19222#. type: TP
19223#: start-stop-daemon.man:1
19224#, no-wrap
19225msgid "B<-t>, B<--test>"
19226msgstr ""
19227
19228#. type: Plain text
19229#: start-stop-daemon.man:1
19230msgid ""
19231"Print actions that would be taken and set appropriate return value, but take "
19232"no action."
19233msgstr ""
19234
19235#. type: TP
19236#: start-stop-daemon.man:1
19237#, no-wrap
19238msgid "B<-o>, B<--oknodo>"
19239msgstr ""
19240
19241#. type: Plain text
19242#: start-stop-daemon.man:1
19243msgid "Return exit status 0 instead of 1 if no actions are (would be) taken."
19244msgstr ""
19245
19246#. type: TP
19247#: start-stop-daemon.man:1
19248#, no-wrap
19249msgid "B<-q>, B<--quiet>"
19250msgstr ""
19251
19252#. type: Plain text
19253#: start-stop-daemon.man:1
19254msgid "Do not print informational messages; only display error messages."
19255msgstr ""
19256
19257#. type: TP
19258#: start-stop-daemon.man:1
19259#, no-wrap
19260msgid "B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]"
19261msgstr ""
19262
19263#. type: Plain text
19264#: start-stop-daemon.man:1
19265msgid ""
19266"Change to this username/uid before starting the process. You can also "
19267"specify a group by appending a B<:>, then the group or gid in the same way "
19268"as you would for the B<chown>(1) command (I<user>B<:>I<group>). If a user "
19269"is specified without a group, the primary GID for that user is used. When "
19270"using this option you must realize that the primary and supplemental groups "
19271"are set as well, even if the B<--group> option is not specified. The "
19272"B<--group> option is only for groups that the user isn't normally a member "
19273"of (like adding per process group membership for generic users like "
19274"B<nobody>)."
19275msgstr ""
19276
19277#. type: TP
19278#: start-stop-daemon.man:1
19279#, no-wrap
19280msgid "B<-r>, B<--chroot> I<root>"
19281msgstr ""
19282
19283#. type: Plain text
19284#: start-stop-daemon.man:1
19285msgid ""
19286"Chdir and chroot to I<root> before starting the process. Please note that "
19287"the pidfile is also written after the chroot."
19288msgstr ""
19289
19290#. type: TP
19291#: start-stop-daemon.man:1
19292#, no-wrap
19293msgid "B<-d>, B<--chdir> I<path>"
19294msgstr ""
19295
19296#. type: Plain text
19297#: start-stop-daemon.man:1
19298msgid ""
19299"Chdir to I<path> before starting the process. This is done after the chroot "
19300"if the B<-r>|B<--chroot> option is set. When not specified, "
19301"B<start-stop-daemon> will chdir to the root directory before starting the "
19302"process."
19303msgstr ""
19304
19305#. type: TP
19306#: start-stop-daemon.man:1
19307#, no-wrap
19308msgid "B<-b>, B<--background>"
19309msgstr ""
19310
19311#. type: Plain text
19312#: start-stop-daemon.man:1
19313msgid ""
19314"Typically used with programs that don't detach on their own. This option "
19315"will force B<start-stop-daemon> to fork before starting the process, and "
19316"force it into the background. B<Warning: start-stop-daemon> cannot check "
19317"the exit status if the process fails to execute for B<any> reason. This is a "
19318"last resort, and is only meant for programs that either make no sense "
19319"forking on their own, or where it's not feasible to add the code for them to "
19320"do this themselves."
19321msgstr ""
19322
19323#. type: TP
19324#: start-stop-daemon.man:1
19325#, no-wrap
19326msgid "B<-C>, B<--no-close>"
19327msgstr ""
19328
19329#. type: Plain text
19330#: start-stop-daemon.man:1
19331msgid ""
19332"Do not close any file descriptor when forcing the daemon into the background "
19333"(since version 1.16.5). Used for debugging purposes to see the process "
19334"output, or to redirect file descriptors to log the process output. Only "
19335"relevant when using B<--background>."
19336msgstr ""
19337
19338#. type: TP
19339#: start-stop-daemon.man:1
19340#, no-wrap
19341msgid "B<-N>, B<--nicelevel> I<int>"
19342msgstr ""
19343
19344#. type: Plain text
19345#: start-stop-daemon.man:1
19346msgid "This alters the priority of the process before starting it."
19347msgstr ""
19348
19349#. type: TP
19350#: start-stop-daemon.man:1
19351#, no-wrap
19352msgid "B<-P>, B<--procsched> I<policy>B<:>I<priority>"
19353msgstr ""
19354
19355#. type: Plain text
19356#: start-stop-daemon.man:1
19357msgid ""
19358"This alters the process scheduler policy and priority of the process before "
19359"starting it (since version 1.15.0). The priority can be optionally "
19360"specified by appending a B<:> followed by the value. The default I<priority> "
19361"is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>."
19362msgstr ""
19363
19364#. type: TP
19365#: start-stop-daemon.man:1
19366#, no-wrap
19367msgid "B<-I>, B<--iosched> I<class>B<:>I<priority>"
19368msgstr ""
19369
19370#. type: Plain text
19371#: start-stop-daemon.man:1
19372msgid ""
19373"This alters the IO scheduler class and priority of the process before "
19374"starting it (since version 1.15.0). The priority can be optionally "
19375"specified by appending a B<:> followed by the value. The default I<priority> "
19376"is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The "
19377"currently supported values for I<class> are B<idle>, B<best-effort> and "
19378"B<real-time>."
19379msgstr ""
19380
19381#. type: TP
19382#: start-stop-daemon.man:1
19383#, no-wrap
19384msgid "B<-k>, B<--umask> I<mask>"
19385msgstr ""
19386
19387#. type: Plain text
19388#: start-stop-daemon.man:1
19389msgid ""
19390"This sets the umask of the process before starting it (since version "
19391"1.13.22)."
19392msgstr ""
19393
19394#. type: TP
19395#: start-stop-daemon.man:1
19396#, no-wrap
19397msgid "B<-m>, B<--make-pidfile>"
19398msgstr ""
19399
19400#. type: Plain text
19401#: start-stop-daemon.man:1
19402msgid ""
19403"Used when starting a program that does not create its own pid file. This "
19404"option will make B<start-stop-daemon> create the file referenced with "
19405"B<--pidfile> and place the pid into it just before executing the "
19406"process. Note, the file will only be removed when stopping the program if "
19407"B<--remove-pidfile> is used. B<Note:> This feature may not work in all "
19408"cases. Most notably when the program being executed forks from its main "
19409"process. Because of this, it is usually only useful when combined with the "
19410"B<--background> option."
19411msgstr ""
19412
19413#. type: TP
19414#: start-stop-daemon.man:1
19415#, no-wrap
19416msgid "B<--remove-pidfile>"
19417msgstr ""
19418
19419#. type: Plain text
19420#: start-stop-daemon.man:1
19421msgid ""
19422"Used when stopping a program that does not remove its own pid file (since "
19423"version 1.17.19). This option will make B<start-stop-daemon> remove the "
19424"file referenced with B<--pidfile> after terminating the process."
19425msgstr ""
19426
19427#. type: Plain text
19428#: start-stop-daemon.man:1
19429msgid "Print verbose informational messages."
19430msgstr ""
19431
19432#. type: Plain text
19433#: start-stop-daemon.man:1
19434msgid ""
19435"The requested action was performed. If B<--oknodo> was specified, it's also "
19436"possible that nothing had to be done. This can happen when B<--start> was "
19437"specified and a matching process was already running, or when B<--stop> was "
19438"specified and there were no matching processes."
19439msgstr ""
19440
19441#. type: Plain text
19442#: start-stop-daemon.man:1
19443msgid "If B<--oknodo> was not specified and nothing was done."
19444msgstr ""
19445
19446#. type: Plain text
19447#: start-stop-daemon.man:1
19448msgid ""
19449"If B<--stop> and B<--retry> were specified, but the end of the schedule was "
19450"reached and the processes were still running."
19451msgstr ""
19452
19453#. type: TP
19454#: start-stop-daemon.man:1 start-stop-daemon.man:1
19455#, no-wrap
19456msgid "B<3>"
19457msgstr ""
19458
19459#. type: Plain text
19460#: start-stop-daemon.man:1
19461msgid "Any other error."
19462msgstr ""
19463
19464#. type: Plain text
19465#: start-stop-daemon.man:1
19466msgid "When using the B<--status> command, the following status codes are returned:"
19467msgstr ""
19468
19469#. type: Plain text
19470#: start-stop-daemon.man:1
19471msgid "Program is running."
19472msgstr ""
19473
19474#. type: Plain text
19475#: start-stop-daemon.man:1
19476msgid "Program is not running and the pid file exists."
19477msgstr ""
19478
19479#. type: Plain text
19480#: start-stop-daemon.man:1
19481msgid "Program is not running."
19482msgstr ""
19483
19484#. type: TP
19485#: start-stop-daemon.man:1
19486#, no-wrap
19487msgid "B<4>"
19488msgstr ""
19489
19490#. type: Plain text
19491#: start-stop-daemon.man:1
19492msgid "Unable to determine program status."
19493msgstr ""
19494
19495#. type: Plain text
19496#: start-stop-daemon.man:1
19497msgid ""
19498"Start the B<food> daemon, unless one is already running (a process named "
19499"food, running as user food, with pid in food.pid):"
19500msgstr ""
19501
19502#. type: Plain text
19503#: start-stop-daemon.man:1
19504#, no-wrap
19505msgid ""
19506"start-stop-daemon --start --oknodo --user food --name food \\e\n"
19507"\t--pidfile /run/food.pid --startas /usr/sbin/food \\e\n"
19508"\t--chuid food -- --daemon\n"
19509msgstr ""
19510
19511#. type: Plain text
19512#: start-stop-daemon.man:1
19513msgid "Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:"
19514msgstr ""
19515
19516#. type: Plain text
19517#: start-stop-daemon.man:1
19518#, no-wrap
19519msgid ""
19520"start-stop-daemon --stop --oknodo --user food --name food \\e\n"
19521"\t--pidfile /run/food.pid --retry 5\n"
19522msgstr ""
19523
19524#. type: Plain text
19525#: start-stop-daemon.man:1
19526msgid "Demonstration of a custom schedule for stopping B<food>:"
19527msgstr ""
19528
19529#. type: Plain text
19530#: start-stop-daemon.man:1
19531#, no-wrap
19532msgid ""
19533"start-stop-daemon --stop --oknodo --user food --name food \\e\n"
19534"\t--pidfile /run/food.pid --retry=TERM/30/KILL/5\n"
19535msgstr ""
19536
19537#. type: TH
19538#: update-alternatives.man:1
19539#, no-wrap
19540msgid "update-alternatives"
19541msgstr ""
19542
19543#. type: Plain text
19544#: update-alternatives.man:1
19545msgid "update-alternatives - maintain symbolic links determining default commands"
19546msgstr ""
19547
19548#. type: Plain text
19549#: update-alternatives.man:1
19550msgid "B<update-alternatives> [I<option>...] I<command>"
19551msgstr ""
19552
19553#. type: Plain text
19554#: update-alternatives.man:1
19555msgid ""
19556"B<update-alternatives> creates, removes, maintains and displays information "
19557"about the symbolic links comprising the Debian alternatives system."
19558msgstr ""
19559
19560#. type: Plain text
19561#: update-alternatives.man:1
19562msgid ""
19563"It is possible for several programs fulfilling the same or similar functions "
19564"to be installed on a single system at the same time. For example, many "
19565"systems have several text editors installed at once. This gives choice to "
19566"the users of a system, allowing each to use a different editor, if desired, "
19567"but makes it difficult for a program to make a good choice for an editor to "
19568"invoke if the user has not specified a particular preference."
19569msgstr ""
19570
19571#. type: Plain text
19572#: update-alternatives.man:1
19573msgid ""
19574"Debian's alternatives system aims to solve this problem. A generic name in "
19575"the filesystem is shared by all files providing interchangeable "
19576"functionality. The alternatives system and the system administrator "
19577"together determine which actual file is referenced by this generic name. "
19578"For example, if the text editors B<ed>(1) and B<nvi>(1) are both installed "
19579"on the system, the alternatives system will cause the generic name "
19580"I</usr/bin/editor> to refer to I</usr/bin/nvi> by default. The system "
19581"administrator can override this and cause it to refer to I</usr/bin/ed> "
19582"instead, and the alternatives system will not alter this setting until "
19583"explicitly requested to do so."
19584msgstr ""
19585
19586#. type: Plain text
19587#: update-alternatives.man:1
19588msgid ""
19589"The generic name is not a direct symbolic link to the selected alternative. "
19590"Instead, it is a symbolic link to a name in the I<alternatives> "
19591"I<directory>, which in turn is a symbolic link to the actual file "
19592"referenced. This is done so that the system administrator's changes can be "
19593"confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why "
19594"this is a Good Thing."
19595msgstr ""
19596
19597#. type: Plain text
19598#: update-alternatives.man:1
19599msgid ""
19600"When each package providing a file with a particular functionality is "
19601"installed, changed or removed, B<update-alternatives> is called to update "
19602"information about that file in the alternatives system. "
19603"B<update-alternatives> is usually called from the B<postinst> (configure) or "
19604"B<prerm> (remove and deconfigure) scripts in Debian packages."
19605msgstr ""
19606
19607#. type: Plain text
19608#: update-alternatives.man:1
19609msgid ""
19610"It is often useful for a number of alternatives to be synchronized, so that "
19611"they are changed as a group; for example, when several versions of the "
19612"B<vi>(1) editor are installed, the man page referenced by "
19613"I</usr/share/man/man1/vi.1> should correspond to the executable referenced "
19614"by I</usr/bin/vi>. B<update-alternatives> handles this by means of "
19615"I<master> and I<slave> links; when the master is changed, any associated "
19616"slaves are changed too. A master link and its associated slaves make up a "
19617"I<link> I<group>."
19618msgstr ""
19619
19620#. type: Plain text
19621#: update-alternatives.man:1
19622msgid ""
19623"Each link group is, at any given time, in one of two modes: automatic or "
19624"manual. When a group is in automatic mode, the alternatives system will "
19625"automatically decide, as packages are installed and removed, whether and how "
19626"to update the links. In manual mode, the alternatives system will retain "
19627"the choice of the administrator and avoid changing the links (except when "
19628"something is broken)."
19629msgstr ""
19630
19631#. type: Plain text
19632#: update-alternatives.man:1
19633msgid ""
19634"Link groups are in automatic mode when they are first introduced to the "
19635"system. If the system administrator makes changes to the system's automatic "
19636"settings, this will be noticed the next time B<update-alternatives> is run "
19637"on the changed link's group, and the group will automatically be switched to "
19638"manual mode."
19639msgstr ""
19640
19641#. type: Plain text
19642#: update-alternatives.man:1
19643msgid ""
19644"Each alternative has a I<priority> associated with it. When a link group is "
19645"in automatic mode, the alternatives pointed to by members of the group will "
19646"be those which have the highest priority."
19647msgstr ""
19648
19649#. type: Plain text
19650#: update-alternatives.man:1
19651msgid ""
19652"When using the B<--config> option, B<update-alternatives> will list all of "
19653"the choices for the link group of which given I<name> is the master "
19654"alternative name. The current choice is marked with a ‘*’. You will then "
19655"be prompted for your choice regarding this link group. Depending on the "
19656"choice made, the link group might no longer be in I<auto> mode. You will "
19657"need to use the B<--auto> option in order to return to the automatic mode "
19658"(or you can rerun B<--config> and select the entry marked as automatic)."
19659msgstr ""
19660
19661#. type: Plain text
19662#: update-alternatives.man:1
19663msgid ""
19664"If you want to configure non-interactively you can use the B<--set> option "
19665"instead (see below)."
19666msgstr ""
19667
19668#. type: Plain text
19669#: update-alternatives.man:1
19670msgid ""
19671"Different packages providing the same file need to do so B<cooperatively>. "
19672"In other words, the usage of B<update-alternatives> is B<mandatory> for all "
19673"involved packages in such case. It is not possible to override some file in "
19674"a package that does not employ the B<update-alternatives> mechanism."
19675msgstr ""
19676
19677#. type: SH
19678#: update-alternatives.man:1
19679#, no-wrap
19680msgid "TERMINOLOGY"
19681msgstr ""
19682
19683#. type: Plain text
19684#: update-alternatives.man:1
19685msgid ""
19686"Since the activities of B<update-alternatives> are quite involved, some "
19687"specific terms will help to explain its operation."
19688msgstr ""
19689
19690#. type: TP
19691#: update-alternatives.man:1
19692#, no-wrap
19693msgid "generic name (or alternative link)"
19694msgstr ""
19695
19696#. type: Plain text
19697#: update-alternatives.man:1
19698msgid ""
19699"A name, like I</usr/bin/editor>, which refers, via the alternatives system, "
19700"to one of a number of files of similar function."
19701msgstr ""
19702
19703#. type: TP
19704#: update-alternatives.man:1
19705#, no-wrap
19706msgid "alternative name"
19707msgstr ""
19708
19709#. type: Plain text
19710#: update-alternatives.man:1
19711msgid "The name of a symbolic link in the alternatives directory."
19712msgstr ""
19713
19714#. type: TP
19715#: update-alternatives.man:1
19716#, no-wrap
19717msgid "alternative (or alternative path)"
19718msgstr ""
19719
19720#. type: Plain text
19721#: update-alternatives.man:1
19722msgid ""
19723"The name of a specific file in the filesystem, which may be made accessible "
19724"via a generic name using the alternatives system."
19725msgstr ""
19726
19727#. type: TP
19728#: update-alternatives.man:1
19729#, no-wrap
19730msgid "alternatives directory"
19731msgstr ""
19732
19733#. type: Plain text
19734#: update-alternatives.man:1
19735msgid "A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks."
19736msgstr ""
19737
19738#. type: TP
19739#: update-alternatives.man:1
19740#, no-wrap
19741msgid "administrative directory"
19742msgstr ""
19743
19744#. type: Plain text
19745#: update-alternatives.man:1
19746msgid ""
19747"A directory, by default I<%ADMINDIR%/alternatives>, containing "
19748"B<update-alternatives>' state information."
19749msgstr ""
19750
19751#. type: TP
19752#: update-alternatives.man:1
19753#, no-wrap
19754msgid "link group"
19755msgstr ""
19756
19757#. type: Plain text
19758#: update-alternatives.man:1
19759msgid "A set of related symlinks, intended to be updated as a group."
19760msgstr ""
19761
19762#. type: TP
19763#: update-alternatives.man:1
19764#, no-wrap
19765msgid "master link"
19766msgstr ""
19767
19768#. type: Plain text
19769#: update-alternatives.man:1
19770msgid ""
19771"The alternative link in a link group which determines how the other links in "
19772"the group are configured."
19773msgstr ""
19774
19775#. type: TP
19776#: update-alternatives.man:1
19777#, no-wrap
19778msgid "slave link"
19779msgstr ""
19780
19781#. type: Plain text
19782#: update-alternatives.man:1
19783msgid ""
19784"An alternative link in a link group which is controlled by the setting of "
19785"the master link."
19786msgstr ""
19787
19788#. type: TP
19789#: update-alternatives.man:1
19790#, no-wrap
19791msgid "automatic mode"
19792msgstr ""
19793
19794#. type: Plain text
19795#: update-alternatives.man:1
19796msgid ""
19797"When a link group is in automatic mode, the alternatives system ensures that "
19798"the links in the group point to the highest priority alternative appropriate "
19799"for the group."
19800msgstr ""
19801
19802#. type: TP
19803#: update-alternatives.man:1
19804#, no-wrap
19805msgid "manual mode"
19806msgstr ""
19807
19808#. type: Plain text
19809#: update-alternatives.man:1
19810msgid ""
19811"When a link group is in manual mode, the alternatives system will not make "
19812"any changes to the system administrator's settings."
19813msgstr ""
19814
19815#. type: TP
19816#: update-alternatives.man:1
19817#, no-wrap
19818msgid "B<--install> I<link name path priority> [B<--slave> I<link name path>]..."
19819msgstr ""
19820
19821#. type: Plain text
19822#: update-alternatives.man:1
19823msgid ""
19824"Add a group of alternatives to the system. I<link> is the generic name for "
19825"the master link, I<name> is the name of its symlink in the alternatives "
19826"directory, and I<path> is the alternative being introduced for the master "
19827"link. The arguments after B<--slave> are the generic name, symlink name in "
19828"the alternatives directory and the alternative path for a slave link. Zero "
19829"or more B<--slave> options, each followed by three arguments, may be "
19830"specified. Note that the master alternative must exist or the call will "
19831"fail. However if a slave alternative doesn't exist, the corresponding slave "
19832"alternative link will simply not be installed (a warning will still be "
19833"displayed). If some real file is installed where an alternative link has to "
19834"be installed, it is kept unless B<--force> is used."
19835msgstr ""
19836
19837#. type: Plain text
19838#: update-alternatives.man:1
19839msgid ""
19840"If the alternative name specified exists already in the alternatives "
19841"system's records, the information supplied will be added as a new set of "
19842"alternatives for the group. Otherwise, a new group, set to automatic mode, "
19843"will be added with this information. If the group is in automatic mode, and "
19844"the newly added alternatives' priority is higher than any other installed "
19845"alternatives for this group, the symlinks will be updated to point to the "
19846"newly added alternatives."
19847msgstr ""
19848
19849#. type: TP
19850#: update-alternatives.man:1
19851#, no-wrap
19852msgid "B<--set> I<name path>"
19853msgstr ""
19854
19855#. type: Plain text
19856#: update-alternatives.man:1
19857msgid ""
19858"Set the program I<path> as alternative for I<name.> This is equivalent to "
19859"B<--config> but is non-interactive and thus scriptable."
19860msgstr ""
19861
19862#. type: TP
19863#: update-alternatives.man:1
19864#, no-wrap
19865msgid "B<--remove> I<name path>"
19866msgstr ""
19867
19868#. type: Plain text
19869#: update-alternatives.man:1
19870msgid ""
19871"Remove an alternative and all of its associated slave links. I<name> is a "
19872"name in the alternatives directory, and I<path> is an absolute filename to "
19873"which I<name> could be linked. If I<name> is indeed linked to I<path>, "
19874"I<name> will be updated to point to another appropriate alternative (and the "
19875"group is put back in automatic mode), or removed if there is no such "
19876"alternative left. Associated slave links will be updated or removed, "
19877"correspondingly. If the link is not currently pointing to I<path>, no links "
19878"are changed; only the information about the alternative is removed."
19879msgstr ""
19880
19881#. type: TP
19882#: update-alternatives.man:1
19883#, no-wrap
19884msgid "B<--remove-all> I<name>"
19885msgstr ""
19886
19887#. type: Plain text
19888#: update-alternatives.man:1
19889msgid ""
19890"Remove all alternatives and all of their associated slave links. I<name> is "
19891"a name in the alternatives directory."
19892msgstr ""
19893
19894#. type: Plain text
19895#: update-alternatives.man:1
19896msgid ""
19897"Call B<--config> on all alternatives. It can be usefully combined with "
19898"B<--skip-auto> to review and configure all alternatives which are not "
19899"configured in automatic mode. Broken alternatives are also displayed. Thus "
19900"a simple way to fix all broken alternatives is to call B<yes '' | "
19901"update-alternatives --force --all>."
19902msgstr ""
19903
19904#. type: TP
19905#: update-alternatives.man:1
19906#, no-wrap
19907msgid "B<--auto> I<name>"
19908msgstr ""
19909
19910#. type: Plain text
19911#: update-alternatives.man:1
19912msgid ""
19913"Switch the link group behind the alternative for I<name> to automatic mode. "
19914"In the process, the master symlink and its slaves are updated to point to "
19915"the highest priority installed alternatives."
19916msgstr ""
19917
19918#. type: TP
19919#: update-alternatives.man:1
19920#, no-wrap
19921msgid "B<--display> I<name>"
19922msgstr ""
19923
19924#. type: Plain text
19925#: update-alternatives.man:1
19926msgid ""
19927"Display information about the link group. Information displayed includes "
19928"the group's mode (auto or manual), the master and slave links, which "
19929"alternative the master link currently points to, what other alternatives are "
19930"available (and their corresponding slave alternatives), and the highest "
19931"priority alternative currently installed."
19932msgstr ""
19933
19934#. type: TP
19935#: update-alternatives.man:1
19936#, no-wrap
19937msgid "B<--get-selections>"
19938msgstr ""
19939
19940#. type: Plain text
19941#: update-alternatives.man:1
19942msgid ""
19943"List all master alternative names (those controlling a link group) and "
19944"their status (since version 1.15.0). Each line contains up to 3 fields "
19945"(separated by one or more spaces). The first field is the alternative name, "
19946"the second one is the status (either B<auto> or B<manual>), and the last one "
19947"contains the current choice in the alternative (beware: it's a filename and "
19948"thus might contain spaces)."
19949msgstr ""
19950
19951#. type: Plain text
19952#: update-alternatives.man:1
19953msgid ""
19954"Read configuration of alternatives on standard input in the format generated "
19955"by B<--get-selections> and reconfigure them accordingly (since version "
19956"1.15.0)."
19957msgstr ""
19958
19959#. type: TP
19960#: update-alternatives.man:1
19961#, no-wrap
19962msgid "B<--query> I<name>"
19963msgstr ""
19964
19965#. type: Plain text
19966#: update-alternatives.man:1
19967msgid ""
19968"Display information about the link group like B<--display> does, but in a "
19969"machine parseable way (since version 1.15.0, see section B<QUERY FORMAT> "
19970"below)."
19971msgstr ""
19972
19973#. type: TP
19974#: update-alternatives.man:1
19975#, no-wrap
19976msgid "B<--list> I<name>"
19977msgstr ""
19978
19979#. type: Plain text
19980#: update-alternatives.man:1
19981msgid "Display all targets of the link group."
19982msgstr ""
19983
19984#. type: TP
19985#: update-alternatives.man:1
19986#, no-wrap
19987msgid "B<--config> I<name>"
19988msgstr ""
19989
19990#. type: Plain text
19991#: update-alternatives.man:1
19992msgid ""
19993"Show available alternatives for a link group and allow the user to "
19994"interactively select which one to use. The link group is updated."
19995msgstr ""
19996
19997#. type: TP
19998#: update-alternatives.man:1
19999#, no-wrap
20000msgid "B<--altdir>I< directory>"
20001msgstr ""
20002
20003#. type: Plain text
20004#: update-alternatives.man:1
20005msgid ""
20006"Specifies the alternatives directory, when this is to be different from the "
20007"default."
20008msgstr ""
20009
20010#. type: Plain text
20011#: update-alternatives.man:1
20012msgid ""
20013"Specifies the administrative directory, when this is to be different from "
20014"the default."
20015msgstr ""
20016
20017#. type: TP
20018#: update-alternatives.man:1
20019#, no-wrap
20020msgid "B<--log>I< file>"
20021msgstr ""
20022
20023#. type: Plain text
20024#: update-alternatives.man:1
20025msgid ""
20026"Specifies the log file (since version 1.15.0), when this is to be different "
20027"from the default (%LOGDIR%/alternatives.log)."
20028msgstr ""
20029
20030#. type: Plain text
20031#: update-alternatives.man:1
20032msgid ""
20033"Allow replacing or dropping any real file that is installed where an "
20034"alternative link has to be installed or removed."
20035msgstr ""
20036
20037#. type: TP
20038#: update-alternatives.man:1
20039#, no-wrap
20040msgid "B<--skip-auto>"
20041msgstr ""
20042
20043#. type: Plain text
20044#: update-alternatives.man:1
20045msgid ""
20046"Skip configuration prompt for alternatives which are properly configured in "
20047"automatic mode. This option is only relevant with B<--config> or B<--all>."
20048msgstr ""
20049
20050#. type: TP
20051#: update-alternatives.man:1
20052#, no-wrap
20053msgid "B<--verbose>"
20054msgstr ""
20055
20056#. type: Plain text
20057#: update-alternatives.man:1
20058msgid "Generate more comments about what is being done."
20059msgstr ""
20060
20061#. type: Plain text
20062#: update-alternatives.man:1
20063msgid "Don't generate any comments unless errors occur."
20064msgstr ""
20065
20066#. type: Plain text
20067#: update-alternatives.man:1
20068msgid ""
20069"Problems were encountered whilst parsing the command line or performing the "
20070"action."
20071msgstr ""
20072
20073#. type: Plain text
20074#: update-alternatives.man:1
20075msgid ""
20076"If set and the B<--admindir> option has not been specified, it will be used "
20077"as the base administrative directory."
20078msgstr ""
20079
20080#. type: TP
20081#: update-alternatives.man:1
20082#, no-wrap
20083msgid "I<%CONFDIR%/alternatives/>"
20084msgstr ""
20085
20086#. type: Plain text
20087#: update-alternatives.man:1
20088msgid ""
20089"The default alternatives directory. Can be overridden by the B<--altdir> "
20090"option."
20091msgstr ""
20092
20093#. type: TP
20094#: update-alternatives.man:1
20095#, no-wrap
20096msgid "I<%ADMINDIR%/alternatives/>"
20097msgstr ""
20098
20099#. type: Plain text
20100#: update-alternatives.man:1
20101msgid ""
20102"The default administration directory. Can be overridden by the "
20103"B<--admindir> option."
20104msgstr ""
20105
20106#. type: SH
20107#: update-alternatives.man:1
20108#, no-wrap
20109msgid "QUERY FORMAT"
20110msgstr ""
20111
20112#. type: Plain text
20113#: update-alternatives.man:1
20114msgid ""
20115"The B<--query> format is using an RFC822-like flat format. It's made of I<n> "
20116"+ 1 blocks where I<n> is the number of alternatives available in the queried "
20117"link group. The first block contains the following fields:"
20118msgstr ""
20119
20120#. type: TP
20121#: update-alternatives.man:1
20122#, no-wrap
20123msgid "B<Name:>I< name>"
20124msgstr ""
20125
20126#. type: Plain text
20127#: update-alternatives.man:1
20128msgid "The alternative name in the alternative directory."
20129msgstr ""
20130
20131#. type: TP
20132#: update-alternatives.man:1
20133#, no-wrap
20134msgid "B<Link:>I< link>"
20135msgstr ""
20136
20137#. type: Plain text
20138#: update-alternatives.man:1
20139msgid "The generic name of the alternative."
20140msgstr ""
20141
20142#. type: TP
20143#: update-alternatives.man:1 update-alternatives.man:1
20144#, no-wrap
20145msgid "B<Slaves:>I< list-of-slaves>"
20146msgstr ""
20147
20148#. type: Plain text
20149#: update-alternatives.man:1
20150msgid ""
20151"When this field is present, the B<next> lines hold all slave links "
20152"associated to the master link of the alternative. There is one slave per "
20153"line. Each line contains one space, the generic name of the slave "
20154"alternative, another space, and the path to the slave link."
20155msgstr ""
20156
20157#. type: TP
20158#: update-alternatives.man:1
20159#, no-wrap
20160msgid "B<Status:>I< status>"
20161msgstr ""
20162
20163#. type: Plain text
20164#: update-alternatives.man:1
20165msgid "The status of the alternative (B<auto> or B<manual>)."
20166msgstr ""
20167
20168#. type: TP
20169#: update-alternatives.man:1
20170#, no-wrap
20171msgid "B<Best:>I< best-choice>"
20172msgstr ""
20173
20174#. type: Plain text
20175#: update-alternatives.man:1
20176msgid ""
20177"The path of the best alternative for this link group. Not present if there "
20178"is no alternatives available."
20179msgstr ""
20180
20181#. type: TP
20182#: update-alternatives.man:1
20183#, no-wrap
20184msgid "B<Value:>I< currently-selected-alternative>"
20185msgstr ""
20186
20187#. type: Plain text
20188#: update-alternatives.man:1
20189msgid ""
20190"The path of the currently selected alternative. It can also take the magic "
20191"value B<none>. It is used if the link doesn't exist."
20192msgstr ""
20193
20194#. type: Plain text
20195#: update-alternatives.man:1
20196msgid ""
20197"The other blocks describe the available alternatives in the queried link "
20198"group:"
20199msgstr ""
20200
20201#. type: TP
20202#: update-alternatives.man:1
20203#, no-wrap
20204msgid "B<Alternative:>I< path-of-this-alternative>"
20205msgstr ""
20206
20207#. type: Plain text
20208#: update-alternatives.man:1
20209msgid "Path to this block's alternative."
20210msgstr ""
20211
20212#. type: TP
20213#: update-alternatives.man:1
20214#, no-wrap
20215msgid "B<Priority:>I< priority-value>"
20216msgstr ""
20217
20218#. type: Plain text
20219#: update-alternatives.man:1
20220msgid "Value of the priority of this alternative."
20221msgstr ""
20222
20223#. type: Plain text
20224#: update-alternatives.man:1
20225msgid ""
20226"When this field is present, the B<next> lines hold all slave alternatives "
20227"associated to the master link of the alternative. There is one slave per "
20228"line. Each line contains one space, the generic name of the slave "
20229"alternative, another space, and the path to the slave alternative."
20230msgstr ""
20231
20232#. type: SS
20233#: update-alternatives.man:1
20234#, no-wrap
20235msgid "Example"
20236msgstr ""
20237
20238#. type: Plain text
20239#: update-alternatives.man:1
20240#, no-wrap
20241msgid ""
20242"$ update-alternatives --query editor\n"
20243"Name: editor\n"
20244"Link: /usr/bin/editor\n"
20245"Slaves:\n"
20246" editor.1.gz /usr/share/man/man1/editor.1.gz\n"
20247" editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz\n"
20248" editor.it.1.gz /usr/share/man/it/man1/editor.1.gz\n"
20249" editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz\n"
20250" editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz\n"
20251"Status: auto\n"
20252"Best: /usr/bin/vim.basic\n"
20253"Value: /usr/bin/vim.basic\n"
20254msgstr ""
20255
20256#. type: Plain text
20257#: update-alternatives.man:1
20258#, no-wrap
20259msgid ""
20260"Alternative: /bin/ed\n"
20261"Priority: -100\n"
20262"Slaves:\n"
20263" editor.1.gz /usr/share/man/man1/ed.1.gz\n"
20264msgstr ""
20265
20266#. type: Plain text
20267#: update-alternatives.man:1
20268#, no-wrap
20269msgid ""
20270"Alternative: /usr/bin/vim.basic\n"
20271"Priority: 50\n"
20272"Slaves:\n"
20273" editor.1.gz /usr/share/man/man1/vim.1.gz\n"
20274" editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz\n"
20275" editor.it.1.gz /usr/share/man/it/man1/vim.1.gz\n"
20276" editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz\n"
20277" editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz\n"
20278msgstr ""
20279
20280#. type: Plain text
20281#: update-alternatives.man:1
20282msgid ""
20283"With B<--verbose> B<update-alternatives> chatters incessantly about its "
20284"activities on its standard output channel. If problems occur, "
20285"B<update-alternatives> outputs error messages on its standard error channel "
20286"and returns an exit status of 2. These diagnostics should be "
20287"self-explanatory; if you do not find them so, please report this as a bug."
20288msgstr ""
20289
20290#. type: Plain text
20291#: update-alternatives.man:1
20292msgid ""
20293"There are several packages which provide a text editor compatible with "
20294"B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the "
20295"link group B<vi>, which includes links for the program itself and the "
20296"associated manpage."
20297msgstr ""
20298
20299#. type: Plain text
20300#: update-alternatives.man:1
20301msgid ""
20302"To display the available packages which provide B<vi> and the current "
20303"setting for it, use the B<--display> action:"
20304msgstr ""
20305
20306#. type: Plain text
20307#: update-alternatives.man:1
20308msgid "B<update-alternatives --display vi>"
20309msgstr ""
20310
20311#. type: Plain text
20312#: update-alternatives.man:1
20313msgid ""
20314"To choose a particular B<vi> implementation, use this command as root and "
20315"then select a number from the list:"
20316msgstr ""
20317
20318#. type: Plain text
20319#: update-alternatives.man:1
20320msgid "B<update-alternatives --config vi>"
20321msgstr ""
20322
20323#. type: Plain text
20324#: update-alternatives.man:1
20325msgid ""
20326"To go back to having the B<vi> implementation chosen automatically, do this "
20327"as root:"
20328msgstr ""
20329
20330#. type: Plain text
20331#: update-alternatives.man:1
20332msgid "B<update-alternatives --auto vi>"
20333msgstr ""
20334
20335#. type: Plain text
20336#: update-alternatives.man:1
20337msgid "B<ln>(1), FHS, the Filesystem Hierarchy Standard."
20338msgstr ""