Switch from pkg-config to pkgconf
[dpkg.git] / man / po / dpkg-man.pot
blobddebe40b1858fd3640bb89baf2ec77a8fe081f8c
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.
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: dpkg-man 1.21.20\n"
10 "Report-Msgid-Bugs-To: debian-dpkg@lists.debian.org\n"
11 "POT-Creation-Date: 2023-02-07 11:18+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"
20 #. type: =head1
21 #: deb-buildinfo.pod deb-changelog.pod deb-changes.pod deb-conffiles.pod
22 #: deb-control.pod deb-extra-override.pod deb-md5sums.pod deb-old.pod
23 #: deb-origin.pod deb-override.pod deb-postinst.pod deb-postrm.pod
24 #: deb-preinst.pod deb-prerm.pod deb-shlibs.pod deb-split.pod
25 #: deb-src-control.pod deb-src-files.pod deb-src-rules.pod deb-src-symbols.pod
26 #: deb-substvars.pod deb-symbols.pod deb-triggers.pod deb-version.pod deb.pod
27 #: deb822.pod dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
28 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
29 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
30 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-maintscript-helper.pod
31 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
32 #: dpkg-query.pod dpkg-realpath.pod dpkg-scanpackages.pod dpkg-scansources.pod
33 #: dpkg-shlibdeps.pod dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod
34 #: dpkg-trigger.pod dpkg-vendor.pod dpkg.cfg.pod dpkg.pod dsc.pod
35 #: dselect.cfg.pod dselect.pod start-stop-daemon.pod update-alternatives.pod
36 msgid "NAME"
37 msgstr ""
39 #. type: textblock
40 #: deb-buildinfo.pod
41 msgid "deb-buildinfo - Debian build information file format"
42 msgstr ""
44 #. type: =head1
45 #: deb-buildinfo.pod deb-changelog.pod deb-changes.pod deb-conffiles.pod
46 #: deb-control.pod deb-extra-override.pod deb-md5sums.pod deb-old.pod
47 #: deb-origin.pod deb-override.pod deb-postinst.pod deb-postrm.pod
48 #: deb-preinst.pod deb-prerm.pod deb-shlibs.pod deb-split.pod
49 #: deb-src-control.pod deb-src-files.pod deb-src-rules.pod deb-src-symbols.pod
50 #: deb-substvars.pod deb-symbols.pod deb-triggers.pod deb-version.pod deb.pod
51 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
52 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
53 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
54 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-maintscript-helper.pod
55 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
56 #: dpkg-query.pod dpkg-realpath.pod dpkg-scanpackages.pod dpkg-scansources.pod
57 #: dpkg-shlibdeps.pod dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod
58 #: dpkg-trigger.pod dpkg-vendor.pod dpkg.pod dsc.pod dselect.pod
59 #: start-stop-daemon.pod update-alternatives.pod
60 msgid "SYNOPSIS"
61 msgstr ""
63 #. type: textblock
64 #: deb-buildinfo.pod
65 msgid "I<filename>B<.buildinfo>"
66 msgstr ""
68 #. type: =head1
69 #: deb-buildinfo.pod deb-changelog.pod deb-changes.pod deb-conffiles.pod
70 #: deb-control.pod deb-extra-override.pod deb-md5sums.pod deb-old.pod
71 #: deb-origin.pod deb-override.pod deb-postinst.pod deb-postrm.pod
72 #: deb-preinst.pod deb-prerm.pod deb-shlibs.pod deb-split.pod
73 #: deb-src-control.pod deb-src-files.pod deb-src-rules.pod deb-src-symbols.pod
74 #: deb-substvars.pod deb-symbols.pod deb-triggers.pod deb-version.pod deb.pod
75 #: deb822.pod dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
76 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
77 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
78 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-maintscript-helper.pod
79 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
80 #: dpkg-query.pod dpkg-realpath.pod dpkg-scanpackages.pod dpkg-scansources.pod
81 #: dpkg-shlibdeps.pod dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod
82 #: dpkg-trigger.pod dpkg-vendor.pod dpkg.cfg.pod dpkg.pod dsc.pod
83 #: dselect.cfg.pod dselect.pod start-stop-daemon.pod update-alternatives.pod
84 msgid "DESCRIPTION"
85 msgstr ""
87 #. type: textblock
88 #: deb-buildinfo.pod
89 msgid ""
90 "Each Debian source package build can record the build information in a "
91 "B<.buildinfo> control file, which contains a number of fields in "
92 "L<deb822(5)> format."
93 msgstr ""
95 #. type: textblock
96 #: deb-buildinfo.pod
97 msgid ""
98 "Each field begins with a tag, such as B<Source> or B<Binary> (case "
99 "insensitive), followed by a colon, and the body of the field (case sensitive "
100 "unless stated otherwise).  Fields are delimited only by field tags.  In "
101 "other words, field text may be multiple lines in length, but the "
102 "installation tools will generally join lines when processing the body of the "
103 "field (except in case of the multiline fields B<Binary-Only-Changes>, "
104 "B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>, "
105 "B<Checksums-Sha1> and B<Checksums-Sha256>, see below)."
106 msgstr ""
108 #. type: textblock
109 #: deb-buildinfo.pod deb-changes.pod dsc.pod
110 msgid ""
111 "The control data might be enclosed in an OpenPGP ASCII Armored signature, as "
112 "specified in RFC4880."
113 msgstr ""
115 #. type: textblock
116 #: deb-buildinfo.pod
117 msgid ""
118 "The name of the B<.buildinfo> file will depend on the type of build and will "
119 "be as specific as necessary but not more; for a build that includes B<any> "
120 "the name will be "
121 "I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo>, or otherwise "
122 "for a build that includes B<all> the name will be "
123 "I<source-name>B<_>I<binary-version>B<_>B<all.buildinfo>, or otherwise for a "
124 "build that includes B<source> the name will be "
125 "I<source-name>B<_>I<source-version>B<_>B<source.buildinfo>."
126 msgstr ""
128 #. type: =head1
129 #: deb-buildinfo.pod deb-changes.pod deb-control.pod deb-origin.pod dsc.pod
130 msgid "FIELDS"
131 msgstr ""
133 #. type: =item
134 #: deb-buildinfo.pod deb-changes.pod dsc.pod
135 msgid "B<Format:> I<format-version> (required)"
136 msgstr ""
138 #. type: textblock
139 #: deb-buildinfo.pod
140 msgid ""
141 "The value of this field declares the format version of the file.  The syntax "
142 "of the field value is a version number with a major and minor component.  "
143 "Backward incompatible changes to the format will bump the major version, and "
144 "backward compatible changes (such as field additions) will bump the minor "
145 "version.  The current format version is B<1.0>."
146 msgstr ""
148 #. type: =item
149 #: deb-buildinfo.pod deb-changes.pod
150 msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)"
151 msgstr ""
153 #. type: textblock
154 #: deb-buildinfo.pod
155 msgid ""
156 "The name of the source package.  If the source version differs from the "
157 "binary version, then the I<source-name> will be followed by a "
158 "I<source-version> in parenthesis.  This can happen when the build is for a "
159 "binary-only non-maintainer upload."
160 msgstr ""
162 #. type: =item
163 #: deb-buildinfo.pod deb-changes.pod
164 msgid "B<Binary:> I<binary-package-list> (required in context)"
165 msgstr ""
167 #. type: textblock
168 #: deb-buildinfo.pod
169 msgid ""
170 "This folded field is a space-separated list of binary packages built.  If "
171 "the build is source-only, then the field is omitted (since dpkg 1.20.0)."
172 msgstr ""
174 #. type: =item
175 #: deb-buildinfo.pod
176 msgid "B<Architecture:> I<arch-list> (required)"
177 msgstr ""
179 #. type: textblock
180 #: deb-buildinfo.pod
181 msgid ""
182 "This space-separated field lists the architectures of the files currently "
183 "being built.  Common architectures are B<amd64>, B<armel>, B<i386>, etc.  "
184 "Note that the B<all> value is meant for packages that are architecture "
185 "independent.  If the source for the package is also being built, the special "
186 "entry B<source> is also present.  Architecture wildcards must never be "
187 "present in the list."
188 msgstr ""
190 #. type: =item
191 #: deb-buildinfo.pod deb-changes.pod deb-control.pod dsc.pod
192 msgid "B<Version:> I<version-string> (required)"
193 msgstr ""
195 #. type: textblock
196 #: deb-buildinfo.pod deb-changes.pod dsc.pod
197 msgid ""
198 "Typically, this is the original package's version number in whatever form "
199 "the program's author uses.  It may also include a Debian revision number "
200 "(for non-native packages).  The exact format and sorting algorithm are "
201 "described in B<deb-version>(7)."
202 msgstr ""
204 #. type: =item
205 #: deb-buildinfo.pod
206 msgid "B<Binary-Only-Changes:>"
207 msgstr ""
209 #. type: =item
210 #: deb-buildinfo.pod
211 msgid "S< >I<changelog-entry>"
212 msgstr ""
214 #. type: textblock
215 #: deb-buildinfo.pod
216 msgid ""
217 "This multiline field contains the concatenated text of the changelog entry "
218 "for a binary-only non-maintainer upload (binNMU) if that is the case.  To "
219 "make this a valid multiline field empty lines are replaced with a single "
220 "full stop (‘.’) and all lines are indented by one space character.  The "
221 "exact content depends on the changelog format."
222 msgstr ""
224 #. type: =item
225 #: deb-buildinfo.pod
226 msgid "B<Checksums-Md5:> (required)"
227 msgstr ""
229 #. type: =item
230 #: deb-buildinfo.pod deb-changes.pod dsc.pod
231 msgid "B<Checksums-Sha1:> (required)"
232 msgstr ""
234 #. type: =item
235 #: deb-buildinfo.pod deb-changes.pod dsc.pod
236 msgid "B<Checksums-Sha256:> (required)"
237 msgstr ""
239 #. type: =item
240 #: deb-buildinfo.pod deb-changes.pod dsc.pod
241 msgid "S< >I<checksum> I<size> I<filename>"
242 msgstr ""
244 #. type: textblock
245 #: deb-buildinfo.pod
246 msgid ""
247 "These multiline fields contain a list of files with a checksum and size for "
248 "each one.  These fields have the same syntax and differ only in the checksum "
249 "algorithm used: MD5 for B<Checksums-Md5>, SHA-1 for B<Checksums-Sha1> and "
250 "SHA-256 for B<Checksums-Sha256>."
251 msgstr ""
253 #. type: textblock
254 #: deb-buildinfo.pod deb-changes.pod
255 msgid ""
256 "The first line of the field value (the part on the same line as the field "
257 "name followed by a colon) is always empty.  The content of the field is "
258 "expressed as continuation lines, one line per file.  Each line consists of "
259 "space-separated entries describing the file: the checksum, the file size, "
260 "and the file name."
261 msgstr ""
263 #. type: textblock
264 #: deb-buildinfo.pod
265 msgid "These fields list all files that make up the build."
266 msgstr ""
268 #. type: =item
269 #: deb-buildinfo.pod
270 msgid "B<Build-Origin:> I<name>"
271 msgstr ""
273 #. type: textblock
274 #: deb-buildinfo.pod deb-control.pod dsc.pod
275 msgid "The name of the distribution this package is originating from."
276 msgstr ""
278 #. type: =item
279 #: deb-buildinfo.pod
280 msgid "B<Build-Architecture:> I<arch> (required)"
281 msgstr ""
283 #. type: textblock
284 #: deb-buildinfo.pod
285 msgid ""
286 "The Debian architecture for the installation the packages is being built "
287 "in.  Common architectures are B<amd64>, B<armel>, B<i386>, etc."
288 msgstr ""
290 #. type: =item
291 #: deb-buildinfo.pod
292 msgid "B<Build-Date:> I<build-date>"
293 msgstr ""
295 #. type: textblock
296 #: deb-buildinfo.pod
297 msgid ""
298 "The date the package was built.  It must be in the same format as the date "
299 "in a B<deb-changelog>(5)  entry."
300 msgstr ""
302 #. type: =item
303 #: deb-buildinfo.pod
304 msgid "B<Build-Kernel-Version:> I<build-kernel-version>"
305 msgstr ""
307 #. type: textblock
308 #: deb-buildinfo.pod
309 msgid ""
310 "The release and version (in an unspecified format) of the kernel running on "
311 "the build system.  This field is only going to be present if the builder has "
312 "explicitly requested it, to avoid leaking possibly sensitive information."
313 msgstr ""
315 #. type: =item
316 #: deb-buildinfo.pod
317 msgid "B<Build-Path:> I<build-path>"
318 msgstr ""
320 #. type: textblock
321 #: deb-buildinfo.pod
322 msgid ""
323 "The absolute build path, which correspond to the unpacked source tree.  This "
324 "field is only going to be present if the vendor has allowed it via some "
325 "pattern match to avoid leaking possibly sensitive information."
326 msgstr ""
328 #. type: textblock
329 #: deb-buildinfo.pod
330 msgid ""
331 "On Debian and derivatives only build paths starting with I</build/> will "
332 "emit this field."
333 msgstr ""
335 #. type: =item
336 #: deb-buildinfo.pod
337 msgid "B<Build-Tainted-By:>"
338 msgstr ""
340 #. type: =item
341 #: deb-buildinfo.pod
342 msgid "S< >I<taint-reason-list>"
343 msgstr ""
345 #. type: textblock
346 #: deb-buildinfo.pod
347 msgid ""
348 "This folded field contains a space-separated list of non-exhaustive reason "
349 "tags (formed by alphanumeric and dash characters) which identify why the "
350 "current build has been tainted (since dpkg 1.19.5)."
351 msgstr ""
353 #. type: textblock
354 #: deb-buildinfo.pod
355 msgid "On Debian and derivatives the following reason tags can be emitted:"
356 msgstr ""
358 #. type: =item
359 #: deb-buildinfo.pod
360 msgid "B<merged-usr-via-aliased-dirs>"
361 msgstr ""
363 #. type: textblock
364 #: deb-buildinfo.pod
365 msgid ""
366 "The system has a merged I</usr> via aliased directories (previously known as "
367 "B<merged-usr-via-symlinks>).  This will confuse B<dpkg-query>, "
368 "B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> and any other "
369 "tool using pathnames as keys into their databases, as it creates filesystem "
370 "aliasing problems, and messes with the understanding of the filesystem that "
371 "B<dpkg> has recorded in its database.  For build systems that hardcode "
372 "pathnames to specific binaries or libraries on the resulting artifacts, it "
373 "can also produce packages that will be incompatible with non-/usr-merged "
374 "filesystems."
375 msgstr ""
377 #. type: =item
378 #: deb-buildinfo.pod
379 msgid "B<usr-local-has-configs>"
380 msgstr ""
382 #. type: textblock
383 #: deb-buildinfo.pod
384 msgid "The system has configuration files under I</usr/local/etc>."
385 msgstr ""
387 #. type: =item
388 #: deb-buildinfo.pod
389 msgid "B<usr-local-has-includes>"
390 msgstr ""
392 #. type: textblock
393 #: deb-buildinfo.pod
394 msgid "The system has header files under I</usr/local/include>."
395 msgstr ""
397 #. type: =item
398 #: deb-buildinfo.pod
399 msgid "B<usr-local-has-programs>"
400 msgstr ""
402 #. type: textblock
403 #: deb-buildinfo.pod
404 msgid "The system has programs under I</usr/local/bin> or I</usr/local/sbin>."
405 msgstr ""
407 #. type: =item
408 #: deb-buildinfo.pod
409 msgid "B<usr-local-has-libraries>"
410 msgstr ""
412 #. type: textblock
413 #: deb-buildinfo.pod
414 msgid "The system has libraries, either static or shared under I</usr/local/lib>."
415 msgstr ""
417 #. type: =item
418 #: deb-buildinfo.pod
419 msgid "B<can-execute-cross-built-programs>"
420 msgstr ""
422 #. type: textblock
423 #: deb-buildinfo.pod
424 msgid ""
425 "The system can execute cross built programs, either directly or via some "
426 "emulation layer."
427 msgstr ""
429 #. type: textblock
430 #: deb-buildinfo.pod
431 msgid "Since dpkg 1.21.10."
432 msgstr ""
434 #. type: =item
435 #: deb-buildinfo.pod
436 msgid "B<Installed-Build-Depends:> (required)"
437 msgstr ""
439 #. type: =item
440 #: deb-buildinfo.pod
441 msgid "S< >I<package-list>"
442 msgstr ""
444 #. type: textblock
445 #: deb-buildinfo.pod
446 msgid ""
447 "The list of installed and configured packages that might affect the package "
448 "build process."
449 msgstr ""
451 #. type: textblock
452 #: deb-buildinfo.pod
453 msgid ""
454 "The list consists of each package name, optionally arch-qualified for "
455 "foreign architectures, with an exact version restriction, separated by "
456 "commas."
457 msgstr ""
459 #. type: textblock
460 #: deb-buildinfo.pod
461 msgid ""
462 "The list includes all essential packages, packages listed in "
463 "B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> source "
464 "control fields, any vendor specific builtin dependencies, and all their "
465 "recursive dependencies.  On Debian and derivatives the dependency builtin is "
466 "B<build-essential>."
467 msgstr ""
469 #. type: textblock
470 #: deb-buildinfo.pod
471 msgid ""
472 "For dependencies coming from the source control fields, all dependency "
473 "alternatives and all providers of virtual packages depended on will be "
474 "included."
475 msgstr ""
477 #. type: =item
478 #: deb-buildinfo.pod
479 msgid "B<Environment:>"
480 msgstr ""
482 #. type: =item
483 #: deb-buildinfo.pod
484 msgid "S< >I<variable-list>"
485 msgstr ""
487 #. type: textblock
488 #: deb-buildinfo.pod
489 msgid ""
490 "The list of environment variables that are known to affect the package build "
491 "process, with each environment variable followed by an equal sign (‘=’)  and "
492 "the variable's quoted value, using double quotes (‘\"’), and backslashes "
493 "escaped (‘\\\\’)."
494 msgstr ""
496 #. type: =head1
497 #: deb-buildinfo.pod deb-changelog.pod deb-changes.pod deb-conffiles.pod
498 #: deb-control.pod deb-extra-override.pod deb-md5sums.pod deb-old.pod
499 #: deb-origin.pod deb-override.pod deb-postinst.pod deb-postrm.pod
500 #: deb-preinst.pod deb-prerm.pod deb-shlibs.pod deb-split.pod
501 #: deb-src-control.pod deb-src-files.pod deb-src-rules.pod deb-src-symbols.pod
502 #: deb-substvars.pod deb-symbols.pod deb-triggers.pod deb-version.pod deb.pod
503 #: deb822.pod dpkg-architecture.pod dpkg-buildpackage.pod dpkg-deb.pod
504 #: dpkg-distaddfile.pod dpkg-divert.pod dpkg-fsys-usrunmess.pod
505 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
506 #: dpkg-gensymbols.pod dpkg-maintscript-helper.pod dpkg-name.pod
507 #: dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
508 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
509 #: dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
510 #: dpkg-vendor.pod dpkg.cfg.pod dpkg.pod dsc.pod dselect.cfg.pod dselect.pod
511 #: update-alternatives.pod
512 msgid "SEE ALSO"
513 msgstr ""
515 #. type: textblock
516 #: deb-buildinfo.pod
517 msgid "L<deb822(5)>, B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1)."
518 msgstr ""
520 #. type: textblock
521 #: deb-changelog.pod
522 msgid "deb-changelog - dpkg source packages' changelog file format"
523 msgstr ""
525 #. type: =item
526 #: deb-changelog.pod dpkg-parsechangelog.pod
527 msgid "B<debian/changelog>"
528 msgstr ""
530 #. type: textblock
531 #: deb-changelog.pod
532 msgid ""
533 "Changes in the packaged version of a project are explained in the changelog "
534 "file I<debian/changelog>.  This includes modifications made in the source "
535 "package compared to the upstream one as well as other changes and updates to "
536 "the package."
537 msgstr ""
539 #. type: textblock
540 #: deb-changelog.pod
541 msgid ""
542 "The format of the I<debian/changelog> allows the package building tools to "
543 "discover which version of the package is being built and find out other "
544 "release-specific information."
545 msgstr ""
547 #. type: textblock
548 #: deb-changelog.pod
549 msgid "That format is a series of entries like this:"
550 msgstr ""
552 #. type: verbatim
553 #: deb-changelog.pod
554 #, no-wrap
555 msgid ""
556 "Z<>\n"
557 " I<package> (I<version>) I<distributions>; I<metadata>\n"
558 "          [optional blank line(s), stripped]\n"
559 "  * I<change-details>\n"
560 "    I<more-change-details>\n"
561 "          [blank line(s), included in B<dpkg-parsechangelog>(1) output]\n"
562 "  * I<even-more-change-details>\n"
563 "          [optional blank line(s), stripped]\n"
564 "  -- I<maintainer-name> <I<email-address>>  I<date>\n"
565 "\n"
566 msgstr ""
568 #. type: textblock
569 #: deb-changelog.pod
570 msgid ""
571 "I<package> and I<version> are the source package name and version number.  "
572 "I<version> is delimited by parenthesis U+00028 ‘B<(>’ and U+0029 ‘B<)>’."
573 msgstr ""
575 #. type: textblock
576 #: deb-changelog.pod
577 msgid ""
578 "I<distributions> lists one or more space-separated distributions where this "
579 "version should be installed when it is uploaded; it is copied to the "
580 "B<Distribution> field in the I<.changes> file.  I<distributions> must be "
581 "terminated by a semicolon (U+003B ‘B<;>’)."
582 msgstr ""
584 #. type: textblock
585 #: deb-changelog.pod
586 msgid ""
587 "I<metadata> lists zero or more comma-separated I<keyword>=I<value> items.  "
588 "Each keyword can contain only minus and case insensitive alphanumeric "
589 "characters, as they need to be mapped to B<deb822>(5) field names.  The only "
590 "I<keyword>s currently supported by B<dpkg> are B<urgency> and "
591 "B<binary-only>.  B<urgency>'s value is used for the B<Urgency> field in the "
592 "I<.changes> file for the upload.  B<binary-only> with a B<yes> value, is "
593 "used to denote that this changelog entry is for a binary-only non-maintainer "
594 "upload (an automatic binary rebuild with the only change being the changelog "
595 "entry)."
596 msgstr ""
598 #. type: textblock
599 #: deb-changelog.pod
600 msgid ""
601 "The change details may in fact be any series of lines starting with at least "
602 "two spaces (U+0020 B<SPACE>), but conventionally each change starts with an "
603 "asterisk and a separating space and continuation lines are indented so as to "
604 "bring them in line with the start of the text above.  Blank lines may be "
605 "used here to separate groups of changes, if desired."
606 msgstr ""
608 #. type: textblock
609 #: deb-changelog.pod
610 msgid ""
611 "If this upload resolves bugs recorded in the distribution bug tracking "
612 "system, they may be automatically closed on the inclusion of this package "
613 "into the distribution archive by including the string:"
614 msgstr ""
616 #. type: textblock
617 #: deb-changelog.pod
618 msgid "B<Closes: #>I<nnnnn>"
619 msgstr ""
621 #. type: textblock
622 #: deb-changelog.pod
623 msgid ""
624 "in the change details, where B<#>I<nnnnn> is the bug number.  The exact Perl "
625 "regular expression is:"
626 msgstr ""
628 #. type: textblock
629 #: deb-changelog.pod
630 msgid "B</closes:\\s*(?:bug)?\\#?\\s?\\d+(?:,\\s*(?:bug)?\\#?\\s?\\d+)*/i>"
631 msgstr ""
633 #. type: textblock
634 #: deb-changelog.pod
635 msgid ""
636 "That is, the string should consist of the word B<closes:> followed by a "
637 "comma-separated list of bug numbers.  Bug numbers may be preceded by the "
638 "word B<bug> and/or a B<#> sign, as in C<Closes: 42, bug#43, #44, bug 45>.  "
639 "The words B<closes:> and B<bug> are not case sensitive.  The list of bug "
640 "numbers may span multiple lines."
641 msgstr ""
643 #. type: textblock
644 #: deb-changelog.pod
645 msgid ""
646 "This information is conveyed via the B<Closes> field in the I<.changes> "
647 "file.  Where, depending on the archive maintenance software, all the bug "
648 "numbers listed might get automatically closed."
649 msgstr ""
651 #. type: textblock
652 #: deb-changelog.pod
653 msgid ""
654 "The maintainer name and email address used in the changelog should be the "
655 "details of the person who prepared this release of the package.  They are "
656 "B<not> necessarily those of the uploader or usual package maintainer.  The "
657 "information here will be copied to the B<Changed-By> field in the "
658 "I<.changes> file, and then later might be used to send an acknowledgment "
659 "when the upload has been installed in the distribution archive."
660 msgstr ""
662 #. type: textblock
663 #: deb-changelog.pod
664 msgid ""
665 "The I<date> has the following format (compatible and with the same semantics "
666 "of RFC2822 and RFC5322, or what «date -R» generates):"
667 msgstr ""
669 #. type: textblock
670 #: deb-changelog.pod
671 msgid ""
672 "I<day-of-week>B<,> I<dd> I<month> I<yyyy> I<hh>B<:>I<mm>B<:>I<ss> "
673 "B<+>I<zzzz>"
674 msgstr ""
676 #. type: textblock
677 #: deb-changelog.pod
678 msgid "where:"
679 msgstr ""
681 #. type: =item
682 #: deb-changelog.pod
683 msgid "I<day-of-week>"
684 msgstr ""
686 #. type: textblock
687 #: deb-changelog.pod
688 msgid "Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>."
689 msgstr ""
691 #. type: =item
692 #: deb-changelog.pod
693 msgid "I<dd>"
694 msgstr ""
696 #. type: textblock
697 #: deb-changelog.pod
698 msgid ""
699 "Is a one- or two-digit day of the month (B<01>-B<31>), where the leading "
700 "zero is optional, but conventionally does not get omitted."
701 msgstr ""
703 #. type: =item
704 #: deb-changelog.pod
705 msgid "I<month>"
706 msgstr ""
708 #. type: textblock
709 #: deb-changelog.pod
710 msgid ""
711 "Is one of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, "
712 "B<Sep>, B<Oct>, B<Nov>, B<Dec>."
713 msgstr ""
715 #. type: =item
716 #: deb-changelog.pod
717 msgid "I<yyyy>"
718 msgstr ""
720 #. type: textblock
721 #: deb-changelog.pod
722 msgid "Is the four-digit year (e.g. 2010)."
723 msgstr ""
725 #. type: =item
726 #: deb-changelog.pod
727 msgid "I<hh>"
728 msgstr ""
730 #. type: textblock
731 #: deb-changelog.pod
732 msgid "Is the two-digit hour (B<00>-B<23>)."
733 msgstr ""
735 #. type: =item
736 #: deb-changelog.pod
737 msgid "I<mm>"
738 msgstr ""
740 #. type: textblock
741 #: deb-changelog.pod
742 msgid "Is the two-digit minutes (B<00>-B<59>)."
743 msgstr ""
745 #. type: =item
746 #: deb-changelog.pod
747 msgid "I<ss>"
748 msgstr ""
750 #. type: textblock
751 #: deb-changelog.pod
752 msgid "Is the two-digit seconds (B<00>-B<60>)."
753 msgstr ""
755 #. type: =item
756 #: deb-changelog.pod
757 msgid "[B<+->]I<zzzz>"
758 msgstr ""
760 #. type: textblock
761 #: deb-changelog.pod
762 msgid ""
763 "Is the time zone offset from Coordinated Universal Time (UTC).  ‘B<+>’ "
764 "indicates that the time is ahead of (i.e., east of) UTC and ‘B<->’ indicates "
765 "that the time is behind (i.e., west of) UTC.  The first two digits indicate "
766 "the hour difference from UTC and the last two digits indicate the number of "
767 "additional minutes difference from UTC.  The last two digits must be in the "
768 "range B<00>-B<59>."
769 msgstr ""
771 #. type: textblock
772 #: deb-changelog.pod
773 msgid ""
774 "The first “title” line with the package name must start at the left hand "
775 "margin.  The “trailer” line with the maintainer and date details must be "
776 "preceded by exactly one space (U+0020 B<SPACE>).  The maintainer details and "
777 "the date must be separated by exactly two spaces (U+0020 B<SPACE>).  Each "
778 "part of the I<date> can be separated by one or more spaces (U+0020 "
779 "B<SPACE>), except after the comma where it can be separated by zero or more "
780 "spaces (U+0020 B<SPACE>)."
781 msgstr ""
783 #. type: textblock
784 #: deb-changelog.pod
785 msgid ""
786 "Any line that consists entirely (i.e., no leading whitespace) of B<#> or "
787 "B</* */> style comments or RCS keywords."
788 msgstr ""
790 #. type: textblock
791 #: deb-changelog.pod
792 msgid ""
793 "Vim modelines or Emacs local variables, and ancient changelog entries with "
794 "other formats at the end of the file should be accepted and preserved on "
795 "output, but their contents might be otherwise ignored and parsing stopped at "
796 "that point."
797 msgstr ""
799 #. type: textblock
800 #: deb-changelog.pod
801 msgid "The entire changelog must be encoded in UTF-8."
802 msgstr ""
804 #. type: =head1
805 #: deb-changelog.pod deb-substvars.pod dpkg-architecture.pod
806 #: dpkg-buildflags.pod dpkg-buildpackage.pod dpkg-distaddfile.pod
807 #: dpkg-divert.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
808 #: dpkg-gencontrol.pod dpkg-parsechangelog.pod dpkg-source.pod dpkg-split.pod
809 #: dpkg-statoverride.pod dpkg.cfg.pod dpkg.pod dselect.cfg.pod
810 #: update-alternatives.pod
811 msgid "FILES"
812 msgstr ""
814 #. type: =item
815 #: deb-changelog.pod
816 msgid "I<debian/changelog>"
817 msgstr ""
819 #. type: =head1
820 #: deb-changelog.pod deb-shlibs.pod deb-symbols.pod dpkg-architecture.pod
821 #: dpkg-buildflags.pod dpkg-divert.pod dpkg-name.pod dpkg.pod
822 #: update-alternatives.pod
823 msgid "EXAMPLES"
824 msgstr ""
826 #. type: verbatim
827 #: deb-changelog.pod
828 #, no-wrap
829 msgid ""
830 " dpkg (1.17.18) unstable; urgency=low\n"
831 "\n"
832 msgstr ""
834 #. type: verbatim
835 #: deb-changelog.pod
836 #, no-wrap
837 msgid ""
838 "  [ Guillem Jover ]\n"
839 "  * Handle empty minimum versions when initializing dependency versions,\n"
840 "    as the code is mapping the minimum version 0 to '' to avoid outputting\n"
841 "    useless versions. Regression introduced in dpkg 1.17.17. Closes: "
842 "#764929\n"
843 "\n"
844 msgstr ""
846 #. type: verbatim
847 #: deb-changelog.pod
848 #, no-wrap
849 msgid ""
850 "  [ Updated programs translations ]\n"
851 "  * Catalan (Guillem Jover).\n"
852 "\n"
853 msgstr ""
855 #. type: verbatim
856 #: deb-changelog.pod
857 #, no-wrap
858 msgid ""
859 "  [ Updated dselect translations ]\n"
860 "  * Catalan (Guillem Jover).\n"
861 "  * German (Sven Joachim).\n"
862 "\n"
863 msgstr ""
865 #. type: verbatim
866 #: deb-changelog.pod
867 #, no-wrap
868 msgid ""
869 "  -- Guillem Jover <guillem@debian.org>  Sun, 12 Oct 2014 15:47:44 +0200\n"
870 "\n"
871 msgstr ""
873 #. type: textblock
874 #: deb-changelog.pod
875 msgid ""
876 "B<deb822>(5), B<deb-version>(7), B<deb-changes>(5), "
877 "B<dpkg-parsechangelog>(1)."
878 msgstr ""
880 #. type: textblock
881 #: deb-changes.pod
882 msgid "deb-changes - Debian changes file format"
883 msgstr ""
885 #. type: textblock
886 #: deb-changes.pod
887 msgid "I<filename>B<.changes>"
888 msgstr ""
890 #. type: textblock
891 #: deb-changes.pod
892 msgid ""
893 "Each Debian upload is composed of a .changes control file, which contains a "
894 "number of fields in L<deb822(5)> format."
895 msgstr ""
897 #. type: textblock
898 #: deb-changes.pod
899 msgid ""
900 "Each field begins with a tag, such as B<Source> or B<Binary> (case "
901 "insensitive), followed by a colon, and the body of the field (case sensitive "
902 "unless stated otherwise).  Fields are delimited only by field tags.  In "
903 "other words, field text may be multiple lines in length, but the "
904 "installation tools will generally join lines when processing the body of the "
905 "field (except in case of the multiline fields B<Description>, B<Changes>, "
906 "B<Files>, B<Checksums-Sha1> and B<Checksums-Sha256>, see below)."
907 msgstr ""
909 #. type: textblock
910 #: deb-changes.pod
911 msgid ""
912 "The value of this field declares the format version of the file.  The syntax "
913 "of the field value is a version number with a major and minor component.  "
914 "Backward incompatible changes to the format will bump the major version, and "
915 "backward compatible changes (such as field additions) will bump the minor "
916 "version.  The current format version is B<1.8>."
917 msgstr ""
919 #. type: =item
920 #: deb-changes.pod
921 msgid "B<Date:> I<release-date> (required)"
922 msgstr ""
924 #. type: textblock
925 #: deb-changes.pod
926 msgid ""
927 "The date the package was built or last edited.  It must be in the same "
928 "format as the date in a B<deb-changelog>(5)  entry."
929 msgstr ""
931 #. type: textblock
932 #: deb-changes.pod
933 msgid ""
934 "The value of this field is usually extracted from the I<debian/changelog> "
935 "file."
936 msgstr ""
938 #. type: textblock
939 #: deb-changes.pod
940 msgid ""
941 "The name of the source package.  If the source version differs from the "
942 "binary version, then the I<source-name> will be followed by a "
943 "I<source-version> in parenthesis.  This can happen when the upload is a "
944 "binary-only non-maintainer upload."
945 msgstr ""
947 #. type: textblock
948 #: deb-changes.pod
949 msgid ""
950 "This folded field is a space-separated list of binary packages to upload.  "
951 "If the upload is source-only, then the field is omitted (since dpkg 1.19.3)."
952 msgstr ""
954 #. type: =item
955 #: deb-changes.pod
956 msgid "B<Architecture:> I<arch-list>"
957 msgstr ""
959 #. type: textblock
960 #: deb-changes.pod
961 msgid ""
962 "Lists the architectures of the files currently being uploaded.  Common "
963 "architectures are B<amd64>, B<armel>, B<i386>, etc.  Note that the B<all> "
964 "value is meant for packages that are architecture independent.  If the "
965 "source for the package is also being uploaded, the special entry B<source> "
966 "is also present.  Architecture wildcards must never be present in the list."
967 msgstr ""
969 #. type: =item
970 #: deb-changes.pod
971 msgid "B<Distribution:> I<distribution>s (required)"
972 msgstr ""
974 #. type: textblock
975 #: deb-changes.pod
976 msgid ""
977 "Lists one or more space-separated distributions where this version should be "
978 "installed when it is uploaded to the archive."
979 msgstr ""
981 #. type: =item
982 #: deb-changes.pod
983 msgid "B<Urgency:> I<urgency> (recommended)"
984 msgstr ""
986 #. type: textblock
987 #: deb-changes.pod
988 msgid ""
989 "The urgency of the upload.  The currently known values, in increasing order "
990 "of urgency, are: B<low>, B<medium>, B<high>, B<critical> and B<emergency>."
991 msgstr ""
993 #. type: =item
994 #: deb-changes.pod
995 msgid "B<Maintainer:> I<fullname-email> (required)"
996 msgstr ""
998 #. type: textblock
999 #: deb-changes.pod
1000 msgid ""
1001 "Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
1002 "typically the person who created the package, as opposed to the author of "
1003 "the software that was packaged."
1004 msgstr ""
1006 #. type: =item
1007 #: deb-changes.pod
1008 msgid "B<Changed-By:> I<fullname-email>"
1009 msgstr ""
1011 #. type: textblock
1012 #: deb-changes.pod
1013 msgid ""
1014 "Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is "
1015 "typically the person who prepared the package changes for this release."
1016 msgstr ""
1018 #. type: =item
1019 #: deb-changes.pod
1020 msgid "B<Description:> (recommended)"
1021 msgstr ""
1023 #. type: =item
1024 #: deb-changes.pod
1025 msgid "S< >I<binary-package-name> B<-> I<binary-package-summary>"
1026 msgstr ""
1028 #. type: textblock
1029 #: deb-changes.pod
1030 msgid ""
1031 "This multiline field contains a list of binary package names followed by a "
1032 "space, a dash (‘B<->’) and their possibly truncated short descriptions.  If "
1033 "the upload is source-only, then the field is omitted (since dpkg 1.19.3)."
1034 msgstr ""
1036 #. type: =item
1037 #: deb-changes.pod
1038 msgid "B<Closes:> I<bug-number-list>"
1039 msgstr ""
1041 #. type: textblock
1042 #: deb-changes.pod
1043 msgid ""
1044 "A space-separated list of bug report numbers for bug reports that have been "
1045 "resolved with this upload.  The distribution archive software might use this "
1046 "field to automatically close the referred bug numbers in the distribution "
1047 "bug tracking system."
1048 msgstr ""
1050 #. type: =item
1051 #: deb-changes.pod
1052 msgid "B<Binary-Only: yes>"
1053 msgstr ""
1055 #. type: textblock
1056 #: deb-changes.pod
1057 msgid ""
1058 "This field denotes that the upload is a binary-only non-maintainer build.  "
1059 "It originates from the B<binary-only=yes> key/value from the changelog "
1060 "metadata entry."
1061 msgstr ""
1063 #. type: =item
1064 #: deb-changes.pod
1065 msgid "B<Built-For-Profiles:> I<profile-list>"
1066 msgstr ""
1068 #. type: textblock
1069 #: deb-changes.pod
1070 msgid ""
1071 "This field specifies a whitespace separated list of build profiles that this "
1072 "upload was built with."
1073 msgstr ""
1075 #. type: =item
1076 #: deb-changes.pod
1077 msgid "B<Changes:> (required)"
1078 msgstr ""
1080 #. type: =item
1081 #: deb-changes.pod
1082 msgid "S< >I<changelog-entries>"
1083 msgstr ""
1085 #. type: textblock
1086 #: deb-changes.pod
1087 msgid ""
1088 "This multiline field contains the concatenated text of all changelog entries "
1089 "that are part of the upload.  To make this a valid multiline field empty "
1090 "lines are replaced with a single full stop (‘.’) and all lines are indented "
1091 "by one space character.  The exact content depends on the changelog format."
1092 msgstr ""
1094 #. type: =item
1095 #: deb-changes.pod dsc.pod
1096 msgid "B<Files:> (required)"
1097 msgstr ""
1099 #. type: =item
1100 #: deb-changes.pod
1101 msgid "S< >I<md5sum> I<size> I<section> I<priority> I<filename>"
1102 msgstr ""
1104 #. type: textblock
1105 #: deb-changes.pod
1106 msgid ""
1107 "This multiline field contains a list of files with an md5sum, size, section "
1108 "and priority for each one."
1109 msgstr ""
1111 #. type: textblock
1112 #: deb-changes.pod
1113 msgid ""
1114 "The first line of the field value (the part on the same line as the field "
1115 "name followed by a colon) is always empty.  The content of the field is "
1116 "expressed as continuation lines, one line per file.  Each line consists of "
1117 "space-separated entries describing the file: the md5sum, the file size, the "
1118 "file section, the file priority, and the file name."
1119 msgstr ""
1121 #. type: textblock
1122 #: deb-changes.pod
1123 msgid ""
1124 "This field lists all files that make up the upload.  The list of files in "
1125 "this field must match the list of files in the other related B<Checksums> "
1126 "fields."
1127 msgstr ""
1129 #. type: textblock
1130 #: deb-changes.pod
1131 msgid ""
1132 "These multiline fields contain a list of files with a checksum and size for "
1133 "each one.  These fields have the same syntax and differ only in the checksum "
1134 "algorithm used: SHA-1 for B<Checksums-Sha1> and SHA-256 for "
1135 "B<Checksums-Sha256>."
1136 msgstr ""
1138 #. type: textblock
1139 #: deb-changes.pod
1140 msgid ""
1141 "These fields list all files that make up the upload.  The list of files in "
1142 "these fields must match the list of files in the B<Files> field and the "
1143 "other related B<Checksums> fields."
1144 msgstr ""
1146 #. type: =head1
1147 #: deb-changes.pod deb-control.pod dpkg-buildpackage.pod dpkg-deb.pod
1148 #: dpkg-name.pod dpkg-source.pod dpkg-split.pod dpkg.pod dsc.pod dselect.pod
1149 msgid "BUGS"
1150 msgstr ""
1152 #. type: textblock
1153 #: deb-changes.pod
1154 msgid ""
1155 "The B<Files> field is inconsistent with the other B<Checksums> fields.  The "
1156 "B<Changed-By> and B<Maintainer> fields have confusing names.  The "
1157 "B<Distribution> field contains information about what is commonly referred "
1158 "to as a suite."
1159 msgstr ""
1161 #. type: textblock
1162 #: deb-changes.pod
1163 msgid "L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7)."
1164 msgstr ""
1166 #. type: textblock
1167 #: deb-conffiles.pod
1168 msgid "deb-conffiles - package conffiles"
1169 msgstr ""
1171 #. type: textblock
1172 #: deb-conffiles.pod
1173 msgid "B<DEBIAN/conffiles>"
1174 msgstr ""
1176 #. type: textblock
1177 #: deb-conffiles.pod
1178 msgid ""
1179 "A package declares its list of conffiles by including a I<conffiles> file in "
1180 "its control archive (i.e. I<DEBIAN/conffiles> during package creation)."
1181 msgstr ""
1183 #. type: textblock
1184 #: deb-conffiles.pod
1185 msgid ""
1186 "This file contains a list of files, one per line, with an optional leading "
1187 "flag separated by whitespace.  The conffiles must be listed as absolute "
1188 "pathnames.  Trailing whitespace will be trimmed, but empty or "
1189 "whitespace-only lines are not accepted."
1190 msgstr ""
1192 #. type: textblock
1193 #: deb-conffiles.pod
1194 msgid ""
1195 "Files without a flag should exist in the binary package, otherwise "
1196 "L<dpkg(1)> will ignore them."
1197 msgstr ""
1199 #. type: textblock
1200 #: deb-conffiles.pod
1201 msgid ""
1202 "There is currently only one flag supported, B<remove-on-upgrade>, to mark "
1203 "that a conffile needs to be removed on the next upgrade (since dpkg "
1204 "1.20.6).  These files must not exist in the binary package, as both "
1205 "L<dpkg(1)> and L<dpkg-deb(1)> will not accept building nor processing such "
1206 "binary packages."
1207 msgstr ""
1209 #. type: =head1
1210 #: deb-conffiles.pod deb-control.pod deb-md5sums.pod deb-origin.pod
1211 #: deb-src-control.pod start-stop-daemon.pod
1212 msgid "EXAMPLE"
1213 msgstr ""
1215 #. type: verbatim
1216 #: deb-conffiles.pod
1217 #, no-wrap
1218 msgid ""
1219 " %CONFDIR%/alternatives/README\n"
1220 " %CONFDIR%/cron.daily/dpkg\n"
1221 " %PKGCONFDIR%/dpkg.cfg\n"
1222 " %CONFDIR%/logrotate.d/dpkg\n"
1223 " remove-on-upgrade /etc/some-old-file.conf\n"
1224 "\n"
1225 msgstr ""
1227 #. type: textblock
1228 #: deb-conffiles.pod
1229 msgid "B<dpkg-deb>(1), B<dpkg>(1)."
1230 msgstr ""
1232 #. type: textblock
1233 #: deb-control.pod
1234 msgid "deb-control - Debian binary packages' master control file format"
1235 msgstr ""
1237 #. type: textblock
1238 #: deb-control.pod
1239 msgid "B<DEBIAN/control>"
1240 msgstr ""
1242 #. type: textblock
1243 #: deb-control.pod
1244 msgid ""
1245 "Each Debian binary package contains a B<control> file in its B<control> "
1246 "member, and its L<deb822(5)> format is a subset of the master "
1247 "B<debian/control> file in Debian source packages, see B<deb-src-control>(5)."
1248 msgstr ""
1250 #. type: textblock
1251 #: deb-control.pod
1252 msgid ""
1253 "This file contains a number of fields.  Each field begins with a tag, such "
1254 "as B<Package> or B<Version> (case insensitive), followed by a colon, and the "
1255 "body of the field (case sensitive unless stated otherwise).  Fields are "
1256 "delimited only by field tags. In other words, field text may be multiple "
1257 "lines in length, but the installation tools will generally join lines when "
1258 "processing the body of the field (except in the case of the B<Description> "
1259 "field, see below)."
1260 msgstr ""
1262 #. type: =item
1263 #: deb-control.pod
1264 msgid "B<Package:> I<package-name> (required)"
1265 msgstr ""
1267 #. type: textblock
1268 #: deb-control.pod dsc.pod
1269 msgid ""
1270 "The value of this field determines the package name, and is used to generate "
1271 "file names by most installation tools."
1272 msgstr ""
1274 #. type: =item
1275 #: deb-control.pod deb-src-control.pod
1276 msgid "B<Package-Type:> B<deb>|B<udeb>|I<type>"
1277 msgstr ""
1279 #. type: textblock
1280 #: deb-control.pod deb-src-control.pod
1281 msgid ""
1282 "This field defines the type of the package.  B<udeb> is for size-constrained "
1283 "packages used by the debian installer.  B<deb> is the default value, it is "
1284 "assumed if the field is absent.  More types might be added in the future."
1285 msgstr ""
1287 #. type: textblock
1288 #: deb-control.pod
1289 msgid ""
1290 "Typically, this is the original package's version number in whatever form "
1291 "the program's author uses. It may also include a Debian revision number (for "
1292 "non-native packages). The exact format and sorting algorithm are described "
1293 "in B<deb-version>(7)."
1294 msgstr ""
1296 #. type: =item
1297 #: deb-control.pod deb-src-control.pod dsc.pod
1298 msgid "B<Maintainer:> I<fullname-email> (recommended)"
1299 msgstr ""
1301 #. type: textblock
1302 #: deb-control.pod dsc.pod
1303 msgid ""
1304 "Should be in the format “Joe Bloggs E<lt>jbloggs@foo.comE<gt>”, and is "
1305 "typically the person who created the package, as opposed to the author of "
1306 "the software that was packaged."
1307 msgstr ""
1309 #. type: =item
1310 #: deb-control.pod deb-src-control.pod
1311 msgid "B<Description:> I<short-description> (recommended)"
1312 msgstr ""
1314 #. type: =item
1315 #: deb-control.pod deb-src-control.pod dsc.pod
1316 msgid "S< >I<long-description>"
1317 msgstr ""
1319 #. type: textblock
1320 #: deb-control.pod
1321 msgid ""
1322 "The format for the package description is a short brief summary on the first "
1323 "line (after the B<Description> field). The following lines should be used as "
1324 "a longer, more detailed description. Each line of the long description must "
1325 "be preceded by a space, and blank lines in the long description must contain "
1326 "a single ‘B<.>’ following the preceding space."
1327 msgstr ""
1329 #. type: =item
1330 #: deb-control.pod deb-src-control.pod
1331 msgid "B<Section:> I<section>"
1332 msgstr ""
1334 #. type: textblock
1335 #: deb-control.pod deb-src-control.pod
1336 msgid ""
1337 "This is a general field that gives the package a category based on the "
1338 "software that it installs.  Some common sections are B<utils>, B<net>, "
1339 "B<mail>, B<text>, B<x11>, etc."
1340 msgstr ""
1342 #. type: =item
1343 #: deb-control.pod deb-src-control.pod
1344 msgid "B<Priority:> I<priority>"
1345 msgstr ""
1347 #. type: textblock
1348 #: deb-control.pod deb-src-control.pod
1349 msgid ""
1350 "Sets the importance of this package in relation to the system as a whole.  "
1351 "Common priorities are B<required>, B<standard>, B<optional>, B<extra>, etc."
1352 msgstr ""
1354 #. type: textblock
1355 #: deb-control.pod deb-src-control.pod
1356 msgid ""
1357 "The B<Section> and B<Priority> fields usually have a defined set of accepted "
1358 "values based on the specific distribution policy."
1359 msgstr ""
1361 #. type: =item
1362 #: deb-control.pod
1363 msgid "B<Installed-Size:> I<size>"
1364 msgstr ""
1366 #. type: textblock
1367 #: deb-control.pod
1368 msgid ""
1369 "The approximate total size of the package's installed files, in KiB units.  "
1370 "The algorithm to compute the size is described in L<deb-substvars(5)>."
1371 msgstr ""
1373 #. type: =item
1374 #: deb-control.pod deb-src-control.pod
1375 msgid "B<Protected:> B<yes>|B<no>"
1376 msgstr ""
1378 #. type: textblock
1379 #: deb-control.pod
1380 msgid ""
1381 "This field is usually only needed when the answer is B<yes>.  It denotes a "
1382 "package that is required mostly for proper booting of the system or used for "
1383 "custom system-local meta-packages.  L<dpkg(1)> or any other installation "
1384 "tool will not allow a B<Protected> package to be removed (at least not "
1385 "without using one of the force options)."
1386 msgstr ""
1388 #. type: textblock
1389 #: deb-control.pod dsc.pod
1390 msgid "Supported since dpkg 1.20.1."
1391 msgstr ""
1393 #. type: =item
1394 #: deb-control.pod deb-src-control.pod
1395 msgid "B<Essential:> B<yes>|B<no>"
1396 msgstr ""
1398 #. type: textblock
1399 #: deb-control.pod
1400 msgid ""
1401 "This field is usually only needed when the answer is B<yes>.  It denotes a "
1402 "package that is required for the packaging system, for proper operation of "
1403 "the system in general or during boot (although the latter should be "
1404 "converted to B<Protected> field instead).  L<dpkg(1)> or any other "
1405 "installation tool will not allow an B<Essential> package to be removed (at "
1406 "least not without using one of the force options)."
1407 msgstr ""
1409 #. type: =item
1410 #: deb-control.pod deb-src-control.pod
1411 msgid "B<Build-Essential:> B<yes>|B<no>"
1412 msgstr ""
1414 #. type: textblock
1415 #: deb-control.pod
1416 msgid ""
1417 "This field is usually only needed when the answer is B<yes>, and is commonly "
1418 "injected by the archive software.  It denotes a package that is required "
1419 "when building other packages."
1420 msgstr ""
1422 #. type: =item
1423 #: deb-control.pod
1424 msgid "B<Architecture:> I<arch>|B<all> (required)"
1425 msgstr ""
1427 #. type: textblock
1428 #: deb-control.pod
1429 msgid ""
1430 "The architecture specifies which type of hardware this package was compiled "
1431 "for.  Common architectures are B<amd64>, B<armel>, B<i386>, B<powerpc>, "
1432 "etc.  Note that the B<all> value is meant for packages that are architecture "
1433 "independent.  Some examples of this are shell and Perl scripts, and "
1434 "documentation."
1435 msgstr ""
1437 #. type: =item
1438 #: deb-control.pod deb-src-control.pod dsc.pod
1439 msgid "B<Origin:> I<name>"
1440 msgstr ""
1442 #. type: =item
1443 #: deb-control.pod deb-src-control.pod
1444 msgid "B<Bugs:> I<url>"
1445 msgstr ""
1447 #. type: textblock
1448 #: deb-control.pod
1449 msgid ""
1450 "The I<url> of the bug tracking system for this package. The current used "
1451 "format is I<bts-type>B<://>I<bts-address>, like "
1452 "B<debbugs://bugs.debian.org>."
1453 msgstr ""
1455 #. type: =item
1456 #: deb-control.pod deb-src-control.pod dsc.pod
1457 msgid "B<Homepage:> I<url>"
1458 msgstr ""
1460 #. type: textblock
1461 #: deb-control.pod dsc.pod
1462 msgid "The upstream project home page I<url>."
1463 msgstr ""
1465 #. type: =item
1466 #: deb-control.pod deb-src-control.pod
1467 msgid "B<Tag:> I<tag-list>"
1468 msgstr ""
1470 #. type: textblock
1471 #: deb-control.pod
1472 msgid ""
1473 "List of tags describing the qualities of the package. The description and "
1474 "list of supported tags can be found in the B<debtags> package."
1475 msgstr ""
1477 #. type: =item
1478 #: deb-control.pod
1479 msgid "B<Multi-Arch:> B<no>|B<same>|B<foreign>|B<allowed>"
1480 msgstr ""
1482 #. type: textblock
1483 #: deb-control.pod
1484 msgid ""
1485 "This field is used to indicate how this package should behave on a "
1486 "multi-arch installations."
1487 msgstr ""
1489 #. type: =item
1490 #: deb-control.pod deb-src-control.pod
1491 msgid "B<no>"
1492 msgstr ""
1494 #. type: textblock
1495 #: deb-control.pod
1496 msgid ""
1497 "This value is the default when the field is omitted, in which case adding "
1498 "the field with an explicit B<no> value is generally not needed."
1499 msgstr ""
1501 #. type: =item
1502 #: deb-control.pod
1503 msgid "B<same>"
1504 msgstr ""
1506 #. type: textblock
1507 #: deb-control.pod
1508 msgid ""
1509 "This package is co-installable with itself, but it must not be used to "
1510 "satisfy the dependency of any package of a different architecture from "
1511 "itself."
1512 msgstr ""
1514 #. type: =item
1515 #: deb-control.pod
1516 msgid "B<foreign>"
1517 msgstr ""
1519 #. type: textblock
1520 #: deb-control.pod
1521 msgid ""
1522 "This package is not co-installable with itself, but should be allowed to "
1523 "satisfy a non-arch-qualified dependency of a package of a different arch "
1524 "from itself (if a dependency has an explicit arch-qualifier then the value "
1525 "B<foreign> is ignored)."
1526 msgstr ""
1528 #. type: =item
1529 #: deb-control.pod
1530 msgid "B<allowed>"
1531 msgstr ""
1533 #. type: textblock
1534 #: deb-control.pod
1535 msgid ""
1536 "This allows reverse-dependencies to indicate in their B<Depends> field that "
1537 "they accept this package from a foreign architecture by qualifying the "
1538 "package name with B<:any>, but has no effect otherwise."
1539 msgstr ""
1541 #. type: =item
1542 #: deb-control.pod
1543 msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>]"
1544 msgstr ""
1546 #. type: textblock
1547 #: deb-control.pod
1548 msgid ""
1549 "The name of the source package that this binary package came from, if it is "
1550 "different than the name of the package itself.  If the source version "
1551 "differs from the binary version, then the I<source-name> will be followed by "
1552 "a I<source-version> in parenthesis.  This can happen for example on a "
1553 "binary-only non-maintainer upload, or when setting a different binary "
1554 "version via «B<dpkg-gencontrol -v>»."
1555 msgstr ""
1557 #. type: =item
1558 #: deb-control.pod deb-src-control.pod
1559 msgid "B<Subarchitecture:> I<value>"
1560 msgstr ""
1562 #. type: =item
1563 #: deb-control.pod deb-src-control.pod
1564 msgid "B<Kernel-Version:> I<value>"
1565 msgstr ""
1567 #. type: =item
1568 #: deb-control.pod deb-src-control.pod
1569 msgid "B<Installer-Menu-Item:> I<value>"
1570 msgstr ""
1572 #. type: textblock
1573 #: deb-control.pod
1574 msgid ""
1575 "These fields are used by the debian-installer and are usually not needed.  "
1576 "For more details about them, see "
1577 "L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>."
1578 msgstr ""
1580 #. type: =item
1581 #: deb-control.pod deb-src-control.pod
1582 msgid "B<Depends:> I<package-list>"
1583 msgstr ""
1585 #. type: textblock
1586 #: deb-control.pod
1587 msgid ""
1588 "List of packages that are required for this package to provide a non-trivial "
1589 "amount of functionality. The package maintenance software will not allow a "
1590 "package to be installed if the packages listed in its B<Depends> field "
1591 "aren't installed (at least not without using the force options).  In an "
1592 "installation, the postinst scripts of packages listed in B<Depends> fields "
1593 "are run before those of the packages which depend on them. On the opposite, "
1594 "in a removal, the prerm script of a package is run before those of the "
1595 "packages listed in its B<Depends> field."
1596 msgstr ""
1598 #. type: =item
1599 #: deb-control.pod deb-src-control.pod
1600 msgid "B<Pre-Depends:> I<package-list>"
1601 msgstr ""
1603 #. type: textblock
1604 #: deb-control.pod
1605 msgid ""
1606 "List of packages that must be installed B<and> configured before this one "
1607 "can be installed. This is usually used in the case where this package "
1608 "requires another package for running its preinst script."
1609 msgstr ""
1611 #. type: =item
1612 #: deb-control.pod deb-src-control.pod
1613 msgid "B<Recommends:> I<package-list>"
1614 msgstr ""
1616 #. type: textblock
1617 #: deb-control.pod
1618 msgid ""
1619 "Lists packages that would be found together with this one in all but unusual "
1620 "installations. The package maintenance software will warn the user if they "
1621 "install a package without those listed in its B<Recommends> field."
1622 msgstr ""
1624 #. type: =item
1625 #: deb-control.pod deb-src-control.pod
1626 msgid "B<Suggests:> I<package-list>"
1627 msgstr ""
1629 #. type: textblock
1630 #: deb-control.pod
1631 msgid ""
1632 "Lists packages that are related to this one and can perhaps enhance its "
1633 "usefulness, but without which installing this package is perfectly "
1634 "reasonable."
1635 msgstr ""
1637 #. type: textblock
1638 #: deb-control.pod
1639 msgid ""
1640 "The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> "
1641 "fields is a list of groups of alternative packages. Each group is a list of "
1642 "packages separated by vertical bar (or “pipe”) symbols, ‘B<|>’.  The groups "
1643 "are separated by commas.  Commas are to be read as “AND”, and pipes as “OR”, "
1644 "with pipes binding more tightly.  Each package name is optionally followed "
1645 "by an architecture qualifier appended after a colon ‘B<:>’, optionally "
1646 "followed by a version number specification in parentheses."
1647 msgstr ""
1649 #. type: textblock
1650 #: deb-control.pod
1651 msgid ""
1652 "An architecture qualifier name can be a real Debian architecture name (since "
1653 "dpkg 1.16.5) or B<any> (since dpkg 1.16.2).  If omitted, the default is the "
1654 "current binary package architecture.  A real Debian architecture name will "
1655 "match exactly that architecture for that package name, B<any> will match any "
1656 "architecture for that package name if the package has been marked as "
1657 "B<Multi-Arch: allowed>."
1658 msgstr ""
1660 #. type: textblock
1661 #: deb-control.pod deb-src-control.pod
1662 msgid ""
1663 "A version number may start with a ‘B<E<gt>E<gt>>’, in which case any later "
1664 "version will match, and may specify or omit the Debian packaging revision "
1665 "(separated by a hyphen).  Accepted version relationships are ‘B<E<gt>E<gt>>’ "
1666 "for greater than, ‘B<E<lt>E<lt>>’ for less than, ‘B<E<gt>=>’ for greater "
1667 "than or equal to, ‘B<E<lt>=>’ for less than or equal to, and ‘B<=>’ for "
1668 "equal to."
1669 msgstr ""
1671 #. type: =item
1672 #: deb-control.pod deb-src-control.pod
1673 msgid "B<Breaks:> I<package-list>"
1674 msgstr ""
1676 #. type: textblock
1677 #: deb-control.pod
1678 msgid ""
1679 "Lists packages that this one breaks, for example by exposing bugs when the "
1680 "named packages rely on this one. The package maintenance software will not "
1681 "allow broken packages to be configured; generally the resolution is to "
1682 "upgrade the packages named in a B<Breaks> field."
1683 msgstr ""
1685 #. type: =item
1686 #: deb-control.pod deb-src-control.pod
1687 msgid "B<Conflicts:> I<package-list>"
1688 msgstr ""
1690 #. type: textblock
1691 #: deb-control.pod
1692 msgid ""
1693 "Lists packages that conflict with this one, for example by containing files "
1694 "with the same names. The package maintenance software will not allow "
1695 "conflicting packages to be installed at the same time. Two conflicting "
1696 "packages should each include a B<Conflicts> line mentioning the other."
1697 msgstr ""
1699 #. type: =item
1700 #: deb-control.pod deb-src-control.pod
1701 msgid "B<Replaces:> I<package-list>"
1702 msgstr ""
1704 #. type: textblock
1705 #: deb-control.pod
1706 msgid ""
1707 "List of packages files from which this one replaces. This is used for "
1708 "allowing this package to overwrite the files of another package and is "
1709 "usually used with the B<Conflicts> field to force removal of the other "
1710 "package, if this one also has the same files as the conflicted package."
1711 msgstr ""
1713 #. type: textblock
1714 #: deb-control.pod
1715 msgid ""
1716 "The syntax of B<Breaks>, B<Conflicts> and B<Replaces> is a list of package "
1717 "names, separated by commas (and optional whitespace).  In the B<Breaks> and "
1718 "B<Conflicts> fields, the comma should be read as “OR”.  An optional "
1719 "architecture qualifier can also be appended to the package name with the "
1720 "same syntax as above, but the default is B<any> instead of the binary "
1721 "package architecture.  An optional version can also be given with the same "
1722 "syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields."
1723 msgstr ""
1725 #. type: =item
1726 #: deb-control.pod deb-src-control.pod
1727 msgid "B<Enhances:> I<package-list>"
1728 msgstr ""
1730 #. type: textblock
1731 #: deb-control.pod
1732 msgid ""
1733 "This is a list of packages that this one enhances.  It is similar to "
1734 "B<Suggests> but in the opposite direction."
1735 msgstr ""
1737 #. type: =item
1738 #: deb-control.pod deb-src-control.pod
1739 msgid "B<Provides:> I<package-list>"
1740 msgstr ""
1742 #. type: textblock
1743 #: deb-control.pod
1744 msgid ""
1745 "This is a list of virtual packages that this one provides.  Usually this is "
1746 "used in the case of several packages all providing the same service.  For "
1747 "example, sendmail and exim can serve as a mail server, so they provide a "
1748 "common package (“mail-transport-agent”) on which other packages can depend.  "
1749 "This will allow sendmail or exim to serve as a valid option to satisfy the "
1750 "dependency.  This prevents the packages that depend on a mail server from "
1751 "having to know the package names for all of them, and using ‘B<|>’ to "
1752 "separate the list."
1753 msgstr ""
1755 #. type: textblock
1756 #: deb-control.pod
1757 msgid ""
1758 "The syntax of B<Provides> is a list of package names, separated by commas "
1759 "(and optional whitespace).  An optional architecture qualifier can also be "
1760 "appended to the package name with the same syntax as above.  If omitted, the "
1761 "default is the current binary package architecture.  An optional exact "
1762 "(equal to) version can also be given with the same syntax as above (honored "
1763 "since dpkg 1.17.11)."
1764 msgstr ""
1766 #. type: =item
1767 #: deb-control.pod deb-src-control.pod
1768 msgid "B<Built-Using:> I<package-list>"
1769 msgstr ""
1771 #. type: textblock
1772 #: deb-control.pod
1773 msgid ""
1774 "This dependency field lists extra source packages that were used during the "
1775 "build of this binary package, for license compliance purposes.  This is an "
1776 "indication to the archive maintenance software that these extra source "
1777 "packages must be kept whilst this binary package is maintained.  This field "
1778 "must be a comma-separated list of source package names with strict ‘B<=>’ "
1779 "version relationships enclosed within parenthesis.  Note that the archive "
1780 "maintenance software is likely to refuse to accept an upload which declares "
1781 "a B<Built-Using> relationship which cannot be satisfied within the archive."
1782 msgstr ""
1784 #. type: =item
1785 #: deb-control.pod deb-src-control.pod
1786 msgid "B<Static-Built-Using:> I<package-list>"
1787 msgstr ""
1789 #. type: textblock
1790 #: deb-control.pod
1791 msgid ""
1792 "This dependency field lists extra source packages that were used during the "
1793 "build of this binary package, for static building purposes (for example "
1794 "linking against static libraries, builds for source-centered languages such "
1795 "as Go or Rust, usage of header-only C/C++ libraries, injecting data blobs "
1796 "into code, etc.).  This is useful to track whether this package might need "
1797 "to be rebuilt when source packages listed here have been updated, for "
1798 "example due to security updates.  This field must be a comma-separated list "
1799 "of source package names with strict ‘B<=>’ version relationships enclosed "
1800 "within parenthesis."
1801 msgstr ""
1803 #. type: textblock
1804 #: deb-control.pod
1805 msgid "Supported since dpkg 1.21.3."
1806 msgstr ""
1808 #. type: =item
1809 #: deb-control.pod
1810 msgid "B<Built-For-Profiles:> I<profile-list> (obsolete)"
1811 msgstr ""
1813 #. type: textblock
1814 #: deb-control.pod
1815 msgid ""
1816 "This field used to specify a whitespace separated list of build profiles "
1817 "that this binary packages was built with (since dpkg 1.17.2 until 1.18.18).  "
1818 "The information previously found in this field can now be found in the "
1819 "B<.buildinfo> file, which supersedes it."
1820 msgstr ""
1822 #. type: =item
1823 #: deb-control.pod
1824 msgid "B<Auto-Built-Package:> I<reason-list>"
1825 msgstr ""
1827 #. type: textblock
1828 #: deb-control.pod
1829 msgid ""
1830 "This field specifies a whitespace separated list of reasons why this package "
1831 "was auto-generated.  Binary packages marked with this field will not appear "
1832 "in the I<debian/control> master source control file.  The only currently "
1833 "used reason is B<debug-symbols>."
1834 msgstr ""
1836 #. type: =item
1837 #: deb-control.pod
1838 msgid "B<Build-Ids:> I<elf-build-id-list>"
1839 msgstr ""
1841 #. type: textblock
1842 #: deb-control.pod
1843 msgid ""
1844 "This field specifies a whitespace separated list of ELF build-ids. These are "
1845 "unique identifiers for semantically identical ELF objects, for each of these "
1846 "within the package."
1847 msgstr ""
1849 #. type: textblock
1850 #: deb-control.pod
1851 msgid "The format or the way to compute each build-id is not defined by design."
1852 msgstr ""
1854 #. type: verbatim
1855 #: deb-control.pod
1856 #, no-wrap
1857 msgid ""
1858 " Package: grep\n"
1859 " Essential: yes\n"
1860 " Priority: required\n"
1861 " Section: base\n"
1862 " Maintainer: Wichert Akkerman <wakkerma@debian.org>\n"
1863 " Architecture: sparc\n"
1864 " Version: 2.4-1\n"
1865 " Pre-Depends: libc6 (>= 2.0.105)\n"
1866 " Provides: rgrep\n"
1867 " Conflicts: rgrep\n"
1868 " Description: GNU grep, egrep and fgrep.\n"
1869 "  The GNU family of grep utilities may be the \"fastest grep in the "
1870 "west\".\n"
1871 "  GNU grep is based on a fast lazy-state deterministic matcher (about\n"
1872 "  twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper\n"
1873 "  search for a fixed string that eliminates impossible text from being\n"
1874 "  considered by the full regexp matcher without necessarily having to\n"
1875 "  look at every character. The result is typically many times faster\n"
1876 "  than Unix grep or egrep. (Regular expressions containing backreferencing\n"
1877 "  will run more slowly, however).\n"
1878 "\n"
1879 msgstr ""
1881 #. type: textblock
1882 #: deb-control.pod
1883 msgid ""
1884 "The B<Build-Ids> field uses a rather generic name out of its original "
1885 "context within an ELF object, which serves a very specific purpose and "
1886 "executable format."
1887 msgstr ""
1889 #. type: textblock
1890 #: deb-control.pod
1891 msgid ""
1892 "L<deb822(5)>, B<deb-src-control>(5), B<deb>(5), B<deb-version>(7), "
1893 "B<debtags>(1), B<dpkg>(1), B<dpkg-deb>(1)."
1894 msgstr ""
1896 #. type: textblock
1897 #: deb-extra-override.pod
1898 msgid "deb-extra-override - Debian archive extra override file"
1899 msgstr ""
1901 #. type: textblock
1902 #: deb-extra-override.pod deb-override.pod
1903 msgid "B<override>"
1904 msgstr ""
1906 #. type: textblock
1907 #: deb-extra-override.pod
1908 msgid ""
1909 "While most information about a binary/source package can be found in the "
1910 "control/.dsc file, all of it can be overridden when it's exported to "
1911 "Packages/Sources files. The extra override file contains those overrides."
1912 msgstr ""
1914 #. type: textblock
1915 #: deb-extra-override.pod
1916 msgid ""
1917 "The extra override file has a simple whitespace-delimited format. Comments "
1918 "are allowed (denoted with a B<#>)."
1919 msgstr ""
1921 #. type: textblock
1922 #: deb-extra-override.pod
1923 msgid "I<package> I<field-name> I<value>"
1924 msgstr ""
1926 #. type: textblock
1927 #: deb-extra-override.pod
1928 msgid "I<package> is the name of the binary/source package."
1929 msgstr ""
1931 #. type: textblock
1932 #: deb-extra-override.pod
1933 msgid "I<field-name> is the name of the field that is overridden."
1934 msgstr ""
1936 #. type: textblock
1937 #: deb-extra-override.pod
1938 msgid ""
1939 "I<value> is the value to put in the field. It can contain spaces as the line "
1940 "is split in no more than 3 columns when it's parsed."
1941 msgstr ""
1943 #. type: textblock
1944 #: deb-extra-override.pod
1945 msgid ""
1946 "The extra override files used to make the official Packages lists may be "
1947 "found in the I<indices> directory on any Debian mirror."
1948 msgstr ""
1950 #. type: textblock
1951 #: deb-extra-override.pod deb-override.pod
1952 msgid "B<dpkg-scanpackages>(1), B<dpkg-scansources>(1), B<apt-ftparchive>(1)."
1953 msgstr ""
1955 #. type: textblock
1956 #: deb-md5sums.pod
1957 msgid "deb-md5sums - package MD5 file digests"
1958 msgstr ""
1960 #. type: textblock
1961 #: deb-md5sums.pod
1962 msgid "B<DEBIAN/md5sums>"
1963 msgstr ""
1965 #. type: textblock
1966 #: deb-md5sums.pod
1967 msgid ""
1968 "A package declares the MD5 digests for the package file contents by "
1969 "including an I<md5sums> file in its control archive (i.e. I<DEBIAN/md5sums> "
1970 "during package creation). This file is used for integrity verification and "
1971 "deduplication purposes, and not for any kind of security purpose."
1972 msgstr ""
1974 #. type: textblock
1975 #: deb-md5sums.pod
1976 msgid ""
1977 "This file contains a list of MD5 digests (as 32 case-insensitive hexadecimal "
1978 "characters) followed by two spaces (U+0020 B<SPACE>) and the absolute "
1979 "pathname of a plain file, one per line."
1980 msgstr ""
1982 #. type: textblock
1983 #: deb-md5sums.pod
1984 msgid ""
1985 "Trailing slashes (U+002F B</>) in the pathname will be trimmed.  Neither "
1986 "trailing whitespace nor empty or whitespace-only lines are accepted."
1987 msgstr ""
1989 #. type: textblock
1990 #: deb-md5sums.pod
1991 msgid ""
1992 "If the control file does not exist in the binary package, L<dpkg(1)> will "
1993 "generate the matching information at unpack time (since B<dpkg> 1.16.3)."
1994 msgstr ""
1996 #. type: verbatim
1997 #: deb-md5sums.pod
1998 #, no-wrap
1999 msgid ""
2000 " 53c0d4afe4bc4eccb5cb234d2e06ef4d  usr/bin/dpkg\n"
2001 " f8da2bc74cdcad8b81c48a4f0d7bb0a8  usr/bin/dpkg-deb\n"
2002 " 70b913132de56e95e75de504979309b4  usr/bin/dpkg-divert\n"
2003 " […]\n"
2004 "\n"
2005 msgstr ""
2007 #. type: textblock
2008 #: deb-md5sums.pod
2009 msgid "B<md5sum>(1), B<dpkg-deb>(1), B<dpkg>(1)."
2010 msgstr ""
2012 #. type: textblock
2013 #: deb-old.pod
2014 msgid "deb-old - old style Debian binary package format"
2015 msgstr ""
2017 #. type: textblock
2018 #: deb-old.pod deb-split.pod deb.pod
2019 msgid "I<filename>B<.deb>"
2020 msgstr ""
2022 #. type: textblock
2023 #: deb-old.pod
2024 msgid ""
2025 "The B<.deb> format is the Debian binary package file format. This manual "
2026 "page describes the B<old> format, used before Debian 0.93. Please see "
2027 "B<deb>(5)  for details of the new format."
2028 msgstr ""
2030 #. type: =head1
2031 #: deb-old.pod deb-split.pod deb.pod
2032 msgid "FORMAT"
2033 msgstr ""
2035 #. type: textblock
2036 #: deb-old.pod
2037 msgid ""
2038 "The file is two lines of format information as ASCII text, followed by two "
2039 "concatenated gzipped ustar files."
2040 msgstr ""
2042 #. type: textblock
2043 #: deb-old.pod
2044 msgid ""
2045 "The first line is the format version number padded to 8 digits, and is "
2046 "B<0.939000> for all old-format archives."
2047 msgstr ""
2049 #. type: textblock
2050 #: deb-old.pod
2051 msgid ""
2052 "The second line is a decimal string (without leading zeroes) giving the "
2053 "length of the first gzipped tarfile."
2054 msgstr ""
2056 #. type: textblock
2057 #: deb-old.pod
2058 msgid "Each of these lines is terminated with a single newline character."
2059 msgstr ""
2061 #. type: textblock
2062 #: deb-old.pod
2063 msgid ""
2064 "The first tarfile contains the control information, as a series of ordinary "
2065 "files. The file B<control> must be present, as it contains the core control "
2066 "information."
2067 msgstr ""
2069 #. type: textblock
2070 #: deb-old.pod
2071 msgid ""
2072 "In some very old archives, the files in the control tarfile may optionally "
2073 "be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory "
2074 "will be in the control tarfile too, and the control tarfile will have only "
2075 "files in that directory. Optionally the control tarfile may contain an entry "
2076 "for ‘B<.>’, that is, the current directory."
2077 msgstr ""
2079 #. type: textblock
2080 #: deb-old.pod
2081 msgid ""
2082 "The second gzipped tarfile is the filesystem archive, containing pathnames "
2083 "relative to the root directory of the system to be installed on. The "
2084 "pathnames do not have leading slashes."
2085 msgstr ""
2087 #. type: textblock
2088 #: deb-old.pod
2089 msgid "B<deb>(5), B<dpkg-deb>(1), B<deb-control>(5)."
2090 msgstr ""
2092 #. type: textblock
2093 #: deb-origin.pod
2094 msgid "deb-origin - Vendor-specific information files"
2095 msgstr ""
2097 #. type: textblock
2098 #: deb-origin.pod
2099 msgid "B<%PKGCONFDIR%/origins/>I<filename>"
2100 msgstr ""
2102 #. type: textblock
2103 #: deb-origin.pod
2104 msgid ""
2105 "The files in B<%PKGCONFDIR%/origins> can provide information about various "
2106 "vendors who are providing Debian packages."
2107 msgstr ""
2109 #. type: textblock
2110 #: deb-origin.pod
2111 msgid ""
2112 "They contain a number of fields, or comments when the line starts with "
2113 "‘B<#>’.  Each field begins with a tag, such as B<Vendor> or B<Parent>, "
2114 "followed by a colon and the body of the field. Fields are delimited only by "
2115 "field tags. In other words, field text may be multiple lines in length, but "
2116 "the tools will join lines when processing the body of the field."
2117 msgstr ""
2119 #. type: textblock
2120 #: deb-origin.pod
2121 msgid ""
2122 "The file should be named according to the vendor name.  The usual convention "
2123 "is to name the vendor file using the vendor name in all lowercase, but some "
2124 "variation is permitted."
2125 msgstr ""
2127 #. type: textblock
2128 #: deb-origin.pod
2129 msgid ""
2130 "Namely (since dpkg 1.21.10), first, non-alphanumeric characters "
2131 "(‘B<[^A-Za-z0-9]>’) are mapped to dashes (‘B<->’), then the resulting name "
2132 "will be tried in sequence by lower-casing it, keeping it as is, lower-casing "
2133 "then capitalizing it (that is upper-casing the first character), and only "
2134 "capitalizing it."
2135 msgstr ""
2137 #. type: textblock
2138 #: deb-origin.pod
2139 msgid ""
2140 "In addition, for historical and backwards compatibility, the name will be "
2141 "tried keeping it as is without non-alphanumeric characters remapping, then "
2142 "the resulting name will be tried in sequence by lower-casing it, keeping it "
2143 "as is, lower-casing then capitalizing it, and only capitalizing it.  And "
2144 "finally the name will be tried by remapping spaces to dashes (‘B<->’), then "
2145 "the resulting name will be tried in sequence by lower-casing it, keeping it "
2146 "as is, lower-casing then capitalizing it, and only capitalizing it."
2147 msgstr ""
2149 #. type: textblock
2150 #: deb-origin.pod
2151 msgid ""
2152 "But these backwards compatible module lookups will be removed during the "
2153 "dpkg 1.22.x release cycle."
2154 msgstr ""
2156 #. type: =item
2157 #: deb-origin.pod
2158 msgid "B<Vendor:> I<vendor-name> (required)"
2159 msgstr ""
2161 #. type: textblock
2162 #: deb-origin.pod
2163 msgid "The value of this field determines the vendor name."
2164 msgstr ""
2166 #. type: =item
2167 #: deb-origin.pod
2168 msgid "B<Vendor-URL:> I<vendor-url>"
2169 msgstr ""
2171 #. type: textblock
2172 #: deb-origin.pod
2173 msgid "The value of this field determines the vendor URL."
2174 msgstr ""
2176 #. type: =item
2177 #: deb-origin.pod
2178 msgid "B<Bugs:> I<bug-url>"
2179 msgstr ""
2181 #. type: textblock
2182 #: deb-origin.pod
2183 msgid ""
2184 "The value of this field determines the type and address of the bug tracking "
2185 "system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., "
2186 "debbugs://bugs.debian.org/)."
2187 msgstr ""
2189 #. type: =item
2190 #: deb-origin.pod
2191 msgid "B<Parent:> I<vendor-name>"
2192 msgstr ""
2194 #. type: textblock
2195 #: deb-origin.pod
2196 msgid ""
2197 "The value of this field determines the vendor name of the vendor that this "
2198 "vendor derives from."
2199 msgstr ""
2201 #. type: verbatim
2202 #: deb-origin.pod
2203 #, no-wrap
2204 msgid ""
2205 " Vendor: Debian\n"
2206 " Vendor-URL: https://www.debian.org/\n"
2207 " Bugs: debbugs://bugs.debian.org\n"
2208 "\n"
2209 msgstr ""
2211 #. type: textblock
2212 #: deb-origin.pod
2213 msgid "B<dpkg-vendor>(1)"
2214 msgstr ""
2216 #. type: textblock
2217 #: deb-override.pod
2218 msgid "deb-override - Debian archive override file"
2219 msgstr ""
2221 #. type: textblock
2222 #: deb-override.pod
2223 msgid ""
2224 "While most information about a package can be found in the control file, "
2225 "some is managed centrally by the distribution czars rather than by the "
2226 "maintainer in order to offer some global consistency.  This information is "
2227 "found in the override file."
2228 msgstr ""
2230 #. type: textblock
2231 #: deb-override.pod
2232 msgid ""
2233 "The override file has a simple whitespace-delimited format. Comments are "
2234 "allowed (denoted with a B<#>)."
2235 msgstr ""
2237 #. type: textblock
2238 #: deb-override.pod
2239 msgid "I<package> I<priority> I<section> [I<maintainer-info>]"
2240 msgstr ""
2242 #. type: textblock
2243 #: deb-override.pod
2244 msgid ""
2245 "I<package> is the name of the package. Entries in the override file for "
2246 "packages not found in the tree of binary packages are ignored."
2247 msgstr ""
2249 #. type: textblock
2250 #: deb-override.pod
2251 msgid ""
2252 "I<priority> and I<section> correspond to the respective control fields "
2253 "available in the .deb. The allowed values are specific to each distribution "
2254 "archive."
2255 msgstr ""
2257 #. type: textblock
2258 #: deb-override.pod
2259 msgid ""
2260 "I<maintainer-info>, if present, can be either the name of a maintainer for "
2261 "an unconditional override, or else I<old-maintainer> B<=E<gt>> "
2262 "I<new-maintainer> to perform a substitution."
2263 msgstr ""
2265 #. type: textblock
2266 #: deb-override.pod
2267 msgid ""
2268 "The override files used to make the official Packages lists may be found in "
2269 "the I<indices> directory on any Debian mirror."
2270 msgstr ""
2272 #. type: textblock
2273 #: deb-postinst.pod
2274 msgid "deb-postinst - package post-installation maintainer script"
2275 msgstr ""
2277 #. type: textblock
2278 #: deb-postinst.pod
2279 msgid "B<DEBIAN/postinst>"
2280 msgstr ""
2282 #. type: textblock
2283 #: deb-postinst.pod
2284 msgid ""
2285 "A package can perform several post-installation actions via maintainer "
2286 "scripts, by including an executable I<postinst> file in its control archive "
2287 "(i.e. I<DEBIAN/postinst> during package creation)."
2288 msgstr ""
2290 #. type: textblock
2291 #: deb-postinst.pod deb-postrm.pod deb-preinst.pod deb-prerm.pod
2292 msgid "The script can be called in the following ways:"
2293 msgstr ""
2295 #. type: =item
2296 #: deb-postinst.pod
2297 msgid "I<postinst> B<configure> I<old-version>"
2298 msgstr ""
2300 #. type: textblock
2301 #: deb-postinst.pod
2302 msgid "After the package was installed."
2303 msgstr ""
2305 #. type: =item
2306 #: deb-postinst.pod
2307 msgid "I<postinst> B<triggered> \"I<trigger-name...>\""
2308 msgstr ""
2310 #. type: textblock
2311 #: deb-postinst.pod
2312 msgid ""
2313 "After the package was triggered.  The list of space-separated "
2314 "I<trigger-name>s is passed as the second argument."
2315 msgstr ""
2317 #. type: =item
2318 #: deb-postinst.pod
2319 msgid "I<old-postinst> B<abort-upgrade> I<new-version>"
2320 msgstr ""
2322 #. type: textblock
2323 #: deb-postinst.pod
2324 msgid "If I<prerm> fails during B<upgrade> or fails on B<failed-upgrade>."
2325 msgstr ""
2327 #. type: =item
2328 #: deb-postinst.pod
2329 msgid "I<old-postinst> B<abort-remove>"
2330 msgstr ""
2332 #. type: textblock
2333 #: deb-postinst.pod
2334 msgid "If I<prerm> fails during B<remove>."
2335 msgstr ""
2337 #. type: =item
2338 #: deb-postinst.pod
2339 msgid "I<postinst> B<abort-deconfigure> B<in-favour> I<new-package> I<new-version>"
2340 msgstr ""
2342 #. type: =item
2343 #: deb-postinst.pod deb-prerm.pod
2344 msgid "S< >[ B<removing> I<old-package> I<old-version> ]"
2345 msgstr ""
2347 #. type: textblock
2348 #: deb-postinst.pod
2349 msgid "If I<prerm> fails during B<deconfigure in-favour> of a package."
2350 msgstr ""
2352 #. type: =item
2353 #: deb-postinst.pod
2354 msgid "I<postinst> B<abort-remove> B<in-favour> I<new-package> I<new-version>"
2355 msgstr ""
2357 #. type: textblock
2358 #: deb-postinst.pod
2359 msgid ""
2360 "If I<prerm> fails during B<remove in-favour> for replacement due to "
2361 "conflict."
2362 msgstr ""
2364 #. type: textblock
2365 #: deb-postinst.pod deb-postrm.pod deb-preinst.pod deb-prerm.pod
2366 #: dpkg-divert.pod dpkg-query.pod dpkg-statoverride.pod dpkg.cfg.pod
2367 msgid "B<dpkg>(1)."
2368 msgstr ""
2370 #. type: textblock
2371 #: deb-postrm.pod
2372 msgid "deb-postrm - package post-removal maintainer script"
2373 msgstr ""
2375 #. type: textblock
2376 #: deb-postrm.pod
2377 msgid "B<DEBIAN/postrm>"
2378 msgstr ""
2380 #. type: textblock
2381 #: deb-postrm.pod
2382 msgid ""
2383 "A package can perform several post-removal actions via maintainer scripts, "
2384 "by including an executable I<postrm> file in its control archive "
2385 "(i.e. I<DEBIAN/postrm> during package creation)."
2386 msgstr ""
2388 #. type: =item
2389 #: deb-postrm.pod
2390 msgid "I<postrm> B<remove>"
2391 msgstr ""
2393 #. type: textblock
2394 #: deb-postrm.pod
2395 msgid "After the package was removed."
2396 msgstr ""
2398 #. type: =item
2399 #: deb-postrm.pod
2400 msgid "I<postrm> B<purge>"
2401 msgstr ""
2403 #. type: textblock
2404 #: deb-postrm.pod
2405 msgid "After the package was purged."
2406 msgstr ""
2408 #. type: =item
2409 #: deb-postrm.pod
2410 msgid "I<old-postrm> B<upgrade> I<new-version>"
2411 msgstr ""
2413 #. type: textblock
2414 #: deb-postrm.pod
2415 msgid "After the package was upgraded."
2416 msgstr ""
2418 #. type: =item
2419 #: deb-postrm.pod
2420 msgid "I<new-postrm> B<failed-upgrade> I<old-version> I<new-version>"
2421 msgstr ""
2423 #. type: textblock
2424 #: deb-postrm.pod
2425 msgid "If the above B<upgrade> call fails."
2426 msgstr ""
2428 #. type: textblock
2429 #: deb-postrm.pod deb-preinst.pod deb-prerm.pod
2430 msgid "The I<new-version> is passed only since dpkg 1.18.5."
2431 msgstr ""
2433 #. type: =item
2434 #: deb-postrm.pod
2435 msgid "I<postrm> B<disappear> I<overwriter-package> I<overwriter-version>"
2436 msgstr ""
2438 #. type: textblock
2439 #: deb-postrm.pod
2440 msgid "After all of the packages files have been replaced."
2441 msgstr ""
2443 #. type: =item
2444 #: deb-postrm.pod
2445 msgid "I<new-postrm> B<abort-install>"
2446 msgstr ""
2448 #. type: textblock
2449 #: deb-postrm.pod
2450 msgid "If I<preinst> fails during B<install>."
2451 msgstr ""
2453 #. type: =item
2454 #: deb-postrm.pod
2455 msgid "I<new-postrm> B<abort-install> I<old-version> I<new-version>"
2456 msgstr ""
2458 #. type: textblock
2459 #: deb-postrm.pod
2460 msgid "If I<preinst> fails during B<install> for an upgrade of a removed package."
2461 msgstr ""
2463 #. type: =item
2464 #: deb-postrm.pod
2465 msgid "I<new-postrm> B<abort-upgrade> I<old-version> I<new-version>"
2466 msgstr ""
2468 #. type: textblock
2469 #: deb-postrm.pod
2470 msgid "If I<preinst> fails during B<upgrade>."
2471 msgstr ""
2473 #. type: textblock
2474 #: deb-preinst.pod
2475 msgid "deb-preinst - package pre-installation maintainer script"
2476 msgstr ""
2478 #. type: textblock
2479 #: deb-preinst.pod
2480 msgid "B<DEBIAN/preinst>"
2481 msgstr ""
2483 #. type: textblock
2484 #: deb-preinst.pod
2485 msgid ""
2486 "A package can perform several pre-installation actions via maintainer "
2487 "scripts, by including an executable I<preinst> file in its control archive "
2488 "(i.e. I<DEBIAN/preinst> during package creation)."
2489 msgstr ""
2491 #. type: =item
2492 #: deb-preinst.pod
2493 msgid "I<new-preinst> B<install>"
2494 msgstr ""
2496 #. type: textblock
2497 #: deb-preinst.pod
2498 msgid "Before the package is installed."
2499 msgstr ""
2501 #. type: =item
2502 #: deb-preinst.pod
2503 msgid "I<new-preinst> B<install> I<old-version> I<new-version>"
2504 msgstr ""
2506 #. type: textblock
2507 #: deb-preinst.pod
2508 msgid "Before a removed package is upgraded."
2509 msgstr ""
2511 #. type: =item
2512 #: deb-preinst.pod
2513 msgid "I<new-preinst> B<upgrade> I<old-version> I<new-version>"
2514 msgstr ""
2516 #. type: textblock
2517 #: deb-preinst.pod
2518 msgid "Before the package is upgraded."
2519 msgstr ""
2521 #. type: =item
2522 #: deb-preinst.pod
2523 msgid "I<old-preinst> B<abort-upgrade> I<new-version>"
2524 msgstr ""
2526 #. type: textblock
2527 #: deb-preinst.pod
2528 msgid "If I<postrm> fails during upgrade or fails on failed upgrade."
2529 msgstr ""
2531 #. type: textblock
2532 #: deb-prerm.pod
2533 msgid "deb-prerm - package pre-removal maintainer script"
2534 msgstr ""
2536 #. type: textblock
2537 #: deb-prerm.pod
2538 msgid "B<DEBIAN/prerm>"
2539 msgstr ""
2541 #. type: textblock
2542 #: deb-prerm.pod
2543 msgid ""
2544 "A package can perform several pre-removal actions via maintainer scripts, by "
2545 "including an executable I<prerm> file in its control archive "
2546 "(i.e. I<DEBIAN/prerm> during package creation)."
2547 msgstr ""
2549 #. type: =item
2550 #: deb-prerm.pod
2551 msgid "I<prerm> B<remove>"
2552 msgstr ""
2554 #. type: textblock
2555 #: deb-prerm.pod
2556 msgid "Before the package is removed."
2557 msgstr ""
2559 #. type: =item
2560 #: deb-prerm.pod
2561 msgid "I<old-prerm> B<upgrade> I<new-version>"
2562 msgstr ""
2564 #. type: textblock
2565 #: deb-prerm.pod
2566 msgid "Before an upgrade."
2567 msgstr ""
2569 #. type: =item
2570 #: deb-prerm.pod
2571 msgid "I<new-prerm> B<failed-upgrade> I<old-version> I<new-version>"
2572 msgstr ""
2574 #. type: textblock
2575 #: deb-prerm.pod
2576 msgid "If the above B<upgrade> fails."
2577 msgstr ""
2579 #. type: =item
2580 #: deb-prerm.pod
2581 msgid "I<prerm> B<deconfigure> B<in-favour> I<new-package> I<new-version>"
2582 msgstr ""
2584 #. type: textblock
2585 #: deb-prerm.pod
2586 msgid "Before package is deconfigured while dependency is replaced due to conflict."
2587 msgstr ""
2589 #. type: =item
2590 #: deb-prerm.pod
2591 msgid "I<prerm> B<remove> B<in-favour> I<new-package> I<new-version>"
2592 msgstr ""
2594 #. type: textblock
2595 #: deb-prerm.pod
2596 msgid "Before the package is replaced due to conflict."
2597 msgstr ""
2599 #. type: textblock
2600 #: deb-shlibs.pod
2601 msgid "deb-shlibs - Debian shared library information file"
2602 msgstr ""
2604 #. type: textblock
2605 #: deb-shlibs.pod
2606 msgid "B<debian/shlibs>, B<debian/>I<binary-name>B<.shlibs>, B<DEBIAN/shlibs>"
2607 msgstr ""
2609 #. type: textblock
2610 #: deb-shlibs.pod
2611 msgid ""
2612 "B<shlibs> files map shared library names and versions (I<SONAMEs>)  to "
2613 "dependencies suitable for a package control file.  There is one entry per "
2614 "line. Blank lines are B<not> allowed.  Lines beginning with a B<#> character "
2615 "are considered commentary, and are ignored.  All other lines must have the "
2616 "format:"
2617 msgstr ""
2619 #. type: textblock
2620 #: deb-shlibs.pod
2621 msgid "[I<type>B<:>] I<library> I<version> I<dependencies>"
2622 msgstr ""
2624 #. type: textblock
2625 #: deb-shlibs.pod
2626 msgid ""
2627 "The I<library> and I<version> fields are whitespace-delimited, but the "
2628 "I<dependencies> field extends to the end of the line.  The I<type> field is "
2629 "optional and normally not needed."
2630 msgstr ""
2632 #. type: textblock
2633 #: deb-shlibs.pod
2634 msgid ""
2635 "The I<dependencies> field has the same syntax as the B<Depends> field in a "
2636 "binary control file, see B<deb-control>(5)."
2637 msgstr ""
2639 #. type: =head1
2640 #: deb-shlibs.pod
2641 msgid "SONAME FORMATS"
2642 msgstr ""
2644 #. type: textblock
2645 #: deb-shlibs.pod
2646 msgid "The SONAME formats supported are:"
2647 msgstr ""
2649 #. type: textblock
2650 #: deb-shlibs.pod
2651 msgid "I<name>.so.I<version>"
2652 msgstr ""
2654 #. type: textblock
2655 #: deb-shlibs.pod
2656 msgid "and"
2657 msgstr ""
2659 #. type: textblock
2660 #: deb-shlibs.pod
2661 msgid "I<name>-I<version>.so"
2662 msgstr ""
2664 #. type: textblock
2665 #: deb-shlibs.pod
2666 msgid "where I<name> is usually prefixed by B<lib>."
2667 msgstr ""
2669 #. type: textblock
2670 #: deb-shlibs.pod
2671 msgid ""
2672 "The B<shlibs> file for a typical library package, named I<libcrunch1>, that "
2673 "provides one library whose SONAME is I<libcrunch.so.1>, might read"
2674 msgstr ""
2676 #. type: verbatim
2677 #: deb-shlibs.pod
2678 #, no-wrap
2679 msgid ""
2680 " libcrunch 1 libcrunch1 (>= 1.2-1)\n"
2681 "\n"
2682 msgstr ""
2684 #. type: textblock
2685 #: deb-shlibs.pod
2686 msgid ""
2687 "The I<dependencies> must mention the most recent version of the package that "
2688 "added new symbols to the library: in the above example, new symbols were "
2689 "added to version 1.2 of I<libcrunch>.  This is not the only reason the "
2690 "dependencies might need to be tightened."
2691 msgstr ""
2693 #. type: textblock
2694 #: deb-shlibs.pod
2695 msgid "B<deb-control>(5), B<dpkg-shlibdeps>(1), B<deb-symbols>(5)."
2696 msgstr ""
2698 #. type: textblock
2699 #: deb-split.pod
2700 msgid "deb-split - Debian multi-part binary package format"
2701 msgstr ""
2703 #. type: textblock
2704 #: deb-split.pod
2705 msgid ""
2706 "The multi-part B<.deb> format is used to split big packages into smaller "
2707 "pieces to ease transport in small media."
2708 msgstr ""
2710 #. type: textblock
2711 #: deb-split.pod
2712 msgid ""
2713 "The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  The "
2714 "file names might contain a trailing slash (since dpkg 1.15.6)."
2715 msgstr ""
2717 #. type: textblock
2718 #: deb-split.pod
2719 msgid ""
2720 "The first member is named B<debian-split> and contains a series of lines, "
2721 "separated by newlines. Currently eight lines are present:"
2722 msgstr ""
2724 #. type: =item
2725 #: deb-split.pod deb-src-symbols.pod dpkg-fsys-usrunmess.pod
2726 #: dpkg-gensymbols.pod dselect.pod
2727 msgid "*"
2728 msgstr ""
2730 #. type: textblock
2731 #: deb-split.pod
2732 msgid "The format version number, B<2.1> at the time this manual page was written."
2733 msgstr ""
2735 #. type: textblock
2736 #: deb-split.pod
2737 msgid "The package name."
2738 msgstr ""
2740 #. type: textblock
2741 #: deb-split.pod
2742 msgid "The package version."
2743 msgstr ""
2745 #. type: textblock
2746 #: deb-split.pod
2747 msgid "The md5sum of the package."
2748 msgstr ""
2750 #. type: textblock
2751 #: deb-split.pod
2752 msgid "The total size of the package."
2753 msgstr ""
2755 #. type: textblock
2756 #: deb-split.pod
2757 msgid "The maximum part size."
2758 msgstr ""
2760 #. type: textblock
2761 #: deb-split.pod
2762 msgid ""
2763 "The current part number, followed by a slash and the total amount of parts "
2764 "(as in ‘1/10’)."
2765 msgstr ""
2767 #. type: textblock
2768 #: deb-split.pod
2769 msgid "The package architecture (since dpkg 1.16.1)."
2770 msgstr ""
2772 #. type: textblock
2773 #: deb-split.pod
2774 msgid ""
2775 "Programs which read multi-part archives should be prepared for the minor "
2776 "format version number to be increased and additional lines to be present, "
2777 "and should ignore these if this is the case."
2778 msgstr ""
2780 #. type: textblock
2781 #: deb-split.pod
2782 msgid ""
2783 "If the major format version number has changed, an incompatible change has "
2784 "been made and the program should stop. If it has not, then the program "
2785 "should be able to safely continue, unless it encounters an unexpected member "
2786 "in the archive (except at the end), as described below."
2787 msgstr ""
2789 #. type: textblock
2790 #: deb-split.pod
2791 msgid ""
2792 "The second, last required member is named B<data.>I<N>, where I<N> denotes "
2793 "the part number. It contains the raw part data."
2794 msgstr ""
2796 #. type: textblock
2797 #: deb-split.pod
2798 msgid ""
2799 "These members must occur in this exact order. Current implementations should "
2800 "ignore any additional members after B<data.>I<N>.  Further members may be "
2801 "defined in the future, and (if possible) will be placed after these two."
2802 msgstr ""
2804 #. type: textblock
2805 #: deb-split.pod
2806 msgid "B<deb>(5), B<dpkg-split>(1)."
2807 msgstr ""
2809 #. type: textblock
2810 #: deb-src-control.pod
2811 msgid "deb-src-control - Debian source packages' master control file format"
2812 msgstr ""
2814 #. type: =item
2815 #: deb-src-control.pod dpkg-gencontrol.pod
2816 msgid "B<debian/control>"
2817 msgstr ""
2819 #. type: textblock
2820 #: deb-src-control.pod
2821 msgid ""
2822 "Each Debian source package contains the master «B<debian/control>» file, and "
2823 "its L<deb822(5)> format is a superset of the B<control> file shipped in "
2824 "Debian binary packages, see B<deb-control>(5)."
2825 msgstr ""
2827 #. type: textblock
2828 #: deb-src-control.pod
2829 msgid ""
2830 "This file contains at least 2 stanzas, separated by a blank line.  The first "
2831 "stanza lists all information about the source package in general, while each "
2832 "following stanza describes exactly one binary package.  Each stanza consists "
2833 "of at least one field.  A field starts with a fieldname, such as B<Package> "
2834 "or B<Section> (case insensitive), followed by a colon, the body of the field "
2835 "(case sensitive unless stated otherwise) and a newline.  Multi-line fields "
2836 "are also allowed, but each supplementary line, without a fieldname, should "
2837 "start with at least one space. The content of the multi-line fields is "
2838 "generally joined to a single line by the tools (except in the case of the "
2839 "B<Description> field, see below). To insert empty lines into a multi-line "
2840 "field, insert a dot after the space.  Lines starting with a ‘B<#>’ are "
2841 "treated as comments."
2842 msgstr ""
2844 #. type: =head1
2845 #: deb-src-control.pod
2846 msgid "SOURCE FIELDS"
2847 msgstr ""
2849 #. type: =item
2850 #: deb-src-control.pod
2851 msgid "B<Source:> I<source-package-name> (required)"
2852 msgstr ""
2854 #. type: textblock
2855 #: deb-src-control.pod
2856 msgid ""
2857 "The value of this field is the name of the source package, and should match "
2858 "the name of the source package in the debian/changelog file. A package name "
2859 "must consist only of lowercase letters (a-z), digits (0-9), plus (+) and "
2860 "minus (-) signs, and periods (.). Package names must be at least two "
2861 "characters long and must start with a lowercase alphanumeric character "
2862 "(a-z0-9)."
2863 msgstr ""
2865 #. type: textblock
2866 #: deb-src-control.pod
2867 msgid ""
2868 "Should be in the format «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», and "
2869 "references the person who currently maintains the package, as opposed to the "
2870 "author of the software or the original packager."
2871 msgstr ""
2873 #. type: =item
2874 #: deb-src-control.pod
2875 msgid "B<Uploaders:> I<fullname-email>"
2876 msgstr ""
2878 #. type: textblock
2879 #: deb-src-control.pod dsc.pod
2880 msgid ""
2881 "Lists all the names and email addresses of co-maintainers of the package, in "
2882 "the same format as the B<Maintainer> field.  Multiple co-maintainers should "
2883 "be separated by a comma."
2884 msgstr ""
2886 #. type: =item
2887 #: deb-src-control.pod
2888 msgid "B<Standards-Version:> I<version-string>"
2889 msgstr ""
2891 #. type: textblock
2892 #: deb-src-control.pod dsc.pod
2893 msgid ""
2894 "This documents the most recent version of the distribution policy standards "
2895 "this package complies with."
2896 msgstr ""
2898 #. type: =item
2899 #: deb-src-control.pod dsc.pod
2900 msgid "B<Description> I<short-description>"
2901 msgstr ""
2903 #. type: textblock
2904 #: deb-src-control.pod dsc.pod
2905 msgid ""
2906 "The format for the source package description is a short brief summary on "
2907 "the first line (after the B<Description> field).  The following lines should "
2908 "be used as a longer, more detailed description.  Each line of the long "
2909 "description must be preceded by a space, and blank lines in the long "
2910 "description must contain a single ‘B<.>’ following the preceding space."
2911 msgstr ""
2913 #. type: textblock
2914 #: deb-src-control.pod
2915 msgid "The upstream project home page URL."
2916 msgstr ""
2918 #. type: textblock
2919 #: deb-src-control.pod
2920 msgid ""
2921 "The I<url> of the bug tracking system for this package. The current used "
2922 "format is I<bts-type>B<://>I<bts-address>, like "
2923 "B<debbugs://bugs.debian.org>. This field is usually not needed."
2924 msgstr ""
2926 #. type: =item
2927 #: deb-src-control.pod
2928 msgid "B<Rules-Requires-Root:> B<no>|B<binary-targets>|I<impl-keywords>"
2929 msgstr ""
2931 #. type: textblock
2932 #: deb-src-control.pod
2933 msgid ""
2934 "This field is used to indicate whether the B<debian/rules> file requires "
2935 "(fake)root privileges to run some of its targets, and if so when."
2936 msgstr ""
2938 #. type: textblock
2939 #: deb-src-control.pod
2940 msgid "The binary targets will not require (fake)root at all."
2941 msgstr ""
2943 #. type: =item
2944 #: deb-src-control.pod
2945 msgid "B<binary-targets>"
2946 msgstr ""
2948 #. type: textblock
2949 #: deb-src-control.pod
2950 msgid ""
2951 "The binary targets must always be run under (fake)root.  This value is the "
2952 "default when the field is omitted; adding the field with an explicit "
2953 "B<binary-targets> while not strictly needed, marks it as having been "
2954 "analyzed for this requirement."
2955 msgstr ""
2957 #. type: =item
2958 #: deb-src-control.pod
2959 msgid "I<impl-keywords>"
2960 msgstr ""
2962 #. type: textblock
2963 #: deb-src-control.pod
2964 msgid ""
2965 "This is a space-separated list of keywords which define when (fake)root is "
2966 "required."
2967 msgstr ""
2969 #. type: textblock
2970 #: deb-src-control.pod
2971 msgid ""
2972 "Keywords consist of I<namespace>/I<cases>.  The I<namespace> part cannot "
2973 "contain \"/\" or whitespace.  The I<cases> part cannot contain whitespace.  "
2974 "Furthermore, both parts must consist entirely of printable ASCII characters."
2975 msgstr ""
2977 #. type: textblock
2978 #: deb-src-control.pod
2979 msgid ""
2980 "Each tool/package will define a namespace named after itself and provide a "
2981 "number of cases where (fake)root is required.  (See \"Implementation "
2982 "provided keywords\" in I<rootless-builds.txt>)."
2983 msgstr ""
2985 #. type: textblock
2986 #: deb-src-control.pod
2987 msgid ""
2988 "When the field is set to one of the I<impl-keywords>, the builder will "
2989 "expose an interface that is used to run a command under (fake)root.  (See "
2990 "\"Gain Root API\" in I<rootless-builds.txt>.)"
2991 msgstr ""
2993 #. type: =item
2994 #: deb-src-control.pod dsc.pod
2995 msgid "B<Testsuite:> I<name-list>"
2996 msgstr ""
2998 #. type: =item
2999 #: deb-src-control.pod dsc.pod
3000 msgid "B<Testsuite-Triggers:> I<package-list>"
3001 msgstr ""
3003 #. type: textblock
3004 #: deb-src-control.pod
3005 msgid ""
3006 "These fields are described in the B<dsc>(5)  manual page, as they are "
3007 "generated from information inferred from B<debian/tests/control> or copied "
3008 "literally to the source control file."
3009 msgstr ""
3011 #. type: =item
3012 #: deb-src-control.pod dsc.pod
3013 msgid "B<Vcs-Arch:> I<url>"
3014 msgstr ""
3016 #. type: =item
3017 #: deb-src-control.pod dsc.pod
3018 msgid "B<Vcs-Bzr:> I<url>"
3019 msgstr ""
3021 #. type: =item
3022 #: deb-src-control.pod dsc.pod
3023 msgid "B<Vcs-Cvs:> I<url>"
3024 msgstr ""
3026 #. type: =item
3027 #: deb-src-control.pod dsc.pod
3028 msgid "B<Vcs-Darcs:> I<url>"
3029 msgstr ""
3031 #. type: =item
3032 #: deb-src-control.pod dsc.pod
3033 msgid "B<Vcs-Git:> I<url>"
3034 msgstr ""
3036 #. type: =item
3037 #: deb-src-control.pod dsc.pod
3038 msgid "B<Vcs-Hg:> I<url>"
3039 msgstr ""
3041 #. type: =item
3042 #: deb-src-control.pod dsc.pod
3043 msgid "B<Vcs-Mtn:> I<url>"
3044 msgstr ""
3046 #. type: =item
3047 #: deb-src-control.pod dsc.pod
3048 msgid "B<Vcs-Svn:> I<url>"
3049 msgstr ""
3051 #. type: textblock
3052 #: deb-src-control.pod
3053 msgid ""
3054 "The I<url> of the Version Control System repository used to maintain this "
3055 "package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, "
3056 "B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> "
3057 "(Subversion). Usually this field points to the latest version of the "
3058 "package, such as the main branch or the trunk."
3059 msgstr ""
3061 #. type: =item
3062 #: deb-src-control.pod dsc.pod
3063 msgid "B<Vcs-Browser:> I<url>"
3064 msgstr ""
3066 #. type: textblock
3067 #: deb-src-control.pod
3068 msgid ""
3069 "The I<url> of a webinterface to browse the Version Control System "
3070 "repository."
3071 msgstr ""
3073 #. type: textblock
3074 #: deb-src-control.pod
3075 msgid ""
3076 "The name of the distribution this package is originating from. This field is "
3077 "usually not needed."
3078 msgstr ""
3080 #. type: =item
3081 #: deb-src-control.pod dsc.pod
3082 msgid "B<Build-Depends:> I<package-list>"
3083 msgstr ""
3085 #. type: textblock
3086 #: deb-src-control.pod
3087 msgid ""
3088 "A list of packages that need to be installed and configured to be able to "
3089 "build from source package.  These dependencies need to be satisfied when "
3090 "building binary architecture dependent or independent packages and source "
3091 "packages.  Including a dependency in this field does not have the exact same "
3092 "effect as including it in both B<Build-Depends-Arch> and "
3093 "B<Build-Depends-Indep>, because the dependency also needs to be satisfied "
3094 "when building the source package."
3095 msgstr ""
3097 #. type: =item
3098 #: deb-src-control.pod dsc.pod
3099 msgid "B<Build-Depends-Arch:> I<package-list>"
3100 msgstr ""
3102 #. type: textblock
3103 #: deb-src-control.pod
3104 msgid ""
3105 "Same as B<Build-Depends>, but they are only needed when building the "
3106 "architecture dependent packages. The B<Build-Depends> are also installed in "
3107 "this case. This field is supported since dpkg 1.16.4; in order to build with "
3108 "older dpkg versions, B<Build-Depends> should be used instead."
3109 msgstr ""
3111 #. type: =item
3112 #: deb-src-control.pod dsc.pod
3113 msgid "B<Build-Depends-Indep:> I<package-list>"
3114 msgstr ""
3116 #. type: textblock
3117 #: deb-src-control.pod
3118 msgid ""
3119 "Same as B<Build-Depends>, but they are only needed when building the "
3120 "architecture independent packages. The B<Build-Depends> are also installed "
3121 "in this case."
3122 msgstr ""
3124 #. type: =item
3125 #: deb-src-control.pod dsc.pod
3126 msgid "B<Build-Conflicts:> I<package-list>"
3127 msgstr ""
3129 #. type: textblock
3130 #: deb-src-control.pod
3131 msgid ""
3132 "A list of packages that should not be installed when the package is built, "
3133 "for example because they interfere with the build system used.  Including a "
3134 "dependency in this list has the same effect as including it in both "
3135 "B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional "
3136 "effect of being used for source-only builds."
3137 msgstr ""
3139 #. type: =item
3140 #: deb-src-control.pod dsc.pod
3141 msgid "B<Build-Conflicts-Arch:> I<package-list>"
3142 msgstr ""
3144 #. type: textblock
3145 #: deb-src-control.pod
3146 msgid ""
3147 "Same as B<Build-Conflicts>, but only when building the architecture "
3148 "dependent packages. This field is supported since dpkg 1.16.4; in order to "
3149 "build with older dpkg versions, B<Build-Conflicts> should be used instead."
3150 msgstr ""
3152 #. type: =item
3153 #: deb-src-control.pod dsc.pod
3154 msgid "B<Build-Conflicts-Indep:> I<package-list>"
3155 msgstr ""
3157 #. type: textblock
3158 #: deb-src-control.pod
3159 msgid ""
3160 "Same as B<Build-Conflicts>, but only when building the architecture "
3161 "independent packages."
3162 msgstr ""
3164 #. type: textblock
3165 #: deb-src-control.pod
3166 msgid ""
3167 "The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and "
3168 "B<Build-Depends-Indep> fields is a list of groups of alternative packages.  "
3169 "Each group is a list of packages separated by vertical bar (or “pipe”)  "
3170 "symbols, ‘B<|>’.  The groups are separated by commas ‘B<,>’, and can end "
3171 "with a trailing comma that will be eliminated when generating the fields for "
3172 "B<deb-control>(5) (since dpkg 1.10.14).  Commas are to be read as “AND”, and "
3173 "pipes as “OR”, with pipes binding more tightly.  Each package name is "
3174 "optionally followed by an architecture qualifier appended after a colon "
3175 "‘B<:>’, optionally followed by a version number specification in parentheses "
3176 "‘B<(>’ and ‘B<)>’, an architecture specification in square brackets ‘B<[>’ "
3177 "and ‘B<]>’, and a restriction formula consisting of one or more lists of "
3178 "profile names in angle brackets ‘B<E<lt>>’ and ‘B<E<gt>>’."
3179 msgstr ""
3181 #. type: textblock
3182 #: deb-src-control.pod
3183 msgid ""
3184 "The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and "
3185 "B<Build-Conflicts-Indep> fields is a list of comma-separated package names, "
3186 "where the comma is read as an “AND”, and where the list can end with a "
3187 "trailing comma that will be eliminated when generating the fields for "
3188 "B<deb-control>(5)  (since dpkg 1.10.14).  Specifying alternative packages "
3189 "using a “pipe” is not supported.  Each package name is optionally followed "
3190 "by a version number specification in parentheses, an architecture "
3191 "specification in square brackets, and a restriction formula consisting of "
3192 "one or more lists of profile names in angle brackets."
3193 msgstr ""
3195 #. type: textblock
3196 #: deb-src-control.pod
3197 msgid ""
3198 "An architecture qualifier name can be a real Debian architecture name (since "
3199 "dpkg 1.16.5), B<any> (since dpkg 1.16.2) or B<native> (since dpkg 1.16.5).  "
3200 "If omitted, the default for B<Build-Depends> fields is the current host "
3201 "architecture, the default for B<Build-Conflicts> fields is B<any>.  A real "
3202 "Debian architecture name will match exactly that architecture for that "
3203 "package name, B<any> will match any architecture for that package name if "
3204 "the package is marked with B<Multi-Arch: allowed>, and B<native> will match "
3205 "the current build architecture if the package is not marked with "
3206 "B<Multi-Arch: foreign>."
3207 msgstr ""
3209 #. type: textblock
3210 #: deb-src-control.pod
3211 msgid ""
3212 "An architecture specification consists of one or more architecture names, "
3213 "separated by whitespace. Exclamation marks may be prepended to each of the "
3214 "names, meaning “NOT”."
3215 msgstr ""
3217 #. type: textblock
3218 #: deb-src-control.pod
3219 msgid ""
3220 "A restriction formula consists of one or more restriction lists, separated "
3221 "by whitespace. Each restriction list is enclosed in angle brackets. Items in "
3222 "the restriction list are build profile names, separated by whitespace and "
3223 "can be prefixed with an exclamation mark, meaning “NOT”.  A restriction "
3224 "formula represents a disjunctive normal form expression."
3225 msgstr ""
3227 #. type: textblock
3228 #: deb-src-control.pod
3229 msgid ""
3230 "Note that dependencies on packages in the B<build-essential> set can be "
3231 "omitted and that declaring build conflicts against them is impossible. A "
3232 "list of these packages is in the build-essential package."
3233 msgstr ""
3235 #. type: =head1
3236 #: deb-src-control.pod
3237 msgid "BINARY FIELDS"
3238 msgstr ""
3240 #. type: textblock
3241 #: deb-src-control.pod
3242 msgid ""
3243 "Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in "
3244 "a binary stanza to override the global value from the source package."
3245 msgstr ""
3247 #. type: =item
3248 #: deb-src-control.pod
3249 msgid "B<Package:> I<binary-package-name> (required)"
3250 msgstr ""
3252 #. type: textblock
3253 #: deb-src-control.pod
3254 msgid ""
3255 "This field is used to name the binary package name. The same restrictions as "
3256 "to a source package name apply."
3257 msgstr ""
3259 #. type: =item
3260 #: deb-src-control.pod
3261 msgid "B<Architecture:> I<arch>|B<all>|B<any> (required)"
3262 msgstr ""
3264 #. type: textblock
3265 #: deb-src-control.pod
3266 msgid ""
3267 "The architecture specifies on which type of hardware this package runs. For "
3268 "packages that run on all architectures, use the B<any> value. For packages "
3269 "that are architecture independent, such as shell and Perl scripts or "
3270 "documentation, use the B<all> value. To restrict the packages to a certain "
3271 "set of architectures, specify the architecture names, separated by a "
3272 "space. It's also possible to put architecture wildcards in that list (see "
3273 "B<dpkg-architecture>(1)  for more information about them)."
3274 msgstr ""
3276 #. type: =item
3277 #: deb-src-control.pod
3278 msgid "B<Build-Profiles:> I<restriction-formula>"
3279 msgstr ""
3281 #. type: textblock
3282 #: deb-src-control.pod
3283 msgid ""
3284 "This field specifies the conditions for which this binary package does or "
3285 "does not build.  To express that condition, the same restriction formula "
3286 "syntax from the B<Build-Depends> field is used (including the angle "
3287 "brackets)."
3288 msgstr ""
3290 #. type: textblock
3291 #: deb-src-control.pod
3292 msgid ""
3293 "If a binary package stanza does not contain this field, then it implicitly "
3294 "means that it builds with all build profiles (including none at all)."
3295 msgstr ""
3297 #. type: textblock
3298 #: deb-src-control.pod
3299 msgid ""
3300 "In other words, if a binary package stanza is annotated with a non-empty "
3301 "B<Build-Profiles> field, then this binary package is generated if and only "
3302 "if the condition expressed by the conjunctive normal form expression "
3303 "evaluates to true."
3304 msgstr ""
3306 #. type: =item
3307 #: deb-src-control.pod
3308 msgid "B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>"
3309 msgstr ""
3311 #. type: textblock
3312 #: deb-src-control.pod
3313 msgid ""
3314 "These fields are described in the B<deb-control>(5)  manual page, as they "
3315 "are copied literally to the control file of the binary package."
3316 msgstr ""
3318 #. type: textblock
3319 #: deb-src-control.pod
3320 msgid ""
3321 "These fields declare relationships between packages. They are discussed in "
3322 "the B<deb-control>(5)  manpage.  When these fields are found in "
3323 "I<debian/control> they can also end with a trailing comma (since dpkg "
3324 "1.10.14), have architecture specifications and restriction formulas which "
3325 "will all get reduced when generating the fields for B<deb-control>(5)."
3326 msgstr ""
3328 #. type: textblock
3329 #: deb-src-control.pod
3330 msgid ""
3331 "These fields are used by the debian-installer in B<udeb>s and are usually "
3332 "not needed.  For more details about them, see "
3333 "L<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>."
3334 msgstr ""
3336 #. type: =head1
3337 #: deb-src-control.pod
3338 msgid "USER-DEFINED FIELDS"
3339 msgstr ""
3341 #. type: textblock
3342 #: deb-src-control.pod
3343 msgid ""
3344 "It is allowed to add additional user-defined fields to the control file. The "
3345 "tools will ignore these fields. If you want the fields to be copied over to "
3346 "the output files, such as the binary packages, you need to use a custom "
3347 "naming scheme: the fields should start with an B<X>, followed by zero or "
3348 "more of the letters B<SBC> and a hyphen."
3349 msgstr ""
3351 #. type: =item
3352 #: deb-src-control.pod
3353 msgid "B<S>"
3354 msgstr ""
3356 #. type: textblock
3357 #: deb-src-control.pod
3358 msgid "The field will appear in the source package control file, see B<dsc>(5)."
3359 msgstr ""
3361 #. type: =item
3362 #: deb-src-control.pod
3363 msgid "B<B>"
3364 msgstr ""
3366 #. type: textblock
3367 #: deb-src-control.pod
3368 msgid ""
3369 "The field will appear in the control file in the binary package, see "
3370 "B<deb-control>(5)."
3371 msgstr ""
3373 #. type: =item
3374 #: deb-src-control.pod
3375 msgid "B<C>"
3376 msgstr ""
3378 #. type: textblock
3379 #: deb-src-control.pod
3380 msgid ""
3381 "The field will appear in the upload control (.changes) file, see "
3382 "B<deb-changes>(5)."
3383 msgstr ""
3385 #. type: textblock
3386 #: deb-src-control.pod
3387 msgid ""
3388 "Note that the B<X>[B<SBC>]B<-> prefixes are stripped when the fields are "
3389 "copied over to the output files. A field B<XC-Approved-By> will appear as "
3390 "B<Approved-By> in the changes file and will not appear in the binary or "
3391 "source package control files."
3392 msgstr ""
3394 #. type: textblock
3395 #: deb-src-control.pod
3396 msgid ""
3397 "Take into account that these user-defined fields will be using the global "
3398 "namespace, which might at some point in the future collide with officially "
3399 "recognized fields. To avoid such potential situation you can prefix those "
3400 "fields with B<Private->, such as B<XB-Private-New-Field>."
3401 msgstr ""
3403 #. type: verbatim
3404 #: deb-src-control.pod
3405 #, no-wrap
3406 msgid ""
3407 " # Comment\n"
3408 " Source: dpkg\n"
3409 " Section: admin\n"
3410 " Priority: required\n"
3411 " Maintainer: Dpkg Developers <debian-dpkg@lists.debian.org>\n"
3412 " # this field is copied to the binary and source packages\n"
3413 " XBS-Upstream-Release-Status: stable\n"
3414 " Homepage: https://wiki.debian.org/Teams/Dpkg\n"
3415 " Vcs-Browser: https://git.dpkg.org/cgit/dpkg/dpkg.git\n"
3416 " Vcs-Git: https://git.dpkg.org/git/dpkg/dpkg.git\n"
3417 " Standards-Version: 3.7.3\n"
3418 " Build-Depends: pkg-config, debhelper (>= 4.1.81),\n"
3419 "  libselinux1-dev (>= 1.28-4) [!linux-any]\n"
3420 "\n"
3421 msgstr ""
3423 #. type: verbatim
3424 #: deb-src-control.pod
3425 #, no-wrap
3426 msgid ""
3427 " Package: dpkg-dev\n"
3428 " Section: utils\n"
3429 " Priority: optional\n"
3430 " Architecture: all\n"
3431 " # this is a custom field in the binary package\n"
3432 " XB-Mentoring-Contact: Raphael Hertzog <hertzog@debian.org>\n"
3433 " Depends: dpkg (>= 1.14.6), perl5, perl-modules, cpio (>= 2.4.2-2),\n"
3434 "  bzip2, lzma, patch (>= 2.2-1), make, binutils, libtimedate-perl\n"
3435 " Recommends: gcc | c-compiler, build-essential\n"
3436 " Suggests: gnupg, debian-keyring\n"
3437 " Conflicts: dpkg-cross (<< 2.0.0), devscripts (<< 2.10.26)\n"
3438 " Replaces: manpages-pl (<= 20051117-1)\n"
3439 " Description: Debian package development tools\n"
3440 "  This package provides the development tools (including dpkg-source)\n"
3441 "  required to unpack, build and upload Debian source packages.\n"
3442 "  .\n"
3443 "  Most Debian source packages will require additional tools to build;\n"
3444 "  for example, most packages need make and the C compiler gcc.\n"
3445 "\n"
3446 msgstr ""
3448 #. type: textblock
3449 #: deb-src-control.pod
3450 msgid ""
3451 "I<%PKGDOCDIR%/spec/rootless-builds.txt>, L<deb822(5)>, B<deb-control>(5), "
3452 "B<deb-version>(7), B<dpkg-source>(1)"
3453 msgstr ""
3455 #. type: textblock
3456 #: deb-src-files.pod
3457 msgid "deb-src-files - Debian distribute files format"
3458 msgstr ""
3460 #. type: =item
3461 #: deb-src-files.pod dpkg-distaddfile.pod dpkg-genbuildinfo.pod
3462 #: dpkg-genchanges.pod dpkg-gencontrol.pod
3463 msgid "B<debian/files>"
3464 msgstr ""
3466 #. type: textblock
3467 #: deb-src-files.pod
3468 msgid ""
3469 "This file contains the list of artifacts that are to be distributed via the "
3470 "B<.changes> control file."
3471 msgstr ""
3473 #. type: textblock
3474 #: deb-src-files.pod
3475 msgid "The I<debian/files> file has a simple whitespace-delimited format."
3476 msgstr ""
3478 #. type: textblock
3479 #: deb-src-files.pod
3480 msgid "I<filename> I<section> I<priority> [ I<keyword=value...> ]"
3481 msgstr ""
3483 #. type: textblock
3484 #: deb-src-files.pod
3485 msgid "I<filename> is the name of the artifact to distribute."
3486 msgstr ""
3488 #. type: textblock
3489 #: deb-src-files.pod
3490 msgid ""
3491 "I<section> and I<priority> correspond to the respective control fields "
3492 "available in the .deb.  The allowed values are specific to each distribution "
3493 "archive."
3494 msgstr ""
3496 #. type: textblock
3497 #: deb-src-files.pod
3498 msgid ""
3499 "I<keyword=value...> corresponds to an optional whitespace-delimited list of "
3500 "attributes for this entry.  The only currently supported keyword is "
3501 "B<automatic> with value B<yes>, to mark automatically generated files."
3502 msgstr ""
3504 #. type: =head1
3505 #: deb-src-files.pod deb-version.pod dpkg-architecture.pod
3506 #: dpkg-buildpackage.pod dpkg-deb.pod dpkg-divert.pod dpkg-parsechangelog.pod
3507 msgid "NOTES"
3508 msgstr ""
3510 #. type: textblock
3511 #: deb-src-files.pod
3512 msgid ""
3513 "This file is not intended to be modified directly, please use one of "
3514 "B<dpkg-gencontrol> or B<dpkg-distaddfile> to add entries to it."
3515 msgstr ""
3517 #. type: textblock
3518 #: deb-src-files.pod
3519 msgid "B<dpkg-genchanges>(1), B<dpkg-distaddfile>(1)."
3520 msgstr ""
3522 #. type: textblock
3523 #: deb-src-rules.pod
3524 msgid "deb-src-rules - Debian source package rules file"
3525 msgstr ""
3527 #. type: textblock
3528 #: deb-src-rules.pod
3529 msgid "B<debian/rules>"
3530 msgstr ""
3532 #. type: textblock
3533 #: deb-src-rules.pod
3534 msgid ""
3535 "This file contains the instructions necessary to build the binary packages "
3536 "from the source package."
3537 msgstr ""
3539 #. type: textblock
3540 #: deb-src-rules.pod
3541 msgid ""
3542 "The I<debian/rules> file is an executable Makefile, with a shebang that is "
3543 "usually set to \"#!/usr/bin/make -f\"."
3544 msgstr ""
3546 #. type: textblock
3547 #: deb-src-rules.pod
3548 msgid "It must support the following make targets:"
3549 msgstr ""
3551 #. type: =item
3552 #: deb-src-rules.pod
3553 msgid "B<clean>"
3554 msgstr ""
3556 #. type: textblock
3557 #: deb-src-rules.pod
3558 msgid ""
3559 "Clean up the source tree, by undoing any change done by any of the build and "
3560 "binary targets.  This target will be called with root privileges."
3561 msgstr ""
3563 #. type: =item
3564 #: deb-src-rules.pod
3565 msgid "B<build-indep>"
3566 msgstr ""
3568 #. type: textblock
3569 #: deb-src-rules.pod
3570 msgid ""
3571 "Build architecture independent files required to build any architecture "
3572 "independent binary package.  If there are no architecture independent binary "
3573 "packages to generate, the target must still exist but do nothing.  This "
3574 "target must not require root privileges."
3575 msgstr ""
3577 #. type: =item
3578 #: deb-src-rules.pod
3579 msgid "B<build-arch>"
3580 msgstr ""
3582 #. type: textblock
3583 #: deb-src-rules.pod
3584 msgid ""
3585 "Build architecture dependent files required to build any architecture "
3586 "dependent binary package.  If there are no architecture dependent binary "
3587 "packages to generate, the target must still exist but do nothing.  This "
3588 "target must not require root privileges."
3589 msgstr ""
3591 #. type: =item
3592 #: deb-src-rules.pod
3593 msgid "B<build>"
3594 msgstr ""
3596 #. type: textblock
3597 #: deb-src-rules.pod
3598 msgid ""
3599 "Build architecture independent and dependent files, either by depending (at "
3600 "least transitively) on B<build-indep> and/or B<build-arch> or by inlining "
3601 "what those targets would do.  This target must not require root privileges."
3602 msgstr ""
3604 #. type: =item
3605 #: deb-src-rules.pod
3606 msgid "B<binary-indep>"
3607 msgstr ""
3609 #. type: textblock
3610 #: deb-src-rules.pod
3611 msgid ""
3612 "Build architecture independent binary packages.  This target must depend (at "
3613 "least transitively) on either B<build-indep> or B<build>.  This target will "
3614 "be called with root privileges."
3615 msgstr ""
3617 #. type: =item
3618 #: deb-src-rules.pod
3619 msgid "B<binary-arch>"
3620 msgstr ""
3622 #. type: textblock
3623 #: deb-src-rules.pod
3624 msgid ""
3625 "Build architecture dependent binary packages.  This target must depend (at "
3626 "least transitively) on either B<build-arch> or B<build>.  This target will "
3627 "be called with root privileges."
3628 msgstr ""
3630 #. type: =item
3631 #: deb-src-rules.pod dpkg-buildpackage.pod dpkg-genbuildinfo.pod
3632 #: dpkg-genchanges.pod
3633 msgid "B<binary>"
3634 msgstr ""
3636 #. type: textblock
3637 #: deb-src-rules.pod
3638 msgid ""
3639 "Build architecture independent and dependent binary packages, either by "
3640 "depending (at least transitively) on B<binary-indep> and/or B<binary-arch> "
3641 "or by inlining what those targets would do.  This target will be called with "
3642 "root privileges."
3643 msgstr ""
3645 #. type: textblock
3646 #: deb-src-rules.pod
3647 msgid ""
3648 "B<dpkg-architecture>(1), B<dpkg-vendor>(1), B<dpkg-buildflags>(1), "
3649 "B<dpkg-parsechangelog>(1), B<dpkg-shlibdeps>(1), B<dpkg-gencontrol>(1), "
3650 "B<dpkg-deb>(1), B<dpkg-distaddfile>(1)."
3651 msgstr ""
3653 #. type: textblock
3654 #: deb-src-symbols.pod
3655 msgid "deb-src-symbols - Debian's extended shared library template file"
3656 msgstr ""
3658 #. type: textblock
3659 #: deb-src-symbols.pod
3660 msgid ""
3661 "B<debian/>I<package>B<.symbols.>I<arch>, B<debian/symbols.>I<arch>, "
3662 "B<debian/>I<package>B<.symbols>, B<debian/symbols>"
3663 msgstr ""
3665 #. type: textblock
3666 #: deb-src-symbols.pod
3667 msgid ""
3668 "The symbol file templates are shipped in Debian source packages, and its "
3669 "format is a superset of the symbols files shipped in binary packages, see "
3670 "L<deb-symbols(5)>."
3671 msgstr ""
3673 #. type: =head2
3674 #: deb-src-symbols.pod
3675 msgid "Comments"
3676 msgstr ""
3678 #. type: textblock
3679 #: deb-src-symbols.pod
3680 msgid ""
3681 "Comments are supported in template symbol files. Any line with ‘#’ as the "
3682 "first character is a comment except if it starts with ‘#include’ (see "
3683 "section B<Using includes>).  Lines starting with ‘#MISSING:’ are special "
3684 "comments documenting symbols that have disappeared."
3685 msgstr ""
3687 #. type: =head2
3688 #: deb-src-symbols.pod
3689 msgid "Using #PACKAGE# substitution"
3690 msgstr ""
3692 #. type: textblock
3693 #: deb-src-symbols.pod
3694 msgid ""
3695 "In some rare cases, the name of the library varies between architectures.  "
3696 "To avoid hardcoding the name of the package in the symbols file, you can use "
3697 "the marker I<#PACKAGE#>. It will be replaced by the real package name during "
3698 "installation of the symbols files. Contrary to the I<#MINVER#> marker, "
3699 "I<#PACKAGE#> will never appear in a symbols file inside a binary package."
3700 msgstr ""
3702 #. type: =head2
3703 #: deb-src-symbols.pod
3704 msgid "Using symbol tags"
3705 msgstr ""
3707 #. type: textblock
3708 #: deb-src-symbols.pod
3709 msgid ""
3710 "Symbol tagging is useful for marking symbols that are special in some way.  "
3711 "Any symbol can have an arbitrary number of tags associated with it. While "
3712 "all tags are parsed and stored, only some of them are understood by "
3713 "B<dpkg-gensymbols> and trigger special handling of the symbols. See "
3714 "subsection B<Standard symbol tags> for reference of these tags."
3715 msgstr ""
3717 #. type: textblock
3718 #: deb-src-symbols.pod
3719 msgid ""
3720 "Tag specification comes right before the symbol name (no whitespace is "
3721 "allowed in between). It always starts with an opening bracket B<(>, ends "
3722 "with a closing bracket B<)> and must contain at least one tag. Multiple tags "
3723 "are separated by the B<|> character. Each tag can optionally have a value "
3724 "which is separated form the tag name by the B<=> character. Tag names and "
3725 "values can be arbitrary strings except they cannot contain any of the "
3726 "special B<)> B<|> B<=> characters. Symbol names following a tag "
3727 "specification can optionally be quoted with either B<'> or B<\"> characters "
3728 "to allow whitespaces in them. However, if there are no tags specified for "
3729 "the symbol, quotes are treated as part of the symbol name which continues up "
3730 "until the first space."
3731 msgstr ""
3733 #. type: verbatim
3734 #: deb-src-symbols.pod
3735 #, no-wrap
3736 msgid ""
3737 "  (tag1=i am marked|tag name with space)\"tagged quoted symbol\"@Base 1.0\n"
3738 "  (optional)tagged_unquoted_symbol@Base 1.0 1\n"
3739 "  untagged_symbol@Base 1.0\n"
3740 "\n"
3741 msgstr ""
3743 #. type: textblock
3744 #: deb-src-symbols.pod
3745 msgid ""
3746 "The first symbol in the example is named I<tagged quoted symbol> and has two "
3747 "tags: I<tag1> with value I<i am marked> and I<tag name with space> that has "
3748 "no value. The second symbol named I<tagged_unquoted_symbol> is only tagged "
3749 "with the tag named I<optional>. The last symbol is an example of the normal "
3750 "untagged symbol."
3751 msgstr ""
3753 #. type: textblock
3754 #: deb-src-symbols.pod
3755 msgid ""
3756 "Since symbol tags are an extension of the B<deb-symbols>(5) format, they can "
3757 "only be part of the symbols files used in source packages (those files "
3758 "should then be seen as templates used to build the symbols files that are "
3759 "embedded in binary packages). When B<dpkg-gensymbols> is called without the "
3760 "B<-t> option, it will output symbols files compatible to the "
3761 "B<deb-symbols>(5) format: it fully processes symbols according to the "
3762 "requirements of their standard tags and strips all tags from the output. On "
3763 "the contrary, in template mode (B<-t>) all symbols and their tags (both "
3764 "standard and unknown ones)  are kept in the output and are written in their "
3765 "original form as they were loaded."
3766 msgstr ""
3768 #. type: =head2
3769 #: deb-src-symbols.pod
3770 msgid "Standard symbol tags"
3771 msgstr ""
3773 #. type: =item
3774 #: deb-src-symbols.pod
3775 msgid "B<optional>"
3776 msgstr ""
3778 #. type: textblock
3779 #: deb-src-symbols.pod
3780 msgid ""
3781 "A symbol marked as optional can disappear from the library at any time and "
3782 "that will never cause B<dpkg-gensymbols> to fail. However, disappeared "
3783 "optional symbols will continuously appear as MISSING in the diff in each new "
3784 "package revision.  This behaviour serves as a reminder for the maintainer "
3785 "that such a symbol needs to be removed from the symbol file or readded to "
3786 "the library. When the optional symbol, which was previously declared as "
3787 "MISSING, suddenly reappears in the next revision, it will be upgraded back "
3788 "to the “existing” status with its minimum version unchanged."
3789 msgstr ""
3791 #. type: textblock
3792 #: deb-src-symbols.pod
3793 msgid ""
3794 "This tag is useful for symbols which are private where their disappearance "
3795 "do not cause ABI breakage. For example, most of C++ template instantiations "
3796 "fall into this category. Like any other tag, this one may also have an "
3797 "arbitrary value: it could be used to indicate why the symbol is considered "
3798 "optional."
3799 msgstr ""
3801 #. type: =item
3802 #: deb-src-symbols.pod
3803 msgid "B<arch=>I<architecture-list>"
3804 msgstr ""
3806 #. type: =item
3807 #: deb-src-symbols.pod
3808 msgid "B<arch-bits=>I<architecture-bits>"
3809 msgstr ""
3811 #. type: =item
3812 #: deb-src-symbols.pod
3813 msgid "B<arch-endian=>I<architecture-endianness>"
3814 msgstr ""
3816 #. type: textblock
3817 #: deb-src-symbols.pod
3818 msgid ""
3819 "These tags allow one to restrict the set of architectures where the symbol "
3820 "is supposed to exist. The B<arch-bits> and B<arch-endian> tags are supported "
3821 "since dpkg 1.18.0. When the symbols list is updated with the symbols "
3822 "discovered in the library, all arch-specific symbols which do not concern "
3823 "the current host architecture are treated as if they did not exist. If an "
3824 "arch-specific symbol matching the current host architecture does not exist "
3825 "in the library, normal procedures for missing symbols apply and it may cause "
3826 "B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol "
3827 "is found when it was not supposed to exist (because the current host "
3828 "architecture is not listed in the tag or does not match the endianness and "
3829 "bits), it is made arch neutral (i.e. the arch, arch-bits and arch-endian "
3830 "tags are dropped and the symbol will appear in the diff due to this change), "
3831 "but it is not considered as new."
3832 msgstr ""
3834 #. type: textblock
3835 #: deb-src-symbols.pod
3836 msgid ""
3837 "When operating in the default non-template mode, among arch-specific symbols "
3838 "only those that match the current host architecture are written to the "
3839 "symbols file. On the contrary, all arch-specific symbols (including those "
3840 "from foreign arches) are always written to the symbol file when operating in "
3841 "template mode."
3842 msgstr ""
3844 #. type: textblock
3845 #: deb-src-symbols.pod
3846 msgid ""
3847 "The format of I<architecture-list> is the same as the one used in the "
3848 "B<Build-Depends> field of I<debian/control> (except the enclosing square "
3849 "brackets []). For example, the first symbol from the list below will be "
3850 "considered only on alpha, any-amd64 and ia64 architectures, the second only "
3851 "on linux architectures, while the third one anywhere except on armel."
3852 msgstr ""
3854 #. type: verbatim
3855 #: deb-src-symbols.pod
3856 #, no-wrap
3857 msgid ""
3858 "  (arch=alpha any-amd64 ia64)64bit_specific_symbol@Base 1.0\n"
3859 "  (arch=linux-any)linux_specific_symbol@Base 1.0\n"
3860 "  (arch=!armel)symbol_armel_does_not_have@Base 1.0\n"
3861 "\n"
3862 msgstr ""
3864 #. type: textblock
3865 #: deb-src-symbols.pod
3866 msgid "The I<architecture-bits> is either B<32> or B<64>."
3867 msgstr ""
3869 #. type: verbatim
3870 #: deb-src-symbols.pod
3871 #, no-wrap
3872 msgid ""
3873 "  (arch-bits=32)32bit_specific_symbol@Base 1.0\n"
3874 "  (arch-bits=64)64bit_specific_symbol@Base 1.0\n"
3875 "\n"
3876 msgstr ""
3878 #. type: textblock
3879 #: deb-src-symbols.pod
3880 msgid "The I<architecture-endianness> is either B<little> or B<big>."
3881 msgstr ""
3883 #. type: verbatim
3884 #: deb-src-symbols.pod
3885 #, no-wrap
3886 msgid ""
3887 "  (arch-endian=little)little_endian_specific_symbol@Base 1.0\n"
3888 "  (arch-endian=big)big_endian_specific_symbol@Base 1.0\n"
3889 "\n"
3890 msgstr ""
3892 #. type: textblock
3893 #: deb-src-symbols.pod
3894 msgid "Multiple restrictions can be chained."
3895 msgstr ""
3897 #. type: verbatim
3898 #: deb-src-symbols.pod
3899 #, no-wrap
3900 msgid ""
3901 "  (arch-bits=32|arch-endian=little)32bit_le_symbol@Base 1.0\n"
3902 "\n"
3903 msgstr ""
3905 #. type: =item
3906 #: deb-src-symbols.pod
3907 msgid "B<allow-internal>"
3908 msgstr ""
3910 #. type: textblock
3911 #: deb-src-symbols.pod
3912 msgid ""
3913 "dpkg-gensymbols has a list of internal symbols that should not appear in "
3914 "symbols files as they are usually only side-effects of implementation "
3915 "details of the toolchain (since dpkg 1.20.1).  If for some reason, you "
3916 "really want one of those symbols to be included in the symbols file, you "
3917 "should tag the symbol with B<allow-internal>.  It can be necessary for some "
3918 "low level toolchain libraries like “libgcc”."
3919 msgstr ""
3921 #. type: =item
3922 #: deb-src-symbols.pod
3923 msgid "B<ignore-blacklist>"
3924 msgstr ""
3926 #. type: textblock
3927 #: deb-src-symbols.pod
3928 msgid ""
3929 "A deprecated alias for B<allow-internal> (since dpkg 1.20.1, supported since "
3930 "dpkg 1.15.3)."
3931 msgstr ""
3933 #. type: =item
3934 #: deb-src-symbols.pod
3935 msgid "B<c++>"
3936 msgstr ""
3938 #. type: textblock
3939 #: deb-src-symbols.pod
3940 msgid ""
3941 "Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection "
3942 "below."
3943 msgstr ""
3945 #. type: =item
3946 #: deb-src-symbols.pod
3947 msgid "B<symver>"
3948 msgstr ""
3950 #. type: textblock
3951 #: deb-src-symbols.pod
3952 msgid ""
3953 "Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol "
3954 "patterns> subsection below."
3955 msgstr ""
3957 #. type: =item
3958 #: deb-src-symbols.pod
3959 msgid "B<regex>"
3960 msgstr ""
3962 #. type: textblock
3963 #: deb-src-symbols.pod
3964 msgid ""
3965 "Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection "
3966 "below."
3967 msgstr ""
3969 #. type: =head2
3970 #: deb-src-symbols.pod
3971 msgid "Using symbol patterns"
3972 msgstr ""
3974 #. type: textblock
3975 #: deb-src-symbols.pod
3976 msgid ""
3977 "Unlike a standard symbol specification, a pattern may cover multiple real "
3978 "symbols from the library. B<dpkg-gensymbols> will attempt to match each "
3979 "pattern against each real symbol that does I<not> have a specific symbol "
3980 "counterpart defined in the symbol file. Whenever the first matching pattern "
3981 "is found, all its tags and properties will be used as a basis specification "
3982 "of the symbol. If none of the patterns matches, the symbol will be "
3983 "considered as new."
3984 msgstr ""
3986 #. type: textblock
3987 #: deb-src-symbols.pod
3988 msgid ""
3989 "A pattern is considered lost if it does not match any symbol in the "
3990 "library. By default this will trigger a B<dpkg-gensymbols> failure under "
3991 "B<-c1> or higher level. However, if the failure is undesired, the pattern "
3992 "may be marked with the I<optional> tag. Then if the pattern does not match "
3993 "anything, it will only appear in the diff as MISSING. Moreover, like any "
3994 "symbol, the pattern may be limited to the specific architectures with the "
3995 "I<arch> tag. Please refer to B<Standard symbol tags> subsection above for "
3996 "more information."
3997 msgstr ""
3999 #. type: textblock
4000 #: deb-src-symbols.pod
4001 msgid ""
4002 "Patterns are an extension of the B<deb-symbols>(5) format hence they are "
4003 "only valid in symbol file templates. Pattern specification syntax is not any "
4004 "different from the one of a specific symbol. However, symbol name part of "
4005 "the specification serves as an expression to be matched against "
4006 "I<name@version> of the real symbol. In order to distinguish among different "
4007 "pattern types, a pattern will typically be tagged with a special tag."
4008 msgstr ""
4010 #. type: textblock
4011 #: deb-src-symbols.pod
4012 msgid "At the moment, B<dpkg-gensymbols> supports three basic pattern types:"
4013 msgstr ""
4015 #. type: textblock
4016 #: deb-src-symbols.pod
4017 msgid ""
4018 "This pattern is denoted by the I<c++> tag. It matches only C++ symbols by "
4019 "their demangled symbol name (as emitted by B<c++filt>(1) utility). This "
4020 "pattern is very handy for matching symbols which mangled names might vary "
4021 "across different architectures while their demangled names remain the "
4022 "same. One group of such symbols is I<non-virtual thunks> which have "
4023 "architecture specific offsets embedded in their mangled names. A common "
4024 "instance of this case is a virtual destructor which under diamond "
4025 "inheritance needs a non-virtual thunk symbol. For example, even if "
4026 "_ZThn8_N3NSB6ClassDD1Ev@Base on 32bit architectures will probably be "
4027 "_ZThn16_N3NSB6ClassDD1Ev@Base on 64bit ones, it can be matched with a single "
4028 "I<c++> pattern:"
4029 msgstr ""
4031 #. type: verbatim
4032 #: deb-src-symbols.pod
4033 #, no-wrap
4034 msgid ""
4035 " libdummy.so.1 libdummy1 #MINVER#\n"
4036 "  [...]\n"
4037 "  (c++)\"non-virtual thunk to NSB::ClassD::~ClassD()@Base\" 1.0\n"
4038 "  [...]\n"
4039 "\n"
4040 msgstr ""
4042 #. type: textblock
4043 #: deb-src-symbols.pod
4044 msgid "The demangled name above can be obtained by executing the following command:"
4045 msgstr ""
4047 #. type: verbatim
4048 #: deb-src-symbols.pod
4049 #, no-wrap
4050 msgid ""
4051 "  $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt\n"
4052 "\n"
4053 msgstr ""
4055 #. type: textblock
4056 #: deb-src-symbols.pod
4057 msgid ""
4058 "Please note that while mangled name is unique in the library by definition, "
4059 "this is not necessarily true for demangled names. A couple of distinct real "
4060 "symbols may have the same demangled name. For example, that's the case with "
4061 "non-virtual thunk symbols in complex inheritance configurations or with most "
4062 "constructors and destructors (since g++ typically generates two real symbols "
4063 "for them). However, as these collisions happen on the ABI level, they should "
4064 "not degrade quality of the symbol file."
4065 msgstr ""
4067 #. type: textblock
4068 #: deb-src-symbols.pod
4069 msgid ""
4070 "This pattern is denoted by the I<symver> tag. Well maintained libraries have "
4071 "versioned symbols where each version corresponds to the upstream version "
4072 "where the symbol got added. If that's the case, you can use a I<symver> "
4073 "pattern to match any symbol associated to the specific version. For example:"
4074 msgstr ""
4076 #. type: verbatim
4077 #: deb-src-symbols.pod
4078 #, no-wrap
4079 msgid ""
4080 " libc.so.6 libc6 #MINVER#\n"
4081 "  (symver)GLIBC_2.0 2.0\n"
4082 "  [...]\n"
4083 "  (symver)GLIBC_2.7 2.7\n"
4084 "  access@GLIBC_2.0 2.2\n"
4085 "\n"
4086 msgstr ""
4088 #. type: textblock
4089 #: deb-src-symbols.pod
4090 msgid ""
4091 "All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to "
4092 "minimal version of 2.0 and 2.7 respectively with the exception of the symbol "
4093 "access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 "
4094 "version 2.2 despite being in the scope of the \"(symver)GLIBC_2.0\" pattern "
4095 "because specific symbols take precedence over patterns."
4096 msgstr ""
4098 #. type: textblock
4099 #: deb-src-symbols.pod
4100 msgid ""
4101 "Please note that while old style wildcard patterns (denoted by \"*@version\" "
4102 "in the symbol name field) are still supported, they have been deprecated by "
4103 "new style syntax \"(symver|optional)version\". For example, \"*@GLIBC_2.0 "
4104 "2.0\" should be written as \"(symver|optional)GLIBC_2.0 2.0\" if the same "
4105 "behaviour is needed."
4106 msgstr ""
4108 #. type: textblock
4109 #: deb-src-symbols.pod
4110 msgid ""
4111 "Regular expression patterns are denoted by the I<regex> tag. They match by "
4112 "the perl regular expression specified in the symbol name field. A regular "
4113 "expression is matched as it is, therefore do not forget to start it with the "
4114 "I<^> character or it may match any part of the real symbol I<name@version> "
4115 "string. For example:"
4116 msgstr ""
4118 #. type: verbatim
4119 #: deb-src-symbols.pod
4120 #, no-wrap
4121 msgid ""
4122 " libdummy.so.1 libdummy1 #MINVER#\n"
4123 "  (regex)\"^mystack_.*@Base$\" 1.0\n"
4124 "  (regex|optional)\"private\" 1.0\n"
4125 "\n"
4126 msgstr ""
4128 #. type: textblock
4129 #: deb-src-symbols.pod
4130 msgid ""
4131 "Symbols like \"mystack_new@Base\", \"mystack_push@Base\", "
4132 "\"mystack_pop@Base\", etc., will be matched by the first pattern while "
4133 "\"ng_mystack_new@Base\" would not.  The second pattern will match all "
4134 "symbols having the string \"private\" in their names and matches will "
4135 "inherit I<optional> tag from the pattern."
4136 msgstr ""
4138 #. type: textblock
4139 #: deb-src-symbols.pod
4140 msgid ""
4141 "Basic patterns listed above can be combined where it makes sense. In that "
4142 "case, they are processed in the order in which the tags are specified. For "
4143 "example, both:"
4144 msgstr ""
4146 #. type: verbatim
4147 #: deb-src-symbols.pod
4148 #, no-wrap
4149 msgid ""
4150 "  (c++|regex)\"^NSA::ClassA::Private::privmethod\\d\\(int\\)@Base\" 1.0\n"
4151 "  (regex|c++)N3NSA6ClassA7Private11privmethod\\dEi@Base 1.0\n"
4152 "\n"
4153 msgstr ""
4155 #. type: textblock
4156 #: deb-src-symbols.pod
4157 msgid ""
4158 "will match symbols \"_ZN3NSA6ClassA7Private11privmethod1Ei@Base\" and "
4159 "\"_ZN3NSA6ClassA7Private11privmethod2Ei@Base\". When matching the first "
4160 "pattern, the raw symbol is first demangled as C++ symbol, then the demangled "
4161 "name is matched against the regular expression. On the other hand, when "
4162 "matching the second pattern, regular expression is matched against the raw "
4163 "symbol name, then the symbol is tested if it is C++ one by attempting to "
4164 "demangle it. A failure of any basic pattern will result in the failure of "
4165 "the whole pattern.  Therefore, for example, "
4166 "\"__N3NSA6ClassA7Private11privmethod\\dEi@Base\" will not match either of "
4167 "the patterns because it is not a valid C++ symbol."
4168 msgstr ""
4170 #. type: textblock
4171 #: deb-src-symbols.pod
4172 msgid ""
4173 "In general, all patterns are divided into two groups: aliases (basic I<c++> "
4174 "and I<symver>) and generic patterns (I<regex>, all combinations of multiple "
4175 "basic patterns). Matching of basic alias-based patterns is fast (O(1))  "
4176 "while generic patterns are O(N) (N - generic pattern count) for each "
4177 "symbol.  Therefore, it is recommended not to overuse generic patterns."
4178 msgstr ""
4180 #. type: textblock
4181 #: deb-src-symbols.pod
4182 msgid ""
4183 "When multiple patterns match the same real symbol, aliases (first I<c++>, "
4184 "then I<symver>) are preferred over generic patterns. Generic patterns are "
4185 "matched in the order they are found in the symbol file template until the "
4186 "first success.  Please note, however, that manual reordering of template "
4187 "file entries is not recommended because B<dpkg-gensymbols> generates diffs "
4188 "based on the alphanumerical order of their names."
4189 msgstr ""
4191 #. type: =head2
4192 #: deb-src-symbols.pod
4193 msgid "Using includes"
4194 msgstr ""
4196 #. type: textblock
4197 #: deb-src-symbols.pod
4198 msgid ""
4199 "When the set of exported symbols differ between architectures, it may become "
4200 "inefficient to use a single symbol file. In those cases, an include "
4201 "directive may prove to be useful in a couple of ways:"
4202 msgstr ""
4204 #. type: textblock
4205 #: deb-src-symbols.pod
4206 msgid ""
4207 "You can factorize the common part in some external file and include that "
4208 "file in your I<package>.symbols.I<arch> file by using an include directive "
4209 "like this:"
4210 msgstr ""
4212 #. type: verbatim
4213 #: deb-src-symbols.pod
4214 #, no-wrap
4215 msgid ""
4216 " #include \"I<packages>.symbols.common\"\n"
4217 "\n"
4218 msgstr ""
4220 #. type: textblock
4221 #: deb-src-symbols.pod
4222 msgid "The include directive may also be tagged like any symbol:"
4223 msgstr ""
4225 #. type: verbatim
4226 #: deb-src-symbols.pod
4227 #, no-wrap
4228 msgid ""
4229 " (tag|...|tagN)#include \"file-to-include\"\n"
4230 "\n"
4231 msgstr ""
4233 #. type: textblock
4234 #: deb-src-symbols.pod
4235 msgid ""
4236 "As a result, all symbols included from I<file-to-include> will be considered "
4237 "to be tagged with I<tag> ... I<tagN> by default. You can use this feature to "
4238 "create a common I<package>.symbols file which includes architecture specific "
4239 "symbol files:"
4240 msgstr ""
4242 #. type: verbatim
4243 #: deb-src-symbols.pod
4244 #, no-wrap
4245 msgid ""
4246 "  common_symbol1@Base 1.0\n"
4247 " (arch=amd64 ia64 alpha)#include \"package.symbols.64bit\"\n"
4248 " (arch=!amd64 !ia64 !alpha)#include \"package.symbols.32bit\"\n"
4249 "  common_symbol2@Base 1.0\n"
4250 "\n"
4251 msgstr ""
4253 #. type: textblock
4254 #: deb-src-symbols.pod
4255 msgid ""
4256 "The symbols files are read line by line, and include directives are "
4257 "processed as soon as they are encountered. This means that the content of "
4258 "the included file can override any content that appeared before the include "
4259 "directive and that any content after the directive can override anything "
4260 "contained in the included file. Any symbol (or even another #include "
4261 "directive) in the included file can specify additional tags or override "
4262 "values of the inherited tags in its tag specification. However, there is no "
4263 "way for the symbol to remove any of the inherited tags."
4264 msgstr ""
4266 #. type: textblock
4267 #: deb-src-symbols.pod
4268 msgid ""
4269 "An included file can repeat the header line containing the SONAME of the "
4270 "library. In that case, it overrides any header line previously read.  "
4271 "However, in general it's best to avoid duplicating header lines. One way to "
4272 "do it is the following:"
4273 msgstr ""
4275 #. type: verbatim
4276 #: deb-src-symbols.pod
4277 #, no-wrap
4278 msgid ""
4279 " #include \"libsomething1.symbols.common\"\n"
4280 "  arch_specific_symbol@Base 1.0\n"
4281 "\n"
4282 msgstr ""
4284 #. type: textblock
4285 #: deb-src-symbols.pod
4286 msgid "B<deb-symbols>(5), B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
4287 msgstr ""
4289 #. type: textblock
4290 #: deb-substvars.pod
4291 msgid "deb-substvars - Debian source substitution variables"
4292 msgstr ""
4294 #. type: textblock
4295 #: deb-substvars.pod
4296 msgid "B<debian/substvars>, B<debian/>I<binary-package>B<.substvars>, variables"
4297 msgstr ""
4299 #. type: textblock
4300 #: deb-substvars.pod
4301 msgid ""
4302 "Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their "
4303 "control information (to the source control file B<.dsc> for B<dpkg-source> "
4304 "and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>)  they "
4305 "perform some variable substitutions on the output file."
4306 msgstr ""
4308 #. type: =head2
4309 #: deb-substvars.pod
4310 msgid "Variable Syntax"
4311 msgstr ""
4313 #. type: textblock
4314 #: deb-substvars.pod
4315 msgid ""
4316 "A variable substitution has the form B<${>I<variable-name>B<}>.  Variable "
4317 "names consist of alphanumerics (a-zA-Z0-9), hyphens (-) and colons (:) and "
4318 "start with an alphanumeric, and are case-sensitive, even though they might "
4319 "refer to other entities which are case-preserving.  Variable substitutions "
4320 "are performed repeatedly until none are left; the full text of the field "
4321 "after the substitution is rescanned to look for more substitutions."
4322 msgstr ""
4324 #. type: =head2
4325 #: deb-substvars.pod
4326 msgid "File Syntax"
4327 msgstr ""
4329 #. type: textblock
4330 #: deb-substvars.pod
4331 msgid ""
4332 "Substitution variables can be specified in a file.  These files consist of "
4333 "lines of the form I<name>B<=>I<value> or I<name>B<?=>I<value>.  The B<=> "
4334 "operator assigns a normal substitution variable, while the B<?=> operator "
4335 "(since dpkg 1.21.8) assigns an optional substitution variable which will "
4336 "emit no warnings even if unused.  Trailing whitespace on each line, blank "
4337 "lines, and lines starting with a B<#> symbol (comments) are ignored."
4338 msgstr ""
4340 #. type: =head2
4341 #: deb-substvars.pod
4342 msgid "Substitution"
4343 msgstr ""
4345 #. type: textblock
4346 #: deb-substvars.pod
4347 msgid ""
4348 "Variables can be set using the B<-V> common option.  They can be also "
4349 "specified in the file B<debian/substvars> (or whatever other file is "
4350 "specified using the B<-T> common option)."
4351 msgstr ""
4353 #. type: textblock
4354 #: deb-substvars.pod
4355 msgid ""
4356 "After all the substitutions have been done each occurrence of the string "
4357 "B<${}> (which is not an actual substitution variable) is replaced with a "
4358 "B<$> sign.  This can be used as an escape sequence such as "
4359 "B<${}{>I<VARIABLE>B<}> which will end up as B<${>I<VARIABLE>B<}> on the "
4360 "output."
4361 msgstr ""
4363 #. type: textblock
4364 #: deb-substvars.pod
4365 msgid ""
4366 "If a variable is referred to but not defined it generates a warning and an "
4367 "empty value is assumed."
4368 msgstr ""
4370 #. type: textblock
4371 #: deb-substvars.pod
4372 msgid ""
4373 "While variable substitution is done on all control fields, some of those "
4374 "fields are used and needed during the build when the substitution did not "
4375 "yet occur. That's why you can't use variables in the B<Package>, B<Source> "
4376 "and B<Architecture> fields."
4377 msgstr ""
4379 #. type: textblock
4380 #: deb-substvars.pod
4381 msgid ""
4382 "Variable substitution happens on the content of the fields after they have "
4383 "been parsed, thus if you want a variable to expand over multiple lines you "
4384 "do not have to include a space after the newline. This is done implicitly "
4385 "when the field is output. For example, if the variable B<${Description}> is "
4386 "set to \"foo is bar.${Newline}foo is great.\" and if you have the following "
4387 "field:"
4388 msgstr ""
4390 #. type: verbatim
4391 #: deb-substvars.pod
4392 #, no-wrap
4393 msgid ""
4394 " Description: foo application\n"
4395 "  ${Description}\n"
4396 "  .\n"
4397 "  More text.\n"
4398 "\n"
4399 msgstr ""
4401 #. type: textblock
4402 #: deb-substvars.pod
4403 msgid "It will result in:"
4404 msgstr ""
4406 #. type: verbatim
4407 #: deb-substvars.pod
4408 #, no-wrap
4409 msgid ""
4410 " Description: foo application\n"
4411 "  foo is bar.\n"
4412 "  foo is great.\n"
4413 "  .\n"
4414 "  More text.\n"
4415 "\n"
4416 msgstr ""
4418 #. type: =head2
4419 #: deb-substvars.pod
4420 msgid "Built-in Variable"
4421 msgstr ""
4423 #. type: textblock
4424 #: deb-substvars.pod
4425 msgid "Additionally, the following standard variables are always available:"
4426 msgstr ""
4428 #. type: =item
4429 #: deb-substvars.pod
4430 msgid "B<Arch>"
4431 msgstr ""
4433 #. type: textblock
4434 #: deb-substvars.pod
4435 msgid ""
4436 "The current host architecture (i.e. the architecture the package is being "
4437 "built for, the equivalent of B<DEB_HOST_ARCH>)."
4438 msgstr ""
4440 #. type: =item
4441 #: deb-substvars.pod
4442 msgid "B<vendor:Name>"
4443 msgstr ""
4445 #. type: textblock
4446 #: deb-substvars.pod
4447 msgid ""
4448 "The current vendor name (since dpkg 1.20.0).  This value comes from the "
4449 "B<Vendor> field for the current vendor's origin file, as B<dpkg-vendor>(1) "
4450 "would retrieve it."
4451 msgstr ""
4453 #. type: =item
4454 #: deb-substvars.pod
4455 msgid "B<vendor:Id>"
4456 msgstr ""
4458 #. type: textblock
4459 #: deb-substvars.pod
4460 msgid ""
4461 "The current vendor ID (since dpkg 1.20.0).  This is just the lowercase "
4462 "variant of B<vendor:Name>."
4463 msgstr ""
4465 #. type: =item
4466 #: deb-substvars.pod dpkg-query.pod
4467 msgid "B<source:Version>"
4468 msgstr ""
4470 #. type: textblock
4471 #: deb-substvars.pod
4472 msgid "The source package version (since dpkg 1.13.19)."
4473 msgstr ""
4475 #. type: =item
4476 #: deb-substvars.pod dpkg-query.pod
4477 msgid "B<source:Upstream-Version>"
4478 msgstr ""
4480 #. type: textblock
4481 #: deb-substvars.pod
4482 msgid ""
4483 "The upstream source package version, including the Debian version epoch if "
4484 "any (since dpkg 1.13.19)."
4485 msgstr ""
4487 #. type: =item
4488 #: deb-substvars.pod
4489 msgid "B<binary:Version>"
4490 msgstr ""
4492 #. type: textblock
4493 #: deb-substvars.pod
4494 msgid ""
4495 "The binary package version (which may differ from B<source:Version> in a "
4496 "binNMU for example; since dpkg 1.13.19)."
4497 msgstr ""
4499 #. type: =item
4500 #: deb-substvars.pod
4501 msgid "B<Source-Version>"
4502 msgstr ""
4504 #. type: textblock
4505 #: deb-substvars.pod
4506 msgid ""
4507 "The source package version (from the changelog file). This variable is now "
4508 "B<obsolete> and emits an error when used as its meaning is different from "
4509 "its function, please use the B<source:Version> or B<binary:Version> as "
4510 "appropriate."
4511 msgstr ""
4513 #. type: =item
4514 #: deb-substvars.pod
4515 msgid "B<source:Synopsis>"
4516 msgstr ""
4518 #. type: textblock
4519 #: deb-substvars.pod
4520 msgid ""
4521 "The source package synopsis, extracted from the source stanza B<Description> "
4522 "field, if it exists (since dpkg 1.19.0)."
4523 msgstr ""
4525 #. type: =item
4526 #: deb-substvars.pod
4527 msgid "B<source:Extended-Description>"
4528 msgstr ""
4530 #. type: textblock
4531 #: deb-substvars.pod
4532 msgid ""
4533 "The source package extended description, extracted from the source stanza "
4534 "B<Description> field, if it exists (since dpkg 1.19.0)."
4535 msgstr ""
4537 #. type: =item
4538 #: deb-substvars.pod dpkg-query.pod
4539 msgid "B<Installed-Size>"
4540 msgstr ""
4542 #. type: textblock
4543 #: deb-substvars.pod
4544 msgid ""
4545 "The approximate total size of the package's installed files. This value is "
4546 "copied into the corresponding control file field; setting it will modify the "
4547 "value of that field. If this variable is not set B<dpkg-gencontrol> will "
4548 "compute the default value by accumulating the size of each regular file and "
4549 "symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other "
4550 "filesystem object type.  With hardlinks only being counted once as a regular "
4551 "file."
4552 msgstr ""
4554 #. type: textblock
4555 #: deb-substvars.pod
4556 msgid ""
4557 "B<Note:> Take into account that this can only ever be an approximation, as "
4558 "the actual size used on the installed system will depend greatly on the "
4559 "filesystem used and its parameters, which might end up using either more or "
4560 "less space than the specified in this field."
4561 msgstr ""
4563 #. type: =item
4564 #: deb-substvars.pod
4565 msgid "B<Extra-Size>"
4566 msgstr ""
4568 #. type: textblock
4569 #: deb-substvars.pod
4570 msgid ""
4571 "Additional disk space used when the package is installed. If this variable "
4572 "is set its value is added to that of the B<Installed-Size> variable (whether "
4573 "set explicitly or using the default value) before it is copied into the "
4574 "B<Installed-Size> control file field."
4575 msgstr ""
4577 #. type: =item
4578 #: deb-substvars.pod
4579 msgid "B<S:>I<fieldname>"
4580 msgstr ""
4582 #. type: textblock
4583 #: deb-substvars.pod
4584 msgid ""
4585 "The value of the source stanza field I<fieldname> (which must be given in "
4586 "the canonical capitalization; since dpkg 1.18.11).  Setting these variables "
4587 "has no effect other than on places where they are expanded explicitly.  "
4588 "These variables are only available when generating binary control files."
4589 msgstr ""
4591 #. type: =item
4592 #: deb-substvars.pod
4593 msgid "B<F:>I<fieldname>"
4594 msgstr ""
4596 #. type: textblock
4597 #: deb-substvars.pod
4598 msgid ""
4599 "The value of the output field I<fieldname> (which must be given in the "
4600 "canonical capitalization). Setting these variables has no effect other than "
4601 "on places where they are expanded explicitly."
4602 msgstr ""
4604 #. type: =item
4605 #: deb-substvars.pod
4606 msgid "B<Format>"
4607 msgstr ""
4609 #. type: textblock
4610 #: deb-substvars.pod
4611 msgid ""
4612 "The B<.changes> file format version generated by this version of the source "
4613 "packaging scripts. If you set this variable the contents of the B<Format> "
4614 "field in the B<.changes> file will change too."
4615 msgstr ""
4617 #. type: =item
4618 #: deb-substvars.pod
4619 msgid "B<Newline>, B<Space>, B<Tab>"
4620 msgstr ""
4622 #. type: textblock
4623 #: deb-substvars.pod
4624 msgid "These variables each hold the corresponding character."
4625 msgstr ""
4627 #. type: =item
4628 #: deb-substvars.pod
4629 msgid "B<shlibs:>I<dependencyfield>"
4630 msgstr ""
4632 #. type: textblock
4633 #: deb-substvars.pod
4634 msgid ""
4635 "Variable settings with names of this form are generated by "
4636 "B<dpkg-shlibdeps>."
4637 msgstr ""
4639 #. type: =item
4640 #: deb-substvars.pod
4641 msgid "B<dpkg:Upstream-Version>"
4642 msgstr ""
4644 #. type: textblock
4645 #: deb-substvars.pod
4646 msgid "The upstream version of dpkg (since dpkg 1.13.19)."
4647 msgstr ""
4649 #. type: =item
4650 #: deb-substvars.pod
4651 msgid "B<dpkg:Version>"
4652 msgstr ""
4654 #. type: textblock
4655 #: deb-substvars.pod
4656 msgid "The full version of dpkg (since dpkg 1.13.19)."
4657 msgstr ""
4659 #. type: =item
4660 #: deb-substvars.pod
4661 msgid "B<debian/substvars>"
4662 msgstr ""
4664 #. type: textblock
4665 #: deb-substvars.pod
4666 msgid "List of substitution variables and values."
4667 msgstr ""
4669 #. type: textblock
4670 #: deb-substvars.pod
4671 msgid ""
4672 "B<dpkg>(1), B<dpkg-vendor>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), "
4673 "B<dpkg-shlibdeps>(1), B<dpkg-source>(1)."
4674 msgstr ""
4676 #. type: textblock
4677 #: deb-symbols.pod
4678 msgid "deb-symbols - Debian's extended shared library information file"
4679 msgstr ""
4681 #. type: textblock
4682 #: deb-symbols.pod
4683 msgid "B<DEBIAN/symbols>"
4684 msgstr ""
4686 #. type: textblock
4687 #: deb-symbols.pod
4688 msgid ""
4689 "The symbol files are shipped in Debian binary packages, and its format is a "
4690 "subset of the template symbol files used by B<dpkg-gensymbols>(1)  in Debian "
4691 "source packages, see L<deb-src-symbols(5)>."
4692 msgstr ""
4694 #. type: textblock
4695 #: deb-symbols.pod
4696 msgid ""
4697 "The format for an extended shared library dependency information entry in "
4698 "these files is:"
4699 msgstr ""
4701 #. type: verbatim
4702 #: deb-symbols.pod
4703 #, no-wrap
4704 msgid ""
4705 "Z<>\n"
4706 " I<library-soname> I<main-dependency-template>\n"
4707 " [| I<alternative-dependency-template>]\n"
4708 " [...]\n"
4709 " [* I<field-name>: I<field-value>]\n"
4710 " [...]\n"
4711 "  I<symbol> I<minimal-version> [I<id-of-dependency-template>]\n"
4712 "\n"
4713 msgstr ""
4715 #. type: textblock
4716 #: deb-symbols.pod
4717 msgid ""
4718 "The I<library-soname> is exactly the value of the SONAME field as exported "
4719 "by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> "
4720 "is dynamically replaced either by a version check like “(E<gt>= "
4721 "I<minimal-version>)” or by nothing (if an unversioned dependency is deemed "
4722 "sufficient)."
4723 msgstr ""
4725 #. type: textblock
4726 #: deb-symbols.pod
4727 msgid ""
4728 "Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being "
4729 "“Base” if the library is not versioned) is associated to a "
4730 "I<minimal-version> of its dependency template (the main dependency template "
4731 "is always used and will end up being combined with the dependency template "
4732 "referenced by I<id-of-dependency-template> if present). The first "
4733 "alternative dependency template is numbered 1, the second one 2, etc.  Each "
4734 "column is separated by exactly a single whitespace."
4735 msgstr ""
4737 #. type: textblock
4738 #: deb-symbols.pod
4739 msgid ""
4740 "Each entry for a library can also have some fields of meta-information.  "
4741 "Those fields are stored on lines starting with an asterisk. Currently, the "
4742 "only valid fields are:"
4743 msgstr ""
4745 #. type: =item
4746 #: deb-symbols.pod
4747 msgid "B<Build-Depends-Package>"
4748 msgstr ""
4750 #. type: textblock
4751 #: deb-symbols.pod
4752 msgid ""
4753 "It indicates the name of the “-dev” package associated to the library and is "
4754 "used by B<dpkg-shlibdeps> to make sure that the dependency generated is at "
4755 "least as strict as the corresponding build dependency (since dpkg 1.14.13)."
4756 msgstr ""
4758 #. type: =item
4759 #: deb-symbols.pod
4760 msgid "B<Build-Depends-Packages>"
4761 msgstr ""
4763 #. type: textblock
4764 #: deb-symbols.pod
4765 msgid ""
4766 "The same as B<Build-Depends-Package> but accepts a comma-separated list of "
4767 "package names (since dpkg 1.20.0).  This field will override any "
4768 "B<Build-Depends-Package> field present, and is mostly useful with “-dev” "
4769 "packages and metapackages depending on these, say for a transition period."
4770 msgstr ""
4772 #. type: =item
4773 #: deb-symbols.pod
4774 msgid "B<Allow-Internal-Symbol-Groups>"
4775 msgstr ""
4777 #. type: textblock
4778 #: deb-symbols.pod
4779 msgid ""
4780 "It indicates what internal symbol groups should be ignored, as a whitespace "
4781 "separated list, so that the symbols contained in those groups get included "
4782 "in the output file (since dpkg 1.20.1).  This should only be necessary for "
4783 "toolchain packages providing those internal symbols. The available groups "
4784 "are system dependent, for ELF and GNU-based systems these are B<aeabi> and "
4785 "B<gomp>."
4786 msgstr ""
4788 #. type: =item
4789 #: deb-symbols.pod
4790 msgid "B<Ignore-Blacklist-Groups>"
4791 msgstr ""
4793 #. type: textblock
4794 #: deb-symbols.pod
4795 msgid ""
4796 "A deprecated alias for B<Allow-Internal-Symbol-Groups> (since dpkg 1.20.1, "
4797 "supported since dpkg 1.17.6)."
4798 msgstr ""
4800 #. type: =head2
4801 #: deb-symbols.pod
4802 msgid "Simple symbols file"
4803 msgstr ""
4805 #. type: verbatim
4806 #: deb-symbols.pod
4807 #, no-wrap
4808 msgid ""
4809 " libftp.so.3 libftp3 #MINVER#\n"
4810 "  DefaultNetbuf@Base 3.1-1-6\n"
4811 "  FtpAccess@Base 3.1-1-6\n"
4812 "  [...]\n"
4813 "\n"
4814 msgstr ""
4816 #. type: =head2
4817 #: deb-symbols.pod
4818 msgid "Advanced symbols file"
4819 msgstr ""
4821 #. type: verbatim
4822 #: deb-symbols.pod
4823 #, no-wrap
4824 msgid ""
4825 " libGL.so.1 libgl1\n"
4826 " | libgl1-mesa-glx #MINVER#\n"
4827 " * Build-Depends-Package: libgl1-mesa-dev\n"
4828 "  publicGlSymbol@Base 6.3-1\n"
4829 "  [...]\n"
4830 "  implementationSpecificSymbol@Base 6.5.2-7 1\n"
4831 "  [...]\n"
4832 "\n"
4833 msgstr ""
4835 #. type: textblock
4836 #: deb-symbols.pod
4837 msgid ""
4838 "L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, "
4839 "L<deb-src-symbols(5)>, B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
4840 msgstr ""
4842 #. type: textblock
4843 #: deb-triggers.pod
4844 msgid "deb-triggers - package triggers"
4845 msgstr ""
4847 #. type: textblock
4848 #: deb-triggers.pod
4849 msgid ""
4850 "B<debian/triggers>, B<debian/>I<binary-package>B<.triggers>, "
4851 "B<DEBIAN/triggers>"
4852 msgstr ""
4854 #. type: textblock
4855 #: deb-triggers.pod
4856 msgid ""
4857 "A package declares its relationship to some trigger(s) by including a "
4858 "I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during "
4859 "package creation)."
4860 msgstr ""
4862 #. type: textblock
4863 #: deb-triggers.pod
4864 msgid ""
4865 "This file contains directives, one per line. Leading and trailing whitespace "
4866 "and everything after the first B<#> on any line will be trimmed, and empty "
4867 "lines will be ignored."
4868 msgstr ""
4870 #. type: textblock
4871 #: deb-triggers.pod
4872 msgid "The trigger control directives currently supported are:"
4873 msgstr ""
4875 #. type: =item
4876 #: deb-triggers.pod
4877 msgid "B<interest> I<trigger-name>"
4878 msgstr ""
4880 #. type: =item
4881 #: deb-triggers.pod
4882 msgid "B<interest-await> I<trigger-name>"
4883 msgstr ""
4885 #. type: =item
4886 #: deb-triggers.pod
4887 msgid "B<interest-noawait> I<trigger-name>"
4888 msgstr ""
4890 #. type: textblock
4891 #: deb-triggers.pod
4892 msgid ""
4893 "Specifies that the package is interested in the named trigger. All triggers "
4894 "in which a package is interested must be listed using this directive in the "
4895 "triggers control file."
4896 msgstr ""
4898 #. type: textblock
4899 #: deb-triggers.pod
4900 msgid ""
4901 "The “await” variants put the triggering package in triggers-awaited state "
4902 "depending on how the trigger was activated.  The “noawait” variant does not "
4903 "put the triggering packages in triggers-awaited state, even if the "
4904 "triggering package declared an “await” activation (either with an "
4905 "B<activate-await> or B<activate> directive, or by using the B<dpkg-trigger> "
4906 "B<--no-await> command-line option).  The “noawait” variant should be used "
4907 "when the functionality provided by the trigger is not crucial."
4908 msgstr ""
4910 #. type: =item
4911 #: deb-triggers.pod
4912 msgid "B<activate> I<trigger-name>"
4913 msgstr ""
4915 #. type: =item
4916 #: deb-triggers.pod
4917 msgid "B<activate-await> I<trigger-name>"
4918 msgstr ""
4920 #. type: =item
4921 #: deb-triggers.pod
4922 msgid "B<activate-noawait> I<trigger-name>"
4923 msgstr ""
4925 #. type: textblock
4926 #: deb-triggers.pod
4927 msgid ""
4928 "Arranges that changes to this package's state will activate the specified "
4929 "trigger. The trigger will be activated at the start of the following "
4930 "operations: unpack, configure, remove (including for the benefit of a "
4931 "conflicting package), purge and deconfigure."
4932 msgstr ""
4934 #. type: textblock
4935 #: deb-triggers.pod
4936 msgid ""
4937 "The “await” variants only put the triggering package in triggers-awaited "
4938 "state if the interest directive is also “await”.  The “noawait” variant "
4939 "never puts the triggering packages in triggers-awaited state.  The “noawait” "
4940 "variant should be used when the functionality provided by the trigger is not "
4941 "crucial."
4942 msgstr ""
4944 #. type: textblock
4945 #: deb-triggers.pod
4946 msgid ""
4947 "If this package disappears during the unpacking of another package the "
4948 "trigger will be activated when the disappearance is noted towards the end of "
4949 "the unpack. Trigger processing, and transition from triggers-awaited to "
4950 "installed, does not cause activations.  In the case of unpack, triggers "
4951 "mentioned in both the old and new versions of the package will be activated."
4952 msgstr ""
4954 #. type: textblock
4955 #: deb-triggers.pod
4956 msgid ""
4957 "Unknown directives are an error which will prevent installation of the "
4958 "package."
4959 msgstr ""
4961 #. type: textblock
4962 #: deb-triggers.pod
4963 msgid ""
4964 "The “-noawait” variants should always be favored when possible since "
4965 "triggering packages are not put in triggers-awaited state and can thus be "
4966 "immediately configured without requiring the processing of the trigger.  If "
4967 "the triggering packages are dependencies of other upgraded packages, it will "
4968 "avoid an early trigger processing run and make it possible to run the "
4969 "trigger only once as one of the last steps of the upgrade."
4970 msgstr ""
4972 #. type: textblock
4973 #: deb-triggers.pod
4974 msgid ""
4975 "The “-noawait” variants are supported since dpkg 1.16.1, and will lead to "
4976 "errors if used with an older dpkg."
4977 msgstr ""
4979 #. type: textblock
4980 #: deb-triggers.pod
4981 msgid ""
4982 "The “-await” alias variants are supported since dpkg 1.17.21, and will lead "
4983 "to errors if used with an older dpkg."
4984 msgstr ""
4986 #. type: textblock
4987 #: deb-triggers.pod
4988 msgid ""
4989 "When a package provides an B<interest-noawait> directive, any activation "
4990 "will set the triggering package into “noawait” mode, regardless of the "
4991 "awaiting mode requested by the activation (either “await” or “noawait”).  "
4992 "When a package provides an B<interest> or B<interest-await> directive, any "
4993 "activation will set the triggering package into “await” or “noawait“ "
4994 "depending on how it was activated."
4995 msgstr ""
4997 #. type: textblock
4998 #: deb-triggers.pod
4999 msgid "B<dpkg-trigger>(1), B<dpkg>(1), B<%PKGDOCDIR%/spec/triggers.txt>."
5000 msgstr ""
5002 #. type: textblock
5003 #: deb-version.pod
5004 msgid "deb-version - Debian package version number format"
5005 msgstr ""
5007 #. type: textblock
5008 #: deb-version.pod
5009 msgid "[I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]"
5010 msgstr ""
5012 #. type: textblock
5013 #: deb-version.pod
5014 msgid ""
5015 "Version numbers as used for Debian binary and source packages consist of "
5016 "three components. These are:"
5017 msgstr ""
5019 #. type: =item
5020 #: deb-version.pod
5021 msgid "I<epoch>"
5022 msgstr ""
5024 #. type: textblock
5025 #: deb-version.pod
5026 msgid ""
5027 "This is a single (generally small) unsigned integer.  It may be omitted, in "
5028 "which case zero is assumed.  If it is omitted then the I<upstream-version> "
5029 "may not contain any colons."
5030 msgstr ""
5032 #. type: textblock
5033 #: deb-version.pod
5034 msgid ""
5035 "It is provided to allow mistakes in the version numbers of older versions of "
5036 "a package, and also a package's previous version numbering schemes, to be "
5037 "left behind."
5038 msgstr ""
5040 #. type: =item
5041 #: deb-version.pod
5042 msgid "I<upstream-version>"
5043 msgstr ""
5045 #. type: textblock
5046 #: deb-version.pod
5047 msgid ""
5048 "This is the main part of the version number.  It is usually the version "
5049 "number of the original (“upstream”)  package from which the I<.deb> file has "
5050 "been made, if this is applicable.  Usually this will be in the same format "
5051 "as that specified by the upstream author(s); however, it may need to be "
5052 "reformatted to fit into the package management system's format and "
5053 "comparison scheme."
5054 msgstr ""
5056 #. type: textblock
5057 #: deb-version.pod
5058 msgid ""
5059 "The comparison behavior of the package management system with respect to the "
5060 "I<upstream-version> is described below. The I<upstream-version> portion of "
5061 "the version number is mandatory."
5062 msgstr ""
5064 #. type: textblock
5065 #: deb-version.pod
5066 msgid ""
5067 "The I<upstream-version> may contain only alphanumerics (“A-Za-z0-9”) and the "
5068 "characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) "
5069 "and should start with a digit.  If there is no I<debian-revision> then "
5070 "hyphens are not allowed; if there is no I<epoch> then colons are not "
5071 "allowed."
5072 msgstr ""
5074 #. type: =item
5075 #: deb-version.pod
5076 msgid "I<debian-revision>"
5077 msgstr ""
5079 #. type: textblock
5080 #: deb-version.pod
5081 msgid ""
5082 "This part of the version number specifies the version of the Debian package "
5083 "based on the upstream version.  It may contain only alphanumerics and the "
5084 "characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the "
5085 "same way as the I<upstream-version> is."
5086 msgstr ""
5088 #. type: textblock
5089 #: deb-version.pod
5090 msgid ""
5091 "It is optional; if it isn't present then the I<upstream-version> may not "
5092 "contain a hyphen.  This format represents the case where a piece of software "
5093 "was written specifically to be turned into a Debian package, and so there is "
5094 "only one “debianization” of it and therefore no revision indication is "
5095 "required."
5096 msgstr ""
5098 #. type: textblock
5099 #: deb-version.pod
5100 msgid ""
5101 "It is conventional to restart the I<debian-revision> at ‘1’ each time the "
5102 "I<upstream-version> is increased."
5103 msgstr ""
5105 #. type: textblock
5106 #: deb-version.pod
5107 msgid ""
5108 "Dpkg will break the version number apart at the last hyphen in the string "
5109 "(if there is one) to determine the I<upstream-version> and "
5110 "I<debian-revision>. The absence of a I<debian-revision> compares earlier "
5111 "than the presence of one (but note that the I<debian-revision> is the least "
5112 "significant part of the version number)."
5113 msgstr ""
5115 #. type: =head2
5116 #: deb-version.pod
5117 msgid "Sorting algorithm"
5118 msgstr ""
5120 #. type: textblock
5121 #: deb-version.pod
5122 msgid ""
5123 "The I<upstream-version> and I<debian-revision> parts are compared by the "
5124 "package management system using the same algorithm:"
5125 msgstr ""
5127 #. type: textblock
5128 #: deb-version.pod
5129 msgid "The strings are compared from left to right."
5130 msgstr ""
5132 #. type: textblock
5133 #: deb-version.pod
5134 msgid ""
5135 "First the initial part of each string consisting entirely of non-digit "
5136 "characters is determined.  These two parts (one of which may be empty) are "
5137 "compared lexically.  If a difference is found it is returned.  The lexical "
5138 "comparison is a comparison of ASCII values modified so that all the letters "
5139 "sort earlier than all the non-letters and so that a tilde sorts before "
5140 "anything, even the end of a part.  For example, the following parts are in "
5141 "sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’."
5142 msgstr ""
5144 #. type: textblock
5145 #: deb-version.pod
5146 msgid ""
5147 "Then the initial part of the remainder of each string which consists "
5148 "entirely of digit characters is determined.  The numerical values of these "
5149 "two parts are compared, and any difference found is returned as the result "
5150 "of the comparison.  For these purposes an empty string (which can only occur "
5151 "at the end of one or both version strings being compared) counts as zero."
5152 msgstr ""
5154 #. type: textblock
5155 #: deb-version.pod
5156 msgid ""
5157 "These two steps (comparing and removing initial non-digit strings and "
5158 "initial digit strings) are repeated until a difference is found or both "
5159 "strings are exhausted."
5160 msgstr ""
5162 #. type: textblock
5163 #: deb-version.pod
5164 msgid ""
5165 "Note that the purpose of epochs is to allow us to leave behind mistakes in "
5166 "version numbering, and to cope with situations where the version numbering "
5167 "scheme changes.  It is B<not> intended to cope with version numbers "
5168 "containing strings of letters which the package management system cannot "
5169 "interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings."
5170 msgstr ""
5172 #. type: textblock
5173 #: deb-version.pod
5174 msgid ""
5175 "The tilde character and its special sorting properties were introduced in "
5176 "dpkg 1.10 and some parts of the dpkg build scripts only gained support for "
5177 "it later in the 1.10.x series."
5178 msgstr ""
5180 #. type: textblock
5181 #: deb-version.pod
5182 msgid "B<deb-control>(5), B<deb>(5), B<dpkg>(1)"
5183 msgstr ""
5185 #. type: textblock
5186 #: deb.pod
5187 msgid "deb - Debian binary package format"
5188 msgstr ""
5190 #. type: textblock
5191 #: deb.pod
5192 msgid ""
5193 "The B<.deb> format is the Debian binary package file format. It is "
5194 "understood since dpkg 0.93.76, and is generated by default since dpkg 1.2.0 "
5195 "and 1.1.1elf (i386/ELF builds)."
5196 msgstr ""
5198 #. type: textblock
5199 #: deb.pod
5200 msgid ""
5201 "The format described here is used since Debian 0.93; details of the old "
5202 "format are described in B<deb-old>(5)."
5203 msgstr ""
5205 #. type: textblock
5206 #: deb.pod
5207 msgid ""
5208 "The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  Only "
5209 "the common B<ar> archive format is supported, with no long file name "
5210 "extensions, but with file names containing an optional trailing slash, which "
5211 "limits their length to 15 characters (from the 16 allowed).  File sizes are "
5212 "limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 "
5213 "MiB member files."
5214 msgstr ""
5216 #. type: textblock
5217 #: deb.pod
5218 msgid ""
5219 "The B<tar> archives currently allowed are, the old-style (v7) format, the "
5220 "pre-POSIX ustar format, a subset of the GNU format (new style long pathnames "
5221 "and long linknames, supported since dpkg 1.4.1.17; large file metadata since "
5222 "dpkg 1.18.24), and the POSIX ustar format (long names supported since dpkg "
5223 "1.15.0).  Unrecognized tar typeflags are considered an error.  Each tar "
5224 "entry size inside a tar archive is limited to 11 ASCII octal digits, "
5225 "allowing for up to 8 GiB tar entries.  The GNU large file metadata support "
5226 "permits 95-bit tar entry sizes and negative timestamps, and 63-bit UID, GID "
5227 "and device numbers."
5228 msgstr ""
5230 #. type: textblock
5231 #: deb.pod
5232 msgid ""
5233 "The first member is named B<debian-binary> and contains a series of lines, "
5234 "separated by newlines. Currently only one line is present, the format "
5235 "version number, B<2.0> at the time this manual page was written.  Programs "
5236 "which read new-format archives should be prepared for the minor number to be "
5237 "increased and new lines to be present, and should ignore these if this is "
5238 "the case."
5239 msgstr ""
5241 #. type: textblock
5242 #: deb.pod
5243 msgid ""
5244 "If the major number has changed, an incompatible change has been made and "
5245 "the program should stop. If it has not, then the program should be able to "
5246 "safely continue, unless it encounters an unexpected member in the archive "
5247 "(except at the end), as described below."
5248 msgstr ""
5250 #. type: textblock
5251 #: deb.pod
5252 msgid ""
5253 "The second required member is named B<control.tar>.  It is a tar archive "
5254 "containing the package control information, either not compressed (supported "
5255 "since dpkg 1.17.6), or compressed with gzip (with B<.gz> extension) or xz "
5256 "(with B<.xz> extension, supported since 1.17.6), zstd (with B<.zst> "
5257 "extension, supported since dpkg 1.21.18), as a series of plain files, of "
5258 "which the file B<control> is mandatory and contains the core control "
5259 "information, the B<md5sums>, B<conffiles>, B<triggers>, B<shlibs> and "
5260 "B<symbols> files contain optional control information, and the B<preinst>, "
5261 "B<postinst>, B<prerm> and B<postrm> files are optional maintainer scripts.  "
5262 "The control tarball may optionally contain an entry for ‘B<.>’, the current "
5263 "directory."
5264 msgstr ""
5266 #. type: textblock
5267 #: deb.pod
5268 msgid ""
5269 "The third, last required member is named B<data.tar>.  It contains the "
5270 "filesystem as a tar archive, either not compressed (supported since dpkg "
5271 "1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> "
5272 "extension, supported since dpkg 1.15.6), zstd (with B<.zst> extension, "
5273 "supported since dpkg 1.21.18), bzip2 (with B<.bz2> extension, supported "
5274 "since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported since dpkg "
5275 "1.13.25)."
5276 msgstr ""
5278 #. type: textblock
5279 #: deb.pod
5280 msgid ""
5281 "These members must occur in this exact order. Current implementations should "
5282 "ignore any additional members after B<data.tar>.  Further members may be "
5283 "defined in the future, and (if possible) will be placed after these "
5284 "three. Any additional members that may need to be inserted after "
5285 "B<debian-binary> and before B<control.tar> or B<data.tar> and which should "
5286 "be safely ignored by older programs, will have names starting with an "
5287 "underscore, ‘B<_>’."
5288 msgstr ""
5290 #. type: textblock
5291 #: deb.pod
5292 msgid ""
5293 "Those new members which won't be able to be safely ignored will be inserted "
5294 "before B<data.tar> with names starting with something other than "
5295 "underscores, or will (more likely) cause the major version number to be "
5296 "increased."
5297 msgstr ""
5299 #. type: =head1
5300 #: deb.pod
5301 msgid "MEDIA TYPE"
5302 msgstr ""
5304 #. type: =head2
5305 #: deb.pod
5306 msgid "Current"
5307 msgstr ""
5309 #. type: textblock
5310 #: deb.pod
5311 msgid "application/vnd.debian.binary-package"
5312 msgstr ""
5314 #. type: =head2
5315 #: deb.pod
5316 msgid "Deprecated"
5317 msgstr ""
5319 #. type: textblock
5320 #: deb.pod
5321 msgid "application/x-debian-package"
5322 msgstr ""
5324 #. type: textblock
5325 #: deb.pod
5326 msgid "application/x-deb"
5327 msgstr ""
5329 #. type: textblock
5330 #: deb.pod
5331 msgid ""
5332 "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5), B<deb-conffiles>(5), "
5333 "B<deb-md5sums>(5), B<deb-triggers>(5), B<deb-shlibs>(5), B<deb-symbols>(5), "
5334 "B<deb-preinst>(5), B<deb-postinst>(5), B<deb-prerm>(5), B<deb-postrm>(5)."
5335 msgstr ""
5337 #. type: textblock
5338 #: deb822.pod
5339 msgid "deb822 - Debian RFC822 control data format"
5340 msgstr ""
5342 #. type: textblock
5343 #: deb822.pod
5344 msgid ""
5345 "The package management system manipulates data represented in a common "
5346 "format, known as I<control data>, stored in I<control files>.  Control files "
5347 "are used for source packages, binary packages and the B<.changes> files "
5348 "which control the installation of uploaded files (B<dpkg>'s internal "
5349 "databases are in a similar format)."
5350 msgstr ""
5352 #. type: =head1
5353 #: deb822.pod
5354 msgid "SYNTAX"
5355 msgstr ""
5357 #. type: textblock
5358 #: deb822.pod
5359 msgid ""
5360 "A control file consists of one or more stanzas of fields (the stanzas "
5361 "sometimes used to be referred to as paragraphs).  The stanzas are separated "
5362 "by empty lines.  Parsers may accept lines consisting solely of U+0020 "
5363 "B<SPACE> and U+0009 B<TAB> as stanza separators, but control files should "
5364 "use empty lines.  Some control files allow only one stanza; others allow "
5365 "several, in which case each stanza usually refers to a different package.  "
5366 "(For example, in source packages, the first stanza refers to the source "
5367 "package, and later stanzas refer to binary packages generated from the "
5368 "source.)  The ordering of the stanzas in control files is significant."
5369 msgstr ""
5371 #. type: textblock
5372 #: deb822.pod
5373 msgid ""
5374 "Each stanza consists of a series of data fields.  Each field consists of the "
5375 "field name followed by a colon (U+003A ‘B<:>’), and then the data/value "
5376 "associated with that field.  The field name is composed of US-ASCII "
5377 "characters excluding control characters, space, and colon (i.e., characters "
5378 "in the ranges U+0021 ‘B<!>’ through U+0039 ‘B<9>’, and U+003B ‘B<;>’ through "
5379 "U+007E ‘B<~>’, inclusive).  Field names must not begin with the comment "
5380 "character (U+0023 ‘B<#>’), nor with the hyphen character (U+002D ‘B<->’)."
5381 msgstr ""
5383 #. type: textblock
5384 #: deb822.pod
5385 msgid ""
5386 "The field ends at the end of the line or at the end of the last continuation "
5387 "line (see below).  Horizontal whitespace (U+0020 B<SPACE> and U+0009 B<TAB>) "
5388 "may occur immediately before or after the value and is ignored there; it is "
5389 "conventional to put a single space after the colon.  For example, a field "
5390 "might be:"
5391 msgstr ""
5393 #. type: verbatim
5394 #: deb822.pod
5395 #, no-wrap
5396 msgid ""
5397 " Package: dpkg\n"
5398 "\n"
5399 msgstr ""
5401 #. type: textblock
5402 #: deb822.pod
5403 msgid "the field name is B<Package> and the field value B<dpkg>."
5404 msgstr ""
5406 #. type: textblock
5407 #: deb822.pod
5408 msgid ""
5409 "Empty field values are only permitted in source package control files "
5410 "(I<debian/control>).  Such fields are ignored."
5411 msgstr ""
5413 #. type: textblock
5414 #: deb822.pod
5415 msgid "A stanza must not contain more than one instance of a particular field name."
5416 msgstr ""
5418 #. type: textblock
5419 #: deb822.pod
5420 msgid "There are three types of fields:"
5421 msgstr ""
5423 #. type: =item
5424 #: deb822.pod
5425 msgid "B<simple>"
5426 msgstr ""
5428 #. type: textblock
5429 #: deb822.pod
5430 msgid ""
5431 "The field, including its value, must be a single line.  Folding of the field "
5432 "is not permitted.  This is the default field type if the definition of the "
5433 "field does not specify a different type."
5434 msgstr ""
5436 #. type: =item
5437 #: deb822.pod
5438 msgid "B<folded>"
5439 msgstr ""
5441 #. type: textblock
5442 #: deb822.pod
5443 msgid ""
5444 "The value of a folded field is a logical line that may span several lines.  "
5445 "The lines after the first are called continuation lines and must start with "
5446 "a U+0020 B<SPACE> or a U+0009 B<TAB>.  Whitespace, including any newlines, "
5447 "is not significant in the field values of folded fields."
5448 msgstr ""
5450 #. type: textblock
5451 #: deb822.pod
5452 msgid ""
5453 "This folding method is similar to RFC5322, allowing control files that "
5454 "contain only one stanza and no multiline fields to be read by parsers "
5455 "written for RFC5322."
5456 msgstr ""
5458 #. type: =item
5459 #: deb822.pod
5460 msgid "B<multiline>"
5461 msgstr ""
5463 #. type: textblock
5464 #: deb822.pod
5465 msgid ""
5466 "The value of a multiline field may comprise multiple continuation lines.  "
5467 "The first line of the value, the part on the same line as the field name, "
5468 "often has special significance or may have to be empty.  Other lines are "
5469 "added following the same syntax as the continuation lines of the folded "
5470 "fields.  Whitespace, including newlines, is significant in the values of "
5471 "multiline fields."
5472 msgstr ""
5474 #. type: textblock
5475 #: deb822.pod
5476 msgid ""
5477 "Whitespace must not appear inside names (of packages, architectures, files "
5478 "or anything else) or version numbers, or between the characters of "
5479 "multi-character version relationships."
5480 msgstr ""
5482 #. type: textblock
5483 #: deb822.pod
5484 msgid ""
5485 "The presence and purpose of a field, and the syntax of its value may differ "
5486 "between types of control files."
5487 msgstr ""
5489 #. type: textblock
5490 #: deb822.pod
5491 msgid ""
5492 "Field names are not case-sensitive, but it is usual to capitalize the field "
5493 "names using mixed case as shown below.  Field values are case-sensitive "
5494 "unless the description of the field says otherwise."
5495 msgstr ""
5497 #. type: textblock
5498 #: deb822.pod
5499 msgid ""
5500 "Stanza separators (empty lines) and lines consisting only of U+0020 B<SPACE> "
5501 "and U+0009 B<TAB>, are not allowed within field values or between fields.  "
5502 "Empty lines in field values are usually escaped by representing them by a "
5503 "U+0020 B<SPACE> followed by a dot (U+002E ‘B<.>’)."
5504 msgstr ""
5506 #. type: textblock
5507 #: deb822.pod
5508 msgid ""
5509 "Lines starting with U+0023 ‘B<#>’, without any preceding whitespace are "
5510 "comments lines that are only permitted in source package control files "
5511 "(I<debian/control>) and in B<deb-origin>(5) files.  These comment lines are "
5512 "ignored, even between two continuation lines.  They do not end logical "
5513 "lines."
5514 msgstr ""
5516 #. type: textblock
5517 #: deb822.pod
5518 msgid "All control files must be encoded in UTF-8."
5519 msgstr ""
5521 #. type: textblock
5522 #: deb822.pod
5523 msgid "B<RFC822>, B<RFC5322>."
5524 msgstr ""
5526 #. type: textblock
5527 #: dpkg-architecture.pod
5528 msgid "dpkg-architecture - set and determine the architecture for package building"
5529 msgstr ""
5531 #. type: textblock
5532 #: dpkg-architecture.pod
5533 msgid "B<dpkg-architecture> [I<option>...] [I<command>]"
5534 msgstr ""
5536 #. type: textblock
5537 #: dpkg-architecture.pod
5538 msgid ""
5539 "B<dpkg-architecture> provides a facility to determine and set the build and "
5540 "host architecture for package building."
5541 msgstr ""
5543 #. type: textblock
5544 #: dpkg-architecture.pod
5545 msgid ""
5546 "The build architecture is always determined by either the B<DEB_BUILD_ARCH> "
5547 "variable if set (and B<--force> not being specified) or by an external call "
5548 "to B<dpkg>(1), and cannot be set at the command line."
5549 msgstr ""
5551 #. type: textblock
5552 #: dpkg-architecture.pod
5553 msgid ""
5554 "You can specify the host architecture by providing one or both of the "
5555 "options B<--host-arch> and B<--host-type>, otherwise the B<DEB_HOST_ARCH> "
5556 "variable is used if set (and B<--force> not being specified). The default is "
5557 "determined by an external call to B<gcc>(1), or the same as the build "
5558 "architecture if B<CC> or gcc are both not available. One out of "
5559 "B<--host-arch> and B<--host-type> is sufficient, the value of the other will "
5560 "be set to a usable default. Indeed, it is often better to only specify one, "
5561 "because B<dpkg-architecture> will warn you if your choice does not match the "
5562 "default."
5563 msgstr ""
5565 #. type: =head1
5566 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-deb.pod dpkg-divert.pod
5567 #: dpkg-query.pod dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod
5568 #: dpkg-trigger.pod dpkg-vendor.pod dselect.pod start-stop-daemon.pod
5569 #: update-alternatives.pod
5570 msgid "COMMANDS"
5571 msgstr ""
5573 #. type: =item
5574 #: dpkg-architecture.pod
5575 msgid "B<-l>, B<--list>"
5576 msgstr ""
5578 #. type: textblock
5579 #: dpkg-architecture.pod
5580 msgid ""
5581 "Print the environment variables, one each line, in the format "
5582 "I<VARIABLE=value>. This is the default action."
5583 msgstr ""
5585 #. type: =item
5586 #: dpkg-architecture.pod
5587 msgid "B<-e>, B<--equal> I<architecture>"
5588 msgstr ""
5590 #. type: textblock
5591 #: dpkg-architecture.pod
5592 msgid ""
5593 "Check for equality of architecture (since dpkg 1.13.13).  It compares the "
5594 "current or specified Debian host architecture against I<architecture>, to "
5595 "check if they are equal.  This action will not expand the architecture "
5596 "wildcards.  Command finishes with an exit status of 0 if matched, 1 if not "
5597 "matched."
5598 msgstr ""
5600 #. type: =item
5601 #: dpkg-architecture.pod
5602 msgid "B<-i>, B<--is> I<architecture-wildcard>"
5603 msgstr ""
5605 #. type: textblock
5606 #: dpkg-architecture.pod
5607 msgid ""
5608 "Check for identity of architecture (since dpkg 1.13.13).  It compares the "
5609 "current or specified Debian host architecture against "
5610 "I<architecture-wildcard> after having expanded it as an architecture "
5611 "wildcard, to check if they match.  Command finishes with an exit status of 0 "
5612 "if matched, 1 if not matched."
5613 msgstr ""
5615 #. type: =item
5616 #: dpkg-architecture.pod
5617 msgid "B<-q>, B<--query> I<variable-name>"
5618 msgstr ""
5620 #. type: textblock
5621 #: dpkg-architecture.pod
5622 msgid "Print the value of a single variable."
5623 msgstr ""
5625 #. type: =item
5626 #: dpkg-architecture.pod
5627 msgid "B<-s>, B<--print-set>"
5628 msgstr ""
5630 #. type: textblock
5631 #: dpkg-architecture.pod
5632 msgid ""
5633 "Print an export command. This can be used to set the environment variables "
5634 "using the POSIX shell or make B<eval>, depending on the output format."
5635 msgstr ""
5637 #. type: =item
5638 #: dpkg-architecture.pod
5639 msgid "B<-u>, B<--print-unset>"
5640 msgstr ""
5642 #. type: textblock
5643 #: dpkg-architecture.pod
5644 msgid "Print a similar command to B<--print-set> but to unset all variables."
5645 msgstr ""
5647 #. type: =item
5648 #: dpkg-architecture.pod
5649 msgid "B<-c>, B<--command> I<command-string>"
5650 msgstr ""
5652 #. type: textblock
5653 #: dpkg-architecture.pod
5654 msgid ""
5655 "Execute a I<command-string> in an environment which has all variables set to "
5656 "the determined value."
5657 msgstr ""
5659 #. type: =item
5660 #: dpkg-architecture.pod
5661 msgid "B<-L>, B<--list-known>"
5662 msgstr ""
5664 #. type: textblock
5665 #: dpkg-architecture.pod
5666 msgid ""
5667 "Print a list of valid architecture names.  Possibly restricted by one or "
5668 "more of the matching options B<--match-wildcard>, B<--match-bits> or "
5669 "B<--match-endian> (since dpkg 1.17.14)."
5670 msgstr ""
5672 #. type: =item
5673 #: dpkg-architecture.pod dpkg-buildpackage.pod dpkg-checkbuilddeps.pod
5674 #: dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod dpkg-fsys-usrunmess.pod
5675 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
5676 #: dpkg-gensymbols.pod dpkg-name.pod dpkg-parsechangelog.pod dpkg-query.pod
5677 #: dpkg-realpath.pod dpkg-scanpackages.pod dpkg-shlibdeps.pod dpkg-source.pod
5678 #: dpkg-split.pod dpkg-trigger.pod dpkg.pod dselect.pod
5679 msgid "B<-?>, B<--help>"
5680 msgstr ""
5682 #. type: textblock
5683 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
5684 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
5685 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
5686 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-mergechangelogs.pod
5687 #: dpkg-name.pod dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
5688 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod dpkg-split.pod
5689 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg-vendor.pod
5690 #: update-alternatives.pod
5691 msgid "Show the usage message and exit."
5692 msgstr ""
5694 #. type: =item
5695 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
5696 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
5697 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
5698 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-mergechangelogs.pod
5699 #: dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
5700 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
5701 #: dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
5702 #: dpkg-vendor.pod dpkg.pod dselect.pod update-alternatives.pod
5703 msgid "B<--version>"
5704 msgstr ""
5706 #. type: textblock
5707 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
5708 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
5709 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
5710 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-mergechangelogs.pod
5711 #: dpkg-name.pod dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
5712 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
5713 #: dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
5714 #: dpkg-vendor.pod update-alternatives.pod
5715 msgid "Show the version and exit."
5716 msgstr ""
5718 #. type: =head1
5719 #: dpkg-architecture.pod dpkg-buildpackage.pod dpkg-checkbuilddeps.pod
5720 #: dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod dpkg-fsys-usrunmess.pod
5721 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
5722 #: dpkg-gensymbols.pod dpkg-mergechangelogs.pod dpkg-name.pod
5723 #: dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
5724 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
5725 #: dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
5726 #: dpkg-vendor.pod dpkg.pod dselect.pod start-stop-daemon.pod
5727 #: update-alternatives.pod
5728 msgid "OPTIONS"
5729 msgstr ""
5731 #. type: =item
5732 #: dpkg-architecture.pod dpkg-buildpackage.pod
5733 msgid "B<-a>, B<--host-arch> I<architecture>"
5734 msgstr ""
5736 #. type: textblock
5737 #: dpkg-architecture.pod
5738 msgid "Set the host Debian architecture."
5739 msgstr ""
5741 #. type: =item
5742 #: dpkg-architecture.pod dpkg-buildpackage.pod
5743 msgid "B<-t>, B<--host-type> I<gnu-system-type>"
5744 msgstr ""
5746 #. type: textblock
5747 #: dpkg-architecture.pod
5748 msgid "Set the host GNU system type."
5749 msgstr ""
5751 #. type: =item
5752 #: dpkg-architecture.pod
5753 msgid "B<-A>, B<--target-arch> I<architecture>"
5754 msgstr ""
5756 #. type: textblock
5757 #: dpkg-architecture.pod
5758 msgid "Set the target Debian architecture (since dpkg 1.17.14)."
5759 msgstr ""
5761 #. type: =item
5762 #: dpkg-architecture.pod
5763 msgid "B<-T>, B<--target-type> I<gnu-system-type>"
5764 msgstr ""
5766 #. type: textblock
5767 #: dpkg-architecture.pod
5768 msgid "Set the target GNU system type (since dpkg 1.17.14)."
5769 msgstr ""
5771 #. type: =item
5772 #: dpkg-architecture.pod
5773 msgid "B<-W>, B<--match-wildcard> I<architecture-wildcard>"
5774 msgstr ""
5776 #. type: textblock
5777 #: dpkg-architecture.pod
5778 msgid ""
5779 "Restrict the architectures listed by B<--list-known> to ones matching the "
5780 "specified architecture wildcard (since dpkg 1.17.14)."
5781 msgstr ""
5783 #. type: =item
5784 #: dpkg-architecture.pod
5785 msgid "B<-B>, B<--match-bits> I<architecture-bits>"
5786 msgstr ""
5788 #. type: textblock
5789 #: dpkg-architecture.pod
5790 msgid ""
5791 "Restrict the architectures listed by B<--list-known> to ones with the "
5792 "specified CPU bits (since dpkg 1.17.14). Either B<32> or B<64>."
5793 msgstr ""
5795 #. type: =item
5796 #: dpkg-architecture.pod
5797 msgid "B<-E>, B<--match-endian> I<architecture-endianness>"
5798 msgstr ""
5800 #. type: textblock
5801 #: dpkg-architecture.pod
5802 msgid ""
5803 "Restrict the architectures listed by B<--list-known> to ones with the "
5804 "specified endianness (since dpkg 1.17.14). Either B<little> or B<big>."
5805 msgstr ""
5807 #. type: =item
5808 #: dpkg-architecture.pod
5809 msgid "B<--print-format> I<format>"
5810 msgstr ""
5812 #. type: textblock
5813 #: dpkg-architecture.pod
5814 msgid ""
5815 "Sets the output format for B<--print-set> and B<--print-unset> (since dpkg "
5816 "1.20.6), to either B<shell> (default) or B<make>."
5817 msgstr ""
5819 #. type: =item
5820 #: dpkg-architecture.pod
5821 msgid "B<-f>, B<--force>"
5822 msgstr ""
5824 #. type: textblock
5825 #: dpkg-architecture.pod
5826 msgid ""
5827 "Values set by existing environment variables with the same name as used by "
5828 "the scripts are honored (i.e. used by B<dpkg-architecture>), except if this "
5829 "force flag is present. This allows the user to override a value even when "
5830 "the call to B<dpkg-architecture> is buried in some other script (for example "
5831 "B<dpkg-buildpackage>(1))."
5832 msgstr ""
5834 #. type: =head1
5835 #: dpkg-architecture.pod
5836 msgid "TERMS"
5837 msgstr ""
5839 #. type: =item
5840 #: dpkg-architecture.pod
5841 msgid "build machine"
5842 msgstr ""
5844 #. type: textblock
5845 #: dpkg-architecture.pod
5846 msgid "The machine the package is built on."
5847 msgstr ""
5849 #. type: =item
5850 #: dpkg-architecture.pod
5851 msgid "host machine"
5852 msgstr ""
5854 #. type: textblock
5855 #: dpkg-architecture.pod
5856 msgid "The machine the package is built for."
5857 msgstr ""
5859 #. type: =item
5860 #: dpkg-architecture.pod
5861 msgid "target machine"
5862 msgstr ""
5864 #. type: textblock
5865 #: dpkg-architecture.pod
5866 msgid ""
5867 "The machine the compiler is building for, or the emulator will run code "
5868 "for.  This is only needed when building a cross-toolchain (or emulator), one "
5869 "that will be built on the build architecture, to be run on the host "
5870 "architecture, and to build (or run emulated) code for the target "
5871 "architecture."
5872 msgstr ""
5874 #. type: =item
5875 #: dpkg-architecture.pod
5876 msgid "Debian architecture"
5877 msgstr ""
5879 #. type: textblock
5880 #: dpkg-architecture.pod
5881 msgid ""
5882 "The Debian architecture string, which specifies the binary tree in the FTP "
5883 "archive. Examples: i386, sparc, hurd-i386."
5884 msgstr ""
5886 #. type: =item
5887 #: dpkg-architecture.pod
5888 msgid "Debian architecture tuple"
5889 msgstr ""
5891 #. type: textblock
5892 #: dpkg-architecture.pod
5893 msgid ""
5894 "A Debian architecture tuple is the fully qualified architecture with all its "
5895 "components spelled out.  This differs with Debian architectures in that at "
5896 "least the I<cpu> component does not embed the I<abi>.  The current tuple has "
5897 "the form I<abi>-I<libc>-I<os>-I<cpu>.  Examples: base-gnu-linux-amd64, "
5898 "eabihf-musl-linux-arm."
5899 msgstr ""
5901 #. type: =item
5902 #: dpkg-architecture.pod
5903 msgid "Debian architecture wildcard"
5904 msgstr ""
5906 #. type: textblock
5907 #: dpkg-architecture.pod
5908 msgid ""
5909 "A Debian architecture wildcard is a special architecture string that will "
5910 "match any real architecture being part of it.  The general form is a Debian "
5911 "architecture tuple with four or less elements, and with at least one of them "
5912 "being B<any>.  Missing elements of the tuple are prefixed implicitly as "
5913 "B<any>, and thus the following pairs are equivalent:"
5914 msgstr ""
5916 #. type: =item
5917 #: dpkg-architecture.pod
5918 msgid "B<any>-B<any>-B<any>-B<any> = B<any>"
5919 msgstr ""
5921 #. type: =item
5922 #: dpkg-architecture.pod
5923 msgid "B<any>-B<any>-I<os>-B<any> = I<os>-B<any>"
5924 msgstr ""
5926 #. type: =item
5927 #: dpkg-architecture.pod
5928 msgid "B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>"
5929 msgstr ""
5931 #. type: textblock
5932 #: dpkg-architecture.pod
5933 msgid "Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any."
5934 msgstr ""
5936 #. type: =item
5937 #: dpkg-architecture.pod
5938 msgid "GNU system type"
5939 msgstr ""
5941 #. type: textblock
5942 #: dpkg-architecture.pod
5943 msgid ""
5944 "An architecture specification string consisting of two parts separated by a "
5945 "hyphen: cpu and system.  Examples: i586-linux-gnu, sparc-linux-gnu, "
5946 "i686-gnu, x86_64-netbsd."
5947 msgstr ""
5949 #. type: =item
5950 #: dpkg-architecture.pod
5951 msgid "multiarch triplet"
5952 msgstr ""
5954 #. type: textblock
5955 #: dpkg-architecture.pod
5956 msgid ""
5957 "The clarified GNU system type, used for filesystem paths.  This triplet does "
5958 "not change even when the baseline ISA gets bumped, so that the resulting "
5959 "paths are stable over time.  The only current difference with the GNU system "
5960 "type is that the CPU part for i386 based systems is always i386.  Examples: "
5961 "i386-linux-gnu, x86_64-linux-gnu.  Example paths: "
5962 "/lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-gnu/."
5963 msgstr ""
5965 #. type: =head1
5966 #: dpkg-architecture.pod
5967 msgid "VARIABLES"
5968 msgstr ""
5970 #. type: textblock
5971 #: dpkg-architecture.pod
5972 msgid ""
5973 "The following variables are read from the environment (unless B<--force> has "
5974 "been specified) and set by B<dpkg-architecture> (see the B<TERMS> section "
5975 "for a description of the naming scheme):"
5976 msgstr ""
5978 #. type: =item
5979 #: dpkg-architecture.pod
5980 msgid "B<DEB_BUILD_ARCH>"
5981 msgstr ""
5983 #. type: textblock
5984 #: dpkg-architecture.pod
5985 msgid "The Debian architecture of the build machine."
5986 msgstr ""
5988 #. type: =item
5989 #: dpkg-architecture.pod
5990 msgid "B<DEB_BUILD_ARCH_ABI>"
5991 msgstr ""
5993 #. type: textblock
5994 #: dpkg-architecture.pod
5995 msgid "The Debian ABI name of the build machine (since dpkg 1.18.11)."
5996 msgstr ""
5998 #. type: =item
5999 #: dpkg-architecture.pod
6000 msgid "B<DEB_BUILD_ARCH_LIBC>"
6001 msgstr ""
6003 #. type: textblock
6004 #: dpkg-architecture.pod
6005 msgid "The Debian libc name of the build machine (since dpkg 1.18.11)."
6006 msgstr ""
6008 #. type: =item
6009 #: dpkg-architecture.pod
6010 msgid "B<DEB_BUILD_ARCH_OS>"
6011 msgstr ""
6013 #. type: textblock
6014 #: dpkg-architecture.pod
6015 msgid "The Debian system name of the build machine (since dpkg 1.13.2)."
6016 msgstr ""
6018 #. type: =item
6019 #: dpkg-architecture.pod
6020 msgid "B<DEB_BUILD_ARCH_CPU>"
6021 msgstr ""
6023 #. type: textblock
6024 #: dpkg-architecture.pod
6025 msgid "The Debian CPU name of the build machine (since dpkg 1.13.2)."
6026 msgstr ""
6028 #. type: =item
6029 #: dpkg-architecture.pod
6030 msgid "B<DEB_BUILD_ARCH_BITS>"
6031 msgstr ""
6033 #. type: textblock
6034 #: dpkg-architecture.pod
6035 msgid "The pointer size of the build machine (in bits; since dpkg 1.15.4)."
6036 msgstr ""
6038 #. type: =item
6039 #: dpkg-architecture.pod
6040 msgid "B<DEB_BUILD_ARCH_ENDIAN>"
6041 msgstr ""
6043 #. type: textblock
6044 #: dpkg-architecture.pod
6045 msgid "The endianness of the build machine (little / big; since dpkg 1.15.4)."
6046 msgstr ""
6048 #. type: =item
6049 #: dpkg-architecture.pod
6050 msgid "B<DEB_BUILD_GNU_CPU>"
6051 msgstr ""
6053 #. type: textblock
6054 #: dpkg-architecture.pod
6055 msgid "The GNU CPU part of B<DEB_BUILD_GNU_TYPE>."
6056 msgstr ""
6058 #. type: =item
6059 #: dpkg-architecture.pod
6060 msgid "B<DEB_BUILD_GNU_SYSTEM>"
6061 msgstr ""
6063 #. type: textblock
6064 #: dpkg-architecture.pod
6065 msgid "The GNU system part of B<DEB_BUILD_GNU_TYPE>."
6066 msgstr ""
6068 #. type: =item
6069 #: dpkg-architecture.pod
6070 msgid "B<DEB_BUILD_GNU_TYPE>"
6071 msgstr ""
6073 #. type: textblock
6074 #: dpkg-architecture.pod
6075 msgid "The GNU system type of the build machine."
6076 msgstr ""
6078 #. type: =item
6079 #: dpkg-architecture.pod
6080 msgid "B<DEB_BUILD_MULTIARCH>"
6081 msgstr ""
6083 #. type: textblock
6084 #: dpkg-architecture.pod
6085 msgid ""
6086 "The clarified GNU system type of the build machine, used for filesystem "
6087 "paths (since dpkg 1.16.0)."
6088 msgstr ""
6090 #. type: =item
6091 #: dpkg-architecture.pod
6092 msgid "B<DEB_HOST_ARCH>"
6093 msgstr ""
6095 #. type: textblock
6096 #: dpkg-architecture.pod
6097 msgid "The Debian architecture of the host machine."
6098 msgstr ""
6100 #. type: =item
6101 #: dpkg-architecture.pod
6102 msgid "B<DEB_HOST_ARCH_ABI>"
6103 msgstr ""
6105 #. type: textblock
6106 #: dpkg-architecture.pod
6107 msgid "The Debian ABI name of the host machine (since dpkg 1.18.11)."
6108 msgstr ""
6110 #. type: =item
6111 #: dpkg-architecture.pod
6112 msgid "B<DEB_HOST_ARCH_LIBC>"
6113 msgstr ""
6115 #. type: textblock
6116 #: dpkg-architecture.pod
6117 msgid "The Debian libc name of the host machine (since dpkg 1.18.11)."
6118 msgstr ""
6120 #. type: =item
6121 #: dpkg-architecture.pod
6122 msgid "B<DEB_HOST_ARCH_OS>"
6123 msgstr ""
6125 #. type: textblock
6126 #: dpkg-architecture.pod
6127 msgid "The Debian system name of the host machine (since dpkg 1.13.2)."
6128 msgstr ""
6130 #. type: =item
6131 #: dpkg-architecture.pod
6132 msgid "B<DEB_HOST_ARCH_CPU>"
6133 msgstr ""
6135 #. type: textblock
6136 #: dpkg-architecture.pod
6137 msgid "The Debian CPU name of the host machine (since dpkg 1.13.2)."
6138 msgstr ""
6140 #. type: =item
6141 #: dpkg-architecture.pod
6142 msgid "B<DEB_HOST_ARCH_BITS>"
6143 msgstr ""
6145 #. type: textblock
6146 #: dpkg-architecture.pod
6147 msgid "The pointer size of the host machine (in bits; since dpkg 1.15.4)."
6148 msgstr ""
6150 #. type: =item
6151 #: dpkg-architecture.pod
6152 msgid "B<DEB_HOST_ARCH_ENDIAN>"
6153 msgstr ""
6155 #. type: textblock
6156 #: dpkg-architecture.pod
6157 msgid "The endianness of the host machine (little / big; since dpkg 1.15.4)."
6158 msgstr ""
6160 #. type: =item
6161 #: dpkg-architecture.pod
6162 msgid "B<DEB_HOST_GNU_CPU>"
6163 msgstr ""
6165 #. type: textblock
6166 #: dpkg-architecture.pod
6167 msgid "The GNU CPU part of B<DEB_HOST_GNU_TYPE>."
6168 msgstr ""
6170 #. type: =item
6171 #: dpkg-architecture.pod
6172 msgid "B<DEB_HOST_GNU_SYSTEM>"
6173 msgstr ""
6175 #. type: textblock
6176 #: dpkg-architecture.pod
6177 msgid "The GNU system part of B<DEB_HOST_GNU_TYPE>."
6178 msgstr ""
6180 #. type: =item
6181 #: dpkg-architecture.pod
6182 msgid "B<DEB_HOST_GNU_TYPE>"
6183 msgstr ""
6185 #. type: textblock
6186 #: dpkg-architecture.pod
6187 msgid "The GNU system type of the host machine."
6188 msgstr ""
6190 #. type: =item
6191 #: dpkg-architecture.pod
6192 msgid "B<DEB_HOST_MULTIARCH>"
6193 msgstr ""
6195 #. type: textblock
6196 #: dpkg-architecture.pod
6197 msgid ""
6198 "The clarified GNU system type of the host machine, used for filesystem paths "
6199 "(since dpkg 1.16.0)."
6200 msgstr ""
6202 #. type: =item
6203 #: dpkg-architecture.pod
6204 msgid "B<DEB_TARGET_ARCH>"
6205 msgstr ""
6207 #. type: textblock
6208 #: dpkg-architecture.pod
6209 msgid "The Debian architecture of the target machine (since dpkg 1.17.14)."
6210 msgstr ""
6212 #. type: =item
6213 #: dpkg-architecture.pod
6214 msgid "B<DEB_TARGET_ARCH_ABI>"
6215 msgstr ""
6217 #. type: textblock
6218 #: dpkg-architecture.pod
6219 msgid "The Debian ABI name of the target machine (since dpkg 1.18.11)."
6220 msgstr ""
6222 #. type: =item
6223 #: dpkg-architecture.pod
6224 msgid "B<DEB_TARGET_ARCH_LIBC>"
6225 msgstr ""
6227 #. type: textblock
6228 #: dpkg-architecture.pod
6229 msgid "The Debian libc name of the target machine (since dpkg 1.18.11)."
6230 msgstr ""
6232 #. type: =item
6233 #: dpkg-architecture.pod
6234 msgid "B<DEB_TARGET_ARCH_OS>"
6235 msgstr ""
6237 #. type: textblock
6238 #: dpkg-architecture.pod
6239 msgid "The Debian system name of the target machine (since dpkg 1.17.14)."
6240 msgstr ""
6242 #. type: =item
6243 #: dpkg-architecture.pod
6244 msgid "B<DEB_TARGET_ARCH_CPU>"
6245 msgstr ""
6247 #. type: textblock
6248 #: dpkg-architecture.pod
6249 msgid "The Debian CPU name of the target machine (since dpkg 1.17.14)."
6250 msgstr ""
6252 #. type: =item
6253 #: dpkg-architecture.pod
6254 msgid "B<DEB_TARGET_ARCH_BITS>"
6255 msgstr ""
6257 #. type: textblock
6258 #: dpkg-architecture.pod
6259 msgid "The pointer size of the target machine (in bits; since dpkg 1.17.14)."
6260 msgstr ""
6262 #. type: =item
6263 #: dpkg-architecture.pod
6264 msgid "B<DEB_TARGET_ARCH_ENDIAN>"
6265 msgstr ""
6267 #. type: textblock
6268 #: dpkg-architecture.pod
6269 msgid "The endianness of the target machine (little / big; since dpkg 1.17.14)."
6270 msgstr ""
6272 #. type: =item
6273 #: dpkg-architecture.pod
6274 msgid "B<DEB_TARGET_GNU_CPU>"
6275 msgstr ""
6277 #. type: textblock
6278 #: dpkg-architecture.pod
6279 msgid "The GNU CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
6280 msgstr ""
6282 #. type: =item
6283 #: dpkg-architecture.pod
6284 msgid "B<DEB_TARGET_GNU_SYSTEM>"
6285 msgstr ""
6287 #. type: textblock
6288 #: dpkg-architecture.pod
6289 msgid "The GNU system part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
6290 msgstr ""
6292 #. type: =item
6293 #: dpkg-architecture.pod
6294 msgid "B<DEB_TARGET_GNU_TYPE>"
6295 msgstr ""
6297 #. type: textblock
6298 #: dpkg-architecture.pod
6299 msgid "The GNU system type of the target machine (since dpkg 1.17.14)."
6300 msgstr ""
6302 #. type: =item
6303 #: dpkg-architecture.pod
6304 msgid "B<DEB_TARGET_MULTIARCH>"
6305 msgstr ""
6307 #. type: textblock
6308 #: dpkg-architecture.pod
6309 msgid ""
6310 "The clarified GNU system type of the target machine, used for filesystem "
6311 "paths (since dpkg 1.17.14)."
6312 msgstr ""
6314 #. type: =head2
6315 #: dpkg-architecture.pod
6316 msgid "Architecture tables"
6317 msgstr ""
6319 #. type: textblock
6320 #: dpkg-architecture.pod
6321 msgid ""
6322 "All these files have to be present for B<dpkg-architecture> to work. Their "
6323 "location can be overridden at runtime with the environment variable "
6324 "B<DPKG_DATADIR>.  These tables contain a format B<Version> pseudo-field on "
6325 "their first line to mark their format, so that parsers can check if they "
6326 "understand it, such as \"# Version=1.0\"."
6327 msgstr ""
6329 #. type: =item
6330 #: dpkg-architecture.pod
6331 msgid "I<%PKGDATADIR%/cputable>"
6332 msgstr ""
6334 #. type: textblock
6335 #: dpkg-architecture.pod
6336 msgid ""
6337 "Table of known CPU names and mapping to their GNU name.  Format version 1.0 "
6338 "(since dpkg 1.13.2)."
6339 msgstr ""
6341 #. type: =item
6342 #: dpkg-architecture.pod
6343 msgid "I<%PKGDATADIR%/ostable>"
6344 msgstr ""
6346 #. type: textblock
6347 #: dpkg-architecture.pod
6348 msgid ""
6349 "Table of known operating system names and mapping to their GNU name.  Format "
6350 "version 2.0 (since dpkg 1.18.11)."
6351 msgstr ""
6353 #. type: =item
6354 #: dpkg-architecture.pod
6355 msgid "I<%PKGDATADIR%/tupletable>"
6356 msgstr ""
6358 #. type: textblock
6359 #: dpkg-architecture.pod
6360 msgid ""
6361 "Mapping between Debian architecture tuples and Debian architecture names.  "
6362 "Format version 1.0 (since dpkg 1.18.11)."
6363 msgstr ""
6365 #. type: =item
6366 #: dpkg-architecture.pod
6367 msgid "I<%PKGDATADIR%/abitable>"
6368 msgstr ""
6370 #. type: textblock
6371 #: dpkg-architecture.pod
6372 msgid ""
6373 "Table of Debian architecture ABI attribute overrides.  Format version 2.0 "
6374 "(since dpkg 1.18.11)."
6375 msgstr ""
6377 #. type: =head2
6378 #: dpkg-architecture.pod dpkg-buildflags.pod
6379 msgid "Packaging support"
6380 msgstr ""
6382 #. type: =item
6383 #: dpkg-architecture.pod
6384 msgid "I<%PKGDATADIR%/architecture.mk>"
6385 msgstr ""
6387 #. type: textblock
6388 #: dpkg-architecture.pod
6389 msgid ""
6390 "Makefile snippet that properly sets and exports all the variables that "
6391 "B<dpkg-architecture> outputs (since dpkg 1.16.1)."
6392 msgstr ""
6394 #. type: textblock
6395 #: dpkg-architecture.pod
6396 msgid ""
6397 "B<dpkg-buildpackage> accepts the B<-a> option and passes it to "
6398 "B<dpkg-architecture>. Other examples:"
6399 msgstr ""
6401 #. type: verbatim
6402 #: dpkg-architecture.pod
6403 #, no-wrap
6404 msgid ""
6405 " CC=i386-gnu-gcc dpkg-architecture -c debian/rules build\n"
6406 "\n"
6407 msgstr ""
6409 #. type: verbatim
6410 #: dpkg-architecture.pod
6411 #, no-wrap
6412 msgid ""
6413 " eval $(dpkg-architecture -u)\n"
6414 "\n"
6415 msgstr ""
6417 #. type: textblock
6418 #: dpkg-architecture.pod
6419 msgid ""
6420 "Check if the current or specified host architecture is equal to an "
6421 "architecture:"
6422 msgstr ""
6424 #. type: verbatim
6425 #: dpkg-architecture.pod
6426 #, no-wrap
6427 msgid ""
6428 " dpkg-architecture -elinux-alpha\n"
6429 "\n"
6430 msgstr ""
6432 #. type: verbatim
6433 #: dpkg-architecture.pod
6434 #, no-wrap
6435 msgid ""
6436 " dpkg-architecture -amips -elinux-mips\n"
6437 "\n"
6438 msgstr ""
6440 #. type: textblock
6441 #: dpkg-architecture.pod
6442 msgid "Check if the current or specified host architecture is a Linux system:"
6443 msgstr ""
6445 #. type: verbatim
6446 #: dpkg-architecture.pod
6447 #, no-wrap
6448 msgid ""
6449 " dpkg-architecture -ilinux-any\n"
6450 "\n"
6451 msgstr ""
6453 #. type: verbatim
6454 #: dpkg-architecture.pod
6455 #, no-wrap
6456 msgid ""
6457 " dpkg-architecture -ai386 -ilinux-any\n"
6458 "\n"
6459 msgstr ""
6461 #. type: =head2
6462 #: dpkg-architecture.pod dpkg-buildflags.pod
6463 msgid "Usage in debian/rules"
6464 msgstr ""
6466 #. type: textblock
6467 #: dpkg-architecture.pod
6468 msgid ""
6469 "The environment variables set by B<dpkg-architecture> are passed to "
6470 "I<debian/rules> as make variables (see make documentation). However, you "
6471 "should not rely on them, as this breaks manual invocation of the "
6472 "script. Instead, you should always initialize them using "
6473 "B<dpkg-architecture> with the B<-q> option. Here are some examples, which "
6474 "also show how you can improve the cross compilation support in your package:"
6475 msgstr ""
6477 #. type: textblock
6478 #: dpkg-architecture.pod
6479 msgid "Retrieving the GNU system type and forwarding it to ./configure:"
6480 msgstr ""
6482 #. type: verbatim
6483 #: dpkg-architecture.pod
6484 #, no-wrap
6485 msgid ""
6486 " DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)\n"
6487 " DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)\n"
6488 " [...]\n"
6489 " ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))\n"
6490 "   confflags += --build=$(DEB_HOST_GNU_TYPE)\n"
6491 " else\n"
6492 "   confflags += --build=$(DEB_BUILD_GNU_TYPE) \\\n"
6493 "                --host=$(DEB_HOST_GNU_TYPE)\n"
6494 " endif\n"
6495 " [...]\n"
6496 " ./configure $(confflags)\n"
6497 "\n"
6498 msgstr ""
6500 #. type: textblock
6501 #: dpkg-architecture.pod
6502 msgid "Doing something only for a specific architecture:"
6503 msgstr ""
6505 #. type: verbatim
6506 #: dpkg-architecture.pod
6507 #, no-wrap
6508 msgid ""
6509 " DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)\n"
6510 "\n"
6511 msgstr ""
6513 #. type: verbatim
6514 #: dpkg-architecture.pod
6515 #, no-wrap
6516 msgid ""
6517 " ifeq ($(DEB_HOST_ARCH),alpha)\n"
6518 "   [...]\n"
6519 " endif\n"
6520 "\n"
6521 msgstr ""
6523 #. type: textblock
6524 #: dpkg-architecture.pod
6525 msgid ""
6526 "or if you only need to check the CPU or OS type, use the "
6527 "B<DEB_HOST_ARCH_CPU> or B<DEB_HOST_ARCH_OS> variables."
6528 msgstr ""
6530 #. type: textblock
6531 #: dpkg-architecture.pod
6532 msgid ""
6533 "Note that you can also rely on an external Makefile snippet to properly set "
6534 "all the variables that B<dpkg-architecture> can provide:"
6535 msgstr ""
6537 #. type: verbatim
6538 #: dpkg-architecture.pod
6539 #, no-wrap
6540 msgid ""
6541 " include %PKGDATADIR%/architecture.mk\n"
6542 "\n"
6543 msgstr ""
6545 #. type: textblock
6546 #: dpkg-architecture.pod
6547 msgid ""
6548 "In any case, you should never use B<dpkg --print-architecture> to get "
6549 "architecture information during a package build."
6550 msgstr ""
6552 #. type: =head1
6553 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
6554 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
6555 #: dpkg-fsys-usrunmess.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
6556 #: dpkg-gencontrol.pod dpkg-gensymbols.pod dpkg-maintscript-helper.pod
6557 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
6558 #: dpkg-query.pod dpkg-realpath.pod dpkg-scanpackages.pod dpkg-scansources.pod
6559 #: dpkg-shlibdeps.pod dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod
6560 #: dpkg-trigger.pod dpkg-vendor.pod dpkg.pod dselect.pod
6561 #: update-alternatives.pod
6562 msgid "ENVIRONMENT"
6563 msgstr ""
6565 #. type: =item
6566 #: dpkg-architecture.pod
6567 msgid "B<DPKG_DATADIR>"
6568 msgstr ""
6570 #. type: textblock
6571 #: dpkg-architecture.pod
6572 msgid ""
6573 "If set, it will be used as the B<dpkg> data directory, where the "
6574 "architecture tables are located (since dpkg 1.14.17).  Defaults to "
6575 "«%PKGDATADIR%»."
6576 msgstr ""
6578 #. type: =item
6579 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
6580 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
6581 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
6582 #: dpkg-gensymbols.pod dpkg-maintscript-helper.pod dpkg-mergechangelogs.pod
6583 #: dpkg-name.pod dpkg-parsechangelog.pod dpkg-query.pod dpkg-realpath.pod
6584 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
6585 #: dpkg-source.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
6586 #: dpkg-vendor.pod dpkg.pod
6587 msgid "B<DPKG_COLORS>"
6588 msgstr ""
6590 #. type: textblock
6591 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
6592 #: dpkg-checkbuilddeps.pod dpkg-deb.pod dpkg-distaddfile.pod dpkg-divert.pod
6593 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
6594 #: dpkg-gensymbols.pod dpkg-mergechangelogs.pod dpkg-name.pod
6595 #: dpkg-parsechangelog.pod dpkg-query.pod dpkg-scanpackages.pod
6596 #: dpkg-scansources.pod dpkg-shlibdeps.pod dpkg-source.pod dpkg-split.pod
6597 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg-vendor.pod dpkg.pod
6598 msgid ""
6599 "Sets the color mode (since dpkg 1.18.5).  The currently accepted values are: "
6600 "B<auto> (default), B<always> and B<never>."
6601 msgstr ""
6603 #. type: =item
6604 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
6605 #: dpkg-checkbuilddeps.pod dpkg-distaddfile.pod dpkg-genbuildinfo.pod
6606 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-gensymbols.pod
6607 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
6608 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
6609 #: dpkg-source.pod dpkg-vendor.pod
6610 msgid "B<DPKG_NLS>"
6611 msgstr ""
6613 #. type: textblock
6614 #: dpkg-architecture.pod dpkg-buildflags.pod dpkg-buildpackage.pod
6615 #: dpkg-checkbuilddeps.pod dpkg-distaddfile.pod dpkg-genbuildinfo.pod
6616 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-gensymbols.pod
6617 #: dpkg-mergechangelogs.pod dpkg-name.pod dpkg-parsechangelog.pod
6618 #: dpkg-scanpackages.pod dpkg-scansources.pod dpkg-shlibdeps.pod
6619 #: dpkg-source.pod dpkg-vendor.pod
6620 msgid ""
6621 "If set, it will be used to decide whether to activate Native Language "
6622 "Support, also known as internationalization (or i18n) support (since dpkg "
6623 "1.19.0).  The accepted values are: B<0> and B<1> (default)."
6624 msgstr ""
6626 #. type: textblock
6627 #: dpkg-architecture.pod
6628 msgid "All long command and option names available only since dpkg 1.17.17."
6629 msgstr ""
6631 #. type: textblock
6632 #: dpkg-architecture.pod
6633 msgid "B<dpkg-buildpackage>(1)."
6634 msgstr ""
6636 #. type: textblock
6637 #: dpkg-buildflags.pod
6638 msgid "dpkg-buildflags - returns build flags to use during package build"
6639 msgstr ""
6641 #. type: textblock
6642 #: dpkg-buildflags.pod
6643 msgid "B<dpkg-buildflags> [I<option>...] [I<command>]"
6644 msgstr ""
6646 #. type: textblock
6647 #: dpkg-buildflags.pod
6648 msgid ""
6649 "B<dpkg-buildflags> is a tool to retrieve compilation flags to use during "
6650 "build of Debian packages."
6651 msgstr ""
6653 #. type: textblock
6654 #: dpkg-buildflags.pod
6655 msgid ""
6656 "The default flags are defined by the vendor but they can be "
6657 "extended/overridden in several ways:"
6658 msgstr ""
6660 #. type: =item
6661 #: dpkg-buildflags.pod
6662 msgid "1."
6663 msgstr ""
6665 #. type: textblock
6666 #: dpkg-buildflags.pod
6667 msgid "system-wide with B<%PKGCONFDIR%/buildflags.conf>;"
6668 msgstr ""
6670 #. type: =item
6671 #: dpkg-buildflags.pod
6672 msgid "2."
6673 msgstr ""
6675 #. type: textblock
6676 #: dpkg-buildflags.pod
6677 msgid ""
6678 "for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where "
6679 "B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;"
6680 msgstr ""
6682 #. type: =item
6683 #: dpkg-buildflags.pod
6684 msgid "3."
6685 msgstr ""
6687 #. type: textblock
6688 #: dpkg-buildflags.pod
6689 msgid ""
6690 "temporarily by the user with environment variables (see section "
6691 "B<ENVIRONMENT>);"
6692 msgstr ""
6694 #. type: =item
6695 #: dpkg-buildflags.pod
6696 msgid "4."
6697 msgstr ""
6699 #. type: textblock
6700 #: dpkg-buildflags.pod
6701 msgid ""
6702 "dynamically by the package maintainer with environment variables set via "
6703 "B<debian/rules> (see section B<ENVIRONMENT>)."
6704 msgstr ""
6706 #. type: textblock
6707 #: dpkg-buildflags.pod
6708 msgid "The configuration files can contain four types of directives:"
6709 msgstr ""
6711 #. type: =item
6712 #: dpkg-buildflags.pod
6713 msgid "B<SET> I<flag> I<value>"
6714 msgstr ""
6716 #. type: textblock
6717 #: dpkg-buildflags.pod
6718 msgid "Override the flag named I<flag> to have the value I<value>."
6719 msgstr ""
6721 #. type: =item
6722 #: dpkg-buildflags.pod
6723 msgid "B<STRIP> I<flag> I<value>"
6724 msgstr ""
6726 #. type: textblock
6727 #: dpkg-buildflags.pod
6728 msgid "Strip from the flag named I<flag> all the build flags listed in I<value>."
6729 msgstr ""
6731 #. type: =item
6732 #: dpkg-buildflags.pod
6733 msgid "B<APPEND> I<flag> I<value>"
6734 msgstr ""
6736 #. type: textblock
6737 #: dpkg-buildflags.pod
6738 msgid ""
6739 "Extend the flag named I<flag> by appending the options given in I<value>.  A "
6740 "space is prepended to the appended value if the flag's current value is "
6741 "non-empty."
6742 msgstr ""
6744 #. type: =item
6745 #: dpkg-buildflags.pod
6746 msgid "B<PREPEND> I<flag> I<value>"
6747 msgstr ""
6749 #. type: textblock
6750 #: dpkg-buildflags.pod
6751 msgid ""
6752 "Extend the flag named I<flag> by prepending the options given in I<value>.  "
6753 "A space is appended to the prepended value if the flag's current value is "
6754 "non-empty."
6755 msgstr ""
6757 #. type: textblock
6758 #: dpkg-buildflags.pod
6759 msgid ""
6760 "The configuration files can contain comments on lines starting with a hash "
6761 "(#). Empty lines are also ignored."
6762 msgstr ""
6764 #. type: =item
6765 #: dpkg-buildflags.pod
6766 msgid "B<--dump>"
6767 msgstr ""
6769 #. type: textblock
6770 #: dpkg-buildflags.pod
6771 msgid ""
6772 "Print to standard output all compilation flags and their values. It prints "
6773 "one flag per line separated from its value by an equal sign "
6774 "(“I<flag>=I<value>”). This is the default action."
6775 msgstr ""
6777 #. type: =item
6778 #: dpkg-buildflags.pod
6779 msgid "B<--list>"
6780 msgstr ""
6782 #. type: textblock
6783 #: dpkg-buildflags.pod
6784 msgid ""
6785 "Print the list of flags supported by the current vendor (one per line). See "
6786 "the B<SUPPORTED FLAGS> section for more information about them."
6787 msgstr ""
6789 #. type: =item
6790 #: dpkg-buildflags.pod
6791 msgid "B<--status>"
6792 msgstr ""
6794 #. type: textblock
6795 #: dpkg-buildflags.pod
6796 msgid ""
6797 "Display any information that can be useful to explain the behaviour of "
6798 "B<dpkg-buildflags> (since dpkg 1.16.5): relevant environment variables, "
6799 "current vendor, state of all feature flags.  Also print the resulting "
6800 "compiler flags with their origin."
6801 msgstr ""
6803 #. type: textblock
6804 #: dpkg-buildflags.pod
6805 msgid ""
6806 "This is intended to be run from B<debian/rules>, so that the build log keeps "
6807 "a clear trace of the build flags used. This can be useful to diagnose "
6808 "problems related to them."
6809 msgstr ""
6811 #. type: =item
6812 #: dpkg-buildflags.pod
6813 msgid "B<--export=>I<format>"
6814 msgstr ""
6816 #. type: textblock
6817 #: dpkg-buildflags.pod
6818 msgid ""
6819 "Print to standard output commands that can be used to export all the "
6820 "compilation flags for some particular tool. If the I<format> value is not "
6821 "given, B<sh> is assumed. Only compilation flags starting with an upper case "
6822 "character are included, others are assumed to not be suitable for the "
6823 "environment. Supported formats:"
6824 msgstr ""
6826 #. type: =item
6827 #: dpkg-buildflags.pod
6828 msgid "B<sh>"
6829 msgstr ""
6831 #. type: textblock
6832 #: dpkg-buildflags.pod
6833 msgid ""
6834 "Shell commands to set and export all the compilation flags in the "
6835 "environment. The flag values are quoted so the output is ready for "
6836 "evaluation by a shell."
6837 msgstr ""
6839 #. type: =item
6840 #: dpkg-buildflags.pod
6841 msgid "B<cmdline>"
6842 msgstr ""
6844 #. type: textblock
6845 #: dpkg-buildflags.pod
6846 msgid ""
6847 "Arguments to pass to a build program's command line to use all the "
6848 "compilation flags (since dpkg 1.17.0). The flag values are quoted in shell "
6849 "syntax."
6850 msgstr ""
6852 #. type: =item
6853 #: dpkg-buildflags.pod
6854 msgid "B<configure>"
6855 msgstr ""
6857 #. type: textblock
6858 #: dpkg-buildflags.pod
6859 msgid "This is a legacy alias for B<cmdline>."
6860 msgstr ""
6862 #. type: =item
6863 #: dpkg-buildflags.pod
6864 msgid "B<make>"
6865 msgstr ""
6867 #. type: textblock
6868 #: dpkg-buildflags.pod
6869 msgid ""
6870 "Make directives to set and export all the compilation flags in the "
6871 "environment. Output can be written to a Makefile fragment and evaluated "
6872 "using an B<include> directive."
6873 msgstr ""
6875 #. type: =item
6876 #: dpkg-buildflags.pod
6877 msgid "B<--get> I<flag>"
6878 msgstr ""
6880 #. type: textblock
6881 #: dpkg-buildflags.pod
6882 msgid ""
6883 "Print the value of the flag on standard output. Exits with 0 if the flag is "
6884 "known otherwise exits with 1."
6885 msgstr ""
6887 #. type: =item
6888 #: dpkg-buildflags.pod
6889 msgid "B<--origin> I<flag>"
6890 msgstr ""
6892 #. type: textblock
6893 #: dpkg-buildflags.pod
6894 msgid ""
6895 "Print the origin of the value that is returned by B<--get>. Exits with 0 if "
6896 "the flag is known otherwise exits with 1. The origin can be one of the "
6897 "following values:"
6898 msgstr ""
6900 #. type: =item
6901 #: dpkg-buildflags.pod
6902 msgid "B<vendor>"
6903 msgstr ""
6905 #. type: textblock
6906 #: dpkg-buildflags.pod
6907 msgid "the original flag set by the vendor is returned;"
6908 msgstr ""
6910 #. type: =item
6911 #: dpkg-buildflags.pod
6912 msgid "B<system>"
6913 msgstr ""
6915 #. type: textblock
6916 #: dpkg-buildflags.pod
6917 msgid "the flag is set/modified by a system-wide configuration;"
6918 msgstr ""
6920 #. type: =item
6921 #: dpkg-buildflags.pod
6922 msgid "B<user>"
6923 msgstr ""
6925 #. type: textblock
6926 #: dpkg-buildflags.pod
6927 msgid "the flag is set/modified by a user-specific configuration;"
6928 msgstr ""
6930 #. type: =item
6931 #: dpkg-buildflags.pod
6932 msgid "B<env>"
6933 msgstr ""
6935 #. type: textblock
6936 #: dpkg-buildflags.pod
6937 msgid "the flag is set/modified by an environment-specific configuration."
6938 msgstr ""
6940 #. type: =item
6941 #: dpkg-buildflags.pod
6942 msgid "B<--query>"
6943 msgstr ""
6945 #. type: textblock
6946 #: dpkg-buildflags.pod
6947 msgid ""
6948 "Print any information that can be useful to explain the behaviour of the "
6949 "program: current vendor, relevant environment variables, feature areas, "
6950 "state of all feature flags, whether a feature is handled as a builtin "
6951 "default by the compiler (since dpkg 1.21.14), and the compiler flags with "
6952 "their origin (since dpkg 1.19.0)."
6953 msgstr ""
6955 #. type: textblock
6956 #: dpkg-buildflags.pod
6957 msgid "For example:"
6958 msgstr ""
6960 #. type: verbatim
6961 #: dpkg-buildflags.pod
6962 #, no-wrap
6963 msgid ""
6964 " Vendor: Debian\n"
6965 " Environment:\n"
6966 "  DEB_CFLAGS_SET=-O0 -Wall\n"
6967 "\n"
6968 msgstr ""
6970 #. type: verbatim
6971 #: dpkg-buildflags.pod
6972 #, no-wrap
6973 msgid ""
6974 " Area: qa\n"
6975 " Features:\n"
6976 "  bug=no\n"
6977 "  canary=no\n"
6978 " Builtins:\n"
6979 "\n"
6980 msgstr ""
6982 #. type: verbatim
6983 #: dpkg-buildflags.pod
6984 #, no-wrap
6985 msgid ""
6986 " Area: hardening\n"
6987 " Features:\n"
6988 "  pie=no\n"
6989 " Builtins:\n"
6990 "  pie=yes\n"
6991 "\n"
6992 msgstr ""
6994 #. type: verbatim
6995 #: dpkg-buildflags.pod
6996 #, no-wrap
6997 msgid ""
6998 " Area: reproducible\n"
6999 " Features:\n"
7000 "  timeless=no\n"
7001 " Builtins:\n"
7002 "\n"
7003 msgstr ""
7005 #. type: verbatim
7006 #: dpkg-buildflags.pod
7007 #, no-wrap
7008 msgid ""
7009 " Flag: CFLAGS\n"
7010 " Value: -O0 -Wall\n"
7011 " Origin: env\n"
7012 "\n"
7013 msgstr ""
7015 #. type: verbatim
7016 #: dpkg-buildflags.pod
7017 #, no-wrap
7018 msgid ""
7019 " Flag: CPPFLAGS\n"
7020 " Value: -D_FORTIFY_SOURCE=2\n"
7021 " Origin: vendor\n"
7022 "\n"
7023 msgstr ""
7025 #. type: =item
7026 #: dpkg-buildflags.pod
7027 msgid "B<--query-features> I<area>"
7028 msgstr ""
7030 #. type: textblock
7031 #: dpkg-buildflags.pod
7032 msgid ""
7033 "Print the features enabled for a given area (since dpkg 1.16.2).  If the "
7034 "feature is handled (even if only on some architectures) as a builtin default "
7035 "by the compiler, then a B<Builtin> field is printed (since dpkg 1.21.14).  "
7036 "The only currently recognized areas on Debian and derivatives are B<future>, "
7037 "B<qa>, B<reproducible>, B<sanitize> and B<hardening>, see the B<FEATURE "
7038 "AREAS> section for more details.  Exits with 0 if the area is known "
7039 "otherwise exits with 1."
7040 msgstr ""
7042 #. type: textblock
7043 #: dpkg-buildflags.pod
7044 msgid "The output is in RFC822 format, with one section per feature.  For example:"
7045 msgstr ""
7047 #. type: verbatim
7048 #: dpkg-buildflags.pod
7049 #, no-wrap
7050 msgid ""
7051 " Feature: pie\n"
7052 " Enabled: yes\n"
7053 " Builtin: yes\n"
7054 "\n"
7055 msgstr ""
7057 #. type: verbatim
7058 #: dpkg-buildflags.pod
7059 #, no-wrap
7060 msgid ""
7061 " Feature: stackprotector\n"
7062 " Enabled: yes\n"
7063 "\n"
7064 msgstr ""
7066 #. type: =item
7067 #: dpkg-buildflags.pod dpkg-mergechangelogs.pod dpkg-scansources.pod
7068 #: dpkg-statoverride.pod dpkg-vendor.pod update-alternatives.pod
7069 msgid "B<--help>"
7070 msgstr ""
7072 #. type: =head1
7073 #: dpkg-buildflags.pod
7074 msgid "SUPPORTED FLAGS"
7075 msgstr ""
7077 #. type: =item
7078 #: dpkg-buildflags.pod
7079 msgid "B<ASFLAGS>"
7080 msgstr ""
7082 #. type: textblock
7083 #: dpkg-buildflags.pod
7084 msgid "Options for the assembler. Default value: empty. Since dpkg 1.21.0."
7085 msgstr ""
7087 #. type: =item
7088 #: dpkg-buildflags.pod
7089 msgid "B<CFLAGS>"
7090 msgstr ""
7092 #. type: textblock
7093 #: dpkg-buildflags.pod
7094 msgid ""
7095 "Options for the C compiler. The default value set by the vendor includes "
7096 "B<-g> and the default optimization level (B<-O2> usually, or B<-O0> if the "
7097 "B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>)."
7098 msgstr ""
7100 #. type: =item
7101 #: dpkg-buildflags.pod
7102 msgid "B<CPPFLAGS>"
7103 msgstr ""
7105 #. type: textblock
7106 #: dpkg-buildflags.pod
7107 msgid "Options for the C preprocessor. Default value: empty."
7108 msgstr ""
7110 #. type: =item
7111 #: dpkg-buildflags.pod
7112 msgid "B<CXXFLAGS>"
7113 msgstr ""
7115 #. type: textblock
7116 #: dpkg-buildflags.pod
7117 msgid "Options for the C++ compiler. Same as B<CFLAGS>."
7118 msgstr ""
7120 #. type: =item
7121 #: dpkg-buildflags.pod
7122 msgid "B<OBJCFLAGS>"
7123 msgstr ""
7125 #. type: textblock
7126 #: dpkg-buildflags.pod
7127 msgid "Options for the Objective C compiler. Same as B<CFLAGS>."
7128 msgstr ""
7130 #. type: =item
7131 #: dpkg-buildflags.pod
7132 msgid "B<OBJCXXFLAGS>"
7133 msgstr ""
7135 #. type: textblock
7136 #: dpkg-buildflags.pod
7137 msgid "Options for the Objective C++ compiler. Same as B<CXXFLAGS>."
7138 msgstr ""
7140 #. type: =item
7141 #: dpkg-buildflags.pod
7142 msgid "B<GCJFLAGS>"
7143 msgstr ""
7145 #. type: textblock
7146 #: dpkg-buildflags.pod
7147 msgid "Options for the GNU Java compiler (gcj). A subset of B<CFLAGS>."
7148 msgstr ""
7150 #. type: =item
7151 #: dpkg-buildflags.pod
7152 msgid "B<DFLAGS>"
7153 msgstr ""
7155 #. type: textblock
7156 #: dpkg-buildflags.pod
7157 msgid "Options for the D compiler (ldc or gdc). Since dpkg 1.20.6."
7158 msgstr ""
7160 #. type: =item
7161 #: dpkg-buildflags.pod
7162 msgid "B<FFLAGS>"
7163 msgstr ""
7165 #. type: textblock
7166 #: dpkg-buildflags.pod
7167 msgid "Options for the Fortran 77 compiler. A subset of B<CFLAGS>."
7168 msgstr ""
7170 #. type: =item
7171 #: dpkg-buildflags.pod
7172 msgid "B<FCFLAGS>"
7173 msgstr ""
7175 #. type: textblock
7176 #: dpkg-buildflags.pod
7177 msgid "Options for the Fortran 9x compiler. Same as B<FFLAGS>."
7178 msgstr ""
7180 #. type: =item
7181 #: dpkg-buildflags.pod
7182 msgid "B<LDFLAGS>"
7183 msgstr ""
7185 #. type: textblock
7186 #: dpkg-buildflags.pod
7187 msgid ""
7188 "Options passed to the compiler when linking executables or shared objects "
7189 "(if the linker is called directly, then B<-Wl> and B<,> have to be stripped "
7190 "from these options). Default value: empty."
7191 msgstr ""
7193 #. type: textblock
7194 #: dpkg-buildflags.pod
7195 msgid ""
7196 "New flags might be added in the future if the need arises (for example to "
7197 "support other languages)."
7198 msgstr ""
7200 #. type: =head1
7201 #: dpkg-buildflags.pod
7202 msgid "FEATURE AREAS"
7203 msgstr ""
7205 #. type: textblock
7206 #: dpkg-buildflags.pod
7207 msgid ""
7208 "Each area feature can be enabled and disabled in the B<DEB_BUILD_OPTIONS> "
7209 "and B<DEB_BUILD_MAINT_OPTIONS> environment variable's area value with the "
7210 "‘B<+>’ and ‘B<->’ modifier.  For example, to enable the B<hardening> “pie” "
7211 "feature and disable the “fortify” feature you can do this in "
7212 "B<debian/rules>:"
7213 msgstr ""
7215 #. type: verbatim
7216 #: dpkg-buildflags.pod
7217 #, no-wrap
7218 msgid ""
7219 "    export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify\n"
7220 "\n"
7221 msgstr ""
7223 #. type: textblock
7224 #: dpkg-buildflags.pod
7225 msgid ""
7226 "The special feature B<all> (valid in any area) can be used to enable or "
7227 "disable all area features at the same time.  Thus disabling everything in "
7228 "the B<hardening> area and enabling only “format” and “fortify” can be "
7229 "achieved with:"
7230 msgstr ""
7232 #. type: verbatim
7233 #: dpkg-buildflags.pod
7234 #, no-wrap
7235 msgid ""
7236 "    export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify\n"
7237 "\n"
7238 msgstr ""
7240 #. type: =head2
7241 #: dpkg-buildflags.pod
7242 msgid "future"
7243 msgstr ""
7245 #. type: textblock
7246 #: dpkg-buildflags.pod
7247 msgid ""
7248 "Several compile-time options (detailed below) can be used to enable features "
7249 "that should be enabled by default, but cannot due to backwards compatibility "
7250 "reasons."
7251 msgstr ""
7253 #. type: =item
7254 #: dpkg-buildflags.pod
7255 msgid "B<lfs>"
7256 msgstr ""
7258 #. type: textblock
7259 #: dpkg-buildflags.pod
7260 msgid ""
7261 "This setting (disabled by default) enables Large File Support on 32-bit "
7262 "architectures where their ABI does not include LFS by default, by adding "
7263 "B<-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64> to B<CPPFLAGS>."
7264 msgstr ""
7266 #. type: =head2
7267 #: dpkg-buildflags.pod
7268 msgid "qa"
7269 msgstr ""
7271 #. type: textblock
7272 #: dpkg-buildflags.pod
7273 msgid ""
7274 "Several compile-time options (detailed below) can be used to help detect "
7275 "problems in the source code or build system."
7276 msgstr ""
7278 #. type: =item
7279 #: dpkg-buildflags.pod
7280 msgid "B<bug>"
7281 msgstr ""
7283 #. type: textblock
7284 #: dpkg-buildflags.pod
7285 msgid ""
7286 "This setting (disabled by default) adds any warning option that reliably "
7287 "detects problematic source code. The warnings are fatal.  The only currently "
7288 "supported flags are B<CFLAGS> and B<CXXFLAGS> with flags set to "
7289 "B<-Werror=array-bounds>, B<-Werror=clobbered>, "
7290 "B<-Werror=implicit-function-declaration> and "
7291 "B<-Werror=volatile-register-var>."
7292 msgstr ""
7294 #. type: =item
7295 #: dpkg-buildflags.pod
7296 msgid "B<canary>"
7297 msgstr ""
7299 #. type: textblock
7300 #: dpkg-buildflags.pod
7301 msgid ""
7302 "This setting (disabled by default) adds dummy canary options to the build "
7303 "flags, so that the build logs can be checked for how the build flags "
7304 "propagate and to allow finding any omission of normal build flag settings.  "
7305 "The only currently supported flags are B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, "
7306 "B<CXXFLAGS> and B<OBJCXXFLAGS> with flags set to "
7307 "B<-D__DEB_CANARY_>I<flag>_I<random-id>B<__>, and B<LDFLAGS> set to "
7308 "B<-Wl,-z,deb-canary->I<random-id>."
7309 msgstr ""
7311 #. type: =head2
7312 #: dpkg-buildflags.pod
7313 msgid "optimize"
7314 msgstr ""
7316 #. type: textblock
7317 #: dpkg-buildflags.pod
7318 msgid ""
7319 "Several compile-time options (detailed below) can be used to help optimize a "
7320 "resulting binary (since dpkg 1.21.0).  B<Note>: enabling B<all> these "
7321 "options can result in unreproducible binary artifacts."
7322 msgstr ""
7324 #. type: =item
7325 #: dpkg-buildflags.pod
7326 msgid "B<lto>"
7327 msgstr ""
7329 #. type: textblock
7330 #: dpkg-buildflags.pod
7331 msgid ""
7332 "This setting (since dpkg 1.21.0; disabled by default) enables Link Time "
7333 "Optimization by adding B<-flto=auto -ffat-lto-objects> to B<CFLAGS>, "
7334 "B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS>, "
7335 "B<FCFLAGS> and B<LDFLAGS>."
7336 msgstr ""
7338 #. type: =head2
7339 #: dpkg-buildflags.pod
7340 msgid "sanitize"
7341 msgstr ""
7343 #. type: textblock
7344 #: dpkg-buildflags.pod
7345 msgid ""
7346 "Several compile-time options (detailed below) can be used to help sanitize a "
7347 "resulting binary against memory corruptions, memory leaks, use after free, "
7348 "threading data races and undefined behavior bugs.  B<Note>: these options "
7349 "should B<not> be used for production builds as they can reduce reliability "
7350 "for conformant code, reduce security or even functionality."
7351 msgstr ""
7353 #. type: =item
7354 #: dpkg-buildflags.pod
7355 msgid "B<address>"
7356 msgstr ""
7358 #. type: textblock
7359 #: dpkg-buildflags.pod
7360 msgid ""
7361 "This setting (disabled by default) adds B<-fsanitize=address> to B<LDFLAGS> "
7362 "and B<-fsanitize=address -fno-omit-frame-pointer> to B<CFLAGS> and "
7363 "B<CXXFLAGS>."
7364 msgstr ""
7366 #. type: =item
7367 #: dpkg-buildflags.pod
7368 msgid "B<thread>"
7369 msgstr ""
7371 #. type: textblock
7372 #: dpkg-buildflags.pod
7373 msgid ""
7374 "This setting (disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, "
7375 "B<CXXFLAGS> and B<LDFLAGS>."
7376 msgstr ""
7378 #. type: =item
7379 #: dpkg-buildflags.pod
7380 msgid "B<leak>"
7381 msgstr ""
7383 #. type: textblock
7384 #: dpkg-buildflags.pod
7385 msgid ""
7386 "This setting (disabled by default) adds B<-fsanitize=leak> to B<LDFLAGS>. It "
7387 "gets automatically disabled if either the B<address> or the B<thread> "
7388 "features are enabled, as they imply it."
7389 msgstr ""
7391 #. type: =item
7392 #: dpkg-buildflags.pod
7393 msgid "B<undefined>"
7394 msgstr ""
7396 #. type: textblock
7397 #: dpkg-buildflags.pod
7398 msgid ""
7399 "This setting (disabled by default) adds B<-fsanitize=undefined> to "
7400 "B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>."
7401 msgstr ""
7403 #. type: =head2
7404 #: dpkg-buildflags.pod
7405 msgid "hardening"
7406 msgstr ""
7408 #. type: textblock
7409 #: dpkg-buildflags.pod
7410 msgid ""
7411 "Several compile-time options (detailed below) can be used to help harden a "
7412 "resulting binary against memory corruption attacks, or provide additional "
7413 "warning messages during compilation.  Except as noted below, these are "
7414 "enabled by default for architectures that support them."
7415 msgstr ""
7417 #. type: =item
7418 #: dpkg-buildflags.pod
7419 msgid "B<format>"
7420 msgstr ""
7422 #. type: textblock
7423 #: dpkg-buildflags.pod
7424 msgid ""
7425 "This setting (enabled by default) adds B<-Wformat -Werror=format-security> "
7426 "to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> and B<OBJCXXFLAGS>.  This will warn "
7427 "about improper format string uses, and will fail when format functions are "
7428 "used in a way that represent possible security problems. At present, this "
7429 "warns about calls to B<printf> and B<scanf> functions where the format "
7430 "string is not a string literal and there are no format arguments, as in "
7431 "B<printf(foo);> instead of B<printf(\"%s\", foo);> This may be a security "
7432 "hole if the format string came from untrusted input and contains ‘%n’."
7433 msgstr ""
7435 #. type: =item
7436 #: dpkg-buildflags.pod
7437 msgid "B<fortify>"
7438 msgstr ""
7440 #. type: textblock
7441 #: dpkg-buildflags.pod
7442 msgid ""
7443 "This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to "
7444 "B<CPPFLAGS>. During code generation the compiler knows a great deal of "
7445 "information about buffer sizes (where possible), and attempts to replace "
7446 "insecure unlimited length buffer function calls with length-limited "
7447 "ones. This is especially useful for old, crufty code.  Additionally, format "
7448 "strings in writable memory that contain ‘%n’ are blocked. If an application "
7449 "depends on such a format string, it will need to be worked around."
7450 msgstr ""
7452 #. type: textblock
7453 #: dpkg-buildflags.pod
7454 msgid ""
7455 "Note that for this option to have any effect, the source must also be "
7456 "compiled with B<-O1> or higher. If the environment variable "
7457 "B<DEB_BUILD_OPTIONS> contains I<noopt>, then B<fortify> support will be "
7458 "disabled, due to new warnings being issued by glibc 2.16 and later."
7459 msgstr ""
7461 #. type: =item
7462 #: dpkg-buildflags.pod
7463 msgid "B<stackprotector>"
7464 msgstr ""
7466 #. type: textblock
7467 #: dpkg-buildflags.pod
7468 msgid ""
7469 "This setting (enabled by default if stackprotectorstrong is not in use) adds "
7470 "B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS>, B<CXXFLAGS>, "
7471 "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>.  This "
7472 "adds safety checks against stack overwrites. This renders many potential "
7473 "code injection attacks into aborting situations. In the best case this turns "
7474 "code injection vulnerabilities into denial of service or into non-issues "
7475 "(depending on the application)."
7476 msgstr ""
7478 #. type: textblock
7479 #: dpkg-buildflags.pod
7480 msgid ""
7481 "This feature requires linking against glibc (or another provider of "
7482 "B<__stack_chk_fail>), so needs to be disabled when building with "
7483 "B<-nostdlib> or B<-ffreestanding> or similar."
7484 msgstr ""
7486 #. type: =item
7487 #: dpkg-buildflags.pod
7488 msgid "B<stackprotectorstrong>"
7489 msgstr ""
7491 #. type: textblock
7492 #: dpkg-buildflags.pod
7493 msgid ""
7494 "This setting (enabled by default) adds B<-fstack-protector-strong> to "
7495 "B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> "
7496 "and B<FCFLAGS>.  This is a stronger variant of B<stackprotector>, but "
7497 "without significant performance penalties."
7498 msgstr ""
7500 #. type: textblock
7501 #: dpkg-buildflags.pod
7502 msgid "Disabling B<stackprotector> will also disable this setting."
7503 msgstr ""
7505 #. type: textblock
7506 #: dpkg-buildflags.pod
7507 msgid ""
7508 "This feature has the same requirements as B<stackprotector>, and in addition "
7509 "also requires gcc 4.9 and later."
7510 msgstr ""
7512 #. type: =item
7513 #: dpkg-buildflags.pod
7514 msgid "B<relro>"
7515 msgstr ""
7517 #. type: textblock
7518 #: dpkg-buildflags.pod
7519 msgid ""
7520 "This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>.  "
7521 "During program load, several ELF memory sections need to be written to by "
7522 "the linker. This flags the loader to turn these sections read-only before "
7523 "turning over control to the program. Most notably this prevents GOT "
7524 "overwrite attacks. If this option is disabled, B<bindnow> will become "
7525 "disabled as well."
7526 msgstr ""
7528 #. type: =item
7529 #: dpkg-buildflags.pod
7530 msgid "B<bindnow>"
7531 msgstr ""
7533 #. type: textblock
7534 #: dpkg-buildflags.pod
7535 msgid ""
7536 "This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During "
7537 "program load, all dynamic symbols are resolved, allowing for the entire PLT "
7538 "to be marked read-only (due to B<relro> above). The option cannot become "
7539 "enabled if B<relro> is not enabled."
7540 msgstr ""
7542 #. type: =item
7543 #: dpkg-buildflags.pod
7544 msgid "B<pie>"
7545 msgstr ""
7547 #. type: textblock
7548 #: dpkg-buildflags.pod
7549 msgid ""
7550 "This setting (with no global default since dpkg 1.18.23, as it is enabled by "
7551 "default now by gcc on the amd64, arm64, armel, armhf, hurd-i386, i386, "
7552 "kfreebsd-amd64, kfreebsd-i386, mips, mipsel, mips64el, powerpc, ppc64, "
7553 "ppc64el, riscv64, s390x, sparc and sparc64 Debian architectures) adds the "
7554 "required options to enable or disable PIE via gcc specs files, if needed, "
7555 "depending on whether gcc injects on that architecture the flags by itself or "
7556 "not.  When the setting is enabled and gcc injects the flags, it adds "
7557 "nothing.  When the setting is enabled and gcc does not inject the flags, it "
7558 "adds B<-fPIE> (via I<%PKGDATADIR%/pie-compiler.specs>) to B<CFLAGS>, "
7559 "B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and "
7560 "B<FCFLAGS>, and B<-fPIE -pie> (via I<%PKGDATADIR%/pie-link.specs>) to "
7561 "B<LDFLAGS>.  When the setting is disabled and gcc injects the flags, it adds "
7562 "B<-fno-PIE> (via I<%PKGDATADIR%/no-pie-compile.specs>) to B<CFLAGS>, "
7563 "B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and "
7564 "B<FCFLAGS>, and B<-fno-PIE -no-pie> (via I<%PKGDATADIR%/no-pie-link.specs>) "
7565 "to B<LDFLAGS>."
7566 msgstr ""
7568 #. type: textblock
7569 #: dpkg-buildflags.pod
7570 msgid ""
7571 "Position Independent Executable (PIE) is needed to take advantage of Address "
7572 "Space Layout Randomization (ASLR), supported by some kernel versions.  While "
7573 "ASLR can already be enforced for data areas in the stack and heap (brk and "
7574 "mmap), the code areas must be compiled as position-independent.  Shared "
7575 "libraries already do this (B<-fPIC>), so they gain ASLR automatically, but "
7576 "binary .text regions need to be built as PIE to gain ASLR.  When this "
7577 "happens, ROP (Return Oriented Programming) attacks are much harder since "
7578 "there are no static locations to bounce off of during a memory corruption "
7579 "attack."
7580 msgstr ""
7582 #. type: textblock
7583 #: dpkg-buildflags.pod
7584 msgid ""
7585 "PIE is not compatible with B<-fPIC>, so in general care must be taken when "
7586 "building shared objects. But because the PIE flags emitted get injected via "
7587 "gcc specs files, it should always be safe to unconditionally set them "
7588 "regardless of the object type being compiled or linked."
7589 msgstr ""
7591 #. type: textblock
7592 #: dpkg-buildflags.pod
7593 msgid ""
7594 "Static libraries can be used by programs or other shared libraries.  "
7595 "Depending on the flags used to compile all the objects within a static "
7596 "library, these libraries will be usable by different sets of objects:"
7597 msgstr ""
7599 #. type: =item
7600 #: dpkg-buildflags.pod
7601 msgid "none"
7602 msgstr ""
7604 #. type: textblock
7605 #: dpkg-buildflags.pod
7606 msgid "Cannot be linked into a PIE program, nor a shared library."
7607 msgstr ""
7609 #. type: =item
7610 #: dpkg-buildflags.pod
7611 msgid "B<-fPIE>"
7612 msgstr ""
7614 #. type: textblock
7615 #: dpkg-buildflags.pod
7616 msgid "Can be linked into any program, but not a shared library (recommended)."
7617 msgstr ""
7619 #. type: =item
7620 #: dpkg-buildflags.pod
7621 msgid "B<-fPIC>"
7622 msgstr ""
7624 #. type: textblock
7625 #: dpkg-buildflags.pod
7626 msgid "Can be linked into any program and shared library."
7627 msgstr ""
7629 #. type: textblock
7630 #: dpkg-buildflags.pod
7631 msgid ""
7632 "If there is a need to set these flags manually, bypassing the gcc specs "
7633 "injection, there are several things to take into account. Unconditionally "
7634 "and explicitly passing B<-fPIE>, B<-fpie> or B<-pie> to a build-system using "
7635 "libtool is safe as these flags will get stripped when building shared "
7636 "libraries.  Otherwise on projects that build both programs and shared "
7637 "libraries you might need to make sure that when building the shared "
7638 "libraries B<-fPIC> is always passed last (so that it overrides any previous "
7639 "B<-PIE>) to compilation flags such as B<CFLAGS>, and B<-shared> is passed "
7640 "last (so that it overrides any previous B<-pie>) to linking flags such as "
7641 "B<LDFLAGS>. B<Note:> This should not be needed with the default gcc specs "
7642 "machinery."
7643 msgstr ""
7645 #. type: textblock
7646 #: dpkg-buildflags.pod
7647 msgid ""
7648 "Additionally, since PIE is implemented via a general register, some register "
7649 "starved architectures (but not including i386 anymore since optimizations "
7650 "implemented in gcc E<gt>= 5) can see performance losses of up to 15% in very "
7651 "text-segment-heavy application workloads; most workloads see less than "
7652 "1%. Architectures with more general registers (e.g. amd64)  do not see as "
7653 "high a worst-case penalty."
7654 msgstr ""
7656 #. type: =head2
7657 #: dpkg-buildflags.pod
7658 msgid "reproducible"
7659 msgstr ""
7661 #. type: textblock
7662 #: dpkg-buildflags.pod
7663 msgid ""
7664 "The compile-time options detailed below can be used to help improve build "
7665 "reproducibility or provide additional warning messages during "
7666 "compilation. Except as noted below, these are enabled by default for "
7667 "architectures that support them."
7668 msgstr ""
7670 #. type: =item
7671 #: dpkg-buildflags.pod
7672 msgid "B<timeless>"
7673 msgstr ""
7675 #. type: textblock
7676 #: dpkg-buildflags.pod
7677 msgid ""
7678 "This setting (enabled by default) adds B<-Wdate-time> to B<CPPFLAGS>.  This "
7679 "will cause warnings when the B<__TIME__>, B<__DATE__> and B<__TIMESTAMP__> "
7680 "macros are used."
7681 msgstr ""
7683 #. type: =item
7684 #: dpkg-buildflags.pod
7685 msgid "B<fixfilepath>"
7686 msgstr ""
7688 #. type: textblock
7689 #: dpkg-buildflags.pod
7690 msgid ""
7691 "This setting (enabled by default) adds "
7692 "B<-ffile-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, "
7693 "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS> where "
7694 "B<BUILDPATH> is set to the top-level directory of the package being built.  "
7695 "This has the effect of removing the build path from any generated file."
7696 msgstr ""
7698 #. type: textblock
7699 #: dpkg-buildflags.pod
7700 msgid ""
7701 "If both B<fixdebugpath> and B<fixfilepath> are set, this option takes "
7702 "precedence, because it is a superset of the former."
7703 msgstr ""
7705 #. type: =item
7706 #: dpkg-buildflags.pod
7707 msgid "B<fixdebugpath>"
7708 msgstr ""
7710 #. type: textblock
7711 #: dpkg-buildflags.pod
7712 msgid ""
7713 "This setting (enabled by default) adds "
7714 "B<-fdebug-prefix-map=>I<BUILDPATH>B<=.> to B<CFLAGS>, B<CXXFLAGS>, "
7715 "B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS> where "
7716 "B<BUILDPATH> is set to the top-level directory of the package being built.  "
7717 "This has the effect of removing the build path from any generated debug "
7718 "symbols."
7719 msgstr ""
7721 #. type: textblock
7722 #: dpkg-buildflags.pod
7723 msgid ""
7724 "There are 2 sets of environment variables doing the same operations, the "
7725 "first one (DEB_I<flag>_I<op>) should never be used within "
7726 "B<debian/rules>. It's meant for any user that wants to rebuild the source "
7727 "package with different build flags. The second set (DEB_I<flag>_MAINT_I<op>) "
7728 "should only be used in B<debian/rules> by package maintainers to change the "
7729 "resulting build flags."
7730 msgstr ""
7732 #. type: =item
7733 #: dpkg-buildflags.pod
7734 msgid "B<DEB_>I<flag>B<_SET>"
7735 msgstr ""
7737 #. type: =item
7738 #: dpkg-buildflags.pod
7739 msgid "B<DEB_>I<flag>B<_MAINT_SET>"
7740 msgstr ""
7742 #. type: textblock
7743 #: dpkg-buildflags.pod
7744 msgid "This variable can be used to force the value returned for the given I<flag>."
7745 msgstr ""
7747 #. type: =item
7748 #: dpkg-buildflags.pod
7749 msgid "B<DEB_>I<flag>B<_STRIP>"
7750 msgstr ""
7752 #. type: =item
7753 #: dpkg-buildflags.pod
7754 msgid "B<DEB_>I<flag>B<_MAINT_STRIP>"
7755 msgstr ""
7757 #. type: textblock
7758 #: dpkg-buildflags.pod
7759 msgid ""
7760 "This variable can be used to provide a space separated list of options that "
7761 "will be stripped from the set of flags returned for the given I<flag>."
7762 msgstr ""
7764 #. type: =item
7765 #: dpkg-buildflags.pod
7766 msgid "B<DEB_>I<flag>B<_APPEND>"
7767 msgstr ""
7769 #. type: =item
7770 #: dpkg-buildflags.pod
7771 msgid "B<DEB_>I<flag>B<_MAINT_APPEND>"
7772 msgstr ""
7774 #. type: textblock
7775 #: dpkg-buildflags.pod
7776 msgid ""
7777 "This variable can be used to append supplementary options to the value "
7778 "returned for the given I<flag>."
7779 msgstr ""
7781 #. type: =item
7782 #: dpkg-buildflags.pod
7783 msgid "B<DEB_>I<flag>B<_PREPEND>"
7784 msgstr ""
7786 #. type: =item
7787 #: dpkg-buildflags.pod
7788 msgid "B<DEB_>I<flag>B<_MAINT_PREPEND>"
7789 msgstr ""
7791 #. type: textblock
7792 #: dpkg-buildflags.pod
7793 msgid ""
7794 "This variable can be used to prepend supplementary options to the value "
7795 "returned for the given I<flag>."
7796 msgstr ""
7798 #. type: =item
7799 #: dpkg-buildflags.pod dpkg-buildpackage.pod dpkg-genbuildinfo.pod
7800 msgid "B<DEB_BUILD_OPTIONS>"
7801 msgstr ""
7803 #. type: =item
7804 #: dpkg-buildflags.pod
7805 msgid "B<DEB_BUILD_MAINT_OPTIONS>"
7806 msgstr ""
7808 #. type: textblock
7809 #: dpkg-buildflags.pod
7810 msgid ""
7811 "These variables can be used by a user or maintainer to disable/enable "
7812 "various area features that affect build flags.  The "
7813 "B<DEB_BUILD_MAINT_OPTIONS> variable overrides any setting in the "
7814 "B<DEB_BUILD_OPTIONS> feature areas.  See the B<FEATURE AREAS> section for "
7815 "details."
7816 msgstr ""
7818 #. type: =item
7819 #: dpkg-buildflags.pod dpkg-vendor.pod
7820 msgid "B<DEB_VENDOR>"
7821 msgstr ""
7823 #. type: textblock
7824 #: dpkg-buildflags.pod
7825 msgid ""
7826 "This setting defines the current vendor.  If not set, it will discover the "
7827 "current vendor by reading B<%PKGCONFDIR%/origins/default>."
7828 msgstr ""
7830 #. type: =item
7831 #: dpkg-buildflags.pod
7832 msgid "B<DEB_BUILD_PATH>"
7833 msgstr ""
7835 #. type: textblock
7836 #: dpkg-buildflags.pod
7837 msgid ""
7838 "This variable sets the build path (since dpkg 1.18.8) to use in features "
7839 "such as B<fixdebugpath> so that they can be controlled by the caller.  This "
7840 "variable is currently Debian and derivatives-specific."
7841 msgstr ""
7843 #. type: =head2
7844 #: dpkg-buildflags.pod
7845 msgid "Configuration files"
7846 msgstr ""
7848 #. type: =item
7849 #: dpkg-buildflags.pod
7850 msgid "B<%PKGCONFDIR%/buildflags.conf>"
7851 msgstr ""
7853 #. type: textblock
7854 #: dpkg-buildflags.pod
7855 msgid "System wide configuration file."
7856 msgstr ""
7858 #. type: =item
7859 #: dpkg-buildflags.pod
7860 msgid "B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or"
7861 msgstr ""
7863 #. type: =item
7864 #: dpkg-buildflags.pod
7865 msgid "B<$HOME/.config/dpkg/buildflags.conf>"
7866 msgstr ""
7868 #. type: textblock
7869 #: dpkg-buildflags.pod dpkg-buildpackage.pod
7870 msgid "User configuration file."
7871 msgstr ""
7873 #. type: =item
7874 #: dpkg-buildflags.pod
7875 msgid "B<%PKGDATADIR%/buildflags.mk>"
7876 msgstr ""
7878 #. type: textblock
7879 #: dpkg-buildflags.pod
7880 msgid ""
7881 "Makefile snippet that will load (and optionally export) all flags supported "
7882 "by B<dpkg-buildflags> into variables (since dpkg 1.16.1)."
7883 msgstr ""
7885 #. type: textblock
7886 #: dpkg-buildflags.pod
7887 msgid "To pass build flags to a build command in a Makefile:"
7888 msgstr ""
7890 #. type: verbatim
7891 #: dpkg-buildflags.pod
7892 #, no-wrap
7893 msgid ""
7894 " $(MAKE) $(shell dpkg-buildflags --export=cmdline)\n"
7895 "\n"
7896 msgstr ""
7898 #. type: verbatim
7899 #: dpkg-buildflags.pod
7900 #, no-wrap
7901 msgid ""
7902 " ./configure $(shell dpkg-buildflags --export=cmdline)\n"
7903 "\n"
7904 msgstr ""
7906 #. type: textblock
7907 #: dpkg-buildflags.pod
7908 msgid ""
7909 "To set build flags in a shell script or shell fragment, B<eval> can be used "
7910 "to interpret the output and to export the flags in the environment:"
7911 msgstr ""
7913 #. type: verbatim
7914 #: dpkg-buildflags.pod
7915 #, no-wrap
7916 msgid ""
7917 " eval \"$(dpkg-buildflags --export=sh)\" && make\n"
7918 "\n"
7919 msgstr ""
7921 #. type: textblock
7922 #: dpkg-buildflags.pod
7923 msgid "or to set the positional parameters to pass to a command:"
7924 msgstr ""
7926 #. type: verbatim
7927 #: dpkg-buildflags.pod
7928 #, no-wrap
7929 msgid ""
7930 " eval \"set -- $(dpkg-buildflags --export=cmdline)\"\n"
7931 " for dir in a b c; do (cd $dir && ./configure \"$@\" && make); done\n"
7932 "\n"
7933 msgstr ""
7935 #. type: textblock
7936 #: dpkg-buildflags.pod
7937 msgid ""
7938 "You should call B<dpkg-buildflags> or include B<buildflags.mk> from the "
7939 "B<debian/rules> file to obtain the needed build flags to pass to the build "
7940 "system.  Note that older versions of B<dpkg-buildpackage> (before dpkg "
7941 "1.16.1)  exported these flags automatically. However, you should not rely on "
7942 "this, since this breaks manual invocation of B<debian/rules>."
7943 msgstr ""
7945 #. type: textblock
7946 #: dpkg-buildflags.pod
7947 msgid ""
7948 "For packages with autoconf-like build systems, you can pass the relevant "
7949 "options to configure or B<make>(1) directly, as shown above."
7950 msgstr ""
7952 #. type: textblock
7953 #: dpkg-buildflags.pod
7954 msgid ""
7955 "For other build systems, or when you need more fine-grained control about "
7956 "which flags are passed where, you can use B<--get>. Or you can include "
7957 "B<buildflags.mk> instead, which takes care of calling B<dpkg-buildflags> and "
7958 "storing the build flags in make variables."
7959 msgstr ""
7961 #. type: textblock
7962 #: dpkg-buildflags.pod
7963 msgid ""
7964 "If you want to export all buildflags into the environment (where they can be "
7965 "picked up by your build system):"
7966 msgstr ""
7968 #. type: verbatim
7969 #: dpkg-buildflags.pod
7970 #, no-wrap
7971 msgid ""
7972 " DPKG_EXPORT_BUILDFLAGS = 1\n"
7973 " include %PKGDATADIR%/buildflags.mk\n"
7974 "\n"
7975 msgstr ""
7977 #. type: textblock
7978 #: dpkg-buildflags.pod
7979 msgid ""
7980 "For some extra control over what is exported, you can manually export the "
7981 "variables (as none are exported by default):"
7982 msgstr ""
7984 #. type: verbatim
7985 #: dpkg-buildflags.pod
7986 #, no-wrap
7987 msgid ""
7988 " include %PKGDATADIR%/buildflags.mk\n"
7989 " export CPPFLAGS CFLAGS LDFLAGS\n"
7990 "\n"
7991 msgstr ""
7993 #. type: textblock
7994 #: dpkg-buildflags.pod
7995 msgid "And you can of course pass the flags to commands manually:"
7996 msgstr ""
7998 #. type: verbatim
7999 #: dpkg-buildflags.pod
8000 #, no-wrap
8001 msgid ""
8002 " include %PKGDATADIR%/buildflags.mk\n"
8003 " build-arch:\n"
8004 " \t$(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)\n"
8005 "\n"
8006 msgstr ""
8008 #. type: textblock
8009 #: dpkg-buildpackage.pod
8010 msgid "dpkg-buildpackage - build binary or source packages from sources"
8011 msgstr ""
8013 #. type: textblock
8014 #: dpkg-buildpackage.pod
8015 msgid "B<dpkg-buildpackage> [I<option>...]"
8016 msgstr ""
8018 #. type: textblock
8019 #: dpkg-buildpackage.pod
8020 msgid ""
8021 "B<dpkg-buildpackage> is a program that automates the process of building a "
8022 "Debian package. It consists of the following steps:"
8023 msgstr ""
8025 #. type: =item
8026 #: dpkg-buildpackage.pod
8027 msgid "B<1.>"
8028 msgstr ""
8030 #. type: textblock
8031 #: dpkg-buildpackage.pod
8032 msgid ""
8033 "It prepares the build environment by setting various environment variables "
8034 "(see B<ENVIRONMENT>), runs the B<init> hook, and calls B<dpkg-source "
8035 "--before-build> (unless B<-T> or B<--target> has been used)."
8036 msgstr ""
8038 #. type: =item
8039 #: dpkg-buildpackage.pod
8040 msgid "B<2.>"
8041 msgstr ""
8043 #. type: textblock
8044 #: dpkg-buildpackage.pod
8045 msgid ""
8046 "It checks that the build-dependencies and build-conflicts are satisfied "
8047 "(unless B<-d> or B<--no-check-builddeps> is specified)."
8048 msgstr ""
8050 #. type: =item
8051 #: dpkg-buildpackage.pod
8052 msgid "B<3.>"
8053 msgstr ""
8055 #. type: textblock
8056 #: dpkg-buildpackage.pod
8057 msgid ""
8058 "If one or more specific targets have been selected with the B<-T> or "
8059 "B<--target> option, it calls those targets and stops here. Otherwise it runs "
8060 "the B<preclean> hook and calls B<fakeroot debian/rules clean> to clean the "
8061 "build-tree (unless B<-nc> or B<--no-pre-clean> is specified)."
8062 msgstr ""
8064 #. type: =item
8065 #: dpkg-buildpackage.pod
8066 msgid "B<4.>"
8067 msgstr ""
8069 #. type: textblock
8070 #: dpkg-buildpackage.pod
8071 msgid ""
8072 "It runs the B<source> hook and calls B<dpkg-source -b> to generate the "
8073 "source package (if a B<source> build has been requested with B<--build> or "
8074 "equivalent options)."
8075 msgstr ""
8077 #. type: =item
8078 #: dpkg-buildpackage.pod
8079 msgid "B<5.>"
8080 msgstr ""
8082 #. type: textblock
8083 #: dpkg-buildpackage.pod
8084 msgid ""
8085 "It runs the B<build> hook and calls B<debian/rules> I<build-target>, then "
8086 "runs the B<binary> hook followed by B<fakeroot debian/rules> "
8087 "I<binary-target> (unless a source-only build has been requested with "
8088 "B<--build=source> or equivalent options).  Note that I<build-target> and "
8089 "I<binary-target> are either B<build> and B<binary> (default case, or if an "
8090 "B<any> and B<all> build has been requested with B<--build> or equivalent "
8091 "options), or B<build-arch> and B<binary-arch> (if an B<any> and not B<all> "
8092 "build has been requested with B<--build> or equivalent options), or "
8093 "B<build-indep> and B<binary-indep> (if an B<all> and not B<any> build has "
8094 "been requested with B<--build> or equivalent options)."
8095 msgstr ""
8097 #. type: =item
8098 #: dpkg-buildpackage.pod
8099 msgid "B<6.>"
8100 msgstr ""
8102 #. type: textblock
8103 #: dpkg-buildpackage.pod
8104 msgid ""
8105 "It runs the B<buildinfo> hook and calls B<dpkg-genbuildinfo> to generate a "
8106 "B<.buildinfo> file.  Several B<dpkg-buildpackage> options are forwarded to "
8107 "B<dpkg-genbuildinfo>."
8108 msgstr ""
8110 #. type: =item
8111 #: dpkg-buildpackage.pod
8112 msgid "B<7.>"
8113 msgstr ""
8115 #. type: textblock
8116 #: dpkg-buildpackage.pod
8117 msgid ""
8118 "It runs the B<changes> hook and calls B<dpkg-genchanges> to generate a "
8119 "B<.changes> file.  The name of the B<.changes> file will depend on the type "
8120 "of build and will be as specific as necessary but not more; for a build that "
8121 "includes B<any> the name will be "
8122 "I<source-name>B<_>I<binary-version>B<_>I<arch>B<.changes>, or otherwise for "
8123 "a build that includes B<all> the name will be "
8124 "I<source-name>B<_>I<binary-version>B<_>B<all.changes>, or otherwise for a "
8125 "build that includes B<source> the name will be "
8126 "I<source-name>B<_>I<source-version>B<_>B<source.changes>.  Many "
8127 "B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>."
8128 msgstr ""
8130 #. type: =item
8131 #: dpkg-buildpackage.pod
8132 msgid "B<8.>"
8133 msgstr ""
8135 #. type: textblock
8136 #: dpkg-buildpackage.pod
8137 msgid ""
8138 "It runs the B<postclean> hook and if B<-tc> or B<--post-clean> is specified, "
8139 "it will call B<fakeroot debian/rules clean> again."
8140 msgstr ""
8142 #. type: =item
8143 #: dpkg-buildpackage.pod
8144 msgid "B<9.>"
8145 msgstr ""
8147 #. type: textblock
8148 #: dpkg-buildpackage.pod
8149 msgid "It calls B<dpkg-source --after-build>."
8150 msgstr ""
8152 #. type: =item
8153 #: dpkg-buildpackage.pod
8154 msgid "B<10.>"
8155 msgstr ""
8157 #. type: textblock
8158 #: dpkg-buildpackage.pod
8159 msgid ""
8160 "It runs the B<check> hook and calls a package checker for the B<.changes> "
8161 "file (if a command is specified in B<DEB_CHECK_COMMAND> or with "
8162 "B<--check-command>)."
8163 msgstr ""
8165 #. type: =item
8166 #: dpkg-buildpackage.pod
8167 msgid "B<11.>"
8168 msgstr ""
8170 #. type: textblock
8171 #: dpkg-buildpackage.pod
8172 msgid ""
8173 "It runs the B<sign> hook and signs using the OpenPGP backend (as long as it "
8174 "is not an UNRELEASED build, or B<--no-sign> is specified) to sign the "
8175 "B<.dsc> file (if any, unless B<-us> or B<--unsigned-source> is specified), "
8176 "the B<.buildinfo> file (unless B<-ui>, B<--unsigned-buildinfo>, B<-uc> or "
8177 "B<--unsigned-changes> is specified) and the B<.changes> file (unless B<-uc> "
8178 "or B<--unsigned-changes> is specified)."
8179 msgstr ""
8181 #. type: =item
8182 #: dpkg-buildpackage.pod
8183 msgid "B<12.>"
8184 msgstr ""
8186 #. type: textblock
8187 #: dpkg-buildpackage.pod
8188 msgid "It runs the B<done> hook."
8189 msgstr ""
8191 #. type: textblock
8192 #: dpkg-buildpackage.pod
8193 msgid ""
8194 "All long options can be specified both on the command line and in the "
8195 "B<dpkg-buildpackage> system and user configuration files.  Each line in the "
8196 "configuration file is either an option (exactly the same as the command line "
8197 "option but without leading hyphens) or a comment (if it starts with a "
8198 "‘B<#>’)."
8199 msgstr ""
8201 #. type: =item
8202 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8203 msgid "B<--build=>I<type>"
8204 msgstr ""
8206 #. type: textblock
8207 #: dpkg-buildpackage.pod
8208 msgid ""
8209 "Specifies the build I<type> from a comma-separated list of components (since "
8210 "dpkg 1.18.5).  All the specified components get combined to select the "
8211 "single build type to use, which implies a single build run with a single "
8212 "F<.changes> file generated.  Passed to B<dpkg-genchanges>."
8213 msgstr ""
8215 #. type: textblock
8216 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8217 msgid "The allowed values are:"
8218 msgstr ""
8220 #. type: =item
8221 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8222 msgid "B<source>"
8223 msgstr ""
8225 #. type: textblock
8226 #: dpkg-buildpackage.pod
8227 msgid "Builds the source package."
8228 msgstr ""
8230 #. type: textblock
8231 #: dpkg-buildpackage.pod
8232 msgid ""
8233 "B<Note:> When using this value standalone and if what you want is simply to "
8234 "(re-)build the source package from a clean source tree, using B<dpkg-source> "
8235 "directly is always a better option as it does not require any build "
8236 "dependencies to be installed which are otherwise needed to be able to call "
8237 "the B<clean> target."
8238 msgstr ""
8240 #. type: =item
8241 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8242 msgid "B<any>"
8243 msgstr ""
8245 #. type: textblock
8246 #: dpkg-buildpackage.pod
8247 msgid "Builds the architecture specific binary packages."
8248 msgstr ""
8250 #. type: =item
8251 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8252 msgid "B<all>"
8253 msgstr ""
8255 #. type: textblock
8256 #: dpkg-buildpackage.pod
8257 msgid "Builds the architecture independent binary packages."
8258 msgstr ""
8260 #. type: textblock
8261 #: dpkg-buildpackage.pod
8262 msgid ""
8263 "Builds the architecture specific and independent binary packages.  This is "
8264 "an alias for B<any,all>."
8265 msgstr ""
8267 #. type: =item
8268 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8269 msgid "B<full>"
8270 msgstr ""
8272 #. type: textblock
8273 #: dpkg-buildpackage.pod
8274 msgid ""
8275 "Builds everything.  This is an alias for B<source,any,all>, and the same as "
8276 "the default case when no build option is specified."
8277 msgstr ""
8279 #. type: =item
8280 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8281 msgid "B<-g>"
8282 msgstr ""
8284 #. type: textblock
8285 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8286 msgid "Equivalent to B<--build=source,all> (since dpkg 1.17.11)."
8287 msgstr ""
8289 #. type: =item
8290 #: dpkg-buildpackage.pod dpkg-genchanges.pod dpkg.pod
8291 msgid "B<-G>"
8292 msgstr ""
8294 #. type: textblock
8295 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8296 msgid "Equivalent to B<--build=source,any> (since dpkg 1.17.11)."
8297 msgstr ""
8299 #. type: =item
8300 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8301 msgid "B<-b>"
8302 msgstr ""
8304 #. type: textblock
8305 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8306 msgid "Equivalent to B<--build=binary> or B<--build=any,all>."
8307 msgstr ""
8309 #. type: =item
8310 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-genchanges.pod
8311 msgid "B<-B>"
8312 msgstr ""
8314 #. type: textblock
8315 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8316 msgid "Equivalent to B<--build=any>."
8317 msgstr ""
8319 #. type: =item
8320 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-genchanges.pod
8321 msgid "B<-A>"
8322 msgstr ""
8324 #. type: textblock
8325 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8326 msgid "Equivalent to B<--build=all>."
8327 msgstr ""
8329 #. type: =item
8330 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8331 msgid "B<-S>"
8332 msgstr ""
8334 #. type: textblock
8335 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8336 msgid "Equivalent to B<--build=source>."
8337 msgstr ""
8339 #. type: =item
8340 #: dpkg-buildpackage.pod
8341 msgid "B<-F>"
8342 msgstr ""
8344 #. type: textblock
8345 #: dpkg-buildpackage.pod
8346 msgid ""
8347 "Equivalent to B<--build=full>, B<--build=source,binary> or "
8348 "B<--build=source,any,all> (since dpkg 1.15.8)."
8349 msgstr ""
8351 #. type: =item
8352 #: dpkg-buildpackage.pod
8353 msgid "B<--target=>I<target>[,...]"
8354 msgstr ""
8356 #. type: =item
8357 #: dpkg-buildpackage.pod
8358 msgid "B<--target> I<target>[,...]"
8359 msgstr ""
8361 #. type: =item
8362 #: dpkg-buildpackage.pod
8363 msgid "B<-T>, B<--rules-target=>I<target>[,...]"
8364 msgstr ""
8366 #. type: textblock
8367 #: dpkg-buildpackage.pod
8368 msgid ""
8369 "Calls B<debian/rules> I<target> once per target specified, after having "
8370 "setup the build environment (except for calling B<dpkg-source "
8371 "--before-build>), and stops the package build process here (since dpkg "
8372 "1.15.0, long option since dpkg 1.18.8, multi-target support since dpkg "
8373 "1.18.16).  If B<--as-root> is also given, then the command is executed as "
8374 "root (see B<--root-command>).  Note that known targets that are required to "
8375 "be run as root do not need this option (i.e. the B<clean>, B<binary>, "
8376 "B<binary-arch> and B<binary-indep> targets)."
8377 msgstr ""
8379 #. type: =item
8380 #: dpkg-buildpackage.pod
8381 msgid "B<--as-root>"
8382 msgstr ""
8384 #. type: textblock
8385 #: dpkg-buildpackage.pod
8386 msgid ""
8387 "Only meaningful together with B<--target> (since dpkg 1.15.0).  Requires "
8388 "that the target be run with root rights."
8389 msgstr ""
8391 #. type: =item
8392 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8393 msgid "B<-si>"
8394 msgstr ""
8396 #. type: =item
8397 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8398 msgid "B<-sa>"
8399 msgstr ""
8401 #. type: =item
8402 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8403 msgid "B<-sd>"
8404 msgstr ""
8406 #. type: =item
8407 #: dpkg-buildpackage.pod dpkg-genchanges.pod dpkg-gencontrol.pod
8408 #: dpkg-gensymbols.pod
8409 msgid "B<-v>I<version>"
8410 msgstr ""
8412 #. type: =item
8413 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8414 msgid "B<-C>I<changes-description>"
8415 msgstr ""
8417 #. type: =item
8418 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8419 msgid "B<-m>I<maintainer-address>"
8420 msgstr ""
8422 #. type: =item
8423 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8424 msgid "B<-e>I<maintainer-address>"
8425 msgstr ""
8427 #. type: textblock
8428 #: dpkg-buildpackage.pod
8429 msgid "Passed unchanged to B<dpkg-genchanges>. See its manual page."
8430 msgstr ""
8432 #. type: =item
8433 #: dpkg-buildpackage.pod
8434 msgid "B<--build-by=>I<maintainer-address>"
8435 msgstr ""
8437 #. type: =item
8438 #: dpkg-buildpackage.pod
8439 msgid "B<--source-by=>I<maintainer-address> (since dpkg 1.21.10)"
8440 msgstr ""
8442 #. type: textblock
8443 #: dpkg-buildpackage.pod
8444 msgid "Pass as B<-m> to B<dpkg-genchanges>. See its manual page."
8445 msgstr ""
8447 #. type: =item
8448 #: dpkg-buildpackage.pod
8449 msgid "B<--release-by=>I<maintainer-address>"
8450 msgstr ""
8452 #. type: =item
8453 #: dpkg-buildpackage.pod
8454 msgid "B<--changed-by=>I<maintainer-address> (since dpkg 1.21.10)"
8455 msgstr ""
8457 #. type: textblock
8458 #: dpkg-buildpackage.pod
8459 msgid "Pass as B<-e> to B<dpkg-genchanges>. See its manual page."
8460 msgstr ""
8462 #. type: textblock
8463 #: dpkg-buildpackage.pod
8464 msgid ""
8465 "Specify the Debian architecture we build for (long option since dpkg "
8466 "1.17.17).  The architecture of the machine we build on is determined "
8467 "automatically, and is also the default for the host machine."
8468 msgstr ""
8470 #. type: textblock
8471 #: dpkg-buildpackage.pod
8472 msgid ""
8473 "Specify the GNU system type we build for (long option since dpkg 1.17.17).  "
8474 "It can be used in place of B<--host-arch> or as a complement to override the "
8475 "default GNU system type of the host Debian architecture."
8476 msgstr ""
8478 #. type: =item
8479 #: dpkg-buildpackage.pod
8480 msgid "B<--target-arch> I<architecture>"
8481 msgstr ""
8483 #. type: textblock
8484 #: dpkg-buildpackage.pod
8485 msgid ""
8486 "Specify the Debian architecture the binaries built will build for (since "
8487 "dpkg 1.17.17).  The default value is the host machine."
8488 msgstr ""
8490 #. type: =item
8491 #: dpkg-buildpackage.pod
8492 msgid "B<--target-type> I<gnu-system-type>"
8493 msgstr ""
8495 #. type: textblock
8496 #: dpkg-buildpackage.pod
8497 msgid ""
8498 "Specify the GNU system type the binaries built will build for (since dpkg "
8499 "1.17.17).  It can be used in place of B<--target-arch> or as a complement to "
8500 "override the default GNU system type of the target Debian architecture."
8501 msgstr ""
8503 #. type: =item
8504 #: dpkg-buildpackage.pod
8505 msgid "B<-P>, B<--build-profiles=>I<profile>[B<,>...]"
8506 msgstr ""
8508 #. type: textblock
8509 #: dpkg-buildpackage.pod
8510 msgid ""
8511 "Specify the profile(s) we build, as a comma-separated list (since dpkg "
8512 "1.17.2, long option since dpkg 1.18.8).  The default behavior is to build "
8513 "for no specific profile. Also sets them (as a space separated list) as the "
8514 "B<DEB_BUILD_PROFILES> environment variable which allows, for example, "
8515 "B<debian/rules> files to use this information for conditional builds."
8516 msgstr ""
8518 #. type: =item
8519 #: dpkg-buildpackage.pod
8520 msgid "B<-j>, B<--jobs>[=I<jobs>|B<auto>]"
8521 msgstr ""
8523 #. type: textblock
8524 #: dpkg-buildpackage.pod
8525 msgid ""
8526 "Specifies the number of jobs allowed to be run simultaneously (since dpkg "
8527 "1.14.7, long option since dpkg 1.18.8).  The number of jobs matching the "
8528 "number of online processors if B<auto> is specified (since dpkg 1.17.10), or "
8529 "unlimited number if I<jobs> is not specified.  The default behavior is "
8530 "B<auto> (since dpkg 1.18.11) in non-forced mode (since dpkg 1.21.10), and as "
8531 "such it is always safer to use with any package including those that are not "
8532 "parallel-build safe.  Setting the number of jobs to B<1> will restore serial "
8533 "execution."
8534 msgstr ""
8536 #. type: textblock
8537 #: dpkg-buildpackage.pod
8538 msgid ""
8539 "Will add B<parallel=>I<jobs> or B<parallel> to the B<DEB_BUILD_OPTIONS> "
8540 "environment variable which allows debian/rules files to opt-in to use this "
8541 "information for their own purposes.  The I<jobs> value will override the "
8542 "B<parallel=>I<jobs> or B<parallel> option in the B<DEB_BUILD_OPTIONS> "
8543 "environment variable.  Note that the B<auto> value will get replaced by the "
8544 "actual number of currently active processors, and as such will not get "
8545 "propagated to any child process. If the number of online processors cannot "
8546 "be inferred then the code will fallback to using serial execution (since "
8547 "dpkg 1.18.15), although this should only happen on exotic and unsupported "
8548 "systems."
8549 msgstr ""
8551 #. type: =item
8552 #: dpkg-buildpackage.pod
8553 msgid "B<-J>, B<--jobs-try>[=I<jobs>|B<auto>]"
8554 msgstr ""
8556 #. type: textblock
8557 #: dpkg-buildpackage.pod
8558 msgid ""
8559 "This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent "
8560 "to the B<-j> above."
8561 msgstr ""
8563 #. type: textblock
8564 #: dpkg-buildpackage.pod
8565 msgid ""
8566 "Since the behavior for B<-j> changed in dpkg 1.21.10 to the opt-in mode, you "
8567 "can use this option instead if you need to guarantee semantics across dpkg "
8568 "release series."
8569 msgstr ""
8571 #. type: =item
8572 #: dpkg-buildpackage.pod
8573 msgid "B<--jobs-force>[=I<jobs>|B<auto>]"
8574 msgstr ""
8576 #. type: textblock
8577 #: dpkg-buildpackage.pod
8578 msgid ""
8579 "This option (since dpkg 1.21.10) is equivalent to the B<--jobs> option "
8580 "except that it will enable forced parallel mode, by adding the B<make> B<-j> "
8581 "option with the computed number of parallel jobs to the B<MAKEFLAGS> "
8582 "environment variable."
8583 msgstr ""
8585 #. type: textblock
8586 #: dpkg-buildpackage.pod
8587 msgid ""
8588 "This should cause all subsequent make invocations to inherit the option, "
8589 "thus forcing the parallel setting on the packaging (and possibly the "
8590 "upstream build system if that uses L<make(1)>) regardless of their support "
8591 "for parallel builds, which might cause build failures."
8592 msgstr ""
8594 #. type: textblock
8595 #: dpkg-buildpackage.pod
8596 msgid ""
8597 "Note: Any Makefile that is not parallel-safe should be considered to be "
8598 "buggy.  These should either be made parallel-safe, or marked as not being "
8599 "safe with the L<make(1)> B<.NOTPARALLEL> target."
8600 msgstr ""
8602 #. type: =item
8603 #: dpkg-buildpackage.pod
8604 msgid "B<-D>, B<--check-builddeps>"
8605 msgstr ""
8607 #. type: textblock
8608 #: dpkg-buildpackage.pod
8609 msgid ""
8610 "Check build dependencies and conflicts; abort if unsatisfied (long option "
8611 "since dpkg 1.18.8).  This is the default behavior."
8612 msgstr ""
8614 #. type: =item
8615 #: dpkg-buildpackage.pod
8616 msgid "B<-d>, B<--no-check-builddeps>"
8617 msgstr ""
8619 #. type: textblock
8620 #: dpkg-buildpackage.pod
8621 msgid ""
8622 "Do not check build dependencies and conflicts (long option since dpkg "
8623 "1.18.8)."
8624 msgstr ""
8626 #. type: =item
8627 #: dpkg-buildpackage.pod
8628 msgid "B<--ignore-builtin-builddeps>"
8629 msgstr ""
8631 #. type: textblock
8632 #: dpkg-buildpackage.pod
8633 msgid ""
8634 "Do not check built-in build dependencies and conflicts (since dpkg 1.18.2).  "
8635 "These are the distribution specific implicit build dependencies usually "
8636 "required in a build environment, the so called Build-Essential package set."
8637 msgstr ""
8639 #. type: =item
8640 #: dpkg-buildpackage.pod
8641 msgid "B<--rules-requires-root>"
8642 msgstr ""
8644 #. type: textblock
8645 #: dpkg-buildpackage.pod
8646 msgid ""
8647 "Do not honor the B<Rules-Requires-Root> field, falling back to its legacy "
8648 "default value (since dpkg 1.19.1)."
8649 msgstr ""
8651 #. type: =item
8652 #: dpkg-buildpackage.pod
8653 msgid "B<-nc>, B<--no-pre-clean>"
8654 msgstr ""
8656 #. type: textblock
8657 #: dpkg-buildpackage.pod
8658 msgid ""
8659 "Do not clean the source tree before building (long option since dpkg "
8660 "1.18.8).  Implies B<-b> if nothing else has been selected among B<-F>, "
8661 "B<-g>, B<-G>, B<-B>, B<-A> or B<-S>.  Implies B<-d> with B<-S> (since dpkg "
8662 "1.18.0)."
8663 msgstr ""
8665 #. type: =item
8666 #: dpkg-buildpackage.pod
8667 msgid "B<--pre-clean>"
8668 msgstr ""
8670 #. type: textblock
8671 #: dpkg-buildpackage.pod
8672 msgid ""
8673 "Clean the source tree before building (since dpkg 1.18.8).  This is the "
8674 "default behavior."
8675 msgstr ""
8677 #. type: =item
8678 #: dpkg-buildpackage.pod
8679 msgid "B<-tc>, B<--post-clean>"
8680 msgstr ""
8682 #. type: textblock
8683 #: dpkg-buildpackage.pod
8684 msgid ""
8685 "Clean the source tree (using I<gain-root-command> B<debian/rules clean>)  "
8686 "after the package has been built (long option since dpkg 1.18.8)."
8687 msgstr ""
8689 #. type: =item
8690 #: dpkg-buildpackage.pod
8691 msgid "B<--no-post-clean>"
8692 msgstr ""
8694 #. type: textblock
8695 #: dpkg-buildpackage.pod
8696 msgid ""
8697 "Do not clean the source tree after the package has been built (since dpkg "
8698 "1.19.1).  This is the default behavior."
8699 msgstr ""
8701 #. type: =item
8702 #: dpkg-buildpackage.pod
8703 msgid "B<--sanitize-env>"
8704 msgstr ""
8706 #. type: textblock
8707 #: dpkg-buildpackage.pod
8708 msgid ""
8709 "Sanitize the build environment (since dpkg 1.20.0).  This will reset or "
8710 "remove environment variables, umask, and any other process attributes that "
8711 "might otherwise adversely affect the build of packages.  Because the "
8712 "official entry point to build packages is B<debian/rules>, packages cannot "
8713 "rely on these settings being in place, and thus should work even when they "
8714 "are not.  What to sanitize is vendor specific."
8715 msgstr ""
8717 #. type: =item
8718 #: dpkg-buildpackage.pod
8719 msgid "B<-r>, B<--root-command=>I<gain-root-command>"
8720 msgstr ""
8722 #. type: textblock
8723 #: dpkg-buildpackage.pod
8724 msgid ""
8725 "When B<dpkg-buildpackage> needs to execute part of the build process as "
8726 "root, it prefixes the command it executes with I<gain-root-command> if one "
8727 "has been specified (long option since dpkg 1.18.8).  Otherwise, if none has "
8728 "been specified, B<fakeroot> will be used by default, if the command is "
8729 "present.  I<gain-root-command> should start with the name of a program on "
8730 "the B<PATH> and will get as arguments the name of the real command to run "
8731 "and the arguments it should take.  I<gain-root-command> can include "
8732 "parameters (they must be space-separated) but no shell metacharacters.  "
8733 "I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or "
8734 "B<really>.  B<su> is not suitable, since it can only invoke the user's shell "
8735 "with B<-c> instead of passing arguments individually to the command to be "
8736 "run."
8737 msgstr ""
8739 #. type: =item
8740 #: dpkg-buildpackage.pod
8741 msgid "B<-R>, B<--rules-file=>I<rules-file>"
8742 msgstr ""
8744 #. type: textblock
8745 #: dpkg-buildpackage.pod
8746 msgid ""
8747 "Building a Debian package usually involves invoking B<debian/rules> as a "
8748 "command with several standard parameters (since dpkg 1.14.17, long option "
8749 "since dpkg 1.18.8).  With this option it's possible to use another program "
8750 "invocation to build the package (it can include space separated "
8751 "parameters).  Alternatively it can be used to execute the standard rules "
8752 "file with another make program (for example by using B</usr/local/bin/make "
8753 "-f debian/rules> as I<rules-file>)."
8754 msgstr ""
8756 #. type: =item
8757 #: dpkg-buildpackage.pod
8758 msgid "B<--check-command=>I<check-command>"
8759 msgstr ""
8761 #. type: textblock
8762 #: dpkg-buildpackage.pod
8763 msgid ""
8764 "Command used to check the B<.changes> file itself and any artifact built "
8765 "referenced in the file (since dpkg 1.17.6).  The command should take the "
8766 "B<.changes> pathname as an argument. This command will usually be "
8767 "B<lintian>."
8768 msgstr ""
8770 #. type: =item
8771 #: dpkg-buildpackage.pod
8772 msgid "B<--check-option=>I<opt>"
8773 msgstr ""
8775 #. type: textblock
8776 #: dpkg-buildpackage.pod
8777 msgid ""
8778 "Pass option I<opt> to the I<check-command> specified with "
8779 "B<DEB_CHECK_COMMAND> or B<--check-command> (since dpkg 1.17.6).  Can be used "
8780 "multiple times."
8781 msgstr ""
8783 #. type: =item
8784 #: dpkg-buildpackage.pod
8785 msgid "B<--hook->I<hook-name>B<=>I<hook-command>"
8786 msgstr ""
8788 #. type: textblock
8789 #: dpkg-buildpackage.pod
8790 msgid ""
8791 "Set the specified shell code I<hook-command> as the hook I<hook-name>, which "
8792 "will run at the times specified in the run steps (since dpkg 1.17.6).  The "
8793 "hooks will always be executed even if the following action is not performed "
8794 "(except for the B<binary> hook).  All the hooks will run in the unpacked "
8795 "source directory."
8796 msgstr ""
8798 #. type: textblock
8799 #: dpkg-buildpackage.pod
8800 msgid ""
8801 "B<Note:> Hooks can affect the build process, and cause build failures if "
8802 "their commands fail, so watch out for unintended consequences."
8803 msgstr ""
8805 #. type: textblock
8806 #: dpkg-buildpackage.pod
8807 msgid "The current I<hook-name> supported are:"
8808 msgstr ""
8810 #. type: textblock
8811 #: dpkg-buildpackage.pod
8812 msgid ""
8813 "B<init preclean source build binary buildinfo changes postclean check sign "
8814 "done>"
8815 msgstr ""
8817 #. type: textblock
8818 #: dpkg-buildpackage.pod
8819 msgid ""
8820 "The I<hook-command> supports the following substitution format string, which "
8821 "will get applied to it before execution:"
8822 msgstr ""
8824 #. type: =item
8825 #: dpkg-buildpackage.pod
8826 msgid "B<%%>"
8827 msgstr ""
8829 #. type: textblock
8830 #: dpkg-buildpackage.pod
8831 msgid "A single % character."
8832 msgstr ""
8834 #. type: =item
8835 #: dpkg-buildpackage.pod
8836 msgid "B<%a>"
8837 msgstr ""
8839 #. type: textblock
8840 #: dpkg-buildpackage.pod
8841 msgid ""
8842 "A boolean value (0 or 1), representing whether the following action is being "
8843 "performed."
8844 msgstr ""
8846 #. type: =item
8847 #: dpkg-buildpackage.pod
8848 msgid "B<%p>"
8849 msgstr ""
8851 #. type: textblock
8852 #: dpkg-buildpackage.pod
8853 msgid "The source package name."
8854 msgstr ""
8856 #. type: =item
8857 #: dpkg-buildpackage.pod
8858 msgid "B<%v>"
8859 msgstr ""
8861 #. type: textblock
8862 #: dpkg-buildpackage.pod
8863 msgid "The source package version."
8864 msgstr ""
8866 #. type: =item
8867 #: dpkg-buildpackage.pod
8868 msgid "B<%s>"
8869 msgstr ""
8871 #. type: textblock
8872 #: dpkg-buildpackage.pod
8873 msgid "The source package version (without the epoch)."
8874 msgstr ""
8876 #. type: =item
8877 #: dpkg-buildpackage.pod
8878 msgid "B<%u>"
8879 msgstr ""
8881 #. type: textblock
8882 #: dpkg-buildpackage.pod
8883 msgid "The upstream version."
8884 msgstr ""
8886 #. type: =item
8887 #: dpkg-buildpackage.pod
8888 msgid "B<--buildinfo-file=>I<filename>"
8889 msgstr ""
8891 #. type: textblock
8892 #: dpkg-buildpackage.pod
8893 msgid ""
8894 "Set the I<filename> for the generated B<.buildinfo> file (since dpkg "
8895 "1.21.0)."
8896 msgstr ""
8898 #. type: =item
8899 #: dpkg-buildpackage.pod
8900 msgid "B<--buildinfo-option=>I<opt>"
8901 msgstr ""
8903 #. type: textblock
8904 #: dpkg-buildpackage.pod
8905 msgid ""
8906 "Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11).  Can be "
8907 "used multiple times."
8908 msgstr ""
8910 #. type: =item
8911 #: dpkg-buildpackage.pod
8912 msgid "B<--sign-backend=>I<sign-backend>"
8913 msgstr ""
8915 #. type: textblock
8916 #: dpkg-buildpackage.pod
8917 msgid ""
8918 "Specify an OpenPGP backend interface to use when invoking the "
8919 "I<sign-command> (since dpkg 1.21.10)."
8920 msgstr ""
8922 #. type: textblock
8923 #: dpkg-buildpackage.pod
8924 msgid ""
8925 "The default is B<auto>, where the best current backend available will be "
8926 "used.  The specific OpenPGP backends supported in order of preference are:"
8927 msgstr ""
8929 #. type: =item
8930 #: dpkg-buildpackage.pod
8931 msgid "B<sop> (any conforming Stateless OpenPGP implementation)"
8932 msgstr ""
8934 #. type: =item
8935 #: dpkg-buildpackage.pod
8936 msgid "B<sq> (from Sequoia-PGP)"
8937 msgstr ""
8939 #. type: =item
8940 #: dpkg-buildpackage.pod
8941 msgid "B<gpg> (from GnuPG)"
8942 msgstr ""
8944 #. type: =item
8945 #: dpkg-buildpackage.pod
8946 msgid "B<-p>, B<--sign-command=>I<sign-command>"
8947 msgstr ""
8949 #. type: textblock
8950 #: dpkg-buildpackage.pod
8951 msgid ""
8952 "When B<dpkg-buildpackage> needs to execute an OpenPGP backend command to "
8953 "sign a source control (B<.dsc>) file or a B<.changes> file it will run "
8954 "I<sign-command> (searching the B<PATH> if necessary) instead of the default "
8955 "or auto-detected backend command (long option since dpkg 1.18.8).  "
8956 "I<sign-command> will get all the arguments defined by the "
8957 "B<--sign-backend>.  I<sign-command> should not contain spaces or any other "
8958 "shell metacharacters."
8959 msgstr ""
8961 #. type: =item
8962 #: dpkg-buildpackage.pod
8963 msgid "B<-k>, B<--sign-keyid=>I<key-id>"
8964 msgstr ""
8966 #. type: =item
8967 #: dpkg-buildpackage.pod
8968 msgid "B<--sign-key=>I<key-id>"
8969 msgstr ""
8971 #. type: textblock
8972 #: dpkg-buildpackage.pod
8973 msgid ""
8974 "Specify an OpenPGP key-ID (either a fingerprint or a user-ID) for the secret "
8975 "key to use when signing packages (B<--sign-key> since dpkg 1.18.8, "
8976 "B<--sign-keyid> since dpkg 1.21.10)."
8977 msgstr ""
8979 #. type: =item
8980 #: dpkg-buildpackage.pod
8981 msgid "B<--sign-keyfile=>I<key-file>"
8982 msgstr ""
8984 #. type: textblock
8985 #: dpkg-buildpackage.pod
8986 msgid ""
8987 "Specify an OpenPGP I<key-file> containing the secret key to use when signing "
8988 "packages (since dpkg 1.21.10)."
8989 msgstr ""
8991 #. type: textblock
8992 #: dpkg-buildpackage.pod
8993 msgid ""
8994 "Note: For security reasons the I<key-file> is best kept locked with a "
8995 "password."
8996 msgstr ""
8998 #. type: =item
8999 #: dpkg-buildpackage.pod
9000 msgid "B<-us>, B<--unsigned-source>"
9001 msgstr ""
9003 #. type: textblock
9004 #: dpkg-buildpackage.pod
9005 msgid "Do not sign the source package (long option since dpkg 1.18.8)."
9006 msgstr ""
9008 #. type: =item
9009 #: dpkg-buildpackage.pod
9010 msgid "B<-ui>, B<--unsigned-buildinfo>"
9011 msgstr ""
9013 #. type: textblock
9014 #: dpkg-buildpackage.pod
9015 msgid "Do not sign the B<.buildinfo> file (since dpkg 1.18.19)."
9016 msgstr ""
9018 #. type: =item
9019 #: dpkg-buildpackage.pod
9020 msgid "B<-uc>, B<--unsigned-changes>"
9021 msgstr ""
9023 #. type: textblock
9024 #: dpkg-buildpackage.pod
9025 msgid ""
9026 "Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg "
9027 "1.18.8)."
9028 msgstr ""
9030 #. type: =item
9031 #: dpkg-buildpackage.pod
9032 msgid "B<--no-sign>"
9033 msgstr ""
9035 #. type: textblock
9036 #: dpkg-buildpackage.pod
9037 msgid ""
9038 "Do not sign any file, this includes the source package, the B<.buildinfo> "
9039 "file and the B<.changes> file (since dpkg 1.18.20)."
9040 msgstr ""
9042 #. type: =item
9043 #: dpkg-buildpackage.pod
9044 msgid "B<--force-sign>"
9045 msgstr ""
9047 #. type: textblock
9048 #: dpkg-buildpackage.pod
9049 msgid ""
9050 "Force the signing of the resulting files (since dpkg 1.17.0), regardless of "
9051 "B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, "
9052 "B<--unsigned-changes> or other internal heuristics."
9053 msgstr ""
9055 #. type: =item
9056 #: dpkg-buildpackage.pod dpkg-source.pod
9057 msgid "B<-sn>"
9058 msgstr ""
9060 #. type: =item
9061 #: dpkg-buildpackage.pod dpkg-source.pod
9062 msgid "B<-ss>"
9063 msgstr ""
9065 #. type: =item
9066 #: dpkg-buildpackage.pod
9067 msgid "B<-sA>"
9068 msgstr ""
9070 #. type: =item
9071 #: dpkg-buildpackage.pod dpkg-source.pod
9072 msgid "B<-sk>"
9073 msgstr ""
9075 #. type: =item
9076 #: dpkg-buildpackage.pod dpkg-source.pod
9077 msgid "B<-su>"
9078 msgstr ""
9080 #. type: =item
9081 #: dpkg-buildpackage.pod dpkg-source.pod
9082 msgid "B<-sr>"
9083 msgstr ""
9085 #. type: =item
9086 #: dpkg-buildpackage.pod
9087 msgid "B<-sK>"
9088 msgstr ""
9090 #. type: =item
9091 #: dpkg-buildpackage.pod
9092 msgid "B<-sU>"
9093 msgstr ""
9095 #. type: =item
9096 #: dpkg-buildpackage.pod
9097 msgid "B<-sR>"
9098 msgstr ""
9100 #. type: =item
9101 #: dpkg-buildpackage.pod
9102 msgid "B<-i>, B<--diff-ignore>[=I<regex>]"
9103 msgstr ""
9105 #. type: =item
9106 #: dpkg-buildpackage.pod
9107 msgid "B<-I>, B<--tar-ignore>[=I<pattern>]"
9108 msgstr ""
9110 #. type: =item
9111 #: dpkg-buildpackage.pod
9112 msgid "B<-z>, B<--compression-level=>I<level>"
9113 msgstr ""
9115 #. type: =item
9116 #: dpkg-buildpackage.pod
9117 msgid "B<-Z>, B<--compression=>I<compressor>"
9118 msgstr ""
9120 #. type: textblock
9121 #: dpkg-buildpackage.pod
9122 msgid "Passed unchanged to B<dpkg-source>. See its manual page."
9123 msgstr ""
9125 #. type: =item
9126 #: dpkg-buildpackage.pod
9127 msgid "B<--source-option=>I<opt>"
9128 msgstr ""
9130 #. type: textblock
9131 #: dpkg-buildpackage.pod
9132 msgid ""
9133 "Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6).  Can be used "
9134 "multiple times."
9135 msgstr ""
9137 #. type: =item
9138 #: dpkg-buildpackage.pod
9139 msgid "B<--changes-file=>I<filename>"
9140 msgstr ""
9142 #. type: textblock
9143 #: dpkg-buildpackage.pod
9144 msgid "Set the I<filename> for the generated B<.changes> file (since dpkg 1.21.0)."
9145 msgstr ""
9147 #. type: =item
9148 #: dpkg-buildpackage.pod
9149 msgid "B<--changes-option=>I<opt>"
9150 msgstr ""
9152 #. type: textblock
9153 #: dpkg-buildpackage.pod
9154 msgid ""
9155 "Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6).  Can be used "
9156 "multiple times."
9157 msgstr ""
9159 #. type: =item
9160 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-genbuildinfo.pod
9161 #: dpkg-query.pod dpkg-shlibdeps.pod dpkg-trigger.pod dpkg.pod
9162 msgid "B<--admindir=>I<dir>"
9163 msgstr ""
9165 #. type: =item
9166 #: dpkg-buildpackage.pod
9167 msgid "B<--admindir> I<dir>"
9168 msgstr ""
9170 #. type: textblock
9171 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-shlibdeps.pod
9172 msgid ""
9173 "Change the location of the B<dpkg> database (since dpkg 1.14.0).  The "
9174 "default location is I<%ADMINDIR%>."
9175 msgstr ""
9177 #. type: =head2
9178 #: dpkg-buildpackage.pod dpkg-query.pod dpkg.pod
9179 msgid "External environment"
9180 msgstr ""
9182 #. type: =item
9183 #: dpkg-buildpackage.pod
9184 msgid "B<DEB_CHECK_COMMAND>"
9185 msgstr ""
9187 #. type: textblock
9188 #: dpkg-buildpackage.pod
9189 msgid ""
9190 "If set, it will be used as the command to check the B<.changes> file (since "
9191 "dpkg 1.17.6).  Overridden by the B<--check-command> option."
9192 msgstr ""
9194 #. type: =item
9195 #: dpkg-buildpackage.pod
9196 msgid "B<DEB_SIGN_KEYID>"
9197 msgstr ""
9199 #. type: textblock
9200 #: dpkg-buildpackage.pod
9201 msgid ""
9202 "If set, it will be used to sign the B<.changes>, B<.buildinfo> and B<.dsc> "
9203 "files (since dpkg 1.17.2).  Overridden by the B<--sign-key> option."
9204 msgstr ""
9206 #. type: =item
9207 #: dpkg-buildpackage.pod
9208 msgid "B<DEB_SIGN_KEYFILE>"
9209 msgstr ""
9211 #. type: textblock
9212 #: dpkg-buildpackage.pod
9213 msgid ""
9214 "If set, it will be used to sign the B<.changes>, B<.buildinfo> and B<.dsc> "
9215 "files (since dpkg 1.21.10).  Overridden by the B<--sign-keyfile> option."
9216 msgstr ""
9218 #. type: textblock
9219 #: dpkg-buildpackage.pod
9220 msgid ""
9221 "If set, it will contain a space-separated list of options that might affect "
9222 "the build process in I<debian/rules>, and the behavior of some dpkg "
9223 "commands."
9224 msgstr ""
9226 #. type: textblock
9227 #: dpkg-buildpackage.pod
9228 msgid ""
9229 "With B<nocheck> the B<DEB_CHECK_COMMAND> variable will be ignored.  With "
9230 "B<parallel=>I<N> the parallel jobs will be set to I<N>, overridden by the "
9231 "B<--jobs-try> option."
9232 msgstr ""
9234 #. type: =item
9235 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod
9236 msgid "B<DEB_BUILD_PROFILES>"
9237 msgstr ""
9239 #. type: textblock
9240 #: dpkg-buildpackage.pod
9241 msgid ""
9242 "If set, it will be used as the active build profile(s) for the package being "
9243 "built (since dpkg 1.17.2).  It is a space separated list of profile names.  "
9244 "Overridden by the B<-P> option."
9245 msgstr ""
9247 #. type: =head2
9248 #: dpkg-buildpackage.pod dpkg-query.pod dpkg.pod
9249 msgid "Internal environment"
9250 msgstr ""
9252 #. type: textblock
9253 #: dpkg-buildpackage.pod
9254 msgid ""
9255 "Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should "
9256 "not rely on their presence and should instead use the respective interface "
9257 "to retrieve the needed values, because that file is the main entry point to "
9258 "build packages and running it standalone should be supported."
9259 msgstr ""
9261 #. type: =item
9262 #: dpkg-buildpackage.pod
9263 msgid "B<DEB_BUILD_*>"
9264 msgstr ""
9266 #. type: =item
9267 #: dpkg-buildpackage.pod
9268 msgid "B<DEB_HOST_*>"
9269 msgstr ""
9271 #. type: =item
9272 #: dpkg-buildpackage.pod
9273 msgid "B<DEB_TARGET_*>"
9274 msgstr ""
9276 #. type: textblock
9277 #: dpkg-buildpackage.pod
9278 msgid ""
9279 "B<dpkg-architecture> is called with the B<-a> and B<-t> parameters "
9280 "forwarded. Any variable that is output by its B<-s> option is integrated in "
9281 "the build environment."
9282 msgstr ""
9284 #. type: =item
9285 #: dpkg-buildpackage.pod
9286 msgid "B<DEB_RULES_REQUIRES_ROOT>"
9287 msgstr ""
9289 #. type: textblock
9290 #: dpkg-buildpackage.pod
9291 msgid ""
9292 "This variable is set to the value obtained from the B<Rules-Requires-Root> "
9293 "field or from the command-line.  When set, it will be a valid value for the "
9294 "B<Rules-Requires-Root> field.  It is used to notify B<debian/rules> whether "
9295 "the B<rootless-builds.txt> specification is supported."
9296 msgstr ""
9298 #. type: =item
9299 #: dpkg-buildpackage.pod
9300 msgid "B<DEB_GAIN_ROOT_CMD>"
9301 msgstr ""
9303 #. type: textblock
9304 #: dpkg-buildpackage.pod
9305 msgid ""
9306 "This variable is set to I<gain-root-command> when the field "
9307 "B<Rules-Requires-Root> is set to a value different to B<no> and "
9308 "B<binary-targets>."
9309 msgstr ""
9311 #. type: =item
9312 #: dpkg-buildpackage.pod dpkg-deb.pod dpkg-source.pod dpkg-split.pod
9313 msgid "B<SOURCE_DATE_EPOCH>"
9314 msgstr ""
9316 #. type: textblock
9317 #: dpkg-buildpackage.pod
9318 msgid ""
9319 "This variable is set to the Unix timestamp since the epoch of the latest "
9320 "entry in I<debian/changelog>, if it is not already defined."
9321 msgstr ""
9323 #. type: =item
9324 #: dpkg-buildpackage.pod
9325 msgid "I<%PKGCONFDIR%/buildpackage.conf>"
9326 msgstr ""
9328 #. type: textblock
9329 #: dpkg-buildpackage.pod
9330 msgid "System wide configuration file"
9331 msgstr ""
9333 #. type: =item
9334 #: dpkg-buildpackage.pod
9335 msgid "I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or"
9336 msgstr ""
9338 #. type: =item
9339 #: dpkg-buildpackage.pod
9340 msgid "I<$HOME/.config/dpkg/buildpackage.conf>"
9341 msgstr ""
9343 #. type: =head2
9344 #: dpkg-buildpackage.pod
9345 msgid "Compiler flags are no longer exported"
9346 msgstr ""
9348 #. type: textblock
9349 #: dpkg-buildpackage.pod
9350 msgid ""
9351 "Between dpkg 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler "
9352 "flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with "
9353 "values as returned by B<dpkg-buildflags>. This is no longer the case."
9354 msgstr ""
9356 #. type: =head2
9357 #: dpkg-buildpackage.pod
9358 msgid "Default build targets"
9359 msgstr ""
9361 #. type: textblock
9362 #: dpkg-buildpackage.pod
9363 msgid ""
9364 "B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets "
9365 "since dpkg 1.16.2. Those targets are thus mandatory. But to avoid breakages "
9366 "of existing packages, and ease the transition, if the source package does "
9367 "not build both architecture independent and dependent binary packages (since "
9368 "dpkg 1.18.8) it will fallback to use the B<build> target if B<make -f "
9369 "debian/rules -qn> I<build-target> returns 2 as exit code."
9370 msgstr ""
9372 #. type: textblock
9373 #: dpkg-buildpackage.pod
9374 msgid ""
9375 "It should be possible to specify spaces and shell metacharacters and initial "
9376 "arguments for I<gain-root-command> and I<sign-command>."
9377 msgstr ""
9379 #. type: textblock
9380 #: dpkg-buildpackage.pod
9381 msgid ""
9382 "I<%PKGDOCDIR%/spec/rootless-builds.txt>, B<dpkg-source>(1), "
9383 "B<dpkg-architecture>(1), B<dpkg-buildflags>(1), B<dpkg-genbuildinfo>(1), "
9384 "B<dpkg-genchanges>(1), B<fakeroot>(1), B<lintian>(1), "
9385 "L<https://datatracker.ietf.org/doc/draft-dkg-openpgp-stateless-cli/>, "
9386 "B<sq>(1), B<gpg>(1)."
9387 msgstr ""
9389 #. type: textblock
9390 #: dpkg-checkbuilddeps.pod
9391 msgid "dpkg-checkbuilddeps - check build dependencies and conflicts"
9392 msgstr ""
9394 #. type: textblock
9395 #: dpkg-checkbuilddeps.pod
9396 msgid "B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]"
9397 msgstr ""
9399 #. type: textblock
9400 #: dpkg-checkbuilddeps.pod
9401 msgid ""
9402 "This program checks the installed packages in the system against the build "
9403 "dependencies and build conflicts listed in the control file. If any are not "
9404 "met, it displays them and exits with a nonzero return code."
9405 msgstr ""
9407 #. type: textblock
9408 #: dpkg-checkbuilddeps.pod
9409 msgid ""
9410 "By default, B<debian/control> is read, but an alternate control filename may "
9411 "be specified on the command line."
9412 msgstr ""
9414 #. type: textblock
9415 #: dpkg-checkbuilddeps.pod
9416 msgid ""
9417 "Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch> lines (since dpkg "
9418 "1.16.4).  Use when only arch-indep packages will be built, or combine with "
9419 "B<-B> when only a source package is to be built."
9420 msgstr ""
9422 #. type: textblock
9423 #: dpkg-checkbuilddeps.pod
9424 msgid ""
9425 "Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep> lines. Use when "
9426 "only arch-dep packages will be built, or combine with B<-A> when only a "
9427 "source package is to be built."
9428 msgstr ""
9430 #. type: =item
9431 #: dpkg-checkbuilddeps.pod
9432 msgid "B<-I>"
9433 msgstr ""
9435 #. type: textblock
9436 #: dpkg-checkbuilddeps.pod
9437 msgid ""
9438 "Ignore built-in build depends and conflicts (since dpkg 1.18.2).  These are "
9439 "implicit dependencies that are usually required on a specific distribution, "
9440 "the so called Build-Essential package set."
9441 msgstr ""
9443 #. type: =item
9444 #: dpkg-checkbuilddeps.pod
9445 msgid "B<-d> I<build-depends-string>"
9446 msgstr ""
9448 #. type: =item
9449 #: dpkg-checkbuilddeps.pod
9450 msgid "B<-c> I<build-conflicts-string>"
9451 msgstr ""
9453 #. type: textblock
9454 #: dpkg-checkbuilddeps.pod
9455 msgid ""
9456 "Use the given build dependencies/conflicts instead of those contained in the "
9457 "I<debian/control> file (since dpkg 1.14.17)."
9458 msgstr ""
9460 #. type: =item
9461 #: dpkg-checkbuilddeps.pod
9462 msgid "B<-a> I<arch>"
9463 msgstr ""
9465 #. type: textblock
9466 #: dpkg-checkbuilddeps.pod
9467 msgid ""
9468 "Check build dependencies/conflicts assuming that the package described in "
9469 "the control file is to be built for the given host architecture instead of "
9470 "the architecture of the current system (since dpkg 1.16.2)."
9471 msgstr ""
9473 #. type: =item
9474 #: dpkg-checkbuilddeps.pod
9475 msgid "B<-P> I<profile>[B<,>...]"
9476 msgstr ""
9478 #. type: textblock
9479 #: dpkg-checkbuilddeps.pod
9480 msgid ""
9481 "Check build dependencies/conflicts assuming that the package described in "
9482 "the control file is to be built for the given build profile(s)  (since dpkg "
9483 "1.17.2).  The argument is a comma-separated list of profile names."
9484 msgstr ""
9486 #. type: textblock
9487 #: dpkg-checkbuilddeps.pod
9488 msgid ""
9489 "If set, it will be used as the active build profile(s) for the package being "
9490 "built. It is a space separated list of profile names. Overridden by the "
9491 "B<-P> option."
9492 msgstr ""
9494 #. type: textblock
9495 #: dpkg-deb.pod
9496 msgid "dpkg-deb - Debian package archive (.deb) manipulation tool"
9497 msgstr ""
9499 #. type: textblock
9500 #: dpkg-deb.pod
9501 msgid "B<dpkg-deb> [I<option>...] I<command>"
9502 msgstr ""
9504 #. type: textblock
9505 #: dpkg-deb.pod
9506 msgid "B<dpkg-deb> packs, unpacks and provides information about Debian archives."
9507 msgstr ""
9509 #. type: textblock
9510 #: dpkg-deb.pod
9511 msgid "Use B<dpkg> to install and remove packages from your system."
9512 msgstr ""
9514 #. type: textblock
9515 #: dpkg-deb.pod
9516 msgid ""
9517 "You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you "
9518 "want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> "
9519 "and run it for you."
9520 msgstr ""
9522 #. type: textblock
9523 #: dpkg-deb.pod
9524 msgid ""
9525 "For most commands taking an input archive argument, the archive can be read "
9526 "from standard input if the archive name is given as a single minus character "
9527 "(«B<->»); otherwise lack of support will be documented in their respective "
9528 "command description."
9529 msgstr ""
9531 #. type: =item
9532 #: dpkg-deb.pod
9533 msgid "B<-b>, B<--build> I<binary-directory> [I<archive>|I<directory>]"
9534 msgstr ""
9536 #. type: textblock
9537 #: dpkg-deb.pod
9538 msgid ""
9539 "Creates a debian archive from the filesystem tree stored in "
9540 "I<binary-directory>. I<binary-directory> must have a B<DEBIAN> subdirectory, "
9541 "which contains the control information files such as the control file "
9542 "itself. This directory will I<not> appear in the binary package's filesystem "
9543 "archive, but instead the files in it will be put in the binary package's "
9544 "control information area."
9545 msgstr ""
9547 #. type: textblock
9548 #: dpkg-deb.pod
9549 msgid ""
9550 "Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and "
9551 "parse it. It will check the file for syntax errors and other problems, and "
9552 "display the name of the binary package being built.  B<dpkg-deb> will also "
9553 "check the permissions of the maintainer scripts and other files found in the "
9554 "B<DEBIAN> control information directory."
9555 msgstr ""
9557 #. type: textblock
9558 #: dpkg-deb.pod
9559 msgid ""
9560 "If no I<archive> is specified then B<dpkg-deb> will write the package into "
9561 "the file I<binary-directory>B<.deb>."
9562 msgstr ""
9564 #. type: textblock
9565 #: dpkg-deb.pod
9566 msgid "If the archive to be created already exists it will be overwritten."
9567 msgstr ""
9569 #. type: textblock
9570 #: dpkg-deb.pod
9571 msgid ""
9572 "If the second argument is a directory then B<dpkg-deb> will write to the "
9573 "file I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> When a "
9574 "target directory is specified, rather than a file, the B<--nocheck> option "
9575 "may not be used (since B<dpkg-deb> needs to read and parse the package "
9576 "control file to determine which filename to use)."
9577 msgstr ""
9579 #. type: =item
9580 #: dpkg-deb.pod
9581 msgid "B<-I>, B<--info> I<archive> [I<control-file-name>...]"
9582 msgstr ""
9584 #. type: textblock
9585 #: dpkg-deb.pod
9586 msgid "Provides information about a binary package archive."
9587 msgstr ""
9589 #. type: textblock
9590 #: dpkg-deb.pod
9591 msgid ""
9592 "If no I<control-file-name>s are specified then it will print a summary of "
9593 "the contents of the package as well as its control file."
9594 msgstr ""
9596 #. type: textblock
9597 #: dpkg-deb.pod
9598 msgid ""
9599 "If any I<control-file-name>s are specified then B<dpkg-deb> will print them "
9600 "in the order they were specified; if any of the components weren't present "
9601 "it will print an error message to stderr about each one and exit with status "
9602 "2."
9603 msgstr ""
9605 #. type: =item
9606 #: dpkg-deb.pod
9607 msgid "B<-W>, B<--show> I<archive>"
9608 msgstr ""
9610 #. type: textblock
9611 #: dpkg-deb.pod
9612 msgid ""
9613 "Provides information about a binary package archive in the format specified "
9614 "by the B<--showformat> argument. The default format displays the package's "
9615 "name and version on one line, separated by a tabulator."
9616 msgstr ""
9618 #. type: =item
9619 #: dpkg-deb.pod
9620 msgid "B<-f>, B<--field> I<archive> [I<control-field-name>...]"
9621 msgstr ""
9623 #. type: textblock
9624 #: dpkg-deb.pod
9625 msgid "Extracts control file information from a binary package archive."
9626 msgstr ""
9628 #. type: textblock
9629 #: dpkg-deb.pod
9630 msgid ""
9631 "If no I<control-field-name>s are specified then it will print the whole "
9632 "control file."
9633 msgstr ""
9635 #. type: textblock
9636 #: dpkg-deb.pod
9637 msgid ""
9638 "If any are specified then B<dpkg-deb> will print their contents, in the "
9639 "order in which they appear in the control file. If more than one "
9640 "I<control-field-name> is specified then B<dpkg-deb> will precede each with "
9641 "its field name (and a colon and space)."
9642 msgstr ""
9644 #. type: textblock
9645 #: dpkg-deb.pod
9646 msgid "No errors are reported for fields requested but not found."
9647 msgstr ""
9649 #. type: =item
9650 #: dpkg-deb.pod dpkg.pod
9651 msgid "B<-c>, B<--contents> I<archive>"
9652 msgstr ""
9654 #. type: textblock
9655 #: dpkg-deb.pod
9656 msgid ""
9657 "Lists the contents of the filesystem tree archive portion of the package "
9658 "archive. It is currently produced in the format generated by B<tar>'s "
9659 "verbose listing."
9660 msgstr ""
9662 #. type: =item
9663 #: dpkg-deb.pod dpkg.pod
9664 msgid "B<-x>, B<--extract> I<archive> I<directory>"
9665 msgstr ""
9667 #. type: textblock
9668 #: dpkg-deb.pod
9669 msgid ""
9670 "Extracts the filesystem tree from a package archive into the specified "
9671 "directory."
9672 msgstr ""
9674 #. type: textblock
9675 #: dpkg-deb.pod
9676 msgid ""
9677 "Note that extracting a package to the root directory will I<not> result in a "
9678 "correct installation! Use B<dpkg> to install packages."
9679 msgstr ""
9681 #. type: textblock
9682 #: dpkg-deb.pod
9683 msgid ""
9684 "I<directory> (but not its parents) will be created if necessary, and its "
9685 "permissions modified to match the contents of the package."
9686 msgstr ""
9688 #. type: =item
9689 #: dpkg-deb.pod dpkg.pod
9690 msgid "B<-X>, B<--vextract> I<archive> I<directory>"
9691 msgstr ""
9693 #. type: textblock
9694 #: dpkg-deb.pod
9695 msgid ""
9696 "Is like B<--extract> (B<-x>)  with B<--verbose> (B<-v>)  which prints a "
9697 "listing of the files extracted as it goes."
9698 msgstr ""
9700 #. type: =item
9701 #: dpkg-deb.pod
9702 msgid "B<-R>, B<--raw-extract> I<archive> I<directory>"
9703 msgstr ""
9705 #. type: textblock
9706 #: dpkg-deb.pod
9707 msgid ""
9708 "Extracts the filesystem tree from a package archive into a specified "
9709 "directory, and the control information files into a B<DEBIAN> subdirectory "
9710 "of the specified directory (since dpkg 1.16.1)."
9711 msgstr ""
9713 #. type: textblock
9714 #: dpkg-deb.pod
9715 msgid "The target directory (but not its parents) will be created if necessary."
9716 msgstr ""
9718 #. type: textblock
9719 #: dpkg-deb.pod
9720 msgid ""
9721 "The input archive is not (currently) processed sequentially, so reading it "
9722 "from standard input («B<->») is B<not> supported."
9723 msgstr ""
9725 #. type: =item
9726 #: dpkg-deb.pod dpkg.pod
9727 msgid "B<--ctrl-tarfile> I<archive>"
9728 msgstr ""
9730 #. type: textblock
9731 #: dpkg-deb.pod
9732 msgid ""
9733 "Extracts the control data from a binary package and sends it to standard "
9734 "output in B<tar> format (since dpkg 1.17.14). Together with B<tar>(1)  this "
9735 "can be used to extract a particular control file from a package archive.  "
9736 "The input archive will always be processed sequentially."
9737 msgstr ""
9739 #. type: =item
9740 #: dpkg-deb.pod dpkg.pod
9741 msgid "B<--fsys-tarfile> I<archive>"
9742 msgstr ""
9744 #. type: textblock
9745 #: dpkg-deb.pod
9746 msgid ""
9747 "Extracts the filesystem tree data from a binary package and sends it to "
9748 "standard output in B<tar> format. Together with B<tar>(1)  this can be used "
9749 "to extract a particular file from a package archive.  The input archive will "
9750 "always be processed sequentially."
9751 msgstr ""
9753 #. type: =item
9754 #: dpkg-deb.pod dpkg.pod
9755 msgid "B<-e>, B<--control> I<archive> [I<directory>]"
9756 msgstr ""
9758 #. type: textblock
9759 #: dpkg-deb.pod
9760 msgid ""
9761 "Extracts the control information files from a package archive into the "
9762 "specified directory."
9763 msgstr ""
9765 #. type: textblock
9766 #: dpkg-deb.pod
9767 msgid ""
9768 "If no directory is specified then a subdirectory B<DEBIAN> in the current "
9769 "directory is used."
9770 msgstr ""
9772 #. type: =item
9773 #: dpkg-deb.pod
9774 msgid "B<--showformat=>I<format>"
9775 msgstr ""
9777 #. type: textblock
9778 #: dpkg-deb.pod
9779 msgid ""
9780 "This option is used to specify the format of the output B<--show> will "
9781 "produce. The format is a string that will be output for each package listed."
9782 msgstr ""
9784 #. type: textblock
9785 #: dpkg-deb.pod
9786 msgid ""
9787 "The string may reference any status field using the “${I<field-name>}” form, "
9788 "a list of the valid fields can be easily produced using B<-I> on the same "
9789 "package. A complete explanation of the formatting options (including escape "
9790 "sequences and field tabbing) can be found in the explanation of the "
9791 "B<--showformat> option in B<dpkg-query>(1)."
9792 msgstr ""
9794 #. type: textblock
9795 #: dpkg-deb.pod
9796 msgid "The default for this field is “${Package}\\t${Version}\\n”."
9797 msgstr ""
9799 #. type: =item
9800 #: dpkg-deb.pod
9801 msgid "B<-z>I<compress-level>"
9802 msgstr ""
9804 #. type: textblock
9805 #: dpkg-deb.pod
9806 msgid ""
9807 "Specify which compression level to use on the compressor backend, when "
9808 "building a package (default is 9 for gzip, 6 for xz, 3 for zstd).  The "
9809 "accepted values are compressor specific.  For gzip, from 0-9 with 0 being "
9810 "mapped to compressor none.  For xz from 0-9.  For zstd from 0-22, with "
9811 "levels from 20 to 22 enabling its ultra mode.  Before dpkg 1.16.2 level 0 "
9812 "was equivalent to compressor none for all compressors."
9813 msgstr ""
9815 #. type: =item
9816 #: dpkg-deb.pod
9817 msgid "B<-S>I<compress-strategy>"
9818 msgstr ""
9820 #. type: textblock
9821 #: dpkg-deb.pod
9822 msgid ""
9823 "Specify which compression strategy to use on the compressor backend, when "
9824 "building a package (since dpkg 1.16.2). Allowed values are B<none> (since "
9825 "dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> and B<fixed> for gzip (since "
9826 "dpkg 1.17.0) and B<extreme> for xz."
9827 msgstr ""
9829 #. type: =item
9830 #: dpkg-deb.pod
9831 msgid "B<-Z>I<compress-type>"
9832 msgstr ""
9834 #. type: textblock
9835 #: dpkg-deb.pod
9836 msgid ""
9837 "Specify which compression type to use when building a package.  Allowed "
9838 "values are B<gzip>, B<xz> (since dpkg 1.15.6), B<zstd> (since dpkg 1.21.18)  "
9839 "and B<none> (default is B<xz>)."
9840 msgstr ""
9842 #. type: =item
9843 #: dpkg-deb.pod
9844 msgid "B<--[no-]uniform-compression>"
9845 msgstr ""
9847 #. type: textblock
9848 #: dpkg-deb.pod
9849 msgid ""
9850 "Specify that the same compression parameters should be used for all archive "
9851 "members (i.e. B<control.tar> and B<data.tar>; since dpkg 1.17.6).  Otherwise "
9852 "only the B<data.tar> member will use those parameters. The only supported "
9853 "compression types allowed to be uniformly used are B<none>, B<gzip>, B<xz> "
9854 "and B<zstd>.  The B<--no-uniform-compression> option disables uniform "
9855 "compression (since dpkg 1.19.0).  Uniform compression is the default (since "
9856 "dpkg 1.19.0)."
9857 msgstr ""
9859 #. type: =item
9860 #: dpkg-deb.pod dpkg-source.pod
9861 msgid "B<--threads-max=>I<threads>"
9862 msgstr ""
9864 #. type: textblock
9865 #: dpkg-deb.pod
9866 msgid ""
9867 "Sets the maximum number of threads allowed for compressors that support "
9868 "multi-threaded operations (since dpkg 1.21.9)."
9869 msgstr ""
9871 #. type: =item
9872 #: dpkg-deb.pod
9873 msgid "B<--root-owner-group>"
9874 msgstr ""
9876 #. type: textblock
9877 #: dpkg-deb.pod
9878 msgid ""
9879 "Set the owner and group for each entry in the filesystem tree data to root "
9880 "with id 0 (since dpkg 1.19.0)."
9881 msgstr ""
9883 #. type: textblock
9884 #: dpkg-deb.pod
9885 msgid ""
9886 "B<Note>: This option can be useful for rootless builds (see "
9887 "I<rootless-builds.txt>), but should B<not> be used when the entries have an "
9888 "owner or group that is not root.  Support for these will be added later in "
9889 "the form of a meta manifest."
9890 msgstr ""
9892 #. type: =item
9893 #: dpkg-deb.pod
9894 msgid "B<--deb-format=>I<format>"
9895 msgstr ""
9897 #. type: textblock
9898 #: dpkg-deb.pod
9899 msgid ""
9900 "Set the archive format version used when building (since dpkg 1.17.0).  "
9901 "Allowed values are B<2.0> for the new format, and B<0.939000> for the old "
9902 "one (default is B<2.0>)."
9903 msgstr ""
9905 #. type: textblock
9906 #: dpkg-deb.pod
9907 msgid ""
9908 "The old archive format is less easily parsed by non-Debian tools and is now "
9909 "obsolete; its only use is when building packages to be parsed by versions of "
9910 "dpkg older than 0.93.76 (September 1995), which was released as i386 a.out "
9911 "only."
9912 msgstr ""
9914 #. type: =item
9915 #: dpkg-deb.pod
9916 msgid "B<--nocheck>"
9917 msgstr ""
9919 #. type: textblock
9920 #: dpkg-deb.pod
9921 msgid ""
9922 "Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an "
9923 "archive. You can build any archive you want, no matter how broken, this way."
9924 msgstr ""
9926 #. type: =item
9927 #: dpkg-deb.pod start-stop-daemon.pod
9928 msgid "B<-v>, B<--verbose>"
9929 msgstr ""
9931 #. type: textblock
9932 #: dpkg-deb.pod
9933 msgid ""
9934 "Enables verbose output (since dpkg 1.16.1).  This currently only affects "
9935 "B<--extract> making it behave like B<--vextract>."
9936 msgstr ""
9938 #. type: =item
9939 #: dpkg-deb.pod
9940 msgid "B<-D>, B<--debug>"
9941 msgstr ""
9943 #. type: textblock
9944 #: dpkg-deb.pod
9945 msgid "Enables debugging output. This is not very interesting."
9946 msgstr ""
9948 #. type: =head1
9949 #: dpkg-deb.pod dpkg-divert.pod dpkg-query.pod dpkg-split.pod
9950 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg.pod dselect.pod
9951 #: start-stop-daemon.pod update-alternatives.pod
9952 msgid "EXIT STATUS"
9953 msgstr ""
9955 #. type: =item
9956 #: dpkg-deb.pod dpkg-divert.pod dpkg-query.pod dpkg-split.pod
9957 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg.pod dselect.pod
9958 #: start-stop-daemon.pod update-alternatives.pod
9959 msgid "B<0>"
9960 msgstr ""
9962 #. type: textblock
9963 #: dpkg-deb.pod dpkg-divert.pod dpkg-statoverride.pod update-alternatives.pod
9964 msgid "The requested action was successfully performed."
9965 msgstr ""
9967 #. type: =item
9968 #: dpkg-deb.pod dpkg-divert.pod dpkg-query.pod dpkg-split.pod
9969 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg.pod dselect.pod
9970 #: start-stop-daemon.pod update-alternatives.pod
9971 msgid "B<2>"
9972 msgstr ""
9974 #. type: textblock
9975 #: dpkg-deb.pod dpkg-divert.pod dpkg-query.pod dpkg-statoverride.pod
9976 #: dpkg-trigger.pod dpkg.pod dselect.pod
9977 msgid ""
9978 "Fatal or unrecoverable error due to invalid command-line usage, or "
9979 "interactions with the system, such as accesses to the database, memory "
9980 "allocations, etc."
9981 msgstr ""
9983 #. type: =item
9984 #: dpkg-deb.pod
9985 msgid "B<DPKG_DEB_THREADS_MAX>"
9986 msgstr ""
9988 #. type: textblock
9989 #: dpkg-deb.pod
9990 msgid "The B<--threads-max> option overrides this value."
9991 msgstr ""
9993 #. type: =item
9994 #: dpkg-deb.pod
9995 msgid "B<DPKG_DEB_COMPRESSOR_TYPE>"
9996 msgstr ""
9998 #. type: textblock
9999 #: dpkg-deb.pod
10000 msgid "Sets the compressor type to use (since dpkg 1.21.10)."
10001 msgstr ""
10003 #. type: textblock
10004 #: dpkg-deb.pod
10005 msgid "The B<-Z> option overrides this value."
10006 msgstr ""
10008 #. type: =item
10009 #: dpkg-deb.pod
10010 msgid "B<DPKG_DEB_COMPRESSOR_LEVEL>"
10011 msgstr ""
10013 #. type: textblock
10014 #: dpkg-deb.pod
10015 msgid "Sets the compressor level to use (since dpkg 1.21.10)."
10016 msgstr ""
10018 #. type: textblock
10019 #: dpkg-deb.pod
10020 msgid "The B<-z> option overrides this value."
10021 msgstr ""
10023 #. type: =item
10024 #: dpkg-deb.pod dpkg.pod
10025 msgid "B<TMPDIR>"
10026 msgstr ""
10028 #. type: textblock
10029 #: dpkg-deb.pod
10030 msgid ""
10031 "If set, B<dpkg-deb> will use it as the directory in which to create "
10032 "temporary files and directories."
10033 msgstr ""
10035 #. type: textblock
10036 #: dpkg-deb.pod
10037 msgid ""
10038 "If set, it will be used as the timestamp (as seconds since the epoch) in the "
10039 "B<deb>(5)'s B<ar>(5) container and used to clamp the mtime in the B<tar>(5) "
10040 "file entries."
10041 msgstr ""
10043 #. type: textblock
10044 #: dpkg-deb.pod
10045 msgid ""
10046 "Do not attempt to use just B<dpkg-deb> to install software! You must use "
10047 "B<dpkg> proper to ensure that all the files are correctly placed and the "
10048 "package's scripts run and its status and contents recorded."
10049 msgstr ""
10051 #. type: textblock
10052 #: dpkg-deb.pod
10053 msgid "B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing."
10054 msgstr ""
10056 #. type: textblock
10057 #: dpkg-deb.pod
10058 msgid ""
10059 "There is no authentication on B<.deb> files; in fact, there isn't even a "
10060 "straightforward checksum.  (Higher level tools like APT support "
10061 "authenticating B<.deb> packages retrieved from a given repository, and most "
10062 "packages nowadays provide an md5sum control file generated by "
10063 "debian/rules. Though this is not directly supported by the lower level "
10064 "tools.)"
10065 msgstr ""
10067 #. type: textblock
10068 #: dpkg-deb.pod
10069 msgid ""
10070 "F<%PKGDOCDIR%/spec/rootless-builds.txt>, B<deb>(5), B<deb-control>(5), "
10071 "B<dpkg>(1), B<dselect>(1)."
10072 msgstr ""
10074 #. type: textblock
10075 #: dpkg-distaddfile.pod
10076 msgid "dpkg-distaddfile - add entries to debian/files"
10077 msgstr ""
10079 #. type: textblock
10080 #: dpkg-distaddfile.pod
10081 msgid "B<dpkg-distaddfile> [I<option>...] I<filename section priority>"
10082 msgstr ""
10084 #. type: textblock
10085 #: dpkg-distaddfile.pod
10086 msgid "B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>."
10087 msgstr ""
10089 #. type: textblock
10090 #: dpkg-distaddfile.pod
10091 msgid ""
10092 "It takes three non-option arguments, the filename and the section and "
10093 "priority for the B<.changes> file."
10094 msgstr ""
10096 #. type: textblock
10097 #: dpkg-distaddfile.pod
10098 msgid ""
10099 "The filename should be specified relative to the directory where "
10100 "B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than "
10101 "being a pathname relative to the current directory when B<dpkg-distaddfile> "
10102 "is run."
10103 msgstr ""
10105 #. type: =item
10106 #: dpkg-distaddfile.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
10107 #: dpkg-gencontrol.pod
10108 msgid "B<-f>I<files-list-file>"
10109 msgstr ""
10111 #. type: textblock
10112 #: dpkg-distaddfile.pod dpkg-gencontrol.pod
10113 msgid ""
10114 "Read or write the list of files to be uploaded here, rather than using "
10115 "B<debian/files>."
10116 msgstr ""
10118 #. type: textblock
10119 #: dpkg-distaddfile.pod
10120 msgid ""
10121 "The list of generated files which are part of the upload being prepared.  "
10122 "B<dpkg-distaddfile> can be used to add additional files."
10123 msgstr ""
10125 #. type: textblock
10126 #: dpkg-distaddfile.pod
10127 msgid "B<deb-src-files>(5)."
10128 msgstr ""
10130 #. type: textblock
10131 #: dpkg-divert.pod
10132 msgid "dpkg-divert - override a package's version of a file"
10133 msgstr ""
10135 #. type: textblock
10136 #: dpkg-divert.pod
10137 msgid "B<dpkg-divert> [I<option>...] I<command>"
10138 msgstr ""
10140 #. type: textblock
10141 #: dpkg-divert.pod
10142 msgid ""
10143 "B<dpkg-divert> is the utility used to set up and update the list of "
10144 "diversions."
10145 msgstr ""
10147 #. type: textblock
10148 #: dpkg-divert.pod
10149 msgid ""
10150 "File I<diversions> are a way of forcing B<dpkg>(1)  not to install a file "
10151 "into its location, but to a I<diverted> location. Diversions can be used "
10152 "through the Debian package scripts to move a file away when it causes a "
10153 "conflict. System administrators can also use it to override some package's "
10154 "configuration file, or whenever some files (which aren't marked as "
10155 "“conffiles”) need to be preserved by B<dpkg>, when installing a newer "
10156 "version of a package which contains those files."
10157 msgstr ""
10159 #. type: =item
10160 #: dpkg-divert.pod
10161 msgid "[B<--add>] I<file>"
10162 msgstr ""
10164 #. type: textblock
10165 #: dpkg-divert.pod
10166 msgid ""
10167 "Add a diversion for I<file>.  The file is currently not renamed, see "
10168 "B<--rename>."
10169 msgstr ""
10171 #. type: =item
10172 #: dpkg-divert.pod
10173 msgid "B<--remove> I<file>"
10174 msgstr ""
10176 #. type: textblock
10177 #: dpkg-divert.pod
10178 msgid ""
10179 "Remove a diversion for I<file>.  The file is currently not renamed, see "
10180 "B<--rename>."
10181 msgstr ""
10183 #. type: =item
10184 #: dpkg-divert.pod dpkg-statoverride.pod
10185 msgid "B<--list> [I<glob-pattern>]"
10186 msgstr ""
10188 #. type: textblock
10189 #: dpkg-divert.pod
10190 msgid "List all diversions, or ones matching I<glob-pattern>."
10191 msgstr ""
10193 #. type: =item
10194 #: dpkg-divert.pod
10195 msgid "B<--listpackage> I<file>"
10196 msgstr ""
10198 #. type: textblock
10199 #: dpkg-divert.pod
10200 msgid ""
10201 "Print the name of the package that diverts I<file> (since dpkg 1.15.0).  "
10202 "Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not "
10203 "diverted."
10204 msgstr ""
10206 #. type: =item
10207 #: dpkg-divert.pod
10208 msgid "B<--truename> I<file>"
10209 msgstr ""
10211 #. type: textblock
10212 #: dpkg-divert.pod
10213 msgid "Print the real name for a diverted file."
10214 msgstr ""
10216 #. type: =item
10217 #: dpkg-divert.pod dpkg-split.pod dpkg-statoverride.pod dselect.pod
10218 #: update-alternatives.pod
10219 msgid "B<--admindir> I<directory>"
10220 msgstr ""
10222 #. type: textblock
10223 #: dpkg-divert.pod
10224 msgid ""
10225 "Set the administrative directory to I<directory>.  Defaults to "
10226 "«I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set."
10227 msgstr ""
10229 #. type: =item
10230 #: dpkg-divert.pod dpkg-realpath.pod dpkg-statoverride.pod dselect.pod
10231 #: update-alternatives.pod
10232 msgid "B<--instdir> I<directory>"
10233 msgstr ""
10235 #. type: textblock
10236 #: dpkg-divert.pod dpkg-statoverride.pod
10237 msgid ""
10238 "Set the installation directory, which refers to the directory where packages "
10239 "get installed (since dpkg 1.19.2).  Defaults to «I</>» if B<DPKG_ROOT> has "
10240 "not been set."
10241 msgstr ""
10243 #. type: =item
10244 #: dpkg-divert.pod dpkg-realpath.pod dpkg-split.pod dpkg-statoverride.pod
10245 #: dselect.pod update-alternatives.pod
10246 msgid "B<--root> I<directory>"
10247 msgstr ""
10249 #. type: textblock
10250 #: dpkg-divert.pod dpkg-statoverride.pod
10251 msgid ""
10252 "Set the root directory to B<directory>, which sets the installation "
10253 "directory to «I<directory>» and the administrative directory to "
10254 "«I<directory>B<%ADMINDIR%>» (since dpkg 1.19.2)  if B<DPKG_ROOT> has not "
10255 "been set."
10256 msgstr ""
10258 #. type: =item
10259 #: dpkg-divert.pod
10260 msgid "B<--divert> I<divert-to>"
10261 msgstr ""
10263 #. type: textblock
10264 #: dpkg-divert.pod
10265 msgid ""
10266 "I<divert-to> is the location where the versions of I<file>, as provided by "
10267 "other packages, will be diverted."
10268 msgstr ""
10270 #. type: =item
10271 #: dpkg-divert.pod
10272 msgid "B<--local>"
10273 msgstr ""
10275 #. type: textblock
10276 #: dpkg-divert.pod
10277 msgid ""
10278 "Specifies that all packages' versions of this file are diverted.  This "
10279 "means, that there are no exceptions, and whatever package is installed, the "
10280 "file is diverted. This can be used by an admin to install a locally modified "
10281 "version."
10282 msgstr ""
10284 #. type: =item
10285 #: dpkg-divert.pod
10286 msgid "B<--package> I<package>"
10287 msgstr ""
10289 #. type: textblock
10290 #: dpkg-divert.pod
10291 msgid ""
10292 "I<package> is the name of a package whose copy of I<file> will not be "
10293 "diverted. i.e. I<file> will be diverted for all packages except I<package>."
10294 msgstr ""
10296 #. type: =item
10297 #: dpkg-divert.pod dpkg-statoverride.pod update-alternatives.pod
10298 msgid "B<--quiet>"
10299 msgstr ""
10301 #. type: textblock
10302 #: dpkg-divert.pod
10303 msgid "Quiet mode, i.e. no verbose output."
10304 msgstr ""
10306 #. type: =item
10307 #: dpkg-divert.pod
10308 msgid "B<--rename>"
10309 msgstr ""
10311 #. type: textblock
10312 #: dpkg-divert.pod
10313 msgid ""
10314 "Actually move the file aside (or back). B<dpkg-divert> will abort operation "
10315 "in case the destination file already exists.  This is the common behavior "
10316 "used for diversions of files from the non-B<Essential> package set (see "
10317 "B<--no-rename> for more details)."
10318 msgstr ""
10320 #. type: =item
10321 #: dpkg-divert.pod
10322 msgid "B<--no-rename>"
10323 msgstr ""
10325 #. type: textblock
10326 #: dpkg-divert.pod
10327 msgid ""
10328 "Specifies that the file should not be renamed while adding or removing the "
10329 "diversion into the database (since dpkg 1.19.1).  This is intended for "
10330 "diversions of files from the B<Essential> package set, where the temporary "
10331 "disappearance of the original file is not acceptable, as it can render the "
10332 "system non-functional.  This is the default behavior, but that will change "
10333 "in the dpkg 1.20.x cycle."
10334 msgstr ""
10336 #. type: =item
10337 #: dpkg-divert.pod
10338 msgid "B<--test>"
10339 msgstr ""
10341 #. type: textblock
10342 #: dpkg-divert.pod
10343 msgid "Test mode, i.e. don't actually perform any changes, just demonstrate."
10344 msgstr ""
10346 #. type: =item
10347 #: dpkg-divert.pod dpkg-maintscript-helper.pod dpkg-query.pod dpkg-realpath.pod
10348 #: dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod dpkg.pod dselect.pod
10349 msgid "B<DPKG_ROOT>"
10350 msgstr ""
10352 #. type: textblock
10353 #: dpkg-divert.pod dpkg-statoverride.pod
10354 msgid ""
10355 "If set and the B<--instdir> or B<--root> options have not been specified, it "
10356 "will be used as the filesystem root directory (since dpkg 1.19.2)."
10357 msgstr ""
10359 #. type: =item
10360 #: dpkg-divert.pod dpkg-maintscript-helper.pod dpkg-query.pod dpkg-split.pod
10361 #: dpkg-statoverride.pod dpkg-trigger.pod dpkg.pod dselect.pod
10362 msgid "B<DPKG_ADMINDIR>"
10363 msgstr ""
10365 #. type: textblock
10366 #: dpkg-divert.pod dpkg-statoverride.pod
10367 msgid ""
10368 "If set and the B<--admindir> or B<--root> options have not been specified, "
10369 "it will be used as the B<dpkg> data directory."
10370 msgstr ""
10372 #. type: =item
10373 #: dpkg-divert.pod dpkg.pod
10374 msgid "B<DPKG_MAINTSCRIPT_PACKAGE>"
10375 msgstr ""
10377 #. type: textblock
10378 #: dpkg-divert.pod
10379 msgid ""
10380 "If set and the B<--local> and B<--package> options have not been specified, "
10381 "B<dpkg-divert> will use it as the package name."
10382 msgstr ""
10384 #. type: =item
10385 #: dpkg-divert.pod dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod
10386 #: dpkg-trigger.pod dpkg.pod
10387 msgid "B<DPKG_DEBUG>"
10388 msgstr ""
10390 #. type: textblock
10391 #: dpkg-divert.pod dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod
10392 #: dpkg-trigger.pod
10393 msgid ""
10394 "Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently "
10395 "accepted flags are described in the B<dpkg --debug> option, but not all "
10396 "these flags might have an effect on this program."
10397 msgstr ""
10399 #. type: =item
10400 #: dpkg-divert.pod
10401 msgid "I<%ADMINDIR%/diversions>"
10402 msgstr ""
10404 #. type: textblock
10405 #: dpkg-divert.pod
10406 msgid ""
10407 "File which contains the current list of diversions of the system. It is "
10408 "located in the B<dpkg> administration directory, along with other files "
10409 "important to B<dpkg>, such as I<status> or I<available>."
10410 msgstr ""
10412 #. type: textblock
10413 #: dpkg-divert.pod
10414 msgid ""
10415 "B<Note:> B<dpkg-divert> preserves the old copy of this file, with extension "
10416 "I<-old>, before replacing it with the new one."
10417 msgstr ""
10419 #. type: textblock
10420 #: dpkg-divert.pod
10421 msgid ""
10422 "When adding, default is B<--local> and B<--divert> "
10423 "I<original>B<.distrib>. When removing, B<--package> or B<--local> and "
10424 "B<--divert> must match if specified."
10425 msgstr ""
10427 #. type: textblock
10428 #: dpkg-divert.pod
10429 msgid "Directories can't be diverted with B<dpkg-divert>."
10430 msgstr ""
10432 #. type: textblock
10433 #: dpkg-divert.pod
10434 msgid ""
10435 "Care should be taken when diverting shared libraries, B<ldconfig>(8)  "
10436 "creates a symbolic link based on the DT_SONAME field embedded in the "
10437 "library.  Because B<ldconfig> does not honor diverts (only B<dpkg> does), "
10438 "the symlink may end up pointing at the diverted library, if a diverted "
10439 "library has the same SONAME as the undiverted one."
10440 msgstr ""
10442 #. type: textblock
10443 #: dpkg-divert.pod
10444 msgid ""
10445 "To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, "
10446 "i.e. directs all packages providing I</usr/bin/example> to install it as "
10447 "I</usr/bin/example.foo>, performing the rename if required:"
10448 msgstr ""
10450 #. type: verbatim
10451 #: dpkg-divert.pod
10452 #, no-wrap
10453 msgid ""
10454 " dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example\n"
10455 "\n"
10456 msgstr ""
10458 #. type: textblock
10459 #: dpkg-divert.pod
10460 msgid "To remove that diversion:"
10461 msgstr ""
10463 #. type: verbatim
10464 #: dpkg-divert.pod
10465 #, no-wrap
10466 msgid ""
10467 " dpkg-divert --rename --remove /usr/bin/example\n"
10468 "\n"
10469 msgstr ""
10471 #. type: textblock
10472 #: dpkg-divert.pod
10473 msgid ""
10474 "To divert any package trying to install I</usr/bin/example> to "
10475 "I</usr/bin/example.foo>, except your own I<wibble> package:"
10476 msgstr ""
10478 #. type: verbatim
10479 #: dpkg-divert.pod
10480 #, no-wrap
10481 msgid ""
10482 " dpkg-divert --package wibble --divert /usr/bin/example.foo \\\n"
10483 "    --rename /usr/bin/example\n"
10484 "\n"
10485 msgstr ""
10487 #. type: verbatim
10488 #: dpkg-divert.pod
10489 #, no-wrap
10490 msgid ""
10491 " dpkg-divert --package wibble --rename --remove /usr/bin/example\n"
10492 "\n"
10493 msgstr ""
10495 #. type: textblock
10496 #: dpkg-fsys-usrunmess.pod
10497 msgid "dpkg-fsys-usrunmess - undoes the merged-/usr-via-aliased-dirs mess"
10498 msgstr ""
10500 #. type: textblock
10501 #: dpkg-fsys-usrunmess.pod
10502 msgid "B<dpkg-fsys-usrunmess> [B<option>...]"
10503 msgstr ""
10505 #. type: textblock
10506 #: dpkg-fsys-usrunmess.pod
10507 msgid ""
10508 "B<dpkg-fsys-usrunmess> is a tool to fix up filesystems that have been "
10509 "installed anew with recent installers with unfortunate defaults or migrated "
10510 "to the broken merged /usr via aliased directories layout, which is B<not> "
10511 "supported by dpkg. See the dpkg FAQ."
10512 msgstr ""
10514 #. type: textblock
10515 #: dpkg-fsys-usrunmess.pod
10516 msgid ""
10517 "B<Note>: In Debian its tech-ctte has decreed that on the release after "
10518 "bookworm the non-usrmerged layout is not going to be supported, and thus "
10519 "some of its maintainers might not fix issues or intentionally remove "
10520 "non-usrmerged support, so you will need decide and pick your poison."
10521 msgstr ""
10523 #. type: textblock
10524 #: dpkg-fsys-usrunmess.pod
10525 msgid "The program will perform the following overall actions:"
10526 msgstr ""
10528 #. type: textblock
10529 #: dpkg-fsys-usrunmess.pod
10530 msgid "Check whether the system needs to be switched, otherwise do nothing,"
10531 msgstr ""
10533 #. type: textblock
10534 #: dpkg-fsys-usrunmess.pod
10535 msgid "Check for dpkg database consistency and otherwise abort."
10536 msgstr ""
10538 #. type: textblock
10539 #: dpkg-fsys-usrunmess.pod
10540 msgid ""
10541 "Generate and install a regression prevention package, if requested on the "
10542 "command-line or otherwise on the prompt."
10543 msgstr ""
10545 #. type: textblock
10546 #: dpkg-fsys-usrunmess.pod
10547 msgid "Get the list of files and alternatives that need to be restored."
10548 msgstr ""
10550 #. type: textblock
10551 #: dpkg-fsys-usrunmess.pod
10552 msgid "Look for untracked kernel modules files that need to be moved too."
10553 msgstr ""
10555 #. type: textblock
10556 #: dpkg-fsys-usrunmess.pod
10557 msgid ""
10558 "Create a shadow hierarchy under F</.usrunmess>, by creating the directories "
10559 "symlinks or hardlinking or copying the files as needed."
10560 msgstr ""
10562 #. type: textblock
10563 #: dpkg-fsys-usrunmess.pod
10564 msgid "Prompt for confirmation before proceeding, if requested on the command-line."
10565 msgstr ""
10567 #. type: textblock
10568 #: dpkg-fsys-usrunmess.pod
10569 msgid "Lock the dpkg database."
10570 msgstr ""
10572 #. type: textblock
10573 #: dpkg-fsys-usrunmess.pod
10574 msgid ""
10575 "Mark all packages as half-configured to force running maintainer scripts "
10576 "that might need to recreate files."
10577 msgstr ""
10579 #. type: textblock
10580 #: dpkg-fsys-usrunmess.pod
10581 msgid ""
10582 "Replace the aliased directories with the shadow ones, by creating a backup "
10583 "of the old symlinked directories and renaming the shadow ones over."
10584 msgstr ""
10586 #. type: textblock
10587 #: dpkg-fsys-usrunmess.pod
10588 msgid "Relabel MAC information for directories and symlinks if necessary."
10589 msgstr ""
10591 #. type: textblock
10592 #: dpkg-fsys-usrunmess.pod
10593 msgid "Remove backup symlinks."
10594 msgstr ""
10596 #. type: textblock
10597 #: dpkg-fsys-usrunmess.pod
10598 msgid "Remove old moved objects, but defer directory removal."
10599 msgstr ""
10601 #. type: textblock
10602 #: dpkg-fsys-usrunmess.pod
10603 msgid "Remove old deferred directories that are not referenced by dpkg-query."
10604 msgstr ""
10606 #. type: textblock
10607 #: dpkg-fsys-usrunmess.pod
10608 msgid "Remove shadow root directory."
10609 msgstr ""
10611 #. type: textblock
10612 #: dpkg-fsys-usrunmess.pod
10613 msgid ""
10614 "Register a B<policy-rc.d> to disallow service actions, which means that "
10615 "services might need to be restarted afterwards, ideally via a reboot."
10616 msgstr ""
10618 #. type: textblock
10619 #: dpkg-fsys-usrunmess.pod
10620 msgid "Reconfigure all packages."
10621 msgstr ""
10623 #. type: textblock
10624 #: dpkg-fsys-usrunmess.pod
10625 msgid "Unregister the B<policy-rc.d> and restore the alternatives state."
10626 msgstr ""
10628 #. type: textblock
10629 #: dpkg-fsys-usrunmess.pod
10630 msgid ""
10631 "B<Note>: When running the program from some shells such as L<bash(1)> or "
10632 "L<zsh(1)>, after executing it, you might need to request the shell to forget "
10633 "all remembered executable locations with for example C<hash -r>."
10634 msgstr ""
10636 #. type: textblock
10637 #: dpkg-fsys-usrunmess.pod
10638 msgid ""
10639 "B<Note>: Some directories might linger after the migration in case they "
10640 "contain untracked files. A list is printed once the script has finished for "
10641 "further investigation."
10642 msgstr ""
10644 #. type: textblock
10645 #: dpkg-fsys-usrunmess.pod
10646 msgid ""
10647 "B<Warning>: Note that this operation has the potential to render the system "
10648 "unusable or broken in case of a sudden crash or reboot, unexpected state of "
10649 "the system, or possible bugs in the script. Be prepared with recovery media "
10650 "and consider doing backups beforehand."
10651 msgstr ""
10653 #. type: =item
10654 #: dpkg-fsys-usrunmess.pod
10655 msgid "B<-p>, B<--prompt>"
10656 msgstr ""
10658 #. type: textblock
10659 #: dpkg-fsys-usrunmess.pod
10660 msgid ""
10661 "Prompt at the time of no return, so that the debug output or the shadow "
10662 "hierarchy can be evaluated before proceeding."
10663 msgstr ""
10665 #. type: =item
10666 #: dpkg-fsys-usrunmess.pod
10667 msgid "B<--prevention>"
10668 msgstr ""
10670 #. type: =item
10671 #: dpkg-fsys-usrunmess.pod
10672 msgid "B<--no-prevention>"
10673 msgstr ""
10675 #. type: textblock
10676 #: dpkg-fsys-usrunmess.pod
10677 msgid ""
10678 "Enables or disables generating and installing a regression prevention "
10679 "package into the system.  If no option has been specified, the action to "
10680 "take will be prompted."
10681 msgstr ""
10683 #. type: textblock
10684 #: dpkg-fsys-usrunmess.pod
10685 msgid ""
10686 "The generated package contains the B<Protected> field set to B<yes> to "
10687 "protect against accidental removal of the package."
10688 msgstr ""
10690 #. type: =item
10691 #: dpkg-fsys-usrunmess.pod
10692 msgid "B<-n>, B<--no-act>"
10693 msgstr ""
10695 #. type: =item
10696 #: dpkg-fsys-usrunmess.pod
10697 msgid "B<--dry-run>"
10698 msgstr ""
10700 #. type: textblock
10701 #: dpkg-fsys-usrunmess.pod
10702 msgid ""
10703 "This option enables the dry-run mode, where no destructive action takes "
10704 "place, only the preparatory part."
10705 msgstr ""
10707 #. type: =item
10708 #: dpkg-fsys-usrunmess.pod
10709 msgid "B<DPKG_USRUNMESS_NOACT>"
10710 msgstr ""
10712 #. type: textblock
10713 #: dpkg-fsys-usrunmess.pod
10714 msgid "This setting defines whether to enable dry-run mode."
10715 msgstr ""
10717 #. type: textblock
10718 #: dpkg-fsys-usrunmess.pod
10719 msgid "L<https://wiki.debian.org/Teams/Dpkg/FAQ#broken-usrmerge>."
10720 msgstr ""
10722 #. type: textblock
10723 #: dpkg-genbuildinfo.pod
10724 msgid "dpkg-genbuildinfo - generate Debian .buildinfo files"
10725 msgstr ""
10727 #. type: textblock
10728 #: dpkg-genbuildinfo.pod
10729 msgid "B<dpkg-genbuildinfo> [I<option>...]"
10730 msgstr ""
10732 #. type: textblock
10733 #: dpkg-genbuildinfo.pod
10734 msgid ""
10735 "B<dpkg-genbuildinfo> reads information from an unpacked and built Debian "
10736 "source tree and from the files it has generated and generates a Debian "
10737 "control file describing the build environment and the build artifacts "
10738 "(B<.buildinfo> file)."
10739 msgstr ""
10741 #. type: textblock
10742 #: dpkg-genbuildinfo.pod
10743 msgid "This command was introduced in dpkg 1.18.11."
10744 msgstr ""
10746 #. type: textblock
10747 #: dpkg-genbuildinfo.pod
10748 msgid "Specifies the build I<type> from a comma-separated list of components."
10749 msgstr ""
10751 #. type: textblock
10752 #: dpkg-genbuildinfo.pod
10753 msgid ""
10754 "Generate build information including unqualified build dependencies "
10755 "(B<Build-Depends>) and architecture specific build dependencies "
10756 "(B<Build-Depends-Arch>)."
10757 msgstr ""
10759 #. type: textblock
10760 #: dpkg-genbuildinfo.pod
10761 msgid ""
10762 "Generate build information including unqualified build dependencies "
10763 "(B<Build-Depends>) and architecture independent build dependencies "
10764 "(B<Build-Depends-Indep>)."
10765 msgstr ""
10767 #. type: textblock
10768 #: dpkg-genbuildinfo.pod
10769 msgid ""
10770 "Effectively ignored; generate build information with just the unqualified "
10771 "build dependencies (B<Build-Depends>)."
10772 msgstr ""
10774 #. type: textblock
10775 #: dpkg-genbuildinfo.pod
10776 msgid ""
10777 "Generate build information with all three types of build dependencies.  This "
10778 "is an alias for B<any,all>."
10779 msgstr ""
10781 #. type: textblock
10782 #: dpkg-genbuildinfo.pod
10783 msgid ""
10784 "Generate build information with all three types of build dependencies.  This "
10785 "is an alias for B<any,all,source>, and the same as the default case when no "
10786 "build option is specified."
10787 msgstr ""
10789 #. type: =item
10790 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod
10791 msgid "B<-c>I<controlfile>"
10792 msgstr ""
10794 #. type: textblock
10795 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10796 msgid ""
10797 "Specifies the main source control file to read information from. The default "
10798 "is B<debian/control>."
10799 msgstr ""
10801 #. type: =item
10802 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10803 #: dpkg-source.pod
10804 msgid "B<-l>I<changelog-file>"
10805 msgstr ""
10807 #. type: textblock
10808 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10809 msgid ""
10810 "Specifies the changelog file to read information from. The default is "
10811 "B<debian/changelog>."
10812 msgstr ""
10814 #. type: textblock
10815 #: dpkg-genbuildinfo.pod
10816 msgid ""
10817 "Specifies where is the list of files that have been produced by the build, "
10818 "rather than using B<debian/files>."
10819 msgstr ""
10821 #. type: =item
10822 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10823 #: dpkg-source.pod
10824 msgid "B<-F>I<changelog-format>"
10825 msgstr ""
10827 #. type: textblock
10828 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10829 #: dpkg-source.pod
10830 msgid ""
10831 "Specifies the format of the changelog. See B<dpkg-parsechangelog>(1)  for "
10832 "information about alternative formats."
10833 msgstr ""
10835 #. type: =item
10836 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10837 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
10838 msgid "B<-O>[I<filename>]"
10839 msgstr ""
10841 #. type: textblock
10842 #: dpkg-genbuildinfo.pod
10843 msgid ""
10844 "Print the buildinfo file to standard output (or I<filename> if specified)  "
10845 "rather than to "
10846 "I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<.buildinfo> (where "
10847 "I<dir> is B<..> by default or I<upload-files-dir> if B<-u> was used)."
10848 msgstr ""
10850 #. type: =item
10851 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod
10852 msgid "B<-u>I<upload-files-dir>"
10853 msgstr ""
10855 #. type: textblock
10856 #: dpkg-genbuildinfo.pod
10857 msgid ""
10858 "Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
10859 "(B<dpkg-genbuildinfo> needs to find these files so that it can include their "
10860 "sizes and checksums in the B<.buildinfo> file)."
10861 msgstr ""
10863 #. type: =item
10864 #: dpkg-genbuildinfo.pod
10865 msgid "B<--always-include-kernel>"
10866 msgstr ""
10868 #. type: textblock
10869 #: dpkg-genbuildinfo.pod
10870 msgid "By default, the B<Build-Kernel-Version> field will not be written out."
10871 msgstr ""
10873 #. type: textblock
10874 #: dpkg-genbuildinfo.pod
10875 msgid ""
10876 "Specify this option (since dpkg 1.19.0) to always write a "
10877 "B<Build-Kernel-Version> field when generating the B<.buildinfo>."
10878 msgstr ""
10880 #. type: =item
10881 #: dpkg-genbuildinfo.pod
10882 msgid "B<--always-include-path>"
10883 msgstr ""
10885 #. type: textblock
10886 #: dpkg-genbuildinfo.pod
10887 msgid ""
10888 "By default, the B<Build-Path> field will only be written if the current "
10889 "directory starts with an allowed pattern."
10890 msgstr ""
10892 #. type: textblock
10893 #: dpkg-genbuildinfo.pod
10894 msgid ""
10895 "On Debian and derivatives the pattern matches on B</build/> at the start of "
10896 "the pathname."
10897 msgstr ""
10899 #. type: textblock
10900 #: dpkg-genbuildinfo.pod
10901 msgid ""
10902 "Specify this option to always write a B<Build-Path> field when generating "
10903 "the B<.buildinfo>."
10904 msgstr ""
10906 #. type: textblock
10907 #: dpkg-genbuildinfo.pod
10908 msgid ""
10909 "Change the location of the B<dpkg> database. The default location is "
10910 "I</var/lib/dpkg>."
10911 msgstr ""
10913 #. type: =item
10914 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gensymbols.pod
10915 #: dpkg-source.pod
10916 msgid "B<-q>"
10917 msgstr ""
10919 #. type: textblock
10920 #: dpkg-genbuildinfo.pod
10921 msgid ""
10922 "B<dpkg-genbuildinfo> might produce informative messages on standard error.  "
10923 "B<-q> suppresses these messages."
10924 msgstr ""
10926 #. type: textblock
10927 #: dpkg-genbuildinfo.pod
10928 msgid ""
10929 "This variable can be used to enable or disable various features that affect "
10930 "the information included in the .buildinfo file, via the B<buildinfo> option "
10931 "(since dpkg 1.18.19).  This option contains a comma-separated list of "
10932 "features, prefixed with the ‘B<+>’ or ‘B<->’ modifiers, to denote whether to "
10933 "enable or disable them.  The special feature “B<all>” can be used to enable "
10934 "or disable all other features.  The feature “B<path>” controls whether to "
10935 "unconditionally include the B<Build-Path> field."
10936 msgstr ""
10938 #. type: textblock
10939 #: dpkg-genbuildinfo.pod
10940 msgid ""
10941 "The list of generated files.  B<dpkg-genbuildinfo> reads the data here when "
10942 "producing a B<.buildinfo> file."
10943 msgstr ""
10945 #. type: textblock
10946 #: dpkg-genbuildinfo.pod
10947 msgid "B<deb-buildinfo>(5)."
10948 msgstr ""
10950 #. type: textblock
10951 #: dpkg-genchanges.pod
10952 msgid "dpkg-genchanges - generate Debian .changes files"
10953 msgstr ""
10955 #. type: textblock
10956 #: dpkg-genchanges.pod
10957 msgid "B<dpkg-genchanges> [I<option>...]"
10958 msgstr ""
10960 #. type: textblock
10961 #: dpkg-genchanges.pod
10962 msgid ""
10963 "B<dpkg-genchanges> reads information from an unpacked and built Debian "
10964 "source tree and from the files it has generated and generates a Debian "
10965 "upload control file (B<.changes> file)."
10966 msgstr ""
10968 #. type: textblock
10969 #: dpkg-genchanges.pod
10970 msgid ""
10971 "Specifies the build I<type> from a comma-separated list of components (since "
10972 "dpkg 1.18.5)."
10973 msgstr ""
10975 #. type: textblock
10976 #: dpkg-genchanges.pod
10977 msgid "Upload the source package."
10978 msgstr ""
10980 #. type: textblock
10981 #: dpkg-genchanges.pod
10982 msgid "Upload the architecture specific binary packages."
10983 msgstr ""
10985 #. type: textblock
10986 #: dpkg-genchanges.pod
10987 msgid "Upload the architecture independent binary packages."
10988 msgstr ""
10990 #. type: textblock
10991 #: dpkg-genchanges.pod
10992 msgid ""
10993 "Upload the architecture specific and independent binary packages.  This is "
10994 "an alias for B<any,all>."
10995 msgstr ""
10997 #. type: textblock
10998 #: dpkg-genchanges.pod
10999 msgid ""
11000 "Upload everything.  This is alias for B<source,any,all>, and the same as the "
11001 "default case when no build option is specified."
11002 msgstr ""
11004 #. type: textblock
11005 #: dpkg-genchanges.pod
11006 msgid ""
11007 "The B<-s>I<x> options control whether the original source archive is "
11008 "included in the upload if any source is being generated (i.e.  B<-b> or "
11009 "B<-B> haven't been used)."
11010 msgstr ""
11012 #. type: textblock
11013 #: dpkg-genchanges.pod
11014 msgid ""
11015 "By default, or if specified, the original source will be included only if "
11016 "the upstream version number (the version without epoch and without Debian "
11017 "revision) differs from the upstream version number of the previous changelog "
11018 "entry."
11019 msgstr ""
11021 #. type: textblock
11022 #: dpkg-genchanges.pod
11023 msgid "Forces the inclusion of the original source."
11024 msgstr ""
11026 #. type: textblock
11027 #: dpkg-genchanges.pod
11028 msgid "Forces the exclusion of the original source and includes only the diff."
11029 msgstr ""
11031 #. type: textblock
11032 #: dpkg-genchanges.pod
11033 msgid ""
11034 "Causes changelog information from all versions strictly later than "
11035 "I<version> to be used."
11036 msgstr ""
11038 #. type: textblock
11039 #: dpkg-genchanges.pod
11040 msgid ""
11041 "Read the description of the changes from the file I<changes-description> "
11042 "rather than using the information from the source tree's changelog file."
11043 msgstr ""
11045 #. type: textblock
11046 #: dpkg-genchanges.pod
11047 msgid ""
11048 "Use I<maintainer-address> as the name and email address of the maintainer "
11049 "for this package, rather than using the information from the source tree's "
11050 "control file."
11051 msgstr ""
11053 #. type: textblock
11054 #: dpkg-genchanges.pod
11055 msgid ""
11056 "Use I<maintainer-address> as the name and email address of the maintainer "
11057 "for this upload, rather than using the information from the source tree's "
11058 "changelog."
11059 msgstr ""
11061 #. type: =item
11062 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11063 msgid "B<-V>I<name>B<=>I<value>"
11064 msgstr ""
11066 #. type: textblock
11067 #: dpkg-genchanges.pod dpkg-source.pod
11068 msgid ""
11069 "Set an output substitution variable.  See B<deb-substvars>(5) for a "
11070 "discussion of output substitution."
11071 msgstr ""
11073 #. type: =item
11074 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-shlibdeps.pod dpkg-source.pod
11075 msgid "B<-T>I<substvars-file>"
11076 msgstr ""
11078 #. type: textblock
11079 #: dpkg-genchanges.pod
11080 msgid ""
11081 "Read substitution variables in I<substvars-file>; the default is "
11082 "B<debian/substvars>.  No variable substitution is done on any of the fields "
11083 "that are output, except for the contents extracted from each binary package "
11084 "B<Description> field (since dpkg 1.19.0), however the special variable "
11085 "I<Format> will override the field of the same name.  This option can be used "
11086 "multiple times to read substitution variables from multiple files (since "
11087 "dpkg 1.15.6)."
11088 msgstr ""
11090 #. type: =item
11091 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11092 msgid "B<-D>I<field>B<=>I<value>"
11093 msgstr ""
11095 #. type: textblock
11096 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11097 msgid "Override or add an output control file field."
11098 msgstr ""
11100 #. type: =item
11101 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11102 msgid "B<-U>I<field>"
11103 msgstr ""
11105 #. type: textblock
11106 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11107 msgid "Remove an output control file field."
11108 msgstr ""
11110 #. type: textblock
11111 #: dpkg-genchanges.pod
11112 msgid ""
11113 "Read the list of files to be uploaded here, rather than using "
11114 "B<debian/files>."
11115 msgstr ""
11117 #. type: textblock
11118 #: dpkg-genchanges.pod
11119 msgid ""
11120 "Look for the files to be uploaded in I<upload-files-dir> rather than B<..> "
11121 "(B<dpkg-genchanges> needs to find these files so that it can include their "
11122 "sizes and checksums in the B<.changes> file)."
11123 msgstr ""
11125 #. type: textblock
11126 #: dpkg-genchanges.pod
11127 msgid ""
11128 "Usually B<dpkg-genchanges> will produce informative messages on standard "
11129 "error, for example about how many of the package's source files are being "
11130 "uploaded.  B<-q> suppresses these messages."
11131 msgstr ""
11133 #. type: textblock
11134 #: dpkg-genchanges.pod
11135 msgid ""
11136 "Print the changes file to standard output (the default) or to I<filename> if "
11137 "specified (since dpkg 1.18.5)."
11138 msgstr ""
11140 #. type: textblock
11141 #: dpkg-genchanges.pod
11142 msgid ""
11143 "The list of generated files which are part of the upload being prepared.  "
11144 "B<dpkg-genchanges> reads the data here when producing a B<.changes> file."
11145 msgstr ""
11147 #. type: textblock
11148 #: dpkg-genchanges.pod
11149 msgid ""
11150 "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-src-files>(5), "
11151 "B<deb-changelog>(5), B<deb-changes>(5)."
11152 msgstr ""
11154 #. type: textblock
11155 #: dpkg-gencontrol.pod
11156 msgid "dpkg-gencontrol - generate Debian control files"
11157 msgstr ""
11159 #. type: textblock
11160 #: dpkg-gencontrol.pod
11161 msgid "B<dpkg-gencontrol> [I<option>...]"
11162 msgstr ""
11164 #. type: textblock
11165 #: dpkg-gencontrol.pod
11166 msgid ""
11167 "B<dpkg-gencontrol> reads information from an unpacked Debian source tree and "
11168 "generates a binary package control file (which defaults to "
11169 "debian/tmp/DEBIAN/control); during this process it will simplify the "
11170 "relation fields."
11171 msgstr ""
11173 #. type: textblock
11174 #: dpkg-gencontrol.pod
11175 msgid ""
11176 "Thus B<Pre-Depends>, B<Depends>, B<Recommends> and B<Suggests> are "
11177 "simplified in this order by removing dependencies which are known to be true "
11178 "according to the stronger dependencies already parsed. It will also remove "
11179 "any self-dependency (in fact it will remove any dependency which evaluates "
11180 "to true given the current version of the package as installed). Logically it "
11181 "keeps the intersection of multiple dependencies on the same package. The "
11182 "order of dependencies is preserved as best as possible: if any dependency "
11183 "must be discarded due to another dependency appearing further in the field, "
11184 "the superseding dependency will take the place of the discarded one."
11185 msgstr ""
11187 #. type: textblock
11188 #: dpkg-gencontrol.pod
11189 msgid ""
11190 "The other relation fields (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> "
11191 "and B<Provides>)  are also simplified individually by computing the union of "
11192 "the various dependencies when a package is listed multiple times in the "
11193 "field."
11194 msgstr ""
11196 #. type: textblock
11197 #: dpkg-gencontrol.pod
11198 msgid ""
11199 "B<dpkg-gencontrol> also adds an entry for the binary package to "
11200 "B<debian/files>."
11201 msgstr ""
11203 #. type: textblock
11204 #: dpkg-gencontrol.pod
11205 msgid "Sets the version number of the binary package which will be generated."
11206 msgstr ""
11208 #. type: textblock
11209 #: dpkg-gencontrol.pod
11210 msgid ""
11211 "Set an output substitution variable. See B<deb-substvars>(5) for discussion "
11212 "of output substitution."
11213 msgstr ""
11215 #. type: textblock
11216 #: dpkg-gencontrol.pod
11217 msgid ""
11218 "Read substitution variables in I<substvars-file>; the default is "
11219 "B<debian/substvars>.  This option can be used multiple times to read "
11220 "substitution variables from multiple files (since dpkg 1.15.6)."
11221 msgstr ""
11223 #. type: =item
11224 #: dpkg-gencontrol.pod dpkg-source.pod
11225 msgid "B<-c>I<control-file>"
11226 msgstr ""
11228 #. type: =item
11229 #: dpkg-gencontrol.pod dpkg-gensymbols.pod
11230 msgid "B<-p>I<package>"
11231 msgstr ""
11233 #. type: textblock
11234 #: dpkg-gencontrol.pod
11235 msgid ""
11236 "Generate information for the binary package I<package>.  If the source "
11237 "control file lists only one binary package then this option may be omitted; "
11238 "otherwise it is essential to select which binary package's information to "
11239 "generate."
11240 msgstr ""
11242 #. type: =item
11243 #: dpkg-gencontrol.pod
11244 msgid "B<-n>I<filename>"
11245 msgstr ""
11247 #. type: textblock
11248 #: dpkg-gencontrol.pod
11249 msgid ""
11250 "Assume the filename of the package will be I<filename> instead of the normal "
11251 "package_version_arch.deb filename."
11252 msgstr ""
11254 #. type: =item
11255 #: dpkg-gencontrol.pod
11256 msgid "B<-is>, B<-ip>, B<-isp>"
11257 msgstr ""
11259 #. type: textblock
11260 #: dpkg-gencontrol.pod
11261 msgid ""
11262 "These options are ignored for compatibility with older versions of the dpkg "
11263 "build scripts but are now deprecated. Previously they were used to tell "
11264 "B<dpkg-gencontrol> to include the Section and Priority fields in the control "
11265 "file. This is now the default behaviour. If you want to get the old "
11266 "behaviour you can use the B<-U> option to delete the fields from the control "
11267 "file."
11268 msgstr ""
11270 #. type: =item
11271 #: dpkg-gencontrol.pod dpkg-gensymbols.pod
11272 msgid "B<-P>I<package-build-dir>"
11273 msgstr ""
11275 #. type: textblock
11276 #: dpkg-gencontrol.pod
11277 msgid ""
11278 "Scan I<package-build-dir> instead of B<debian/tmp>.  This value is used to "
11279 "find the default value of the B<Installed-Size> substitution variable and "
11280 "control file field, and for the default location of the output file."
11281 msgstr ""
11283 #. type: textblock
11284 #: dpkg-gencontrol.pod
11285 msgid ""
11286 "Print the control file to standard output (or I<filename> if specified, "
11287 "since dpkg 1.17.2), rather than to B<debian/tmp/DEBIAN/control> (or "
11288 "I<package-build-dir>B</DEBIAN/control> if B<-P> was used)."
11289 msgstr ""
11291 #. type: textblock
11292 #: dpkg-gencontrol.pod
11293 msgid ""
11294 "The main source control information file, giving version-independent "
11295 "information about the source package and the binary packages it can produce."
11296 msgstr ""
11298 #. type: textblock
11299 #: dpkg-gencontrol.pod
11300 msgid ""
11301 "The list of generated files which are part of the upload being prepared.  "
11302 "B<dpkg-gencontrol> adds the presumed filenames of binary packages whose "
11303 "control files it generates here."
11304 msgstr ""
11306 #. type: textblock
11307 #: dpkg-gencontrol.pod
11308 msgid ""
11309 "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-changelog>(5), "
11310 "B<deb-control>(5)."
11311 msgstr ""
11313 #. type: textblock
11314 #: dpkg-gensymbols.pod
11315 msgid ""
11316 "dpkg-gensymbols - generate symbols files (shared library dependency "
11317 "information)"
11318 msgstr ""
11320 #. type: textblock
11321 #: dpkg-gensymbols.pod
11322 msgid "B<dpkg-gensymbols> [I<option>...]"
11323 msgstr ""
11325 #. type: textblock
11326 #: dpkg-gensymbols.pod
11327 msgid ""
11328 "B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) "
11329 "looking for libraries and generates a I<symbols> file describing them. This "
11330 "file, if non-empty, is then installed in the DEBIAN subdirectory of the "
11331 "build tree so that it ends up included in the control information of the "
11332 "package."
11333 msgstr ""
11335 #. type: textblock
11336 #: dpkg-gensymbols.pod
11337 msgid ""
11338 "When generating those files, it uses as input some symbols files provided by "
11339 "the maintainer. It looks for the following files (and uses the first that is "
11340 "found):"
11341 msgstr ""
11343 #. type: textblock
11344 #: dpkg-gensymbols.pod
11345 msgid "debian/I<package>.symbols.I<arch>"
11346 msgstr ""
11348 #. type: textblock
11349 #: dpkg-gensymbols.pod
11350 msgid "debian/symbols.I<arch>"
11351 msgstr ""
11353 #. type: textblock
11354 #: dpkg-gensymbols.pod
11355 msgid "debian/I<package>.symbols"
11356 msgstr ""
11358 #. type: textblock
11359 #: dpkg-gensymbols.pod
11360 msgid "debian/symbols"
11361 msgstr ""
11363 #. type: textblock
11364 #: dpkg-gensymbols.pod
11365 msgid ""
11366 "The main interest of those files is to provide the minimal version "
11367 "associated to each symbol provided by the libraries. Usually it corresponds "
11368 "to the first version of that package that provided the symbol, but it can be "
11369 "manually incremented by the maintainer if the ABI of the symbol is extended "
11370 "without breaking backwards compatibility. It's the responsibility of the "
11371 "maintainer to keep those files up-to-date and accurate, but "
11372 "B<dpkg-gensymbols> helps with that."
11373 msgstr ""
11375 #. type: textblock
11376 #: dpkg-gensymbols.pod
11377 msgid ""
11378 "When the generated symbols files differ from the maintainer supplied one, "
11379 "B<dpkg-gensymbols> will print a diff between the two versions.  Furthermore "
11380 "if the difference is too significant, it will even fail (you can customize "
11381 "how much difference you can tolerate, see the B<-c> option)."
11382 msgstr ""
11384 #. type: =head1
11385 #: dpkg-gensymbols.pod
11386 msgid "MAINTAINING SYMBOLS FILES"
11387 msgstr ""
11389 #. type: textblock
11390 #: dpkg-gensymbols.pod
11391 msgid ""
11392 "The base interchange format of the symbols file is described in "
11393 "B<deb-symbols>(5), which is used by the symbols files included in binary "
11394 "packages. These are generated from template symbols files with a format "
11395 "based on the former, described in B<deb-src-symbols>(5)  and included in "
11396 "source packages."
11397 msgstr ""
11399 #. type: textblock
11400 #: dpkg-gensymbols.pod
11401 msgid ""
11402 "The symbols files are really useful only if they reflect the evolution of "
11403 "the package through several releases. Thus the maintainer has to update them "
11404 "every time that a new symbol is added so that its associated minimal version "
11405 "matches reality."
11406 msgstr ""
11408 #. type: textblock
11409 #: dpkg-gensymbols.pod
11410 msgid ""
11411 "The diffs contained in the build logs can be used as a starting point, but "
11412 "the maintainer, additionally, has to make sure that the behaviour of those "
11413 "symbols has not changed in a way that would make anything using those "
11414 "symbols and linking against the new version, stop working with the old "
11415 "version."
11416 msgstr ""
11418 #. type: textblock
11419 #: dpkg-gensymbols.pod
11420 msgid ""
11421 "In most cases, the diff applies directly to the debian/I<package>.symbols "
11422 "file. That said, further tweaks are usually needed: it's recommended for "
11423 "example to drop the Debian revision from the minimal version so that "
11424 "backports with a lower version number but the same upstream version still "
11425 "satisfy the generated dependencies.  If the Debian revision can't be dropped "
11426 "because the symbol really got added by the Debian specific change, then one "
11427 "should suffix the version with ‘B<~>’."
11428 msgstr ""
11430 #. type: textblock
11431 #: dpkg-gensymbols.pod
11432 msgid ""
11433 "Before applying any patch to the symbols file, the maintainer should "
11434 "double-check that it's sane. Public symbols are not supposed to disappear, "
11435 "so the patch should ideally only add new lines."
11436 msgstr ""
11438 #. type: textblock
11439 #: dpkg-gensymbols.pod
11440 msgid "Note that you can put comments in symbols files."
11441 msgstr ""
11443 #. type: textblock
11444 #: dpkg-gensymbols.pod
11445 msgid ""
11446 "Do not forget to check if old symbol versions need to be increased.  There "
11447 "is no way B<dpkg-gensymbols> can warn about this. Blindly applying the diff "
11448 "or assuming there is nothing to change if there is no diff, without checking "
11449 "for such changes, can lead to packages with loose dependencies that claim "
11450 "they can work with older packages they cannot work with. This will introduce "
11451 "hard to find bugs with (partial)  upgrades."
11452 msgstr ""
11454 #. type: =head2
11455 #: dpkg-gensymbols.pod
11456 msgid "Good library management"
11457 msgstr ""
11459 #. type: textblock
11460 #: dpkg-gensymbols.pod
11461 msgid "A well-maintained library has the following features:"
11462 msgstr ""
11464 #. type: textblock
11465 #: dpkg-gensymbols.pod
11466 msgid ""
11467 "its API is stable (public symbols are never dropped, only new public symbols "
11468 "are added) and changes in incompatible ways only when the SONAME changes;"
11469 msgstr ""
11471 #. type: textblock
11472 #: dpkg-gensymbols.pod
11473 msgid ""
11474 "ideally, it uses symbol versioning to achieve ABI stability despite internal "
11475 "changes and API extension;"
11476 msgstr ""
11478 #. type: textblock
11479 #: dpkg-gensymbols.pod
11480 msgid ""
11481 "it doesn't export private symbols (such symbols can be tagged optional as "
11482 "workaround)."
11483 msgstr ""
11485 #. type: textblock
11486 #: dpkg-gensymbols.pod
11487 msgid ""
11488 "While maintaining the symbols file, it's easy to notice appearance and "
11489 "disappearance of symbols. But it's more difficult to catch incompatible API "
11490 "and ABI change. Thus the maintainer should read thoroughly the upstream "
11491 "changelog looking for cases where the rules of good library management have "
11492 "been broken. If potential problems are discovered, the upstream author "
11493 "should be notified as an upstream fix is always better than a Debian "
11494 "specific work-around."
11495 msgstr ""
11497 #. type: textblock
11498 #: dpkg-gensymbols.pod
11499 msgid "Scan I<package-build-dir> instead of debian/tmp."
11500 msgstr ""
11502 #. type: textblock
11503 #: dpkg-gensymbols.pod
11504 msgid ""
11505 "Define the package name. Required if more than one binary package is listed "
11506 "in debian/control (or if there's no debian/control file)."
11507 msgstr ""
11509 #. type: textblock
11510 #: dpkg-gensymbols.pod
11511 msgid ""
11512 "Define the package version. Defaults to the version extracted from "
11513 "debian/changelog. Required if called outside of a source package tree."
11514 msgstr ""
11516 #. type: =item
11517 #: dpkg-gensymbols.pod
11518 msgid "B<-e>I<library-file>"
11519 msgstr ""
11521 #. type: textblock
11522 #: dpkg-gensymbols.pod
11523 msgid ""
11524 "Only analyze libraries explicitly listed instead of finding all public "
11525 "libraries. You can use shell patterns used for pathname expansions (see the "
11526 "B<File::Glob>(3perl) manual page for details) in I<library-file> to match "
11527 "multiple libraries with a single argument (otherwise you need multiple "
11528 "B<-e>)."
11529 msgstr ""
11531 #. type: =item
11532 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
11533 msgid "B<-l>I<directory>"
11534 msgstr ""
11536 #. type: textblock
11537 #: dpkg-gensymbols.pod
11538 msgid ""
11539 "Prepend I<directory> to the list of directories to search for private shared "
11540 "libraries (since dpkg 1.19.1). This option can be used multiple times."
11541 msgstr ""
11543 #. type: textblock
11544 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
11545 msgid ""
11546 "B<Note:> Use this option instead of setting B<LD_LIBRARY_PATH>, as that "
11547 "environment variable is used to control the run-time linker and abusing it "
11548 "to set the shared library paths at build-time can be problematic when "
11549 "cross-compiling for example."
11550 msgstr ""
11552 #. type: =item
11553 #: dpkg-gensymbols.pod
11554 msgid "B<-I>I<filename>"
11555 msgstr ""
11557 #. type: textblock
11558 #: dpkg-gensymbols.pod
11559 msgid ""
11560 "Use I<filename> as reference file to generate the symbols file that is "
11561 "integrated in the package itself."
11562 msgstr ""
11564 #. type: textblock
11565 #: dpkg-gensymbols.pod
11566 msgid ""
11567 "Print the generated symbols file to standard output or to I<filename> if "
11568 "specified, rather than to B<debian/tmp/DEBIAN/symbols> (or "
11569 "I<package-build-dir>B</DEBIAN/symbols> if B<-P> was used). If I<filename> is "
11570 "pre-existing, its contents are used as basis for the generated symbols "
11571 "file.  You can use this feature to update a symbols file so that it matches "
11572 "a newer upstream version of your library."
11573 msgstr ""
11575 #. type: =item
11576 #: dpkg-gensymbols.pod
11577 msgid "B<-t>"
11578 msgstr ""
11580 #. type: textblock
11581 #: dpkg-gensymbols.pod
11582 msgid ""
11583 "Write the symbol file in template mode rather than the format compatible "
11584 "with B<deb-symbols>(5). The main difference is that in the template mode "
11585 "symbol names and tags are written in their original form contrary to the "
11586 "post-processed symbol names with tags stripped in the compatibility mode.  "
11587 "Moreover, some symbols might be omitted when writing a standard "
11588 "B<deb-symbols>(5) file (according to the tag processing rules) while all "
11589 "symbols are always written to the symbol file template."
11590 msgstr ""
11592 #. type: =item
11593 #: dpkg-gensymbols.pod
11594 msgid "B<-c>I<[0-4]>"
11595 msgstr ""
11597 #. type: textblock
11598 #: dpkg-gensymbols.pod
11599 msgid ""
11600 "Define the checks to do when comparing the generated symbols file with the "
11601 "template file used as starting point. By default the level is 1. Increasing "
11602 "levels do more checks and include all checks of lower levels."
11603 msgstr ""
11605 #. type: =item
11606 #: dpkg-gensymbols.pod
11607 msgid "Level 0"
11608 msgstr ""
11610 #. type: textblock
11611 #: dpkg-gensymbols.pod
11612 msgid "Never fails."
11613 msgstr ""
11615 #. type: =item
11616 #: dpkg-gensymbols.pod
11617 msgid "Level 1"
11618 msgstr ""
11620 #. type: textblock
11621 #: dpkg-gensymbols.pod
11622 msgid "Fails if some symbols have disappeared."
11623 msgstr ""
11625 #. type: =item
11626 #: dpkg-gensymbols.pod
11627 msgid "Level 2"
11628 msgstr ""
11630 #. type: textblock
11631 #: dpkg-gensymbols.pod
11632 msgid "Fails if some new symbols have been introduced."
11633 msgstr ""
11635 #. type: =item
11636 #: dpkg-gensymbols.pod
11637 msgid "Level 3"
11638 msgstr ""
11640 #. type: textblock
11641 #: dpkg-gensymbols.pod
11642 msgid "Fails if some libraries have disappeared."
11643 msgstr ""
11645 #. type: =item
11646 #: dpkg-gensymbols.pod
11647 msgid "Level 4"
11648 msgstr ""
11650 #. type: textblock
11651 #: dpkg-gensymbols.pod
11652 msgid "Fails if some libraries have been introduced."
11653 msgstr ""
11655 #. type: textblock
11656 #: dpkg-gensymbols.pod
11657 msgid ""
11658 "This value can be overridden by the environment variable "
11659 "B<DPKG_GENSYMBOLS_CHECK_LEVEL>."
11660 msgstr ""
11662 #. type: textblock
11663 #: dpkg-gensymbols.pod
11664 msgid ""
11665 "Keep quiet and never generate a diff between generated symbols file and the "
11666 "template file used as starting point or show any warnings about new/lost "
11667 "libraries or new/lost symbols. This option only disables informational "
11668 "output but not the checks themselves (see B<-c> option)."
11669 msgstr ""
11671 #. type: =item
11672 #: dpkg-gensymbols.pod
11673 msgid "B<-a>I<arch>"
11674 msgstr ""
11676 #. type: textblock
11677 #: dpkg-gensymbols.pod
11678 msgid ""
11679 "Assume I<arch> as host architecture when processing symbol files. Use this "
11680 "option to generate a symbol file or diff for any architecture provided its "
11681 "binaries are already available."
11682 msgstr ""
11684 #. type: =item
11685 #: dpkg-gensymbols.pod
11686 msgid "B<-d>"
11687 msgstr ""
11689 #. type: textblock
11690 #: dpkg-gensymbols.pod
11691 msgid ""
11692 "Enable debug mode. Numerous messages are displayed to explain what "
11693 "B<dpkg-gensymbols> does."
11694 msgstr ""
11696 #. type: =item
11697 #: dpkg-gensymbols.pod
11698 msgid "B<-V>"
11699 msgstr ""
11701 #. type: textblock
11702 #: dpkg-gensymbols.pod
11703 msgid ""
11704 "Enable verbose mode. The generated symbols file contains deprecated symbols "
11705 "as comments. Furthermore in template mode, pattern symbols are followed by "
11706 "comments listing real symbols that have matched the pattern."
11707 msgstr ""
11709 #. type: =item
11710 #: dpkg-gensymbols.pod
11711 msgid "B<DPKG_GENSYMBOLS_CHECK_LEVEL>"
11712 msgstr ""
11714 #. type: textblock
11715 #: dpkg-gensymbols.pod
11716 msgid ""
11717 "Overrides the command check level, even if the B<-c> command-line argument "
11718 "was given (note that this goes against the common convention of command-line "
11719 "arguments having precedence over environment variables)."
11720 msgstr ""
11722 #. type: textblock
11723 #: dpkg-gensymbols.pod
11724 msgid ""
11725 "L<https://people.redhat.com/drepper/symbol-versioning>, "
11726 "L<https://people.redhat.com/drepper/goodpractice.pdf>, "
11727 "L<https://people.redhat.com/drepper/dsohowto.pdf>, B<deb-src-symbol>(5), "
11728 "B<deb-symbols>(5), B<dpkg-shlibdeps>(1)."
11729 msgstr ""
11731 #. type: textblock
11732 #: dpkg-maintscript-helper.pod
11733 msgid ""
11734 "dpkg-maintscript-helper - works around known dpkg limitations in maintainer "
11735 "scripts"
11736 msgstr ""
11738 #. type: textblock
11739 #: dpkg-maintscript-helper.pod
11740 msgid ""
11741 "B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> "
11742 "I<maint-script-parameter>..."
11743 msgstr ""
11745 #. type: =head1
11746 #: dpkg-maintscript-helper.pod
11747 msgid "COMMANDS AND PARAMETERS"
11748 msgstr ""
11750 #. type: =item
11751 #: dpkg-maintscript-helper.pod
11752 msgid "B<supports> I<command>"
11753 msgstr ""
11755 #. type: =item
11756 #: dpkg-maintscript-helper.pod
11757 msgid "B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]"
11758 msgstr ""
11760 #. type: =item
11761 #: dpkg-maintscript-helper.pod
11762 msgid ""
11763 "B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> "
11764 "[I<package>]]"
11765 msgstr ""
11767 #. type: =item
11768 #: dpkg-maintscript-helper.pod
11769 msgid "B<symlink_to_dir> I<pathname> I<old-target> [I<prior-version> [I<package>]]"
11770 msgstr ""
11772 #. type: =item
11773 #: dpkg-maintscript-helper.pod
11774 msgid "B<dir_to_symlink> I<pathname> I<new-target> [I<prior-version> [I<package>]]"
11775 msgstr ""
11777 #. type: textblock
11778 #: dpkg-maintscript-helper.pod
11779 msgid ""
11780 "This program is designed to be run within maintainer scripts to achieve some "
11781 "tasks that B<dpkg> can't (yet) handle natively either because of design "
11782 "decisions or due to current limitations."
11783 msgstr ""
11785 #. type: textblock
11786 #: dpkg-maintscript-helper.pod
11787 msgid ""
11788 "Many of those tasks require coordinated actions from several maintainer "
11789 "scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes "
11790 "the same call simply needs to be put in all scripts and the program will "
11791 "automatically adapt its behaviour based on the environment variable "
11792 "B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you "
11793 "have to forward after a double hyphen."
11794 msgstr ""
11796 #. type: =head1
11797 #: dpkg-maintscript-helper.pod
11798 msgid "COMMON PARAMETERS"
11799 msgstr ""
11801 #. type: =item
11802 #: dpkg-maintscript-helper.pod
11803 msgid "I<prior-version>"
11804 msgstr ""
11806 #. type: textblock
11807 #: dpkg-maintscript-helper.pod
11808 msgid ""
11809 "Defines the latest version of the package whose upgrade should trigger the "
11810 "operation. It is important to calculate I<prior-version> correctly so that "
11811 "the operations are correctly performed even if the user rebuilt the package "
11812 "with a local version. If I<prior-version> is empty or omitted, then the "
11813 "operation is tried on every upgrade (note: it's safer to give the version "
11814 "and have the operation tried only once)."
11815 msgstr ""
11817 #. type: textblock
11818 #: dpkg-maintscript-helper.pod
11819 msgid ""
11820 "If the conffile has not been shipped for several versions, and you are now "
11821 "modifying the maintainer scripts to clean up the obsolete file, "
11822 "I<prior-version> should be based on the version of the package that you are "
11823 "now preparing, not the first version of the package that lacked the "
11824 "conffile. This applies to all other actions in the same way."
11825 msgstr ""
11827 #. type: textblock
11828 #: dpkg-maintscript-helper.pod
11829 msgid ""
11830 "For example, for a conffile removed in version B<2.0-1> of a package, "
11831 "I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to "
11832 "be removed even if the user rebuilt the previous version B<1.0-1> as "
11833 "B<1.0-1local1>. Or a package switching a path from a symlink (shipped in "
11834 "version B<1.0-1>) to a directory (shipped in version B<2.0-1>), but only "
11835 "performing the actual switch in the maintainer scripts in version B<3.0-1>, "
11836 "should set I<prior-version> to B<3.0-1~>."
11837 msgstr ""
11839 #. type: =item
11840 #: dpkg-maintscript-helper.pod
11841 msgid "I<package>"
11842 msgstr ""
11844 #. type: textblock
11845 #: dpkg-maintscript-helper.pod
11846 msgid ""
11847 "The package name owning the pathname(s).  When the package is “Multi-Arch: "
11848 "same” this parameter must include the architecture qualifier, otherwise it "
11849 "should B<not> usually include the architecture qualifier (as it would "
11850 "disallow cross-grades, or switching from being architecture specific to "
11851 "architecture B<all> or vice versa).  If the parameter is empty or omitted, "
11852 "the B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment "
11853 "variables (as set by B<dpkg> when running the maintainer scripts) will be "
11854 "used to generate an arch-qualified package name."
11855 msgstr ""
11857 #. type: =item
11858 #: dpkg-maintscript-helper.pod
11859 msgid "B<-->"
11860 msgstr ""
11862 #. type: textblock
11863 #: dpkg-maintscript-helper.pod
11864 msgid ""
11865 "All the parameters of the maintainer scripts have to be forwarded to the "
11866 "program after B<-->."
11867 msgstr ""
11869 #. type: =head1
11870 #: dpkg-maintscript-helper.pod
11871 msgid "CONFFILE RELATED TASKS"
11872 msgstr ""
11874 #. type: textblock
11875 #: dpkg-maintscript-helper.pod
11876 msgid ""
11877 "When upgrading a package, B<dpkg> will not automatically remove a conffile "
11878 "(a configuration file for which B<dpkg> should preserve user changes) if it "
11879 "is not present in the newer version. There are two principal reasons for "
11880 "this; the first is that the conffile could've been dropped by accident and "
11881 "the next version could restore it, users wouldn't want their changes thrown "
11882 "away. The second is to allow packages to transition files from a "
11883 "dpkg-maintained conffile to a file maintained by the package's maintainer "
11884 "scripts, usually with a tool like debconf or ucf."
11885 msgstr ""
11887 #. type: textblock
11888 #: dpkg-maintscript-helper.pod
11889 msgid ""
11890 "This means that if a package is intended to rename or remove a conffile, it "
11891 "must explicitly do so and B<dpkg-maintscript-helper> can be used to "
11892 "implement graceful deletion and moving of conffiles within maintainer "
11893 "scripts."
11894 msgstr ""
11896 #. type: =head2
11897 #: dpkg-maintscript-helper.pod
11898 msgid "Removing a conffile"
11899 msgstr ""
11901 #. type: textblock
11902 #: dpkg-maintscript-helper.pod
11903 msgid ""
11904 "Note: This can be replaced in most cases by the C<remove-on-upgrade> flag in "
11905 "F<DEBIAN/conffiles> (since dpkg 1.20.6), see L<deb-conffiles(5)>."
11906 msgstr ""
11908 #. type: textblock
11909 #: dpkg-maintscript-helper.pod
11910 msgid ""
11911 "If a conffile is completely removed, it should be removed from disk, unless "
11912 "the user has modified it. If there are local modifications, they should be "
11913 "preserved. If the package upgrades aborts, the newly obsolete conffile "
11914 "should not disappear."
11915 msgstr ""
11917 #. type: textblock
11918 #: dpkg-maintscript-helper.pod
11919 msgid ""
11920 "All of this is implemented by putting the following shell snippet in the "
11921 "B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
11922 msgstr ""
11924 #. type: verbatim
11925 #: dpkg-maintscript-helper.pod
11926 #, no-wrap
11927 msgid ""
11928 "Z<>\n"
11929 " dpkg-maintscript-helper rm_conffile \\\n"
11930 "    I<conffile> I<prior-version> I<package> -- \"$@\"\n"
11931 "\n"
11932 msgstr ""
11934 #. type: textblock
11935 #: dpkg-maintscript-helper.pod
11936 msgid "I<conffile> is the filename of the conffile to remove."
11937 msgstr ""
11939 #. type: textblock
11940 #: dpkg-maintscript-helper.pod
11941 msgid ""
11942 "Current implementation: in the B<preinst>, it checks if the conffile was "
11943 "modified and renames it either to I<conffile>B<.dpkg-remove> (if not "
11944 "modified) or to I<conffile>B<.dpkg-backup> (if modified). In the "
11945 "B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept "
11946 "for reference as it contains user modifications but the former will be "
11947 "removed. If the package upgrade aborts, the B<postrm> reinstalls the "
11948 "original conffile. During purge, the B<postrm> will also delete the "
11949 "B<.dpkg-bak> file kept up to now."
11950 msgstr ""
11952 #. type: =head2
11953 #: dpkg-maintscript-helper.pod
11954 msgid "Renaming a conffile"
11955 msgstr ""
11957 #. type: textblock
11958 #: dpkg-maintscript-helper.pod
11959 msgid ""
11960 "If a conffile is moved from one location to another, you need to make sure "
11961 "you move across any changes the user has made. This may seem a simple change "
11962 "to the B<preinst> script at first, however that will result in the user "
11963 "being prompted by B<dpkg> to approve the conffile edits even though they are "
11964 "not responsible of them."
11965 msgstr ""
11967 #. type: textblock
11968 #: dpkg-maintscript-helper.pod
11969 msgid ""
11970 "Graceful renaming can be implemented by putting the following shell snippet "
11971 "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
11972 msgstr ""
11974 #. type: verbatim
11975 #: dpkg-maintscript-helper.pod
11976 #, no-wrap
11977 msgid ""
11978 "Z<>\n"
11979 " dpkg-maintscript-helper mv_conffile \\\n"
11980 "    I<old-conffile> I<new-conffile> I<prior-version> I<package> -- \"$@\"\n"
11981 "\n"
11982 msgstr ""
11984 #. type: textblock
11985 #: dpkg-maintscript-helper.pod
11986 msgid ""
11987 "I<old-conffile> and I<new-conffile> are the old and new name of the conffile "
11988 "to rename."
11989 msgstr ""
11991 #. type: textblock
11992 #: dpkg-maintscript-helper.pod
11993 msgid ""
11994 "Current implementation: the B<preinst> checks if the conffile has been "
11995 "modified, if yes it's left on place otherwise it's renamed to "
11996 "I<old-conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes "
11997 "I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to "
11998 "I<new-conffile> if I<old-conffile> is still available. On "
11999 "abort-upgrade/abort-install, the B<postrm> renames "
12000 "I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required."
12001 msgstr ""
12003 #. type: =head1
12004 #: dpkg-maintscript-helper.pod
12005 msgid "SYMLINK AND DIRECTORY SWITCHES"
12006 msgstr ""
12008 #. type: textblock
12009 #: dpkg-maintscript-helper.pod
12010 msgid ""
12011 "When upgrading a package, B<dpkg> will not automatically switch a symlink to "
12012 "a directory or vice-versa. Downgrades are not supported and the path will be "
12013 "left as is."
12014 msgstr ""
12016 #. type: textblock
12017 #: dpkg-maintscript-helper.pod
12018 msgid ""
12019 "Note: The symlinks and directories created during these switches need to be "
12020 "shipped in the new packages, or B<dpkg> will not be able to remove them on "
12021 "purge."
12022 msgstr ""
12024 #. type: =head2
12025 #: dpkg-maintscript-helper.pod
12026 msgid "Switching a symlink to directory"
12027 msgstr ""
12029 #. type: textblock
12030 #: dpkg-maintscript-helper.pod
12031 msgid ""
12032 "If a symlink is switched to a real directory, you need to make sure before "
12033 "unpacking that the symlink is removed. This may seem a simple change to the "
12034 "B<preinst> script at first, however that will result in some problems in "
12035 "case of admin local customization of the symlink or when downgrading the "
12036 "package."
12037 msgstr ""
12039 #. type: verbatim
12040 #: dpkg-maintscript-helper.pod
12041 #, no-wrap
12042 msgid ""
12043 "Z<>\n"
12044 " dpkg-maintscript-helper symlink_to_dir \\\n"
12045 "    I<pathname> I<old-target> I<prior-version> I<package> -- \"$@\"\n"
12046 "\n"
12047 msgstr ""
12049 #. type: textblock
12050 #: dpkg-maintscript-helper.pod
12051 msgid ""
12052 "I<pathname> is the absolute name of the old symlink (the path will be a "
12053 "directory at the end of the installation) and I<old-target> is the target "
12054 "name of the former symlink at I<pathname>. It can either be absolute or "
12055 "relative to the directory containing I<pathname>."
12056 msgstr ""
12058 #. type: textblock
12059 #: dpkg-maintscript-helper.pod
12060 msgid ""
12061 "Current implementation: the B<preinst> checks if the symlink exists and "
12062 "points to I<old-target>, if not then it's left in place, otherwise it's "
12063 "renamed to I<pathname>B<.dpkg-backup>. On configuration, the B<postinst> "
12064 "removes I<pathname>B<.dpkg-backup> if I<pathname>B<.dpkg-backup> is still a "
12065 "symlink. On abort-upgrade/abort-install, the B<postrm> renames "
12066 "I<pathname>B<.dpkg-backup> back to I<pathname> if required."
12067 msgstr ""
12069 #. type: =head2
12070 #: dpkg-maintscript-helper.pod
12071 msgid "Switching a directory to symlink"
12072 msgstr ""
12074 #. type: textblock
12075 #: dpkg-maintscript-helper.pod
12076 msgid ""
12077 "If a real directory is switched to a symlink, you need to make sure before "
12078 "unpacking that the directory is removed. This may seem a simple change to "
12079 "the B<preinst> script at first, however that will result in some problems in "
12080 "case the directory contains conffiles, pathnames owned by other packages, "
12081 "locally created pathnames, or when downgrading the package."
12082 msgstr ""
12084 #. type: textblock
12085 #: dpkg-maintscript-helper.pod
12086 msgid ""
12087 "Graceful switching can be implemented by putting the following shell snippet "
12088 "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
12089 msgstr ""
12091 #. type: verbatim
12092 #: dpkg-maintscript-helper.pod
12093 #, no-wrap
12094 msgid ""
12095 "Z<>\n"
12096 " dpkg-maintscript-helper dir_to_symlink \\\n"
12097 "    I<pathname> I<new-target> I<prior-version> I<package> -- \"$@\"\n"
12098 "\n"
12099 msgstr ""
12101 #. type: textblock
12102 #: dpkg-maintscript-helper.pod
12103 msgid ""
12104 "I<pathname> is the absolute name of the old directory (the path will be a "
12105 "symlink at the end of the installation) and I<new-target> is the target of "
12106 "the new symlink at I<pathname>. It can either be absolute or relative to the "
12107 "directory containing I<pathname>."
12108 msgstr ""
12110 #. type: textblock
12111 #: dpkg-maintscript-helper.pod
12112 msgid ""
12113 "Current implementation: the B<preinst> checks if the directory exists, does "
12114 "not contain conffiles, pathnames owned by other packages, or locally created "
12115 "pathnames, if not then it's left in place, otherwise it's renamed to "
12116 "I<pathname>B<.dpkg-backup>, and an empty staging directory named I<pathname> "
12117 "is created, marked with a file so that dpkg can track it. On configuration, "
12118 "the B<postinst> finishes the switch if I<pathname>B<.dpkg-backup> is still a "
12119 "directory and I<pathname> is the staging directory; it removes the staging "
12120 "directory mark file, moves the newly created files inside the staging "
12121 "directory to the symlink target I<new-target>/, replaces the now empty "
12122 "staging directory I<pathname> with a symlink to I<new-target>, and removes "
12123 "I<pathname>B<.dpkg-backup>. On abort-upgrade/abort-install, the B<postrm> "
12124 "renames I<pathname>B<.dpkg-backup> back to I<pathname> if required."
12125 msgstr ""
12127 #. type: =head1
12128 #: dpkg-maintscript-helper.pod
12129 msgid "INTEGRATION IN PACKAGES"
12130 msgstr ""
12132 #. type: textblock
12133 #: dpkg-maintscript-helper.pod
12134 msgid ""
12135 "When using a packaging helper, please check if it has native "
12136 "B<dpkg-maintscript-helper> integration, which might make your life "
12137 "easier. See for example B<dh_installdeb>(1)."
12138 msgstr ""
12140 #. type: textblock
12141 #: dpkg-maintscript-helper.pod
12142 msgid ""
12143 "Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it "
12144 "unconditionally requires a pre-dependency to ensure that the required "
12145 "version of B<dpkg> has been unpacked before. The required version depends on "
12146 "the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2, for "
12147 "B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14:"
12148 msgstr ""
12150 #. type: verbatim
12151 #: dpkg-maintscript-helper.pod
12152 #, no-wrap
12153 msgid ""
12154 " Pre-Depends: dpkg (>= 1.17.14)\n"
12155 "\n"
12156 msgstr ""
12158 #. type: textblock
12159 #: dpkg-maintscript-helper.pod
12160 msgid ""
12161 "But in many cases the operation done by the program is not critical for the "
12162 "package, and instead of using a pre-dependency we can call the program only "
12163 "if we know that the required command is supported by the currently installed "
12164 "B<dpkg>:"
12165 msgstr ""
12167 #. type: verbatim
12168 #: dpkg-maintscript-helper.pod
12169 #, no-wrap
12170 msgid ""
12171 "Z<>\n"
12172 " if dpkg-maintscript-helper supports I<command>; then\n"
12173 "    dpkg-maintscript-helper I<command> ...\n"
12174 " fi\n"
12175 "\n"
12176 msgstr ""
12178 #. type: textblock
12179 #: dpkg-maintscript-helper.pod
12180 msgid ""
12181 "The command B<supports> will return 0 on success, 1 otherwise. The "
12182 "B<supports> command will check if the environment variables as set by dpkg "
12183 "and required by the script are present, and will consider it a failure in "
12184 "case the environment is not sufficient."
12185 msgstr ""
12187 #. type: textblock
12188 #: dpkg-maintscript-helper.pod
12189 msgid "If set, it will be used as the filesystem root directory."
12190 msgstr ""
12192 #. type: textblock
12193 #: dpkg-maintscript-helper.pod
12194 msgid "If set, it will be used as the B<dpkg> data directory."
12195 msgstr ""
12197 #. type: textblock
12198 #: dpkg-maintscript-helper.pod
12199 msgid ""
12200 "Sets the color mode (since dpkg 1.19.1).  The currently accepted values are: "
12201 "B<auto> (default), B<always> and B<never>."
12202 msgstr ""
12204 #. type: textblock
12205 #: dpkg-maintscript-helper.pod
12206 msgid "B<dh_installdeb>(1)."
12207 msgstr ""
12209 #. type: textblock
12210 #: dpkg-mergechangelogs.pod
12211 msgid "dpkg-mergechangelogs - 3-way merge of debian/changelog files"
12212 msgstr ""
12214 #. type: textblock
12215 #: dpkg-mergechangelogs.pod
12216 msgid "B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]"
12217 msgstr ""
12219 #. type: textblock
12220 #: dpkg-mergechangelogs.pod
12221 msgid ""
12222 "This program will use the 3 provided versions of the Debian changelog to "
12223 "generate a merged changelog file. The resulting changelog is stored in the "
12224 "file I<out> or output to the standard output if that parameter is not given."
12225 msgstr ""
12227 #. type: textblock
12228 #: dpkg-mergechangelogs.pod
12229 msgid ""
12230 "Each entry is identified by its version number and they are assumed to be "
12231 "not conflicting, they are simply merged in the right order (by decreasing "
12232 "version number). When B<--merge-prereleases> is used, the part of the "
12233 "version number after the last tilde is dropped so that 1.0-1~exp1 and "
12234 "1.0-1~exp5 are considered to be the same entry. When the same version is "
12235 "available in both I<new-a> and I<new-b>, a standard line-based 3-way merge "
12236 "is attempted (provided that the module Algorithm::Merge is available — it's "
12237 "part of the package libalgorithm-merge-perl — otherwise you get a global "
12238 "conflict on the content of the entry)."
12239 msgstr ""
12241 #. type: =item
12242 #: dpkg-mergechangelogs.pod
12243 msgid "B<--merge-unreleased>"
12244 msgstr ""
12246 #. type: textblock
12247 #: dpkg-mergechangelogs.pod
12248 msgid ""
12249 "Ignore the version number when the entries are marked as B<UNRELEASED> "
12250 "(since dpkg 1.21.0)."
12251 msgstr ""
12253 #. type: textblock
12254 #: dpkg-mergechangelogs.pod
12255 msgid ""
12256 "This is useful when you have diverging development for versions that have "
12257 "not yet been released. For instance 2.1-1 is released, then development "
12258 "happens for the new 2.2-1 and then for 2.3-1, where it makes sense to just "
12259 "end with a coalesced entry for 2.3-1 including all the development done in "
12260 "2.2-1."
12261 msgstr ""
12263 #. type: =item
12264 #: dpkg-mergechangelogs.pod
12265 msgid "B<-m>, B<--merge-prereleases>"
12266 msgstr ""
12268 #. type: textblock
12269 #: dpkg-mergechangelogs.pod
12270 msgid ""
12271 "Drop the part after the last tilde in the version number when doing version "
12272 "comparison to identify if two entries are supposed to be the same or not."
12273 msgstr ""
12275 #. type: textblock
12276 #: dpkg-mergechangelogs.pod
12277 msgid ""
12278 "This is useful when you keep using the same changelog entry but you increase "
12279 "its version number regularly. For instance, you might have 2.3-1~exp1, "
12280 "2.3-1~exp2, ... until the official release 2.3-1 and they are all the same "
12281 "changelog entry that has evolved over time."
12282 msgstr ""
12284 #. type: =head1
12285 #: dpkg-mergechangelogs.pod
12286 msgid "LIMITATIONS"
12287 msgstr ""
12289 #. type: textblock
12290 #: dpkg-mergechangelogs.pod
12291 msgid ""
12292 "Anything that is not parsed by Dpkg::Changelog is lost during the merge.  "
12293 "This might include stuff like comments which were not supposed to be there, "
12294 "etc."
12295 msgstr ""
12297 #. type: =head1
12298 #: dpkg-mergechangelogs.pod
12299 msgid "INTEGRATION WITH GIT"
12300 msgstr ""
12302 #. type: textblock
12303 #: dpkg-mergechangelogs.pod
12304 msgid ""
12305 "If you want to use this program to merge Debian changelog files in a git "
12306 "repository, you have first to register a new merge driver in B<.git/config> "
12307 "or B<~/.gitconfig>:"
12308 msgstr ""
12310 #. type: verbatim
12311 #: dpkg-mergechangelogs.pod
12312 #, no-wrap
12313 msgid ""
12314 " [merge \"dpkg-mergechangelogs\"]\n"
12315 "    name = debian/changelog merge driver\n"
12316 "    driver = dpkg-mergechangelogs -m %O %A %B %A\n"
12317 "\n"
12318 msgstr ""
12320 #. type: textblock
12321 #: dpkg-mergechangelogs.pod
12322 msgid ""
12323 "Then you have to setup the merge attribute for the debian/changelog file "
12324 "either in B<.gitattributes> in the repository itself, or in "
12325 "B<.git/info/attributes>:"
12326 msgstr ""
12328 #. type: verbatim
12329 #: dpkg-mergechangelogs.pod
12330 #, no-wrap
12331 msgid " debian/changelog merge=dpkg-mergechangelogs\n"
12332 msgstr ""
12334 #. type: textblock
12335 #: dpkg-name.pod
12336 msgid "dpkg-name - rename Debian packages to full package names"
12337 msgstr ""
12339 #. type: textblock
12340 #: dpkg-name.pod
12341 msgid "B<dpkg-name> [I<option>...] [B<-->] I<file>..."
12342 msgstr ""
12344 #. type: textblock
12345 #: dpkg-name.pod
12346 msgid ""
12347 "This manual page documents the B<dpkg-name> program which provides an easy "
12348 "way to rename B<Debian> packages into their full package names. A full "
12349 "package name consists of "
12350 "I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified "
12351 "in the control file of the package. The I<version> part of the filename "
12352 "consists of the upstream version information optionally followed by a hyphen "
12353 "and the revision information. The I<package-type> part comes from that field "
12354 "if present or fallbacks to B<deb>."
12355 msgstr ""
12357 #. type: =item
12358 #: dpkg-name.pod
12359 msgid "B<-a>, B<--no-architecture>"
12360 msgstr ""
12362 #. type: textblock
12363 #: dpkg-name.pod
12364 msgid "The destination filename will not have the architecture information."
12365 msgstr ""
12367 #. type: =item
12368 #: dpkg-name.pod
12369 msgid "B<-k>, B<--symlink>"
12370 msgstr ""
12372 #. type: textblock
12373 #: dpkg-name.pod
12374 msgid "Create a symlink, instead of moving."
12375 msgstr ""
12377 #. type: =item
12378 #: dpkg-name.pod
12379 msgid "B<-o>, B<--overwrite>"
12380 msgstr ""
12382 #. type: textblock
12383 #: dpkg-name.pod
12384 msgid ""
12385 "Existing files will be overwritten if they have the same name as the "
12386 "destination filename."
12387 msgstr ""
12389 #. type: =item
12390 #: dpkg-name.pod
12391 msgid "B<-s>, B<--subdir> [I<dir>]"
12392 msgstr ""
12394 #. type: textblock
12395 #: dpkg-name.pod
12396 msgid ""
12397 "Files will be moved into a subdirectory. If the directory given as argument "
12398 "exists the files will be moved into that directory otherwise the name of the "
12399 "target directory is extracted from the section field in the control part of "
12400 "the package. The target directory will be "
12401 "«unstable/binary-I<architecture>/I<section>».  If the section is not found "
12402 "in the control, then B<no-section> is assumed, and in this case, as well as "
12403 "for sections B<non-free> and B<contrib> the target directory is "
12404 "«I<section>/binary-I<architecture>».  The section field is not required so a "
12405 "lot of packages will find their way to the B<no-section> area."
12406 msgstr ""
12408 #. type: textblock
12409 #: dpkg-name.pod
12410 msgid "B<Warning:> I<Use this option with care, it is messy.>"
12411 msgstr ""
12413 #. type: =item
12414 #: dpkg-name.pod
12415 msgid "B<-c>, B<--create-dir>"
12416 msgstr ""
12418 #. type: textblock
12419 #: dpkg-name.pod
12420 msgid ""
12421 "This option can used together with the B<-s> option. If a target directory "
12422 "isn't found it will be created automatically."
12423 msgstr ""
12425 #. type: textblock
12426 #: dpkg-name.pod
12427 msgid "B<Warning:> I<Use this option with care.>"
12428 msgstr ""
12430 #. type: =item
12431 #: dpkg-name.pod
12432 msgid "B<-v>, B<--version>"
12433 msgstr ""
12435 #. type: textblock
12436 #: dpkg-name.pod
12437 msgid ""
12438 "Some packages don't follow the name structure "
12439 "I<package>B<_>I<version>B<_>I<architecture>B<.deb>.  Packages renamed by "
12440 "B<dpkg-name> will follow this structure. Generally this will have no impact "
12441 "on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other "
12442 "installation tools might depend on this naming structure."
12443 msgstr ""
12445 #. type: =item
12446 #: dpkg-name.pod
12447 msgid "B<dpkg-name bar-foo.deb>"
12448 msgstr ""
12450 #. type: textblock
12451 #: dpkg-name.pod
12452 msgid ""
12453 "The file B<bar-foo.deb> will be renamed to bar-foo_1.0-2_i386.deb or "
12454 "something similar (depending on whatever information is in the control part "
12455 "of B<bar-foo.deb>)."
12456 msgstr ""
12458 #. type: =item
12459 #: dpkg-name.pod
12460 msgid "B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>"
12461 msgstr ""
12463 #. type: textblock
12464 #: dpkg-name.pod
12465 msgid ""
12466 "All files with the extension B<deb> in the directory /root/debian and its "
12467 "subdirectory's will be renamed by B<dpkg-name> if required into names with "
12468 "no architecture information."
12469 msgstr ""
12471 #. type: =item
12472 #: dpkg-name.pod
12473 msgid "B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>"
12474 msgstr ""
12476 #. type: textblock
12477 #: dpkg-name.pod
12478 msgid ""
12479 "B<Don't do this.> Your archive will be messed up completely because a lot of "
12480 "packages don't come with section information.  B<Don't do this.>"
12481 msgstr ""
12483 #. type: =item
12484 #: dpkg-name.pod
12485 msgid "B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>"
12486 msgstr ""
12488 #. type: textblock
12489 #: dpkg-name.pod
12490 msgid "This can be used when building new packages."
12491 msgstr ""
12493 #. type: textblock
12494 #: dpkg-name.pod
12495 msgid ""
12496 "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dpkg-deb>(1), B<find>(1), "
12497 "B<xargs>(1)."
12498 msgstr ""
12500 #. type: textblock
12501 #: dpkg-parsechangelog.pod
12502 msgid "dpkg-parsechangelog - parse Debian changelog files"
12503 msgstr ""
12505 #. type: textblock
12506 #: dpkg-parsechangelog.pod
12507 msgid "B<dpkg-parsechangelog> [I<option>...]"
12508 msgstr ""
12510 #. type: textblock
12511 #: dpkg-parsechangelog.pod
12512 msgid ""
12513 "B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian "
12514 "source tree and outputs the information in it to standard output in a "
12515 "machine-readable form."
12516 msgstr ""
12518 #. type: =item
12519 #: dpkg-parsechangelog.pod
12520 msgid "B<-l>, B<--file> I<changelog-file>"
12521 msgstr ""
12523 #. type: textblock
12524 #: dpkg-parsechangelog.pod
12525 msgid ""
12526 "Specifies the changelog file to read information from.  A ‘-’ can be used to "
12527 "specify reading from standard input.  The default is B<debian/changelog>."
12528 msgstr ""
12530 #. type: =item
12531 #: dpkg-parsechangelog.pod
12532 msgid "B<-F> I<changelog-format>"
12533 msgstr ""
12535 #. type: textblock
12536 #: dpkg-parsechangelog.pod
12537 msgid ""
12538 "Specifies the format of the changelog. By default the format is read from a "
12539 "special line near the bottom of the changelog or failing that defaults to "
12540 "the B<debian> standard format. See also B<CHANGELOG FORMATS>."
12541 msgstr ""
12543 #. type: =item
12544 #: dpkg-parsechangelog.pod
12545 msgid "B<-L> I<libdir>"
12546 msgstr ""
12548 #. type: textblock
12549 #: dpkg-parsechangelog.pod
12550 msgid ""
12551 "Obsolete option without effect (since dpkg 1.18.8).  Setting the perl "
12552 "environment variables B<PERL5LIB> or B<PERLLIB> has a similar effect when "
12553 "looking for the parser perl modules."
12554 msgstr ""
12556 #. type: =item
12557 #: dpkg-parsechangelog.pod
12558 msgid "B<-S>, B<--show-field> I<field>"
12559 msgstr ""
12561 #. type: textblock
12562 #: dpkg-parsechangelog.pod
12563 msgid ""
12564 "Specifies the name of the field to show (since dpkg 1.17.0).  The field name "
12565 "is not printed, only its value."
12566 msgstr ""
12568 #. type: =head2
12569 #: dpkg-parsechangelog.pod
12570 msgid "Parser Options"
12571 msgstr ""
12573 #. type: textblock
12574 #: dpkg-parsechangelog.pod
12575 msgid ""
12576 "The following options can be used to influence the output of the changelog "
12577 "parser, for example the range of entries or the format of the output."
12578 msgstr ""
12580 #. type: =item
12581 #: dpkg-parsechangelog.pod
12582 msgid "B<--format> I<output-format>"
12583 msgstr ""
12585 #. type: textblock
12586 #: dpkg-parsechangelog.pod
12587 msgid ""
12588 "Set the output format. Currently supported values are B<dpkg> and "
12589 "B<rfc822>.  B<dpkg> is the classic output format (from before this option "
12590 "existed) and the default. It consists of one stanza in Debian control format "
12591 "(see B<deb-control>(5)). If more than one entry is requested, then most "
12592 "fields are taken from the first entry (usually the most recent entry), "
12593 "except otherwise stated:"
12594 msgstr ""
12596 #. type: =item
12597 #: dpkg-parsechangelog.pod
12598 msgid "B<Source:> I<pkg-name>"
12599 msgstr ""
12601 #. type: =item
12602 #: dpkg-parsechangelog.pod
12603 msgid "B<Version:> I<version>"
12604 msgstr ""
12606 #. type: =item
12607 #: dpkg-parsechangelog.pod
12608 msgid "B<Distribution:> I<target-distribution>"
12609 msgstr ""
12611 #. type: =item
12612 #: dpkg-parsechangelog.pod
12613 msgid "B<Urgency:> I<urgency>"
12614 msgstr ""
12616 #. type: textblock
12617 #: dpkg-parsechangelog.pod
12618 msgid ""
12619 "The highest urgency of all included entries is used, followed by the "
12620 "concatenated (space-separated) comments from all the versions requested."
12621 msgstr ""
12623 #. type: =item
12624 #: dpkg-parsechangelog.pod
12625 msgid "B<Maintainer:> I<author>"
12626 msgstr ""
12628 #. type: =item
12629 #: dpkg-parsechangelog.pod
12630 msgid "B<Date:> I<date>"
12631 msgstr ""
12633 #. type: textblock
12634 #: dpkg-parsechangelog.pod
12635 msgid ""
12636 "The date of the entry as a string, as it appears in the changelog.  With a "
12637 "B<strptime>(3) format \"B<%a, %d %b %Y %T %z>\", but where the day of the "
12638 "week might not actually correspond to the real day obtained from the rest of "
12639 "the date string.  If you need a more accurate representation of the date, "
12640 "use the B<Timestamp> field, but take into account it might not be possible "
12641 "to map it back to the exact value in this field."
12642 msgstr ""
12644 #. type: =item
12645 #: dpkg-parsechangelog.pod
12646 msgid "B<Timestamp:> I<timestamp>"
12647 msgstr ""
12649 #. type: textblock
12650 #: dpkg-parsechangelog.pod
12651 msgid ""
12652 "The date of the entry as a timestamp in seconds since the epoch (since dpkg "
12653 "1.18.8)."
12654 msgstr ""
12656 #. type: =item
12657 #: dpkg-parsechangelog.pod
12658 msgid "B<Closes:> I<bug-number>"
12659 msgstr ""
12661 #. type: textblock
12662 #: dpkg-parsechangelog.pod
12663 msgid "The Closes fields of all included entries are merged."
12664 msgstr ""
12666 #. type: =item
12667 #: dpkg-parsechangelog.pod
12668 msgid "B<Changes:> I<changelog-entries>"
12669 msgstr ""
12671 #. type: textblock
12672 #: dpkg-parsechangelog.pod
12673 msgid ""
12674 "The text of all changelog entries is concatenated. To make this field a "
12675 "valid Debian control format multiline field empty lines are replaced with a "
12676 "single full stop and all lines is intended by one space character. The exact "
12677 "content depends on the changelog format."
12678 msgstr ""
12680 #. type: textblock
12681 #: dpkg-parsechangelog.pod
12682 msgid ""
12683 "The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> "
12684 "fields are mandatory."
12685 msgstr ""
12687 #. type: textblock
12688 #: dpkg-parsechangelog.pod
12689 msgid "There might be additional user-defined fields present."
12690 msgstr ""
12692 #. type: textblock
12693 #: dpkg-parsechangelog.pod
12694 msgid ""
12695 "The B<rfc822> format uses the same fields but outputs a separate stanza for "
12696 "each changelog entry so that all metadata for each entry is preserved."
12697 msgstr ""
12699 #. type: =item
12700 #: dpkg-parsechangelog.pod
12701 msgid "B<--reverse>"
12702 msgstr ""
12704 #. type: textblock
12705 #: dpkg-parsechangelog.pod
12706 msgid "Include all changes in reverse order (since dpkg 1.19.1)."
12707 msgstr ""
12709 #. type: textblock
12710 #: dpkg-parsechangelog.pod
12711 msgid ""
12712 "B<Note:> For the B<dpkg> format the first entry will be the most ancient "
12713 "entry."
12714 msgstr ""
12716 #. type: =item
12717 #: dpkg-parsechangelog.pod update-alternatives.pod
12718 msgid "B<--all>"
12719 msgstr ""
12721 #. type: textblock
12722 #: dpkg-parsechangelog.pod
12723 msgid ""
12724 "Include all changes.  B<Note:> Other options have no effect when this is in "
12725 "use."
12726 msgstr ""
12728 #. type: =item
12729 #: dpkg-parsechangelog.pod
12730 msgid "B<-s>, B<--since> I<version>"
12731 msgstr ""
12733 #. type: =item
12734 #: dpkg-parsechangelog.pod
12735 msgid "B<-v> I<version>"
12736 msgstr ""
12738 #. type: textblock
12739 #: dpkg-parsechangelog.pod
12740 msgid "Include all changes later than I<version>."
12741 msgstr ""
12743 #. type: =item
12744 #: dpkg-parsechangelog.pod
12745 msgid "B<-u>, B<--until> I<version>"
12746 msgstr ""
12748 #. type: textblock
12749 #: dpkg-parsechangelog.pod
12750 msgid "Include all changes earlier than I<version>."
12751 msgstr ""
12753 #. type: =item
12754 #: dpkg-parsechangelog.pod
12755 msgid "B<-f>, B<--from> I<version>"
12756 msgstr ""
12758 #. type: textblock
12759 #: dpkg-parsechangelog.pod
12760 msgid "Include all changes equal or later than I<version>."
12761 msgstr ""
12763 #. type: =item
12764 #: dpkg-parsechangelog.pod
12765 msgid "B<-t>, B<--to> I<version>"
12766 msgstr ""
12768 #. type: textblock
12769 #: dpkg-parsechangelog.pod
12770 msgid "Include all changes up to or equal than I<version>."
12771 msgstr ""
12773 #. type: =item
12774 #: dpkg-parsechangelog.pod
12775 msgid "B<-c>, B<--count> I<number>"
12776 msgstr ""
12778 #. type: =item
12779 #: dpkg-parsechangelog.pod
12780 msgid "B<-n> I<number>"
12781 msgstr ""
12783 #. type: textblock
12784 #: dpkg-parsechangelog.pod
12785 msgid ""
12786 "Include I<number> entries from the top (or the tail if I<number> is lower "
12787 "than 0)."
12788 msgstr ""
12790 #. type: =item
12791 #: dpkg-parsechangelog.pod
12792 msgid "B<-o>, B<--offset> I<number>"
12793 msgstr ""
12795 #. type: textblock
12796 #: dpkg-parsechangelog.pod
12797 msgid ""
12798 "Change the starting point for B<--count>, counted from the top (or the tail "
12799 "if I<number> is lower than 0)."
12800 msgstr ""
12802 #. type: =head1
12803 #: dpkg-parsechangelog.pod
12804 msgid "CHANGELOG FORMATS"
12805 msgstr ""
12807 #. type: textblock
12808 #: dpkg-parsechangelog.pod
12809 msgid ""
12810 "It is possible to use a different format to the standard one, by providing a "
12811 "parser for that alternative format."
12812 msgstr ""
12814 #. type: textblock
12815 #: dpkg-parsechangelog.pod
12816 msgid ""
12817 "In order to have B<dpkg-parsechangelog> run the new parser, a line must be "
12818 "included within the last 40 lines of the changelog file, matching the Perl "
12819 "regular expression: “B<\\schangelog-format:\\s+([0-9a-z]+)\\W>”.  The part "
12820 "in parentheses should be the name of the format. For example:"
12821 msgstr ""
12823 #. type: textblock
12824 #: dpkg-parsechangelog.pod
12825 msgid "@@@ changelog-format: I<otherformat> @@@"
12826 msgstr ""
12828 #. type: textblock
12829 #: dpkg-parsechangelog.pod
12830 msgid ""
12831 "Changelog format names are non-empty strings of lowercase alphanumerics "
12832 "(“a-z0-9”)."
12833 msgstr ""
12835 #. type: textblock
12836 #: dpkg-parsechangelog.pod
12837 msgid ""
12838 "If such a line exists then B<dpkg-parsechangelog> will look for the parser "
12839 "as a B<Dpkg::Changelog::>I<Otherformat> perl module; it is an error for it "
12840 "not being present.  The parser name in the perl module will be automatically "
12841 "capitalized.  The default changelog format is B<debian>, and a parser for it "
12842 "is provided by default."
12843 msgstr ""
12845 #. type: textblock
12846 #: dpkg-parsechangelog.pod
12847 msgid ""
12848 "The parser should be derived from the Dpkg::Changelog class and implement "
12849 "the required documented interface."
12850 msgstr ""
12852 #. type: textblock
12853 #: dpkg-parsechangelog.pod
12854 msgid ""
12855 "If the changelog format which is being parsed always or almost always leaves "
12856 "a blank line between individual change notes, these blank lines should be "
12857 "stripped out, so as to make the resulting output compact."
12858 msgstr ""
12860 #. type: textblock
12861 #: dpkg-parsechangelog.pod
12862 msgid ""
12863 "If the changelog format does not contain date or package name information "
12864 "this information should be omitted from the output. The parser should not "
12865 "attempt to synthesize it or find it from other sources."
12866 msgstr ""
12868 #. type: textblock
12869 #: dpkg-parsechangelog.pod
12870 msgid ""
12871 "If the changelog does not have the expected format the parser should error "
12872 "out, rather than trying to muddle through and possibly generating incorrect "
12873 "output."
12874 msgstr ""
12876 #. type: textblock
12877 #: dpkg-parsechangelog.pod
12878 msgid "A changelog parser may not interact with the user at all."
12879 msgstr ""
12881 #. type: textblock
12882 #: dpkg-parsechangelog.pod
12883 msgid ""
12884 "All B<Parser Options> except for B<-v> are only supported since dpkg "
12885 "1.14.16."
12886 msgstr ""
12888 #. type: textblock
12889 #: dpkg-parsechangelog.pod
12890 msgid ""
12891 "Short option parsing with non-bundled values available only since dpkg "
12892 "1.18.0."
12893 msgstr ""
12895 #. type: textblock
12896 #: dpkg-parsechangelog.pod
12897 msgid ""
12898 "The changelog file, used to obtain version-dependent information about the "
12899 "source package, such as the urgency and distribution of an upload, the "
12900 "changes made since a particular release, and the source version number "
12901 "itself."
12902 msgstr ""
12904 #. type: textblock
12905 #: dpkg-parsechangelog.pod
12906 msgid "B<deb-changelog>(5)."
12907 msgstr ""
12909 #. type: textblock
12910 #: dpkg-query.pod
12911 msgid "dpkg-query - a tool to query the dpkg database"
12912 msgstr ""
12914 #. type: textblock
12915 #: dpkg-query.pod
12916 msgid "B<dpkg-query> [I<option>...] I<command>"
12917 msgstr ""
12919 #. type: textblock
12920 #: dpkg-query.pod
12921 msgid ""
12922 "B<dpkg-query> is a tool to show information about packages listed in the "
12923 "B<dpkg> database."
12924 msgstr ""
12926 #. type: =item
12927 #: dpkg-query.pod
12928 msgid "B<-l>, B<--list> [I<package-name-pattern>...]"
12929 msgstr ""
12931 #. type: textblock
12932 #: dpkg-query.pod
12933 msgid ""
12934 "List all known packages matching one or more patterns, regardless of their "
12935 "status, which includes any real or virtual package referenced in any "
12936 "dependency relationship field (such as B<Breaks>, B<Enhances>, etc.).  If no "
12937 "I<package-name-pattern> is given, list all packages in I<%ADMINDIR%/status>, "
12938 "excluding the ones marked as not-installed (i.e.  those which have been "
12939 "previously purged).  Normal shell wildcard characters are allowed in "
12940 "I<package-name-pattern>.  Please note you will probably have to quote "
12941 "I<package-name-pattern> to prevent the shell from performing filename "
12942 "expansion.  For example this will list all package names starting with "
12943 "“libc6”:"
12944 msgstr ""
12946 #. type: verbatim
12947 #: dpkg-query.pod
12948 #, no-wrap
12949 msgid ""
12950 " dpkg-query -l 'libc6*'\n"
12951 "\n"
12952 msgstr ""
12954 #. type: textblock
12955 #: dpkg-query.pod
12956 msgid ""
12957 "The first three columns of the output show the desired action, the package "
12958 "status, and errors, in that order."
12959 msgstr ""
12961 #. type: textblock
12962 #: dpkg-query.pod
12963 msgid "Desired action:"
12964 msgstr ""
12966 #. type: =item
12967 #: dpkg-query.pod
12968 msgid "u = Unknown"
12969 msgstr ""
12971 #. type: =item
12972 #: dpkg-query.pod
12973 msgid "i = Install"
12974 msgstr ""
12976 #. type: =item
12977 #: dpkg-query.pod
12978 msgid "h = Hold"
12979 msgstr ""
12981 #. type: =item
12982 #: dpkg-query.pod
12983 msgid "r = Remove"
12984 msgstr ""
12986 #. type: =item
12987 #: dpkg-query.pod
12988 msgid "p = Purge"
12989 msgstr ""
12991 #. type: textblock
12992 #: dpkg-query.pod
12993 msgid "Package status:"
12994 msgstr ""
12996 #. type: =item
12997 #: dpkg-query.pod
12998 msgid "n = Not-installed"
12999 msgstr ""
13001 #. type: =item
13002 #: dpkg-query.pod
13003 msgid "c = Config-files"
13004 msgstr ""
13006 #. type: =item
13007 #: dpkg-query.pod
13008 msgid "H = Half-installed"
13009 msgstr ""
13011 #. type: =item
13012 #: dpkg-query.pod
13013 msgid "U = Unpacked"
13014 msgstr ""
13016 #. type: =item
13017 #: dpkg-query.pod
13018 msgid "F = Half-configured"
13019 msgstr ""
13021 #. type: =item
13022 #: dpkg-query.pod
13023 msgid "W = Triggers-awaiting"
13024 msgstr ""
13026 #. type: =item
13027 #: dpkg-query.pod
13028 msgid "t = Triggers-pending"
13029 msgstr ""
13031 #. type: =item
13032 #: dpkg-query.pod
13033 msgid "i = Installed"
13034 msgstr ""
13036 #. type: textblock
13037 #: dpkg-query.pod
13038 msgid "Error flags:"
13039 msgstr ""
13041 #. type: =item
13042 #: dpkg-query.pod
13043 msgid "E<lt>emptyE<gt> = (none)"
13044 msgstr ""
13046 #. type: =item
13047 #: dpkg-query.pod
13048 msgid "R = Reinst-required"
13049 msgstr ""
13051 #. type: textblock
13052 #: dpkg-query.pod
13053 msgid ""
13054 "An uppercase status or error letter indicates the package is likely to cause "
13055 "severe problems. Please refer to B<dpkg>(1) for information about the above "
13056 "states and flags."
13057 msgstr ""
13059 #. type: textblock
13060 #: dpkg-query.pod
13061 msgid ""
13062 "The output format of this option is not configurable, but varies "
13063 "automatically to fit the terminal width. It is intended for human readers, "
13064 "and is not easily machine-readable. See B<-W> (B<--show>)  and "
13065 "B<--showformat> for a way to configure the output format."
13066 msgstr ""
13068 #. type: =item
13069 #: dpkg-query.pod
13070 msgid "B<-W>, B<--show> [I<package-name-pattern>...]"
13071 msgstr ""
13073 #. type: textblock
13074 #: dpkg-query.pod
13075 msgid ""
13076 "Just like the B<--list> option this will list all packages matching the "
13077 "given patterns. However the output can be customized using the "
13078 "B<--showformat> option."
13079 msgstr ""
13081 #. type: textblock
13082 #: dpkg-query.pod
13083 msgid ""
13084 "The default output format gives one line per matching package, each line "
13085 "consisting of the package name and its installed version, separated by a "
13086 "tab.  The package name will be architecture qualified for packages with a "
13087 "B<Multi-Arch> field with the value B<same> or with a foreign architecture, "
13088 "which is an architecture that is neither the native one nor B<all>."
13089 msgstr ""
13091 #. type: =item
13092 #: dpkg-query.pod
13093 msgid "B<-s>, B<--status> [I<package-name>...]"
13094 msgstr ""
13096 #. type: textblock
13097 #: dpkg-query.pod
13098 msgid ""
13099 "Report status of specified packages. This just displays the entry in the "
13100 "installed package status database.  If no I<package-name> is specified it "
13101 "will display all package entries in the status database (since dpkg "
13102 "1.19.1).  When multiple I<package-name> entries are listed, the requested "
13103 "status entries are separated by an empty line, with the same order as "
13104 "specified on the argument list."
13105 msgstr ""
13107 #. type: =item
13108 #: dpkg-query.pod dpkg.pod
13109 msgid "B<-L>, B<--listfiles> I<package-name>..."
13110 msgstr ""
13112 #. type: textblock
13113 #: dpkg-query.pod
13114 msgid ""
13115 "List files installed to your system from I<package-name>. When multiple "
13116 "I<package-name>s are listed, the requested lists of files are separated by "
13117 "an empty line, with the same order as specified on the argument list."
13118 msgstr ""
13120 #. type: textblock
13121 #: dpkg-query.pod
13122 msgid ""
13123 "Each file diversion is printed on its own line after its diverted file, "
13124 "prefixed with one of the following localized strings:"
13125 msgstr ""
13127 #. type: verbatim
13128 #: dpkg-query.pod
13129 #, no-wrap
13130 msgid ""
13131 "Z<>\n"
13132 "  locally diverted to: I<diverted-to>\n"
13133 "  package diverts others to: I<diverted-to>\n"
13134 "  diverted by I<pkg> to: I<diverted-to>\n"
13135 "\n"
13136 msgstr ""
13138 #. type: textblock
13139 #: dpkg-query.pod
13140 msgid ""
13141 "Hint: When machine parsing the output, it is customary to set the locale to "
13142 "B<C.UTF-8> to get reproducible results."
13143 msgstr ""
13145 #. type: textblock
13146 #: dpkg-query.pod
13147 msgid ""
13148 "This command will not list extra files created by maintainer scripts, nor "
13149 "will it list alternatives."
13150 msgstr ""
13152 #. type: =item
13153 #: dpkg-query.pod
13154 msgid "B<--control-list> I<package-name>"
13155 msgstr ""
13157 #. type: textblock
13158 #: dpkg-query.pod
13159 msgid ""
13160 "List control files installed to your system from I<package-name> (since dpkg "
13161 "1.16.5).  These can be used as input arguments to B<--control-show>."
13162 msgstr ""
13164 #. type: =item
13165 #: dpkg-query.pod
13166 msgid "B<--control-show> I<package-name> I<control-file>"
13167 msgstr ""
13169 #. type: textblock
13170 #: dpkg-query.pod
13171 msgid ""
13172 "Print the I<control-file> installed to your system from I<package-name> to "
13173 "the standard output (since dpkg 1.16.5)."
13174 msgstr ""
13176 #. type: =item
13177 #: dpkg-query.pod
13178 msgid "B<-c>, B<--control-path> I<package-name> [I<control-file>]"
13179 msgstr ""
13181 #. type: textblock
13182 #: dpkg-query.pod
13183 msgid ""
13184 "List paths for control files installed to your system from I<package-name> "
13185 "(since dpkg 1.15.4).  If I<control-file> is specified then only list the "
13186 "path for that control file if it is present."
13187 msgstr ""
13189 #. type: textblock
13190 #: dpkg-query.pod
13191 msgid ""
13192 "B<Warning>: this command is deprecated as it gives direct access to the "
13193 "internal dpkg database, please switch to use B<--control-list> and "
13194 "B<--control-show> instead for all cases where those commands might give the "
13195 "same end result. Although, as long as there is still at least one case where "
13196 "this command is needed (i.e. when having to remove a damaging postrm "
13197 "maintainer script), and while there is no good solution for that, this "
13198 "command will not get removed."
13199 msgstr ""
13201 #. type: =item
13202 #: dpkg-query.pod dpkg.pod
13203 msgid "B<-S>, B<--search> I<filename-search-pattern>..."
13204 msgstr ""
13206 #. type: textblock
13207 #: dpkg-query.pod
13208 msgid ""
13209 "Search for packages that own files corresponding to the given patterns.  "
13210 "Standard shell wildcard characters can be used in the pattern, where "
13211 "asterisk (B<*>) and question mark (B<?>) will match a slash, and backslash "
13212 "(B<\\>) will be used as an escape character."
13213 msgstr ""
13215 #. type: textblock
13216 #: dpkg-query.pod
13217 msgid ""
13218 "If the first character in the I<filename-search-pattern> is none of "
13219 "‘B<*[?/>’ then it will be considered a substring match and will be "
13220 "implicitly surrounded by ‘B<*>’ (as in B<*>I<filename-search-pattern>B<*>).  "
13221 "If the subsequent string contains any of ‘B<*[?\\>’, then it will handled "
13222 "like a glob pattern, otherwise any trailing ‘B</>’ or ‘B</.>’ will be "
13223 "removed and a literal path lookup will be performed."
13224 msgstr ""
13226 #. type: textblock
13227 #: dpkg-query.pod
13228 msgid ""
13229 "The output format consists of one line per matching pattern, with a list of "
13230 "packages owning the pathname separated by a comma (U+002C ‘B<,>’) and a "
13231 "space (U+0020 ‘B< >’), followed by a colon (U+003A ‘B<:>’) and a space, "
13232 "followed by the pathname. As in:"
13233 msgstr ""
13235 #. type: verbatim
13236 #: dpkg-query.pod
13237 #, no-wrap
13238 msgid ""
13239 "  pkgname1, pkgname2: pathname1\n"
13240 "  pkgname3: pathname2\n"
13241 "\n"
13242 msgstr ""
13244 #. type: textblock
13245 #: dpkg-query.pod
13246 msgid "File diversions are printed with the following localized strings:"
13247 msgstr ""
13249 #. type: verbatim
13250 #: dpkg-query.pod
13251 #, no-wrap
13252 msgid ""
13253 "Z<>\n"
13254 "  diversion by I<pkgname> from: I<diverted-from>\n"
13255 "  diversion by I<pkgname> to: I<diverted-to>\n"
13256 "\n"
13257 msgstr ""
13259 #. type: textblock
13260 #: dpkg-query.pod
13261 msgid "or for local diversions:"
13262 msgstr ""
13264 #. type: verbatim
13265 #: dpkg-query.pod
13266 #, no-wrap
13267 msgid ""
13268 "Z<>\n"
13269 "  local diversion from: I<diverted-from>\n"
13270 "  local diversion to: I<diverted-to>\n"
13271 "\n"
13272 msgstr ""
13274 #. type: =item
13275 #: dpkg-query.pod
13276 msgid "B<-p>, B<--print-avail> [I<package-name>...]"
13277 msgstr ""
13279 #. type: textblock
13280 #: dpkg-query.pod
13281 msgid ""
13282 "Display details about packages, as found in I<%ADMINDIR%/available>.  If no "
13283 "I<package-name> is specified, it will display all package entries in the "
13284 "I<available> database (since dpkg 1.19.1).  When multiple I<package-name> "
13285 "are listed, the requested I<available> entries are separated by an empty "
13286 "line, with the same order as specified on the argument list."
13287 msgstr ""
13289 #. type: textblock
13290 #: dpkg-query.pod
13291 msgid ""
13292 "Users of APT-based frontends should use B<apt show> I<package-name> instead "
13293 "as the I<available> file is only kept up-to-date when using B<dselect>."
13294 msgstr ""
13296 #. type: textblock
13297 #: dpkg-query.pod
13298 msgid ""
13299 "Change the location of the B<dpkg> database. The default location is "
13300 "I<%ADMINDIR%>."
13301 msgstr ""
13303 #. type: =item
13304 #: dpkg-query.pod dpkg-trigger.pod
13305 msgid "B<--root=>I<directory>"
13306 msgstr ""
13308 #. type: textblock
13309 #: dpkg-query.pod dpkg-trigger.pod
13310 msgid ""
13311 "Set the root directory to I<directory>, which sets the administrative "
13312 "directory to «I<directory>%ADMINDIR%» (since dpkg 1.21.0)."
13313 msgstr ""
13315 #. type: =item
13316 #: dpkg-query.pod
13317 msgid "B<--load-avail>"
13318 msgstr ""
13320 #. type: textblock
13321 #: dpkg-query.pod
13322 msgid ""
13323 "Also load the available file when using the B<--show> and B<--list> "
13324 "commands, which now default to only querying the status file (since dpkg "
13325 "1.16.2)."
13326 msgstr ""
13328 #. type: =item
13329 #: dpkg-query.pod dpkg.pod
13330 msgid "B<--no-pager>"
13331 msgstr ""
13333 #. type: textblock
13334 #: dpkg-query.pod dpkg.pod
13335 msgid "Disables the use of any pager when showing information (since dpkg 1.19.2)."
13336 msgstr ""
13338 #. type: =item
13339 #: dpkg-query.pod
13340 msgid "B<-f>, B<--showformat=>I<format>"
13341 msgstr ""
13343 #. type: textblock
13344 #: dpkg-query.pod
13345 msgid ""
13346 "This option is used to specify the format of the output B<--show> will "
13347 "produce (short option since dpkg 1.13.1).  The format is a string that will "
13348 "be output for each package listed."
13349 msgstr ""
13351 #. type: textblock
13352 #: dpkg-query.pod
13353 msgid "In the format string, “B<\\>” introduces escapes:"
13354 msgstr ""
13356 #. type: =item
13357 #: dpkg-query.pod
13358 msgid "B<\\n> newline"
13359 msgstr ""
13361 #. type: =item
13362 #: dpkg-query.pod
13363 msgid "B<\\r> carriage return"
13364 msgstr ""
13366 #. type: =item
13367 #: dpkg-query.pod
13368 msgid "B<\\t> tab"
13369 msgstr ""
13371 #. type: textblock
13372 #: dpkg-query.pod
13373 msgid ""
13374 "“B<\\>” before any other character suppresses any special meaning of the "
13375 "following character, which is useful for “B<\\>” and “B<$>”."
13376 msgstr ""
13378 #. type: textblock
13379 #: dpkg-query.pod
13380 msgid ""
13381 "Package information can be included by inserting variable references to "
13382 "package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”. Fields "
13383 "are printed right-aligned unless the width is negative in which case left "
13384 "alignment will be used. The following I<field>s are recognized but they are "
13385 "not necessarily available in the status file (only internal fields or fields "
13386 "stored in the binary package end up in it):"
13387 msgstr ""
13389 #. type: =item
13390 #: dpkg-query.pod
13391 msgid "B<Architecture>"
13392 msgstr ""
13394 #. type: =item
13395 #: dpkg-query.pod
13396 msgid "B<Bugs>"
13397 msgstr ""
13399 #. type: =item
13400 #: dpkg-query.pod
13401 msgid "B<Conffiles> (internal)"
13402 msgstr ""
13404 #. type: =item
13405 #: dpkg-query.pod
13406 msgid "B<Config-Version> (internal)"
13407 msgstr ""
13409 #. type: =item
13410 #: dpkg-query.pod
13411 msgid "B<Conflicts>"
13412 msgstr ""
13414 #. type: =item
13415 #: dpkg-query.pod
13416 msgid "B<Breaks>"
13417 msgstr ""
13419 #. type: =item
13420 #: dpkg-query.pod
13421 msgid "B<Depends>"
13422 msgstr ""
13424 #. type: =item
13425 #: dpkg-query.pod
13426 msgid "B<Description>"
13427 msgstr ""
13429 #. type: =item
13430 #: dpkg-query.pod
13431 msgid "B<Enhances>"
13432 msgstr ""
13434 #. type: =item
13435 #: dpkg-query.pod
13436 msgid "B<Protected>"
13437 msgstr ""
13439 #. type: =item
13440 #: dpkg-query.pod
13441 msgid "B<Essential>"
13442 msgstr ""
13444 #. type: =item
13445 #: dpkg-query.pod
13446 msgid "B<Filename> (internal, front-end related)"
13447 msgstr ""
13449 #. type: =item
13450 #: dpkg-query.pod
13451 msgid "B<Homepage>"
13452 msgstr ""
13454 #. type: =item
13455 #: dpkg-query.pod
13456 msgid "B<MD5sum> (internal, front-end related)"
13457 msgstr ""
13459 #. type: =item
13460 #: dpkg-query.pod
13461 msgid "B<MSDOS-Filename> (internal, front-end related)"
13462 msgstr ""
13464 #. type: =item
13465 #: dpkg-query.pod
13466 msgid "B<Maintainer>"
13467 msgstr ""
13469 #. type: =item
13470 #: dpkg-query.pod
13471 msgid "B<Origin>"
13472 msgstr ""
13474 #. type: =item
13475 #: dpkg-query.pod
13476 msgid "B<Package>"
13477 msgstr ""
13479 #. type: =item
13480 #: dpkg-query.pod
13481 msgid "B<Pre-Depends>"
13482 msgstr ""
13484 #. type: =item
13485 #: dpkg-query.pod
13486 msgid "B<Priority>"
13487 msgstr ""
13489 #. type: =item
13490 #: dpkg-query.pod
13491 msgid "B<Provides>"
13492 msgstr ""
13494 #. type: =item
13495 #: dpkg-query.pod
13496 msgid "B<Recommends>"
13497 msgstr ""
13499 #. type: =item
13500 #: dpkg-query.pod
13501 msgid "B<Replaces>"
13502 msgstr ""
13504 #. type: =item
13505 #: dpkg-query.pod
13506 msgid "B<Revision> (obsolete)"
13507 msgstr ""
13509 #. type: =item
13510 #: dpkg-query.pod
13511 msgid "B<Section>"
13512 msgstr ""
13514 #. type: =item
13515 #: dpkg-query.pod
13516 msgid "B<Size> (internal, front-end related)"
13517 msgstr ""
13519 #. type: =item
13520 #: dpkg-query.pod
13521 msgid "B<Source>"
13522 msgstr ""
13524 #. type: =item
13525 #: dpkg-query.pod
13526 msgid "B<Status> (internal)"
13527 msgstr ""
13529 #. type: =item
13530 #: dpkg-query.pod
13531 msgid "B<Suggests>"
13532 msgstr ""
13534 #. type: =item
13535 #: dpkg-query.pod
13536 msgid "B<Tag> (usually not in .deb but in repository Packages files)"
13537 msgstr ""
13539 #. type: =item
13540 #: dpkg-query.pod
13541 msgid "B<Triggers-Awaited> (internal)"
13542 msgstr ""
13544 #. type: =item
13545 #: dpkg-query.pod
13546 msgid "B<Triggers-Pending> (internal)"
13547 msgstr ""
13549 #. type: =item
13550 #: dpkg-query.pod
13551 msgid "B<Version>"
13552 msgstr ""
13554 #. type: textblock
13555 #: dpkg-query.pod
13556 msgid ""
13557 "The following are virtual fields, generated by B<dpkg-query> from values "
13558 "from other fields (note that these do not use valid names for fields in "
13559 "control files):"
13560 msgstr ""
13562 #. type: =item
13563 #: dpkg-query.pod
13564 msgid "B<binary:Package>"
13565 msgstr ""
13567 #. type: textblock
13568 #: dpkg-query.pod
13569 msgid ""
13570 "It contains the binary package name with a possible architecture qualifier "
13571 "like “libc6:amd64” (since dpkg 1.16.2).  An architecture qualifier will be "
13572 "present to make the package name unambiguous, for packages with a "
13573 "B<Multi-Arch> field with the value B<same> or with a foreign architecture, "
13574 "which is an architecture that is neither the native one nor B<all>."
13575 msgstr ""
13577 #. type: =item
13578 #: dpkg-query.pod
13579 msgid "B<binary:Synopsis>"
13580 msgstr ""
13582 #. type: textblock
13583 #: dpkg-query.pod
13584 msgid "It contains the package short description (since dpkg 1.19.1)."
13585 msgstr ""
13587 #. type: =item
13588 #: dpkg-query.pod
13589 msgid "B<binary:Summary>"
13590 msgstr ""
13592 #. type: textblock
13593 #: dpkg-query.pod
13594 msgid "This is an alias for B<binary:Synopsis> (since dpkg 1.16.2)."
13595 msgstr ""
13597 #. type: =item
13598 #: dpkg-query.pod
13599 msgid "B<db:Status-Abbrev>"
13600 msgstr ""
13602 #. type: textblock
13603 #: dpkg-query.pod
13604 msgid ""
13605 "It contains the abbreviated package status (as three characters), such as "
13606 "“ii ” or “iHR” (since dpkg 1.16.2).  See the B<--list> command description "
13607 "for more details."
13608 msgstr ""
13610 #. type: =item
13611 #: dpkg-query.pod
13612 msgid "B<db:Status-Want>"
13613 msgstr ""
13615 #. type: textblock
13616 #: dpkg-query.pod
13617 msgid ""
13618 "It contains the package wanted status, part of the Status field (since dpkg "
13619 "1.17.11)."
13620 msgstr ""
13622 #. type: =item
13623 #: dpkg-query.pod
13624 msgid "B<db:Status-Status>"
13625 msgstr ""
13627 #. type: textblock
13628 #: dpkg-query.pod
13629 msgid ""
13630 "It contains the package status word, part of the Status field (since dpkg "
13631 "1.17.11)."
13632 msgstr ""
13634 #. type: =item
13635 #: dpkg-query.pod
13636 msgid "B<db:Status-Eflag>"
13637 msgstr ""
13639 #. type: textblock
13640 #: dpkg-query.pod
13641 msgid ""
13642 "It contains the package status error flag, part of the Status field (since "
13643 "dpkg 1.17.11)."
13644 msgstr ""
13646 #. type: =item
13647 #: dpkg-query.pod
13648 msgid "B<db-fsys:Files>"
13649 msgstr ""
13651 #. type: textblock
13652 #: dpkg-query.pod
13653 msgid ""
13654 "It contains the list of the package filesystem entries separated by newlines "
13655 "(since dpkg 1.19.3)."
13656 msgstr ""
13658 #. type: =item
13659 #: dpkg-query.pod
13660 msgid "B<db-fsys:Last-Modified>"
13661 msgstr ""
13663 #. type: textblock
13664 #: dpkg-query.pod
13665 msgid ""
13666 "It contains the timestamp in seconds of the last time the package filesystem "
13667 "entries were modified (since dpkg 1.19.3)."
13668 msgstr ""
13670 #. type: =item
13671 #: dpkg-query.pod
13672 msgid "B<source:Package>"
13673 msgstr ""
13675 #. type: textblock
13676 #: dpkg-query.pod
13677 msgid ""
13678 "It contains the source package name for this binary package (since dpkg "
13679 "1.16.2)."
13680 msgstr ""
13682 #. type: textblock
13683 #: dpkg-query.pod
13684 msgid ""
13685 "It contains the source package version for this binary package (since dpkg "
13686 "1.16.2)"
13687 msgstr ""
13689 #. type: textblock
13690 #: dpkg-query.pod
13691 msgid ""
13692 "It contains the source package upstream version for this binary package "
13693 "(since dpkg 1.18.16)"
13694 msgstr ""
13696 #. type: textblock
13697 #: dpkg-query.pod
13698 msgid ""
13699 "The default format string is “B<${binary:Package}\\t${Version}\\n>”.  "
13700 "Actually, all other fields found in the status file (i.e. user defined "
13701 "fields) can be requested, too. They will be printed as-is, though, no "
13702 "conversion nor error checking is done on them. To get the name of the "
13703 "B<dpkg> maintainer and the installed version, you could run:"
13704 msgstr ""
13706 #. type: verbatim
13707 #: dpkg-query.pod
13708 #, no-wrap
13709 msgid ""
13710 " dpkg-query -f='${binary:Package} ${Version}\\t${Maintainer}\\n' \\\n"
13711 "  -W dpkg\n"
13712 "\n"
13713 msgstr ""
13715 #. type: textblock
13716 #: dpkg-query.pod
13717 msgid "The requested query was successfully performed."
13718 msgstr ""
13720 #. type: =item
13721 #: dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
13722 #: dpkg.pod start-stop-daemon.pod
13723 msgid "B<1>"
13724 msgstr ""
13726 #. type: textblock
13727 #: dpkg-query.pod
13728 msgid ""
13729 "The requested query failed either fully or partially, due to no file or "
13730 "package being found (except for B<--control-path>, B<--control-list> and "
13731 "B<--control-show> were such errors are fatal)."
13732 msgstr ""
13734 #. type: =item
13735 #: dpkg-query.pod dpkg.pod
13736 msgid "B<SHELL>"
13737 msgstr ""
13739 #. type: textblock
13740 #: dpkg-query.pod
13741 msgid ""
13742 "Sets the program to execute when spawning a command via a shell (since dpkg "
13743 "1.19.2)."
13744 msgstr ""
13746 #. type: =item
13747 #: dpkg-query.pod dpkg.pod
13748 msgid "B<PAGER>"
13749 msgstr ""
13751 #. type: =item
13752 #: dpkg-query.pod dpkg.pod
13753 msgid "B<DPKG_PAGER>"
13754 msgstr ""
13756 #. type: textblock
13757 #: dpkg-query.pod
13758 msgid ""
13759 "Sets the pager command to use (since dpkg 1.19.1), which will be executed "
13760 "with «B<$SHELL -c>».  If B<SHELL> is not set, «B<sh>» will be used instead.  "
13761 "The B<DPKG_PAGER> overrides the B<PAGER> environment variable (since dpkg "
13762 "1.19.2)."
13763 msgstr ""
13765 #. type: textblock
13766 #: dpkg-query.pod dpkg-trigger.pod
13767 msgid ""
13768 "If set and the B<--root> option has not been specified, it will be used as "
13769 "the filesystem root directory (since dpkg 1.21.0)."
13770 msgstr ""
13772 #. type: textblock
13773 #: dpkg-query.pod dpkg-trigger.pod
13774 msgid ""
13775 "If set and the B<--admindir> option has not been specified, it will be used "
13776 "as the B<dpkg> data directory."
13777 msgstr ""
13779 #. type: =item
13780 #: dpkg-query.pod dpkg.pod
13781 msgid "B<LESS>"
13782 msgstr ""
13784 #. type: textblock
13785 #: dpkg-query.pod
13786 msgid ""
13787 "Defined by B<dpkg-query> to “B<-FRSXMQ>”, if not already set, when spawning "
13788 "a pager (since dpkg 1.19.2).  To change the default behavior, this variable "
13789 "can be preset to some other value including an empty string, or the B<PAGER> "
13790 "or B<DPKG_PAGER> variables can be set to disable specific options with "
13791 "«B<-+>», for example B<DPKG_PAGER=\"less -+F\">."
13792 msgstr ""
13794 #. type: textblock
13795 #: dpkg-realpath.pod
13796 msgid "dpkg-realpath - print the resolved pathname with DPKG_ROOT support"
13797 msgstr ""
13799 #. type: textblock
13800 #: dpkg-realpath.pod
13801 msgid "B<dpkg-realpath> [I<option>...] I<pathname>"
13802 msgstr ""
13804 #. type: textblock
13805 #: dpkg-realpath.pod
13806 msgid ""
13807 "B<dpkg-realpath> is a tool (since dpkg 1.20.1) to resolve a pathname, that "
13808 "takes the L<dpkg(1)> root directory into account, either implicitly from the "
13809 "B<DPKG_ROOT> environment variable or from the command-line B<--root> or "
13810 "B<--instdir> options, and returns an absolute I<pathname> relative to the "
13811 "root directory.  The root directory must not be prefixed to the I<pathname> "
13812 "to be resolved."
13813 msgstr ""
13815 #. type: textblock
13816 #: dpkg-realpath.pod
13817 msgid ""
13818 "This is intended to be used by other B<dpkg> helpers, or by maintainer "
13819 "scripts instead of using L<realpath(1)> or L<readlink(1)> to canonicalize "
13820 "pathnames, as these latter commands do not support canonicalization relative "
13821 "to a different root than F</>."
13822 msgstr ""
13824 #. type: =item
13825 #: dpkg-realpath.pod
13826 msgid "B<-z>, B<--zero>"
13827 msgstr ""
13829 #. type: textblock
13830 #: dpkg-realpath.pod
13831 msgid ""
13832 "Use a NUL byte to end output lines instead of a new line character (since "
13833 "dpkg 1.20.6)."
13834 msgstr ""
13836 #. type: textblock
13837 #: dpkg-realpath.pod
13838 msgid ""
13839 "Set the root directory to I<directory>, which is the base directory that "
13840 "pathnames get canonicalized against.  Defaults to «B</>» if B<DPKG_ROOT> has "
13841 "not been set."
13842 msgstr ""
13844 #. type: textblock
13845 #: dpkg-realpath.pod update-alternatives.pod
13846 msgid ""
13847 "If set and the B<--instdir> or B<--root> options have not been specified, it "
13848 "will be used as the filesystem root directory."
13849 msgstr ""
13851 #. type: textblock
13852 #: dpkg-realpath.pod
13853 msgid ""
13854 "Sets the color mode.  The currently accepted values are: B<auto> (default), "
13855 "B<always> and B<never>."
13856 msgstr ""
13858 #. type: textblock
13859 #: dpkg-realpath.pod
13860 msgid "L<realpath(1)>, L<readlink(1)>."
13861 msgstr ""
13863 #. type: textblock
13864 #: dpkg-scanpackages.pod
13865 msgid "dpkg-scanpackages - create Packages index files"
13866 msgstr ""
13868 #. type: textblock
13869 #: dpkg-scanpackages.pod
13870 msgid ""
13871 "B<dpkg-scanpackages> [I<option>...] I<binary-path> [I<override-file> "
13872 "[I<path-prefix>]] B<E<gt>> I<Packages>"
13873 msgstr ""
13875 #. type: textblock
13876 #: dpkg-scanpackages.pod
13877 msgid ""
13878 "B<dpkg-scanpackages> sorts through a tree of Debian binary packages and "
13879 "creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the "
13880 "user what packages are available for installation. These Packages files are "
13881 "the same as those found on Debian archive sites and CD-ROMs. You might use "
13882 "B<dpkg-scanpackages> yourself if making a directory of local packages to "
13883 "install on a cluster of machines."
13884 msgstr ""
13886 #. type: textblock
13887 #: dpkg-scanpackages.pod
13888 msgid ""
13889 "B<Note:> If you want to access the generated Packages file with B<apt>(8)  "
13890 "you will probably need to compress the file with B<xz>(1)  (generating a "
13891 "Packages.xz file), B<bzip2>(1)  (generating a Packages.bz2 file) or "
13892 "B<gzip>(1)  (generating a Packages.gz file).  B<apt>(8)  ignores "
13893 "uncompressed Packages files except on local access (i.e.  B<file://> "
13894 "sources)."
13895 msgstr ""
13897 #. type: textblock
13898 #: dpkg-scanpackages.pod
13899 msgid ""
13900 "I<binary-path> is the name of the tree of the binary packages to process "
13901 "(for example, B<contrib/binary-i386>).  It is best to make this relative to "
13902 "the root of the Debian archive, because every Filename field in the new "
13903 "Packages file will start with this string."
13904 msgstr ""
13906 #. type: textblock
13907 #: dpkg-scanpackages.pod
13908 msgid ""
13909 "I<override-file> is the name of a file to read which contains information "
13910 "about how the package fits into the distribution (the file can be compressed "
13911 "since dpkg 1.15.5); see B<deb-override>(5)."
13912 msgstr ""
13914 #. type: textblock
13915 #: dpkg-scanpackages.pod
13916 msgid "I<path-prefix> is an optional string to be prepended to the Filename fields."
13917 msgstr ""
13919 #. type: textblock
13920 #: dpkg-scanpackages.pod
13921 msgid ""
13922 "If more than one version of a package is found only the newest one is "
13923 "included in the output. If they have the same version and only differ in "
13924 "architecture only the first one found is used."
13925 msgstr ""
13927 #. type: =item
13928 #: dpkg-scanpackages.pod
13929 msgid "B<-t>, B<--type> I<type>"
13930 msgstr ""
13932 #. type: textblock
13933 #: dpkg-scanpackages.pod
13934 msgid "Scan for *.I<type> packages, instead of *.deb."
13935 msgstr ""
13937 #. type: =item
13938 #: dpkg-scanpackages.pod dpkg-scansources.pod
13939 msgid "B<-e>, B<--extra-override> I<file>"
13940 msgstr ""
13942 #. type: textblock
13943 #: dpkg-scanpackages.pod
13944 msgid ""
13945 "Scan I<file> to find supplementary overrides (the file can be compressed "
13946 "since dpkg 1.15.5).  See B<deb-extra-override>(5)  for more information on "
13947 "its format."
13948 msgstr ""
13950 #. type: =item
13951 #: dpkg-scanpackages.pod
13952 msgid "B<-a>, B<--arch> I<arch>"
13953 msgstr ""
13955 #. type: textblock
13956 #: dpkg-scanpackages.pod
13957 msgid ""
13958 "Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of "
13959 "scanning for all debs."
13960 msgstr ""
13962 #. type: =item
13963 #: dpkg-scanpackages.pod
13964 msgid "B<-h>, B<--hash> I<hash-list>"
13965 msgstr ""
13967 #. type: textblock
13968 #: dpkg-scanpackages.pod
13969 msgid ""
13970 "Only generate file hashes for the comma-specified list specified (since dpkg "
13971 "1.17.14).  The default is to generate all currently supported hashes.  "
13972 "Supported values: B<md5>, B<sha1>, B<sha256>."
13973 msgstr ""
13975 #. type: =item
13976 #: dpkg-scanpackages.pod
13977 msgid "B<-m>, B<--multiversion>"
13978 msgstr ""
13980 #. type: textblock
13981 #: dpkg-scanpackages.pod
13982 msgid "Include all found packages in the output."
13983 msgstr ""
13985 #. type: =item
13986 #: dpkg-scanpackages.pod
13987 msgid "B<-M>, B<--medium> I<id-string>"
13988 msgstr ""
13990 #. type: textblock
13991 #: dpkg-scanpackages.pod
13992 msgid ""
13993 "Add an B<X-Medium> field containing the value I<id-string> (since dpkg "
13994 "1.15.5).  This field is required if you want to generate B<Packages.cd> "
13995 "files for use by the B<media> access method of B<dselect>."
13996 msgstr ""
13998 #. type: =head1
13999 #: dpkg-scanpackages.pod dpkg-shlibdeps.pod dpkg-source.pod
14000 #: update-alternatives.pod
14001 msgid "DIAGNOSTICS"
14002 msgstr ""
14004 #. type: textblock
14005 #: dpkg-scanpackages.pod
14006 msgid ""
14007 "B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also "
14008 "warns about packages that are in the wrong subdirectory, are duplicated, "
14009 "have a Filename field in their control file, are missing from the override "
14010 "file, or have maintainer substitutions which do not take effect."
14011 msgstr ""
14013 #. type: textblock
14014 #: dpkg-scanpackages.pod
14015 msgid ""
14016 "B<dpkg>(1), B<dselect>(1), B<deb-override>(5), B<deb-extra-override>(5), "
14017 "B<dpkg-scansources>(1)."
14018 msgstr ""
14020 #. type: textblock
14021 #: dpkg-scansources.pod
14022 msgid "dpkg-scansources - create Sources index files"
14023 msgstr ""
14025 #. type: textblock
14026 #: dpkg-scansources.pod
14027 msgid ""
14028 "B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> "
14029 "[I<path-prefix>]] B<E<gt>> I<Sources>"
14030 msgstr ""
14032 #. type: textblock
14033 #: dpkg-scansources.pod
14034 msgid ""
14035 "B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files.  These "
14036 "are used to create a Debian source index, which is output to stdout."
14037 msgstr ""
14039 #. type: textblock
14040 #: dpkg-scansources.pod
14041 msgid ""
14042 "The I<override-file>, if given, is used to set priorities in the resulting "
14043 "index stanzas and to override the maintainer field given in the I<.dsc> "
14044 "files.  The file can be compressed (since dpkg 1.15.5).  See "
14045 "B<deb-override>(5)  for the format of this file."
14046 msgstr ""
14048 #. type: textblock
14049 #: dpkg-scansources.pod
14050 msgid ""
14051 "B<Note:> Since the override file is indexed by binary, not source packages, "
14052 "there's a bit of a problem here. The current implementation uses the highest "
14053 "priority of all the binary packages produced by a I<.dsc> file for the "
14054 "priority of the source package, and the override entry for the first binary "
14055 "package listed in the I<.dsc> file to modify maintainer information. This "
14056 "might change."
14057 msgstr ""
14059 #. type: textblock
14060 #: dpkg-scansources.pod
14061 msgid ""
14062 "The I<path-prefix>, if given, is prepended to the directory field in the "
14063 "generated source index. You generally use this to make the directory fields "
14064 "contain the path from the top of the Debian archive hierarchy."
14065 msgstr ""
14067 #. type: textblock
14068 #: dpkg-scansources.pod
14069 msgid ""
14070 "B<Note:> If you want to access the generated Sources file with B<apt>(8)  "
14071 "you will probably need to compress the file with B<gzip>(1)  (generating a "
14072 "Sources.gz file).  B<apt>(8)  ignores uncompressed Sources files except on "
14073 "local access (i.e.  B<file://> sources)."
14074 msgstr ""
14076 #. type: =item
14077 #: dpkg-scansources.pod
14078 msgid "B<-n>, B<--no-sort>"
14079 msgstr ""
14081 #. type: textblock
14082 #: dpkg-scansources.pod
14083 msgid ""
14084 "Do not sort the index stanzas.  Normally they are sorted by source package "
14085 "name."
14086 msgstr ""
14088 #. type: textblock
14089 #: dpkg-scansources.pod
14090 msgid ""
14091 "Scan I<file> to find supplementary overrides (since dpkg 1.15.4; the file "
14092 "can be compressed since dpkg 1.15.5).  See B<deb-extra-override>(5)  for "
14093 "more information on its format."
14094 msgstr ""
14096 #. type: =item
14097 #: dpkg-scansources.pod
14098 msgid "B<-s>, B<--source-override> I<file>"
14099 msgstr ""
14101 #. type: textblock
14102 #: dpkg-scansources.pod
14103 msgid ""
14104 "Use I<file> as the source override file (the file can be compressed since "
14105 "dpkg 1.15.5).  The default is the name of the override file you specified "
14106 "with I<.src> appended."
14107 msgstr ""
14109 #. type: textblock
14110 #: dpkg-scansources.pod
14111 msgid ""
14112 "The source override file is in a different format from the binary override "
14113 "file. It contains only two whitespace separated fields, the first is the "
14114 "source package name and the second is the section. Blank lines and comment "
14115 "lines are ignored in the normal manner. If a package appears in both files "
14116 "the source override takes precedence for setting the section."
14117 msgstr ""
14119 #. type: =item
14120 #: dpkg-scansources.pod update-alternatives.pod
14121 msgid "B<--debug>"
14122 msgstr ""
14124 #. type: textblock
14125 #: dpkg-scansources.pod
14126 msgid "Turn debugging on."
14127 msgstr ""
14129 #. type: textblock
14130 #: dpkg-scansources.pod
14131 msgid "B<deb-override>(5), B<deb-extra-override>(5), B<dpkg-scanpackages>(1)."
14132 msgstr ""
14134 #. type: textblock
14135 #: dpkg-shlibdeps.pod
14136 msgid "dpkg-shlibdeps - generate shared library substvar dependencies"
14137 msgstr ""
14139 #. type: textblock
14140 #: dpkg-shlibdeps.pod
14141 msgid "B<dpkg-shlibdeps> [I<option>...] [B<-e>] I<executable> [I<option>...]"
14142 msgstr ""
14144 #. type: textblock
14145 #: dpkg-shlibdeps.pod
14146 msgid ""
14147 "B<dpkg-shlibdeps> calculates shared library dependencies for executables "
14148 "named in its arguments. The dependencies are added to the substitution "
14149 "variables file B<debian/substvars> as variable names "
14150 "B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency "
14151 "field name. Any other variables starting with B<shlibs:> are removed from "
14152 "the file."
14153 msgstr ""
14155 #. type: textblock
14156 #: dpkg-shlibdeps.pod
14157 msgid ""
14158 "B<dpkg-shlibdeps> has two possible sources of information to generate "
14159 "dependency information. Either I<symbols> files or I<shlibs> files. For each "
14160 "binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries "
14161 "that it's linked with.  Then, for each library, it looks up either the "
14162 "I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if "
14163 "debian/shlibs.local contains the relevant dependency). Both files are "
14164 "supposed to be provided by the library package and should thus be available "
14165 "as %ADMINDIR%/info/I<package>.I<symbols> or "
14166 "%ADMINDIR%/info/I<package>.I<shlibs>. The package name is identified in two "
14167 "steps: find the library file on the system (looking in the same directories "
14168 "that B<ld.so> would use), then use B<dpkg -S> I<library-file> to lookup the "
14169 "package providing the library."
14170 msgstr ""
14172 #. type: =head2
14173 #: dpkg-shlibdeps.pod
14174 msgid "Symbols files"
14175 msgstr ""
14177 #. type: textblock
14178 #: dpkg-shlibdeps.pod
14179 msgid ""
14180 "Symbols files contain finer-grained dependency information by providing the "
14181 "minimum dependency for each symbol that the library exports. The script "
14182 "tries to find a symbols file associated to a library package in the "
14183 "following places (first match is used):"
14184 msgstr ""
14186 #. type: =item
14187 #: dpkg-shlibdeps.pod
14188 msgid "debian/*/DEBIAN/symbols"
14189 msgstr ""
14191 #. type: textblock
14192 #: dpkg-shlibdeps.pod
14193 msgid ""
14194 "Shared library information generated by the current build process that also "
14195 "invoked B<dpkg-shlibdeps>.  They are generated by B<dpkg-gensymbols>(1).  "
14196 "They are only used if the library is found in a package's build tree. The "
14197 "symbols file in that build tree takes precedence over symbols files from "
14198 "other binary packages."
14199 msgstr ""
14201 #. type: =item
14202 #: dpkg-shlibdeps.pod
14203 msgid "%PKGCONFDIR%/symbols/I<package>.symbols.I<arch>"
14204 msgstr ""
14206 #. type: =item
14207 #: dpkg-shlibdeps.pod
14208 msgid "%PKGCONFDIR%/symbols/I<package>.symbols"
14209 msgstr ""
14211 #. type: textblock
14212 #: dpkg-shlibdeps.pod
14213 msgid ""
14214 "Per-system overriding shared library dependency information.  I<arch> is the "
14215 "architecture of the current system (obtained by B<dpkg-architecture "
14216 "-qDEB_HOST_ARCH>)."
14217 msgstr ""
14219 #. type: =item
14220 #: dpkg-shlibdeps.pod
14221 msgid "Output from “B<dpkg-query --control-path> I<package> symbols”"
14222 msgstr ""
14224 #. type: textblock
14225 #: dpkg-shlibdeps.pod
14226 msgid ""
14227 "Package-provided shared library dependency information.  Unless overridden "
14228 "by B<--admindir>, those files are located in %ADMINDIR%."
14229 msgstr ""
14231 #. type: textblock
14232 #: dpkg-shlibdeps.pod
14233 msgid ""
14234 "While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers "
14235 "the (biggest) minimal version needed for each library. At the end of the "
14236 "process, it is able to write out the minimal dependency for every library "
14237 "used (provided that the information of the I<symbols> files are accurate)."
14238 msgstr ""
14240 #. type: textblock
14241 #: dpkg-shlibdeps.pod
14242 msgid ""
14243 "As a safe-guard measure, a symbols file can provide a "
14244 "B<Build-Depends-Package> meta-information field and B<dpkg-shlibdeps> will "
14245 "extract the minimal version required by the corresponding package in the "
14246 "B<Build-Depends> field and use this version if it's higher than the minimal "
14247 "version computed by scanning symbols."
14248 msgstr ""
14250 #. type: =head2
14251 #: dpkg-shlibdeps.pod
14252 msgid "Shlibs files"
14253 msgstr ""
14255 #. type: textblock
14256 #: dpkg-shlibdeps.pod
14257 msgid ""
14258 "Shlibs files associate directly a library to a dependency (without looking "
14259 "at the symbols). It's thus often stronger than really needed but very safe "
14260 "and easy to handle."
14261 msgstr ""
14263 #. type: textblock
14264 #: dpkg-shlibdeps.pod
14265 msgid ""
14266 "The dependencies for a library are looked up in several places. The first "
14267 "file providing information for the library of interest is used:"
14268 msgstr ""
14270 #. type: =item
14271 #: dpkg-shlibdeps.pod
14272 msgid "debian/shlibs.local"
14273 msgstr ""
14275 #. type: textblock
14276 #: dpkg-shlibdeps.pod
14277 msgid "Package-local overriding shared library dependency information."
14278 msgstr ""
14280 #. type: =item
14281 #: dpkg-shlibdeps.pod
14282 msgid "%PKGCONFDIR%/shlibs.override"
14283 msgstr ""
14285 #. type: textblock
14286 #: dpkg-shlibdeps.pod
14287 msgid "Per-system overriding shared library dependency information."
14288 msgstr ""
14290 #. type: =item
14291 #: dpkg-shlibdeps.pod
14292 msgid "debian/*/DEBIAN/shlibs"
14293 msgstr ""
14295 #. type: textblock
14296 #: dpkg-shlibdeps.pod
14297 msgid ""
14298 "Shared library information generated by the current build process that also "
14299 "invoked B<dpkg-shlibdeps>.  They are only used if the library is found in a "
14300 "package's build tree. The shlibs file in that build tree takes precedence "
14301 "over shlibs files from other binary packages."
14302 msgstr ""
14304 #. type: =item
14305 #: dpkg-shlibdeps.pod
14306 msgid "Output from “B<dpkg-query --control-path> I<package> shlibs”"
14307 msgstr ""
14309 #. type: =item
14310 #: dpkg-shlibdeps.pod
14311 msgid "%PKGCONFDIR%/shlibs.default"
14312 msgstr ""
14314 #. type: textblock
14315 #: dpkg-shlibdeps.pod
14316 msgid "Per-system default shared library dependency information."
14317 msgstr ""
14319 #. type: textblock
14320 #: dpkg-shlibdeps.pod
14321 msgid ""
14322 "The extracted dependencies are then directly used (except if they are "
14323 "filtered out because they have been identified as duplicate, or as weaker "
14324 "than another dependency)."
14325 msgstr ""
14327 #. type: textblock
14328 #: dpkg-shlibdeps.pod
14329 msgid ""
14330 "B<dpkg-shlibdeps> interprets non-option arguments as executable names, just "
14331 "as if they'd been supplied as B<-e>I<executable>."
14332 msgstr ""
14334 #. type: =item
14335 #: dpkg-shlibdeps.pod
14336 msgid "B<-e>I<executable>"
14337 msgstr ""
14339 #. type: textblock
14340 #: dpkg-shlibdeps.pod
14341 msgid ""
14342 "Include dependencies appropriate for the shared libraries required by "
14343 "I<executable>.  This option can be used multiple times."
14344 msgstr ""
14346 #. type: textblock
14347 #: dpkg-shlibdeps.pod
14348 msgid ""
14349 "Prepend I<directory> to the list of directories to search for private shared "
14350 "libraries (since dpkg 1.17.0). This option can be used multiple times."
14351 msgstr ""
14353 #. type: =item
14354 #: dpkg-shlibdeps.pod
14355 msgid "B<-d>I<dependency-field>"
14356 msgstr ""
14358 #. type: textblock
14359 #: dpkg-shlibdeps.pod
14360 msgid ""
14361 "Add dependencies to be added to the control file dependency field "
14362 "I<dependency-field>.  (The dependencies for this field are placed in the "
14363 "variable B<shlibs:>I<dependency-field>.)"
14364 msgstr ""
14366 #. type: textblock
14367 #: dpkg-shlibdeps.pod
14368 msgid ""
14369 "The B<-d>I<dependency-field> option takes effect for all executables after "
14370 "the option, until the next B<-d>I<dependency-field>.  The default "
14371 "I<dependency-field> is B<Depends>."
14372 msgstr ""
14374 #. type: textblock
14375 #: dpkg-shlibdeps.pod
14376 msgid ""
14377 "If the same dependency entry (or set of alternatives) appears in more than "
14378 "one of the recognized dependency field names B<Pre-Depends>, B<Depends>, "
14379 "B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will "
14380 "automatically remove the dependency from all fields except the one "
14381 "representing the most important dependencies."
14382 msgstr ""
14384 #. type: =item
14385 #: dpkg-shlibdeps.pod
14386 msgid "B<-p>I<varname-prefix>"
14387 msgstr ""
14389 #. type: textblock
14390 #: dpkg-shlibdeps.pod
14391 msgid ""
14392 "Start substitution variables with I<varname-prefix>B<:> instead of "
14393 "B<shlibs:>.  Likewise, any existing substitution variables starting with "
14394 "I<varname-prefix>B<:> (rather than B<shlibs:>)  are removed from the "
14395 "substitution variables file."
14396 msgstr ""
14398 #. type: textblock
14399 #: dpkg-shlibdeps.pod
14400 msgid ""
14401 "Print substitution variable settings to standard output (or I<filename> if "
14402 "specified, since dpkg 1.17.2), rather than being added to the substitution "
14403 "variables file (B<debian/substvars> by default)."
14404 msgstr ""
14406 #. type: =item
14407 #: dpkg-shlibdeps.pod
14408 msgid "B<-t>I<type>"
14409 msgstr ""
14411 #. type: textblock
14412 #: dpkg-shlibdeps.pod
14413 msgid ""
14414 "Prefer shared library dependency information tagged for the given package "
14415 "type. If no tagged information is available, falls back to untagged "
14416 "information. The default package type is B<deb>. Shared library dependency "
14417 "information is tagged for a given type by prefixing it with the name of the "
14418 "type, a colon, and whitespace."
14419 msgstr ""
14421 #. type: =item
14422 #: dpkg-shlibdeps.pod
14423 msgid "B<-L>I<local-shlibs-file>"
14424 msgstr ""
14426 #. type: textblock
14427 #: dpkg-shlibdeps.pod
14428 msgid ""
14429 "Read overriding shared library dependency information from "
14430 "I<local-shlibs-file> instead of B<debian/shlibs.local>."
14431 msgstr ""
14433 #. type: textblock
14434 #: dpkg-shlibdeps.pod
14435 msgid ""
14436 "Write substitution variables in I<substvars-file>; the default is "
14437 "B<debian/substvars>."
14438 msgstr ""
14440 #. type: =item
14441 #: dpkg-shlibdeps.pod
14442 msgid "B<-v>"
14443 msgstr ""
14445 #. type: textblock
14446 #: dpkg-shlibdeps.pod
14447 msgid ""
14448 "Enable verbose mode (since dpkg 1.14.8).  Numerous messages are displayed to "
14449 "explain what B<dpkg-shlibdeps> does."
14450 msgstr ""
14452 #. type: =item
14453 #: dpkg-shlibdeps.pod
14454 msgid "B<-x>I<package>"
14455 msgstr ""
14457 #. type: textblock
14458 #: dpkg-shlibdeps.pod
14459 msgid ""
14460 "Exclude the package from the generated dependencies (since dpkg 1.14.8).  "
14461 "This is useful to avoid self-dependencies for packages which provide ELF "
14462 "binaries (executables or library plugins) using a library contained in the "
14463 "same package. This option can be used multiple times to exclude several "
14464 "packages."
14465 msgstr ""
14467 #. type: =item
14468 #: dpkg-shlibdeps.pod
14469 msgid "B<-S>I<package-build-dir>"
14470 msgstr ""
14472 #. type: textblock
14473 #: dpkg-shlibdeps.pod
14474 msgid ""
14475 "Look into I<package-build-dir> first when trying to find a library (since "
14476 "dpkg 1.14.15).  This is useful when the source package builds multiple "
14477 "flavors of the same library and you want to ensure that you get the "
14478 "dependency from a given binary package. You can use this option multiple "
14479 "times: directories will be tried in the same order before directories of "
14480 "other binary packages."
14481 msgstr ""
14483 #. type: =item
14484 #: dpkg-shlibdeps.pod
14485 msgid "B<-I>I<package-build-dir>"
14486 msgstr ""
14488 #. type: textblock
14489 #: dpkg-shlibdeps.pod
14490 msgid ""
14491 "Ignore I<package-build-dir> when looking for shlibs, symbols, and shared "
14492 "library files (since dpkg 1.18.5).  You can use this option multiple times."
14493 msgstr ""
14495 #. type: =item
14496 #: dpkg-shlibdeps.pod
14497 msgid "B<--ignore-missing-info>"
14498 msgstr ""
14500 #. type: textblock
14501 #: dpkg-shlibdeps.pod
14502 msgid ""
14503 "Do not fail if dependency information can't be found for a shared library "
14504 "(since dpkg 1.14.8).  Usage of this option is discouraged, all libraries "
14505 "should provide dependency information (either with shlibs files, or with "
14506 "symbols files)  even if they are not yet used by other packages."
14507 msgstr ""
14509 #. type: =item
14510 #: dpkg-shlibdeps.pod
14511 msgid "B<--warnings=>I<value>"
14512 msgstr ""
14514 #. type: textblock
14515 #: dpkg-shlibdeps.pod
14516 msgid ""
14517 "I<value> is a bit field defining the set of warnings that can be emitted by "
14518 "B<dpkg-shlibdeps> (since dpkg 1.14.17).  Bit 0 (value=1) enables the warning "
14519 "“symbol I<sym> used by I<binary> found in none of the libraries”, bit 1 "
14520 "(value=2) enables the warning “package could avoid a useless dependency” and "
14521 "bit 2 (value=4) enables the warning “I<binary> should not be linked against "
14522 "I<library>”.  The default I<value> is 3: the first two warnings are active "
14523 "by default, the last one is not. Set I<value> to 7 if you want all warnings "
14524 "to be active."
14525 msgstr ""
14527 #. type: =head2
14528 #: dpkg-shlibdeps.pod
14529 msgid "Warnings"
14530 msgstr ""
14532 #. type: textblock
14533 #: dpkg-shlibdeps.pod
14534 msgid ""
14535 "Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of "
14536 "the generated package, it is able to emit warnings in several cases. They "
14537 "inform you of things that can be improved in the package. In most cases, "
14538 "those improvements concern the upstream sources directly. By order of "
14539 "decreasing importance, here are the various warnings that you can encounter:"
14540 msgstr ""
14542 #. type: =item
14543 #: dpkg-shlibdeps.pod
14544 msgid "B<symbol> I<sym> B<used by> I<binary> B<found in none of the libraries.>"
14545 msgstr ""
14547 #. type: textblock
14548 #: dpkg-shlibdeps.pod
14549 msgid ""
14550 "The indicated symbol has not been found in the libraries linked with the "
14551 "binary. The I<binary> is most likely a library and it needs to be linked "
14552 "with an additional library during the build process (option B<-l>I<library> "
14553 "of the linker)."
14554 msgstr ""
14556 #. type: =item
14557 #: dpkg-shlibdeps.pod
14558 msgid ""
14559 "I<binary> B<contains an unresolvable reference to symbol> I<sym>B<: it's "
14560 "probably a plugin>"
14561 msgstr ""
14563 #. type: textblock
14564 #: dpkg-shlibdeps.pod
14565 msgid ""
14566 "The indicated symbol has not been found in the libraries linked with the "
14567 "binary. The I<binary> is most likely a plugin and the symbol is probably "
14568 "provided by the program that loads this plugin. In theory a plugin doesn't "
14569 "have any SONAME but this binary does have one and as such it could not be "
14570 "clearly identified as such. However the fact that the binary is stored in a "
14571 "non-public directory is a strong indication that's it's not a normal shared "
14572 "library. If the binary is really a plugin, then disregard this warning. But "
14573 "there's always the possibility that it's a real library and that programs "
14574 "linking to it are using an RPATH so that the dynamic loader finds it. In "
14575 "that case, the library is broken and needs to be fixed."
14576 msgstr ""
14578 #. type: =item
14579 #: dpkg-shlibdeps.pod
14580 msgid ""
14581 "B<package could avoid a useless dependency if> I<binary> B<was not linked "
14582 "against> I<library> B<(it uses none of the library's symbols)>"
14583 msgstr ""
14585 #. type: textblock
14586 #: dpkg-shlibdeps.pod
14587 msgid ""
14588 "None of the I<binaries> that are linked with I<library> use any of the "
14589 "symbols provided by the library. By fixing all the binaries, you would avoid "
14590 "the dependency associated to this library (unless the same dependency is "
14591 "also generated by another library that is really used)."
14592 msgstr ""
14594 #. type: =item
14595 #: dpkg-shlibdeps.pod
14596 msgid ""
14597 "B<package could avoid a useless dependency if> I<binaries> B<were not linked "
14598 "against> I<library> B<(they use none of the library's symbols)>"
14599 msgstr ""
14601 #. type: textblock
14602 #: dpkg-shlibdeps.pod
14603 msgid "Exactly the same as the above warning, but for multiple binaries."
14604 msgstr ""
14606 #. type: =item
14607 #: dpkg-shlibdeps.pod
14608 msgid ""
14609 "I<binary> B<should not be linked against> I<library> B<(it uses none of the "
14610 "library's symbols)>"
14611 msgstr ""
14613 #. type: textblock
14614 #: dpkg-shlibdeps.pod
14615 msgid ""
14616 "The I<binary> is linked to a library that it doesn't need. It's not a "
14617 "problem but some small performance improvements in binary load time can be "
14618 "obtained by not linking this library to this binary. This warning checks the "
14619 "same information as the previous one but does it for each binary instead of "
14620 "doing the check globally on all binaries analyzed."
14621 msgstr ""
14623 #. type: =head2
14624 #: dpkg-shlibdeps.pod
14625 msgid "Errors"
14626 msgstr ""
14628 #. type: textblock
14629 #: dpkg-shlibdeps.pod
14630 msgid ""
14631 "B<dpkg-shlibdeps> will fail if it can't find a public library used by a "
14632 "binary or if this library has no associated dependency information (either "
14633 "shlibs file or symbols file). A public library has a SONAME and is versioned "
14634 "(libsomething.so.I<X>). A private library (like a plugin) should not have a "
14635 "SONAME and doesn't need to be versioned."
14636 msgstr ""
14638 #. type: =item
14639 #: dpkg-shlibdeps.pod
14640 msgid ""
14641 "B<couldn't find library> I<library-soname> B<needed by> I<binary> B<(its "
14642 "RPATH is '>I<rpath>B<')>"
14643 msgstr ""
14645 #. type: textblock
14646 #: dpkg-shlibdeps.pod
14647 msgid ""
14648 "The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> "
14649 "has been unable to find the library.  B<dpkg-shlibdeps> creates a list of "
14650 "directories to check as following: directories listed in the RPATH of the "
14651 "binary, directories added by the B<-l> option, directories listed in the "
14652 "B<LD_LIBRARY_PATH> environment variable, cross multiarch directories "
14653 "(ex. /lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), standard public "
14654 "directories (/lib, /usr/lib), directories listed in /etc/ld.so.conf, and "
14655 "obsolete multilib directories (/lib32, /usr/lib32, /lib64, /usr/lib64).  "
14656 "Then it checks those directories in the package's build tree of the binary "
14657 "being analyzed, in the packages' build trees indicated with the B<-S> "
14658 "command-line option, in other packages' build trees that contains a "
14659 "DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory.  If "
14660 "the library is not found in any of those directories, then you get this "
14661 "error."
14662 msgstr ""
14664 #. type: textblock
14665 #: dpkg-shlibdeps.pod
14666 msgid ""
14667 "If the library not found is in a private directory of the same package, then "
14668 "you want to add the directory with B<-l>. If it's in another binary package "
14669 "being built, you want to make sure that the shlibs/symbols file of this "
14670 "package is already created and that B<-l> contains the appropriate directory "
14671 "if it also is in a private directory."
14672 msgstr ""
14674 #. type: =item
14675 #: dpkg-shlibdeps.pod
14676 msgid ""
14677 "B<no dependency information found for> I<library-file> B<(used by> "
14678 "I<binary>B<).>"
14679 msgstr ""
14681 #. type: textblock
14682 #: dpkg-shlibdeps.pod
14683 msgid ""
14684 "The library needed by I<binary> has been found by B<dpkg-shlibdeps> in "
14685 "I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency "
14686 "information for that library. To find out the dependency, it has tried to "
14687 "map the library to a Debian package with the help of B<dpkg -S> "
14688 "I<library-file>.  Then it checked the corresponding shlibs and symbols files "
14689 "in %ADMINDIR%/info/, and in the various package's build trees "
14690 "(debian/*/DEBIAN/)."
14691 msgstr ""
14693 #. type: textblock
14694 #: dpkg-shlibdeps.pod
14695 msgid ""
14696 "This failure can be caused by a bad or missing shlibs or symbols file in the "
14697 "package of the library. It might also happen if the library is built within "
14698 "the same source package and if the shlibs files has not yet been created (in "
14699 "which case you must fix debian/rules to create the shlibs before calling "
14700 "B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under "
14701 "a non-canonical name (example: "
14702 "/usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of "
14703 "/usr/lib/libssl.so.0.9.8) that's not associated to any package, "
14704 "B<dpkg-shlibdeps> tries to work around this by trying to fallback on a "
14705 "canonical name (using B<realpath>(3))  but it might not always work. It's "
14706 "always best to clean up the RPATH of the binary to avoid problems."
14707 msgstr ""
14709 #. type: textblock
14710 #: dpkg-shlibdeps.pod
14711 msgid ""
14712 "Calling B<dpkg-shlibdeps> in verbose mode (B<-v>) will provide much more "
14713 "information about where it tried to find the dependency information. This "
14714 "might be useful if you don't understand why it's giving you this error."
14715 msgstr ""
14717 #. type: textblock
14718 #: dpkg-shlibdeps.pod
14719 msgid ""
14720 "B<deb-substvars>(5), B<deb-shlibs>(5), B<deb-symbols>(5), "
14721 "B<dpkg-gensymbols>(1)."
14722 msgstr ""
14724 #. type: textblock
14725 #: dpkg-source.pod
14726 msgid "dpkg-source - Debian source package (.dsc) manipulation tool"
14727 msgstr ""
14729 #. type: textblock
14730 #: dpkg-source.pod
14731 msgid "B<dpkg-source> [I<option>...] I<command>"
14732 msgstr ""
14734 #. type: textblock
14735 #: dpkg-source.pod
14736 msgid "B<dpkg-source> packs and unpacks Debian source archives."
14737 msgstr ""
14739 #. type: textblock
14740 #: dpkg-source.pod
14741 msgid ""
14742 "None of these commands allow multiple options to be combined into one, and "
14743 "they do not allow the value for an option to be specified in a separate "
14744 "argument."
14745 msgstr ""
14747 #. type: =item
14748 #: dpkg-source.pod
14749 msgid "B<-x>, B<--extract> I<filename>.dsc [I<output-directory>]"
14750 msgstr ""
14752 #. type: textblock
14753 #: dpkg-source.pod
14754 msgid ""
14755 "Extract a source package (B<--extract> since dpkg 1.17.14).  One non-option "
14756 "argument must be supplied, the name of the Debian source control file "
14757 "(B<.dsc>).  An optional second non-option argument may be supplied to "
14758 "specify the directory to extract the source package to, this must not "
14759 "exist. If no output directory is specified, the source package is extracted "
14760 "into a directory named I<source>-I<version> under the current working "
14761 "directory."
14762 msgstr ""
14764 #. type: textblock
14765 #: dpkg-source.pod
14766 msgid ""
14767 "B<dpkg-source> will read the names of the other file(s) making up the source "
14768 "package from the control file; they are assumed to be in the same directory "
14769 "as the B<.dsc>."
14770 msgstr ""
14772 #. type: textblock
14773 #: dpkg-source.pod
14774 msgid ""
14775 "The files in the extracted package will have their permissions and "
14776 "ownerships set to those which would have been expected if the files and "
14777 "directories had simply been created - directories and executable files will "
14778 "be 0777 and plain files will be 0666, both modified by the extractors' "
14779 "umask; if the parent directory is setgid then the extracted directories will "
14780 "be too, and all the files and directories will inherit its group ownership."
14781 msgstr ""
14783 #. type: textblock
14784 #: dpkg-source.pod
14785 msgid ""
14786 "If the source package uses a non-standard format (currently this means all "
14787 "formats except “1.0”), its name will be stored in B<debian/source/format> so "
14788 "that the following builds of the source package use the same format by "
14789 "default."
14790 msgstr ""
14792 #. type: =item
14793 #: dpkg-source.pod
14794 msgid "B<-b>, B<--build> I<directory> [I<format-specific-parameters>]"
14795 msgstr ""
14797 #. type: textblock
14798 #: dpkg-source.pod
14799 msgid ""
14800 "Build a source package (B<--build> since dpkg 1.17.14).  The first "
14801 "non-option argument is taken as the name of the directory containing the "
14802 "debianized source tree (i.e. with a debian sub-directory and maybe changes "
14803 "to the original files).  Depending on the source package format used to "
14804 "build the package, additional parameters might be accepted."
14805 msgstr ""
14807 #. type: textblock
14808 #: dpkg-source.pod
14809 msgid ""
14810 "B<dpkg-source> will build the source package with the first format found in "
14811 "this ordered list: the format indicated with the I<--format> command line "
14812 "option, the format indicated in B<debian/source/format>, “1.0”.  The "
14813 "fallback to “1.0” is deprecated and will be removed at some point in the "
14814 "future, you should always document the desired source format in "
14815 "B<debian/source/format>. See section B<SOURCE PACKAGE FORMATS> for an "
14816 "extensive description of the various source package formats."
14817 msgstr ""
14819 #. type: =item
14820 #: dpkg-source.pod
14821 msgid "B<--print-format> I<directory>"
14822 msgstr ""
14824 #. type: textblock
14825 #: dpkg-source.pod
14826 msgid ""
14827 "Print the source format that would be used to build the source package if "
14828 "B<dpkg-source --build> I<directory> was called (in the same conditions and "
14829 "with the same parameters; since dpkg 1.15.5)."
14830 msgstr ""
14832 #. type: =item
14833 #: dpkg-source.pod
14834 msgid "B<--before-build> I<directory>"
14835 msgstr ""
14837 #. type: textblock
14838 #: dpkg-source.pod
14839 msgid ""
14840 "Run the corresponding hook of the source package format (since dpkg "
14841 "1.15.8).  This hook is called before any build of the package "
14842 "(B<dpkg-buildpackage> calls it very early even before B<debian/rules "
14843 "clean>). This command is idempotent and can be called multiple times. Not "
14844 "all source formats implement something in this hook, and those that do "
14845 "usually prepare the source tree for the build for example by ensuring that "
14846 "the Debian patches are applied."
14847 msgstr ""
14849 #. type: =item
14850 #: dpkg-source.pod
14851 msgid "B<--after-build> I<directory>"
14852 msgstr ""
14854 #. type: textblock
14855 #: dpkg-source.pod
14856 msgid ""
14857 "Run the corresponding hook of the source package format (since dpkg "
14858 "1.15.8).  This hook is called after any build of the package "
14859 "(B<dpkg-buildpackage> calls it last). This command is idempotent and can be "
14860 "called multiple times. Not all source formats implement something in this "
14861 "hook, and those that do usually use it to undo what B<--before-build> has "
14862 "done."
14863 msgstr ""
14865 #. type: =item
14866 #: dpkg-source.pod
14867 msgid "B<--commit> [I<directory>] ..."
14868 msgstr ""
14870 #. type: textblock
14871 #: dpkg-source.pod
14872 msgid ""
14873 "Record changes in the source tree unpacked in I<directory> (since dpkg "
14874 "1.16.1).  This command can take supplementary parameters depending on the "
14875 "source format.  It will error out for formats where this operation doesn't "
14876 "mean anything."
14877 msgstr ""
14879 #. type: textblock
14880 #: dpkg-source.pod
14881 msgid ""
14882 "Show the usage message and exit.  The format specific build and extract "
14883 "options can be shown by using the B<--format> option."
14884 msgstr ""
14886 #. type: =head2
14887 #: dpkg-source.pod
14888 msgid "Generic build options"
14889 msgstr ""
14891 #. type: textblock
14892 #: dpkg-source.pod
14893 msgid ""
14894 "Specifies the main source control file to read information from. The default "
14895 "is B<debian/control>.  If given with relative pathname this is interpreted "
14896 "starting at the source tree's top level directory."
14897 msgstr ""
14899 #. type: textblock
14900 #: dpkg-source.pod
14901 msgid ""
14902 "Specifies the changelog file to read information from. The default is "
14903 "B<debian/changelog>.  If given with relative pathname this is interpreted "
14904 "starting at the source tree's top level directory."
14905 msgstr ""
14907 #. type: =item
14908 #: dpkg-source.pod
14909 msgid "B<--format=>I<value>"
14910 msgstr ""
14912 #. type: textblock
14913 #: dpkg-source.pod
14914 msgid ""
14915 "Use the given format for building the source package (since dpkg 1.14.17).  "
14916 "It does override any format given in B<debian/source/format>."
14917 msgstr ""
14919 #. type: textblock
14920 #: dpkg-source.pod
14921 msgid ""
14922 "Read substitution variables in I<substvars-file>; the default is to not read "
14923 "any file. This option can be used multiple times to read substitution "
14924 "variables from multiple files (since dpkg 1.15.6)."
14925 msgstr ""
14927 #. type: =item
14928 #: dpkg-source.pod
14929 msgid "B<-Z>I<compression>, B<--compression>=I<compression>"
14930 msgstr ""
14932 #. type: textblock
14933 #: dpkg-source.pod
14934 msgid ""
14935 "Specify the compression to use for created tarballs and diff files "
14936 "(B<--compression> since dpkg 1.15.5).  Note that this option will not cause "
14937 "existing tarballs to be recompressed, it only affects new files. Supported "
14938 "values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>.  The default is I<xz> for "
14939 "formats 2.0 and newer, and I<gzip> for format 1.0. I<xz> is only supported "
14940 "since dpkg 1.15.5."
14941 msgstr ""
14943 #. type: =item
14944 #: dpkg-source.pod
14945 msgid "B<-z>I<level>, B<--compression-level>=I<level>"
14946 msgstr ""
14948 #. type: textblock
14949 #: dpkg-source.pod
14950 msgid ""
14951 "Compression level to use (B<--compression-level> since dpkg 1.15.5).  As "
14952 "with B<-Z> it only affects newly created files. Supported values are: I<1> "
14953 "to I<9>, I<best>, and I<fast>.  The default is I<9> for gzip and bzip2, I<6> "
14954 "for xz and lzma."
14955 msgstr ""
14957 #. type: =item
14958 #: dpkg-source.pod
14959 msgid "B<-i>[I<regex>], B<--diff-ignore>[=I<regex>]"
14960 msgstr ""
14962 #. type: textblock
14963 #: dpkg-source.pod
14964 msgid ""
14965 "You may specify a perl regular expression to match files you want filtered "
14966 "out of the list of files for the diff (B<--diff-ignore> since dpkg 1.15.6).  "
14967 "(This list is generated by a find command.) (If the source package is being "
14968 "built as a version 3 source package using a VCS, this can be used to ignore "
14969 "uncommitted changes on specific files. Using -i.* will ignore all of them.)"
14970 msgstr ""
14972 #. type: textblock
14973 #: dpkg-source.pod
14974 msgid ""
14975 "The B<-i> option by itself enables this setting with a default regex "
14976 "(preserving any modification to the default regex done by a previous use of "
14977 "B<--extend-diff-ignore>) that will filter out control files and directories "
14978 "of the most common revision control systems, backup and swap files and "
14979 "Libtool build output directories. There can only be one active regex, of "
14980 "multiple B<-i> options only the last one will take effect."
14981 msgstr ""
14983 #. type: textblock
14984 #: dpkg-source.pod
14985 msgid ""
14986 "This is very helpful in cutting out extraneous files that get included in "
14987 "the diff, for example if you maintain your source in a revision control "
14988 "system and want to use a checkout to build a source package without "
14989 "including the additional files and directories that it will usually contain "
14990 "(e.g. CVS/, .cvsignore, .svn/). The default regex is already very "
14991 "exhaustive, but if you need to replace it, please note that by default it "
14992 "can match any part of a path, so if you want to match the begin of a "
14993 "filename or only full filenames, you will need to provide the necessary "
14994 "anchors (e.g. ‘(^|/)’, ‘($|/)’) yourself."
14995 msgstr ""
14997 #. type: =item
14998 #: dpkg-source.pod
14999 msgid "B<--extend-diff-ignore>=I<regex>"
15000 msgstr ""
15002 #. type: textblock
15003 #: dpkg-source.pod
15004 msgid ""
15005 "The perl regular expression specified will extend the default value used by "
15006 "B<--diff-ignore> and its current value, if set (since dpkg 1.15.6).  It does "
15007 "this by concatenating “B<|>I<regex>” to the existing value.  This option is "
15008 "convenient to use in B<debian/source/options> to exclude some auto-generated "
15009 "files from the automatic patch generation."
15010 msgstr ""
15012 #. type: =item
15013 #: dpkg-source.pod
15014 msgid "B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]"
15015 msgstr ""
15017 #. type: textblock
15018 #: dpkg-source.pod
15019 msgid ""
15020 "If this option is specified, the pattern will be passed to B<tar>(1)'s "
15021 "B<--exclude> option when it is called to generate a .orig.tar or .tar file "
15022 "(B<--tar-ignore> since dpkg 1.15.6).  For example, B<-I>CVS will make tar "
15023 "skip over CVS directories when generating a .tar.gz file. The option may be "
15024 "repeated multiple times to list multiple patterns to exclude."
15025 msgstr ""
15027 #. type: textblock
15028 #: dpkg-source.pod
15029 msgid ""
15030 "B<-I> by itself adds default B<--exclude> options that will filter out "
15031 "control files and directories of the most common revision control systems, "
15032 "backup and swap files and Libtool build output directories."
15033 msgstr ""
15035 #. type: textblock
15036 #: dpkg-source.pod
15037 msgid ""
15038 "B<Note:> While they have similar purposes, B<-i> and B<-I> have very "
15039 "different syntax and semantics. B<-i> can only be specified once and takes a "
15040 "perl compatible regular expression which is matched against the full "
15041 "relative path of each file. B<-I> can specified multiple times and takes a "
15042 "filename pattern with shell wildcards.  The pattern is applied to the full "
15043 "relative path but also to each part of the path individually. The exact "
15044 "semantic of tar's B<--exclude> option is somewhat complicated, see "
15045 "L<https://www.gnu.org/software/tar/manual/tar.html#wildcards> for a full "
15046 "documentation."
15047 msgstr ""
15049 #. type: textblock
15050 #: dpkg-source.pod
15051 msgid ""
15052 "The default regex and patterns for both options can be seen in the output of "
15053 "the B<--help> command."
15054 msgstr ""
15056 #. type: =head2
15057 #: dpkg-source.pod
15058 msgid "Generic extract options"
15059 msgstr ""
15061 #. type: =item
15062 #: dpkg-source.pod
15063 msgid "B<--no-copy>"
15064 msgstr ""
15066 #. type: textblock
15067 #: dpkg-source.pod
15068 msgid ""
15069 "Do not copy original tarballs near the extracted source package (since dpkg "
15070 "1.14.17)."
15071 msgstr ""
15073 #. type: =item
15074 #: dpkg-source.pod
15075 msgid "B<--no-check>"
15076 msgstr ""
15078 #. type: textblock
15079 #: dpkg-source.pod
15080 msgid "Do not check signatures and checksums before unpacking (since dpkg 1.14.17)."
15081 msgstr ""
15083 #. type: =item
15084 #: dpkg-source.pod
15085 msgid "B<--no-overwrite-dir>"
15086 msgstr ""
15088 #. type: textblock
15089 #: dpkg-source.pod
15090 msgid ""
15091 "Do not overwrite the extraction directory if it already exists (since dpkg "
15092 "1.18.8)."
15093 msgstr ""
15095 #. type: =item
15096 #: dpkg-source.pod
15097 msgid "B<--require-valid-signature>"
15098 msgstr ""
15100 #. type: textblock
15101 #: dpkg-source.pod
15102 msgid ""
15103 "Refuse to unpack the source package if it doesn't contain an OpenPGP "
15104 "signature that can be verified (since dpkg 1.15.0) either with the user's "
15105 "I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of "
15106 "the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg>, "
15107 "I</usr/share/keyrings/debian-nonupload.gpg> and "
15108 "I</usr/share/keyrings/debian-maintainers.gpg>)."
15109 msgstr ""
15111 #. type: =item
15112 #: dpkg-source.pod
15113 msgid "B<--require-strong-checksums>"
15114 msgstr ""
15116 #. type: textblock
15117 #: dpkg-source.pod
15118 msgid ""
15119 "Refuse to unpack the source package if it does not contain any strong "
15120 "checksums (since dpkg 1.18.7).  Currently the only known checksum considered "
15121 "strong is B<SHA-256>."
15122 msgstr ""
15124 #. type: =item
15125 #: dpkg-source.pod
15126 msgid "B<--ignore-bad-version>"
15127 msgstr ""
15129 #. type: textblock
15130 #: dpkg-source.pod
15131 msgid ""
15132 "Turns the bad source package version check into a non-fatal warning (since "
15133 "dpkg 1.17.7).  This option should only be necessary when extracting ancient "
15134 "source packages with broken versions, just for backwards compatibility."
15135 msgstr ""
15137 #. type: =head2
15138 #: dpkg-source.pod
15139 msgid "Generic general options"
15140 msgstr ""
15142 #. type: textblock
15143 #: dpkg-source.pod
15144 msgid ""
15145 "Sets the maximum number of threads allowed for compressors that support "
15146 "multi-threaded operations (since dpkg 1.21.14)."
15147 msgstr ""
15149 #. type: textblock
15150 #: dpkg-source.pod
15151 msgid "Sets quiet mode to suppress warnings."
15152 msgstr ""
15154 #. type: =head1
15155 #: dpkg-source.pod
15156 msgid "SOURCE PACKAGE FORMATS"
15157 msgstr ""
15159 #. type: textblock
15160 #: dpkg-source.pod
15161 msgid ""
15162 "If you don't know what source format to use, you should probably pick either "
15163 "“3.0 (quilt)” or “3.0 (native)”.  See "
15164 "L<https://wiki.debian.org/Projects/DebSrc3.0> for information on the "
15165 "deployment of those formats within Debian."
15166 msgstr ""
15168 #. type: =head2
15169 #: dpkg-source.pod
15170 msgid "Format: 1.0"
15171 msgstr ""
15173 #. type: textblock
15174 #: dpkg-source.pod
15175 msgid ""
15176 "A source package in this format consists either of a B<.orig.tar.gz> "
15177 "associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package "
15178 "is said to be I<native>).  Optionally the original tarball might be "
15179 "accompanied by a detached upstream signature B<.orig.tar.gz.asc>, extraction "
15180 "supported since dpkg 1.18.5."
15181 msgstr ""
15183 #. type: textblock
15184 #: dpkg-source.pod
15185 msgid "B<Extracting>"
15186 msgstr ""
15188 #. type: textblock
15189 #: dpkg-source.pod
15190 msgid ""
15191 "Extracting a native package is a simple extraction of the single tarball in "
15192 "the target directory. Extracting a non-native package is done by first "
15193 "unpacking the B<.orig.tar.gz> and then applying the patch contained in the "
15194 "B<.diff.gz> file. The timestamp of all patched files is reset to the "
15195 "extraction time of the source package (this avoids timestamp skews leading "
15196 "to problems when autogenerated files are patched). The diff can create new "
15197 "files (the whole debian directory is created that way) but cannot remove "
15198 "files (empty files will be left over) and cannot create or change symlinks."
15199 msgstr ""
15201 #. type: textblock
15202 #: dpkg-source.pod
15203 msgid "B<Building>"
15204 msgstr ""
15206 #. type: textblock
15207 #: dpkg-source.pod
15208 msgid ""
15209 "Building a native package is just creating a single tarball with the source "
15210 "directory. Building a non-native package involves extracting the original "
15211 "tarball in a separate “.orig” directory and regenerating the B<.diff.gz> by "
15212 "comparing the source package I<directory> with the .orig directory."
15213 msgstr ""
15215 #. type: textblock
15216 #: dpkg-source.pod
15217 msgid "B<Build options (with --build):>"
15218 msgstr ""
15220 #. type: textblock
15221 #: dpkg-source.pod
15222 msgid ""
15223 "If a second non-option argument is supplied it should be the name of the "
15224 "original source directory or tarfile or the empty string if the package is a "
15225 "Debian-specific one and so has no debianization diffs. If no second argument "
15226 "is supplied then B<dpkg-source> will look for the original source tarfile "
15227 "I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source "
15228 "directory I<directory>B<.orig> depending on the B<-sX> arguments."
15229 msgstr ""
15231 #. type: textblock
15232 #: dpkg-source.pod
15233 msgid ""
15234 "B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing "
15235 "tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, "
15236 "B<-sU> and B<-sR> should be used instead."
15237 msgstr ""
15239 #. type: textblock
15240 #: dpkg-source.pod
15241 msgid ""
15242 "Specifies to expect the original source as a tarfile, by default "
15243 "I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  It will leave "
15244 "this original source in place as a tarfile, or copy it to the current "
15245 "directory if it isn't already there. The tarball will be unpacked into "
15246 "I<directory>B<.orig> for the generation of the diff."
15247 msgstr ""
15249 #. type: =item
15250 #: dpkg-source.pod
15251 msgid "B<-sp>"
15252 msgstr ""
15254 #. type: textblock
15255 #: dpkg-source.pod
15256 msgid "Like B<-sk> but will remove the directory again afterwards."
15257 msgstr ""
15259 #. type: textblock
15260 #: dpkg-source.pod
15261 msgid ""
15262 "Specifies that the original source is expected as a directory, by default "
15263 "I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a "
15264 "new original source archive from it."
15265 msgstr ""
15267 #. type: textblock
15268 #: dpkg-source.pod
15269 msgid "Like B<-su> but will remove that directory after it has been used."
15270 msgstr ""
15272 #. type: textblock
15273 #: dpkg-source.pod
15274 msgid ""
15275 "Specifies that the original source is available both as a directory and as a "
15276 "tarfile. B<dpkg-source> will use the directory to create the diff, but the "
15277 "tarfile to create the B<.dsc>.  This option must be used with care - if the "
15278 "directory and tarfile do not match a bad source archive will be generated."
15279 msgstr ""
15281 #. type: textblock
15282 #: dpkg-source.pod
15283 msgid ""
15284 "Specifies to not look for any original source, and to not generate a diff.  "
15285 "The second argument, if supplied, must be the empty string. This is used for "
15286 "Debian-specific packages which do not have a separate upstream source and "
15287 "therefore have no debianization diffs."
15288 msgstr ""
15290 #. type: =item
15291 #: dpkg-source.pod
15292 msgid "B<-sa> or B<-sA>"
15293 msgstr ""
15295 #. type: textblock
15296 #: dpkg-source.pod
15297 msgid ""
15298 "Specifies to look for the original source archive as a tarfile or as a "
15299 "directory - the second argument, if any, may be either, or the empty string "
15300 "(this is equivalent to using B<-sn>).  If a tarfile is found it will unpack "
15301 "it to create the diff and remove it afterwards (this is equivalent to "
15302 "B<-sp>); if a directory is found it will pack it to create the original "
15303 "source and remove it afterwards (this is equivalent to B<-sr>); if neither "
15304 "is found it will assume that the package has no debianization diffs, only a "
15305 "straightforward source archive (this is equivalent to B<-sn>).  If both are "
15306 "found then B<dpkg-source> will ignore the directory, overwriting it, if "
15307 "B<-sA> was specified (this is equivalent to B<-sP>)  or raise an error if "
15308 "B<-sa> was specified.  B<-sa> is the default."
15309 msgstr ""
15311 #. type: =item
15312 #: dpkg-source.pod
15313 msgid "B<--abort-on-upstream-changes>"
15314 msgstr ""
15316 #. type: textblock
15317 #: dpkg-source.pod
15318 msgid ""
15319 "The process fails if the generated diff contains changes to files outside of "
15320 "the debian sub-directory (since dpkg 1.15.8).  This option is not allowed in "
15321 "B<debian/source/options> but can be used in B<debian/source/local-options>."
15322 msgstr ""
15324 #. type: textblock
15325 #: dpkg-source.pod
15326 msgid "B<Extract options (with --extract):>"
15327 msgstr ""
15329 #. type: textblock
15330 #: dpkg-source.pod
15331 msgid "In all cases any existing original source tree will be removed."
15332 msgstr ""
15334 #. type: textblock
15335 #: dpkg-source.pod
15336 msgid ""
15337 "Used when extracting then the original source (if any) will be left as a "
15338 "tarfile. If it is not already located in the current directory or if an "
15339 "existing but different file is there it will be copied there.  (B<This is "
15340 "the default>)."
15341 msgstr ""
15343 #. type: textblock
15344 #: dpkg-source.pod
15345 msgid "Unpacks the original source tree."
15346 msgstr ""
15348 #. type: textblock
15349 #: dpkg-source.pod
15350 msgid ""
15351 "Ensures that the original source is neither copied to the current directory "
15352 "nor unpacked. Any original source tree that was in the current directory is "
15353 "still removed."
15354 msgstr ""
15356 #. type: textblock
15357 #: dpkg-source.pod
15358 msgid ""
15359 "All the B<-s>I<X> options are mutually exclusive. If you specify more than "
15360 "one only the last one will be used."
15361 msgstr ""
15363 #. type: =item
15364 #: dpkg-source.pod
15365 msgid "B<--skip-debianization>"
15366 msgstr ""
15368 #. type: textblock
15369 #: dpkg-source.pod
15370 msgid ""
15371 "Skips application of the debian diff on top of the upstream sources (since "
15372 "dpkg 1.15.1)."
15373 msgstr ""
15375 #. type: =head2
15376 #: dpkg-source.pod
15377 msgid "Format: 2.0"
15378 msgstr ""
15380 #. type: textblock
15381 #: dpkg-source.pod
15382 msgid ""
15383 "Extraction supported since dpkg 1.13.9, building supported since dpkg "
15384 "1.14.8.  Also known as wig&pen. This format is not recommended for "
15385 "wide-spread usage, the format “3.0 (quilt)” replaces it.  Wig&pen was the "
15386 "first specification of a new-generation source package format."
15387 msgstr ""
15389 #. type: textblock
15390 #: dpkg-source.pod
15391 msgid ""
15392 "The behaviour of this format is the same as the “3.0 (quilt)” format except "
15393 "that it doesn't use an explicit list of patches. All files in "
15394 "B<debian/patches/> matching the perl regular expression B<[\\w-]+> must be "
15395 "valid patches: they are applied at extraction time."
15396 msgstr ""
15398 #. type: textblock
15399 #: dpkg-source.pod
15400 msgid ""
15401 "When building a new source package, any change to the upstream source is "
15402 "stored in a patch named B<zz_debian-diff-auto>."
15403 msgstr ""
15405 #. type: =head2
15406 #: dpkg-source.pod
15407 msgid "Format: 3.0 (native)"
15408 msgstr ""
15410 #. type: textblock
15411 #: dpkg-source.pod
15412 msgid ""
15413 "Supported since dpkg 1.14.17.  This format is an extension of the native "
15414 "package format as defined in the 1.0 format. It supports all compression "
15415 "methods and will ignore by default any VCS specific files and directories as "
15416 "well as many temporary files (see default value associated to B<-I> option "
15417 "in the B<--help> output)."
15418 msgstr ""
15420 #. type: =head2
15421 #: dpkg-source.pod
15422 msgid "Format: 3.0 (quilt)"
15423 msgstr ""
15425 #. type: textblock
15426 #: dpkg-source.pod
15427 msgid ""
15428 "Supported since dpkg 1.14.17.  A source package in this format contains at "
15429 "least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, "
15430 "B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It "
15431 "can also contain additional original tarballs "
15432 "(B<.orig->I<component>B<.tar.>I<ext>).  I<component> can only contain "
15433 "alphanumeric (‘a-zA-Z0-9’) characters and hyphens (‘-’).  Optionally each "
15434 "original tarball can be accompanied by a detached upstream signature "
15435 "(B<.orig.tar.>I<ext>B<.asc> and B<.orig->I<component>B<.tar.>I<ext>B<.asc>), "
15436 "extraction supported since dpkg 1.17.20, building supported since dpkg "
15437 "1.18.5."
15438 msgstr ""
15440 #. type: textblock
15441 #: dpkg-source.pod
15442 msgid ""
15443 "The main original tarball is extracted first, then all additional original "
15444 "tarballs are extracted in subdirectories named after the I<component> part "
15445 "of their filename (any pre-existing directory is replaced). The debian "
15446 "tarball is extracted on top of the source directory after prior removal of "
15447 "any pre-existing B<debian> directory. Note that the debian tarball must "
15448 "contain a B<debian> sub-directory but it can also contain binary files "
15449 "outside of that directory (see B<--include-binaries> option)."
15450 msgstr ""
15452 #. type: textblock
15453 #: dpkg-source.pod
15454 msgid ""
15455 "All patches listed in B<debian/patches/>I<vendor>B<.series> or "
15456 "B<debian/patches/series> are then applied, where I<vendor> will be the "
15457 "lowercase name of the current vendor, or B<debian> if there is no vendor "
15458 "defined.  If the former file is used and the latter one doesn't exist (or is "
15459 "a symlink), then the latter is replaced with a symlink to the former.  This "
15460 "is meant to simplify usage of B<quilt> to manage the set of patches.  "
15461 "Vendor-specific series files are intended to make it possible to serialize "
15462 "multiple development branches based on the vendor, in a declarative way, in "
15463 "preference to open-coding this handling in B<debian/rules>.  This is "
15464 "particularly useful when the source would need to be patched conditionally "
15465 "because the affected files do not have built-in conditional occlusion "
15466 "support.  Note however that while B<dpkg-source> parses correctly series "
15467 "files with explicit options used for patch application (stored on each line "
15468 "after the patch filename and one or more spaces), it does ignore those "
15469 "options and always expects patches that can be applied with the B<-p1> "
15470 "option of B<patch>. It will thus emit a warning when it encounters such "
15471 "options, and the build is likely to fail."
15472 msgstr ""
15474 #. type: textblock
15475 #: dpkg-source.pod
15476 msgid ""
15477 "Note that B<lintian>(1) will emit unconditional warnings when using vendor "
15478 "series due to a controversial Debian specific ruling, which should not "
15479 "affect any external usage; to silence these, the dpkg lintian profile can be "
15480 "used by passing «B<--profile dpkg>» to B<lintian>(1)."
15481 msgstr ""
15483 #. type: textblock
15484 #: dpkg-source.pod
15485 msgid ""
15486 "The timestamp of all patched files is reset to the extraction time of the "
15487 "source package (this avoids timestamp skews leading to problems when "
15488 "autogenerated files are patched)."
15489 msgstr ""
15491 #. type: textblock
15492 #: dpkg-source.pod
15493 msgid ""
15494 "Contrary to B<quilt>'s default behaviour, patches are expected to apply "
15495 "without any fuzz. When that is not the case, you should refresh such patches "
15496 "with B<quilt>, or B<dpkg-source> will error out while trying to apply them."
15497 msgstr ""
15499 #. type: textblock
15500 #: dpkg-source.pod
15501 msgid "Similarly to B<quilt>'s default behaviour, the patches can remove files too."
15502 msgstr ""
15504 #. type: textblock
15505 #: dpkg-source.pod
15506 msgid ""
15507 "The file B<.pc/applied-patches> is created if some patches have been applied "
15508 "during the extraction."
15509 msgstr ""
15511 #. type: textblock
15512 #: dpkg-source.pod
15513 msgid ""
15514 "All original tarballs found in the current directory are extracted in a "
15515 "temporary directory by following the same logic as for the unpack, the "
15516 "debian directory is copied over in the temporary directory, and all patches "
15517 "except the automatic patch (B<debian-changes->I<version> or "
15518 "B<debian-changes>, depending on B<--single-debian-patch>) are applied. The "
15519 "temporary directory is compared to the source package directory. When the "
15520 "diff is non-empty, the build fails unless B<--single-debian-patch> or "
15521 "B<--auto-commit> has been used, in which case the diff is stored in the "
15522 "automatic patch.  If the automatic patch is created/deleted, it's "
15523 "added/removed from the series file and from the B<quilt> metadata."
15524 msgstr ""
15526 #. type: textblock
15527 #: dpkg-source.pod
15528 msgid ""
15529 "Any change on a binary file is not representable in a diff and will thus "
15530 "lead to a failure unless the maintainer deliberately decided to include that "
15531 "modified binary file in the debian tarball (by listing it in "
15532 "B<debian/source/include-binaries>). The build will also fail if it finds "
15533 "binary files in the debian sub-directory unless they have been allowed "
15534 "through B<debian/source/include-binaries>."
15535 msgstr ""
15537 #. type: textblock
15538 #: dpkg-source.pod
15539 msgid ""
15540 "The updated debian directory and the list of modified binaries is then used "
15541 "to generate the debian tarball."
15542 msgstr ""
15544 #. type: textblock
15545 #: dpkg-source.pod
15546 msgid ""
15547 "The automatically generated diff doesn't include changes on VCS specific "
15548 "files as well as many temporary files (see default value associated to B<-i> "
15549 "option in the B<--help> output). In particular, the B<.pc> directory used by "
15550 "B<quilt> is ignored during generation of the automatic patch."
15551 msgstr ""
15553 #. type: textblock
15554 #: dpkg-source.pod
15555 msgid ""
15556 "B<Note:> B<dpkg-source> B<--before-build> (and B<--build>) will ensure that "
15557 "all patches listed in the series file are applied so that a package build "
15558 "always has all patches applied. It does this by finding unapplied patches "
15559 "(they are listed in the B<series> file but not in B<.pc/applied-patches>), "
15560 "and if the first patch in that set can be applied without errors, it will "
15561 "apply them all. The option B<--no-preparation> can be used to disable this "
15562 "behavior."
15563 msgstr ""
15565 #. type: textblock
15566 #: dpkg-source.pod
15567 msgid "B<Recording changes>"
15568 msgstr ""
15570 #. type: =item
15571 #: dpkg-source.pod
15572 msgid "B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]"
15573 msgstr ""
15575 #. type: textblock
15576 #: dpkg-source.pod
15577 msgid ""
15578 "Generates a patch corresponding to the local changes that are not managed by "
15579 "the B<quilt> patch system and integrates it in the patch system under the "
15580 "name I<patch-name>. If the name is missing, it will be asked "
15581 "interactively. If I<patch-file> is given, it is used as the patch "
15582 "corresponding to the local changes to integrate. Once integrated, an editor "
15583 "is launched so that you can edit the meta-information in the patch header."
15584 msgstr ""
15586 #. type: textblock
15587 #: dpkg-source.pod
15588 msgid ""
15589 "Passing I<patch-file> is mainly useful after a build failure that "
15590 "pre-generated this file, and on this ground the given file is removed after "
15591 "integration. Note also that the changes contained in the patch file must "
15592 "already be applied on the tree and that the files modified by the patch must "
15593 "not have supplementary unrecorded changes."
15594 msgstr ""
15596 #. type: textblock
15597 #: dpkg-source.pod
15598 msgid ""
15599 "If the patch generation detects modified binary files, they will be "
15600 "automatically added to B<debian/source/include-binaries> so that they end up "
15601 "in the debian tarball (exactly like B<dpkg-source --include-binaries "
15602 "--build> would do)."
15603 msgstr ""
15605 #. type: textblock
15606 #: dpkg-source.pod
15607 msgid "B<Build options>"
15608 msgstr ""
15610 #. type: =item
15611 #: dpkg-source.pod
15612 msgid "B<--allow-version-of-quilt-db=>I<version>"
15613 msgstr ""
15615 #. type: textblock
15616 #: dpkg-source.pod
15617 msgid ""
15618 "Allow B<dpkg-source> to build the source package if the version of the "
15619 "B<quilt> metadata is the one specified, even if B<dpkg-source> doesn't know "
15620 "about it (since dpkg 1.15.5.4).  Effectively this says that the given "
15621 "version of the B<quilt> metadata is compatible with the version 2 that "
15622 "B<dpkg-source> currently supports. The version of the B<quilt> metadata is "
15623 "stored in B<.pc/.version>."
15624 msgstr ""
15626 #. type: =item
15627 #: dpkg-source.pod
15628 msgid "B<--include-removal>"
15629 msgstr ""
15631 #. type: textblock
15632 #: dpkg-source.pod
15633 msgid ""
15634 "Do not ignore removed files and include them in the automatically generated "
15635 "patch."
15636 msgstr ""
15638 #. type: =item
15639 #: dpkg-source.pod
15640 msgid "B<--include-timestamp>"
15641 msgstr ""
15643 #. type: textblock
15644 #: dpkg-source.pod
15645 msgid "Include timestamp in the automatically generated patch."
15646 msgstr ""
15648 #. type: =item
15649 #: dpkg-source.pod
15650 msgid "B<--include-binaries>"
15651 msgstr ""
15653 #. type: textblock
15654 #: dpkg-source.pod
15655 msgid ""
15656 "Add all modified binaries in the debian tarball. Also add them to "
15657 "B<debian/source/include-binaries>: they will be added by default in "
15658 "subsequent builds and this option is thus no more needed."
15659 msgstr ""
15661 #. type: =item
15662 #: dpkg-source.pod
15663 msgid "B<--no-preparation>"
15664 msgstr ""
15666 #. type: textblock
15667 #: dpkg-source.pod
15668 msgid ""
15669 "Do not try to prepare the build tree by applying patches which are "
15670 "apparently unapplied (since dpkg 1.14.18)."
15671 msgstr ""
15673 #. type: =item
15674 #: dpkg-source.pod
15675 msgid "B<--single-debian-patch>"
15676 msgstr ""
15678 #. type: textblock
15679 #: dpkg-source.pod
15680 msgid ""
15681 "Use B<debian/patches/debian-changes> instead of "
15682 "B<debian/patches/debian-changes->I<version> for the name of the automatic "
15683 "patch generated during build (since dpkg 1.15.5.4).  This option is "
15684 "particularly useful when the package is maintained in a VCS and a patch set "
15685 "can't reliably be generated. Instead the current diff with upstream should "
15686 "be stored in a single patch. The option would be put in "
15687 "B<debian/source/local-options> and would be accompanied by a "
15688 "B<debian/source/local-patch-header> file explaining how the Debian changes "
15689 "can be best reviewed, for example in the VCS that is used."
15690 msgstr ""
15692 #. type: =item
15693 #: dpkg-source.pod
15694 msgid "B<--create-empty-orig>"
15695 msgstr ""
15697 #. type: textblock
15698 #: dpkg-source.pod
15699 msgid ""
15700 "Automatically create the main original tarball as empty if it's missing and "
15701 "if there are supplementary original tarballs (since dpkg 1.15.6).  This "
15702 "option is meant to be used when the source package is just a bundle of "
15703 "multiple upstream software and where there's no “main” software."
15704 msgstr ""
15706 #. type: =item
15707 #: dpkg-source.pod
15708 msgid "B<--no-unapply-patches, --unapply-patches>"
15709 msgstr ""
15711 #. type: textblock
15712 #: dpkg-source.pod
15713 msgid ""
15714 "By default, B<dpkg-source> will automatically unapply the patches in the "
15715 "B<--after-build> hook if it did apply them during B<--before-build> "
15716 "(B<--unapply-patches> since dpkg 1.15.8, B<--no-unapply-patches> since dpkg "
15717 "1.16.5).  Those options allow you to forcefully disable or enable the patch "
15718 "unapplication process. Those options are only allowed in "
15719 "B<debian/source/local-options> so that all generated source packages have "
15720 "the same behavior by default."
15721 msgstr ""
15723 #. type: textblock
15724 #: dpkg-source.pod
15725 msgid ""
15726 "The process fails if an automatic patch has been generated (since dpkg "
15727 "1.15.8).  This option can be used to ensure that all changes were properly "
15728 "recorded in separate B<quilt> patches prior to the source package "
15729 "build. This option is not allowed in B<debian/source/options> but can be "
15730 "used in B<debian/source/local-options>."
15731 msgstr ""
15733 #. type: =item
15734 #: dpkg-source.pod
15735 msgid "B<--auto-commit>"
15736 msgstr ""
15738 #. type: textblock
15739 #: dpkg-source.pod
15740 msgid ""
15741 "The process doesn't fail if an automatic patch has been generated, instead "
15742 "it's immediately recorded in the B<quilt> series."
15743 msgstr ""
15745 #. type: textblock
15746 #: dpkg-source.pod
15747 msgid "B<Extract options>"
15748 msgstr ""
15750 #. type: textblock
15751 #: dpkg-source.pod
15752 msgid ""
15753 "Skips extraction of the debian tarball on top of the upstream sources (since "
15754 "dpkg 1.15.1)."
15755 msgstr ""
15757 #. type: =item
15758 #: dpkg-source.pod
15759 msgid "B<--skip-patches>"
15760 msgstr ""
15762 #. type: textblock
15763 #: dpkg-source.pod
15764 msgid "Do not apply patches at the end of the extraction (since dpkg 1.14.18)."
15765 msgstr ""
15767 #. type: =head2
15768 #: dpkg-source.pod
15769 msgid "Format: 3.0 (custom)"
15770 msgstr ""
15772 #. type: textblock
15773 #: dpkg-source.pod
15774 msgid ""
15775 "Supported since dpkg 1.14.17.  This format is special.  It doesn't represent "
15776 "a real source package format but can be used to create source packages with "
15777 "arbitrary files."
15778 msgstr ""
15780 #. type: textblock
15781 #: dpkg-source.pod
15782 msgid ""
15783 "All non-option arguments are taken as files to integrate in the generated "
15784 "source package. They must exist and are preferably in the current "
15785 "directory. At least one file must be given."
15786 msgstr ""
15788 #. type: =item
15789 #: dpkg-source.pod
15790 msgid "B<--target-format=>I<value>"
15791 msgstr ""
15793 #. type: textblock
15794 #: dpkg-source.pod
15795 msgid ""
15796 "B<Required>. Defines the real format of the generated source package.  The "
15797 "generated .dsc file will contain this value in its B<Format> field and not "
15798 "“3.0 (custom)”."
15799 msgstr ""
15801 #. type: =head2
15802 #: dpkg-source.pod
15803 msgid "Format: 3.0 (git)"
15804 msgstr ""
15806 #. type: textblock
15807 #: dpkg-source.pod
15808 msgid "Supported since dpkg 1.14.17.  This format is experimental."
15809 msgstr ""
15811 #. type: textblock
15812 #: dpkg-source.pod
15813 msgid ""
15814 "A source package in this format consists of a single bundle of a git "
15815 "repository B<.git> to hold the source of a package.  There may also be a "
15816 "B<.gitshallow> file listing revisions for a shallow git clone."
15817 msgstr ""
15819 #. type: textblock
15820 #: dpkg-source.pod
15821 msgid ""
15822 "The bundle is cloned as a git repository to the target directory.  If there "
15823 "is a gitshallow file, it is installed as I<.git/shallow> inside the cloned "
15824 "git repository."
15825 msgstr ""
15827 #. type: textblock
15828 #: dpkg-source.pod
15829 msgid ""
15830 "Note that by default the new repository will have the same branch checked "
15831 "out that was checked out in the original source.  (Typically “main”, but it "
15832 "could be anything.)  Any other branches will be available under "
15833 "I<remotes/origin/>."
15834 msgstr ""
15836 #. type: textblock
15837 #: dpkg-source.pod
15838 msgid ""
15839 "Before going any further, some checks are done to ensure that we don't have "
15840 "any non-ignored uncommitted changes."
15841 msgstr ""
15843 #. type: textblock
15844 #: dpkg-source.pod
15845 msgid ""
15846 "B<git-bundle>(1) is used to generate a bundle of the git repository.  By "
15847 "default, all branches and tags in the repository are included in the bundle."
15848 msgstr ""
15850 #. type: =item
15851 #: dpkg-source.pod
15852 msgid "B<--git-ref=>I<ref>"
15853 msgstr ""
15855 #. type: textblock
15856 #: dpkg-source.pod
15857 msgid ""
15858 "Allows specifying a git ref to include in the git bundle. Use disables the "
15859 "default behavior of including all branches and tags. May be specified "
15860 "multiple times. The I<ref> can be the name of a branch or tag to include. It "
15861 "may also be any parameter that can be passed to B<git-rev-list>(1). For "
15862 "example, to include only the main branch, use B<--git-ref=>main. To include "
15863 "all tags and branches, except for the private branch, use B<--git-ref=>--all "
15864 "B<--git-ref=>^private"
15865 msgstr ""
15867 #. type: =item
15868 #: dpkg-source.pod
15869 msgid "B<--git-depth=>I<number>"
15870 msgstr ""
15872 #. type: textblock
15873 #: dpkg-source.pod
15874 msgid ""
15875 "Creates a shallow clone with a history truncated to the specified number of "
15876 "revisions."
15877 msgstr ""
15879 #. type: =head2
15880 #: dpkg-source.pod
15881 msgid "Format: 3.0 (bzr)"
15882 msgstr ""
15884 #. type: textblock
15885 #: dpkg-source.pod
15886 msgid ""
15887 "Supported since dpkg 1.14.17.  This format is experimental.  It generates a "
15888 "single tarball containing the bzr repository."
15889 msgstr ""
15891 #. type: textblock
15892 #: dpkg-source.pod
15893 msgid "The tarball is unpacked and then bzr is used to checkout the current branch."
15894 msgstr ""
15896 #. type: textblock
15897 #: dpkg-source.pod
15898 msgid ""
15899 "Then the VCS specific part of the source directory is copied over to a "
15900 "temporary directory. Before this temporary directory is packed in a tarball, "
15901 "various cleanup are done to save space."
15902 msgstr ""
15904 #. type: =head2
15905 #: dpkg-source.pod
15906 msgid "no source format specified in debian/source/format"
15907 msgstr ""
15909 #. type: textblock
15910 #: dpkg-source.pod
15911 msgid ""
15912 "The file B<debian/source/format> should always exist and indicate the "
15913 "desired source format. For backwards compatibility, format “1.0” is assumed "
15914 "when the file doesn't exist but you should not rely on this: at some point "
15915 "in the future B<dpkg-source> will be modified to fail when that file doesn't "
15916 "exist."
15917 msgstr ""
15919 #. type: textblock
15920 #: dpkg-source.pod
15921 msgid ""
15922 "The rationale is that format “1.0” is no longer the recommended format, you "
15923 "should usually pick one of the newer formats (“3.0 (quilt)”, “3.0 (native)”) "
15924 "but B<dpkg-source> will not do this automatically for you.  If you want to "
15925 "continue using the old format, you should be explicit about it and put “1.0” "
15926 "in B<debian/source/format>."
15927 msgstr ""
15929 #. type: =head2
15930 #: dpkg-source.pod
15931 msgid "the diff modifies the following upstream files"
15932 msgstr ""
15934 #. type: textblock
15935 #: dpkg-source.pod
15936 msgid ""
15937 "When using source format “1.0” it is usually a bad idea to modify upstream "
15938 "files directly as the changes end up hidden and mostly undocumented in the "
15939 ".diff.gz file. Instead you should store your changes as patches in the "
15940 "debian directory and apply them at build-time. To avoid this complexity you "
15941 "can also use the format “3.0 (quilt)” that offers this natively."
15942 msgstr ""
15944 #. type: =head2
15945 #: dpkg-source.pod
15946 msgid "cannot represent change to I<file>"
15947 msgstr ""
15949 #. type: textblock
15950 #: dpkg-source.pod
15951 msgid ""
15952 "Changes to upstream sources are usually stored with patch files, but not all "
15953 "changes can be represented with patches: they can only alter the content of "
15954 "plain text files. If you try replacing a file with something of a different "
15955 "type (for example replacing a plain file with a symlink or a directory), you "
15956 "will get this error message."
15957 msgstr ""
15959 #. type: =head2
15960 #: dpkg-source.pod
15961 msgid "newly created empty file I<file> will not be represented in diff"
15962 msgstr ""
15964 #. type: textblock
15965 #: dpkg-source.pod
15966 msgid ""
15967 "Empty files can't be created with patch files. Thus this change is not "
15968 "recorded in the source package and you are warned about it."
15969 msgstr ""
15971 #. type: =head2
15972 #: dpkg-source.pod
15973 msgid "executable mode I<perms> of I<file> will not be represented in diff"
15974 msgstr ""
15976 #. type: textblock
15977 #: dpkg-source.pod
15978 msgid ""
15979 "Patch files do not record permissions of files and thus executable "
15980 "permissions are not stored in the source package. This warning reminds you "
15981 "of that fact."
15982 msgstr ""
15984 #. type: =head2
15985 #: dpkg-source.pod
15986 msgid "special mode I<perms> of I<file> will not be represented in diff"
15987 msgstr ""
15989 #. type: textblock
15990 #: dpkg-source.pod
15991 msgid ""
15992 "Patch files do not record permissions of files and thus modified permissions "
15993 "are not stored in the source package. This warning reminds you of that fact."
15994 msgstr ""
15996 #. type: textblock
15997 #: dpkg-source.pod
15998 msgid ""
15999 "If set, it will be used as the timestamp (as seconds since the epoch) to "
16000 "clamp the mtime in the B<tar>(5) file entries."
16001 msgstr ""
16003 #. type: =item
16004 #: dpkg-source.pod
16005 msgid "B<VISUAL>"
16006 msgstr ""
16008 #. type: =item
16009 #: dpkg-source.pod
16010 msgid "B<EDITOR>"
16011 msgstr ""
16013 #. type: textblock
16014 #: dpkg-source.pod
16015 msgid "Used by the “2.0” and “3.0 (quilt)” source format modules."
16016 msgstr ""
16018 #. type: =item
16019 #: dpkg-source.pod
16020 msgid "B<GIT_DIR>"
16021 msgstr ""
16023 #. type: =item
16024 #: dpkg-source.pod
16025 msgid "B<GIT_INDEX_FILE>"
16026 msgstr ""
16028 #. type: =item
16029 #: dpkg-source.pod
16030 msgid "B<GIT_OBJECT_DIRECTORY>"
16031 msgstr ""
16033 #. type: =item
16034 #: dpkg-source.pod
16035 msgid "B<GIT_ALTERNATE_OBJECT_DIRECTORIES>"
16036 msgstr ""
16038 #. type: =item
16039 #: dpkg-source.pod
16040 msgid "B<GIT_WORK_TREE>"
16041 msgstr ""
16043 #. type: textblock
16044 #: dpkg-source.pod
16045 msgid "Used by the “3.0 (git)” source format modules."
16046 msgstr ""
16048 #. type: =head2
16049 #: dpkg-source.pod
16050 msgid "debian/source/format"
16051 msgstr ""
16053 #. type: textblock
16054 #: dpkg-source.pod
16055 msgid ""
16056 "This file contains on a single line the format that should be used to build "
16057 "the source package (possible formats are described above). No leading or "
16058 "trailing spaces are allowed."
16059 msgstr ""
16061 #. type: =head2
16062 #: dpkg-source.pod
16063 msgid "debian/source/include-binaries"
16064 msgstr ""
16066 #. type: textblock
16067 #: dpkg-source.pod
16068 msgid ""
16069 "This file contains a list of pathnames of binary files (one per line) "
16070 "relative to the source root directory that should be included in the debian "
16071 "tarball.  Leading and trailing spaces are stripped.  Lines starting with "
16072 "‘B<#>’ are comments and are skipped.  Empty lines are ignored."
16073 msgstr ""
16075 #. type: =head2
16076 #: dpkg-source.pod
16077 msgid "debian/source/options"
16078 msgstr ""
16080 #. type: textblock
16081 #: dpkg-source.pod
16082 msgid ""
16083 "This file contains a list of long options that should be automatically "
16084 "prepended to the set of command line options of a B<dpkg-source --build> or "
16085 "B<dpkg-source --print-format> call. Options like B<--compression> and "
16086 "B<--compression-level> are well suited for this file."
16087 msgstr ""
16089 #. type: textblock
16090 #: dpkg-source.pod
16091 msgid ""
16092 "Each option should be put on a separate line. Empty lines and lines starting "
16093 "with ‘B<#>’ are ignored.  The leading ‘B<-->’ should be stripped and short "
16094 "options are not allowed.  Optional spaces are allowed around the ‘B<=>’ "
16095 "symbol and optional quotes are allowed around the value.  Here's an example "
16096 "of such a file:"
16097 msgstr ""
16099 #. type: verbatim
16100 #: dpkg-source.pod
16101 #, no-wrap
16102 msgid ""
16103 " # let dpkg-source create a debian.tar.bz2 with maximal compression\n"
16104 " compression = \"bzip2\"\n"
16105 " compression-level = 9\n"
16106 " # use debian/patches/debian-changes as automatic patch\n"
16107 " single-debian-patch\n"
16108 " # ignore changes on config.{sub,guess}\n"
16109 " extend-diff-ignore = \"(^|/)(config.sub|config.guess)$\"\n"
16110 "\n"
16111 msgstr ""
16113 #. type: textblock
16114 #: dpkg-source.pod
16115 msgid ""
16116 "B<Note:> B<format> options are not accepted in this file, you should use "
16117 "B<debian/source/format> instead."
16118 msgstr ""
16120 #. type: =head2
16121 #: dpkg-source.pod
16122 msgid "debian/source/local-options"
16123 msgstr ""
16125 #. type: textblock
16126 #: dpkg-source.pod
16127 msgid ""
16128 "Exactly like B<debian/source/options> except that the file is not included "
16129 "in the generated source package. It can be useful to store a preference tied "
16130 "to the maintainer or to the VCS repository where the source package is "
16131 "maintained."
16132 msgstr ""
16134 #. type: =head2
16135 #: dpkg-source.pod
16136 msgid "debian/source/local-patch-header"
16137 msgstr ""
16139 #. type: =head2
16140 #: dpkg-source.pod
16141 msgid "debian/source/patch-header"
16142 msgstr ""
16144 #. type: textblock
16145 #: dpkg-source.pod
16146 msgid ""
16147 "Free form text that is put on top of the automatic patch generated in "
16148 "formats “2.0” or “3.0 (quilt)”. B<local-patch-header> is not included in the "
16149 "generated source package while B<patch-header> is."
16150 msgstr ""
16152 #. type: =head2
16153 #: dpkg-source.pod
16154 msgid "debian/patches/I<vendor>.series"
16155 msgstr ""
16157 #. type: =head2
16158 #: dpkg-source.pod
16159 msgid "debian/patches/series"
16160 msgstr ""
16162 #. type: textblock
16163 #: dpkg-source.pod
16164 msgid ""
16165 "This file lists all patches that have to be applied (in the given order)  on "
16166 "top of the upstream source package. Leading and trailing spaces are "
16167 "stripped.  The I<vendor> will be the lowercase name of the current vendor, "
16168 "or B<debian> if there is no vendor defined.  If the vendor-specific series "
16169 "file does not exist, the vendor-less series file will be used.  Lines "
16170 "starting with ‘B<#>’ are comments and are skipped.  Empty lines are "
16171 "ignored.  Remaining lines start with a patch filename (relative to the "
16172 "B<debian/patches/> directory) up to the first space character or the end of "
16173 "line. Optional B<quilt> options can follow up to the end of line or the "
16174 "first ‘B<#>’ preceded by one or more spaces (which marks the start of a "
16175 "comment up to the end of line)."
16176 msgstr ""
16178 #. type: textblock
16179 #: dpkg-source.pod
16180 msgid ""
16181 "The point at which field overriding occurs compared to certain standard "
16182 "output field settings is rather confused."
16183 msgstr ""
16185 #. type: textblock
16186 #: dpkg-source.pod
16187 msgid "B<deb-src-control>(5), B<deb-changelog>(5), B<deb-substvars>(5), B<dsc>(5)."
16188 msgstr ""
16190 #. type: textblock
16191 #: dpkg-split.pod
16192 msgid "dpkg-split - Debian package archive split/join tool"
16193 msgstr ""
16195 #. type: textblock
16196 #: dpkg-split.pod
16197 msgid "B<dpkg-split> [I<option>...] I<command>"
16198 msgstr ""
16200 #. type: textblock
16201 #: dpkg-split.pod
16202 msgid ""
16203 "B<dpkg-split> splits Debian binary package files into smaller parts and "
16204 "reassembles them again, to support the storage of large package files on "
16205 "small media such as floppy disks."
16206 msgstr ""
16208 #. type: textblock
16209 #: dpkg-split.pod
16210 msgid ""
16211 "It can be operated manually using the B<--split>, B<--join> and B<--info> "
16212 "options."
16213 msgstr ""
16215 #. type: textblock
16216 #: dpkg-split.pod
16217 msgid ""
16218 "It also has an automatic mode, invoked using the B<--auto> option, where it "
16219 "maintains a queue of parts seen but not yet reassembled and reassembles a "
16220 "package file when it has seen all of its parts. The B<--listq> and "
16221 "B<--discard> options allow the management of the queue."
16222 msgstr ""
16224 #. type: textblock
16225 #: dpkg-split.pod
16226 msgid ""
16227 "All splitting, joining and queueing operations produce informative messages "
16228 "on standard output; these may safely be ignored."
16229 msgstr ""
16231 #. type: =item
16232 #: dpkg-split.pod
16233 msgid "B<-s>, B<--split> I<complete-archive> [I<prefix>]"
16234 msgstr ""
16236 #. type: textblock
16237 #: dpkg-split.pod
16238 msgid "Splits a single Debian binary package into several parts."
16239 msgstr ""
16241 #. type: textblock
16242 #: dpkg-split.pod
16243 msgid ""
16244 "The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part "
16245 "number, starting at 1, and I<M> is the total number of parts (both in "
16246 "decimal)."
16247 msgstr ""
16249 #. type: textblock
16250 #: dpkg-split.pod
16251 msgid ""
16252 "If no I<prefix> is supplied then the I<complete-archive> filename is taken, "
16253 "including directory, with any trailing B<.deb> removed."
16254 msgstr ""
16256 #. type: =item
16257 #: dpkg-split.pod
16258 msgid "B<-j>, B<--join> I<part>..."
16259 msgstr ""
16261 #. type: textblock
16262 #: dpkg-split.pod
16263 msgid ""
16264 "Joins the parts of a package file together, reassembling the original file "
16265 "as it was before it was split."
16266 msgstr ""
16268 #. type: textblock
16269 #: dpkg-split.pod
16270 msgid ""
16271 "The part files given as arguments must be all the parts of exactly the same "
16272 "original binary file. Each part must occur exactly once in the argument "
16273 "list, though the parts to not need to be listed in order."
16274 msgstr ""
16276 #. type: textblock
16277 #: dpkg-split.pod
16278 msgid ""
16279 "The parts must of course all have been generated with the same part size "
16280 "specified at split time, which means that they must usually have been "
16281 "generated by the same invocation of B<dpkg-split --split>."
16282 msgstr ""
16284 #. type: textblock
16285 #: dpkg-split.pod
16286 msgid "The parts' filenames are not significant for the reassembly process."
16287 msgstr ""
16289 #. type: textblock
16290 #: dpkg-split.pod
16291 msgid ""
16292 "By default the output file is called "
16293 "I<package>B<_>I<version>B<_>I<arch>B<.deb>."
16294 msgstr ""
16296 #. type: =item
16297 #: dpkg-split.pod
16298 msgid "B<-I>, B<--info> I<part>..."
16299 msgstr ""
16301 #. type: textblock
16302 #: dpkg-split.pod
16303 msgid ""
16304 "Prints information, in a human-readable format, about the part file(s)  "
16305 "specified. Arguments which are not binary package parts produce a message "
16306 "saying so instead (but still on standard output)."
16307 msgstr ""
16309 #. type: =item
16310 #: dpkg-split.pod
16311 msgid "B<-a>, B<--auto -o> I<complete-output> I<part>"
16312 msgstr ""
16314 #. type: textblock
16315 #: dpkg-split.pod
16316 msgid "Automatically queue parts and reassemble a package if possible."
16317 msgstr ""
16319 #. type: textblock
16320 #: dpkg-split.pod
16321 msgid ""
16322 "The I<part> specified is examined, and compared with other parts of the same "
16323 "package (if any) in the queue of packages file parts."
16324 msgstr ""
16326 #. type: textblock
16327 #: dpkg-split.pod
16328 msgid ""
16329 "If all parts of the package file of which I<part> is a part are available "
16330 "then the package is reassembled and written to I<complete-output> (which "
16331 "should not usually already exist, though this is not an error)."
16332 msgstr ""
16334 #. type: textblock
16335 #: dpkg-split.pod
16336 msgid ""
16337 "If not then the I<part> is copied into the queue and I<complete-output> is "
16338 "not created."
16339 msgstr ""
16341 #. type: textblock
16342 #: dpkg-split.pod
16343 msgid ""
16344 "If I<part> is not a split binary package part then B<dpkg-split> will exit "
16345 "with status B<1>; if some other trouble occurs then it will exit with status "
16346 "B<2>."
16347 msgstr ""
16349 #. type: textblock
16350 #: dpkg-split.pod
16351 msgid ""
16352 "The B<--output> or B<-o> option must be supplied when using B<--auto>.  (If "
16353 "this were not mandatory the calling program would not know what output file "
16354 "to expect.)"
16355 msgstr ""
16357 #. type: =item
16358 #: dpkg-split.pod
16359 msgid "B<-l>, B<--listq>"
16360 msgstr ""
16362 #. type: textblock
16363 #: dpkg-split.pod
16364 msgid "Lists the contents of the queue of packages to be reassembled."
16365 msgstr ""
16367 #. type: textblock
16368 #: dpkg-split.pod
16369 msgid ""
16370 "For each package file of which parts are in the queue the output gives the "
16371 "name of the package, the parts in the queue, and the total number of bytes "
16372 "stored in the queue."
16373 msgstr ""
16375 #. type: =item
16376 #: dpkg-split.pod
16377 msgid "B<-d>, B<--discard> [I<package>...]"
16378 msgstr ""
16380 #. type: textblock
16381 #: dpkg-split.pod
16382 msgid ""
16383 "This discards parts from the queue of those waiting for the remaining parts "
16384 "of their packages."
16385 msgstr ""
16387 #. type: textblock
16388 #: dpkg-split.pod
16389 msgid ""
16390 "If no I<package> is specified then the queue is cleared completely; if any "
16391 "are specified then only parts of the relevant package(s) are deleted."
16392 msgstr ""
16394 #. type: =item
16395 #: dpkg-split.pod
16396 msgid "B<--depotdir> I<directory>"
16397 msgstr ""
16399 #. type: textblock
16400 #: dpkg-split.pod
16401 msgid ""
16402 "Specifies an alternative directory for the queue of parts awaiting automatic "
16403 "reassembly. The default is B<%ADMINDIR%/parts>."
16404 msgstr ""
16406 #. type: textblock
16407 #: dpkg-split.pod
16408 msgid ""
16409 "Set the administrative directory to I<directory> (since dpkg 1.21.10).  This "
16410 "is where the I<statoverride> file is stored.  Defaults to «I<%ADMINDIR%>» if "
16411 "B<DPKG_ADMINDIR> has not been set."
16412 msgstr ""
16414 #. type: textblock
16415 #: dpkg-split.pod
16416 msgid ""
16417 "Set the root directory to B<directory> (since dpkg 1.21.10), which sets the "
16418 "installation directory to «I<directory>» and the administrative directory to "
16419 "«I<directory>B<%ADMINDIR%>» if B<DPKG_ROOT> has not been set."
16420 msgstr ""
16422 #. type: =item
16423 #: dpkg-split.pod
16424 msgid "B<-S>, B<--partsize> I<kibibytes>"
16425 msgstr ""
16427 #. type: textblock
16428 #: dpkg-split.pod
16429 msgid ""
16430 "Specifies the maximum part size when splitting, in kibibytes (1024 "
16431 "bytes). The default is 450 KiB."
16432 msgstr ""
16434 #. type: =item
16435 #: dpkg-split.pod
16436 msgid "B<-o>, B<--output> I<complete-output>"
16437 msgstr ""
16439 #. type: textblock
16440 #: dpkg-split.pod
16441 msgid "Specifies the output file name for a reassembly."
16442 msgstr ""
16444 #. type: textblock
16445 #: dpkg-split.pod
16446 msgid ""
16447 "This overrides the default for a manual reassembly (B<--join>)  and is "
16448 "mandatory for an automatic queue-or-reassemble (B<--auto>)."
16449 msgstr ""
16451 #. type: =item
16452 #: dpkg-split.pod
16453 msgid "B<-Q>, B<--npquiet>"
16454 msgstr ""
16456 #. type: textblock
16457 #: dpkg-split.pod
16458 msgid ""
16459 "When doing automatic queue-or-reassembly B<dpkg-split> usually prints a "
16460 "message if it is given a I<part> that is not a binary package part. This "
16461 "option suppresses this message, to allow programs such as B<dpkg> to cope "
16462 "with both split and unsplit packages without producing spurious messages."
16463 msgstr ""
16465 #. type: =item
16466 #: dpkg-split.pod
16467 msgid "B<--msdos>"
16468 msgstr ""
16470 #. type: textblock
16471 #: dpkg-split.pod
16472 msgid "Forces the output filenames generated by B<--split> to be MSDOS-compatible."
16473 msgstr ""
16475 #. type: textblock
16476 #: dpkg-split.pod
16477 msgid ""
16478 "This mangles the prefix - either the default derived from the input filename "
16479 "or the one supplied as an argument: alphanumerics are lowercased, plus signs "
16480 "are replaced by B<x>'s and all other characters are discarded."
16481 msgstr ""
16483 #. type: textblock
16484 #: dpkg-split.pod
16485 msgid ""
16486 "The result is then truncated as much as is necessary, and filenames of the "
16487 "form I<prefixN>B<of>I<M>B<.deb> are generated."
16488 msgstr ""
16490 #. type: textblock
16491 #: dpkg-split.pod
16492 msgid ""
16493 "The requested split, merge, or other command succeeded.  B<--info> commands "
16494 "count as successful even if the files are not binary package parts."
16495 msgstr ""
16497 #. type: textblock
16498 #: dpkg-split.pod
16499 msgid ""
16500 "Only occurs with B<--auto> and indicates that the I<part> file was not a "
16501 "binary package part."
16502 msgstr ""
16504 #. type: textblock
16505 #: dpkg-split.pod
16506 msgid ""
16507 "Fatal or unrecoverable error due to invalid command-line usage, a file that "
16508 "looked like a package part file but was corrupted, or interactions with the "
16509 "system, such as accesses to the database, memory allocations, etc."
16510 msgstr ""
16512 #. type: textblock
16513 #: dpkg-split.pod
16514 msgid ""
16515 "If set and B<--root> option has not been specified, it will be used as the "
16516 "filesystem root directory (since dpkg 1.21.10)."
16517 msgstr ""
16519 #. type: textblock
16520 #: dpkg-split.pod
16521 msgid ""
16522 "If set and the B<--admindir> or B<--root> options have not been specified, "
16523 "it will be used as the B<dpkg> data directory (since dpkg 1.21.10)."
16524 msgstr ""
16526 #. type: textblock
16527 #: dpkg-split.pod
16528 msgid ""
16529 "If set, it will be used as the timestamp (as seconds since the epoch) in the "
16530 "B<deb-split>(5)'s B<ar>(5) container."
16531 msgstr ""
16533 #. type: =item
16534 #: dpkg-split.pod
16535 msgid "I<%ADMINDIR%/parts>"
16536 msgstr ""
16538 #. type: textblock
16539 #: dpkg-split.pod
16540 msgid "The default queue directory for part files awaiting automatic reassembly."
16541 msgstr ""
16543 #. type: textblock
16544 #: dpkg-split.pod
16545 msgid ""
16546 "The filenames used in this directory are in a format internal to "
16547 "B<dpkg-split> and are unlikely to be useful to other programs, and in any "
16548 "case the filename format should not be relied upon."
16549 msgstr ""
16551 #. type: textblock
16552 #: dpkg-split.pod
16553 msgid ""
16554 "Full details of the packages in the queue are impossible to get without "
16555 "digging into the queue directory yourself."
16556 msgstr ""
16558 #. type: textblock
16559 #: dpkg-split.pod
16560 msgid ""
16561 "There is no easy way to test whether a file that may be a binary package "
16562 "part is one."
16563 msgstr ""
16565 #. type: textblock
16566 #: dpkg-split.pod
16567 msgid "B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1)."
16568 msgstr ""
16570 #. type: textblock
16571 #: dpkg-statoverride.pod
16572 msgid "dpkg-statoverride - override ownership and mode of files"
16573 msgstr ""
16575 #. type: textblock
16576 #: dpkg-statoverride.pod
16577 msgid "B<dpkg-statoverride> [I<option>...] I<command>"
16578 msgstr ""
16580 #. type: textblock
16581 #: dpkg-statoverride.pod
16582 msgid ""
16583 "“B<stat overrides>” are a way to tell B<dpkg>(1)  to use a different owner "
16584 "or mode for a path when a package is installed (this applies to any "
16585 "filesystem object that B<dpkg> handles, including directories, devices, "
16586 "etc.). This can be used to force programs that are normally setuid to be "
16587 "install without a setuid flag, or only executable by a certain group."
16588 msgstr ""
16590 #. type: textblock
16591 #: dpkg-statoverride.pod
16592 msgid ""
16593 "B<dpkg-statoverride> is a utility to manage the list of stat overrides. It "
16594 "has three basic functions: adding, removing and listing overrides."
16595 msgstr ""
16597 #. type: =item
16598 #: dpkg-statoverride.pod
16599 msgid "B<--add> I<user group mode path>"
16600 msgstr ""
16602 #. type: textblock
16603 #: dpkg-statoverride.pod
16604 msgid ""
16605 "Add an override for I<path>. I<path> does not need to exist nor be known to "
16606 "B<dpkg> when this command is used; the override will be stored and used "
16607 "later.  Users and groups can be specified by their name (for example B<root> "
16608 "or B<nobody>), or by their number by prepending the number with a ‘B<#>’ "
16609 "(for example B<#0> or B<#65534>).  The I<mode> needs to be specified in "
16610 "octal."
16611 msgstr ""
16613 #. type: textblock
16614 #: dpkg-statoverride.pod
16615 msgid ""
16616 "If B<--update> is specified and I<path> exists, it is immediately set to the "
16617 "new owner and mode."
16618 msgstr ""
16620 #. type: =item
16621 #: dpkg-statoverride.pod
16622 msgid "B<--remove> I<path>"
16623 msgstr ""
16625 #. type: textblock
16626 #: dpkg-statoverride.pod
16627 msgid ""
16628 "Remove an override for I<path>, the status of I<path> is left unchanged by "
16629 "this command."
16630 msgstr ""
16632 #. type: textblock
16633 #: dpkg-statoverride.pod
16634 msgid ""
16635 "List all overrides. If a glob pattern is specified restrict the output to "
16636 "overrides which match the glob."
16637 msgstr ""
16639 #. type: =item
16640 #: dpkg-statoverride.pod dpkg.pod
16641 msgid "B<--force-help>"
16642 msgstr ""
16644 #. type: textblock
16645 #: dpkg-statoverride.pod
16646 msgid "Give help about the B<--force->I<thing> options (since dpkg 1.19.5)."
16647 msgstr ""
16649 #. type: textblock
16650 #: dpkg-statoverride.pod
16651 msgid ""
16652 "Set the administrative directory to I<directory>.  This is where the "
16653 "I<statoverride> file is stored.  Defaults to «I<%ADMINDIR%>» if "
16654 "B<DPKG_ADMINDIR> has not been set."
16655 msgstr ""
16657 #. type: =item
16658 #: dpkg-statoverride.pod dpkg.pod
16659 msgid "B<--force->I<things>"
16660 msgstr ""
16662 #. type: =item
16663 #: dpkg-statoverride.pod dpkg.pod
16664 msgid "B<--no-force->I<things>, B<--refuse->I<things>"
16665 msgstr ""
16667 #. type: textblock
16668 #: dpkg-statoverride.pod
16669 msgid ""
16670 "Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some "
16671 "things (since dpkg 1.19.5).  I<things> is a comma separated list of things "
16672 "specified below.  B<--force-help> displays a message describing them.  "
16673 "Things marked with (*) are forced by default."
16674 msgstr ""
16676 #. type: textblock
16677 #: dpkg-statoverride.pod
16678 msgid ""
16679 "I<Warning: These options are mostly intended to be used by experts only.  "
16680 "Using them without fully understanding their effects may break your whole "
16681 "system.>"
16682 msgstr ""
16684 #. type: textblock
16685 #: dpkg-statoverride.pod dpkg.pod
16686 msgid "B<all>: Turns on (or off) all force options."
16687 msgstr ""
16689 #. type: textblock
16690 #: dpkg-statoverride.pod dpkg.pod
16691 msgid ""
16692 "B<statoverride-add>: Overwrite an existing stat override when adding it "
16693 "(since dpkg 1.19.5)."
16694 msgstr ""
16696 #. type: textblock
16697 #: dpkg-statoverride.pod dpkg.pod
16698 msgid ""
16699 "B<statoverride-remove>: Ignore a missing stat override when removing it "
16700 "(since dpkg 1.19.5)."
16701 msgstr ""
16703 #. type: textblock
16704 #: dpkg-statoverride.pod dpkg.pod
16705 msgid ""
16706 "B<security-mac>(*): Use platform-specific Mandatory Access Controls (MAC) "
16707 "based security when installing files into the filesystem (since dpkg "
16708 "1.19.5).  On Linux systems the implementation uses SELinux."
16709 msgstr ""
16711 #. type: textblock
16712 #: dpkg-statoverride.pod
16713 msgid ""
16714 "B<not-root>: Try to (de)install things even when not root (since dpkg "
16715 "1.21.8)."
16716 msgstr ""
16718 #. type: =item
16719 #: dpkg-statoverride.pod update-alternatives.pod
16720 msgid "B<--force>"
16721 msgstr ""
16723 #. type: textblock
16724 #: dpkg-statoverride.pod
16725 msgid ""
16726 "Force an action, even if a sanity check would otherwise prohibit it.  This "
16727 "is necessary to override an existing override.  This option is deprecated "
16728 "(since dpkg 1.19.5), it is replaced by B<--force-all>."
16729 msgstr ""
16731 #. type: =item
16732 #: dpkg-statoverride.pod
16733 msgid "B<--update>"
16734 msgstr ""
16736 #. type: textblock
16737 #: dpkg-statoverride.pod
16738 msgid ""
16739 "Immediately try to change the I<path> to the new owner and mode if it "
16740 "exists."
16741 msgstr ""
16743 #. type: textblock
16744 #: dpkg-statoverride.pod
16745 msgid "Be less verbose about what we do."
16746 msgstr ""
16748 #. type: textblock
16749 #: dpkg-statoverride.pod
16750 msgid "For B<--list>, if there are no overrides or none match the supplied glob."
16751 msgstr ""
16753 #. type: =item
16754 #: dpkg-statoverride.pod dpkg.pod
16755 msgid "B<DPKG_FORCE>"
16756 msgstr ""
16758 #. type: textblock
16759 #: dpkg-statoverride.pod
16760 msgid ""
16761 "If set and none of the B<--force->I<...> options have been specified, it "
16762 "will be used as the force options to use (since dpkg 1.19.5)."
16763 msgstr ""
16765 #. type: =item
16766 #: dpkg-statoverride.pod
16767 msgid "I<%ADMINDIR%/statoverride>"
16768 msgstr ""
16770 #. type: textblock
16771 #: dpkg-statoverride.pod
16772 msgid ""
16773 "File which contains the current list of stat overrides of the system. It is "
16774 "located in the B<dpkg> administration directory, along with other files "
16775 "important to B<dpkg>, such as I<status> or I<available>."
16776 msgstr ""
16778 #. type: textblock
16779 #: dpkg-statoverride.pod
16780 msgid ""
16781 "B<Note:> B<dpkg-statoverride> preserves the old copy of this file, with "
16782 "extension “-old”, before replacing it with the new one."
16783 msgstr ""
16785 #. type: textblock
16786 #: dpkg-trigger.pod
16787 msgid "dpkg-trigger - a package trigger utility"
16788 msgstr ""
16790 #. type: textblock
16791 #: dpkg-trigger.pod
16792 msgid "B<dpkg-trigger> [I<option>...] I<trigger-name>"
16793 msgstr ""
16795 #. type: textblock
16796 #: dpkg-trigger.pod
16797 msgid "B<dpkg-trigger> [I<option>...] I<command>"
16798 msgstr ""
16800 #. type: textblock
16801 #: dpkg-trigger.pod
16802 msgid ""
16803 "B<dpkg-trigger> is a tool to explicitly activate triggers and check for its "
16804 "support on the running B<dpkg>."
16805 msgstr ""
16807 #. type: textblock
16808 #: dpkg-trigger.pod
16809 msgid ""
16810 "This can be used by maintainer scripts in complex and conditional situations "
16811 "where the file triggers, or the declarative B<activate> triggers control "
16812 "file directive, are insufficiently rich. It can also be used for testing and "
16813 "by system administrators (but note that the triggers won't actually be run "
16814 "by B<dpkg-trigger>)."
16815 msgstr ""
16817 #. type: textblock
16818 #: dpkg-trigger.pod
16819 msgid "Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>."
16820 msgstr ""
16822 #. type: =item
16823 #: dpkg-trigger.pod
16824 msgid "B<--check-supported>"
16825 msgstr ""
16827 #. type: textblock
16828 #: dpkg-trigger.pod
16829 msgid ""
16830 "Check if the running B<dpkg> supports triggers (usually called from a "
16831 "postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> "
16832 "with an error message to stderr if not. Normally, however, it is better just "
16833 "to activate the desired trigger with B<dpkg-trigger>."
16834 msgstr ""
16836 #. type: textblock
16837 #: dpkg-trigger.pod
16838 msgid ""
16839 "Change the location of the B<dpkg> database.  Defaults to I<%ADMINDIR%> if "
16840 "B<DPKG_ADMINDIR> has not been set."
16841 msgstr ""
16843 #. type: =item
16844 #: dpkg-trigger.pod
16845 msgid "B<--by-package=>I<package>"
16846 msgstr ""
16848 #. type: textblock
16849 #: dpkg-trigger.pod
16850 msgid ""
16851 "Override trigger awaiter (normally set by B<dpkg> through the "
16852 "B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, "
16853 "naming the package to which the script belongs, and this will be used by "
16854 "default)."
16855 msgstr ""
16857 #. type: =item
16858 #: dpkg-trigger.pod
16859 msgid "B<--no-await>"
16860 msgstr ""
16862 #. type: textblock
16863 #: dpkg-trigger.pod
16864 msgid ""
16865 "This option arranges that the calling package I<T> (if any) need not await "
16866 "the processing of this trigger; the interested package(s) I<I>, will not be "
16867 "added to I<T>'s trigger processing awaited list and I<T>'s status is "
16868 "unchanged.  I<T> may be considered installed even though I<I> may not yet "
16869 "have processed the trigger."
16870 msgstr ""
16872 #. type: =item
16873 #: dpkg-trigger.pod
16874 msgid "B<--await>"
16875 msgstr ""
16877 #. type: textblock
16878 #: dpkg-trigger.pod
16879 msgid ""
16880 "This option does the inverse of B<--no-await> (since dpkg 1.17.21).  If the "
16881 "interested package has declared a “noawait” directive, then this option will "
16882 "not be effective.  It is currently the default behavior."
16883 msgstr ""
16885 #. type: =item
16886 #: dpkg-trigger.pod
16887 msgid "B<--no-act>"
16888 msgstr ""
16890 #. type: textblock
16891 #: dpkg-trigger.pod
16892 msgid "Just test, do not actually change anything."
16893 msgstr ""
16895 #. type: textblock
16896 #: dpkg-trigger.pod dpkg.pod
16897 msgid ""
16898 "The requested action was successfully performed.  Or a check or assertion "
16899 "command returned true."
16900 msgstr ""
16902 #. type: textblock
16903 #: dpkg-trigger.pod dpkg.pod
16904 msgid "A check or assertion command returned false."
16905 msgstr ""
16907 #. type: textblock
16908 #: dpkg-trigger.pod
16909 msgid "B<dpkg>(1), B<deb-triggers>(5), B<%PKGDOCDIR%/spec/triggers.txt>."
16910 msgstr ""
16912 #. type: textblock
16913 #: dpkg-vendor.pod
16914 msgid "dpkg-vendor - queries information about distribution vendors"
16915 msgstr ""
16917 #. type: textblock
16918 #: dpkg-vendor.pod
16919 msgid "B<dpkg-vendor> [I<option>...] I<command>"
16920 msgstr ""
16922 #. type: textblock
16923 #: dpkg-vendor.pod
16924 msgid ""
16925 "B<dpkg-vendor> is a tool to query information about vendors listed in "
16926 "B<%PKGCONFDIR%/origins>. B<%PKGCONFDIR%/origins/default> contains "
16927 "information about the current vendor."
16928 msgstr ""
16930 #. type: =item
16931 #: dpkg-vendor.pod
16932 msgid "B<--is> I<vendor>"
16933 msgstr ""
16935 #. type: textblock
16936 #: dpkg-vendor.pod
16937 msgid ""
16938 "Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with "
16939 "B<1>."
16940 msgstr ""
16942 #. type: =item
16943 #: dpkg-vendor.pod
16944 msgid "B<--derives-from> I<vendor>"
16945 msgstr ""
16947 #. type: textblock
16948 #: dpkg-vendor.pod
16949 msgid ""
16950 "Exits with B<0> if the current vendor distribution is a derivative of "
16951 "I<vendor>, otherwise exits with B<1>.  It uses the B<Parent> field to browse "
16952 "all ancestors of the current vendor."
16953 msgstr ""
16955 #. type: =item
16956 #: dpkg-vendor.pod
16957 msgid "B<--query> I<field>"
16958 msgstr ""
16960 #. type: textblock
16961 #: dpkg-vendor.pod
16962 msgid ""
16963 "Print on standard output the value of the vendor-specific I<field> for the "
16964 "current vendor."
16965 msgstr ""
16967 #. type: =item
16968 #: dpkg-vendor.pod
16969 msgid "B<--vendor> I<vendor>"
16970 msgstr ""
16972 #. type: textblock
16973 #: dpkg-vendor.pod
16974 msgid ""
16975 "Assumes the current vendor is I<vendor> instead of discovering it with the "
16976 "B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>."
16977 msgstr ""
16979 #. type: textblock
16980 #: dpkg-vendor.pod
16981 msgid ""
16982 "This setting defines the current vendor. If not set, it will discover the "
16983 "current vendor by reading B<%PKGCONFDIR%/origins/default>."
16984 msgstr ""
16986 #. type: textblock
16987 #: dpkg-vendor.pod
16988 msgid "B<deb-origin>(5)."
16989 msgstr ""
16991 #. type: textblock
16992 #: dpkg.cfg.pod
16993 msgid "dpkg.cfg - dpkg configuration file"
16994 msgstr ""
16996 #. type: textblock
16997 #: dpkg.cfg.pod
16998 msgid ""
16999 "This file contains default options for dpkg. Each line contains a single "
17000 "option which is exactly the same as a normal command line option for dpkg "
17001 "except for the leading hyphens which are not used here. Quotes surrounding "
17002 "option values are stripped. Comments are allowed by starting a line with a "
17003 "hash sign (‘B<#>’)."
17004 msgstr ""
17006 #. type: =item
17007 #: dpkg.cfg.pod dpkg.pod
17008 msgid "I<%PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*>"
17009 msgstr ""
17011 #. type: =item
17012 #: dpkg.cfg.pod dpkg.pod
17013 msgid "I<%PKGCONFDIR%/dpkg.cfg>"
17014 msgstr ""
17016 #. type: textblock
17017 #: dpkg.cfg.pod
17018 msgid "I<~/.dpkg.cfg>"
17019 msgstr ""
17021 #. type: textblock
17022 #: dpkg.pod
17023 msgid "dpkg - package manager for Debian"
17024 msgstr ""
17026 #. type: textblock
17027 #: dpkg.pod
17028 msgid "B<dpkg> [I<option>...] I<action>"
17029 msgstr ""
17031 #. type: =head1
17032 #: dpkg.pod
17033 msgid "WARNING"
17034 msgstr ""
17036 #. type: textblock
17037 #: dpkg.pod
17038 msgid ""
17039 "This manual is intended for users wishing to understand B<dpkg>'s command "
17040 "line options and package states in more detail than that provided by B<dpkg "
17041 "--help>."
17042 msgstr ""
17044 #. type: textblock
17045 #: dpkg.pod
17046 msgid ""
17047 "It should I<not> be used by package maintainers wishing to understand how "
17048 "B<dpkg> will install their packages. The descriptions of what B<dpkg> does "
17049 "when installing and removing packages are particularly inadequate."
17050 msgstr ""
17052 #. type: textblock
17053 #: dpkg.pod
17054 msgid ""
17055 "B<dpkg> is a medium-level tool to install, build, remove and manage Debian "
17056 "packages.  The primary and more user-friendly front-end for B<dpkg> as a CLI "
17057 "(command-line interface) is B<apt>(8) and as a TUI (terminal user interface) "
17058 "is B<aptitude>(8).  B<dpkg> itself is controlled entirely via command line "
17059 "parameters, which consist of exactly one action and zero or more "
17060 "options. The action-parameter tells B<dpkg> what to do and options control "
17061 "the behavior of the action in some way."
17062 msgstr ""
17064 #. type: textblock
17065 #: dpkg.pod
17066 msgid ""
17067 "B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and "
17068 "B<dpkg-query>(1). The list of supported actions can be found later on in the "
17069 "B<ACTIONS> section. If any such action is encountered B<dpkg> just runs "
17070 "B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no "
17071 "specific options are currently passed to them, to use any such option the "
17072 "back-ends need to be called directly."
17073 msgstr ""
17075 #. type: =head1
17076 #: dpkg.pod
17077 msgid "INFORMATION ABOUT PACKAGES"
17078 msgstr ""
17080 #. type: textblock
17081 #: dpkg.pod
17082 msgid ""
17083 "B<dpkg> maintains some usable information about available packages. The "
17084 "information is divided in three classes: B<states>, B<selection states> and "
17085 "B<flags>. These values are intended to be changed mainly with B<dselect>."
17086 msgstr ""
17088 #. type: =head2
17089 #: dpkg.pod
17090 msgid "Package states"
17091 msgstr ""
17093 #. type: =item
17094 #: dpkg.pod
17095 msgid "B<not-installed>"
17096 msgstr ""
17098 #. type: textblock
17099 #: dpkg.pod
17100 msgid "The package is not installed on your system."
17101 msgstr ""
17103 #. type: =item
17104 #: dpkg.pod
17105 msgid "B<config-files>"
17106 msgstr ""
17108 #. type: textblock
17109 #: dpkg.pod
17110 msgid ""
17111 "Only the configuration files or the B<postrm> script and the data it needs "
17112 "to remove of the package exist on the system."
17113 msgstr ""
17115 #. type: =item
17116 #: dpkg.pod
17117 msgid "B<half-installed>"
17118 msgstr ""
17120 #. type: textblock
17121 #: dpkg.pod
17122 msgid ""
17123 "The installation of the package has been started, but not completed for some "
17124 "reason."
17125 msgstr ""
17127 #. type: =item
17128 #: dpkg.pod
17129 msgid "B<unpacked>"
17130 msgstr ""
17132 #. type: textblock
17133 #: dpkg.pod
17134 msgid "The package is unpacked, but not configured."
17135 msgstr ""
17137 #. type: =item
17138 #: dpkg.pod
17139 msgid "B<half-configured>"
17140 msgstr ""
17142 #. type: textblock
17143 #: dpkg.pod
17144 msgid ""
17145 "The package is unpacked and configuration has been started, but not yet "
17146 "completed for some reason."
17147 msgstr ""
17149 #. type: =item
17150 #: dpkg.pod
17151 msgid "B<triggers-awaited>"
17152 msgstr ""
17154 #. type: textblock
17155 #: dpkg.pod
17156 msgid "The package awaits trigger processing by another package."
17157 msgstr ""
17159 #. type: =item
17160 #: dpkg.pod
17161 msgid "B<triggers-pending>"
17162 msgstr ""
17164 #. type: textblock
17165 #: dpkg.pod
17166 msgid "The package has been triggered."
17167 msgstr ""
17169 #. type: =item
17170 #: dpkg.pod
17171 msgid "B<installed>"
17172 msgstr ""
17174 #. type: textblock
17175 #: dpkg.pod
17176 msgid "The package is correctly unpacked and configured."
17177 msgstr ""
17179 #. type: =head2
17180 #: dpkg.pod
17181 msgid "Package selection states"
17182 msgstr ""
17184 #. type: =item
17185 #: dpkg.pod
17186 msgid "B<install>"
17187 msgstr ""
17189 #. type: textblock
17190 #: dpkg.pod
17191 msgid "The package is selected for installation."
17192 msgstr ""
17194 #. type: =item
17195 #: dpkg.pod
17196 msgid "B<hold>"
17197 msgstr ""
17199 #. type: textblock
17200 #: dpkg.pod
17201 msgid ""
17202 "A package marked to be on B<hold> is kept on the same version, that is, no "
17203 "automatic new installs, upgrades or removals will be performed on them, "
17204 "unless these actions are requested explicitly, or are permitted to be done "
17205 "automatically with the B<--force-hold> option."
17206 msgstr ""
17208 #. type: =item
17209 #: dpkg.pod
17210 msgid "B<deinstall>"
17211 msgstr ""
17213 #. type: textblock
17214 #: dpkg.pod
17215 msgid ""
17216 "The package is selected for deinstallation (i.e. we want to remove all "
17217 "files, except configuration files)."
17218 msgstr ""
17220 #. type: =item
17221 #: dpkg.pod
17222 msgid "B<purge>"
17223 msgstr ""
17225 #. type: textblock
17226 #: dpkg.pod
17227 msgid ""
17228 "The package is selected to be purged (i.e. we want to remove everything from "
17229 "system directories, even configuration files)."
17230 msgstr ""
17232 #. type: =item
17233 #: dpkg.pod
17234 msgid "B<unknown>"
17235 msgstr ""
17237 #. type: textblock
17238 #: dpkg.pod
17239 msgid ""
17240 "The package selection is unknown.  A package that is also in a "
17241 "B<not-installed> state, and with an B<ok> flag will be forgotten in the next "
17242 "database store."
17243 msgstr ""
17245 #. type: =head2
17246 #: dpkg.pod
17247 msgid "Package flags"
17248 msgstr ""
17250 #. type: =item
17251 #: dpkg.pod
17252 msgid "B<ok>"
17253 msgstr ""
17255 #. type: textblock
17256 #: dpkg.pod
17257 msgid ""
17258 "A package marked B<ok> is in a known state, but might need further "
17259 "processing."
17260 msgstr ""
17262 #. type: =item
17263 #: dpkg.pod
17264 msgid "B<reinstreq>"
17265 msgstr ""
17267 #. type: textblock
17268 #: dpkg.pod
17269 msgid ""
17270 "A package marked B<reinstreq> is broken and requires reinstallation. These "
17271 "packages cannot be removed, unless forced with option "
17272 "B<--force-remove-reinstreq>."
17273 msgstr ""
17275 #. type: =head1
17276 #: dpkg.pod
17277 msgid "ACTIONS"
17278 msgstr ""
17280 #. type: =item
17281 #: dpkg.pod
17282 msgid "B<-i>, B<--install> I<package-file>..."
17283 msgstr ""
17285 #. type: textblock
17286 #: dpkg.pod
17287 msgid ""
17288 "Install the package. If B<--recursive> or B<-R> option is specified, "
17289 "I<package-file> must refer to a directory instead."
17290 msgstr ""
17292 #. type: textblock
17293 #: dpkg.pod
17294 msgid "Installation consists of the following steps:"
17295 msgstr ""
17297 #. type: textblock
17298 #: dpkg.pod
17299 msgid "B<1.> Extract the control files of the new package."
17300 msgstr ""
17302 #. type: textblock
17303 #: dpkg.pod
17304 msgid ""
17305 "B<2.> If another version of the same package was installed before the new "
17306 "installation, execute I<prerm> script of the old package."
17307 msgstr ""
17309 #. type: textblock
17310 #: dpkg.pod
17311 msgid "B<3.> Run I<preinst> script, if provided by the package."
17312 msgstr ""
17314 #. type: textblock
17315 #: dpkg.pod
17316 msgid ""
17317 "B<4.> Unpack the new files, and at the same time back up the old files, so "
17318 "that if something goes wrong, they can be restored."
17319 msgstr ""
17321 #. type: textblock
17322 #: dpkg.pod
17323 msgid ""
17324 "B<5.> If another version of the same package was installed before the new "
17325 "installation, execute the I<postrm> script of the old package. Note that "
17326 "this script is executed after the I<preinst> script of the new package, "
17327 "because new files are written at the same time old files are removed."
17328 msgstr ""
17330 #. type: textblock
17331 #: dpkg.pod
17332 msgid ""
17333 "B<6.> Configure the package. See B<--configure> for detailed information "
17334 "about how this is done."
17335 msgstr ""
17337 #. type: =item
17338 #: dpkg.pod
17339 msgid "B<--unpack> I<package-file>..."
17340 msgstr ""
17342 #. type: textblock
17343 #: dpkg.pod
17344 msgid ""
17345 "Unpack the package, but don't configure it. If B<--recursive> or B<-R> "
17346 "option is specified, I<package-file> must refer to a directory instead."
17347 msgstr ""
17349 #. type: textblock
17350 #: dpkg.pod
17351 msgid ""
17352 "Will process triggers for B<Pre-Depends> unless B<--no-triggers> has been "
17353 "specified."
17354 msgstr ""
17356 #. type: =item
17357 #: dpkg.pod
17358 msgid "B<--configure> I<package>...|B<-a>|B<--pending>"
17359 msgstr ""
17361 #. type: textblock
17362 #: dpkg.pod
17363 msgid ""
17364 "Configure a package which has been unpacked but not yet configured.  If "
17365 "B<-a> or B<--pending> is given instead of I<package>, all unpacked but "
17366 "unconfigured packages are configured."
17367 msgstr ""
17369 #. type: textblock
17370 #: dpkg.pod
17371 msgid ""
17372 "To reconfigure a package which has already been configured, try the "
17373 "B<dpkg-reconfigure>(8)  command instead."
17374 msgstr ""
17376 #. type: textblock
17377 #: dpkg.pod
17378 msgid "Configuring consists of the following steps:"
17379 msgstr ""
17381 #. type: textblock
17382 #: dpkg.pod
17383 msgid ""
17384 "B<1.> Unpack the conffiles, and at the same time back up the old conffiles, "
17385 "so that they can be restored if something goes wrong."
17386 msgstr ""
17388 #. type: textblock
17389 #: dpkg.pod
17390 msgid "B<2.> Run I<postinst> script, if provided by the package."
17391 msgstr ""
17393 #. type: textblock
17394 #: dpkg.pod
17395 msgid "Will process triggers unless B<--no-triggers> has been specified."
17396 msgstr ""
17398 #. type: =item
17399 #: dpkg.pod
17400 msgid "B<--triggers-only> I<package>...|B<-a>|B<--pending>"
17401 msgstr ""
17403 #. type: textblock
17404 #: dpkg.pod
17405 msgid ""
17406 "Processes only triggers (since dpkg 1.14.17).  All pending triggers will be "
17407 "processed.  If package names are supplied only those packages' triggers will "
17408 "be processed, exactly once each where necessary. Use of this option may "
17409 "leave packages in the improper B<triggers-awaited> and B<triggers-pending> "
17410 "states. This can be fixed later by running: B<dpkg --configure --pending>."
17411 msgstr ""
17413 #. type: =item
17414 #: dpkg.pod
17415 msgid "B<-r>, B<--remove> I<package>...|B<-a>|B<--pending>"
17416 msgstr ""
17418 #. type: textblock
17419 #: dpkg.pod
17420 msgid ""
17421 "Remove an installed package.  This removes everything except conffiles and "
17422 "other data cleaned up by the I<postrm> script, which may avoid having to "
17423 "reconfigure the package if it is reinstalled later (conffiles are "
17424 "configuration files that are listed in the I<DEBIAN/conffiles> control "
17425 "file).  If there is no I<DEBIAN/conffiles> control file nor I<DEBIAN/postrm> "
17426 "script, this command is equivalent to calling B<--purge>.  If B<-a> or "
17427 "B<--pending> is given instead of a package name, then all packages unpacked, "
17428 "but marked to be removed in file I<%ADMINDIR%/status>, are removed."
17429 msgstr ""
17431 #. type: textblock
17432 #: dpkg.pod
17433 msgid "Removing of a package consists of the following steps:"
17434 msgstr ""
17436 #. type: textblock
17437 #: dpkg.pod
17438 msgid "B<1.> Run I<prerm> script"
17439 msgstr ""
17441 #. type: textblock
17442 #: dpkg.pod
17443 msgid "B<2.> Remove the installed files"
17444 msgstr ""
17446 #. type: textblock
17447 #: dpkg.pod
17448 msgid "B<3.> Run I<postrm> script"
17449 msgstr ""
17451 #. type: =item
17452 #: dpkg.pod
17453 msgid "B<-P>, B<--purge> I<package>...|B<-a>|B<--pending>"
17454 msgstr ""
17456 #. type: textblock
17457 #: dpkg.pod
17458 msgid ""
17459 "Purge an installed or already removed package. This removes everything, "
17460 "including conffiles, and anything else cleaned up from I<postrm>.  If B<-a> "
17461 "or B<--pending> is given instead of a package name, then all packages "
17462 "unpacked or removed, but marked to be purged in file I<%ADMINDIR%/status>, "
17463 "are purged."
17464 msgstr ""
17466 #. type: textblock
17467 #: dpkg.pod
17468 msgid ""
17469 "B<Note:> Some configuration files might be unknown to B<dpkg> because they "
17470 "are created and handled separately through the configuration scripts. In "
17471 "that case, B<dpkg> won't remove them by itself, but the package's I<postrm> "
17472 "script (which is called by B<dpkg>), has to take care of their removal "
17473 "during purge. Of course, this only applies to files in system directories, "
17474 "not configuration files written to individual users' home directories."
17475 msgstr ""
17477 #. type: textblock
17478 #: dpkg.pod
17479 msgid "Purging of a package consists of the following steps:"
17480 msgstr ""
17482 #. type: textblock
17483 #: dpkg.pod
17484 msgid ""
17485 "B<1.> Remove the package, if not already removed. See B<--remove> for "
17486 "detailed information about how this is done."
17487 msgstr ""
17489 #. type: textblock
17490 #: dpkg.pod
17491 msgid "B<2.> Run I<postrm> script."
17492 msgstr ""
17494 #. type: =item
17495 #: dpkg.pod
17496 msgid "B<-V>, B<--verify> [I<package-name>...]"
17497 msgstr ""
17499 #. type: textblock
17500 #: dpkg.pod
17501 msgid ""
17502 "Verifies the integrity of I<package-name> or all packages if omitted, by "
17503 "comparing information from the files installed by a package with the files "
17504 "metadata information stored in the B<dpkg> database (since dpkg 1.17.2).  "
17505 "The origin of the files metadata information in the database is the binary "
17506 "packages themselves. That metadata gets collected at package unpack time "
17507 "during the installation process."
17508 msgstr ""
17510 #. type: textblock
17511 #: dpkg.pod
17512 msgid ""
17513 "Currently the only functional check performed is an md5sum verification of "
17514 "the file contents against the stored value in the files database.  It will "
17515 "only get checked if the database contains the file md5sum. To check for any "
17516 "missing metadata in the database, the B<--audit> command can be used."
17517 msgstr ""
17519 #. type: textblock
17520 #: dpkg.pod
17521 msgid ""
17522 "The output format is selectable with the B<--verify-format> option, which by "
17523 "default uses the B<rpm> format, but that might change in the future, and as "
17524 "such, programs parsing this command output should be explicit about the "
17525 "format they expect."
17526 msgstr ""
17528 #. type: =item
17529 #: dpkg.pod
17530 msgid "B<-C>, B<--audit> [I<package-name>...]"
17531 msgstr ""
17533 #. type: textblock
17534 #: dpkg.pod
17535 msgid ""
17536 "Performs database sanity and consistency checks for I<package-name> or all "
17537 "packages if omitted (per package checks since dpkg 1.17.10).  For example, "
17538 "searches for packages that have been installed only partially on your system "
17539 "or that have missing, wrong or obsolete control data or files. B<dpkg> will "
17540 "suggest what to do with them to get them fixed."
17541 msgstr ""
17543 #. type: =item
17544 #: dpkg.pod
17545 msgid "B<--update-avail> [I<Packages-file>]"
17546 msgstr ""
17548 #. type: =item
17549 #: dpkg.pod
17550 msgid "B<--merge-avail> [I<Packages-file>]"
17551 msgstr ""
17553 #. type: textblock
17554 #: dpkg.pod
17555 msgid ""
17556 "Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With "
17557 "action B<--merge-avail>, old information is combined with information from "
17558 "I<Packages-file>. With action B<--update-avail>, old information is replaced "
17559 "with the information in the I<Packages-file>. The I<Packages-file> "
17560 "distributed with Debian is simply named «I<Packages>». If the "
17561 "I<Packages-file> argument is missing or named «B<->» then it will be read "
17562 "from standard input (since dpkg 1.17.7). B<dpkg> keeps its record of "
17563 "available packages in I<%ADMINDIR%/available>."
17564 msgstr ""
17566 #. type: textblock
17567 #: dpkg.pod
17568 msgid ""
17569 "A simpler one-shot command to retrieve and update the I<available> file is "
17570 "B<dselect update>. Note that this file is mostly useless if you don't use "
17571 "B<dselect> but an APT-based frontend: APT has its own system to keep track "
17572 "of available packages."
17573 msgstr ""
17575 #. type: =item
17576 #: dpkg.pod
17577 msgid "B<-A>, B<--record-avail> I<package-file>..."
17578 msgstr ""
17580 #. type: textblock
17581 #: dpkg.pod
17582 msgid ""
17583 "Update B<dpkg> and B<dselect>'s idea of which packages are available with "
17584 "information from the package I<package-file>. If B<--recursive> or B<-R> "
17585 "option is specified, I<package-file> must refer to a directory instead."
17586 msgstr ""
17588 #. type: =item
17589 #: dpkg.pod
17590 msgid "B<--forget-old-unavail>"
17591 msgstr ""
17593 #. type: textblock
17594 #: dpkg.pod
17595 msgid ""
17596 "Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled "
17597 "unavailable packages (since dpkg 1.15.4), but only those that do not contain "
17598 "user information such as package selections."
17599 msgstr ""
17601 #. type: =item
17602 #: dpkg.pod
17603 msgid "B<--clear-avail>"
17604 msgstr ""
17606 #. type: textblock
17607 #: dpkg.pod
17608 msgid "Erase the existing information about what packages are available."
17609 msgstr ""
17611 #. type: =item
17612 #: dpkg.pod
17613 msgid "B<--get-selections> [I<package-name-pattern>...]"
17614 msgstr ""
17616 #. type: textblock
17617 #: dpkg.pod
17618 msgid ""
17619 "Get list of package selections, and write it to stdout. Without a pattern, "
17620 "non-installed packages (i.e. those which have been previously purged) will "
17621 "not be shown."
17622 msgstr ""
17624 #. type: =item
17625 #: dpkg.pod update-alternatives.pod
17626 msgid "B<--set-selections>"
17627 msgstr ""
17629 #. type: textblock
17630 #: dpkg.pod
17631 msgid ""
17632 "Set package selections using file read from stdin. This file should be in "
17633 "the format “I<package> I<state>”, where state is one of B<install>, B<hold>, "
17634 "B<deinstall> or B<purge>. Blank lines and comment lines beginning with "
17635 "‘B<#>’ are also permitted."
17636 msgstr ""
17638 #. type: textblock
17639 #: dpkg.pod
17640 msgid ""
17641 "The I<available> file needs to be up-to-date for this command to be useful, "
17642 "otherwise unknown packages will be ignored with a warning. See the "
17643 "B<--update-avail> and B<--merge-avail> commands for more information."
17644 msgstr ""
17646 #. type: =item
17647 #: dpkg.pod
17648 msgid "B<--clear-selections>"
17649 msgstr ""
17651 #. type: textblock
17652 #: dpkg.pod
17653 msgid ""
17654 "Set the requested state of every non-essential package to deinstall (since "
17655 "dpkg 1.13.18).  This is intended to be used immediately before "
17656 "B<--set-selections>, to deinstall any packages not in list given to "
17657 "B<--set-selections>."
17658 msgstr ""
17660 #. type: =item
17661 #: dpkg.pod
17662 msgid "B<--yet-to-unpack>"
17663 msgstr ""
17665 #. type: textblock
17666 #: dpkg.pod
17667 msgid ""
17668 "Searches for packages selected for installation, but which for some reason "
17669 "still haven't been installed."
17670 msgstr ""
17672 #. type: textblock
17673 #: dpkg.pod
17674 msgid ""
17675 "B<Note:> This command makes use of both the available file and the package "
17676 "selections."
17677 msgstr ""
17679 #. type: =item
17680 #: dpkg.pod
17681 msgid "B<--predep-package>"
17682 msgstr ""
17684 #. type: textblock
17685 #: dpkg.pod
17686 msgid ""
17687 "Print a single package which is the target of one or more relevant "
17688 "pre-dependencies and has itself no unsatisfied pre-dependencies."
17689 msgstr ""
17691 #. type: textblock
17692 #: dpkg.pod
17693 msgid ""
17694 "If such a package is present, output it as a Packages file entry, which can "
17695 "be massaged as appropriate."
17696 msgstr ""
17698 #. type: textblock
17699 #: dpkg.pod
17700 msgid ""
17701 "Returns 0 when a package is printed, 1 when no suitable package is available "
17702 "and 2 on error."
17703 msgstr ""
17705 #. type: =item
17706 #: dpkg.pod
17707 msgid "B<--add-architecture> I<architecture>"
17708 msgstr ""
17710 #. type: textblock
17711 #: dpkg.pod
17712 msgid ""
17713 "Add I<architecture> to the list of architectures for which packages can be "
17714 "installed without using B<--force-architecture> (since dpkg 1.16.2).  The "
17715 "architecture B<dpkg> is built for (i.e. the output of "
17716 "B<--print-architecture>)  is always part of that list."
17717 msgstr ""
17719 #. type: =item
17720 #: dpkg.pod
17721 msgid "B<--remove-architecture> I<architecture>"
17722 msgstr ""
17724 #. type: textblock
17725 #: dpkg.pod
17726 msgid ""
17727 "Remove I<architecture> from the list of architectures for which packages can "
17728 "be installed without using B<--force-architecture> (since dpkg 1.16.2). If "
17729 "the architecture is currently in use in the database then the operation will "
17730 "be refused, except if B<--force-architecture> is specified. The architecture "
17731 "B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never "
17732 "be removed from that list."
17733 msgstr ""
17735 #. type: =item
17736 #: dpkg.pod
17737 msgid "B<--print-architecture>"
17738 msgstr ""
17740 #. type: textblock
17741 #: dpkg.pod
17742 msgid "Print architecture of packages B<dpkg> installs (for example, “i386”)."
17743 msgstr ""
17745 #. type: =item
17746 #: dpkg.pod
17747 msgid "B<--print-foreign-architectures>"
17748 msgstr ""
17750 #. type: textblock
17751 #: dpkg.pod
17752 msgid ""
17753 "Print a newline-separated list of the extra architectures B<dpkg> is "
17754 "configured to allow packages to be installed for (since dpkg 1.16.2)."
17755 msgstr ""
17757 #. type: =item
17758 #: dpkg.pod
17759 msgid "B<--assert-help>"
17760 msgstr ""
17762 #. type: textblock
17763 #: dpkg.pod
17764 msgid "Give help about the B<--assert->I<feature> options (since dpkg 1.21.0)."
17765 msgstr ""
17767 #. type: =item
17768 #: dpkg.pod
17769 msgid "B<--assert->I<feature>"
17770 msgstr ""
17772 #. type: textblock
17773 #: dpkg.pod
17774 msgid ""
17775 "Asserts that B<dpkg> supports the requested feature.  Returns 0 if the "
17776 "feature is fully supported, 1 if the feature is known but B<dpkg> cannot "
17777 "provide support for it yet, and 2 if the feature is unknown.  The current "
17778 "list of assertable features is:"
17779 msgstr ""
17781 #. type: =item
17782 #: dpkg.pod
17783 msgid "B<support-predepends>"
17784 msgstr ""
17786 #. type: textblock
17787 #: dpkg.pod
17788 msgid "Supports the B<Pre-Depends> field (since dpkg 1.1.0)."
17789 msgstr ""
17791 #. type: =item
17792 #: dpkg.pod
17793 msgid "B<working-epoch>"
17794 msgstr ""
17796 #. type: textblock
17797 #: dpkg.pod
17798 msgid "Supports epochs in version strings (since dpkg 1.4.0.7)."
17799 msgstr ""
17801 #. type: =item
17802 #: dpkg.pod
17803 msgid "B<long-filenames>"
17804 msgstr ""
17806 #. type: textblock
17807 #: dpkg.pod
17808 msgid "Supports long filenames in B<deb>(5) archives (since dpkg 1.4.1.17)."
17809 msgstr ""
17811 #. type: =item
17812 #: dpkg.pod
17813 msgid "B<multi-conrep>"
17814 msgstr ""
17816 #. type: textblock
17817 #: dpkg.pod
17818 msgid "Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19)."
17819 msgstr ""
17821 #. type: =item
17822 #: dpkg.pod
17823 msgid "B<multi-arch>"
17824 msgstr ""
17826 #. type: textblock
17827 #: dpkg.pod
17828 msgid "Supports multi-arch fields and semantics (since dpkg 1.16.2)."
17829 msgstr ""
17831 #. type: =item
17832 #: dpkg.pod
17833 msgid "B<versioned-provides>"
17834 msgstr ""
17836 #. type: textblock
17837 #: dpkg.pod
17838 msgid "Supports versioned B<Provides> (since dpkg 1.17.11)."
17839 msgstr ""
17841 #. type: =item
17842 #: dpkg.pod
17843 msgid "B<protected-field>"
17844 msgstr ""
17846 #. type: textblock
17847 #: dpkg.pod
17848 msgid "Supports the B<Protected> field (since dpkg 1.20.1)."
17849 msgstr ""
17851 #. type: =item
17852 #: dpkg.pod
17853 msgid "B<--validate->I<thing> I<string>"
17854 msgstr ""
17856 #. type: textblock
17857 #: dpkg.pod
17858 msgid ""
17859 "Validate that the I<thing> I<string> has a correct syntax (since dpkg "
17860 "1.18.16).  Returns 0 if the I<string> is valid, 1 if the I<string> is "
17861 "invalid but might be accepted in lax contexts, and 2 if the I<string> is "
17862 "invalid.  The current list of validatable I<thing>s is:"
17863 msgstr ""
17865 #. type: =item
17866 #: dpkg.pod
17867 msgid "B<pkgname>"
17868 msgstr ""
17870 #. type: textblock
17871 #: dpkg.pod
17872 msgid "Validates the given package name (since dpkg 1.18.16)."
17873 msgstr ""
17875 #. type: =item
17876 #: dpkg.pod
17877 msgid "B<trigname>"
17878 msgstr ""
17880 #. type: textblock
17881 #: dpkg.pod
17882 msgid "Validates the given trigger name (since dpkg 1.18.16)."
17883 msgstr ""
17885 #. type: =item
17886 #: dpkg.pod
17887 msgid "B<archname>"
17888 msgstr ""
17890 #. type: textblock
17891 #: dpkg.pod
17892 msgid "Validates the given architecture name (since dpkg 1.18.16)."
17893 msgstr ""
17895 #. type: =item
17896 #: dpkg.pod
17897 msgid "B<version>"
17898 msgstr ""
17900 #. type: textblock
17901 #: dpkg.pod
17902 msgid "Validates the given version (since dpkg 1.18.16)."
17903 msgstr ""
17905 #. type: =item
17906 #: dpkg.pod
17907 msgid "B<--compare-versions> I<ver1> I<op> I<ver2>"
17908 msgstr ""
17910 #. type: textblock
17911 #: dpkg.pod
17912 msgid ""
17913 "Compare version numbers, where I<op> is a binary operator. B<dpkg> returns "
17914 "true (B<0>) if the specified condition is satisfied, and false (B<1>) "
17915 "otherwise. There are two groups of operators, which differ in how they treat "
17916 "an empty I<ver1> or I<ver2>. These treat an empty version as earlier than "
17917 "any version: B<lt le eq ne ge gt>. These treat an empty version as later "
17918 "than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for "
17919 "compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= "
17920 "E<gt>E<gt> E<gt>>. The B<E<lt>> and B<E<gt>> operators are obsolete and "
17921 "should B<not> be used, due to confusing semantics. To illustrate: B<0.1 "
17922 "E<lt> 0.1> evaluates to true."
17923 msgstr ""
17925 #. type: =end
17926 #: dpkg.pod
17927 msgid "disabled"
17928 msgstr ""
17930 #. type: =item
17931 #: dpkg.pod
17932 msgid "B<--command-fd> I<n>"
17933 msgstr ""
17935 #. type: textblock
17936 #: dpkg.pod
17937 msgid "Accept a series of commands on input file descriptor I<n>."
17938 msgstr ""
17940 #. type: textblock
17941 #: dpkg.pod
17942 msgid ""
17943 "B<Note:> Additional options set on the command line, and through this file "
17944 "descriptor, are not reset for subsequent commands executed during the same "
17945 "run."
17946 msgstr ""
17948 #. type: textblock
17949 #: dpkg.pod
17950 msgid "Display a brief help message."
17951 msgstr ""
17953 #. type: textblock
17954 #: dpkg.pod
17955 msgid "Give help about the B<--force->I<thing> options."
17956 msgstr ""
17958 #. type: =item
17959 #: dpkg.pod
17960 msgid "B<-Dh>, B<--debug=help>"
17961 msgstr ""
17963 #. type: textblock
17964 #: dpkg.pod
17965 msgid "Give help about debugging options."
17966 msgstr ""
17968 #. type: textblock
17969 #: dpkg.pod
17970 msgid "Display B<dpkg> version information."
17971 msgstr ""
17973 #. type: textblock
17974 #: dpkg.pod
17975 msgid ""
17976 "When used with B<--robot>, the output will be the program version number in "
17977 "a dotted numerical format, with no newline."
17978 msgstr ""
17980 #. type: =item
17981 #: dpkg.pod
17982 msgid "B<dpkg-deb actions>"
17983 msgstr ""
17985 #. type: textblock
17986 #: dpkg.pod
17987 msgid ""
17988 "See B<dpkg-deb>(1) for more information about the following actions, and "
17989 "other actions and options not exposed by the B<dpkg> front-end."
17990 msgstr ""
17992 #. type: =item
17993 #: dpkg.pod
17994 msgid "B<-b>, B<--build> I<directory> [I<archive>|I<directory>]"
17995 msgstr ""
17997 #. type: textblock
17998 #: dpkg.pod
17999 msgid "Build a deb package."
18000 msgstr ""
18002 #. type: textblock
18003 #: dpkg.pod
18004 msgid "List contents of a deb package."
18005 msgstr ""
18007 #. type: textblock
18008 #: dpkg.pod
18009 msgid "Extract control-information from a package."
18010 msgstr ""
18012 #. type: textblock
18013 #: dpkg.pod
18014 msgid "Extract the files contained by package."
18015 msgstr ""
18017 #. type: textblock
18018 #: dpkg.pod
18019 msgid "Extract and display the filenames contained by a package."
18020 msgstr ""
18022 #. type: =item
18023 #: dpkg.pod
18024 msgid "B<-f>, B<--field> I<archive> [I<control-field>...]"
18025 msgstr ""
18027 #. type: textblock
18028 #: dpkg.pod
18029 msgid "Display control field(s) of a package."
18030 msgstr ""
18032 #. type: textblock
18033 #: dpkg.pod
18034 msgid "Output the control tar-file contained in a Debian package."
18035 msgstr ""
18037 #. type: textblock
18038 #: dpkg.pod
18039 msgid "Output the filesystem tar-file contained by a Debian package."
18040 msgstr ""
18042 #. type: =item
18043 #: dpkg.pod
18044 msgid "B<-I>, B<--info> I<archive> [I<control-file>...]"
18045 msgstr ""
18047 #. type: textblock
18048 #: dpkg.pod
18049 msgid "Show information about a package."
18050 msgstr ""
18052 #. type: =item
18053 #: dpkg.pod
18054 msgid "B<dpkg-query actions>"
18055 msgstr ""
18057 #. type: textblock
18058 #: dpkg.pod
18059 msgid ""
18060 "See B<dpkg-query>(1) for more information about the following actions, and "
18061 "other actions and options not exposed by the B<dpkg> front-end."
18062 msgstr ""
18064 #. type: =item
18065 #: dpkg.pod
18066 msgid "B<-l>, B<--list> I<package-name-pattern>..."
18067 msgstr ""
18069 #. type: textblock
18070 #: dpkg.pod
18071 msgid "List packages matching given pattern."
18072 msgstr ""
18074 #. type: =item
18075 #: dpkg.pod
18076 msgid "B<-s>, B<--status> I<package-name>..."
18077 msgstr ""
18079 #. type: textblock
18080 #: dpkg.pod
18081 msgid "Report status of specified package."
18082 msgstr ""
18084 #. type: textblock
18085 #: dpkg.pod
18086 msgid "List files installed to your system from I<package-name>."
18087 msgstr ""
18089 #. type: textblock
18090 #: dpkg.pod
18091 msgid "Search for a filename from installed packages."
18092 msgstr ""
18094 #. type: =item
18095 #: dpkg.pod
18096 msgid "B<-p>, B<--print-avail> I<package-name>..."
18097 msgstr ""
18099 #. type: textblock
18100 #: dpkg.pod
18101 msgid ""
18102 "Display details about I<package-name>, as found in "
18103 "I<%ADMINDIR%/available>. Users of APT-based frontends should use B<apt show> "
18104 "I<package-name> instead."
18105 msgstr ""
18107 #. type: textblock
18108 #: dpkg.pod
18109 msgid ""
18110 "All options can be specified both on the command line and in the B<dpkg> "
18111 "configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names "
18112 "matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration directory "
18113 "I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration file is either "
18114 "an option (exactly the same as the command line option but without leading "
18115 "hyphens) or a comment (if it starts with a ‘B<#>’)."
18116 msgstr ""
18118 #. type: =item
18119 #: dpkg.pod
18120 msgid "B<--abort-after=>I<number>"
18121 msgstr ""
18123 #. type: textblock
18124 #: dpkg.pod
18125 msgid "Change after how many errors B<dpkg> will abort. The default is 50."
18126 msgstr ""
18128 #. type: =item
18129 #: dpkg.pod
18130 msgid "B<-B>, B<--auto-deconfigure>"
18131 msgstr ""
18133 #. type: textblock
18134 #: dpkg.pod
18135 msgid ""
18136 "When a package is removed, there is a possibility that another installed "
18137 "package depended on the removed package. Specifying this option will cause "
18138 "automatic deconfiguration of the package which depended on the removed "
18139 "package."
18140 msgstr ""
18142 #. type: =item
18143 #: dpkg.pod
18144 msgid "B<-D>I<octal>, B<--debug=>I<octal>"
18145 msgstr ""
18147 #. type: textblock
18148 #: dpkg.pod
18149 msgid ""
18150 "Switch debugging on. I<octal> is formed by bitwise-ORing desired values "
18151 "together from the list below (note that these values may change in future "
18152 "releases). B<-Dh> or B<--debug=help> display these debugging values."
18153 msgstr ""
18155 #. type: verbatim
18156 #: dpkg.pod
18157 #, no-wrap
18158 msgid ""
18159 "    Number   Description\n"
18160 "         1   Generally helpful progress information\n"
18161 "         2   Invocation and status of maintainer scripts\n"
18162 "        10   Output for each file processed\n"
18163 "       100   Lots of output for each file processed\n"
18164 "        20   Output for each configuration file\n"
18165 "       200   Lots of output for each configuration file\n"
18166 "        40   Dependencies and conflicts\n"
18167 "       400   Lots of dependencies/conflicts output\n"
18168 "     10000   Trigger activation and processing\n"
18169 "     20000   Lots of output regarding triggers\n"
18170 "     40000   Silly amounts of output regarding triggers\n"
18171 "      1000   Lots of drivel about for example the dpkg/info dir\n"
18172 "      2000   Insane amounts of drivel\n"
18173 "\n"
18174 msgstr ""
18176 #. type: textblock
18177 #: dpkg.pod
18178 msgid ""
18179 "Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some "
18180 "things. I<things> is a comma separated list of things specified "
18181 "below. B<--force-help> displays a message describing them.  Things marked "
18182 "with (*) are forced by default."
18183 msgstr ""
18185 #. type: textblock
18186 #: dpkg.pod
18187 msgid ""
18188 "I<Warning: These options are mostly intended to be used by experts "
18189 "only. Using them without fully understanding their effects may break your "
18190 "whole system.>"
18191 msgstr ""
18193 #. type: textblock
18194 #: dpkg.pod
18195 msgid ""
18196 "B<downgrade>(*): Install a package, even if newer version of it is already "
18197 "installed."
18198 msgstr ""
18200 #. type: textblock
18201 #: dpkg.pod
18202 msgid ""
18203 "I<Warning: At present> B<dpkg> I<does not do any dependency checking on "
18204 "downgrades and therefore will not warn you if the downgrade breaks the "
18205 "dependency of some other package. This can have serious side effects, "
18206 "downgrading essential system components can even make your whole system "
18207 "unusable. Use with care.>"
18208 msgstr ""
18210 #. type: textblock
18211 #: dpkg.pod
18212 msgid ""
18213 "B<configure-any>: Configure also any unpacked but unconfigured packages on "
18214 "which the current package depends."
18215 msgstr ""
18217 #. type: textblock
18218 #: dpkg.pod
18219 msgid ""
18220 "B<hold>: Allow automatic installs, upgrades or removals of packages even "
18221 "when marked to be on “hold”.  B<Note:> When these actions are requested "
18222 "explicitly, the “hold” package selection state always gets ignored."
18223 msgstr ""
18225 #. type: textblock
18226 #: dpkg.pod
18227 msgid ""
18228 "B<remove-reinstreq>: Remove a package, even if it's broken and marked to "
18229 "require reinstallation. This may, for example, cause parts of the package to "
18230 "remain on the system, which will then be forgotten by B<dpkg>."
18231 msgstr ""
18233 #. type: textblock
18234 #: dpkg.pod
18235 msgid ""
18236 "B<remove-protected>: Remove, even if the package is considered protected "
18237 "(since dpkg 1.20.1).  Protected packages contain mostly important system "
18238 "boot infrastructure or are used for custom system-local meta-packages.  "
18239 "Removing them might cause the whole system to be unable to boot or lose "
18240 "required functionality to operate, so use with caution."
18241 msgstr ""
18243 #. type: textblock
18244 #: dpkg.pod
18245 msgid ""
18246 "B<remove-essential>: Remove, even if the package is considered essential.  "
18247 "Essential packages contain mostly very basic Unix commands, required for the "
18248 "packaging system, for the operation of the system in general or during boot "
18249 "(although the latter should be converted to protected packages instead).  "
18250 "Removing them might cause the whole system to stop working, so use with "
18251 "caution."
18252 msgstr ""
18254 #. type: textblock
18255 #: dpkg.pod
18256 msgid ""
18257 "B<depends>: Turn all dependency problems into warnings.  This affects the "
18258 "B<Pre-Depends> and B<Depends> fields."
18259 msgstr ""
18261 #. type: textblock
18262 #: dpkg.pod
18263 msgid ""
18264 "B<depends-version>: Don't care about versions when checking dependencies.  "
18265 "This affects the B<Pre-Depends> and B<Depends> fields."
18266 msgstr ""
18268 #. type: textblock
18269 #: dpkg.pod
18270 msgid ""
18271 "B<breaks>: Install, even if this would break another package (since dpkg "
18272 "1.14.6).  This affects the B<Breaks> field."
18273 msgstr ""
18275 #. type: textblock
18276 #: dpkg.pod
18277 msgid ""
18278 "B<conflicts>: Install, even if it conflicts with another package. This is "
18279 "dangerous, for it will usually cause overwriting of some files.  This "
18280 "affects the B<Conflicts> field."
18281 msgstr ""
18283 #. type: textblock
18284 #: dpkg.pod
18285 msgid ""
18286 "B<confmiss>: Always install the missing conffile without prompting. This is "
18287 "dangerous, since it means not preserving a change (removing) made to the "
18288 "file."
18289 msgstr ""
18291 #. type: textblock
18292 #: dpkg.pod
18293 msgid ""
18294 "B<confnew>: If a conffile has been modified and the version in the package "
18295 "did change, always install the new version without prompting, unless the "
18296 "B<--force-confdef> is also specified, in which case the default action is "
18297 "preferred."
18298 msgstr ""
18300 #. type: textblock
18301 #: dpkg.pod
18302 msgid ""
18303 "B<confold>: If a conffile has been modified and the version in the package "
18304 "did change, always keep the old version without prompting, unless the "
18305 "B<--force-confdef> is also specified, in which case the default action is "
18306 "preferred."
18307 msgstr ""
18309 #. type: textblock
18310 #: dpkg.pod
18311 msgid ""
18312 "B<confdef>: If a conffile has been modified and the version in the package "
18313 "did change, always choose the default action without prompting. If there is "
18314 "no default action it will stop to ask the user unless B<--force-confnew> or "
18315 "B<--force-confold> is also been given, in which case it will use that to "
18316 "decide the final action."
18317 msgstr ""
18319 #. type: textblock
18320 #: dpkg.pod
18321 msgid ""
18322 "B<confask>: If a conffile has been modified always offer to replace it with "
18323 "the version in the package, even if the version in the package did not "
18324 "change (since dpkg 1.15.8).  If any of B<--force-confnew>, "
18325 "B<--force-confold>, or B<--force-confdef> is also given, it will be used to "
18326 "decide the final action."
18327 msgstr ""
18329 #. type: textblock
18330 #: dpkg.pod
18331 msgid "B<overwrite>: Overwrite one package's file with another's file."
18332 msgstr ""
18334 #. type: textblock
18335 #: dpkg.pod
18336 msgid "B<overwrite-dir>: Overwrite one package's directory with another's file."
18337 msgstr ""
18339 #. type: textblock
18340 #: dpkg.pod
18341 msgid "B<overwrite-diverted>: Overwrite a diverted file with an undiverted version."
18342 msgstr ""
18344 #. type: textblock
18345 #: dpkg.pod
18346 msgid ""
18347 "B<unsafe-io>: Do not perform safe I/O operations when unpacking (since dpkg "
18348 "1.15.8.6).  Currently this implies not performing file system syncs before "
18349 "file renames, which is known to cause substantial performance degradation on "
18350 "some file systems, unfortunately the ones that require the safe I/O on the "
18351 "first place due to their unreliable behaviour causing zero-length files on "
18352 "abrupt system crashes."
18353 msgstr ""
18355 #. type: textblock
18356 #: dpkg.pod
18357 msgid ""
18358 "I<Note>: For ext4, the main offender, consider using instead the mount "
18359 "option B<nodelalloc>, which will fix both the performance degradation and "
18360 "the data safety issues, the latter by making the file system not produce "
18361 "zero-length files on abrupt system crashes with any software not doing syncs "
18362 "before atomic renames."
18363 msgstr ""
18365 #. type: textblock
18366 #: dpkg.pod
18367 msgid ""
18368 "I<Warning: Using this option might improve performance at the cost of losing "
18369 "data, use with care.>"
18370 msgstr ""
18372 #. type: textblock
18373 #: dpkg.pod
18374 msgid ""
18375 "B<script-chrootless>: Run maintainer scripts without B<chroot>(2)ing into "
18376 "B<instdir> even if the package does not support this mode of operation "
18377 "(since dpkg 1.18.5)."
18378 msgstr ""
18380 #. type: textblock
18381 #: dpkg.pod
18382 msgid "I<Warning: This can destroy your host system, use with extreme care.>"
18383 msgstr ""
18385 #. type: textblock
18386 #: dpkg.pod
18387 msgid "B<architecture>: Process even packages with wrong or no architecture."
18388 msgstr ""
18390 #. type: textblock
18391 #: dpkg.pod
18392 msgid ""
18393 "B<bad-version>: Process even packages with wrong versions (since dpkg "
18394 "1.16.1)."
18395 msgstr ""
18397 #. type: textblock
18398 #: dpkg.pod
18399 msgid "B<bad-path>: B<PATH> is missing important programs, so problems are likely."
18400 msgstr ""
18402 #. type: textblock
18403 #: dpkg.pod
18404 msgid "B<not-root>: Try to (de)install things even when not root."
18405 msgstr ""
18407 #. type: textblock
18408 #: dpkg.pod
18409 msgid "B<bad-verify>: Install a package even if it fails authenticity check."
18410 msgstr ""
18412 #. type: =item
18413 #: dpkg.pod
18414 msgid "B<--ignore-depends>=I<package>,..."
18415 msgstr ""
18417 #. type: textblock
18418 #: dpkg.pod
18419 msgid ""
18420 "Ignore dependency-checking for specified packages (actually, checking is "
18421 "performed, but only warnings about conflicts are given, nothing else).  This "
18422 "affects the B<Pre-Depends>, B<Depends> and B<Breaks> fields."
18423 msgstr ""
18425 #. type: =item
18426 #: dpkg.pod
18427 msgid "B<--no-act>, B<--dry-run>, B<--simulate>"
18428 msgstr ""
18430 #. type: textblock
18431 #: dpkg.pod
18432 msgid ""
18433 "Do everything which is supposed to be done, but don't write any "
18434 "changes. This is used to see what would happen with the specified action, "
18435 "without actually modifying anything."
18436 msgstr ""
18438 #. type: textblock
18439 #: dpkg.pod
18440 msgid ""
18441 "Be sure to give B<--no-act> before the action-parameter, or you might end up "
18442 "with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first "
18443 "purge package “foo” and then try to purge package ”--no-act”, even though "
18444 "you probably expected it to actually do nothing)."
18445 msgstr ""
18447 #. type: =item
18448 #: dpkg.pod
18449 msgid "B<-R>, B<--recursive>"
18450 msgstr ""
18452 #. type: textblock
18453 #: dpkg.pod
18454 msgid ""
18455 "Recursively handle all regular files matching pattern B<*.deb> found at "
18456 "specified directories and all of its subdirectories. This can be used with "
18457 "B<-i>, B<-A>, B<--install>, B<--unpack> and B<--record-avail> actions."
18458 msgstr ""
18460 #. type: textblock
18461 #: dpkg.pod
18462 msgid ""
18463 "Don't install a package if a newer version of the same package is already "
18464 "installed. This is an alias of B<--refuse-downgrade>."
18465 msgstr ""
18467 #. type: textblock
18468 #: dpkg.pod
18469 msgid ""
18470 "Set the administrative directory to I<directory>.  This directory contains "
18471 "many files that give information about status of installed or uninstalled "
18472 "packages, etc.  Defaults to «I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been "
18473 "set."
18474 msgstr ""
18476 #. type: =item
18477 #: dpkg.pod
18478 msgid "B<--instdir=>I<dir>"
18479 msgstr ""
18481 #. type: textblock
18482 #: dpkg.pod
18483 msgid ""
18484 "Set the installation directory, which refers to the directory where packages "
18485 "are to be installed. B<instdir> is also the directory passed to B<chroot>(2) "
18486 "before running package's installation scripts, which means that the scripts "
18487 "see B<instdir> as a root directory.  Defaults to «I</>»."
18488 msgstr ""
18490 #. type: =item
18491 #: dpkg.pod
18492 msgid "B<--root=>I<dir>"
18493 msgstr ""
18495 #. type: textblock
18496 #: dpkg.pod
18497 msgid ""
18498 "Set the root directory to B<directory>, which sets the installation "
18499 "directory to «I<dir>» and the administrative directory to "
18500 "«I<dir>B<%ADMINDIR%>»."
18501 msgstr ""
18503 #. type: =item
18504 #: dpkg.pod
18505 msgid "B<-O>, B<--selected-only>"
18506 msgstr ""
18508 #. type: textblock
18509 #: dpkg.pod
18510 msgid ""
18511 "Only process the packages that are selected for installation. The actual "
18512 "marking is done with B<dselect> or by B<dpkg>, when it handles packages. For "
18513 "example, when a package is removed, it will be marked selected for "
18514 "deinstallation."
18515 msgstr ""
18517 #. type: =item
18518 #: dpkg.pod
18519 msgid "B<-E>, B<--skip-same-version>"
18520 msgstr ""
18522 #. type: textblock
18523 #: dpkg.pod
18524 msgid ""
18525 "Don't install the package if the same version and architecture of the "
18526 "package is already installed."
18527 msgstr ""
18529 #. type: textblock
18530 #: dpkg.pod
18531 msgid ""
18532 "Since dpkg 1.21.10, the architecture is also taken into account, which makes "
18533 "it possible to cross-grade packages or install additional co-installable "
18534 "instances with the same version, but different architecture."
18535 msgstr ""
18537 #. type: =item
18538 #: dpkg.pod
18539 msgid "B<--pre-invoke=>I<command>"
18540 msgstr ""
18542 #. type: =item
18543 #: dpkg.pod
18544 msgid "B<--post-invoke=>I<command>"
18545 msgstr ""
18547 #. type: textblock
18548 #: dpkg.pod
18549 msgid ""
18550 "Set an invoke hook I<command> to be run via “sh -c” before or after the "
18551 "B<dpkg> run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, "
18552 "I<remove>, I<purge>, I<add-architecture> and I<remove-architecture> B<dpkg> "
18553 "actions (since dpkg 1.15.4; I<add-architecture> and I<remove-architecture> "
18554 "actions since dpkg 1.17.19). This option can be specified multiple "
18555 "times. The order the options are specified is preserved, with the ones from "
18556 "the configuration files taking precedence.  The environment variable "
18557 "B<DPKG_HOOK_ACTION> is set for the hooks to the current B<dpkg> action."
18558 msgstr ""
18560 #. type: textblock
18561 #: dpkg.pod
18562 msgid ""
18563 "B<Note:> Front-ends might call B<dpkg> several times per invocation, which "
18564 "might run the hooks more times than expected."
18565 msgstr ""
18567 #. type: =item
18568 #: dpkg.pod
18569 msgid "B<--path-exclude=>I<glob-pattern>"
18570 msgstr ""
18572 #. type: =item
18573 #: dpkg.pod
18574 msgid "B<--path-include=>I<glob-pattern>"
18575 msgstr ""
18577 #. type: textblock
18578 #: dpkg.pod
18579 msgid ""
18580 "Set I<glob-pattern> as a path filter, either by excluding or re-including "
18581 "previously excluded paths matching the specified patterns during install "
18582 "(since dpkg 1.15.8)."
18583 msgstr ""
18585 #. type: textblock
18586 #: dpkg.pod
18587 msgid ""
18588 "I<Warning: Take into account that depending on the excluded paths you might "
18589 "completely break your system, use with caution.>"
18590 msgstr ""
18592 #. type: textblock
18593 #: dpkg.pod
18594 msgid ""
18595 "The glob patterns use the same wildcards used in the shell, were ‘*’ matches "
18596 "any sequence of characters, including the empty string and also ‘/’.  For "
18597 "example, «I</usr/*/READ*>» matches «I</usr/share/doc/package/README>».  As "
18598 "usual, ‘?’ matches any single character (again, including ‘/’).  And ‘[’ "
18599 "starts a character class, which can contain a list of characters, ranges and "
18600 "complementations. See B<glob>(7) for detailed information about globbing.  "
18601 "B<Note:> The current implementation might re-include more directories and "
18602 "symlinks than needed, in particular when there is a more specific "
18603 "re-inclusion, to be on the safe side and avoid possible unpack failures; "
18604 "future work might fix this."
18605 msgstr ""
18607 #. type: textblock
18608 #: dpkg.pod
18609 msgid ""
18610 "This can be used to remove all paths except some particular ones; a typical "
18611 "case is:"
18612 msgstr ""
18614 #. type: verbatim
18615 #: dpkg.pod
18616 #, no-wrap
18617 msgid ""
18618 " --path-exclude=/usr/share/doc/*\n"
18619 " --path-include=/usr/share/doc/*/copyright\n"
18620 "\n"
18621 msgstr ""
18623 #. type: textblock
18624 #: dpkg.pod
18625 msgid "to remove all documentation files except the copyright files."
18626 msgstr ""
18628 #. type: textblock
18629 #: dpkg.pod
18630 msgid ""
18631 "These two options can be specified multiple times, and interleaved with each "
18632 "other. Both are processed in the given order, with the last rule that "
18633 "matches a file name making the decision."
18634 msgstr ""
18636 #. type: textblock
18637 #: dpkg.pod
18638 msgid ""
18639 "The filters are applied when unpacking the binary packages, and as such only "
18640 "have knowledge of the type of object currently being filtered (e.g. a normal "
18641 "file or a directory) and have not visibility of what objects will come "
18642 "next.  Because these filters have side effects (in contrast to B<find>(1)  "
18643 "filters), excluding an exact pathname that happens to be a directory object "
18644 "like I</usr/share/doc> will not have the desired result, and only that "
18645 "pathname will be excluded (which could be automatically reincluded if the "
18646 "code sees the need).  Any subsequent files contained within that directory "
18647 "will fail to unpack."
18648 msgstr ""
18650 #. type: textblock
18651 #: dpkg.pod
18652 msgid "Hint: make sure the globs are not expanded by your shell."
18653 msgstr ""
18655 #. type: =item
18656 #: dpkg.pod
18657 msgid "B<--verify-format> I<format-name>"
18658 msgstr ""
18660 #. type: textblock
18661 #: dpkg.pod
18662 msgid "Sets the output format for the B<--verify> command (since dpkg 1.17.2)."
18663 msgstr ""
18665 #. type: textblock
18666 #: dpkg.pod
18667 msgid ""
18668 "The only currently supported output format is B<rpm>, which consists of a "
18669 "line for every path that failed any check.  These lines have the following "
18670 "format:"
18671 msgstr ""
18673 #. type: verbatim
18674 #: dpkg.pod
18675 #, no-wrap
18676 msgid ""
18677 "Z<>\n"
18678 " B<missing  > [B<c>] I<pathname> [B<(>I<error-message>B<)>]\n"
18679 " B<??5??????> [B<c>] I<pathname>\n"
18680 "\n"
18681 msgstr ""
18683 #. type: textblock
18684 #: dpkg.pod
18685 msgid ""
18686 "The first 9 characters are used to report the checks result, either a "
18687 "literal B<missing> when the file is not present or its metadata cannot be "
18688 "fetched, or one of the following special characters that report the result "
18689 "for each check:"
18690 msgstr ""
18692 #. type: =item
18693 #: dpkg.pod
18694 msgid "‘B<?>’"
18695 msgstr ""
18697 #. type: textblock
18698 #: dpkg.pod
18699 msgid ""
18700 "Implies the check could not be done (lack of support, file permissions, "
18701 "etc)."
18702 msgstr ""
18704 #. type: =item
18705 #: dpkg.pod
18706 msgid "‘B<.>’"
18707 msgstr ""
18709 #. type: textblock
18710 #: dpkg.pod
18711 msgid "Implies the check passed."
18712 msgstr ""
18714 #. type: =item
18715 #: dpkg.pod
18716 msgid "‘I<A-Za-z0-9>’"
18717 msgstr ""
18719 #. type: textblock
18720 #: dpkg.pod
18721 msgid ""
18722 "Implies a specific check failed.  The following positions and alphanumeric "
18723 "characters are currently supported:"
18724 msgstr ""
18726 #. type: =item
18727 #: dpkg.pod
18728 msgid "1 ‘B<?>’"
18729 msgstr ""
18731 #. type: textblock
18732 #: dpkg.pod
18733 msgid "These checks are currently not supported, will always be ‘B<?>’."
18734 msgstr ""
18736 #. type: =item
18737 #: dpkg.pod
18738 msgid "2 ‘B<M>’"
18739 msgstr ""
18741 #. type: textblock
18742 #: dpkg.pod
18743 msgid ""
18744 "The file mode check failed (since dpkg 1.21.0).  Because pathname metadata "
18745 "is currently not tracked, this check can only be partially emulated via a "
18746 "very simple heuristic for pathnames that have a known digest, which implies "
18747 "they should be regular files, where the check will fail if the pathname is "
18748 "not a regular file on the filesystem.  This check will currently never "
18749 "succeed as it does not have enough information available."
18750 msgstr ""
18752 #. type: =item
18753 #: dpkg.pod
18754 msgid "3 ‘B<5>’"
18755 msgstr ""
18757 #. type: textblock
18758 #: dpkg.pod
18759 msgid "The digest check failed, which means the file contents have changed."
18760 msgstr ""
18762 #. type: =item
18763 #: dpkg.pod
18764 msgid "4-9 ‘B<?>’"
18765 msgstr ""
18767 #. type: textblock
18768 #: dpkg.pod
18769 msgid ""
18770 "The line is followed by a space and an attribute character.  The following "
18771 "attribute character is supported:"
18772 msgstr ""
18774 #. type: =item
18775 #: dpkg.pod
18776 msgid "‘B<c>’"
18777 msgstr ""
18779 #. type: textblock
18780 #: dpkg.pod
18781 msgid "The pathname is a conffile."
18782 msgstr ""
18784 #. type: textblock
18785 #: dpkg.pod
18786 msgid "Finally followed by another space and the pathname."
18787 msgstr ""
18789 #. type: textblock
18790 #: dpkg.pod
18791 msgid ""
18792 "In case the entry was of the B<missing> type, and the file was not actually "
18793 "present on the filesystem, then the line is followed by a space and the "
18794 "error message enclosed within parenthesis."
18795 msgstr ""
18797 #. type: =item
18798 #: dpkg.pod
18799 msgid "B<--status-fd> I<n>"
18800 msgstr ""
18802 #. type: textblock
18803 #: dpkg.pod
18804 msgid ""
18805 "Send machine-readable package status and progress information to file "
18806 "descriptor I<n>. This option can be specified multiple times. The "
18807 "information is generally one record per line, in one of the following forms:"
18808 msgstr ""
18810 #. type: =item
18811 #: dpkg.pod
18812 msgid "B<status:> I<package>B<:> I<status>"
18813 msgstr ""
18815 #. type: textblock
18816 #: dpkg.pod
18817 msgid "Package status changed; I<status> is as in the status file."
18818 msgstr ""
18820 #. type: =item
18821 #: dpkg.pod
18822 msgid "B<status:> I<package> B<: error :> I<extended-error-message>"
18823 msgstr ""
18825 #. type: textblock
18826 #: dpkg.pod
18827 msgid ""
18828 "An error occurred. Any possible newlines in I<extended-error-message> will "
18829 "be converted to spaces before output."
18830 msgstr ""
18832 #. type: =item
18833 #: dpkg.pod
18834 msgid ""
18835 "B<status:> I<file> B<: conffile-prompt : '>I<real-old>B<' '>I<real-new>B<'> "
18836 "I<useredited> I<distedited>"
18837 msgstr ""
18839 #. type: textblock
18840 #: dpkg.pod
18841 msgid "User is being asked a conffile question."
18842 msgstr ""
18844 #. type: =item
18845 #: dpkg.pod
18846 msgid "B<processing:> I<stage>B<:> I<package>"
18847 msgstr ""
18849 #. type: textblock
18850 #: dpkg.pod
18851 msgid ""
18852 "Sent just before a processing stage starts. I<stage> is one of B<upgrade>, "
18853 "B<install> (both sent before unpacking), B<configure>, B<trigproc>, "
18854 "B<disappear>, B<remove>, B<purge>."
18855 msgstr ""
18857 #. type: =item
18858 #: dpkg.pod
18859 msgid "B<--status-logger>=I<command>"
18860 msgstr ""
18862 #. type: textblock
18863 #: dpkg.pod
18864 msgid ""
18865 "Send machine-readable package status and progress information to the shell "
18866 "I<command>'s standard input, to be run via “sh -c” (since dpkg 1.16.0).  "
18867 "This option can be specified multiple times.  The output format used is the "
18868 "same as in B<--status-fd>."
18869 msgstr ""
18871 #. type: =item
18872 #: dpkg.pod
18873 msgid "B<--log=>I<filename>"
18874 msgstr ""
18876 #. type: textblock
18877 #: dpkg.pod
18878 msgid ""
18879 "Log status change updates and actions to I<filename>, instead of the default "
18880 "I<%LOGDIR%/dpkg.log>. If this option is given multiple times, the last "
18881 "filename is used. Log messages are of the form:"
18882 msgstr ""
18884 #. type: =item
18885 #: dpkg.pod
18886 msgid "YYYY-MM-DD HH:MM:SS B<startup> I<type> I<command>"
18887 msgstr ""
18889 #. type: textblock
18890 #: dpkg.pod
18891 msgid ""
18892 "For each dpkg invocation where I<type> is B<archives> (with a I<command> of "
18893 "B<unpack> or B<install>) or B<packages> (with a I<command> of B<configure>, "
18894 "B<triggers-only>, B<remove> or B<purge>)."
18895 msgstr ""
18897 #. type: =item
18898 #: dpkg.pod
18899 msgid "YYYY-MM-DD HH:MM:SS B<status> I<state> I<pkg> I<installed-version>"
18900 msgstr ""
18902 #. type: textblock
18903 #: dpkg.pod
18904 msgid "For status change updates."
18905 msgstr ""
18907 #. type: =item
18908 #: dpkg.pod
18909 msgid ""
18910 "YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> "
18911 "I<available-version>"
18912 msgstr ""
18914 #. type: textblock
18915 #: dpkg.pod
18916 msgid ""
18917 "For actions where I<action> is one of B<install>, B<upgrade>, B<configure>, "
18918 "B<trigproc>, B<disappear>, B<remove> or B<purge>."
18919 msgstr ""
18921 #. type: =item
18922 #: dpkg.pod
18923 msgid "YYYY-MM-DD HH:MM:SS B<conffile> I<filename> I<decision>"
18924 msgstr ""
18926 #. type: textblock
18927 #: dpkg.pod
18928 msgid "For conffile changes where I<decision> is either B<install> or B<keep>."
18929 msgstr ""
18931 #. type: =item
18932 #: dpkg.pod
18933 msgid "B<--robot>"
18934 msgstr ""
18936 #. type: textblock
18937 #: dpkg.pod
18938 msgid ""
18939 "Use a machine-readable output format. This provides an interface for "
18940 "programs that need to parse the output of some of the commands that do not "
18941 "otherwise emit a machine-readable output format. No localization will be "
18942 "used, and the output will be modified to make it easier to parse."
18943 msgstr ""
18945 #. type: textblock
18946 #: dpkg.pod
18947 msgid "The only currently supported command is B<--version>."
18948 msgstr ""
18950 #. type: =item
18951 #: dpkg.pod
18952 msgid "B<--no-debsig>"
18953 msgstr ""
18955 #. type: textblock
18956 #: dpkg.pod
18957 msgid "Do not try to verify package signatures."
18958 msgstr ""
18960 #. type: =item
18961 #: dpkg.pod
18962 msgid "B<--no-triggers>"
18963 msgstr ""
18965 #. type: textblock
18966 #: dpkg.pod
18967 msgid ""
18968 "Do not run any triggers in this run (since dpkg 1.14.17), but activations "
18969 "will still be recorded.  If used with B<--configure> I<package> or "
18970 "B<--triggers-only> I<package> then the named package postinst will still be "
18971 "run even if only a triggers run is needed. Use of this option may leave "
18972 "packages in the improper B<triggers-awaited> and B<triggers-pending> "
18973 "states. This can be fixed later by running: B<dpkg --configure --pending>."
18974 msgstr ""
18976 #. type: =item
18977 #: dpkg.pod
18978 msgid "B<--triggers>"
18979 msgstr ""
18981 #. type: textblock
18982 #: dpkg.pod
18983 msgid "Cancels a previous B<--no-triggers> (since dpkg 1.14.17)."
18984 msgstr ""
18986 #. type: =item
18987 #: dpkg.pod
18988 msgid "B<PATH>"
18989 msgstr ""
18991 #. type: textblock
18992 #: dpkg.pod
18993 msgid ""
18994 "This variable is expected to be defined in the environment and point to the "
18995 "system paths where several required programs are to be found. If it's not "
18996 "set or the programs are not found, B<dpkg> will abort."
18997 msgstr ""
18999 #. type: =item
19000 #: dpkg.pod dselect.pod
19001 msgid "B<HOME>"
19002 msgstr ""
19004 #. type: textblock
19005 #: dpkg.pod
19006 msgid ""
19007 "If set, B<dpkg> will use it as the directory from which to read the user "
19008 "specific configuration file."
19009 msgstr ""
19011 #. type: textblock
19012 #: dpkg.pod
19013 msgid ""
19014 "If set, B<dpkg> will use it as the directory in which to create temporary "
19015 "files and directories."
19016 msgstr ""
19018 #. type: textblock
19019 #: dpkg.pod
19020 msgid ""
19021 "The program B<dpkg> will execute when starting a new interactive shell, or "
19022 "when spawning a command via a shell."
19023 msgstr ""
19025 #. type: textblock
19026 #: dpkg.pod
19027 msgid ""
19028 "The program B<dpkg> will execute when running a pager, which will be "
19029 "executed with «B<$SHELL -c>», for example when displaying the conffile "
19030 "differences.  If B<SHELL> is not set, «B<sh>» will be used instead.  The "
19031 "B<DPKG_PAGER> overrides the B<PAGER> environment variable (since dpkg "
19032 "1.19.2)."
19033 msgstr ""
19035 #. type: textblock
19036 #: dpkg.pod
19037 msgid ""
19038 "Sets the debug mask (since dpkg 1.21.10) from an octal value.  The currently "
19039 "accepted flags are described in the B<--debug> option."
19040 msgstr ""
19042 #. type: textblock
19043 #: dpkg.pod
19044 msgid ""
19045 "Sets the force flags (since dpkg 1.19.5).  When this variable is present, no "
19046 "built-in force defaults will be applied.  If the variable is present but "
19047 "empty, all force flags will be disabled."
19048 msgstr ""
19050 #. type: textblock
19051 #: dpkg.pod
19052 msgid ""
19053 "If set and the B<--admindir> or B<--root> options have not been specified, "
19054 "it will be used as the B<dpkg> administrative directory (since dpkg 1.20.0)."
19055 msgstr ""
19057 #. type: =item
19058 #: dpkg.pod
19059 msgid "B<DPKG_FRONTEND_LOCKED>"
19060 msgstr ""
19062 #. type: textblock
19063 #: dpkg.pod
19064 msgid ""
19065 "Set by a package manager frontend to notify dpkg that it should not acquire "
19066 "the frontend lock (since dpkg 1.19.1)."
19067 msgstr ""
19069 #. type: textblock
19070 #: dpkg.pod
19071 msgid ""
19072 "Defined by B<dpkg> to “B<-FRSXMQ>”, if not already set, when spawning a "
19073 "pager (since dpkg 1.19.2).  To change the default behavior, this variable "
19074 "can be preset to some other value including an empty string, or the B<PAGER> "
19075 "or B<DPKG_PAGER> variables can be set to disable specific options with "
19076 "«B<-+>», for example B<DPKG_PAGER=\"less -+F\">."
19077 msgstr ""
19079 #. type: textblock
19080 #: dpkg.pod
19081 msgid ""
19082 "Defined by B<dpkg> on the maintainer script environment to indicate which "
19083 "installation to act on (since dpkg 1.18.5).  The value is intended to be "
19084 "prepended to any path maintainer scripts operate on.  During normal "
19085 "operation, this variable is empty.  When installing packages into a "
19086 "different B<instdir>, B<dpkg> normally invokes maintainer scripts using "
19087 "B<chroot>(2) and leaves this variable empty, but if "
19088 "B<--force-script-chrootless> is specified then the B<chroot>(2) call is "
19089 "skipped and B<instdir> is non-empty."
19090 msgstr ""
19092 #. type: textblock
19093 #: dpkg.pod
19094 msgid ""
19095 "Defined by B<dpkg> on the maintainer script environment to indicate the "
19096 "B<dpkg> administrative directory to use (since dpkg 1.16.0).  This variable "
19097 "is always set to the current B<--admindir> value."
19098 msgstr ""
19100 #. type: textblock
19101 #: dpkg.pod
19102 msgid ""
19103 "Defined by B<dpkg> on the subprocesses environment to all the currently "
19104 "enabled force option names separated by commas (since dpkg 1.19.5)."
19105 msgstr ""
19107 #. type: =item
19108 #: dpkg.pod
19109 msgid "B<DPKG_SHELL_REASON>"
19110 msgstr ""
19112 #. type: textblock
19113 #: dpkg.pod
19114 msgid ""
19115 "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
19116 "the situation (since dpkg 1.15.6).  Current valid value: B<conffile-prompt>."
19117 msgstr ""
19119 #. type: =item
19120 #: dpkg.pod
19121 msgid "B<DPKG_CONFFILE_OLD>"
19122 msgstr ""
19124 #. type: textblock
19125 #: dpkg.pod
19126 msgid ""
19127 "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
19128 "the situation (since dpkg 1.15.6).  Contains the path to the old conffile."
19129 msgstr ""
19131 #. type: =item
19132 #: dpkg.pod
19133 msgid "B<DPKG_CONFFILE_NEW>"
19134 msgstr ""
19136 #. type: textblock
19137 #: dpkg.pod
19138 msgid ""
19139 "Defined by B<dpkg> on the shell spawned on the conffile prompt to examine "
19140 "the situation (since dpkg 1.15.6).  Contains the path to the new conffile."
19141 msgstr ""
19143 #. type: =item
19144 #: dpkg.pod
19145 msgid "B<DPKG_HOOK_ACTION>"
19146 msgstr ""
19148 #. type: textblock
19149 #: dpkg.pod
19150 msgid ""
19151 "Defined by B<dpkg> on the shell spawned when executing a hook action (since "
19152 "dpkg 1.15.4).  Contains the current B<dpkg> action."
19153 msgstr ""
19155 #. type: =item
19156 #: dpkg.pod
19157 msgid "B<DPKG_RUNNING_VERSION>"
19158 msgstr ""
19160 #. type: textblock
19161 #: dpkg.pod
19162 msgid ""
19163 "Defined by B<dpkg> on the maintainer script environment to the version of "
19164 "the currently running B<dpkg> instance (since dpkg 1.14.17)."
19165 msgstr ""
19167 #. type: textblock
19168 #: dpkg.pod
19169 msgid ""
19170 "Defined by B<dpkg> on the maintainer script environment to the "
19171 "(non-arch-qualified) package name being handled (since dpkg 1.14.17)."
19172 msgstr ""
19174 #. type: =item
19175 #: dpkg.pod
19176 msgid "B<DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT>"
19177 msgstr ""
19179 #. type: textblock
19180 #: dpkg.pod
19181 msgid ""
19182 "Defined by B<dpkg> on the maintainer script environment to the package "
19183 "reference count, i.e. the number of package instances with a state greater "
19184 "than B<not-installed> (since dpkg 1.17.2)."
19185 msgstr ""
19187 #. type: =item
19188 #: dpkg.pod
19189 msgid "B<DPKG_MAINTSCRIPT_ARCH>"
19190 msgstr ""
19192 #. type: textblock
19193 #: dpkg.pod
19194 msgid ""
19195 "Defined by B<dpkg> on the maintainer script environment to the architecture "
19196 "the package got built for (since dpkg 1.15.4)."
19197 msgstr ""
19199 #. type: =item
19200 #: dpkg.pod
19201 msgid "B<DPKG_MAINTSCRIPT_NAME>"
19202 msgstr ""
19204 #. type: textblock
19205 #: dpkg.pod
19206 msgid ""
19207 "Defined by B<dpkg> on the maintainer script environment to the name of the "
19208 "script running, one of B<preinst>, B<postinst>, B<prerm> or B<postrm> (since "
19209 "dpkg 1.15.7)."
19210 msgstr ""
19212 #. type: =item
19213 #: dpkg.pod
19214 msgid "B<DPKG_MAINTSCRIPT_DEBUG>"
19215 msgstr ""
19217 #. type: textblock
19218 #: dpkg.pod
19219 msgid ""
19220 "Defined by B<dpkg> on the maintainer script environment to a value (‘B<0>’ "
19221 "or ‘B<1>’) noting whether debugging has been requested (with the B<--debug> "
19222 "option) for the maintainer scripts (since dpkg 1.18.4)."
19223 msgstr ""
19225 #. type: textblock
19226 #: dpkg.pod
19227 msgid "Configuration fragment files (since dpkg 1.15.4)."
19228 msgstr ""
19230 #. type: textblock
19231 #: dpkg.pod
19232 msgid "Configuration file with default options."
19233 msgstr ""
19235 #. type: =item
19236 #: dpkg.pod
19237 msgid "I<%LOGDIR%/dpkg.log>"
19238 msgstr ""
19240 #. type: textblock
19241 #: dpkg.pod
19242 msgid "Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>)."
19243 msgstr ""
19245 #. type: textblock
19246 #: dpkg.pod
19247 msgid ""
19248 "The other files listed below are in their default directories, see option "
19249 "B<--admindir> to see how to change locations of these files."
19250 msgstr ""
19252 #. type: =item
19253 #: dpkg.pod
19254 msgid "I<%ADMINDIR%/available>"
19255 msgstr ""
19257 #. type: textblock
19258 #: dpkg.pod
19259 msgid "List of available packages."
19260 msgstr ""
19262 #. type: =item
19263 #: dpkg.pod
19264 msgid "I<%ADMINDIR%/status>"
19265 msgstr ""
19267 #. type: textblock
19268 #: dpkg.pod
19269 msgid ""
19270 "Statuses of available packages. This file contains information about whether "
19271 "a package is marked for removing or not, whether it is installed or not, "
19272 "etc. See section B<INFORMATION ABOUT PACKAGES> for more info."
19273 msgstr ""
19275 #. type: textblock
19276 #: dpkg.pod
19277 msgid ""
19278 "The status file is backed up daily in I<%BACKUPSDIR%>. It can be useful if "
19279 "it's lost or corrupted due to filesystems troubles."
19280 msgstr ""
19282 #. type: textblock
19283 #: dpkg.pod
19284 msgid "The format and contents of a binary package are described in B<deb>(5)."
19285 msgstr ""
19287 #. type: textblock
19288 #: dpkg.pod
19289 msgid "B<--no-act> usually gives less information than might be helpful."
19290 msgstr ""
19292 #. type: textblock
19293 #: dpkg.pod
19294 msgid ""
19295 "To list installed packages related to the editor B<vi>(1) (note that "
19296 "B<dpkg-query> does not load the I<available> file anymore by default, and "
19297 "the B<dpkg-query> B<--load-avail> option should be used instead for that):"
19298 msgstr ""
19300 #. type: verbatim
19301 #: dpkg.pod
19302 #, no-wrap
19303 msgid ""
19304 " dpkg -l '*vi*'\n"
19305 "\n"
19306 msgstr ""
19308 #. type: textblock
19309 #: dpkg.pod
19310 msgid "To see the entries in I<%ADMINDIR%/available> of two packages:"
19311 msgstr ""
19313 #. type: verbatim
19314 #: dpkg.pod
19315 #, no-wrap
19316 msgid ""
19317 " dpkg --print-avail elvis vim | less\n"
19318 "\n"
19319 msgstr ""
19321 #. type: textblock
19322 #: dpkg.pod
19323 msgid "To search the listing of packages yourself:"
19324 msgstr ""
19326 #. type: verbatim
19327 #: dpkg.pod
19328 #, no-wrap
19329 msgid ""
19330 " less %ADMINDIR%/available\n"
19331 "\n"
19332 msgstr ""
19334 #. type: textblock
19335 #: dpkg.pod
19336 msgid "To remove an installed elvis package:"
19337 msgstr ""
19339 #. type: verbatim
19340 #: dpkg.pod
19341 #, no-wrap
19342 msgid ""
19343 " dpkg -r elvis\n"
19344 "\n"
19345 msgstr ""
19347 #. type: textblock
19348 #: dpkg.pod
19349 msgid ""
19350 "To install a package, you first need to find it in an archive or CDROM. The "
19351 "I<available> file shows that the vim package is in section B<editors>:"
19352 msgstr ""
19354 #. type: verbatim
19355 #: dpkg.pod
19356 #, no-wrap
19357 msgid ""
19358 " cd /media/cdrom/pool/main/v/vim\n"
19359 " dpkg -i vim_4.5-3.deb\n"
19360 "\n"
19361 msgstr ""
19363 #. type: textblock
19364 #: dpkg.pod
19365 msgid "To make a local copy of the package selection states:"
19366 msgstr ""
19368 #. type: verbatim
19369 #: dpkg.pod
19370 #, no-wrap
19371 msgid ""
19372 " dpkg --get-selections> myselections\n"
19373 "\n"
19374 msgstr ""
19376 #. type: textblock
19377 #: dpkg.pod
19378 msgid ""
19379 "You might transfer this file to another computer, and after having updated "
19380 "the I<available> file there with your package manager frontend of choice "
19381 "(see L<https://wiki.debian.org/Teams/Dpkg/FAQ#set-selections> for more "
19382 "details), for example:"
19383 msgstr ""
19385 #. type: verbatim
19386 #: dpkg.pod
19387 #, no-wrap
19388 msgid ""
19389 " apt-cache dumpavail | dpkg --merge-avail\n"
19390 "\n"
19391 msgstr ""
19393 #. type: textblock
19394 #: dpkg.pod
19395 msgid "or with dpkg 1.17.6 and earlier:"
19396 msgstr ""
19398 #. type: verbatim
19399 #: dpkg.pod
19400 #, no-wrap
19401 msgid ""
19402 " avail=$(mktemp)\n"
19403 " apt-cache dumpavail> \"$avail\"\n"
19404 " dpkg --merge-avail \"$avail\"\n"
19405 " rm \"$avail\"\n"
19406 "\n"
19407 msgstr ""
19409 #. type: textblock
19410 #: dpkg.pod
19411 msgid "you can install it with:"
19412 msgstr ""
19414 #. type: verbatim
19415 #: dpkg.pod
19416 #, no-wrap
19417 msgid ""
19418 " dpkg --clear-selections\n"
19419 " dpkg --set-selections <myselections\n"
19420 "\n"
19421 msgstr ""
19423 #. type: textblock
19424 #: dpkg.pod
19425 msgid ""
19426 "Note that this will not actually install or remove anything, but just set "
19427 "the selection state on the requested packages. You will need some other "
19428 "application to actually download and install the requested packages. For "
19429 "example, run B<apt-get dselect-upgrade>."
19430 msgstr ""
19432 #. type: textblock
19433 #: dpkg.pod
19434 msgid ""
19435 "Ordinarily, you will find that B<dselect>(1) provides a more convenient way "
19436 "to modify the package selection states."
19437 msgstr ""
19439 #. type: =head1
19440 #: dpkg.pod
19441 msgid "ADDITIONAL FUNCTIONALITY"
19442 msgstr ""
19444 #. type: textblock
19445 #: dpkg.pod
19446 msgid ""
19447 "Additional functionality can be gained by installing any of the following "
19448 "packages: B<apt>, B<aptitude> and B<debsums>."
19449 msgstr ""
19451 #. type: textblock
19452 #: dpkg.pod
19453 msgid ""
19454 "B<aptitude>(8), B<apt>(8), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), "
19455 "B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8)."
19456 msgstr ""
19458 #. type: =head1
19459 #: dpkg.pod
19460 msgid "AUTHORS"
19461 msgstr ""
19463 #. type: textblock
19464 #: dpkg.pod
19465 msgid ""
19466 "See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to "
19467 "B<dpkg>."
19468 msgstr ""
19470 #. type: textblock
19471 #: dsc.pod
19472 msgid "dsc - Debian source packages' control file format"
19473 msgstr ""
19475 #. type: textblock
19476 #: dsc.pod
19477 msgid "I<filename>B<.dsc>"
19478 msgstr ""
19480 #. type: textblock
19481 #: dsc.pod
19482 msgid ""
19483 "Each Debian source package is composed of a .dsc control file, which "
19484 "contains a number of fields, in L<deb822(5)> format."
19485 msgstr ""
19487 #. type: textblock
19488 #: dsc.pod
19489 msgid ""
19490 "Each field begins with a tag, such as B<Source> or B<Binary> (case "
19491 "insensitive), followed by a colon, and the body of the field (case sensitive "
19492 "unless stated otherwise).  Fields are delimited only by field tags.  In "
19493 "other words, field text may be multiple lines in length, but the "
19494 "installation tools will generally join lines when processing the body of the "
19495 "field (except in case of the multiline fields B<Package-List>, B<Files>, "
19496 "B<Checksums-Sha1> and B<Checksums-Sha256>, see below)."
19497 msgstr ""
19499 #. type: textblock
19500 #: dsc.pod
19501 msgid ""
19502 "The value of this field declares the format version of the source package.  "
19503 "The field value is used by programs acting on a source package to interpret "
19504 "the list of files in the source package and determine how to unpack it.  The "
19505 "syntax of the field value is a numeric major revision (“0-9”), a period "
19506 "(“.”), a numeric minor revision (“0-9”), and then an optional subtype after "
19507 "whitespace (“ \\t”), which if specified is a lowercase alphanumeric "
19508 "(“a-z0-9”) word in parentheses (“()”).  The subtype is optional in the "
19509 "syntax but may be mandatory for particular source format revisions."
19510 msgstr ""
19512 #. type: textblock
19513 #: dsc.pod
19514 msgid ""
19515 "The source formats currently supported by B<dpkg> are B<1.0>, B<2.0>, B<3.0 "
19516 "(native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> and B<3.0 (custom)>.  "
19517 "See B<dpkg-source>(1) for their description."
19518 msgstr ""
19520 #. type: =item
19521 #: dsc.pod
19522 msgid "B<Source:> I<source-name> (required)"
19523 msgstr ""
19525 #. type: =item
19526 #: dsc.pod
19527 msgid "B<Binary:> I<binary-package-list>"
19528 msgstr ""
19530 #. type: textblock
19531 #: dsc.pod
19532 msgid ""
19533 "This folded field lists binary packages which this source package can "
19534 "produce, separated by commas."
19535 msgstr ""
19537 #. type: textblock
19538 #: dsc.pod
19539 msgid ""
19540 "This field has now been superseded by the B<Package-List> field, which gives "
19541 "enough information about what binary packages are produced on which "
19542 "architecture, build-profile and other involved restrictions."
19543 msgstr ""
19545 #. type: =item
19546 #: dsc.pod
19547 msgid "B<Architecture:> I<arch-list> (recommended)"
19548 msgstr ""
19550 #. type: textblock
19551 #: dsc.pod
19552 msgid ""
19553 "A list of architectures and architecture wildcards separated by spaces which "
19554 "specify the type of hardware this package can be compiled for.  Common "
19555 "architecture names and architecture wildcards are B<amd64>, B<armel>, "
19556 "B<i386>, B<linux-any>, B<any-amd64>, etc."
19557 msgstr ""
19559 #. type: textblock
19560 #: dsc.pod
19561 msgid ""
19562 "Note that the B<all> value is meant for packages that are architecture "
19563 "independent, and B<any> for packages that are architecture dependent.  The "
19564 "list may include (or consist solely of) the special value B<all>.  When the "
19565 "list contains the architecture wildcard B<any>, the only other value allowed "
19566 "in the list is B<all>."
19567 msgstr ""
19569 #. type: textblock
19570 #: dsc.pod
19571 msgid ""
19572 "The field value is generally generated from B<Architecture> fields from in "
19573 "the I<debian/control> in the source package."
19574 msgstr ""
19576 #. type: =item
19577 #: dsc.pod
19578 msgid "B<Uploaders:> I<fullname-email-list>"
19579 msgstr ""
19581 #. type: =item
19582 #: dsc.pod
19583 msgid "B<Standards-Version:> I<version-string> (recommended)"
19584 msgstr ""
19586 #. type: textblock
19587 #: dsc.pod
19588 msgid ""
19589 "The I<url> of a web interface to browse the Version Control System "
19590 "repository."
19591 msgstr ""
19593 #. type: textblock
19594 #: dsc.pod
19595 msgid ""
19596 "These fields declare the I<url> of the Version Control System repository "
19597 "used to maintain this package.  See B<deb-src-control>(5) for more details."
19598 msgstr ""
19600 #. type: textblock
19601 #: dsc.pod
19602 msgid ""
19603 "This field declares that the source package contains the specified test "
19604 "suites.  The value is a comma-separated list of test suites.  If the "
19605 "B<autopkgtest> value is present, a I<debian/tests/control> is expected to be "
19606 "present, if the file is present but not the value, then B<dpkg-source> will "
19607 "automatically add it, preserving previous values."
19608 msgstr ""
19610 #. type: textblock
19611 #: dsc.pod
19612 msgid ""
19613 "This field declares the comma-separated union of all test dependencies "
19614 "(B<Depends> fields in I<debian/tests/control> file), with all restrictions "
19615 "removed, and OR dependencies flattened (that is, converted to separate AND "
19616 "relationships), except for binaries generated by this source package and its "
19617 "meta-dependency equivalent B<@>."
19618 msgstr ""
19620 #. type: textblock
19621 #: dsc.pod
19622 msgid ""
19623 "Rationale: this field is needed because otherwise to be able to get the test "
19624 "dependencies, each source package would need to be unpacked."
19625 msgstr ""
19627 #. type: textblock
19628 #: dsc.pod
19629 msgid ""
19630 "These fields declare relationships between the source package and packages "
19631 "used to build it.  They are discussed in the B<deb-src-control>(5) manpage."
19632 msgstr ""
19634 #. type: =item
19635 #: dsc.pod
19636 msgid "B<Package-List:>"
19637 msgstr ""
19639 #. type: =item
19640 #: dsc.pod
19641 msgid "S< >I<package> I<package-type> I<section> I<priority> I<key-value-list>"
19642 msgstr ""
19644 #. type: textblock
19645 #: dsc.pod
19646 msgid ""
19647 "This multiline field contains a list of binary packages generated by this "
19648 "source package."
19649 msgstr ""
19651 #. type: textblock
19652 #: dsc.pod
19653 msgid "The I<package> is the binary package name."
19654 msgstr ""
19656 #. type: textblock
19657 #: dsc.pod
19658 msgid ""
19659 "The I<package-type> is the binary package type, usually B<deb>, another "
19660 "common value is B<udeb>."
19661 msgstr ""
19663 #. type: textblock
19664 #: dsc.pod
19665 msgid ""
19666 "The I<section> and I<priority> match the binary package fields of the same "
19667 "name."
19668 msgstr ""
19670 #. type: textblock
19671 #: dsc.pod
19672 msgid ""
19673 "The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the "
19674 "currently known optional keys are:"
19675 msgstr ""
19677 #. type: =item
19678 #: dsc.pod
19679 msgid "B<arch>"
19680 msgstr ""
19682 #. type: textblock
19683 #: dsc.pod
19684 msgid ""
19685 "The architecture restriction from the binary package B<Architecture> field, "
19686 "with spaces converted to ‘,’."
19687 msgstr ""
19689 #. type: =item
19690 #: dsc.pod
19691 msgid "B<profile>"
19692 msgstr ""
19694 #. type: textblock
19695 #: dsc.pod
19696 msgid ""
19697 "The normalized build-profile restriction formula from the binary package "
19698 "B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’."
19699 msgstr ""
19701 #. type: =item
19702 #: dsc.pod
19703 msgid "B<protected>"
19704 msgstr ""
19706 #. type: textblock
19707 #: dsc.pod
19708 msgid ""
19709 "If the binary package is protected, this key will contain the value of the "
19710 "B<Protected> field, that is a B<yes> value."
19711 msgstr ""
19713 #. type: =item
19714 #: dsc.pod
19715 msgid "B<essential>"
19716 msgstr ""
19718 #. type: textblock
19719 #: dsc.pod
19720 msgid ""
19721 "If the binary package is essential, this key will contain the value of the "
19722 "B<Essential> field, that is a B<yes> value."
19723 msgstr ""
19725 #. type: textblock
19726 #: dsc.pod
19727 msgid ""
19728 "These multiline fields contain a list of files with a checksum and size for "
19729 "each one.  These fields have the same syntax and differ only in the checksum "
19730 "algorithm used: MD5 for B<Files>, SHA-1 for B<Checksums-Sha1> and SHA-256 "
19731 "for B<Checksums-Sha256>."
19732 msgstr ""
19734 #. type: textblock
19735 #: dsc.pod
19736 msgid ""
19737 "The first line of the field value (the part on the same line as the field "
19738 "name followed by a colon) is always empty.  The content of the field is "
19739 "expressed as continuation lines, one line per file.  Each line consists of "
19740 "the checksum, a space, the file size, a space, and the file name."
19741 msgstr ""
19743 #. type: textblock
19744 #: dsc.pod
19745 msgid ""
19746 "These fields list all files that make up the source package.  The list of "
19747 "files in these fields must match the list of files in the other related "
19748 "fields."
19749 msgstr ""
19751 #. type: textblock
19752 #: dsc.pod
19753 msgid ""
19754 "The B<Format> field conflates the format for the B<.dsc> file itself and the "
19755 "format of the extracted source package."
19756 msgstr ""
19758 #. type: textblock
19759 #: dsc.pod
19760 msgid "L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7), B<dpkg-source>(1)."
19761 msgstr ""
19763 #. type: textblock
19764 #: dselect.cfg.pod
19765 msgid "dselect.cfg - dselect configuration file"
19766 msgstr ""
19768 #. type: textblock
19769 #: dselect.cfg.pod
19770 msgid ""
19771 "This file contains default options for dselect. Each line contains a single "
19772 "option which is exactly the same as a normal command line option for dselect "
19773 "except for the leading hyphens which are not used here. Quotes surrounding "
19774 "option values are stripped. Comments are allowed by starting a line with a "
19775 "hash sign (‘B<#>’)."
19776 msgstr ""
19778 #. type: textblock
19779 #: dselect.cfg.pod
19780 msgid "I<%PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*>"
19781 msgstr ""
19783 #. type: textblock
19784 #: dselect.cfg.pod
19785 msgid "I<%PKGCONFDIR%/dselect.cfg>"
19786 msgstr ""
19788 #. type: textblock
19789 #: dselect.cfg.pod
19790 msgid "I<~/.dselect.cfg>"
19791 msgstr ""
19793 #. type: textblock
19794 #: dselect.cfg.pod
19795 msgid "B<dselect>(1)."
19796 msgstr ""
19798 #. type: textblock
19799 #: dselect.pod
19800 msgid "dselect - Debian package management frontend"
19801 msgstr ""
19803 #. type: textblock
19804 #: dselect.pod
19805 msgid "B<dselect> [I<option>...] [I<command>...]"
19806 msgstr ""
19808 #. type: textblock
19809 #: dselect.pod
19810 msgid ""
19811 "B<dselect> is one of the primary user interfaces for managing packages on a "
19812 "Debian system. At the B<dselect> main menu, the system administrator can:"
19813 msgstr ""
19815 #. type: textblock
19816 #: dselect.pod
19817 msgid "Update the list of available package versions,"
19818 msgstr ""
19820 #. type: textblock
19821 #: dselect.pod
19822 msgid "View the status of installed and available packages,"
19823 msgstr ""
19825 #. type: textblock
19826 #: dselect.pod
19827 msgid "Alter package selections and manage dependencies,"
19828 msgstr ""
19830 #. type: textblock
19831 #: dselect.pod
19832 msgid "Install new packages or upgrade to newer versions."
19833 msgstr ""
19835 #. type: textblock
19836 #: dselect.pod
19837 msgid ""
19838 "B<dselect> operates as a front-end to B<dpkg>(1), the low-level Debian "
19839 "package handling tool. It features a full-screen package selections manager "
19840 "with package depends and conflicts resolver. When run with administrator "
19841 "privileges, packages can be installed, upgraded and removed. Various access "
19842 "methods can be configured to retrieve available package version information "
19843 "and installable packages from package repositories.  Depending on the used "
19844 "access method, these repositories can be public archive servers on the "
19845 "internet, local archive servers or CD-ROMs.  The recommended access method "
19846 "is I<apt>, which is provided by the package B<apt>(8)."
19847 msgstr ""
19849 #. type: textblock
19850 #: dselect.pod
19851 msgid ""
19852 "Normally B<dselect> is invoked without parameters. An interactive menu is "
19853 "presented, offering the user a list of commands. If a command is given as "
19854 "argument, then that command is started immediately. Several command line "
19855 "parameters are still available to modify the running behaviour of B<dselect> "
19856 "or show additional information about the program."
19857 msgstr ""
19859 #. type: textblock
19860 #: dselect.pod
19861 msgid ""
19862 "All options can be specified both on the command line and in the B<dselect> "
19863 "configuration file I<%PKGCONFDIR%/dselect.cfg> or the files on the "
19864 "configuration directory I<%PKGCONFDIR%/dselect.cfg.d/>. Each line in the "
19865 "configuration file is either an option (exactly the same as the command line "
19866 "option but without leading hyphens) or a comment (if it starts with a "
19867 "‘B<#>’)."
19868 msgstr ""
19870 #. type: textblock
19871 #: dselect.pod
19872 msgid ""
19873 "Changes the directory where the dpkg ‘I<status>’, ‘I<available>’ and similar "
19874 "files are located.  Defaults to I<%ADMINDIR%> if B<DPKG_ADMINDIR> has not "
19875 "been set."
19876 msgstr ""
19878 #. type: textblock
19879 #: dselect.pod
19880 msgid ""
19881 "Set the installation directory, which refers to the directory where packages "
19882 "get installed (since dpkg 1.21.2).  Defaults to «I</>» if B<DPKG_ROOT> has "
19883 "not been set."
19884 msgstr ""
19886 #. type: textblock
19887 #: dselect.pod
19888 msgid ""
19889 "Set the root directory to I<directory>, which sets the installation "
19890 "directory to «I<directory>» and the administrative directory to "
19891 "«I<directory>%ADMINDIR%» (since dpkg 1.21.0)."
19892 msgstr ""
19894 #. type: =item
19895 #: dselect.pod
19896 msgid "B<-D>I<file>, B<--debug> I<file>"
19897 msgstr ""
19899 #. type: textblock
19900 #: dselect.pod
19901 msgid "Turn on debugging. Debugging information is sent to I<file>."
19902 msgstr ""
19904 #. type: =item
19905 #: dselect.pod
19906 msgid "B<--expert>"
19907 msgstr ""
19909 #. type: textblock
19910 #: dselect.pod
19911 msgid "Turns on expert mode, i.e. doesn't display possibly annoying help messages."
19912 msgstr ""
19914 #. type: =item
19915 #: dselect.pod
19916 msgid ""
19917 "B<--color> "
19918 "I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
19919 msgstr ""
19921 #. type: =item
19922 #: dselect.pod
19923 msgid ""
19924 "B<--colour> "
19925 "I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
19926 msgstr ""
19928 #. type: textblock
19929 #: dselect.pod
19930 msgid ""
19931 "Configures screen colors. This works only if your display supports colors.  "
19932 "This option may be used multiple times (and is best used in "
19933 "I<dselect.cfg>). Each use changes the color (and optionally, other "
19934 "attributes) of one part of the screen.  The parts of the screen (from top to "
19935 "bottom) are:"
19936 msgstr ""
19938 #. type: =item
19939 #: dselect.pod
19940 msgid "B<title>"
19941 msgstr ""
19943 #. type: textblock
19944 #: dselect.pod
19945 msgid "The screen title."
19946 msgstr ""
19948 #. type: =item
19949 #: dselect.pod
19950 msgid "B<listhead>"
19951 msgstr ""
19953 #. type: textblock
19954 #: dselect.pod
19955 msgid "The header line above the list of packages."
19956 msgstr ""
19958 #. type: =item
19959 #: dselect.pod
19960 msgid "B<list>"
19961 msgstr ""
19963 #. type: textblock
19964 #: dselect.pod
19965 msgid "The scrolling list of packages (and also some help text)."
19966 msgstr ""
19968 #. type: =item
19969 #: dselect.pod
19970 msgid "B<listsel>"
19971 msgstr ""
19973 #. type: textblock
19974 #: dselect.pod
19975 msgid "The selected item in the list."
19976 msgstr ""
19978 #. type: =item
19979 #: dselect.pod
19980 msgid "B<pkgstate>"
19981 msgstr ""
19983 #. type: textblock
19984 #: dselect.pod
19985 msgid ""
19986 "In the list of packages, the text indicating the current state of each "
19987 "package."
19988 msgstr ""
19990 #. type: =item
19991 #: dselect.pod
19992 msgid "B<pkgstatesel>"
19993 msgstr ""
19995 #. type: textblock
19996 #: dselect.pod
19997 msgid ""
19998 "In the list of packages, the text indicating the current state of the "
19999 "currently selected package."
20000 msgstr ""
20002 #. type: =item
20003 #: dselect.pod
20004 msgid "B<infohead>"
20005 msgstr ""
20007 #. type: textblock
20008 #: dselect.pod
20009 msgid "The header line that displays the state of the currently selected package."
20010 msgstr ""
20012 #. type: =item
20013 #: dselect.pod
20014 msgid "B<infodesc>"
20015 msgstr ""
20017 #. type: textblock
20018 #: dselect.pod
20019 msgid "The package's short description."
20020 msgstr ""
20022 #. type: =item
20023 #: dselect.pod
20024 msgid "B<info>"
20025 msgstr ""
20027 #. type: textblock
20028 #: dselect.pod
20029 msgid "Used to display package info such as the package's description."
20030 msgstr ""
20032 #. type: =item
20033 #: dselect.pod
20034 msgid "B<infofoot>"
20035 msgstr ""
20037 #. type: textblock
20038 #: dselect.pod
20039 msgid "The last line of the screen when selecting packages."
20040 msgstr ""
20042 #. type: =item
20043 #: dselect.pod
20044 msgid "B<query>"
20045 msgstr ""
20047 #. type: textblock
20048 #: dselect.pod
20049 msgid "Used to display query lines"
20050 msgstr ""
20052 #. type: =item
20053 #: dselect.pod
20054 msgid "B<helpscreen>"
20055 msgstr ""
20057 #. type: textblock
20058 #: dselect.pod
20059 msgid "Color of help screens."
20060 msgstr ""
20062 #. type: textblock
20063 #: dselect.pod
20064 msgid ""
20065 "After the part of the screen comes a colon and the color specification. You "
20066 "can specify either the foreground color, the background color, or both, "
20067 "overriding the compiled-in colors. Use standard curses color names."
20068 msgstr ""
20070 #. type: textblock
20071 #: dselect.pod
20072 msgid ""
20073 "Optionally, after the color specification is another colon, and an attribute "
20074 "specification. This is a list of one or more attributes, separated by plus "
20075 "(‘+’) characters.  Available attributes include (not all of these will work "
20076 "on all terminals): B<normal>, B<standout>, B<underline>, B<reverse>, "
20077 "B<blink>, B<bright>, B<dim>, B<bold>"
20078 msgstr ""
20080 #. type: textblock
20081 #: dselect.pod
20082 msgid "Print a brief help text and exit successfully."
20083 msgstr ""
20085 #. type: textblock
20086 #: dselect.pod
20087 msgid "Print version information and exit successfully."
20088 msgstr ""
20090 #. type: textblock
20091 #: dselect.pod
20092 msgid ""
20093 "When B<dselect> is started it can perform the following commands, either "
20094 "directly if it was specified on the command line or by prompting the user "
20095 "with a menu of available commands if running interactively:"
20096 msgstr ""
20098 #. type: =head2
20099 #: dselect.pod
20100 msgid "access"
20101 msgstr ""
20103 #. type: textblock
20104 #: dselect.pod
20105 msgid "Choose and configure an access method to access package repositories."
20106 msgstr ""
20108 #. type: textblock
20109 #: dselect.pod
20110 msgid ""
20111 "By default, B<dselect> provides several methods such as I<multi_cd>, "
20112 "I<mounted> or I<ftp>, but other packages may provide additional methods, for "
20113 "example the I<apt> access method provided by the B<apt>(8) package."
20114 msgstr ""
20116 #. type: textblock
20117 #: dselect.pod
20118 msgid "The use of the I<apt> access method is strongly recommended."
20119 msgstr ""
20121 #. type: =head2
20122 #: dselect.pod
20123 msgid "update"
20124 msgstr ""
20126 #. type: textblock
20127 #: dselect.pod
20128 msgid "Refresh the available packages database."
20129 msgstr ""
20131 #. type: textblock
20132 #: dselect.pod
20133 msgid ""
20134 "Retrieves a list of available package versions from the package repository, "
20135 "configured for the current access method, and update the dpkg database. The "
20136 "package lists are commonly provided by the repository as files named "
20137 "I<Packages> or I<Packages.gz>.  These files can be generated by repository "
20138 "maintainers, using the program B<dpkg-scanpackages>(1)."
20139 msgstr ""
20141 #. type: textblock
20142 #: dselect.pod
20143 msgid ""
20144 "Details of the update command depend on the access method's implementation.  "
20145 "Normally the process is straightforward and requires no user interaction."
20146 msgstr ""
20148 #. type: =head2
20149 #: dselect.pod
20150 msgid "select"
20151 msgstr ""
20153 #. type: textblock
20154 #: dselect.pod
20155 msgid "View or manage package selections and dependencies."
20156 msgstr ""
20158 #. type: textblock
20159 #: dselect.pod
20160 msgid ""
20161 "This is the main function of B<dselect>. In the select screen, the user can "
20162 "review a list of all available and installed packages. When run with "
20163 "administrator privileges, it is also possible to interactively change "
20164 "packages selection state. B<dselect> tracks the implications of these "
20165 "changes to other depending or conflicting packages."
20166 msgstr ""
20168 #. type: textblock
20169 #: dselect.pod
20170 msgid ""
20171 "When a conflict or failed depends is detected, a dependency resolution "
20172 "subscreen is prompted to the user. In this screen, a list of conflicting or "
20173 "depending packages is shown, and for each package listed, the reason for its "
20174 "listing is shown. The user may apply the suggestions proposed by B<dselect>, "
20175 "override them, or back out all the changes, including the ones that created "
20176 "the unresolved depends or conflicts."
20177 msgstr ""
20179 #. type: textblock
20180 #: dselect.pod
20181 msgid ""
20182 "The use of the interactive package selections management screen is explained "
20183 "in more detail below."
20184 msgstr ""
20186 #. type: =head2
20187 #: dselect.pod
20188 msgid "install"
20189 msgstr ""
20191 #. type: textblock
20192 #: dselect.pod
20193 msgid "Installs selected packages."
20194 msgstr ""
20196 #. type: textblock
20197 #: dselect.pod
20198 msgid ""
20199 "The configured access method will fetch installable or upgradable packages "
20200 "from the relevant repositories and install these using B<dpkg>.  Depending "
20201 "on the implementation of the access method, all packages can be prefetched "
20202 "before installation, or fetched when needed.  Some access methods may also "
20203 "remove packages that were marked for removal."
20204 msgstr ""
20206 #. type: textblock
20207 #: dselect.pod
20208 msgid ""
20209 "If an error occurred during install, it is usually advisable to run install "
20210 "again. In most cases, the problems will disappear or be solved.  If problems "
20211 "persist or the installation performed was incorrect, please investigate into "
20212 "the causes and circumstances, and file a bug in the Debian bug tracking "
20213 "system. Instructions on how to do this can be found at "
20214 "L<https://bugs.debian.org/> or by reading the documentation for B<bug>(1) or "
20215 "B<reportbug>(1), if these are installed."
20216 msgstr ""
20218 #. type: textblock
20219 #: dselect.pod
20220 msgid ""
20221 "Details of the install command depend on the access method's "
20222 "implementation.  The user's attention and input may be required during "
20223 "installation, configuration or removal of packages. This depends on the "
20224 "maintainer scripts in the package. Some packages make use of the "
20225 "B<debconf>(1)  library, allowing for more flexible or even automated "
20226 "installation setups."
20227 msgstr ""
20229 #. type: =head2
20230 #: dselect.pod
20231 msgid "config"
20232 msgstr ""
20234 #. type: textblock
20235 #: dselect.pod
20236 msgid "Configures any previously installed, but not fully configured packages."
20237 msgstr ""
20239 #. type: =head2
20240 #: dselect.pod
20241 msgid "remove"
20242 msgstr ""
20244 #. type: textblock
20245 #: dselect.pod
20246 msgid "Removes or purges installed packages, that are marked for removal."
20247 msgstr ""
20249 #. type: =head2
20250 #: dselect.pod
20251 msgid "quit"
20252 msgstr ""
20254 #. type: textblock
20255 #: dselect.pod
20256 msgid "Quit B<dselect>."
20257 msgstr ""
20259 #. type: textblock
20260 #: dselect.pod
20261 msgid "Exits the program with zero (successful) error code."
20262 msgstr ""
20264 #. type: =head1
20265 #: dselect.pod
20266 msgid "PACKAGE SELECTIONS MANAGEMENT"
20267 msgstr ""
20269 #. type: =head2
20270 #: dselect.pod
20271 msgid "Introduction"
20272 msgstr ""
20274 #. type: textblock
20275 #: dselect.pod
20276 msgid ""
20277 "B<dselect> directly exposes the administrator to some of the complexities "
20278 "involved with managing large sets of packages with many "
20279 "interdependencies. For a user who is unfamiliar with the concepts and the "
20280 "ways of the Debian package management system, it can be quite "
20281 "overwhelming. Although B<dselect> is aimed at easing package management and "
20282 "administration, it is only instrumental in doing so and cannot be assumed to "
20283 "be a sufficient substitute for administrator skill and understanding. The "
20284 "user is required to be familiar with the concepts underlying the Debian "
20285 "packaging system.  In case of doubt, consult the B<dpkg>(1) manpage and the "
20286 "distribution policy."
20287 msgstr ""
20289 #. type: textblock
20290 #: dselect.pod
20291 msgid ""
20292 "Unless B<dselect> is run in expert or immediate mode, a help screen is first "
20293 "displayed when choosing this command from the menu. The user is I<strongly> "
20294 "advised to study all of the information presented in the online help "
20295 "screens, when one pops up.  The online help screens can at any time be "
20296 "invoked with the ‘B<?>’ key."
20297 msgstr ""
20299 #. type: =head2
20300 #: dselect.pod
20301 msgid "Screen layout"
20302 msgstr ""
20304 #. type: textblock
20305 #: dselect.pod
20306 msgid ""
20307 "The select screen is by default split in a top and a bottom half.  The top "
20308 "half shows a list of packages. A cursor bar can select an individual "
20309 "package, or a group of packages, if applicable, by selecting the group "
20310 "header. The bottom half of the screen shows some details about the package "
20311 "currently selected in the top half of the screen.  The type of detail that "
20312 "is displayed can be varied."
20313 msgstr ""
20315 #. type: textblock
20316 #: dselect.pod
20317 msgid ""
20318 "Pressing the ‘B<I>’ key toggles a full-screen display of the packages list, "
20319 "an enlarged view of the package details, or the equally split screen."
20320 msgstr ""
20322 #. type: =head2
20323 #: dselect.pod
20324 msgid "Package details view"
20325 msgstr ""
20327 #. type: textblock
20328 #: dselect.pod
20329 msgid ""
20330 "The package details view by default shows the extended package description "
20331 "for the package that is currently selected in the packages status list.  The "
20332 "type of detail can be toggled by pressing the ‘B<i>’ key.  This alternates "
20333 "between:"
20334 msgstr ""
20336 #. type: textblock
20337 #: dselect.pod
20338 msgid "the extended description"
20339 msgstr ""
20341 #. type: textblock
20342 #: dselect.pod
20343 msgid "the control information for the installed version"
20344 msgstr ""
20346 #. type: textblock
20347 #: dselect.pod
20348 msgid "the control information for the available version"
20349 msgstr ""
20351 #. type: textblock
20352 #: dselect.pod
20353 msgid ""
20354 "In a dependency resolution screen, there is also the possibility of viewing "
20355 "the specific unresolved depends or conflicts related to the package and "
20356 "causing it to be listed."
20357 msgstr ""
20359 #. type: =head2
20360 #: dselect.pod
20361 msgid "Packages status list"
20362 msgstr ""
20364 #. type: textblock
20365 #: dselect.pod
20366 msgid ""
20367 "The main select screen displays a list of all packages known to the Debian "
20368 "package management system. This includes packages installed on the system "
20369 "and packages known from the available packages database."
20370 msgstr ""
20372 #. type: textblock
20373 #: dselect.pod
20374 msgid ""
20375 "For every package, the list shows the package's status, priority, section, "
20376 "installed and available architecture, installed and available versions, the "
20377 "package name and its short description, all in one line.  By pressing the "
20378 "‘B<A>’ key, the display of the installed and available architecture can be "
20379 "toggled between on an off.  By pressing the ‘B<V>’ key, the display of the "
20380 "installed and available version can be toggled between on an off.  By "
20381 "pressing the ‘B<v>’ key, the package status display is toggled between "
20382 "verbose and shorthand.  Shorthand display is the default."
20383 msgstr ""
20385 #. type: textblock
20386 #: dselect.pod
20387 msgid ""
20388 "The shorthand status indication consists of four parts: an error flag, which "
20389 "should normally be clear, the current status, the last selection state and "
20390 "the current selection state.  The first two relate to the actual state of "
20391 "the package, the second pair are about the selections set by the user."
20392 msgstr ""
20394 #. type: textblock
20395 #: dselect.pod
20396 msgid "These are the meanings of the shorthand package status indicator codes:"
20397 msgstr ""
20399 #. type: textblock
20400 #: dselect.pod
20401 msgid "Error flag:"
20402 msgstr ""
20404 #. type: =item
20405 #: dselect.pod
20406 msgid "I<empty> no error"
20407 msgstr ""
20409 #. type: =item
20410 #: dselect.pod
20411 msgid "B<R> serious error, needs reinstallation;"
20412 msgstr ""
20414 #. type: textblock
20415 #: dselect.pod
20416 msgid "Installed state:"
20417 msgstr ""
20419 #. type: =item
20420 #: dselect.pod
20421 msgid "I<empty> not installed;"
20422 msgstr ""
20424 #. type: =item
20425 #: dselect.pod
20426 msgid "B<*> fully installed and configured;"
20427 msgstr ""
20429 #. type: =item
20430 #: dselect.pod
20431 msgid "B<-> not installed but some config files may remain;"
20432 msgstr ""
20434 #. type: =item
20435 #: dselect.pod
20436 msgid "B<U> unpacked but not yet configured;"
20437 msgstr ""
20439 #. type: =item
20440 #: dselect.pod
20441 msgid "B<C> half-configured (an error happened);"
20442 msgstr ""
20444 #. type: =item
20445 #: dselect.pod
20446 msgid "B<I> half-installed (an error happened)."
20447 msgstr ""
20449 #. type: textblock
20450 #: dselect.pod
20451 msgid "Current and requested selections:"
20452 msgstr ""
20454 #. type: =item
20455 #: dselect.pod
20456 msgid "B<*> marked for installation or upgrade;"
20457 msgstr ""
20459 #. type: =item
20460 #: dselect.pod
20461 msgid "B<-> marked for removal, configuration files remain;"
20462 msgstr ""
20464 #. type: =item
20465 #: dselect.pod
20466 msgid "B<=> on hold: package will not be processed at all;"
20467 msgstr ""
20469 #. type: =item
20470 #: dselect.pod
20471 msgid "B<_> marked for purge, also remove configuration;"
20472 msgstr ""
20474 #. type: =item
20475 #: dselect.pod
20476 msgid "B<n> package is new and has yet to be marked."
20477 msgstr ""
20479 #. type: =head2
20480 #: dselect.pod
20481 msgid "Cursor and screen movement"
20482 msgstr ""
20484 #. type: textblock
20485 #: dselect.pod
20486 msgid ""
20487 "The package selection list and the dependency conflict resolution screens "
20488 "can be navigated using motion commands mapped to the following keys:"
20489 msgstr ""
20491 #. type: =item
20492 #: dselect.pod
20493 msgid "B<p, Up, k> move cursor bar up"
20494 msgstr ""
20496 #. type: =item
20497 #: dselect.pod
20498 msgid "B<n, Down, j> move cursor bar down"
20499 msgstr ""
20501 #. type: =item
20502 #: dselect.pod
20503 msgid "B<P, Pgup, Backspace> scroll list 1 page up"
20504 msgstr ""
20506 #. type: =item
20507 #: dselect.pod
20508 msgid "B<N, Pgdn, Space> scroll list 1 page down"
20509 msgstr ""
20511 #. type: =item
20512 #: dselect.pod
20513 msgid "B<^p> scroll list 1 line up"
20514 msgstr ""
20516 #. type: =item
20517 #: dselect.pod
20518 msgid "B<^n> scroll list 1 line down"
20519 msgstr ""
20521 #. type: =item
20522 #: dselect.pod
20523 msgid "B<t, Home> jump to top of list"
20524 msgstr ""
20526 #. type: =item
20527 #: dselect.pod
20528 msgid "B<e, End> jump to end of list"
20529 msgstr ""
20531 #. type: =item
20532 #: dselect.pod
20533 msgid "B<u> scroll info 1 page up"
20534 msgstr ""
20536 #. type: =item
20537 #: dselect.pod
20538 msgid "B<d> scroll info 1 page down"
20539 msgstr ""
20541 #. type: =item
20542 #: dselect.pod
20543 msgid "B<^u> scroll info 1 line up"
20544 msgstr ""
20546 #. type: =item
20547 #: dselect.pod
20548 msgid "B<^d> scroll info 1 line down"
20549 msgstr ""
20551 #. type: =item
20552 #: dselect.pod
20553 msgid "B<B, Left-arrow> pan display 1/3 screen left"
20554 msgstr ""
20556 #. type: =item
20557 #: dselect.pod
20558 msgid "B<F, Right-arrow> pan display 1/3 screen right"
20559 msgstr ""
20561 #. type: =item
20562 #: dselect.pod
20563 msgid "B<^b> pan display 1 character left"
20564 msgstr ""
20566 #. type: =item
20567 #: dselect.pod
20568 msgid "B<^f> pan display 1 character right"
20569 msgstr ""
20571 #. type: =head2
20572 #: dselect.pod
20573 msgid "Searching and sorting"
20574 msgstr ""
20576 #. type: textblock
20577 #: dselect.pod
20578 msgid ""
20579 "The list of packages can be searched by package name. This is done by "
20580 "pressing ‘B</>’, and typing a simple search string. The string is "
20581 "interpreted as a B<regex>(7)  regular expression.  If you add ‘B</d>’ to the "
20582 "search expression, dselect will also search in descriptions.  If you add "
20583 "‘B</i>’ the search will be case insensitive.  You may combine these two "
20584 "suffixes like this: ‘B</id>’.  Repeated searching is accomplished by "
20585 "repeatedly pressing the ‘B<n>’ or ‘B<\\>’ keys, until the wanted package is "
20586 "found.  If the search reaches the bottom of the list, it wraps to the top "
20587 "and continues searching from there."
20588 msgstr ""
20590 #. type: textblock
20591 #: dselect.pod
20592 msgid ""
20593 "The list sort order can be varied by pressing the ‘B<o>’ and ‘B<O>’ keys "
20594 "repeatedly.  The following nine sort orderings can be selected:"
20595 msgstr ""
20597 #. type: =item
20598 #: dselect.pod
20599 msgid "B<alphabet>"
20600 msgstr ""
20602 #. type: =item
20603 #: dselect.pod
20604 msgid "B<priority+section>"
20605 msgstr ""
20607 #. type: =item
20608 #: dselect.pod
20609 msgid "B<section+priority>"
20610 msgstr ""
20612 #. type: =item
20613 #: dselect.pod
20614 msgid "B<available>"
20615 msgstr ""
20617 #. type: =item
20618 #: dselect.pod
20619 msgid "B<available+priority>"
20620 msgstr ""
20622 #. type: =item
20623 #: dselect.pod
20624 msgid "B<available+section>"
20625 msgstr ""
20627 #. type: =item
20628 #: dselect.pod
20629 msgid "B<status>"
20630 msgstr ""
20632 #. type: =item
20633 #: dselect.pod
20634 msgid "B<status+priority>"
20635 msgstr ""
20637 #. type: =item
20638 #: dselect.pod
20639 msgid "B<status+section>"
20640 msgstr ""
20642 #. type: textblock
20643 #: dselect.pod
20644 msgid ""
20645 "Where not listed above explicitly, alphabetic order is used as the final "
20646 "subordering sort key."
20647 msgstr ""
20649 #. type: =head2
20650 #: dselect.pod
20651 msgid "Altering selections"
20652 msgstr ""
20654 #. type: textblock
20655 #: dselect.pod
20656 msgid ""
20657 "The requested selection state of individual packages may be altered with the "
20658 "following commands:"
20659 msgstr ""
20661 #. type: =item
20662 #: dselect.pod
20663 msgid "B<+, Insert> install or upgrade"
20664 msgstr ""
20666 #. type: =item
20667 #: dselect.pod
20668 msgid "B<=, H> hold in present state and version"
20669 msgstr ""
20671 #. type: =item
20672 #: dselect.pod
20673 msgid "B<:, G> unhold: upgrade or leave uninstalled"
20674 msgstr ""
20676 #. type: =item
20677 #: dselect.pod
20678 msgid "B<-, Delete> remove, but leave configuration"
20679 msgstr ""
20681 #. type: =item
20682 #: dselect.pod
20683 msgid "B<_> remove & purge configuration"
20684 msgstr ""
20686 #. type: textblock
20687 #: dselect.pod
20688 msgid ""
20689 "When the change request results in one or more unsatisfied depends or "
20690 "conflicts, B<dselect> prompts the user with a dependency resolution "
20691 "screen. This will be further explained below."
20692 msgstr ""
20694 #. type: textblock
20695 #: dselect.pod
20696 msgid ""
20697 "It is also possible to apply these commands to groups of package selections, "
20698 "by pointing the cursor bar onto a group header. The exact grouping of "
20699 "packages is dependent on the current list ordering settings."
20700 msgstr ""
20702 #. type: textblock
20703 #: dselect.pod
20704 msgid ""
20705 "Proper care should be taken when altering large groups of selections, "
20706 "because this can instantaneously create large numbers of unresolved depends "
20707 "or conflicts, all of which will be listed in one dependency resolution "
20708 "screen, making them very hard to handle. In practice, only hold and unhold "
20709 "operations are useful when applied to groups."
20710 msgstr ""
20712 #. type: =head2
20713 #: dselect.pod
20714 msgid "Resolving depends and conflicts"
20715 msgstr ""
20717 #. type: textblock
20718 #: dselect.pod
20719 msgid ""
20720 "When the change request results in one or more unsatisfied depends or "
20721 "conflicts, B<dselect> prompts the user with a dependency resolution "
20722 "screen. First however, an informative help screen is displayed."
20723 msgstr ""
20725 #. type: textblock
20726 #: dselect.pod
20727 msgid ""
20728 "The top half of this screen lists all the packages that will have unresolved "
20729 "depends or conflicts, as a result of the requested change, and all the "
20730 "packages whose installation can resolve any of these depends or whose "
20731 "removal can resolve any of the conflicts.  The bottom half defaults to show "
20732 "the depends or conflicts that cause the currently selected package to be "
20733 "listed."
20734 msgstr ""
20736 #. type: textblock
20737 #: dselect.pod
20738 msgid ""
20739 "When the sublist of packages is displayed initially, B<dselect> may have "
20740 "already set the requested selection status of some of the listed packages, "
20741 "in order to resolve the depends or conflicts that caused the dependency "
20742 "resolution screen to be displayed. Usually, it is best to follow up the "
20743 "suggestions made by B<dselect>."
20744 msgstr ""
20746 #. type: textblock
20747 #: dselect.pod
20748 msgid ""
20749 "The listed packages' selection state may be reverted to the original "
20750 "settings, as they were before the unresolved depends or conflicts were "
20751 "created, by pressing the ‘B<R>’ key.  By pressing the ‘B<D>’ key, the "
20752 "automatic suggestions are reset, but the change that caused the dependency "
20753 "resolution screen to be prompted is kept as requested.  Finally, by pressing "
20754 "‘B<U>’, the selections are again set to the automatic suggestion values."
20755 msgstr ""
20757 #. type: =head2
20758 #: dselect.pod
20759 msgid "Establishing the requested selections"
20760 msgstr ""
20762 #. type: textblock
20763 #: dselect.pod
20764 msgid ""
20765 "By pressing B<enter>, the currently displayed set of selections is "
20766 "accepted. If B<dselect> detects no unresolved depends as a result of the "
20767 "requested selections, the new selections will be set.  However, if there are "
20768 "any unresolved depends, B<dselect> will again prompt the user with a "
20769 "dependency resolution screen."
20770 msgstr ""
20772 #. type: textblock
20773 #: dselect.pod
20774 msgid ""
20775 "To alter a set of selections that creates unresolved depends or conflicts "
20776 "and forcing B<dselect> to accept it, press the ‘B<Q>’ key. This sets the "
20777 "selections as specified by the user, unconditionally. Generally, don't do "
20778 "this unless you've read the fine print."
20779 msgstr ""
20781 #. type: textblock
20782 #: dselect.pod
20783 msgid ""
20784 "The opposite effect, to back out any selections change requests and go back "
20785 "to the previous list of selections, is attained by pressing the ‘B<X>’ or "
20786 "B<escape> keys. By repeatedly pressing these keys, any possibly detrimental "
20787 "changes to the requested package selections can be backed out completely to "
20788 "the last established settings."
20789 msgstr ""
20791 #. type: textblock
20792 #: dselect.pod
20793 msgid ""
20794 "If you mistakenly establish some settings and wish to revert all the "
20795 "selections to what is currently installed on the system, press the ‘B<C>’ "
20796 "key.  This is somewhat similar to using the unhold command on all packages, "
20797 "but provides a more obvious panic button in cases where the user pressed "
20798 "B<enter> by accident."
20799 msgstr ""
20801 #. type: textblock
20802 #: dselect.pod
20803 msgid "The requested command was successfully performed."
20804 msgstr ""
20806 #. type: textblock
20807 #: dselect.pod
20808 msgid ""
20809 "If set and the B<--instdir> or B<--root> options have not been specified, it "
20810 "will be used as the filesystem root directory (since dpkg 1.21.0)."
20811 msgstr ""
20813 #. type: textblock
20814 #: dselect.pod
20815 msgid ""
20816 "If set and the B<--admindir> or B<--root> option have not been specified, it "
20817 "will be used as the B<dpkg> database directory (since dpkg 1.21.0)."
20818 msgstr ""
20820 #. type: textblock
20821 #: dselect.pod
20822 msgid ""
20823 "If set, B<dselect> will use it as the directory from which to read the user "
20824 "specific configuration file."
20825 msgstr ""
20827 #. type: textblock
20828 #: dselect.pod
20829 msgid ""
20830 "The B<dselect> package selection interface is confusing to some new users.  "
20831 "Reportedly, it even makes seasoned kernel developers cry."
20832 msgstr ""
20834 #. type: textblock
20835 #: dselect.pod
20836 msgid "The documentation is lacking."
20837 msgstr ""
20839 #. type: textblock
20840 #: dselect.pod
20841 msgid "There is no help option in the main menu."
20842 msgstr ""
20844 #. type: textblock
20845 #: dselect.pod
20846 msgid "The visible list of available packages cannot be reduced."
20847 msgstr ""
20849 #. type: textblock
20850 #: dselect.pod
20851 msgid ""
20852 "The built in access methods can no longer stand up to current quality "
20853 "standards. Use the access method provided by B<apt>(8), it is not only not "
20854 "broken, it is also much more flexible than the built in access methods."
20855 msgstr ""
20857 #. type: textblock
20858 #: dselect.pod
20859 msgid "B<dpkg>(1), B<apt>(8), B<sources.list>(5), B<deb>(5)."
20860 msgstr ""
20862 #. type: textblock
20863 #: start-stop-daemon.pod
20864 msgid "start-stop-daemon - start and stop system daemon programs"
20865 msgstr ""
20867 #. type: textblock
20868 #: start-stop-daemon.pod
20869 msgid "B<start-stop-daemon> [I<option>...] I<command>"
20870 msgstr ""
20872 #. type: textblock
20873 #: start-stop-daemon.pod
20874 msgid ""
20875 "B<start-stop-daemon> is used to control the creation and termination of "
20876 "system-level processes.  Using one of the matching options, "
20877 "B<start-stop-daemon> can be configured to find existing instances of a "
20878 "running process."
20879 msgstr ""
20881 #. type: textblock
20882 #: start-stop-daemon.pod
20883 msgid ""
20884 "B<Note:> Unless B<--pid> or B<--pidfile> are specified, B<start-stop-daemon> "
20885 "behaves similar to B<killall>(1).  B<start-stop-daemon> will scan the "
20886 "process table looking for any processes which match the process name, parent "
20887 "pid, uid, and/or gid (if specified). Any matching process will prevent "
20888 "B<--start> from starting the daemon. All matching processes will be sent the "
20889 "TERM signal (or the one specified via B<--signal> or B<--retry>) if "
20890 "B<--stop> is specified. For daemons which have long-lived children which "
20891 "need to live through a B<--stop>, you must specify a pidfile."
20892 msgstr ""
20894 #. type: =item
20895 #: start-stop-daemon.pod
20896 msgid "B<-S>, B<--start> [B<-->] I<arguments>"
20897 msgstr ""
20899 #. type: textblock
20900 #: start-stop-daemon.pod
20901 msgid ""
20902 "Check for the existence of a specified process.  If such a process exists, "
20903 "B<start-stop-daemon> does nothing, and exits with error status 1 (0 if "
20904 "B<--oknodo> is specified).  If such a process does not exist, it starts an "
20905 "instance, using either the executable specified by B<--exec> or, if "
20906 "specified, by B<--startas>.  Any arguments given after B<--> on the command "
20907 "line are passed unmodified to the program being started."
20908 msgstr ""
20910 #. type: =item
20911 #: start-stop-daemon.pod
20912 msgid "B<-K>, B<--stop>"
20913 msgstr ""
20915 #. type: textblock
20916 #: start-stop-daemon.pod
20917 msgid ""
20918 "Checks for the existence of a specified process.  If such a process exists, "
20919 "B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits "
20920 "with error status 0.  If such a process does not exist, B<start-stop-daemon> "
20921 "exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is "
20922 "specified, then B<start-stop-daemon> will check that the process(es) have "
20923 "terminated."
20924 msgstr ""
20926 #. type: =item
20927 #: start-stop-daemon.pod
20928 msgid "B<-T>, B<--status>"
20929 msgstr ""
20931 #. type: textblock
20932 #: start-stop-daemon.pod
20933 msgid ""
20934 "Check for the existence of a specified process, and returns an exit status "
20935 "code, according to the LSB Init Script Actions (since version 1.16.1)."
20936 msgstr ""
20938 #. type: =item
20939 #: start-stop-daemon.pod
20940 msgid "B<-H>, B<--help>"
20941 msgstr ""
20943 #. type: textblock
20944 #: start-stop-daemon.pod
20945 msgid "Show usage information and exit."
20946 msgstr ""
20948 #. type: =item
20949 #: start-stop-daemon.pod
20950 msgid "B<-V>, B<--version>"
20951 msgstr ""
20953 #. type: textblock
20954 #: start-stop-daemon.pod
20955 msgid "Show the program version and exit."
20956 msgstr ""
20958 #. type: =head2
20959 #: start-stop-daemon.pod
20960 msgid "Matching options"
20961 msgstr ""
20963 #. type: =item
20964 #: start-stop-daemon.pod
20965 msgid "B<--pid> I<pid>"
20966 msgstr ""
20968 #. type: textblock
20969 #: start-stop-daemon.pod
20970 msgid ""
20971 "Check for a process with the specified I<pid> (since version 1.17.6).  The "
20972 "I<pid> must be a number greater than 0."
20973 msgstr ""
20975 #. type: =item
20976 #: start-stop-daemon.pod
20977 msgid "B<--ppid> I<ppid>"
20978 msgstr ""
20980 #. type: textblock
20981 #: start-stop-daemon.pod
20982 msgid ""
20983 "Check for a process with the specified parent pid I<ppid> (since version "
20984 "1.17.7).  The I<ppid> must be a number greater than 0."
20985 msgstr ""
20987 #. type: =item
20988 #: start-stop-daemon.pod
20989 msgid "B<-p>, B<--pidfile> I<pidfile>"
20990 msgstr ""
20992 #. type: textblock
20993 #: start-stop-daemon.pod
20994 msgid "Check whether a process has created the file I<pidfile>."
20995 msgstr ""
20997 #. type: textblock
20998 #: start-stop-daemon.pod
20999 msgid ""
21000 "B<Note:> Using this matching option alone might cause unintended processes "
21001 "to be acted on, if the old process terminated without being able to remove "
21002 "the I<pidfile>."
21003 msgstr ""
21005 #. type: textblock
21006 #: start-stop-daemon.pod
21007 msgid ""
21008 "B<Warning:> Using this match option with a world-writable pidfile or using "
21009 "it alone with a daemon that writes the pidfile as an unprivileged (non-root)  "
21010 "user will be refused with an error (since version 1.19.3) as this is a "
21011 "security risk, because either any user can write to it, or if the daemon "
21012 "gets compromised, the contents of the pidfile cannot be trusted, and then a "
21013 "privileged runner (such as an init script executed as root) would end up "
21014 "acting on any system process.  Using I</dev/null> is exempt from these "
21015 "checks."
21016 msgstr ""
21018 #. type: =item
21019 #: start-stop-daemon.pod
21020 msgid "B<-x>, B<--exec> I<executable>"
21021 msgstr ""
21023 #. type: textblock
21024 #: start-stop-daemon.pod
21025 msgid ""
21026 "Check for processes that are instances of this I<executable>. The "
21027 "I<executable> argument should be an absolute pathname."
21028 msgstr ""
21030 #. type: textblock
21031 #: start-stop-daemon.pod
21032 msgid ""
21033 "B<Note:> This might not work as intended with interpreted scripts, as the "
21034 "executable will point to the interpreter. Take into account processes "
21035 "running from inside a chroot will also be matched, so other match "
21036 "restrictions might be needed."
21037 msgstr ""
21039 #. type: =item
21040 #: start-stop-daemon.pod
21041 msgid "B<-n>, B<--name> I<process-name>"
21042 msgstr ""
21044 #. type: textblock
21045 #: start-stop-daemon.pod
21046 msgid ""
21047 "Check for processes with the name I<process-name>. The I<process-name> is "
21048 "usually the process filename, but it could have been changed by the process "
21049 "itself."
21050 msgstr ""
21052 #. type: textblock
21053 #: start-stop-daemon.pod
21054 msgid ""
21055 "B<Note:> On most systems this information is retrieved from the process comm "
21056 "name from the kernel, which tends to have a relatively short length limit "
21057 "(assuming more than 15 characters is non-portable)."
21058 msgstr ""
21060 #. type: =item
21061 #: start-stop-daemon.pod
21062 msgid "B<-u>, B<--user> I<username>|I<uid>"
21063 msgstr ""
21065 #. type: textblock
21066 #: start-stop-daemon.pod
21067 msgid "Check for processes owned by the user specified by I<username> or I<uid>."
21068 msgstr ""
21070 #. type: textblock
21071 #: start-stop-daemon.pod
21072 msgid ""
21073 "B<Note:> Using this matching option alone will cause all processes matching "
21074 "the user to be acted on."
21075 msgstr ""
21077 #. type: =head2
21078 #: start-stop-daemon.pod
21079 msgid "Generic options"
21080 msgstr ""
21082 #. type: =item
21083 #: start-stop-daemon.pod
21084 msgid "B<-g>, B<--group> I<group>|I<gid>"
21085 msgstr ""
21087 #. type: textblock
21088 #: start-stop-daemon.pod
21089 msgid "Change to I<group> or I<gid> when starting the process."
21090 msgstr ""
21092 #. type: =item
21093 #: start-stop-daemon.pod
21094 msgid "B<-s>, B<--signal> I<signal>"
21095 msgstr ""
21097 #. type: textblock
21098 #: start-stop-daemon.pod
21099 msgid ""
21100 "With B<--stop>, specifies the signal to send to processes being stopped "
21101 "(default TERM)."
21102 msgstr ""
21104 #. type: =item
21105 #: start-stop-daemon.pod
21106 msgid "B<-R>, B<--retry> I<timeout>|I<schedule>"
21107 msgstr ""
21109 #. type: textblock
21110 #: start-stop-daemon.pod
21111 msgid ""
21112 "With B<--stop>, specifies that B<start-stop-daemon> is to check whether the "
21113 "process(es)  do finish. It will check repeatedly whether any matching "
21114 "processes are running, until none are. If the processes do not exit it will "
21115 "then take further action as determined by the schedule."
21116 msgstr ""
21118 #. type: textblock
21119 #: start-stop-daemon.pod
21120 msgid ""
21121 "If I<timeout> is specified instead of I<schedule>, then the schedule "
21122 "I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the "
21123 "signal specified with B<--signal>."
21124 msgstr ""
21126 #. type: textblock
21127 #: start-stop-daemon.pod
21128 msgid ""
21129 "I<schedule> is a list of at least two items separated by slashes (B</>); "
21130 "each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means "
21131 "to send that signal, or I<timeout>, which means to wait that many seconds "
21132 "for processes to exit, or B<forever>, which means to repeat the rest of the "
21133 "schedule forever if necessary."
21134 msgstr ""
21136 #. type: textblock
21137 #: start-stop-daemon.pod
21138 msgid ""
21139 "If the end of the schedule is reached and B<forever> is not specified, then "
21140 "B<start-stop-daemon> exits with error status 2.  If a schedule is specified, "
21141 "then any signal specified with B<--signal> is ignored."
21142 msgstr ""
21144 #. type: =item
21145 #: start-stop-daemon.pod
21146 msgid "B<-a>, B<--startas> I<pathname>"
21147 msgstr ""
21149 #. type: textblock
21150 #: start-stop-daemon.pod
21151 msgid ""
21152 "With B<--start>, start the process specified by I<pathname>.  If not "
21153 "specified, defaults to the argument given to B<--exec>."
21154 msgstr ""
21156 #. type: =item
21157 #: start-stop-daemon.pod
21158 msgid "B<-t>, B<--test>"
21159 msgstr ""
21161 #. type: textblock
21162 #: start-stop-daemon.pod
21163 msgid ""
21164 "Print actions that would be taken and set appropriate return value, but take "
21165 "no action."
21166 msgstr ""
21168 #. type: =item
21169 #: start-stop-daemon.pod
21170 msgid "B<-o>, B<--oknodo>"
21171 msgstr ""
21173 #. type: textblock
21174 #: start-stop-daemon.pod
21175 msgid "Return exit status 0 instead of 1 if no actions are (would be) taken."
21176 msgstr ""
21178 #. type: =item
21179 #: start-stop-daemon.pod
21180 msgid "B<-q>, B<--quiet>"
21181 msgstr ""
21183 #. type: textblock
21184 #: start-stop-daemon.pod
21185 msgid "Do not print informational messages; only display error messages."
21186 msgstr ""
21188 #. type: =item
21189 #: start-stop-daemon.pod
21190 msgid "B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]"
21191 msgstr ""
21193 #. type: textblock
21194 #: start-stop-daemon.pod
21195 msgid ""
21196 "Change to this username/uid before starting the process. You can also "
21197 "specify a group by appending a B<:>, then the group or gid in the same way "
21198 "as you would for the B<chown>(1) command (I<user>B<:>I<group>).  If a user "
21199 "is specified without a group, the primary GID for that user is used.  When "
21200 "using this option you must realize that the primary and supplemental groups "
21201 "are set as well, even if the B<--group> option is not specified. The "
21202 "B<--group> option is only for groups that the user isn't normally a member "
21203 "of (like adding per process group membership for generic users like "
21204 "B<nobody>)."
21205 msgstr ""
21207 #. type: =item
21208 #: start-stop-daemon.pod
21209 msgid "B<-r>, B<--chroot> I<root>"
21210 msgstr ""
21212 #. type: textblock
21213 #: start-stop-daemon.pod
21214 msgid ""
21215 "Change directory and chroot to I<root> before starting the process. Please "
21216 "note that the pidfile is also written after the chroot."
21217 msgstr ""
21219 #. type: =item
21220 #: start-stop-daemon.pod
21221 msgid "B<-d>, B<--chdir> I<path>"
21222 msgstr ""
21224 #. type: textblock
21225 #: start-stop-daemon.pod
21226 msgid ""
21227 "Change directory to I<path> before starting the process. This is done after "
21228 "the chroot if the B<-r>|B<--chroot> option is set. When not specified, "
21229 "B<start-stop-daemon> will change directory to the root directory before "
21230 "starting the process."
21231 msgstr ""
21233 #. type: =item
21234 #: start-stop-daemon.pod
21235 msgid "B<-b>, B<--background>"
21236 msgstr ""
21238 #. type: textblock
21239 #: start-stop-daemon.pod
21240 msgid ""
21241 "Typically used with programs that don't detach on their own. This option "
21242 "will force B<start-stop-daemon> to fork before starting the process, and "
21243 "force it into the background."
21244 msgstr ""
21246 #. type: textblock
21247 #: start-stop-daemon.pod
21248 msgid ""
21249 "B<Warning: start-stop-daemon> cannot check the exit status if the process "
21250 "fails to execute for B<any> reason. This is a last resort, and is only meant "
21251 "for programs that either make no sense forking on their own, or where it's "
21252 "not feasible to add the code for them to do this themselves."
21253 msgstr ""
21255 #. type: =item
21256 #: start-stop-daemon.pod
21257 msgid "B<--notify-await>"
21258 msgstr ""
21260 #. type: textblock
21261 #: start-stop-daemon.pod
21262 msgid ""
21263 "Wait for the background process to send a readiness notification before "
21264 "considering the service started (since version 1.19.3).  This implements "
21265 "parts of the systemd readiness protocol, as specified in the B<sd_notify>(3) "
21266 "man page.  The following variables are supported:"
21267 msgstr ""
21269 #. type: =item
21270 #: start-stop-daemon.pod
21271 msgid "B<READY=1>"
21272 msgstr ""
21274 #. type: textblock
21275 #: start-stop-daemon.pod
21276 msgid "The program is ready to give service, so we can exit safely."
21277 msgstr ""
21279 #. type: =item
21280 #: start-stop-daemon.pod
21281 msgid "B<EXTEND_TIMEOUT_USEC=>I<number>"
21282 msgstr ""
21284 #. type: textblock
21285 #: start-stop-daemon.pod
21286 msgid ""
21287 "The program requests to extend the timeout by I<number> microseconds.  This "
21288 "will reset the current timeout to the specified value."
21289 msgstr ""
21291 #. type: =item
21292 #: start-stop-daemon.pod
21293 msgid "B<ERRNO=>I<number>"
21294 msgstr ""
21296 #. type: textblock
21297 #: start-stop-daemon.pod
21298 msgid ""
21299 "The program is exiting with an error.  Do the same and print the "
21300 "user-friendly string for the B<errno> value."
21301 msgstr ""
21303 #. type: =item
21304 #: start-stop-daemon.pod
21305 msgid "B<--notify-timeout> I<timeout>"
21306 msgstr ""
21308 #. type: textblock
21309 #: start-stop-daemon.pod
21310 msgid ""
21311 "Set a timeout for the B<--notify-await> option (since version 1.19.3).  When "
21312 "the timeout is reached, B<start-stop-daemon> will exit with an error code, "
21313 "and no readiness notification will be awaited.  The default is B<60> "
21314 "seconds."
21315 msgstr ""
21317 #. type: =item
21318 #: start-stop-daemon.pod
21319 msgid "B<-C>, B<--no-close>"
21320 msgstr ""
21322 #. type: textblock
21323 #: start-stop-daemon.pod
21324 msgid ""
21325 "Do not close any file descriptor when forcing the daemon into the background "
21326 "(since version 1.16.5).  Used for debugging purposes to see the process "
21327 "output, or to redirect file descriptors to log the process output.  Only "
21328 "relevant when using B<--background>."
21329 msgstr ""
21331 #. type: =item
21332 #: start-stop-daemon.pod
21333 msgid "B<-O>, B<--output> I<pathname>"
21334 msgstr ""
21336 #. type: textblock
21337 #: start-stop-daemon.pod
21338 msgid ""
21339 "Redirect B<stdout> and B<stderr> to I<pathname> when forcing the daemon into "
21340 "the background (since version 1.20.6).  Only relevant when using "
21341 "B<--background>."
21342 msgstr ""
21344 #. type: =item
21345 #: start-stop-daemon.pod
21346 msgid "B<-N>, B<--nicelevel> I<int>"
21347 msgstr ""
21349 #. type: textblock
21350 #: start-stop-daemon.pod
21351 msgid "This alters the priority of the process before starting it."
21352 msgstr ""
21354 #. type: =item
21355 #: start-stop-daemon.pod
21356 msgid "B<-P>, B<--procsched> I<policy>B<:>I<priority>"
21357 msgstr ""
21359 #. type: textblock
21360 #: start-stop-daemon.pod
21361 msgid ""
21362 "This alters the process scheduler policy and priority of the process before "
21363 "starting it (since version 1.15.0).  The priority can be optionally "
21364 "specified by appending a B<:> followed by the value. The default I<priority> "
21365 "is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>."
21366 msgstr ""
21368 #. type: textblock
21369 #: start-stop-daemon.pod
21370 msgid ""
21371 "This option might do nothing on some systems, where POSIX process scheduling "
21372 "is not supported."
21373 msgstr ""
21375 #. type: =item
21376 #: start-stop-daemon.pod
21377 msgid "B<-I>, B<--iosched> I<class>B<:>I<priority>"
21378 msgstr ""
21380 #. type: textblock
21381 #: start-stop-daemon.pod
21382 msgid ""
21383 "This alters the IO scheduler class and priority of the process before "
21384 "starting it (since version 1.15.0).  The priority can be optionally "
21385 "specified by appending a B<:> followed by the value. The default I<priority> "
21386 "is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The "
21387 "currently supported values for I<class> are B<idle>, B<best-effort> and "
21388 "B<real-time>."
21389 msgstr ""
21391 #. type: textblock
21392 #: start-stop-daemon.pod
21393 msgid ""
21394 "This option might do nothing on some systems, where Linux IO scheduling is "
21395 "not supported."
21396 msgstr ""
21398 #. type: =item
21399 #: start-stop-daemon.pod
21400 msgid "B<-k>, B<--umask> I<mask>"
21401 msgstr ""
21403 #. type: textblock
21404 #: start-stop-daemon.pod
21405 msgid ""
21406 "This sets the umask of the process before starting it (since version "
21407 "1.13.22)."
21408 msgstr ""
21410 #. type: =item
21411 #: start-stop-daemon.pod
21412 msgid "B<-m>, B<--make-pidfile>"
21413 msgstr ""
21415 #. type: textblock
21416 #: start-stop-daemon.pod
21417 msgid ""
21418 "Used when starting a program that does not create its own pid file. This "
21419 "option will make B<start-stop-daemon> create the file referenced with "
21420 "B<--pidfile> and place the pid into it just before executing the "
21421 "process. Note, the file will only be removed when stopping the program if "
21422 "B<--remove-pidfile> is used."
21423 msgstr ""
21425 #. type: textblock
21426 #: start-stop-daemon.pod
21427 msgid ""
21428 "B<Note:> This feature may not work in all cases. Most notably when the "
21429 "program being executed forks from its main process. Because of this, it is "
21430 "usually only useful when combined with the B<--background> option."
21431 msgstr ""
21433 #. type: =item
21434 #: start-stop-daemon.pod
21435 msgid "B<--remove-pidfile>"
21436 msgstr ""
21438 #. type: textblock
21439 #: start-stop-daemon.pod
21440 msgid ""
21441 "Used when stopping a program that does not remove its own pid file (since "
21442 "version 1.17.19).  This option will make B<start-stop-daemon> remove the "
21443 "file referenced with B<--pidfile> after terminating the process."
21444 msgstr ""
21446 #. type: textblock
21447 #: start-stop-daemon.pod
21448 msgid "Print verbose informational messages."
21449 msgstr ""
21451 #. type: textblock
21452 #: start-stop-daemon.pod
21453 msgid ""
21454 "The requested action was performed. If B<--oknodo> was specified, it's also "
21455 "possible that nothing had to be done.  This can happen when B<--start> was "
21456 "specified and a matching process was already running, or when B<--stop> was "
21457 "specified and there were no matching processes."
21458 msgstr ""
21460 #. type: textblock
21461 #: start-stop-daemon.pod
21462 msgid "If B<--oknodo> was not specified and nothing was done."
21463 msgstr ""
21465 #. type: textblock
21466 #: start-stop-daemon.pod
21467 msgid ""
21468 "If B<--stop> and B<--retry> were specified, but the end of the schedule was "
21469 "reached and the processes were still running."
21470 msgstr ""
21472 #. type: =item
21473 #: start-stop-daemon.pod
21474 msgid "B<3>"
21475 msgstr ""
21477 #. type: textblock
21478 #: start-stop-daemon.pod
21479 msgid "Any other error."
21480 msgstr ""
21482 #. type: textblock
21483 #: start-stop-daemon.pod
21484 msgid "When using the B<--status> command, the following status codes are returned:"
21485 msgstr ""
21487 #. type: textblock
21488 #: start-stop-daemon.pod
21489 msgid "Program is running."
21490 msgstr ""
21492 #. type: textblock
21493 #: start-stop-daemon.pod
21494 msgid "Program is not running and the pid file exists."
21495 msgstr ""
21497 #. type: textblock
21498 #: start-stop-daemon.pod
21499 msgid "Program is not running."
21500 msgstr ""
21502 #. type: =item
21503 #: start-stop-daemon.pod
21504 msgid "B<4>"
21505 msgstr ""
21507 #. type: textblock
21508 #: start-stop-daemon.pod
21509 msgid "Unable to determine program status."
21510 msgstr ""
21512 #. type: textblock
21513 #: start-stop-daemon.pod
21514 msgid ""
21515 "Start the B<food> daemon, unless one is already running (a process named "
21516 "food, running as user food, with pid in food.pid):"
21517 msgstr ""
21519 #. type: verbatim
21520 #: start-stop-daemon.pod
21521 #, no-wrap
21522 msgid ""
21523 " start-stop-daemon --start --oknodo --user food --name food \\\n"
21524 "   --pidfile %RUNSTATEDIR%/food.pid --startas /usr/sbin/food \\\n"
21525 "   --chuid food -- --daemon\n"
21526 "\n"
21527 msgstr ""
21529 #. type: textblock
21530 #: start-stop-daemon.pod
21531 msgid "Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:"
21532 msgstr ""
21534 #. type: verbatim
21535 #: start-stop-daemon.pod
21536 #, no-wrap
21537 msgid ""
21538 " start-stop-daemon --stop --oknodo --user food --name food \\\n"
21539 "   --pidfile %RUNSTATEDIR%/food.pid --retry 5\n"
21540 "\n"
21541 msgstr ""
21543 #. type: textblock
21544 #: start-stop-daemon.pod
21545 msgid "Demonstration of a custom schedule for stopping B<food>:"
21546 msgstr ""
21548 #. type: verbatim
21549 #: start-stop-daemon.pod
21550 #, no-wrap
21551 msgid ""
21552 " start-stop-daemon --stop --oknodo --user food --name food \\\n"
21553 "   --pidfile %RUNSTATEDIR%/food.pid --retry=TERM/30/KILL/5\n"
21554 "\n"
21555 msgstr ""
21557 #. type: textblock
21558 #: update-alternatives.pod
21559 msgid "update-alternatives - maintain symbolic links determining default commands"
21560 msgstr ""
21562 #. type: textblock
21563 #: update-alternatives.pod
21564 msgid "B<update-alternatives> [I<option>...] I<command>"
21565 msgstr ""
21567 #. type: textblock
21568 #: update-alternatives.pod
21569 msgid ""
21570 "B<update-alternatives> creates, removes, maintains and displays information "
21571 "about the symbolic links comprising the Debian alternatives system."
21572 msgstr ""
21574 #. type: textblock
21575 #: update-alternatives.pod
21576 msgid ""
21577 "It is possible for several programs fulfilling the same or similar functions "
21578 "to be installed on a single system at the same time.  For example, many "
21579 "systems have several text editors installed at once.  This gives choice to "
21580 "the users of a system, allowing each to use a different editor, if desired, "
21581 "but makes it difficult for a program to make a good choice for an editor to "
21582 "invoke if the user has not specified a particular preference."
21583 msgstr ""
21585 #. type: textblock
21586 #: update-alternatives.pod
21587 msgid ""
21588 "Debian's alternatives system aims to solve this problem.  A generic name in "
21589 "the filesystem is shared by all files providing interchangeable "
21590 "functionality.  The alternatives system and the system administrator "
21591 "together determine which actual file is referenced by this generic name.  "
21592 "For example, if the text editors B<ed>(1)  and B<nvi>(1)  are both installed "
21593 "on the system, the alternatives system will cause the generic name "
21594 "I</usr/bin/editor> to refer to I</usr/bin/nvi> by default. The system "
21595 "administrator can override this and cause it to refer to I</usr/bin/ed> "
21596 "instead, and the alternatives system will not alter this setting until "
21597 "explicitly requested to do so."
21598 msgstr ""
21600 #. type: textblock
21601 #: update-alternatives.pod
21602 msgid ""
21603 "The generic name is not a direct symbolic link to the selected alternative.  "
21604 "Instead, it is a symbolic link to a name in the I<alternatives> "
21605 "I<directory>, which in turn is a symbolic link to the actual file "
21606 "referenced.  This is done so that the system administrator's changes can be "
21607 "confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why "
21608 "this is a Good Thing."
21609 msgstr ""
21611 #. type: textblock
21612 #: update-alternatives.pod
21613 msgid ""
21614 "When each package providing a file with a particular functionality is "
21615 "installed, changed or removed, B<update-alternatives> is called to update "
21616 "information about that file in the alternatives system.  "
21617 "B<update-alternatives> is usually called from the following Debian package "
21618 "maintainer scripts, B<postinst> (configure) to install the alternative and "
21619 "from B<prerm> and B<postrm> (remove) to remove the alternative.  B<Note:> in "
21620 "most (if not all) cases no other maintainer script actions should call "
21621 "B<update-alternatives>, in particular neither of B<upgrade> nor "
21622 "B<disappear>, as any other such action can lose the manual state of an "
21623 "alternative, or make the alternative temporarily flip-flop, or completely "
21624 "switch when several of them have the same priority."
21625 msgstr ""
21627 #. type: textblock
21628 #: update-alternatives.pod
21629 msgid ""
21630 "It is often useful for a number of alternatives to be synchronized, so that "
21631 "they are changed as a group; for example, when several versions of the "
21632 "B<vi>(1)  editor are installed, the man page referenced by "
21633 "I</usr/share/man/man1/vi.1> should correspond to the executable referenced "
21634 "by I</usr/bin/vi>.  B<update-alternatives> handles this by means of "
21635 "I<master> and I<slave> links; when the master is changed, any associated "
21636 "slaves are changed too.  A master link and its associated slaves make up a "
21637 "I<link> I<group>."
21638 msgstr ""
21640 #. type: textblock
21641 #: update-alternatives.pod
21642 msgid ""
21643 "Each link group is, at any given time, in one of two modes: automatic or "
21644 "manual.  When a group is in automatic mode, the alternatives system will "
21645 "automatically decide, as packages are installed and removed, whether and how "
21646 "to update the links.  In manual mode, the alternatives system will retain "
21647 "the choice of the administrator and avoid changing the links (except when "
21648 "something is broken)."
21649 msgstr ""
21651 #. type: textblock
21652 #: update-alternatives.pod
21653 msgid ""
21654 "Link groups are in automatic mode when they are first introduced to the "
21655 "system.  If the system administrator makes changes to the system's automatic "
21656 "settings, this will be noticed the next time B<update-alternatives> is run "
21657 "on the changed link's group, and the group will automatically be switched to "
21658 "manual mode."
21659 msgstr ""
21661 #. type: textblock
21662 #: update-alternatives.pod
21663 msgid ""
21664 "Each alternative has a I<priority> associated with it.  When a link group is "
21665 "in automatic mode, the alternatives pointed to by members of the group will "
21666 "be those which have the highest priority."
21667 msgstr ""
21669 #. type: textblock
21670 #: update-alternatives.pod
21671 msgid ""
21672 "When using the B<--config> option, B<update-alternatives> will list all of "
21673 "the choices for the link group of which given I<name> is the master "
21674 "alternative name.  The current choice is marked with a ‘*’.  You will then "
21675 "be prompted for your choice regarding this link group.  Depending on the "
21676 "choice made, the link group might no longer be in I<auto> mode. You will "
21677 "need to use the B<--auto> option in order to return to the automatic mode "
21678 "(or you can rerun B<--config> and select the entry marked as automatic)."
21679 msgstr ""
21681 #. type: textblock
21682 #: update-alternatives.pod
21683 msgid ""
21684 "If you want to configure non-interactively you can use the B<--set> option "
21685 "instead (see below)."
21686 msgstr ""
21688 #. type: textblock
21689 #: update-alternatives.pod
21690 msgid ""
21691 "Different packages providing the same file need to do so B<cooperatively>.  "
21692 "In other words, the usage of B<update-alternatives> is B<mandatory> for all "
21693 "involved packages in such case. It is not possible to override some file in "
21694 "a package that does not employ the B<update-alternatives> mechanism."
21695 msgstr ""
21697 #. type: =head1
21698 #: update-alternatives.pod
21699 msgid "TERMINOLOGY"
21700 msgstr ""
21702 #. type: textblock
21703 #: update-alternatives.pod
21704 msgid ""
21705 "Since the activities of B<update-alternatives> are quite involved, some "
21706 "specific terms will help to explain its operation."
21707 msgstr ""
21709 #. type: =item
21710 #: update-alternatives.pod
21711 msgid "generic name (or alternative link)"
21712 msgstr ""
21714 #. type: textblock
21715 #: update-alternatives.pod
21716 msgid ""
21717 "A name, like I</usr/bin/editor>, which refers, via the alternatives system, "
21718 "to one of a number of files of similar function."
21719 msgstr ""
21721 #. type: =item
21722 #: update-alternatives.pod
21723 msgid "alternative name"
21724 msgstr ""
21726 #. type: textblock
21727 #: update-alternatives.pod
21728 msgid "The name of a symbolic link in the alternatives directory."
21729 msgstr ""
21731 #. type: =item
21732 #: update-alternatives.pod
21733 msgid "alternative (or alternative path)"
21734 msgstr ""
21736 #. type: textblock
21737 #: update-alternatives.pod
21738 msgid ""
21739 "The name of a specific file in the filesystem, which may be made accessible "
21740 "via a generic name using the alternatives system."
21741 msgstr ""
21743 #. type: =item
21744 #: update-alternatives.pod
21745 msgid "alternatives directory"
21746 msgstr ""
21748 #. type: textblock
21749 #: update-alternatives.pod
21750 msgid "A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks."
21751 msgstr ""
21753 #. type: =item
21754 #: update-alternatives.pod
21755 msgid "administrative directory"
21756 msgstr ""
21758 #. type: textblock
21759 #: update-alternatives.pod
21760 msgid ""
21761 "A directory, by default I<%ADMINDIR%/alternatives>, containing "
21762 "B<update-alternatives>' state information."
21763 msgstr ""
21765 #. type: =item
21766 #: update-alternatives.pod
21767 msgid "link group"
21768 msgstr ""
21770 #. type: textblock
21771 #: update-alternatives.pod
21772 msgid "A set of related symlinks, intended to be updated as a group."
21773 msgstr ""
21775 #. type: =item
21776 #: update-alternatives.pod
21777 msgid "master link"
21778 msgstr ""
21780 #. type: textblock
21781 #: update-alternatives.pod
21782 msgid ""
21783 "The alternative link in a link group which determines how the other links in "
21784 "the group are configured."
21785 msgstr ""
21787 #. type: =item
21788 #: update-alternatives.pod
21789 msgid "slave link"
21790 msgstr ""
21792 #. type: textblock
21793 #: update-alternatives.pod
21794 msgid ""
21795 "An alternative link in a link group which is controlled by the setting of "
21796 "the master link."
21797 msgstr ""
21799 #. type: =item
21800 #: update-alternatives.pod
21801 msgid "automatic mode"
21802 msgstr ""
21804 #. type: textblock
21805 #: update-alternatives.pod
21806 msgid ""
21807 "When a link group is in automatic mode, the alternatives system ensures that "
21808 "the links in the group point to the highest priority alternative appropriate "
21809 "for the group."
21810 msgstr ""
21812 #. type: =item
21813 #: update-alternatives.pod
21814 msgid "manual mode"
21815 msgstr ""
21817 #. type: textblock
21818 #: update-alternatives.pod
21819 msgid ""
21820 "When a link group is in manual mode, the alternatives system will not make "
21821 "any changes to the system administrator's settings."
21822 msgstr ""
21824 #. type: =item
21825 #: update-alternatives.pod
21826 msgid "B<--install> I<link name path priority> [B<--slave> I<link name path>]..."
21827 msgstr ""
21829 #. type: textblock
21830 #: update-alternatives.pod
21831 msgid ""
21832 "Add a group of alternatives to the system.  I<link> is the generic name for "
21833 "the master link, I<name> is the name of its symlink in the alternatives "
21834 "directory, and I<path> is the alternative being introduced for the master "
21835 "link.  The arguments after B<--slave> are the generic name, symlink name in "
21836 "the alternatives directory and the alternative path for a slave link.  Zero "
21837 "or more B<--slave> options, each followed by three arguments, may be "
21838 "specified. Note that the master alternative must exist or the call will "
21839 "fail. However if a slave alternative doesn't exist, the corresponding slave "
21840 "alternative link will simply not be installed (a warning will still be "
21841 "displayed). If some real file is installed where an alternative link has to "
21842 "be installed, it is kept unless B<--force> is used."
21843 msgstr ""
21845 #. type: textblock
21846 #: update-alternatives.pod
21847 msgid ""
21848 "If the alternative name specified exists already in the alternatives "
21849 "system's records, the information supplied will be added as a new set of "
21850 "alternatives for the group.  Otherwise, a new group, set to automatic mode, "
21851 "will be added with this information.  If the group is in automatic mode, and "
21852 "the newly added alternatives' priority is higher than any other installed "
21853 "alternatives for this group, the symlinks will be updated to point to the "
21854 "newly added alternatives."
21855 msgstr ""
21857 #. type: =item
21858 #: update-alternatives.pod
21859 msgid "B<--set> I<name> I<path>"
21860 msgstr ""
21862 #. type: textblock
21863 #: update-alternatives.pod
21864 msgid ""
21865 "Set the program I<path> as alternative for I<name>.  This is equivalent to "
21866 "B<--config> but is non-interactive and thus scriptable."
21867 msgstr ""
21869 #. type: =item
21870 #: update-alternatives.pod
21871 msgid "B<--remove> I<name> I<path>"
21872 msgstr ""
21874 #. type: textblock
21875 #: update-alternatives.pod
21876 msgid ""
21877 "Remove an alternative and all of its associated slave links.  I<name> is a "
21878 "name in the alternatives directory, and I<path> is an absolute filename to "
21879 "which I<name> could be linked. If I<name> is indeed linked to I<path>, "
21880 "I<name> will be updated to point to another appropriate alternative (and the "
21881 "group is put back in automatic mode), or removed if there is no such "
21882 "alternative left.  Associated slave links will be updated or removed, "
21883 "correspondingly.  If the link is not currently pointing to I<path>, no links "
21884 "are changed; only the information about the alternative is removed."
21885 msgstr ""
21887 #. type: =item
21888 #: update-alternatives.pod
21889 msgid "B<--remove-all> I<name>"
21890 msgstr ""
21892 #. type: textblock
21893 #: update-alternatives.pod
21894 msgid ""
21895 "Remove all alternatives and all of their associated slave links.  I<name> is "
21896 "a name in the alternatives directory."
21897 msgstr ""
21899 #. type: textblock
21900 #: update-alternatives.pod
21901 msgid ""
21902 "Call B<--config> on all alternatives. It can be usefully combined with "
21903 "B<--skip-auto> to review and configure all alternatives which are not "
21904 "configured in automatic mode. Broken alternatives are also displayed.  Thus "
21905 "a simple way to fix all broken alternatives is to call B<yes '' | "
21906 "update-alternatives --force --all>."
21907 msgstr ""
21909 #. type: =item
21910 #: update-alternatives.pod
21911 msgid "B<--auto> I<name>"
21912 msgstr ""
21914 #. type: textblock
21915 #: update-alternatives.pod
21916 msgid ""
21917 "Switch the link group behind the alternative for I<name> to automatic mode.  "
21918 "In the process, the master symlink and its slaves are updated to point to "
21919 "the highest priority installed alternatives."
21920 msgstr ""
21922 #. type: =item
21923 #: update-alternatives.pod
21924 msgid "B<--display> I<name>"
21925 msgstr ""
21927 #. type: textblock
21928 #: update-alternatives.pod
21929 msgid ""
21930 "Display information about the link group.  Information displayed includes "
21931 "the group's mode (auto or manual), the master and slave links, which "
21932 "alternative the master link currently points to, what other alternatives are "
21933 "available (and their corresponding slave alternatives), and the highest "
21934 "priority alternative currently installed."
21935 msgstr ""
21937 #. type: =item
21938 #: update-alternatives.pod
21939 msgid "B<--get-selections>"
21940 msgstr ""
21942 #. type: textblock
21943 #: update-alternatives.pod
21944 msgid ""
21945 "List all master alternative names (those controlling a link group)  and "
21946 "their status (since version 1.15.0).  Each line contains up to 3 fields "
21947 "(separated by one or more spaces). The first field is the alternative name, "
21948 "the second one is the status (either B<auto> or B<manual>), and the last one "
21949 "contains the current choice in the alternative (beware: it's a filename and "
21950 "thus might contain spaces)."
21951 msgstr ""
21953 #. type: textblock
21954 #: update-alternatives.pod
21955 msgid ""
21956 "Read configuration of alternatives on standard input in the format generated "
21957 "by B<--get-selections> and reconfigure them accordingly (since version "
21958 "1.15.0)."
21959 msgstr ""
21961 #. type: =item
21962 #: update-alternatives.pod
21963 msgid "B<--query> I<name>"
21964 msgstr ""
21966 #. type: textblock
21967 #: update-alternatives.pod
21968 msgid ""
21969 "Display information about the link group like B<--display> does, but in a "
21970 "machine parseable way (since version 1.15.0, see section B<QUERY FORMAT> "
21971 "below)."
21972 msgstr ""
21974 #. type: =item
21975 #: update-alternatives.pod
21976 msgid "B<--list> I<name>"
21977 msgstr ""
21979 #. type: textblock
21980 #: update-alternatives.pod
21981 msgid "Display all targets of the link group."
21982 msgstr ""
21984 #. type: =item
21985 #: update-alternatives.pod
21986 msgid "B<--config> I<name>"
21987 msgstr ""
21989 #. type: textblock
21990 #: update-alternatives.pod
21991 msgid ""
21992 "Show available alternatives for a link group and allow the user to "
21993 "interactively select which one to use. The link group is updated."
21994 msgstr ""
21996 #. type: =item
21997 #: update-alternatives.pod
21998 msgid "B<--altdir> I<directory>"
21999 msgstr ""
22001 #. type: textblock
22002 #: update-alternatives.pod
22003 msgid ""
22004 "Specifies the alternatives directory, when this is to be different from the "
22005 "default.  Defaults to «I<%CONFDIR%/alternatives>»."
22006 msgstr ""
22008 #. type: textblock
22009 #: update-alternatives.pod
22010 msgid ""
22011 "Specifies the administrative directory, when this is to be different from "
22012 "the default.  Defaults to «I<%ADMINDIR%/alternatives>» if "
22013 "B<%ADMINDIR_ENVVAR%> has not been set."
22014 msgstr ""
22016 #. type: textblock
22017 #: update-alternatives.pod
22018 msgid ""
22019 "Specifies the installation directory where alternatives links will be "
22020 "created (since version 1.20.1).  Defaults to «I</>» if B<%INSTDIR_ENVVAR%> "
22021 "has not been set."
22022 msgstr ""
22024 #. type: textblock
22025 #: update-alternatives.pod
22026 msgid ""
22027 "Specifies the root directory (since version 1.20.1).  This also sets the "
22028 "alternatives, installation and administrative directories to match.  "
22029 "Defaults to «I</>» if B<%INSTDIR_ENVVAR%> has not been set."
22030 msgstr ""
22032 #. type: =item
22033 #: update-alternatives.pod
22034 msgid "B<--log> I<file>"
22035 msgstr ""
22037 #. type: textblock
22038 #: update-alternatives.pod
22039 msgid ""
22040 "Specifies the log file (since version 1.15.0), when this is to be different "
22041 "from the default (%LOGDIR%/alternatives.log)."
22042 msgstr ""
22044 #. type: textblock
22045 #: update-alternatives.pod
22046 msgid ""
22047 "Allow replacing or dropping any real file that is installed where an "
22048 "alternative link has to be installed or removed."
22049 msgstr ""
22051 #. type: =item
22052 #: update-alternatives.pod
22053 msgid "B<--skip-auto>"
22054 msgstr ""
22056 #. type: textblock
22057 #: update-alternatives.pod
22058 msgid ""
22059 "Skip configuration prompt for alternatives which are properly configured in "
22060 "automatic mode. This option is only relevant with B<--config> or B<--all>."
22061 msgstr ""
22063 #. type: textblock
22064 #: update-alternatives.pod
22065 msgid "Do not generate any comments unless errors occur."
22066 msgstr ""
22068 #. type: =item
22069 #: update-alternatives.pod
22070 msgid "B<--verbose>"
22071 msgstr ""
22073 #. type: textblock
22074 #: update-alternatives.pod
22075 msgid "Generate more comments about what is being done."
22076 msgstr ""
22078 #. type: textblock
22079 #: update-alternatives.pod
22080 msgid ""
22081 "Generate even more comments, helpful for debugging, about what is being done "
22082 "(since version 1.19.3)."
22083 msgstr ""
22085 #. type: textblock
22086 #: update-alternatives.pod
22087 msgid ""
22088 "Problems were encountered whilst parsing the command line or performing the "
22089 "action."
22090 msgstr ""
22092 #. type: =item
22093 #: update-alternatives.pod
22094 msgid "B<%INSTDIR_ENVVAR%>"
22095 msgstr ""
22097 #. type: =item
22098 #: update-alternatives.pod
22099 msgid "B<%ADMINDIR_ENVVAR%>"
22100 msgstr ""
22102 #. type: textblock
22103 #: update-alternatives.pod
22104 msgid ""
22105 "If set and the B<--admindir> option has not been specified, it will be used "
22106 "as the base administrative directory."
22107 msgstr ""
22109 #. type: =item
22110 #: update-alternatives.pod
22111 msgid "I<%CONFDIR%/alternatives/>"
22112 msgstr ""
22114 #. type: textblock
22115 #: update-alternatives.pod
22116 msgid ""
22117 "The default alternatives directory.  Can be overridden by the B<--altdir> "
22118 "option."
22119 msgstr ""
22121 #. type: =item
22122 #: update-alternatives.pod
22123 msgid "I<%ADMINDIR%/alternatives/>"
22124 msgstr ""
22126 #. type: textblock
22127 #: update-alternatives.pod
22128 msgid ""
22129 "The default administration directory.  Can be overridden by the "
22130 "B<--admindir> option."
22131 msgstr ""
22133 #. type: =head1
22134 #: update-alternatives.pod
22135 msgid "QUERY FORMAT"
22136 msgstr ""
22138 #. type: textblock
22139 #: update-alternatives.pod
22140 msgid ""
22141 "The B<--query> format is using an RFC822-like flat format. It's made of I<n> "
22142 "+ 1 stanzas where I<n> is the number of alternatives available in the "
22143 "queried link group. The first stanza contains the following fields:"
22144 msgstr ""
22146 #. type: =item
22147 #: update-alternatives.pod
22148 msgid "B<Name:> I<name>"
22149 msgstr ""
22151 #. type: textblock
22152 #: update-alternatives.pod
22153 msgid "The alternative name in the alternative directory."
22154 msgstr ""
22156 #. type: =item
22157 #: update-alternatives.pod
22158 msgid "B<Link:> I<link>"
22159 msgstr ""
22161 #. type: textblock
22162 #: update-alternatives.pod
22163 msgid "The generic name of the alternative."
22164 msgstr ""
22166 #. type: =item
22167 #: update-alternatives.pod
22168 msgid "B<Slaves:> I<list-of-slaves>"
22169 msgstr ""
22171 #. type: textblock
22172 #: update-alternatives.pod
22173 msgid ""
22174 "When this field is present, the B<next> lines hold all slave links "
22175 "associated to the master link of the alternative. There is one slave per "
22176 "line. Each line contains one space, the generic name of the slave "
22177 "alternative, another space, and the path to the slave link."
22178 msgstr ""
22180 #. type: =item
22181 #: update-alternatives.pod
22182 msgid "B<Status:> I<status>"
22183 msgstr ""
22185 #. type: textblock
22186 #: update-alternatives.pod
22187 msgid "The status of the alternative (B<auto> or B<manual>)."
22188 msgstr ""
22190 #. type: =item
22191 #: update-alternatives.pod
22192 msgid "B<Best:> I<best-choice>"
22193 msgstr ""
22195 #. type: textblock
22196 #: update-alternatives.pod
22197 msgid ""
22198 "The path of the best alternative for this link group. Not present if there "
22199 "is no alternatives available."
22200 msgstr ""
22202 #. type: =item
22203 #: update-alternatives.pod
22204 msgid "B<Value:> I<currently-selected-alternative>"
22205 msgstr ""
22207 #. type: textblock
22208 #: update-alternatives.pod
22209 msgid ""
22210 "The path of the currently selected alternative. It can also take the magic "
22211 "value B<none>. It is used if the link doesn't exist."
22212 msgstr ""
22214 #. type: textblock
22215 #: update-alternatives.pod
22216 msgid ""
22217 "The other stanzas describe the available alternatives in the queried link "
22218 "group:"
22219 msgstr ""
22221 #. type: =item
22222 #: update-alternatives.pod
22223 msgid "B<Alternative:> I<path-of-this-alternative>"
22224 msgstr ""
22226 #. type: textblock
22227 #: update-alternatives.pod
22228 msgid "Path to this stanza's alternative."
22229 msgstr ""
22231 #. type: =item
22232 #: update-alternatives.pod
22233 msgid "B<Priority:> I<priority-value>"
22234 msgstr ""
22236 #. type: textblock
22237 #: update-alternatives.pod
22238 msgid "Value of the priority of this alternative."
22239 msgstr ""
22241 #. type: textblock
22242 #: update-alternatives.pod
22243 msgid ""
22244 "When this field is present, the B<next> lines hold all slave alternatives "
22245 "associated to the master link of the alternative. There is one slave per "
22246 "line. Each line contains one space, the generic name of the slave "
22247 "alternative, another space, and the path to the slave alternative."
22248 msgstr ""
22250 #. type: =head2
22251 #: update-alternatives.pod
22252 msgid "Example"
22253 msgstr ""
22255 #. type: verbatim
22256 #: update-alternatives.pod
22257 #, no-wrap
22258 msgid ""
22259 " $ update-alternatives --query editor\n"
22260 " Name: editor\n"
22261 " Link: /usr/bin/editor\n"
22262 " Slaves:\n"
22263 "  editor.1.gz /usr/share/man/man1/editor.1.gz\n"
22264 "  editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz\n"
22265 "  editor.it.1.gz /usr/share/man/it/man1/editor.1.gz\n"
22266 "  editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz\n"
22267 "  editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz\n"
22268 " Status: auto\n"
22269 " Best: /usr/bin/vim.basic\n"
22270 " Value: /usr/bin/vim.basic\n"
22271 "\n"
22272 msgstr ""
22274 #. type: verbatim
22275 #: update-alternatives.pod
22276 #, no-wrap
22277 msgid ""
22278 " Alternative: /bin/ed\n"
22279 " Priority: -100\n"
22280 " Slaves:\n"
22281 "  editor.1.gz /usr/share/man/man1/ed.1.gz\n"
22282 "\n"
22283 msgstr ""
22285 #. type: verbatim
22286 #: update-alternatives.pod
22287 #, no-wrap
22288 msgid ""
22289 " Alternative: /usr/bin/vim.basic\n"
22290 " Priority: 50\n"
22291 " Slaves:\n"
22292 "  editor.1.gz /usr/share/man/man1/vim.1.gz\n"
22293 "  editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz\n"
22294 "  editor.it.1.gz /usr/share/man/it/man1/vim.1.gz\n"
22295 "  editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz\n"
22296 "  editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz\n"
22297 "\n"
22298 msgstr ""
22300 #. type: textblock
22301 #: update-alternatives.pod
22302 msgid ""
22303 "With B<--verbose> B<update-alternatives> chatters incessantly about its "
22304 "activities on its standard output channel.  If problems occur, "
22305 "B<update-alternatives> outputs error messages on its standard error channel "
22306 "and returns an exit status of 2.  These diagnostics should be "
22307 "self-explanatory; if you do not find them so, please report this as a bug."
22308 msgstr ""
22310 #. type: textblock
22311 #: update-alternatives.pod
22312 msgid ""
22313 "There are several packages which provide a text editor compatible with "
22314 "B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the "
22315 "link group B<vi>, which includes links for the program itself and the "
22316 "associated manpage."
22317 msgstr ""
22319 #. type: textblock
22320 #: update-alternatives.pod
22321 msgid ""
22322 "To display the available packages which provide B<vi> and the current "
22323 "setting for it, use the B<--display> action:"
22324 msgstr ""
22326 #. type: verbatim
22327 #: update-alternatives.pod
22328 #, no-wrap
22329 msgid ""
22330 " update-alternatives --display vi\n"
22331 "\n"
22332 msgstr ""
22334 #. type: textblock
22335 #: update-alternatives.pod
22336 msgid ""
22337 "To choose a particular B<vi> implementation, use this command as root and "
22338 "then select a number from the list:"
22339 msgstr ""
22341 #. type: verbatim
22342 #: update-alternatives.pod
22343 #, no-wrap
22344 msgid ""
22345 " update-alternatives --config vi\n"
22346 "\n"
22347 msgstr ""
22349 #. type: textblock
22350 #: update-alternatives.pod
22351 msgid ""
22352 "To go back to having the B<vi> implementation chosen automatically, do this "
22353 "as root:"
22354 msgstr ""
22356 #. type: verbatim
22357 #: update-alternatives.pod
22358 #, no-wrap
22359 msgid ""
22360 " update-alternatives --auto vi\n"
22361 "\n"
22362 msgstr ""
22364 #. type: textblock
22365 #: update-alternatives.pod
22366 msgid "B<ln>(1), FHS (the Filesystem Hierarchy Standard)."
22367 msgstr ""