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.
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"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
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
41 msgid "deb-buildinfo - Debian build information file format"
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
65 msgid "I<filename>B<.buildinfo>"
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
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."
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)."
109 #: deb-buildinfo.pod deb-changes.pod dsc.pod
111 "The control data might be enclosed in an OpenPGP ASCII Armored signature, as "
112 "specified in RFC4880."
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> "
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>."
129 #: deb-buildinfo.pod deb-changes.pod deb-control.pod deb-origin.pod dsc.pod
134 #: deb-buildinfo.pod deb-changes.pod dsc.pod
135 msgid "B<Format:> I<format-version> (required)"
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>."
149 #: deb-buildinfo.pod deb-changes.pod
150 msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)"
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."
163 #: deb-buildinfo.pod deb-changes.pod
164 msgid "B<Binary:> I<binary-package-list> (required in context)"
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)."
176 msgid "B<Architecture:> I<arch-list> (required)"
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."
191 #: deb-buildinfo.pod deb-changes.pod deb-control.pod dsc.pod
192 msgid "B<Version:> I<version-string> (required)"
196 #: deb-buildinfo.pod deb-changes.pod dsc.pod
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)."
206 msgid "B<Binary-Only-Changes:>"
211 msgid "S< >I<changelog-entry>"
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."
226 msgid "B<Checksums-Md5:> (required)"
230 #: deb-buildinfo.pod deb-changes.pod dsc.pod
231 msgid "B<Checksums-Sha1:> (required)"
235 #: deb-buildinfo.pod deb-changes.pod dsc.pod
236 msgid "B<Checksums-Sha256:> (required)"
240 #: deb-buildinfo.pod deb-changes.pod dsc.pod
241 msgid "S< >I<checksum> I<size> I<filename>"
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>."
254 #: deb-buildinfo.pod deb-changes.pod
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, "
265 msgid "These fields list all files that make up the build."
270 msgid "B<Build-Origin:> I<name>"
274 #: deb-buildinfo.pod deb-control.pod dsc.pod
275 msgid "The name of the distribution this package is originating from."
280 msgid "B<Build-Architecture:> I<arch> (required)"
286 "The Debian architecture for the installation the packages is being built "
287 "in. Common architectures are B<amd64>, B<armel>, B<i386>, etc."
292 msgid "B<Build-Date:> I<build-date>"
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."
304 msgid "B<Build-Kernel-Version:> I<build-kernel-version>"
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."
317 msgid "B<Build-Path:> I<build-path>"
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."
331 "On Debian and derivatives only build paths starting with I</build/> will "
337 msgid "B<Build-Tainted-By:>"
342 msgid "S< >I<taint-reason-list>"
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)."
355 msgid "On Debian and derivatives the following reason tags can be emitted:"
360 msgid "B<merged-usr-via-aliased-dirs>"
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 "
379 msgid "B<usr-local-has-configs>"
384 msgid "The system has configuration files under I</usr/local/etc>."
389 msgid "B<usr-local-has-includes>"
394 msgid "The system has header files under I</usr/local/include>."
399 msgid "B<usr-local-has-programs>"
404 msgid "The system has programs under I</usr/local/bin> or I</usr/local/sbin>."
409 msgid "B<usr-local-has-libraries>"
414 msgid "The system has libraries, either static or shared under I</usr/local/lib>."
419 msgid "B<can-execute-cross-built-programs>"
425 "The system can execute cross built programs, either directly or via some "
431 msgid "Since dpkg 1.21.10."
436 msgid "B<Installed-Build-Depends:> (required)"
441 msgid "S< >I<package-list>"
447 "The list of installed and configured packages that might affect the package "
454 "The list consists of each package name, optionally arch-qualified for "
455 "foreign architectures, with an exact version restriction, separated by "
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>."
472 "For dependencies coming from the source control fields, all dependency "
473 "alternatives and all providers of virtual packages depended on will be "
479 msgid "B<Environment:>"
484 msgid "S< >I<variable-list>"
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 "
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
517 msgid "L<deb822(5)>, B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1)."
522 msgid "deb-changelog - dpkg source packages' changelog file format"
526 #: deb-changelog.pod dpkg-parsechangelog.pod
527 msgid "B<debian/changelog>"
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 "
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."
549 msgid "That format is a series of entries like this:"
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"
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<)>’."
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<;>’)."
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 "
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."
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:"
618 msgid "B<Closes: #>I<nnnnn>"
624 "in the change details, where B<#>I<nnnnn> is the bug number. The exact Perl "
625 "regular expression is:"
630 msgid "B</closes:\\s*(?:bug)?\\#?\\s?\\d+(?:,\\s*(?:bug)?\\#?\\s?\\d+)*/i>"
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."
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."
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."
665 "The I<date> has the following format (compatible and with the same semantics "
666 "of RFC2822 and RFC5322, or what «date -R» generates):"
672 "I<day-of-week>B<,> I<dd> I<month> I<yyyy> I<hh>B<:>I<mm>B<:>I<ss> "
683 msgid "I<day-of-week>"
688 msgid "Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>."
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."
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>."
722 msgid "Is the four-digit year (e.g. 2010)."
732 msgid "Is the two-digit hour (B<00>-B<23>)."
742 msgid "Is the two-digit minutes (B<00>-B<59>)."
752 msgid "Is the two-digit seconds (B<00>-B<60>)."
757 msgid "[B<+->]I<zzzz>"
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 "
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>)."
786 "Any line that consists entirely (i.e., no leading whitespace) of B<#> or "
787 "B</* */> style comments or RCS keywords."
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 "
801 msgid "The entire changelog must be encoded in UTF-8."
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
816 msgid "I<debian/changelog>"
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
830 " dpkg (1.17.18) unstable; urgency=low\n"
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: "
850 " [ Updated programs translations ]\n"
851 " * Catalan (Guillem Jover).\n"
859 " [ Updated dselect translations ]\n"
860 " * Catalan (Guillem Jover).\n"
861 " * German (Sven Joachim).\n"
869 " -- Guillem Jover <guillem@debian.org> Sun, 12 Oct 2014 15:47:44 +0200\n"
876 "B<deb822>(5), B<deb-version>(7), B<deb-changes>(5), "
877 "B<dpkg-parsechangelog>(1)."
882 msgid "deb-changes - Debian changes file format"
887 msgid "I<filename>B<.changes>"
893 "Each Debian upload is composed of a .changes control file, which contains a "
894 "number of fields in L<deb822(5)> format."
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)."
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>."
921 msgid "B<Date:> I<release-date> (required)"
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."
934 "The value of this field is usually extracted from the I<debian/changelog> "
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."
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)."
956 msgid "B<Architecture:> I<arch-list>"
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."
971 msgid "B<Distribution:> I<distribution>s (required)"
977 "Lists one or more space-separated distributions where this version should be "
978 "installed when it is uploaded to the archive."
983 msgid "B<Urgency:> I<urgency> (recommended)"
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>."
995 msgid "B<Maintainer:> I<fullname-email> (required)"
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."
1008 msgid "B<Changed-By:> I<fullname-email>"
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."
1020 msgid "B<Description:> (recommended)"
1025 msgid "S< >I<binary-package-name> B<-> I<binary-package-summary>"
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)."
1038 msgid "B<Closes:> I<bug-number-list>"
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."
1052 msgid "B<Binary-Only: yes>"
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 "
1065 msgid "B<Built-For-Profiles:> I<profile-list>"
1071 "This field specifies a whitespace separated list of build profiles that this "
1072 "upload was built with."
1077 msgid "B<Changes:> (required)"
1082 msgid "S< >I<changelog-entries>"
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."
1095 #: deb-changes.pod dsc.pod
1096 msgid "B<Files:> (required)"
1101 msgid "S< >I<md5sum> I<size> I<section> I<priority> I<filename>"
1107 "This multiline field contains a list of files with an md5sum, size, section "
1108 "and priority for each one."
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."
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> "
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>."
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."
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
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 "
1163 msgid "L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7)."
1167 #: deb-conffiles.pod
1168 msgid "deb-conffiles - package conffiles"
1172 #: deb-conffiles.pod
1173 msgid "B<DEBIAN/conffiles>"
1177 #: deb-conffiles.pod
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)."
1184 #: deb-conffiles.pod
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."
1193 #: deb-conffiles.pod
1195 "Files without a flag should exist in the binary package, otherwise "
1196 "L<dpkg(1)> will ignore them."
1200 #: deb-conffiles.pod
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 "
1210 #: deb-conffiles.pod deb-control.pod deb-md5sums.pod deb-origin.pod
1211 #: deb-src-control.pod start-stop-daemon.pod
1216 #: deb-conffiles.pod
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"
1228 #: deb-conffiles.pod
1229 msgid "B<dpkg-deb>(1), B<dpkg>(1)."
1234 msgid "deb-control - Debian binary packages' master control file format"
1239 msgid "B<DEBIAN/control>"
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)."
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)."
1264 msgid "B<Package:> I<package-name> (required)"
1268 #: deb-control.pod dsc.pod
1270 "The value of this field determines the package name, and is used to generate "
1271 "file names by most installation tools."
1275 #: deb-control.pod deb-src-control.pod
1276 msgid "B<Package-Type:> B<deb>|B<udeb>|I<type>"
1280 #: deb-control.pod deb-src-control.pod
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."
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)."
1297 #: deb-control.pod deb-src-control.pod dsc.pod
1298 msgid "B<Maintainer:> I<fullname-email> (recommended)"
1302 #: deb-control.pod dsc.pod
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."
1310 #: deb-control.pod deb-src-control.pod
1311 msgid "B<Description:> I<short-description> (recommended)"
1315 #: deb-control.pod deb-src-control.pod dsc.pod
1316 msgid "S< >I<long-description>"
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."
1330 #: deb-control.pod deb-src-control.pod
1331 msgid "B<Section:> I<section>"
1335 #: deb-control.pod deb-src-control.pod
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."
1343 #: deb-control.pod deb-src-control.pod
1344 msgid "B<Priority:> I<priority>"
1348 #: deb-control.pod deb-src-control.pod
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."
1355 #: deb-control.pod deb-src-control.pod
1357 "The B<Section> and B<Priority> fields usually have a defined set of accepted "
1358 "values based on the specific distribution policy."
1363 msgid "B<Installed-Size:> I<size>"
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)>."
1374 #: deb-control.pod deb-src-control.pod
1375 msgid "B<Protected:> B<yes>|B<no>"
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)."
1389 #: deb-control.pod dsc.pod
1390 msgid "Supported since dpkg 1.20.1."
1394 #: deb-control.pod deb-src-control.pod
1395 msgid "B<Essential:> B<yes>|B<no>"
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)."
1410 #: deb-control.pod deb-src-control.pod
1411 msgid "B<Build-Essential:> B<yes>|B<no>"
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."
1424 msgid "B<Architecture:> I<arch>|B<all> (required)"
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 "
1438 #: deb-control.pod deb-src-control.pod dsc.pod
1439 msgid "B<Origin:> I<name>"
1443 #: deb-control.pod deb-src-control.pod
1444 msgid "B<Bugs:> I<url>"
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>."
1456 #: deb-control.pod deb-src-control.pod dsc.pod
1457 msgid "B<Homepage:> I<url>"
1461 #: deb-control.pod dsc.pod
1462 msgid "The upstream project home page I<url>."
1466 #: deb-control.pod deb-src-control.pod
1467 msgid "B<Tag:> I<tag-list>"
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."
1479 msgid "B<Multi-Arch:> B<no>|B<same>|B<foreign>|B<allowed>"
1485 "This field is used to indicate how this package should behave on a "
1486 "multi-arch installations."
1490 #: deb-control.pod deb-src-control.pod
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."
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 "
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)."
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."
1543 msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>]"
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>»."
1558 #: deb-control.pod deb-src-control.pod
1559 msgid "B<Subarchitecture:> I<value>"
1563 #: deb-control.pod deb-src-control.pod
1564 msgid "B<Kernel-Version:> I<value>"
1568 #: deb-control.pod deb-src-control.pod
1569 msgid "B<Installer-Menu-Item:> I<value>"
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>."
1581 #: deb-control.pod deb-src-control.pod
1582 msgid "B<Depends:> I<package-list>"
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."
1599 #: deb-control.pod deb-src-control.pod
1600 msgid "B<Pre-Depends:> I<package-list>"
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."
1612 #: deb-control.pod deb-src-control.pod
1613 msgid "B<Recommends:> I<package-list>"
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."
1625 #: deb-control.pod deb-src-control.pod
1626 msgid "B<Suggests:> I<package-list>"
1632 "Lists packages that are related to this one and can perhaps enhance its "
1633 "usefulness, but without which installing this package is perfectly "
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."
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>."
1661 #: deb-control.pod deb-src-control.pod
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 "
1672 #: deb-control.pod deb-src-control.pod
1673 msgid "B<Breaks:> I<package-list>"
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."
1686 #: deb-control.pod deb-src-control.pod
1687 msgid "B<Conflicts:> I<package-list>"
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."
1700 #: deb-control.pod deb-src-control.pod
1701 msgid "B<Replaces:> I<package-list>"
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."
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."
1726 #: deb-control.pod deb-src-control.pod
1727 msgid "B<Enhances:> I<package-list>"
1733 "This is a list of packages that this one enhances. It is similar to "
1734 "B<Suggests> but in the opposite direction."
1738 #: deb-control.pod deb-src-control.pod
1739 msgid "B<Provides:> I<package-list>"
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."
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)."
1767 #: deb-control.pod deb-src-control.pod
1768 msgid "B<Built-Using:> I<package-list>"
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."
1785 #: deb-control.pod deb-src-control.pod
1786 msgid "B<Static-Built-Using:> I<package-list>"
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."
1805 msgid "Supported since dpkg 1.21.3."
1810 msgid "B<Built-For-Profiles:> I<profile-list> (obsolete)"
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."
1824 msgid "B<Auto-Built-Package:> I<reason-list>"
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>."
1838 msgid "B<Build-Ids:> I<elf-build-id-list>"
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."
1851 msgid "The format or the way to compute each build-id is not defined by design."
1860 " Priority: required\n"
1862 " Maintainer: Wichert Akkerman <wakkerma@debian.org>\n"
1863 " Architecture: sparc\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 "
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"
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."
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)."
1897 #: deb-extra-override.pod
1898 msgid "deb-extra-override - Debian archive extra override file"
1902 #: deb-extra-override.pod deb-override.pod
1907 #: deb-extra-override.pod
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."
1915 #: deb-extra-override.pod
1917 "The extra override file has a simple whitespace-delimited format. Comments "
1918 "are allowed (denoted with a B<#>)."
1922 #: deb-extra-override.pod
1923 msgid "I<package> I<field-name> I<value>"
1927 #: deb-extra-override.pod
1928 msgid "I<package> is the name of the binary/source package."
1932 #: deb-extra-override.pod
1933 msgid "I<field-name> is the name of the field that is overridden."
1937 #: deb-extra-override.pod
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."
1944 #: deb-extra-override.pod
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."
1951 #: deb-extra-override.pod deb-override.pod
1952 msgid "B<dpkg-scanpackages>(1), B<dpkg-scansources>(1), B<apt-ftparchive>(1)."
1957 msgid "deb-md5sums - package MD5 file digests"
1962 msgid "B<DEBIAN/md5sums>"
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."
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."
1985 "Trailing slashes (U+002F B</>) in the pathname will be trimmed. Neither "
1986 "trailing whitespace nor empty or whitespace-only lines are accepted."
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)."
2000 " 53c0d4afe4bc4eccb5cb234d2e06ef4d usr/bin/dpkg\n"
2001 " f8da2bc74cdcad8b81c48a4f0d7bb0a8 usr/bin/dpkg-deb\n"
2002 " 70b913132de56e95e75de504979309b4 usr/bin/dpkg-divert\n"
2009 msgid "B<md5sum>(1), B<dpkg-deb>(1), B<dpkg>(1)."
2014 msgid "deb-old - old style Debian binary package format"
2018 #: deb-old.pod deb-split.pod deb.pod
2019 msgid "I<filename>B<.deb>"
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."
2031 #: deb-old.pod deb-split.pod deb.pod
2038 "The file is two lines of format information as ASCII text, followed by two "
2039 "concatenated gzipped ustar files."
2045 "The first line is the format version number padded to 8 digits, and is "
2046 "B<0.939000> for all old-format archives."
2052 "The second line is a decimal string (without leading zeroes) giving the "
2053 "length of the first gzipped tarfile."
2058 msgid "Each of these lines is terminated with a single newline character."
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 "
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."
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."
2089 msgid "B<deb>(5), B<dpkg-deb>(1), B<deb-control>(5)."
2094 msgid "deb-origin - Vendor-specific information files"
2099 msgid "B<%PKGCONFDIR%/origins/>I<filename>"
2105 "The files in B<%PKGCONFDIR%/origins> can provide information about various "
2106 "vendors who are providing Debian packages."
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."
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."
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 "
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."
2152 "But these backwards compatible module lookups will be removed during the "
2153 "dpkg 1.22.x release cycle."
2158 msgid "B<Vendor:> I<vendor-name> (required)"
2163 msgid "The value of this field determines the vendor name."
2168 msgid "B<Vendor-URL:> I<vendor-url>"
2173 msgid "The value of this field determines the vendor URL."
2178 msgid "B<Bugs:> I<bug-url>"
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/)."
2191 msgid "B<Parent:> I<vendor-name>"
2197 "The value of this field determines the vendor name of the vendor that this "
2198 "vendor derives from."
2206 " Vendor-URL: https://www.debian.org/\n"
2207 " Bugs: debbugs://bugs.debian.org\n"
2213 msgid "B<dpkg-vendor>(1)"
2218 msgid "deb-override - Debian archive override file"
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."
2233 "The override file has a simple whitespace-delimited format. Comments are "
2234 "allowed (denoted with a B<#>)."
2239 msgid "I<package> I<priority> I<section> [I<maintainer-info>]"
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."
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 "
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."
2268 "The override files used to make the official Packages lists may be found in "
2269 "the I<indices> directory on any Debian mirror."
2274 msgid "deb-postinst - package post-installation maintainer script"
2279 msgid "B<DEBIAN/postinst>"
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)."
2291 #: deb-postinst.pod deb-postrm.pod deb-preinst.pod deb-prerm.pod
2292 msgid "The script can be called in the following ways:"
2297 msgid "I<postinst> B<configure> I<old-version>"
2302 msgid "After the package was installed."
2307 msgid "I<postinst> B<triggered> \"I<trigger-name...>\""
2313 "After the package was triggered. The list of space-separated "
2314 "I<trigger-name>s is passed as the second argument."
2319 msgid "I<old-postinst> B<abort-upgrade> I<new-version>"
2324 msgid "If I<prerm> fails during B<upgrade> or fails on B<failed-upgrade>."
2329 msgid "I<old-postinst> B<abort-remove>"
2334 msgid "If I<prerm> fails during B<remove>."
2339 msgid "I<postinst> B<abort-deconfigure> B<in-favour> I<new-package> I<new-version>"
2343 #: deb-postinst.pod deb-prerm.pod
2344 msgid "S< >[ B<removing> I<old-package> I<old-version> ]"
2349 msgid "If I<prerm> fails during B<deconfigure in-favour> of a package."
2354 msgid "I<postinst> B<abort-remove> B<in-favour> I<new-package> I<new-version>"
2360 "If I<prerm> fails during B<remove in-favour> for replacement due to "
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
2372 msgid "deb-postrm - package post-removal maintainer script"
2377 msgid "B<DEBIAN/postrm>"
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)."
2390 msgid "I<postrm> B<remove>"
2395 msgid "After the package was removed."
2400 msgid "I<postrm> B<purge>"
2405 msgid "After the package was purged."
2410 msgid "I<old-postrm> B<upgrade> I<new-version>"
2415 msgid "After the package was upgraded."
2420 msgid "I<new-postrm> B<failed-upgrade> I<old-version> I<new-version>"
2425 msgid "If the above B<upgrade> call fails."
2429 #: deb-postrm.pod deb-preinst.pod deb-prerm.pod
2430 msgid "The I<new-version> is passed only since dpkg 1.18.5."
2435 msgid "I<postrm> B<disappear> I<overwriter-package> I<overwriter-version>"
2440 msgid "After all of the packages files have been replaced."
2445 msgid "I<new-postrm> B<abort-install>"
2450 msgid "If I<preinst> fails during B<install>."
2455 msgid "I<new-postrm> B<abort-install> I<old-version> I<new-version>"
2460 msgid "If I<preinst> fails during B<install> for an upgrade of a removed package."
2465 msgid "I<new-postrm> B<abort-upgrade> I<old-version> I<new-version>"
2470 msgid "If I<preinst> fails during B<upgrade>."
2475 msgid "deb-preinst - package pre-installation maintainer script"
2480 msgid "B<DEBIAN/preinst>"
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)."
2493 msgid "I<new-preinst> B<install>"
2498 msgid "Before the package is installed."
2503 msgid "I<new-preinst> B<install> I<old-version> I<new-version>"
2508 msgid "Before a removed package is upgraded."
2513 msgid "I<new-preinst> B<upgrade> I<old-version> I<new-version>"
2518 msgid "Before the package is upgraded."
2523 msgid "I<old-preinst> B<abort-upgrade> I<new-version>"
2528 msgid "If I<postrm> fails during upgrade or fails on failed upgrade."
2533 msgid "deb-prerm - package pre-removal maintainer script"
2538 msgid "B<DEBIAN/prerm>"
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)."
2551 msgid "I<prerm> B<remove>"
2556 msgid "Before the package is removed."
2561 msgid "I<old-prerm> B<upgrade> I<new-version>"
2566 msgid "Before an upgrade."
2571 msgid "I<new-prerm> B<failed-upgrade> I<old-version> I<new-version>"
2576 msgid "If the above B<upgrade> fails."
2581 msgid "I<prerm> B<deconfigure> B<in-favour> I<new-package> I<new-version>"
2586 msgid "Before package is deconfigured while dependency is replaced due to conflict."
2591 msgid "I<prerm> B<remove> B<in-favour> I<new-package> I<new-version>"
2596 msgid "Before the package is replaced due to conflict."
2601 msgid "deb-shlibs - Debian shared library information file"
2606 msgid "B<debian/shlibs>, B<debian/>I<binary-name>B<.shlibs>, B<DEBIAN/shlibs>"
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 "
2621 msgid "[I<type>B<:>] I<library> I<version> I<dependencies>"
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."
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)."
2641 msgid "SONAME FORMATS"
2646 msgid "The SONAME formats supported are:"
2651 msgid "I<name>.so.I<version>"
2661 msgid "I<name>-I<version>.so"
2666 msgid "where I<name> is usually prefixed by B<lib>."
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"
2680 " libcrunch 1 libcrunch1 (>= 1.2-1)\n"
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."
2695 msgid "B<deb-control>(5), B<dpkg-shlibdeps>(1), B<deb-symbols>(5)."
2700 msgid "deb-split - Debian multi-part binary package format"
2706 "The multi-part B<.deb> format is used to split big packages into smaller "
2707 "pieces to ease transport in small media."
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)."
2720 "The first member is named B<debian-split> and contains a series of lines, "
2721 "separated by newlines. Currently eight lines are present:"
2725 #: deb-split.pod deb-src-symbols.pod dpkg-fsys-usrunmess.pod
2726 #: dpkg-gensymbols.pod dselect.pod
2732 msgid "The format version number, B<2.1> at the time this manual page was written."
2737 msgid "The package name."
2742 msgid "The package version."
2747 msgid "The md5sum of the package."
2752 msgid "The total size of the package."
2757 msgid "The maximum part size."
2763 "The current part number, followed by a slash and the total amount of parts "
2769 msgid "The package architecture (since dpkg 1.16.1)."
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."
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."
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."
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."
2806 msgid "B<deb>(5), B<dpkg-split>(1)."
2810 #: deb-src-control.pod
2811 msgid "deb-src-control - Debian source packages' master control file format"
2815 #: deb-src-control.pod dpkg-gencontrol.pod
2816 msgid "B<debian/control>"
2820 #: deb-src-control.pod
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)."
2828 #: deb-src-control.pod
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."
2845 #: deb-src-control.pod
2846 msgid "SOURCE FIELDS"
2850 #: deb-src-control.pod
2851 msgid "B<Source:> I<source-package-name> (required)"
2855 #: deb-src-control.pod
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 "
2866 #: deb-src-control.pod
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."
2874 #: deb-src-control.pod
2875 msgid "B<Uploaders:> I<fullname-email>"
2879 #: deb-src-control.pod dsc.pod
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."
2887 #: deb-src-control.pod
2888 msgid "B<Standards-Version:> I<version-string>"
2892 #: deb-src-control.pod dsc.pod
2894 "This documents the most recent version of the distribution policy standards "
2895 "this package complies with."
2899 #: deb-src-control.pod dsc.pod
2900 msgid "B<Description> I<short-description>"
2904 #: deb-src-control.pod dsc.pod
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."
2914 #: deb-src-control.pod
2915 msgid "The upstream project home page URL."
2919 #: deb-src-control.pod
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."
2927 #: deb-src-control.pod
2928 msgid "B<Rules-Requires-Root:> B<no>|B<binary-targets>|I<impl-keywords>"
2932 #: deb-src-control.pod
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."
2939 #: deb-src-control.pod
2940 msgid "The binary targets will not require (fake)root at all."
2944 #: deb-src-control.pod
2945 msgid "B<binary-targets>"
2949 #: deb-src-control.pod
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."
2958 #: deb-src-control.pod
2959 msgid "I<impl-keywords>"
2963 #: deb-src-control.pod
2965 "This is a space-separated list of keywords which define when (fake)root is "
2970 #: deb-src-control.pod
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."
2978 #: deb-src-control.pod
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>)."
2986 #: deb-src-control.pod
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>.)"
2994 #: deb-src-control.pod dsc.pod
2995 msgid "B<Testsuite:> I<name-list>"
2999 #: deb-src-control.pod dsc.pod
3000 msgid "B<Testsuite-Triggers:> I<package-list>"
3004 #: deb-src-control.pod
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."
3012 #: deb-src-control.pod dsc.pod
3013 msgid "B<Vcs-Arch:> I<url>"
3017 #: deb-src-control.pod dsc.pod
3018 msgid "B<Vcs-Bzr:> I<url>"
3022 #: deb-src-control.pod dsc.pod
3023 msgid "B<Vcs-Cvs:> I<url>"
3027 #: deb-src-control.pod dsc.pod
3028 msgid "B<Vcs-Darcs:> I<url>"
3032 #: deb-src-control.pod dsc.pod
3033 msgid "B<Vcs-Git:> I<url>"
3037 #: deb-src-control.pod dsc.pod
3038 msgid "B<Vcs-Hg:> I<url>"
3042 #: deb-src-control.pod dsc.pod
3043 msgid "B<Vcs-Mtn:> I<url>"
3047 #: deb-src-control.pod dsc.pod
3048 msgid "B<Vcs-Svn:> I<url>"
3052 #: deb-src-control.pod
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."
3062 #: deb-src-control.pod dsc.pod
3063 msgid "B<Vcs-Browser:> I<url>"
3067 #: deb-src-control.pod
3069 "The I<url> of a webinterface to browse the Version Control System "
3074 #: deb-src-control.pod
3076 "The name of the distribution this package is originating from. This field is "
3077 "usually not needed."
3081 #: deb-src-control.pod dsc.pod
3082 msgid "B<Build-Depends:> I<package-list>"
3086 #: deb-src-control.pod
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."
3098 #: deb-src-control.pod dsc.pod
3099 msgid "B<Build-Depends-Arch:> I<package-list>"
3103 #: deb-src-control.pod
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."
3112 #: deb-src-control.pod dsc.pod
3113 msgid "B<Build-Depends-Indep:> I<package-list>"
3117 #: deb-src-control.pod
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 "
3125 #: deb-src-control.pod dsc.pod
3126 msgid "B<Build-Conflicts:> I<package-list>"
3130 #: deb-src-control.pod
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."
3140 #: deb-src-control.pod dsc.pod
3141 msgid "B<Build-Conflicts-Arch:> I<package-list>"
3145 #: deb-src-control.pod
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."
3153 #: deb-src-control.pod dsc.pod
3154 msgid "B<Build-Conflicts-Indep:> I<package-list>"
3158 #: deb-src-control.pod
3160 "Same as B<Build-Conflicts>, but only when building the architecture "
3161 "independent packages."
3165 #: deb-src-control.pod
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>>’."
3182 #: deb-src-control.pod
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."
3196 #: deb-src-control.pod
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>."
3210 #: deb-src-control.pod
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”."
3218 #: deb-src-control.pod
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."
3228 #: deb-src-control.pod
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."
3236 #: deb-src-control.pod
3237 msgid "BINARY FIELDS"
3241 #: deb-src-control.pod
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."
3248 #: deb-src-control.pod
3249 msgid "B<Package:> I<binary-package-name> (required)"
3253 #: deb-src-control.pod
3255 "This field is used to name the binary package name. The same restrictions as "
3256 "to a source package name apply."
3260 #: deb-src-control.pod
3261 msgid "B<Architecture:> I<arch>|B<all>|B<any> (required)"
3265 #: deb-src-control.pod
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)."
3277 #: deb-src-control.pod
3278 msgid "B<Build-Profiles:> I<restriction-formula>"
3282 #: deb-src-control.pod
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 "
3291 #: deb-src-control.pod
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)."
3298 #: deb-src-control.pod
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."
3307 #: deb-src-control.pod
3308 msgid "B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>"
3312 #: deb-src-control.pod
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."
3319 #: deb-src-control.pod
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)."
3329 #: deb-src-control.pod
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>."
3337 #: deb-src-control.pod
3338 msgid "USER-DEFINED FIELDS"
3342 #: deb-src-control.pod
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."
3352 #: deb-src-control.pod
3357 #: deb-src-control.pod
3358 msgid "The field will appear in the source package control file, see B<dsc>(5)."
3362 #: deb-src-control.pod
3367 #: deb-src-control.pod
3369 "The field will appear in the control file in the binary package, see "
3370 "B<deb-control>(5)."
3374 #: deb-src-control.pod
3379 #: deb-src-control.pod
3381 "The field will appear in the upload control (.changes) file, see "
3382 "B<deb-changes>(5)."
3386 #: deb-src-control.pod
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."
3395 #: deb-src-control.pod
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>."
3404 #: deb-src-control.pod
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"
3424 #: deb-src-control.pod
3427 " Package: dpkg-dev\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"
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"
3449 #: deb-src-control.pod
3451 "I<%PKGDOCDIR%/spec/rootless-builds.txt>, L<deb822(5)>, B<deb-control>(5), "
3452 "B<deb-version>(7), B<dpkg-source>(1)"
3456 #: deb-src-files.pod
3457 msgid "deb-src-files - Debian distribute files format"
3461 #: deb-src-files.pod dpkg-distaddfile.pod dpkg-genbuildinfo.pod
3462 #: dpkg-genchanges.pod dpkg-gencontrol.pod
3463 msgid "B<debian/files>"
3467 #: deb-src-files.pod
3469 "This file contains the list of artifacts that are to be distributed via the "
3470 "B<.changes> control file."
3474 #: deb-src-files.pod
3475 msgid "The I<debian/files> file has a simple whitespace-delimited format."
3479 #: deb-src-files.pod
3480 msgid "I<filename> I<section> I<priority> [ I<keyword=value...> ]"
3484 #: deb-src-files.pod
3485 msgid "I<filename> is the name of the artifact to distribute."
3489 #: deb-src-files.pod
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 "
3497 #: deb-src-files.pod
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."
3505 #: deb-src-files.pod deb-version.pod dpkg-architecture.pod
3506 #: dpkg-buildpackage.pod dpkg-deb.pod dpkg-divert.pod dpkg-parsechangelog.pod
3511 #: deb-src-files.pod
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."
3518 #: deb-src-files.pod
3519 msgid "B<dpkg-genchanges>(1), B<dpkg-distaddfile>(1)."
3523 #: deb-src-rules.pod
3524 msgid "deb-src-rules - Debian source package rules file"
3528 #: deb-src-rules.pod
3529 msgid "B<debian/rules>"
3533 #: deb-src-rules.pod
3535 "This file contains the instructions necessary to build the binary packages "
3536 "from the source package."
3540 #: deb-src-rules.pod
3542 "The I<debian/rules> file is an executable Makefile, with a shebang that is "
3543 "usually set to \"#!/usr/bin/make -f\"."
3547 #: deb-src-rules.pod
3548 msgid "It must support the following make targets:"
3552 #: deb-src-rules.pod
3557 #: deb-src-rules.pod
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."
3564 #: deb-src-rules.pod
3565 msgid "B<build-indep>"
3569 #: deb-src-rules.pod
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."
3578 #: deb-src-rules.pod
3579 msgid "B<build-arch>"
3583 #: deb-src-rules.pod
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."
3592 #: deb-src-rules.pod
3597 #: deb-src-rules.pod
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."
3605 #: deb-src-rules.pod
3606 msgid "B<binary-indep>"
3610 #: deb-src-rules.pod
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."
3618 #: deb-src-rules.pod
3619 msgid "B<binary-arch>"
3623 #: deb-src-rules.pod
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."
3631 #: deb-src-rules.pod dpkg-buildpackage.pod dpkg-genbuildinfo.pod
3632 #: dpkg-genchanges.pod
3637 #: deb-src-rules.pod
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 "
3646 #: deb-src-rules.pod
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)."
3654 #: deb-src-symbols.pod
3655 msgid "deb-src-symbols - Debian's extended shared library template file"
3659 #: deb-src-symbols.pod
3661 "B<debian/>I<package>B<.symbols.>I<arch>, B<debian/symbols.>I<arch>, "
3662 "B<debian/>I<package>B<.symbols>, B<debian/symbols>"
3666 #: deb-src-symbols.pod
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)>."
3674 #: deb-src-symbols.pod
3679 #: deb-src-symbols.pod
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."
3688 #: deb-src-symbols.pod
3689 msgid "Using #PACKAGE# substitution"
3693 #: deb-src-symbols.pod
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."
3703 #: deb-src-symbols.pod
3704 msgid "Using symbol tags"
3708 #: deb-src-symbols.pod
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."
3718 #: deb-src-symbols.pod
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."
3734 #: deb-src-symbols.pod
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"
3744 #: deb-src-symbols.pod
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 "
3754 #: deb-src-symbols.pod
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."
3769 #: deb-src-symbols.pod
3770 msgid "Standard symbol tags"
3774 #: deb-src-symbols.pod
3779 #: deb-src-symbols.pod
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."
3792 #: deb-src-symbols.pod
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 "
3802 #: deb-src-symbols.pod
3803 msgid "B<arch=>I<architecture-list>"
3807 #: deb-src-symbols.pod
3808 msgid "B<arch-bits=>I<architecture-bits>"
3812 #: deb-src-symbols.pod
3813 msgid "B<arch-endian=>I<architecture-endianness>"
3817 #: deb-src-symbols.pod
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."
3835 #: deb-src-symbols.pod
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 "
3845 #: deb-src-symbols.pod
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."
3855 #: deb-src-symbols.pod
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"
3865 #: deb-src-symbols.pod
3866 msgid "The I<architecture-bits> is either B<32> or B<64>."
3870 #: deb-src-symbols.pod
3873 " (arch-bits=32)32bit_specific_symbol@Base 1.0\n"
3874 " (arch-bits=64)64bit_specific_symbol@Base 1.0\n"
3879 #: deb-src-symbols.pod
3880 msgid "The I<architecture-endianness> is either B<little> or B<big>."
3884 #: deb-src-symbols.pod
3887 " (arch-endian=little)little_endian_specific_symbol@Base 1.0\n"
3888 " (arch-endian=big)big_endian_specific_symbol@Base 1.0\n"
3893 #: deb-src-symbols.pod
3894 msgid "Multiple restrictions can be chained."
3898 #: deb-src-symbols.pod
3901 " (arch-bits=32|arch-endian=little)32bit_le_symbol@Base 1.0\n"
3906 #: deb-src-symbols.pod
3907 msgid "B<allow-internal>"
3911 #: deb-src-symbols.pod
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”."
3922 #: deb-src-symbols.pod
3923 msgid "B<ignore-blacklist>"
3927 #: deb-src-symbols.pod
3929 "A deprecated alias for B<allow-internal> (since dpkg 1.20.1, supported since "
3934 #: deb-src-symbols.pod
3939 #: deb-src-symbols.pod
3941 "Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection "
3946 #: deb-src-symbols.pod
3951 #: deb-src-symbols.pod
3953 "Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol "
3954 "patterns> subsection below."
3958 #: deb-src-symbols.pod
3963 #: deb-src-symbols.pod
3965 "Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection "
3970 #: deb-src-symbols.pod
3971 msgid "Using symbol patterns"
3975 #: deb-src-symbols.pod
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."
3987 #: deb-src-symbols.pod
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 "
4000 #: deb-src-symbols.pod
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."
4011 #: deb-src-symbols.pod
4012 msgid "At the moment, B<dpkg-gensymbols> supports three basic pattern types:"
4016 #: deb-src-symbols.pod
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 "
4032 #: deb-src-symbols.pod
4035 " libdummy.so.1 libdummy1 #MINVER#\n"
4037 " (c++)\"non-virtual thunk to NSB::ClassD::~ClassD()@Base\" 1.0\n"
4043 #: deb-src-symbols.pod
4044 msgid "The demangled name above can be obtained by executing the following command:"
4048 #: deb-src-symbols.pod
4051 " $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt\n"
4056 #: deb-src-symbols.pod
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."
4068 #: deb-src-symbols.pod
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:"
4077 #: deb-src-symbols.pod
4080 " libc.so.6 libc6 #MINVER#\n"
4081 " (symver)GLIBC_2.0 2.0\n"
4083 " (symver)GLIBC_2.7 2.7\n"
4084 " access@GLIBC_2.0 2.2\n"
4089 #: deb-src-symbols.pod
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."
4099 #: deb-src-symbols.pod
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."
4109 #: deb-src-symbols.pod
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:"
4119 #: deb-src-symbols.pod
4122 " libdummy.so.1 libdummy1 #MINVER#\n"
4123 " (regex)\"^mystack_.*@Base$\" 1.0\n"
4124 " (regex|optional)\"private\" 1.0\n"
4129 #: deb-src-symbols.pod
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."
4139 #: deb-src-symbols.pod
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 "
4147 #: deb-src-symbols.pod
4150 " (c++|regex)\"^NSA::ClassA::Private::privmethod\\d\\(int\\)@Base\" 1.0\n"
4151 " (regex|c++)N3NSA6ClassA7Private11privmethod\\dEi@Base 1.0\n"
4156 #: deb-src-symbols.pod
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."
4171 #: deb-src-symbols.pod
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."
4181 #: deb-src-symbols.pod
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."
4192 #: deb-src-symbols.pod
4193 msgid "Using includes"
4197 #: deb-src-symbols.pod
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:"
4205 #: deb-src-symbols.pod
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 "
4213 #: deb-src-symbols.pod
4216 " #include \"I<packages>.symbols.common\"\n"
4221 #: deb-src-symbols.pod
4222 msgid "The include directive may also be tagged like any symbol:"
4226 #: deb-src-symbols.pod
4229 " (tag|...|tagN)#include \"file-to-include\"\n"
4234 #: deb-src-symbols.pod
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 "
4243 #: deb-src-symbols.pod
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"
4254 #: deb-src-symbols.pod
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."
4267 #: deb-src-symbols.pod
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:"
4276 #: deb-src-symbols.pod
4279 " #include \"libsomething1.symbols.common\"\n"
4280 " arch_specific_symbol@Base 1.0\n"
4285 #: deb-src-symbols.pod
4286 msgid "B<deb-symbols>(5), B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
4290 #: deb-substvars.pod
4291 msgid "deb-substvars - Debian source substitution variables"
4295 #: deb-substvars.pod
4296 msgid "B<debian/substvars>, B<debian/>I<binary-package>B<.substvars>, variables"
4300 #: deb-substvars.pod
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."
4309 #: deb-substvars.pod
4310 msgid "Variable Syntax"
4314 #: deb-substvars.pod
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."
4325 #: deb-substvars.pod
4330 #: deb-substvars.pod
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."
4341 #: deb-substvars.pod
4342 msgid "Substitution"
4346 #: deb-substvars.pod
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)."
4354 #: deb-substvars.pod
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 "
4364 #: deb-substvars.pod
4366 "If a variable is referred to but not defined it generates a warning and an "
4367 "empty value is assumed."
4371 #: deb-substvars.pod
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."
4380 #: deb-substvars.pod
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 "
4391 #: deb-substvars.pod
4394 " Description: foo application\n"
4402 #: deb-substvars.pod
4403 msgid "It will result in:"
4407 #: deb-substvars.pod
4410 " Description: foo application\n"
4419 #: deb-substvars.pod
4420 msgid "Built-in Variable"
4424 #: deb-substvars.pod
4425 msgid "Additionally, the following standard variables are always available:"
4429 #: deb-substvars.pod
4434 #: deb-substvars.pod
4436 "The current host architecture (i.e. the architecture the package is being "
4437 "built for, the equivalent of B<DEB_HOST_ARCH>)."
4441 #: deb-substvars.pod
4442 msgid "B<vendor:Name>"
4446 #: deb-substvars.pod
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."
4454 #: deb-substvars.pod
4455 msgid "B<vendor:Id>"
4459 #: deb-substvars.pod
4461 "The current vendor ID (since dpkg 1.20.0). This is just the lowercase "
4462 "variant of B<vendor:Name>."
4466 #: deb-substvars.pod dpkg-query.pod
4467 msgid "B<source:Version>"
4471 #: deb-substvars.pod
4472 msgid "The source package version (since dpkg 1.13.19)."
4476 #: deb-substvars.pod dpkg-query.pod
4477 msgid "B<source:Upstream-Version>"
4481 #: deb-substvars.pod
4483 "The upstream source package version, including the Debian version epoch if "
4484 "any (since dpkg 1.13.19)."
4488 #: deb-substvars.pod
4489 msgid "B<binary:Version>"
4493 #: deb-substvars.pod
4495 "The binary package version (which may differ from B<source:Version> in a "
4496 "binNMU for example; since dpkg 1.13.19)."
4500 #: deb-substvars.pod
4501 msgid "B<Source-Version>"
4505 #: deb-substvars.pod
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 "
4514 #: deb-substvars.pod
4515 msgid "B<source:Synopsis>"
4519 #: deb-substvars.pod
4521 "The source package synopsis, extracted from the source stanza B<Description> "
4522 "field, if it exists (since dpkg 1.19.0)."
4526 #: deb-substvars.pod
4527 msgid "B<source:Extended-Description>"
4531 #: deb-substvars.pod
4533 "The source package extended description, extracted from the source stanza "
4534 "B<Description> field, if it exists (since dpkg 1.19.0)."
4538 #: deb-substvars.pod dpkg-query.pod
4539 msgid "B<Installed-Size>"
4543 #: deb-substvars.pod
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 "
4555 #: deb-substvars.pod
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."
4564 #: deb-substvars.pod
4565 msgid "B<Extra-Size>"
4569 #: deb-substvars.pod
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."
4578 #: deb-substvars.pod
4579 msgid "B<S:>I<fieldname>"
4583 #: deb-substvars.pod
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."
4592 #: deb-substvars.pod
4593 msgid "B<F:>I<fieldname>"
4597 #: deb-substvars.pod
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."
4605 #: deb-substvars.pod
4610 #: deb-substvars.pod
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."
4618 #: deb-substvars.pod
4619 msgid "B<Newline>, B<Space>, B<Tab>"
4623 #: deb-substvars.pod
4624 msgid "These variables each hold the corresponding character."
4628 #: deb-substvars.pod
4629 msgid "B<shlibs:>I<dependencyfield>"
4633 #: deb-substvars.pod
4635 "Variable settings with names of this form are generated by "
4636 "B<dpkg-shlibdeps>."
4640 #: deb-substvars.pod
4641 msgid "B<dpkg:Upstream-Version>"
4645 #: deb-substvars.pod
4646 msgid "The upstream version of dpkg (since dpkg 1.13.19)."
4650 #: deb-substvars.pod
4651 msgid "B<dpkg:Version>"
4655 #: deb-substvars.pod
4656 msgid "The full version of dpkg (since dpkg 1.13.19)."
4660 #: deb-substvars.pod
4661 msgid "B<debian/substvars>"
4665 #: deb-substvars.pod
4666 msgid "List of substitution variables and values."
4670 #: deb-substvars.pod
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)."
4678 msgid "deb-symbols - Debian's extended shared library information file"
4683 msgid "B<DEBIAN/symbols>"
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)>."
4697 "The format for an extended shared library dependency information entry in "
4706 " I<library-soname> I<main-dependency-template>\n"
4707 " [| I<alternative-dependency-template>]\n"
4709 " [* I<field-name>: I<field-value>]\n"
4711 " I<symbol> I<minimal-version> [I<id-of-dependency-template>]\n"
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 "
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."
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:"
4747 msgid "B<Build-Depends-Package>"
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)."
4760 msgid "B<Build-Depends-Packages>"
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."
4774 msgid "B<Allow-Internal-Symbol-Groups>"
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 "
4790 msgid "B<Ignore-Blacklist-Groups>"
4796 "A deprecated alias for B<Allow-Internal-Symbol-Groups> (since dpkg 1.20.1, "
4797 "supported since dpkg 1.17.6)."
4802 msgid "Simple symbols file"
4809 " libftp.so.3 libftp3 #MINVER#\n"
4810 " DefaultNetbuf@Base 3.1-1-6\n"
4811 " FtpAccess@Base 3.1-1-6\n"
4818 msgid "Advanced symbols file"
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"
4830 " implementationSpecificSymbol@Base 6.5.2-7 1\n"
4838 "L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, "
4839 "L<deb-src-symbols(5)>, B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)."
4844 msgid "deb-triggers - package triggers"
4850 "B<debian/triggers>, B<debian/>I<binary-package>B<.triggers>, "
4851 "B<DEBIAN/triggers>"
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)."
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."
4872 msgid "The trigger control directives currently supported are:"
4877 msgid "B<interest> I<trigger-name>"
4882 msgid "B<interest-await> I<trigger-name>"
4887 msgid "B<interest-noawait> I<trigger-name>"
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."
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."
4912 msgid "B<activate> I<trigger-name>"
4917 msgid "B<activate-await> I<trigger-name>"
4922 msgid "B<activate-noawait> I<trigger-name>"
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."
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 "
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."
4957 "Unknown directives are an error which will prevent installation of the "
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."
4975 "The “-noawait” variants are supported since dpkg 1.16.1, and will lead to "
4976 "errors if used with an older dpkg."
4982 "The “-await” alias variants are supported since dpkg 1.17.21, and will lead "
4983 "to errors if used with an older dpkg."
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."
4999 msgid "B<dpkg-trigger>(1), B<dpkg>(1), B<%PKGDOCDIR%/spec/triggers.txt>."
5004 msgid "deb-version - Debian package version number format"
5009 msgid "[I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]"
5015 "Version numbers as used for Debian binary and source packages consist of "
5016 "three components. These are:"
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."
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 "
5042 msgid "I<upstream-version>"
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."
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."
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 "
5076 msgid "I<debian-revision>"
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."
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 "
5101 "It is conventional to restart the I<debian-revision> at ‘1’ each time the "
5102 "I<upstream-version> is increased."
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)."
5117 msgid "Sorting algorithm"
5123 "The I<upstream-version> and I<debian-revision> parts are compared by the "
5124 "package management system using the same algorithm:"
5129 msgid "The strings are compared from left to right."
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’."
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."
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."
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."
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."
5182 msgid "B<deb-control>(5), B<deb>(5), B<dpkg>(1)"
5187 msgid "deb - Debian binary package format"
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)."
5201 "The format described here is used since Debian 0.93; details of the old "
5202 "format are described in B<deb-old>(5)."
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 "
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."
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 "
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."
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 "
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 "
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<_>’."
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 "
5311 msgid "application/vnd.debian.binary-package"
5321 msgid "application/x-debian-package"
5326 msgid "application/x-deb"
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)."
5339 msgid "deb822 - Debian RFC822 control data format"
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)."
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."
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<->’)."
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 "
5403 msgid "the field name is B<Package> and the field value B<dpkg>."
5409 "Empty field values are only permitted in source package control files "
5410 "(I<debian/control>). Such fields are ignored."
5415 msgid "A stanza must not contain more than one instance of a particular field name."
5420 msgid "There are three types of fields:"
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."
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."
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."
5460 msgid "B<multiline>"
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 "
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."
5485 "The presence and purpose of a field, and the syntax of its value may differ "
5486 "between types of control files."
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."
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<.>’)."
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 "
5518 msgid "All control files must be encoded in UTF-8."
5523 msgid "B<RFC822>, B<RFC5322>."
5527 #: dpkg-architecture.pod
5528 msgid "dpkg-architecture - set and determine the architecture for package building"
5532 #: dpkg-architecture.pod
5533 msgid "B<dpkg-architecture> [I<option>...] [I<command>]"
5537 #: dpkg-architecture.pod
5539 "B<dpkg-architecture> provides a facility to determine and set the build and "
5540 "host architecture for package building."
5544 #: dpkg-architecture.pod
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."
5552 #: dpkg-architecture.pod
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 "
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
5574 #: dpkg-architecture.pod
5575 msgid "B<-l>, B<--list>"
5579 #: dpkg-architecture.pod
5581 "Print the environment variables, one each line, in the format "
5582 "I<VARIABLE=value>. This is the default action."
5586 #: dpkg-architecture.pod
5587 msgid "B<-e>, B<--equal> I<architecture>"
5591 #: dpkg-architecture.pod
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 "
5601 #: dpkg-architecture.pod
5602 msgid "B<-i>, B<--is> I<architecture-wildcard>"
5606 #: dpkg-architecture.pod
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."
5616 #: dpkg-architecture.pod
5617 msgid "B<-q>, B<--query> I<variable-name>"
5621 #: dpkg-architecture.pod
5622 msgid "Print the value of a single variable."
5626 #: dpkg-architecture.pod
5627 msgid "B<-s>, B<--print-set>"
5631 #: dpkg-architecture.pod
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."
5638 #: dpkg-architecture.pod
5639 msgid "B<-u>, B<--print-unset>"
5643 #: dpkg-architecture.pod
5644 msgid "Print a similar command to B<--print-set> but to unset all variables."
5648 #: dpkg-architecture.pod
5649 msgid "B<-c>, B<--command> I<command-string>"
5653 #: dpkg-architecture.pod
5655 "Execute a I<command-string> in an environment which has all variables set to "
5656 "the determined value."
5660 #: dpkg-architecture.pod
5661 msgid "B<-L>, B<--list-known>"
5665 #: dpkg-architecture.pod
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)."
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>"
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."
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>"
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."
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
5732 #: dpkg-architecture.pod dpkg-buildpackage.pod
5733 msgid "B<-a>, B<--host-arch> I<architecture>"
5737 #: dpkg-architecture.pod
5738 msgid "Set the host Debian architecture."
5742 #: dpkg-architecture.pod dpkg-buildpackage.pod
5743 msgid "B<-t>, B<--host-type> I<gnu-system-type>"
5747 #: dpkg-architecture.pod
5748 msgid "Set the host GNU system type."
5752 #: dpkg-architecture.pod
5753 msgid "B<-A>, B<--target-arch> I<architecture>"
5757 #: dpkg-architecture.pod
5758 msgid "Set the target Debian architecture (since dpkg 1.17.14)."
5762 #: dpkg-architecture.pod
5763 msgid "B<-T>, B<--target-type> I<gnu-system-type>"
5767 #: dpkg-architecture.pod
5768 msgid "Set the target GNU system type (since dpkg 1.17.14)."
5772 #: dpkg-architecture.pod
5773 msgid "B<-W>, B<--match-wildcard> I<architecture-wildcard>"
5777 #: dpkg-architecture.pod
5779 "Restrict the architectures listed by B<--list-known> to ones matching the "
5780 "specified architecture wildcard (since dpkg 1.17.14)."
5784 #: dpkg-architecture.pod
5785 msgid "B<-B>, B<--match-bits> I<architecture-bits>"
5789 #: dpkg-architecture.pod
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>."
5796 #: dpkg-architecture.pod
5797 msgid "B<-E>, B<--match-endian> I<architecture-endianness>"
5801 #: dpkg-architecture.pod
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>."
5808 #: dpkg-architecture.pod
5809 msgid "B<--print-format> I<format>"
5813 #: dpkg-architecture.pod
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>."
5820 #: dpkg-architecture.pod
5821 msgid "B<-f>, B<--force>"
5825 #: dpkg-architecture.pod
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))."
5835 #: dpkg-architecture.pod
5840 #: dpkg-architecture.pod
5841 msgid "build machine"
5845 #: dpkg-architecture.pod
5846 msgid "The machine the package is built on."
5850 #: dpkg-architecture.pod
5851 msgid "host machine"
5855 #: dpkg-architecture.pod
5856 msgid "The machine the package is built for."
5860 #: dpkg-architecture.pod
5861 msgid "target machine"
5865 #: dpkg-architecture.pod
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 "
5875 #: dpkg-architecture.pod
5876 msgid "Debian architecture"
5880 #: dpkg-architecture.pod
5882 "The Debian architecture string, which specifies the binary tree in the FTP "
5883 "archive. Examples: i386, sparc, hurd-i386."
5887 #: dpkg-architecture.pod
5888 msgid "Debian architecture tuple"
5892 #: dpkg-architecture.pod
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."
5902 #: dpkg-architecture.pod
5903 msgid "Debian architecture wildcard"
5907 #: dpkg-architecture.pod
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:"
5917 #: dpkg-architecture.pod
5918 msgid "B<any>-B<any>-B<any>-B<any> = B<any>"
5922 #: dpkg-architecture.pod
5923 msgid "B<any>-B<any>-I<os>-B<any> = I<os>-B<any>"
5927 #: dpkg-architecture.pod
5928 msgid "B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>"
5932 #: dpkg-architecture.pod
5933 msgid "Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any."
5937 #: dpkg-architecture.pod
5938 msgid "GNU system type"
5942 #: dpkg-architecture.pod
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."
5950 #: dpkg-architecture.pod
5951 msgid "multiarch triplet"
5955 #: dpkg-architecture.pod
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/."
5966 #: dpkg-architecture.pod
5971 #: dpkg-architecture.pod
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):"
5979 #: dpkg-architecture.pod
5980 msgid "B<DEB_BUILD_ARCH>"
5984 #: dpkg-architecture.pod
5985 msgid "The Debian architecture of the build machine."
5989 #: dpkg-architecture.pod
5990 msgid "B<DEB_BUILD_ARCH_ABI>"
5994 #: dpkg-architecture.pod
5995 msgid "The Debian ABI name of the build machine (since dpkg 1.18.11)."
5999 #: dpkg-architecture.pod
6000 msgid "B<DEB_BUILD_ARCH_LIBC>"
6004 #: dpkg-architecture.pod
6005 msgid "The Debian libc name of the build machine (since dpkg 1.18.11)."
6009 #: dpkg-architecture.pod
6010 msgid "B<DEB_BUILD_ARCH_OS>"
6014 #: dpkg-architecture.pod
6015 msgid "The Debian system name of the build machine (since dpkg 1.13.2)."
6019 #: dpkg-architecture.pod
6020 msgid "B<DEB_BUILD_ARCH_CPU>"
6024 #: dpkg-architecture.pod
6025 msgid "The Debian CPU name of the build machine (since dpkg 1.13.2)."
6029 #: dpkg-architecture.pod
6030 msgid "B<DEB_BUILD_ARCH_BITS>"
6034 #: dpkg-architecture.pod
6035 msgid "The pointer size of the build machine (in bits; since dpkg 1.15.4)."
6039 #: dpkg-architecture.pod
6040 msgid "B<DEB_BUILD_ARCH_ENDIAN>"
6044 #: dpkg-architecture.pod
6045 msgid "The endianness of the build machine (little / big; since dpkg 1.15.4)."
6049 #: dpkg-architecture.pod
6050 msgid "B<DEB_BUILD_GNU_CPU>"
6054 #: dpkg-architecture.pod
6055 msgid "The GNU CPU part of B<DEB_BUILD_GNU_TYPE>."
6059 #: dpkg-architecture.pod
6060 msgid "B<DEB_BUILD_GNU_SYSTEM>"
6064 #: dpkg-architecture.pod
6065 msgid "The GNU system part of B<DEB_BUILD_GNU_TYPE>."
6069 #: dpkg-architecture.pod
6070 msgid "B<DEB_BUILD_GNU_TYPE>"
6074 #: dpkg-architecture.pod
6075 msgid "The GNU system type of the build machine."
6079 #: dpkg-architecture.pod
6080 msgid "B<DEB_BUILD_MULTIARCH>"
6084 #: dpkg-architecture.pod
6086 "The clarified GNU system type of the build machine, used for filesystem "
6087 "paths (since dpkg 1.16.0)."
6091 #: dpkg-architecture.pod
6092 msgid "B<DEB_HOST_ARCH>"
6096 #: dpkg-architecture.pod
6097 msgid "The Debian architecture of the host machine."
6101 #: dpkg-architecture.pod
6102 msgid "B<DEB_HOST_ARCH_ABI>"
6106 #: dpkg-architecture.pod
6107 msgid "The Debian ABI name of the host machine (since dpkg 1.18.11)."
6111 #: dpkg-architecture.pod
6112 msgid "B<DEB_HOST_ARCH_LIBC>"
6116 #: dpkg-architecture.pod
6117 msgid "The Debian libc name of the host machine (since dpkg 1.18.11)."
6121 #: dpkg-architecture.pod
6122 msgid "B<DEB_HOST_ARCH_OS>"
6126 #: dpkg-architecture.pod
6127 msgid "The Debian system name of the host machine (since dpkg 1.13.2)."
6131 #: dpkg-architecture.pod
6132 msgid "B<DEB_HOST_ARCH_CPU>"
6136 #: dpkg-architecture.pod
6137 msgid "The Debian CPU name of the host machine (since dpkg 1.13.2)."
6141 #: dpkg-architecture.pod
6142 msgid "B<DEB_HOST_ARCH_BITS>"
6146 #: dpkg-architecture.pod
6147 msgid "The pointer size of the host machine (in bits; since dpkg 1.15.4)."
6151 #: dpkg-architecture.pod
6152 msgid "B<DEB_HOST_ARCH_ENDIAN>"
6156 #: dpkg-architecture.pod
6157 msgid "The endianness of the host machine (little / big; since dpkg 1.15.4)."
6161 #: dpkg-architecture.pod
6162 msgid "B<DEB_HOST_GNU_CPU>"
6166 #: dpkg-architecture.pod
6167 msgid "The GNU CPU part of B<DEB_HOST_GNU_TYPE>."
6171 #: dpkg-architecture.pod
6172 msgid "B<DEB_HOST_GNU_SYSTEM>"
6176 #: dpkg-architecture.pod
6177 msgid "The GNU system part of B<DEB_HOST_GNU_TYPE>."
6181 #: dpkg-architecture.pod
6182 msgid "B<DEB_HOST_GNU_TYPE>"
6186 #: dpkg-architecture.pod
6187 msgid "The GNU system type of the host machine."
6191 #: dpkg-architecture.pod
6192 msgid "B<DEB_HOST_MULTIARCH>"
6196 #: dpkg-architecture.pod
6198 "The clarified GNU system type of the host machine, used for filesystem paths "
6199 "(since dpkg 1.16.0)."
6203 #: dpkg-architecture.pod
6204 msgid "B<DEB_TARGET_ARCH>"
6208 #: dpkg-architecture.pod
6209 msgid "The Debian architecture of the target machine (since dpkg 1.17.14)."
6213 #: dpkg-architecture.pod
6214 msgid "B<DEB_TARGET_ARCH_ABI>"
6218 #: dpkg-architecture.pod
6219 msgid "The Debian ABI name of the target machine (since dpkg 1.18.11)."
6223 #: dpkg-architecture.pod
6224 msgid "B<DEB_TARGET_ARCH_LIBC>"
6228 #: dpkg-architecture.pod
6229 msgid "The Debian libc name of the target machine (since dpkg 1.18.11)."
6233 #: dpkg-architecture.pod
6234 msgid "B<DEB_TARGET_ARCH_OS>"
6238 #: dpkg-architecture.pod
6239 msgid "The Debian system name of the target machine (since dpkg 1.17.14)."
6243 #: dpkg-architecture.pod
6244 msgid "B<DEB_TARGET_ARCH_CPU>"
6248 #: dpkg-architecture.pod
6249 msgid "The Debian CPU name of the target machine (since dpkg 1.17.14)."
6253 #: dpkg-architecture.pod
6254 msgid "B<DEB_TARGET_ARCH_BITS>"
6258 #: dpkg-architecture.pod
6259 msgid "The pointer size of the target machine (in bits; since dpkg 1.17.14)."
6263 #: dpkg-architecture.pod
6264 msgid "B<DEB_TARGET_ARCH_ENDIAN>"
6268 #: dpkg-architecture.pod
6269 msgid "The endianness of the target machine (little / big; since dpkg 1.17.14)."
6273 #: dpkg-architecture.pod
6274 msgid "B<DEB_TARGET_GNU_CPU>"
6278 #: dpkg-architecture.pod
6279 msgid "The GNU CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
6283 #: dpkg-architecture.pod
6284 msgid "B<DEB_TARGET_GNU_SYSTEM>"
6288 #: dpkg-architecture.pod
6289 msgid "The GNU system part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)."
6293 #: dpkg-architecture.pod
6294 msgid "B<DEB_TARGET_GNU_TYPE>"
6298 #: dpkg-architecture.pod
6299 msgid "The GNU system type of the target machine (since dpkg 1.17.14)."
6303 #: dpkg-architecture.pod
6304 msgid "B<DEB_TARGET_MULTIARCH>"
6308 #: dpkg-architecture.pod
6310 "The clarified GNU system type of the target machine, used for filesystem "
6311 "paths (since dpkg 1.17.14)."
6315 #: dpkg-architecture.pod
6316 msgid "Architecture tables"
6320 #: dpkg-architecture.pod
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\"."
6330 #: dpkg-architecture.pod
6331 msgid "I<%PKGDATADIR%/cputable>"
6335 #: dpkg-architecture.pod
6337 "Table of known CPU names and mapping to their GNU name. Format version 1.0 "
6338 "(since dpkg 1.13.2)."
6342 #: dpkg-architecture.pod
6343 msgid "I<%PKGDATADIR%/ostable>"
6347 #: dpkg-architecture.pod
6349 "Table of known operating system names and mapping to their GNU name. Format "
6350 "version 2.0 (since dpkg 1.18.11)."
6354 #: dpkg-architecture.pod
6355 msgid "I<%PKGDATADIR%/tupletable>"
6359 #: dpkg-architecture.pod
6361 "Mapping between Debian architecture tuples and Debian architecture names. "
6362 "Format version 1.0 (since dpkg 1.18.11)."
6366 #: dpkg-architecture.pod
6367 msgid "I<%PKGDATADIR%/abitable>"
6371 #: dpkg-architecture.pod
6373 "Table of Debian architecture ABI attribute overrides. Format version 2.0 "
6374 "(since dpkg 1.18.11)."
6378 #: dpkg-architecture.pod dpkg-buildflags.pod
6379 msgid "Packaging support"
6383 #: dpkg-architecture.pod
6384 msgid "I<%PKGDATADIR%/architecture.mk>"
6388 #: dpkg-architecture.pod
6390 "Makefile snippet that properly sets and exports all the variables that "
6391 "B<dpkg-architecture> outputs (since dpkg 1.16.1)."
6395 #: dpkg-architecture.pod
6397 "B<dpkg-buildpackage> accepts the B<-a> option and passes it to "
6398 "B<dpkg-architecture>. Other examples:"
6402 #: dpkg-architecture.pod
6405 " CC=i386-gnu-gcc dpkg-architecture -c debian/rules build\n"
6410 #: dpkg-architecture.pod
6413 " eval $(dpkg-architecture -u)\n"
6418 #: dpkg-architecture.pod
6420 "Check if the current or specified host architecture is equal to an "
6425 #: dpkg-architecture.pod
6428 " dpkg-architecture -elinux-alpha\n"
6433 #: dpkg-architecture.pod
6436 " dpkg-architecture -amips -elinux-mips\n"
6441 #: dpkg-architecture.pod
6442 msgid "Check if the current or specified host architecture is a Linux system:"
6446 #: dpkg-architecture.pod
6449 " dpkg-architecture -ilinux-any\n"
6454 #: dpkg-architecture.pod
6457 " dpkg-architecture -ai386 -ilinux-any\n"
6462 #: dpkg-architecture.pod dpkg-buildflags.pod
6463 msgid "Usage in debian/rules"
6467 #: dpkg-architecture.pod
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:"
6478 #: dpkg-architecture.pod
6479 msgid "Retrieving the GNU system type and forwarding it to ./configure:"
6483 #: dpkg-architecture.pod
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"
6489 " ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))\n"
6490 " confflags += --build=$(DEB_HOST_GNU_TYPE)\n"
6492 " confflags += --build=$(DEB_BUILD_GNU_TYPE) \\\n"
6493 " --host=$(DEB_HOST_GNU_TYPE)\n"
6496 " ./configure $(confflags)\n"
6501 #: dpkg-architecture.pod
6502 msgid "Doing something only for a specific architecture:"
6506 #: dpkg-architecture.pod
6509 " DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)\n"
6514 #: dpkg-architecture.pod
6517 " ifeq ($(DEB_HOST_ARCH),alpha)\n"
6524 #: dpkg-architecture.pod
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."
6531 #: dpkg-architecture.pod
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:"
6538 #: dpkg-architecture.pod
6541 " include %PKGDATADIR%/architecture.mk\n"
6546 #: dpkg-architecture.pod
6548 "In any case, you should never use B<dpkg --print-architecture> to get "
6549 "architecture information during a package build."
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
6566 #: dpkg-architecture.pod
6567 msgid "B<DPKG_DATADIR>"
6571 #: dpkg-architecture.pod
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 "
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>"
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
6599 "Sets the color mode (since dpkg 1.18.5). The currently accepted values are: "
6600 "B<auto> (default), B<always> and B<never>."
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
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
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)."
6627 #: dpkg-architecture.pod
6628 msgid "All long command and option names available only since dpkg 1.17.17."
6632 #: dpkg-architecture.pod
6633 msgid "B<dpkg-buildpackage>(1)."
6637 #: dpkg-buildflags.pod
6638 msgid "dpkg-buildflags - returns build flags to use during package build"
6642 #: dpkg-buildflags.pod
6643 msgid "B<dpkg-buildflags> [I<option>...] [I<command>]"
6647 #: dpkg-buildflags.pod
6649 "B<dpkg-buildflags> is a tool to retrieve compilation flags to use during "
6650 "build of Debian packages."
6654 #: dpkg-buildflags.pod
6656 "The default flags are defined by the vendor but they can be "
6657 "extended/overridden in several ways:"
6661 #: dpkg-buildflags.pod
6666 #: dpkg-buildflags.pod
6667 msgid "system-wide with B<%PKGCONFDIR%/buildflags.conf>;"
6671 #: dpkg-buildflags.pod
6676 #: dpkg-buildflags.pod
6678 "for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where "
6679 "B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;"
6683 #: dpkg-buildflags.pod
6688 #: dpkg-buildflags.pod
6690 "temporarily by the user with environment variables (see section "
6695 #: dpkg-buildflags.pod
6700 #: dpkg-buildflags.pod
6702 "dynamically by the package maintainer with environment variables set via "
6703 "B<debian/rules> (see section B<ENVIRONMENT>)."
6707 #: dpkg-buildflags.pod
6708 msgid "The configuration files can contain four types of directives:"
6712 #: dpkg-buildflags.pod
6713 msgid "B<SET> I<flag> I<value>"
6717 #: dpkg-buildflags.pod
6718 msgid "Override the flag named I<flag> to have the value I<value>."
6722 #: dpkg-buildflags.pod
6723 msgid "B<STRIP> I<flag> I<value>"
6727 #: dpkg-buildflags.pod
6728 msgid "Strip from the flag named I<flag> all the build flags listed in I<value>."
6732 #: dpkg-buildflags.pod
6733 msgid "B<APPEND> I<flag> I<value>"
6737 #: dpkg-buildflags.pod
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 "
6745 #: dpkg-buildflags.pod
6746 msgid "B<PREPEND> I<flag> I<value>"
6750 #: dpkg-buildflags.pod
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 "
6758 #: dpkg-buildflags.pod
6760 "The configuration files can contain comments on lines starting with a hash "
6761 "(#). Empty lines are also ignored."
6765 #: dpkg-buildflags.pod
6770 #: dpkg-buildflags.pod
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."
6778 #: dpkg-buildflags.pod
6783 #: dpkg-buildflags.pod
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."
6790 #: dpkg-buildflags.pod
6795 #: dpkg-buildflags.pod
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."
6804 #: dpkg-buildflags.pod
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."
6812 #: dpkg-buildflags.pod
6813 msgid "B<--export=>I<format>"
6817 #: dpkg-buildflags.pod
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:"
6827 #: dpkg-buildflags.pod
6832 #: dpkg-buildflags.pod
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."
6840 #: dpkg-buildflags.pod
6845 #: dpkg-buildflags.pod
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 "
6853 #: dpkg-buildflags.pod
6854 msgid "B<configure>"
6858 #: dpkg-buildflags.pod
6859 msgid "This is a legacy alias for B<cmdline>."
6863 #: dpkg-buildflags.pod
6868 #: dpkg-buildflags.pod
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."
6876 #: dpkg-buildflags.pod
6877 msgid "B<--get> I<flag>"
6881 #: dpkg-buildflags.pod
6883 "Print the value of the flag on standard output. Exits with 0 if the flag is "
6884 "known otherwise exits with 1."
6888 #: dpkg-buildflags.pod
6889 msgid "B<--origin> I<flag>"
6893 #: dpkg-buildflags.pod
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 "
6901 #: dpkg-buildflags.pod
6906 #: dpkg-buildflags.pod
6907 msgid "the original flag set by the vendor is returned;"
6911 #: dpkg-buildflags.pod
6916 #: dpkg-buildflags.pod
6917 msgid "the flag is set/modified by a system-wide configuration;"
6921 #: dpkg-buildflags.pod
6926 #: dpkg-buildflags.pod
6927 msgid "the flag is set/modified by a user-specific configuration;"
6931 #: dpkg-buildflags.pod
6936 #: dpkg-buildflags.pod
6937 msgid "the flag is set/modified by an environment-specific configuration."
6941 #: dpkg-buildflags.pod
6946 #: dpkg-buildflags.pod
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)."
6956 #: dpkg-buildflags.pod
6957 msgid "For example:"
6961 #: dpkg-buildflags.pod
6966 " DEB_CFLAGS_SET=-O0 -Wall\n"
6971 #: dpkg-buildflags.pod
6983 #: dpkg-buildflags.pod
6986 " Area: hardening\n"
6995 #: dpkg-buildflags.pod
6998 " Area: reproducible\n"
7006 #: dpkg-buildflags.pod
7010 " Value: -O0 -Wall\n"
7016 #: dpkg-buildflags.pod
7020 " Value: -D_FORTIFY_SOURCE=2\n"
7026 #: dpkg-buildflags.pod
7027 msgid "B<--query-features> I<area>"
7031 #: dpkg-buildflags.pod
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."
7043 #: dpkg-buildflags.pod
7044 msgid "The output is in RFC822 format, with one section per feature. For example:"
7048 #: dpkg-buildflags.pod
7058 #: dpkg-buildflags.pod
7061 " Feature: stackprotector\n"
7067 #: dpkg-buildflags.pod dpkg-mergechangelogs.pod dpkg-scansources.pod
7068 #: dpkg-statoverride.pod dpkg-vendor.pod update-alternatives.pod
7073 #: dpkg-buildflags.pod
7074 msgid "SUPPORTED FLAGS"
7078 #: dpkg-buildflags.pod
7083 #: dpkg-buildflags.pod
7084 msgid "Options for the assembler. Default value: empty. Since dpkg 1.21.0."
7088 #: dpkg-buildflags.pod
7093 #: dpkg-buildflags.pod
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>)."
7101 #: dpkg-buildflags.pod
7106 #: dpkg-buildflags.pod
7107 msgid "Options for the C preprocessor. Default value: empty."
7111 #: dpkg-buildflags.pod
7116 #: dpkg-buildflags.pod
7117 msgid "Options for the C++ compiler. Same as B<CFLAGS>."
7121 #: dpkg-buildflags.pod
7122 msgid "B<OBJCFLAGS>"
7126 #: dpkg-buildflags.pod
7127 msgid "Options for the Objective C compiler. Same as B<CFLAGS>."
7131 #: dpkg-buildflags.pod
7132 msgid "B<OBJCXXFLAGS>"
7136 #: dpkg-buildflags.pod
7137 msgid "Options for the Objective C++ compiler. Same as B<CXXFLAGS>."
7141 #: dpkg-buildflags.pod
7146 #: dpkg-buildflags.pod
7147 msgid "Options for the GNU Java compiler (gcj). A subset of B<CFLAGS>."
7151 #: dpkg-buildflags.pod
7156 #: dpkg-buildflags.pod
7157 msgid "Options for the D compiler (ldc or gdc). Since dpkg 1.20.6."
7161 #: dpkg-buildflags.pod
7166 #: dpkg-buildflags.pod
7167 msgid "Options for the Fortran 77 compiler. A subset of B<CFLAGS>."
7171 #: dpkg-buildflags.pod
7176 #: dpkg-buildflags.pod
7177 msgid "Options for the Fortran 9x compiler. Same as B<FFLAGS>."
7181 #: dpkg-buildflags.pod
7186 #: dpkg-buildflags.pod
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."
7194 #: dpkg-buildflags.pod
7196 "New flags might be added in the future if the need arises (for example to "
7197 "support other languages)."
7201 #: dpkg-buildflags.pod
7202 msgid "FEATURE AREAS"
7206 #: dpkg-buildflags.pod
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 "
7216 #: dpkg-buildflags.pod
7219 " export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify\n"
7224 #: dpkg-buildflags.pod
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 "
7233 #: dpkg-buildflags.pod
7236 " export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify\n"
7241 #: dpkg-buildflags.pod
7246 #: dpkg-buildflags.pod
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 "
7254 #: dpkg-buildflags.pod
7259 #: dpkg-buildflags.pod
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>."
7267 #: dpkg-buildflags.pod
7272 #: dpkg-buildflags.pod
7274 "Several compile-time options (detailed below) can be used to help detect "
7275 "problems in the source code or build system."
7279 #: dpkg-buildflags.pod
7284 #: dpkg-buildflags.pod
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>."
7295 #: dpkg-buildflags.pod
7300 #: dpkg-buildflags.pod
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>."
7312 #: dpkg-buildflags.pod
7317 #: dpkg-buildflags.pod
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."
7325 #: dpkg-buildflags.pod
7330 #: dpkg-buildflags.pod
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>."
7339 #: dpkg-buildflags.pod
7344 #: dpkg-buildflags.pod
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."
7354 #: dpkg-buildflags.pod
7359 #: dpkg-buildflags.pod
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 "
7367 #: dpkg-buildflags.pod
7372 #: dpkg-buildflags.pod
7374 "This setting (disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, "
7375 "B<CXXFLAGS> and B<LDFLAGS>."
7379 #: dpkg-buildflags.pod
7384 #: dpkg-buildflags.pod
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."
7392 #: dpkg-buildflags.pod
7393 msgid "B<undefined>"
7397 #: dpkg-buildflags.pod
7399 "This setting (disabled by default) adds B<-fsanitize=undefined> to "
7400 "B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>."
7404 #: dpkg-buildflags.pod
7409 #: dpkg-buildflags.pod
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."
7418 #: dpkg-buildflags.pod
7423 #: dpkg-buildflags.pod
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’."
7436 #: dpkg-buildflags.pod
7441 #: dpkg-buildflags.pod
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."
7453 #: dpkg-buildflags.pod
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."
7462 #: dpkg-buildflags.pod
7463 msgid "B<stackprotector>"
7467 #: dpkg-buildflags.pod
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)."
7479 #: dpkg-buildflags.pod
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."
7487 #: dpkg-buildflags.pod
7488 msgid "B<stackprotectorstrong>"
7492 #: dpkg-buildflags.pod
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."
7501 #: dpkg-buildflags.pod
7502 msgid "Disabling B<stackprotector> will also disable this setting."
7506 #: dpkg-buildflags.pod
7508 "This feature has the same requirements as B<stackprotector>, and in addition "
7509 "also requires gcc 4.9 and later."
7513 #: dpkg-buildflags.pod
7518 #: dpkg-buildflags.pod
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 "
7529 #: dpkg-buildflags.pod
7534 #: dpkg-buildflags.pod
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."
7543 #: dpkg-buildflags.pod
7548 #: dpkg-buildflags.pod
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>) "
7569 #: dpkg-buildflags.pod
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 "
7583 #: dpkg-buildflags.pod
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."
7592 #: dpkg-buildflags.pod
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:"
7600 #: dpkg-buildflags.pod
7605 #: dpkg-buildflags.pod
7606 msgid "Cannot be linked into a PIE program, nor a shared library."
7610 #: dpkg-buildflags.pod
7615 #: dpkg-buildflags.pod
7616 msgid "Can be linked into any program, but not a shared library (recommended)."
7620 #: dpkg-buildflags.pod
7625 #: dpkg-buildflags.pod
7626 msgid "Can be linked into any program and shared library."
7630 #: dpkg-buildflags.pod
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 "
7646 #: dpkg-buildflags.pod
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."
7657 #: dpkg-buildflags.pod
7658 msgid "reproducible"
7662 #: dpkg-buildflags.pod
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."
7671 #: dpkg-buildflags.pod
7676 #: dpkg-buildflags.pod
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__> "
7684 #: dpkg-buildflags.pod
7685 msgid "B<fixfilepath>"
7689 #: dpkg-buildflags.pod
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."
7699 #: dpkg-buildflags.pod
7701 "If both B<fixdebugpath> and B<fixfilepath> are set, this option takes "
7702 "precedence, because it is a superset of the former."
7706 #: dpkg-buildflags.pod
7707 msgid "B<fixdebugpath>"
7711 #: dpkg-buildflags.pod
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 "
7722 #: dpkg-buildflags.pod
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."
7733 #: dpkg-buildflags.pod
7734 msgid "B<DEB_>I<flag>B<_SET>"
7738 #: dpkg-buildflags.pod
7739 msgid "B<DEB_>I<flag>B<_MAINT_SET>"
7743 #: dpkg-buildflags.pod
7744 msgid "This variable can be used to force the value returned for the given I<flag>."
7748 #: dpkg-buildflags.pod
7749 msgid "B<DEB_>I<flag>B<_STRIP>"
7753 #: dpkg-buildflags.pod
7754 msgid "B<DEB_>I<flag>B<_MAINT_STRIP>"
7758 #: dpkg-buildflags.pod
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>."
7765 #: dpkg-buildflags.pod
7766 msgid "B<DEB_>I<flag>B<_APPEND>"
7770 #: dpkg-buildflags.pod
7771 msgid "B<DEB_>I<flag>B<_MAINT_APPEND>"
7775 #: dpkg-buildflags.pod
7777 "This variable can be used to append supplementary options to the value "
7778 "returned for the given I<flag>."
7782 #: dpkg-buildflags.pod
7783 msgid "B<DEB_>I<flag>B<_PREPEND>"
7787 #: dpkg-buildflags.pod
7788 msgid "B<DEB_>I<flag>B<_MAINT_PREPEND>"
7792 #: dpkg-buildflags.pod
7794 "This variable can be used to prepend supplementary options to the value "
7795 "returned for the given I<flag>."
7799 #: dpkg-buildflags.pod dpkg-buildpackage.pod dpkg-genbuildinfo.pod
7800 msgid "B<DEB_BUILD_OPTIONS>"
7804 #: dpkg-buildflags.pod
7805 msgid "B<DEB_BUILD_MAINT_OPTIONS>"
7809 #: dpkg-buildflags.pod
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 "
7819 #: dpkg-buildflags.pod dpkg-vendor.pod
7820 msgid "B<DEB_VENDOR>"
7824 #: dpkg-buildflags.pod
7826 "This setting defines the current vendor. If not set, it will discover the "
7827 "current vendor by reading B<%PKGCONFDIR%/origins/default>."
7831 #: dpkg-buildflags.pod
7832 msgid "B<DEB_BUILD_PATH>"
7836 #: dpkg-buildflags.pod
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."
7844 #: dpkg-buildflags.pod
7845 msgid "Configuration files"
7849 #: dpkg-buildflags.pod
7850 msgid "B<%PKGCONFDIR%/buildflags.conf>"
7854 #: dpkg-buildflags.pod
7855 msgid "System wide configuration file."
7859 #: dpkg-buildflags.pod
7860 msgid "B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or"
7864 #: dpkg-buildflags.pod
7865 msgid "B<$HOME/.config/dpkg/buildflags.conf>"
7869 #: dpkg-buildflags.pod dpkg-buildpackage.pod
7870 msgid "User configuration file."
7874 #: dpkg-buildflags.pod
7875 msgid "B<%PKGDATADIR%/buildflags.mk>"
7879 #: dpkg-buildflags.pod
7881 "Makefile snippet that will load (and optionally export) all flags supported "
7882 "by B<dpkg-buildflags> into variables (since dpkg 1.16.1)."
7886 #: dpkg-buildflags.pod
7887 msgid "To pass build flags to a build command in a Makefile:"
7891 #: dpkg-buildflags.pod
7894 " $(MAKE) $(shell dpkg-buildflags --export=cmdline)\n"
7899 #: dpkg-buildflags.pod
7902 " ./configure $(shell dpkg-buildflags --export=cmdline)\n"
7907 #: dpkg-buildflags.pod
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:"
7914 #: dpkg-buildflags.pod
7917 " eval \"$(dpkg-buildflags --export=sh)\" && make\n"
7922 #: dpkg-buildflags.pod
7923 msgid "or to set the positional parameters to pass to a command:"
7927 #: dpkg-buildflags.pod
7930 " eval \"set -- $(dpkg-buildflags --export=cmdline)\"\n"
7931 " for dir in a b c; do (cd $dir && ./configure \"$@\" && make); done\n"
7936 #: dpkg-buildflags.pod
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>."
7946 #: dpkg-buildflags.pod
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."
7953 #: dpkg-buildflags.pod
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."
7962 #: dpkg-buildflags.pod
7964 "If you want to export all buildflags into the environment (where they can be "
7965 "picked up by your build system):"
7969 #: dpkg-buildflags.pod
7972 " DPKG_EXPORT_BUILDFLAGS = 1\n"
7973 " include %PKGDATADIR%/buildflags.mk\n"
7978 #: dpkg-buildflags.pod
7980 "For some extra control over what is exported, you can manually export the "
7981 "variables (as none are exported by default):"
7985 #: dpkg-buildflags.pod
7988 " include %PKGDATADIR%/buildflags.mk\n"
7989 " export CPPFLAGS CFLAGS LDFLAGS\n"
7994 #: dpkg-buildflags.pod
7995 msgid "And you can of course pass the flags to commands manually:"
7999 #: dpkg-buildflags.pod
8002 " include %PKGDATADIR%/buildflags.mk\n"
8004 " \t$(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)\n"
8009 #: dpkg-buildpackage.pod
8010 msgid "dpkg-buildpackage - build binary or source packages from sources"
8014 #: dpkg-buildpackage.pod
8015 msgid "B<dpkg-buildpackage> [I<option>...]"
8019 #: dpkg-buildpackage.pod
8021 "B<dpkg-buildpackage> is a program that automates the process of building a "
8022 "Debian package. It consists of the following steps:"
8026 #: dpkg-buildpackage.pod
8031 #: dpkg-buildpackage.pod
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)."
8039 #: dpkg-buildpackage.pod
8044 #: dpkg-buildpackage.pod
8046 "It checks that the build-dependencies and build-conflicts are satisfied "
8047 "(unless B<-d> or B<--no-check-builddeps> is specified)."
8051 #: dpkg-buildpackage.pod
8056 #: dpkg-buildpackage.pod
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)."
8065 #: dpkg-buildpackage.pod
8070 #: dpkg-buildpackage.pod
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)."
8078 #: dpkg-buildpackage.pod
8083 #: dpkg-buildpackage.pod
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)."
8098 #: dpkg-buildpackage.pod
8103 #: dpkg-buildpackage.pod
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>."
8111 #: dpkg-buildpackage.pod
8116 #: dpkg-buildpackage.pod
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>."
8131 #: dpkg-buildpackage.pod
8136 #: dpkg-buildpackage.pod
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."
8143 #: dpkg-buildpackage.pod
8148 #: dpkg-buildpackage.pod
8149 msgid "It calls B<dpkg-source --after-build>."
8153 #: dpkg-buildpackage.pod
8158 #: dpkg-buildpackage.pod
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>)."
8166 #: dpkg-buildpackage.pod
8171 #: dpkg-buildpackage.pod
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)."
8182 #: dpkg-buildpackage.pod
8187 #: dpkg-buildpackage.pod
8188 msgid "It runs the B<done> hook."
8192 #: dpkg-buildpackage.pod
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 "
8202 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8203 msgid "B<--build=>I<type>"
8207 #: dpkg-buildpackage.pod
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>."
8216 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8217 msgid "The allowed values are:"
8221 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8226 #: dpkg-buildpackage.pod
8227 msgid "Builds the source package."
8231 #: dpkg-buildpackage.pod
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."
8241 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8246 #: dpkg-buildpackage.pod
8247 msgid "Builds the architecture specific binary packages."
8251 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8256 #: dpkg-buildpackage.pod
8257 msgid "Builds the architecture independent binary packages."
8261 #: dpkg-buildpackage.pod
8263 "Builds the architecture specific and independent binary packages. This is "
8264 "an alias for B<any,all>."
8268 #: dpkg-buildpackage.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
8273 #: dpkg-buildpackage.pod
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."
8280 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8285 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8286 msgid "Equivalent to B<--build=source,all> (since dpkg 1.17.11)."
8290 #: dpkg-buildpackage.pod dpkg-genchanges.pod dpkg.pod
8295 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8296 msgid "Equivalent to B<--build=source,any> (since dpkg 1.17.11)."
8300 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8305 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8306 msgid "Equivalent to B<--build=binary> or B<--build=any,all>."
8310 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-genchanges.pod
8315 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8316 msgid "Equivalent to B<--build=any>."
8320 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-genchanges.pod
8325 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8326 msgid "Equivalent to B<--build=all>."
8330 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8335 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8336 msgid "Equivalent to B<--build=source>."
8340 #: dpkg-buildpackage.pod
8345 #: dpkg-buildpackage.pod
8347 "Equivalent to B<--build=full>, B<--build=source,binary> or "
8348 "B<--build=source,any,all> (since dpkg 1.15.8)."
8352 #: dpkg-buildpackage.pod
8353 msgid "B<--target=>I<target>[,...]"
8357 #: dpkg-buildpackage.pod
8358 msgid "B<--target> I<target>[,...]"
8362 #: dpkg-buildpackage.pod
8363 msgid "B<-T>, B<--rules-target=>I<target>[,...]"
8367 #: dpkg-buildpackage.pod
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)."
8380 #: dpkg-buildpackage.pod
8381 msgid "B<--as-root>"
8385 #: dpkg-buildpackage.pod
8387 "Only meaningful together with B<--target> (since dpkg 1.15.0). Requires "
8388 "that the target be run with root rights."
8392 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8397 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8402 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8407 #: dpkg-buildpackage.pod dpkg-genchanges.pod dpkg-gencontrol.pod
8408 #: dpkg-gensymbols.pod
8409 msgid "B<-v>I<version>"
8413 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8414 msgid "B<-C>I<changes-description>"
8418 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8419 msgid "B<-m>I<maintainer-address>"
8423 #: dpkg-buildpackage.pod dpkg-genchanges.pod
8424 msgid "B<-e>I<maintainer-address>"
8428 #: dpkg-buildpackage.pod
8429 msgid "Passed unchanged to B<dpkg-genchanges>. See its manual page."
8433 #: dpkg-buildpackage.pod
8434 msgid "B<--build-by=>I<maintainer-address>"
8438 #: dpkg-buildpackage.pod
8439 msgid "B<--source-by=>I<maintainer-address> (since dpkg 1.21.10)"
8443 #: dpkg-buildpackage.pod
8444 msgid "Pass as B<-m> to B<dpkg-genchanges>. See its manual page."
8448 #: dpkg-buildpackage.pod
8449 msgid "B<--release-by=>I<maintainer-address>"
8453 #: dpkg-buildpackage.pod
8454 msgid "B<--changed-by=>I<maintainer-address> (since dpkg 1.21.10)"
8458 #: dpkg-buildpackage.pod
8459 msgid "Pass as B<-e> to B<dpkg-genchanges>. See its manual page."
8463 #: dpkg-buildpackage.pod
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."
8471 #: dpkg-buildpackage.pod
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."
8479 #: dpkg-buildpackage.pod
8480 msgid "B<--target-arch> I<architecture>"
8484 #: dpkg-buildpackage.pod
8486 "Specify the Debian architecture the binaries built will build for (since "
8487 "dpkg 1.17.17). The default value is the host machine."
8491 #: dpkg-buildpackage.pod
8492 msgid "B<--target-type> I<gnu-system-type>"
8496 #: dpkg-buildpackage.pod
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."
8504 #: dpkg-buildpackage.pod
8505 msgid "B<-P>, B<--build-profiles=>I<profile>[B<,>...]"
8509 #: dpkg-buildpackage.pod
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."
8519 #: dpkg-buildpackage.pod
8520 msgid "B<-j>, B<--jobs>[=I<jobs>|B<auto>]"
8524 #: dpkg-buildpackage.pod
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 "
8537 #: dpkg-buildpackage.pod
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 "
8552 #: dpkg-buildpackage.pod
8553 msgid "B<-J>, B<--jobs-try>[=I<jobs>|B<auto>]"
8557 #: dpkg-buildpackage.pod
8559 "This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent "
8560 "to the B<-j> above."
8564 #: dpkg-buildpackage.pod
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 "
8572 #: dpkg-buildpackage.pod
8573 msgid "B<--jobs-force>[=I<jobs>|B<auto>]"
8577 #: dpkg-buildpackage.pod
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."
8586 #: dpkg-buildpackage.pod
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."
8595 #: dpkg-buildpackage.pod
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."
8603 #: dpkg-buildpackage.pod
8604 msgid "B<-D>, B<--check-builddeps>"
8608 #: dpkg-buildpackage.pod
8610 "Check build dependencies and conflicts; abort if unsatisfied (long option "
8611 "since dpkg 1.18.8). This is the default behavior."
8615 #: dpkg-buildpackage.pod
8616 msgid "B<-d>, B<--no-check-builddeps>"
8620 #: dpkg-buildpackage.pod
8622 "Do not check build dependencies and conflicts (long option since dpkg "
8627 #: dpkg-buildpackage.pod
8628 msgid "B<--ignore-builtin-builddeps>"
8632 #: dpkg-buildpackage.pod
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."
8640 #: dpkg-buildpackage.pod
8641 msgid "B<--rules-requires-root>"
8645 #: dpkg-buildpackage.pod
8647 "Do not honor the B<Rules-Requires-Root> field, falling back to its legacy "
8648 "default value (since dpkg 1.19.1)."
8652 #: dpkg-buildpackage.pod
8653 msgid "B<-nc>, B<--no-pre-clean>"
8657 #: dpkg-buildpackage.pod
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 "
8666 #: dpkg-buildpackage.pod
8667 msgid "B<--pre-clean>"
8671 #: dpkg-buildpackage.pod
8673 "Clean the source tree before building (since dpkg 1.18.8). This is the "
8678 #: dpkg-buildpackage.pod
8679 msgid "B<-tc>, B<--post-clean>"
8683 #: dpkg-buildpackage.pod
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)."
8690 #: dpkg-buildpackage.pod
8691 msgid "B<--no-post-clean>"
8695 #: dpkg-buildpackage.pod
8697 "Do not clean the source tree after the package has been built (since dpkg "
8698 "1.19.1). This is the default behavior."
8702 #: dpkg-buildpackage.pod
8703 msgid "B<--sanitize-env>"
8707 #: dpkg-buildpackage.pod
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."
8718 #: dpkg-buildpackage.pod
8719 msgid "B<-r>, B<--root-command=>I<gain-root-command>"
8723 #: dpkg-buildpackage.pod
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 "
8740 #: dpkg-buildpackage.pod
8741 msgid "B<-R>, B<--rules-file=>I<rules-file>"
8745 #: dpkg-buildpackage.pod
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>)."
8757 #: dpkg-buildpackage.pod
8758 msgid "B<--check-command=>I<check-command>"
8762 #: dpkg-buildpackage.pod
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 "
8771 #: dpkg-buildpackage.pod
8772 msgid "B<--check-option=>I<opt>"
8776 #: dpkg-buildpackage.pod
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 "
8784 #: dpkg-buildpackage.pod
8785 msgid "B<--hook->I<hook-name>B<=>I<hook-command>"
8789 #: dpkg-buildpackage.pod
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 "
8799 #: dpkg-buildpackage.pod
8801 "B<Note:> Hooks can affect the build process, and cause build failures if "
8802 "their commands fail, so watch out for unintended consequences."
8806 #: dpkg-buildpackage.pod
8807 msgid "The current I<hook-name> supported are:"
8811 #: dpkg-buildpackage.pod
8813 "B<init preclean source build binary buildinfo changes postclean check sign "
8818 #: dpkg-buildpackage.pod
8820 "The I<hook-command> supports the following substitution format string, which "
8821 "will get applied to it before execution:"
8825 #: dpkg-buildpackage.pod
8830 #: dpkg-buildpackage.pod
8831 msgid "A single % character."
8835 #: dpkg-buildpackage.pod
8840 #: dpkg-buildpackage.pod
8842 "A boolean value (0 or 1), representing whether the following action is being "
8847 #: dpkg-buildpackage.pod
8852 #: dpkg-buildpackage.pod
8853 msgid "The source package name."
8857 #: dpkg-buildpackage.pod
8862 #: dpkg-buildpackage.pod
8863 msgid "The source package version."
8867 #: dpkg-buildpackage.pod
8872 #: dpkg-buildpackage.pod
8873 msgid "The source package version (without the epoch)."
8877 #: dpkg-buildpackage.pod
8882 #: dpkg-buildpackage.pod
8883 msgid "The upstream version."
8887 #: dpkg-buildpackage.pod
8888 msgid "B<--buildinfo-file=>I<filename>"
8892 #: dpkg-buildpackage.pod
8894 "Set the I<filename> for the generated B<.buildinfo> file (since dpkg "
8899 #: dpkg-buildpackage.pod
8900 msgid "B<--buildinfo-option=>I<opt>"
8904 #: dpkg-buildpackage.pod
8906 "Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11). Can be "
8907 "used multiple times."
8911 #: dpkg-buildpackage.pod
8912 msgid "B<--sign-backend=>I<sign-backend>"
8916 #: dpkg-buildpackage.pod
8918 "Specify an OpenPGP backend interface to use when invoking the "
8919 "I<sign-command> (since dpkg 1.21.10)."
8923 #: dpkg-buildpackage.pod
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:"
8930 #: dpkg-buildpackage.pod
8931 msgid "B<sop> (any conforming Stateless OpenPGP implementation)"
8935 #: dpkg-buildpackage.pod
8936 msgid "B<sq> (from Sequoia-PGP)"
8940 #: dpkg-buildpackage.pod
8941 msgid "B<gpg> (from GnuPG)"
8945 #: dpkg-buildpackage.pod
8946 msgid "B<-p>, B<--sign-command=>I<sign-command>"
8950 #: dpkg-buildpackage.pod
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."
8962 #: dpkg-buildpackage.pod
8963 msgid "B<-k>, B<--sign-keyid=>I<key-id>"
8967 #: dpkg-buildpackage.pod
8968 msgid "B<--sign-key=>I<key-id>"
8972 #: dpkg-buildpackage.pod
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)."
8980 #: dpkg-buildpackage.pod
8981 msgid "B<--sign-keyfile=>I<key-file>"
8985 #: dpkg-buildpackage.pod
8987 "Specify an OpenPGP I<key-file> containing the secret key to use when signing "
8988 "packages (since dpkg 1.21.10)."
8992 #: dpkg-buildpackage.pod
8994 "Note: For security reasons the I<key-file> is best kept locked with a "
8999 #: dpkg-buildpackage.pod
9000 msgid "B<-us>, B<--unsigned-source>"
9004 #: dpkg-buildpackage.pod
9005 msgid "Do not sign the source package (long option since dpkg 1.18.8)."
9009 #: dpkg-buildpackage.pod
9010 msgid "B<-ui>, B<--unsigned-buildinfo>"
9014 #: dpkg-buildpackage.pod
9015 msgid "Do not sign the B<.buildinfo> file (since dpkg 1.18.19)."
9019 #: dpkg-buildpackage.pod
9020 msgid "B<-uc>, B<--unsigned-changes>"
9024 #: dpkg-buildpackage.pod
9026 "Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg "
9031 #: dpkg-buildpackage.pod
9032 msgid "B<--no-sign>"
9036 #: dpkg-buildpackage.pod
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)."
9043 #: dpkg-buildpackage.pod
9044 msgid "B<--force-sign>"
9048 #: dpkg-buildpackage.pod
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."
9056 #: dpkg-buildpackage.pod dpkg-source.pod
9061 #: dpkg-buildpackage.pod dpkg-source.pod
9066 #: dpkg-buildpackage.pod
9071 #: dpkg-buildpackage.pod dpkg-source.pod
9076 #: dpkg-buildpackage.pod dpkg-source.pod
9081 #: dpkg-buildpackage.pod dpkg-source.pod
9086 #: dpkg-buildpackage.pod
9091 #: dpkg-buildpackage.pod
9096 #: dpkg-buildpackage.pod
9101 #: dpkg-buildpackage.pod
9102 msgid "B<-i>, B<--diff-ignore>[=I<regex>]"
9106 #: dpkg-buildpackage.pod
9107 msgid "B<-I>, B<--tar-ignore>[=I<pattern>]"
9111 #: dpkg-buildpackage.pod
9112 msgid "B<-z>, B<--compression-level=>I<level>"
9116 #: dpkg-buildpackage.pod
9117 msgid "B<-Z>, B<--compression=>I<compressor>"
9121 #: dpkg-buildpackage.pod
9122 msgid "Passed unchanged to B<dpkg-source>. See its manual page."
9126 #: dpkg-buildpackage.pod
9127 msgid "B<--source-option=>I<opt>"
9131 #: dpkg-buildpackage.pod
9133 "Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6). Can be used "
9138 #: dpkg-buildpackage.pod
9139 msgid "B<--changes-file=>I<filename>"
9143 #: dpkg-buildpackage.pod
9144 msgid "Set the I<filename> for the generated B<.changes> file (since dpkg 1.21.0)."
9148 #: dpkg-buildpackage.pod
9149 msgid "B<--changes-option=>I<opt>"
9153 #: dpkg-buildpackage.pod
9155 "Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6). Can be used "
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>"
9166 #: dpkg-buildpackage.pod
9167 msgid "B<--admindir> I<dir>"
9171 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod dpkg-shlibdeps.pod
9173 "Change the location of the B<dpkg> database (since dpkg 1.14.0). The "
9174 "default location is I<%ADMINDIR%>."
9178 #: dpkg-buildpackage.pod dpkg-query.pod dpkg.pod
9179 msgid "External environment"
9183 #: dpkg-buildpackage.pod
9184 msgid "B<DEB_CHECK_COMMAND>"
9188 #: dpkg-buildpackage.pod
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."
9195 #: dpkg-buildpackage.pod
9196 msgid "B<DEB_SIGN_KEYID>"
9200 #: dpkg-buildpackage.pod
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."
9207 #: dpkg-buildpackage.pod
9208 msgid "B<DEB_SIGN_KEYFILE>"
9212 #: dpkg-buildpackage.pod
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."
9219 #: dpkg-buildpackage.pod
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 "
9227 #: dpkg-buildpackage.pod
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."
9235 #: dpkg-buildpackage.pod dpkg-checkbuilddeps.pod
9236 msgid "B<DEB_BUILD_PROFILES>"
9240 #: dpkg-buildpackage.pod
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."
9248 #: dpkg-buildpackage.pod dpkg-query.pod dpkg.pod
9249 msgid "Internal environment"
9253 #: dpkg-buildpackage.pod
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."
9262 #: dpkg-buildpackage.pod
9263 msgid "B<DEB_BUILD_*>"
9267 #: dpkg-buildpackage.pod
9268 msgid "B<DEB_HOST_*>"
9272 #: dpkg-buildpackage.pod
9273 msgid "B<DEB_TARGET_*>"
9277 #: dpkg-buildpackage.pod
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."
9285 #: dpkg-buildpackage.pod
9286 msgid "B<DEB_RULES_REQUIRES_ROOT>"
9290 #: dpkg-buildpackage.pod
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."
9299 #: dpkg-buildpackage.pod
9300 msgid "B<DEB_GAIN_ROOT_CMD>"
9304 #: dpkg-buildpackage.pod
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>."
9312 #: dpkg-buildpackage.pod dpkg-deb.pod dpkg-source.pod dpkg-split.pod
9313 msgid "B<SOURCE_DATE_EPOCH>"
9317 #: dpkg-buildpackage.pod
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."
9324 #: dpkg-buildpackage.pod
9325 msgid "I<%PKGCONFDIR%/buildpackage.conf>"
9329 #: dpkg-buildpackage.pod
9330 msgid "System wide configuration file"
9334 #: dpkg-buildpackage.pod
9335 msgid "I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or"
9339 #: dpkg-buildpackage.pod
9340 msgid "I<$HOME/.config/dpkg/buildpackage.conf>"
9344 #: dpkg-buildpackage.pod
9345 msgid "Compiler flags are no longer exported"
9349 #: dpkg-buildpackage.pod
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."
9357 #: dpkg-buildpackage.pod
9358 msgid "Default build targets"
9362 #: dpkg-buildpackage.pod
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."
9373 #: dpkg-buildpackage.pod
9375 "It should be possible to specify spaces and shell metacharacters and initial "
9376 "arguments for I<gain-root-command> and I<sign-command>."
9380 #: dpkg-buildpackage.pod
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)."
9390 #: dpkg-checkbuilddeps.pod
9391 msgid "dpkg-checkbuilddeps - check build dependencies and conflicts"
9395 #: dpkg-checkbuilddeps.pod
9396 msgid "B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]"
9400 #: dpkg-checkbuilddeps.pod
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."
9408 #: dpkg-checkbuilddeps.pod
9410 "By default, B<debian/control> is read, but an alternate control filename may "
9411 "be specified on the command line."
9415 #: dpkg-checkbuilddeps.pod
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."
9423 #: dpkg-checkbuilddeps.pod
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."
9431 #: dpkg-checkbuilddeps.pod
9436 #: dpkg-checkbuilddeps.pod
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."
9444 #: dpkg-checkbuilddeps.pod
9445 msgid "B<-d> I<build-depends-string>"
9449 #: dpkg-checkbuilddeps.pod
9450 msgid "B<-c> I<build-conflicts-string>"
9454 #: dpkg-checkbuilddeps.pod
9456 "Use the given build dependencies/conflicts instead of those contained in the "
9457 "I<debian/control> file (since dpkg 1.14.17)."
9461 #: dpkg-checkbuilddeps.pod
9462 msgid "B<-a> I<arch>"
9466 #: dpkg-checkbuilddeps.pod
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)."
9474 #: dpkg-checkbuilddeps.pod
9475 msgid "B<-P> I<profile>[B<,>...]"
9479 #: dpkg-checkbuilddeps.pod
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."
9487 #: dpkg-checkbuilddeps.pod
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 "
9496 msgid "dpkg-deb - Debian package archive (.deb) manipulation tool"
9501 msgid "B<dpkg-deb> [I<option>...] I<command>"
9506 msgid "B<dpkg-deb> packs, unpacks and provides information about Debian archives."
9511 msgid "Use B<dpkg> to install and remove packages from your system."
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."
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."
9533 msgid "B<-b>, B<--build> I<binary-directory> [I<archive>|I<directory>]"
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."
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."
9560 "If no I<archive> is specified then B<dpkg-deb> will write the package into "
9561 "the file I<binary-directory>B<.deb>."
9566 msgid "If the archive to be created already exists it will be overwritten."
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)."
9581 msgid "B<-I>, B<--info> I<archive> [I<control-file-name>...]"
9586 msgid "Provides information about a binary package archive."
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."
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 "
9607 msgid "B<-W>, B<--show> I<archive>"
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."
9620 msgid "B<-f>, B<--field> I<archive> [I<control-field-name>...]"
9625 msgid "Extracts control file information from a binary package archive."
9631 "If no I<control-field-name>s are specified then it will print the whole "
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)."
9646 msgid "No errors are reported for fields requested but not found."
9650 #: dpkg-deb.pod dpkg.pod
9651 msgid "B<-c>, B<--contents> I<archive>"
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 "
9663 #: dpkg-deb.pod dpkg.pod
9664 msgid "B<-x>, B<--extract> I<archive> I<directory>"
9670 "Extracts the filesystem tree from a package archive into the specified "
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."
9684 "I<directory> (but not its parents) will be created if necessary, and its "
9685 "permissions modified to match the contents of the package."
9689 #: dpkg-deb.pod dpkg.pod
9690 msgid "B<-X>, B<--vextract> I<archive> I<directory>"
9696 "Is like B<--extract> (B<-x>) with B<--verbose> (B<-v>) which prints a "
9697 "listing of the files extracted as it goes."
9702 msgid "B<-R>, B<--raw-extract> I<archive> I<directory>"
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)."
9715 msgid "The target directory (but not its parents) will be created if necessary."
9721 "The input archive is not (currently) processed sequentially, so reading it "
9722 "from standard input («B<->») is B<not> supported."
9726 #: dpkg-deb.pod dpkg.pod
9727 msgid "B<--ctrl-tarfile> I<archive>"
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."
9740 #: dpkg-deb.pod dpkg.pod
9741 msgid "B<--fsys-tarfile> I<archive>"
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."
9754 #: dpkg-deb.pod dpkg.pod
9755 msgid "B<-e>, B<--control> I<archive> [I<directory>]"
9761 "Extracts the control information files from a package archive into the "
9762 "specified directory."
9768 "If no directory is specified then a subdirectory B<DEBIAN> in the current "
9769 "directory is used."
9774 msgid "B<--showformat=>I<format>"
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."
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)."
9796 msgid "The default for this field is “${Package}\\t${Version}\\n”."
9801 msgid "B<-z>I<compress-level>"
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."
9817 msgid "B<-S>I<compress-strategy>"
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."
9831 msgid "B<-Z>I<compress-type>"
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>)."
9844 msgid "B<--[no-]uniform-compression>"
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 "
9860 #: dpkg-deb.pod dpkg-source.pod
9861 msgid "B<--threads-max=>I<threads>"
9867 "Sets the maximum number of threads allowed for compressors that support "
9868 "multi-threaded operations (since dpkg 1.21.9)."
9873 msgid "B<--root-owner-group>"
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)."
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."
9894 msgid "B<--deb-format=>I<format>"
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>)."
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 "
9916 msgid "B<--nocheck>"
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."
9927 #: dpkg-deb.pod start-stop-daemon.pod
9928 msgid "B<-v>, B<--verbose>"
9934 "Enables verbose output (since dpkg 1.16.1). This currently only affects "
9935 "B<--extract> making it behave like B<--vextract>."
9940 msgid "B<-D>, B<--debug>"
9945 msgid "Enables debugging output. This is not very interesting."
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
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
9963 #: dpkg-deb.pod dpkg-divert.pod dpkg-statoverride.pod update-alternatives.pod
9964 msgid "The requested action was successfully performed."
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
9975 #: dpkg-deb.pod dpkg-divert.pod dpkg-query.pod dpkg-statoverride.pod
9976 #: dpkg-trigger.pod dpkg.pod dselect.pod
9978 "Fatal or unrecoverable error due to invalid command-line usage, or "
9979 "interactions with the system, such as accesses to the database, memory "
9985 msgid "B<DPKG_DEB_THREADS_MAX>"
9990 msgid "The B<--threads-max> option overrides this value."
9995 msgid "B<DPKG_DEB_COMPRESSOR_TYPE>"
10000 msgid "Sets the compressor type to use (since dpkg 1.21.10)."
10005 msgid "The B<-Z> option overrides this value."
10010 msgid "B<DPKG_DEB_COMPRESSOR_LEVEL>"
10015 msgid "Sets the compressor level to use (since dpkg 1.21.10)."
10020 msgid "The B<-z> option overrides this value."
10024 #: dpkg-deb.pod dpkg.pod
10031 "If set, B<dpkg-deb> will use it as the directory in which to create "
10032 "temporary files and directories."
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) "
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."
10053 msgid "B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing."
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 "
10070 "F<%PKGDOCDIR%/spec/rootless-builds.txt>, B<deb>(5), B<deb-control>(5), "
10071 "B<dpkg>(1), B<dselect>(1)."
10075 #: dpkg-distaddfile.pod
10076 msgid "dpkg-distaddfile - add entries to debian/files"
10080 #: dpkg-distaddfile.pod
10081 msgid "B<dpkg-distaddfile> [I<option>...] I<filename section priority>"
10085 #: dpkg-distaddfile.pod
10086 msgid "B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>."
10090 #: dpkg-distaddfile.pod
10092 "It takes three non-option arguments, the filename and the section and "
10093 "priority for the B<.changes> file."
10097 #: dpkg-distaddfile.pod
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> "
10106 #: dpkg-distaddfile.pod dpkg-genbuildinfo.pod dpkg-genchanges.pod
10107 #: dpkg-gencontrol.pod
10108 msgid "B<-f>I<files-list-file>"
10112 #: dpkg-distaddfile.pod dpkg-gencontrol.pod
10114 "Read or write the list of files to be uploaded here, rather than using "
10119 #: dpkg-distaddfile.pod
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."
10126 #: dpkg-distaddfile.pod
10127 msgid "B<deb-src-files>(5)."
10132 msgid "dpkg-divert - override a package's version of a file"
10137 msgid "B<dpkg-divert> [I<option>...] I<command>"
10143 "B<dpkg-divert> is the utility used to set up and update the list of "
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."
10161 msgid "[B<--add>] I<file>"
10167 "Add a diversion for I<file>. The file is currently not renamed, see "
10173 msgid "B<--remove> I<file>"
10179 "Remove a diversion for I<file>. The file is currently not renamed, see "
10184 #: dpkg-divert.pod dpkg-statoverride.pod
10185 msgid "B<--list> [I<glob-pattern>]"
10190 msgid "List all diversions, or ones matching I<glob-pattern>."
10195 msgid "B<--listpackage> I<file>"
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 "
10208 msgid "B<--truename> I<file>"
10213 msgid "Print the real name for a diverted file."
10217 #: dpkg-divert.pod dpkg-split.pod dpkg-statoverride.pod dselect.pod
10218 #: update-alternatives.pod
10219 msgid "B<--admindir> I<directory>"
10225 "Set the administrative directory to I<directory>. Defaults to "
10226 "«I<%ADMINDIR%>» if B<DPKG_ADMINDIR> has not been set."
10230 #: dpkg-divert.pod dpkg-realpath.pod dpkg-statoverride.pod dselect.pod
10231 #: update-alternatives.pod
10232 msgid "B<--instdir> I<directory>"
10236 #: dpkg-divert.pod dpkg-statoverride.pod
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 "
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>"
10250 #: dpkg-divert.pod dpkg-statoverride.pod
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 "
10260 msgid "B<--divert> I<divert-to>"
10266 "I<divert-to> is the location where the versions of I<file>, as provided by "
10267 "other packages, will be diverted."
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 "
10286 msgid "B<--package> I<package>"
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>."
10297 #: dpkg-divert.pod dpkg-statoverride.pod update-alternatives.pod
10303 msgid "Quiet mode, i.e. no verbose output."
10308 msgid "B<--rename>"
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)."
10322 msgid "B<--no-rename>"
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."
10343 msgid "Test mode, i.e. don't actually perform any changes, just demonstrate."
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>"
10353 #: dpkg-divert.pod dpkg-statoverride.pod
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)."
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>"
10366 #: dpkg-divert.pod dpkg-statoverride.pod
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."
10373 #: dpkg-divert.pod dpkg.pod
10374 msgid "B<DPKG_MAINTSCRIPT_PACKAGE>"
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."
10385 #: dpkg-divert.pod dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod
10386 #: dpkg-trigger.pod dpkg.pod
10387 msgid "B<DPKG_DEBUG>"
10391 #: dpkg-divert.pod dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod
10392 #: dpkg-trigger.pod
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."
10401 msgid "I<%ADMINDIR%/diversions>"
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>."
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."
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."
10429 msgid "Directories can't be diverted with B<dpkg-divert>."
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."
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:"
10454 " dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example\n"
10460 msgid "To remove that diversion:"
10467 " dpkg-divert --rename --remove /usr/bin/example\n"
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:"
10482 " dpkg-divert --package wibble --divert /usr/bin/example.foo \\\n"
10483 " --rename /usr/bin/example\n"
10491 " dpkg-divert --package wibble --rename --remove /usr/bin/example\n"
10496 #: dpkg-fsys-usrunmess.pod
10497 msgid "dpkg-fsys-usrunmess - undoes the merged-/usr-via-aliased-dirs mess"
10501 #: dpkg-fsys-usrunmess.pod
10502 msgid "B<dpkg-fsys-usrunmess> [B<option>...]"
10506 #: dpkg-fsys-usrunmess.pod
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."
10515 #: dpkg-fsys-usrunmess.pod
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."
10524 #: dpkg-fsys-usrunmess.pod
10525 msgid "The program will perform the following overall actions:"
10529 #: dpkg-fsys-usrunmess.pod
10530 msgid "Check whether the system needs to be switched, otherwise do nothing,"
10534 #: dpkg-fsys-usrunmess.pod
10535 msgid "Check for dpkg database consistency and otherwise abort."
10539 #: dpkg-fsys-usrunmess.pod
10541 "Generate and install a regression prevention package, if requested on the "
10542 "command-line or otherwise on the prompt."
10546 #: dpkg-fsys-usrunmess.pod
10547 msgid "Get the list of files and alternatives that need to be restored."
10551 #: dpkg-fsys-usrunmess.pod
10552 msgid "Look for untracked kernel modules files that need to be moved too."
10556 #: dpkg-fsys-usrunmess.pod
10558 "Create a shadow hierarchy under F</.usrunmess>, by creating the directories "
10559 "symlinks or hardlinking or copying the files as needed."
10563 #: dpkg-fsys-usrunmess.pod
10564 msgid "Prompt for confirmation before proceeding, if requested on the command-line."
10568 #: dpkg-fsys-usrunmess.pod
10569 msgid "Lock the dpkg database."
10573 #: dpkg-fsys-usrunmess.pod
10575 "Mark all packages as half-configured to force running maintainer scripts "
10576 "that might need to recreate files."
10580 #: dpkg-fsys-usrunmess.pod
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."
10587 #: dpkg-fsys-usrunmess.pod
10588 msgid "Relabel MAC information for directories and symlinks if necessary."
10592 #: dpkg-fsys-usrunmess.pod
10593 msgid "Remove backup symlinks."
10597 #: dpkg-fsys-usrunmess.pod
10598 msgid "Remove old moved objects, but defer directory removal."
10602 #: dpkg-fsys-usrunmess.pod
10603 msgid "Remove old deferred directories that are not referenced by dpkg-query."
10607 #: dpkg-fsys-usrunmess.pod
10608 msgid "Remove shadow root directory."
10612 #: dpkg-fsys-usrunmess.pod
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."
10619 #: dpkg-fsys-usrunmess.pod
10620 msgid "Reconfigure all packages."
10624 #: dpkg-fsys-usrunmess.pod
10625 msgid "Unregister the B<policy-rc.d> and restore the alternatives state."
10629 #: dpkg-fsys-usrunmess.pod
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>."
10637 #: dpkg-fsys-usrunmess.pod
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."
10645 #: dpkg-fsys-usrunmess.pod
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."
10654 #: dpkg-fsys-usrunmess.pod
10655 msgid "B<-p>, B<--prompt>"
10659 #: dpkg-fsys-usrunmess.pod
10661 "Prompt at the time of no return, so that the debug output or the shadow "
10662 "hierarchy can be evaluated before proceeding."
10666 #: dpkg-fsys-usrunmess.pod
10667 msgid "B<--prevention>"
10671 #: dpkg-fsys-usrunmess.pod
10672 msgid "B<--no-prevention>"
10676 #: dpkg-fsys-usrunmess.pod
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."
10684 #: dpkg-fsys-usrunmess.pod
10686 "The generated package contains the B<Protected> field set to B<yes> to "
10687 "protect against accidental removal of the package."
10691 #: dpkg-fsys-usrunmess.pod
10692 msgid "B<-n>, B<--no-act>"
10696 #: dpkg-fsys-usrunmess.pod
10697 msgid "B<--dry-run>"
10701 #: dpkg-fsys-usrunmess.pod
10703 "This option enables the dry-run mode, where no destructive action takes "
10704 "place, only the preparatory part."
10708 #: dpkg-fsys-usrunmess.pod
10709 msgid "B<DPKG_USRUNMESS_NOACT>"
10713 #: dpkg-fsys-usrunmess.pod
10714 msgid "This setting defines whether to enable dry-run mode."
10718 #: dpkg-fsys-usrunmess.pod
10719 msgid "L<https://wiki.debian.org/Teams/Dpkg/FAQ#broken-usrmerge>."
10723 #: dpkg-genbuildinfo.pod
10724 msgid "dpkg-genbuildinfo - generate Debian .buildinfo files"
10728 #: dpkg-genbuildinfo.pod
10729 msgid "B<dpkg-genbuildinfo> [I<option>...]"
10733 #: dpkg-genbuildinfo.pod
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)."
10742 #: dpkg-genbuildinfo.pod
10743 msgid "This command was introduced in dpkg 1.18.11."
10747 #: dpkg-genbuildinfo.pod
10748 msgid "Specifies the build I<type> from a comma-separated list of components."
10752 #: dpkg-genbuildinfo.pod
10754 "Generate build information including unqualified build dependencies "
10755 "(B<Build-Depends>) and architecture specific build dependencies "
10756 "(B<Build-Depends-Arch>)."
10760 #: dpkg-genbuildinfo.pod
10762 "Generate build information including unqualified build dependencies "
10763 "(B<Build-Depends>) and architecture independent build dependencies "
10764 "(B<Build-Depends-Indep>)."
10768 #: dpkg-genbuildinfo.pod
10770 "Effectively ignored; generate build information with just the unqualified "
10771 "build dependencies (B<Build-Depends>)."
10775 #: dpkg-genbuildinfo.pod
10777 "Generate build information with all three types of build dependencies. This "
10778 "is an alias for B<any,all>."
10782 #: dpkg-genbuildinfo.pod
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."
10790 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod
10791 msgid "B<-c>I<controlfile>"
10795 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10797 "Specifies the main source control file to read information from. The default "
10798 "is B<debian/control>."
10802 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10804 msgid "B<-l>I<changelog-file>"
10808 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10810 "Specifies the changelog file to read information from. The default is "
10811 "B<debian/changelog>."
10815 #: dpkg-genbuildinfo.pod
10817 "Specifies where is the list of files that have been produced by the build, "
10818 "rather than using B<debian/files>."
10822 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10824 msgid "B<-F>I<changelog-format>"
10828 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10831 "Specifies the format of the changelog. See B<dpkg-parsechangelog>(1) for "
10832 "information about alternative formats."
10836 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gencontrol.pod
10837 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
10838 msgid "B<-O>[I<filename>]"
10842 #: dpkg-genbuildinfo.pod
10844 "Print the buildinfo file to standard output (or I<filename> if specified) "
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)."
10851 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod
10852 msgid "B<-u>I<upload-files-dir>"
10856 #: dpkg-genbuildinfo.pod
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)."
10864 #: dpkg-genbuildinfo.pod
10865 msgid "B<--always-include-kernel>"
10869 #: dpkg-genbuildinfo.pod
10870 msgid "By default, the B<Build-Kernel-Version> field will not be written out."
10874 #: dpkg-genbuildinfo.pod
10876 "Specify this option (since dpkg 1.19.0) to always write a "
10877 "B<Build-Kernel-Version> field when generating the B<.buildinfo>."
10881 #: dpkg-genbuildinfo.pod
10882 msgid "B<--always-include-path>"
10886 #: dpkg-genbuildinfo.pod
10888 "By default, the B<Build-Path> field will only be written if the current "
10889 "directory starts with an allowed pattern."
10893 #: dpkg-genbuildinfo.pod
10895 "On Debian and derivatives the pattern matches on B</build/> at the start of "
10900 #: dpkg-genbuildinfo.pod
10902 "Specify this option to always write a B<Build-Path> field when generating "
10903 "the B<.buildinfo>."
10907 #: dpkg-genbuildinfo.pod
10909 "Change the location of the B<dpkg> database. The default location is "
10910 "I</var/lib/dpkg>."
10914 #: dpkg-genbuildinfo.pod dpkg-genchanges.pod dpkg-gensymbols.pod
10920 #: dpkg-genbuildinfo.pod
10922 "B<dpkg-genbuildinfo> might produce informative messages on standard error. "
10923 "B<-q> suppresses these messages."
10927 #: dpkg-genbuildinfo.pod
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."
10939 #: dpkg-genbuildinfo.pod
10941 "The list of generated files. B<dpkg-genbuildinfo> reads the data here when "
10942 "producing a B<.buildinfo> file."
10946 #: dpkg-genbuildinfo.pod
10947 msgid "B<deb-buildinfo>(5)."
10951 #: dpkg-genchanges.pod
10952 msgid "dpkg-genchanges - generate Debian .changes files"
10956 #: dpkg-genchanges.pod
10957 msgid "B<dpkg-genchanges> [I<option>...]"
10961 #: dpkg-genchanges.pod
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)."
10969 #: dpkg-genchanges.pod
10971 "Specifies the build I<type> from a comma-separated list of components (since "
10976 #: dpkg-genchanges.pod
10977 msgid "Upload the source package."
10981 #: dpkg-genchanges.pod
10982 msgid "Upload the architecture specific binary packages."
10986 #: dpkg-genchanges.pod
10987 msgid "Upload the architecture independent binary packages."
10991 #: dpkg-genchanges.pod
10993 "Upload the architecture specific and independent binary packages. This is "
10994 "an alias for B<any,all>."
10998 #: dpkg-genchanges.pod
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."
11005 #: dpkg-genchanges.pod
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)."
11013 #: dpkg-genchanges.pod
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 "
11022 #: dpkg-genchanges.pod
11023 msgid "Forces the inclusion of the original source."
11027 #: dpkg-genchanges.pod
11028 msgid "Forces the exclusion of the original source and includes only the diff."
11032 #: dpkg-genchanges.pod
11034 "Causes changelog information from all versions strictly later than "
11035 "I<version> to be used."
11039 #: dpkg-genchanges.pod
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."
11046 #: dpkg-genchanges.pod
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 "
11054 #: dpkg-genchanges.pod
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 "
11062 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11063 msgid "B<-V>I<name>B<=>I<value>"
11067 #: dpkg-genchanges.pod dpkg-source.pod
11069 "Set an output substitution variable. See B<deb-substvars>(5) for a "
11070 "discussion of output substitution."
11074 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-shlibdeps.pod dpkg-source.pod
11075 msgid "B<-T>I<substvars-file>"
11079 #: dpkg-genchanges.pod
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 "
11091 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11092 msgid "B<-D>I<field>B<=>I<value>"
11096 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11097 msgid "Override or add an output control file field."
11101 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11102 msgid "B<-U>I<field>"
11106 #: dpkg-genchanges.pod dpkg-gencontrol.pod dpkg-source.pod
11107 msgid "Remove an output control file field."
11111 #: dpkg-genchanges.pod
11113 "Read the list of files to be uploaded here, rather than using "
11118 #: dpkg-genchanges.pod
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)."
11126 #: dpkg-genchanges.pod
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."
11134 #: dpkg-genchanges.pod
11136 "Print the changes file to standard output (the default) or to I<filename> if "
11137 "specified (since dpkg 1.18.5)."
11141 #: dpkg-genchanges.pod
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."
11148 #: dpkg-genchanges.pod
11150 "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-src-files>(5), "
11151 "B<deb-changelog>(5), B<deb-changes>(5)."
11155 #: dpkg-gencontrol.pod
11156 msgid "dpkg-gencontrol - generate Debian control files"
11160 #: dpkg-gencontrol.pod
11161 msgid "B<dpkg-gencontrol> [I<option>...]"
11165 #: dpkg-gencontrol.pod
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 "
11174 #: dpkg-gencontrol.pod
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."
11188 #: dpkg-gencontrol.pod
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 "
11197 #: dpkg-gencontrol.pod
11199 "B<dpkg-gencontrol> also adds an entry for the binary package to "
11204 #: dpkg-gencontrol.pod
11205 msgid "Sets the version number of the binary package which will be generated."
11209 #: dpkg-gencontrol.pod
11211 "Set an output substitution variable. See B<deb-substvars>(5) for discussion "
11212 "of output substitution."
11216 #: dpkg-gencontrol.pod
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)."
11224 #: dpkg-gencontrol.pod dpkg-source.pod
11225 msgid "B<-c>I<control-file>"
11229 #: dpkg-gencontrol.pod dpkg-gensymbols.pod
11230 msgid "B<-p>I<package>"
11234 #: dpkg-gencontrol.pod
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 "
11243 #: dpkg-gencontrol.pod
11244 msgid "B<-n>I<filename>"
11248 #: dpkg-gencontrol.pod
11250 "Assume the filename of the package will be I<filename> instead of the normal "
11251 "package_version_arch.deb filename."
11255 #: dpkg-gencontrol.pod
11256 msgid "B<-is>, B<-ip>, B<-isp>"
11260 #: dpkg-gencontrol.pod
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 "
11271 #: dpkg-gencontrol.pod dpkg-gensymbols.pod
11272 msgid "B<-P>I<package-build-dir>"
11276 #: dpkg-gencontrol.pod
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."
11284 #: dpkg-gencontrol.pod
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)."
11292 #: dpkg-gencontrol.pod
11294 "The main source control information file, giving version-independent "
11295 "information about the source package and the binary packages it can produce."
11299 #: dpkg-gencontrol.pod
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."
11307 #: dpkg-gencontrol.pod
11309 "B<deb-substvars>(5), B<deb-src-control>(5), B<deb-changelog>(5), "
11310 "B<deb-control>(5)."
11314 #: dpkg-gensymbols.pod
11316 "dpkg-gensymbols - generate symbols files (shared library dependency "
11321 #: dpkg-gensymbols.pod
11322 msgid "B<dpkg-gensymbols> [I<option>...]"
11326 #: dpkg-gensymbols.pod
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 "
11336 #: dpkg-gensymbols.pod
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 "
11344 #: dpkg-gensymbols.pod
11345 msgid "debian/I<package>.symbols.I<arch>"
11349 #: dpkg-gensymbols.pod
11350 msgid "debian/symbols.I<arch>"
11354 #: dpkg-gensymbols.pod
11355 msgid "debian/I<package>.symbols"
11359 #: dpkg-gensymbols.pod
11360 msgid "debian/symbols"
11364 #: dpkg-gensymbols.pod
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."
11376 #: dpkg-gensymbols.pod
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)."
11385 #: dpkg-gensymbols.pod
11386 msgid "MAINTAINING SYMBOLS FILES"
11390 #: dpkg-gensymbols.pod
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 "
11400 #: dpkg-gensymbols.pod
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 "
11409 #: dpkg-gensymbols.pod
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 "
11419 #: dpkg-gensymbols.pod
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<~>’."
11431 #: dpkg-gensymbols.pod
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."
11439 #: dpkg-gensymbols.pod
11440 msgid "Note that you can put comments in symbols files."
11444 #: dpkg-gensymbols.pod
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."
11455 #: dpkg-gensymbols.pod
11456 msgid "Good library management"
11460 #: dpkg-gensymbols.pod
11461 msgid "A well-maintained library has the following features:"
11465 #: dpkg-gensymbols.pod
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;"
11472 #: dpkg-gensymbols.pod
11474 "ideally, it uses symbol versioning to achieve ABI stability despite internal "
11475 "changes and API extension;"
11479 #: dpkg-gensymbols.pod
11481 "it doesn't export private symbols (such symbols can be tagged optional as "
11486 #: dpkg-gensymbols.pod
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."
11498 #: dpkg-gensymbols.pod
11499 msgid "Scan I<package-build-dir> instead of debian/tmp."
11503 #: dpkg-gensymbols.pod
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)."
11510 #: dpkg-gensymbols.pod
11512 "Define the package version. Defaults to the version extracted from "
11513 "debian/changelog. Required if called outside of a source package tree."
11517 #: dpkg-gensymbols.pod
11518 msgid "B<-e>I<library-file>"
11522 #: dpkg-gensymbols.pod
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 "
11532 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
11533 msgid "B<-l>I<directory>"
11537 #: dpkg-gensymbols.pod
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."
11544 #: dpkg-gensymbols.pod dpkg-shlibdeps.pod
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."
11553 #: dpkg-gensymbols.pod
11554 msgid "B<-I>I<filename>"
11558 #: dpkg-gensymbols.pod
11560 "Use I<filename> as reference file to generate the symbols file that is "
11561 "integrated in the package itself."
11565 #: dpkg-gensymbols.pod
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."
11576 #: dpkg-gensymbols.pod
11581 #: dpkg-gensymbols.pod
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."
11593 #: dpkg-gensymbols.pod
11594 msgid "B<-c>I<[0-4]>"
11598 #: dpkg-gensymbols.pod
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."
11606 #: dpkg-gensymbols.pod
11611 #: dpkg-gensymbols.pod
11612 msgid "Never fails."
11616 #: dpkg-gensymbols.pod
11621 #: dpkg-gensymbols.pod
11622 msgid "Fails if some symbols have disappeared."
11626 #: dpkg-gensymbols.pod
11631 #: dpkg-gensymbols.pod
11632 msgid "Fails if some new symbols have been introduced."
11636 #: dpkg-gensymbols.pod
11641 #: dpkg-gensymbols.pod
11642 msgid "Fails if some libraries have disappeared."
11646 #: dpkg-gensymbols.pod
11651 #: dpkg-gensymbols.pod
11652 msgid "Fails if some libraries have been introduced."
11656 #: dpkg-gensymbols.pod
11658 "This value can be overridden by the environment variable "
11659 "B<DPKG_GENSYMBOLS_CHECK_LEVEL>."
11663 #: dpkg-gensymbols.pod
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)."
11672 #: dpkg-gensymbols.pod
11673 msgid "B<-a>I<arch>"
11677 #: dpkg-gensymbols.pod
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."
11685 #: dpkg-gensymbols.pod
11690 #: dpkg-gensymbols.pod
11692 "Enable debug mode. Numerous messages are displayed to explain what "
11693 "B<dpkg-gensymbols> does."
11697 #: dpkg-gensymbols.pod
11702 #: dpkg-gensymbols.pod
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."
11710 #: dpkg-gensymbols.pod
11711 msgid "B<DPKG_GENSYMBOLS_CHECK_LEVEL>"
11715 #: dpkg-gensymbols.pod
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)."
11723 #: dpkg-gensymbols.pod
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)."
11732 #: dpkg-maintscript-helper.pod
11734 "dpkg-maintscript-helper - works around known dpkg limitations in maintainer "
11739 #: dpkg-maintscript-helper.pod
11741 "B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> "
11742 "I<maint-script-parameter>..."
11746 #: dpkg-maintscript-helper.pod
11747 msgid "COMMANDS AND PARAMETERS"
11751 #: dpkg-maintscript-helper.pod
11752 msgid "B<supports> I<command>"
11756 #: dpkg-maintscript-helper.pod
11757 msgid "B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]"
11761 #: dpkg-maintscript-helper.pod
11763 "B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> "
11768 #: dpkg-maintscript-helper.pod
11769 msgid "B<symlink_to_dir> I<pathname> I<old-target> [I<prior-version> [I<package>]]"
11773 #: dpkg-maintscript-helper.pod
11774 msgid "B<dir_to_symlink> I<pathname> I<new-target> [I<prior-version> [I<package>]]"
11778 #: dpkg-maintscript-helper.pod
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."
11786 #: dpkg-maintscript-helper.pod
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."
11797 #: dpkg-maintscript-helper.pod
11798 msgid "COMMON PARAMETERS"
11802 #: dpkg-maintscript-helper.pod
11803 msgid "I<prior-version>"
11807 #: dpkg-maintscript-helper.pod
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)."
11818 #: dpkg-maintscript-helper.pod
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."
11828 #: dpkg-maintscript-helper.pod
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~>."
11840 #: dpkg-maintscript-helper.pod
11845 #: dpkg-maintscript-helper.pod
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."
11858 #: dpkg-maintscript-helper.pod
11863 #: dpkg-maintscript-helper.pod
11865 "All the parameters of the maintainer scripts have to be forwarded to the "
11866 "program after B<-->."
11870 #: dpkg-maintscript-helper.pod
11871 msgid "CONFFILE RELATED TASKS"
11875 #: dpkg-maintscript-helper.pod
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."
11888 #: dpkg-maintscript-helper.pod
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 "
11897 #: dpkg-maintscript-helper.pod
11898 msgid "Removing a conffile"
11902 #: dpkg-maintscript-helper.pod
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)>."
11909 #: dpkg-maintscript-helper.pod
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."
11918 #: dpkg-maintscript-helper.pod
11920 "All of this is implemented by putting the following shell snippet in the "
11921 "B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
11925 #: dpkg-maintscript-helper.pod
11929 " dpkg-maintscript-helper rm_conffile \\\n"
11930 " I<conffile> I<prior-version> I<package> -- \"$@\"\n"
11935 #: dpkg-maintscript-helper.pod
11936 msgid "I<conffile> is the filename of the conffile to remove."
11940 #: dpkg-maintscript-helper.pod
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."
11953 #: dpkg-maintscript-helper.pod
11954 msgid "Renaming a conffile"
11958 #: dpkg-maintscript-helper.pod
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."
11968 #: dpkg-maintscript-helper.pod
11970 "Graceful renaming can be implemented by putting the following shell snippet "
11971 "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
11975 #: dpkg-maintscript-helper.pod
11979 " dpkg-maintscript-helper mv_conffile \\\n"
11980 " I<old-conffile> I<new-conffile> I<prior-version> I<package> -- \"$@\"\n"
11985 #: dpkg-maintscript-helper.pod
11987 "I<old-conffile> and I<new-conffile> are the old and new name of the conffile "
11992 #: dpkg-maintscript-helper.pod
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."
12004 #: dpkg-maintscript-helper.pod
12005 msgid "SYMLINK AND DIRECTORY SWITCHES"
12009 #: dpkg-maintscript-helper.pod
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 "
12017 #: dpkg-maintscript-helper.pod
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 "
12025 #: dpkg-maintscript-helper.pod
12026 msgid "Switching a symlink to directory"
12030 #: dpkg-maintscript-helper.pod
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 "
12040 #: dpkg-maintscript-helper.pod
12044 " dpkg-maintscript-helper symlink_to_dir \\\n"
12045 " I<pathname> I<old-target> I<prior-version> I<package> -- \"$@\"\n"
12050 #: dpkg-maintscript-helper.pod
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>."
12059 #: dpkg-maintscript-helper.pod
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."
12070 #: dpkg-maintscript-helper.pod
12071 msgid "Switching a directory to symlink"
12075 #: dpkg-maintscript-helper.pod
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."
12085 #: dpkg-maintscript-helper.pod
12087 "Graceful switching can be implemented by putting the following shell snippet "
12088 "in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:"
12092 #: dpkg-maintscript-helper.pod
12096 " dpkg-maintscript-helper dir_to_symlink \\\n"
12097 " I<pathname> I<new-target> I<prior-version> I<package> -- \"$@\"\n"
12102 #: dpkg-maintscript-helper.pod
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>."
12111 #: dpkg-maintscript-helper.pod
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."
12128 #: dpkg-maintscript-helper.pod
12129 msgid "INTEGRATION IN PACKAGES"
12133 #: dpkg-maintscript-helper.pod
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)."
12141 #: dpkg-maintscript-helper.pod
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:"
12151 #: dpkg-maintscript-helper.pod
12154 " Pre-Depends: dpkg (>= 1.17.14)\n"
12159 #: dpkg-maintscript-helper.pod
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 "
12168 #: dpkg-maintscript-helper.pod
12172 " if dpkg-maintscript-helper supports I<command>; then\n"
12173 " dpkg-maintscript-helper I<command> ...\n"
12179 #: dpkg-maintscript-helper.pod
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."
12188 #: dpkg-maintscript-helper.pod
12189 msgid "If set, it will be used as the filesystem root directory."
12193 #: dpkg-maintscript-helper.pod
12194 msgid "If set, it will be used as the B<dpkg> data directory."
12198 #: dpkg-maintscript-helper.pod
12200 "Sets the color mode (since dpkg 1.19.1). The currently accepted values are: "
12201 "B<auto> (default), B<always> and B<never>."
12205 #: dpkg-maintscript-helper.pod
12206 msgid "B<dh_installdeb>(1)."
12210 #: dpkg-mergechangelogs.pod
12211 msgid "dpkg-mergechangelogs - 3-way merge of debian/changelog files"
12215 #: dpkg-mergechangelogs.pod
12216 msgid "B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]"
12220 #: dpkg-mergechangelogs.pod
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."
12228 #: dpkg-mergechangelogs.pod
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)."
12242 #: dpkg-mergechangelogs.pod
12243 msgid "B<--merge-unreleased>"
12247 #: dpkg-mergechangelogs.pod
12249 "Ignore the version number when the entries are marked as B<UNRELEASED> "
12250 "(since dpkg 1.21.0)."
12254 #: dpkg-mergechangelogs.pod
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 "
12264 #: dpkg-mergechangelogs.pod
12265 msgid "B<-m>, B<--merge-prereleases>"
12269 #: dpkg-mergechangelogs.pod
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."
12276 #: dpkg-mergechangelogs.pod
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."
12285 #: dpkg-mergechangelogs.pod
12286 msgid "LIMITATIONS"
12290 #: dpkg-mergechangelogs.pod
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, "
12298 #: dpkg-mergechangelogs.pod
12299 msgid "INTEGRATION WITH GIT"
12303 #: dpkg-mergechangelogs.pod
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>:"
12311 #: dpkg-mergechangelogs.pod
12314 " [merge \"dpkg-mergechangelogs\"]\n"
12315 " name = debian/changelog merge driver\n"
12316 " driver = dpkg-mergechangelogs -m %O %A %B %A\n"
12321 #: dpkg-mergechangelogs.pod
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>:"
12329 #: dpkg-mergechangelogs.pod
12331 msgid " debian/changelog merge=dpkg-mergechangelogs\n"
12336 msgid "dpkg-name - rename Debian packages to full package names"
12341 msgid "B<dpkg-name> [I<option>...] [B<-->] I<file>..."
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>."
12359 msgid "B<-a>, B<--no-architecture>"
12364 msgid "The destination filename will not have the architecture information."
12369 msgid "B<-k>, B<--symlink>"
12374 msgid "Create a symlink, instead of moving."
12379 msgid "B<-o>, B<--overwrite>"
12385 "Existing files will be overwritten if they have the same name as the "
12386 "destination filename."
12391 msgid "B<-s>, B<--subdir> [I<dir>]"
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."
12410 msgid "B<Warning:> I<Use this option with care, it is messy.>"
12415 msgid "B<-c>, B<--create-dir>"
12421 "This option can used together with the B<-s> option. If a target directory "
12422 "isn't found it will be created automatically."
12427 msgid "B<Warning:> I<Use this option with care.>"
12432 msgid "B<-v>, B<--version>"
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."
12447 msgid "B<dpkg-name bar-foo.deb>"
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>)."
12460 msgid "B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>"
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."
12473 msgid "B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>"
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.>"
12485 msgid "B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>"
12490 msgid "This can be used when building new packages."
12496 "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dpkg-deb>(1), B<find>(1), "
12501 #: dpkg-parsechangelog.pod
12502 msgid "dpkg-parsechangelog - parse Debian changelog files"
12506 #: dpkg-parsechangelog.pod
12507 msgid "B<dpkg-parsechangelog> [I<option>...]"
12511 #: dpkg-parsechangelog.pod
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."
12519 #: dpkg-parsechangelog.pod
12520 msgid "B<-l>, B<--file> I<changelog-file>"
12524 #: dpkg-parsechangelog.pod
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>."
12531 #: dpkg-parsechangelog.pod
12532 msgid "B<-F> I<changelog-format>"
12536 #: dpkg-parsechangelog.pod
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>."
12544 #: dpkg-parsechangelog.pod
12545 msgid "B<-L> I<libdir>"
12549 #: dpkg-parsechangelog.pod
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."
12557 #: dpkg-parsechangelog.pod
12558 msgid "B<-S>, B<--show-field> I<field>"
12562 #: dpkg-parsechangelog.pod
12564 "Specifies the name of the field to show (since dpkg 1.17.0). The field name "
12565 "is not printed, only its value."
12569 #: dpkg-parsechangelog.pod
12570 msgid "Parser Options"
12574 #: dpkg-parsechangelog.pod
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."
12581 #: dpkg-parsechangelog.pod
12582 msgid "B<--format> I<output-format>"
12586 #: dpkg-parsechangelog.pod
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:"
12597 #: dpkg-parsechangelog.pod
12598 msgid "B<Source:> I<pkg-name>"
12602 #: dpkg-parsechangelog.pod
12603 msgid "B<Version:> I<version>"
12607 #: dpkg-parsechangelog.pod
12608 msgid "B<Distribution:> I<target-distribution>"
12612 #: dpkg-parsechangelog.pod
12613 msgid "B<Urgency:> I<urgency>"
12617 #: dpkg-parsechangelog.pod
12619 "The highest urgency of all included entries is used, followed by the "
12620 "concatenated (space-separated) comments from all the versions requested."
12624 #: dpkg-parsechangelog.pod
12625 msgid "B<Maintainer:> I<author>"
12629 #: dpkg-parsechangelog.pod
12630 msgid "B<Date:> I<date>"
12634 #: dpkg-parsechangelog.pod
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."
12645 #: dpkg-parsechangelog.pod
12646 msgid "B<Timestamp:> I<timestamp>"
12650 #: dpkg-parsechangelog.pod
12652 "The date of the entry as a timestamp in seconds since the epoch (since dpkg "
12657 #: dpkg-parsechangelog.pod
12658 msgid "B<Closes:> I<bug-number>"
12662 #: dpkg-parsechangelog.pod
12663 msgid "The Closes fields of all included entries are merged."
12667 #: dpkg-parsechangelog.pod
12668 msgid "B<Changes:> I<changelog-entries>"
12672 #: dpkg-parsechangelog.pod
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."
12681 #: dpkg-parsechangelog.pod
12683 "The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> "
12684 "fields are mandatory."
12688 #: dpkg-parsechangelog.pod
12689 msgid "There might be additional user-defined fields present."
12693 #: dpkg-parsechangelog.pod
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."
12700 #: dpkg-parsechangelog.pod
12701 msgid "B<--reverse>"
12705 #: dpkg-parsechangelog.pod
12706 msgid "Include all changes in reverse order (since dpkg 1.19.1)."
12710 #: dpkg-parsechangelog.pod
12712 "B<Note:> For the B<dpkg> format the first entry will be the most ancient "
12717 #: dpkg-parsechangelog.pod update-alternatives.pod
12722 #: dpkg-parsechangelog.pod
12724 "Include all changes. B<Note:> Other options have no effect when this is in "
12729 #: dpkg-parsechangelog.pod
12730 msgid "B<-s>, B<--since> I<version>"
12734 #: dpkg-parsechangelog.pod
12735 msgid "B<-v> I<version>"
12739 #: dpkg-parsechangelog.pod
12740 msgid "Include all changes later than I<version>."
12744 #: dpkg-parsechangelog.pod
12745 msgid "B<-u>, B<--until> I<version>"
12749 #: dpkg-parsechangelog.pod
12750 msgid "Include all changes earlier than I<version>."
12754 #: dpkg-parsechangelog.pod
12755 msgid "B<-f>, B<--from> I<version>"
12759 #: dpkg-parsechangelog.pod
12760 msgid "Include all changes equal or later than I<version>."
12764 #: dpkg-parsechangelog.pod
12765 msgid "B<-t>, B<--to> I<version>"
12769 #: dpkg-parsechangelog.pod
12770 msgid "Include all changes up to or equal than I<version>."
12774 #: dpkg-parsechangelog.pod
12775 msgid "B<-c>, B<--count> I<number>"
12779 #: dpkg-parsechangelog.pod
12780 msgid "B<-n> I<number>"
12784 #: dpkg-parsechangelog.pod
12786 "Include I<number> entries from the top (or the tail if I<number> is lower "
12791 #: dpkg-parsechangelog.pod
12792 msgid "B<-o>, B<--offset> I<number>"
12796 #: dpkg-parsechangelog.pod
12798 "Change the starting point for B<--count>, counted from the top (or the tail "
12799 "if I<number> is lower than 0)."
12803 #: dpkg-parsechangelog.pod
12804 msgid "CHANGELOG FORMATS"
12808 #: dpkg-parsechangelog.pod
12810 "It is possible to use a different format to the standard one, by providing a "
12811 "parser for that alternative format."
12815 #: dpkg-parsechangelog.pod
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:"
12824 #: dpkg-parsechangelog.pod
12825 msgid "@@@ changelog-format: I<otherformat> @@@"
12829 #: dpkg-parsechangelog.pod
12831 "Changelog format names are non-empty strings of lowercase alphanumerics "
12836 #: dpkg-parsechangelog.pod
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."
12846 #: dpkg-parsechangelog.pod
12848 "The parser should be derived from the Dpkg::Changelog class and implement "
12849 "the required documented interface."
12853 #: dpkg-parsechangelog.pod
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."
12861 #: dpkg-parsechangelog.pod
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."
12869 #: dpkg-parsechangelog.pod
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 "
12877 #: dpkg-parsechangelog.pod
12878 msgid "A changelog parser may not interact with the user at all."
12882 #: dpkg-parsechangelog.pod
12884 "All B<Parser Options> except for B<-v> are only supported since dpkg "
12889 #: dpkg-parsechangelog.pod
12891 "Short option parsing with non-bundled values available only since dpkg "
12896 #: dpkg-parsechangelog.pod
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 "
12905 #: dpkg-parsechangelog.pod
12906 msgid "B<deb-changelog>(5)."
12911 msgid "dpkg-query - a tool to query the dpkg database"
12916 msgid "B<dpkg-query> [I<option>...] I<command>"
12922 "B<dpkg-query> is a tool to show information about packages listed in the "
12923 "B<dpkg> database."
12928 msgid "B<-l>, B<--list> [I<package-name-pattern>...]"
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 "
12950 " dpkg-query -l 'libc6*'\n"
12957 "The first three columns of the output show the desired action, the package "
12958 "status, and errors, in that order."
12963 msgid "Desired action:"
12968 msgid "u = Unknown"
12973 msgid "i = Install"
12993 msgid "Package status:"
12998 msgid "n = Not-installed"
13003 msgid "c = Config-files"
13008 msgid "H = Half-installed"
13013 msgid "U = Unpacked"
13018 msgid "F = Half-configured"
13023 msgid "W = Triggers-awaiting"
13028 msgid "t = Triggers-pending"
13033 msgid "i = Installed"
13038 msgid "Error flags:"
13043 msgid "E<lt>emptyE<gt> = (none)"
13048 msgid "R = Reinst-required"
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."
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."
13070 msgid "B<-W>, B<--show> [I<package-name-pattern>...]"
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."
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>."
13093 msgid "B<-s>, B<--status> [I<package-name>...]"
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."
13108 #: dpkg-query.pod dpkg.pod
13109 msgid "B<-L>, B<--listfiles> I<package-name>..."
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."
13123 "Each file diversion is printed on its own line after its diverted file, "
13124 "prefixed with one of the following localized strings:"
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"
13141 "Hint: When machine parsing the output, it is customary to set the locale to "
13142 "B<C.UTF-8> to get reproducible results."
13148 "This command will not list extra files created by maintainer scripts, nor "
13149 "will it list alternatives."
13154 msgid "B<--control-list> I<package-name>"
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>."
13166 msgid "B<--control-show> I<package-name> I<control-file>"
13172 "Print the I<control-file> installed to your system from I<package-name> to "
13173 "the standard output (since dpkg 1.16.5)."
13178 msgid "B<-c>, B<--control-path> I<package-name> [I<control-file>]"
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."
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."
13202 #: dpkg-query.pod dpkg.pod
13203 msgid "B<-S>, B<--search> I<filename-search-pattern>..."
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."
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."
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:"
13239 " pkgname1, pkgname2: pathname1\n"
13240 " pkgname3: pathname2\n"
13246 msgid "File diversions are printed with the following localized strings:"
13254 " diversion by I<pkgname> from: I<diverted-from>\n"
13255 " diversion by I<pkgname> to: I<diverted-to>\n"
13261 msgid "or for local diversions:"
13269 " local diversion from: I<diverted-from>\n"
13270 " local diversion to: I<diverted-to>\n"
13276 msgid "B<-p>, B<--print-avail> [I<package-name>...]"
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."
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>."
13299 "Change the location of the B<dpkg> database. The default location is "
13304 #: dpkg-query.pod dpkg-trigger.pod
13305 msgid "B<--root=>I<directory>"
13309 #: dpkg-query.pod dpkg-trigger.pod
13311 "Set the root directory to I<directory>, which sets the administrative "
13312 "directory to «I<directory>%ADMINDIR%» (since dpkg 1.21.0)."
13317 msgid "B<--load-avail>"
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 "
13329 #: dpkg-query.pod dpkg.pod
13330 msgid "B<--no-pager>"
13334 #: dpkg-query.pod dpkg.pod
13335 msgid "Disables the use of any pager when showing information (since dpkg 1.19.2)."
13340 msgid "B<-f>, B<--showformat=>I<format>"
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."
13353 msgid "In the format string, “B<\\>” introduces escapes:"
13358 msgid "B<\\n> newline"
13363 msgid "B<\\r> carriage return"
13374 "“B<\\>” before any other character suppresses any special meaning of the "
13375 "following character, which is useful for “B<\\>” and “B<$>”."
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):"
13391 msgid "B<Architecture>"
13401 msgid "B<Conffiles> (internal)"
13406 msgid "B<Config-Version> (internal)"
13411 msgid "B<Conflicts>"
13426 msgid "B<Description>"
13431 msgid "B<Enhances>"
13436 msgid "B<Protected>"
13441 msgid "B<Essential>"
13446 msgid "B<Filename> (internal, front-end related)"
13451 msgid "B<Homepage>"
13456 msgid "B<MD5sum> (internal, front-end related)"
13461 msgid "B<MSDOS-Filename> (internal, front-end related)"
13466 msgid "B<Maintainer>"
13481 msgid "B<Pre-Depends>"
13486 msgid "B<Priority>"
13491 msgid "B<Provides>"
13496 msgid "B<Recommends>"
13501 msgid "B<Replaces>"
13506 msgid "B<Revision> (obsolete)"
13516 msgid "B<Size> (internal, front-end related)"
13526 msgid "B<Status> (internal)"
13531 msgid "B<Suggests>"
13536 msgid "B<Tag> (usually not in .deb but in repository Packages files)"
13541 msgid "B<Triggers-Awaited> (internal)"
13546 msgid "B<Triggers-Pending> (internal)"
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 "
13564 msgid "B<binary:Package>"
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>."
13579 msgid "B<binary:Synopsis>"
13584 msgid "It contains the package short description (since dpkg 1.19.1)."
13589 msgid "B<binary:Summary>"
13594 msgid "This is an alias for B<binary:Synopsis> (since dpkg 1.16.2)."
13599 msgid "B<db:Status-Abbrev>"
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."
13612 msgid "B<db:Status-Want>"
13618 "It contains the package wanted status, part of the Status field (since dpkg "
13624 msgid "B<db:Status-Status>"
13630 "It contains the package status word, part of the Status field (since dpkg "
13636 msgid "B<db:Status-Eflag>"
13642 "It contains the package status error flag, part of the Status field (since "
13648 msgid "B<db-fsys:Files>"
13654 "It contains the list of the package filesystem entries separated by newlines "
13655 "(since dpkg 1.19.3)."
13660 msgid "B<db-fsys:Last-Modified>"
13666 "It contains the timestamp in seconds of the last time the package filesystem "
13667 "entries were modified (since dpkg 1.19.3)."
13672 msgid "B<source:Package>"
13678 "It contains the source package name for this binary package (since dpkg "
13685 "It contains the source package version for this binary package (since dpkg "
13692 "It contains the source package upstream version for this binary package "
13693 "(since dpkg 1.18.16)"
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:"
13710 " dpkg-query -f='${binary:Package} ${Version}\\t${Maintainer}\\n' \\\n"
13717 msgid "The requested query was successfully performed."
13721 #: dpkg-query.pod dpkg-split.pod dpkg-statoverride.pod dpkg-trigger.pod
13722 #: dpkg.pod start-stop-daemon.pod
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)."
13735 #: dpkg-query.pod dpkg.pod
13742 "Sets the program to execute when spawning a command via a shell (since dpkg "
13747 #: dpkg-query.pod dpkg.pod
13752 #: dpkg-query.pod dpkg.pod
13753 msgid "B<DPKG_PAGER>"
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 "
13766 #: dpkg-query.pod dpkg-trigger.pod
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)."
13773 #: dpkg-query.pod dpkg-trigger.pod
13775 "If set and the B<--admindir> option has not been specified, it will be used "
13776 "as the B<dpkg> data directory."
13780 #: dpkg-query.pod dpkg.pod
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\">."
13795 #: dpkg-realpath.pod
13796 msgid "dpkg-realpath - print the resolved pathname with DPKG_ROOT support"
13800 #: dpkg-realpath.pod
13801 msgid "B<dpkg-realpath> [I<option>...] I<pathname>"
13805 #: dpkg-realpath.pod
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> "
13816 #: dpkg-realpath.pod
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</>."
13825 #: dpkg-realpath.pod
13826 msgid "B<-z>, B<--zero>"
13830 #: dpkg-realpath.pod
13832 "Use a NUL byte to end output lines instead of a new line character (since "
13837 #: dpkg-realpath.pod
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 "
13845 #: dpkg-realpath.pod update-alternatives.pod
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."
13852 #: dpkg-realpath.pod
13854 "Sets the color mode. The currently accepted values are: B<auto> (default), "
13855 "B<always> and B<never>."
13859 #: dpkg-realpath.pod
13860 msgid "L<realpath(1)>, L<readlink(1)>."
13864 #: dpkg-scanpackages.pod
13865 msgid "dpkg-scanpackages - create Packages index files"
13869 #: dpkg-scanpackages.pod
13871 "B<dpkg-scanpackages> [I<option>...] I<binary-path> [I<override-file> "
13872 "[I<path-prefix>]] B<E<gt>> I<Packages>"
13876 #: dpkg-scanpackages.pod
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."
13887 #: dpkg-scanpackages.pod
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://> "
13898 #: dpkg-scanpackages.pod
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."
13907 #: dpkg-scanpackages.pod
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)."
13915 #: dpkg-scanpackages.pod
13916 msgid "I<path-prefix> is an optional string to be prepended to the Filename fields."
13920 #: dpkg-scanpackages.pod
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."
13928 #: dpkg-scanpackages.pod
13929 msgid "B<-t>, B<--type> I<type>"
13933 #: dpkg-scanpackages.pod
13934 msgid "Scan for *.I<type> packages, instead of *.deb."
13938 #: dpkg-scanpackages.pod dpkg-scansources.pod
13939 msgid "B<-e>, B<--extra-override> I<file>"
13943 #: dpkg-scanpackages.pod
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 "
13951 #: dpkg-scanpackages.pod
13952 msgid "B<-a>, B<--arch> I<arch>"
13956 #: dpkg-scanpackages.pod
13958 "Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of "
13959 "scanning for all debs."
13963 #: dpkg-scanpackages.pod
13964 msgid "B<-h>, B<--hash> I<hash-list>"
13968 #: dpkg-scanpackages.pod
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>."
13976 #: dpkg-scanpackages.pod
13977 msgid "B<-m>, B<--multiversion>"
13981 #: dpkg-scanpackages.pod
13982 msgid "Include all found packages in the output."
13986 #: dpkg-scanpackages.pod
13987 msgid "B<-M>, B<--medium> I<id-string>"
13991 #: dpkg-scanpackages.pod
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>."
13999 #: dpkg-scanpackages.pod dpkg-shlibdeps.pod dpkg-source.pod
14000 #: update-alternatives.pod
14001 msgid "DIAGNOSTICS"
14005 #: dpkg-scanpackages.pod
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."
14014 #: dpkg-scanpackages.pod
14016 "B<dpkg>(1), B<dselect>(1), B<deb-override>(5), B<deb-extra-override>(5), "
14017 "B<dpkg-scansources>(1)."
14021 #: dpkg-scansources.pod
14022 msgid "dpkg-scansources - create Sources index files"
14026 #: dpkg-scansources.pod
14028 "B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> "
14029 "[I<path-prefix>]] B<E<gt>> I<Sources>"
14033 #: dpkg-scansources.pod
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."
14040 #: dpkg-scansources.pod
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."
14049 #: dpkg-scansources.pod
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 "
14060 #: dpkg-scansources.pod
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."
14068 #: dpkg-scansources.pod
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)."
14077 #: dpkg-scansources.pod
14078 msgid "B<-n>, B<--no-sort>"
14082 #: dpkg-scansources.pod
14084 "Do not sort the index stanzas. Normally they are sorted by source package "
14089 #: dpkg-scansources.pod
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."
14097 #: dpkg-scansources.pod
14098 msgid "B<-s>, B<--source-override> I<file>"
14102 #: dpkg-scansources.pod
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."
14110 #: dpkg-scansources.pod
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."
14120 #: dpkg-scansources.pod update-alternatives.pod
14125 #: dpkg-scansources.pod
14126 msgid "Turn debugging on."
14130 #: dpkg-scansources.pod
14131 msgid "B<deb-override>(5), B<deb-extra-override>(5), B<dpkg-scanpackages>(1)."
14135 #: dpkg-shlibdeps.pod
14136 msgid "dpkg-shlibdeps - generate shared library substvar dependencies"
14140 #: dpkg-shlibdeps.pod
14141 msgid "B<dpkg-shlibdeps> [I<option>...] [B<-e>] I<executable> [I<option>...]"
14145 #: dpkg-shlibdeps.pod
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 "
14156 #: dpkg-shlibdeps.pod
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."
14173 #: dpkg-shlibdeps.pod
14174 msgid "Symbols files"
14178 #: dpkg-shlibdeps.pod
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):"
14187 #: dpkg-shlibdeps.pod
14188 msgid "debian/*/DEBIAN/symbols"
14192 #: dpkg-shlibdeps.pod
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."
14202 #: dpkg-shlibdeps.pod
14203 msgid "%PKGCONFDIR%/symbols/I<package>.symbols.I<arch>"
14207 #: dpkg-shlibdeps.pod
14208 msgid "%PKGCONFDIR%/symbols/I<package>.symbols"
14212 #: dpkg-shlibdeps.pod
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>)."
14220 #: dpkg-shlibdeps.pod
14221 msgid "Output from “B<dpkg-query --control-path> I<package> symbols”"
14225 #: dpkg-shlibdeps.pod
14227 "Package-provided shared library dependency information. Unless overridden "
14228 "by B<--admindir>, those files are located in %ADMINDIR%."
14232 #: dpkg-shlibdeps.pod
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)."
14241 #: dpkg-shlibdeps.pod
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."
14251 #: dpkg-shlibdeps.pod
14252 msgid "Shlibs files"
14256 #: dpkg-shlibdeps.pod
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."
14264 #: dpkg-shlibdeps.pod
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:"
14271 #: dpkg-shlibdeps.pod
14272 msgid "debian/shlibs.local"
14276 #: dpkg-shlibdeps.pod
14277 msgid "Package-local overriding shared library dependency information."
14281 #: dpkg-shlibdeps.pod
14282 msgid "%PKGCONFDIR%/shlibs.override"
14286 #: dpkg-shlibdeps.pod
14287 msgid "Per-system overriding shared library dependency information."
14291 #: dpkg-shlibdeps.pod
14292 msgid "debian/*/DEBIAN/shlibs"
14296 #: dpkg-shlibdeps.pod
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."
14305 #: dpkg-shlibdeps.pod
14306 msgid "Output from “B<dpkg-query --control-path> I<package> shlibs”"
14310 #: dpkg-shlibdeps.pod
14311 msgid "%PKGCONFDIR%/shlibs.default"
14315 #: dpkg-shlibdeps.pod
14316 msgid "Per-system default shared library dependency information."
14320 #: dpkg-shlibdeps.pod
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)."
14328 #: dpkg-shlibdeps.pod
14330 "B<dpkg-shlibdeps> interprets non-option arguments as executable names, just "
14331 "as if they'd been supplied as B<-e>I<executable>."
14335 #: dpkg-shlibdeps.pod
14336 msgid "B<-e>I<executable>"
14340 #: dpkg-shlibdeps.pod
14342 "Include dependencies appropriate for the shared libraries required by "
14343 "I<executable>. This option can be used multiple times."
14347 #: dpkg-shlibdeps.pod
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."
14354 #: dpkg-shlibdeps.pod
14355 msgid "B<-d>I<dependency-field>"
14359 #: dpkg-shlibdeps.pod
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>.)"
14367 #: dpkg-shlibdeps.pod
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>."
14375 #: dpkg-shlibdeps.pod
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."
14385 #: dpkg-shlibdeps.pod
14386 msgid "B<-p>I<varname-prefix>"
14390 #: dpkg-shlibdeps.pod
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."
14399 #: dpkg-shlibdeps.pod
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)."
14407 #: dpkg-shlibdeps.pod
14408 msgid "B<-t>I<type>"
14412 #: dpkg-shlibdeps.pod
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."
14422 #: dpkg-shlibdeps.pod
14423 msgid "B<-L>I<local-shlibs-file>"
14427 #: dpkg-shlibdeps.pod
14429 "Read overriding shared library dependency information from "
14430 "I<local-shlibs-file> instead of B<debian/shlibs.local>."
14434 #: dpkg-shlibdeps.pod
14436 "Write substitution variables in I<substvars-file>; the default is "
14437 "B<debian/substvars>."
14441 #: dpkg-shlibdeps.pod
14446 #: dpkg-shlibdeps.pod
14448 "Enable verbose mode (since dpkg 1.14.8). Numerous messages are displayed to "
14449 "explain what B<dpkg-shlibdeps> does."
14453 #: dpkg-shlibdeps.pod
14454 msgid "B<-x>I<package>"
14458 #: dpkg-shlibdeps.pod
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 "
14468 #: dpkg-shlibdeps.pod
14469 msgid "B<-S>I<package-build-dir>"
14473 #: dpkg-shlibdeps.pod
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."
14484 #: dpkg-shlibdeps.pod
14485 msgid "B<-I>I<package-build-dir>"
14489 #: dpkg-shlibdeps.pod
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."
14496 #: dpkg-shlibdeps.pod
14497 msgid "B<--ignore-missing-info>"
14501 #: dpkg-shlibdeps.pod
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."
14510 #: dpkg-shlibdeps.pod
14511 msgid "B<--warnings=>I<value>"
14515 #: dpkg-shlibdeps.pod
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 "
14528 #: dpkg-shlibdeps.pod
14533 #: dpkg-shlibdeps.pod
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:"
14543 #: dpkg-shlibdeps.pod
14544 msgid "B<symbol> I<sym> B<used by> I<binary> B<found in none of the libraries.>"
14548 #: dpkg-shlibdeps.pod
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> "
14557 #: dpkg-shlibdeps.pod
14559 "I<binary> B<contains an unresolvable reference to symbol> I<sym>B<: it's "
14560 "probably a plugin>"
14564 #: dpkg-shlibdeps.pod
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."
14579 #: dpkg-shlibdeps.pod
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)>"
14586 #: dpkg-shlibdeps.pod
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)."
14595 #: dpkg-shlibdeps.pod
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)>"
14602 #: dpkg-shlibdeps.pod
14603 msgid "Exactly the same as the above warning, but for multiple binaries."
14607 #: dpkg-shlibdeps.pod
14609 "I<binary> B<should not be linked against> I<library> B<(it uses none of the "
14610 "library's symbols)>"
14614 #: dpkg-shlibdeps.pod
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."
14624 #: dpkg-shlibdeps.pod
14629 #: dpkg-shlibdeps.pod
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."
14639 #: dpkg-shlibdeps.pod
14641 "B<couldn't find library> I<library-soname> B<needed by> I<binary> B<(its "
14642 "RPATH is '>I<rpath>B<')>"
14646 #: dpkg-shlibdeps.pod
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 "
14665 #: dpkg-shlibdeps.pod
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."
14675 #: dpkg-shlibdeps.pod
14677 "B<no dependency information found for> I<library-file> B<(used by> "
14682 #: dpkg-shlibdeps.pod
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/)."
14694 #: dpkg-shlibdeps.pod
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."
14710 #: dpkg-shlibdeps.pod
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."
14718 #: dpkg-shlibdeps.pod
14720 "B<deb-substvars>(5), B<deb-shlibs>(5), B<deb-symbols>(5), "
14721 "B<dpkg-gensymbols>(1)."
14726 msgid "dpkg-source - Debian source package (.dsc) manipulation tool"
14731 msgid "B<dpkg-source> [I<option>...] I<command>"
14736 msgid "B<dpkg-source> packs and unpacks Debian source archives."
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 "
14749 msgid "B<-x>, B<--extract> I<filename>.dsc [I<output-directory>]"
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 "
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 "
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."
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 "
14794 msgid "B<-b>, B<--build> I<directory> [I<format-specific-parameters>]"
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."
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."
14821 msgid "B<--print-format> I<directory>"
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)."
14834 msgid "B<--before-build> I<directory>"
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."
14851 msgid "B<--after-build> I<directory>"
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 "
14867 msgid "B<--commit> [I<directory>] ..."
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 "
14882 "Show the usage message and exit. The format specific build and extract "
14883 "options can be shown by using the B<--format> option."
14888 msgid "Generic build options"
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."
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."
14909 msgid "B<--format=>I<value>"
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>."
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)."
14929 msgid "B<-Z>I<compression>, B<--compression>=I<compression>"
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."
14945 msgid "B<-z>I<level>, B<--compression-level>=I<level>"
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> "
14959 msgid "B<-i>[I<regex>], B<--diff-ignore>[=I<regex>]"
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.)"
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."
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."
14999 msgid "B<--extend-diff-ignore>=I<regex>"
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."
15014 msgid "B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]"
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."
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."
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 "
15052 "The default regex and patterns for both options can be seen in the output of "
15053 "the B<--help> command."
15058 msgid "Generic extract options"
15063 msgid "B<--no-copy>"
15069 "Do not copy original tarballs near the extracted source package (since dpkg "
15075 msgid "B<--no-check>"
15080 msgid "Do not check signatures and checksums before unpacking (since dpkg 1.14.17)."
15085 msgid "B<--no-overwrite-dir>"
15091 "Do not overwrite the extraction directory if it already exists (since dpkg "
15097 msgid "B<--require-valid-signature>"
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>)."
15113 msgid "B<--require-strong-checksums>"
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>."
15126 msgid "B<--ignore-bad-version>"
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."
15139 msgid "Generic general options"
15145 "Sets the maximum number of threads allowed for compressors that support "
15146 "multi-threaded operations (since dpkg 1.21.14)."
15151 msgid "Sets quiet mode to suppress warnings."
15156 msgid "SOURCE PACKAGE FORMATS"
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."
15170 msgid "Format: 1.0"
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."
15185 msgid "B<Extracting>"
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."
15203 msgid "B<Building>"
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."
15217 msgid "B<Build options (with --build):>"
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."
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."
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."
15256 msgid "Like B<-sk> but will remove the directory again afterwards."
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."
15269 msgid "Like B<-su> but will remove that directory after it has been used."
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."
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."
15292 msgid "B<-sa> or B<-sA>"
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."
15313 msgid "B<--abort-on-upstream-changes>"
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>."
15326 msgid "B<Extract options (with --extract):>"
15331 msgid "In all cases any existing original source tree will be removed."
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 "
15345 msgid "Unpacks the original source tree."
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 "
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."
15365 msgid "B<--skip-debianization>"
15371 "Skips application of the debian diff on top of the upstream sources (since "
15377 msgid "Format: 2.0"
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."
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."
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>."
15407 msgid "Format: 3.0 (native)"
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)."
15422 msgid "Format: 3.0 (quilt)"
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 "
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)."
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."
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)."
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)."
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."
15501 msgid "Similarly to B<quilt>'s default behaviour, the patches can remove files too."
15507 "The file B<.pc/applied-patches> is created if some patches have been applied "
15508 "during the extraction."
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."
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>."
15540 "The updated debian directory and the list of modified binaries is then used "
15541 "to generate the debian tarball."
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."
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 "
15567 msgid "B<Recording changes>"
15572 msgid "B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]"
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."
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."
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)."
15607 msgid "B<Build options>"
15612 msgid "B<--allow-version-of-quilt-db=>I<version>"
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>."
15628 msgid "B<--include-removal>"
15634 "Do not ignore removed files and include them in the automatically generated "
15640 msgid "B<--include-timestamp>"
15645 msgid "Include timestamp in the automatically generated patch."
15650 msgid "B<--include-binaries>"
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."
15663 msgid "B<--no-preparation>"
15669 "Do not try to prepare the build tree by applying patches which are "
15670 "apparently unapplied (since dpkg 1.14.18)."
15675 msgid "B<--single-debian-patch>"
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."
15694 msgid "B<--create-empty-orig>"
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."
15708 msgid "B<--no-unapply-patches, --unapply-patches>"
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."
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>."
15735 msgid "B<--auto-commit>"
15741 "The process doesn't fail if an automatic patch has been generated, instead "
15742 "it's immediately recorded in the B<quilt> series."
15747 msgid "B<Extract options>"
15753 "Skips extraction of the debian tarball on top of the upstream sources (since "
15759 msgid "B<--skip-patches>"
15764 msgid "Do not apply patches at the end of the extraction (since dpkg 1.14.18)."
15769 msgid "Format: 3.0 (custom)"
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 "
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."
15790 msgid "B<--target-format=>I<value>"
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 "
15803 msgid "Format: 3.0 (git)"
15808 msgid "Supported since dpkg 1.14.17. This format is experimental."
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."
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 "
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/>."
15839 "Before going any further, some checks are done to ensure that we don't have "
15840 "any non-ignored uncommitted changes."
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."
15852 msgid "B<--git-ref=>I<ref>"
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"
15869 msgid "B<--git-depth=>I<number>"
15875 "Creates a shallow clone with a history truncated to the specified number of "
15881 msgid "Format: 3.0 (bzr)"
15887 "Supported since dpkg 1.14.17. This format is experimental. It generates a "
15888 "single tarball containing the bzr repository."
15893 msgid "The tarball is unpacked and then bzr is used to checkout the current branch."
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."
15906 msgid "no source format specified in debian/source/format"
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 "
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>."
15931 msgid "the diff modifies the following upstream files"
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."
15946 msgid "cannot represent change to I<file>"
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."
15961 msgid "newly created empty file I<file> will not be represented in diff"
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."
15973 msgid "executable mode I<perms> of I<file> will not be represented in diff"
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 "
15986 msgid "special mode I<perms> of I<file> will not be represented in diff"
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."
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."
16015 msgid "Used by the “2.0” and “3.0 (quilt)” source format modules."
16025 msgid "B<GIT_INDEX_FILE>"
16030 msgid "B<GIT_OBJECT_DIRECTORY>"
16035 msgid "B<GIT_ALTERNATE_OBJECT_DIRECTORIES>"
16040 msgid "B<GIT_WORK_TREE>"
16045 msgid "Used by the “3.0 (git)” source format modules."
16050 msgid "debian/source/format"
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."
16063 msgid "debian/source/include-binaries"
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."
16077 msgid "debian/source/options"
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."
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 "
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"
16116 "B<Note:> B<format> options are not accepted in this file, you should use "
16117 "B<debian/source/format> instead."
16122 msgid "debian/source/local-options"
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 "
16136 msgid "debian/source/local-patch-header"
16141 msgid "debian/source/patch-header"
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."
16154 msgid "debian/patches/I<vendor>.series"
16159 msgid "debian/patches/series"
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)."
16181 "The point at which field overriding occurs compared to certain standard "
16182 "output field settings is rather confused."
16187 msgid "B<deb-src-control>(5), B<deb-changelog>(5), B<deb-substvars>(5), B<dsc>(5)."
16192 msgid "dpkg-split - Debian package archive split/join tool"
16197 msgid "B<dpkg-split> [I<option>...] I<command>"
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."
16211 "It can be operated manually using the B<--split>, B<--join> and B<--info> "
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."
16227 "All splitting, joining and queueing operations produce informative messages "
16228 "on standard output; these may safely be ignored."
16233 msgid "B<-s>, B<--split> I<complete-archive> [I<prefix>]"
16238 msgid "Splits a single Debian binary package into several parts."
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 "
16252 "If no I<prefix> is supplied then the I<complete-archive> filename is taken, "
16253 "including directory, with any trailing B<.deb> removed."
16258 msgid "B<-j>, B<--join> I<part>..."
16264 "Joins the parts of a package file together, reassembling the original file "
16265 "as it was before it was split."
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."
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>."
16286 msgid "The parts' filenames are not significant for the reassembly process."
16292 "By default the output file is called "
16293 "I<package>B<_>I<version>B<_>I<arch>B<.deb>."
16298 msgid "B<-I>, B<--info> I<part>..."
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)."
16311 msgid "B<-a>, B<--auto -o> I<complete-output> I<part>"
16316 msgid "Automatically queue parts and reassemble a package if possible."
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."
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)."
16337 "If not then the I<part> is copied into the queue and I<complete-output> is "
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 "
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 "
16359 msgid "B<-l>, B<--listq>"
16364 msgid "Lists the contents of the queue of packages to be reassembled."
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."
16377 msgid "B<-d>, B<--discard> [I<package>...]"
16383 "This discards parts from the queue of those waiting for the remaining parts "
16384 "of their packages."
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."
16396 msgid "B<--depotdir> I<directory>"
16402 "Specifies an alternative directory for the queue of parts awaiting automatic "
16403 "reassembly. The default is B<%ADMINDIR%/parts>."
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."
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."
16424 msgid "B<-S>, B<--partsize> I<kibibytes>"
16430 "Specifies the maximum part size when splitting, in kibibytes (1024 "
16431 "bytes). The default is 450 KiB."
16436 msgid "B<-o>, B<--output> I<complete-output>"
16441 msgid "Specifies the output file name for a reassembly."
16447 "This overrides the default for a manual reassembly (B<--join>) and is "
16448 "mandatory for an automatic queue-or-reassemble (B<--auto>)."
16453 msgid "B<-Q>, B<--npquiet>"
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."
16472 msgid "Forces the output filenames generated by B<--split> to be MSDOS-compatible."
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."
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."
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."
16500 "Only occurs with B<--auto> and indicates that the I<part> file was not a "
16501 "binary package part."
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."
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)."
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)."
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."
16535 msgid "I<%ADMINDIR%/parts>"
16540 msgid "The default queue directory for part files awaiting automatic reassembly."
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."
16554 "Full details of the packages in the queue are impossible to get without "
16555 "digging into the queue directory yourself."
16561 "There is no easy way to test whether a file that may be a binary package "
16567 msgid "B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1)."
16571 #: dpkg-statoverride.pod
16572 msgid "dpkg-statoverride - override ownership and mode of files"
16576 #: dpkg-statoverride.pod
16577 msgid "B<dpkg-statoverride> [I<option>...] I<command>"
16581 #: dpkg-statoverride.pod
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."
16591 #: dpkg-statoverride.pod
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."
16598 #: dpkg-statoverride.pod
16599 msgid "B<--add> I<user group mode path>"
16603 #: dpkg-statoverride.pod
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 "
16614 #: dpkg-statoverride.pod
16616 "If B<--update> is specified and I<path> exists, it is immediately set to the "
16617 "new owner and mode."
16621 #: dpkg-statoverride.pod
16622 msgid "B<--remove> I<path>"
16626 #: dpkg-statoverride.pod
16628 "Remove an override for I<path>, the status of I<path> is left unchanged by "
16633 #: dpkg-statoverride.pod
16635 "List all overrides. If a glob pattern is specified restrict the output to "
16636 "overrides which match the glob."
16640 #: dpkg-statoverride.pod dpkg.pod
16641 msgid "B<--force-help>"
16645 #: dpkg-statoverride.pod
16646 msgid "Give help about the B<--force->I<thing> options (since dpkg 1.19.5)."
16650 #: dpkg-statoverride.pod
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."
16658 #: dpkg-statoverride.pod dpkg.pod
16659 msgid "B<--force->I<things>"
16663 #: dpkg-statoverride.pod dpkg.pod
16664 msgid "B<--no-force->I<things>, B<--refuse->I<things>"
16668 #: dpkg-statoverride.pod
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."
16677 #: dpkg-statoverride.pod
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 "
16685 #: dpkg-statoverride.pod dpkg.pod
16686 msgid "B<all>: Turns on (or off) all force options."
16690 #: dpkg-statoverride.pod dpkg.pod
16692 "B<statoverride-add>: Overwrite an existing stat override when adding it "
16693 "(since dpkg 1.19.5)."
16697 #: dpkg-statoverride.pod dpkg.pod
16699 "B<statoverride-remove>: Ignore a missing stat override when removing it "
16700 "(since dpkg 1.19.5)."
16704 #: dpkg-statoverride.pod dpkg.pod
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."
16712 #: dpkg-statoverride.pod
16714 "B<not-root>: Try to (de)install things even when not root (since dpkg "
16719 #: dpkg-statoverride.pod update-alternatives.pod
16724 #: dpkg-statoverride.pod
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>."
16732 #: dpkg-statoverride.pod
16733 msgid "B<--update>"
16737 #: dpkg-statoverride.pod
16739 "Immediately try to change the I<path> to the new owner and mode if it "
16744 #: dpkg-statoverride.pod
16745 msgid "Be less verbose about what we do."
16749 #: dpkg-statoverride.pod
16750 msgid "For B<--list>, if there are no overrides or none match the supplied glob."
16754 #: dpkg-statoverride.pod dpkg.pod
16755 msgid "B<DPKG_FORCE>"
16759 #: dpkg-statoverride.pod
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)."
16766 #: dpkg-statoverride.pod
16767 msgid "I<%ADMINDIR%/statoverride>"
16771 #: dpkg-statoverride.pod
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>."
16779 #: dpkg-statoverride.pod
16781 "B<Note:> B<dpkg-statoverride> preserves the old copy of this file, with "
16782 "extension “-old”, before replacing it with the new one."
16786 #: dpkg-trigger.pod
16787 msgid "dpkg-trigger - a package trigger utility"
16791 #: dpkg-trigger.pod
16792 msgid "B<dpkg-trigger> [I<option>...] I<trigger-name>"
16796 #: dpkg-trigger.pod
16797 msgid "B<dpkg-trigger> [I<option>...] I<command>"
16801 #: dpkg-trigger.pod
16803 "B<dpkg-trigger> is a tool to explicitly activate triggers and check for its "
16804 "support on the running B<dpkg>."
16808 #: dpkg-trigger.pod
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>)."
16818 #: dpkg-trigger.pod
16819 msgid "Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>."
16823 #: dpkg-trigger.pod
16824 msgid "B<--check-supported>"
16828 #: dpkg-trigger.pod
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>."
16837 #: dpkg-trigger.pod
16839 "Change the location of the B<dpkg> database. Defaults to I<%ADMINDIR%> if "
16840 "B<DPKG_ADMINDIR> has not been set."
16844 #: dpkg-trigger.pod
16845 msgid "B<--by-package=>I<package>"
16849 #: dpkg-trigger.pod
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 "
16858 #: dpkg-trigger.pod
16859 msgid "B<--no-await>"
16863 #: dpkg-trigger.pod
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."
16873 #: dpkg-trigger.pod
16878 #: dpkg-trigger.pod
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."
16886 #: dpkg-trigger.pod
16887 msgid "B<--no-act>"
16891 #: dpkg-trigger.pod
16892 msgid "Just test, do not actually change anything."
16896 #: dpkg-trigger.pod dpkg.pod
16898 "The requested action was successfully performed. Or a check or assertion "
16899 "command returned true."
16903 #: dpkg-trigger.pod dpkg.pod
16904 msgid "A check or assertion command returned false."
16908 #: dpkg-trigger.pod
16909 msgid "B<dpkg>(1), B<deb-triggers>(5), B<%PKGDOCDIR%/spec/triggers.txt>."
16914 msgid "dpkg-vendor - queries information about distribution vendors"
16919 msgid "B<dpkg-vendor> [I<option>...] I<command>"
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."
16932 msgid "B<--is> I<vendor>"
16938 "Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with "
16944 msgid "B<--derives-from> I<vendor>"
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."
16957 msgid "B<--query> I<field>"
16963 "Print on standard output the value of the vendor-specific I<field> for the "
16969 msgid "B<--vendor> I<vendor>"
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>."
16982 "This setting defines the current vendor. If not set, it will discover the "
16983 "current vendor by reading B<%PKGCONFDIR%/origins/default>."
16988 msgid "B<deb-origin>(5)."
16993 msgid "dpkg.cfg - dpkg configuration file"
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<#>’)."
17007 #: dpkg.cfg.pod dpkg.pod
17008 msgid "I<%PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*>"
17012 #: dpkg.cfg.pod dpkg.pod
17013 msgid "I<%PKGCONFDIR%/dpkg.cfg>"
17018 msgid "I<~/.dpkg.cfg>"
17023 msgid "dpkg - package manager for Debian"
17028 msgid "B<dpkg> [I<option>...] I<action>"
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 "
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."
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."
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."
17077 msgid "INFORMATION ABOUT PACKAGES"
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>."
17090 msgid "Package states"
17095 msgid "B<not-installed>"
17100 msgid "The package is not installed on your system."
17105 msgid "B<config-files>"
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."
17117 msgid "B<half-installed>"
17123 "The installation of the package has been started, but not completed for some "
17129 msgid "B<unpacked>"
17134 msgid "The package is unpacked, but not configured."
17139 msgid "B<half-configured>"
17145 "The package is unpacked and configuration has been started, but not yet "
17146 "completed for some reason."
17151 msgid "B<triggers-awaited>"
17156 msgid "The package awaits trigger processing by another package."
17161 msgid "B<triggers-pending>"
17166 msgid "The package has been triggered."
17171 msgid "B<installed>"
17176 msgid "The package is correctly unpacked and configured."
17181 msgid "Package selection states"
17191 msgid "The package is selected for installation."
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."
17210 msgid "B<deinstall>"
17216 "The package is selected for deinstallation (i.e. we want to remove all "
17217 "files, except configuration files)."
17228 "The package is selected to be purged (i.e. we want to remove everything from "
17229 "system directories, even configuration files)."
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 "
17247 msgid "Package flags"
17258 "A package marked B<ok> is in a known state, but might need further "
17264 msgid "B<reinstreq>"
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>."
17282 msgid "B<-i>, B<--install> I<package-file>..."
17288 "Install the package. If B<--recursive> or B<-R> option is specified, "
17289 "I<package-file> must refer to a directory instead."
17294 msgid "Installation consists of the following steps:"
17299 msgid "B<1.> Extract the control files of the new package."
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."
17311 msgid "B<3.> Run I<preinst> script, if provided by the package."
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."
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."
17333 "B<6.> Configure the package. See B<--configure> for detailed information "
17334 "about how this is done."
17339 msgid "B<--unpack> I<package-file>..."
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."
17352 "Will process triggers for B<Pre-Depends> unless B<--no-triggers> has been "
17358 msgid "B<--configure> I<package>...|B<-a>|B<--pending>"
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."
17372 "To reconfigure a package which has already been configured, try the "
17373 "B<dpkg-reconfigure>(8) command instead."
17378 msgid "Configuring consists of the following steps:"
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."
17390 msgid "B<2.> Run I<postinst> script, if provided by the package."
17395 msgid "Will process triggers unless B<--no-triggers> has been specified."
17400 msgid "B<--triggers-only> I<package>...|B<-a>|B<--pending>"
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>."
17415 msgid "B<-r>, B<--remove> I<package>...|B<-a>|B<--pending>"
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."
17433 msgid "Removing of a package consists of the following steps:"
17438 msgid "B<1.> Run I<prerm> script"
17443 msgid "B<2.> Remove the installed files"
17448 msgid "B<3.> Run I<postrm> script"
17453 msgid "B<-P>, B<--purge> I<package>...|B<-a>|B<--pending>"
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>, "
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."
17479 msgid "Purging of a package consists of the following steps:"
17485 "B<1.> Remove the package, if not already removed. See B<--remove> for "
17486 "detailed information about how this is done."
17491 msgid "B<2.> Run I<postrm> script."
17496 msgid "B<-V>, B<--verify> [I<package-name>...]"
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."
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."
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."
17530 msgid "B<-C>, B<--audit> [I<package-name>...]"
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."
17545 msgid "B<--update-avail> [I<Packages-file>]"
17550 msgid "B<--merge-avail> [I<Packages-file>]"
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>."
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."
17577 msgid "B<-A>, B<--record-avail> I<package-file>..."
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."
17590 msgid "B<--forget-old-unavail>"
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."
17603 msgid "B<--clear-avail>"
17608 msgid "Erase the existing information about what packages are available."
17613 msgid "B<--get-selections> [I<package-name-pattern>...]"
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 "
17625 #: dpkg.pod update-alternatives.pod
17626 msgid "B<--set-selections>"
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."
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."
17648 msgid "B<--clear-selections>"
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>."
17662 msgid "B<--yet-to-unpack>"
17668 "Searches for packages selected for installation, but which for some reason "
17669 "still haven't been installed."
17675 "B<Note:> This command makes use of both the available file and the package "
17681 msgid "B<--predep-package>"
17687 "Print a single package which is the target of one or more relevant "
17688 "pre-dependencies and has itself no unsatisfied pre-dependencies."
17694 "If such a package is present, output it as a Packages file entry, which can "
17695 "be massaged as appropriate."
17701 "Returns 0 when a package is printed, 1 when no suitable package is available "
17707 msgid "B<--add-architecture> I<architecture>"
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."
17721 msgid "B<--remove-architecture> I<architecture>"
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."
17737 msgid "B<--print-architecture>"
17742 msgid "Print architecture of packages B<dpkg> installs (for example, “i386”)."
17747 msgid "B<--print-foreign-architectures>"
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)."
17759 msgid "B<--assert-help>"
17764 msgid "Give help about the B<--assert->I<feature> options (since dpkg 1.21.0)."
17769 msgid "B<--assert->I<feature>"
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:"
17783 msgid "B<support-predepends>"
17788 msgid "Supports the B<Pre-Depends> field (since dpkg 1.1.0)."
17793 msgid "B<working-epoch>"
17798 msgid "Supports epochs in version strings (since dpkg 1.4.0.7)."
17803 msgid "B<long-filenames>"
17808 msgid "Supports long filenames in B<deb>(5) archives (since dpkg 1.4.1.17)."
17813 msgid "B<multi-conrep>"
17818 msgid "Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19)."
17823 msgid "B<multi-arch>"
17828 msgid "Supports multi-arch fields and semantics (since dpkg 1.16.2)."
17833 msgid "B<versioned-provides>"
17838 msgid "Supports versioned B<Provides> (since dpkg 1.17.11)."
17843 msgid "B<protected-field>"
17848 msgid "Supports the B<Protected> field (since dpkg 1.20.1)."
17853 msgid "B<--validate->I<thing> I<string>"
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:"
17872 msgid "Validates the given package name (since dpkg 1.18.16)."
17877 msgid "B<trigname>"
17882 msgid "Validates the given trigger name (since dpkg 1.18.16)."
17887 msgid "B<archname>"
17892 msgid "Validates the given architecture name (since dpkg 1.18.16)."
17902 msgid "Validates the given version (since dpkg 1.18.16)."
17907 msgid "B<--compare-versions> I<ver1> I<op> I<ver2>"
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."
17932 msgid "B<--command-fd> I<n>"
17937 msgid "Accept a series of commands on input file descriptor I<n>."
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 "
17950 msgid "Display a brief help message."
17955 msgid "Give help about the B<--force->I<thing> options."
17960 msgid "B<-Dh>, B<--debug=help>"
17965 msgid "Give help about debugging options."
17970 msgid "Display B<dpkg> version information."
17976 "When used with B<--robot>, the output will be the program version number in "
17977 "a dotted numerical format, with no newline."
17982 msgid "B<dpkg-deb actions>"
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."
17994 msgid "B<-b>, B<--build> I<directory> [I<archive>|I<directory>]"
17999 msgid "Build a deb package."
18004 msgid "List contents of a deb package."
18009 msgid "Extract control-information from a package."
18014 msgid "Extract the files contained by package."
18019 msgid "Extract and display the filenames contained by a package."
18024 msgid "B<-f>, B<--field> I<archive> [I<control-field>...]"
18029 msgid "Display control field(s) of a package."
18034 msgid "Output the control tar-file contained in a Debian package."
18039 msgid "Output the filesystem tar-file contained by a Debian package."
18044 msgid "B<-I>, B<--info> I<archive> [I<control-file>...]"
18049 msgid "Show information about a package."
18054 msgid "B<dpkg-query actions>"
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."
18066 msgid "B<-l>, B<--list> I<package-name-pattern>..."
18071 msgid "List packages matching given pattern."
18076 msgid "B<-s>, B<--status> I<package-name>..."
18081 msgid "Report status of specified package."
18086 msgid "List files installed to your system from I<package-name>."
18091 msgid "Search for a filename from installed packages."
18096 msgid "B<-p>, B<--print-avail> I<package-name>..."
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."
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<#>’)."
18120 msgid "B<--abort-after=>I<number>"
18125 msgid "Change after how many errors B<dpkg> will abort. The default is 50."
18130 msgid "B<-B>, B<--auto-deconfigure>"
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 "
18144 msgid "B<-D>I<octal>, B<--debug=>I<octal>"
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."
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"
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."
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 "
18196 "B<downgrade>(*): Install a package, even if newer version of it is already "
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.>"
18213 "B<configure-any>: Configure also any unpacked but unconfigured packages on "
18214 "which the current package depends."
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."
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>."
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."
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 "
18257 "B<depends>: Turn all dependency problems into warnings. This affects the "
18258 "B<Pre-Depends> and B<Depends> fields."
18264 "B<depends-version>: Don't care about versions when checking dependencies. "
18265 "This affects the B<Pre-Depends> and B<Depends> fields."
18271 "B<breaks>: Install, even if this would break another package (since dpkg "
18272 "1.14.6). This affects the B<Breaks> field."
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."
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 "
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 "
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 "
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."
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."
18331 msgid "B<overwrite>: Overwrite one package's file with another's file."
18336 msgid "B<overwrite-dir>: Overwrite one package's directory with another's file."
18341 msgid "B<overwrite-diverted>: Overwrite a diverted file with an undiverted version."
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."
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."
18368 "I<Warning: Using this option might improve performance at the cost of losing "
18369 "data, use with care.>"
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)."
18382 msgid "I<Warning: This can destroy your host system, use with extreme care.>"
18387 msgid "B<architecture>: Process even packages with wrong or no architecture."
18393 "B<bad-version>: Process even packages with wrong versions (since dpkg "
18399 msgid "B<bad-path>: B<PATH> is missing important programs, so problems are likely."
18404 msgid "B<not-root>: Try to (de)install things even when not root."
18409 msgid "B<bad-verify>: Install a package even if it fails authenticity check."
18414 msgid "B<--ignore-depends>=I<package>,..."
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."
18427 msgid "B<--no-act>, B<--dry-run>, B<--simulate>"
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."
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)."
18449 msgid "B<-R>, B<--recursive>"
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."
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>."
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 "
18478 msgid "B<--instdir=>I<dir>"
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</>»."
18492 msgid "B<--root=>I<dir>"
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%>»."
18505 msgid "B<-O>, B<--selected-only>"
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 "
18519 msgid "B<-E>, B<--skip-same-version>"
18525 "Don't install the package if the same version and architecture of the "
18526 "package is already installed."
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."
18539 msgid "B<--pre-invoke=>I<command>"
18544 msgid "B<--post-invoke=>I<command>"
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."
18563 "B<Note:> Front-ends might call B<dpkg> several times per invocation, which "
18564 "might run the hooks more times than expected."
18569 msgid "B<--path-exclude=>I<glob-pattern>"
18574 msgid "B<--path-include=>I<glob-pattern>"
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)."
18588 "I<Warning: Take into account that depending on the excluded paths you might "
18589 "completely break your system, use with caution.>"
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."
18610 "This can be used to remove all paths except some particular ones; a typical "
18618 " --path-exclude=/usr/share/doc/*\n"
18619 " --path-include=/usr/share/doc/*/copyright\n"
18625 msgid "to remove all documentation files except the copyright files."
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."
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."
18652 msgid "Hint: make sure the globs are not expanded by your shell."
18657 msgid "B<--verify-format> I<format-name>"
18662 msgid "Sets the output format for the B<--verify> command (since dpkg 1.17.2)."
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 "
18678 " B<missing > [B<c>] I<pathname> [B<(>I<error-message>B<)>]\n"
18679 " B<??5??????> [B<c>] I<pathname>\n"
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 "
18700 "Implies the check could not be done (lack of support, file permissions, "
18711 msgid "Implies the check passed."
18716 msgid "‘I<A-Za-z0-9>’"
18722 "Implies a specific check failed. The following positions and alphanumeric "
18723 "characters are currently supported:"
18733 msgid "These checks are currently not supported, will always be ‘B<?>’."
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."
18759 msgid "The digest check failed, which means the file contents have changed."
18770 "The line is followed by a space and an attribute character. The following "
18771 "attribute character is supported:"
18781 msgid "The pathname is a conffile."
18786 msgid "Finally followed by another space and the pathname."
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."
18799 msgid "B<--status-fd> I<n>"
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:"
18812 msgid "B<status:> I<package>B<:> I<status>"
18817 msgid "Package status changed; I<status> is as in the status file."
18822 msgid "B<status:> I<package> B<: error :> I<extended-error-message>"
18828 "An error occurred. Any possible newlines in I<extended-error-message> will "
18829 "be converted to spaces before output."
18835 "B<status:> I<file> B<: conffile-prompt : '>I<real-old>B<' '>I<real-new>B<'> "
18836 "I<useredited> I<distedited>"
18841 msgid "User is being asked a conffile question."
18846 msgid "B<processing:> I<stage>B<:> I<package>"
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>."
18859 msgid "B<--status-logger>=I<command>"
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>."
18873 msgid "B<--log=>I<filename>"
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:"
18886 msgid "YYYY-MM-DD HH:MM:SS B<startup> I<type> I<command>"
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>)."
18899 msgid "YYYY-MM-DD HH:MM:SS B<status> I<state> I<pkg> I<installed-version>"
18904 msgid "For status change updates."
18910 "YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> "
18911 "I<available-version>"
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>."
18923 msgid "YYYY-MM-DD HH:MM:SS B<conffile> I<filename> I<decision>"
18928 msgid "For conffile changes where I<decision> is either B<install> or B<keep>."
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."
18947 msgid "The only currently supported command is B<--version>."
18952 msgid "B<--no-debsig>"
18957 msgid "Do not try to verify package signatures."
18962 msgid "B<--no-triggers>"
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>."
18978 msgid "B<--triggers>"
18983 msgid "Cancels a previous B<--no-triggers> (since dpkg 1.14.17)."
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."
19000 #: dpkg.pod dselect.pod
19007 "If set, B<dpkg> will use it as the directory from which to read the user "
19008 "specific configuration file."
19014 "If set, B<dpkg> will use it as the directory in which to create temporary "
19015 "files and directories."
19021 "The program B<dpkg> will execute when starting a new interactive shell, or "
19022 "when spawning a command via a shell."
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 "
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."
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."
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)."
19059 msgid "B<DPKG_FRONTEND_LOCKED>"
19065 "Set by a package manager frontend to notify dpkg that it should not acquire "
19066 "the frontend lock (since dpkg 1.19.1)."
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\">."
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."
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."
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)."
19109 msgid "B<DPKG_SHELL_REASON>"
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>."
19121 msgid "B<DPKG_CONFFILE_OLD>"
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."
19133 msgid "B<DPKG_CONFFILE_NEW>"
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."
19145 msgid "B<DPKG_HOOK_ACTION>"
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."
19157 msgid "B<DPKG_RUNNING_VERSION>"
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)."
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)."
19176 msgid "B<DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT>"
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)."
19189 msgid "B<DPKG_MAINTSCRIPT_ARCH>"
19195 "Defined by B<dpkg> on the maintainer script environment to the architecture "
19196 "the package got built for (since dpkg 1.15.4)."
19201 msgid "B<DPKG_MAINTSCRIPT_NAME>"
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 "
19214 msgid "B<DPKG_MAINTSCRIPT_DEBUG>"
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)."
19227 msgid "Configuration fragment files (since dpkg 1.15.4)."
19232 msgid "Configuration file with default options."
19237 msgid "I<%LOGDIR%/dpkg.log>"
19242 msgid "Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>)."
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."
19254 msgid "I<%ADMINDIR%/available>"
19259 msgid "List of available packages."
19264 msgid "I<%ADMINDIR%/status>"
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."
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."
19284 msgid "The format and contents of a binary package are described in B<deb>(5)."
19289 msgid "B<--no-act> usually gives less information than might be helpful."
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):"
19304 " dpkg -l '*vi*'\n"
19310 msgid "To see the entries in I<%ADMINDIR%/available> of two packages:"
19317 " dpkg --print-avail elvis vim | less\n"
19323 msgid "To search the listing of packages yourself:"
19330 " less %ADMINDIR%/available\n"
19336 msgid "To remove an installed elvis package:"
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>:"
19358 " cd /media/cdrom/pool/main/v/vim\n"
19359 " dpkg -i vim_4.5-3.deb\n"
19365 msgid "To make a local copy of the package selection states:"
19372 " dpkg --get-selections> myselections\n"
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:"
19389 " apt-cache dumpavail | dpkg --merge-avail\n"
19395 msgid "or with dpkg 1.17.6 and earlier:"
19402 " avail=$(mktemp)\n"
19403 " apt-cache dumpavail> \"$avail\"\n"
19404 " dpkg --merge-avail \"$avail\"\n"
19411 msgid "you can install it with:"
19418 " dpkg --clear-selections\n"
19419 " dpkg --set-selections <myselections\n"
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>."
19435 "Ordinarily, you will find that B<dselect>(1) provides a more convenient way "
19436 "to modify the package selection states."
19441 msgid "ADDITIONAL FUNCTIONALITY"
19447 "Additional functionality can be gained by installing any of the following "
19448 "packages: B<apt>, B<aptitude> and B<debsums>."
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)."
19466 "See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to "
19472 msgid "dsc - Debian source packages' control file format"
19477 msgid "I<filename>B<.dsc>"
19483 "Each Debian source package is composed of a .dsc control file, which "
19484 "contains a number of fields, in L<deb822(5)> format."
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)."
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."
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."
19522 msgid "B<Source:> I<source-name> (required)"
19527 msgid "B<Binary:> I<binary-package-list>"
19533 "This folded field lists binary packages which this source package can "
19534 "produce, separated by commas."
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."
19547 msgid "B<Architecture:> I<arch-list> (recommended)"
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."
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>."
19572 "The field value is generally generated from B<Architecture> fields from in "
19573 "the I<debian/control> in the source package."
19578 msgid "B<Uploaders:> I<fullname-email-list>"
19583 msgid "B<Standards-Version:> I<version-string> (recommended)"
19589 "The I<url> of a web interface to browse the Version Control System "
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."
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."
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<@>."
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."
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."
19636 msgid "B<Package-List:>"
19641 msgid "S< >I<package> I<package-type> I<section> I<priority> I<key-value-list>"
19647 "This multiline field contains a list of binary packages generated by this "
19653 msgid "The I<package> is the binary package name."
19659 "The I<package-type> is the binary package type, usually B<deb>, another "
19660 "common value is B<udeb>."
19666 "The I<section> and I<priority> match the binary package fields of the same "
19673 "The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the "
19674 "currently known optional keys are:"
19685 "The architecture restriction from the binary package B<Architecture> field, "
19686 "with spaces converted to ‘,’."
19697 "The normalized build-profile restriction formula from the binary package "
19698 "B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’."
19703 msgid "B<protected>"
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."
19715 msgid "B<essential>"
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."
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>."
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."
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 "
19754 "The B<Format> field conflates the format for the B<.dsc> file itself and the "
19755 "format of the extracted source package."
19760 msgid "L<deb822(5)>, B<deb-src-control>(5), B<deb-version>(7), B<dpkg-source>(1)."
19765 msgid "dselect.cfg - dselect configuration file"
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<#>’)."
19780 msgid "I<%PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*>"
19785 msgid "I<%PKGCONFDIR%/dselect.cfg>"
19790 msgid "I<~/.dselect.cfg>"
19795 msgid "B<dselect>(1)."
19800 msgid "dselect - Debian package management frontend"
19805 msgid "B<dselect> [I<option>...] [I<command>...]"
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:"
19817 msgid "Update the list of available package versions,"
19822 msgid "View the status of installed and available packages,"
19827 msgid "Alter package selections and manage dependencies,"
19832 msgid "Install new packages or upgrade to newer versions."
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)."
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."
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 "
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 "
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 "
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)."
19896 msgid "B<-D>I<file>, B<--debug> I<file>"
19901 msgid "Turn on debugging. Debugging information is sent to I<file>."
19906 msgid "B<--expert>"
19911 msgid "Turns on expert mode, i.e. doesn't display possibly annoying help messages."
19918 "I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
19925 "I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]"
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 "
19945 msgid "The screen title."
19950 msgid "B<listhead>"
19955 msgid "The header line above the list of packages."
19965 msgid "The scrolling list of packages (and also some help text)."
19975 msgid "The selected item in the list."
19980 msgid "B<pkgstate>"
19986 "In the list of packages, the text indicating the current state of each "
19992 msgid "B<pkgstatesel>"
19998 "In the list of packages, the text indicating the current state of the "
19999 "currently selected package."
20004 msgid "B<infohead>"
20009 msgid "The header line that displays the state of the currently selected package."
20014 msgid "B<infodesc>"
20019 msgid "The package's short description."
20029 msgid "Used to display package info such as the package's description."
20034 msgid "B<infofoot>"
20039 msgid "The last line of the screen when selecting packages."
20049 msgid "Used to display query lines"
20054 msgid "B<helpscreen>"
20059 msgid "Color of help screens."
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."
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>"
20082 msgid "Print a brief help text and exit successfully."
20087 msgid "Print version information and exit successfully."
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:"
20105 msgid "Choose and configure an access method to access package repositories."
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."
20118 msgid "The use of the I<apt> access method is strongly recommended."
20128 msgid "Refresh the available packages database."
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)."
20144 "Details of the update command depend on the access method's implementation. "
20145 "Normally the process is straightforward and requires no user interaction."
20155 msgid "View or manage package selections and dependencies."
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."
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."
20182 "The use of the interactive package selections management screen is explained "
20183 "in more detail below."
20193 msgid "Installs selected packages."
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."
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."
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."
20236 msgid "Configures any previously installed, but not fully configured packages."
20246 msgid "Removes or purges installed packages, that are marked for removal."
20256 msgid "Quit B<dselect>."
20261 msgid "Exits the program with zero (successful) error code."
20266 msgid "PACKAGE SELECTIONS MANAGEMENT"
20271 msgid "Introduction"
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."
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."
20301 msgid "Screen layout"
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."
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."
20324 msgid "Package details view"
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 "
20338 msgid "the extended description"
20343 msgid "the control information for the installed version"
20348 msgid "the control information for the available version"
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."
20361 msgid "Packages status list"
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."
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."
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."
20396 msgid "These are the meanings of the shorthand package status indicator codes:"
20401 msgid "Error flag:"
20406 msgid "I<empty> no error"
20411 msgid "B<R> serious error, needs reinstallation;"
20416 msgid "Installed state:"
20421 msgid "I<empty> not installed;"
20426 msgid "B<*> fully installed and configured;"
20431 msgid "B<-> not installed but some config files may remain;"
20436 msgid "B<U> unpacked but not yet configured;"
20441 msgid "B<C> half-configured (an error happened);"
20446 msgid "B<I> half-installed (an error happened)."
20451 msgid "Current and requested selections:"
20456 msgid "B<*> marked for installation or upgrade;"
20461 msgid "B<-> marked for removal, configuration files remain;"
20466 msgid "B<=> on hold: package will not be processed at all;"
20471 msgid "B<_> marked for purge, also remove configuration;"
20476 msgid "B<n> package is new and has yet to be marked."
20481 msgid "Cursor and screen movement"
20487 "The package selection list and the dependency conflict resolution screens "
20488 "can be navigated using motion commands mapped to the following keys:"
20493 msgid "B<p, Up, k> move cursor bar up"
20498 msgid "B<n, Down, j> move cursor bar down"
20503 msgid "B<P, Pgup, Backspace> scroll list 1 page up"
20508 msgid "B<N, Pgdn, Space> scroll list 1 page down"
20513 msgid "B<^p> scroll list 1 line up"
20518 msgid "B<^n> scroll list 1 line down"
20523 msgid "B<t, Home> jump to top of list"
20528 msgid "B<e, End> jump to end of list"
20533 msgid "B<u> scroll info 1 page up"
20538 msgid "B<d> scroll info 1 page down"
20543 msgid "B<^u> scroll info 1 line up"
20548 msgid "B<^d> scroll info 1 line down"
20553 msgid "B<B, Left-arrow> pan display 1/3 screen left"
20558 msgid "B<F, Right-arrow> pan display 1/3 screen right"
20563 msgid "B<^b> pan display 1 character left"
20568 msgid "B<^f> pan display 1 character right"
20573 msgid "Searching and sorting"
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."
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:"
20599 msgid "B<alphabet>"
20604 msgid "B<priority+section>"
20609 msgid "B<section+priority>"
20614 msgid "B<available>"
20619 msgid "B<available+priority>"
20624 msgid "B<available+section>"
20634 msgid "B<status+priority>"
20639 msgid "B<status+section>"
20645 "Where not listed above explicitly, alphabetic order is used as the final "
20646 "subordering sort key."
20651 msgid "Altering selections"
20657 "The requested selection state of individual packages may be altered with the "
20658 "following commands:"
20663 msgid "B<+, Insert> install or upgrade"
20668 msgid "B<=, H> hold in present state and version"
20673 msgid "B<:, G> unhold: upgrade or leave uninstalled"
20678 msgid "B<-, Delete> remove, but leave configuration"
20683 msgid "B<_> remove & purge configuration"
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."
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."
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."
20714 msgid "Resolving depends and conflicts"
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."
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 "
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>."
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."
20759 msgid "Establishing the requested selections"
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."
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."
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."
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."
20803 msgid "The requested command was successfully performed."
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)."
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)."
20823 "If set, B<dselect> will use it as the directory from which to read the user "
20824 "specific configuration file."
20830 "The B<dselect> package selection interface is confusing to some new users. "
20831 "Reportedly, it even makes seasoned kernel developers cry."
20836 msgid "The documentation is lacking."
20841 msgid "There is no help option in the main menu."
20846 msgid "The visible list of available packages cannot be reduced."
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."
20859 msgid "B<dpkg>(1), B<apt>(8), B<sources.list>(5), B<deb>(5)."
20863 #: start-stop-daemon.pod
20864 msgid "start-stop-daemon - start and stop system daemon programs"
20868 #: start-stop-daemon.pod
20869 msgid "B<start-stop-daemon> [I<option>...] I<command>"
20873 #: start-stop-daemon.pod
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 "
20882 #: start-stop-daemon.pod
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."
20895 #: start-stop-daemon.pod
20896 msgid "B<-S>, B<--start> [B<-->] I<arguments>"
20900 #: start-stop-daemon.pod
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."
20911 #: start-stop-daemon.pod
20912 msgid "B<-K>, B<--stop>"
20916 #: start-stop-daemon.pod
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 "
20927 #: start-stop-daemon.pod
20928 msgid "B<-T>, B<--status>"
20932 #: start-stop-daemon.pod
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)."
20939 #: start-stop-daemon.pod
20940 msgid "B<-H>, B<--help>"
20944 #: start-stop-daemon.pod
20945 msgid "Show usage information and exit."
20949 #: start-stop-daemon.pod
20950 msgid "B<-V>, B<--version>"
20954 #: start-stop-daemon.pod
20955 msgid "Show the program version and exit."
20959 #: start-stop-daemon.pod
20960 msgid "Matching options"
20964 #: start-stop-daemon.pod
20965 msgid "B<--pid> I<pid>"
20969 #: start-stop-daemon.pod
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."
20976 #: start-stop-daemon.pod
20977 msgid "B<--ppid> I<ppid>"
20981 #: start-stop-daemon.pod
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."
20988 #: start-stop-daemon.pod
20989 msgid "B<-p>, B<--pidfile> I<pidfile>"
20993 #: start-stop-daemon.pod
20994 msgid "Check whether a process has created the file I<pidfile>."
20998 #: start-stop-daemon.pod
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 "
21006 #: start-stop-daemon.pod
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 "
21019 #: start-stop-daemon.pod
21020 msgid "B<-x>, B<--exec> I<executable>"
21024 #: start-stop-daemon.pod
21026 "Check for processes that are instances of this I<executable>. The "
21027 "I<executable> argument should be an absolute pathname."
21031 #: start-stop-daemon.pod
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."
21040 #: start-stop-daemon.pod
21041 msgid "B<-n>, B<--name> I<process-name>"
21045 #: start-stop-daemon.pod
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 "
21053 #: start-stop-daemon.pod
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)."
21061 #: start-stop-daemon.pod
21062 msgid "B<-u>, B<--user> I<username>|I<uid>"
21066 #: start-stop-daemon.pod
21067 msgid "Check for processes owned by the user specified by I<username> or I<uid>."
21071 #: start-stop-daemon.pod
21073 "B<Note:> Using this matching option alone will cause all processes matching "
21074 "the user to be acted on."
21078 #: start-stop-daemon.pod
21079 msgid "Generic options"
21083 #: start-stop-daemon.pod
21084 msgid "B<-g>, B<--group> I<group>|I<gid>"
21088 #: start-stop-daemon.pod
21089 msgid "Change to I<group> or I<gid> when starting the process."
21093 #: start-stop-daemon.pod
21094 msgid "B<-s>, B<--signal> I<signal>"
21098 #: start-stop-daemon.pod
21100 "With B<--stop>, specifies the signal to send to processes being stopped "
21105 #: start-stop-daemon.pod
21106 msgid "B<-R>, B<--retry> I<timeout>|I<schedule>"
21110 #: start-stop-daemon.pod
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."
21119 #: start-stop-daemon.pod
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>."
21127 #: start-stop-daemon.pod
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."
21137 #: start-stop-daemon.pod
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."
21145 #: start-stop-daemon.pod
21146 msgid "B<-a>, B<--startas> I<pathname>"
21150 #: start-stop-daemon.pod
21152 "With B<--start>, start the process specified by I<pathname>. If not "
21153 "specified, defaults to the argument given to B<--exec>."
21157 #: start-stop-daemon.pod
21158 msgid "B<-t>, B<--test>"
21162 #: start-stop-daemon.pod
21164 "Print actions that would be taken and set appropriate return value, but take "
21169 #: start-stop-daemon.pod
21170 msgid "B<-o>, B<--oknodo>"
21174 #: start-stop-daemon.pod
21175 msgid "Return exit status 0 instead of 1 if no actions are (would be) taken."
21179 #: start-stop-daemon.pod
21180 msgid "B<-q>, B<--quiet>"
21184 #: start-stop-daemon.pod
21185 msgid "Do not print informational messages; only display error messages."
21189 #: start-stop-daemon.pod
21190 msgid "B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]"
21194 #: start-stop-daemon.pod
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 "
21208 #: start-stop-daemon.pod
21209 msgid "B<-r>, B<--chroot> I<root>"
21213 #: start-stop-daemon.pod
21215 "Change directory and chroot to I<root> before starting the process. Please "
21216 "note that the pidfile is also written after the chroot."
21220 #: start-stop-daemon.pod
21221 msgid "B<-d>, B<--chdir> I<path>"
21225 #: start-stop-daemon.pod
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."
21234 #: start-stop-daemon.pod
21235 msgid "B<-b>, B<--background>"
21239 #: start-stop-daemon.pod
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."
21247 #: start-stop-daemon.pod
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."
21256 #: start-stop-daemon.pod
21257 msgid "B<--notify-await>"
21261 #: start-stop-daemon.pod
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:"
21270 #: start-stop-daemon.pod
21275 #: start-stop-daemon.pod
21276 msgid "The program is ready to give service, so we can exit safely."
21280 #: start-stop-daemon.pod
21281 msgid "B<EXTEND_TIMEOUT_USEC=>I<number>"
21285 #: start-stop-daemon.pod
21287 "The program requests to extend the timeout by I<number> microseconds. This "
21288 "will reset the current timeout to the specified value."
21292 #: start-stop-daemon.pod
21293 msgid "B<ERRNO=>I<number>"
21297 #: start-stop-daemon.pod
21299 "The program is exiting with an error. Do the same and print the "
21300 "user-friendly string for the B<errno> value."
21304 #: start-stop-daemon.pod
21305 msgid "B<--notify-timeout> I<timeout>"
21309 #: start-stop-daemon.pod
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> "
21318 #: start-stop-daemon.pod
21319 msgid "B<-C>, B<--no-close>"
21323 #: start-stop-daemon.pod
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>."
21332 #: start-stop-daemon.pod
21333 msgid "B<-O>, B<--output> I<pathname>"
21337 #: start-stop-daemon.pod
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 "
21345 #: start-stop-daemon.pod
21346 msgid "B<-N>, B<--nicelevel> I<int>"
21350 #: start-stop-daemon.pod
21351 msgid "This alters the priority of the process before starting it."
21355 #: start-stop-daemon.pod
21356 msgid "B<-P>, B<--procsched> I<policy>B<:>I<priority>"
21360 #: start-stop-daemon.pod
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>."
21369 #: start-stop-daemon.pod
21371 "This option might do nothing on some systems, where POSIX process scheduling "
21372 "is not supported."
21376 #: start-stop-daemon.pod
21377 msgid "B<-I>, B<--iosched> I<class>B<:>I<priority>"
21381 #: start-stop-daemon.pod
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 "
21392 #: start-stop-daemon.pod
21394 "This option might do nothing on some systems, where Linux IO scheduling is "
21399 #: start-stop-daemon.pod
21400 msgid "B<-k>, B<--umask> I<mask>"
21404 #: start-stop-daemon.pod
21406 "This sets the umask of the process before starting it (since version "
21411 #: start-stop-daemon.pod
21412 msgid "B<-m>, B<--make-pidfile>"
21416 #: start-stop-daemon.pod
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."
21426 #: start-stop-daemon.pod
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."
21434 #: start-stop-daemon.pod
21435 msgid "B<--remove-pidfile>"
21439 #: start-stop-daemon.pod
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."
21447 #: start-stop-daemon.pod
21448 msgid "Print verbose informational messages."
21452 #: start-stop-daemon.pod
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."
21461 #: start-stop-daemon.pod
21462 msgid "If B<--oknodo> was not specified and nothing was done."
21466 #: start-stop-daemon.pod
21468 "If B<--stop> and B<--retry> were specified, but the end of the schedule was "
21469 "reached and the processes were still running."
21473 #: start-stop-daemon.pod
21478 #: start-stop-daemon.pod
21479 msgid "Any other error."
21483 #: start-stop-daemon.pod
21484 msgid "When using the B<--status> command, the following status codes are returned:"
21488 #: start-stop-daemon.pod
21489 msgid "Program is running."
21493 #: start-stop-daemon.pod
21494 msgid "Program is not running and the pid file exists."
21498 #: start-stop-daemon.pod
21499 msgid "Program is not running."
21503 #: start-stop-daemon.pod
21508 #: start-stop-daemon.pod
21509 msgid "Unable to determine program status."
21513 #: start-stop-daemon.pod
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):"
21520 #: start-stop-daemon.pod
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"
21530 #: start-stop-daemon.pod
21531 msgid "Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:"
21535 #: start-stop-daemon.pod
21538 " start-stop-daemon --stop --oknodo --user food --name food \\\n"
21539 " --pidfile %RUNSTATEDIR%/food.pid --retry 5\n"
21544 #: start-stop-daemon.pod
21545 msgid "Demonstration of a custom schedule for stopping B<food>:"
21549 #: start-stop-daemon.pod
21552 " start-stop-daemon --stop --oknodo --user food --name food \\\n"
21553 " --pidfile %RUNSTATEDIR%/food.pid --retry=TERM/30/KILL/5\n"
21558 #: update-alternatives.pod
21559 msgid "update-alternatives - maintain symbolic links determining default commands"
21563 #: update-alternatives.pod
21564 msgid "B<update-alternatives> [I<option>...] I<command>"
21568 #: update-alternatives.pod
21570 "B<update-alternatives> creates, removes, maintains and displays information "
21571 "about the symbolic links comprising the Debian alternatives system."
21575 #: update-alternatives.pod
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."
21586 #: update-alternatives.pod
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."
21601 #: update-alternatives.pod
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."
21612 #: update-alternatives.pod
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."
21628 #: update-alternatives.pod
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>."
21641 #: update-alternatives.pod
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)."
21652 #: update-alternatives.pod
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 "
21662 #: update-alternatives.pod
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."
21670 #: update-alternatives.pod
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)."
21682 #: update-alternatives.pod
21684 "If you want to configure non-interactively you can use the B<--set> option "
21685 "instead (see below)."
21689 #: update-alternatives.pod
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."
21698 #: update-alternatives.pod
21699 msgid "TERMINOLOGY"
21703 #: update-alternatives.pod
21705 "Since the activities of B<update-alternatives> are quite involved, some "
21706 "specific terms will help to explain its operation."
21710 #: update-alternatives.pod
21711 msgid "generic name (or alternative link)"
21715 #: update-alternatives.pod
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."
21722 #: update-alternatives.pod
21723 msgid "alternative name"
21727 #: update-alternatives.pod
21728 msgid "The name of a symbolic link in the alternatives directory."
21732 #: update-alternatives.pod
21733 msgid "alternative (or alternative path)"
21737 #: update-alternatives.pod
21739 "The name of a specific file in the filesystem, which may be made accessible "
21740 "via a generic name using the alternatives system."
21744 #: update-alternatives.pod
21745 msgid "alternatives directory"
21749 #: update-alternatives.pod
21750 msgid "A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks."
21754 #: update-alternatives.pod
21755 msgid "administrative directory"
21759 #: update-alternatives.pod
21761 "A directory, by default I<%ADMINDIR%/alternatives>, containing "
21762 "B<update-alternatives>' state information."
21766 #: update-alternatives.pod
21771 #: update-alternatives.pod
21772 msgid "A set of related symlinks, intended to be updated as a group."
21776 #: update-alternatives.pod
21777 msgid "master link"
21781 #: update-alternatives.pod
21783 "The alternative link in a link group which determines how the other links in "
21784 "the group are configured."
21788 #: update-alternatives.pod
21793 #: update-alternatives.pod
21795 "An alternative link in a link group which is controlled by the setting of "
21800 #: update-alternatives.pod
21801 msgid "automatic mode"
21805 #: update-alternatives.pod
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 "
21813 #: update-alternatives.pod
21814 msgid "manual mode"
21818 #: update-alternatives.pod
21820 "When a link group is in manual mode, the alternatives system will not make "
21821 "any changes to the system administrator's settings."
21825 #: update-alternatives.pod
21826 msgid "B<--install> I<link name path priority> [B<--slave> I<link name path>]..."
21830 #: update-alternatives.pod
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."
21846 #: update-alternatives.pod
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."
21858 #: update-alternatives.pod
21859 msgid "B<--set> I<name> I<path>"
21863 #: update-alternatives.pod
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."
21870 #: update-alternatives.pod
21871 msgid "B<--remove> I<name> I<path>"
21875 #: update-alternatives.pod
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."
21888 #: update-alternatives.pod
21889 msgid "B<--remove-all> I<name>"
21893 #: update-alternatives.pod
21895 "Remove all alternatives and all of their associated slave links. I<name> is "
21896 "a name in the alternatives directory."
21900 #: update-alternatives.pod
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>."
21910 #: update-alternatives.pod
21911 msgid "B<--auto> I<name>"
21915 #: update-alternatives.pod
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."
21923 #: update-alternatives.pod
21924 msgid "B<--display> I<name>"
21928 #: update-alternatives.pod
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."
21938 #: update-alternatives.pod
21939 msgid "B<--get-selections>"
21943 #: update-alternatives.pod
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)."
21954 #: update-alternatives.pod
21956 "Read configuration of alternatives on standard input in the format generated "
21957 "by B<--get-selections> and reconfigure them accordingly (since version "
21962 #: update-alternatives.pod
21963 msgid "B<--query> I<name>"
21967 #: update-alternatives.pod
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> "
21975 #: update-alternatives.pod
21976 msgid "B<--list> I<name>"
21980 #: update-alternatives.pod
21981 msgid "Display all targets of the link group."
21985 #: update-alternatives.pod
21986 msgid "B<--config> I<name>"
21990 #: update-alternatives.pod
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."
21997 #: update-alternatives.pod
21998 msgid "B<--altdir> I<directory>"
22002 #: update-alternatives.pod
22004 "Specifies the alternatives directory, when this is to be different from the "
22005 "default. Defaults to «I<%CONFDIR%/alternatives>»."
22009 #: update-alternatives.pod
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."
22017 #: update-alternatives.pod
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."
22025 #: update-alternatives.pod
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."
22033 #: update-alternatives.pod
22034 msgid "B<--log> I<file>"
22038 #: update-alternatives.pod
22040 "Specifies the log file (since version 1.15.0), when this is to be different "
22041 "from the default (%LOGDIR%/alternatives.log)."
22045 #: update-alternatives.pod
22047 "Allow replacing or dropping any real file that is installed where an "
22048 "alternative link has to be installed or removed."
22052 #: update-alternatives.pod
22053 msgid "B<--skip-auto>"
22057 #: update-alternatives.pod
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>."
22064 #: update-alternatives.pod
22065 msgid "Do not generate any comments unless errors occur."
22069 #: update-alternatives.pod
22070 msgid "B<--verbose>"
22074 #: update-alternatives.pod
22075 msgid "Generate more comments about what is being done."
22079 #: update-alternatives.pod
22081 "Generate even more comments, helpful for debugging, about what is being done "
22082 "(since version 1.19.3)."
22086 #: update-alternatives.pod
22088 "Problems were encountered whilst parsing the command line or performing the "
22093 #: update-alternatives.pod
22094 msgid "B<%INSTDIR_ENVVAR%>"
22098 #: update-alternatives.pod
22099 msgid "B<%ADMINDIR_ENVVAR%>"
22103 #: update-alternatives.pod
22105 "If set and the B<--admindir> option has not been specified, it will be used "
22106 "as the base administrative directory."
22110 #: update-alternatives.pod
22111 msgid "I<%CONFDIR%/alternatives/>"
22115 #: update-alternatives.pod
22117 "The default alternatives directory. Can be overridden by the B<--altdir> "
22122 #: update-alternatives.pod
22123 msgid "I<%ADMINDIR%/alternatives/>"
22127 #: update-alternatives.pod
22129 "The default administration directory. Can be overridden by the "
22130 "B<--admindir> option."
22134 #: update-alternatives.pod
22135 msgid "QUERY FORMAT"
22139 #: update-alternatives.pod
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:"
22147 #: update-alternatives.pod
22148 msgid "B<Name:> I<name>"
22152 #: update-alternatives.pod
22153 msgid "The alternative name in the alternative directory."
22157 #: update-alternatives.pod
22158 msgid "B<Link:> I<link>"
22162 #: update-alternatives.pod
22163 msgid "The generic name of the alternative."
22167 #: update-alternatives.pod
22168 msgid "B<Slaves:> I<list-of-slaves>"
22172 #: update-alternatives.pod
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."
22181 #: update-alternatives.pod
22182 msgid "B<Status:> I<status>"
22186 #: update-alternatives.pod
22187 msgid "The status of the alternative (B<auto> or B<manual>)."
22191 #: update-alternatives.pod
22192 msgid "B<Best:> I<best-choice>"
22196 #: update-alternatives.pod
22198 "The path of the best alternative for this link group. Not present if there "
22199 "is no alternatives available."
22203 #: update-alternatives.pod
22204 msgid "B<Value:> I<currently-selected-alternative>"
22208 #: update-alternatives.pod
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."
22215 #: update-alternatives.pod
22217 "The other stanzas describe the available alternatives in the queried link "
22222 #: update-alternatives.pod
22223 msgid "B<Alternative:> I<path-of-this-alternative>"
22227 #: update-alternatives.pod
22228 msgid "Path to this stanza's alternative."
22232 #: update-alternatives.pod
22233 msgid "B<Priority:> I<priority-value>"
22237 #: update-alternatives.pod
22238 msgid "Value of the priority of this alternative."
22242 #: update-alternatives.pod
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."
22251 #: update-alternatives.pod
22256 #: update-alternatives.pod
22259 " $ update-alternatives --query editor\n"
22261 " Link: /usr/bin/editor\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"
22269 " Best: /usr/bin/vim.basic\n"
22270 " Value: /usr/bin/vim.basic\n"
22275 #: update-alternatives.pod
22278 " Alternative: /bin/ed\n"
22279 " Priority: -100\n"
22281 " editor.1.gz /usr/share/man/man1/ed.1.gz\n"
22286 #: update-alternatives.pod
22289 " Alternative: /usr/bin/vim.basic\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"
22301 #: update-alternatives.pod
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."
22311 #: update-alternatives.pod
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."
22320 #: update-alternatives.pod
22322 "To display the available packages which provide B<vi> and the current "
22323 "setting for it, use the B<--display> action:"
22327 #: update-alternatives.pod
22330 " update-alternatives --display vi\n"
22335 #: update-alternatives.pod
22337 "To choose a particular B<vi> implementation, use this command as root and "
22338 "then select a number from the list:"
22342 #: update-alternatives.pod
22345 " update-alternatives --config vi\n"
22350 #: update-alternatives.pod
22352 "To go back to having the B<vi> implementation chosen automatically, do this "
22357 #: update-alternatives.pod
22360 " update-alternatives --auto vi\n"
22365 #: update-alternatives.pod
22366 msgid "B<ln>(1), FHS (the Filesystem Hierarchy Standard)."