1# Simplified Chinese translation to dpkg-man. 2# This file is distributed under the same license as the dpkg package. 3# 4# Copyrights: 5# Zhou Mo <cdluminate@gmail.com>, 2014. 6# 7msgid "" 8msgstr "" 9"Project-Id-Version: dpkg-man 1.17.21\n" 10"Report-Msgid-Bugs-To: debian-dpkg@lists.debian.org\n" 11"POT-Creation-Date: 2019-03-25 15:07+0100\n" 12"PO-Revision-Date: 2019-02-24 18:25+0100\n" 13"Last-Translator: Zhou Mo <cdluminate@gmail.com>\n" 14"Language-Team: Chinese (simplified) <debian-l10n-chinese@lists.debian.org>\n" 15"Language: zh_CN\n" 16"MIME-Version: 1.0\n" 17"Content-Type: text/plain; charset=UTF-8\n" 18"Content-Transfer-Encoding: 8bit\n" 19"Plural-Forms: nplurals=1; plural=0;\n" 20 21#. type: TH 22#: deb.man 23#, no-wrap 24msgid "deb" 25msgstr "deb" 26 27#. type: TH 28#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 29#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 30#: deb-split.man deb-version.man deb-old.man deb-origin.man deb-override.man 31#: deb-extra-override.man deb-shlibs.man deb-substvars.man deb-symbols.man 32#: deb-postinst.man deb-postrm.man deb-preinst.man deb-prerm.man 33#: deb-triggers.man dsc.man dpkg.man dpkg-architecture.man dpkg.cfg.man 34#: dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 35#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 36#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 37#: dpkg-maintscript-helper.man dpkg-mergechangelogs.man dpkg-name.man 38#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 39#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 40#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 41#: dselect.cfg.man start-stop-daemon.man update-alternatives.man 42#, no-wrap 43msgid "%RELEASE_DATE%" 44msgstr "" 45 46#. type: TH 47#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 48#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 49#: deb-split.man deb-version.man deb-old.man deb-origin.man deb-override.man 50#: deb-extra-override.man deb-shlibs.man deb-substvars.man deb-symbols.man 51#: deb-postinst.man deb-postrm.man deb-preinst.man deb-prerm.man 52#: deb-triggers.man dsc.man dpkg.man dpkg-architecture.man dpkg.cfg.man 53#: dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 54#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 55#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 56#: dpkg-maintscript-helper.man dpkg-mergechangelogs.man dpkg-name.man 57#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 58#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 59#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 60#: dselect.cfg.man start-stop-daemon.man update-alternatives.man 61#, no-wrap 62msgid "%VERSION%" 63msgstr "" 64 65#. type: TH 66#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 67#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 68#: deb-split.man deb-version.man deb-old.man deb-origin.man deb-override.man 69#: deb-extra-override.man deb-shlibs.man deb-substvars.man deb-symbols.man 70#: deb-postinst.man deb-postrm.man deb-preinst.man deb-prerm.man 71#: deb-triggers.man dsc.man dpkg.man dpkg-architecture.man dpkg.cfg.man 72#: dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 73#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 74#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 75#: dpkg-maintscript-helper.man dpkg-mergechangelogs.man dpkg-name.man 76#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 77#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 78#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 79#: dselect.cfg.man start-stop-daemon.man update-alternatives.man 80#, no-wrap 81msgid "dpkg suite" 82msgstr "dpkg 软件集" 83 84#. type: SH 85#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 86#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 87#: deb-src-rules.man deb-split.man deb-version.man deb-old.man deb-origin.man 88#: deb-override.man deb-extra-override.man deb-shlibs.man deb-substvars.man 89#: deb-symbols.man deb-postinst.man deb-postrm.man deb-preinst.man 90#: deb-prerm.man deb-triggers.man dsc.man dpkg.man dpkg-architecture.man 91#: dpkg.cfg.man dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 92#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 93#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 94#: dpkg-maintscript-helper.man dpkg-mergechangelogs.man dpkg-name.man 95#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 96#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 97#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 98#: dselect.cfg.man start-stop-daemon.man update-alternatives.man 99#, no-wrap 100msgid "NAME" 101msgstr "名称" 102 103#. type: Plain text 104#: deb.man 105msgid "deb - Debian binary package format" 106msgstr "deb - Debian 二进制包格式" 107 108#. type: SH 109#: deb.man deb-buildinfo.man deb-changelog.man deb-changes.man deb-control.man 110#: deb-conffiles.man deb-src-control.man deb-src-files.man deb-src-rules.man 111#: deb-split.man deb-version.man deb-old.man deb-origin.man deb-override.man 112#: deb-extra-override.man deb-substvars.man deb-symbols.man deb-postinst.man 113#: deb-postrm.man deb-preinst.man deb-prerm.man deb-triggers.man dsc.man 114#: dpkg.man dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 115#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 116#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 117#: dpkg-gensymbols.man dpkg-maintscript-helper.man dpkg-mergechangelogs.man 118#: dpkg-name.man dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 119#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 120#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 121#: start-stop-daemon.man update-alternatives.man 122#, no-wrap 123msgid "SYNOPSIS" 124msgstr "概要" 125 126#. type: Plain text 127#: deb.man deb-split.man deb-old.man 128msgid "I<filename>B<.deb>" 129msgstr "I<filename>B<.deb>" 130 131#. type: SH 132#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 133#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 134#: deb-src-rules.man deb-split.man deb-version.man deb-old.man deb-origin.man 135#: deb-override.man deb-extra-override.man deb-shlibs.man deb-substvars.man 136#: deb-symbols.man deb-postinst.man deb-postrm.man deb-preinst.man 137#: deb-prerm.man deb-triggers.man dsc.man dpkg.man dpkg-architecture.man 138#: dpkg.cfg.man dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 139#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 140#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 141#: dpkg-maintscript-helper.man dpkg-mergechangelogs.man dpkg-name.man 142#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 143#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 144#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 145#: dselect.cfg.man start-stop-daemon.man update-alternatives.man 146#, no-wrap 147msgid "DESCRIPTION" 148msgstr "描述" 149 150#. type: Plain text 151#: deb.man 152msgid "" 153"The B<.deb> format is the Debian binary package file format. It is " 154"understood since dpkg 0.93.76, and is generated by default since dpkg 1.2.0 " 155"and 1.1.1elf (i386/ELF builds)." 156msgstr "" 157"B<.deb> 格式是 Debian 的二进制软件包文件格式。此类文件被 dpkg 0.93.76 以上的" 158"版本支持，自 dpkg 1.2.0 和 dpkg 1.1.1elf (i386/ELF builds)之后，它也作为默认" 159"的生成文件格式。" 160 161#. type: Plain text 162#: deb.man 163msgid "" 164"The format described here is used since Debian 0.93; details of the old " 165"format are described in B<deb-old>(5)." 166msgstr "" 167"此处描述的格式在 Debian 0.93 之后启用；关于这个旧版格式的细节，请参见 B<deb-" 168"old>(5)。" 169 170#. type: SH 171#: deb.man deb-split.man deb-old.man 172#, no-wrap 173msgid "FORMAT" 174msgstr "格式" 175 176#. type: Plain text 177#: deb.man 178msgid "" 179"The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. Only " 180"the common B<ar> archive format is supported, with no long file name " 181"extensions, but with file names containing an optional trailing slash, which " 182"limits their length to 15 characters (from the 16 allowed). File sizes are " 183"limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 " 184"MiB member files." 185msgstr "" 186"此类文件是带有体系结构 B<!E<lt>archE<gt>> 魔数(magic value)的 B<ar> 归档。仅" 187"有通用 B<ar> 归档格式被支持，亦即，无长文件名扩展，但文件名可以选择尾缀一个斜" 188"杠(/)，从而将文件名长度限制为15字符（总共允许16字符）。文件大小限制为10个 " 189"ASCII 十进制数字，这使得最大可容纳 9536.74 MiB 的成员文件。" 190 191#. type: Plain text 192#: deb.man 193#, fuzzy 194#| msgid "" 195#| "The B<tar> archives currently allowed are, the old-style (v7) format, the " 196#| "pre-POSIX ustar format, a subset of the GNU format (only the new style " 197#| "long pathnames and long linknames, supported since dpkg 1.4.1.17), and " 198#| "the POSIX ustar format (long names supported since dpkg 1.15.0). " 199#| "Unrecognized tar typeflags are considered an error." 200msgid "" 201"The B<tar> archives currently allowed are, the old-style (v7) format, the " 202"pre-POSIX ustar format, a subset of the GNU format (new style long pathnames " 203"and long linknames, supported since dpkg 1.4.1.17; large file metadata since " 204"dpkg 1.18.24), and the POSIX ustar format (long names supported since dpkg " 205"1.15.0). Unrecognized tar typeflags are considered an error. Each tar " 206"entry size inside a tar archive is limited to 11 ASCII octal digits, " 207"allowing for up to 8 GiB tar entries. The GNU large file metadata support " 208"permits 95-bit tar entry sizes and negative timestamps, and 63-bit UID, GID " 209"and device numbers." 210msgstr "" 211"当前可用的 B<tar> 归档版本有，旧版(v7)、pre-POSIX ustar 版本，这是一个GNU格式" 212"的子集（只有自 dpkg 1.4.1.17 之后，新版长路径名和长链接名才被支持），以及 " 213"POSIX ustar 格式（自 dpkg 1.15.0 后支持长名称）。不被识别的 tar 类型标志将会" 214"导致错误。" 215 216#. type: Plain text 217#: deb.man 218msgid "" 219"The first member is named B<debian-binary> and contains a series of lines, " 220"separated by newlines. Currently only one line is present, the format " 221"version number, B<2.0> at the time this manual page was written. Programs " 222"which read new-format archives should be prepared for the minor number to be " 223"increased and new lines to be present, and should ignore these if this is " 224"the case." 225msgstr "" 226 227#. type: Plain text 228#: deb.man 229msgid "" 230"If the major number has changed, an incompatible change has been made and " 231"the program should stop. If it has not, then the program should be able to " 232"safely continue, unless it encounters an unexpected member in the archive " 233"(except at the end), as described below." 234msgstr "" 235 236#. type: Plain text 237#: deb.man 238msgid "" 239"The second required member is named B<control.tar>. It is a tar archive " 240"containing the package control information, either not compressed (supported " 241"since dpkg 1.17.6), or compressed with gzip (with B<.gz> extension) or xz " 242"(with B<.xz> extension, supported since 1.17.6), as a series of plain files, " 243"of which the file B<control> is mandatory and contains the core control " 244"information, the B<conffiles>, B<triggers>, B<shlibs> and B<symbols> files " 245"contain optional control information, and the B<preinst>, B<postinst>, " 246"B<prerm> and B<postrm> files are optional maintainer scripts. The control " 247"tarball may optionally contain an entry for ‘B<.>’, the current directory." 248msgstr "" 249 250#. type: Plain text 251#: deb.man 252msgid "" 253"The third, last required member is named B<data.tar>. It contains the " 254"filesystem as a tar archive, either not compressed (supported since dpkg " 255"1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> " 256"extension, supported since dpkg 1.15.6), bzip2 (with B<.bz2> extension, " 257"supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported " 258"since dpkg 1.13.25)." 259msgstr "" 260 261#. type: Plain text 262#: deb.man 263msgid "" 264"These members must occur in this exact order. Current implementations should " 265"ignore any additional members after B<data.tar>. Further members may be " 266"defined in the future, and (if possible) will be placed after these three. " 267"Any additional members that may need to be inserted after B<debian-binary> " 268"and before B<control.tar> or B<data.tar> and which should be safely ignored " 269"by older programs, will have names starting with an underscore, ‘B<_>’." 270msgstr "" 271 272#. type: Plain text 273#: deb.man 274msgid "" 275"Those new members which won't be able to be safely ignored will be inserted " 276"before B<data.tar> with names starting with something other than " 277"underscores, or will (more likely) cause the major version number to be " 278"increased." 279msgstr "" 280 281#. type: SH 282#: deb.man 283#, no-wrap 284msgid "MEDIA TYPE" 285msgstr "媒体类型" 286 287#. type: SS 288#: deb.man 289#, no-wrap 290msgid "Current" 291msgstr "Current" 292 293#. type: Plain text 294#: deb.man 295msgid "application/vnd.debian.binary-package" 296msgstr "application/vnd.debian.binary-package" 297 298#. type: SS 299#: deb.man 300#, no-wrap 301msgid "Deprecated" 302msgstr "Deprecated" 303 304#. type: Plain text 305#: deb.man 306msgid "application/x-debian-package" 307msgstr "application/x-debian-package" 308 309#. type: Plain text 310#: deb.man 311msgid "application/x-deb" 312msgstr "application/x-deb" 313 314#. type: SH 315#: deb.man deb822.man deb-buildinfo.man deb-changelog.man deb-changes.man 316#: deb-control.man deb-conffiles.man deb-src-control.man deb-src-files.man 317#: deb-src-rules.man deb-split.man deb-version.man deb-old.man deb-origin.man 318#: deb-override.man deb-extra-override.man deb-shlibs.man deb-substvars.man 319#: deb-symbols.man deb-postinst.man deb-postrm.man deb-preinst.man 320#: deb-prerm.man deb-triggers.man dsc.man dpkg.man dpkg-architecture.man 321#: dpkg.cfg.man dpkg-buildpackage.man dpkg-genbuildinfo.man 322#: dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man dpkg-genchanges.man 323#: dpkg-gencontrol.man dpkg-gensymbols.man dpkg-maintscript-helper.man 324#: dpkg-name.man dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 325#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 326#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 327#: dselect.cfg.man update-alternatives.man 328#, no-wrap 329msgid "SEE ALSO" 330msgstr "参考" 331 332#. type: Plain text 333#: deb.man 334msgid "" 335"B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5), B<deb-conffiles>(5) B<deb-" 336"triggers>(5), B<deb-shlibs>(5), B<deb-symbols>(5), B<deb-preinst>(5), B<deb-" 337"postinst>(5), B<deb-prerm>(5), B<deb-postrm>(5)." 338msgstr "" 339 340#. type: TH 341#: deb822.man 342#, no-wrap 343msgid "deb822" 344msgstr "" 345 346#. type: Plain text 347#: deb822.man 348#, fuzzy 349#| msgid "deb - Debian binary package format" 350msgid "deb822 - Debian RFC822 control data format" 351msgstr "deb - Debian 二进制包格式" 352 353#. type: Plain text 354#: deb822.man 355msgid "" 356"The package management system manipulates data represented in a common " 357"format, known as I<control data>, stored in I<control files>. Control files " 358"are used for source packages, binary packages and the B<.changes> files " 359"which control the installation of uploaded files (B<dpkg>'s internal " 360"databases are in a similar format)." 361msgstr "" 362 363#. type: SH 364#: deb822.man 365#, no-wrap 366msgid "SYNTAX" 367msgstr "" 368 369#. type: Plain text 370#: deb822.man 371msgid "" 372"A control file consists of one or more paragraphs of fields (the paragraphs " 373"are also sometimes referred to as stanzas). The paragraphs are separated by " 374"empty lines. Parsers may accept lines consisting solely of U+0020 B<SPACE> " 375"and U+0009 B<TAB> as paragraph separators, but control files should use " 376"empty lines. Some control files allow only one paragraph; others allow " 377"several, in which case each paragraph usually refers to a different " 378"package. (For example, in source packages, the first paragraph refers to " 379"the source package, and later paragraphs refer to binary packages generated " 380"from the source.) The ordering of the paragraphs in control files is " 381"significant." 382msgstr "" 383 384#. type: Plain text 385#: deb822.man 386msgid "" 387"Each paragraph consists of a series of data fields. Each field consists of " 388"the field name followed by a colon (U+003A ‘B<:>’), and then the data/value " 389"associated with that field. The field name is composed of US-ASCII " 390"characters excluding control characters, space, and colon (i.e., characters " 391"in the ranges U+0021 ‘B<!>’ through U+0039 ‘B<9>’, and U+003B ‘B<;>’ through " 392"U+007E ‘B<~>’, inclusive). Field names must not begin with the comment " 393"character (U+0023 ‘B<#>’), nor with the hyphen character (U+002D ‘B<->’)." 394msgstr "" 395 396#. type: Plain text 397#: deb822.man 398msgid "" 399"The field ends at the end of the line or at the end of the last continuation " 400"line (see below). Horizontal whitespace (U+0020 B<SPACE> and U+0009 B<TAB>) " 401"may occur immediately before or after the value and is ignored there; it is " 402"conventional to put a single space after the colon. For example, a field " 403"might be:" 404msgstr "" 405 406#. type: Plain text 407#: deb822.man 408#, fuzzy, no-wrap 409#| msgid "Package flags" 410msgid "Package: dpkg\n" 411msgstr "软件包标志" 412 413#. type: Plain text 414#: deb822.man 415msgid "the field name is B<Package> and the field value B<dpkg>." 416msgstr "" 417 418#. type: Plain text 419#: deb822.man 420msgid "" 421"Empty field values are only permitted in source package control files " 422"(I<debian/control>). Such fields are ignored." 423msgstr "" 424 425#. type: Plain text 426#: deb822.man 427msgid "" 428"A paragraph must not contain more than one instance of a particular field " 429"name." 430msgstr "" 431 432#. type: Plain text 433#: deb822.man 434msgid "There are three types of fields:" 435msgstr "" 436 437#. type: TP 438#: deb822.man 439#, no-wrap 440msgid "B<simple>" 441msgstr "" 442 443#. type: Plain text 444#: deb822.man 445msgid "" 446"The field, including its value, must be a single line. Folding of the field " 447"is not permitted. This is the default field type if the definition of the " 448"field does not specify a different type." 449msgstr "" 450 451#. type: TP 452#: deb822.man 453#, no-wrap 454msgid "B<folded>" 455msgstr "" 456 457#. type: Plain text 458#: deb822.man 459msgid "" 460"The value of a folded field is a logical line that may span several lines. " 461"The lines after the first are called continuation lines and must start with " 462"a U+0020 B<SPACE> or a U+0009 B<TAB>. Whitespace, including any newlines, " 463"is not significant in the field values of folded fields." 464msgstr "" 465 466#. type: Plain text 467#: deb822.man 468msgid "" 469"This folding method is similar to RFC5322, allowing control files that " 470"contain only one paragraph and no multiline fields to be read by parsers " 471"written for RFC5322." 472msgstr "" 473 474#. type: TP 475#: deb822.man 476#, fuzzy, no-wrap 477#| msgid "B<half-configured>" 478msgid "B<multiline>" 479msgstr "B<half-configured>" 480 481#. type: Plain text 482#: deb822.man 483msgid "" 484"The value of a multiline field may comprise multiple continuation lines. " 485"The first line of the value, the part on the same line as the field name, " 486"often has special significance or may have to be empty. Other lines are " 487"added following the same syntax as the continuation lines of the folded " 488"fields. Whitespace, including newlines, is significant in the values of " 489"multiline fields." 490msgstr "" 491 492#. type: Plain text 493#: deb822.man 494msgid "" 495"Whitespace must not appear inside names (of packages, architectures, files " 496"or anything else) or version numbers, or between the characters of multi-" 497"character version relationships." 498msgstr "" 499 500#. type: Plain text 501#: deb822.man 502msgid "" 503"The presence and purpose of a field, and the syntax of its value may differ " 504"between types of control files." 505msgstr "" 506 507#. type: Plain text 508#: deb822.man 509msgid "" 510"Field names are not case-sensitive, but it is usual to capitalize the field " 511"names using mixed case as shown below. Field values are case-sensitive " 512"unless the description of the field says otherwise." 513msgstr "" 514 515#. type: Plain text 516#: deb822.man 517msgid "" 518"Paragraph separators (empty lines) and lines consisting only of U+0020 " 519"B<SPACE> and U+0009 B<TAB>, are not allowed within field values or between " 520"fields. Empty lines in field values are usually escaped by representing " 521"them by a U+0020 B<SPACE> followed by a dot (U+002E ‘B<.>’)." 522msgstr "" 523 524#. type: Plain text 525#: deb822.man 526msgid "" 527"Lines starting with U+0023 ‘B<#>’, without any preceding whitespace are " 528"comments lines that are only permitted in source package control files " 529"(I<debian/control>) and in B<deb-origin>(5) files. These comment lines are " 530"ignored, even between two continuation lines. They do not end logical lines." 531msgstr "" 532 533#. type: Plain text 534#: deb822.man 535msgid "All control files must be encoded in UTF-8." 536msgstr "" 537 538#. type: Plain text 539#: deb822.man 540msgid "B<RFC822>, B<RFC5322>." 541msgstr "" 542 543#. type: TH 544#: deb-buildinfo.man 545#, no-wrap 546msgid "deb-buildinfo" 547msgstr "" 548 549#. type: Plain text 550#: deb-buildinfo.man 551#, fuzzy 552#| msgid "deb-control - Debian packages' master control file format" 553msgid "deb-buildinfo - Debian build information file format" 554msgstr "deb-control - Debian 软件包的主控文件格式" 555 556#. type: Plain text 557#: deb-buildinfo.man 558#, fuzzy 559#| msgid "I<filename>B<.deb>" 560msgid "I<filename>B<.buildinfo>" 561msgstr "I<filename>B<.deb>" 562 563#. type: Plain text 564#: deb-buildinfo.man 565msgid "" 566"Each Debian source package build can record the build information in a B<." 567"buildinfo> control file, which contains a number of fields. Each field " 568"begins with a tag, such as B<Source> or B<Binary> (case insensitive), " 569"followed by a colon, and the body of the field. Fields are delimited only " 570"by field tags. In other words, field text may be multiple lines in length, " 571"but the installation tools will generally join lines when processing the " 572"body of the field (except in case of the multiline fields B<Binary-Only-" 573"Changes>, B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>, " 574"B<Checksums-Sha1> and B<Checksums-Sha256>, see below)." 575msgstr "" 576 577#. type: Plain text 578#: deb-buildinfo.man deb-changes.man dsc.man 579msgid "" 580"The control data might be enclosed in an OpenPGP ASCII Armored signature, as " 581"specified in RFC4880." 582msgstr "" 583 584#. type: Plain text 585#: deb-buildinfo.man 586msgid "" 587"The name of the B<.buildinfo> file will depend on the type of build and will " 588"be as specific as necessary but not more; for a build that includes B<any> " 589"the name will be I<source-name>B<_>I<binary-version>B<_>I<arch>B<." 590"buildinfo>, or otherwise for a build that includes B<all> the name will be " 591"I<source-name>B<_>I<binary-version>B<_>B<all.buildinfo>, or otherwise for a " 592"build that includes B<source> the name will be I<source-name>B<_>I<source-" 593"version>B<_>B<source.buildinfo>." 594msgstr "" 595 596#. type: SH 597#: deb-buildinfo.man deb-changes.man deb-control.man deb-origin.man dsc.man 598#, fuzzy, no-wrap 599#| msgid "SOURCE FIELDS" 600msgid "FIELDS" 601msgstr "源码相关字段" 602 603#. type: TP 604#: deb-buildinfo.man deb-changes.man dsc.man 605#, fuzzy, no-wrap 606#| msgid "B<Version:>I< version-string>" 607msgid "B<Format:> I<format-version> (required)" 608msgstr "B<Version:>I< version-string>" 609 610#. type: Plain text 611#: deb-buildinfo.man 612msgid "" 613"The value of this field declares the format version of the file. The syntax " 614"of the field value is a version number with a major and minor component. " 615"Backward incompatible changes to the format will bump the major version, and " 616"backward compatible changes (such as field additions) will bump the minor " 617"version. The current format version is B<1.0>." 618msgstr "" 619 620#. type: TP 621#: deb-buildinfo.man deb-changes.man 622#, no-wrap 623msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>] (required)" 624msgstr "" 625 626#. type: Plain text 627#: deb-buildinfo.man 628msgid "" 629"The name of the source package. If the source version differs from the " 630"binary version, then the I<source-name> will be followed by a I<source-" 631"version> in parenthesis. This can happen when the build is for a binary-" 632"only non-maintainer upload." 633msgstr "" 634 635#. type: TP 636#: deb-buildinfo.man 637#, fuzzy, no-wrap 638#| msgid "B<Package:>I< package-name>" 639msgid "B<Binary:> I<binary-package-list> (required)" 640msgstr "B<Package:>I< package-name>" 641 642#. type: Plain text 643#: deb-buildinfo.man 644msgid "This folded field is a space-separated list of binary packages built." 645msgstr "" 646 647#. type: TP 648#: deb-buildinfo.man 649#, fuzzy, no-wrap 650#| msgid "B<--add-architecture >I<architecture>" 651msgid "B<Architecture:> I<arch-list> (required)" 652msgstr "B<--add-architecture >I<architectur>" 653 654#. type: Plain text 655#: deb-buildinfo.man 656msgid "" 657"This space-separated field lists the architectures of the files currently " 658"being built. Common architectures are B<amd64>, B<armel>, B<i386>, etc. " 659"Note that the B<all> value is meant for packages that are architecture " 660"independent. If the source for the package is also being built, the special " 661"entry B<source> is also present. Architecture wildcards must never be " 662"present in the list." 663msgstr "" 664 665#. type: TP 666#: deb-buildinfo.man deb-changes.man deb-control.man dsc.man 667#, fuzzy, no-wrap 668#| msgid "B<Version:>I< version-string>" 669msgid "B<Version:> I<version-string> (required)" 670msgstr "B<Version:>I< version-string>" 671 672#. type: Plain text 673#: deb-buildinfo.man deb-changes.man dsc.man 674msgid "" 675"Typically, this is the original package's version number in whatever form " 676"the program's author uses. It may also include a Debian revision number " 677"(for non-native packages). The exact format and sorting algorithm are " 678"described in B<deb-version>(7)." 679msgstr "" 680 681#. type: TP 682#: deb-buildinfo.man 683#, no-wrap 684msgid "B<Binary-Only-Changes:>" 685msgstr "" 686 687#. type: TQ 688#: deb-buildinfo.man 689#, fuzzy, no-wrap 690#| msgid "B<--unpack >I<package-file>..." 691msgid "I<changelog-entry>" 692msgstr "B<--unpack >I<package-file>..." 693 694#. type: Plain text 695#: deb-buildinfo.man 696msgid "" 697"This multiline field contains the concatenated text of the changelog entry " 698"for a binary-only non-maintainer upload (binNMU) if that is the case. To " 699"make this a valid multiline field empty lines are replaced with a single " 700"full stop (‘.’) and all lines are indented by one space character. The " 701"exact content depends on the changelog format." 702msgstr "" 703 704#. type: TP 705#: deb-buildinfo.man 706#, fuzzy, no-wrap 707#| msgid "B<Package:>I< package-name>" 708msgid "B<Checksums-Md5:> (required)" 709msgstr "B<Package:>I< package-name>" 710 711#. type: TQ 712#: deb-buildinfo.man deb-changes.man dsc.man 713#, no-wrap 714msgid "B<Checksums-Sha1:> (required)" 715msgstr "" 716 717#. type: TQ 718#: deb-buildinfo.man deb-changes.man dsc.man 719#, no-wrap 720msgid "B<Checksums-Sha256:> (required)" 721msgstr "" 722 723#. type: TQ 724#: deb-buildinfo.man deb-changes.man dsc.man 725#, no-wrap 726msgid " I<checksum> I<size> I<filename>" 727msgstr "" 728 729#. type: Plain text 730#: deb-buildinfo.man 731msgid "" 732"These multiline fields contain a list of files with a checksum and size for " 733"each one. These fields have the same syntax and differ only in the checksum " 734"algorithm used: MD5 for B<Checksums-Md5>, SHA-1 for B<Checksums-Sha1> and " 735"SHA-256 for B<Checksums-Sha256>." 736msgstr "" 737 738#. type: Plain text 739#: deb-buildinfo.man deb-changes.man 740msgid "" 741"The first line of the field value (the part on the same line as the field " 742"name followed by a colon) is always empty. The content of the field is " 743"expressed as continuation lines, one line per file. Each line consists of " 744"space-separated entries describing the file: the checksum, the file size, " 745"and the file name." 746msgstr "" 747 748#. type: Plain text 749#: deb-buildinfo.man 750msgid "These fields list all files that make up the build." 751msgstr "" 752 753#. type: TP 754#: deb-buildinfo.man 755#, fuzzy, no-wrap 756#| msgid "B<--abort-after=>I<number>" 757msgid "B<Build-Origin:> I<name>" 758msgstr "B<--abort-after=>I<number>" 759 760#. type: Plain text 761#: deb-buildinfo.man deb-control.man dsc.man 762msgid "The name of the distribution this package is originating from." 763msgstr "" 764 765#. type: TP 766#: deb-buildinfo.man 767#, fuzzy, no-wrap 768#| msgid "B<--add-architecture >I<architecture>" 769msgid "B<Build-Architecture:> I<arch> (required)" 770msgstr "B<--add-architecture >I<architectur>" 771 772#. type: Plain text 773#: deb-buildinfo.man 774msgid "" 775"The Debian architecture for the installation the packages is being built " 776"in. Common architectures are B<amd64>, B<armel>, B<i386>, etc." 777msgstr "" 778 779#. type: TP 780#: deb-buildinfo.man 781#, fuzzy, no-wrap 782#| msgid "B<--abort-after=>I<number>" 783msgid "B<Build-Date:> I<build-date>" 784msgstr "B<--abort-after=>I<number>" 785 786#. type: Plain text 787#: deb-buildinfo.man 788msgid "" 789"The date the package was built. It must be in the same format as the date " 790"in a B<deb-changelog>(5) entry." 791msgstr "" 792 793#. type: TP 794#: deb-buildinfo.man 795#, no-wrap 796msgid "B<Build-Kernel-Version:> I<build-kernel-version>" 797msgstr "" 798 799#. type: Plain text 800#: deb-buildinfo.man 801msgid "" 802"The release and version (in an unspecified format) of the kernel running on " 803"the build system. This field is only going to be present if the builder has " 804"explicitly requested it, to avoid leaking possibly sensitive information." 805msgstr "" 806 807#. type: TP 808#: deb-buildinfo.man 809#, no-wrap 810msgid "B<Build-Path:> I<build-path>" 811msgstr "" 812 813#. type: Plain text 814#: deb-buildinfo.man 815msgid "" 816"The absolute build path, which correspond to the unpacked source tree. This " 817"field is only going to be present if the vendor has whitelisted it via some " 818"pattern match to avoid leaking possibly sensitive information." 819msgstr "" 820 821#. type: Plain text 822#: deb-buildinfo.man 823msgid "" 824"On Debian and derivatives only build paths starting with I</build/> will " 825"emit this field." 826msgstr "" 827 828#. type: TP 829#: deb-buildinfo.man 830#, no-wrap 831msgid "B<Build-Tainted-By:>" 832msgstr "" 833 834#. type: TQ 835#: deb-buildinfo.man 836#, no-wrap 837msgid "I<taint-reason-list>" 838msgstr "" 839 840#. type: Plain text 841#: deb-buildinfo.man 842msgid "" 843"This folded field contains a space-separated list of non-exhaustive reason " 844"tags (formed by alphanumeric and dash characters) which identify why the " 845"current build has been tainted (since dpkg 1.19.5)." 846msgstr "" 847 848#. type: Plain text 849#: deb-buildinfo.man 850msgid "On Debian and derivatives the following reason tags can be emitted:" 851msgstr "" 852 853#. type: TP 854#: deb-buildinfo.man 855#, no-wrap 856msgid "B<merged-usr-via-symlinks>" 857msgstr "" 858 859#. type: Plain text 860#: deb-buildinfo.man 861msgid "" 862"The system has a merged I</usr> via symlinks. This will confuse B<dpkg-" 863"query>, B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> and " 864"any other tool using pathnames as keys into their databases, as it creates " 865"filesystem aliasing problems, and messes with the understanding of the " 866"filesystem that B<dpkg> has recorded in its database. For build systems " 867"that hardcode pathnames to specific binaries or libraries on the resulting " 868"artifacts, it can also produce packages that will be incompatible with non-/" 869"usr-merged filesystems." 870msgstr "" 871 872#. type: TP 873#: deb-buildinfo.man 874#, no-wrap 875msgid "B<usr-local-has-configs>" 876msgstr "" 877 878#. type: Plain text 879#: deb-buildinfo.man 880msgid "The system has configuration files under I</usr/local/etc>." 881msgstr "" 882 883#. type: TP 884#: deb-buildinfo.man 885#, fuzzy, no-wrap 886#| msgid "B<--path-include=>I<glob-pattern>" 887msgid "B<usr-local-has-includes>" 888msgstr "B<--path-include=>I<glob-pattern>" 889 890#. type: Plain text 891#: deb-buildinfo.man 892msgid "The system has header files under I</usr/local/include>." 893msgstr "" 894 895#. type: TP 896#: deb-buildinfo.man 897#, no-wrap 898msgid "B<usr-local-has-programs>" 899msgstr "" 900 901#. type: Plain text 902#: deb-buildinfo.man 903msgid "The system has programs under I</usr/local/bin> or I</usr/local/sbin>." 904msgstr "" 905 906#. type: TP 907#: deb-buildinfo.man 908#, no-wrap 909msgid "B<usr-local-has-libraries>" 910msgstr "" 911 912#. type: Plain text 913#: deb-buildinfo.man 914msgid "" 915"The system has libraries, either static or shared under I</usr/local/lib>." 916msgstr "" 917 918#. type: TP 919#: deb-buildinfo.man 920#, fuzzy, no-wrap 921#| msgid "B<reinst-required>" 922msgid "B<Installed-Build-Depends:> (required)" 923msgstr "B<reinst-required>" 924 925#. type: TQ 926#: deb-buildinfo.man 927#, fuzzy, no-wrap 928#| msgid "Package states" 929msgid "I<package-list>" 930msgstr "软件包状态" 931 932#. type: Plain text 933#: deb-buildinfo.man 934msgid "" 935"The list of installed and configured packages that might affect the package " 936"build process." 937msgstr "" 938 939#. type: Plain text 940#: deb-buildinfo.man 941msgid "" 942"The list consists of each package name, optionally arch-qualified for " 943"foreign architectures, with an exact version restriction, separated by " 944"commas." 945msgstr "" 946 947#. type: Plain text 948#: deb-buildinfo.man 949msgid "" 950"The list includes all essential packages, packages listed in B<Build-" 951"Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> source control " 952"fields, any vendor specific builtin dependencies, and all their recursive " 953"dependencies. On Debian and derivatives the dependency builtin is B<build-" 954"essential>." 955msgstr "" 956 957#. type: Plain text 958#: deb-buildinfo.man 959msgid "" 960"For dependencies coming from the source control fields, all dependency " 961"alternatives and all providers of virtual packages depended on will be " 962"included." 963msgstr "" 964 965#. type: TP 966#: deb-buildinfo.man 967#, no-wrap 968msgid "B<Environment:>" 969msgstr "" 970 971#. type: TQ 972#: deb-buildinfo.man 973#, no-wrap 974msgid "I<variable-list>" 975msgstr "" 976 977#. type: Plain text 978#: deb-buildinfo.man 979msgid "" 980"The list of environment variables that are known to affect the package build " 981"process, with each environment variable followed by an equal sign (‘=’) and " 982"the variable's quoted value, using double quotes (‘\"’), and backslashes " 983"escaped (‘\\e\\e’)." 984msgstr "" 985 986#. type: Plain text 987#: deb-buildinfo.man 988#, fuzzy 989#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 990msgid "B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1)." 991msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 992 993#. type: TH 994#: deb-changelog.man 995#, no-wrap 996msgid "deb-changelog" 997msgstr "" 998 999#. type: Plain text 1000#: deb-changelog.man 1001#, fuzzy 1002#| msgid "deb-src-control - Debian source packages' master control file format" 1003msgid "deb-changelog - dpkg source packages' changelog file format" 1004msgstr "deb-src-control - Debian 源代码包的主控文件格式" 1005 1006#. type: Plain text 1007#: deb-changelog.man 1008msgid "changelog" 1009msgstr "" 1010 1011#. type: Plain text 1012#: deb-changelog.man 1013msgid "" 1014"Changes in the packaged version of a project are explained in the changelog " 1015"file I<debian/changelog>. This includes modifications made in the source " 1016"package compared to the upstream one as well as other changes and updates to " 1017"the package." 1018msgstr "" 1019 1020#. type: Plain text 1021#: deb-changelog.man 1022msgid "" 1023"The format of the I<debian/changelog> allows the package building tools to " 1024"discover which version of the package is being built and find out other " 1025"release-specific information." 1026msgstr "" 1027 1028#. type: Plain text 1029#: deb-changelog.man 1030msgid "That format is a series of entries like this:" 1031msgstr "" 1032 1033#. type: Plain text 1034#: deb-changelog.man 1035#, no-wrap 1036msgid "" 1037"I<package> (I<version>) I<distributions>; I<metadata>\n" 1038" [optional blank line(s), stripped]\n" 1039" * I<change-details>\n" 1040" I<more-change-details>\n" 1041" [blank line(s), included in output of B<dpkg-parsechangelog>(1)]\n" 1042" * I<even-more-change-details>\n" 1043" [optional blank line(s), stripped]\n" 1044" -- I<maintainer-name> E<lt>I<email-address>E<gt> I<date>\n" 1045msgstr "" 1046 1047#. type: Plain text 1048#: deb-changelog.man 1049msgid "" 1050"I<package> and I<version> are the source package name and version number." 1051msgstr "" 1052 1053#. type: Plain text 1054#: deb-changelog.man 1055msgid "" 1056"I<distributions> lists one or more space-separated distributions where this " 1057"version should be installed when it is uploaded; it is copied to the " 1058"B<Distribution> field in the I<.changes> file." 1059msgstr "" 1060 1061#. type: Plain text 1062#: deb-changelog.man 1063msgid "" 1064"I<metadata> is a comma-separated list of I<keyword>=I<value> items. The " 1065"only I<keyword>s currently supported by B<dpkg> are B<urgency> and B<binary-" 1066"only>. B<urgency>'s value is used for the B<Urgency> field in the I<." 1067"changes> file for the upload. B<binary-only> with a B<yes> value, is used " 1068"to denote that this changelog entry is for a binary-only non-maintainer " 1069"upload (an automatic binary rebuild with the only change being the changelog " 1070"entry)." 1071msgstr "" 1072 1073#. type: Plain text 1074#: deb-changelog.man 1075msgid "" 1076"The change details may in fact be any series of lines starting with at least " 1077"two spaces, but conventionally each change starts with an asterisk and a " 1078"separating space and continuation lines are indented so as to bring them in " 1079"line with the start of the text above. Blank lines may be used here to " 1080"separate groups of changes, if desired." 1081msgstr "" 1082 1083#. type: Plain text 1084#: deb-changelog.man 1085msgid "" 1086"If this upload resolves bugs recorded in the distribution bug tracking " 1087"system, they may be automatically closed on the inclusion of this package " 1088"into the distribution archive by including the string:" 1089msgstr "" 1090 1091#. type: Plain text 1092#: deb-changelog.man 1093#, no-wrap 1094msgid " B<Closes: Bug#>I<nnnnn>\n" 1095msgstr "" 1096 1097#. type: Plain text 1098#: deb-changelog.man 1099msgid "" 1100"in the change details (the exact Perl regular expression is B</closes:" 1101"\\es*(?:bug)?\\e#?\\es?\\ed+(?:,\\es*(?:bug)?\\e#?\\es?\\ed+)*/i>). This " 1102"information is conveyed via the B<Closes> field in the I<.changes> file." 1103msgstr "" 1104 1105#. type: Plain text 1106#: deb-changelog.man 1107msgid "" 1108"The maintainer name and email address used in the changelog should be the " 1109"details of the person who prepared this release of the package. They are " 1110"B<not> necessarily those of the uploader or usual package maintainer. The " 1111"information here will be copied to the B<Changed-By> field in the I<." 1112"changes> file, and then later might be used to send an acknowledgement when " 1113"the upload has been installed in the distribution archive." 1114msgstr "" 1115 1116#. type: Plain text 1117#: deb-changelog.man 1118msgid "" 1119"The I<date> has the following format (compatible and with the same semantics " 1120"of RFC2822 and RFC5322, or what «date -R» generates):" 1121msgstr "" 1122 1123#. type: Plain text 1124#: deb-changelog.man 1125msgid "" 1126"I<day-of-week>B<,> I<dd> I<month> I<yyyy> I<hh>B<:>I<mm>B<:>I<ss> B<+>I<zzzz>" 1127msgstr "" 1128 1129#. type: Plain text 1130#: deb-changelog.man 1131msgid "where:" 1132msgstr "" 1133 1134#. type: TP 1135#: deb-changelog.man 1136#, no-wrap 1137msgid "I<day-of-week>" 1138msgstr "" 1139 1140#. type: Plain text 1141#: deb-changelog.man 1142msgid "Is one of: B<Mon>, B<Tue>, B<Wed>, B<Thu>, B<Fri>, B<Sat>, B<Sun>." 1143msgstr "" 1144 1145#. type: TP 1146#: deb-changelog.man 1147#, no-wrap 1148msgid "I<dd>" 1149msgstr "" 1150 1151#. type: Plain text 1152#: deb-changelog.man 1153msgid "Is a one- or two-digit day of the month (B<01>-B<31>)." 1154msgstr "" 1155 1156#. type: TP 1157#: deb-changelog.man 1158#, no-wrap 1159msgid "I<month>" 1160msgstr "" 1161 1162#. type: Plain text 1163#: deb-changelog.man 1164msgid "" 1165"Is one of: B<Jan>, B<Feb>, B<Mar>, B<Apr>, B<May>, B<Jun>, B<Jul>, B<Aug>, " 1166"B<Sep>, B<Oct>, B<Nov>, B<Dec>." 1167msgstr "" 1168 1169#. type: TP 1170#: deb-changelog.man 1171#, no-wrap 1172msgid "I<yyyy>" 1173msgstr "" 1174 1175#. type: Plain text 1176#: deb-changelog.man 1177msgid "Is the four-digit year (e.g. 2010)." 1178msgstr "" 1179 1180#. type: TP 1181#: deb-changelog.man 1182#, no-wrap 1183msgid "I<hh>" 1184msgstr "" 1185 1186#. type: Plain text 1187#: deb-changelog.man 1188msgid "Is the two-digit hour (B<00>-B<23>)." 1189msgstr "" 1190 1191#. type: TP 1192#: deb-changelog.man 1193#, no-wrap 1194msgid "I<mm>" 1195msgstr "" 1196 1197#. type: Plain text 1198#: deb-changelog.man 1199msgid "Is the two-digit minutes (B<00>-B<59>)." 1200msgstr "" 1201 1202#. type: TP 1203#: deb-changelog.man 1204#, no-wrap 1205msgid "I<ss>" 1206msgstr "" 1207 1208#. type: Plain text 1209#: deb-changelog.man 1210msgid "Is the two-digit seconds (B<00>-B<60>)." 1211msgstr "" 1212 1213#. type: TP 1214#: deb-changelog.man 1215#, no-wrap 1216msgid "[B<+->]I<zzzz>" 1217msgstr "" 1218 1219#. type: Plain text 1220#: deb-changelog.man 1221msgid "" 1222"Is the time zone offset from Coordinated Universal Time (UTC). ‘B<+>’ " 1223"indicates that the time is ahead of (i.e., east of) UTC and ‘B<->’ indicates " 1224"that the time is behind (i.e., west of) UTC. The first two digits indicate " 1225"the hour difference from UTC and the last two digits indicate the number of " 1226"additional minutes difference from UTC. The last two digits must be in the " 1227"range B<00>-B<59>." 1228msgstr "" 1229 1230#. type: Plain text 1231#: deb-changelog.man 1232msgid "" 1233"The first “title” line with the package name must start at the left hand " 1234"margin. The “trailer” line with the maintainer and date details must be " 1235"preceded by exactly one space. The maintainer details and the date must be " 1236"separated by exactly two spaces." 1237msgstr "" 1238 1239#. type: Plain text 1240#: deb-changelog.man 1241msgid "" 1242"Any line that consists entirely (i.e., no leading whitespace) of B<#> or B</" 1243"* */> style comments or RCS keywords." 1244msgstr "" 1245 1246#. type: Plain text 1247#: deb-changelog.man 1248msgid "" 1249"Vim modelines or Emacs local variables, and ancient changelog entries with " 1250"other formats at the end of the file should be accepted and preserved on " 1251"output, but their contents might be otherwise ignored and parsing stopped at " 1252"that point." 1253msgstr "" 1254 1255#. type: Plain text 1256#: deb-changelog.man 1257msgid "The entire changelog must be encoded in UTF-8." 1258msgstr "" 1259 1260#. type: SH 1261#: deb-changelog.man deb-substvars.man dpkg.man dpkg-architecture.man 1262#: dpkg.cfg.man dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 1263#: dpkg-distaddfile.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 1264#: dpkg-parsechangelog.man dpkg-source.man dpkg-split.man dpkg-statoverride.man 1265#: dselect.cfg.man update-alternatives.man 1266#, no-wrap 1267msgid "FILES" 1268msgstr "" 1269 1270#. type: TP 1271#: deb-changelog.man 1272#, no-wrap 1273msgid "I<debian/changelog>" 1274msgstr "" 1275 1276#. type: SH 1277#: deb-changelog.man deb-shlibs.man deb-symbols.man dpkg.man 1278#: dpkg-architecture.man dpkg-buildflags.man dpkg-divert.man dpkg-name.man 1279#: update-alternatives.man 1280#, no-wrap 1281msgid "EXAMPLES" 1282msgstr "" 1283 1284#. type: Plain text 1285#: deb-changelog.man 1286#, no-wrap 1287msgid "dpkg (1.17.18) unstable; urgency=low\n" 1288msgstr "" 1289 1290#. type: Plain text 1291#: deb-changelog.man 1292#, no-wrap 1293msgid "" 1294" [ Guillem Jover ]\n" 1295" * Handle empty minimum versions when initializing dependency versions,\n" 1296" as the code is mapping the minimum version 0 to '' to avoid outputting\n" 1297" useless versions. Regression introduced in dpkg 1.17.17. Closes: #764929\n" 1298msgstr "" 1299 1300#. type: Plain text 1301#: deb-changelog.man 1302#, no-wrap 1303msgid "" 1304" [ Updated programs translations ]\n" 1305" * Catalan (Guillem Jover).\n" 1306msgstr "" 1307 1308#. type: Plain text 1309#: deb-changelog.man 1310#, no-wrap 1311msgid "" 1312" [ Updated dselect translations ]\n" 1313" * Catalan (Guillem Jover).\n" 1314" * German (Sven Joachim).\n" 1315msgstr "" 1316 1317#. type: Plain text 1318#: deb-changelog.man 1319#, no-wrap 1320msgid " -- Guillem Jover E<lt>guillem@debian.orgE<gt> Sun, 12 Oct 2014 15:47:44 +0200\n" 1321msgstr "" 1322 1323#. type: Plain text 1324#: deb-changelog.man 1325#, fuzzy 1326#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 1327msgid "B<deb-version>(7), B<deb-changes>(5), B<dpkg-parsechangelog>(1)." 1328msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 1329 1330#. type: TH 1331#: deb-changes.man 1332#, no-wrap 1333msgid "deb-changes" 1334msgstr "" 1335 1336#. type: Plain text 1337#: deb-changes.man 1338#, fuzzy 1339#| msgid "deb-control - Debian packages' master control file format" 1340msgid "deb-changes - Debian changes file format" 1341msgstr "deb-control - Debian 软件包的主控文件格式" 1342 1343#. type: Plain text 1344#: deb-changes.man 1345#, fuzzy 1346#| msgid "I<filename>B<.deb>" 1347msgid "I<filename>B<.changes>" 1348msgstr "I<filename>B<.deb>" 1349 1350#. type: Plain text 1351#: deb-changes.man 1352msgid "" 1353"Each Debian upload is composed of a .changes control file, which contains a " 1354"number of fields. Each field begins with a tag, such as B<Source> or " 1355"B<Binary> (case insensitive), followed by a colon, and the body of the " 1356"field. Fields are delimited only by field tags. In other words, field text " 1357"may be multiple lines in length, but the installation tools will generally " 1358"join lines when processing the body of the field (except in case of the " 1359"multiline fields B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> and " 1360"B<Checksums-Sha256>, see below)." 1361msgstr "" 1362 1363#. type: Plain text 1364#: deb-changes.man 1365msgid "" 1366"The value of this field declares the format version of the file. The syntax " 1367"of the field value is a version number with a major and minor component. " 1368"Backward incompatible changes to the format will bump the major version, and " 1369"backward compatible changes (such as field additions) will bump the minor " 1370"version. The current format version is B<1.8>." 1371msgstr "" 1372 1373#. type: TP 1374#: deb-changes.man 1375#, fuzzy, no-wrap 1376#| msgid "B<Package:>I< package-name>" 1377msgid "B<Date:> I<release-date> (required)" 1378msgstr "B<Package:>I< package-name>" 1379 1380#. type: Plain text 1381#: deb-changes.man 1382msgid "" 1383"The date the package was built or last edited. It must be in the same " 1384"format as the date in a B<deb-changelog>(5) entry." 1385msgstr "" 1386 1387#. type: Plain text 1388#: deb-changes.man 1389msgid "" 1390"The value of this field is usually extracted from the I<debian/changelog> " 1391"file." 1392msgstr "" 1393 1394#. type: Plain text 1395#: deb-changes.man 1396msgid "" 1397"The name of the source package. If the source version differs from the " 1398"binary version, then the I<source-name> will be followed by a I<source-" 1399"version> in parenthesis. This can happen when the upload is a binary-only " 1400"non-maintainer upload." 1401msgstr "" 1402 1403#. type: TP 1404#: deb-changes.man 1405#, fuzzy, no-wrap 1406#| msgid "B<Package:>I< package-name>" 1407msgid "B<Binary:> I<binary-package-list> (required in context)" 1408msgstr "B<Package:>I< package-name>" 1409 1410#. type: Plain text 1411#: deb-changes.man 1412msgid "" 1413"This folded field is a space-separated list of binary packages to upload. " 1414"If the upload is source-only, then the field is omitted (since dpkg 1.19.3)." 1415msgstr "" 1416 1417#. type: TP 1418#: deb-changes.man 1419#, fuzzy, no-wrap 1420#| msgid "B<--add-architecture >I<architecture>" 1421msgid "B<Architecture:> I<arch-list>" 1422msgstr "B<--add-architecture >I<architectur>" 1423 1424#. type: Plain text 1425#: deb-changes.man 1426msgid "" 1427"Lists the architectures of the files currently being uploaded. Common " 1428"architectures are B<amd64>, B<armel>, B<i386>, etc. Note that the B<all> " 1429"value is meant for packages that are architecture independent. If the " 1430"source for the package is also being uploaded, the special entry B<source> " 1431"is also present. Architecture wildcards must never be present in the list." 1432msgstr "" 1433 1434#. type: TP 1435#: deb-changes.man 1436#, fuzzy, no-wrap 1437#| msgid "B<Version:>I< version-string>" 1438msgid "B<Distribution:> I<distribution>s (required)" 1439msgstr "B<Version:>I< version-string>" 1440 1441#. type: Plain text 1442#: deb-changes.man 1443msgid "" 1444"Lists one or more space-separated distributions where this version should be " 1445"installed when it is uploaded to the archive." 1446msgstr "" 1447 1448#. type: TP 1449#: deb-changes.man 1450#, no-wrap 1451msgid "B<Urgency:> I<urgency> (recommended)" 1452msgstr "" 1453 1454#. type: Plain text 1455#: deb-changes.man 1456msgid "" 1457"The urgency of the upload. The currently known values, in increasing order " 1458"of urgency, are: B<low>, B<medium>, B<high>, B<critical> and B<emergency>." 1459msgstr "" 1460 1461#. type: TP 1462#: deb-changes.man 1463#, no-wrap 1464msgid "B<Maintainer:> I<fullname-email> (required)" 1465msgstr "" 1466 1467#. type: Plain text 1468#: deb-changes.man 1469msgid "" 1470"Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is " 1471"typically the person who created the package, as opposed to the author of " 1472"the software that was packaged." 1473msgstr "" 1474 1475#. type: TP 1476#: deb-changes.man 1477#, no-wrap 1478msgid "B<Changed-By:>I< fullname-email>" 1479msgstr "" 1480 1481#. type: Plain text 1482#: deb-changes.man 1483msgid "" 1484"Should be in the format “Joe Bloggs E<lt>jbloggs@example.orgE<gt>”, and is " 1485"typically the person who prepared the package changes for this release." 1486msgstr "" 1487 1488#. type: TP 1489#: deb-changes.man 1490#, no-wrap 1491msgid "B<Description:> (recommended)" 1492msgstr "" 1493 1494#. type: TQ 1495#: deb-changes.man 1496#, no-wrap 1497msgid " I<binary-package-name> B<-> I<binary-package-summary>" 1498msgstr "" 1499 1500#. type: Plain text 1501#: deb-changes.man 1502msgid "" 1503"This multiline field contains a list of binary package names followed by a " 1504"space, a dash (‘B<->’) and their possibly truncated short descriptions. If " 1505"the upload is source-only, then the field is omitted (since dpkg 1.19.3)." 1506msgstr "" 1507 1508#. type: TP 1509#: deb-changes.man 1510#, no-wrap 1511msgid "B<Closes:>I< bug-number-list>" 1512msgstr "" 1513 1514#. type: Plain text 1515#: deb-changes.man 1516msgid "" 1517"A space-separated list of bug report numbers that have been resolved with " 1518"this upload. The distribution archive software might use this field to " 1519"automatically close the referred bug numbers in the distribution bug " 1520"tracking system." 1521msgstr "" 1522 1523#. type: TP 1524#: deb-changes.man 1525#, no-wrap 1526msgid "B<Binary-Only: yes>" 1527msgstr "" 1528 1529#. type: Plain text 1530#: deb-changes.man 1531msgid "" 1532"This field denotes that the upload is a binary-only non-maintainer build. " 1533"It originates from the B<binary-only=yes> key/value from the changelog " 1534"metadata entry." 1535msgstr "" 1536 1537#. type: TP 1538#: deb-changes.man 1539#, no-wrap 1540msgid "B<Built-For-Profiles:>I< profile-list>" 1541msgstr "" 1542 1543#. type: Plain text 1544#: deb-changes.man 1545msgid "" 1546"This field specifies a whitespace separated list of build profiles that this " 1547"upload was built with." 1548msgstr "" 1549 1550#. type: TP 1551#: deb-changes.man 1552#, fuzzy, no-wrap 1553#| msgid "B<Package:>I< package-name>" 1554msgid "B<Changes:> (required)" 1555msgstr "B<Package:>I< package-name>" 1556 1557#. type: TQ 1558#: deb-changes.man 1559#, fuzzy, no-wrap 1560#| msgid "B<--unpack >I<package-file>..." 1561msgid "I<changelog-entries>" 1562msgstr "B<--unpack >I<package-file>..." 1563 1564#. type: Plain text 1565#: deb-changes.man 1566msgid "" 1567"This multiline field contains the concatenated text of all changelog entries " 1568"that are part of the upload. To make this a valid multiline field empty " 1569"lines are replaced with a single full stop (‘.’) and all lines are indented " 1570"by one space character. The exact content depends on the changelog format." 1571msgstr "" 1572 1573#. type: TP 1574#: deb-changes.man dsc.man 1575#, fuzzy, no-wrap 1576#| msgid "B<reinst-required>" 1577msgid "B<Files:> (required)" 1578msgstr "B<reinst-required>" 1579 1580#. type: TQ 1581#: deb-changes.man 1582#, no-wrap 1583msgid " I<md5sum> I<size> I<section> I<priority> I<filename>" 1584msgstr "" 1585 1586#. type: Plain text 1587#: deb-changes.man 1588msgid "" 1589"This multiline field contains a list of files with an md5sum, size, section " 1590"and priority for each one." 1591msgstr "" 1592 1593#. type: Plain text 1594#: deb-changes.man 1595msgid "" 1596"The first line of the field value (the part on the same line as the field " 1597"name followed by a colon) is always empty. The content of the field is " 1598"expressed as continuation lines, one line per file. Each line consists of " 1599"space-separated entries describing the file: the md5sum, the file size, the " 1600"file section, the file priority, and the file name." 1601msgstr "" 1602 1603#. type: Plain text 1604#: deb-changes.man 1605msgid "" 1606"This field lists all files that make up the upload. The list of files in " 1607"this field must match the list of files in the other related B<Checksums> " 1608"fields." 1609msgstr "" 1610 1611#. type: Plain text 1612#: deb-changes.man 1613msgid "" 1614"These multiline fields contain a list of files with a checksum and size for " 1615"each one. These fields have the same syntax and differ only in the checksum " 1616"algorithm used: SHA-1 for B<Checksums-Sha1> and SHA-256 for B<Checksums-" 1617"Sha256>." 1618msgstr "" 1619 1620#. type: Plain text 1621#: deb-changes.man 1622msgid "" 1623"These fields list all files that make up the upload. The list of files in " 1624"these fields must match the list of files in the B<Files> field and the " 1625"other related B<Checksums> fields." 1626msgstr "" 1627 1628#. type: SH 1629#: deb-changes.man deb-control.man dsc.man dpkg.man dpkg-buildpackage.man 1630#: dpkg-deb.man dpkg-name.man dpkg-source.man dpkg-split.man dselect.man 1631#, no-wrap 1632msgid "BUGS" 1633msgstr "" 1634 1635#. type: Plain text 1636#: deb-changes.man 1637msgid "" 1638"The B<Files> field is inconsistent with the other B<Checksums> fields. The " 1639"B<Changed-By> and B<Maintainer> fields have confusing names. The " 1640"B<Distribution> field contains information about what is commonly referred " 1641"to as a suite." 1642msgstr "" 1643 1644#. type: Plain text 1645#: deb-changes.man 1646#, fuzzy 1647#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 1648msgid "B<deb-src-control>(5), B<deb-version>(7)." 1649msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 1650 1651#. type: TH 1652#: deb-control.man 1653#, no-wrap 1654msgid "deb-control" 1655msgstr "deb-control" 1656 1657#. type: Plain text 1658#: deb-control.man 1659#, fuzzy 1660#| msgid "deb-control - Debian packages' master control file format" 1661msgid "deb-control - Debian binary packages' master control file format" 1662msgstr "deb-control - Debian 软件包的主控文件格式" 1663 1664#. type: Plain text 1665#: deb-control.man 1666msgid "control" 1667msgstr "" 1668 1669#. type: Plain text 1670#: deb-control.man 1671msgid "" 1672"Each Debian binary package contains the master I<control> file, which " 1673"contains a number of fields. Each field begins with a tag, such as " 1674"B<Package> or B<Version> (case insensitive), followed by a colon, and the " 1675"body of the field. Fields are delimited only by field tags. In other words, " 1676"field text may be multiple lines in length, but the installation tools will " 1677"generally join lines when processing the body of the field (except in the " 1678"case of the B<Description> field, see below)." 1679msgstr "" 1680 1681#. type: TP 1682#: deb-control.man 1683#, fuzzy, no-wrap 1684#| msgid "B<Package:>I< package-name>" 1685msgid "B<Package:> I<package-name> (required)" 1686msgstr "B<Package:>I< package-name>" 1687 1688#. type: Plain text 1689#: deb-control.man dsc.man 1690msgid "" 1691"The value of this field determines the package name, and is used to generate " 1692"file names by most installation tools." 1693msgstr "" 1694 1695#. type: TP 1696#: deb-control.man deb-src-control.man 1697#, no-wrap 1698msgid "B<Package-Type:> B<deb>|B<udeb>|I<type>" 1699msgstr "" 1700 1701#. type: Plain text 1702#: deb-control.man deb-src-control.man 1703msgid "" 1704"This field defines the type of the package. B<udeb> is for size-constrained " 1705"packages used by the debian installer. B<deb> is the default value, it is " 1706"assumed if the field is absent. More types might be added in the future." 1707msgstr "" 1708 1709#. type: Plain text 1710#: deb-control.man 1711msgid "" 1712"Typically, this is the original package's version number in whatever form " 1713"the program's author uses. It may also include a Debian revision number (for " 1714"non-native packages). The exact format and sorting algorithm are described " 1715"in B<deb-version>(7)." 1716msgstr "" 1717 1718#. type: TP 1719#: deb-control.man deb-src-control.man dsc.man 1720#, no-wrap 1721msgid "B<Maintainer:> I<fullname-email> (recommended)" 1722msgstr "" 1723 1724#. type: Plain text 1725#: deb-control.man dsc.man 1726msgid "" 1727"Should be in the format “Joe Bloggs E<lt>jbloggs@foo.comE<gt>”, and is " 1728"typically the person who created the package, as opposed to the author of " 1729"the software that was packaged." 1730msgstr "" 1731 1732#. type: TQ 1733#: deb-control.man deb-src-control.man 1734#, fuzzy, no-wrap 1735#| msgid "B<Version:>I< version-string>" 1736msgid "B<Description:> I<short-description> (recommended)" 1737msgstr "B<Version:>I< version-string>" 1738 1739#. type: TQ 1740#: deb-control.man deb-src-control.man dsc.man 1741#, no-wrap 1742msgid "B< >I<long-description>" 1743msgstr "" 1744 1745#. type: Plain text 1746#: deb-control.man 1747msgid "" 1748"The format for the package description is a short brief summary on the first " 1749"line (after the B<Description> field). The following lines should be used as " 1750"a longer, more detailed description. Each line of the long description must " 1751"be preceded by a space, and blank lines in the long description must contain " 1752"a single ‘B<.>’ following the preceding space." 1753msgstr "" 1754 1755#. type: TP 1756#: deb-control.man deb-src-control.man 1757#, no-wrap 1758msgid "B<Section:>I< section>" 1759msgstr "" 1760 1761#. type: Plain text 1762#: deb-control.man deb-src-control.man 1763msgid "" 1764"This is a general field that gives the package a category based on the " 1765"software that it installs. Some common sections are B<utils>, B<net>, " 1766"B<mail>, B<text>, B<x11>, etc." 1767msgstr "" 1768 1769#. type: TP 1770#: deb-control.man deb-src-control.man 1771#, no-wrap 1772msgid "B<Priority:>I< priority>" 1773msgstr "" 1774 1775#. type: Plain text 1776#: deb-control.man deb-src-control.man 1777msgid "" 1778"Sets the importance of this package in relation to the system as a whole. " 1779"Common priorities are B<required>, B<standard>, B<optional>, B<extra>, etc." 1780msgstr "" 1781 1782#. type: Plain text 1783#: deb-control.man deb-src-control.man 1784msgid "" 1785"The B<Section> and B<Priority> fields usually have a defined set of accepted " 1786"values based on the specific distribution policy." 1787msgstr "" 1788 1789#. type: TP 1790#: deb-control.man 1791#, fuzzy, no-wrap 1792#| msgid "B<installed>" 1793msgid "B<Installed-Size:> size" 1794msgstr "B<installed>" 1795 1796#. type: Plain text 1797#: deb-control.man 1798msgid "" 1799"The approximate total size of the package's installed files, in KiB units." 1800msgstr "" 1801 1802#. type: TP 1803#: deb-control.man deb-src-control.man 1804#, no-wrap 1805msgid "B<Essential:> B<yes>|B<no>" 1806msgstr "" 1807 1808#. type: Plain text 1809#: deb-control.man 1810msgid "" 1811"This field is usually only needed when the answer is B<yes>. It denotes a " 1812"package that is required for proper operation of the system. Dpkg or any " 1813"other installation tool will not allow an B<Essential> package to be removed " 1814"(at least not without using one of the force options)." 1815msgstr "" 1816 1817#. type: TQ 1818#: deb-control.man deb-src-control.man 1819#, no-wrap 1820msgid "B<Build-Essential:> B<yes>|B<no>" 1821msgstr "" 1822 1823#. type: Plain text 1824#: deb-control.man 1825msgid "" 1826"This field is usually only needed when the answer is B<yes>, and is commonly " 1827"injected by the archive software. It denotes a package that is required " 1828"when building other packages." 1829msgstr "" 1830 1831#. type: TP 1832#: deb-control.man 1833#, no-wrap 1834msgid "B<Architecture:> I<arch>|B<all> (recommended)" 1835msgstr "" 1836 1837#. type: Plain text 1838#: deb-control.man 1839msgid "" 1840"The architecture specifies which type of hardware this package was compiled " 1841"for. Common architectures are B<amd64>, B<armel>, B<i386>, B<powerpc>, " 1842"etc. Note that the B<all> value is meant for packages that are architecture " 1843"independent. Some examples of this are shell and Perl scripts, and " 1844"documentation." 1845msgstr "" 1846 1847#. type: TP 1848#: deb-control.man deb-src-control.man dsc.man 1849#, no-wrap 1850msgid "B<Origin:>I< name>" 1851msgstr "" 1852 1853#. type: TP 1854#: deb-control.man deb-src-control.man 1855#, no-wrap 1856msgid "B<Bugs:>I< url>" 1857msgstr "" 1858 1859#. type: Plain text 1860#: deb-control.man 1861msgid "" 1862"The I<url> of the bug tracking system for this package. The current used " 1863"format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>." 1864msgstr "" 1865 1866#. type: TP 1867#: deb-control.man deb-src-control.man dsc.man 1868#, no-wrap 1869msgid "B<Homepage:>I< url>" 1870msgstr "" 1871 1872#. type: Plain text 1873#: deb-control.man dsc.man 1874msgid "The upstream project home page I<url>." 1875msgstr "" 1876 1877#. type: TQ 1878#: deb-control.man deb-src-control.man 1879#, no-wrap 1880msgid "B<Tag:>I< tag-list>" 1881msgstr "" 1882 1883#. type: Plain text 1884#: deb-control.man 1885msgid "" 1886"List of tags describing the qualities of the package. The description and " 1887"list of supported tags can be found in the B<debtags> package." 1888msgstr "" 1889 1890#. type: TP 1891#: deb-control.man 1892#, no-wrap 1893msgid "B<Multi-Arch:> B<no>|B<same>|B<foreign>|B<allowed>" 1894msgstr "" 1895 1896#. type: Plain text 1897#: deb-control.man 1898msgid "" 1899"This field is used to indicate how this package should behave on a multi-" 1900"arch installations." 1901msgstr "" 1902 1903#. type: TP 1904#: deb-control.man deb-src-control.man 1905#, no-wrap 1906msgid "B<no>" 1907msgstr "" 1908 1909#. type: Plain text 1910#: deb-control.man 1911msgid "" 1912"This value is the default when the field is omitted, in which case adding " 1913"the field with an explicit B<no> value is generally not needed." 1914msgstr "" 1915 1916#. type: TP 1917#: deb-control.man 1918#, no-wrap 1919msgid "B<same>" 1920msgstr "" 1921 1922#. type: Plain text 1923#: deb-control.man 1924msgid "" 1925"This package is co-installable with itself, but it must not be used to " 1926"satisfy the dependency of any package of a different architecture from " 1927"itself." 1928msgstr "" 1929 1930#. type: TP 1931#: deb-control.man 1932#, no-wrap 1933msgid "B<foreign>" 1934msgstr "" 1935 1936#. type: Plain text 1937#: deb-control.man 1938msgid "" 1939"This package is not co-installable with itself, but should be allowed to " 1940"satisfy a non-arch-qualified dependency of a package of a different arch " 1941"from itself (if a dependency has an explicit arch-qualifier then the value " 1942"B<foreign> is ignored)." 1943msgstr "" 1944 1945#. type: TP 1946#: deb-control.man 1947#, fuzzy, no-wrap 1948#| msgid "B<install>" 1949msgid "B<allowed>" 1950msgstr "B<install>" 1951 1952#. type: Plain text 1953#: deb-control.man 1954msgid "" 1955"This allows reverse-dependencies to indicate in their B<Depends> field that " 1956"they accept this package from a foreign architecture by qualifying the " 1957"package name with B<:any>, but has no effect otherwise." 1958msgstr "" 1959 1960#. type: TP 1961#: deb-control.man 1962#, no-wrap 1963msgid "B<Source:> I<source-name> [B<(>I<source-version>B<)>]" 1964msgstr "" 1965 1966#. type: Plain text 1967#: deb-control.man 1968msgid "" 1969"The name of the source package that this binary package came from, if it is " 1970"different than the name of the package itself. If the source version " 1971"differs from the binary version, then the I<source-name> will be followed by " 1972"a I<source-version> in parenthesis. This can happen for example on a binary-" 1973"only non-maintainer upload, or when setting a different binary version via " 1974"«B<dpkg-gencontrol -v>»." 1975msgstr "" 1976 1977#. type: TP 1978#: deb-control.man deb-src-control.man 1979#, no-wrap 1980msgid "B<Subarchitecture:>I< value>" 1981msgstr "" 1982 1983#. type: TQ 1984#: deb-control.man deb-src-control.man 1985#, no-wrap 1986msgid "B<Kernel-Version:>I< value>" 1987msgstr "" 1988 1989#. type: TQ 1990#: deb-control.man deb-src-control.man 1991#, no-wrap 1992msgid "B<Installer-Menu-Item:>I< value>" 1993msgstr "" 1994 1995#. type: Plain text 1996#: deb-control.man 1997msgid "" 1998"These fields are used by the debian-installer and are usually not needed. " 1999"See /usr/share/doc/debian-installer/devel/modules.txt from the B<debian-" 2000"installer> package for more details about them." 2001msgstr "" 2002 2003#. type: TP 2004#: deb-control.man deb-src-control.man 2005#, no-wrap 2006msgid "B<Depends:>I< package-list>" 2007msgstr "" 2008 2009#. type: Plain text 2010#: deb-control.man 2011msgid "" 2012"List of packages that are required for this package to provide a non-trivial " 2013"amount of functionality. The package maintenance software will not allow a " 2014"package to be installed if the packages listed in its B<Depends> field " 2015"aren't installed (at least not without using the force options). In an " 2016"installation, the postinst scripts of packages listed in B<Depends> fields " 2017"are run before those of the packages which depend on them. On the opposite, " 2018"in a removal, the prerm script of a package is run before those of the " 2019"packages listed in its B<Depends> field." 2020msgstr "" 2021 2022#. type: TQ 2023#: deb-control.man deb-src-control.man 2024#, no-wrap 2025msgid "B<Pre-Depends:>I< package-list>" 2026msgstr "" 2027 2028#. type: Plain text 2029#: deb-control.man 2030msgid "" 2031"List of packages that must be installed B<and> configured before this one " 2032"can be installed. This is usually used in the case where this package " 2033"requires another package for running its preinst script." 2034msgstr "" 2035 2036#. type: TQ 2037#: deb-control.man deb-src-control.man 2038#, no-wrap 2039msgid "B<Recommends:>I< package-list>" 2040msgstr "" 2041 2042#. type: Plain text 2043#: deb-control.man 2044msgid "" 2045"Lists packages that would be found together with this one in all but unusual " 2046"installations. The package maintenance software will warn the user if they " 2047"install a package without those listed in its B<Recommends> field." 2048msgstr "" 2049 2050#. type: TQ 2051#: deb-control.man deb-src-control.man 2052#, no-wrap 2053msgid "B<Suggests:>I< package-list>" 2054msgstr "" 2055 2056#. type: Plain text 2057#: deb-control.man 2058msgid "" 2059"Lists packages that are related to this one and can perhaps enhance its " 2060"usefulness, but without which installing this package is perfectly " 2061"reasonable." 2062msgstr "" 2063 2064#. type: Plain text 2065#: deb-control.man 2066msgid "" 2067"The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> " 2068"fields is a list of groups of alternative packages. Each group is a list of " 2069"packages separated by vertical bar (or “pipe”) symbols, ‘B<|>’. The groups " 2070"are separated by commas. Commas are to be read as “AND”, and pipes as “OR”, " 2071"with pipes binding more tightly. Each package name is optionally followed " 2072"by an architecture qualifier appended after a colon ‘B<:>’, optionally " 2073"followed by a version number specification in parentheses." 2074msgstr "" 2075 2076#. type: Plain text 2077#: deb-control.man 2078msgid "" 2079"An architecture qualifier name can be a real Debian architecture name (since " 2080"dpkg 1.16.5) or B<any> (since dpkg 1.16.2). If omitted, the default is the " 2081"current binary package architecture. A real Debian architecture name will " 2082"match exactly that architecture for that package name, B<any> will match any " 2083"architecture for that package name if the package has been marked as B<Multi-" 2084"Arch: allowed>." 2085msgstr "" 2086 2087#. type: Plain text 2088#: deb-control.man deb-src-control.man 2089msgid "" 2090"A version number may start with a ‘B<E<gt>E<gt>>’, in which case any later " 2091"version will match, and may specify or omit the Debian packaging revision " 2092"(separated by a hyphen). Accepted version relationships are ‘B<E<gt>E<gt>>’ " 2093"for greater than, ‘B<E<lt>E<lt>>’ for less than, ‘B<E<gt>=>’ for greater " 2094"than or equal to, ‘B<E<lt>=>’ for less than or equal to, and ‘B<=>’ for " 2095"equal to." 2096msgstr "" 2097 2098#. type: TQ 2099#: deb-control.man deb-src-control.man 2100#, no-wrap 2101msgid "B<Breaks:>I< package-list>" 2102msgstr "" 2103 2104#. type: Plain text 2105#: deb-control.man 2106msgid "" 2107"Lists packages that this one breaks, for example by exposing bugs when the " 2108"named packages rely on this one. The package maintenance software will not " 2109"allow broken packages to be configured; generally the resolution is to " 2110"upgrade the packages named in a B<Breaks> field." 2111msgstr "" 2112 2113#. type: TQ 2114#: deb-control.man deb-src-control.man 2115#, no-wrap 2116msgid "B<Conflicts:>I< package-list>" 2117msgstr "" 2118 2119#. type: Plain text 2120#: deb-control.man 2121msgid "" 2122"Lists packages that conflict with this one, for example by containing files " 2123"with the same names. The package maintenance software will not allow " 2124"conflicting packages to be installed at the same time. Two conflicting " 2125"packages should each include a B<Conflicts> line mentioning the other." 2126msgstr "" 2127 2128#. type: TQ 2129#: deb-control.man deb-src-control.man 2130#, no-wrap 2131msgid "B<Replaces:>I< package-list>" 2132msgstr "" 2133 2134#. type: Plain text 2135#: deb-control.man 2136msgid "" 2137"List of packages files from which this one replaces. This is used for " 2138"allowing this package to overwrite the files of another package and is " 2139"usually used with the B<Conflicts> field to force removal of the other " 2140"package, if this one also has the same files as the conflicted package." 2141msgstr "" 2142 2143#. type: Plain text 2144#: deb-control.man 2145msgid "" 2146"The syntax of B<Breaks>, B<Conflicts> and B<Replaces> is a list of package " 2147"names, separated by commas (and optional whitespace). In the B<Breaks> and " 2148"B<Conflicts> fields, the comma should be read as “OR”. An optional " 2149"architecture qualifier can also be appended to the package name with the " 2150"same syntax as above, but the default is B<any> instead of the binary " 2151"package architecture. An optional version can also be given with the same " 2152"syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields." 2153msgstr "" 2154 2155#. type: TQ 2156#: deb-control.man deb-src-control.man 2157#, no-wrap 2158msgid "B<Enhances:>I< package-list>" 2159msgstr "" 2160 2161#. type: Plain text 2162#: deb-control.man 2163msgid "" 2164"This is a list of packages that this one enhances. It is similar to " 2165"B<Suggests> but in the opposite direction." 2166msgstr "" 2167 2168#. type: TQ 2169#: deb-control.man deb-src-control.man 2170#, no-wrap 2171msgid "B<Provides:>I< package-list>" 2172msgstr "" 2173 2174#. type: Plain text 2175#: deb-control.man 2176msgid "" 2177"This is a list of virtual packages that this one provides. Usually this is " 2178"used in the case of several packages all providing the same service. For " 2179"example, sendmail and exim can serve as a mail server, so they provide a " 2180"common package (“mail-transport-agent”) on which other packages can depend. " 2181"This will allow sendmail or exim to serve as a valid option to satisfy the " 2182"dependency. This prevents the packages that depend on a mail server from " 2183"having to know the package names for all of them, and using ‘B<|>’ to " 2184"separate the list." 2185msgstr "" 2186 2187#. type: Plain text 2188#: deb-control.man 2189msgid "" 2190"The syntax of B<Provides> is a list of package names, separated by commas " 2191"(and optional whitespace). An optional architecture qualifier can also be " 2192"appended to the package name with the same syntax as above. If omitted, the " 2193"default is the current binary package architecture. An optional exact " 2194"(equal to) version can also be given with the same syntax as above (honored " 2195"since dpkg 1.17.11)." 2196msgstr "" 2197 2198#. type: TQ 2199#: deb-control.man deb-src-control.man 2200#, no-wrap 2201msgid "B<Built-Using:>I< package-list>" 2202msgstr "" 2203 2204#. type: Plain text 2205#: deb-control.man 2206msgid "" 2207"This field lists extra source packages that were used during the build of " 2208"this binary package. This is an indication to the archive maintenance " 2209"software that these extra source packages must be kept whilst this binary " 2210"package is maintained. This field must be a list of source package names " 2211"with strict ‘B<=>’ version relationships. Note that the archive maintenance " 2212"software is likely to refuse to accept an upload which declares a B<Built-" 2213"Using> relationship which cannot be satisfied within the archive." 2214msgstr "" 2215 2216#. type: TP 2217#: deb-control.man 2218#, no-wrap 2219msgid "B<Built-For-Profiles:>I< profile-list (obsolete)>" 2220msgstr "" 2221 2222#. type: Plain text 2223#: deb-control.man 2224msgid "" 2225"This field used to specify a whitespace separated list of build profiles " 2226"that this binary packages was built with (since dpkg 1.17.2 until 1.18.18). " 2227"The information previously found in this field can now be found in the B<." 2228"buildinfo> file, which supersedes it." 2229msgstr "" 2230 2231#. type: TP 2232#: deb-control.man 2233#, no-wrap 2234msgid "B<Auto-Built-Package:>I< reason-list>" 2235msgstr "" 2236 2237#. type: Plain text 2238#: deb-control.man 2239msgid "" 2240"This field specifies a whitespace separated list of reasons why this package " 2241"was auto-generated. Binary packages marked with this field will not appear " 2242"in the I<debian/control> master source control file. The only currently " 2243"used reason is B<debug-symbols>." 2244msgstr "" 2245 2246#. type: TP 2247#: deb-control.man 2248#, fuzzy, no-wrap 2249#| msgid "B<--abort-after=>I<number>" 2250msgid "B<Build-Ids:>I< elf-build-id-list>" 2251msgstr "B<--abort-after=>I<number>" 2252 2253#. type: Plain text 2254#: deb-control.man 2255msgid "" 2256"This field specifies a whitespace separated list of ELF build-ids. These are " 2257"unique identifiers for semantically identical ELF objects, for each of these " 2258"within the package." 2259msgstr "" 2260 2261#. type: Plain text 2262#: deb-control.man 2263msgid "" 2264"The format or the way to compute each build-id is not defined by design." 2265msgstr "" 2266 2267#. type: SH 2268#: deb-control.man deb-conffiles.man deb-src-control.man deb-origin.man 2269#: start-stop-daemon.man 2270#, no-wrap 2271msgid "EXAMPLE" 2272msgstr "示例" 2273 2274#. type: Plain text 2275#: deb-control.man 2276#, no-wrap 2277msgid "" 2278"Package: grep\n" 2279"Essential: yes\n" 2280"Priority: required\n" 2281"Section: base\n" 2282"Maintainer: Wichert Akkerman E<lt>wakkerma@debian.orgE<gt>\n" 2283"Architecture: sparc\n" 2284"Version: 2.4-1\n" 2285"Pre-Depends: libc6 (E<gt>= 2.0.105)\n" 2286"Provides: rgrep\n" 2287"Conflicts: rgrep\n" 2288"Description: GNU grep, egrep and fgrep.\n" 2289" The GNU family of grep utilities may be the \"fastest grep in the west\".\n" 2290" GNU grep is based on a fast lazy-state deterministic matcher (about\n" 2291" twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper\n" 2292" search for a fixed string that eliminates impossible text from being\n" 2293" considered by the full regexp matcher without necessarily having to\n" 2294" look at every character. The result is typically many times faster\n" 2295" than Unix grep or egrep. (Regular expressions containing backreferencing\n" 2296" will run more slowly, however).\n" 2297msgstr "" 2298 2299#. type: Plain text 2300#: deb-control.man 2301msgid "" 2302"The B<Build-Ids> field uses a rather generic name out of its original " 2303"context within an ELF object, which serves a very specific purpose and " 2304"executable format." 2305msgstr "" 2306 2307#. type: Plain text 2308#: deb-control.man 2309#, fuzzy 2310#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 2311msgid "" 2312"B<deb-src-control>(5), B<deb>(5), B<deb-version>(7), B<debtags>(1), " 2313"B<dpkg>(1), B<dpkg-deb>(1)." 2314msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 2315 2316#. type: TH 2317#: deb-conffiles.man 2318#, fuzzy, no-wrap 2319#| msgid "deb-control" 2320msgid "deb-conffiles" 2321msgstr "deb-control" 2322 2323#. type: Plain text 2324#: deb-conffiles.man 2325msgid "deb-conffiles - package conffiles" 2326msgstr "" 2327 2328#. type: Plain text 2329#: deb-conffiles.man 2330#, fuzzy 2331#| msgid "B<config-files>" 2332msgid "conffiles" 2333msgstr "B<config-files>" 2334 2335#. type: Plain text 2336#: deb-conffiles.man 2337msgid "" 2338"A package declares its list of conffiles by including a I<conffiles> file in " 2339"its control archive (i.e. I<DEBIAN/conffiles> during package creation)." 2340msgstr "" 2341 2342#. type: Plain text 2343#: deb-conffiles.man 2344msgid "" 2345"This file contains a list of files, one per line. They should be listed as " 2346"absolute pathnames, and should exist in the binary package, otherwise " 2347"B<dpkg>(1) will ignore them (although by default B<dpkg-deb>(1) will refuse " 2348"to build such binary packages). Trailing whitespace will be trimmed, and " 2349"empty lines will be ignored." 2350msgstr "" 2351 2352#. type: Plain text 2353#: deb-conffiles.man 2354#, no-wrap 2355msgid "" 2356"%CONFDIR%/alternatives/README\n" 2357"%CONFDIR%/cron.daily/dpkg\n" 2358"%PKGCONFDIR%/dpkg.cfg\n" 2359"%CONFDIR%/logrotate.d/dpkg\n" 2360msgstr "" 2361 2362#. type: Plain text 2363#: deb-conffiles.man 2364#, fuzzy 2365#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 2366msgid "B<dpkg-deb>(1), B<dpkg>(1)." 2367msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 2368 2369#. type: TH 2370#: deb-src-control.man 2371#, no-wrap 2372msgid "deb-src-control" 2373msgstr "" 2374 2375#. type: Plain text 2376#: deb-src-control.man 2377msgid "deb-src-control - Debian source packages' master control file format" 2378msgstr "deb-src-control - Debian 源代码包的主控文件格式" 2379 2380#. type: Plain text 2381#: deb-src-control.man 2382#, fuzzy 2383#| msgid "deb-control" 2384msgid "debian/control" 2385msgstr "deb-control" 2386 2387#. type: Plain text 2388#: deb-src-control.man 2389msgid "" 2390"Each Debian source package contains the master «control» file, which " 2391"contains at least 2 paragraphs, separated by a blank line. The first " 2392"paragraph lists all information about the source package in general, while " 2393"each following paragraph describes exactly one binary package. Each " 2394"paragraph consists of at least one field. A field starts with a fieldname, " 2395"such as B<Package> or B<Section> (case insensitive), followed by a colon, " 2396"the body of the field and a newline. Multi-line fields are also allowed, " 2397"but each supplementary line, without a fieldname, should start with at least " 2398"one space. The content of the multi-line fields is generally joined to a " 2399"single line by the tools (except in the case of the B<Description> field, " 2400"see below). To insert empty lines into a multi-line field, insert a dot " 2401"after the space. Lines starting with a ‘B<#>’ are treated as comments." 2402msgstr "" 2403 2404#. type: SH 2405#: deb-src-control.man 2406#, no-wrap 2407msgid "SOURCE FIELDS" 2408msgstr "源码相关字段" 2409 2410#. type: TP 2411#: deb-src-control.man 2412#, no-wrap 2413msgid "B<Source:> I<source-package-name> (required)" 2414msgstr "" 2415 2416#. type: Plain text 2417#: deb-src-control.man 2418msgid "" 2419"The value of this field is the name of the source package, and should match " 2420"the name of the source package in the debian/changelog file. A package name " 2421"must consist only of lowercase letters (a-z), digits (0-9), plus (+) and " 2422"minus (-) signs, and periods (.). Package names must be at least two " 2423"characters long and must start with a lowercase alphanumeric character (a-" 2424"z0-9)." 2425msgstr "" 2426 2427#. type: Plain text 2428#: deb-src-control.man 2429msgid "" 2430"Should be in the format «Joe Bloggs E<lt>jbloggs@foo.comE<gt>», and " 2431"references the person who currently maintains the package, as opposed to the " 2432"author of the software or the original packager." 2433msgstr "" 2434 2435#. type: TP 2436#: deb-src-control.man 2437#, no-wrap 2438msgid "B<Uploaders:>I< fullname-email>" 2439msgstr "" 2440 2441#. type: Plain text 2442#: deb-src-control.man dsc.man 2443msgid "" 2444"Lists all the names and email addresses of co-maintainers of the package, in " 2445"the same format as the B<Maintainer> field. Multiple co-maintainers should " 2446"be separated by a comma." 2447msgstr "" 2448 2449#. type: TP 2450#: deb-src-control.man 2451#, no-wrap 2452msgid "B<Standards-Version:>I< version-string>" 2453msgstr "" 2454 2455#. type: Plain text 2456#: deb-src-control.man dsc.man 2457msgid "" 2458"This documents the most recent version of the distribution policy standards " 2459"this package complies with." 2460msgstr "" 2461 2462#. type: TP 2463#: deb-src-control.man dsc.man 2464#, fuzzy, no-wrap 2465#| msgid "B<Version:>I< version-string>" 2466msgid "B<Description>I< short-description>" 2467msgstr "B<Version:>I< version-string>" 2468 2469#. type: Plain text 2470#: deb-src-control.man dsc.man 2471msgid "" 2472"The format for the source package description is a short brief summary on " 2473"the first line (after the B<Description> field). The following lines should " 2474"be used as a longer, more detailed description. Each line of the long " 2475"description must be preceded by a space, and blank lines in the long " 2476"description must contain a single ‘B<.>’ following the preceding space." 2477msgstr "" 2478 2479#. type: Plain text 2480#: deb-src-control.man 2481msgid "The upstream project home page URL." 2482msgstr "" 2483 2484#. type: Plain text 2485#: deb-src-control.man 2486msgid "" 2487"The I<url> of the bug tracking system for this package. The current used " 2488"format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian." 2489"org>. This field is usually not needed." 2490msgstr "" 2491 2492#. type: TP 2493#: deb-src-control.man 2494#, no-wrap 2495msgid "B<Rules-Requires-Root:> B<no>|B<binary-targets>|I<impl-keywords>" 2496msgstr "" 2497 2498#. type: Plain text 2499#: deb-src-control.man 2500msgid "" 2501"This field is used to indicate whether the B<debian/rules> file requires " 2502"(fake)root privileges to run some of its targets, and if so when." 2503msgstr "" 2504 2505#. type: Plain text 2506#: deb-src-control.man 2507msgid "The binary targets will not require (fake)root at all." 2508msgstr "" 2509 2510#. type: TP 2511#: deb-src-control.man 2512#, no-wrap 2513msgid "B<binary-targets>" 2514msgstr "" 2515 2516#. type: Plain text 2517#: deb-src-control.man 2518msgid "" 2519"The binary targets must always be run under (fake)root. This value is the " 2520"default when the field is omitted; adding the field with an explicit " 2521"B<binary-targets> while not strictly needed, marks it as having been " 2522"analyzed for this requirement." 2523msgstr "" 2524 2525#. type: TP 2526#: deb-src-control.man 2527#, no-wrap 2528msgid "I<impl-keywords>" 2529msgstr "" 2530 2531#. type: Plain text 2532#: deb-src-control.man 2533msgid "" 2534"This is a space-separated list of keywords which define when (fake)root is " 2535"required." 2536msgstr "" 2537 2538#. type: Plain text 2539#: deb-src-control.man 2540msgid "" 2541"Keywords consist of I<namespace>/I<cases>. The I<namespace> part cannot " 2542"contain \"/\" or whitespace. The I<cases> part cannot contain whitespace. " 2543"Furthermore, both parts must consist entirely of printable ASCII characters." 2544msgstr "" 2545 2546#. type: Plain text 2547#: deb-src-control.man 2548msgid "" 2549"Each tool/package will define a namespace named after itself and provide a " 2550"number of cases where (fake)root is required. (See \"Implementation " 2551"provided keywords\" in I<rootless-builds.txt>)." 2552msgstr "" 2553 2554#. type: Plain text 2555#: deb-src-control.man 2556msgid "" 2557"When the field is set to one of the I<impl-keywords>, the builder will " 2558"expose an interface that is used to run a command under (fake)root. (See " 2559"\"Gain Root API\" in I<rootless-builds.txt>.)" 2560msgstr "" 2561 2562#. type: TP 2563#: deb-src-control.man dsc.man 2564#, no-wrap 2565msgid "B<Testsuite:>I< name-list>" 2566msgstr "" 2567 2568#. type: TP 2569#: deb-src-control.man dsc.man 2570#, no-wrap 2571msgid "B<Testsuite-Triggers:>I< package-list>" 2572msgstr "" 2573 2574#. type: Plain text 2575#: deb-src-control.man 2576msgid "" 2577"These fields are described in the B<dsc>(5) manual page, as they are " 2578"generated from information inferred from B<debian/tests/control> or copied " 2579"literally to the source control file." 2580msgstr "" 2581 2582#. type: TP 2583#: deb-src-control.man dsc.man 2584#, no-wrap 2585msgid "B<Vcs-Arch:>I< url>" 2586msgstr "" 2587 2588#. type: TQ 2589#: deb-src-control.man dsc.man 2590#, no-wrap 2591msgid "B<Vcs-Bzr:>I< url>" 2592msgstr "" 2593 2594#. type: TQ 2595#: deb-src-control.man dsc.man 2596#, no-wrap 2597msgid "B<Vcs-Cvs:>I< url>" 2598msgstr "" 2599 2600#. type: TQ 2601#: deb-src-control.man dsc.man 2602#, no-wrap 2603msgid "B<Vcs-Darcs:>I< url>" 2604msgstr "" 2605 2606#. type: TQ 2607#: deb-src-control.man dsc.man 2608#, no-wrap 2609msgid "B<Vcs-Git:>I< url>" 2610msgstr "" 2611 2612#. type: TQ 2613#: deb-src-control.man dsc.man 2614#, no-wrap 2615msgid "B<Vcs-Hg:>I< url>" 2616msgstr "" 2617 2618#. type: TQ 2619#: deb-src-control.man dsc.man 2620#, no-wrap 2621msgid "B<Vcs-Mtn:>I< url>" 2622msgstr "" 2623 2624#. type: TQ 2625#: deb-src-control.man dsc.man 2626#, no-wrap 2627msgid "B<Vcs-Svn:>I< url>" 2628msgstr "" 2629 2630#. type: Plain text 2631#: deb-src-control.man 2632msgid "" 2633"The I<url> of the Version Control System repository used to maintain this " 2634"package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, " 2635"B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> (Subversion). " 2636"Usually this field points to the latest version of the package, such as the " 2637"main branch or the trunk." 2638msgstr "" 2639 2640#. type: TP 2641#: deb-src-control.man dsc.man 2642#, no-wrap 2643msgid "B<Vcs-Browser:>I< url>" 2644msgstr "" 2645 2646#. type: Plain text 2647#: deb-src-control.man 2648msgid "" 2649"The I<url> of a webinterface to browse the Version Control System repository." 2650msgstr "" 2651 2652#. type: Plain text 2653#: deb-src-control.man 2654msgid "" 2655"The name of the distribution this package is originating from. This field is " 2656"usually not needed." 2657msgstr "" 2658 2659#. type: TP 2660#: deb-src-control.man dsc.man 2661#, no-wrap 2662msgid "B<Build-Depends:>I< package-list>" 2663msgstr "" 2664 2665#. type: Plain text 2666#: deb-src-control.man 2667msgid "" 2668"A list of packages that need to be installed and configured to be able to " 2669"build from source package. These dependencies need to be satisfied when " 2670"building binary architecture dependent or independent packages and source " 2671"packages. Including a dependency in this field does not have the exact same " 2672"effect as including it in both B<Build-Depends-Arch> and B<Build-Depends-" 2673"Indep>, because the dependency also needs to be satisfied when building the " 2674"source package." 2675msgstr "" 2676 2677#. type: TQ 2678#: deb-src-control.man dsc.man 2679#, no-wrap 2680msgid "B<Build-Depends-Arch:>I< package-list>" 2681msgstr "" 2682 2683#. type: Plain text 2684#: deb-src-control.man 2685msgid "" 2686"Same as B<Build-Depends>, but they are only needed when building the " 2687"architecture dependent packages. The B<Build-Depends> are also installed in " 2688"this case. This field is supported since dpkg 1.16.4; in order to build with " 2689"older dpkg versions, B<Build-Depends> should be used instead." 2690msgstr "" 2691 2692#. type: TQ 2693#: deb-src-control.man dsc.man 2694#, no-wrap 2695msgid "B<Build-Depends-Indep:>I< package-list>" 2696msgstr "" 2697 2698#. type: Plain text 2699#: deb-src-control.man 2700msgid "" 2701"Same as B<Build-Depends>, but they are only needed when building the " 2702"architecture independent packages. The B<Build-Depends> are also installed " 2703"in this case." 2704msgstr "" 2705 2706#. type: TQ 2707#: deb-src-control.man dsc.man 2708#, no-wrap 2709msgid "B<Build-Conflicts:>I< package-list>" 2710msgstr "" 2711 2712#. type: Plain text 2713#: deb-src-control.man 2714msgid "" 2715"A list of packages that should not be installed when the package is built, " 2716"for example because they interfere with the build system used. Including a " 2717"dependency in this list has the same effect as including it in both B<Build-" 2718"Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional effect of " 2719"being used for source-only builds." 2720msgstr "" 2721 2722#. type: TQ 2723#: deb-src-control.man dsc.man 2724#, no-wrap 2725msgid "B<Build-Conflicts-Arch:>I< package-list>" 2726msgstr "" 2727 2728#. type: Plain text 2729#: deb-src-control.man 2730msgid "" 2731"Same as B<Build-Conflicts>, but only when building the architecture " 2732"dependent packages. This field is supported since dpkg 1.16.4; in order to " 2733"build with older dpkg versions, B<Build-Conflicts> should be used instead." 2734msgstr "" 2735 2736#. type: TQ 2737#: deb-src-control.man dsc.man 2738#, no-wrap 2739msgid "B<Build-Conflicts-Indep:>I< package-list>" 2740msgstr "" 2741 2742#. type: Plain text 2743#: deb-src-control.man 2744msgid "" 2745"Same as B<Build-Conflicts>, but only when building the architecture " 2746"independent packages." 2747msgstr "" 2748 2749#. type: Plain text 2750#: deb-src-control.man 2751msgid "" 2752"The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and B<Build-" 2753"Depends-Indep> fields is a list of groups of alternative packages. Each " 2754"group is a list of packages separated by vertical bar (or “pipe”) symbols, " 2755"‘B<|>’. The groups are separated by commas ‘B<,>’, and can end with a " 2756"trailing comma that will be eliminated when generating the fields for B<deb-" 2757"control>(5) (since dpkg 1.10.14). Commas are to be read as “AND”, and pipes " 2758"as “OR”, with pipes binding more tightly. Each package name is optionally " 2759"followed by an architecture qualifier appended after a colon ‘B<:>’, " 2760"optionally followed by a version number specification in parentheses ‘B<(>’ " 2761"and ‘B<)>’, an architecture specification in square brackets ‘B<[>’ and " 2762"‘B<]>’, and a restriction formula consisting of one or more lists of profile " 2763"names in angle brackets ‘B<E<lt>>’ and ‘B<E<gt>>’." 2764msgstr "" 2765 2766#. type: Plain text 2767#: deb-src-control.man 2768msgid "" 2769"The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and B<Build-" 2770"Conflicts-Indep> fields is a list of comma-separated package names, where " 2771"the comma is read as an “AND”, and where the list can end with a trailing " 2772"comma that will be eliminated when generating the fields for B<deb-" 2773"control>(5) (since dpkg 1.10.14). Specifying alternative packages using a " 2774"“pipe” is not supported. Each package name is optionally followed by a " 2775"version number specification in parentheses, an architecture specification " 2776"in square brackets, and a restriction formula consisting of one or more " 2777"lists of profile names in angle brackets." 2778msgstr "" 2779 2780#. type: Plain text 2781#: deb-src-control.man 2782msgid "" 2783"An architecture qualifier name can be a real Debian architecture name (since " 2784"dpkg 1.16.5), B<any> (since dpkg 1.16.2) or B<native> (since dpkg 1.16.5). " 2785"If omitted, the default for B<Build-Depends> fields is the current host " 2786"architecture, the default for B<Build-Conflicts> fields is B<any>. A real " 2787"Debian architecture name will match exactly that architecture for that " 2788"package name, B<any> will match any architecture for that package name if " 2789"the package is marked with B<Multi-Arch: allowed>, and B<native> will match " 2790"the current build architecture if the package is not marked with B<Multi-" 2791"Arch: foreign>." 2792msgstr "" 2793 2794#. type: Plain text 2795#: deb-src-control.man 2796msgid "" 2797"An architecture specification consists of one or more architecture names, " 2798"separated by whitespace. Exclamation marks may be prepended to each of the " 2799"names, meaning “NOT”." 2800msgstr "" 2801 2802#. type: Plain text 2803#: deb-src-control.man 2804msgid "" 2805"A restriction formula consists of one or more restriction lists, separated " 2806"by whitespace. Each restriction list is enclosed in angle brackets. Items in " 2807"the restriction list are build profile names, separated by whitespace and " 2808"can be prefixed with an exclamation mark, meaning “NOT”. A restriction " 2809"formula represents a disjunctive normal form expression." 2810msgstr "" 2811 2812#. type: Plain text 2813#: deb-src-control.man 2814msgid "" 2815"Note that dependencies on packages in the B<build-essential> set can be " 2816"omitted and that declaring build conflicts against them is impossible. A " 2817"list of these packages is in the build-essential package." 2818msgstr "" 2819 2820#. type: SH 2821#: deb-src-control.man 2822#, no-wrap 2823msgid "BINARY FIELDS" 2824msgstr "二进制相关字段" 2825 2826#. type: Plain text 2827#: deb-src-control.man 2828msgid "" 2829"Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in " 2830"a binary paragraph to override the global value from the source package." 2831msgstr "" 2832 2833#. type: TP 2834#: deb-src-control.man 2835#, no-wrap 2836msgid "B<Package:> I<binary-package-name> (required)" 2837msgstr "" 2838 2839#. type: Plain text 2840#: deb-src-control.man 2841msgid "" 2842"This field is used to name the binary package name. The same restrictions as " 2843"to a source package name apply." 2844msgstr "" 2845 2846#. type: TP 2847#: deb-src-control.man 2848#, no-wrap 2849msgid "B<Architecture:> I<arch>|B<all>|B<any> (required)" 2850msgstr "" 2851 2852#. type: Plain text 2853#: deb-src-control.man 2854msgid "" 2855"The architecture specifies on which type of hardware this package runs. For " 2856"packages that run on all architectures, use the B<any> value. For packages " 2857"that are architecture independent, such as shell and Perl scripts or " 2858"documentation, use the B<all> value. To restrict the packages to a certain " 2859"set of architectures, specify the architecture names, separated by a space. " 2860"It's also possible to put architecture wildcards in that list (see B<dpkg-" 2861"architecture>(1) for more information about them)." 2862msgstr "" 2863 2864#. type: TP 2865#: deb-src-control.man 2866#, no-wrap 2867msgid "B<Build-Profiles:> I<restriction-formula>" 2868msgstr "" 2869 2870#. type: Plain text 2871#: deb-src-control.man 2872msgid "" 2873"This field specifies the conditions for which this binary package does or " 2874"does not build. To express that condition, the same restriction formula " 2875"syntax from the B<Build-Depends> field is used." 2876msgstr "" 2877 2878#. type: Plain text 2879#: deb-src-control.man 2880msgid "" 2881"If a binary package paragraph does not contain this field, then it " 2882"implicitly means that it builds with all build profiles (including none at " 2883"all)." 2884msgstr "" 2885 2886#. type: Plain text 2887#: deb-src-control.man 2888msgid "" 2889"In other words, if a binary package paragraph is annotated with a non-empty " 2890"B<Build-Profiles> field, then this binary package is generated if and only " 2891"if the condition expressed by the conjunctive normal form expression " 2892"evaluates to true." 2893msgstr "" 2894 2895#. type: TQ 2896#: deb-src-control.man 2897#, no-wrap 2898msgid "B<Multi-Arch:> B<same>|B<foreign>|B<allowed>|B<no>" 2899msgstr "" 2900 2901#. type: Plain text 2902#: deb-src-control.man 2903msgid "" 2904"These fields are described in the B<deb-control>(5) manual page, as they " 2905"are copied literally to the control file of the binary package." 2906msgstr "" 2907 2908#. type: Plain text 2909#: deb-src-control.man 2910msgid "" 2911"These fields declare relationships between packages. They are discussed in " 2912"the B<deb-control>(5) manpage. When these fields are found in I<debian/" 2913"control> they can also end with a trailing comma (since dpkg 1.10.14), have " 2914"architecture specifications and restriction formulas which will all get " 2915"reduced when generating the fields for B<deb-control>(5)." 2916msgstr "" 2917 2918#. type: Plain text 2919#: deb-src-control.man 2920msgid "" 2921"These fields are used by the debian-installer in B<udeb>s and are usually " 2922"not needed. See /usr/share/doc/debian-installer/devel/modules.txt from the " 2923"B<debian-installer> package for more details about them." 2924msgstr "" 2925 2926#. type: SH 2927#: deb-src-control.man 2928#, no-wrap 2929msgid "USER-DEFINED FIELDS" 2930msgstr "用户自定义字段" 2931 2932#. type: Plain text 2933#: deb-src-control.man 2934msgid "" 2935"It is allowed to add additional user-defined fields to the control file. The " 2936"tools will ignore these fields. If you want the fields to be copied over to " 2937"the output files, such as the binary packages, you need to use a custom " 2938"naming scheme: the fields should start with an B<X>, followed by zero or " 2939"more of the letters B<SBC> and a hyphen." 2940msgstr "" 2941 2942#. type: TP 2943#: deb-src-control.man 2944#, no-wrap 2945msgid "B<S>" 2946msgstr "" 2947 2948#. type: Plain text 2949#: deb-src-control.man 2950msgid "" 2951"The field will appear in the source package control file, see B<dsc>(5)." 2952msgstr "" 2953 2954#. type: TP 2955#: deb-src-control.man 2956#, no-wrap 2957msgid "B<B>" 2958msgstr "" 2959 2960#. type: Plain text 2961#: deb-src-control.man 2962msgid "" 2963"The field will appear in the control file in the binary package, see B<deb-" 2964"control>(5)." 2965msgstr "" 2966 2967#. type: TP 2968#: deb-src-control.man 2969#, no-wrap 2970msgid "B<C>" 2971msgstr "" 2972 2973#. type: Plain text 2974#: deb-src-control.man 2975msgid "" 2976"The field will appear in the upload control (.changes) file, see B<deb-" 2977"changes>(5)." 2978msgstr "" 2979 2980#. type: Plain text 2981#: deb-src-control.man 2982msgid "" 2983"Note that the B<X>[B<SBC>]B<-> prefixes are stripped when the fields are " 2984"copied over to the output files. A field B<XC-Approved-By> will appear as " 2985"B<Approved-By> in the changes file and will not appear in the binary or " 2986"source package control files." 2987msgstr "" 2988 2989#. type: Plain text 2990#: deb-src-control.man 2991msgid "" 2992"Take into account that these user-defined fields will be using the global " 2993"namespace, which might at some point in the future collide with officially " 2994"recognized fields. To avoid such potential situation you can prefix those " 2995"fields with B<Private->, such as B<XB-Private-New-Field>." 2996msgstr "" 2997 2998#. type: Plain text 2999#: deb-src-control.man 3000#, no-wrap 3001msgid "" 3002"# Comment\n" 3003"Source: dpkg\n" 3004"Section: admin\n" 3005"Priority: required\n" 3006"Maintainer: Dpkg Developers E<lt>debian-dpkg@lists.debian.orgE<gt>\n" 3007"# this field is copied to the binary and source packages\n" 3008"XBS-Upstream-Release-Status: stable\n" 3009"Homepage: https://wiki.debian.org/Teams/Dpkg\n" 3010"Vcs-Browser: https://git.dpkg.org/cgit/dpkg/dpkg.git\n" 3011"Vcs-Git: https://git.dpkg.org/git/dpkg/dpkg.git\n" 3012"Standards-Version: 3.7.3\n" 3013"Build-Depends: pkg-config, debhelper (E<gt>= 4.1.81),\n" 3014" libselinux1-dev (E<gt>= 1.28-4) [!linux-any]\n" 3015msgstr "" 3016 3017#. type: Plain text 3018#: deb-src-control.man 3019#, no-wrap 3020msgid "" 3021"Package: dpkg-dev\n" 3022"Section: utils\n" 3023"Priority: optional\n" 3024"Architecture: all\n" 3025"# this is a custom field in the binary package\n" 3026"XB-Mentoring-Contact: Raphael Hertzog E<lt>hertzog@debian.orgE<gt>\n" 3027"Depends: dpkg (E<gt>= 1.14.6), perl5, perl-modules, cpio (E<gt>= 2.4.2-2),\n" 3028" bzip2, lzma, patch (E<gt>= 2.2-1), make, binutils, libtimedate-perl\n" 3029"Recommends: gcc | c-compiler, build-essential\n" 3030"Suggests: gnupg, debian-keyring\n" 3031"Conflicts: dpkg-cross (E<lt>E<lt> 2.0.0), devscripts (E<lt>E<lt> 2.10.26)\n" 3032"Replaces: manpages-pl (E<lt>= 20051117-1)\n" 3033"Description: Debian package development tools\n" 3034" This package provides the development tools (including dpkg-source)\n" 3035" required to unpack, build and upload Debian source packages.\n" 3036" .\n" 3037" Most Debian source packages will require additional tools to build;\n" 3038" for example, most packages need make and the C compiler gcc.\n" 3039msgstr "" 3040 3041#. type: Plain text 3042#: deb-src-control.man 3043#, fuzzy 3044#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 3045msgid "B<deb-control>(5), B<deb-version>(7), B<dpkg-source>(1)" 3046msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 3047 3048#. type: TH 3049#: deb-src-files.man 3050#, fuzzy, no-wrap 3051#| msgid "deb-control" 3052msgid "deb-src-files" 3053msgstr "deb-control" 3054 3055#. type: Plain text 3056#: deb-src-files.man 3057#, fuzzy 3058#| msgid "deb-control - Debian packages' master control file format" 3059msgid "deb-src-files - Debian distribute files format" 3060msgstr "deb-control - Debian 软件包的主控文件格式" 3061 3062#. type: Plain text 3063#: deb-src-files.man 3064#, fuzzy 3065#| msgid "deb-control" 3066msgid "debian/files" 3067msgstr "deb-control" 3068 3069#. type: Plain text 3070#: deb-src-files.man 3071msgid "" 3072"This file contains the list of artifacts that are to be distributed via the " 3073"B<.changes> control file." 3074msgstr "" 3075 3076#. type: Plain text 3077#: deb-src-files.man 3078msgid "The I<debian/files> file has a simple whitespace-delimited format." 3079msgstr "" 3080 3081#. type: Plain text 3082#: deb-src-files.man 3083msgid "I<filename> I<section> I<priority> [ I<keyword=value\\&...\\&> ]" 3084msgstr "" 3085 3086#. type: Plain text 3087#: deb-src-files.man 3088#, fuzzy 3089#| msgid "I<conffile> is the filename of the conffile to remove." 3090msgid "I<filename> is the name of the artifact to distribute." 3091msgstr "I<配置文件> 参数是要移除的配置文件名。" 3092 3093#. type: Plain text 3094#: deb-src-files.man 3095msgid "" 3096"I<section> and I<priority> correspond to the respective control fields " 3097"available in the .deb. The allowed values are specific to each distribution " 3098"archive." 3099msgstr "" 3100 3101#. type: Plain text 3102#: deb-src-files.man 3103msgid "" 3104"I<keyword=value\\&...\\&> corresponds to an optional whitespace-delimited " 3105"list of attributes for this entry. The only currently supported keyword is " 3106"B<automatic> with value B<yes>, to mark automatically generated files." 3107msgstr "" 3108 3109#. type: SH 3110#: deb-src-files.man deb-version.man dpkg-architecture.man 3111#: dpkg-buildpackage.man dpkg-deb.man dpkg-divert.man dpkg-parsechangelog.man 3112#, no-wrap 3113msgid "NOTES" 3114msgstr "" 3115 3116#. type: Plain text 3117#: deb-src-files.man 3118msgid "" 3119"This file is not intended to be modified directly, please use one of B<dpkg-" 3120"gencontrol> or B<dpkg-distaddfile> to add entries to it." 3121msgstr "" 3122 3123#. type: Plain text 3124#: deb-src-files.man 3125#, fuzzy 3126#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 3127msgid "B<dpkg-genchanges>(1), B<dpkg-distaddfile>(1)." 3128msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 3129 3130#. type: TH 3131#: deb-src-rules.man 3132#, fuzzy, no-wrap 3133#| msgid "deb-control" 3134msgid "deb-src-rules" 3135msgstr "deb-control" 3136 3137#. type: TH 3138#: deb-src-rules.man 3139#, no-wrap 3140msgid "2017-09-05" 3141msgstr "" 3142 3143#. type: TH 3144#: deb-src-rules.man 3145#, fuzzy, no-wrap 3146#| msgid "Debian" 3147msgid "Debian Project" 3148msgstr "Debian" 3149 3150#. type: TH 3151#: deb-src-rules.man 3152#, fuzzy, no-wrap 3153#| msgid "dpkg suite" 3154msgid "dpkg utilities" 3155msgstr "dpkg 软件集" 3156 3157#. type: Plain text 3158#: deb-src-rules.man 3159#, fuzzy 3160#| msgid "deb-src-control - Debian source packages' master control file format" 3161msgid "deb-src-rules - Debian source package rules file" 3162msgstr "deb-src-control - Debian 源代码包的主控文件格式" 3163 3164#. type: Plain text 3165#: deb-src-rules.man 3166#, fuzzy 3167#| msgid "deb-control" 3168msgid "debian/rules" 3169msgstr "deb-control" 3170 3171#. type: Plain text 3172#: deb-src-rules.man 3173msgid "" 3174"This file contains the instructions necessary to build the binary packages " 3175"from the source package." 3176msgstr "" 3177 3178#. type: Plain text 3179#: deb-src-rules.man 3180msgid "" 3181"The I<debian/rules> file is an executable Makefile, with a shebang that is " 3182"usually set to \"#!/usr/bin/make -f\"." 3183msgstr "" 3184 3185#. type: Plain text 3186#: deb-src-rules.man 3187msgid "It must support the following make targets:" 3188msgstr "" 3189 3190#. type: TP 3191#: deb-src-rules.man 3192#, fuzzy, no-wrap 3193#| msgid "B<--ignore-depends>=I<package>,..." 3194msgid "B<clean>" 3195msgstr "B<--ignore-depends>=I<package>,..." 3196 3197#. type: Plain text 3198#: deb-src-rules.man 3199msgid "" 3200"Clean up the source tree, by undoing any change done by any of the build and " 3201"binary targets. This target will be called with root privileges." 3202msgstr "" 3203 3204#. type: TP 3205#: deb-src-rules.man 3206#, no-wrap 3207msgid "B<build-indep>" 3208msgstr "" 3209 3210#. type: Plain text 3211#: deb-src-rules.man 3212msgid "" 3213"Build architecture independent files required to build any architecture " 3214"independent binary package. If there are no architecture independent binary " 3215"packages to generate, the target must still exist but do nothing. This " 3216"target must not require root privileges." 3217msgstr "" 3218 3219#. type: TP 3220#: deb-src-rules.man 3221#, no-wrap 3222msgid "B<build-arch>" 3223msgstr "" 3224 3225#. type: Plain text 3226#: deb-src-rules.man 3227msgid "" 3228"Build architecture dependent files required to build any architecture " 3229"dependent binary package. If there are no architecture dependent binary " 3230"packages to generate, the target must still exist but do nothing. This " 3231"target must not require root privileges." 3232msgstr "" 3233 3234#. type: TP 3235#: deb-src-rules.man 3236#, no-wrap 3237msgid "B<build>" 3238msgstr "" 3239 3240#. type: Plain text 3241#: deb-src-rules.man 3242msgid "" 3243"Build architecture independent and dependent files, either by depending (at " 3244"least transitively) on B<build-indep> and/or B<build-arch> or by inlining " 3245"what those targets would do. This target must not require root privileges." 3246msgstr "" 3247 3248#. type: TP 3249#: deb-src-rules.man 3250#, no-wrap 3251msgid "B<binary-indep>" 3252msgstr "" 3253 3254#. type: Plain text 3255#: deb-src-rules.man 3256msgid "" 3257"Build architecture independent binary packages. This target must depend (at " 3258"least transitively) on either B<build-indep> or B<build>. This target will " 3259"be called with root privileges." 3260msgstr "" 3261 3262#. type: TP 3263#: deb-src-rules.man 3264#, no-wrap 3265msgid "B<binary-arch>" 3266msgstr "" 3267 3268#. type: Plain text 3269#: deb-src-rules.man 3270msgid "" 3271"Build architecture dependent binary packages. This target must depend (at " 3272"least transitively) on either B<build-arch> or B<build>. This target will " 3273"be called with root privileges." 3274msgstr "" 3275 3276#. type: TP 3277#: deb-src-rules.man dpkg-buildpackage.man dpkg-genbuildinfo.man 3278#: dpkg-genchanges.man 3279#, no-wrap 3280msgid "B<binary>" 3281msgstr "" 3282 3283#. type: Plain text 3284#: deb-src-rules.man 3285msgid "" 3286"Build architecture independent and dependent binary packages, either by " 3287"depending (at least transitively) on B<binary-indep> and/or B<binary-arch> " 3288"or by inlining what those targets would do. This target will be called with " 3289"root privileges." 3290msgstr "" 3291 3292#. type: Plain text 3293#: deb-src-rules.man 3294msgid "" 3295"B<dpkg-architecture>(1), B<dpkg-vendor>(1), B<dpkg-buildflags>(1), B<dpkg-" 3296"parsechangelog>(1), B<dpkg-shlibdeps>(1), B<dpkg-gencontrol>(1), B<dpkg-" 3297"deb>(1), B<dpkg-distaddfile>(1)." 3298msgstr "" 3299 3300#. type: TH 3301#: deb-split.man 3302#, no-wrap 3303msgid "deb-split" 3304msgstr "" 3305 3306#. type: Plain text 3307#: deb-split.man 3308msgid "deb-split - Debian multi-part binary package format" 3309msgstr "deb-split - 分割的多块 Debian 二进制软件包格式" 3310 3311#. type: Plain text 3312#: deb-split.man 3313msgid "" 3314"The multi-part B<.deb> format is used to split big packages into smaller " 3315"pieces to ease transport in small media." 3316msgstr "" 3317 3318#. type: Plain text 3319#: deb-split.man 3320msgid "" 3321"The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>. The " 3322"file names might contain a trailing slash (since dpkg 1.15.6)." 3323msgstr "" 3324 3325#. type: Plain text 3326#: deb-split.man 3327msgid "" 3328"The first member is named B<debian-split> and contains a series of lines, " 3329"separated by newlines. Currently eight lines are present:" 3330msgstr "" 3331 3332#. type: IP 3333#: deb-split.man dpkg-gensymbols.man 3334#, no-wrap 3335msgid "•" 3336msgstr "" 3337 3338#. type: Plain text 3339#: deb-split.man 3340msgid "" 3341"The format version number, B<2.1> at the time this manual page was written." 3342msgstr "" 3343 3344#. type: Plain text 3345#: deb-split.man 3346msgid "The package name." 3347msgstr "" 3348 3349#. type: Plain text 3350#: deb-split.man 3351msgid "The package version." 3352msgstr "" 3353 3354#. type: Plain text 3355#: deb-split.man 3356msgid "The md5sum of the package." 3357msgstr "" 3358 3359#. type: Plain text 3360#: deb-split.man 3361msgid "The total size of the package." 3362msgstr "" 3363 3364#. type: Plain text 3365#: deb-split.man 3366msgid "The maximum part size." 3367msgstr "" 3368 3369#. type: Plain text 3370#: deb-split.man 3371msgid "" 3372"The current part number, followed by a slash and the total amount of parts " 3373"(as in ‘1/10’)." 3374msgstr "" 3375 3376#. type: Plain text 3377#: deb-split.man 3378msgid "The package architecture (since dpkg 1.16.1)." 3379msgstr "" 3380 3381#. type: Plain text 3382#: deb-split.man 3383msgid "" 3384"Programs which read multi-part archives should be prepared for the minor " 3385"format version number to be increased and additional lines to be present, " 3386"and should ignore these if this is the case." 3387msgstr "" 3388 3389#. type: Plain text 3390#: deb-split.man 3391msgid "" 3392"If the major format version number has changed, an incompatible change has " 3393"been made and the program should stop. If it has not, then the program " 3394"should be able to safely continue, unless it encounters an unexpected member " 3395"in the archive (except at the end), as described below." 3396msgstr "" 3397 3398#. type: Plain text 3399#: deb-split.man 3400msgid "" 3401"The second, last required member is named B<data.>I<N>, where I<N> denotes " 3402"the part number. It contains the raw part data." 3403msgstr "" 3404 3405#. type: Plain text 3406#: deb-split.man 3407msgid "" 3408"These members must occur in this exact order. Current implementations should " 3409"ignore any additional members after B<data.>I<N>. Further members may be " 3410"defined in the future, and (if possible) will be placed after these two." 3411msgstr "" 3412 3413#. type: Plain text 3414#: deb-split.man 3415msgid "B<deb>(5), B<dpkg-split>(1)." 3416msgstr "" 3417 3418#. type: TH 3419#: deb-version.man 3420#, no-wrap 3421msgid "deb-version" 3422msgstr "" 3423 3424#. type: Plain text 3425#: deb-version.man 3426msgid "deb-version - Debian package version number format" 3427msgstr "deb-version - Debian 软件包版本号格式" 3428 3429#. type: Plain text 3430#: deb-version.man 3431msgid "[I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]" 3432msgstr "" 3433 3434#. type: Plain text 3435#: deb-version.man 3436msgid "" 3437"Version numbers as used for Debian binary and source packages consist of " 3438"three components. These are:" 3439msgstr "" 3440 3441#. type: TP 3442#: deb-version.man 3443#, no-wrap 3444msgid "I<epoch>" 3445msgstr "" 3446 3447#. type: Plain text 3448#: deb-version.man 3449msgid "" 3450"This is a single (generally small) unsigned integer. It may be omitted, in " 3451"which case zero is assumed. If it is omitted then the I<upstream-version> " 3452"may not contain any colons." 3453msgstr "" 3454 3455#. type: Plain text 3456#: deb-version.man 3457msgid "" 3458"It is provided to allow mistakes in the version numbers of older versions of " 3459"a package, and also a package's previous version numbering schemes, to be " 3460"left behind." 3461msgstr "" 3462 3463#. type: TP 3464#: deb-version.man 3465#, no-wrap 3466msgid "I<upstream-version>" 3467msgstr "" 3468 3469#. type: Plain text 3470#: deb-version.man 3471msgid "" 3472"This is the main part of the version number. It is usually the version " 3473"number of the original (“upstream”) package from which the I<.deb> file has " 3474"been made, if this is applicable. Usually this will be in the same format " 3475"as that specified by the upstream author(s); however, it may need to be " 3476"reformatted to fit into the package management system's format and " 3477"comparison scheme." 3478msgstr "" 3479 3480#. type: Plain text 3481#: deb-version.man 3482msgid "" 3483"The comparison behavior of the package management system with respect to the " 3484"I<upstream-version> is described below. The I<upstream-version> portion of " 3485"the version number is mandatory." 3486msgstr "" 3487 3488#. type: Plain text 3489#: deb-version.man 3490msgid "" 3491"The I<upstream-version> may contain only alphanumerics (“A-Za-z0-9”) and the " 3492"characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) " 3493"and should start with a digit. If there is no I<debian-revision> then " 3494"hyphens are not allowed; if there is no I<epoch> then colons are not allowed." 3495msgstr "" 3496 3497#. type: TP 3498#: deb-version.man 3499#, no-wrap 3500msgid "I<debian-revision>" 3501msgstr "" 3502 3503#. type: Plain text 3504#: deb-version.man 3505msgid "" 3506"This part of the version number specifies the version of the Debian package " 3507"based on the upstream version. It may contain only alphanumerics and the " 3508"characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the " 3509"same way as the I<upstream-version> is." 3510msgstr "" 3511 3512#. type: Plain text 3513#: deb-version.man 3514msgid "" 3515"It is optional; if it isn't present then the I<upstream-version> may not " 3516"contain a hyphen. This format represents the case where a piece of software " 3517"was written specifically to be turned into a Debian package, and so there is " 3518"only one “debianization” of it and therefore no revision indication is " 3519"required." 3520msgstr "" 3521 3522#. type: Plain text 3523#: deb-version.man 3524msgid "" 3525"It is conventional to restart the I<debian-revision> at ‘1’ each time the " 3526"I<upstream-version> is increased." 3527msgstr "" 3528 3529#. type: Plain text 3530#: deb-version.man 3531msgid "" 3532"Dpkg will break the version number apart at the last hyphen in the string " 3533"(if there is one) to determine the I<upstream-version> and I<debian-" 3534"revision>. The absence of a I<debian-revision> compares earlier than the " 3535"presence of one (but note that the I<debian-revision> is the least " 3536"significant part of the version number)." 3537msgstr "" 3538 3539#. type: SS 3540#: deb-version.man 3541#, no-wrap 3542msgid "Sorting algorithm" 3543msgstr "" 3544 3545#. type: Plain text 3546#: deb-version.man 3547msgid "" 3548"The I<upstream-version> and I<debian-revision> parts are compared by the " 3549"package management system using the same algorithm:" 3550msgstr "" 3551 3552#. type: Plain text 3553#: deb-version.man 3554msgid "The strings are compared from left to right." 3555msgstr "" 3556 3557#. type: Plain text 3558#: deb-version.man 3559msgid "" 3560"First the initial part of each string consisting entirely of non-digit " 3561"characters is determined. These two parts (one of which may be empty) are " 3562"compared lexically. If a difference is found it is returned. The lexical " 3563"comparison is a comparison of ASCII values modified so that all the letters " 3564"sort earlier than all the non-letters and so that a tilde sorts before " 3565"anything, even the end of a part. For example, the following parts are in " 3566"sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’." 3567msgstr "" 3568 3569#. type: Plain text 3570#: deb-version.man 3571msgid "" 3572"Then the initial part of the remainder of each string which consists " 3573"entirely of digit characters is determined. The numerical values of these " 3574"two parts are compared, and any difference found is returned as the result " 3575"of the comparison. For these purposes an empty string (which can only occur " 3576"at the end of one or both version strings being compared) counts as zero." 3577msgstr "" 3578 3579#. type: Plain text 3580#: deb-version.man 3581msgid "" 3582"These two steps (comparing and removing initial non-digit strings and " 3583"initial digit strings) are repeated until a difference is found or both " 3584"strings are exhausted." 3585msgstr "" 3586 3587#. type: Plain text 3588#: deb-version.man 3589msgid "" 3590"Note that the purpose of epochs is to allow us to leave behind mistakes in " 3591"version numbering, and to cope with situations where the version numbering " 3592"scheme changes. It is B<not> intended to cope with version numbers " 3593"containing strings of letters which the package management system cannot " 3594"interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings." 3595msgstr "" 3596 3597#. type: Plain text 3598#: deb-version.man 3599msgid "" 3600"The tilde character and its special sorting properties were introduced in " 3601"dpkg 1.10 and some parts of the dpkg build scripts only gained support for " 3602"it later in the 1.10.x series." 3603msgstr "" 3604 3605#. type: Plain text 3606#: deb-version.man 3607msgid "B<deb-control>(5), B<deb>(5), B<dpkg>(1)" 3608msgstr "" 3609 3610#. type: TH 3611#: deb-old.man 3612#, no-wrap 3613msgid "deb-old" 3614msgstr "" 3615 3616#. type: Plain text 3617#: deb-old.man 3618msgid "deb-old - old style Debian binary package format" 3619msgstr "" 3620 3621#. type: Plain text 3622#: deb-old.man 3623msgid "" 3624"The B<.deb> format is the Debian binary package file format. This manual " 3625"page describes the B<old> format, used before Debian 0.93. Please see " 3626"B<deb>(5) for details of the new format." 3627msgstr "" 3628 3629#. type: Plain text 3630#: deb-old.man 3631msgid "" 3632"The file is two lines of format information as ASCII text, followed by two " 3633"concatenated gzipped ustar files." 3634msgstr "" 3635 3636#. type: Plain text 3637#: deb-old.man 3638msgid "" 3639"The first line is the format version number padded to 8 digits, and is " 3640"B<0.939000> for all old-format archives." 3641msgstr "" 3642 3643#. type: Plain text 3644#: deb-old.man 3645msgid "" 3646"The second line is a decimal string (without leading zeroes) giving the " 3647"length of the first gzipped tarfile." 3648msgstr "" 3649 3650#. type: Plain text 3651#: deb-old.man 3652msgid "Each of these lines is terminated with a single newline character." 3653msgstr "" 3654 3655#. type: Plain text 3656#: deb-old.man 3657msgid "" 3658"The first tarfile contains the control information, as a series of ordinary " 3659"files. The file B<control> must be present, as it contains the core control " 3660"information." 3661msgstr "" 3662 3663#. type: Plain text 3664#: deb-old.man 3665msgid "" 3666"In some very old archives, the files in the control tarfile may optionally " 3667"be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory " 3668"will be in the control tarfile too, and the control tarfile will have only " 3669"files in that directory. Optionally the control tarfile may contain an entry " 3670"for ‘B<.>’, that is, the current directory." 3671msgstr "" 3672 3673#. type: Plain text 3674#: deb-old.man 3675msgid "" 3676"The second gzipped tarfile is the filesystem archive, containing pathnames " 3677"relative to the root directory of the system to be installed on. The " 3678"pathnames do not have leading slashes." 3679msgstr "" 3680 3681#. type: Plain text 3682#: deb-old.man 3683msgid "B<deb>(5), B<dpkg-deb>(1), B<deb-control>(5)." 3684msgstr "" 3685 3686#. type: TH 3687#: deb-origin.man 3688#, no-wrap 3689msgid "deb-origin" 3690msgstr "" 3691 3692#. type: Plain text 3693#: deb-origin.man 3694msgid "deb-origin - Vendor-specific information files" 3695msgstr "" 3696 3697#. type: Plain text 3698#: deb-origin.man 3699msgid "B<%PKGCONFDIR%/origins/>I<filename>" 3700msgstr "" 3701 3702#. type: Plain text 3703#: deb-origin.man 3704msgid "" 3705"The files in B<%PKGCONFDIR%/origins> can provide information about various " 3706"vendors who are providing Debian packages." 3707msgstr "" 3708 3709#. type: Plain text 3710#: deb-origin.man 3711msgid "" 3712"They contain a number of fields, or comments when the line starts with " 3713"‘B<#>’. Each field begins with a tag, such as B<Vendor> or B<Parent>, " 3714"followed by a colon and the body of the field. Fields are delimited only by " 3715"field tags. In other words, field text may be multiple lines in length, but " 3716"the tools will join lines when processing the body of the field." 3717msgstr "" 3718 3719#. type: Plain text 3720#: deb-origin.man 3721msgid "" 3722"The file should be named according to the vendor name. The usual convention " 3723"is to name the vendor file using the vendor name in all lowercase, but some " 3724"variation is permitted. Namely, spaces are mapped to dashes (‘B<->’), and " 3725"the file can have the same casing as the value in B<Vendor> field, or it can " 3726"be capitalized." 3727msgstr "" 3728 3729#. type: TP 3730#: deb-origin.man 3731#, no-wrap 3732msgid "B<Vendor:> I<vendor-name> (required)" 3733msgstr "" 3734 3735#. type: Plain text 3736#: deb-origin.man 3737msgid "The value of this field determines the vendor name." 3738msgstr "" 3739 3740#. type: TP 3741#: deb-origin.man 3742#, no-wrap 3743msgid "B<Vendor-URL:>I< vendor-url>" 3744msgstr "" 3745 3746#. type: Plain text 3747#: deb-origin.man 3748msgid "The value of this field determines the vendor URL." 3749msgstr "" 3750 3751#. type: TP 3752#: deb-origin.man 3753#, no-wrap 3754msgid "B<Bugs:>I< bug-url>" 3755msgstr "" 3756 3757#. type: Plain text 3758#: deb-origin.man 3759msgid "" 3760"The value of this field determines the type and address of the bug tracking " 3761"system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., " 3762"debbugs://bugs.debian.org/)." 3763msgstr "" 3764 3765#. type: TP 3766#: deb-origin.man 3767#, no-wrap 3768msgid "B<Parent:>I< vendor-name>" 3769msgstr "" 3770 3771#. type: Plain text 3772#: deb-origin.man 3773msgid "" 3774"The value of this field determines the vendor name of the vendor that this " 3775"vendor derives from." 3776msgstr "" 3777 3778#. type: Plain text 3779#: deb-origin.man 3780#, no-wrap 3781msgid "" 3782"Vendor: Debian\n" 3783"Vendor-URL: https://www.debian.org/\n" 3784"Bugs: debbugs://bugs.debian.org\n" 3785msgstr "" 3786 3787#. type: Plain text 3788#: deb-origin.man 3789msgid "B<dpkg-vendor>(1)" 3790msgstr "" 3791 3792#. type: TH 3793#: deb-override.man 3794#, no-wrap 3795msgid "deb-override" 3796msgstr "" 3797 3798#. type: Plain text 3799#: deb-override.man 3800msgid "deb-override - Debian archive override file" 3801msgstr "" 3802 3803#. type: Plain text 3804#: deb-override.man deb-extra-override.man 3805msgid "override" 3806msgstr "" 3807 3808#. type: Plain text 3809#: deb-override.man 3810msgid "" 3811"While most information about a package can be found in the control file, " 3812"some is managed centrally by the distribution czars rather than by the " 3813"maintainer in order to offer some global consistency. This information is " 3814"found in the override file." 3815msgstr "" 3816 3817#. type: Plain text 3818#: deb-override.man 3819msgid "" 3820"The override file has a simple whitespace-delimited format. Comments are " 3821"allowed (denoted with a B<#>)." 3822msgstr "" 3823 3824#. type: Plain text 3825#: deb-override.man 3826msgid "I<package> I<priority> I<section> [I<maintainerinfo>]" 3827msgstr "" 3828 3829#. type: Plain text 3830#: deb-override.man 3831msgid "" 3832"I<package> is the name of the package. Entries in the override file for " 3833"packages not found in the tree of binary packages are ignored." 3834msgstr "" 3835 3836#. type: Plain text 3837#: deb-override.man 3838msgid "" 3839"I<priority> and I<section> correspond to the respective control fields " 3840"available in the .deb. The allowed values are specific to each distribution " 3841"archive." 3842msgstr "" 3843 3844#. type: Plain text 3845#: deb-override.man 3846msgid "" 3847"I<maintainerinfo>, if present, can be either the name of a maintainer for an " 3848"unconditional override, or else I<oldmaintainer> B<=E<gt>> I<newmaintainer> " 3849"to perform a substitution." 3850msgstr "" 3851 3852#. type: Plain text 3853#: deb-override.man 3854msgid "" 3855"The override files used to make the official Packages lists may be found in " 3856"the I<indices> directory on any Debian mirror." 3857msgstr "" 3858 3859#. type: Plain text 3860#: deb-override.man deb-extra-override.man 3861msgid "B<dpkg-scanpackages>(1), B<dpkg-scansources>(1), B<apt-ftparchive>(1)." 3862msgstr "" 3863 3864#. type: TH 3865#: deb-extra-override.man 3866#, no-wrap 3867msgid "deb-extra-override" 3868msgstr "" 3869 3870#. type: Plain text 3871#: deb-extra-override.man 3872msgid "deb-extra-override - Debian archive extra override file" 3873msgstr "" 3874 3875#. type: Plain text 3876#: deb-extra-override.man 3877msgid "" 3878"While most information about a binary/source package can be found in the " 3879"control/.dsc file, all of it can be overridden when it's exported to " 3880"Packages/Sources files. The extra override file contains those overrides." 3881msgstr "" 3882 3883#. type: Plain text 3884#: deb-extra-override.man 3885msgid "" 3886"The extra override file has a simple whitespace-delimited format. Comments " 3887"are allowed (denoted with a B<#>)." 3888msgstr "" 3889 3890#. type: Plain text 3891#: deb-extra-override.man 3892msgid "I<package> I<field-name> I<value>" 3893msgstr "" 3894 3895#. type: Plain text 3896#: deb-extra-override.man 3897msgid "I<package> is the name of the binary/source package." 3898msgstr "" 3899 3900#. type: Plain text 3901#: deb-extra-override.man 3902msgid "" 3903"I<field-name> is the name of the field that is overridden. I<value> is the " 3904"value to put in the field. It can contain spaces as the line is split in no " 3905"more than 3 columns when it's parsed." 3906msgstr "" 3907 3908#. type: Plain text 3909#: deb-extra-override.man 3910msgid "" 3911"The extra override files used to make the official Packages lists may be " 3912"found in the I<indices> directory on any Debian mirror." 3913msgstr "" 3914 3915#. type: TH 3916#: deb-shlibs.man 3917#, no-wrap 3918msgid "deb-shlibs" 3919msgstr "" 3920 3921#. type: Plain text 3922#: deb-shlibs.man 3923msgid "deb-shlibs - Debian shared library information file" 3924msgstr "" 3925 3926#. type: Plain text 3927#: deb-shlibs.man 3928msgid "" 3929"B<shlibs> files map shared library names and versions (I<sonames>) to " 3930"dependencies suitable for a package control file. There is one entry per " 3931"line. Blank lines are B<not> allowed. Lines beginning with an B<#> " 3932"character are considered commentary, and are ignored. All other lines must " 3933"have the format" 3934msgstr "" 3935 3936#. type: Plain text 3937#: deb-shlibs.man 3938msgid "[I<type>B<:>] I<library> I<version> I<dependencies>" 3939msgstr "" 3940 3941#. type: Plain text 3942#: deb-shlibs.man 3943msgid "" 3944"The I<library> and I<version> fields are whitespace-delimited, but the " 3945"I<dependencies> field extends to the end of the line. The I<type> field is " 3946"optional and normally not needed." 3947msgstr "" 3948 3949#. type: Plain text 3950#: deb-shlibs.man 3951msgid "" 3952"The I<dependencies> field has the same syntax as the B<Depends> field in a " 3953"binary control file, see B<deb-control>(5)." 3954msgstr "" 3955 3956#. type: Plain text 3957#: deb-shlibs.man 3958msgid "" 3959"The B<shlibs> file for a typical library package, named I<libcrunch1>, that " 3960"provides one library whose soname is I<libcrunch.so.1>, might read" 3961msgstr "" 3962 3963#. type: Plain text 3964#: deb-shlibs.man 3965msgid "libcrunch 1 libcrunch1 (E<gt>= 1.2-1)" 3966msgstr "" 3967 3968#. type: Plain text 3969#: deb-shlibs.man 3970msgid "" 3971"The I<dependencies> must mention the most recent version of the package that " 3972"added new symbols to the library: in the above example, new symbols were " 3973"added to version 1.2 of I<libcrunch>. This is not the only reason the " 3974"dependencies might need to be tightened." 3975msgstr "" 3976 3977#. type: Plain text 3978#: deb-shlibs.man 3979msgid "B<deb-control>(5), B<dpkg-shlibdeps>(1), B<deb-symbols>(5)." 3980msgstr "" 3981 3982#. type: TH 3983#: deb-substvars.man 3984#, no-wrap 3985msgid "deb-substvars" 3986msgstr "" 3987 3988#. type: Plain text 3989#: deb-substvars.man 3990msgid "deb-substvars - Debian source substitution variables" 3991msgstr "" 3992 3993#. type: Plain text 3994#: deb-substvars.man 3995msgid "substvars" 3996msgstr "" 3997 3998#. type: Plain text 3999#: deb-substvars.man 4000msgid "" 4001"Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their " 4002"control information (to the source control file B<.dsc> for B<dpkg-source> " 4003"and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>) they " 4004"perform some variable substitutions on the output file." 4005msgstr "" 4006 4007#. type: Plain text 4008#: deb-substvars.man 4009msgid "" 4010"A variable substitution has the form B<${>I<variable-name>B<}>. Variable " 4011"names consist of alphanumerics (a-zA-Z0-9), hyphens (-) and colons (:) and " 4012"start with an alphanumeric, and are case-sensitive, even though they might " 4013"refer to other entities which are case-preserving. Variable substitutions " 4014"are performed repeatedly until none are left; the full text of the field " 4015"after the substitution is rescanned to look for more substitutions." 4016msgstr "" 4017 4018#. type: Plain text 4019#: deb-substvars.man 4020msgid "" 4021"After all the substitutions have been done each occurrence of the string B<" 4022"${}> (which is not a legal substitution) is replaced with a B<$> sign." 4023msgstr "" 4024 4025#. type: Plain text 4026#: deb-substvars.man 4027msgid "" 4028"While variable substitution is done on all control fields, some of those " 4029"fields are used and needed during the build when the substitution did not " 4030"yet occur. That's why you can't use variables in the B<Package>, B<Source> " 4031"and B<Architecture> fields." 4032msgstr "" 4033 4034#. type: Plain text 4035#: deb-substvars.man 4036msgid "" 4037"Variable substitution happens on the content of the fields after they have " 4038"been parsed, thus if you want a variable to expand over multiple lines you " 4039"do not have to include a space after the newline. This is done implicitly " 4040"when the field is output. For example, if the variable B<${Description}> is " 4041"set to \"foo is bar.${Newline}foo is great.\" and if you have the following " 4042"field:" 4043msgstr "" 4044 4045#. type: Plain text 4046#: deb-substvars.man 4047#, no-wrap 4048msgid "" 4049" Description: foo application\n" 4050" ${Description}\n" 4051" .\n" 4052" More text.\n" 4053msgstr "" 4054 4055#. type: Plain text 4056#: deb-substvars.man 4057msgid "It will result in:" 4058msgstr "" 4059 4060#. type: Plain text 4061#: deb-substvars.man 4062#, no-wrap 4063msgid "" 4064" Description: foo application\n" 4065" foo is bar.\n" 4066" foo is great.\n" 4067" .\n" 4068" More text.\n" 4069msgstr "" 4070 4071#. type: Plain text 4072#: deb-substvars.man 4073msgid "" 4074"Variables can be set using the B<-V> common option. They can be also " 4075"specified in the file B<debian/substvars> (or whatever other file is " 4076"specified using the B<-T> option). This file consists of lines of the form " 4077"I<name>B<=>I<value>. Trailing whitespace on each line, blank lines, and " 4078"lines starting with a B<#> symbol (comments) are ignored." 4079msgstr "" 4080 4081#. type: Plain text 4082#: deb-substvars.man 4083msgid "Additionally, the following standard variables are available:" 4084msgstr "" 4085 4086#. type: TP 4087#: deb-substvars.man 4088#, no-wrap 4089msgid "B<Arch>" 4090msgstr "" 4091 4092#. type: Plain text 4093#: deb-substvars.man 4094msgid "" 4095"The current host architecture (i.e. the architecture the package is being " 4096"built for, the equivalent of B<DEB_HOST_ARCH>)." 4097msgstr "" 4098 4099#. type: TP 4100#: deb-substvars.man dpkg-query.man 4101#, no-wrap 4102msgid "B<source:Version>" 4103msgstr "" 4104 4105#. type: Plain text 4106#: deb-substvars.man 4107#, fuzzy 4108#| msgid "B<bad-version>: Process even packages with wrong versions." 4109msgid "The source package version (since dpkg 1.13.19)." 4110msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 4111 4112#. type: TP 4113#: deb-substvars.man dpkg-query.man 4114#, no-wrap 4115msgid "B<source:Upstream-Version>" 4116msgstr "" 4117 4118#. type: Plain text 4119#: deb-substvars.man 4120msgid "" 4121"The upstream source package version, including the Debian version epoch if " 4122"any (since dpkg 1.13.19)." 4123msgstr "" 4124 4125#. type: TP 4126#: deb-substvars.man 4127#, no-wrap 4128msgid "B<binary:Version>" 4129msgstr "" 4130 4131#. type: Plain text 4132#: deb-substvars.man 4133msgid "" 4134"The binary package version (which may differ from B<source:Version> in a " 4135"binNMU for example; since dpkg 1.13.19)." 4136msgstr "" 4137 4138#. type: TP 4139#: deb-substvars.man 4140#, no-wrap 4141msgid "B<Source-Version>" 4142msgstr "" 4143 4144#. type: Plain text 4145#: deb-substvars.man 4146msgid "" 4147"The source package version (from the changelog file). This variable is now " 4148"B<obsolete> and emits an error when used as its meaning is different from " 4149"its function, please use the B<source:Version> or B<binary:Version> as " 4150"appropriate." 4151msgstr "" 4152 4153#. type: TP 4154#: deb-substvars.man 4155#, fuzzy, no-wrap 4156#| msgid "dpkg-source" 4157msgid "B<source:Synopsis>" 4158msgstr "dpkg-source" 4159 4160#. type: Plain text 4161#: deb-substvars.man 4162msgid "" 4163"The source package synopsis, extracted from the source stanza B<Description> " 4164"field, if it exists (since dpkg 1.19.0)." 4165msgstr "" 4166 4167#. type: TP 4168#: deb-substvars.man 4169#, no-wrap 4170msgid "B<source:Extended-Description>" 4171msgstr "" 4172 4173#. type: Plain text 4174#: deb-substvars.man 4175msgid "" 4176"The source package extended description, extracted from the source stanza " 4177"B<Description> field, if it exists (since dpkg 1.19.0)." 4178msgstr "" 4179 4180#. type: TP 4181#: deb-substvars.man 4182#, no-wrap 4183msgid "B<Installed-Size>" 4184msgstr "" 4185 4186#. type: Plain text 4187#: deb-substvars.man 4188msgid "" 4189"The approximate total size of the package's installed files. This value is " 4190"copied into the corresponding control file field; setting it will modify the " 4191"value of that field. If this variable is not set B<dpkg-gencontrol> will " 4192"compute the default value by accumulating the size of each regular file and " 4193"symlink rounded to 1 KiB used units, and a baseline of 1 KiB for any other " 4194"filesystem object type." 4195msgstr "" 4196 4197#. type: Plain text 4198#: deb-substvars.man 4199msgid "" 4200"B<Note:> Take into account that this can only ever be an approximation, as " 4201"the actual size used on the installed system will depend greatly on the " 4202"filesystem used and its parameters, which might end up using either more or " 4203"less space than the specified in this field." 4204msgstr "" 4205 4206#. type: TP 4207#: deb-substvars.man 4208#, no-wrap 4209msgid "B<Extra-Size>" 4210msgstr "" 4211 4212#. type: Plain text 4213#: deb-substvars.man 4214msgid "" 4215"Additional disk space used when the package is installed. If this variable " 4216"is set its value is added to that of the B<Installed-Size> variable (whether " 4217"set explicitly or using the default value) before it is copied into the " 4218"B<Installed-Size> control file field." 4219msgstr "" 4220 4221#. type: TP 4222#: deb-substvars.man 4223#, no-wrap 4224msgid "B<S:>I<fieldname>" 4225msgstr "" 4226 4227#. type: Plain text 4228#: deb-substvars.man 4229msgid "" 4230"The value of the source stanza field I<fieldname> (which must be given in " 4231"the canonical capitalisation; since dpkg 1.18.11). Setting these variables " 4232"has no effect other than on places where they are expanded explicitly. " 4233"These variables are only available when generating binary control files." 4234msgstr "" 4235 4236#. type: TP 4237#: deb-substvars.man 4238#, no-wrap 4239msgid "B<F:>I<fieldname>" 4240msgstr "" 4241 4242#. type: Plain text 4243#: deb-substvars.man 4244msgid "" 4245"The value of the output field I<fieldname> (which must be given in the " 4246"canonical capitalisation). Setting these variables has no effect other than " 4247"on places where they are expanded explicitly." 4248msgstr "" 4249 4250#. type: TP 4251#: deb-substvars.man 4252#, no-wrap 4253msgid "B<Format>" 4254msgstr "" 4255 4256#. type: Plain text 4257#: deb-substvars.man 4258msgid "" 4259"The B<.changes> file format version generated by this version of the source " 4260"packaging scripts. If you set this variable the contents of the B<Format> " 4261"field in the B<.changes> file will change too." 4262msgstr "" 4263 4264#. type: TP 4265#: deb-substvars.man 4266#, no-wrap 4267msgid "B<Newline>, B<Space>, B<Tab>" 4268msgstr "" 4269 4270#. type: Plain text 4271#: deb-substvars.man 4272msgid "These variables each hold the corresponding character." 4273msgstr "" 4274 4275#. type: TP 4276#: deb-substvars.man 4277#, no-wrap 4278msgid "B<shlibs:>I<dependencyfield>" 4279msgstr "" 4280 4281#. type: Plain text 4282#: deb-substvars.man 4283msgid "" 4284"Variable settings with names of this form are generated by B<dpkg-shlibdeps>." 4285msgstr "" 4286 4287#. type: TP 4288#: deb-substvars.man 4289#, no-wrap 4290msgid "B<dpkg:Upstream-Version>" 4291msgstr "" 4292 4293#. type: Plain text 4294#: deb-substvars.man 4295msgid "The upstream version of dpkg (since dpkg 1.13.19)." 4296msgstr "" 4297 4298#. type: TP 4299#: deb-substvars.man 4300#, no-wrap 4301msgid "B<dpkg:Version>" 4302msgstr "" 4303 4304#. type: Plain text 4305#: deb-substvars.man 4306msgid "The full version of dpkg (since dpkg 1.13.19)." 4307msgstr "" 4308 4309#. type: Plain text 4310#: deb-substvars.man 4311msgid "" 4312"If a variable is referred to but not defined it generates a warning and an " 4313"empty value is assumed." 4314msgstr "" 4315 4316#. type: TP 4317#: deb-substvars.man 4318#, no-wrap 4319msgid "B<debian/substvars>" 4320msgstr "" 4321 4322#. type: Plain text 4323#: deb-substvars.man 4324msgid "List of substitution variables and values." 4325msgstr "" 4326 4327#. type: Plain text 4328#: deb-substvars.man 4329msgid "" 4330"B<dpkg>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), B<dpkg-" 4331"shlibdeps>(1), B<dpkg-source>(1)." 4332msgstr "" 4333 4334#. type: TH 4335#: deb-symbols.man 4336#, no-wrap 4337msgid "deb-symbols" 4338msgstr "" 4339 4340#. type: Plain text 4341#: deb-symbols.man 4342msgid "deb-symbols - Debian's extended shared library information file" 4343msgstr "" 4344 4345#. type: Plain text 4346#: deb-symbols.man 4347msgid "symbols" 4348msgstr "" 4349 4350#. type: Plain text 4351#: deb-symbols.man 4352msgid "" 4353"The symbol files are shipped in Debian binary packages, and its format is a " 4354"subset of the template symbol files used by B<dpkg-gensymbols>(1) in Debian " 4355"source packages." 4356msgstr "" 4357 4358#. type: Plain text 4359#: deb-symbols.man 4360msgid "" 4361"The format for an extended shared library dependency information entry in " 4362"these files is:" 4363msgstr "" 4364 4365#. type: Plain text 4366#: deb-symbols.man 4367msgid "I<library-soname main-dependency-template>" 4368msgstr "" 4369 4370#. type: Plain text 4371#: deb-symbols.man 4372msgid "[| I<alternative-dependency-template>]" 4373msgstr "" 4374 4375#. type: Plain text 4376#: deb-symbols.man 4377msgid "[...]" 4378msgstr "" 4379 4380#. type: Plain text 4381#: deb-symbols.man 4382msgid "[* I<field-name>: I<field-value>]" 4383msgstr "" 4384 4385#. type: Plain text 4386#: deb-symbols.man 4387#, no-wrap 4388msgid "" 4389"[...]\n" 4390" I<symbol> I<minimal-version> [I<id-of-dependency-template>]\n" 4391msgstr "" 4392 4393#. type: Plain text 4394#: deb-symbols.man 4395msgid "" 4396"The I<library-soname> is exactly the value of the SONAME field as exported " 4397"by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> " 4398"is dynamically replaced either by a version check like “(E<gt>= I<minimal-" 4399"version>)” or by nothing (if an unversioned dependency is deemed sufficient)." 4400msgstr "" 4401 4402#. type: Plain text 4403#: deb-symbols.man 4404msgid "" 4405"Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being " 4406"“Base” if the library is not versioned) is associated to a I<minimal-" 4407"version> of its dependency template (the main dependency template is always " 4408"used and will end up being combined with the dependency template referenced " 4409"by I<id-of-dependency-template> if present). The first alternative " 4410"dependency template is numbered 1, the second one 2, etc." 4411msgstr "" 4412 4413#. type: Plain text 4414#: deb-symbols.man 4415msgid "" 4416"Each entry for a library can also have some fields of meta-information. " 4417"Those fields are stored on lines starting with an asterisk. Currently, the " 4418"only valid fields are:" 4419msgstr "" 4420 4421#. type: TP 4422#: deb-symbols.man 4423#, no-wrap 4424msgid "B<Build-Depends-Package>" 4425msgstr "" 4426 4427#. type: Plain text 4428#: deb-symbols.man 4429msgid "" 4430"It indicates the name of the “-dev” package associated to the library and is " 4431"used by B<dpkg-shlibdeps> to make sure that the dependency generated is at " 4432"least as strict as the corresponding build dependency (since dpkg 1.14.13)." 4433msgstr "" 4434 4435#. type: TP 4436#: deb-symbols.man 4437#, no-wrap 4438msgid "B<Ignore-Blacklist-Groups>" 4439msgstr "" 4440 4441#. type: Plain text 4442#: deb-symbols.man 4443msgid "" 4444"It indicates what blacklist groups should be ignored, as a whitespace " 4445"separated list, so that the symbols contained in those groups get included " 4446"in the output file (since dpkg 1.17.6). This should only be necessary for " 4447"toolchain packages providing those blacklisted symbols. The available groups " 4448"are system dependent, for ELF and GNU-based systems these are B<aeabi> and " 4449"B<gomp>." 4450msgstr "" 4451 4452#. type: SS 4453#: deb-symbols.man 4454#, no-wrap 4455msgid "Simple symbols file" 4456msgstr "" 4457 4458#. type: Plain text 4459#: deb-symbols.man 4460#, no-wrap 4461msgid "" 4462"libftp.so.3 libftp3 #MINVER#\n" 4463" DefaultNetbuf@Base 3.1-1-6\n" 4464" FtpAccess@Base 3.1-1-6\n" 4465" [...]\n" 4466msgstr "" 4467 4468#. type: SS 4469#: deb-symbols.man 4470#, no-wrap 4471msgid "Advanced symbols file" 4472msgstr "" 4473 4474#. type: Plain text 4475#: deb-symbols.man 4476msgid "libGL.so.1 libgl1" 4477msgstr "" 4478 4479#. type: Plain text 4480#: deb-symbols.man 4481msgid "| libgl1-mesa-glx #MINVER#" 4482msgstr "" 4483 4484#. type: Plain text 4485#: deb-symbols.man 4486#, no-wrap 4487msgid "" 4488"* Build-Depends-Package: libgl1-mesa-dev\n" 4489" publicGlSymbol@Base 6.3-1\n" 4490" [...]\n" 4491" implementationSpecificSymbol@Base 6.5.2-7 1\n" 4492" [...]\n" 4493msgstr "" 4494 4495#. type: Plain text 4496#: deb-symbols.man 4497msgid "B<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>" 4498msgstr "" 4499 4500#. type: Plain text 4501#: deb-symbols.man 4502msgid "B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1)." 4503msgstr "" 4504 4505#. type: TH 4506#: deb-postinst.man 4507#, fuzzy, no-wrap 4508#| msgid "deb-control" 4509msgid "deb-postinst" 4510msgstr "deb-control" 4511 4512#. type: Plain text 4513#: deb-postinst.man 4514msgid "deb-postinst - package post-installation maintainer script" 4515msgstr "" 4516 4517#. type: Plain text 4518#: deb-postinst.man 4519msgid "postinst" 4520msgstr "" 4521 4522#. type: Plain text 4523#: deb-postinst.man 4524msgid "" 4525"A package can perform several post-installation actions via maintainer " 4526"scripts, by including an executable I<postinst> file in its control archive " 4527"(i.e. I<DEBIAN/postinst> during package creation)." 4528msgstr "" 4529 4530#. type: Plain text 4531#: deb-postinst.man deb-postrm.man deb-preinst.man deb-prerm.man 4532msgid "The script can be called in the following ways:" 4533msgstr "" 4534 4535#. type: TP 4536#: deb-postinst.man 4537#, no-wrap 4538msgid "I<postinst> B<configure> I<old-version>" 4539msgstr "" 4540 4541#. type: Plain text 4542#: deb-postinst.man 4543#, fuzzy 4544#| msgid "The package is not installed on your system." 4545msgid "After the package was installed." 4546msgstr "该软件包没有安装在您的系统中。" 4547 4548#. type: TP 4549#: deb-postinst.man 4550#, no-wrap 4551msgid "I<postinst> B<triggered> I<trigger-name...>" 4552msgstr "" 4553 4554#. type: Plain text 4555#: deb-postinst.man 4556#, fuzzy 4557#| msgid "The package has been triggered." 4558msgid "After the package was triggered." 4559msgstr "该软件包已被触发。" 4560 4561#. type: TP 4562#: deb-postinst.man 4563#, no-wrap 4564msgid "I<old-postinst> B<abort-upgrade> I<new-version>" 4565msgstr "" 4566 4567#. type: Plain text 4568#: deb-postinst.man 4569msgid "If I<prerm> fails during upgrade or fails on failed upgrade." 4570msgstr "" 4571 4572#. type: TP 4573#: deb-postinst.man 4574#, no-wrap 4575msgid "I<old-postinst> B<abort-remove>" 4576msgstr "" 4577 4578#. type: Plain text 4579#: deb-postinst.man 4580msgid "If I<prerm> fails during removal." 4581msgstr "" 4582 4583#. type: TP 4584#: deb-postinst.man 4585#, no-wrap 4586msgid "I<postinst> B<abort-deconfigure in-favour> I<new-package new-version>" 4587msgstr "" 4588 4589#. type: TQ 4590#: deb-postinst.man 4591#, no-wrap 4592msgid " [ B<removing> I<old-package old-version> ]" 4593msgstr "" 4594 4595#. type: Plain text 4596#: deb-postinst.man 4597msgid "If I<prerm> fails during deconfiguration of a package." 4598msgstr "" 4599 4600#. type: TP 4601#: deb-postinst.man 4602#, no-wrap 4603msgid "I<postinst> B<abort-remove in-favour> I<new-package new-version>" 4604msgstr "" 4605 4606#. type: Plain text 4607#: deb-postinst.man 4608msgid "If I<prerm> fails during replacement due to conflict." 4609msgstr "" 4610 4611#. type: Plain text 4612#: deb-postinst.man deb-postrm.man deb-preinst.man deb-prerm.man dpkg.cfg.man 4613#: dpkg-divert.man dpkg-query.man dpkg-statoverride.man 4614msgid "B<dpkg>(1)." 4615msgstr "" 4616 4617#. type: TH 4618#: deb-postrm.man 4619#, fuzzy, no-wrap 4620#| msgid "deb-control" 4621msgid "deb-postrm" 4622msgstr "deb-control" 4623 4624#. type: Plain text 4625#: deb-postrm.man 4626msgid "deb-postrm - package post-removal maintainer script" 4627msgstr "" 4628 4629#. type: Plain text 4630#: deb-postrm.man 4631msgid "postrm" 4632msgstr "" 4633 4634#. type: Plain text 4635#: deb-postrm.man 4636msgid "" 4637"A package can perform several post-removal actions via maintainer scripts, " 4638"by including an executable I<postrm> file in its control archive (i.e. " 4639"I<DEBIAN/postrm> during package creation)." 4640msgstr "" 4641 4642#. type: TP 4643#: deb-postrm.man 4644#, no-wrap 4645msgid "I<postrm> B<remove>" 4646msgstr "" 4647 4648#. type: Plain text 4649#: deb-postrm.man 4650#, fuzzy 4651#| msgid "The package has been triggered." 4652msgid "After the package was removed." 4653msgstr "该软件包已被触发。" 4654 4655#. type: TP 4656#: deb-postrm.man 4657#, fuzzy, no-wrap 4658#| msgid "B<purge>" 4659msgid "I<postrm> B<purge>" 4660msgstr "B<purge>" 4661 4662#. type: Plain text 4663#: deb-postrm.man 4664#, fuzzy 4665#| msgid "The package has been triggered." 4666msgid "After the package was purged." 4667msgstr "该软件包已被触发。" 4668 4669#. type: TP 4670#: deb-postrm.man 4671#, no-wrap 4672msgid "I<old-postrm> B<upgrade> I<new-version>" 4673msgstr "" 4674 4675#. type: Plain text 4676#: deb-postrm.man 4677#, fuzzy 4678#| msgid "The package has been triggered." 4679msgid "After the package was upgraded." 4680msgstr "该软件包已被触发。" 4681 4682#. type: TP 4683#: deb-postrm.man 4684#, no-wrap 4685msgid "I<new-postrm >B<failed-upgrade>I< old-version new-version>" 4686msgstr "" 4687 4688#. type: Plain text 4689#: deb-postrm.man 4690msgid "If the above B<upgrade> call fails." 4691msgstr "" 4692 4693#. type: TP 4694#: deb-postrm.man 4695#, no-wrap 4696msgid "I<postrm> B<disappear> I<overwriter-package> I<overwriter-version>" 4697msgstr "" 4698 4699#. type: Plain text 4700#: deb-postrm.man 4701msgid "After all of the packages files have been replaced." 4702msgstr "" 4703 4704#. type: TP 4705#: deb-postrm.man 4706#, no-wrap 4707msgid "I<new-postrm> B<abort-install>" 4708msgstr "" 4709 4710#. type: Plain text 4711#: deb-postrm.man 4712msgid "If I<preinst> fails during install." 4713msgstr "" 4714 4715#. type: TP 4716#: deb-postrm.man 4717#, no-wrap 4718msgid "I<new-postrm> B<abort-install> I<old-version new-version>" 4719msgstr "" 4720 4721#. type: Plain text 4722#: deb-postrm.man 4723#, fuzzy 4724#| msgid "B<3.> Run I<preinst> script, if provided by the package." 4725msgid "If I<preinst> fails during upgrade of removed package." 4726msgstr "B<3.> 运行 I<preinst> 脚本，如果软件包有提供的话。" 4727 4728#. type: TP 4729#: deb-postrm.man 4730#, no-wrap 4731msgid "I<new-postrm> B<abort-upgrade> I<old-version new-version>" 4732msgstr "" 4733 4734#. type: Plain text 4735#: deb-postrm.man 4736msgid "If I<preinst> fails during upgrade." 4737msgstr "" 4738 4739#. type: TH 4740#: deb-preinst.man 4741#, no-wrap 4742msgid "deb-preinst" 4743msgstr "" 4744 4745#. type: Plain text 4746#: deb-preinst.man 4747msgid "deb-preinst - package pre-installation maintainer script" 4748msgstr "" 4749 4750#. type: Plain text 4751#: deb-preinst.man 4752#, fuzzy 4753#| msgid "B<reinst-required>" 4754msgid "preinst" 4755msgstr "B<reinst-required>" 4756 4757#. type: Plain text 4758#: deb-preinst.man 4759msgid "" 4760"A package can perform several pre-installation actions via maintainer " 4761"scripts, by including an executable I<preinst> file in its control archive " 4762"(i.e. I<DEBIAN/preinst> during package creation)." 4763msgstr "" 4764 4765#. type: TP 4766#: deb-preinst.man 4767#, no-wrap 4768msgid "I<new-preinst> B<install>" 4769msgstr "" 4770 4771#. type: Plain text 4772#: deb-preinst.man 4773#, fuzzy 4774#| msgid "The package is not installed on your system." 4775msgid "Before the package is installed." 4776msgstr "该软件包没有安装在您的系统中。" 4777 4778#. type: TP 4779#: deb-preinst.man 4780#, no-wrap 4781msgid "I<new-preinst> B<install> I<old-version new-version>" 4782msgstr "" 4783 4784#. type: Plain text 4785#: deb-preinst.man 4786msgid "Before removed package is upgraded." 4787msgstr "" 4788 4789#. type: TP 4790#: deb-preinst.man 4791#, no-wrap 4792msgid "I<new-preinst> B<upgrade> I<old-version new-version>" 4793msgstr "" 4794 4795#. type: Plain text 4796#: deb-preinst.man 4797msgid "Before the package is upgraded." 4798msgstr "" 4799 4800#. type: TP 4801#: deb-preinst.man 4802#, no-wrap 4803msgid "I<old-preinst> B<abort-upgrade> I<new-version>" 4804msgstr "" 4805 4806#. type: Plain text 4807#: deb-preinst.man 4808msgid "If I<postrm> fails during upgrade or fails on failed upgrade." 4809msgstr "" 4810 4811#. type: TH 4812#: deb-prerm.man 4813#, no-wrap 4814msgid "deb-prerm" 4815msgstr "" 4816 4817#. type: Plain text 4818#: deb-prerm.man 4819msgid "deb-prerm - package pre-removal maintainer script" 4820msgstr "" 4821 4822#. type: Plain text 4823#: deb-prerm.man 4824msgid "prerm" 4825msgstr "" 4826 4827#. type: Plain text 4828#: deb-prerm.man 4829msgid "" 4830"A package can perform several pre-removal actions via maintainer scripts, by " 4831"including an executable I<prerm> file in its control archive (i.e. I<DEBIAN/" 4832"prerm> during package creation)." 4833msgstr "" 4834 4835#. type: TP 4836#: deb-prerm.man 4837#, no-wrap 4838msgid "I<prerm> B<remove>" 4839msgstr "" 4840 4841#. type: Plain text 4842#: deb-prerm.man 4843msgid "Before the package is removed." 4844msgstr "" 4845 4846#. type: TP 4847#: deb-prerm.man 4848#, no-wrap 4849msgid "I<old-prerm> B<upgrade> I<new-version>" 4850msgstr "" 4851 4852#. type: Plain text 4853#: deb-prerm.man 4854msgid "Before an upgrade." 4855msgstr "" 4856 4857#. type: TP 4858#: deb-prerm.man 4859#, no-wrap 4860msgid "I<new-prerm> B<failed-upgrade> I<old-version new-version>" 4861msgstr "" 4862 4863#. type: Plain text 4864#: deb-prerm.man 4865msgid "If the above B<upgrade> fails." 4866msgstr "" 4867 4868#. type: TP 4869#: deb-prerm.man 4870#, no-wrap 4871msgid "I<prerm> B<deconfigure in-favour> I<new-package new-version>" 4872msgstr "" 4873 4874#. type: TQ 4875#: deb-prerm.man 4876#, no-wrap 4877msgid " [ B<removing> I<old-package old-version> ]" 4878msgstr "" 4879 4880#. type: Plain text 4881#: deb-prerm.man 4882msgid "" 4883"Before package is deconfigured while dependency is replaced due to conflict." 4884msgstr "" 4885 4886#. type: TP 4887#: deb-prerm.man 4888#, no-wrap 4889msgid "I<prerm> B<remove in-favour> I<new-package new-version>" 4890msgstr "" 4891 4892#. type: Plain text 4893#: deb-prerm.man 4894#, fuzzy 4895#| msgid "The package is unpacked, but not configured." 4896msgid "Before the package is replaced due to conflict." 4897msgstr "该软件已经解压，但还没有进行配置。" 4898 4899#. type: TH 4900#: deb-triggers.man 4901#, no-wrap 4902msgid "deb-triggers" 4903msgstr "" 4904 4905#. type: Plain text 4906#: deb-triggers.man 4907msgid "deb-triggers - package triggers" 4908msgstr "" 4909 4910#. type: Plain text 4911#: deb-triggers.man 4912msgid "triggers" 4913msgstr "" 4914 4915#. type: Plain text 4916#: deb-triggers.man 4917msgid "" 4918"A package declares its relationship to some trigger(s) by including a " 4919"I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during " 4920"package creation)." 4921msgstr "" 4922 4923#. type: Plain text 4924#: deb-triggers.man 4925msgid "" 4926"This file contains directives, one per line. Leading and trailing whitespace " 4927"and everything after the first B<#> on any line will be trimmed, and empty " 4928"lines will be ignored." 4929msgstr "" 4930 4931#. type: Plain text 4932#: deb-triggers.man 4933msgid "The trigger control directives currently supported are:" 4934msgstr "" 4935 4936#. type: TP 4937#: deb-triggers.man 4938#, no-wrap 4939msgid "B<interest> I<trigger-name>" 4940msgstr "" 4941 4942#. type: TQ 4943#: deb-triggers.man 4944#, no-wrap 4945msgid "B<interest-await> I<trigger-name>" 4946msgstr "" 4947 4948#. type: TQ 4949#: deb-triggers.man 4950#, no-wrap 4951msgid "B<interest-noawait> I<trigger-name>" 4952msgstr "" 4953 4954#. type: Plain text 4955#: deb-triggers.man 4956msgid "" 4957"Specifies that the package is interested in the named trigger. All triggers " 4958"in which a package is interested must be listed using this directive in the " 4959"triggers control file." 4960msgstr "" 4961 4962#. type: Plain text 4963#: deb-triggers.man 4964msgid "" 4965"The “await” variants put the triggering package in triggers-awaited state " 4966"depending on how the trigger was activated. The “noawait” variant does not " 4967"put the triggering packages in triggers-awaited state, even if the " 4968"triggering package declared an “await” activation (either with an B<activate-" 4969"await> or B<activate> directive, or by using the B<dpkg-trigger> B<--no-" 4970"await> command-line option). The “noawait” variant should be used when the " 4971"functionality provided by the trigger is not crucial." 4972msgstr "" 4973 4974#. type: TP 4975#: deb-triggers.man 4976#, no-wrap 4977msgid "B<activate> I<trigger-name>" 4978msgstr "" 4979 4980#. type: TQ 4981#: deb-triggers.man 4982#, no-wrap 4983msgid "B<activate-await> I<trigger-name>" 4984msgstr "" 4985 4986#. type: TQ 4987#: deb-triggers.man 4988#, no-wrap 4989msgid "B<activate-noawait> I<trigger-name>" 4990msgstr "" 4991 4992#. type: Plain text 4993#: deb-triggers.man 4994msgid "" 4995"Arranges that changes to this package's state will activate the specified " 4996"trigger. The trigger will be activated at the start of the following " 4997"operations: unpack, configure, remove (including for the benefit of a " 4998"conflicting package), purge and deconfigure." 4999msgstr "" 5000 5001#. type: Plain text 5002#: deb-triggers.man 5003msgid "" 5004"The “await” variants only put the triggering package in triggers-awaited " 5005"state if the interest directive is also “await”. The “noawait” variant " 5006"never puts the triggering packages in triggers-awaited state. The “noawait” " 5007"variant should be used when the functionality provided by the trigger is not " 5008"crucial." 5009msgstr "" 5010 5011#. type: Plain text 5012#: deb-triggers.man 5013msgid "" 5014"If this package disappears during the unpacking of another package the " 5015"trigger will be activated when the disappearance is noted towards the end of " 5016"the unpack. Trigger processing, and transition from triggers-awaited to " 5017"installed, does not cause activations. In the case of unpack, triggers " 5018"mentioned in both the old and new versions of the package will be activated." 5019msgstr "" 5020 5021#. type: Plain text 5022#: deb-triggers.man 5023msgid "" 5024"Unknown directives are an error which will prevent installation of the " 5025"package." 5026msgstr "" 5027 5028#. type: Plain text 5029#: deb-triggers.man 5030msgid "" 5031"The “-noawait” variants should always be favored when possible since " 5032"triggering packages are not put in triggers-awaited state and can thus be " 5033"immediately configured without requiring the processing of the trigger. If " 5034"the triggering packages are dependencies of other upgraded packages, it will " 5035"avoid an early trigger processing run and make it possible to run the " 5036"trigger only once as one of the last steps of the upgrade." 5037msgstr "" 5038 5039#. type: Plain text 5040#: deb-triggers.man 5041msgid "" 5042"The “-noawait” variants are supported since dpkg 1.16.1, and will lead to " 5043"errors if used with an older dpkg." 5044msgstr "" 5045 5046#. type: Plain text 5047#: deb-triggers.man 5048msgid "" 5049"The “-await” alias variants are supported since dpkg 1.17.21, and will lead " 5050"to errors if used with an older dpkg." 5051msgstr "" 5052 5053#. type: Plain text 5054#: deb-triggers.man 5055msgid "" 5056"When a package provides an B<interest-noawait> directive, any activation " 5057"will set the triggering package into “noawait” mode, regardless of the " 5058"awaiting mode requested by the activation (either “await” or “noawait”). " 5059"When a package provides an B<interest> or B<interest-await> directive, any " 5060"activation will set the triggering package into “await” or “noawait“ " 5061"depending on how it was activated." 5062msgstr "" 5063 5064#. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev. 5065#. type: Plain text 5066#: deb-triggers.man 5067msgid "" 5068"B<dpkg-trigger>(1), B<dpkg>(1), B</usr/share/doc/dpkg-dev/triggers.txt.gz>." 5069msgstr "" 5070 5071#. type: TH 5072#: dsc.man 5073#, no-wrap 5074msgid "dsc" 5075msgstr "" 5076 5077#. type: Plain text 5078#: dsc.man 5079#, fuzzy 5080#| msgid "deb-src-control - Debian source packages' master control file format" 5081msgid "dsc - Debian source packages' control file format" 5082msgstr "deb-src-control - Debian 源代码包的主控文件格式" 5083 5084#. type: Plain text 5085#: dsc.man 5086#, fuzzy 5087#| msgid "I<filename>B<.deb>" 5088msgid "I<filename>B<.dsc>" 5089msgstr "I<filename>B<.deb>" 5090 5091#. type: Plain text 5092#: dsc.man 5093msgid "" 5094"Each Debian source package is composed of a .dsc control file, which " 5095"contains a number of fields. Each field begins with a tag, such as " 5096"B<Source> or B<Binary> (case insensitive), followed by a colon, and the body " 5097"of the field. Fields are delimited only by field tags. In other words, " 5098"field text may be multiple lines in length, but the installation tools will " 5099"generally join lines when processing the body of the field (except in case " 5100"of the multiline fields B<Package-List>, B<Files>, B<Checksums-Sha1> and " 5101"B<Checksums-Sha256>, see below)." 5102msgstr "" 5103 5104#. type: Plain text 5105#: dsc.man 5106msgid "" 5107"The value of this field declares the format version of the source package. " 5108"The field value is used by programs acting on a source package to interpret " 5109"the list of files in the source package and determine how to unpack it. The " 5110"syntax of the field value is a numeric major revision (“0-9”), a period " 5111"(“.”), a numeric minor revision (“0-9”), and then an optional subtype after " 5112"whitespace (“\\ \\et”), which if specified is a lowercase alphanumeric (“a-" 5113"z0-9”) word in parentheses (“()”). The subtype is optional in the syntax " 5114"but may be mandatory for particular source format revisions." 5115msgstr "" 5116 5117#. type: Plain text 5118#: dsc.man 5119msgid "" 5120"The source formats currently supported by B<dpkg> are B<1.0>, B<2.0>, B<3.0 " 5121"(native)>, B<3.0 (quilt)>, B<3.0 (git)>, B<3.0 (bzr)> and B<3.0 (custom)>. " 5122"See B<dpkg-source>(1) for their description." 5123msgstr "" 5124 5125#. type: TP 5126#: dsc.man 5127#, fuzzy, no-wrap 5128#| msgid "B<Package:>I< package-name>" 5129msgid "B<Source:> I<source-name> (required)" 5130msgstr "B<Package:>I< package-name>" 5131 5132#. type: TP 5133#: dsc.man 5134#, no-wrap 5135msgid "B<Binary:>I< binary-package-list>" 5136msgstr "" 5137 5138#. type: Plain text 5139#: dsc.man 5140msgid "" 5141"This folded field lists binary packages which this source package can " 5142"produce, separated by commas." 5143msgstr "" 5144 5145#. type: Plain text 5146#: dsc.man 5147msgid "" 5148"This field has now been superseded by the B<Package-List> field, which gives " 5149"enough information about what binary packages are produced on which " 5150"architecture, build-profile and other involved restrictions." 5151msgstr "" 5152 5153#. type: TP 5154#: dsc.man 5155#, fuzzy, no-wrap 5156#| msgid "B<--add-architecture >I<architecture>" 5157msgid "B<Architecture:> I<arch-list> (recommended)" 5158msgstr "B<--add-architecture >I<architectur>" 5159 5160#. type: Plain text 5161#: dsc.man 5162msgid "" 5163"A list of architectures and architecture wildcards separated by spaces which " 5164"specify the type of hardware this package can be compiled for. Common " 5165"architecture names and architecture wildcards are B<amd64>, B<armel>, " 5166"B<i386>, B<linux-any>, B<any-amd64>, etc." 5167msgstr "" 5168 5169#. type: Plain text 5170#: dsc.man 5171msgid "" 5172"Note that the B<all> value is meant for packages that are architecture " 5173"independent, and B<any> for packages that are architecture dependent. The " 5174"list may include (or consist solely of) the special value B<all>. When the " 5175"list contains the architecture wildcard B<any>, the only other value allowed " 5176"in the list is B<all>." 5177msgstr "" 5178 5179#. type: Plain text 5180#: dsc.man 5181msgid "" 5182"The field value is generally generated from B<Architecture> fields from in " 5183"the I<debian/control> in the source package." 5184msgstr "" 5185 5186#. type: TP 5187#: dsc.man 5188#, no-wrap 5189msgid "B<Uploaders:>I< fullname-email-list>" 5190msgstr "" 5191 5192#. type: TP 5193#: dsc.man 5194#, fuzzy, no-wrap 5195#| msgid "B<Version:>I< version-string>" 5196msgid "B<Standards-Version:> I<version-string> (recommended)" 5197msgstr "B<Version:>I< version-string>" 5198 5199#. type: Plain text 5200#: dsc.man 5201msgid "" 5202"The I<url> of a web interface to browse the Version Control System " 5203"repository." 5204msgstr "" 5205 5206#. type: Plain text 5207#: dsc.man 5208msgid "" 5209"These fields declare the I<url> of the Version Control System repository " 5210"used to maintain this package. See B<deb-src-control>(5) for more details." 5211msgstr "" 5212 5213#. type: Plain text 5214#: dsc.man 5215msgid "" 5216"This field declares that the source package contains the specified test " 5217"suites. The value is a comma-separated list of test suites. If the " 5218"B<autopkgtest> value is present, a I<debian/tests/control> is expected to be " 5219"present, if the file is present but not the value, then B<dpkg-source> will " 5220"automatically add it, preserving previous values." 5221msgstr "" 5222 5223#. type: Plain text 5224#: dsc.man 5225msgid "" 5226"This field declares the comma-separated union of all test dependencies " 5227"(B<Depends> fields in I<debian/tests/control> file), with all restrictions " 5228"removed, and OR dependencies flattened (that is, converted to separate AND " 5229"relationships), except for binaries generated by this source package and its " 5230"meta-dependency equivalent B<@>." 5231msgstr "" 5232 5233#. type: Plain text 5234#: dsc.man 5235msgid "" 5236"Rationale: this field is needed because otherwise to be able to get the test " 5237"dependencies, each source package would need to be unpacked." 5238msgstr "" 5239 5240#. type: Plain text 5241#: dsc.man 5242msgid "" 5243"These fields declare relationships between the source package and packages " 5244"used to build it. They are discussed in the B<deb-src-control>(5) manpage." 5245msgstr "" 5246 5247#. type: TP 5248#: dsc.man 5249#, fuzzy, no-wrap 5250#| msgid "Package states" 5251msgid "B<Package-List:>" 5252msgstr "软件包状态" 5253 5254#. type: TQ 5255#: dsc.man 5256#, no-wrap 5257msgid " I<package> I<package-type> I<section> I<priority> I<key-value-list>" 5258msgstr "" 5259 5260#. type: Plain text 5261#: dsc.man 5262msgid "" 5263"This multiline field contains a list of binary packages generated by this " 5264"source package." 5265msgstr "" 5266 5267#. type: Plain text 5268#: dsc.man 5269#, fuzzy 5270#| msgid "The package awaits trigger processing by another package." 5271msgid "The I<package> is the binary package name." 5272msgstr "该软件包等待其他包正在处理的触发器。" 5273 5274#. type: Plain text 5275#: dsc.man 5276msgid "" 5277"The I<package-type> is the binary package type, usually B<deb>, another " 5278"common value is B<udeb>." 5279msgstr "" 5280 5281#. type: Plain text 5282#: dsc.man 5283msgid "" 5284"The I<section> and I<priority> match the binary package fields of the same " 5285"name." 5286msgstr "" 5287 5288#. type: Plain text 5289#: dsc.man 5290msgid "" 5291"The I<key-value-list> is a space separated I<key>B<=>I<value> list, and the " 5292"currently known optional keys are:" 5293msgstr "" 5294 5295#. type: TP 5296#: dsc.man 5297#, no-wrap 5298msgid "B<arch>" 5299msgstr "" 5300 5301#. type: Plain text 5302#: dsc.man 5303msgid "" 5304"The architecture restriction from the binary package B<Architecture> field, " 5305"with spaces converted to ‘,’." 5306msgstr "" 5307 5308#. type: TP 5309#: dsc.man 5310#, fuzzy, no-wrap 5311#| msgid "B<config-files>" 5312msgid "B<profile>" 5313msgstr "B<config-files>" 5314 5315#. type: Plain text 5316#: dsc.man 5317msgid "" 5318"The normalized build-profile restriction formula from the binary package " 5319"B<Build-Profile> field, with ORs converted to ‘+’ and ANDs to ‘,’." 5320msgstr "" 5321 5322#. type: TP 5323#: dsc.man 5324#, no-wrap 5325msgid "B<essential>" 5326msgstr "" 5327 5328#. type: Plain text 5329#: dsc.man 5330msgid "" 5331"If the binary package is essential, this key will contain the value of the " 5332"B<Essential> field, that is a B<yes> value." 5333msgstr "" 5334 5335#. type: Plain text 5336#: dsc.man 5337msgid "" 5338"These multiline fields contain a list of files with a checksum and size for " 5339"each one. These fields have the same syntax and differ only in the checksum " 5340"algorithm used: MD5 for B<Files>, SHA-1 for B<Checksums-Sha1> and SHA-256 " 5341"for B<Checksums-Sha256>." 5342msgstr "" 5343 5344#. type: Plain text 5345#: dsc.man 5346msgid "" 5347"The first line of the field value (the part on the same line as the field " 5348"name followed by a colon) is always empty. The content of the field is " 5349"expressed as continuation lines, one line per file. Each line consists of " 5350"the checksum, a space, the file size, a space, and the file name." 5351msgstr "" 5352 5353#. type: Plain text 5354#: dsc.man 5355msgid "" 5356"These fields list all files that make up the source package. The list of " 5357"files in these fields must match the list of files in the other related " 5358"fields." 5359msgstr "" 5360 5361#. type: Plain text 5362#: dsc.man 5363msgid "" 5364"The B<Format> field conflates the format for the B<.dsc> file itself and the " 5365"format of the extracted source package." 5366msgstr "" 5367 5368#. type: Plain text 5369#: dsc.man 5370#, fuzzy 5371#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 5372msgid "B<deb-src-control>(5), B<deb-version>(7), B<dpkg-source>(1)." 5373msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 5374 5375#. type: TH 5376#: dpkg.man 5377#, no-wrap 5378msgid "dpkg" 5379msgstr "dpkg" 5380 5381#. type: Plain text 5382#: dpkg.man 5383msgid "dpkg - package manager for Debian" 5384msgstr "dpkg - Debian 的软件包管理器" 5385 5386#. type: Plain text 5387#: dpkg.man 5388msgid "B<dpkg> [I<option>...] I<action>" 5389msgstr "B<dpkg> [I<option>...] I<action>" 5390 5391#. type: SH 5392#: dpkg.man 5393#, no-wrap 5394msgid "WARNING" 5395msgstr "警告" 5396 5397#. type: Plain text 5398#: dpkg.man 5399msgid "" 5400"This manual is intended for users wishing to understand B<dpkg>'s command " 5401"line options and package states in more detail than that provided by B<dpkg " 5402"--help>." 5403msgstr "" 5404"本手册旨在为用户提供比 B<dpkg --help> 更多关于 B<dpkg> 命令行选项以及软件包状" 5405"态的信息（译者注：译者水平有限，如有问题请多包涵并以英文文档为准）" 5406 5407#. type: Plain text 5408#: dpkg.man 5409msgid "" 5410"It should I<not> be used by package maintainers wishing to understand how " 5411"B<dpkg> will install their packages. The descriptions of what B<dpkg> does " 5412"when installing and removing packages are particularly inadequate." 5413msgstr "" 5414"希望理解 B<dpkg> 如何安装软件包的维护者【不适合】使用本手册。本手册尤其缺乏对" 5415"于 B<dpkg> 进行安装和卸载操作时的具体行为描述。" 5416 5417#. type: Plain text 5418#: dpkg.man 5419msgid "" 5420"B<dpkg> is a tool to install, build, remove and manage Debian packages. The " 5421"primary and more user-friendly front-end for B<dpkg> is B<aptitude>(1). " 5422"B<dpkg> itself is controlled entirely via command line parameters, which " 5423"consist of exactly one action and zero or more options. The action-parameter " 5424"tells B<dpkg> what to do and options control the behavior of the action in " 5425"some way." 5426msgstr "" 5427"B<dpkg> 是一个用来安装、构建、卸载和管理 Debian 软件包的工具。B<dpkg> 主要的" 5428"用户友好型前端是 B<aptitude>(1)。B<dpkg> 本身需要完全通过命令行来操纵，所指的" 5429"命令包含一项行为以及任意个选项。其中的行为参数将指定 B<dpkg> 的行为，同时由其" 5430"他的选项来调整其细节。" 5431 5432#. type: Plain text 5433#: dpkg.man 5434msgid "" 5435"B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and B<dpkg-" 5436"query>(1). The list of supported actions can be found later on in the " 5437"B<ACTIONS> section. If any such action is encountered B<dpkg> just runs " 5438"B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no " 5439"specific options are currently passed to them, to use any such option the " 5440"back-ends need to be called directly." 5441msgstr "" 5442"B<dpkg> 也可以用作 B<dpkg-deb>(1) 和 B<dpkg-query>(1) 的前端。行为项的列表可" 5443"在下文中的 B<行为> 章节中找到。对于这些行为项，dpkg 会用自己得到的参数来调用 " 5444"dpkg-deb 或 dpkg-query，但不会有任何的选项被传递，如果想要也传递选项，请直接" 5445"使用这些后端程序。" 5446 5447#. type: SH 5448#: dpkg.man 5449#, no-wrap 5450msgid "INFORMATION ABOUT PACKAGES" 5451msgstr "关于软件包" 5452 5453#. type: Plain text 5454#: dpkg.man 5455msgid "" 5456"B<dpkg> maintains some usable information about available packages. The " 5457"information is divided in three classes: B<states>, B<selection states> and " 5458"B<flags>. These values are intended to be changed mainly with B<dselect>." 5459msgstr "" 5460"B<dpkg> 维护着一些关于有效软件包的可用信息。这些信息被分为三类：B<states>，" 5461"B<selection states> 和 B<flags>。这些值主要由 B<dselect> 来改动。" 5462 5463#. type: SS 5464#: dpkg.man 5465#, no-wrap 5466msgid "Package states" 5467msgstr "软件包状态" 5468 5469#. type: TP 5470#: dpkg.man 5471#, no-wrap 5472msgid "B<not-installed>" 5473msgstr "B<not-installed>" 5474 5475#. type: Plain text 5476#: dpkg.man 5477msgid "The package is not installed on your system." 5478msgstr "该软件包没有安装在您的系统中。" 5479 5480#. type: TP 5481#: dpkg.man 5482#, no-wrap 5483msgid "B<config-files>" 5484msgstr "B<config-files>" 5485 5486#. type: Plain text 5487#: dpkg.man 5488msgid "Only the configuration files of the package exist on the system." 5489msgstr "仅有一些该包中的配置文件残存于系统中。" 5490 5491#. type: TP 5492#: dpkg.man 5493#, no-wrap 5494msgid "B<half-installed>" 5495msgstr "B<half-installed>" 5496 5497#. type: Plain text 5498#: dpkg.man 5499msgid "" 5500"The installation of the package has been started, but not completed for some " 5501"reason." 5502msgstr "该软件包的安装有曾开始，但因为某些原因没有完成。" 5503 5504#. type: TP 5505#: dpkg.man 5506#, no-wrap 5507msgid "B<unpacked>" 5508msgstr "B<unpacked>" 5509 5510#. type: Plain text 5511#: dpkg.man 5512msgid "The package is unpacked, but not configured." 5513msgstr "该软件已经解压，但还没有进行配置。" 5514 5515#. type: TP 5516#: dpkg.man 5517#, no-wrap 5518msgid "B<half-configured>" 5519msgstr "B<half-configured>" 5520 5521#. type: Plain text 5522#: dpkg.man 5523msgid "" 5524"The package is unpacked and configuration has been started, but not yet " 5525"completed for some reason." 5526msgstr "该软件已经解压而且配置过程有曾开始，但由于某些原因未完成。" 5527 5528#. type: TP 5529#: dpkg.man 5530#, no-wrap 5531msgid "B<triggers-awaited>" 5532msgstr "B<triggers-awaited>" 5533 5534#. type: Plain text 5535#: dpkg.man 5536msgid "The package awaits trigger processing by another package." 5537msgstr "该软件包等待其他包正在处理的触发器。" 5538 5539#. type: TP 5540#: dpkg.man 5541#, no-wrap 5542msgid "B<triggers-pending>" 5543msgstr "B<triggers-pending>" 5544 5545#. type: Plain text 5546#: dpkg.man 5547msgid "The package has been triggered." 5548msgstr "该软件包已被触发。" 5549 5550#. type: TP 5551#: dpkg.man 5552#, no-wrap 5553msgid "B<installed>" 5554msgstr "B<installed>" 5555 5556#. type: Plain text 5557#: dpkg.man 5558msgid "The package is correctly unpacked and configured." 5559msgstr "该软件包已被成功解压并配置。" 5560 5561#. type: SS 5562#: dpkg.man 5563#, no-wrap 5564msgid "Package selection states" 5565msgstr "软件包选择状态" 5566 5567#. type: TP 5568#: dpkg.man 5569#, no-wrap 5570msgid "B<install>" 5571msgstr "B<install>" 5572 5573#. type: Plain text 5574#: dpkg.man 5575msgid "The package is selected for installation." 5576msgstr "该软件包被选择安装。" 5577 5578#. type: TP 5579#: dpkg.man 5580#, no-wrap 5581msgid "B<hold>" 5582msgstr "B<hold>" 5583 5584#. type: Plain text 5585#: dpkg.man 5586msgid "" 5587"A package marked to be on B<hold> is not handled by B<dpkg>, unless forced " 5588"to do that with option B<--force-hold>." 5589msgstr "" 5590"B<dpkg> 不处理标记为保留(B<hold>)的软件包，除非用 B<--force-hold> 选项来强制" 5591"执行。" 5592 5593#. type: TP 5594#: dpkg.man 5595#, no-wrap 5596msgid "B<deinstall>" 5597msgstr "B<deinstall>" 5598 5599#. type: Plain text 5600#: dpkg.man 5601msgid "" 5602"The package is selected for deinstallation (i.e. we want to remove all " 5603"files, except configuration files)." 5604msgstr "该软件包被选择卸载（亦即，想要移除配置文件之外的所有文件）。" 5605 5606#. type: TP 5607#: dpkg.man 5608#, no-wrap 5609msgid "B<purge>" 5610msgstr "B<purge>" 5611 5612#. type: Plain text 5613#: dpkg.man 5614msgid "" 5615"The package is selected to be purged (i.e. we want to remove everything from " 5616"system directories, even configuration files)." 5617msgstr "该软件包被选择清除（亦即，想要移除包括配置文件的所有文件）。" 5618 5619#. type: TP 5620#: dpkg.man 5621#, no-wrap 5622msgid "B<unknown>" 5623msgstr "" 5624 5625#. type: Plain text 5626#: dpkg.man 5627msgid "" 5628"The package selection is unknown. A package that is also in a B<not-" 5629"installed> state, and with an B<ok> flag will be forgotten in the next " 5630"database store." 5631msgstr "" 5632 5633#. type: SS 5634#: dpkg.man 5635#, no-wrap 5636msgid "Package flags" 5637msgstr "软件包标志" 5638 5639#. type: TP 5640#: dpkg.man 5641#, no-wrap 5642msgid "B<ok>" 5643msgstr "" 5644 5645#. type: Plain text 5646#: dpkg.man 5647msgid "" 5648"A package marked B<ok> is in a known state, but might need further " 5649"processing." 5650msgstr "" 5651 5652#. type: TP 5653#: dpkg.man 5654#, fuzzy, no-wrap 5655#| msgid "B<reinst-required>" 5656msgid "B<reinstreq>" 5657msgstr "B<reinst-required>" 5658 5659#. type: Plain text 5660#: dpkg.man 5661#, fuzzy 5662#| msgid "" 5663#| "A package marked B<reinst-required> is broken and requires " 5664#| "reinstallation. These packages cannot be removed, unless forced with " 5665#| "option B<--force-remove-reinstreq>." 5666msgid "" 5667"A package marked B<reinstreq> is broken and requires reinstallation. These " 5668"packages cannot be removed, unless forced with option B<--force-remove-" 5669"reinstreq>." 5670msgstr "" 5671"标记了 B<reinst-required> 的软件包已破损，并需要重新安装。这样的软件包无法卸" 5672"载，除非用 B<--force-remove-reinstreq> 选项强制执行。" 5673 5674#. type: SH 5675#: dpkg.man 5676#, no-wrap 5677msgid "ACTIONS" 5678msgstr "行为" 5679 5680#. type: TP 5681#: dpkg.man 5682#, no-wrap 5683msgid "B<-i>, B<--install> I<package-file>..." 5684msgstr "B<-i>, B<--install> I<package-file>..." 5685 5686#. type: Plain text 5687#: dpkg.man 5688msgid "" 5689"Install the package. If B<--recursive> or B<-R> option is specified, " 5690"I<package-file> must refer to a directory instead." 5691msgstr "" 5692"安装软件包。如果给定 B<--recursive> 或 B<-R> 选项，那么其 I<package-file> 参" 5693"数必须是一个目录。" 5694 5695#. type: Plain text 5696#: dpkg.man 5697msgid "Installation consists of the following steps:" 5698msgstr "安装过程包括一下环节：" 5699 5700#. type: Plain text 5701#: dpkg.man 5702msgid "B<1.> Extract the control files of the new package." 5703msgstr "B<1.> 抽取新软件包的控制文件。" 5704 5705#. type: Plain text 5706#: dpkg.man 5707msgid "" 5708"B<2.> If another version of the same package was installed before the new " 5709"installation, execute I<prerm> script of the old package." 5710msgstr "" 5711"B<2.> 如果已经安装了相同软件包的另一个版本，运行旧软件包的 I<prerm> 脚本。" 5712 5713#. type: Plain text 5714#: dpkg.man 5715msgid "B<3.> Run I<preinst> script, if provided by the package." 5716msgstr "B<3.> 运行 I<preinst> 脚本，如果软件包有提供的话。" 5717 5718#. type: Plain text 5719#: dpkg.man 5720msgid "" 5721"B<4.> Unpack the new files, and at the same time back up the old files, so " 5722"that if something goes wrong, they can be restored." 5723msgstr "B<4.> 将新文件解压，并备份旧文件，备份档用于在出问题时进行恢复。" 5724 5725#. type: Plain text 5726#: dpkg.man 5727msgid "" 5728"B<5.> If another version of the same package was installed before the new " 5729"installation, execute the I<postrm> script of the old package. Note that " 5730"this script is executed after the I<preinst> script of the new package, " 5731"because new files are written at the same time old files are removed." 5732msgstr "" 5733"B<5.> 如果已经安装了相同软件包的另一个版本，就运行旧软件包的 I<postrm> 脚本。" 5734"注意，这个脚本是在新软件包的 I<preinst> 脚本之后被执行的，因为删除旧文件的同" 5735"时新文件被写入。" 5736 5737#. type: Plain text 5738#: dpkg.man 5739msgid "" 5740"B<6.> Configure the package. See B<--configure> for detailed information " 5741"about how this is done." 5742msgstr "B<6.> 配置该软件。欲了解该操作如何达成，详情请参见 B<--configure>。" 5743 5744#. type: TP 5745#: dpkg.man 5746#, no-wrap 5747msgid "B<--unpack >I<package-file>..." 5748msgstr "B<--unpack >I<package-file>..." 5749 5750#. type: Plain text 5751#: dpkg.man 5752msgid "" 5753"Unpack the package, but don't configure it. If B<--recursive> or B<-R> " 5754"option is specified, I<package-file> must refer to a directory instead." 5755msgstr "" 5756"解开此包，但不进行配置。如果给定 B<--recursive> 或 B<-R> 选项，那么 " 5757"I<package-file> 必须是一个目录。" 5758 5759#. type: TP 5760#: dpkg.man 5761#, no-wrap 5762msgid "B<--configure >I<package>...|B<-a>|B<--pending>" 5763msgstr "" 5764 5765#. type: Plain text 5766#: dpkg.man 5767msgid "" 5768"Configure a package which has been unpacked but not yet configured. If B<-" 5769"a> or B<--pending> is given instead of I<package>, all unpacked but " 5770"unconfigured packages are configured." 5771msgstr "" 5772"配置一个解压完成但仍未进行过配置的软件包。如果给定 B<-a> 或者 B<--pending> 选" 5773"项而不是 I<package>，所有解压但未配置的包均会被配置。" 5774 5775#. type: Plain text 5776#: dpkg.man 5777msgid "" 5778"To reconfigure a package which has already been configured, try the B<dpkg-" 5779"reconfigure>(8) command instead." 5780msgstr "若要重新配置一个已经配置过的软件包，请尝试B<dpkg-reconfigure>(8)" 5781 5782#. type: Plain text 5783#: dpkg.man 5784msgid "Configuring consists of the following steps:" 5785msgstr "配置过程包含以下环节：" 5786 5787#. type: Plain text 5788#: dpkg.man 5789msgid "" 5790"B<1.> Unpack the conffiles, and at the same time back up the old conffiles, " 5791"so that they can be restored if something goes wrong." 5792msgstr "B<1.> 解压配置文件，同时备份旧配置文件，以备出错时恢复之需。" 5793 5794#. type: Plain text 5795#: dpkg.man 5796msgid "B<2.> Run I<postinst> script, if provided by the package." 5797msgstr "B<2.> 运行 I<postinst> 脚本，如果软件包提供的话。" 5798 5799#. type: TP 5800#: dpkg.man 5801#, no-wrap 5802msgid "B<--triggers-only> I<package>...|B<-a>|B<--pending>" 5803msgstr "B<--triggers-only> I<package>...|B<-a>|B<--pending>" 5804 5805#. type: Plain text 5806#: dpkg.man 5807#, fuzzy 5808#| msgid "" 5809#| "Processes only triggers. All pending triggers will be processed. If " 5810#| "package names are supplied only those packages' triggers will be " 5811#| "processed, exactly once each where necessary. Use of this option may " 5812#| "leave packages in the improper B<triggers-awaited> and B<triggers-" 5813#| "pending> states. This can be fixed later by running: B<dpkg --configure --" 5814#| "pending>." 5815msgid "" 5816"Processes only triggers (since dpkg 1.14.17). All pending triggers will be " 5817"processed. If package names are supplied only those packages' triggers will " 5818"be processed, exactly once each where necessary. Use of this option may " 5819"leave packages in the improper B<triggers-awaited> and B<triggers-pending> " 5820"states. This can be fixed later by running: B<dpkg --configure --pending>." 5821msgstr "" 5822"仅处理触发器。且所有未决触发器都会被处理。If package names are supplied only " 5823"those packages' triggers will be processed, exactly once each where " 5824"necessary.使用该选项可能导致软件包处于不妥当的 B<triggers-awaited> 和 " 5825"B<triggers-pending>状态。但可以在之后使用该命令修复： B<dpkg --configure --" 5826"pending>。" 5827 5828#. type: TP 5829#: dpkg.man 5830#, fuzzy, no-wrap 5831#| msgid "B<-r>, B<--remove> I<package>B<...|-a|--pending>" 5832msgid "B<-r>, B<--remove> I<package>...|B<-a>|B<--pending>" 5833msgstr "B<-r>, B<--remove> I<package>B<...|-a|--pending>" 5834 5835#. type: Plain text 5836#: dpkg.man 5837#, fuzzy 5838#| msgid "" 5839#| "Remove an installed package. This removes everything except conffiles, " 5840#| "which may avoid having to reconfigure the package if it is reinstalled " 5841#| "later (conffiles are configuration files that are listed in the I<DEBIAN/" 5842#| "conffiles> control file). If B<-a> or B<--pending> is given instead of a " 5843#| "package name, then all packages unpacked, but marked to be removed in " 5844#| "file I<%ADMINDIR%/status>, are removed." 5845msgid "" 5846"Remove an installed package. This removes everything except conffiles and " 5847"other data cleaned up by the I<postrm> script, which may avoid having to " 5848"reconfigure the package if it is reinstalled later (conffiles are " 5849"configuration files that are listed in the I<DEBIAN/conffiles> control " 5850"file). If there is no I<DEBIAN/conffiles> control file nor I<DEBIAN/postrm> " 5851"script, this command is equivalent to calling B<--purge>. If B<-a> or B<--" 5852"pending> is given instead of a package name, then all packages unpacked, but " 5853"marked to be removed in file I<%ADMINDIR%/status>, are removed." 5854msgstr "" 5855"移除一个已安装的软件包。此操作会移除配置文件之外的所有文件，如果稍后要重新安" 5856"装该包，这可以避免重新配置它（conffiles 是在 I<DEBIAN/conffiles> 中列出的配置" 5857"文件，亦即上文所指文件）。如果给定 B<-a> 或 B<--pending> 参数而不是软件包名，" 5858"那么所有已被解压，但在 I<%ADMINDIR%/status> 中被标记为“待删除”的软件包，将被" 5859"删除。" 5860 5861#. type: Plain text 5862#: dpkg.man 5863msgid "Removing of a package consists of the following steps:" 5864msgstr "移除一个软件包需要经过以下环节：" 5865 5866#. type: Plain text 5867#: dpkg.man 5868msgid "B<1.> Run I<prerm> script" 5869msgstr "B<1.> 执行 I<prerm> 脚本" 5870 5871#. type: Plain text 5872#: dpkg.man 5873msgid "B<2.> Remove the installed files" 5874msgstr "B<2.> 移除已安装的文件" 5875 5876#. type: Plain text 5877#: dpkg.man 5878msgid "B<3.> Run I<postrm> script" 5879msgstr "B<3.> 执行 I<postrm> 脚本" 5880 5881#. type: TP 5882#: dpkg.man 5883#, fuzzy, no-wrap 5884#| msgid "B<-P>, B<--purge >I<package>...|B<-a>|B<--pending>" 5885msgid "B<-P>, B<--purge> I<package>...|B<-a>|B<--pending>" 5886msgstr "B<-P>, B<--purge >I<package>...|B<-a>|B<--pending>" 5887 5888#. type: Plain text 5889#: dpkg.man 5890#, fuzzy 5891#| msgid "" 5892#| "Purge an installed or already removed package. This removes everything, " 5893#| "including conffiles. If B<-a> or B<--pending> is given instead of a " 5894#| "package name, then all packages unpacked or removed, but marked to be " 5895#| "purged in file I<%ADMINDIR%/status>, are purged." 5896msgid "" 5897"Purge an installed or already removed package. This removes everything, " 5898"including conffiles, and anything else cleaned up from I<postrm>. If B<-a> " 5899"or B<--pending> is given instead of a package name, then all packages " 5900"unpacked or removed, but marked to be purged in file I<%ADMINDIR%/status>, " 5901"are purged." 5902msgstr "" 5903"彻底清除已安装或已移除的软件包。这会删除所有有关的文件，包括所有配置文件。如" 5904"果给定 B<-a> 或 B<--pending> 选项而不是软件包名，那么在 I<%ADMINDIR%/status> " 5905"中所有已解压的、已移除但标记了“待清除”的软件包均会被彻底清除。" 5906 5907#. type: Plain text 5908#: dpkg.man 5909msgid "" 5910"Note: some configuration files might be unknown to B<dpkg> because they are " 5911"created and handled separately through the configuration scripts. In that " 5912"case, B<dpkg> won't remove them by itself, but the package's I<postrm> " 5913"script (which is called by B<dpkg>), has to take care of their removal " 5914"during purge. Of course, this only applies to files in system directories, " 5915"not configuration files written to individual users' home directories." 5916msgstr "" 5917"注意：有些配置文件可能不被 B<dpkg> 记录，因为它们是通过配置脚本来分别创建和处" 5918"理的。在这种情况下，B<dpkg> 将不会擅自删除这些配置文件，而是由软件包的 " 5919"I<postrm> 脚本（由 B<dpkg> 调用）来进行删除及清除。当然，这只应用于系统目录中" 5920"的文件，而用户家目录中的配置文件则不受影响。" 5921 5922#. type: Plain text 5923#: dpkg.man 5924msgid "Purging of a package consists of the following steps:" 5925msgstr "清除一个软件包包含以下环节：" 5926 5927#. type: Plain text 5928#: dpkg.man 5929msgid "" 5930"B<1.> Remove the package, if not already removed. See B<--remove> for " 5931"detailed information about how this is done." 5932msgstr "" 5933"B<1.> 如果它没有被移除，那么移除该软件包。更多实现的细节请参见 B<--remove>。" 5934 5935#. type: Plain text 5936#: dpkg.man 5937msgid "B<2.> Run I<postrm> script." 5938msgstr "B<2.> 执行 I<postrm> 脚本。" 5939 5940#. type: TP 5941#: dpkg.man 5942#, no-wrap 5943msgid "B<-V>, B<--verify> [I<package-name>...]" 5944msgstr "B<-V>, B<--verify> [I<package-name>...]" 5945 5946#. type: Plain text 5947#: dpkg.man 5948#, fuzzy 5949#| msgid "" 5950#| "Verifies the integrity of I<package-name> or all packages if omitted, by " 5951#| "comparing information from the files installed by a package with the " 5952#| "files metadata information stored in the B<dpkg> database. The origin of " 5953#| "the files metadata information in the database is the binary packages " 5954#| "themselves. That metadata gets collected at package unpack time during " 5955#| "the installation process." 5956msgid "" 5957"Verifies the integrity of I<package-name> or all packages if omitted, by " 5958"comparing information from the files installed by a package with the files " 5959"metadata information stored in the B<dpkg> database (since dpkg 1.17.2). " 5960"The origin of the files metadata information in the database is the binary " 5961"packages themselves. That metadata gets collected at package unpack time " 5962"during the installation process." 5963msgstr "" 5964"对已安装文件的信息与 B<dpkg> 数据库中的文件元信息进行比较，以检查软件包 " 5965"I<package-name> 的完整性，若参数缺省则检查所有包。数据库中的原始的文件元信息" 5966"正是二进制包本身。这些元信息是在安装过程的解压环节中收集的。" 5967 5968#. type: Plain text 5969#: dpkg.man 5970#, fuzzy 5971#| msgid "" 5972#| "Currently the only functional check performed is an md5sum verification " 5973#| "against the stored value in the files database. It will only get checked " 5974#| "if the database contains the file md5sum. To check for any missing " 5975#| "metadata in the database, the B<--audit> command can be used." 5976msgid "" 5977"Currently the only functional check performed is an md5sum verification of " 5978"the file contents against the stored value in the files database. It will " 5979"only get checked if the database contains the file md5sum. To check for any " 5980"missing metadata in the database, the B<--audit> command can be used." 5981msgstr "" 5982"当前唯一进行过的的功能性检查是一次根据文件数据库中校验和进行的 md5sum 校验。" 5983"不过仅当数据库中有这些文件的 md5sum 值的时候才会进行校验。若要检查任何数据库" 5984"中缺失的元信息，请使用 B<--audit> 选项。" 5985 5986#. type: Plain text 5987#: dpkg.man 5988msgid "" 5989"The output format is selectable with the B<--verify-format> option, which by " 5990"default uses the B<rpm> format, but that might change in the future, and as " 5991"such, programs parsing this command output should be explicit about the " 5992"format they expect." 5993msgstr "" 5994"输出格式可以用 B<--verify-format> 选项来选择，它默认使用 B<rpm> 格式，但这一" 5995"点可能在未来被更改，正因如此，解析输出信息的程序应该显式说明它所期望的输出格" 5996"式。" 5997 5998#. type: TP 5999#: dpkg.man 6000#, no-wrap 6001msgid "B<-C>, B<--audit> [I<package-name>...]" 6002msgstr "B<-C>, B<--audit> [I<package-name>...]" 6003 6004#. type: Plain text 6005#: dpkg.man 6006#, fuzzy 6007#| msgid "" 6008#| "Performs database sanity and consistency checks for I<package-name> or " 6009#| "all packages if omitted. For example, searches for packages that have " 6010#| "been installed only partially on your system or that have missing, wrong " 6011#| "or obsolete control data or files. B<dpkg> will suggest what to do with " 6012#| "them to get them fixed." 6013msgid "" 6014"Performs database sanity and consistency checks for I<package-name> or all " 6015"packages if omitted (per package checks since dpkg 1.17.10). For example, " 6016"searches for packages that have been installed only partially on your system " 6017"or that have missing, wrong or obsolete control data or files. B<dpkg> will " 6018"suggest what to do with them to get them fixed." 6019msgstr "" 6020"对 I<package-name> 进行数据库一致性以及健康检查，如果该参数缺省则检查所有软件" 6021"包。比如说，搜索安装到系统中的不完整文件，搜索发生了 丢失/错误/废弃 的控制文" 6022"件和数据。B<dpkg> 会针对相应的情况给出修复建议。" 6023 6024#. type: TP 6025#: dpkg.man 6026#, fuzzy, no-wrap 6027#| msgid "B<--update-avail>, B<--merge-avail> [I<Packages-file>]" 6028msgid "B<--update-avail> [I<Packages-file>]" 6029msgstr "B<--update-avail>, B<--merge-avail> [I<Packages-file>]" 6030 6031#. type: TQ 6032#: dpkg.man 6033#, fuzzy, no-wrap 6034#| msgid "B<--update-avail>, B<--merge-avail> [I<Packages-file>]" 6035msgid "B<--merge-avail> [I<Packages-file>]" 6036msgstr "B<--update-avail>, B<--merge-avail> [I<Packages-file>]" 6037 6038#. type: Plain text 6039#: dpkg.man 6040#, fuzzy 6041#| msgid "" 6042#| "Update B<dpkg>'s and B<dselect>'s idea of which packages are available. " 6043#| "With action B<--merge-avail>, old information is combined with " 6044#| "information from I<Packages-file>. With action B<--update-avail>, old " 6045#| "information is replaced with the information in the I<Packages-file>. The " 6046#| "I<Packages-file> distributed with Debian is simply named I<Packages>. If " 6047#| "the I<Packages-file> argument is missing or named B<-> then it will be " 6048#| "read from standard input (since dpkg 1.17.7). B<dpkg> keeps its record of " 6049#| "available packages in I<%ADMINDIR%/available>." 6050msgid "" 6051"Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With " 6052"action B<--merge-avail>, old information is combined with information from " 6053"I<Packages-file>. With action B<--update-avail>, old information is replaced " 6054"with the information in the I<Packages-file>. The I<Packages-file> " 6055"distributed with Debian is simply named «I<Packages>». If the I<Packages-" 6056"file> argument is missing or named «B<->» then it will be read from standard " 6057"input (since dpkg 1.17.7). B<dpkg> keeps its record of available packages in " 6058"I<%ADMINDIR%/available>." 6059msgstr "" 6060"更新 B<dpkg> 和 B<dselect> 对有效软件包的感知。通过 B<--merge-avail> 行为，旧" 6061"信息会与 I<Packages-file> 中的信息结合。通过 B<--update-avail> 行为，旧信息会" 6062"被 I<Packages-file> 中的信息取代。由 Debian 分发的 I<Packages-file> 被简单命" 6063"名为 I<Packages>。如果 I<Packages-file> 参数缺省，或者为 B<->，那么它将从标准" 6064"输入中读取（自 dpkg 1.17.7 之后）。B<dpkg> 会在 I<%ADMINDIR%/available> 中维" 6065"护自己对有效软件包的记录。" 6066 6067#. type: Plain text 6068#: dpkg.man 6069msgid "" 6070"A simpler one-shot command to retrieve and update the I<available> file is " 6071"B<dselect update>. Note that this file is mostly useless if you don't use " 6072"B<dselect> but an APT-based frontend: APT has its own system to keep track " 6073"of available packages." 6074msgstr "" 6075"B<dselect update> 是一个更简单的一次性命令，用于获取和更新 I<available> 文" 6076"件。注意，如果您使用基于 APT 的前端而不是 B<dselect>，那么该文件大多数情况下" 6077"是无用的：APT 有它自己的有效包跟踪系统。" 6078 6079#. type: TP 6080#: dpkg.man 6081#, no-wrap 6082msgid "B<-A>, B<--record-avail> I<package-file>..." 6083msgstr "B<-A>, B<--record-avail> I<package-file>..." 6084 6085#. type: Plain text 6086#: dpkg.man 6087msgid "" 6088"Update B<dpkg> and B<dselect>'s idea of which packages are available with " 6089"information from the package I<package-file>. If B<--recursive> or B<-R> " 6090"option is specified, I<package-file> must refer to a directory instead." 6091msgstr "" 6092"通过 I<package-file> 中的信息，更新 B<dpkg> 和 B<dselect> 对于有效软件包的认" 6093"识。如果给定 B<--recursive> 或 B<-R> 参数，那么 I<package-file> 必须指向一个" 6094"目录。" 6095 6096#. type: TP 6097#: dpkg.man 6098#, no-wrap 6099msgid "B<--forget-old-unavail>" 6100msgstr "B<--forget-old-unavail>" 6101 6102#. type: Plain text 6103#: dpkg.man 6104msgid "" 6105"Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled " 6106"unavailable packages (since dpkg 1.15.4), but only those that do not contain " 6107"user information such as package selections." 6108msgstr "" 6109 6110#. type: TP 6111#: dpkg.man 6112#, no-wrap 6113msgid "B<--clear-avail>" 6114msgstr "B<--clear-avail>" 6115 6116#. type: Plain text 6117#: dpkg.man 6118msgid "Erase the existing information about what packages are available." 6119msgstr "擦除现存的关于有效软件包的信息。" 6120 6121#. type: TP 6122#: dpkg.man 6123#, no-wrap 6124msgid "B<--get-selections> [I<package-name-pattern>...]" 6125msgstr "B<--get-selections> [I<package-name-pattern>...]" 6126 6127#. type: Plain text 6128#: dpkg.man 6129msgid "" 6130"Get list of package selections, and write it to stdout. Without a pattern, " 6131"non-installed packages (i.e. those which have been previously purged) will " 6132"not be shown." 6133msgstr "" 6134"获取软件包选择列表，并写到标准输出。如果未给出一个表达式，那么未安装的软件包" 6135"（亦即，先前被清除的）将不会显示。" 6136 6137#. type: TP 6138#: dpkg.man update-alternatives.man 6139#, no-wrap 6140msgid "B<--set-selections>" 6141msgstr "B<--set-selections>" 6142 6143#. type: Plain text 6144#: dpkg.man 6145#, fuzzy 6146#| msgid "" 6147#| "Set package selections using file read from stdin. This file should be in " 6148#| "the format 'I<package> I<state>', where state is one of B<install>, " 6149#| "B<hold>, B<deinstall> or B<purge>. Blank lines and comment lines " 6150#| "beginning with '#' are also permitted." 6151msgid "" 6152"Set package selections using file read from stdin. This file should be in " 6153"the format “I<package> I<state>”, where state is one of B<install>, B<hold>, " 6154"B<deinstall> or B<purge>. Blank lines and comment lines beginning with " 6155"‘B<#>’ are also permitted." 6156msgstr "" 6157"通过标准输入读取文件，以此设置软件包选择。读入的文件格式应该是“I<package> " 6158"I<state>”，其中的“state”是 B<install>，B<hold>，B<deinstall>，B<purge> 四者之" 6159"一。支持空行和‘#’开头的注释行。" 6160 6161#. type: Plain text 6162#: dpkg.man 6163msgid "" 6164"The I<available> file needs to be up-to-date for this command to be useful, " 6165"otherwise unknown packages will be ignored with a warning. See the B<--" 6166"update-avail> and B<--merge-avail> commands for more information." 6167msgstr "" 6168"需要更新 I<available> 文件以使该命令生效，否则未知的包将伴随警告而被忽略。详" 6169"情请参见 B<--update-avail> 和 B<--merge-avail> 命令。" 6170 6171#. type: TP 6172#: dpkg.man 6173#, no-wrap 6174msgid "B<--clear-selections>" 6175msgstr "B<--clear-selections>" 6176 6177#. type: Plain text 6178#: dpkg.man 6179msgid "" 6180"Set the requested state of every non-essential package to deinstall (since " 6181"dpkg 1.13.18). This is intended to be used immediately before B<--set-" 6182"selections>, to deinstall any packages not in list given to B<--set-" 6183"selections>." 6184msgstr "" 6185 6186#. type: TP 6187#: dpkg.man 6188#, no-wrap 6189msgid "B<--yet-to-unpack>" 6190msgstr "B<--yet-to-unpack>" 6191 6192#. type: Plain text 6193#: dpkg.man 6194msgid "" 6195"Searches for packages selected for installation, but which for some reason " 6196"still haven't been installed." 6197msgstr "搜索那些已选择安装，但因某种缘故仍未安装完成的软件包。" 6198 6199#. type: Plain text 6200#: dpkg.man 6201msgid "" 6202"Note: This command makes use of both the available file and the package " 6203"selections." 6204msgstr "" 6205 6206#. type: TP 6207#: dpkg.man 6208#, fuzzy, no-wrap 6209#| msgid "B<--ignore-depends>=I<package>,..." 6210msgid "B<--predep-package>" 6211msgstr "B<--ignore-depends>=I<package>,..." 6212 6213#. type: Plain text 6214#: dpkg.man 6215msgid "" 6216"Print a single package which is the target of one or more relevant pre-" 6217"dependencies and has itself no unsatisfied pre-dependencies." 6218msgstr "" 6219 6220#. type: Plain text 6221#: dpkg.man 6222msgid "" 6223"If such a package is present, output it as a Packages file entry, which can " 6224"be massaged as appropriate." 6225msgstr "" 6226 6227#. type: Plain text 6228#: dpkg.man 6229msgid "" 6230"Returns 0 when a package is printed, 1 when no suitable package is available " 6231"and 2 on error." 6232msgstr "" 6233 6234#. type: TP 6235#: dpkg.man 6236#, no-wrap 6237msgid "B<--add-architecture >I<architecture>" 6238msgstr "B<--add-architecture >I<architectur>" 6239 6240#. type: Plain text 6241#: dpkg.man 6242#, fuzzy 6243#| msgid "" 6244#| "Add I<architecture> to the list of architectures for which packages can " 6245#| "be installed without using B<--force-architecture>. The architecture " 6246#| "B<dpkg> is built for (i.e. the output of B<--print-architecture>) is " 6247#| "always part of that list." 6248msgid "" 6249"Add I<architecture> to the list of architectures for which packages can be " 6250"installed without using B<--force-architecture> (since dpkg 1.16.2). The " 6251"architecture B<dpkg> is built for (i.e. the output of B<--print-" 6252"architecture>) is always part of that list." 6253msgstr "" 6254"将指定的 I<architectur> 添加到体系结构列表，而根据这个列表可以在不使用B<--" 6255"force-architecture> 选项的情况下安装对应体系结构的软件包。构建 B<dpkg> 所用的" 6256"体系结构（即 B<--print-architecture> 的输出）会一直留在该体系结构列表中。" 6257 6258#. type: TP 6259#: dpkg.man 6260#, no-wrap 6261msgid "B<--remove-architecture >I<architecture>" 6262msgstr "B<--remove-architecture >I<architecture>" 6263 6264#. type: Plain text 6265#: dpkg.man 6266#, fuzzy 6267#| msgid "" 6268#| "Remove I<architecture> from the list of architectures for which packages " 6269#| "can be installed without using B<--force-architecture>. If the " 6270#| "architecture is currently in use in the database then the operation will " 6271#| "be refused, except if B<--force-architecture> is specified. The " 6272#| "architecture B<dpkg> is built for (i.e. the output of B<--print-" 6273#| "architecture>) can never be removed from that list." 6274msgid "" 6275"Remove I<architecture> from the list of architectures for which packages can " 6276"be installed without using B<--force-architecture> (since dpkg 1.16.2). If " 6277"the architecture is currently in use in the database then the operation will " 6278"be refused, except if B<--force-architecture> is specified. The architecture " 6279"B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never " 6280"be removed from that list." 6281msgstr "" 6282"将指定的 I<architectur> 从体系结构列表中移除，而根据这个列表可以在不使用B<--" 6283"force-architecture> 选项的情况下安装对应体系结构的软件包。如果所指体系结构正" 6284"被数据库所使用，那么这项操作会被拒绝，除非指定B<--force-architecture> 选项。" 6285"构建 B<dpkg> 所用的体系结构（即 B<--print-architecture> 的输出）会一直留在该" 6286"体系结构列表中。" 6287 6288#. type: TP 6289#: dpkg.man 6290#, no-wrap 6291msgid "B<--print-architecture>" 6292msgstr "B<--print-architecture>" 6293 6294#. type: Plain text 6295#: dpkg.man 6296#, fuzzy 6297#| msgid "" 6298#| "Print architecture of packages B<dpkg> installs (for example, \"i386\")." 6299msgid "Print architecture of packages B<dpkg> installs (for example, “i386”)." 6300msgstr "打印 B<dpkg> 安装的软件包的体系结构（比如 \"i386\"）。" 6301 6302#. type: TP 6303#: dpkg.man 6304#, no-wrap 6305msgid "B<--print-foreign-architectures>" 6306msgstr "B<--print-foreign-architectures>" 6307 6308#. type: Plain text 6309#: dpkg.man 6310#, fuzzy 6311#| msgid "" 6312#| "Print a newline-separated list of the extra architectures B<dpkg> is " 6313#| "configured to allow packages to be installed for." 6314msgid "" 6315"Print a newline-separated list of the extra architectures B<dpkg> is " 6316"configured to allow packages to be installed for (since dpkg 1.16.2)." 6317msgstr "打印 B<dpkg> 配置为可以安装的额外体系结构列表，该表以换行符分隔。" 6318 6319#. type: TP 6320#: dpkg.man 6321#, no-wrap 6322msgid "B<--assert->I<feature>" 6323msgstr "" 6324 6325#. type: Plain text 6326#: dpkg.man 6327msgid "" 6328"Asserts that B<dpkg> supports the requested feature. Returns 0 if the " 6329"feature is fully supported, 1 if the feature is known but B<dpkg> cannot " 6330"provide support for it yet, and 2 if the feature is unknown. The current " 6331"list of assertable features is:" 6332msgstr "" 6333 6334#. type: TP 6335#: dpkg.man 6336#, no-wrap 6337msgid "B<support-predepends>" 6338msgstr "" 6339 6340#. type: Plain text 6341#: dpkg.man 6342msgid "Supports the B<Pre-Depends> field (since dpkg 1.1.0)." 6343msgstr "" 6344 6345#. type: TP 6346#: dpkg.man 6347#, no-wrap 6348msgid "B<working-epoch>" 6349msgstr "" 6350 6351#. type: Plain text 6352#: dpkg.man 6353msgid "Supports epochs in version strings (since dpkg 1.4.0.7)." 6354msgstr "" 6355 6356#. type: TP 6357#: dpkg.man 6358#, fuzzy, no-wrap 6359#| msgid "B<config-files>" 6360msgid "B<long-filenames>" 6361msgstr "B<config-files>" 6362 6363#. type: Plain text 6364#: dpkg.man 6365msgid "Supports long filenames in B<deb>(5) archives (since dpkg 1.4.1.17)." 6366msgstr "" 6367 6368#. type: TP 6369#: dpkg.man 6370#, fuzzy, no-wrap 6371#| msgid "B<half-configured>" 6372msgid "B<multi-conrep>" 6373msgstr "B<half-configured>" 6374 6375#. type: Plain text 6376#: dpkg.man 6377msgid "Supports multiple B<Conflicts> and B<Replaces> (since dpkg 1.4.1.19)." 6378msgstr "" 6379 6380#. type: TP 6381#: dpkg.man 6382#, no-wrap 6383msgid "B<multi-arch>" 6384msgstr "" 6385 6386#. type: Plain text 6387#: dpkg.man 6388msgid "Supports multi-arch fields and semantics (since dpkg 1.16.2)." 6389msgstr "" 6390 6391#. type: TP 6392#: dpkg.man 6393#, fuzzy, no-wrap 6394#| msgid "B<--version>" 6395msgid "B<versioned-provides>" 6396msgstr "B<--version>" 6397 6398#. type: Plain text 6399#: dpkg.man 6400msgid "Supports versioned B<Provides> (since dpkg 1.17.11)." 6401msgstr "" 6402 6403#. type: TP 6404#: dpkg.man 6405#, fuzzy, no-wrap 6406#| msgid "B<--force-help>" 6407msgid "B<--validate->I<thing string>" 6408msgstr "B<--force-help>" 6409 6410#. type: Plain text 6411#: dpkg.man 6412msgid "" 6413"Validate that the I<thing> I<string> has a correct syntax (since dpkg " 6414"1.18.16). Returns 0 if the I<string> is valid, 1 if the I<string> is " 6415"invalid but might be accepted in lax contexts, and 2 if the I<string> is " 6416"invalid. The current list of validatable I<thing>s is:" 6417msgstr "" 6418 6419#. type: TP 6420#: dpkg.man 6421#, no-wrap 6422msgid "B<pkgname>" 6423msgstr "" 6424 6425#. type: Plain text 6426#: dpkg.man 6427#, fuzzy 6428#| msgid "B<bad-version>: Process even packages with wrong versions." 6429msgid "Validates the given package name (since dpkg 1.18.16)." 6430msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 6431 6432#. type: TP 6433#: dpkg.man 6434#, fuzzy, no-wrap 6435#| msgid "B<triggers-awaited>" 6436msgid "B<trigname>" 6437msgstr "B<triggers-awaited>" 6438 6439#. type: Plain text 6440#: dpkg.man 6441#, fuzzy 6442#| msgid "B<bad-version>: Process even packages with wrong versions." 6443msgid "Validates the given trigger name (since dpkg 1.18.16)." 6444msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 6445 6446#. type: TP 6447#: dpkg.man 6448#, fuzzy, no-wrap 6449#| msgid "B<triggers-awaited>" 6450msgid "B<archname>" 6451msgstr "B<triggers-awaited>" 6452 6453#. type: Plain text 6454#: dpkg.man 6455#, fuzzy 6456#| msgid "B<bad-version>: Process even packages with wrong versions." 6457msgid "Validates the given architecture name (since dpkg 1.18.16)." 6458msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 6459 6460#. type: TP 6461#: dpkg.man 6462#, fuzzy, no-wrap 6463#| msgid "B<--version>" 6464msgid "B<version>" 6465msgstr "B<--version>" 6466 6467#. type: Plain text 6468#: dpkg.man 6469#, fuzzy 6470#| msgid "B<bad-version>: Process even packages with wrong versions." 6471msgid "Validates the given version (since dpkg 1.18.16)." 6472msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 6473 6474#. type: TP 6475#: dpkg.man 6476#, no-wrap 6477msgid "B<--compare-versions >I<ver1 op ver2>" 6478msgstr "B<--compare-versions >I<ver1 op ver2>" 6479 6480#. .TP 6481#. .B \-\-command\-fd \fIn\fP 6482#. Accept a series of commands on input file descriptor \fIn\fP. Note: 6483#. additional options set on the command line, and through this file descriptor, 6484#. are not reset for subsequent commands executed during the same run. 6485#. type: Plain text 6486#: dpkg.man 6487#, fuzzy 6488#| msgid "" 6489#| "Compare version numbers, where I<op> is a binary operator. B<dpkg> " 6490#| "returns success (zero result) if the specified condition is satisfied, " 6491#| "and failure (nonzero result) otherwise. There are two groups of " 6492#| "operators, which differ in how they treat an empty I<ver1> or I<ver2>. " 6493#| "These treat an empty version as earlier than any version: B<lt le eq ne " 6494#| "ge gt>. These treat an empty version as later than any version: B<lt-nl " 6495#| "le-nl ge-nl gt-nl>. These are provided only for compatibility with " 6496#| "control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>." 6497msgid "" 6498"Compare version numbers, where I<op> is a binary operator. B<dpkg> returns " 6499"true (B<0>) if the specified condition is satisfied, and false (B<1>) " 6500"otherwise. There are two groups of operators, which differ in how they treat " 6501"an empty I<ver1> or I<ver2>. These treat an empty version as earlier than " 6502"any version: B<lt le eq ne ge gt>. These treat an empty version as later " 6503"than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for " 6504"compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= " 6505"E<gt>E<gt> E<gt>>. The B<E<lt>> and B<E<gt>> operators are obsolete and " 6506"should B<not> be used, due to confusing semantics. To illustrate: B<0.1 " 6507"E<lt> 0.1> evaluates to true." 6508msgstr "" 6509"比较版本号，其中 I<op> 是二元运算符。如果满足给定条件，那么 B<dpkg> 将返回成" 6510"功（结果为0），否则（结果非0）返回失败。可用的算符有两组，它们的区别在于对空" 6511"白的 I<ver1> 和 I<ver2> 的反应。这些算符认定空白版本早于任何版本：B<lt-nl le-" 6512"nl ge-nl gt-nl>。这些算符仅为兼容控制文件语法：B<E<lt> E<lt>E<lt> E<lt>= = " 6513"E<gt>= E<gt>E<gt> E<gt>>。" 6514 6515#. type: TP 6516#: dpkg.man dpkg-architecture.man dpkg-buildpackage.man dpkg-genbuildinfo.man 6517#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 6518#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man dpkg-name.man 6519#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 6520#: dpkg-shlibdeps.man dpkg-source.man dpkg-split.man dpkg-trigger.man 6521#: dselect.man 6522#, no-wrap 6523msgid "B<-?>, B<--help>" 6524msgstr "B<-?>, B<--help>" 6525 6526#. type: Plain text 6527#: dpkg.man 6528msgid "Display a brief help message." 6529msgstr "显示简短的帮助信息。" 6530 6531#. type: TP 6532#: dpkg.man dpkg-statoverride.man 6533#, no-wrap 6534msgid "B<--force-help>" 6535msgstr "B<--force-help>" 6536 6537#. type: Plain text 6538#: dpkg.man 6539msgid "Give help about the B<--force->I<thing> options." 6540msgstr "显示有关 B<--force->I<thing> 选项的帮助。" 6541 6542#. type: TP 6543#: dpkg.man 6544#, no-wrap 6545msgid "B<-Dh>, B<--debug=help>" 6546msgstr "B<-Dh>, B<--debug=help>" 6547 6548#. type: Plain text 6549#: dpkg.man 6550msgid "Give help about debugging options." 6551msgstr "显示关于调试选项的帮助信息。" 6552 6553#. type: TP 6554#: dpkg.man dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 6555#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 6556#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 6557#: dpkg-gensymbols.man dpkg-mergechangelogs.man dpkg-parsechangelog.man 6558#: dpkg-query.man dpkg-scanpackages.man dpkg-scansources.man dpkg-shlibdeps.man 6559#: dpkg-source.man dpkg-split.man dpkg-statoverride.man dpkg-trigger.man 6560#: dpkg-vendor.man dselect.man update-alternatives.man 6561#, no-wrap 6562msgid "B<--version>" 6563msgstr "B<--version>" 6564 6565#. type: Plain text 6566#: dpkg.man 6567msgid "Display B<dpkg> version information." 6568msgstr "显示 B<dpkg> 版本信息。" 6569 6570#. type: TP 6571#: dpkg.man 6572#, no-wrap 6573msgid "B<dpkg-deb actions>" 6574msgstr "B<dpkg-deb 行为>" 6575 6576#. type: Plain text 6577#: dpkg.man 6578msgid "See B<dpkg-deb>(1) for more information about the following actions." 6579msgstr "有关下列行为的细节，请参见 B<dpkg-dev>(1)。" 6580 6581#. type: Plain text 6582#: dpkg.man 6583#, fuzzy, no-wrap 6584#| msgid "" 6585#| "B<-b>, B<--build> I<directory> [I<archive>|I<directory>]\n" 6586#| " Build a deb package.\n" 6587#| "B<-c>, B<--contents> I<archive>\n" 6588#| " List contents of a deb package.\n" 6589#| "B<-e>, B<--control> I<filename> [I<directory>]\n" 6590#| " Extract control-information from a package.\n" 6591#| "B<-x>, B<--extract> I<archive directory>\n" 6592#| " Extract the files contained by package.\n" 6593#| "B<-X>, B<--vextract> I<archive directory>\n" 6594#| " Extract and display the filenames contained by a\n" 6595#| " package.\n" 6596#| "B<-f>, B<--field> I<archive> [I<control-field>...]\n" 6597#| " Display control field(s) of a package.\n" 6598#| "B<--fsys-tarfile> I<archive>\n" 6599#| " Display the filesystem tar-file contained by a\n" 6600#| " Debian package.\n" 6601#| "B<-I>, B<--info> I<archive> [I<control-file>...]\n" 6602#| " Show information about a package.\n" 6603msgid "" 6604"B<-b>, B<--build> I<directory> [I<archive>|I<directory>]\n" 6605" Build a deb package.\n" 6606"B<-c>, B<--contents> I<archive>\n" 6607" List contents of a deb package.\n" 6608"B<-e>, B<--control> I<archive> [I<directory>]\n" 6609" Extract control-information from a package.\n" 6610"B<-x>, B<--extract> I<archive directory>\n" 6611" Extract the files contained by package.\n" 6612"B<-X>, B<--vextract> I<archive directory>\n" 6613" Extract and display the filenames contained by a\n" 6614" package.\n" 6615"B<-f>, B<--field> I<archive> [I<control-field>...]\n" 6616" Display control field(s) of a package.\n" 6617"B<--ctrl-tarfile> I<archive>\n" 6618" Output the control tar-file contained in a Debian package.\n" 6619"B<--fsys-tarfile> I<archive>\n" 6620" Output the filesystem tar-file contained by a Debian package.\n" 6621"B<-I>, B<--info> I<archive> [I<control-file>...]\n" 6622" Show information about a package.\n" 6623msgstr "" 6624"B<-b>, B<--build> I<directory> [I<archive>|I<directory>]\n" 6625" 构建 deb 软件包。\n" 6626"B<-c>, B<--contents> I<archive>\n" 6627" 列出 deb 包的内容。\n" 6628"B<-e>, B<--control> I<filename> [I<directory>]\n" 6629" 抽取包中的控制信息。\n" 6630"B<-x>, B<--extract> I<archive directory>\n" 6631" 抽取包中的文件。\n" 6632"B<-X>, B<--vextract> I<archive directory>\n" 6633" 抽取包中文件并显示文件名。\n" 6634"B<-f>, B<--field> I<archive> [I<control-field>...]\n" 6635" 显示包中的控制字段。\n" 6636"B<--fsys-tarfile> I<archive>\n" 6637" 显示 Debian 包中的文件系统 tar 文件。\n" 6638"B<-I>, B<--info> I<archive> [I<control-file>...]\n" 6639" 显示软件包信息。\n" 6640 6641#. type: TP 6642#: dpkg.man 6643#, no-wrap 6644msgid "B<dpkg-query actions>" 6645msgstr "B<dpkg-query actions>" 6646 6647#. type: Plain text 6648#: dpkg.man 6649msgid "See B<dpkg-query>(1) for more information about the following actions." 6650msgstr "有关下列行为的细节，请参见 B<dpkg-query>(1)。" 6651 6652#. type: Plain text 6653#: dpkg.man 6654#, no-wrap 6655msgid "" 6656"B<-l>, B<--list> I<package-name-pattern>...\n" 6657" List packages matching given pattern.\n" 6658"B<-s>, B<--status> I<package-name>...\n" 6659" Report status of specified package.\n" 6660"B<-L>, B<--listfiles> I<package-name>...\n" 6661" List files installed to your system from I<package-name>.\n" 6662"B<-S>, B<--search> I<filename-search-pattern>...\n" 6663" Search for a filename from installed packages.\n" 6664"B<-p>, B<--print-avail> I<package-name>...\n" 6665" Display details about I<package-name>, as found in\n" 6666" I<%ADMINDIR%/available>. Users of APT-based frontends\n" 6667" should use B<apt-cache show> I<package-name> instead.\n" 6668msgstr "" 6669"B<-l>, B<--list> I<package-name-pattern>...\n" 6670" 列出匹配给定模式的包。\n" 6671"B<-s>, B<--status> I<package-name>...\n" 6672" 报告指定包的状态。\n" 6673"B<-L>, B<--listfiles> I<package-name>...\n" 6674" 列出由包 I<package-name> 安装到系统中的文件。\n" 6675"B<-S>, B<--search> I<filename-search-pattern>...\n" 6676" 在已安装的包中搜索文件名。\n" 6677"B<-p>, B<--print-avail> I<package-name>...\n" 6678" 根据 I<%ADMINDIR%/available> 中找到的信息，\n" 6679" 显示关于 I<package-name> 的详情。而使用基于 APT 的前端\n" 6680" 的用户应使用 B<apt-cache show> I<package-name> 。\n" 6681 6682#. type: SH 6683#: dpkg.man dpkg-architecture.man dpkg-buildpackage.man dpkg-genbuildinfo.man 6684#: dpkg-checkbuilddeps.man dpkg-distaddfile.man dpkg-deb.man dpkg-divert.man 6685#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 6686#: dpkg-mergechangelogs.man dpkg-name.man dpkg-parsechangelog.man 6687#: dpkg-query.man dpkg-scanpackages.man dpkg-scansources.man dpkg-shlibdeps.man 6688#: dpkg-source.man dpkg-split.man dpkg-statoverride.man dpkg-trigger.man 6689#: dpkg-vendor.man dselect.man start-stop-daemon.man update-alternatives.man 6690#, no-wrap 6691msgid "OPTIONS" 6692msgstr "选项" 6693 6694#. type: Plain text 6695#: dpkg.man 6696#, fuzzy 6697#| msgid "" 6698#| "All options can be specified both on the command line and in the B<dpkg> " 6699#| "configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names " 6700#| "matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration " 6701#| "directory I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration " 6702#| "file is either an option (exactly the same as the command line option but " 6703#| "without leading hyphens) or a comment (if it starts with a B<#>)." 6704msgid "" 6705"All options can be specified both on the command line and in the B<dpkg> " 6706"configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names " 6707"matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration directory " 6708"I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration file is either " 6709"an option (exactly the same as the command line option but without leading " 6710"hyphens) or a comment (if it starts with a ‘B<#>’)." 6711msgstr "" 6712"所有选项都可以在命令行中或者在 B<dpkg> 配置文件 I<%PKGCONFDIR%/dpkg.cfg> 中指" 6713"定，在配置目录 I<%PKGCONFDIR%/dpkg.cfg.d/> 里的零碎文件中指定也可（零碎文件需" 6714"要匹配 shell 模式 '[0-9a-zA-Z_-]*'）。配置文件中的每一行可以是选项（与命令行" 6715"选项一致，但无需连字符）也可以是注释（以 B<#> 开头）。" 6716 6717#. type: TP 6718#: dpkg.man 6719#, no-wrap 6720msgid "B<--abort-after=>I<number>" 6721msgstr "B<--abort-after=>I<number>" 6722 6723#. type: Plain text 6724#: dpkg.man 6725msgid "Change after how many errors B<dpkg> will abort. The default is 50." 6726msgstr "修改累计错误容忍上限（超过该值则中止），该值默认为50。" 6727 6728#. type: TP 6729#: dpkg.man 6730#, no-wrap 6731msgid "B<-B>, B<--auto-deconfigure>" 6732msgstr "B<-B>, B<--auto-deconfigure>" 6733 6734#. type: Plain text 6735#: dpkg.man 6736msgid "" 6737"When a package is removed, there is a possibility that another installed " 6738"package depended on the removed package. Specifying this option will cause " 6739"automatic deconfiguration of the package which depended on the removed " 6740"package." 6741msgstr "" 6742"当要移除一个软件包的时候，有可能有别的软件包依赖于这个包。指定该选项将导致依" 6743"赖这个包的软件包被自动反配置。" 6744 6745#. type: TP 6746#: dpkg.man 6747#, no-wrap 6748msgid "B<-D>I<octal>B<, --debug=>I<octal>" 6749msgstr "B<-D>I<octal>B<, --debug=>I<octal>" 6750 6751#. type: Plain text 6752#: dpkg.man 6753msgid "" 6754"Switch debugging on. I<octal> is formed by bitwise-oring desired values " 6755"together from the list below (note that these values may change in future " 6756"releases). B<-Dh> or B<--debug=help> display these debugging values." 6757msgstr "" 6758 6759#. type: Plain text 6760#: dpkg.man 6761#, no-wrap 6762msgid "" 6763" Number Description\n" 6764" 1 Generally helpful progress information\n" 6765" 2 Invocation and status of maintainer scripts\n" 6766" 10 Output for each file processed\n" 6767" 100 Lots of output for each file processed\n" 6768" 20 Output for each configuration file\n" 6769" 200 Lots of output for each configuration file\n" 6770" 40 Dependencies and conflicts\n" 6771" 400 Lots of dependencies/conflicts output\n" 6772" 10000 Trigger activation and processing\n" 6773" 20000 Lots of output regarding triggers\n" 6774" 40000 Silly amounts of output regarding triggers\n" 6775" 1000 Lots of drivel about e.g. the dpkg/info dir\n" 6776" 2000 Insane amounts of drivel\n" 6777msgstr "" 6778" 数字 描述\n" 6779" 1 一般有用的进度信息\n" 6780" 2 维护者脚本的调用和状态\n" 6781" 10 每当处理文件都输出\n" 6782" 100 每当处理文件都大量输出\n" 6783" 20 每当处理配置文件都输出\n" 6784" 200 每当处理配置文件都大量输出\n" 6785" 40 依赖关系和冲突\n" 6786" 400 依赖关系和冲突的大量输出\n" 6787" 10000 触发器激活和处理\n" 6788" 20000 大量关于触发器的输出\n" 6789" 40000 海量关于触发器的输出\n" 6790" 1000 很多废话，比如 dpkg/info dir\n" 6791" 2000 数量惊世骇俗的废话\n" 6792 6793#. type: TP 6794#: dpkg.man dpkg-statoverride.man 6795#, fuzzy, no-wrap 6796#| msgid "B<--force-help>" 6797msgid "B<--force->I<things>" 6798msgstr "B<--force-help>" 6799 6800#. type: TQ 6801#: dpkg.man dpkg-statoverride.man 6802#, fuzzy, no-wrap 6803#| msgid "B<--force->I<things>, B<--no-force->I<things>, B<--refuse->I<things>" 6804msgid "B<--no-force->I<things>, B<--refuse->I<things>" 6805msgstr "B<--force->I<things>, B<--no-force->I<things>, B<--refuse->I<things>" 6806 6807#. type: Plain text 6808#: dpkg.man 6809msgid "" 6810"Force or refuse (B<no-force> and B<refuse> mean the same thing) to do some " 6811"things. I<things> is a comma separated list of things specified below. B<--" 6812"force-help> displays a message describing them. Things marked with (*) are " 6813"forced by default." 6814msgstr "" 6815"强制或拒绝做某事（B<no-force> 和 B<refuse> 所指相同）。I<things> 是一个逗号分" 6816"隔的事件表，具体事件请参见下文。B<--force-help> 会给出相应的帮助信息。另外，" 6817"标记了（*）的事件是默认选择强制的。" 6818 6819#. type: Plain text 6820#: dpkg.man 6821msgid "" 6822"I<Warning: These options are mostly intended to be used by experts only. " 6823"Using them without fully understanding their effects may break your whole " 6824"system.>" 6825msgstr "" 6826"I<警告: 这些选项大多数是提供给专家用户使用的。在没有完全理解它们的效果的情况" 6827"下使用，很可能会破坏您的整个系统。>" 6828 6829#. type: Plain text 6830#: dpkg.man dpkg-statoverride.man 6831msgid "B<all>: Turns on (or off) all force options." 6832msgstr "B<all>: 强制选项全开（或全关）。" 6833 6834#. type: Plain text 6835#: dpkg.man 6836msgid "" 6837"B<downgrade>(*): Install a package, even if newer version of it is already " 6838"installed." 6839msgstr "B<downgrage>(*): 即使一个包的新版本已被安装，也继续安装该包。" 6840 6841#. type: Plain text 6842#: dpkg.man 6843msgid "" 6844"I<Warning: At present >B<dpkg>I< does not do any dependency checking on " 6845"downgrades and therefore will not warn you if the downgrade breaks the " 6846"dependency of some other package. This can have serious side effects, " 6847"downgrading essential system components can even make your whole system " 6848"unusable. Use with care.>" 6849msgstr "" 6850 6851#. type: Plain text 6852#: dpkg.man 6853msgid "" 6854"B<configure-any>: Configure also any unpacked but unconfigured packages on " 6855"which the current package depends." 6856msgstr "" 6857 6858#. type: Plain text 6859#: dpkg.man 6860#, fuzzy 6861#| msgid "B<hold>: Process packages even when marked \"hold\"." 6862msgid "B<hold>: Process packages even when marked “hold”." 6863msgstr "B<bold>: 连同标记了 “hold” 的软件包一并处理。" 6864 6865#. type: Plain text 6866#: dpkg.man 6867msgid "" 6868"B<remove-reinstreq>: Remove a package, even if it's broken and marked to " 6869"require reinstallation. This may, for example, cause parts of the package to " 6870"remain on the system, which will then be forgotten by B<dpkg>." 6871msgstr "" 6872 6873#. type: Plain text 6874#: dpkg.man 6875msgid "" 6876"B<remove-essential>: Remove, even if the package is considered essential. " 6877"Essential packages contain mostly very basic Unix commands. Removing them " 6878"might cause the whole system to stop working, so use with caution." 6879msgstr "" 6880 6881#. type: Plain text 6882#: dpkg.man 6883#, fuzzy 6884#| msgid "B<depends>: Turn all dependency problems into warnings." 6885msgid "" 6886"B<depends>: Turn all dependency problems into warnings. This affects the " 6887"B<Pre-Depends> and B<Depends> fields." 6888msgstr "B<depends>: 将所有依赖问题转为警告。" 6889 6890#. type: Plain text 6891#: dpkg.man 6892#, fuzzy 6893#| msgid "" 6894#| "B<depends-version>: Don't care about versions when checking dependencies." 6895msgid "" 6896"B<depends-version>: Don't care about versions when checking dependencies. " 6897"This affects the B<Pre-Depends> and B<Depends> fields." 6898msgstr "B<depends-version>: 检查依赖关系时忽略版本。" 6899 6900#. type: Plain text 6901#: dpkg.man 6902#, fuzzy 6903#| msgid "B<breaks>: Install, even if this would break another package." 6904msgid "" 6905"B<breaks>: Install, even if this would break another package (since dpkg " 6906"1.14.6). This affects the B<Breaks> field." 6907msgstr "B<breaks>: 即使会破坏别的软件包也坚持安装。" 6908 6909#. type: Plain text 6910#: dpkg.man 6911#, fuzzy 6912#| msgid "" 6913#| "B<conflicts>: Install, even if it conflicts with another package. This is " 6914#| "dangerous, for it will usually cause overwriting of some files." 6915msgid "" 6916"B<conflicts>: Install, even if it conflicts with another package. This is " 6917"dangerous, for it will usually cause overwriting of some files. This " 6918"affects the B<Conflicts> field." 6919msgstr "" 6920"B<conflicts>: 即使与别的软件包冲突也坚持安装。不过这很危险，因为很有可能会导" 6921"致一些文件被覆盖。" 6922 6923#. type: Plain text 6924#: dpkg.man 6925#, fuzzy 6926#| msgid "" 6927#| "B<confmiss>: If a conffile is missing and the version in the package did " 6928#| "change, always install the missing conffile without prompting. This is " 6929#| "dangerous, since it means not preserving a change (removing) made to the " 6930#| "file." 6931msgid "" 6932"B<confmiss>: Always install the missing conffile without prompting. This is " 6933"dangerous, since it means not preserving a change (removing) made to the " 6934"file." 6935msgstr "" 6936"B<confmiss>: 在 conffile 丢失并且软件包版本有过变动的情况下，那么总是在不提示" 6937"的情况下安装丢失的 conffile 。注意这很危险，毕竟这意味着对文件作出的更改将不" 6938"被保留。" 6939 6940#. type: Plain text 6941#: dpkg.man 6942msgid "" 6943"B<confnew>: If a conffile has been modified and the version in the package " 6944"did change, always install the new version without prompting, unless the B<--" 6945"force-confdef> is also specified, in which case the default action is " 6946"preferred." 6947msgstr "" 6948"B<confnew>: 在 conffile 和软件包版本均发生变动的情况下，总是在不提示的情况下" 6949"安装新版本。如果偏好默认行为的话，除非同时指定 B<--force-confdef> 选项。" 6950 6951#. type: Plain text 6952#: dpkg.man 6953msgid "" 6954"B<confold>: If a conffile has been modified and the version in the package " 6955"did change, always keep the old version without prompting, unless the B<--" 6956"force-confdef> is also specified, in which case the default action is " 6957"preferred." 6958msgstr "" 6959"B<confnew>: 在 conffile 和软件包版本均发生变动的情况下，总是在不提示的情况下" 6960"保留旧版本。如果偏好默认行为的话，除非同时指定 B<--force-confdef> 选项。" 6961 6962#. type: Plain text 6963#: dpkg.man 6964msgid "" 6965"B<confdef>: If a conffile has been modified and the version in the package " 6966"did change, always choose the default action without prompting. If there is " 6967"no default action it will stop to ask the user unless B<--force-confnew> or " 6968"B<--force-confold> is also been given, in which case it will use that to " 6969"decide the final action." 6970msgstr "" 6971"B<confdef>: 在 conffile 和软件包版本均变动的情况下，总是选择默认行为并且不提" 6972"示。如果没有默认行为，那么它将停下来询问用户。除非指定 B<--force-confnew> 或 " 6973"B<--force-confold> 选项，此时它会根据指定的选项来最终决策。" 6974 6975#. type: Plain text 6976#: dpkg.man 6977#, fuzzy 6978#| msgid "" 6979#| "B<confask>: If a conffile has been modified always offer to replace it " 6980#| "with the version in the package, even if the version in the package did " 6981#| "not change. If any of B<--force-confmiss>, B<--force-confnew>, B<--force-" 6982#| "confold>, or B<--force-confdef> is also given, it will be used to decide " 6983#| "the final action." 6984msgid "" 6985"B<confask>: If a conffile has been modified always offer to replace it with " 6986"the version in the package, even if the version in the package did not " 6987"change (since dpkg 1.15.8). If any of B<--force-confnew>, B<--force-" 6988"confold>, or B<--force-confdef> is also given, it will be used to decide the " 6989"final action." 6990msgstr "" 6991"B<confask>: 在 confffile 被更改的情况下，即使软件包里的版本不改变，也用包里的" 6992"文件进行替换。如果在 B<--force-confmiss>, B<--force-confnew>, B<--force-" 6993"confold>, 或 B<--force-confdef> 四个选项中有任意一个被同时指定，那么它会根据" 6994"选项进行最终决策。" 6995 6996#. type: Plain text 6997#: dpkg.man 6998msgid "B<overwrite>: Overwrite one package's file with another's file." 6999msgstr "B<overwrite>: 将其他软件包的文件覆盖到一个软件包上。" 7000 7001#. type: Plain text 7002#: dpkg.man 7003#, fuzzy 7004#| msgid "" 7005#| "B<overwrite-dir> Overwrite one package's directory with another's file." 7006msgid "" 7007"B<overwrite-dir>: Overwrite one package's directory with another's file." 7008msgstr "B<overwrite-dir> 将其他包的文件覆盖到一个软件包目录上。" 7009 7010#. type: Plain text 7011#: dpkg.man 7012msgid "" 7013"B<overwrite-diverted>: Overwrite a diverted file with an undiverted version." 7014msgstr "B<overwrite-diverted>: 将转移后的文件以未转移版本覆盖。" 7015 7016#. type: Plain text 7017#: dpkg.man dpkg-statoverride.man 7018msgid "" 7019"B<statoverride-add>: Overwrite an existing stat override when adding it " 7020"(since dpkg 1.19.5)." 7021msgstr "" 7022 7023#. type: Plain text 7024#: dpkg.man dpkg-statoverride.man 7025msgid "" 7026"B<statoverride-remove>: Ignore a missing stat override when removing it " 7027"(since dpkg 1.19.5)." 7028msgstr "" 7029 7030#. type: Plain text 7031#: dpkg.man dpkg-statoverride.man 7032msgid "" 7033"B<security-mac>(*): Use platform-specific Mandatory Access Controls (MAC) " 7034"based security when installing files into the filesystem (since dpkg " 7035"1.19.5). On Linux systems the implementation uses SELinux." 7036msgstr "" 7037 7038#. type: Plain text 7039#: dpkg.man 7040msgid "" 7041"B<unsafe-io>: Do not perform safe I/O operations when unpacking (since dpkg " 7042"1.15.8.6). Currently this implies not performing file system syncs before " 7043"file renames, which is known to cause substantial performance degradation on " 7044"some file systems, unfortunately the ones that require the safe I/O on the " 7045"first place due to their unreliable behaviour causing zero-length files on " 7046"abrupt system crashes." 7047msgstr "" 7048 7049#. type: Plain text 7050#: dpkg.man 7051msgid "" 7052"I<Note>: For ext4, the main offender, consider using instead the mount " 7053"option B<nodelalloc>, which will fix both the performance degradation and " 7054"the data safety issues, the latter by making the file system not produce " 7055"zero-length files on abrupt system crashes with any software not doing syncs " 7056"before atomic renames." 7057msgstr "" 7058 7059#. type: Plain text 7060#: dpkg.man 7061msgid "" 7062"I<Warning: Using this option might improve performance at the cost of losing " 7063"data, use with care.>" 7064msgstr "" 7065 7066#. type: Plain text 7067#: dpkg.man 7068msgid "" 7069"B<script-chrootless>: Run maintainer scripts without B<chroot>(2)ing into " 7070"B<instdir> even if the package does not support this mode of operation " 7071"(since dpkg 1.18.5)." 7072msgstr "" 7073 7074#. type: Plain text 7075#: dpkg.man 7076msgid "I<Warning: This can destroy your host system, use with extreme care.>" 7077msgstr "" 7078 7079#. type: Plain text 7080#: dpkg.man 7081msgid "B<architecture>: Process even packages with wrong or no architecture." 7082msgstr "B<architecture>: 容忍软件包错误或缺省的体系结构并继续。" 7083 7084#. type: Plain text 7085#: dpkg.man 7086#, fuzzy 7087#| msgid "B<bad-version>: Process even packages with wrong versions." 7088msgid "" 7089"B<bad-version>: Process even packages with wrong versions (since dpkg " 7090"1.16.1)." 7091msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 7092 7093#. type: Plain text 7094#: dpkg.man 7095msgid "" 7096"B<bad-path>: B<PATH> is missing important programs, so problems are likely." 7097msgstr "B<bad-path>: 在 B<PATH> 下无法找到重要的程序，这可能是出问题的原因" 7098 7099#. type: Plain text 7100#: dpkg.man 7101msgid "B<not-root>: Try to (de)install things even when not root." 7102msgstr "B<not-root>: 在非 root 时尝试（反）安装软件。" 7103 7104#. type: Plain text 7105#: dpkg.man 7106msgid "B<bad-verify>: Install a package even if it fails authenticity check." 7107msgstr "B<bad-verify>: 容忍失败的真实性检查并安装。" 7108 7109#. type: TP 7110#: dpkg.man 7111#, no-wrap 7112msgid "B<--ignore-depends>=I<package>,..." 7113msgstr "B<--ignore-depends>=I<package>,..." 7114 7115#. type: Plain text 7116#: dpkg.man 7117#, fuzzy 7118#| msgid "" 7119#| "Ignore dependency-checking for specified packages (actually, checking is " 7120#| "performed, but only warnings about conflicts are given, nothing else)." 7121msgid "" 7122"Ignore dependency-checking for specified packages (actually, checking is " 7123"performed, but only warnings about conflicts are given, nothing else). This " 7124"affects the B<Pre-Depends>, B<Depends> and B<Breaks> fields." 7125msgstr "" 7126"忽略对指定软件包的依赖检查（实际上进行了检查，只是当且仅当发生冲突时才会发出" 7127"警告）。" 7128 7129#. type: TP 7130#: dpkg.man 7131#, no-wrap 7132msgid "B<--no-act>, B<--dry-run>, B<--simulate>" 7133msgstr "B<--no-act>, B<--dry-run>, B<--simulate>" 7134 7135#. type: Plain text 7136#: dpkg.man 7137msgid "" 7138"Do everything which is supposed to be done, but don't write any changes. " 7139"This is used to see what would happen with the specified action, without " 7140"actually modifying anything." 7141msgstr "" 7142"进行所有预期的操作，但是不进行任何写入。该选的意图是，在不进行任何修改的情况" 7143"下观察软件根据指定的行为做了什么。" 7144 7145#. type: Plain text 7146#: dpkg.man 7147msgid "" 7148"Be sure to give B<--no-act> before the action-parameter, or you might end up " 7149"with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first " 7150"purge package foo and then try to purge package --no-act, even though you " 7151"probably expected it to actually do nothing)" 7152msgstr "" 7153 7154#. type: TP 7155#: dpkg.man 7156#, no-wrap 7157msgid "B<-R>, B<--recursive>" 7158msgstr "B<-R>, B<--recursive>" 7159 7160#. type: Plain text 7161#: dpkg.man 7162msgid "" 7163"Recursively handle all regular files matching pattern B<*.deb> found at " 7164"specified directories and all of its subdirectories. This can be used with " 7165"B<-i>, B<-A>, B<--install>, B<--unpack> and B<--record-avail> actions." 7166msgstr "" 7167 7168#. type: TP 7169#: dpkg.man dpkg-buildpackage.man dpkg-genchanges.man 7170#, no-wrap 7171msgid "B<-G>" 7172msgstr "B<-G>" 7173 7174#. type: Plain text 7175#: dpkg.man 7176msgid "" 7177"Don't install a package if a newer version of the same package is already " 7178"installed. This is an alias of B<--refuse-downgrade>." 7179msgstr "" 7180"如果已经安装了该软件包的更新版本，那就不安装该软件。（译者注：即拒绝降级）这" 7181"也是 B<--refuse-downgrade> 选项的别名。" 7182 7183#. type: TP 7184#: dpkg.man dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-checkbuilddeps.man 7185#: dpkg-query.man dpkg-shlibdeps.man dpkg-trigger.man 7186#, no-wrap 7187msgid "B<--admindir=>I<dir>" 7188msgstr "B<--admindir=>I<dir>" 7189 7190#. type: Plain text 7191#: dpkg.man 7192#, fuzzy 7193#| msgid "" 7194#| "Change default administrative directory, which contains many files that " 7195#| "give information about status of installed or uninstalled packages, etc. " 7196#| "(Defaults to I<%ADMINDIR%>)" 7197msgid "" 7198"Set the administrative directory to I<directory>. This directory contains " 7199"many files that give information about status of installed or uninstalled " 7200"packages, etc. Defaults to «I<%ADMINDIR%>»." 7201msgstr "" 7202"变更默认管理目录，这个目录包含着许多已安装和未安装软件包的状态记录文件等。" 7203"（默认为 I<%ADMINDIR%>）" 7204 7205#. type: TP 7206#: dpkg.man 7207#, no-wrap 7208msgid "B<--instdir=>I<dir>" 7209msgstr "B<--instdir=>I<dir>" 7210 7211#. type: Plain text 7212#: dpkg.man 7213#, fuzzy 7214#| msgid "" 7215#| "Change default installation directory which refers to the directory where " 7216#| "packages are to be installed. B<instdir> is also the directory passed to " 7217#| "B<chroot>(2) before running package's installation scripts, which means " 7218#| "that the scripts see B<instdir> as a root directory. (Defaults to I</>)" 7219msgid "" 7220"Set the installation directory, which refers to the directory where packages " 7221"are to be installed. B<instdir> is also the directory passed to B<chroot>(2) " 7222"before running package's installation scripts, which means that the scripts " 7223"see B<instdir> as a root directory. Defaults to «I</>»." 7224msgstr "" 7225"变更默认的软件包安装目录。在执行软件包的安装脚本之前，目录 B<instdir> 同样会" 7226"传递给 B<chroot>(2)，这意味着那些脚本会视 B<instdir> 为根目录。（默认为 I</" 7227">）" 7228 7229#. type: TP 7230#: dpkg.man 7231#, no-wrap 7232msgid "B<--root=>I<dir>" 7233msgstr "B<--root=>I<dir>" 7234 7235#. type: Plain text 7236#: dpkg.man 7237#, fuzzy 7238#| msgid "" 7239#| "Changing B<root> changes B<instdir> to I<dir> and B<admindir> to I<dir>B</" 7240#| "var/lib/dpkg>." 7241msgid "" 7242"Set the root directory to B<directory>, which sets the installation " 7243"directory to «I<dir>» and the administrative directory to «I<dir>B<%ADMINDIR" 7244"%>»." 7245msgstr "" 7246"对 B<root> 的更改会将 B<instdir> 迁至 I<dir> 并把 B<admindir> 迁至 I<dir>B</" 7247"var/lib/dpkg> 。" 7248 7249#. type: TP 7250#: dpkg.man 7251#, no-wrap 7252msgid "B<-O>, B<--selected-only>" 7253msgstr "B<-O>, B<--selected-only>" 7254 7255#. type: Plain text 7256#: dpkg.man 7257msgid "" 7258"Only process the packages that are selected for installation. The actual " 7259"marking is done with B<dselect> or by B<dpkg>, when it handles packages. For " 7260"example, when a package is removed, it will be marked selected for " 7261"deinstallation." 7262msgstr "" 7263 7264#. type: TP 7265#: dpkg.man 7266#, no-wrap 7267msgid "B<-E>, B<--skip-same-version>" 7268msgstr "B<-E>, B<--skip-same-version>" 7269 7270#. type: Plain text 7271#: dpkg.man 7272msgid "" 7273"Don't install the package if the same version of the package is already " 7274"installed." 7275msgstr "如果有相同版本的软件包已经安装，那就跳过。" 7276 7277#. type: TP 7278#: dpkg.man 7279#, no-wrap 7280msgid "B<--pre-invoke=>I<command>" 7281msgstr "B<--pre-invoke=>I<command>" 7282 7283#. type: TQ 7284#: dpkg.man 7285#, no-wrap 7286msgid "B<--post-invoke=>I<command>" 7287msgstr "B<--post-invoke=>I<command>" 7288 7289#. type: Plain text 7290#: dpkg.man 7291msgid "" 7292"Set an invoke hook I<command> to be run via ``sh -c'' before or after the " 7293"B<dpkg> run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, " 7294"I<remove>, I<purge>, I<add-architecture> and I<remove-architecture> B<dpkg> " 7295"actions (since dpkg 1.15.4; I<add-architecture> and I<remove-architecture> " 7296"actions since dpkg 1.17.19). This option can be specified multiple times. " 7297"The order the options are specified is preserved, with the ones from the " 7298"configuration files taking precedence. The environment variable " 7299"B<DPKG_HOOK_ACTION> is set for the hooks to the current B<dpkg> action. " 7300"Note: front-ends might call B<dpkg> several times per invocation, which " 7301"might run the hooks more times than expected." 7302msgstr "" 7303 7304#. type: TP 7305#: dpkg.man 7306#, no-wrap 7307msgid "B<--path-exclude=>I<glob-pattern>" 7308msgstr "B<--path-exclude=>I<glob-pattern>" 7309 7310#. type: TQ 7311#: dpkg.man 7312#, no-wrap 7313msgid "B<--path-include=>I<glob-pattern>" 7314msgstr "B<--path-include=>I<glob-pattern>" 7315 7316#. type: Plain text 7317#: dpkg.man 7318msgid "" 7319"Set I<glob-pattern> as a path filter, either by excluding or re-including " 7320"previously excluded paths matching the specified patterns during install " 7321"(since dpkg 1.15.8)." 7322msgstr "" 7323 7324#. type: Plain text 7325#: dpkg.man 7326msgid "" 7327"I<Warning: take into account that depending on the excluded paths you might " 7328"completely break your system, use with caution.>" 7329msgstr "" 7330 7331#. type: Plain text 7332#: dpkg.man 7333msgid "" 7334"The glob patterns use the same wildcards used in the shell, were ‘*’ matches " 7335"any sequence of characters, including the empty string and also ‘/’. For " 7336"example, «I</usr/*/READ*>» matches «I</usr/share/doc/package/README>». As " 7337"usual, ‘?’ matches any single character (again, including ‘/’). And ‘[’ " 7338"starts a character class, which can contain a list of characters, ranges and " 7339"complementations. See B<glob>(7) for detailed information about globbing. " 7340"Note: the current implementation might re-include more directories and " 7341"symlinks than needed, to be on the safe side and avoid possible unpack " 7342"failures; future work might fix this." 7343msgstr "" 7344 7345#. type: Plain text 7346#: dpkg.man 7347msgid "" 7348"This can be used to remove all paths except some particular ones; a typical " 7349"case is:" 7350msgstr "这可以用来删除除了一些特例外的所有路径；一种典型的情况是：" 7351 7352#. type: Plain text 7353#: dpkg.man 7354#, no-wrap 7355msgid "" 7356"B<--path-exclude=/usr/share/doc/*>\n" 7357"B<--path-include=/usr/share/doc/*/copyright>\n" 7358msgstr "" 7359 7360#. type: Plain text 7361#: dpkg.man 7362msgid "to remove all documentation files except the copyright files." 7363msgstr "" 7364 7365#. type: Plain text 7366#: dpkg.man 7367msgid "" 7368"These two options can be specified multiple times, and interleaved with each " 7369"other. Both are processed in the given order, with the last rule that " 7370"matches a file name making the decision." 7371msgstr "" 7372 7373#. type: Plain text 7374#: dpkg.man 7375msgid "" 7376"The filters are applied when unpacking the binary packages, and as such only " 7377"have knowledge of the type of object currently being filtered (e.g. a normal " 7378"file or a directory) and have not visibility of what objects will come " 7379"next. Because these filters have side effects (in contrast to B<find>(1) " 7380"filters), excluding an exact pathname that happens to be a directory object " 7381"like I</usr/share/doc> will not have the desired result, and only that " 7382"pathname will be excluded (which could be automatically reincluded if the " 7383"code sees the need). Any subsequent files contained within that directory " 7384"will fail to unpack." 7385msgstr "" 7386 7387#. type: Plain text 7388#: dpkg.man 7389msgid "Hint: make sure the globs are not expanded by your shell." 7390msgstr "" 7391 7392#. type: TP 7393#: dpkg.man 7394#, no-wrap 7395msgid "B<--verify-format>I< format-name>" 7396msgstr "" 7397 7398#. type: Plain text 7399#: dpkg.man 7400msgid "Sets the output format for the B<--verify> command (since dpkg 1.17.2)." 7401msgstr "" 7402 7403#. type: Plain text 7404#: dpkg.man 7405msgid "" 7406"The only currently supported output format is B<rpm>, which consists of a " 7407"line for every path that failed any check. The lines start with 9 " 7408"characters to report each specific check result, a ‘B<?>’ implies the check " 7409"could not be done (lack of support, file permissions, etc), ‘B<.>’ implies " 7410"the check passed, and an alphanumeric character implies a specific check " 7411"failed; the md5sum verification failure (the file contents have changed) is " 7412"denoted with a ‘B<5>’ on the third character. The line is followed by a " 7413"space and an attribute character (currently ‘B<c>’ for conffiles), another " 7414"space and the pathname." 7415msgstr "" 7416 7417#. type: TP 7418#: dpkg.man 7419#, no-wrap 7420msgid "B<--status-fd >I<n>" 7421msgstr "" 7422 7423#. type: Plain text 7424#: dpkg.man 7425msgid "" 7426"Send machine-readable package status and progress information to file " 7427"descriptor I<n>. This option can be specified multiple times. The " 7428"information is generally one record per line, in one of the following forms:" 7429msgstr "" 7430 7431#. type: TP 7432#: dpkg.man 7433#, no-wrap 7434msgid "B<status: >I<package>B<: >I<status>" 7435msgstr "" 7436 7437#. type: Plain text 7438#: dpkg.man 7439msgid "Package status changed; I<status> is as in the status file." 7440msgstr "" 7441 7442#. type: TP 7443#: dpkg.man 7444#, no-wrap 7445msgid "B<status: >I<package>B< : error : >I<extended-error-message>" 7446msgstr "" 7447 7448#. type: Plain text 7449#: dpkg.man 7450msgid "" 7451"An error occurred. Any possible newlines in I<extended-error-message> will " 7452"be converted to spaces before output." 7453msgstr "" 7454 7455#. type: TP 7456#: dpkg.man 7457#, no-wrap 7458msgid "B<status: >I<file>B< : conffile-prompt : '>I<real-old>B<' '>I<real-new>B<' >I<useredited>B< >I<distedited>" 7459msgstr "" 7460 7461#. type: Plain text 7462#: dpkg.man 7463msgid "User is being asked a conffile question." 7464msgstr "" 7465 7466#. type: TP 7467#: dpkg.man 7468#, no-wrap 7469msgid "B<processing: >I<stage>B<: >I<package>" 7470msgstr "" 7471 7472#. type: Plain text 7473#: dpkg.man 7474msgid "" 7475"Sent just before a processing stage starts. I<stage> is one of B<upgrade>, " 7476"B<install> (both sent before unpacking), B<configure>, B<trigproc>, " 7477"B<disappear>, B<remove>, B<purge>." 7478msgstr "" 7479 7480#. type: TP 7481#: dpkg.man 7482#, no-wrap 7483msgid "B<--status-logger>=I<command>" 7484msgstr "" 7485 7486#. type: Plain text 7487#: dpkg.man 7488msgid "" 7489"Send machine-readable package status and progress information to the shell " 7490"I<command>'s standard input, to be run via ``sh -c'' (since dpkg 1.16.0). " 7491"This option can be specified multiple times. The output format used is the " 7492"same as in B<--status-fd>." 7493msgstr "" 7494 7495#. type: TP 7496#: dpkg.man 7497#, no-wrap 7498msgid "B<--log=>I<filename>" 7499msgstr "" 7500 7501#. type: Plain text 7502#: dpkg.man 7503msgid "" 7504"Log status change updates and actions to I<filename>, instead of the default " 7505"I<%LOGDIR%/dpkg.log>. If this option is given multiple times, the last " 7506"filename is used. Log messages are of the form:" 7507msgstr "" 7508 7509#. type: TP 7510#: dpkg.man 7511#, no-wrap 7512msgid "YYYY-MM-DD HH:MM:SS B<startup> I<type> I<command>" 7513msgstr "" 7514 7515#. type: Plain text 7516#: dpkg.man 7517msgid "" 7518"For each dpkg invocation where I<type> is B<archives> (with a I<command> of " 7519"B<unpack> or B<install>) or B<packages> (with a I<command> of B<configure>, " 7520"B<triggers-only>, B<remove> or B<purge>)." 7521msgstr "" 7522 7523#. type: TP 7524#: dpkg.man 7525#, no-wrap 7526msgid "YYYY-MM-DD HH:MM:SS B<status> I<state> I<pkg> I<installed-version>" 7527msgstr "" 7528 7529#. type: Plain text 7530#: dpkg.man 7531msgid "For status change updates." 7532msgstr "" 7533 7534#. type: TP 7535#: dpkg.man 7536#, no-wrap 7537msgid "YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> I<available-version>" 7538msgstr "" 7539 7540#. type: Plain text 7541#: dpkg.man 7542msgid "" 7543"For actions where I<action> is one of B<install>, B<upgrade>, B<configure>, " 7544"B<trigproc>, B<disappear>, B<remove> or B<purge>." 7545msgstr "" 7546 7547#. type: TP 7548#: dpkg.man 7549#, no-wrap 7550msgid "YYYY-MM-DD HH:MM:SS B<conffile> I<filename> I<decision>" 7551msgstr "" 7552 7553#. type: Plain text 7554#: dpkg.man 7555msgid "For conffile changes where I<decision> is either B<install> or B<keep>." 7556msgstr "" 7557 7558#. type: TP 7559#: dpkg.man dpkg-query.man 7560#, fuzzy, no-wrap 7561#| msgid "B<--version>" 7562msgid "B<--no-pager>" 7563msgstr "B<--version>" 7564 7565#. type: Plain text 7566#: dpkg.man dpkg-query.man 7567msgid "" 7568"Disables the use of any pager when showing information (since dpkg 1.19.2)." 7569msgstr "" 7570 7571#. type: TP 7572#: dpkg.man 7573#, no-wrap 7574msgid "B<--no-debsig>" 7575msgstr "" 7576 7577#. type: Plain text 7578#: dpkg.man 7579msgid "Do not try to verify package signatures." 7580msgstr "" 7581 7582#. type: TP 7583#: dpkg.man 7584#, no-wrap 7585msgid "B<--no-triggers>" 7586msgstr "" 7587 7588#. type: Plain text 7589#: dpkg.man 7590#, fuzzy 7591#| msgid "" 7592#| "Processes only triggers. All pending triggers will be processed. If " 7593#| "package names are supplied only those packages' triggers will be " 7594#| "processed, exactly once each where necessary. Use of this option may " 7595#| "leave packages in the improper B<triggers-awaited> and B<triggers-" 7596#| "pending> states. This can be fixed later by running: B<dpkg --configure --" 7597#| "pending>." 7598msgid "" 7599"Do not run any triggers in this run (since dpkg 1.14.17), but activations " 7600"will still be recorded. If used with B<--configure> I<package> or B<--" 7601"triggers-only> I<package> then the named package postinst will still be run " 7602"even if only a triggers run is needed. Use of this option may leave packages " 7603"in the improper B<triggers-awaited> and B<triggers-pending> states. This can " 7604"be fixed later by running: B<dpkg --configure --pending>." 7605msgstr "" 7606"仅处理触发器。且所有未决触发器都会被处理。If package names are supplied only " 7607"those packages' triggers will be processed, exactly once each where " 7608"necessary.使用该选项可能导致软件包处于不妥当的 B<triggers-awaited> 和 " 7609"B<triggers-pending>状态。但可以在之后使用该命令修复： B<dpkg --configure --" 7610"pending>。" 7611 7612#. type: TP 7613#: dpkg.man 7614#, no-wrap 7615msgid "B<--triggers>" 7616msgstr "" 7617 7618#. type: Plain text 7619#: dpkg.man 7620msgid "Cancels a previous B<--no-triggers> (since dpkg 1.14.17)." 7621msgstr "" 7622 7623#. type: SH 7624#: dpkg.man dpkg-deb.man dpkg-divert.man dpkg-query.man dpkg-split.man 7625#: dpkg-statoverride.man dpkg-trigger.man dselect.man start-stop-daemon.man 7626#: update-alternatives.man 7627#, no-wrap 7628msgid "EXIT STATUS" 7629msgstr "" 7630 7631#. type: TP 7632#: dpkg.man dpkg-deb.man dpkg-divert.man dpkg-query.man dpkg-split.man 7633#: dpkg-statoverride.man dpkg-trigger.man dselect.man start-stop-daemon.man 7634#: update-alternatives.man 7635#, no-wrap 7636msgid "B<0>" 7637msgstr "" 7638 7639#. type: Plain text 7640#: dpkg.man dpkg-trigger.man 7641msgid "" 7642"The requested action was successfully performed. Or a check or assertion " 7643"command returned true." 7644msgstr "" 7645 7646#. type: TP 7647#: dpkg.man dpkg-query.man dpkg-split.man dpkg-statoverride.man 7648#: dpkg-trigger.man start-stop-daemon.man 7649#, no-wrap 7650msgid "B<1>" 7651msgstr "" 7652 7653#. type: Plain text 7654#: dpkg.man dpkg-trigger.man 7655msgid "A check or assertion command returned false." 7656msgstr "" 7657 7658#. type: TP 7659#: dpkg.man dpkg-deb.man dpkg-divert.man dpkg-query.man dpkg-split.man 7660#: dpkg-statoverride.man dpkg-trigger.man dselect.man start-stop-daemon.man 7661#: update-alternatives.man 7662#, no-wrap 7663msgid "B<2>" 7664msgstr "" 7665 7666#. type: Plain text 7667#: dpkg.man dpkg-deb.man dpkg-divert.man dpkg-query.man dpkg-statoverride.man 7668#: dpkg-trigger.man dselect.man 7669msgid "" 7670"Fatal or unrecoverable error due to invalid command-line usage, or " 7671"interactions with the system, such as accesses to the database, memory " 7672"allocations, etc." 7673msgstr "" 7674 7675#. type: SH 7676#: dpkg.man dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 7677#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 7678#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 7679#: dpkg-gensymbols.man dpkg-maintscript-helper.man dpkg-mergechangelogs.man 7680#: dpkg-name.man dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 7681#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 7682#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man dselect.man 7683#: update-alternatives.man 7684#, no-wrap 7685msgid "ENVIRONMENT" 7686msgstr "" 7687 7688#. type: SS 7689#: dpkg.man dpkg-buildpackage.man dpkg-query.man 7690#, no-wrap 7691msgid "External environment" 7692msgstr "" 7693 7694#. type: TP 7695#: dpkg.man 7696#, no-wrap 7697msgid "B<PATH>" 7698msgstr "" 7699 7700#. type: Plain text 7701#: dpkg.man 7702msgid "" 7703"This variable is expected to be defined in the environment and point to the " 7704"system paths where several required programs are to be found. If it's not " 7705"set or the programs are not found, B<dpkg> will abort." 7706msgstr "" 7707 7708#. type: TP 7709#: dpkg.man dselect.man 7710#, no-wrap 7711msgid "B<HOME>" 7712msgstr "" 7713 7714#. type: Plain text 7715#: dpkg.man 7716msgid "" 7717"If set, B<dpkg> will use it as the directory from which to read the user " 7718"specific configuration file." 7719msgstr "" 7720 7721#. type: TP 7722#: dpkg.man dpkg-deb.man 7723#, no-wrap 7724msgid "B<TMPDIR>" 7725msgstr "" 7726 7727#. type: Plain text 7728#: dpkg.man 7729msgid "" 7730"If set, B<dpkg> will use it as the directory in which to create temporary " 7731"files and directories." 7732msgstr "" 7733 7734#. type: TP 7735#: dpkg.man dpkg-query.man 7736#, no-wrap 7737msgid "B<SHELL>" 7738msgstr "" 7739 7740#. type: Plain text 7741#: dpkg.man 7742msgid "" 7743"The program B<dpkg> will execute when starting a new interactive shell, or " 7744"when spawning a command via a shell." 7745msgstr "" 7746 7747#. type: TP 7748#: dpkg.man dpkg-query.man 7749#, no-wrap 7750msgid "B<PAGER>" 7751msgstr "" 7752 7753#. type: TQ 7754#: dpkg.man dpkg-query.man 7755#, no-wrap 7756msgid "B<DPKG_PAGER>" 7757msgstr "" 7758 7759#. type: Plain text 7760#: dpkg.man 7761msgid "" 7762"The program B<dpkg> will execute when running a pager, for example when " 7763"displaying the conffile differences. If B<SHELL> is not set, «B<sh>» will " 7764"be used instead. The B<DPKG_PAGER> overrides the B<PAGER> environment " 7765"variable (since dpkg 1.19.2)." 7766msgstr "" 7767 7768#. type: TP 7769#: dpkg.man dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 7770#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 7771#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 7772#: dpkg-gensymbols.man dpkg-maintscript-helper.man dpkg-mergechangelogs.man 7773#: dpkg-name.man dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 7774#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 7775#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man 7776#, no-wrap 7777msgid "B<DPKG_COLORS>" 7778msgstr "" 7779 7780#. type: Plain text 7781#: dpkg.man dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 7782#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 7783#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 7784#: dpkg-gensymbols.man dpkg-mergechangelogs.man dpkg-name.man 7785#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 7786#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 7787#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man 7788msgid "" 7789"Sets the color mode (since dpkg 1.18.5). The currently accepted values are: " 7790"B<auto> (default), B<always> and B<never>." 7791msgstr "" 7792 7793#. type: TP 7794#: dpkg.man dpkg-statoverride.man 7795#, no-wrap 7796msgid "B<DPKG_FORCE>" 7797msgstr "" 7798 7799#. type: Plain text 7800#: dpkg.man 7801msgid "" 7802"Sets the force flags (since dpkg 1.19.5). When this variable is present, no " 7803"built-in force defaults will be applied. If the variable is present but " 7804"empty, all force flags will be disabled." 7805msgstr "" 7806 7807#. type: TP 7808#: dpkg.man 7809#, no-wrap 7810msgid "B<DPKG_FRONTEND_LOCKED>" 7811msgstr "" 7812 7813#. type: Plain text 7814#: dpkg.man 7815msgid "" 7816"Set by a package manager frontend to notify dpkg that it should not acquire " 7817"the frontend lock (since dpkg 1.19.1)." 7818msgstr "" 7819 7820#. type: SS 7821#: dpkg.man dpkg-buildpackage.man dpkg-query.man 7822#, no-wrap 7823msgid "Internal environment" 7824msgstr "" 7825 7826#. type: TP 7827#: dpkg.man dpkg-query.man 7828#, no-wrap 7829msgid "B<LESS>" 7830msgstr "" 7831 7832#. type: Plain text 7833#: dpkg.man 7834msgid "" 7835"Defined by B<dpkg> to “B<-FRSXMQ>”, if not already set, when spawning a " 7836"pager (since dpkg 1.19.2). To change the default behavior, this variable " 7837"can be preset to some other value including an empty string, or the B<PAGER> " 7838"or B<DPKG_PAGER> variables can be set to disable specific options with «B<-" 7839"+>», for example B<DPKG_PAGER=\"less -+F\">." 7840msgstr "" 7841 7842#. type: TP 7843#: dpkg.man dpkg-divert.man dpkg-statoverride.man 7844#, no-wrap 7845msgid "B<DPKG_ROOT>" 7846msgstr "" 7847 7848#. type: Plain text 7849#: dpkg.man 7850msgid "" 7851"Defined by B<dpkg> on the maintainer script environment to indicate which " 7852"installation to act on (since dpkg 1.18.5). The value is intended to be " 7853"prepended to any path maintainer scripts operate on. During normal " 7854"operation, this variable is empty. When installing packages into a " 7855"different B<instdir>, B<dpkg> normally invokes maintainer scripts using " 7856"B<chroot>(2) and leaves this variable empty, but if B<--force-script-" 7857"chrootless> is specified then the B<chroot>(2) call is skipped and " 7858"B<instdir> is non-empty." 7859msgstr "" 7860 7861#. type: TP 7862#: dpkg.man dpkg-divert.man dpkg-query.man dpkg-statoverride.man 7863#: dpkg-trigger.man update-alternatives.man 7864#, no-wrap 7865msgid "B<DPKG_ADMINDIR>" 7866msgstr "" 7867 7868#. type: Plain text 7869#: dpkg.man 7870msgid "" 7871"Defined by B<dpkg> on the maintainer script environment to indicate the " 7872"B<dpkg> administrative directory to use (since dpkg 1.16.0). This variable " 7873"is always set to the current B<--admindir> value." 7874msgstr "" 7875 7876#. type: Plain text 7877#: dpkg.man 7878msgid "" 7879"Defined by B<dpkg> on the subprocesses environment to all the currently " 7880"enabled force option names separated by commas (since dpkg 1.19.5)." 7881msgstr "" 7882 7883#. type: TP 7884#: dpkg.man 7885#, no-wrap 7886msgid "B<DPKG_SHELL_REASON>" 7887msgstr "" 7888 7889#. type: Plain text 7890#: dpkg.man 7891msgid "" 7892"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine " 7893"the situation (since dpkg 1.15.6). Current valid value: B<conffile-prompt>." 7894msgstr "" 7895 7896#. type: TP 7897#: dpkg.man 7898#, no-wrap 7899msgid "B<DPKG_CONFFILE_OLD>" 7900msgstr "" 7901 7902#. type: Plain text 7903#: dpkg.man 7904msgid "" 7905"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine " 7906"the situation (since dpkg 1.15.6). Contains the path to the old conffile." 7907msgstr "" 7908 7909#. type: TP 7910#: dpkg.man 7911#, no-wrap 7912msgid "B<DPKG_CONFFILE_NEW>" 7913msgstr "" 7914 7915#. type: Plain text 7916#: dpkg.man 7917msgid "" 7918"Defined by B<dpkg> on the shell spawned on the conffile prompt to examine " 7919"the situation (since dpkg 1.15.6). Contains the path to the new conffile." 7920msgstr "" 7921 7922#. type: TP 7923#: dpkg.man 7924#, no-wrap 7925msgid "B<DPKG_HOOK_ACTION>" 7926msgstr "" 7927 7928#. type: Plain text 7929#: dpkg.man 7930msgid "" 7931"Defined by B<dpkg> on the shell spawned when executing a hook action (since " 7932"dpkg 1.15.4). Contains the current B<dpkg> action." 7933msgstr "" 7934 7935#. type: TP 7936#: dpkg.man 7937#, no-wrap 7938msgid "B<DPKG_RUNNING_VERSION>" 7939msgstr "" 7940 7941#. type: Plain text 7942#: dpkg.man 7943msgid "" 7944"Defined by B<dpkg> on the maintainer script environment to the version of " 7945"the currently running B<dpkg> instance (since dpkg 1.14.17)." 7946msgstr "" 7947 7948#. type: TP 7949#: dpkg.man dpkg-divert.man 7950#, no-wrap 7951msgid "B<DPKG_MAINTSCRIPT_PACKAGE>" 7952msgstr "" 7953 7954#. type: Plain text 7955#: dpkg.man 7956msgid "" 7957"Defined by B<dpkg> on the maintainer script environment to the (non-arch-" 7958"qualified) package name being handled (since dpkg 1.14.17)." 7959msgstr "" 7960 7961#. type: TP 7962#: dpkg.man 7963#, no-wrap 7964msgid "B<DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT>" 7965msgstr "" 7966 7967#. type: Plain text 7968#: dpkg.man 7969msgid "" 7970"Defined by B<dpkg> on the maintainer script environment to the package " 7971"reference count, i.e. the number of package instances with a state greater " 7972"than B<not-installed> (since dpkg 1.17.2)." 7973msgstr "" 7974 7975#. type: TP 7976#: dpkg.man 7977#, no-wrap 7978msgid "B<DPKG_MAINTSCRIPT_ARCH>" 7979msgstr "" 7980 7981#. type: Plain text 7982#: dpkg.man 7983msgid "" 7984"Defined by B<dpkg> on the maintainer script environment to the architecture " 7985"the package got built for (since dpkg 1.15.4)." 7986msgstr "" 7987 7988#. type: TP 7989#: dpkg.man 7990#, no-wrap 7991msgid "B<DPKG_MAINTSCRIPT_NAME>" 7992msgstr "" 7993 7994#. type: Plain text 7995#: dpkg.man 7996msgid "" 7997"Defined by B<dpkg> on the maintainer script environment to the name of the " 7998"script running, one of B<preinst>, B<postinst>, B<prerm> or B<postrm> (since " 7999"dpkg 1.15.7)." 8000msgstr "" 8001 8002#. type: TP 8003#: dpkg.man 8004#, no-wrap 8005msgid "B<DPKG_MAINTSCRIPT_DEBUG>" 8006msgstr "" 8007 8008#. type: Plain text 8009#: dpkg.man 8010msgid "" 8011"Defined by B<dpkg> on the maintainer script environment to a value (‘B<0>’ " 8012"or ‘B<1>’) noting whether debugging has been requested (with the B<--debug> " 8013"option) for the maintainer scripts (since dpkg 1.18.4)." 8014msgstr "" 8015 8016#. type: Plain text 8017#: dpkg.man dpkg.cfg.man 8018#, no-wrap 8019msgid "I<%PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*>" 8020msgstr "" 8021 8022#. type: Plain text 8023#: dpkg.man 8024msgid "Configuration fragment files (since dpkg 1.15.4)." 8025msgstr "" 8026 8027#. type: Plain text 8028#: dpkg.man dpkg.cfg.man 8029#, no-wrap 8030msgid "I<%PKGCONFDIR%/dpkg.cfg>" 8031msgstr "" 8032 8033#. type: Plain text 8034#: dpkg.man 8035msgid "Configuration file with default options." 8036msgstr "" 8037 8038#. type: TP 8039#: dpkg.man 8040#, no-wrap 8041msgid "I<%LOGDIR%/dpkg.log>" 8042msgstr "" 8043 8044#. type: Plain text 8045#: dpkg.man 8046msgid "Default log file (see I<%PKGCONFDIR%/dpkg.cfg> and option B<--log>)." 8047msgstr "" 8048 8049#. type: Plain text 8050#: dpkg.man 8051msgid "" 8052"The other files listed below are in their default directories, see option " 8053"B<--admindir> to see how to change locations of these files." 8054msgstr "" 8055 8056#. type: TP 8057#: dpkg.man 8058#, no-wrap 8059msgid "I<%ADMINDIR%/available>" 8060msgstr "" 8061 8062#. type: Plain text 8063#: dpkg.man 8064msgid "List of available packages." 8065msgstr "" 8066 8067#. type: TP 8068#: dpkg.man 8069#, no-wrap 8070msgid "I<%ADMINDIR%/status>" 8071msgstr "" 8072 8073#. type: Plain text 8074#: dpkg.man 8075msgid "" 8076"Statuses of available packages. This file contains information about whether " 8077"a package is marked for removing or not, whether it is installed or not, " 8078"etc. See section B<INFORMATION ABOUT PACKAGES> for more info." 8079msgstr "" 8080 8081#. type: Plain text 8082#: dpkg.man 8083msgid "" 8084"The status file is backed up daily in I</var/backups>. It can be useful if " 8085"it's lost or corrupted due to filesystems troubles." 8086msgstr "" 8087 8088#. type: Plain text 8089#: dpkg.man 8090msgid "The format and contents of a binary package are described in B<deb>(5)." 8091msgstr "" 8092 8093#. type: Plain text 8094#: dpkg.man 8095msgid "B<--no-act> usually gives less information than might be helpful." 8096msgstr "" 8097 8098#. type: Plain text 8099#: dpkg.man 8100msgid "" 8101"To list installed packages related to the editor B<vi>(1) (note that B<dpkg-" 8102"query> does not load the I<available> file anymore by default, and the " 8103"B<dpkg-query> B<--load-avail> option should be used instead for that):" 8104msgstr "" 8105 8106#. type: Plain text 8107#: dpkg.man 8108#, no-wrap 8109msgid " B<dpkg -l '*vi*'>\n" 8110msgstr "" 8111 8112#. type: Plain text 8113#: dpkg.man 8114msgid "To see the entries in I<%ADMINDIR%/available> of two packages:" 8115msgstr "" 8116 8117#. type: Plain text 8118#: dpkg.man 8119#, no-wrap 8120msgid " B<dpkg --print-avail elvis vim | less>\n" 8121msgstr "" 8122 8123#. type: Plain text 8124#: dpkg.man 8125msgid "To search the listing of packages yourself:" 8126msgstr "" 8127 8128#. type: Plain text 8129#: dpkg.man 8130#, no-wrap 8131msgid " B<less %ADMINDIR%/available>\n" 8132msgstr "" 8133 8134#. type: Plain text 8135#: dpkg.man 8136msgid "To remove an installed elvis package:" 8137msgstr "" 8138 8139#. type: Plain text 8140#: dpkg.man 8141#, no-wrap 8142msgid " B<dpkg -r elvis>\n" 8143msgstr "" 8144 8145#. type: Plain text 8146#: dpkg.man 8147msgid "" 8148"To install a package, you first need to find it in an archive or CDROM. The " 8149"I<available> file shows that the vim package is in section B<editors>:" 8150msgstr "" 8151 8152#. type: Plain text 8153#: dpkg.man 8154#, no-wrap 8155msgid "" 8156" B<cd /media/cdrom/pool/main/v/vim>\n" 8157" B<dpkg -i vim_4.5-3.deb>\n" 8158msgstr "" 8159 8160#. type: Plain text 8161#: dpkg.man 8162msgid "To make a local copy of the package selection states:" 8163msgstr "" 8164 8165#. type: Plain text 8166#: dpkg.man 8167#, no-wrap 8168msgid " B<dpkg --get-selections E<gt>myselections>\n" 8169msgstr "" 8170 8171#. type: Plain text 8172#: dpkg.man 8173msgid "" 8174"You might transfer this file to another computer, and after having updated " 8175"the I<available> file there with your package manager frontend of choice " 8176"(see https://wiki.debian.org/Teams/Dpkg/FAQ for more details), for example:" 8177msgstr "" 8178 8179#. type: Plain text 8180#: dpkg.man 8181#, no-wrap 8182msgid " B<apt-cache dumpavail | dpkg --merge-avail>\n" 8183msgstr "" 8184 8185#. type: Plain text 8186#: dpkg.man 8187msgid "or with dpkg 1.17.6 and earlier:" 8188msgstr "" 8189 8190#. type: Plain text 8191#: dpkg.man 8192#, no-wrap 8193msgid "" 8194" B<avail=`mktemp`>\n" 8195" B<apt-cache dumpavail E<gt>\"$avail\">\n" 8196" B<dpkg --merge-avail \"$avail\">\n" 8197" B<rm \"$avail\">\n" 8198msgstr "" 8199 8200#. type: Plain text 8201#: dpkg.man 8202msgid "you can install it with:" 8203msgstr "" 8204 8205#. type: Plain text 8206#: dpkg.man 8207#, no-wrap 8208msgid "" 8209" B<dpkg --clear-selections>\n" 8210" B<dpkg --set-selections E<lt>myselections>\n" 8211msgstr "" 8212 8213#. type: Plain text 8214#: dpkg.man 8215msgid "" 8216"Note that this will not actually install or remove anything, but just set " 8217"the selection state on the requested packages. You will need some other " 8218"application to actually download and install the requested packages. For " 8219"example, run B<apt-get dselect-upgrade>." 8220msgstr "" 8221 8222#. type: Plain text 8223#: dpkg.man 8224msgid "" 8225"Ordinarily, you will find that B<dselect>(1) provides a more convenient way " 8226"to modify the package selection states." 8227msgstr "" 8228 8229#. type: SH 8230#: dpkg.man 8231#, no-wrap 8232msgid "ADDITIONAL FUNCTIONALITY" 8233msgstr "" 8234 8235#. type: Plain text 8236#: dpkg.man 8237msgid "" 8238"Additional functionality can be gained by installing any of the following " 8239"packages: B<apt>, B<aptitude> and B<debsums>." 8240msgstr "" 8241 8242#. type: Plain text 8243#: dpkg.man 8244msgid "" 8245"B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), " 8246"B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8)." 8247msgstr "" 8248 8249#. type: SH 8250#: dpkg.man 8251#, no-wrap 8252msgid "AUTHORS" 8253msgstr "" 8254 8255#. type: Plain text 8256#: dpkg.man 8257msgid "" 8258"See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to " 8259"B<dpkg>." 8260msgstr "" 8261 8262#. type: TH 8263#: dpkg-architecture.man 8264#, no-wrap 8265msgid "dpkg-architecture" 8266msgstr "" 8267 8268#. type: Plain text 8269#: dpkg-architecture.man 8270msgid "" 8271"dpkg-architecture - set and determine the architecture for package building" 8272msgstr "" 8273 8274#. type: Plain text 8275#: dpkg-architecture.man 8276msgid "B<dpkg-architecture> [I<option>...] [I<command>]" 8277msgstr "" 8278 8279#. type: Plain text 8280#: dpkg-architecture.man 8281msgid "" 8282"B<dpkg-architecture> provides a facility to determine and set the build and " 8283"host architecture for package building." 8284msgstr "" 8285 8286#. type: Plain text 8287#: dpkg-architecture.man 8288msgid "" 8289"The build architecture is always determined by an external call to " 8290"B<dpkg>(1), and cannot be set at the command line." 8291msgstr "" 8292 8293#. type: Plain text 8294#: dpkg-architecture.man 8295msgid "" 8296"You can specify the host architecture by providing one or both of the " 8297"options B<--host-arch> and B<--host-type>. The default is determined by an " 8298"external call to B<gcc>(1), or the same as the build architecture if B<CC> " 8299"or gcc are both not available. One out of B<--host-arch> and B<--host-type> " 8300"is sufficient, the value of the other will be set to a usable default. " 8301"Indeed, it is often better to only specify one, because B<dpkg-architecture> " 8302"will warn you if your choice does not match the default." 8303msgstr "" 8304 8305#. type: SH 8306#: dpkg-architecture.man dpkg-buildflags.man dpkg-deb.man dpkg-divert.man 8307#: dpkg-query.man dpkg-source.man dpkg-split.man dpkg-statoverride.man 8308#: dpkg-trigger.man dpkg-vendor.man dselect.man start-stop-daemon.man 8309#: update-alternatives.man 8310#, no-wrap 8311msgid "COMMANDS" 8312msgstr "" 8313 8314#. type: TP 8315#: dpkg-architecture.man 8316#, no-wrap 8317msgid "B<-l>, B<--list>" 8318msgstr "" 8319 8320#. type: Plain text 8321#: dpkg-architecture.man 8322msgid "" 8323"Print the environment variables, one each line, in the format " 8324"I<VARIABLE=value>. This is the default action." 8325msgstr "" 8326 8327#. type: TP 8328#: dpkg-architecture.man 8329#, no-wrap 8330msgid "B<-e>, B<--equal> I<architecture>" 8331msgstr "" 8332 8333#. type: Plain text 8334#: dpkg-architecture.man 8335msgid "" 8336"Check for equality of architecture (since dpkg 1.13.13). It compares the " 8337"current or specified Debian host architecture against I<architecture>, to " 8338"check if they are equal. This action will not expand the architecture " 8339"wildcards. Command finishes with an exit status of 0 if matched, 1 if not " 8340"matched." 8341msgstr "" 8342 8343#. type: TP 8344#: dpkg-architecture.man 8345#, no-wrap 8346msgid "B<-i>, B<--is> I<architecture-wildcard>" 8347msgstr "" 8348 8349#. type: Plain text 8350#: dpkg-architecture.man 8351msgid "" 8352"Check for identity of architecture (since dpkg 1.13.13). It compares the " 8353"current or specified Debian host architecture against I<architecture-" 8354"wildcard> after having expanded it as an architecture wildcard, to check if " 8355"they match. Command finishes with an exit status of 0 if matched, 1 if not " 8356"matched." 8357msgstr "" 8358 8359#. type: TP 8360#: dpkg-architecture.man 8361#, no-wrap 8362msgid "B<-q>, B<--query> I<variable-name>" 8363msgstr "" 8364 8365#. type: Plain text 8366#: dpkg-architecture.man 8367msgid "Print the value of a single variable." 8368msgstr "" 8369 8370#. type: TP 8371#: dpkg-architecture.man 8372#, no-wrap 8373msgid "B<-s>, B<--print-set>" 8374msgstr "" 8375 8376#. type: Plain text 8377#: dpkg-architecture.man 8378msgid "" 8379"Print an export command. This can be used to set the environment variables " 8380"using eval." 8381msgstr "" 8382 8383#. type: TP 8384#: dpkg-architecture.man 8385#, no-wrap 8386msgid "B<-u>, B<--print-unset>" 8387msgstr "" 8388 8389#. type: Plain text 8390#: dpkg-architecture.man 8391msgid "Print a similar command to B<--print-unset> but to unset all variables." 8392msgstr "" 8393 8394#. type: TP 8395#: dpkg-architecture.man 8396#, fuzzy, no-wrap 8397#| msgid "B<-E>, B<--skip-same-version>" 8398msgid "B<-c>, B<--command> I<command-string>" 8399msgstr "B<-E>, B<--skip-same-version>" 8400 8401#. type: Plain text 8402#: dpkg-architecture.man 8403msgid "" 8404"Execute a I<command-string> in an environment which has all variables set to " 8405"the determined value." 8406msgstr "" 8407 8408#. type: TP 8409#: dpkg-architecture.man 8410#, no-wrap 8411msgid "B<-L>, B<--list-known>" 8412msgstr "" 8413 8414#. type: Plain text 8415#: dpkg-architecture.man 8416msgid "" 8417"Print a list of valid architecture names. Possibly restricted by one or " 8418"more of the matching options B<--match-wildcard>, B<--match-bits> or B<--" 8419"match-endian> (since dpkg 1.17.14)." 8420msgstr "" 8421 8422#. type: Plain text 8423#: dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 8424#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 8425#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 8426#: dpkg-gensymbols.man dpkg-mergechangelogs.man dpkg-name.man 8427#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 8428#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-split.man dpkg-statoverride.man 8429#: dpkg-trigger.man dpkg-vendor.man update-alternatives.man 8430msgid "Show the usage message and exit." 8431msgstr "" 8432 8433#. type: Plain text 8434#: dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 8435#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 8436#: dpkg-deb.man dpkg-divert.man dpkg-genchanges.man dpkg-gencontrol.man 8437#: dpkg-gensymbols.man dpkg-mergechangelogs.man dpkg-name.man 8438#: dpkg-parsechangelog.man dpkg-query.man dpkg-scanpackages.man 8439#: dpkg-scansources.man dpkg-shlibdeps.man dpkg-source.man dpkg-split.man 8440#: dpkg-statoverride.man dpkg-trigger.man dpkg-vendor.man 8441#: update-alternatives.man 8442msgid "Show the version and exit." 8443msgstr "" 8444 8445#. type: TP 8446#: dpkg-architecture.man dpkg-buildpackage.man 8447#, no-wrap 8448msgid "B<-a>, B<--host-arch> I<architecture>" 8449msgstr "" 8450 8451#. type: Plain text 8452#: dpkg-architecture.man 8453msgid "Set the host Debian architecture." 8454msgstr "" 8455 8456#. type: TP 8457#: dpkg-architecture.man dpkg-buildpackage.man 8458#, no-wrap 8459msgid "B<-t>, B<--host-type> I<gnu-system-type>" 8460msgstr "" 8461 8462#. type: Plain text 8463#: dpkg-architecture.man 8464msgid "Set the host GNU system type." 8465msgstr "" 8466 8467#. type: TP 8468#: dpkg-architecture.man 8469#, no-wrap 8470msgid "B<-A>, B<--target-arch> I<architecture>" 8471msgstr "" 8472 8473#. type: Plain text 8474#: dpkg-architecture.man 8475msgid "Set the target Debian architecture (since dpkg 1.17.14)." 8476msgstr "" 8477 8478#. type: TP 8479#: dpkg-architecture.man 8480#, no-wrap 8481msgid "B<-T>, B<--target-type> I<gnu-system-type>" 8482msgstr "" 8483 8484#. type: Plain text 8485#: dpkg-architecture.man 8486msgid "Set the target GNU system type (since dpkg 1.17.14)." 8487msgstr "" 8488 8489#. type: TP 8490#: dpkg-architecture.man 8491#, no-wrap 8492msgid "B<-W>, B<--match-wildcard> I<architecture-wildcard>" 8493msgstr "" 8494 8495#. type: Plain text 8496#: dpkg-architecture.man 8497msgid "" 8498"Restrict the architectures listed by B<--list-known> to ones matching the " 8499"specified architecture wildcard (since dpkg 1.17.14)." 8500msgstr "" 8501 8502#. type: TP 8503#: dpkg-architecture.man 8504#, no-wrap 8505msgid "B<-B>, B<--match-bits> I<architecture-bits>" 8506msgstr "" 8507 8508#. type: Plain text 8509#: dpkg-architecture.man 8510msgid "" 8511"Restrict the architectures listed by B<--list-known> to ones with the " 8512"specified CPU bits (since dpkg 1.17.14). Either B<32> or B<64>." 8513msgstr "" 8514 8515#. type: TP 8516#: dpkg-architecture.man 8517#, no-wrap 8518msgid "B<-E>, B<--match-endian> I<architecture-endianness>" 8519msgstr "" 8520 8521#. type: Plain text 8522#: dpkg-architecture.man 8523msgid "" 8524"Restrict the architectures listed by B<--list-known> to ones with the " 8525"specified endianness (since dpkg 1.17.14). Either B<little> or B<big>." 8526msgstr "" 8527 8528#. type: TP 8529#: dpkg-architecture.man 8530#, no-wrap 8531msgid "B<-f>, B<--force>" 8532msgstr "" 8533 8534#. type: Plain text 8535#: dpkg-architecture.man 8536msgid "" 8537"Values set by existing environment variables with the same name as used by " 8538"the scripts are honored (i.e. used by B<dpkg-architecture>), except if this " 8539"force flag is present. This allows the user to override a value even when " 8540"the call to B<dpkg-architecture> is buried in some other script (for example " 8541"B<dpkg-buildpackage>(1))." 8542msgstr "" 8543 8544#. type: SH 8545#: dpkg-architecture.man 8546#, no-wrap 8547msgid "TERMS" 8548msgstr "" 8549 8550#. type: IP 8551#: dpkg-architecture.man 8552#, no-wrap 8553msgid "build machine" 8554msgstr "" 8555 8556#. type: Plain text 8557#: dpkg-architecture.man 8558msgid "The machine the package is built on." 8559msgstr "" 8560 8561#. type: IP 8562#: dpkg-architecture.man 8563#, no-wrap 8564msgid "host machine" 8565msgstr "" 8566 8567#. type: Plain text 8568#: dpkg-architecture.man 8569msgid "The machine the package is built for." 8570msgstr "" 8571 8572#. type: IP 8573#: dpkg-architecture.man 8574#, no-wrap 8575msgid "target machine" 8576msgstr "" 8577 8578#. type: Plain text 8579#: dpkg-architecture.man 8580msgid "" 8581"The machine the compiler is building for. This is only needed when building " 8582"a cross-toolchain, one that will be built on the build architecture, to be " 8583"run on the host architecture, and to build code for the target architecture." 8584msgstr "" 8585 8586#. type: IP 8587#: dpkg-architecture.man 8588#, no-wrap 8589msgid "Debian architecture" 8590msgstr "" 8591 8592#. type: Plain text 8593#: dpkg-architecture.man 8594msgid "" 8595"The Debian architecture string, which specifies the binary tree in the FTP " 8596"archive. Examples: i386, sparc, hurd-i386." 8597msgstr "" 8598 8599#. type: IP 8600#: dpkg-architecture.man 8601#, no-wrap 8602msgid "Debian architecture tuple" 8603msgstr "" 8604 8605#. type: Plain text 8606#: dpkg-architecture.man 8607msgid "" 8608"A Debian architecture tuple is the fully qualified architecture with all its " 8609"components spelled out. This differs with Debian architectures in that at " 8610"least the I<cpu> component does not embed the I<abi>. The current tuple has " 8611"the form I<abi>-I<libc>-I<os>-I<cpu>. Examples: base-gnu-linux-amd64, " 8612"eabihf-musl-linux-arm." 8613msgstr "" 8614 8615#. type: IP 8616#: dpkg-architecture.man 8617#, no-wrap 8618msgid "Debian architecture wildcard" 8619msgstr "" 8620 8621#. type: Plain text 8622#: dpkg-architecture.man 8623msgid "" 8624"A Debian architecture wildcard is a special architecture string that will " 8625"match any real architecture being part of it. The general form is a Debian " 8626"architecture tuple with four or less elements, and with at least one of them " 8627"being B<any>. Missing elements of the tuple are prefixed implicitly as " 8628"B<any>, and thus the following pairs are equivalent:" 8629msgstr "" 8630 8631#. type: Plain text 8632#: dpkg-architecture.man 8633#, no-wrap 8634msgid "" 8635" B<any>-B<any>-B<any>-B<any> = B<any>\n" 8636" B<any>-B<any>-I<os>-B<any> = I<os>-B<any>\n" 8637" B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>\n" 8638msgstr "" 8639 8640#. type: Plain text 8641#: dpkg-architecture.man 8642msgid "" 8643"Examples: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any." 8644msgstr "" 8645 8646#. type: IP 8647#: dpkg-architecture.man 8648#, no-wrap 8649msgid "GNU system type" 8650msgstr "" 8651 8652#. type: Plain text 8653#: dpkg-architecture.man 8654msgid "" 8655"An architecture specification string consisting of two parts separated by a " 8656"hyphen: cpu and system. Examples: i586-linux-gnu, sparc-linux-gnu, i686-" 8657"gnu, x86_64-netbsd." 8658msgstr "" 8659 8660#. type: IP 8661#: dpkg-architecture.man 8662#, no-wrap 8663msgid "multiarch triplet" 8664msgstr "" 8665 8666#. type: Plain text 8667#: dpkg-architecture.man 8668msgid "" 8669"The clarified GNU system type, used for filesystem paths. This triplet does " 8670"not change even when the baseline ISA gets bumped, so that the resulting " 8671"paths are stable over time. The only current difference with the GNU system " 8672"type is that the CPU part for i386 based systems is always i386. Examples: " 8673"i386-linux-gnu, x86_64-linux-gnu. Example paths: /lib/powerpc64le-linux-" 8674"gnu/, /usr/lib/i386-kfreebsd-gnu/." 8675msgstr "" 8676 8677#. type: SH 8678#: dpkg-architecture.man 8679#, no-wrap 8680msgid "VARIABLES" 8681msgstr "" 8682 8683#. type: Plain text 8684#: dpkg-architecture.man 8685msgid "" 8686"The following variables are set by B<dpkg-architecture> (see the B<TERMS> " 8687"section for a description of the naming scheme):" 8688msgstr "" 8689 8690#. type: IP 8691#: dpkg-architecture.man 8692#, no-wrap 8693msgid "B<DEB_BUILD_ARCH>" 8694msgstr "" 8695 8696#. type: Plain text 8697#: dpkg-architecture.man 8698msgid "The Debian architecture of the build machine." 8699msgstr "" 8700 8701#. type: IP 8702#: dpkg-architecture.man 8703#, no-wrap 8704msgid "B<DEB_BUILD_ARCH_ABI>" 8705msgstr "" 8706 8707#. type: Plain text 8708#: dpkg-architecture.man 8709#, fuzzy 8710#| msgid "B<bad-version>: Process even packages with wrong versions." 8711msgid "The Debian abi name of the build machine (since dpkg 1.18.11)." 8712msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 8713 8714#. type: IP 8715#: dpkg-architecture.man 8716#, no-wrap 8717msgid "B<DEB_BUILD_ARCH_LIBC>" 8718msgstr "" 8719 8720#. type: Plain text 8721#: dpkg-architecture.man 8722msgid "The Debian libc name of the build machine (since dpkg 1.18.11)." 8723msgstr "" 8724 8725#. type: IP 8726#: dpkg-architecture.man 8727#, no-wrap 8728msgid "B<DEB_BUILD_ARCH_OS>" 8729msgstr "" 8730 8731#. type: Plain text 8732#: dpkg-architecture.man 8733msgid "The Debian system name of the build machine (since dpkg 1.13.2)." 8734msgstr "" 8735 8736#. type: IP 8737#: dpkg-architecture.man 8738#, no-wrap 8739msgid "B<DEB_BUILD_ARCH_CPU>" 8740msgstr "" 8741 8742#. type: Plain text 8743#: dpkg-architecture.man 8744msgid "The Debian cpu name of the build machine (since dpkg 1.13.2)." 8745msgstr "" 8746 8747#. type: IP 8748#: dpkg-architecture.man 8749#, no-wrap 8750msgid "B<DEB_BUILD_ARCH_BITS>" 8751msgstr "" 8752 8753#. type: Plain text 8754#: dpkg-architecture.man 8755msgid "The pointer size of the build machine (in bits; since dpkg 1.15.4)." 8756msgstr "" 8757 8758#. type: IP 8759#: dpkg-architecture.man 8760#, no-wrap 8761msgid "B<DEB_BUILD_ARCH_ENDIAN>" 8762msgstr "" 8763 8764#. type: Plain text 8765#: dpkg-architecture.man 8766msgid "The endianness of the build machine (little / big; since dpkg 1.15.4)." 8767msgstr "" 8768 8769#. type: IP 8770#: dpkg-architecture.man 8771#, no-wrap 8772msgid "B<DEB_BUILD_GNU_CPU>" 8773msgstr "" 8774 8775#. type: Plain text 8776#: dpkg-architecture.man 8777msgid "The CPU part of B<DEB_BUILD_GNU_TYPE>." 8778msgstr "" 8779 8780#. type: IP 8781#: dpkg-architecture.man 8782#, no-wrap 8783msgid "B<DEB_BUILD_GNU_SYSTEM>" 8784msgstr "" 8785 8786#. type: Plain text 8787#: dpkg-architecture.man 8788msgid "The System part of B<DEB_BUILD_GNU_TYPE>." 8789msgstr "" 8790 8791#. type: IP 8792#: dpkg-architecture.man 8793#, no-wrap 8794msgid "B<DEB_BUILD_GNU_TYPE>" 8795msgstr "" 8796 8797#. type: Plain text 8798#: dpkg-architecture.man 8799msgid "The GNU system type of the build machine." 8800msgstr "" 8801 8802#. type: IP 8803#: dpkg-architecture.man 8804#, no-wrap 8805msgid "B<DEB_BUILD_MULTIARCH>" 8806msgstr "" 8807 8808#. type: Plain text 8809#: dpkg-architecture.man 8810msgid "" 8811"The clarified GNU system type of the build machine, used for filesystem " 8812"paths (since dpkg 1.16.0)." 8813msgstr "" 8814 8815#. type: IP 8816#: dpkg-architecture.man 8817#, no-wrap 8818msgid "B<DEB_HOST_ARCH>" 8819msgstr "" 8820 8821#. type: Plain text 8822#: dpkg-architecture.man 8823msgid "The Debian architecture of the host machine." 8824msgstr "" 8825 8826#. type: IP 8827#: dpkg-architecture.man 8828#, no-wrap 8829msgid "B<DEB_HOST_ARCH_ABI>" 8830msgstr "" 8831 8832#. type: Plain text 8833#: dpkg-architecture.man 8834#, fuzzy 8835#| msgid "B<bad-version>: Process even packages with wrong versions." 8836msgid "The Debian abi name of the host machine (since dpkg 1.18.11)." 8837msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 8838 8839#. type: IP 8840#: dpkg-architecture.man 8841#, no-wrap 8842msgid "B<DEB_HOST_ARCH_LIBC>" 8843msgstr "" 8844 8845#. type: Plain text 8846#: dpkg-architecture.man 8847#, fuzzy 8848#| msgid "B<bad-version>: Process even packages with wrong versions." 8849msgid "The Debian libc name of the host machine (since dpkg 1.18.11)." 8850msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 8851 8852#. type: IP 8853#: dpkg-architecture.man 8854#, no-wrap 8855msgid "B<DEB_HOST_ARCH_OS>" 8856msgstr "" 8857 8858#. type: Plain text 8859#: dpkg-architecture.man 8860msgid "The Debian system name of the host machine (since dpkg 1.13.2)." 8861msgstr "" 8862 8863#. type: IP 8864#: dpkg-architecture.man 8865#, no-wrap 8866msgid "B<DEB_HOST_ARCH_CPU>" 8867msgstr "" 8868 8869#. type: Plain text 8870#: dpkg-architecture.man 8871msgid "The Debian cpu name of the host machine (since dpkg 1.13.2)." 8872msgstr "" 8873 8874#. type: IP 8875#: dpkg-architecture.man 8876#, no-wrap 8877msgid "B<DEB_HOST_ARCH_BITS>" 8878msgstr "" 8879 8880#. type: Plain text 8881#: dpkg-architecture.man 8882msgid "The pointer size of the host machine (in bits; since dpkg 1.15.4)." 8883msgstr "" 8884 8885#. type: IP 8886#: dpkg-architecture.man 8887#, no-wrap 8888msgid "B<DEB_HOST_ARCH_ENDIAN>" 8889msgstr "" 8890 8891#. type: Plain text 8892#: dpkg-architecture.man 8893msgid "The endianness of the host machine (little / big; since dpkg 1.15.4)." 8894msgstr "" 8895 8896#. type: IP 8897#: dpkg-architecture.man 8898#, no-wrap 8899msgid "B<DEB_HOST_GNU_CPU>" 8900msgstr "" 8901 8902#. type: Plain text 8903#: dpkg-architecture.man 8904msgid "The CPU part of B<DEB_HOST_GNU_TYPE>." 8905msgstr "" 8906 8907#. type: IP 8908#: dpkg-architecture.man 8909#, no-wrap 8910msgid "B<DEB_HOST_GNU_SYSTEM>" 8911msgstr "" 8912 8913#. type: Plain text 8914#: dpkg-architecture.man 8915msgid "The System part of B<DEB_HOST_GNU_TYPE>." 8916msgstr "" 8917 8918#. type: IP 8919#: dpkg-architecture.man 8920#, no-wrap 8921msgid "B<DEB_HOST_GNU_TYPE>" 8922msgstr "" 8923 8924#. type: Plain text 8925#: dpkg-architecture.man 8926msgid "The GNU system type of the host machine." 8927msgstr "" 8928 8929#. type: IP 8930#: dpkg-architecture.man 8931#, no-wrap 8932msgid "B<DEB_HOST_MULTIARCH>" 8933msgstr "" 8934 8935#. type: Plain text 8936#: dpkg-architecture.man 8937msgid "" 8938"The clarified GNU system type of the host machine, used for filesystem paths " 8939"(since dpkg 1.16.0)." 8940msgstr "" 8941 8942#. type: IP 8943#: dpkg-architecture.man 8944#, no-wrap 8945msgid "B<DEB_TARGET_ARCH>" 8946msgstr "" 8947 8948#. type: Plain text 8949#: dpkg-architecture.man 8950msgid "The Debian architecture of the target machine (since dpkg 1.17.14)." 8951msgstr "" 8952 8953#. type: IP 8954#: dpkg-architecture.man 8955#, no-wrap 8956msgid "B<DEB_TARGET_ARCH_ABI>" 8957msgstr "" 8958 8959#. type: Plain text 8960#: dpkg-architecture.man 8961#, fuzzy 8962#| msgid "B<bad-version>: Process even packages with wrong versions." 8963msgid "The Debian abi name of the target machine (since dpkg 1.18.11)." 8964msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 8965 8966#. type: IP 8967#: dpkg-architecture.man 8968#, no-wrap 8969msgid "B<DEB_TARGET_ARCH_LIBC>" 8970msgstr "" 8971 8972#. type: Plain text 8973#: dpkg-architecture.man 8974#, fuzzy 8975#| msgid "B<bad-version>: Process even packages with wrong versions." 8976msgid "The Debian libc name of the target machine (since dpkg 1.18.11)." 8977msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 8978 8979#. type: IP 8980#: dpkg-architecture.man 8981#, no-wrap 8982msgid "B<DEB_TARGET_ARCH_OS>" 8983msgstr "" 8984 8985#. type: Plain text 8986#: dpkg-architecture.man 8987msgid "The Debian system name of the target machine (since dpkg 1.17.14)." 8988msgstr "" 8989 8990#. type: IP 8991#: dpkg-architecture.man 8992#, no-wrap 8993msgid "B<DEB_TARGET_ARCH_CPU>" 8994msgstr "" 8995 8996#. type: Plain text 8997#: dpkg-architecture.man 8998msgid "The Debian cpu name of the target machine (since dpkg 1.17.14)." 8999msgstr "" 9000 9001#. type: IP 9002#: dpkg-architecture.man 9003#, no-wrap 9004msgid "B<DEB_TARGET_ARCH_BITS>" 9005msgstr "" 9006 9007#. type: Plain text 9008#: dpkg-architecture.man 9009msgid "The pointer size of the target machine (in bits; since dpkg 1.17.14)." 9010msgstr "" 9011 9012#. type: IP 9013#: dpkg-architecture.man 9014#, no-wrap 9015msgid "B<DEB_TARGET_ARCH_ENDIAN>" 9016msgstr "" 9017 9018#. type: Plain text 9019#: dpkg-architecture.man 9020msgid "" 9021"The endianness of the target machine (little / big; since dpkg 1.17.14)." 9022msgstr "" 9023 9024#. type: IP 9025#: dpkg-architecture.man 9026#, no-wrap 9027msgid "B<DEB_TARGET_GNU_CPU>" 9028msgstr "" 9029 9030#. type: Plain text 9031#: dpkg-architecture.man 9032msgid "The CPU part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)." 9033msgstr "" 9034 9035#. type: IP 9036#: dpkg-architecture.man 9037#, no-wrap 9038msgid "B<DEB_TARGET_GNU_SYSTEM>" 9039msgstr "" 9040 9041#. type: Plain text 9042#: dpkg-architecture.man 9043msgid "The System part of B<DEB_TARGET_GNU_TYPE> (since dpkg 1.17.14)." 9044msgstr "" 9045 9046#. type: IP 9047#: dpkg-architecture.man 9048#, no-wrap 9049msgid "B<DEB_TARGET_GNU_TYPE>" 9050msgstr "" 9051 9052#. type: Plain text 9053#: dpkg-architecture.man 9054msgid "The GNU system type of the target machine (since dpkg 1.17.14)." 9055msgstr "" 9056 9057#. type: IP 9058#: dpkg-architecture.man 9059#, no-wrap 9060msgid "B<DEB_TARGET_MULTIARCH>" 9061msgstr "" 9062 9063#. type: Plain text 9064#: dpkg-architecture.man 9065msgid "" 9066"The clarified GNU system type of the target machine, used for filesystem " 9067"paths (since dpkg 1.17.14)." 9068msgstr "" 9069 9070#. type: SS 9071#: dpkg-architecture.man 9072#, no-wrap 9073msgid "Architecture tables" 9074msgstr "" 9075 9076#. type: Plain text 9077#: dpkg-architecture.man 9078msgid "" 9079"All these files have to be present for B<dpkg-architecture> to work. Their " 9080"location can be overridden at runtime with the environment variable " 9081"B<DPKG_DATADIR>. These tables contain a format B<Version> pseudo-field on " 9082"their first line to mark their format, so that parsers can check if they " 9083"understand it, such as \"# Version=1.0\"." 9084msgstr "" 9085 9086#. type: TP 9087#: dpkg-architecture.man 9088#, no-wrap 9089msgid "I<%PKGDATADIR%/cputable>" 9090msgstr "" 9091 9092#. type: Plain text 9093#: dpkg-architecture.man 9094msgid "" 9095"Table of known CPU names and mapping to their GNU name. Format version 1.0 " 9096"(since dpkg 1.13.2)." 9097msgstr "" 9098 9099#. type: TP 9100#: dpkg-architecture.man 9101#, no-wrap 9102msgid "I<%PKGDATADIR%/ostable>" 9103msgstr "" 9104 9105#. type: Plain text 9106#: dpkg-architecture.man 9107msgid "" 9108"Table of known operating system names and mapping to their GNU name. Format " 9109"version 2.0 (since dpkg 1.18.11)." 9110msgstr "" 9111 9112#. type: TP 9113#: dpkg-architecture.man 9114#, no-wrap 9115msgid "I<%PKGDATADIR%/tupletable>" 9116msgstr "" 9117 9118#. type: Plain text 9119#: dpkg-architecture.man 9120msgid "" 9121"Mapping between Debian architecture tuples and Debian architecture names. " 9122"Format version 1.0 (since dpkg 1.18.11)." 9123msgstr "" 9124 9125#. type: TP 9126#: dpkg-architecture.man 9127#, no-wrap 9128msgid "I<%PKGDATADIR%/abitable>" 9129msgstr "" 9130 9131#. type: Plain text 9132#: dpkg-architecture.man 9133msgid "" 9134"Table of Debian architecture ABI attribute overrides. Format version 2.0 " 9135"(since dpkg 1.18.11)." 9136msgstr "" 9137 9138#. type: SS 9139#: dpkg-architecture.man dpkg-buildflags.man 9140#, no-wrap 9141msgid "Packaging support" 9142msgstr "" 9143 9144#. type: TP 9145#: dpkg-architecture.man 9146#, no-wrap 9147msgid "I<%PKGDATADIR%/architecture.mk>" 9148msgstr "" 9149 9150#. type: Plain text 9151#: dpkg-architecture.man 9152msgid "" 9153"Makefile snippet that properly sets and exports all the variables that " 9154"B<dpkg-architecture> outputs (since dpkg 1.16.1)." 9155msgstr "" 9156 9157#. type: Plain text 9158#: dpkg-architecture.man 9159msgid "" 9160"B<dpkg-buildpackage> accepts the B<-a> option and passes it to B<dpkg-" 9161"architecture>. Other examples:" 9162msgstr "" 9163 9164#. type: Plain text 9165#: dpkg-architecture.man 9166msgid "CC=i386-gnu-gcc dpkg-architecture -c debian/rules build" 9167msgstr "" 9168 9169#. type: Plain text 9170#: dpkg-architecture.man 9171msgid "eval \\`dpkg-architecture -u\\`" 9172msgstr "" 9173 9174#. type: Plain text 9175#: dpkg-architecture.man 9176msgid "" 9177"Check if the current or specified host architecture is equal to an " 9178"architecture:" 9179msgstr "" 9180 9181#. type: Plain text 9182#: dpkg-architecture.man 9183msgid "dpkg-architecture -elinux-alpha" 9184msgstr "" 9185 9186#. type: Plain text 9187#: dpkg-architecture.man 9188msgid "dpkg-architecture -amips -elinux-mips" 9189msgstr "" 9190 9191#. type: Plain text 9192#: dpkg-architecture.man 9193msgid "Check if the current or specified host architecture is a Linux system:" 9194msgstr "" 9195 9196#. type: Plain text 9197#: dpkg-architecture.man 9198msgid "dpkg-architecture -ilinux-any" 9199msgstr "" 9200 9201#. type: Plain text 9202#: dpkg-architecture.man 9203msgid "dpkg-architecture -ai386 -ilinux-any" 9204msgstr "" 9205 9206#. type: SS 9207#: dpkg-architecture.man dpkg-buildflags.man 9208#, no-wrap 9209msgid "Usage in debian/rules" 9210msgstr "" 9211 9212#. type: Plain text 9213#: dpkg-architecture.man 9214msgid "" 9215"The environment variables set by B<dpkg-architecture> are passed to I<debian/" 9216"rules> as make variables (see make documentation). However, you should not " 9217"rely on them, as this breaks manual invocation of the script. Instead, you " 9218"should always initialize them using B<dpkg-architecture> with the B<-q> " 9219"option. Here are some examples, which also show how you can improve the " 9220"cross compilation support in your package:" 9221msgstr "" 9222 9223#. type: Plain text 9224#: dpkg-architecture.man 9225msgid "Retrieving the GNU system type and forwarding it to ./configure:" 9226msgstr "" 9227 9228#. type: Plain text 9229#: dpkg-architecture.man 9230#, no-wrap 9231msgid "" 9232"DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)\n" 9233"DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)\n" 9234"[...]\n" 9235"ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))\n" 9236" confflags += --build=$(DEB_HOST_GNU_TYPE)\n" 9237"else\n" 9238" confflags += --build=$(DEB_BUILD_GNU_TYPE) \\e\n" 9239" --host=$(DEB_HOST_GNU_TYPE)\n" 9240"endif\n" 9241"[...]\n" 9242"\\&./configure $(confflags)\n" 9243msgstr "" 9244 9245#. type: Plain text 9246#: dpkg-architecture.man 9247msgid "Doing something only for a specific architecture:" 9248msgstr "" 9249 9250#. type: Plain text 9251#: dpkg-architecture.man 9252#, no-wrap 9253msgid "DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)\n" 9254msgstr "" 9255 9256#. type: Plain text 9257#: dpkg-architecture.man 9258#, no-wrap 9259msgid "" 9260"ifeq ($(DEB_HOST_ARCH),alpha)\n" 9261" [...]\n" 9262"endif\n" 9263msgstr "" 9264 9265#. type: Plain text 9266#: dpkg-architecture.man 9267msgid "" 9268"or if you only need to check the CPU or OS type, use the " 9269"B<DEB_HOST_ARCH_CPU> or B<DEB_HOST_ARCH_OS> variables." 9270msgstr "" 9271 9272#. type: Plain text 9273#: dpkg-architecture.man 9274msgid "" 9275"Note that you can also rely on an external Makefile snippet to properly set " 9276"all the variables that B<dpkg-architecture> can provide:" 9277msgstr "" 9278 9279#. type: Plain text 9280#: dpkg-architecture.man 9281#, no-wrap 9282msgid "include %PKGDATADIR%/architecture.mk\n" 9283msgstr "" 9284 9285#. type: Plain text 9286#: dpkg-architecture.man 9287msgid "" 9288"In any case, you should never use B<dpkg --print-architecture> to get " 9289"architecture information during a package build." 9290msgstr "" 9291 9292#. type: TP 9293#: dpkg-architecture.man 9294#, no-wrap 9295msgid "B<DPKG_DATADIR>" 9296msgstr "" 9297 9298#. type: Plain text 9299#: dpkg-architecture.man 9300msgid "" 9301"If set, it will be used as the B<dpkg> data directory, where the " 9302"architecture tables are located (since dpkg 1.14.17). Defaults to " 9303"«%PKGDATADIR%»." 9304msgstr "" 9305 9306#. type: TP 9307#: dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 9308#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 9309#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 9310#: dpkg-mergechangelogs.man dpkg-name.man dpkg-parsechangelog.man 9311#: dpkg-scanpackages.man dpkg-scansources.man dpkg-shlibdeps.man 9312#: dpkg-source.man dpkg-vendor.man 9313#, no-wrap 9314msgid "B<DPKG_NLS>" 9315msgstr "" 9316 9317#. type: Plain text 9318#: dpkg-architecture.man dpkg-buildflags.man dpkg-buildpackage.man 9319#: dpkg-genbuildinfo.man dpkg-checkbuilddeps.man dpkg-distaddfile.man 9320#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-gensymbols.man 9321#: dpkg-mergechangelogs.man dpkg-name.man dpkg-parsechangelog.man 9322#: dpkg-scanpackages.man dpkg-scansources.man dpkg-shlibdeps.man 9323#: dpkg-source.man dpkg-vendor.man 9324msgid "" 9325"If set, it will be used to decide whether to activate Native Language " 9326"Support, also known as internationalization (or i18n) support (since dpkg " 9327"1.19.0). The accepted values are: B<0> and B<1> (default)." 9328msgstr "" 9329 9330#. type: Plain text 9331#: dpkg-architecture.man 9332msgid "All long command and option names available only since dpkg 1.17.17." 9333msgstr "" 9334 9335#. type: Plain text 9336#: dpkg-architecture.man 9337#, fuzzy 9338#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 9339msgid "B<dpkg-buildpackage>(1)." 9340msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 9341 9342#. type: TH 9343#: dpkg.cfg.man 9344#, no-wrap 9345msgid "dpkg.cfg" 9346msgstr "" 9347 9348#. type: Plain text 9349#: dpkg.cfg.man 9350msgid "dpkg.cfg - dpkg configuration file" 9351msgstr "" 9352 9353#. type: Plain text 9354#: dpkg.cfg.man 9355msgid "" 9356"This file contains default options for dpkg. Each line contains a single " 9357"option which is exactly the same as a normal command line option for dpkg " 9358"except for the leading hyphens which are not used here. Quotes surrounding " 9359"option values are stripped. Comments are allowed by starting a line with a " 9360"hash sign (‘B<#>’)." 9361msgstr "" 9362 9363#. type: Plain text 9364#: dpkg.cfg.man 9365msgid "I<~/.dpkg.cfg>" 9366msgstr "" 9367 9368#. type: TH 9369#: dpkg-buildflags.man 9370#, no-wrap 9371msgid "dpkg-buildflags" 9372msgstr "" 9373 9374#. type: Plain text 9375#: dpkg-buildflags.man 9376msgid "dpkg-buildflags - returns build flags to use during package build" 9377msgstr "" 9378 9379#. type: Plain text 9380#: dpkg-buildflags.man 9381msgid "B<dpkg-buildflags> [I<option>...] [I<command>]" 9382msgstr "" 9383 9384#. type: Plain text 9385#: dpkg-buildflags.man 9386msgid "" 9387"B<dpkg-buildflags> is a tool to retrieve compilation flags to use during " 9388"build of Debian packages." 9389msgstr "" 9390 9391#. type: Plain text 9392#: dpkg-buildflags.man 9393msgid "" 9394"The default flags are defined by the vendor but they can be extended/" 9395"overridden in several ways:" 9396msgstr "" 9397 9398#. type: IP 9399#: dpkg-buildflags.man 9400#, no-wrap 9401msgid "1." 9402msgstr "" 9403 9404#. type: Plain text 9405#: dpkg-buildflags.man 9406msgid "system-wide with B<%PKGCONFDIR%/buildflags.conf>;" 9407msgstr "" 9408 9409#. type: IP 9410#: dpkg-buildflags.man 9411#, no-wrap 9412msgid "2." 9413msgstr "" 9414 9415#. type: Plain text 9416#: dpkg-buildflags.man 9417msgid "" 9418"for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where B<" 9419"$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;" 9420msgstr "" 9421 9422#. type: IP 9423#: dpkg-buildflags.man 9424#, no-wrap 9425msgid "3." 9426msgstr "" 9427 9428#. type: Plain text 9429#: dpkg-buildflags.man 9430msgid "" 9431"temporarily by the user with environment variables (see section " 9432"B<ENVIRONMENT>);" 9433msgstr "" 9434 9435#. type: IP 9436#: dpkg-buildflags.man 9437#, no-wrap 9438msgid "4." 9439msgstr "" 9440 9441#. type: Plain text 9442#: dpkg-buildflags.man 9443msgid "" 9444"dynamically by the package maintainer with environment variables set via " 9445"B<debian/rules> (see section B<ENVIRONMENT>)." 9446msgstr "" 9447 9448#. type: Plain text 9449#: dpkg-buildflags.man 9450msgid "The configuration files can contain four types of directives:" 9451msgstr "" 9452 9453#. type: TP 9454#: dpkg-buildflags.man 9455#, no-wrap 9456msgid "B<SET>I< flag value>" 9457msgstr "" 9458 9459#. type: Plain text 9460#: dpkg-buildflags.man 9461msgid "Override the flag named I<flag> to have the value I<value>." 9462msgstr "" 9463 9464#. type: TP 9465#: dpkg-buildflags.man 9466#, no-wrap 9467msgid "B<STRIP>I< flag value>" 9468msgstr "" 9469 9470#. type: Plain text 9471#: dpkg-buildflags.man 9472msgid "" 9473"Strip from the flag named I<flag> all the build flags listed in I<value>." 9474msgstr "" 9475 9476#. type: TP 9477#: dpkg-buildflags.man 9478#, no-wrap 9479msgid "B<APPEND>I< flag value>" 9480msgstr "" 9481 9482#. type: Plain text 9483#: dpkg-buildflags.man 9484msgid "" 9485"Extend the flag named I<flag> by appending the options given in I<value>. A " 9486"space is prepended to the appended value if the flag's current value is non-" 9487"empty." 9488msgstr "" 9489 9490#. type: TP 9491#: dpkg-buildflags.man 9492#, no-wrap 9493msgid "B<PREPEND>I< flag value>" 9494msgstr "" 9495 9496#. type: Plain text 9497#: dpkg-buildflags.man 9498msgid "" 9499"Extend the flag named I<flag> by prepending the options given in I<value>. " 9500"A space is appended to the prepended value if the flag's current value is " 9501"non-empty." 9502msgstr "" 9503 9504#. type: Plain text 9505#: dpkg-buildflags.man 9506msgid "" 9507"The configuration files can contain comments on lines starting with a hash " 9508"(#). Empty lines are also ignored." 9509msgstr "" 9510 9511#. type: TP 9512#: dpkg-buildflags.man 9513#, no-wrap 9514msgid "B<--dump>" 9515msgstr "" 9516 9517#. type: Plain text 9518#: dpkg-buildflags.man 9519msgid "" 9520"Print to standard output all compilation flags and their values. It prints " 9521"one flag per line separated from its value by an equal sign " 9522"(“I<flag>=I<value>”). This is the default action." 9523msgstr "" 9524 9525#. type: TP 9526#: dpkg-buildflags.man 9527#, no-wrap 9528msgid "B<--list>" 9529msgstr "" 9530 9531#. type: Plain text 9532#: dpkg-buildflags.man 9533msgid "" 9534"Print the list of flags supported by the current vendor (one per line). See " 9535"the B<SUPPORTED FLAGS> section for more information about them." 9536msgstr "" 9537 9538#. type: TP 9539#: dpkg-buildflags.man 9540#, no-wrap 9541msgid "B<--status>" 9542msgstr "" 9543 9544#. type: Plain text 9545#: dpkg-buildflags.man 9546msgid "" 9547"Display any information that can be useful to explain the behaviour of " 9548"B<dpkg-buildflags> (since dpkg 1.16.5): relevant environment variables, " 9549"current vendor, state of all feature flags. Also print the resulting " 9550"compiler flags with their origin." 9551msgstr "" 9552 9553#. type: Plain text 9554#: dpkg-buildflags.man 9555msgid "" 9556"This is intended to be run from B<debian/rules>, so that the build log keeps " 9557"a clear trace of the build flags used. This can be useful to diagnose " 9558"problems related to them." 9559msgstr "" 9560 9561#. type: TP 9562#: dpkg-buildflags.man 9563#, no-wrap 9564msgid "B<--export=>I<format>" 9565msgstr "" 9566 9567#. type: Plain text 9568#: dpkg-buildflags.man 9569msgid "" 9570"Print to standard output commands that can be used to export all the " 9571"compilation flags for some particular tool. If the I<format> value is not " 9572"given, B<sh> is assumed. Only compilation flags starting with an upper case " 9573"character are included, others are assumed to not be suitable for the " 9574"environment. Supported formats:" 9575msgstr "" 9576 9577#. type: TP 9578#: dpkg-buildflags.man 9579#, no-wrap 9580msgid "B<sh>" 9581msgstr "" 9582 9583#. type: Plain text 9584#: dpkg-buildflags.man 9585msgid "" 9586"Shell commands to set and export all the compilation flags in the " 9587"environment. The flag values are quoted so the output is ready for " 9588"evaluation by a shell." 9589msgstr "" 9590 9591#. type: TP 9592#: dpkg-buildflags.man 9593#, no-wrap 9594msgid "B<cmdline>" 9595msgstr "" 9596 9597#. type: Plain text 9598#: dpkg-buildflags.man 9599msgid "" 9600"Arguments to pass to a build program's command line to use all the " 9601"compilation flags (since dpkg 1.17.0). The flag values are quoted in shell " 9602"syntax." 9603msgstr "" 9604 9605#. type: TP 9606#: dpkg-buildflags.man 9607#, no-wrap 9608msgid "B<configure>" 9609msgstr "" 9610 9611#. type: Plain text 9612#: dpkg-buildflags.man 9613msgid "This is a legacy alias for B<cmdline>." 9614msgstr "" 9615 9616#. type: TP 9617#: dpkg-buildflags.man 9618#, no-wrap 9619msgid "B<make>" 9620msgstr "" 9621 9622#. type: Plain text 9623#: dpkg-buildflags.man 9624msgid "" 9625"Make directives to set and export all the compilation flags in the " 9626"environment. Output can be written to a Makefile fragment and evaluated " 9627"using an B<include> directive." 9628msgstr "" 9629 9630#. type: TP 9631#: dpkg-buildflags.man 9632#, no-wrap 9633msgid "B<--get>I< flag>" 9634msgstr "" 9635 9636#. type: Plain text 9637#: dpkg-buildflags.man 9638msgid "" 9639"Print the value of the flag on standard output. Exits with 0 if the flag is " 9640"known otherwise exits with 1." 9641msgstr "" 9642 9643#. type: TP 9644#: dpkg-buildflags.man 9645#, no-wrap 9646msgid "B<--origin>I< flag>" 9647msgstr "" 9648 9649#. type: Plain text 9650#: dpkg-buildflags.man 9651msgid "" 9652"Print the origin of the value that is returned by B<--get>. Exits with 0 if " 9653"the flag is known otherwise exits with 1. The origin can be one of the " 9654"following values:" 9655msgstr "" 9656 9657#. type: TP 9658#: dpkg-buildflags.man 9659#, no-wrap 9660msgid "B<vendor>" 9661msgstr "" 9662 9663#. type: Plain text 9664#: dpkg-buildflags.man 9665msgid "the original flag set by the vendor is returned;" 9666msgstr "" 9667 9668#. type: TP 9669#: dpkg-buildflags.man 9670#, no-wrap 9671msgid "B<system>" 9672msgstr "" 9673 9674#. type: Plain text 9675#: dpkg-buildflags.man 9676msgid "the flag is set/modified by a system-wide configuration;" 9677msgstr "" 9678 9679#. type: TP 9680#: dpkg-buildflags.man 9681#, no-wrap 9682msgid "B<user>" 9683msgstr "" 9684 9685#. type: Plain text 9686#: dpkg-buildflags.man 9687msgid "the flag is set/modified by a user-specific configuration;" 9688msgstr "" 9689 9690#. type: TP 9691#: dpkg-buildflags.man 9692#, no-wrap 9693msgid "B<env>" 9694msgstr "" 9695 9696#. type: Plain text 9697#: dpkg-buildflags.man 9698msgid "the flag is set/modified by an environment-specific configuration." 9699msgstr "" 9700 9701#. type: TP 9702#: dpkg-buildflags.man 9703#, fuzzy, no-wrap 9704#| msgid "B<--version>" 9705msgid "B<--query>" 9706msgstr "B<--version>" 9707 9708#. type: Plain text 9709#: dpkg-buildflags.man 9710msgid "" 9711"Print any information that can be useful to explain the behaviour of the " 9712"program: current vendor, relevant environment variables, feature areas, " 9713"state of all feature flags, and the compiler flags with their origin (since " 9714"dpkg 1.19.0)." 9715msgstr "" 9716 9717#. type: Plain text 9718#: dpkg-buildflags.man 9719msgid "For example:" 9720msgstr "" 9721 9722#. type: Plain text 9723#: dpkg-buildflags.man 9724#, no-wrap 9725msgid "" 9726" Vendor: Debian\n" 9727" Environment:\n" 9728" DEB_CFLAGS_SET=-O0 -Wall\n" 9729msgstr "" 9730 9731#. type: Plain text 9732#: dpkg-buildflags.man 9733#, no-wrap 9734msgid "" 9735" Area: qa\n" 9736" Features:\n" 9737" bug=no\n" 9738" canary=no\n" 9739msgstr "" 9740 9741#. type: Plain text 9742#: dpkg-buildflags.man 9743#, no-wrap 9744msgid "" 9745" Area: reproducible\n" 9746" Features:\n" 9747" timeless=no\n" 9748msgstr "" 9749 9750#. type: Plain text 9751#: dpkg-buildflags.man 9752#, no-wrap 9753msgid "" 9754" Flag: CFLAGS\n" 9755" Value: -O0 -Wall\n" 9756" Origin: env\n" 9757msgstr "" 9758 9759#. type: Plain text 9760#: dpkg-buildflags.man 9761#, no-wrap 9762msgid "" 9763" Flag: CPPFLAGS\n" 9764" Value: -D_FORTIFY_SOURCE=2\n" 9765" Origin: vendor\n" 9766msgstr "" 9767 9768#. type: TP 9769#: dpkg-buildflags.man 9770#, no-wrap 9771msgid "B<--query-features>I< area>" 9772msgstr "" 9773 9774#. type: Plain text 9775#: dpkg-buildflags.man 9776msgid "" 9777"Print the features enabled for a given area (since dpkg 1.16.2). The only " 9778"currently recognized areas on Debian and derivatives are B<future>, B<qa>, " 9779"B<reproducible>, B<sanitize> and B<hardening>, see the B<FEATURE AREAS> " 9780"section for more details. Exits with 0 if the area is known otherwise exits " 9781"with 1." 9782msgstr "" 9783 9784#. type: Plain text 9785#: dpkg-buildflags.man 9786msgid "" 9787"The output is in RFC822 format, with one section per feature. For example:" 9788msgstr "" 9789 9790#. type: Plain text 9791#: dpkg-buildflags.man 9792#, no-wrap 9793msgid "" 9794" Feature: pie\n" 9795" Enabled: yes\n" 9796msgstr "" 9797 9798#. type: Plain text 9799#: dpkg-buildflags.man 9800#, no-wrap 9801msgid "" 9802" Feature: stackprotector\n" 9803" Enabled: yes\n" 9804msgstr "" 9805 9806#. type: TP 9807#: dpkg-buildflags.man dpkg-mergechangelogs.man dpkg-scansources.man 9808#: dpkg-statoverride.man dpkg-vendor.man update-alternatives.man 9809#, no-wrap 9810msgid "B<--help>" 9811msgstr "" 9812 9813#. type: SH 9814#: dpkg-buildflags.man 9815#, no-wrap 9816msgid "SUPPORTED FLAGS" 9817msgstr "" 9818 9819#. type: TP 9820#: dpkg-buildflags.man 9821#, no-wrap 9822msgid "B<CFLAGS>" 9823msgstr "" 9824 9825#. type: Plain text 9826#: dpkg-buildflags.man 9827msgid "" 9828"Options for the C compiler. The default value set by the vendor includes B<-" 9829"g> and the default optimization level (B<-O2> usually, or B<-O0> if the " 9830"B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>)." 9831msgstr "" 9832 9833#. type: TP 9834#: dpkg-buildflags.man 9835#, no-wrap 9836msgid "B<CPPFLAGS>" 9837msgstr "B<CPPFLAGS>" 9838 9839#. type: Plain text 9840#: dpkg-buildflags.man 9841msgid "Options for the C preprocessor. Default value: empty." 9842msgstr "C 预处理器选项。默认：空。" 9843 9844#. type: TP 9845#: dpkg-buildflags.man 9846#, no-wrap 9847msgid "B<CXXFLAGS>" 9848msgstr "B<CXXFLAGS>" 9849 9850#. type: Plain text 9851#: dpkg-buildflags.man 9852msgid "Options for the C++ compiler. Same as B<CFLAGS>." 9853msgstr "C++ 编译器选项。同 B<CFLAGS>。" 9854 9855#. type: TP 9856#: dpkg-buildflags.man 9857#, no-wrap 9858msgid "B<OBJCFLAGS>" 9859msgstr "B<OBJCFLAGS>" 9860 9861#. type: Plain text 9862#: dpkg-buildflags.man 9863msgid "Options for the Objective C compiler. Same as B<CFLAGS>." 9864msgstr "Objective-C 编译器选项。同 B<CFLAGS>。" 9865 9866#. type: TP 9867#: dpkg-buildflags.man 9868#, no-wrap 9869msgid "B<OBJCXXFLAGS>" 9870msgstr "B<OBJCXXFLAGS>" 9871 9872#. type: Plain text 9873#: dpkg-buildflags.man 9874msgid "Options for the Objective C++ compiler. Same as B<CXXFLAGS>." 9875msgstr "Objective-C++ 编译器选项。同 B<CXXFLAGS>。" 9876 9877#. type: TP 9878#: dpkg-buildflags.man 9879#, no-wrap 9880msgid "B<GCJFLAGS>" 9881msgstr "B<GCJFLAGS>" 9882 9883#. type: Plain text 9884#: dpkg-buildflags.man 9885msgid "Options for the GNU Java compiler (gcj). A subset of B<CFLAGS>." 9886msgstr "GNU Java 编译器(gcj)选项。B<CFLAGS> 的子集。" 9887 9888#. type: TP 9889#: dpkg-buildflags.man 9890#, no-wrap 9891msgid "B<FFLAGS>" 9892msgstr "B<FFLAGS>" 9893 9894#. type: Plain text 9895#: dpkg-buildflags.man 9896msgid "Options for the Fortran 77 compiler. A subset of B<CFLAGS>." 9897msgstr "Fortran 77 编译器选项。B<CFLAGS> 的子集。" 9898 9899#. type: TP 9900#: dpkg-buildflags.man 9901#, no-wrap 9902msgid "B<FCFLAGS>" 9903msgstr "B<FCFLAGS>" 9904 9905#. type: Plain text 9906#: dpkg-buildflags.man 9907msgid "Options for the Fortran 9x compiler. Same as B<FFLAGS>." 9908msgstr "Fortran 9x 编译器选项。同 B<FFLAGS>。" 9909 9910#. type: TP 9911#: dpkg-buildflags.man 9912#, no-wrap 9913msgid "B<LDFLAGS>" 9914msgstr "B<LDFLAGS>" 9915 9916#. type: Plain text 9917#: dpkg-buildflags.man 9918msgid "" 9919"Options passed to the compiler when linking executables or shared objects " 9920"(if the linker is called directly, then B<-Wl> and B<,> have to be stripped " 9921"from these options). Default value: empty." 9922msgstr "" 9923 9924#. type: Plain text 9925#: dpkg-buildflags.man 9926msgid "" 9927"New flags might be added in the future if the need arises (for example to " 9928"support other languages)." 9929msgstr "" 9930 9931#. type: SH 9932#: dpkg-buildflags.man 9933#, no-wrap 9934msgid "FEATURE AREAS" 9935msgstr "" 9936 9937#. type: Plain text 9938#: dpkg-buildflags.man 9939msgid "" 9940"Each area feature can be enabled and disabled in the B<DEB_BUILD_OPTIONS> " 9941"and B<DEB_BUILD_MAINT_OPTIONS> environment variable's area value with the ‘B<" 9942"+>’ and ‘B<->’ modifier. For example, to enable the B<hardening> “pie” " 9943"feature and disable the “fortify” feature you can do this in B<debian/rules>:" 9944msgstr "" 9945 9946#. type: Plain text 9947#: dpkg-buildflags.man 9948#, no-wrap 9949msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify\n" 9950msgstr "" 9951 9952#. type: Plain text 9953#: dpkg-buildflags.man 9954msgid "" 9955"The special feature B<all> (valid in any area) can be used to enable or " 9956"disable all area features at the same time. Thus disabling everything in " 9957"the B<hardening> area and enabling only “format” and “fortify” can be " 9958"achieved with:" 9959msgstr "" 9960 9961#. type: Plain text 9962#: dpkg-buildflags.man 9963#, no-wrap 9964msgid " export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify\n" 9965msgstr "" 9966 9967#. type: SS 9968#: dpkg-buildflags.man 9969#, no-wrap 9970msgid "future" 9971msgstr "" 9972 9973#. type: Plain text 9974#: dpkg-buildflags.man 9975msgid "" 9976"Several compile-time options (detailed below) can be used to enable features " 9977"that should be enabled by default, but cannot due to backwards compatibility " 9978"reasons." 9979msgstr "" 9980 9981#. type: TP 9982#: dpkg-buildflags.man 9983#, no-wrap 9984msgid "B<lfs>" 9985msgstr "" 9986 9987#. type: Plain text 9988#: dpkg-buildflags.man 9989msgid "" 9990"This setting (disabled by default) enables Large File Support on 32-bit " 9991"architectures where their ABI does not include LFS by default, by adding B<-" 9992"D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64> to B<CPPFLAGS>." 9993msgstr "" 9994 9995#. type: SS 9996#: dpkg-buildflags.man 9997#, no-wrap 9998msgid "qa" 9999msgstr "" 10000 10001#. type: Plain text 10002#: dpkg-buildflags.man 10003msgid "" 10004"Several compile-time options (detailed below) can be used to help detect " 10005"problems in the source code or build system." 10006msgstr "" 10007 10008#. type: TP 10009#: dpkg-buildflags.man 10010#, no-wrap 10011msgid "B<bug>" 10012msgstr "" 10013 10014#. type: Plain text 10015#: dpkg-buildflags.man 10016msgid "" 10017"This setting (disabled by default) adds any warning option that reliably " 10018"detects problematic source code. The warnings are fatal. The only currently " 10019"supported flags are B<CFLAGS> and B<CXXFLAGS> with flags set to B<-" 10020"Werror=array-bounds>, B<-Werror=clobbered>, B<-Werror=implicit-function-" 10021"declaration> and B<-Werror=volatile-register-var>." 10022msgstr "" 10023 10024#. type: TP 10025#: dpkg-buildflags.man 10026#, no-wrap 10027msgid "B<canary>" 10028msgstr "" 10029 10030#. type: Plain text 10031#: dpkg-buildflags.man 10032msgid "" 10033"This setting (disabled by default) adds dummy canary options to the build " 10034"flags, so that the build logs can be checked for how the build flags " 10035"propagate and to allow finding any omission of normal build flag settings. " 10036"The only currently supported flags are B<CPPFLAGS>, B<CFLAGS>, B<OBJCFLAGS>, " 10037"B<CXXFLAGS> and B<OBJCXXFLAGS> with flags set to B<-" 10038"D__DEB_CANARY_>I<flag>_I<random-id>B<__>, and B<LDFLAGS> set to B<-Wl,-z,deb-" 10039"canary->I<random-id>." 10040msgstr "" 10041 10042#. type: SS 10043#: dpkg-buildflags.man 10044#, no-wrap 10045msgid "sanitize" 10046msgstr "" 10047 10048#. type: Plain text 10049#: dpkg-buildflags.man 10050msgid "" 10051"Several compile-time options (detailed below) can be used to help sanitize a " 10052"resulting binary against memory corruptions, memory leaks, use after free, " 10053"threading data races and undefined behavior bugs. B<Note>: these options " 10054"should B<not> be used for production builds as they can reduce reliability " 10055"for conformant code, reduce security or even functionality." 10056msgstr "" 10057 10058#. type: TP 10059#: dpkg-buildflags.man 10060#, no-wrap 10061msgid "B<address>" 10062msgstr "" 10063 10064#. type: Plain text 10065#: dpkg-buildflags.man 10066msgid "" 10067"This setting (disabled by default) adds B<-fsanitize=address> to B<LDFLAGS> " 10068"and B<-fsanitize=address -fno-omit-frame-pointer> to B<CFLAGS> and " 10069"B<CXXFLAGS>." 10070msgstr "" 10071 10072#. type: TP 10073#: dpkg-buildflags.man 10074#, no-wrap 10075msgid "B<thread>" 10076msgstr "" 10077 10078#. type: Plain text 10079#: dpkg-buildflags.man 10080msgid "" 10081"This setting (disabled by default) adds B<-fsanitize=thread> to B<CFLAGS>, " 10082"B<CXXFLAGS> and B<LDFLAGS>." 10083msgstr "" 10084 10085#. type: TP 10086#: dpkg-buildflags.man 10087#, no-wrap 10088msgid "B<leak>" 10089msgstr "" 10090 10091#. type: Plain text 10092#: dpkg-buildflags.man 10093msgid "" 10094"This setting (disabled by default) adds B<-fsanitize=leak> to B<LDFLAGS>. It " 10095"gets automatically disabled if either the B<address> or the B<thread> " 10096"features are enabled, as they imply it." 10097msgstr "" 10098 10099#. type: TP 10100#: dpkg-buildflags.man 10101#, fuzzy, no-wrap 10102#| msgid "B<unpacked>" 10103msgid "B<undefined>" 10104msgstr "B<unpacked>" 10105 10106#. type: Plain text 10107#: dpkg-buildflags.man 10108msgid "" 10109"This setting (disabled by default) adds B<-fsanitize=undefined> to " 10110"B<CFLAGS>, B<CXXFLAGS> and B<LDFLAGS>." 10111msgstr "" 10112 10113#. type: SS 10114#: dpkg-buildflags.man 10115#, fuzzy, no-wrap 10116#| msgid "Warnings" 10117msgid "hardening" 10118msgstr "警告" 10119 10120#. type: Plain text 10121#: dpkg-buildflags.man 10122msgid "" 10123"Several compile-time options (detailed below) can be used to help harden a " 10124"resulting binary against memory corruption attacks, or provide additional " 10125"warning messages during compilation. Except as noted below, these are " 10126"enabled by default for architectures that support them." 10127msgstr "" 10128 10129#. type: TP 10130#: dpkg-buildflags.man 10131#, no-wrap 10132msgid "B<format>" 10133msgstr "" 10134 10135#. type: Plain text 10136#: dpkg-buildflags.man 10137msgid "" 10138"This setting (enabled by default) adds B<-Wformat -Werror=format-security> " 10139"to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS> and B<OBJCXXFLAGS>. This will warn " 10140"about improper format string uses, and will fail when format functions are " 10141"used in a way that represent possible security problems. At present, this " 10142"warns about calls to B<printf> and B<scanf> functions where the format " 10143"string is not a string literal and there are no format arguments, as in " 10144"B<printf(foo);> instead of B<printf(\"%s\", foo);> This may be a security " 10145"hole if the format string came from untrusted input and contains ‘%n’." 10146msgstr "" 10147 10148#. type: TP 10149#: dpkg-buildflags.man 10150#, no-wrap 10151msgid "B<fortify>" 10152msgstr "" 10153 10154#. type: Plain text 10155#: dpkg-buildflags.man 10156msgid "" 10157"This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to " 10158"B<CPPFLAGS>. During code generation the compiler knows a great deal of " 10159"information about buffer sizes (where possible), and attempts to replace " 10160"insecure unlimited length buffer function calls with length-limited ones. " 10161"This is especially useful for old, crufty code. Additionally, format " 10162"strings in writable memory that contain ‘%n’ are blocked. If an application " 10163"depends on such a format string, it will need to be worked around." 10164msgstr "" 10165 10166#. type: Plain text 10167#: dpkg-buildflags.man 10168msgid "" 10169"Note that for this option to have any effect, the source must also be " 10170"compiled with B<-O1> or higher. If the environment variable " 10171"B<DEB_BUILD_OPTIONS> contains I<noopt>, then B<fortify> support will be " 10172"disabled, due to new warnings being issued by glibc 2.16 and later." 10173msgstr "" 10174 10175#. type: TP 10176#: dpkg-buildflags.man 10177#, no-wrap 10178msgid "B<stackprotector>" 10179msgstr "" 10180 10181#. type: Plain text 10182#: dpkg-buildflags.man 10183msgid "" 10184"This setting (enabled by default if stackprotectorstrong is not in use) adds " 10185"B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS>, B<CXXFLAGS>, " 10186"B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and B<FCFLAGS>. This " 10187"adds safety checks against stack overwrites. This renders many potential " 10188"code injection attacks into aborting situations. In the best case this turns " 10189"code injection vulnerabilities into denial of service or into non-issues " 10190"(depending on the application)." 10191msgstr "" 10192 10193#. type: Plain text 10194#: dpkg-buildflags.man 10195msgid "" 10196"This feature requires linking against glibc (or another provider of " 10197"B<__stack_chk_fail>), so needs to be disabled when building with B<-" 10198"nostdlib> or B<-ffreestanding> or similar." 10199msgstr "" 10200 10201#. type: TP 10202#: dpkg-buildflags.man 10203#, no-wrap 10204msgid "B<stackprotectorstrong>" 10205msgstr "" 10206 10207#. type: Plain text 10208#: dpkg-buildflags.man 10209msgid "" 10210"This setting (enabled by default) adds B<-fstack-protector-strong> to " 10211"B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> " 10212"and B<FCFLAGS>. This is a stronger variant of B<stackprotector>, but " 10213"without significant performance penalties." 10214msgstr "" 10215 10216#. type: Plain text 10217#: dpkg-buildflags.man 10218msgid "Disabling B<stackprotector> will also disable this setting." 10219msgstr "" 10220 10221#. type: Plain text 10222#: dpkg-buildflags.man 10223msgid "" 10224"This feature has the same requirements as B<stackprotector>, and in addition " 10225"also requires gcc 4.9 and later." 10226msgstr "" 10227 10228#. type: TP 10229#: dpkg-buildflags.man 10230#, no-wrap 10231msgid "B<relro>" 10232msgstr "" 10233 10234#. type: Plain text 10235#: dpkg-buildflags.man 10236msgid "" 10237"This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>. " 10238"During program load, several ELF memory sections need to be written to by " 10239"the linker. This flags the loader to turn these sections read-only before " 10240"turning over control to the program. Most notably this prevents GOT " 10241"overwrite attacks. If this option is disabled, B<bindnow> will become " 10242"disabled as well." 10243msgstr "" 10244 10245#. type: TP 10246#: dpkg-buildflags.man 10247#, no-wrap 10248msgid "B<bindnow>" 10249msgstr "" 10250 10251#. type: Plain text 10252#: dpkg-buildflags.man 10253msgid "" 10254"This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During " 10255"program load, all dynamic symbols are resolved, allowing for the entire PLT " 10256"to be marked read-only (due to B<relro> above). The option cannot become " 10257"enabled if B<relro> is not enabled." 10258msgstr "" 10259 10260#. type: TP 10261#: dpkg-buildflags.man 10262#, no-wrap 10263msgid "B<pie>" 10264msgstr "" 10265 10266#. type: Plain text 10267#: dpkg-buildflags.man 10268msgid "" 10269"This setting (with no global default since dpkg 1.18.23, as it is enabled by " 10270"default now by gcc on the amd64, arm64, armel, armhf, hurd-i386, i386, " 10271"kfreebsd-amd64, kfreebsd-i386, mips, mipsel, mips64el, powerpc, ppc64, " 10272"ppc64el, riscv64, s390x, sparc and sparc64 Debian architectures) adds the " 10273"required options to enable or disable PIE via gcc specs files, if needed, " 10274"depending on whether gcc injects on that architecture the flags by itself or " 10275"not. When the setting is enabled and gcc injects the flags, it adds " 10276"nothing. When the setting is enabled and gcc does not inject the flags, it " 10277"adds B<-fPIE> (via I<%PKGDATADIR%/pie-compiler.specs>) to B<CFLAGS>, " 10278"B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and " 10279"B<FCFLAGS>, and B<-fPIE -pie> (via I<%PKGDATADIR%/pie-link.specs>) to " 10280"B<LDFLAGS>. When the setting is disabled and gcc injects the flags, it adds " 10281"B<-fno-PIE> (via I<%PKGDATADIR%/no-pie-compile.specs>) to B<CFLAGS>, " 10282"B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, B<FFLAGS> and " 10283"B<FCFLAGS>, and B<-fno-PIE -no-pie> (via I<%PKGDATADIR%/no-pie-link.specs>) " 10284"to B<LDFLAGS>." 10285msgstr "" 10286 10287#. type: Plain text 10288#: dpkg-buildflags.man 10289msgid "" 10290"Position Independent Executable are needed to take advantage of Address " 10291"Space Layout Randomization, supported by some kernel versions. While ASLR " 10292"can already be enforced for data areas in the stack and heap (brk and mmap), " 10293"the code areas must be compiled as position-independent. Shared libraries " 10294"already do this (B<-fPIC>), so they gain ASLR automatically, but binary ." 10295"text regions need to be build PIE to gain ASLR. When this happens, ROP " 10296"(Return Oriented Programming) attacks are much harder since there are no " 10297"static locations to bounce off of during a memory corruption attack." 10298msgstr "" 10299 10300#. type: Plain text 10301#: dpkg-buildflags.man 10302msgid "" 10303"PIE is not compatible with B<-fPIC>, so in general care must be taken when " 10304"building shared objects. But because the PIE flags emitted get injected via " 10305"gcc specs files, it should always be safe to unconditionally set them " 10306"regardless of the object type being compiled or linked." 10307msgstr "" 10308 10309#. type: Plain text 10310#: dpkg-buildflags.man 10311msgid "" 10312"Static libraries can be used by programs or other shared libraries. " 10313"Depending on the flags used to compile all the objects within a static " 10314"library, these libraries will be usable by different sets of objects:" 10315msgstr "" 10316 10317#. type: TP 10318#: dpkg-buildflags.man 10319#, no-wrap 10320msgid "none" 10321msgstr "" 10322 10323#. type: Plain text 10324#: dpkg-buildflags.man 10325msgid "Cannot be linked into a PIE program, nor a shared library." 10326msgstr "" 10327 10328#. type: TP 10329#: dpkg-buildflags.man 10330#, no-wrap 10331msgid "B<-fPIE>" 10332msgstr "" 10333 10334#. type: Plain text 10335#: dpkg-buildflags.man 10336msgid "Can be linked into any program, but not a shared library (recommended)." 10337msgstr "" 10338 10339#. type: TP 10340#: dpkg-buildflags.man 10341#, no-wrap 10342msgid "B<-fPIC>" 10343msgstr "" 10344 10345#. type: Plain text 10346#: dpkg-buildflags.man 10347msgid "Can be linked into any program and shared library." 10348msgstr "" 10349 10350#. type: Plain text 10351#: dpkg-buildflags.man 10352msgid "" 10353"If there is a need to set these flags manually, bypassing the gcc specs " 10354"injection, there are several things to take into account. Unconditionally " 10355"and explicitly passing B<-fPIE>, B<-fpie> or B<-pie> to a build-system using " 10356"libtool is safe as these flags will get stripped when building shared " 10357"libraries. Otherwise on projects that build both programs and shared " 10358"libraries you might need to make sure that when building the shared " 10359"libraries B<-fPIC> is always passed last (so that it overrides any previous " 10360"B<-PIE>) to compilation flags such as B<CFLAGS>, and B<-shared> is passed " 10361"last (so that it overrides any previous B<-pie>) to linking flags such as " 10362"B<LDFLAGS>. B<Note:> This should not be needed with the default gcc specs " 10363"machinery." 10364msgstr "" 10365 10366#. type: Plain text 10367#: dpkg-buildflags.man 10368msgid "" 10369"Additionally, since PIE is implemented via a general register, some register " 10370"starved architectures (but not including i386 anymore since optimizations " 10371"implemented in gcc E<gt>= 5) can see performance losses of up to 15% in very " 10372"text-segment-heavy application workloads; most workloads see less than 1%. " 10373"Architectures with more general registers (e.g. amd64) do not see as high a " 10374"worst-case penalty." 10375msgstr "" 10376 10377#. type: SS 10378#: dpkg-buildflags.man 10379#, no-wrap 10380msgid "reproducible" 10381msgstr "" 10382 10383#. type: Plain text 10384#: dpkg-buildflags.man 10385msgid "" 10386"The compile-time options detailed below can be used to help improve build " 10387"reproducibility or provide additional warning messages during compilation. " 10388"Except as noted below, these are enabled by default for architectures that " 10389"support them." 10390msgstr "" 10391 10392#. type: TP 10393#: dpkg-buildflags.man 10394#, no-wrap 10395msgid "B<timeless>" 10396msgstr "" 10397 10398#. type: Plain text 10399#: dpkg-buildflags.man 10400msgid "" 10401"This setting (enabled by default) adds B<-Wdate-time> to B<CPPFLAGS>. This " 10402"will cause warnings when the B<__TIME__>, B<__DATE__> and B<__TIMESTAMP__> " 10403"macros are used." 10404msgstr "" 10405 10406#. type: TP 10407#: dpkg-buildflags.man 10408#, fuzzy, no-wrap 10409#| msgid "B<config-files>" 10410msgid "B<fixfilepath>" 10411msgstr "B<config-files>" 10412 10413#. type: Plain text 10414#: dpkg-buildflags.man 10415msgid "" 10416"This setting (disabled by default) adds B<-ffile-prefix-map=>I<BUILDPATH>B<=." 10417"> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, " 10418"B<FFLAGS> and B<FCFLAGS> where B<BUILDPATH> is set to the top-level " 10419"directory of the package being built. This has the effect of removing the " 10420"build path from any generated file." 10421msgstr "" 10422 10423#. type: Plain text 10424#: dpkg-buildflags.man 10425msgid "" 10426"If both B<fixdebugpath> and B<fixfilepath> are set, this option takes " 10427"precedence, because it is a superset of the former." 10428msgstr "" 10429 10430#. type: TP 10431#: dpkg-buildflags.man 10432#, no-wrap 10433msgid "B<fixdebugpath>" 10434msgstr "" 10435 10436#. type: Plain text 10437#: dpkg-buildflags.man 10438msgid "" 10439"This setting (enabled by default) adds B<-fdebug-prefix-map=>I<BUILDPATH>B<=." 10440"> to B<CFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, B<GCJFLAGS>, " 10441"B<FFLAGS> and B<FCFLAGS> where B<BUILDPATH> is set to the top-level " 10442"directory of the package being built. This has the effect of removing the " 10443"build path from any generated debug symbols." 10444msgstr "" 10445 10446#. type: Plain text 10447#: dpkg-buildflags.man 10448msgid "" 10449"There are 2 sets of environment variables doing the same operations, the " 10450"first one (DEB_I<flag>_I<op>) should never be used within B<debian/rules>. " 10451"It's meant for any user that wants to rebuild the source package with " 10452"different build flags. The second set (DEB_I<flag>_MAINT_I<op>) should only " 10453"be used in B<debian/rules> by package maintainers to change the resulting " 10454"build flags." 10455msgstr "" 10456 10457#. type: TP 10458#: dpkg-buildflags.man 10459#, no-wrap 10460msgid "B<DEB_>I<flag>B<_SET>" 10461msgstr "" 10462 10463#. type: TQ 10464#: dpkg-buildflags.man 10465#, no-wrap 10466msgid "B<DEB_>I<flag>B<_MAINT_SET>" 10467msgstr "" 10468 10469#. type: Plain text 10470#: dpkg-buildflags.man 10471msgid "" 10472"This variable can be used to force the value returned for the given I<flag>." 10473msgstr "" 10474 10475#. type: TP 10476#: dpkg-buildflags.man 10477#, no-wrap 10478msgid "B<DEB_>I<flag>B<_STRIP>" 10479msgstr "" 10480 10481#. type: TQ 10482#: dpkg-buildflags.man 10483#, no-wrap 10484msgid "B<DEB_>I<flag>B<_MAINT_STRIP>" 10485msgstr "" 10486 10487#. type: Plain text 10488#: dpkg-buildflags.man 10489msgid "" 10490"This variable can be used to provide a space separated list of options that " 10491"will be stripped from the set of flags returned for the given I<flag>." 10492msgstr "" 10493 10494#. type: TP 10495#: dpkg-buildflags.man 10496#, no-wrap 10497msgid "B<DEB_>I<flag>B<_APPEND>" 10498msgstr "" 10499 10500#. type: TQ 10501#: dpkg-buildflags.man 10502#, no-wrap 10503msgid "B<DEB_>I<flag>B<_MAINT_APPEND>" 10504msgstr "" 10505 10506#. type: Plain text 10507#: dpkg-buildflags.man 10508msgid "" 10509"This variable can be used to append supplementary options to the value " 10510"returned for the given I<flag>." 10511msgstr "" 10512 10513#. type: TP 10514#: dpkg-buildflags.man 10515#, no-wrap 10516msgid "B<DEB_>I<flag>B<_PREPEND>" 10517msgstr "" 10518 10519#. type: TQ 10520#: dpkg-buildflags.man 10521#, no-wrap 10522msgid "B<DEB_>I<flag>B<_MAINT_PREPEND>" 10523msgstr "" 10524 10525#. type: Plain text 10526#: dpkg-buildflags.man 10527msgid "" 10528"This variable can be used to prepend supplementary options to the value " 10529"returned for the given I<flag>." 10530msgstr "" 10531 10532#. type: TP 10533#: dpkg-buildflags.man dpkg-buildpackage.man dpkg-genbuildinfo.man 10534#, no-wrap 10535msgid "B<DEB_BUILD_OPTIONS>" 10536msgstr "" 10537 10538#. type: TQ 10539#: dpkg-buildflags.man 10540#, no-wrap 10541msgid "B<DEB_BUILD_MAINT_OPTIONS>" 10542msgstr "" 10543 10544#. type: Plain text 10545#: dpkg-buildflags.man 10546msgid "" 10547"These variables can be used by a user or maintainer to disable/enable " 10548"various area features that affect build flags. The " 10549"B<DEB_BUILD_MAINT_OPTIONS> variable overrides any setting in the " 10550"B<DEB_BUILD_OPTIONS> feature areas. See the B<FEATURE AREAS> section for " 10551"details." 10552msgstr "" 10553 10554#. type: TP 10555#: dpkg-buildflags.man dpkg-vendor.man 10556#, no-wrap 10557msgid "B<DEB_VENDOR>" 10558msgstr "" 10559 10560#. type: Plain text 10561#: dpkg-buildflags.man 10562msgid "" 10563"This setting defines the current vendor. If not set, it will discover the " 10564"current vendor by reading B<%PKGCONFDIR%/origins/default>." 10565msgstr "" 10566 10567#. type: TP 10568#: dpkg-buildflags.man 10569#, no-wrap 10570msgid "B<DEB_BUILD_PATH>" 10571msgstr "" 10572 10573#. type: Plain text 10574#: dpkg-buildflags.man 10575msgid "" 10576"This variable sets the build path (since dpkg 1.18.8) to use in features " 10577"such as B<fixdebugpath> so that they can be controlled by the caller. This " 10578"variable is currently Debian and derivatives-specific." 10579msgstr "" 10580 10581#. type: SS 10582#: dpkg-buildflags.man 10583#, no-wrap 10584msgid "Configuration files" 10585msgstr "" 10586 10587#. type: TP 10588#: dpkg-buildflags.man 10589#, no-wrap 10590msgid "B<%PKGCONFDIR%/buildflags.conf>" 10591msgstr "" 10592 10593#. type: Plain text 10594#: dpkg-buildflags.man 10595msgid "System wide configuration file." 10596msgstr "" 10597 10598#. type: TP 10599#: dpkg-buildflags.man 10600#, no-wrap 10601msgid "B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or " 10602msgstr "" 10603 10604#. type: TQ 10605#: dpkg-buildflags.man 10606#, no-wrap 10607msgid "B<$HOME/.config/dpkg/buildflags.conf>" 10608msgstr "" 10609 10610#. type: Plain text 10611#: dpkg-buildflags.man dpkg-buildpackage.man 10612msgid "User configuration file." 10613msgstr "" 10614 10615#. type: TP 10616#: dpkg-buildflags.man 10617#, no-wrap 10618msgid "B<%PKGDATADIR%/buildflags.mk>" 10619msgstr "" 10620 10621#. type: Plain text 10622#: dpkg-buildflags.man 10623msgid "" 10624"Makefile snippet that will load (and optionally export) all flags supported " 10625"by B<dpkg-buildflags> into variables (since dpkg 1.16.1)." 10626msgstr "" 10627 10628#. type: Plain text 10629#: dpkg-buildflags.man 10630msgid "To pass build flags to a build command in a Makefile:" 10631msgstr "" 10632 10633#. type: Plain text 10634#: dpkg-buildflags.man 10635#, no-wrap 10636msgid "$(MAKE) $(shell dpkg-buildflags --export=cmdline)\n" 10637msgstr "" 10638 10639#. type: Plain text 10640#: dpkg-buildflags.man 10641#, no-wrap 10642msgid "\\&./configure $(shell dpkg-buildflags --export=cmdline)\n" 10643msgstr "" 10644 10645#. type: Plain text 10646#: dpkg-buildflags.man 10647msgid "" 10648"To set build flags in a shell script or shell fragment, B<eval> can be used " 10649"to interpret the output and to export the flags in the environment:" 10650msgstr "" 10651 10652#. type: Plain text 10653#: dpkg-buildflags.man 10654#, no-wrap 10655msgid "eval \"$(dpkg-buildflags --export=sh)\" && make\n" 10656msgstr "" 10657 10658#. type: Plain text 10659#: dpkg-buildflags.man 10660msgid "or to set the positional parameters to pass to a command:" 10661msgstr "" 10662 10663#. type: Plain text 10664#: dpkg-buildflags.man 10665#, no-wrap 10666msgid "" 10667"eval \"set -- $(dpkg-buildflags --export=cmdline)\"\n" 10668"for dir in a b c; do (cd $dir && ./configure \"$@\" && make); done\n" 10669msgstr "" 10670 10671#. type: Plain text 10672#: dpkg-buildflags.man 10673msgid "" 10674"You should call B<dpkg-buildflags> or include B<buildflags.mk> from the " 10675"B<debian/rules> file to obtain the needed build flags to pass to the build " 10676"system. Note that older versions of B<dpkg-buildpackage> (before dpkg " 10677"1.16.1) exported these flags automatically. However, you should not rely on " 10678"this, since this breaks manual invocation of B<debian/rules>." 10679msgstr "" 10680 10681#. type: Plain text 10682#: dpkg-buildflags.man 10683msgid "" 10684"For packages with autoconf-like build systems, you can pass the relevant " 10685"options to configure or B<make>(1) directly, as shown above." 10686msgstr "" 10687 10688#. type: Plain text 10689#: dpkg-buildflags.man 10690msgid "" 10691"For other build systems, or when you need more fine-grained control about " 10692"which flags are passed where, you can use B<--get>. Or you can include " 10693"B<buildflags.mk> instead, which takes care of calling B<dpkg-buildflags> and " 10694"storing the build flags in make variables." 10695msgstr "" 10696 10697#. type: Plain text 10698#: dpkg-buildflags.man 10699msgid "" 10700"If you want to export all buildflags into the environment (where they can be " 10701"picked up by your build system):" 10702msgstr "" 10703 10704#. type: Plain text 10705#: dpkg-buildflags.man 10706#, no-wrap 10707msgid "" 10708"DPKG_EXPORT_BUILDFLAGS = 1\n" 10709"include %PKGDATADIR%/buildflags.mk\n" 10710msgstr "" 10711 10712#. type: Plain text 10713#: dpkg-buildflags.man 10714msgid "" 10715"For some extra control over what is exported, you can manually export the " 10716"variables (as none are exported by default):" 10717msgstr "" 10718 10719#. type: Plain text 10720#: dpkg-buildflags.man 10721#, no-wrap 10722msgid "" 10723"include %PKGDATADIR%/buildflags.mk\n" 10724"export CPPFLAGS CFLAGS LDFLAGS\n" 10725msgstr "" 10726 10727#. type: Plain text 10728#: dpkg-buildflags.man 10729msgid "And you can of course pass the flags to commands manually:" 10730msgstr "" 10731 10732#. type: Plain text 10733#: dpkg-buildflags.man 10734#, no-wrap 10735msgid "" 10736"include %PKGDATADIR%/buildflags.mk\n" 10737"build-arch:\n" 10738"\\&\t$(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)\n" 10739msgstr "" 10740 10741#. type: TH 10742#: dpkg-buildpackage.man 10743#, no-wrap 10744msgid "dpkg-buildpackage" 10745msgstr "" 10746 10747#. type: Plain text 10748#: dpkg-buildpackage.man 10749msgid "dpkg-buildpackage - build binary or source packages from sources" 10750msgstr "" 10751 10752#. type: Plain text 10753#: dpkg-buildpackage.man 10754msgid "B<dpkg-buildpackage> [I<option>...]" 10755msgstr "" 10756 10757#. type: Plain text 10758#: dpkg-buildpackage.man 10759msgid "" 10760"B<dpkg-buildpackage> is a program that automates the process of building a " 10761"Debian package. It consists of the following steps:" 10762msgstr "" 10763 10764#. type: IP 10765#: dpkg-buildpackage.man 10766#, no-wrap 10767msgid "B<1.>" 10768msgstr "" 10769 10770#. type: Plain text 10771#: dpkg-buildpackage.man 10772msgid "" 10773"It prepares the build environment by setting various environment variables " 10774"(see B<ENVIRONMENT>), runs the B<init> hook, and calls B<dpkg-source --" 10775"before-build> (unless B<-T> or B<--target> has been used)." 10776msgstr "" 10777 10778#. type: IP 10779#: dpkg-buildpackage.man 10780#, no-wrap 10781msgid "B<2.>" 10782msgstr "" 10783 10784#. type: Plain text 10785#: dpkg-buildpackage.man 10786msgid "" 10787"It checks that the build-dependencies and build-conflicts are satisfied " 10788"(unless B<-d> or B<--no-check-builddeps> is specified)." 10789msgstr "" 10790 10791#. type: IP 10792#: dpkg-buildpackage.man 10793#, no-wrap 10794msgid "B<3.>" 10795msgstr "" 10796 10797#. type: Plain text 10798#: dpkg-buildpackage.man 10799msgid "" 10800"If one or more specific targets have been selected with the B<-T> or B<--" 10801"target> option, it calls those targets and stops here. Otherwise it runs the " 10802"B<preclean> hook and calls B<fakeroot debian/rules clean> to clean the build-" 10803"tree (unless B<-nc> or B<--no-pre-clean> is specified)." 10804msgstr "" 10805 10806#. type: IP 10807#: dpkg-buildpackage.man 10808#, no-wrap 10809msgid "B<4.>" 10810msgstr "" 10811 10812#. type: Plain text 10813#: dpkg-buildpackage.man 10814msgid "" 10815"It runs the B<source> hook and calls B<dpkg-source -b> to generate the " 10816"source package (if a B<source> build has been requested with B<--build> or " 10817"equivalent options)." 10818msgstr "" 10819 10820#. type: IP 10821#: dpkg-buildpackage.man 10822#, no-wrap 10823msgid "B<5.>" 10824msgstr "" 10825 10826#. type: Plain text 10827#: dpkg-buildpackage.man 10828msgid "" 10829"It runs the B<build> hook and calls B<debian/rules> I<build-target>, then " 10830"runs the B<binary> hook followed by B<fakeroot debian/rules> I<binary-" 10831"target> (unless a source-only build has been requested with B<--" 10832"build=source> or equivalent options). Note that I<build-target> and " 10833"I<binary-target> are either B<build> and B<binary> (default case, or if an " 10834"B<any> and B<all> build has been requested with B<--build> or equivalent " 10835"options), or B<build-arch> and B<binary-arch> (if an B<any> and not B<all> " 10836"build has been requested with B<--build> or equivalent options), or B<build-" 10837"indep> and B<binary-indep> (if an B<all> and not B<any> build has been " 10838"requested with B<--build> or equivalent options)." 10839msgstr "" 10840 10841#. type: IP 10842#: dpkg-buildpackage.man 10843#, no-wrap 10844msgid "B<6.>" 10845msgstr "" 10846 10847#. type: Plain text 10848#: dpkg-buildpackage.man 10849msgid "" 10850"It runs the B<buildinfo> hook and calls B<dpkg-genbuildinfo> to generate a " 10851"B<.buildinfo> file. Several B<dpkg-buildpackage> options are forwarded to " 10852"B<dpkg-genbuildinfo>." 10853msgstr "" 10854 10855#. type: IP 10856#: dpkg-buildpackage.man 10857#, no-wrap 10858msgid "B<7.>" 10859msgstr "" 10860 10861#. type: Plain text 10862#: dpkg-buildpackage.man 10863msgid "" 10864"It runs the B<changes> hook and calls B<dpkg-genchanges> to generate a B<." 10865"changes> file. The name of the B<.changes> file will depend on the type of " 10866"build and will be as specific as necessary but not more; for a build that " 10867"includes B<any> the name will be I<source-name>B<_>I<binary-" 10868"version>B<_>I<arch>B<.changes>, or otherwise for a build that includes " 10869"B<all> the name will be I<source-name>B<_>I<binary-version>B<_>B<all." 10870"changes>, or otherwise for a build that includes B<source> the name will be " 10871"I<source-name>B<_>I<source-version>B<_>B<source.changes>. Many B<dpkg-" 10872"buildpackage> options are forwarded to B<dpkg-genchanges>." 10873msgstr "" 10874 10875#. type: IP 10876#: dpkg-buildpackage.man 10877#, no-wrap 10878msgid "B<8.>" 10879msgstr "" 10880 10881#. type: Plain text 10882#: dpkg-buildpackage.man 10883msgid "" 10884"It runs the B<postclean> hook and if B<-tc> or B<--post-clean> is specified, " 10885"it will call B<fakeroot debian/rules clean> again." 10886msgstr "" 10887 10888#. type: IP 10889#: dpkg-buildpackage.man 10890#, no-wrap 10891msgid "B<9.>" 10892msgstr "" 10893 10894#. type: Plain text 10895#: dpkg-buildpackage.man 10896msgid "It calls B<dpkg-source --after-build>." 10897msgstr "" 10898 10899#. type: IP 10900#: dpkg-buildpackage.man 10901#, no-wrap 10902msgid "B<10.>" 10903msgstr "" 10904 10905#. type: Plain text 10906#: dpkg-buildpackage.man 10907msgid "" 10908"It runs the B<check> hook and calls a package checker for the B<.changes> " 10909"file (if a command is specified in B<DEB_CHECK_COMMAND> or with B<--check-" 10910"command>)." 10911msgstr "" 10912 10913#. type: IP 10914#: dpkg-buildpackage.man 10915#, no-wrap 10916msgid "B<11.>" 10917msgstr "" 10918 10919#. type: Plain text 10920#: dpkg-buildpackage.man 10921msgid "" 10922"It runs the B<sign> hook and calls B<gpg2> or B<gpg> (as long as it is not " 10923"an UNRELEASED build, or B<--no-sign> is specified) to sign the B<.dsc> file " 10924"(if any, unless B<-us> or B<--unsigned-source> is specified), the B<." 10925"buildinfo> file (unless B<-ui>, B<--unsigned-buildinfo>, B<-uc> or B<--" 10926"unsigned-changes> is specified) and the B<.changes> file (unless B<-uc> or " 10927"B<--unsigned-changes> is specified)." 10928msgstr "" 10929 10930#. type: IP 10931#: dpkg-buildpackage.man 10932#, no-wrap 10933msgid "B<12.>" 10934msgstr "" 10935 10936#. type: Plain text 10937#: dpkg-buildpackage.man 10938msgid "It runs the B<done> hook." 10939msgstr "" 10940 10941#. type: Plain text 10942#: dpkg-buildpackage.man 10943#, fuzzy 10944#| msgid "" 10945#| "All options can be specified both on the command line and in the B<dpkg> " 10946#| "configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names " 10947#| "matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration " 10948#| "directory I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration " 10949#| "file is either an option (exactly the same as the command line option but " 10950#| "without leading hyphens) or a comment (if it starts with a B<#>)." 10951msgid "" 10952"All long options can be specified both on the command line and in the B<dpkg-" 10953"buildpackage> system and user configuration files. Each line in the " 10954"configuration file is either an option (exactly the same as the command line " 10955"option but without leading hyphens) or a comment (if it starts with a " 10956"‘B<#>’)." 10957msgstr "" 10958"所有选项都可以在命令行中或者在 B<dpkg> 配置文件 I<%PKGCONFDIR%/dpkg.cfg> 中指" 10959"定，在配置目录 I<%PKGCONFDIR%/dpkg.cfg.d/> 里的零碎文件中指定也可（零碎文件需" 10960"要匹配 shell 模式 '[0-9a-zA-Z_-]*'）。配置文件中的每一行可以是选项（与命令行" 10961"选项一致，但无需连字符）也可以是注释（以 B<#> 开头）。" 10962 10963#. type: TP 10964#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 10965#, no-wrap 10966msgid "B<--build=>I<type>" 10967msgstr "" 10968 10969#. type: Plain text 10970#: dpkg-buildpackage.man 10971msgid "" 10972"Specifies the build I<type> from a comma-separated list of components (since " 10973"dpkg 1.18.5). Passed to B<dpkg-genchanges>." 10974msgstr "" 10975 10976#. type: Plain text 10977#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 10978msgid "The allowed values are:" 10979msgstr "" 10980 10981#. type: TP 10982#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 10983#, fuzzy, no-wrap 10984#| msgid "dpkg-source" 10985msgid "B<source>" 10986msgstr "dpkg-source" 10987 10988#. type: Plain text 10989#: dpkg-buildpackage.man 10990msgid "" 10991"Builds the source package. Note: when using this value standalone and if " 10992"what you want is simply to (re-)build the source package from a clean source " 10993"tree, using B<dpkg-source> directly is always a better option as it does not " 10994"require any build dependencies to be installed which are otherwise needed to " 10995"be able to call the B<clean> target." 10996msgstr "" 10997 10998#. type: TP 10999#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 11000#, no-wrap 11001msgid "B<any>" 11002msgstr "" 11003 11004#. type: Plain text 11005#: dpkg-buildpackage.man 11006msgid "Builds the architecture specific binary packages." 11007msgstr "" 11008 11009#. type: TP 11010#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 11011#, fuzzy, no-wrap 11012#| msgid "B<install>" 11013msgid "B<all>" 11014msgstr "B<install>" 11015 11016#. type: Plain text 11017#: dpkg-buildpackage.man 11018msgid "Builds the architecture independent binary packages." 11019msgstr "" 11020 11021#. type: Plain text 11022#: dpkg-buildpackage.man 11023msgid "" 11024"Builds the architecture specific and independent binary packages. This is " 11025"an alias for B<any,all>." 11026msgstr "" 11027 11028#. type: TP 11029#: dpkg-buildpackage.man dpkg-genbuildinfo.man dpkg-genchanges.man 11030#, no-wrap 11031msgid "B<full>" 11032msgstr "" 11033 11034#. type: Plain text 11035#: dpkg-buildpackage.man 11036msgid "" 11037"Builds everything. This is an alias for B<source,any,all>, and the same as " 11038"the default case when no build option is specified." 11039msgstr "" 11040 11041#. type: TP 11042#: dpkg-buildpackage.man dpkg-genchanges.man 11043#, no-wrap 11044msgid "B<-g>" 11045msgstr "" 11046 11047#. type: Plain text 11048#: dpkg-buildpackage.man dpkg-genchanges.man 11049msgid "Equivalent to B<--build=source,all> (since dpkg 1.17.11)." 11050msgstr "" 11051 11052#. type: Plain text 11053#: dpkg-buildpackage.man dpkg-genchanges.man 11054msgid "Equivalent to B<--build=source,any> (since dpkg 1.17.11)." 11055msgstr "" 11056 11057#. type: TP 11058#: dpkg-buildpackage.man dpkg-genchanges.man 11059#, no-wrap 11060msgid "B<-b>" 11061msgstr "" 11062 11063#. type: Plain text 11064#: dpkg-buildpackage.man dpkg-genchanges.man 11065msgid "Equivalent to B<--build=binary> or B<--build=any,all>." 11066msgstr "" 11067 11068#. type: TP 11069#: dpkg-buildpackage.man dpkg-checkbuilddeps.man dpkg-genchanges.man 11070#, no-wrap 11071msgid "B<-B>" 11072msgstr "" 11073 11074#. type: Plain text 11075#: dpkg-buildpackage.man dpkg-genchanges.man 11076msgid "Equivalent to B<--build=any>." 11077msgstr "" 11078 11079#. type: TP 11080#: dpkg-buildpackage.man dpkg-checkbuilddeps.man dpkg-genchanges.man 11081#, no-wrap 11082msgid "B<-A>" 11083msgstr "" 11084 11085#. type: Plain text 11086#: dpkg-buildpackage.man dpkg-genchanges.man 11087msgid "Equivalent to B<--build=all>." 11088msgstr "" 11089 11090#. type: TP 11091#: dpkg-buildpackage.man dpkg-genchanges.man 11092#, no-wrap 11093msgid "B<-S>" 11094msgstr "" 11095 11096#. type: Plain text 11097#: dpkg-buildpackage.man dpkg-genchanges.man 11098msgid "Equivalent to B<--build=source>." 11099msgstr "" 11100 11101#. type: TP 11102#: dpkg-buildpackage.man 11103#, no-wrap 11104msgid "B<-F>" 11105msgstr "" 11106 11107#. type: Plain text 11108#: dpkg-buildpackage.man 11109msgid "" 11110"Equivalent to B<--build=full>, B<--build=source,binary> or B<--build=source," 11111"any,all> (since dpkg 1.15.8)." 11112msgstr "" 11113 11114#. type: TP 11115#: dpkg-buildpackage.man 11116#, no-wrap 11117msgid "B<--target=>I<target>[,...]" 11118msgstr "" 11119 11120#. type: TQ 11121#: dpkg-buildpackage.man 11122#, no-wrap 11123msgid "B<--target >I<target>[,...]" 11124msgstr "" 11125 11126#. type: TQ 11127#: dpkg-buildpackage.man 11128#, fuzzy, no-wrap 11129#| msgid "B<-A>, B<--record-avail> I<package-file>..." 11130msgid "B<-T>, B<--rules-target=>I<target>[,...]" 11131msgstr "B<-A>, B<--record-avail> I<package-file>..." 11132 11133#. type: Plain text 11134#: dpkg-buildpackage.man 11135msgid "" 11136"Calls B<debian/rules> I<target> once per target specified, after having " 11137"setup the build environment (except for calling B<dpkg-source --before-" 11138"build>), and stops the package build process here (since dpkg 1.15.0, long " 11139"option since dpkg 1.18.8, multi-target support since dpkg 1.18.16). If B<--" 11140"as-root> is also given, then the command is executed as root (see B<--root-" 11141"command>). Note that known targets that are required to be run as root do " 11142"not need this option (i.e. the B<clean>, B<binary>, B<binary-arch> and " 11143"B<binary-indep> targets)." 11144msgstr "" 11145 11146#. type: TP 11147#: dpkg-buildpackage.man 11148#, no-wrap 11149msgid "B<--as-root>" 11150msgstr "" 11151 11152#. type: Plain text 11153#: dpkg-buildpackage.man 11154msgid "" 11155"Only meaningful together with B<--target> (since dpkg 1.15.0). Requires " 11156"that the target be run with root rights." 11157msgstr "" 11158 11159#. type: TP 11160#: dpkg-buildpackage.man dpkg-genchanges.man 11161#, no-wrap 11162msgid "B<-si>" 11163msgstr "" 11164 11165#. type: TP 11166#: dpkg-buildpackage.man dpkg-genchanges.man 11167#, no-wrap 11168msgid "B<-sa>" 11169msgstr "" 11170 11171#. type: TP 11172#: dpkg-buildpackage.man dpkg-genchanges.man 11173#, no-wrap 11174msgid "B<-sd>" 11175msgstr "" 11176 11177#. type: TP 11178#: dpkg-buildpackage.man dpkg-genchanges.man dpkg-gencontrol.man 11179#: dpkg-gensymbols.man 11180#, no-wrap 11181msgid "B<-v>I<version>" 11182msgstr "" 11183 11184#. type: TP 11185#: dpkg-buildpackage.man dpkg-genchanges.man 11186#, no-wrap 11187msgid "B<-C>I<changes-description>" 11188msgstr "" 11189 11190#. type: TQ 11191#: dpkg-buildpackage.man 11192#, no-wrap 11193msgid "B<-m>, B<--release-by=>I<maintainer-address>" 11194msgstr "" 11195 11196#. type: TQ 11197#: dpkg-buildpackage.man 11198#, no-wrap 11199msgid "B<-e>, B<--build-by=>I<maintainer-address>" 11200msgstr "" 11201 11202#. type: Plain text 11203#: dpkg-buildpackage.man 11204msgid "Passed unchanged to B<dpkg-genchanges>. See its manual page." 11205msgstr "" 11206 11207#. type: Plain text 11208#: dpkg-buildpackage.man 11209msgid "" 11210"Specify the Debian architecture we build for (long option since dpkg " 11211"1.17.17). The architecture of the machine we build on is determined " 11212"automatically, and is also the default for the host machine." 11213msgstr "" 11214 11215#. type: Plain text 11216#: dpkg-buildpackage.man 11217msgid "" 11218"Specify the GNU system type we build for (long option since dpkg 1.17.17). " 11219"It can be used in place of B<--host-arch> or as a complement to override the " 11220"default GNU system type of the host Debian architecture." 11221msgstr "" 11222 11223#. type: TP 11224#: dpkg-buildpackage.man 11225#, no-wrap 11226msgid "B<--target-arch> I<architecture>" 11227msgstr "" 11228 11229#. type: Plain text 11230#: dpkg-buildpackage.man 11231msgid "" 11232"Specify the Debian architecture the binaries built will build for (since " 11233"dpkg 1.17.17). The default value is the host machine." 11234msgstr "" 11235 11236#. type: TP 11237#: dpkg-buildpackage.man 11238#, no-wrap 11239msgid "B<--target-type> I<gnu-system-type>" 11240msgstr "" 11241 11242#. type: Plain text 11243#: dpkg-buildpackage.man 11244msgid "" 11245"Specify the GNU system type the binaries built will build for (since dpkg " 11246"1.17.17). It can be used in place of B<--target-arch> or as a complement to " 11247"override the default GNU system type of the target Debian architecture." 11248msgstr "" 11249 11250#. type: TP 11251#: dpkg-buildpackage.man 11252#, no-wrap 11253msgid "B<-P>, B<--build-profiles=>I<profile>[B<,>...]" 11254msgstr "" 11255 11256#. type: Plain text 11257#: dpkg-buildpackage.man 11258msgid "" 11259"Specify the profile(s) we build, as a comma-separated list (since dpkg " 11260"1.17.2, long option since dpkg 1.18.8). The default behavior is to build " 11261"for no specific profile. Also sets them (as a space separated list) as the " 11262"B<DEB_BUILD_PROFILES> environment variable which allows, for example, " 11263"B<debian/rules> files to use this information for conditional builds." 11264msgstr "" 11265 11266#. type: TP 11267#: dpkg-buildpackage.man 11268#, no-wrap 11269msgid "B<-j>, B<--jobs>[=I<jobs>|B<auto>]" 11270msgstr "" 11271 11272#. type: Plain text 11273#: dpkg-buildpackage.man 11274msgid "" 11275"Number of jobs allowed to be run simultaneously, number of jobs matching the " 11276"number of online processors if B<auto> is specified (since dpkg 1.17.10), or " 11277"unlimited number if I<jobs> is not specified, equivalent to the B<make>(1) " 11278"option of the same name (since dpkg 1.14.7, long option since dpkg 1.18.8). " 11279"Will add itself to the B<MAKEFLAGS> environment variable, which should cause " 11280"all subsequent make invocations to inherit the option, thus forcing the " 11281"parallel setting on the packaging (and possibly the upstream build system if " 11282"that uses make) regardless of their support for parallel builds, which " 11283"might cause build failures. Also adds B<parallel=>I<jobs> or B<parallel> to " 11284"the B<DEB_BUILD_OPTIONS> environment variable which allows debian/rules " 11285"files to use this information for their own purposes. The B<-j> value will " 11286"override the B<parallel=>I<jobs> or B<parallel> option in the " 11287"B<DEB_BUILD_OPTIONS> environment variable. Note that the B<auto> value will " 11288"get replaced by the actual number of currently active processors, and as " 11289"such will not get propagated to any child process. If the number of online " 11290"processors cannot be inferred then the code will fallback to using serial " 11291"execution (since dpkg 1.18.15), although this should only happen on exotic " 11292"and unsupported systems." 11293msgstr "" 11294 11295#. type: TP 11296#: dpkg-buildpackage.man 11297#, no-wrap 11298msgid "B<-J>, B<--jobs-try>[=I<jobs>|B<auto>]" 11299msgstr "" 11300 11301#. type: Plain text 11302#: dpkg-buildpackage.man 11303msgid "" 11304"This option (since dpkg 1.18.2, long option since dpkg 1.18.8) is equivalent " 11305"to the B<-j> option except that it does not set the B<MAKEFLAGS> environment " 11306"variable, and as such it is safer to use with any package including those " 11307"that are not parallel-build safe." 11308msgstr "" 11309 11310#. type: Plain text 11311#: dpkg-buildpackage.man 11312msgid "" 11313"B<auto> is the default behavior (since dpkg 1.18.11). Setting the number of " 11314"jobs to 1 will restore a serial behavior." 11315msgstr "" 11316 11317#. type: TP 11318#: dpkg-buildpackage.man 11319#, fuzzy, no-wrap 11320#| msgid "B<-?>, B<--help>" 11321msgid "B<-D>, B<--check-builddeps>" 11322msgstr "B<-?>, B<--help>" 11323 11324#. type: Plain text 11325#: dpkg-buildpackage.man 11326msgid "" 11327"Check build dependencies and conflicts; abort if unsatisfied (long option " 11328"since dpkg 1.18.8). This is the default behavior." 11329msgstr "" 11330 11331#. type: TP 11332#: dpkg-buildpackage.man 11333#, fuzzy, no-wrap 11334#| msgid "B<-?>, B<--help>" 11335msgid "B<-d>, B<--no-check-builddeps>" 11336msgstr "B<-?>, B<--help>" 11337 11338#. type: Plain text 11339#: dpkg-buildpackage.man 11340msgid "" 11341"Do not check build dependencies and conflicts (long option since dpkg " 11342"1.18.8)." 11343msgstr "" 11344 11345#. type: TP 11346#: dpkg-buildpackage.man 11347#, no-wrap 11348msgid "B<--ignore-builtin-builddeps>" 11349msgstr "" 11350 11351#. type: Plain text 11352#: dpkg-buildpackage.man 11353msgid "" 11354"Do not check built-in build dependencies and conflicts (since dpkg 1.18.2). " 11355"These are the distribution specific implicit build dependencies usually " 11356"required in a build environment, the so called Build-Essential package set." 11357msgstr "" 11358 11359#. type: TP 11360#: dpkg-buildpackage.man 11361#, no-wrap 11362msgid "B<--rules-requires-root>" 11363msgstr "" 11364 11365#. type: Plain text 11366#: dpkg-buildpackage.man 11367msgid "" 11368"Do not honor the B<Rules-Requires-Root> field, falling back to its legacy " 11369"default value (since dpkg 1.19.1)." 11370msgstr "" 11371 11372#. type: TP 11373#: dpkg-buildpackage.man 11374#, fuzzy, no-wrap 11375#| msgid "B<-R>, B<--recursive>" 11376msgid "B<-nc>, B<--no-pre-clean>" 11377msgstr "B<-R>, B<--recursive>" 11378 11379#. type: Plain text 11380#: dpkg-buildpackage.man 11381msgid "" 11382"Do not clean the source tree before building (long option since dpkg " 11383"1.18.8). Implies B<-b> if nothing else has been selected among B<-F>, B<-" 11384"g>, B<-G>, B<-B>, B<-A> or B<-S>. Implies B<-d> with B<-S> (since dpkg " 11385"1.18.0)." 11386msgstr "" 11387 11388#. type: TP 11389#: dpkg-buildpackage.man 11390#, fuzzy, no-wrap 11391#| msgid "B<--ignore-depends>=I<package>,..." 11392msgid "B<--pre-clean>" 11393msgstr "B<--ignore-depends>=I<package>,..." 11394 11395#. type: Plain text 11396#: dpkg-buildpackage.man 11397msgid "" 11398"Clean the source tree before building (since dpkg 1.18.8). This is the " 11399"default behavior." 11400msgstr "" 11401 11402#. type: TP 11403#: dpkg-buildpackage.man 11404#, fuzzy, no-wrap 11405#| msgid "B<-E>, B<--skip-same-version>" 11406msgid "B<-tc>, B<--post-clean>" 11407msgstr "B<-E>, B<--skip-same-version>" 11408 11409#. type: Plain text 11410#: dpkg-buildpackage.man 11411msgid "" 11412"Clean the source tree (using I<gain-root-command> B<debian/rules clean>) " 11413"after the package has been built (long option since dpkg 1.18.8)." 11414msgstr "" 11415 11416#. type: TP 11417#: dpkg-buildpackage.man 11418#, fuzzy, no-wrap 11419#| msgid "B<-E>, B<--skip-same-version>" 11420msgid "B<--no-post-clean>" 11421msgstr "B<-E>, B<--skip-same-version>" 11422 11423#. type: Plain text 11424#: dpkg-buildpackage.man 11425msgid "" 11426"Do not clean the source tree after the package has been built (since dpkg " 11427"1.19.1). This is the default behavior." 11428msgstr "" 11429 11430#. type: TP 11431#: dpkg-buildpackage.man 11432#, no-wrap 11433msgid "B<-r>, B<--root-command=>I<gain-root-command>" 11434msgstr "" 11435 11436#. type: Plain text 11437#: dpkg-buildpackage.man 11438msgid "" 11439"When B<dpkg-buildpackage> needs to execute part of the build process as " 11440"root, it prefixes the command it executes with I<gain-root-command> if one " 11441"has been specified (long option since dpkg 1.18.8). Otherwise, if none has " 11442"been specified, B<fakeroot> will be used by default, if the command is " 11443"present. I<gain-root-command> should start with the name of a program on " 11444"the B<PATH> and will get as arguments the name of the real command to run " 11445"and the arguments it should take. I<gain-root-command> can include " 11446"parameters (they must be space-separated) but no shell metacharacters. " 11447"I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or " 11448"B<really>. B<su> is not suitable, since it can only invoke the user's shell " 11449"with B<-c> instead of passing arguments individually to the command to be " 11450"run." 11451msgstr "" 11452 11453#. type: TP 11454#: dpkg-buildpackage.man 11455#, fuzzy, no-wrap 11456#| msgid "B<-A>, B<--record-avail> I<package-file>..." 11457msgid "B<-R>, B<--rules-file=>I<rules-file>" 11458msgstr "B<-A>, B<--record-avail> I<package-file>..." 11459 11460#. type: Plain text 11461#: dpkg-buildpackage.man 11462msgid "" 11463"Building a Debian package usually involves invoking B<debian/rules> as a " 11464"command with several standard parameters (since dpkg 1.14.17, long option " 11465"since dpkg 1.18.8). With this option it's possible to use another program " 11466"invocation to build the package (it can include space separated " 11467"parameters). Alternatively it can be used to execute the standard rules " 11468"file with another make program (for example by using B</usr/local/bin/make -" 11469"f debian/rules> as I<rules-file>)." 11470msgstr "" 11471 11472#. type: TP 11473#: dpkg-buildpackage.man 11474#, no-wrap 11475msgid "B<--check-command=>I<check-command>" 11476msgstr "" 11477 11478#. type: Plain text 11479#: dpkg-buildpackage.man 11480msgid "" 11481"Command used to check the B<.changes> file itself and any artifact built " 11482"referenced in the file (since dpkg 1.17.6). The command should take the B<." 11483"changes> pathname as an argument. This command will usually be B<lintian>." 11484msgstr "" 11485 11486#. type: TP 11487#: dpkg-buildpackage.man 11488#, no-wrap 11489msgid "B<--check-option=>I<opt>" 11490msgstr "" 11491 11492#. type: Plain text 11493#: dpkg-buildpackage.man 11494msgid "" 11495"Pass option I<opt> to the I<check-command> specified with " 11496"B<DEB_CHECK_COMMAND> or B<--check-command> (since dpkg 1.17.6). Can be used " 11497"multiple times." 11498msgstr "" 11499 11500#. type: TP 11501#: dpkg-buildpackage.man 11502#, no-wrap 11503msgid "B<--hook->I<hook-name>B<=>I<hook-command>" 11504msgstr "" 11505 11506#. type: Plain text 11507#: dpkg-buildpackage.man 11508msgid "" 11509"Set the specified shell code I<hook-command> as the hook I<hook-name>, which " 11510"will run at the times specified in the run steps (since dpkg 1.17.6). The " 11511"hooks will always be executed even if the following action is not performed " 11512"(except for the B<binary> hook). All the hooks will run in the unpacked " 11513"source directory." 11514msgstr "" 11515 11516#. type: Plain text 11517#: dpkg-buildpackage.man 11518msgid "" 11519"Note: Hooks can affect the build process, and cause build failures if their " 11520"commands fail, so watch out for unintended consequences." 11521msgstr "" 11522 11523#. type: Plain text 11524#: dpkg-buildpackage.man 11525msgid "The current I<hook-name> supported are:" 11526msgstr "" 11527 11528#. type: Plain text 11529#: dpkg-buildpackage.man 11530msgid "" 11531"B<init preclean source build binary buildinfo changes postclean check sign " 11532"done>" 11533msgstr "" 11534 11535#. type: Plain text 11536#: dpkg-buildpackage.man 11537msgid "" 11538"The I<hook-command> supports the following substitution format string, which " 11539"will get applied to it before execution:" 11540msgstr "" 11541 11542#. type: TP 11543#: dpkg-buildpackage.man 11544#, no-wrap 11545msgid "B<%%>" 11546msgstr "" 11547 11548#. type: Plain text 11549#: dpkg-buildpackage.man 11550msgid "A single % character." 11551msgstr "" 11552 11553#. type: TP 11554#: dpkg-buildpackage.man 11555#, no-wrap 11556msgid "B<%a>" 11557msgstr "" 11558 11559#. type: Plain text 11560#: dpkg-buildpackage.man 11561msgid "" 11562"A boolean value (0 or 1), representing whether the following action is being " 11563"performed." 11564msgstr "" 11565 11566#. type: TP 11567#: dpkg-buildpackage.man 11568#, no-wrap 11569msgid "B<%p>" 11570msgstr "" 11571 11572#. type: Plain text 11573#: dpkg-buildpackage.man 11574msgid "The source package name." 11575msgstr "" 11576 11577#. type: TP 11578#: dpkg-buildpackage.man 11579#, no-wrap 11580msgid "B<%v>" 11581msgstr "" 11582 11583#. type: Plain text 11584#: dpkg-buildpackage.man 11585msgid "The source package version." 11586msgstr "" 11587 11588#. type: TP 11589#: dpkg-buildpackage.man 11590#, no-wrap 11591msgid "B<%s>" 11592msgstr "" 11593 11594#. type: Plain text 11595#: dpkg-buildpackage.man 11596msgid "The source package version (without the epoch)." 11597msgstr "" 11598 11599#. type: TP 11600#: dpkg-buildpackage.man 11601#, no-wrap 11602msgid "B<%u>" 11603msgstr "" 11604 11605#. type: Plain text 11606#: dpkg-buildpackage.man 11607msgid "The upstream version." 11608msgstr "" 11609 11610#. type: TP 11611#: dpkg-buildpackage.man 11612#, no-wrap 11613msgid "B<--buildinfo-option=>I<opt>" 11614msgstr "" 11615 11616#. type: Plain text 11617#: dpkg-buildpackage.man 11618msgid "" 11619"Pass option I<opt> to B<dpkg-genbuildinfo> (since dpkg 1.18.11). Can be " 11620"used multiple times." 11621msgstr "" 11622 11623#. type: TP 11624#: dpkg-buildpackage.man 11625#, fuzzy, no-wrap 11626#| msgid "B<-E>, B<--skip-same-version>" 11627msgid "B<-p>, B<--sign-command=>I<sign-command>" 11628msgstr "B<-E>, B<--skip-same-version>" 11629 11630#. type: Plain text 11631#: dpkg-buildpackage.man 11632msgid "" 11633"When B<dpkg-buildpackage> needs to execute GPG to sign a source control (B<." 11634"dsc>) file or a B<.changes> file it will run I<sign-command> (searching the " 11635"B<PATH> if necessary) instead of B<gpg2> or B<gpg> (long option since dpkg " 11636"1.18.8). I<sign-command> will get all the arguments that B<gpg2> or B<gpg> " 11637"would have gotten. I<sign-command> should not contain spaces or any other " 11638"shell metacharacters." 11639msgstr "" 11640 11641#. type: TP 11642#: dpkg-buildpackage.man 11643#, fuzzy, no-wrap 11644#| msgid "B<-E>, B<--skip-same-version>" 11645msgid "B<-k>, B<--sign-key=>I<key-id>" 11646msgstr "B<-E>, B<--skip-same-version>" 11647 11648#. type: Plain text 11649#: dpkg-buildpackage.man 11650msgid "" 11651"Specify a key-ID to use when signing packages (long option since dpkg " 11652"1.18.8)." 11653msgstr "" 11654 11655#. type: TP 11656#: dpkg-buildpackage.man 11657#, fuzzy, no-wrap 11658#| msgid "B<-E>, B<--skip-same-version>" 11659msgid "B<-us>, B<--unsigned-source>" 11660msgstr "B<-E>, B<--skip-same-version>" 11661 11662#. type: Plain text 11663#: dpkg-buildpackage.man 11664msgid "Do not sign the source package (long option since dpkg 1.18.8)." 11665msgstr "" 11666 11667#. type: TP 11668#: dpkg-buildpackage.man 11669#, fuzzy, no-wrap 11670#| msgid "B<-E>, B<--skip-same-version>" 11671msgid "B<-ui>, B<--unsigned-buildinfo>" 11672msgstr "B<-E>, B<--skip-same-version>" 11673 11674#. type: Plain text 11675#: dpkg-buildpackage.man 11676#, fuzzy 11677#| msgid "B<bad-version>: Process even packages with wrong versions." 11678msgid "Do not sign the B<.buildinfo> file (since dpkg 1.18.19)." 11679msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 11680 11681#. type: TP 11682#: dpkg-buildpackage.man 11683#, fuzzy, no-wrap 11684#| msgid "B<-R>, B<--recursive>" 11685msgid "B<-uc>, B<--unsigned-changes>" 11686msgstr "B<-R>, B<--recursive>" 11687 11688#. type: Plain text 11689#: dpkg-buildpackage.man 11690#, fuzzy 11691#| msgid "B<bad-version>: Process even packages with wrong versions." 11692msgid "" 11693"Do not sign the B<.buildinfo> and B<.changes> files (long option since dpkg " 11694"1.18.8)." 11695msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 11696 11697#. type: TP 11698#: dpkg-buildpackage.man 11699#, fuzzy, no-wrap 11700#| msgid "B<--version>" 11701msgid "B<--no-sign>" 11702msgstr "B<--version>" 11703 11704#. type: Plain text 11705#: dpkg-buildpackage.man 11706msgid "" 11707"Do not sign any file, this includes the source package, the B<.buildinfo> " 11708"file and the B<.changes> file (since dpkg 1.18.20)." 11709msgstr "" 11710 11711#. type: TP 11712#: dpkg-buildpackage.man 11713#, no-wrap 11714msgid "B<--force-sign>" 11715msgstr "" 11716 11717#. type: Plain text 11718#: dpkg-buildpackage.man 11719msgid "" 11720"Force the signing of the resulting files (since dpkg 1.17.0), regardless of " 11721"B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, B<--" 11722"unsigned-changes> or other internal heuristics." 11723msgstr "" 11724 11725#. type: TP 11726#: dpkg-buildpackage.man dpkg-source.man 11727#, no-wrap 11728msgid "B<-sn>" 11729msgstr "" 11730 11731#. type: TP 11732#: dpkg-buildpackage.man dpkg-source.man 11733#, no-wrap 11734msgid "B<-ss>" 11735msgstr "" 11736 11737#. type: TQ 11738#: dpkg-buildpackage.man 11739#, no-wrap 11740msgid "B<-sA>" 11741msgstr "" 11742 11743#. type: TP 11744#: dpkg-buildpackage.man dpkg-source.man 11745#, no-wrap 11746msgid "B<-sk>" 11747msgstr "" 11748 11749#. type: TP 11750#: dpkg-buildpackage.man dpkg-source.man 11751#, no-wrap 11752msgid "B<-su>" 11753msgstr "" 11754 11755#. type: TP 11756#: dpkg-buildpackage.man dpkg-source.man 11757#, no-wrap 11758msgid "B<-sr>" 11759msgstr "" 11760 11761#. type: TQ 11762#: dpkg-buildpackage.man 11763#, no-wrap 11764msgid "B<-sK>" 11765msgstr "" 11766 11767#. type: TQ 11768#: dpkg-buildpackage.man 11769#, no-wrap 11770msgid "B<-sU>" 11771msgstr "" 11772 11773#. type: TQ 11774#: dpkg-buildpackage.man 11775#, no-wrap 11776msgid "B<-sR>" 11777msgstr "" 11778 11779#. type: TQ 11780#: dpkg-buildpackage.man 11781#, no-wrap 11782msgid "B<-i>, B<--diff-ignore>[=I<regex>]" 11783msgstr "" 11784 11785#. type: TQ 11786#: dpkg-buildpackage.man 11787#, fuzzy, no-wrap 11788#| msgid "B<-E>, B<--skip-same-version>" 11789msgid "B<-I>, B<--tar-ignore>[=I<pattern>]" 11790msgstr "B<-E>, B<--skip-same-version>" 11791 11792#. type: TQ 11793#: dpkg-buildpackage.man 11794#, fuzzy, no-wrap 11795#| msgid "B<-E>, B<--skip-same-version>" 11796msgid "B<-z>, B<--compression-level=>I<level>" 11797msgstr "B<-E>, B<--skip-same-version>" 11798 11799#. type: TQ 11800#: dpkg-buildpackage.man 11801#, fuzzy, no-wrap 11802#| msgid "B<-C>, B<--audit> [I<package-name>...]" 11803msgid "B<-Z>, B<--compression=>I<compressor>" 11804msgstr "B<-C>, B<--audit> [I<package-name>...]" 11805 11806#. type: Plain text 11807#: dpkg-buildpackage.man 11808msgid "Passed unchanged to B<dpkg-source>. See its manual page." 11809msgstr "" 11810 11811#. type: TP 11812#: dpkg-buildpackage.man 11813#, no-wrap 11814msgid "B<--source-option=>I<opt>" 11815msgstr "" 11816 11817#. type: Plain text 11818#: dpkg-buildpackage.man 11819msgid "" 11820"Pass option I<opt> to B<dpkg-source> (since dpkg 1.15.6). Can be used " 11821"multiple times." 11822msgstr "" 11823 11824#. type: TP 11825#: dpkg-buildpackage.man 11826#, no-wrap 11827msgid "B<--changes-option=>I<opt>" 11828msgstr "" 11829 11830#. type: Plain text 11831#: dpkg-buildpackage.man 11832msgid "" 11833"Pass option I<opt> to B<dpkg-genchanges> (since dpkg 1.15.6). Can be used " 11834"multiple times." 11835msgstr "" 11836 11837#. type: TQ 11838#: dpkg-buildpackage.man 11839#, no-wrap 11840msgid "B<--admindir >I<dir>" 11841msgstr "" 11842 11843#. type: Plain text 11844#: dpkg-buildpackage.man dpkg-checkbuilddeps.man dpkg-shlibdeps.man 11845msgid "" 11846"Change the location of the B<dpkg> database (since dpkg 1.14.0). The " 11847"default location is I<%ADMINDIR%>." 11848msgstr "" 11849 11850#. type: TP 11851#: dpkg-buildpackage.man 11852#, no-wrap 11853msgid "B<DEB_CHECK_COMMAND>" 11854msgstr "" 11855 11856#. type: Plain text 11857#: dpkg-buildpackage.man 11858msgid "" 11859"If set, it will be used as the command to check the B<.changes> file (since " 11860"dpkg 1.17.6). Overridden by the B<--check-command> option." 11861msgstr "" 11862 11863#. type: TP 11864#: dpkg-buildpackage.man 11865#, no-wrap 11866msgid "B<DEB_SIGN_KEYID>" 11867msgstr "" 11868 11869#. type: Plain text 11870#: dpkg-buildpackage.man 11871msgid "" 11872"If set, it will be used to sign the B<.changes> and B<.dsc> files (since " 11873"dpkg 1.17.2). Overridden by the B<--sign-key> option." 11874msgstr "" 11875 11876#. type: Plain text 11877#: dpkg-buildpackage.man 11878msgid "" 11879"If set, it will contain a space-separated list of options that might affect " 11880"the build process in I<debian/rules>, and the behavior of some dpkg commands." 11881msgstr "" 11882 11883#. type: Plain text 11884#: dpkg-buildpackage.man 11885msgid "" 11886"With B<nocheck> the B<DEB_CHECK_COMMAND> variable will be ignored. With " 11887"B<parallel=>I<N> the parallel jobs will be set to I<N>, overridden by the " 11888"B<--jobs-try> option." 11889msgstr "" 11890 11891#. type: TP 11892#: dpkg-buildpackage.man dpkg-checkbuilddeps.man 11893#, no-wrap 11894msgid "B<DEB_BUILD_PROFILES>" 11895msgstr "" 11896 11897#. type: Plain text 11898#: dpkg-buildpackage.man 11899msgid "" 11900"If set, it will be used as the active build profile(s) for the package being " 11901"built (since dpkg 1.17.2). It is a space separated list of profile names. " 11902"Overridden by the B<-P> option." 11903msgstr "" 11904 11905#. type: Plain text 11906#: dpkg-buildpackage.man 11907msgid "" 11908"Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should " 11909"not rely on their presence and should instead use the respective interface " 11910"to retrieve the needed values, because that file is the main entry point to " 11911"build packages and running it standalone should be supported." 11912msgstr "" 11913 11914#. type: TP 11915#: dpkg-buildpackage.man 11916#, no-wrap 11917msgid "B<DEB_BUILD_*>" 11918msgstr "" 11919 11920#. type: TQ 11921#: dpkg-buildpackage.man 11922#, no-wrap 11923msgid "B<DEB_HOST_*>" 11924msgstr "" 11925 11926#. type: TQ 11927#: dpkg-buildpackage.man 11928#, no-wrap 11929msgid "B<DEB_TARGET_*>" 11930msgstr "" 11931 11932#. type: Plain text 11933#: dpkg-buildpackage.man 11934msgid "" 11935"B<dpkg-architecture> is called with the B<-a> and B<-t> parameters " 11936"forwarded. Any variable that is output by its B<-s> option is integrated in " 11937"the build environment." 11938msgstr "" 11939 11940#. type: TP 11941#: dpkg-buildpackage.man 11942#, no-wrap 11943msgid "B<DEB_RULES_REQUIRES_ROOT>" 11944msgstr "" 11945 11946#. type: Plain text 11947#: dpkg-buildpackage.man 11948msgid "" 11949"This variable is set to the value obtained from the B<Rules-Requires-Root> " 11950"field or from the command-line. When set, it will be a valid value for the " 11951"B<Rules-Requires-Root> field. It is used to notify B<debian/rules> whether " 11952"the B<rootless-builds.txt> specification is supported." 11953msgstr "" 11954 11955#. type: TP 11956#: dpkg-buildpackage.man 11957#, no-wrap 11958msgid "B<DEB_GAIN_ROOT_CMD>" 11959msgstr "" 11960 11961#. type: Plain text 11962#: dpkg-buildpackage.man 11963msgid "" 11964"This variable is set to I<gain-root-command> when the field B<Rules-Requires-" 11965"Root> is set to a value different to B<no> and B<binary-targets>." 11966msgstr "" 11967 11968#. type: TP 11969#: dpkg-buildpackage.man dpkg-deb.man dpkg-source.man dpkg-split.man 11970#, no-wrap 11971msgid "B<SOURCE_DATE_EPOCH>" 11972msgstr "" 11973 11974#. type: Plain text 11975#: dpkg-buildpackage.man 11976msgid "" 11977"This variable is set to the Unix timestamp since the epoch of the latest " 11978"entry in I<debian/changelog>, if it is not already defined." 11979msgstr "" 11980 11981#. type: TP 11982#: dpkg-buildpackage.man 11983#, no-wrap 11984msgid "I<%PKGCONFDIR%/buildpackage.conf>" 11985msgstr "" 11986 11987#. type: Plain text 11988#: dpkg-buildpackage.man 11989msgid "System wide configuration file" 11990msgstr "" 11991 11992#. type: TP 11993#: dpkg-buildpackage.man 11994#, no-wrap 11995msgid "I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> or" 11996msgstr "" 11997 11998#. type: TQ 11999#: dpkg-buildpackage.man 12000#, no-wrap 12001msgid "I<$HOME/.config/dpkg/buildpackage.conf>" 12002msgstr "" 12003 12004#. type: SS 12005#: dpkg-buildpackage.man 12006#, no-wrap 12007msgid "Compiler flags are no longer exported" 12008msgstr "" 12009 12010#. type: Plain text 12011#: dpkg-buildpackage.man 12012msgid "" 12013"Between dpkg 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler " 12014"flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with " 12015"values as returned by B<dpkg-buildflags>. This is no longer the case." 12016msgstr "" 12017 12018#. type: SS 12019#: dpkg-buildpackage.man 12020#, no-wrap 12021msgid "Default build targets" 12022msgstr "" 12023 12024#. type: Plain text 12025#: dpkg-buildpackage.man 12026msgid "" 12027"B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets " 12028"since dpkg 1.16.2. Those targets are thus mandatory. But to avoid breakages " 12029"of existing packages, and ease the transition, if the source package does " 12030"not build both architecture independent and dependent binary packages (since " 12031"dpkg 1.18.8) it will fallback to use the B<build> target if B<make -f debian/" 12032"rules -qn> I<build-target> returns 2 as exit code." 12033msgstr "" 12034 12035#. type: Plain text 12036#: dpkg-buildpackage.man 12037msgid "" 12038"It should be possible to specify spaces and shell metacharacters and initial " 12039"arguments for I<gain-root-command> and I<sign-command>." 12040msgstr "" 12041 12042#. type: Plain text 12043#: dpkg-buildpackage.man 12044msgid "" 12045"B<dpkg-source>(1), B<dpkg-architecture>(1), B<dpkg-buildflags>(1), B<dpkg-" 12046"genbuildinfo>(1), B<dpkg-genchanges>(1), B<fakeroot>(1), B<lintian>(1), " 12047"B<gpg2>(1), B<gpg>(1)." 12048msgstr "" 12049 12050#. type: TH 12051#: dpkg-genbuildinfo.man 12052#, no-wrap 12053msgid "dpkg-genbuildinfo" 12054msgstr "" 12055 12056#. type: Plain text 12057#: dpkg-genbuildinfo.man 12058msgid "dpkg-genbuildinfo - generate Debian .buildinfo files" 12059msgstr "" 12060 12061#. type: Plain text 12062#: dpkg-genbuildinfo.man 12063#, fuzzy 12064#| msgid "B<dpkg> [I<option>...] I<action>" 12065msgid "B<dpkg-genbuildinfo> [I<option>...]" 12066msgstr "B<dpkg> [I<option>...] I<action>" 12067 12068#. type: Plain text 12069#: dpkg-genbuildinfo.man 12070msgid "" 12071"B<dpkg-genbuildinfo> reads information from an unpacked and built Debian " 12072"source tree and from the files it has generated and generates a Debian " 12073"control file describing the build environment and the build artifacts (B<." 12074"buildinfo> file)." 12075msgstr "" 12076 12077#. type: Plain text 12078#: dpkg-genbuildinfo.man 12079msgid "This command was introduced in dpkg 1.18.11." 12080msgstr "" 12081 12082#. type: Plain text 12083#: dpkg-genbuildinfo.man 12084msgid "Specifies the build I<type> from a comma-separated list of components." 12085msgstr "" 12086 12087#. type: Plain text 12088#: dpkg-genbuildinfo.man 12089msgid "" 12090"Generate build information including unqualified build dependencies (B<Build-" 12091"Depends>) and architecture specific build dependencies (B<Build-Depends-" 12092"Arch>)." 12093msgstr "" 12094 12095#. type: Plain text 12096#: dpkg-genbuildinfo.man 12097msgid "" 12098"Generate build information including unqualified build dependencies (B<Build-" 12099"Depends>) and architecture independent build dependencies (B<Build-Depends-" 12100"Indep>)." 12101msgstr "" 12102 12103#. type: Plain text 12104#: dpkg-genbuildinfo.man 12105msgid "" 12106"Effectively ignored; generate build information with just the unqualified " 12107"build dependencies (B<Build-Depends>)." 12108msgstr "" 12109 12110#. type: Plain text 12111#: dpkg-genbuildinfo.man 12112msgid "" 12113"Generate build information with all three types of build dependencies. This " 12114"is an alias for B<any,all>." 12115msgstr "" 12116 12117#. type: Plain text 12118#: dpkg-genbuildinfo.man 12119msgid "" 12120"Generate build information with all three types of build dependencies. This " 12121"is an alias for B<any,all,source>, and the same as the default case when no " 12122"build option is specified." 12123msgstr "" 12124 12125#. type: TP 12126#: dpkg-genbuildinfo.man dpkg-genchanges.man 12127#, no-wrap 12128msgid "B<-c>I<controlfile>" 12129msgstr "" 12130 12131#. type: Plain text 12132#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12133msgid "" 12134"Specifies the main source control file to read information from. The default " 12135"is B<debian/control>." 12136msgstr "" 12137 12138#. type: TP 12139#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12140#: dpkg-source.man 12141#, no-wrap 12142msgid "B<-l>I<changelog-file>" 12143msgstr "" 12144 12145#. type: Plain text 12146#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12147msgid "" 12148"Specifies the changelog file to read information from. The default is " 12149"B<debian/changelog>." 12150msgstr "" 12151 12152#. type: TP 12153#: dpkg-genbuildinfo.man dpkg-distaddfile.man dpkg-genchanges.man 12154#: dpkg-gencontrol.man 12155#, no-wrap 12156msgid "B<-f>I<files-list-file>" 12157msgstr "" 12158 12159#. type: Plain text 12160#: dpkg-genbuildinfo.man 12161msgid "" 12162"Specifies where is the list of files that have been produced by the build, " 12163"rather than using B<debian/files>." 12164msgstr "" 12165 12166#. type: TP 12167#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12168#: dpkg-source.man 12169#, no-wrap 12170msgid "B<-F>I<changelog-format>" 12171msgstr "" 12172 12173#. type: Plain text 12174#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12175#: dpkg-source.man 12176msgid "" 12177"Specifies the format of the changelog. See B<dpkg-parsechangelog>(1) for " 12178"information about alternative formats." 12179msgstr "" 12180 12181#. type: TP 12182#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gencontrol.man 12183#: dpkg-gensymbols.man dpkg-shlibdeps.man 12184#, no-wrap 12185msgid "B<-O>[I<filename>]" 12186msgstr "" 12187 12188#. type: Plain text 12189#: dpkg-genbuildinfo.man 12190msgid "" 12191"Print the buildinfo file to standard output (or I<filename> if specified) " 12192"rather than to I<dir>B</>I<source-name>B<_>I<binary-version>B<_>I<arch>B<." 12193"buildinfo> (where I<dir> is B<..> by default or I<upload-files-dir> if B<-u> " 12194"was used)." 12195msgstr "" 12196 12197#. type: TP 12198#: dpkg-genbuildinfo.man dpkg-genchanges.man 12199#, no-wrap 12200msgid "B<-u>I<upload-files-dir>" 12201msgstr "" 12202 12203#. type: Plain text 12204#: dpkg-genbuildinfo.man 12205msgid "" 12206"Look for the files to be uploaded in I<upload-files-dir> rather than B<..> " 12207"(B<dpkg-genbuildinfo> needs to find these files so that it can include their " 12208"sizes and checksums in the B<.buildinfo> file)." 12209msgstr "" 12210 12211#. type: TP 12212#: dpkg-genbuildinfo.man 12213#, fuzzy, no-wrap 12214#| msgid "B<--path-include=>I<glob-pattern>" 12215msgid "B<--always-include-kernel>" 12216msgstr "B<--path-include=>I<glob-pattern>" 12217 12218#. type: Plain text 12219#: dpkg-genbuildinfo.man 12220msgid "By default, the B<Build-Kernel-Version> field will not be written out." 12221msgstr "" 12222 12223#. type: Plain text 12224#: dpkg-genbuildinfo.man 12225msgid "" 12226"Specify this option (since dpkg 1.19.0) to always write a B<Build-Kernel-" 12227"Version> field when generating the B<.buildinfo>." 12228msgstr "" 12229 12230#. type: TP 12231#: dpkg-genbuildinfo.man 12232#, fuzzy, no-wrap 12233#| msgid "B<--path-include=>I<glob-pattern>" 12234msgid "B<--always-include-path>" 12235msgstr "B<--path-include=>I<glob-pattern>" 12236 12237#. type: Plain text 12238#: dpkg-genbuildinfo.man 12239msgid "" 12240"By default, the B<Build-Path> field will only be written if the current " 12241"directory starts with a whitelisted pattern." 12242msgstr "" 12243 12244#. type: Plain text 12245#: dpkg-genbuildinfo.man 12246msgid "" 12247"On Debian and derivatives the pattern matches on B</build/> at the start of " 12248"the pathname." 12249msgstr "" 12250 12251#. type: Plain text 12252#: dpkg-genbuildinfo.man 12253msgid "" 12254"Specify this option to always write a B<Build-Path> field when generating " 12255"the B<.buildinfo>." 12256msgstr "" 12257 12258#. type: Plain text 12259#: dpkg-genbuildinfo.man 12260msgid "" 12261"Change the location of the B<dpkg> database. The default location is I</var/" 12262"lib/dpkg>." 12263msgstr "" 12264 12265#. type: TP 12266#: dpkg-genbuildinfo.man dpkg-genchanges.man dpkg-gensymbols.man 12267#, no-wrap 12268msgid "B<-q>" 12269msgstr "" 12270 12271#. type: Plain text 12272#: dpkg-genbuildinfo.man 12273msgid "" 12274"B<dpkg-genbuildinfo> might produce informative messages on standard error. " 12275"B<-q> suppresses these messages." 12276msgstr "" 12277 12278#. type: Plain text 12279#: dpkg-genbuildinfo.man 12280msgid "" 12281"This variable can be used to enable or disable various features that affect " 12282"the information included in the .buildinfo file, via the B<buildinfo> option " 12283"(since dpkg 1.18.19). This option contains a comma-separated list of " 12284"features, prefixed with the ‘B<+>’ or ‘B<->’ modifiers, to denote whether to " 12285"enable or disable them. The special feature “B<all>” can be used to enable " 12286"or disable all other features. The feature “B<path>” controls whether to " 12287"unconditionally include the B<Build-Path> field." 12288msgstr "" 12289 12290#. type: TP 12291#: dpkg-genbuildinfo.man dpkg-distaddfile.man dpkg-genchanges.man 12292#: dpkg-gencontrol.man 12293#, no-wrap 12294msgid "B<debian/files>" 12295msgstr "" 12296 12297#. type: Plain text 12298#: dpkg-genbuildinfo.man 12299msgid "" 12300"The list of generated files. B<dpkg-genbuildinfo> reads the data here when " 12301"producing a B<.buildinfo> file." 12302msgstr "" 12303 12304#. type: Plain text 12305#: dpkg-genbuildinfo.man 12306#, fuzzy 12307#| msgid "B<--unpack >I<package-file>..." 12308msgid "B<deb-buildinfo>(5)." 12309msgstr "B<--unpack >I<package-file>..." 12310 12311#. type: TH 12312#: dpkg-checkbuilddeps.man 12313#, no-wrap 12314msgid "dpkg-checkbuilddeps" 12315msgstr "" 12316 12317#. type: Plain text 12318#: dpkg-checkbuilddeps.man 12319msgid "dpkg-checkbuilddeps - check build dependencies and conflicts" 12320msgstr "" 12321 12322#. type: Plain text 12323#: dpkg-checkbuilddeps.man 12324msgid "B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]" 12325msgstr "" 12326 12327#. type: Plain text 12328#: dpkg-checkbuilddeps.man 12329msgid "" 12330"This program checks the installed packages in the system against the build " 12331"dependencies and build conflicts listed in the control file. If any are not " 12332"met, it displays them and exits with a nonzero return code." 12333msgstr "" 12334 12335#. type: Plain text 12336#: dpkg-checkbuilddeps.man 12337msgid "" 12338"By default, B<debian/control> is read, but an alternate control filename may " 12339"be specified on the command line." 12340msgstr "" 12341 12342#. type: Plain text 12343#: dpkg-checkbuilddeps.man 12344msgid "" 12345"Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch> lines (since dpkg " 12346"1.16.4). Use when only arch-indep packages will be built, or combine with " 12347"B<-B> when only a source package is to be built." 12348msgstr "" 12349 12350#. type: Plain text 12351#: dpkg-checkbuilddeps.man 12352msgid "" 12353"Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep> lines. Use when " 12354"only arch-dep packages will be built, or combine with B<-A> when only a " 12355"source package is to be built." 12356msgstr "" 12357 12358#. type: TP 12359#: dpkg-checkbuilddeps.man 12360#, no-wrap 12361msgid "B<-I>" 12362msgstr "" 12363 12364#. type: Plain text 12365#: dpkg-checkbuilddeps.man 12366msgid "" 12367"Ignore built-in build depends and conflicts (since dpkg 1.18.2). These are " 12368"implicit dependencies that are usually required on a specific distribution, " 12369"the so called Build-Essential package set." 12370msgstr "" 12371 12372#. type: TP 12373#: dpkg-checkbuilddeps.man 12374#, no-wrap 12375msgid "B<-d >I<build-depends-string>" 12376msgstr "" 12377 12378#. type: TP 12379#: dpkg-checkbuilddeps.man 12380#, no-wrap 12381msgid "B<-c >I<build-conflicts-string>" 12382msgstr "" 12383 12384#. type: Plain text 12385#: dpkg-checkbuilddeps.man 12386msgid "" 12387"Use the given build dependencies/conflicts instead of those contained in the " 12388"I<debian/control> file (since dpkg 1.14.17)." 12389msgstr "" 12390 12391#. type: TP 12392#: dpkg-checkbuilddeps.man 12393#, no-wrap 12394msgid "B<-a >I<arch>" 12395msgstr "" 12396 12397#. type: Plain text 12398#: dpkg-checkbuilddeps.man 12399msgid "" 12400"Check build dependencies/conflicts assuming that the package described in " 12401"the control file is to be built for the given host architecture instead of " 12402"the architecture of the current system (since dpkg 1.16.2)." 12403msgstr "" 12404 12405#. type: TP 12406#: dpkg-checkbuilddeps.man 12407#, no-wrap 12408msgid "B<-P >I<profile>[B<,>...]" 12409msgstr "" 12410 12411#. type: Plain text 12412#: dpkg-checkbuilddeps.man 12413msgid "" 12414"Check build dependencies/conflicts assuming that the package described in " 12415"the control file is to be built for the given build profile(s) (since dpkg " 12416"1.17.2). The argument is a comma-separated list of profile names." 12417msgstr "" 12418 12419#. type: Plain text 12420#: dpkg-checkbuilddeps.man 12421msgid "" 12422"If set, it will be used as the active build profile(s) for the package being " 12423"built. It is a space separated list of profile names. Overridden by the B<-" 12424"P> option." 12425msgstr "" 12426 12427#. type: TH 12428#: dpkg-distaddfile.man 12429#, no-wrap 12430msgid "dpkg-distaddfile" 12431msgstr "" 12432 12433#. type: Plain text 12434#: dpkg-distaddfile.man 12435msgid "dpkg-distaddfile - add entries to debian/files" 12436msgstr "" 12437 12438#. type: Plain text 12439#: dpkg-distaddfile.man 12440msgid "B<dpkg-distaddfile> [I<option>...]I< filename section priority>" 12441msgstr "" 12442 12443#. type: Plain text 12444#: dpkg-distaddfile.man 12445msgid "B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>." 12446msgstr "" 12447 12448#. type: Plain text 12449#: dpkg-distaddfile.man 12450msgid "" 12451"It takes three non-option arguments, the filename and the section and " 12452"priority for the B<.changes> file." 12453msgstr "" 12454 12455#. type: Plain text 12456#: dpkg-distaddfile.man 12457msgid "" 12458"The filename should be specified relative to the directory where B<dpkg-" 12459"genchanges> will expect to find the files, usually B<..>, rather than being " 12460"a pathname relative to the current directory when B<dpkg-distaddfile> is run." 12461msgstr "" 12462 12463#. type: Plain text 12464#: dpkg-distaddfile.man dpkg-gencontrol.man 12465msgid "" 12466"Read or write the list of files to be uploaded here, rather than using " 12467"B<debian/files>." 12468msgstr "" 12469 12470#. type: Plain text 12471#: dpkg-distaddfile.man 12472msgid "" 12473"The list of generated files which are part of the upload being prepared. " 12474"B<dpkg-distaddfile> can be used to add additional files." 12475msgstr "" 12476 12477#. type: Plain text 12478#: dpkg-distaddfile.man 12479#, fuzzy 12480#| msgid "B<--unpack >I<package-file>..." 12481msgid "B<deb-src-files>(5)." 12482msgstr "B<--unpack >I<package-file>..." 12483 12484#. type: TH 12485#: dpkg-deb.man 12486#, no-wrap 12487msgid "dpkg-deb" 12488msgstr "" 12489 12490#. type: Plain text 12491#: dpkg-deb.man 12492msgid "dpkg-deb - Debian package archive (.deb) manipulation tool" 12493msgstr "" 12494 12495#. type: Plain text 12496#: dpkg-deb.man 12497msgid "B<dpkg-deb> [I<option>...] I<command>" 12498msgstr "" 12499 12500#. type: Plain text 12501#: dpkg-deb.man 12502msgid "" 12503"B<dpkg-deb> packs, unpacks and provides information about Debian archives." 12504msgstr "" 12505 12506#. type: Plain text 12507#: dpkg-deb.man 12508msgid "Use B<dpkg> to install and remove packages from your system." 12509msgstr "" 12510 12511#. type: Plain text 12512#: dpkg-deb.man 12513msgid "" 12514"You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you " 12515"want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> " 12516"and run it for you." 12517msgstr "" 12518 12519#. type: Plain text 12520#: dpkg-deb.man 12521msgid "" 12522"For most commands taking an input archive argument, the archive can be read " 12523"from standard input if the archive name is given as a single minus character " 12524"(«B<->»); otherwise lack of support will be documented in their respective " 12525"command description." 12526msgstr "" 12527 12528#. type: TP 12529#: dpkg-deb.man 12530#, no-wrap 12531msgid "B<-b>, B<--build> I<binary-directory> [I<archive>|I<directory>]" 12532msgstr "" 12533 12534#. type: Plain text 12535#: dpkg-deb.man 12536msgid "" 12537"Creates a debian archive from the filesystem tree stored in I<binary-" 12538"directory>. I<binary-directory> must have a B<DEBIAN> subdirectory, which " 12539"contains the control information files such as the control file itself. This " 12540"directory will I<not> appear in the binary package's filesystem archive, but " 12541"instead the files in it will be put in the binary package's control " 12542"information area." 12543msgstr "" 12544 12545#. type: Plain text 12546#: dpkg-deb.man 12547msgid "" 12548"Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and " 12549"parse it. It will check the file for syntax errors and other problems, and " 12550"display the name of the binary package being built. B<dpkg-deb> will also " 12551"check the permissions of the maintainer scripts and other files found in the " 12552"B<DEBIAN> control information directory." 12553msgstr "" 12554 12555#. type: Plain text 12556#: dpkg-deb.man 12557msgid "" 12558"If no I<archive> is specified then B<dpkg-deb> will write the package into " 12559"the file I<binary-directory>B<.deb>." 12560msgstr "" 12561 12562#. type: Plain text 12563#: dpkg-deb.man 12564msgid "If the archive to be created already exists it will be overwritten." 12565msgstr "" 12566 12567#. type: Plain text 12568#: dpkg-deb.man 12569msgid "" 12570"If the second argument is a directory then B<dpkg-deb> will write to the " 12571"file I<directory>B</>I<package>B<_>I<version>B<_>I<arch>B<.deb.> When a " 12572"target directory is specified, rather than a file, the B<--nocheck> option " 12573"may not be used (since B<dpkg-deb> needs to read and parse the package " 12574"control file to determine which filename to use)." 12575msgstr "" 12576 12577#. type: TP 12578#: dpkg-deb.man 12579#, no-wrap 12580msgid "B<-I>, B<--info> I<archive> [I<control-file-name>...]" 12581msgstr "" 12582 12583#. type: Plain text 12584#: dpkg-deb.man 12585msgid "Provides information about a binary package archive." 12586msgstr "" 12587 12588#. type: Plain text 12589#: dpkg-deb.man 12590msgid "" 12591"If no I<control-file-name>s are specified then it will print a summary of " 12592"the contents of the package as well as its control file." 12593msgstr "" 12594 12595#. type: Plain text 12596#: dpkg-deb.man 12597msgid "" 12598"If any I<control-file-name>s are specified then B<dpkg-deb> will print them " 12599"in the order they were specified; if any of the components weren't present " 12600"it will print an error message to stderr about each one and exit with status " 12601"2." 12602msgstr "" 12603 12604#. type: TP 12605#: dpkg-deb.man 12606#, no-wrap 12607msgid "B<-W>, B<--show> I<archive>" 12608msgstr "" 12609 12610#. type: Plain text 12611#: dpkg-deb.man 12612msgid "" 12613"Provides information about a binary package archive in the format specified " 12614"by the B<--showformat> argument. The default format displays the package's " 12615"name and version on one line, separated by a tabulator." 12616msgstr "" 12617 12618#. type: TP 12619#: dpkg-deb.man 12620#, no-wrap 12621msgid "B<-f>, B<--field> I<archive> [I<control-field-name>...]" 12622msgstr "" 12623 12624#. type: Plain text 12625#: dpkg-deb.man 12626msgid "Extracts control file information from a binary package archive." 12627msgstr "" 12628 12629#. type: Plain text 12630#: dpkg-deb.man 12631msgid "" 12632"If no I<control-field-name>s are specified then it will print the whole " 12633"control file." 12634msgstr "" 12635 12636#. type: Plain text 12637#: dpkg-deb.man 12638msgid "" 12639"If any are specified then B<dpkg-deb> will print their contents, in the " 12640"order in which they appear in the control file. If more than one I<control-" 12641"field-name> is specified then B<dpkg-deb> will precede each with its field " 12642"name (and a colon and space)." 12643msgstr "" 12644 12645#. type: Plain text 12646#: dpkg-deb.man 12647msgid "No errors are reported for fields requested but not found." 12648msgstr "" 12649 12650#. type: TP 12651#: dpkg-deb.man 12652#, no-wrap 12653msgid "B<-c>, B<--contents> I<archive>" 12654msgstr "" 12655 12656#. type: Plain text 12657#: dpkg-deb.man 12658msgid "" 12659"Lists the contents of the filesystem tree archive portion of the package " 12660"archive. It is currently produced in the format generated by B<tar>'s " 12661"verbose listing." 12662msgstr "" 12663 12664#. type: TP 12665#: dpkg-deb.man 12666#, no-wrap 12667msgid "B<-x>, B<--extract> I<archive directory>" 12668msgstr "" 12669 12670#. type: Plain text 12671#: dpkg-deb.man 12672msgid "" 12673"Extracts the filesystem tree from a package archive into the specified " 12674"directory." 12675msgstr "" 12676 12677#. type: Plain text 12678#: dpkg-deb.man 12679msgid "" 12680"Note that extracting a package to the root directory will I<not> result in a " 12681"correct installation! Use B<dpkg> to install packages." 12682msgstr "" 12683 12684#. type: Plain text 12685#: dpkg-deb.man 12686msgid "" 12687"I<directory> (but not its parents) will be created if necessary, and its " 12688"permissions modified to match the contents of the package." 12689msgstr "" 12690 12691#. type: TP 12692#: dpkg-deb.man 12693#, no-wrap 12694msgid "B<-X>, B<--vextract> I<archive directory>" 12695msgstr "" 12696 12697#. type: Plain text 12698#: dpkg-deb.man 12699msgid "" 12700"Is like B<--extract> (B<-x>) with B<--verbose> (B<-v>) which prints a " 12701"listing of the files extracted as it goes." 12702msgstr "" 12703 12704#. type: TP 12705#: dpkg-deb.man 12706#, no-wrap 12707msgid "B<-R>, B<--raw-extract> I<archive directory>" 12708msgstr "" 12709 12710#. type: Plain text 12711#: dpkg-deb.man 12712msgid "" 12713"Extracts the filesystem tree from a package archive into a specified " 12714"directory, and the control information files into a B<DEBIAN> subdirectory " 12715"of the specified directory (since dpkg 1.16.1)." 12716msgstr "" 12717 12718#. type: Plain text 12719#: dpkg-deb.man 12720msgid "" 12721"The target directory (but not its parents) will be created if necessary." 12722msgstr "" 12723 12724#. type: Plain text 12725#: dpkg-deb.man 12726msgid "" 12727"The input archive is not (currently) processed sequentially, so reading it " 12728"from standard input («B<->») is B<not> supported." 12729msgstr "" 12730 12731#. type: TP 12732#: dpkg-deb.man 12733#, no-wrap 12734msgid "B<--ctrl-tarfile> I<archive>" 12735msgstr "" 12736 12737#. type: Plain text 12738#: dpkg-deb.man 12739msgid "" 12740"Extracts the control data from a binary package and sends it to standard " 12741"output in B<tar> format (since dpkg 1.17.14). Together with B<tar>(1) this " 12742"can be used to extract a particular control file from a package archive. " 12743"The input archive will always be processed sequentially." 12744msgstr "" 12745 12746#. type: TP 12747#: dpkg-deb.man 12748#, no-wrap 12749msgid "B<--fsys-tarfile> I<archive>" 12750msgstr "" 12751 12752#. type: Plain text 12753#: dpkg-deb.man 12754msgid "" 12755"Extracts the filesystem tree data from a binary package and sends it to " 12756"standard output in B<tar> format. Together with B<tar>(1) this can be used " 12757"to extract a particular file from a package archive. The input archive will " 12758"always be processed sequentially." 12759msgstr "" 12760 12761#. type: TP 12762#: dpkg-deb.man 12763#, no-wrap 12764msgid "B<-e>, B<--control> I<archive> [I<directory>]" 12765msgstr "" 12766 12767#. type: Plain text 12768#: dpkg-deb.man 12769msgid "" 12770"Extracts the control information files from a package archive into the " 12771"specified directory." 12772msgstr "" 12773 12774#. type: Plain text 12775#: dpkg-deb.man 12776msgid "" 12777"If no directory is specified then a subdirectory B<DEBIAN> in the current " 12778"directory is used." 12779msgstr "" 12780 12781#. type: TP 12782#: dpkg-deb.man 12783#, no-wrap 12784msgid "B<--showformat=>I<format>" 12785msgstr "" 12786 12787#. type: Plain text 12788#: dpkg-deb.man 12789msgid "" 12790"This option is used to specify the format of the output B<--show> will " 12791"produce. The format is a string that will be output for each package listed." 12792msgstr "" 12793 12794#. type: Plain text 12795#: dpkg-deb.man 12796msgid "" 12797"The string may reference any status field using the “${I<field-name>}” form, " 12798"a list of the valid fields can be easily produced using B<-I> on the same " 12799"package. A complete explanation of the formatting options (including escape " 12800"sequences and field tabbing) can be found in the explanation of the B<--" 12801"showformat> option in B<dpkg-query>(1)." 12802msgstr "" 12803 12804#. type: Plain text 12805#: dpkg-deb.man 12806msgid "The default for this field is “${Package}\\et${Version}\\en”." 12807msgstr "" 12808 12809#. type: TP 12810#: dpkg-deb.man 12811#, no-wrap 12812msgid "B<-z>I<compress-level>" 12813msgstr "" 12814 12815#. type: Plain text 12816#: dpkg-deb.man 12817msgid "" 12818"Specify which compression level to use on the compressor backend, when " 12819"building a package (default is 9 for gzip, 6 for xz). The accepted values " 12820"are 0-9 with: 0 being mapped to compressor none for gzip. Before dpkg " 12821"1.16.2 level 0 was equivalent to compressor none for all compressors." 12822msgstr "" 12823 12824#. type: TP 12825#: dpkg-deb.man 12826#, no-wrap 12827msgid "B<-S>I<compress-strategy>" 12828msgstr "" 12829 12830#. type: Plain text 12831#: dpkg-deb.man 12832msgid "" 12833"Specify which compression strategy to use on the compressor backend, when " 12834"building a package (since dpkg 1.16.2). Allowed values are B<none> (since " 12835"dpkg 1.16.4), B<filtered>, B<huffman>, B<rle> and B<fixed> for gzip (since " 12836"dpkg 1.17.0) and B<extreme> for xz." 12837msgstr "" 12838 12839#. type: TP 12840#: dpkg-deb.man 12841#, no-wrap 12842msgid "B<-Z>I<compress-type>" 12843msgstr "" 12844 12845#. type: Plain text 12846#: dpkg-deb.man 12847msgid "" 12848"Specify which compression type to use when building a package. Allowed " 12849"values are B<gzip>, B<xz> (since dpkg 1.15.6), and B<none> (default is " 12850"B<xz>)." 12851msgstr "" 12852 12853#. type: TP 12854#: dpkg-deb.man 12855#, no-wrap 12856msgid "B<--[no-]uniform-compression>" 12857msgstr "" 12858 12859#. type: Plain text 12860#: dpkg-deb.man 12861msgid "" 12862"Specify that the same compression parameters should be used for all archive " 12863"members (i.e. B<control.tar> and B<data.tar>; since dpkg 1.17.6). Otherwise " 12864"only the B<data.tar> member will use those parameters. The only supported " 12865"compression types allowed to be uniformly used are B<none>, B<gzip> and " 12866"B<xz>. The B<--no-uniform-compression> option disables uniform compression " 12867"(since dpkg 1.19.0). Uniform compression is the default (since dpkg 1.19.0)." 12868msgstr "" 12869 12870#. type: TP 12871#: dpkg-deb.man 12872#, no-wrap 12873msgid "B<--root-owner-group>" 12874msgstr "" 12875 12876#. type: Plain text 12877#: dpkg-deb.man 12878msgid "" 12879"Set the owner and group for each entry in the filesystem tree data to root " 12880"with id 0 (since dpkg 1.19.0)." 12881msgstr "" 12882 12883#. type: Plain text 12884#: dpkg-deb.man 12885msgid "" 12886"B<Note>: This option can be useful for rootless builds (see I<rootless-" 12887"builds.txt>), but should B<not> be used when the entries have an owner or " 12888"group that is not root. Support for these will be added later in the form " 12889"of a meta manifest." 12890msgstr "" 12891 12892#. type: TP 12893#: dpkg-deb.man 12894#, no-wrap 12895msgid "B<--deb-format=>I<format>" 12896msgstr "" 12897 12898#. type: Plain text 12899#: dpkg-deb.man 12900msgid "" 12901"Set the archive format version used when building (since dpkg 1.17.0). " 12902"Allowed values are B<2.0> for the new format, and B<0.939000> for the old " 12903"one (default is B<2.0>)." 12904msgstr "" 12905 12906#. type: Plain text 12907#: dpkg-deb.man 12908msgid "" 12909"The old archive format is less easily parsed by non-Debian tools and is now " 12910"obsolete; its only use is when building packages to be parsed by versions of " 12911"dpkg older than 0.93.76 (September 1995), which was released as i386 a.out " 12912"only." 12913msgstr "" 12914 12915#. type: TP 12916#: dpkg-deb.man 12917#, no-wrap 12918msgid "B<--nocheck>" 12919msgstr "" 12920 12921#. type: Plain text 12922#: dpkg-deb.man 12923msgid "" 12924"Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an " 12925"archive. You can build any archive you want, no matter how broken, this way." 12926msgstr "" 12927 12928#. type: TP 12929#: dpkg-deb.man start-stop-daemon.man 12930#, no-wrap 12931msgid "B<-v>, B<--verbose>" 12932msgstr "" 12933 12934#. type: Plain text 12935#: dpkg-deb.man 12936msgid "" 12937"Enables verbose output (since dpkg 1.16.1). This currently only affects B<--" 12938"extract> making it behave like B<--vextract>." 12939msgstr "" 12940 12941#. type: TP 12942#: dpkg-deb.man 12943#, no-wrap 12944msgid "B<-D>, B<--debug>" 12945msgstr "" 12946 12947#. type: Plain text 12948#: dpkg-deb.man 12949msgid "Enables debugging output. This is not very interesting." 12950msgstr "" 12951 12952#. type: Plain text 12953#: dpkg-deb.man dpkg-divert.man dpkg-statoverride.man update-alternatives.man 12954msgid "The requested action was successfully performed." 12955msgstr "" 12956 12957#. type: Plain text 12958#: dpkg-deb.man 12959msgid "" 12960"If set, B<dpkg-deb> will use it as the directory in which to create " 12961"temporary files and directories." 12962msgstr "" 12963 12964#. type: Plain text 12965#: dpkg-deb.man 12966msgid "" 12967"If set, it will be used as the timestamp (as seconds since the epoch) in the " 12968"B<deb>(5)'s B<ar>(5) container and used to clamp the mtime in the B<tar>(5) " 12969"file entries." 12970msgstr "" 12971 12972#. type: Plain text 12973#: dpkg-deb.man 12974msgid "" 12975"Do not attempt to use just B<dpkg-deb> to install software! You must use " 12976"B<dpkg> proper to ensure that all the files are correctly placed and the " 12977"package's scripts run and its status and contents recorded." 12978msgstr "" 12979 12980#. type: Plain text 12981#: dpkg-deb.man 12982msgid "" 12983"B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing." 12984msgstr "" 12985 12986#. type: Plain text 12987#: dpkg-deb.man 12988msgid "" 12989"There is no authentication on B<.deb> files; in fact, there isn't even a " 12990"straightforward checksum. (Higher level tools like APT support " 12991"authenticating B<.deb> packages retrieved from a given repository, and most " 12992"packages nowadays provide an md5sum control file generated by debian/rules. " 12993"Though this is not directly supported by the lower level tools.)" 12994msgstr "" 12995 12996#. type: Plain text 12997#: dpkg-deb.man 12998msgid "B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dselect>(1)." 12999msgstr "" 13000 13001#. type: TH 13002#: dpkg-divert.man 13003#, no-wrap 13004msgid "dpkg-divert" 13005msgstr "" 13006 13007#. type: Plain text 13008#: dpkg-divert.man 13009msgid "dpkg-divert - override a package's version of a file" 13010msgstr "" 13011 13012#. type: Plain text 13013#: dpkg-divert.man 13014msgid "B<dpkg-divert> [I<option>...] I<command>" 13015msgstr "" 13016 13017#. type: Plain text 13018#: dpkg-divert.man 13019msgid "" 13020"B<dpkg-divert> is the utility used to set up and update the list of " 13021"diversions." 13022msgstr "" 13023 13024#. type: Plain text 13025#: dpkg-divert.man 13026msgid "" 13027"File I<diversions> are a way of forcing B<dpkg>(1) not to install a file " 13028"into its location, but to a I<diverted> location. Diversions can be used " 13029"through the Debian package scripts to move a file away when it causes a " 13030"conflict. System administrators can also use it to override some package's " 13031"configuration file, or whenever some files (which aren't marked as " 13032"“conffiles”) need to be preserved by B<dpkg>, when installing a newer " 13033"version of a package which contains those files." 13034msgstr "" 13035 13036#. type: TP 13037#: dpkg-divert.man 13038#, no-wrap 13039msgid "[B<--add>] I<file>" 13040msgstr "" 13041 13042#. type: Plain text 13043#: dpkg-divert.man 13044msgid "" 13045"Add a diversion for I<file>. The file is currently not renamed, see B<--" 13046"rename>." 13047msgstr "" 13048 13049#. type: TP 13050#: dpkg-divert.man 13051#, no-wrap 13052msgid "B<--remove>I< file>" 13053msgstr "" 13054 13055#. type: Plain text 13056#: dpkg-divert.man 13057msgid "" 13058"Remove a diversion for I<file>. The file is currently not renamed, see B<--" 13059"rename>." 13060msgstr "" 13061 13062#. type: TP 13063#: dpkg-divert.man 13064#, no-wrap 13065msgid "B<--list>I< glob-pattern>" 13066msgstr "" 13067 13068#. type: Plain text 13069#: dpkg-divert.man 13070msgid "List diversions matching I<glob-pattern>." 13071msgstr "" 13072 13073#. type: TP 13074#: dpkg-divert.man 13075#, no-wrap 13076msgid "B<--listpackage>I< file>" 13077msgstr "" 13078 13079#. type: Plain text 13080#: dpkg-divert.man 13081msgid "" 13082"Print the name of the package that diverts I<file> (since dpkg 1.15.0). " 13083"Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not " 13084"diverted." 13085msgstr "" 13086 13087#. type: TP 13088#: dpkg-divert.man 13089#, no-wrap 13090msgid "B<--truename>I< file>" 13091msgstr "" 13092 13093#. type: Plain text 13094#: dpkg-divert.man 13095msgid "Print the real name for a diverted file." 13096msgstr "" 13097 13098#. type: TP 13099#: dpkg-divert.man dpkg-statoverride.man dselect.man update-alternatives.man 13100#, no-wrap 13101msgid "B<--admindir>I< directory>" 13102msgstr "" 13103 13104#. type: Plain text 13105#: dpkg-divert.man 13106msgid "" 13107"Set the administrative directory to I<directory>. Defaults to «I<%ADMINDIR" 13108"%>»." 13109msgstr "" 13110 13111#. type: TP 13112#: dpkg-divert.man dpkg-statoverride.man 13113#, fuzzy, no-wrap 13114#| msgid "B<--instdir=>I<dir>" 13115msgid "B<--instdir>I< directory>" 13116msgstr "B<--instdir=>I<dir>" 13117 13118#. type: Plain text 13119#: dpkg-divert.man 13120msgid "" 13121"Set the installation directory, which refers to the directory where packages " 13122"get installed (since dpkg 1.19.2). Defaults to «I</>»." 13123msgstr "" 13124 13125#. type: TP 13126#: dpkg-divert.man dpkg-statoverride.man 13127#, fuzzy, no-wrap 13128#| msgid "B<--root=>I<dir>" 13129msgid "B<--root>I< directory>" 13130msgstr "B<--root=>I<dir>" 13131 13132#. type: Plain text 13133#: dpkg-divert.man dpkg-statoverride.man 13134msgid "" 13135"Set the root directory to B<directory>, which sets the installation " 13136"directory to «I<directory>» and the administrative directory to " 13137"«I<directory>B<%ADMINDIR%>» (since dpkg 1.19.2)." 13138msgstr "" 13139 13140#. type: TP 13141#: dpkg-divert.man 13142#, no-wrap 13143msgid "B<--divert>I< divert-to>" 13144msgstr "" 13145 13146#. type: Plain text 13147#: dpkg-divert.man 13148msgid "" 13149"I<divert-to> is the location where the versions of I<file>, as provided by " 13150"other packages, will be diverted." 13151msgstr "" 13152 13153#. type: TP 13154#: dpkg-divert.man 13155#, no-wrap 13156msgid "B<--local>" 13157msgstr "" 13158 13159#. type: Plain text 13160#: dpkg-divert.man 13161msgid "" 13162"Specifies that all packages' versions of this file are diverted. This " 13163"means, that there are no exceptions, and whatever package is installed, the " 13164"file is diverted. This can be used by an admin to install a locally modified " 13165"version." 13166msgstr "" 13167 13168#. type: TP 13169#: dpkg-divert.man 13170#, no-wrap 13171msgid "B<--package>I< package>" 13172msgstr "" 13173 13174#. type: Plain text 13175#: dpkg-divert.man 13176msgid "" 13177"I<package> is the name of a package whose copy of I<file> will not be " 13178"diverted. i.e. I<file> will be diverted for all packages except I<package>." 13179msgstr "" 13180 13181#. type: TP 13182#: dpkg-divert.man dpkg-statoverride.man update-alternatives.man 13183#, no-wrap 13184msgid "B<--quiet>" 13185msgstr "" 13186 13187#. type: Plain text 13188#: dpkg-divert.man 13189msgid "Quiet mode, i.e. no verbose output." 13190msgstr "" 13191 13192#. type: TP 13193#: dpkg-divert.man 13194#, no-wrap 13195msgid "B<--rename>" 13196msgstr "" 13197 13198#. type: Plain text 13199#: dpkg-divert.man 13200msgid "" 13201"Actually move the file aside (or back). B<dpkg-divert> will abort operation " 13202"in case the destination file already exists. This is the common behavior " 13203"used for diversions of files from the non-B<Essential> package set (see B<--" 13204"no-rename> for more details)." 13205msgstr "" 13206 13207#. type: TP 13208#: dpkg-divert.man 13209#, fuzzy, no-wrap 13210#| msgid "B<--version>" 13211msgid "B<--no-rename>" 13212msgstr "B<--version>" 13213 13214#. type: Plain text 13215#: dpkg-divert.man 13216msgid "" 13217"Specifies that the file should not be renamed while adding or removing the " 13218"diversion into the database (since dpkg 1.19.1). This is intended for " 13219"diversions of files from the B<Essential> package set, where the temporary " 13220"disappearance of the original file is not acceptable, as it can render the " 13221"system non-functional. This is the default behavior, but that will change " 13222"in the dpkg 1.20.x cycle." 13223msgstr "" 13224 13225#. type: TP 13226#: dpkg-divert.man 13227#, no-wrap 13228msgid "B<--test>" 13229msgstr "" 13230 13231#. type: Plain text 13232#: dpkg-divert.man 13233msgid "Test mode, i.e. don't actually perform any changes, just demonstrate." 13234msgstr "" 13235 13236#. type: Plain text 13237#: dpkg-divert.man dpkg-statoverride.man 13238msgid "" 13239"If set and the B<--instdir> or B<--root> options have not been specified, it " 13240"will be used as the filesystem root directory (since dpkg 1.19.2)." 13241msgstr "" 13242 13243#. type: Plain text 13244#: dpkg-divert.man dpkg-statoverride.man 13245msgid "" 13246"If set and the B<--admindir> or B<--root> options have not been specified, " 13247"it will be used as the B<dpkg> data directory." 13248msgstr "" 13249 13250#. type: Plain text 13251#: dpkg-divert.man 13252msgid "" 13253"If set and the B<--local> and B<--package> options have not been specified, " 13254"B<dpkg-divert> will use it as the package name." 13255msgstr "" 13256 13257#. type: TP 13258#: dpkg-divert.man 13259#, no-wrap 13260msgid "I<%ADMINDIR%/diversions>" 13261msgstr "" 13262 13263#. type: Plain text 13264#: dpkg-divert.man 13265msgid "" 13266"File which contains the current list of diversions of the system. It is " 13267"located in the B<dpkg> administration directory, along with other files " 13268"important to B<dpkg>, such as I<status> or I<available>." 13269msgstr "" 13270 13271#. type: Plain text 13272#: dpkg-divert.man 13273msgid "" 13274"Note: B<dpkg-divert> preserves the old copy of this file, with extension I<-" 13275"old>, before replacing it with the new one." 13276msgstr "" 13277 13278#. type: Plain text 13279#: dpkg-divert.man 13280msgid "" 13281"When adding, default is B<--local> and B<--divert> I<original>B<.distrib>. " 13282"When removing, B<--package> or B<--local> and B<--divert> must match if " 13283"specified." 13284msgstr "" 13285 13286#. type: Plain text 13287#: dpkg-divert.man 13288msgid "Directories can't be diverted with B<dpkg-divert>." 13289msgstr "" 13290 13291#. type: Plain text 13292#: dpkg-divert.man 13293msgid "" 13294"Care should be taken when diverting shared libraries, B<ldconfig>(8) " 13295"creates a symbolic link based on the DT_SONAME field embedded in the " 13296"library. Because B<ldconfig> doesn't honour diverts (only B<dpkg> does), " 13297"the symlink may end up pointing at the diverted library, if a diverted " 13298"library has the same SONAME as the undiverted one." 13299msgstr "" 13300 13301#. type: Plain text 13302#: dpkg-divert.man 13303msgid "" 13304"To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, i." 13305"e. directs all packages providing I</usr/bin/example> to install it as I</" 13306"usr/bin/example.foo>, performing the rename if required:" 13307msgstr "" 13308 13309#. type: Plain text 13310#: dpkg-divert.man 13311msgid "dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example" 13312msgstr "" 13313 13314#. type: Plain text 13315#: dpkg-divert.man 13316msgid "To remove that diversion:" 13317msgstr "" 13318 13319#. type: Plain text 13320#: dpkg-divert.man 13321msgid "dpkg-divert --rename --remove /usr/bin/example" 13322msgstr "" 13323 13324#. type: Plain text 13325#: dpkg-divert.man 13326msgid "" 13327"To divert any package trying to install I</usr/bin/example> to I</usr/bin/" 13328"example.foo>, except your own I<wibble> package:" 13329msgstr "" 13330 13331#. type: Plain text 13332#: dpkg-divert.man 13333msgid "" 13334"dpkg-divert --package wibble --divert /usr/bin/example.foo --rename /usr/bin/" 13335"example" 13336msgstr "" 13337 13338#. type: Plain text 13339#: dpkg-divert.man 13340msgid "dpkg-divert --package wibble --rename --remove /usr/bin/example" 13341msgstr "" 13342 13343#. type: TH 13344#: dpkg-genchanges.man 13345#, no-wrap 13346msgid "dpkg-genchanges" 13347msgstr "" 13348 13349#. type: Plain text 13350#: dpkg-genchanges.man 13351msgid "dpkg-genchanges - generate Debian .changes files" 13352msgstr "" 13353 13354#. type: Plain text 13355#: dpkg-genchanges.man 13356msgid "B<dpkg-genchanges> [I<option>...]" 13357msgstr "" 13358 13359#. type: Plain text 13360#: dpkg-genchanges.man 13361msgid "" 13362"B<dpkg-genchanges> reads information from an unpacked and built Debian " 13363"source tree and from the files it has generated and generates a Debian " 13364"upload control file (B<.changes> file)." 13365msgstr "" 13366 13367#. type: Plain text 13368#: dpkg-genchanges.man 13369msgid "" 13370"Specifies the build I<type> from a comma-separated list of components (since " 13371"dpkg 1.18.5)." 13372msgstr "" 13373 13374#. type: Plain text 13375#: dpkg-genchanges.man 13376msgid "Upload the source package." 13377msgstr "" 13378 13379#. type: Plain text 13380#: dpkg-genchanges.man 13381msgid "Upload the architecture specific binary packages." 13382msgstr "" 13383 13384#. type: Plain text 13385#: dpkg-genchanges.man 13386msgid "Upload the architecture independent binary packages." 13387msgstr "" 13388 13389#. type: Plain text 13390#: dpkg-genchanges.man 13391msgid "" 13392"Upload the architecture specific and independent binary packages. This is " 13393"an alias for B<any,all>." 13394msgstr "" 13395 13396#. type: Plain text 13397#: dpkg-genchanges.man 13398msgid "" 13399"Upload everything. This is alias for B<source,any,all>, and the same as the " 13400"default case when no build option is specified." 13401msgstr "" 13402 13403#. type: Plain text 13404#: dpkg-genchanges.man 13405msgid "" 13406"The B<-s>I<x> options control whether the original source archive is " 13407"included in the upload if any source is being generated (i.e. B<-b> or B<-" 13408"B> haven't been used)." 13409msgstr "" 13410 13411#. type: Plain text 13412#: dpkg-genchanges.man 13413msgid "" 13414"By default, or if specified, the original source will be included only if " 13415"the upstream version number (the version without epoch and without Debian " 13416"revision) differs from the upstream version number of the previous changelog " 13417"entry." 13418msgstr "" 13419 13420#. type: Plain text 13421#: dpkg-genchanges.man 13422msgid "Forces the inclusion of the original source." 13423msgstr "" 13424 13425#. type: Plain text 13426#: dpkg-genchanges.man 13427msgid "Forces the exclusion of the original source and includes only the diff." 13428msgstr "" 13429 13430#. type: Plain text 13431#: dpkg-genchanges.man 13432msgid "" 13433"Causes changelog information from all versions strictly later than " 13434"I<version> to be used." 13435msgstr "" 13436 13437#. type: Plain text 13438#: dpkg-genchanges.man 13439msgid "" 13440"Read the description of the changes from the file I<changes-description> " 13441"rather than using the information from the source tree's changelog file." 13442msgstr "" 13443 13444#. type: TP 13445#: dpkg-genchanges.man 13446#, no-wrap 13447msgid "B<-m>I<maintainer-address>" 13448msgstr "" 13449 13450#. type: Plain text 13451#: dpkg-genchanges.man 13452msgid "" 13453"Use I<maintainer-address> as the name and email address of the maintainer " 13454"for this package, rather than using the information from the source tree's " 13455"control file." 13456msgstr "" 13457 13458#. type: TP 13459#: dpkg-genchanges.man 13460#, no-wrap 13461msgid "B<-e>I<maintainer-address>" 13462msgstr "" 13463 13464#. type: Plain text 13465#: dpkg-genchanges.man 13466msgid "" 13467"Use I<maintainer-address> as the name and email address of the maintainer " 13468"for this upload, rather than using the information from the source tree's " 13469"changelog." 13470msgstr "" 13471 13472#. type: TP 13473#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-source.man 13474#, no-wrap 13475msgid "B<-V>I<name>B<=>I<value>" 13476msgstr "" 13477 13478#. type: Plain text 13479#: dpkg-genchanges.man dpkg-source.man 13480msgid "" 13481"Set an output substitution variable. See B<deb-substvars>(5) for a " 13482"discussion of output substitution." 13483msgstr "" 13484 13485#. type: TP 13486#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-shlibdeps.man dpkg-source.man 13487#, no-wrap 13488msgid "B<-T>I<substvars-file>" 13489msgstr "" 13490 13491#. type: Plain text 13492#: dpkg-genchanges.man 13493msgid "" 13494"Read substitution variables in I<substvars-file>; the default is B<debian/" 13495"substvars>. No variable substitution is done on any of the fields that are " 13496"output, except for the contents extracted from each binary package " 13497"B<Description> field (since dpkg 1.19.0), however the special variable " 13498"I<Format> will override the field of the same name. This option can be used " 13499"multiple times to read substitution variables from multiple files (since " 13500"dpkg 1.15.6)." 13501msgstr "" 13502 13503#. type: TP 13504#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-source.man 13505#, no-wrap 13506msgid "B<-D>I<field>B<=>I<value>" 13507msgstr "" 13508 13509#. type: Plain text 13510#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-source.man 13511msgid "Override or add an output control file field." 13512msgstr "" 13513 13514#. type: TP 13515#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-source.man 13516#, no-wrap 13517msgid "B<-U>I<field>" 13518msgstr "" 13519 13520#. type: Plain text 13521#: dpkg-genchanges.man dpkg-gencontrol.man dpkg-source.man 13522msgid "Remove an output control file field." 13523msgstr "" 13524 13525#. type: Plain text 13526#: dpkg-genchanges.man 13527msgid "" 13528"Read the list of files to be uploaded here, rather than using B<debian/" 13529"files>." 13530msgstr "" 13531 13532#. type: Plain text 13533#: dpkg-genchanges.man 13534msgid "" 13535"Look for the files to be uploaded in I<upload-files-dir> rather than B<..> " 13536"(B<dpkg-genchanges> needs to find these files so that it can include their " 13537"sizes and checksums in the B<.changes> file)." 13538msgstr "" 13539 13540#. type: Plain text 13541#: dpkg-genchanges.man 13542msgid "" 13543"Usually B<dpkg-genchanges> will produce informative messages on standard " 13544"error, for example about how many of the package's source files are being " 13545"uploaded. B<-q> suppresses these messages." 13546msgstr "" 13547 13548#. type: Plain text 13549#: dpkg-genchanges.man 13550msgid "" 13551"Print the changes file to standard output (the default) or to I<filename> if " 13552"specified (since dpkg 1.18.5)." 13553msgstr "" 13554 13555#. type: Plain text 13556#: dpkg-genchanges.man 13557msgid "" 13558"The list of generated files which are part of the upload being prepared. " 13559"B<dpkg-genchanges> reads the data here when producing a B<.changes> file." 13560msgstr "" 13561 13562#. type: Plain text 13563#: dpkg-genchanges.man 13564#, fuzzy 13565#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 13566msgid "" 13567"B<deb-substvars>(5), B<deb-src-control>(5), B<deb-src-files>(5), B<deb-" 13568"changelog>(5), B<deb-changes>(5)." 13569msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 13570 13571#. type: TH 13572#: dpkg-gencontrol.man 13573#, no-wrap 13574msgid "dpkg-gencontrol" 13575msgstr "" 13576 13577#. type: Plain text 13578#: dpkg-gencontrol.man 13579msgid "dpkg-gencontrol - generate Debian control files" 13580msgstr "" 13581 13582#. type: Plain text 13583#: dpkg-gencontrol.man 13584msgid "B<dpkg-gencontrol> [I<option>...]" 13585msgstr "" 13586 13587#. type: Plain text 13588#: dpkg-gencontrol.man 13589msgid "" 13590"B<dpkg-gencontrol> reads information from an unpacked Debian source tree and " 13591"generates a binary package control file (which defaults to debian/tmp/DEBIAN/" 13592"control); during this process it will simplify the relation fields." 13593msgstr "" 13594 13595#. type: Plain text 13596#: dpkg-gencontrol.man 13597msgid "" 13598"Thus B<Pre-Depends>, B<Depends>, B<Recommends> and B<Suggests> are " 13599"simplified in this order by removing dependencies which are known to be true " 13600"according to the stronger dependencies already parsed. It will also remove " 13601"any self-dependency (in fact it will remove any dependency which evaluates " 13602"to true given the current version of the package as installed). Logically it " 13603"keeps the intersection of multiple dependencies on the same package. The " 13604"order of dependencies is preserved as best as possible: if any dependency " 13605"must be discarded due to another dependency appearing further in the field, " 13606"the superseding dependency will take the place of the discarded one." 13607msgstr "" 13608 13609#. type: Plain text 13610#: dpkg-gencontrol.man 13611msgid "" 13612"The other relation fields (B<Enhances>, B<Conflicts>, B<Breaks>, B<Replaces> " 13613"and B<Provides>) are also simplified individually by computing the union of " 13614"the various dependencies when a package is listed multiple times in the " 13615"field." 13616msgstr "" 13617 13618#. type: Plain text 13619#: dpkg-gencontrol.man 13620msgid "" 13621"B<dpkg-gencontrol> also adds an entry for the binary package to B<debian/" 13622"files>." 13623msgstr "" 13624 13625#. type: Plain text 13626#: dpkg-gencontrol.man 13627msgid "Sets the version number of the binary package which will be generated." 13628msgstr "" 13629 13630#. type: Plain text 13631#: dpkg-gencontrol.man 13632msgid "" 13633"Set an output substitution variable. See B<deb-substvars>(5) for discussion " 13634"of output substitution." 13635msgstr "" 13636 13637#. type: Plain text 13638#: dpkg-gencontrol.man 13639msgid "" 13640"Read substitution variables in I<substvars-file>; the default is B<debian/" 13641"substvars>. This option can be used multiple times to read substitution " 13642"variables from multiple files (since dpkg 1.15.6)." 13643msgstr "" 13644 13645#. type: TP 13646#: dpkg-gencontrol.man dpkg-source.man 13647#, no-wrap 13648msgid "B<-c>I<control-file>" 13649msgstr "" 13650 13651#. type: TP 13652#: dpkg-gencontrol.man dpkg-gensymbols.man 13653#, no-wrap 13654msgid "B<-p>I<package>" 13655msgstr "" 13656 13657#. type: Plain text 13658#: dpkg-gencontrol.man 13659msgid "" 13660"Generate information for the binary package I<package>. If the source " 13661"control file lists only one binary package then this option may be omitted; " 13662"otherwise it is essential to select which binary package's information to " 13663"generate." 13664msgstr "" 13665 13666#. type: TP 13667#: dpkg-gencontrol.man 13668#, no-wrap 13669msgid "B<-n>I<filename>" 13670msgstr "" 13671 13672#. type: Plain text 13673#: dpkg-gencontrol.man 13674msgid "" 13675"Assume the filename of the package will be I<filename> instead of the normal " 13676"package_version_arch.deb filename." 13677msgstr "" 13678 13679#. type: TP 13680#: dpkg-gencontrol.man 13681#, no-wrap 13682msgid "B<-is>, B<-ip>, B<-isp>" 13683msgstr "" 13684 13685#. type: Plain text 13686#: dpkg-gencontrol.man 13687msgid "" 13688"These options are ignored for compatibility with older versions of the dpkg " 13689"build scripts but are now deprecated. Previously they were used to tell " 13690"B<dpkg-gencontrol> to include the Section and Priority fields in the control " 13691"file. This is now the default behaviour. If you want to get the old " 13692"behaviour you can use the B<-U> option to delete the fields from the control " 13693"file." 13694msgstr "" 13695 13696#. type: TP 13697#: dpkg-gencontrol.man dpkg-gensymbols.man 13698#, no-wrap 13699msgid "B<-P>I<package-build-dir>" 13700msgstr "" 13701 13702#. type: Plain text 13703#: dpkg-gencontrol.man 13704msgid "" 13705"Tells B<dpkg-source> that the package is being built in I<package-build-dir> " 13706"instead of B<debian/tmp>. This value is used to find the default value of " 13707"the B<Installed-Size> substitution variable and control file field (using " 13708"B<du>), and for the default location of the output file." 13709msgstr "" 13710 13711#. type: Plain text 13712#: dpkg-gencontrol.man 13713msgid "" 13714"Print the control file to standard output (or I<filename> if specified, " 13715"since dpkg 1.17.2), rather than to B<debian/tmp/DEBIAN/control> (or " 13716"I<package-build-dir>B</DEBIAN/control> if B<-P> was used)." 13717msgstr "" 13718 13719#. type: TP 13720#: dpkg-gencontrol.man 13721#, no-wrap 13722msgid "B<debian/control>" 13723msgstr "" 13724 13725#. type: Plain text 13726#: dpkg-gencontrol.man 13727msgid "" 13728"The main source control information file, giving version-independent " 13729"information about the source package and the binary packages it can produce." 13730msgstr "" 13731 13732#. type: Plain text 13733#: dpkg-gencontrol.man 13734msgid "" 13735"The list of generated files which are part of the upload being prepared. " 13736"B<dpkg-gencontrol> adds the presumed filenames of binary packages whose " 13737"control files it generates here." 13738msgstr "" 13739 13740#. type: Plain text 13741#: dpkg-gencontrol.man 13742#, fuzzy 13743#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 13744msgid "" 13745"B<deb-substvars>(5), B<deb-src-control>(5), B<deb-changelog>(5), B<deb-" 13746"control>(5)." 13747msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 13748 13749#. type: TH 13750#: dpkg-gensymbols.man 13751#, no-wrap 13752msgid "dpkg-gensymbols" 13753msgstr "" 13754 13755#. type: Plain text 13756#: dpkg-gensymbols.man 13757msgid "" 13758"dpkg-gensymbols - generate symbols files (shared library dependency " 13759"information)" 13760msgstr "" 13761 13762#. type: Plain text 13763#: dpkg-gensymbols.man 13764msgid "B<dpkg-gensymbols> [I<option>...]" 13765msgstr "" 13766 13767#. type: Plain text 13768#: dpkg-gensymbols.man 13769msgid "" 13770"B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) " 13771"looking for libraries and generates a I<symbols> file describing them. This " 13772"file, if non-empty, is then installed in the DEBIAN subdirectory of the " 13773"build tree so that it ends up included in the control information of the " 13774"package." 13775msgstr "" 13776 13777#. type: Plain text 13778#: dpkg-gensymbols.man 13779msgid "" 13780"When generating those files, it uses as input some symbols files provided by " 13781"the maintainer. It looks for the following files (and uses the first that is " 13782"found):" 13783msgstr "" 13784 13785#. type: Plain text 13786#: dpkg-gensymbols.man 13787msgid "debian/I<package>.symbols.I<arch>" 13788msgstr "" 13789 13790#. type: Plain text 13791#: dpkg-gensymbols.man 13792msgid "debian/symbols.I<arch>" 13793msgstr "" 13794 13795#. type: Plain text 13796#: dpkg-gensymbols.man 13797msgid "debian/I<package>.symbols" 13798msgstr "" 13799 13800#. type: Plain text 13801#: dpkg-gensymbols.man 13802msgid "debian/symbols" 13803msgstr "" 13804 13805#. type: Plain text 13806#: dpkg-gensymbols.man 13807msgid "" 13808"The main interest of those files is to provide the minimal version " 13809"associated to each symbol provided by the libraries. Usually it corresponds " 13810"to the first version of that package that provided the symbol, but it can be " 13811"manually incremented by the maintainer if the ABI of the symbol is extended " 13812"without breaking backwards compatibility. It's the responsibility of the " 13813"maintainer to keep those files up-to-date and accurate, but B<dpkg-" 13814"gensymbols> helps with that." 13815msgstr "" 13816 13817#. type: Plain text 13818#: dpkg-gensymbols.man 13819msgid "" 13820"When the generated symbols files differ from the maintainer supplied one, " 13821"B<dpkg-gensymbols> will print a diff between the two versions. Furthermore " 13822"if the difference is too significant, it will even fail (you can customize " 13823"how much difference you can tolerate, see the B<-c> option)." 13824msgstr "" 13825 13826#. type: SH 13827#: dpkg-gensymbols.man 13828#, no-wrap 13829msgid "MAINTAINING SYMBOLS FILES" 13830msgstr "" 13831 13832#. type: Plain text 13833#: dpkg-gensymbols.man 13834msgid "" 13835"The symbols files are really useful only if they reflect the evolution of " 13836"the package through several releases. Thus the maintainer has to update them " 13837"every time that a new symbol is added so that its associated minimal version " 13838"matches reality. The diffs contained in the build logs can be used as a " 13839"starting point, but the maintainer, additionally, has to make sure that the " 13840"behaviour of those symbols has not changed in a way that would make anything " 13841"using those symbols and linking against the new version, stop working with " 13842"the old version. In most cases, the diff applies directly to the debian/" 13843"I<package>.symbols file. That said, further tweaks are usually needed: it's " 13844"recommended for example to drop the Debian revision from the minimal version " 13845"so that backports with a lower version number but the same upstream version " 13846"still satisfy the generated dependencies. If the Debian revision can't be " 13847"dropped because the symbol really got added by the Debian specific change, " 13848"then one should suffix the version with ‘B<~>’." 13849msgstr "" 13850 13851#. type: Plain text 13852#: dpkg-gensymbols.man 13853msgid "" 13854"Before applying any patch to the symbols file, the maintainer should double-" 13855"check that it's sane. Public symbols are not supposed to disappear, so the " 13856"patch should ideally only add new lines." 13857msgstr "" 13858 13859#. type: Plain text 13860#: dpkg-gensymbols.man 13861msgid "" 13862"Note that you can put comments in symbols files: any line with ‘#’ as the " 13863"first character is a comment except if it starts with ‘#include’ (see " 13864"section B<Using includes>). Lines starting with ‘#MISSING:’ are special " 13865"comments documenting symbols that have disappeared." 13866msgstr "" 13867 13868#. type: Plain text 13869#: dpkg-gensymbols.man 13870msgid "" 13871"Do not forget to check if old symbol versions need to be increased. There " 13872"is no way B<dpkg-gensymbols> can warn about this. Blindly applying the diff " 13873"or assuming there is nothing to change if there is no diff, without checking " 13874"for such changes, can lead to packages with loose dependencies that claim " 13875"they can work with older packages they cannot work with. This will introduce " 13876"hard to find bugs with (partial) upgrades." 13877msgstr "" 13878 13879#. type: SS 13880#: dpkg-gensymbols.man 13881#, no-wrap 13882msgid "Using #PACKAGE# substitution" 13883msgstr "" 13884 13885#. type: Plain text 13886#: dpkg-gensymbols.man 13887msgid "" 13888"In some rare cases, the name of the library varies between architectures. " 13889"To avoid hardcoding the name of the package in the symbols file, you can use " 13890"the marker I<#PACKAGE#>. It will be replaced by the real package name during " 13891"installation of the symbols files. Contrary to the I<#MINVER#> marker, " 13892"I<#PACKAGE#> will never appear in a symbols file inside a binary package." 13893msgstr "" 13894 13895#. type: SS 13896#: dpkg-gensymbols.man 13897#, no-wrap 13898msgid "Using symbol tags" 13899msgstr "" 13900 13901#. type: Plain text 13902#: dpkg-gensymbols.man 13903msgid "" 13904"Symbol tagging is useful for marking symbols that are special in some way. " 13905"Any symbol can have an arbitrary number of tags associated with it. While " 13906"all tags are parsed and stored, only some of them are understood by B<dpkg-" 13907"gensymbols> and trigger special handling of the symbols. See subsection " 13908"B<Standard symbol tags> for reference of these tags." 13909msgstr "" 13910 13911#. type: Plain text 13912#: dpkg-gensymbols.man 13913msgid "" 13914"Tag specification comes right before the symbol name (no whitespace is " 13915"allowed in between). It always starts with an opening bracket B<(>, ends " 13916"with a closing bracket B<)> and must contain at least one tag. Multiple tags " 13917"are separated by the B<|> character. Each tag can optionally have a value " 13918"which is separated form the tag name by the B<=> character. Tag names and " 13919"values can be arbitrary strings except they cannot contain any of the " 13920"special B<)> B<|> B<=> characters. Symbol names following a tag " 13921"specification can optionally be quoted with either B<'> or B<\"> characters " 13922"to allow whitespaces in them. However, if there are no tags specified for " 13923"the symbol, quotes are treated as part of the symbol name which continues up " 13924"until the first space." 13925msgstr "" 13926 13927#. type: Plain text 13928#: dpkg-gensymbols.man 13929#, no-wrap 13930msgid "" 13931" (tag1=i am marked|tag name with space)\"tagged quoted symbol\"@Base 1.0\n" 13932" (optional)tagged_unquoted_symbol@Base 1.0 1\n" 13933" untagged_symbol@Base 1.0\n" 13934msgstr "" 13935 13936#. type: Plain text 13937#: dpkg-gensymbols.man 13938msgid "" 13939"The first symbol in the example is named I<tagged quoted symbol> and has two " 13940"tags: I<tag1> with value I<i am marked> and I<tag name with space> that has " 13941"no value. The second symbol named I<tagged_unquoted_symbol> is only tagged " 13942"with the tag named I<optional>. The last symbol is an example of the normal " 13943"untagged symbol." 13944msgstr "" 13945 13946#. type: Plain text 13947#: dpkg-gensymbols.man 13948msgid "" 13949"Since symbol tags are an extension of the B<deb-symbols>(5) format, they can " 13950"only be part of the symbols files used in source packages (those files " 13951"should then be seen as templates used to build the symbols files that are " 13952"embedded in binary packages). When B<dpkg-gensymbols> is called without the " 13953"B<-t> option, it will output symbols files compatible to the B<deb-" 13954"symbols>(5) format: it fully processes symbols according to the requirements " 13955"of their standard tags and strips all tags from the output. On the contrary, " 13956"in template mode (B<-t>) all symbols and their tags (both standard and " 13957"unknown ones) are kept in the output and are written in their original form " 13958"as they were loaded." 13959msgstr "" 13960 13961#. type: SS 13962#: dpkg-gensymbols.man 13963#, no-wrap 13964msgid "Standard symbol tags" 13965msgstr "" 13966 13967#. type: TP 13968#: dpkg-gensymbols.man 13969#, no-wrap 13970msgid "B<optional>" 13971msgstr "" 13972 13973#. type: Plain text 13974#: dpkg-gensymbols.man 13975msgid "" 13976"A symbol marked as optional can disappear from the library at any time and " 13977"that will never cause B<dpkg-gensymbols> to fail. However, disappeared " 13978"optional symbols will continuously appear as MISSING in the diff in each new " 13979"package revision. This behaviour serves as a reminder for the maintainer " 13980"that such a symbol needs to be removed from the symbol file or readded to " 13981"the library. When the optional symbol, which was previously declared as " 13982"MISSING, suddenly reappears in the next revision, it will be upgraded back " 13983"to the “existing” status with its minimum version unchanged." 13984msgstr "" 13985 13986#. type: Plain text 13987#: dpkg-gensymbols.man 13988msgid "" 13989"This tag is useful for symbols which are private where their disappearance " 13990"do not cause ABI breakage. For example, most of C++ template instantiations " 13991"fall into this category. Like any other tag, this one may also have an " 13992"arbitrary value: it could be used to indicate why the symbol is considered " 13993"optional." 13994msgstr "" 13995 13996#. type: TP 13997#: dpkg-gensymbols.man 13998#, fuzzy, no-wrap 13999#| msgid "B<--add-architecture >I<architecture>" 14000msgid "B<arch=>I<architecture-list>" 14001msgstr "B<--add-architecture >I<architectur>" 14002 14003#. type: TQ 14004#: dpkg-gensymbols.man 14005#, fuzzy, no-wrap 14006#| msgid "B<--add-architecture >I<architecture>" 14007msgid "B<arch-bits=>I<architecture-bits>" 14008msgstr "B<--add-architecture >I<architectur>" 14009 14010#. type: TQ 14011#: dpkg-gensymbols.man 14012#, no-wrap 14013msgid "B<arch-endian=>I<architecture-endianness>" 14014msgstr "" 14015 14016#. type: Plain text 14017#: dpkg-gensymbols.man 14018msgid "" 14019"These tags allow one to restrict the set of architectures where the symbol " 14020"is supposed to exist. The B<arch-bits> and B<arch-endian> tags are supported " 14021"since dpkg 1.18.0. When the symbols list is updated with the symbols " 14022"discovered in the library, all arch-specific symbols which do not concern " 14023"the current host architecture are treated as if they did not exist. If an " 14024"arch-specific symbol matching the current host architecture does not exist " 14025"in the library, normal procedures for missing symbols apply and it may cause " 14026"B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol " 14027"is found when it was not supposed to exist (because the current host " 14028"architecture is not listed in the tag or does not match the endianness and " 14029"bits), it is made arch neutral (i.e. the arch, arch-bits and arch-endian " 14030"tags are dropped and the symbol will appear in the diff due to this change), " 14031"but it is not considered as new." 14032msgstr "" 14033 14034#. type: Plain text 14035#: dpkg-gensymbols.man 14036msgid "" 14037"When operating in the default non-template mode, among arch-specific symbols " 14038"only those that match the current host architecture are written to the " 14039"symbols file. On the contrary, all arch-specific symbols (including those " 14040"from foreign arches) are always written to the symbol file when operating in " 14041"template mode." 14042msgstr "" 14043 14044#. type: Plain text 14045#: dpkg-gensymbols.man 14046msgid "" 14047"The format of I<architecture-list> is the same as the one used in the " 14048"B<Build-Depends> field of I<debian/control> (except the enclosing square " 14049"brackets []). For example, the first symbol from the list below will be " 14050"considered only on alpha, any-amd64 and ia64 architectures, the second only " 14051"on linux architectures, while the third one anywhere except on armel." 14052msgstr "" 14053 14054#. type: Plain text 14055#: dpkg-gensymbols.man 14056#, no-wrap 14057msgid "" 14058" (arch=alpha any-amd64 ia64)64bit_specific_symbol@Base 1.0\n" 14059" (arch=linux-any)linux_specific_symbol@Base 1.0\n" 14060" (arch=!armel)symbol_armel_does_not_have@Base 1.0\n" 14061msgstr "" 14062 14063#. type: Plain text 14064#: dpkg-gensymbols.man 14065msgid "The I<architecture-bits> is either B<32> or B<64>." 14066msgstr "" 14067 14068#. type: Plain text 14069#: dpkg-gensymbols.man 14070#, no-wrap 14071msgid "" 14072" (arch-bits=32)32bit_specific_symbol@Base 1.0\n" 14073" (arch-bits=64)64bit_specific_symbol@Base 1.0\n" 14074msgstr "" 14075 14076#. type: Plain text 14077#: dpkg-gensymbols.man 14078msgid "The I<architecture-endianness> is either B<little> or B<big>." 14079msgstr "" 14080 14081#. type: Plain text 14082#: dpkg-gensymbols.man 14083#, no-wrap 14084msgid "" 14085" (arch-endian=little)little_endian_specific_symbol@Base 1.0\n" 14086" (arch-endian=big)big_endian_specific_symbol@Base 1.0\n" 14087msgstr "" 14088 14089#. type: Plain text 14090#: dpkg-gensymbols.man 14091msgid "Multiple restrictions can be chained." 14092msgstr "" 14093 14094#. type: Plain text 14095#: dpkg-gensymbols.man 14096#, no-wrap 14097msgid " (arch-bits=32|arch-endian=little)32bit_le_symbol@Base 1.0\n" 14098msgstr "" 14099 14100#. type: TP 14101#: dpkg-gensymbols.man 14102#, no-wrap 14103msgid "B<ignore-blacklist>" 14104msgstr "" 14105 14106#. type: Plain text 14107#: dpkg-gensymbols.man 14108msgid "" 14109"dpkg-gensymbols has an internal blacklist of symbols that should not appear " 14110"in symbols files as they are usually only side-effects of implementation " 14111"details of the toolchain. If for some reason, you really want one of those " 14112"symbols to be included in the symbols file, you should tag the symbol with " 14113"B<ignore-blacklist>. It can be necessary for some low level toolchain " 14114"libraries like libgcc." 14115msgstr "" 14116 14117#. type: TP 14118#: dpkg-gensymbols.man 14119#, no-wrap 14120msgid "B<c++>" 14121msgstr "" 14122 14123#. type: Plain text 14124#: dpkg-gensymbols.man 14125msgid "" 14126"Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection below." 14127msgstr "" 14128 14129#. type: TP 14130#: dpkg-gensymbols.man 14131#, no-wrap 14132msgid "B<symver>" 14133msgstr "" 14134 14135#. type: Plain text 14136#: dpkg-gensymbols.man 14137msgid "" 14138"Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol " 14139"patterns> subsection below." 14140msgstr "" 14141 14142#. type: TP 14143#: dpkg-gensymbols.man 14144#, no-wrap 14145msgid "B<regex>" 14146msgstr "" 14147 14148#. type: Plain text 14149#: dpkg-gensymbols.man 14150msgid "" 14151"Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection " 14152"below." 14153msgstr "" 14154 14155#. type: SS 14156#: dpkg-gensymbols.man 14157#, no-wrap 14158msgid "Using symbol patterns" 14159msgstr "" 14160 14161#. type: Plain text 14162#: dpkg-gensymbols.man 14163msgid "" 14164"Unlike a standard symbol specification, a pattern may cover multiple real " 14165"symbols from the library. B<dpkg-gensymbols> will attempt to match each " 14166"pattern against each real symbol that does I<not> have a specific symbol " 14167"counterpart defined in the symbol file. Whenever the first matching pattern " 14168"is found, all its tags and properties will be used as a basis specification " 14169"of the symbol. If none of the patterns matches, the symbol will be " 14170"considered as new." 14171msgstr "" 14172 14173#. type: Plain text 14174#: dpkg-gensymbols.man 14175msgid "" 14176"A pattern is considered lost if it does not match any symbol in the library. " 14177"By default this will trigger a B<dpkg-gensymbols> failure under B<-c1> or " 14178"higher level. However, if the failure is undesired, the pattern may be " 14179"marked with the I<optional> tag. Then if the pattern does not match " 14180"anything, it will only appear in the diff as MISSING. Moreover, like any " 14181"symbol, the pattern may be limited to the specific architectures with the " 14182"I<arch> tag. Please refer to B<Standard symbol tags> subsection above for " 14183"more information." 14184msgstr "" 14185 14186#. type: Plain text 14187#: dpkg-gensymbols.man 14188msgid "" 14189"Patterns are an extension of the B<deb-symbols>(5) format hence they are " 14190"only valid in symbol file templates. Pattern specification syntax is not any " 14191"different from the one of a specific symbol. However, symbol name part of " 14192"the specification serves as an expression to be matched against " 14193"I<name@version> of the real symbol. In order to distinguish among different " 14194"pattern types, a pattern will typically be tagged with a special tag." 14195msgstr "" 14196 14197#. type: Plain text 14198#: dpkg-gensymbols.man 14199msgid "At the moment, B<dpkg-gensymbols> supports three basic pattern types:" 14200msgstr "" 14201 14202#. type: Plain text 14203#: dpkg-gensymbols.man 14204msgid "" 14205"This pattern is denoted by the I<c++> tag. It matches only C++ symbols by " 14206"their demangled symbol name (as emitted by B<c++filt>(1) utility). This " 14207"pattern is very handy for matching symbols which mangled names might vary " 14208"across different architectures while their demangled names remain the same. " 14209"One group of such symbols is I<non-virtual thunks> which have architecture " 14210"specific offsets embedded in their mangled names. A common instance of this " 14211"case is a virtual destructor which under diamond inheritance needs a non-" 14212"virtual thunk symbol. For example, even if _ZThn8_N3NSB6ClassDD1Ev@Base on " 14213"32bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64bit " 14214"ones, it can be matched with a single I<c++> pattern:" 14215msgstr "" 14216 14217#. type: Plain text 14218#: dpkg-gensymbols.man 14219#, no-wrap 14220msgid "" 14221"libdummy.so.1 libdummy1 #MINVER#\n" 14222" [...]\n" 14223" (c++)\"non-virtual thunk to NSB::ClassD::~ClassD()@Base\" 1.0\n" 14224" [...]\n" 14225msgstr "" 14226 14227#. type: Plain text 14228#: dpkg-gensymbols.man 14229msgid "" 14230"The demangled name above can be obtained by executing the following command:" 14231msgstr "" 14232 14233#. type: Plain text 14234#: dpkg-gensymbols.man 14235#, no-wrap 14236msgid " $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt\n" 14237msgstr "" 14238 14239#. type: Plain text 14240#: dpkg-gensymbols.man 14241msgid "" 14242"Please note that while mangled name is unique in the library by definition, " 14243"this is not necessarily true for demangled names. A couple of distinct real " 14244"symbols may have the same demangled name. For example, that's the case with " 14245"non-virtual thunk symbols in complex inheritance configurations or with most " 14246"constructors and destructors (since g++ typically generates two real symbols " 14247"for them). However, as these collisions happen on the ABI level, they should " 14248"not degrade quality of the symbol file." 14249msgstr "" 14250 14251#. type: Plain text 14252#: dpkg-gensymbols.man 14253msgid "" 14254"This pattern is denoted by the I<symver> tag. Well maintained libraries have " 14255"versioned symbols where each version corresponds to the upstream version " 14256"where the symbol got added. If that's the case, you can use a I<symver> " 14257"pattern to match any symbol associated to the specific version. For example:" 14258msgstr "" 14259 14260#. type: Plain text 14261#: dpkg-gensymbols.man 14262#, no-wrap 14263msgid "" 14264"libc.so.6 libc6 #MINVER#\n" 14265" (symver)GLIBC_2.0 2.0\n" 14266" [...]\n" 14267" (symver)GLIBC_2.7 2.7\n" 14268" access@GLIBC_2.0 2.2\n" 14269msgstr "" 14270 14271#. type: Plain text 14272#: dpkg-gensymbols.man 14273msgid "" 14274"All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to " 14275"minimal version of 2.0 and 2.7 respectively with the exception of the symbol " 14276"access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 " 14277"version 2.2 despite being in the scope of the \"(symver)GLIBC_2.0\" pattern " 14278"because specific symbols take precedence over patterns." 14279msgstr "" 14280 14281#. type: Plain text 14282#: dpkg-gensymbols.man 14283msgid "" 14284"Please note that while old style wildcard patterns (denoted by \"*@version\" " 14285"in the symbol name field) are still supported, they have been deprecated by " 14286"new style syntax \"(symver|optional)version\". For example, \"*@GLIBC_2.0 " 14287"2.0\" should be written as \"(symver|optional)GLIBC_2.0 2.0\" if the same " 14288"behaviour is needed." 14289msgstr "" 14290 14291#. type: Plain text 14292#: dpkg-gensymbols.man 14293msgid "" 14294"Regular expression patterns are denoted by the I<regex> tag. They match by " 14295"the perl regular expression specified in the symbol name field. A regular " 14296"expression is matched as it is, therefore do not forget to start it with the " 14297"I<^> character or it may match any part of the real symbol I<name@version> " 14298"string. For example:" 14299msgstr "" 14300 14301#. type: Plain text 14302#: dpkg-gensymbols.man 14303#, no-wrap 14304msgid "" 14305"libdummy.so.1 libdummy1 #MINVER#\n" 14306" (regex)\"^mystack_.*@Base$\" 1.0\n" 14307" (regex|optional)\"private\" 1.0\n" 14308msgstr "" 14309 14310#. type: Plain text 14311#: dpkg-gensymbols.man 14312msgid "" 14313"Symbols like \"mystack_new@Base\", \"mystack_push@Base\", \"mystack_pop@Base" 14314"\" etc. will be matched by the first pattern while e.g. " 14315"\"ng_mystack_new@Base\" won't. The second pattern will match all symbols " 14316"having the string \"private\" in their names and matches will inherit " 14317"I<optional> tag from the pattern." 14318msgstr "" 14319 14320#. type: Plain text 14321#: dpkg-gensymbols.man 14322msgid "" 14323"Basic patterns listed above can be combined where it makes sense. In that " 14324"case, they are processed in the order in which the tags are specified. For " 14325"example, both" 14326msgstr "" 14327 14328#. type: Plain text 14329#: dpkg-gensymbols.man 14330#, no-wrap 14331msgid "" 14332" (c++|regex)\"^NSA::ClassA::Private::privmethod\\ed\\e(int\\e)@Base\" 1.0\n" 14333" (regex|c++)N3NSA6ClassA7Private11privmethod\\edEi@Base 1.0\n" 14334msgstr "" 14335 14336#. type: Plain text 14337#: dpkg-gensymbols.man 14338msgid "" 14339"will match symbols \"_ZN3NSA6ClassA7Private11privmethod1Ei@Base\" and " 14340"\"_ZN3NSA6ClassA7Private11privmethod2Ei@Base\". When matching the first " 14341"pattern, the raw symbol is first demangled as C++ symbol, then the demangled " 14342"name is matched against the regular expression. On the other hand, when " 14343"matching the second pattern, regular expression is matched against the raw " 14344"symbol name, then the symbol is tested if it is C++ one by attempting to " 14345"demangle it. A failure of any basic pattern will result in the failure of " 14346"the whole pattern. Therefore, for example, " 14347"\"__N3NSA6ClassA7Private11privmethod\\edEi@Base\" will not match either of " 14348"the patterns because it is not a valid C++ symbol." 14349msgstr "" 14350 14351#. type: Plain text 14352#: dpkg-gensymbols.man 14353msgid "" 14354"In general, all patterns are divided into two groups: aliases (basic I<c++> " 14355"and I<symver>) and generic patterns (I<regex>, all combinations of multiple " 14356"basic patterns). Matching of basic alias-based patterns is fast (O(1)) " 14357"while generic patterns are O(N) (N - generic pattern count) for each " 14358"symbol. Therefore, it is recommended not to overuse generic patterns." 14359msgstr "" 14360 14361#. type: Plain text 14362#: dpkg-gensymbols.man 14363msgid "" 14364"When multiple patterns match the same real symbol, aliases (first I<c++>, " 14365"then I<symver>) are preferred over generic patterns. Generic patterns are " 14366"matched in the order they are found in the symbol file template until the " 14367"first success. Please note, however, that manual reordering of template " 14368"file entries is not recommended because B<dpkg-gensymbols> generates diffs " 14369"based on the alphanumerical order of their names." 14370msgstr "" 14371 14372#. type: SS 14373#: dpkg-gensymbols.man 14374#, no-wrap 14375msgid "Using includes" 14376msgstr "" 14377 14378#. type: Plain text 14379#: dpkg-gensymbols.man 14380msgid "" 14381"When the set of exported symbols differ between architectures, it may become " 14382"inefficient to use a single symbol file. In those cases, an include " 14383"directive may prove to be useful in a couple of ways:" 14384msgstr "" 14385 14386#. type: Plain text 14387#: dpkg-gensymbols.man 14388msgid "" 14389"You can factorize the common part in some external file and include that " 14390"file in your I<package>.symbols.I<arch> file by using an include directive " 14391"like this:" 14392msgstr "" 14393 14394#. type: Plain text 14395#: dpkg-gensymbols.man 14396msgid "#include \"I<packages>.symbols.common\"" 14397msgstr "" 14398 14399#. type: Plain text 14400#: dpkg-gensymbols.man 14401msgid "The include directive may also be tagged like any symbol:" 14402msgstr "" 14403 14404#. type: Plain text 14405#: dpkg-gensymbols.man 14406msgid "(tag|...|tagN)#include \"file-to-include\"" 14407msgstr "" 14408 14409#. type: Plain text 14410#: dpkg-gensymbols.man 14411msgid "" 14412"As a result, all symbols included from I<file-to-include> will be considered " 14413"to be tagged with I<tag> ... I<tagN> by default. You can use this feature to " 14414"create a common I<package>.symbols file which includes architecture specific " 14415"symbol files:" 14416msgstr "" 14417 14418#. type: Plain text 14419#: dpkg-gensymbols.man 14420#, no-wrap 14421msgid "" 14422" common_symbol1@Base 1.0\n" 14423" (arch=amd64 ia64 alpha)#include \"package.symbols.64bit\"\n" 14424" (arch=!amd64 !ia64 !alpha)#include \"package.symbols.32bit\"\n" 14425" common_symbol2@Base 1.0\n" 14426msgstr "" 14427 14428#. type: Plain text 14429#: dpkg-gensymbols.man 14430msgid "" 14431"The symbols files are read line by line, and include directives are " 14432"processed as soon as they are encountered. This means that the content of " 14433"the included file can override any content that appeared before the include " 14434"directive and that any content after the directive can override anything " 14435"contained in the included file. Any symbol (or even another #include " 14436"directive) in the included file can specify additional tags or override " 14437"values of the inherited tags in its tag specification. However, there is no " 14438"way for the symbol to remove any of the inherited tags." 14439msgstr "" 14440 14441#. type: Plain text 14442#: dpkg-gensymbols.man 14443msgid "" 14444"An included file can repeat the header line containing the SONAME of the " 14445"library. In that case, it overrides any header line previously read. " 14446"However, in general it's best to avoid duplicating header lines. One way to " 14447"do it is the following:" 14448msgstr "" 14449 14450#. type: Plain text 14451#: dpkg-gensymbols.man 14452#, no-wrap 14453msgid "" 14454"#include \"libsomething1.symbols.common\"\n" 14455" arch_specific_symbol@Base 1.0\n" 14456msgstr "" 14457 14458#. type: SS 14459#: dpkg-gensymbols.man 14460#, no-wrap 14461msgid "Good library management" 14462msgstr "" 14463 14464#. type: Plain text 14465#: dpkg-gensymbols.man 14466msgid "A well-maintained library has the following features:" 14467msgstr "" 14468 14469#. type: Plain text 14470#: dpkg-gensymbols.man 14471msgid "" 14472"its API is stable (public symbols are never dropped, only new public symbols " 14473"are added) and changes in incompatible ways only when the SONAME changes;" 14474msgstr "" 14475 14476#. type: Plain text 14477#: dpkg-gensymbols.man 14478msgid "" 14479"ideally, it uses symbol versioning to achieve ABI stability despite internal " 14480"changes and API extension;" 14481msgstr "" 14482 14483#. type: Plain text 14484#: dpkg-gensymbols.man 14485msgid "" 14486"it doesn't export private symbols (such symbols can be tagged optional as " 14487"workaround)." 14488msgstr "" 14489 14490#. type: Plain text 14491#: dpkg-gensymbols.man 14492msgid "" 14493"While maintaining the symbols file, it's easy to notice appearance and " 14494"disappearance of symbols. But it's more difficult to catch incompatible API " 14495"and ABI change. Thus the maintainer should read thoroughly the upstream " 14496"changelog looking for cases where the rules of good library management have " 14497"been broken. If potential problems are discovered, the upstream author " 14498"should be notified as an upstream fix is always better than a Debian " 14499"specific work-around." 14500msgstr "" 14501 14502#. type: Plain text 14503#: dpkg-gensymbols.man 14504msgid "Scan I<package-build-dir> instead of debian/tmp." 14505msgstr "" 14506 14507#. type: Plain text 14508#: dpkg-gensymbols.man 14509msgid "" 14510"Define the package name. Required if more than one binary package is listed " 14511"in debian/control (or if there's no debian/control file)." 14512msgstr "" 14513 14514#. type: Plain text 14515#: dpkg-gensymbols.man 14516msgid "" 14517"Define the package version. Defaults to the version extracted from debian/" 14518"changelog. Required if called outside of a source package tree." 14519msgstr "" 14520 14521#. type: TP 14522#: dpkg-gensymbols.man 14523#, no-wrap 14524msgid "B<-e>I<library-file>" 14525msgstr "" 14526 14527#. type: Plain text 14528#: dpkg-gensymbols.man 14529msgid "" 14530"Only analyze libraries explicitly listed instead of finding all public " 14531"libraries. You can use shell patterns used for pathname expansions (see the " 14532"B<File::Glob>(3perl) manual page for details) in I<library-file> to match " 14533"multiple libraries with a single argument (otherwise you need multiple B<-" 14534"e>)." 14535msgstr "" 14536 14537#. type: TP 14538#: dpkg-gensymbols.man dpkg-shlibdeps.man 14539#, no-wrap 14540msgid "B<-l>I<directory>" 14541msgstr "" 14542 14543#. type: Plain text 14544#: dpkg-gensymbols.man 14545msgid "" 14546"Prepend I<directory> to the list of directories to search for private shared " 14547"libraries (since dpkg 1.19.1). This option can be used multiple times." 14548msgstr "" 14549 14550#. type: Plain text 14551#: dpkg-gensymbols.man dpkg-shlibdeps.man 14552msgid "" 14553"Note: Use this option instead of setting B<LD_LIBRARY_PATH>, as that " 14554"environment variable is used to control the run-time linker and abusing it " 14555"to set the shared library paths at build-time can be problematic when cross-" 14556"compiling for example." 14557msgstr "" 14558 14559#. type: TP 14560#: dpkg-gensymbols.man 14561#, no-wrap 14562msgid "B<-I>I<filename>" 14563msgstr "" 14564 14565#. type: Plain text 14566#: dpkg-gensymbols.man 14567msgid "" 14568"Use I<filename> as reference file to generate the symbols file that is " 14569"integrated in the package itself." 14570msgstr "" 14571 14572#. type: Plain text 14573#: dpkg-gensymbols.man 14574msgid "" 14575"Print the generated symbols file to standard output or to I<filename> if " 14576"specified, rather than to B<debian/tmp/DEBIAN/symbols> (or I<package-build-" 14577"dir>B</DEBIAN/symbols> if B<-P> was used). If I<filename> is pre-existing, " 14578"its contents are used as basis for the generated symbols file. You can use " 14579"this feature to update a symbols file so that it matches a newer upstream " 14580"version of your library." 14581msgstr "" 14582 14583#. type: TP 14584#: dpkg-gensymbols.man 14585#, no-wrap 14586msgid "B<-t>" 14587msgstr "" 14588 14589#. type: Plain text 14590#: dpkg-gensymbols.man 14591msgid "" 14592"Write the symbol file in template mode rather than the format compatible " 14593"with B<deb-symbols>(5). The main difference is that in the template mode " 14594"symbol names and tags are written in their original form contrary to the " 14595"post-processed symbol names with tags stripped in the compatibility mode. " 14596"Moreover, some symbols might be omitted when writing a standard B<deb-" 14597"symbols>(5) file (according to the tag processing rules) while all symbols " 14598"are always written to the symbol file template." 14599msgstr "" 14600 14601#. type: TP 14602#: dpkg-gensymbols.man 14603#, no-wrap 14604msgid "B<-c>I<[0-4]>" 14605msgstr "" 14606 14607#. type: Plain text 14608#: dpkg-gensymbols.man 14609msgid "" 14610"Define the checks to do when comparing the generated symbols file with the " 14611"template file used as starting point. By default the level is 1. Increasing " 14612"levels do more checks and include all checks of lower levels. Level 0 never " 14613"fails. Level 1 fails if some symbols have disappeared. Level 2 fails if some " 14614"new symbols have been introduced. Level 3 fails if some libraries have " 14615"disappeared. Level 4 fails if some libraries have been introduced." 14616msgstr "" 14617 14618#. type: Plain text 14619#: dpkg-gensymbols.man 14620msgid "" 14621"This value can be overridden by the environment variable " 14622"B<DPKG_GENSYMBOLS_CHECK_LEVEL>." 14623msgstr "" 14624 14625#. type: Plain text 14626#: dpkg-gensymbols.man 14627msgid "" 14628"Keep quiet and never generate a diff between generated symbols file and the " 14629"template file used as starting point or show any warnings about new/lost " 14630"libraries or new/lost symbols. This option only disables informational " 14631"output but not the checks themselves (see B<-c> option)." 14632msgstr "" 14633 14634#. type: TP 14635#: dpkg-gensymbols.man 14636#, no-wrap 14637msgid "B<-a>I<arch>" 14638msgstr "" 14639 14640#. type: Plain text 14641#: dpkg-gensymbols.man 14642msgid "" 14643"Assume I<arch> as host architecture when processing symbol files. Use this " 14644"option to generate a symbol file or diff for any architecture provided its " 14645"binaries are already available." 14646msgstr "" 14647 14648#. type: TP 14649#: dpkg-gensymbols.man 14650#, no-wrap 14651msgid "B<-d>" 14652msgstr "" 14653 14654#. type: Plain text 14655#: dpkg-gensymbols.man 14656msgid "" 14657"Enable debug mode. Numerous messages are displayed to explain what B<dpkg-" 14658"gensymbols> does." 14659msgstr "" 14660 14661#. type: TP 14662#: dpkg-gensymbols.man 14663#, no-wrap 14664msgid "B<-V>" 14665msgstr "" 14666 14667#. type: Plain text 14668#: dpkg-gensymbols.man 14669msgid "" 14670"Enable verbose mode. The generated symbols file contains deprecated symbols " 14671"as comments. Furthermore in template mode, pattern symbols are followed by " 14672"comments listing real symbols that have matched the pattern." 14673msgstr "" 14674 14675#. type: TP 14676#: dpkg-gensymbols.man 14677#, no-wrap 14678msgid "B<DPKG_GENSYMBOLS_CHECK_LEVEL>" 14679msgstr "" 14680 14681#. type: Plain text 14682#: dpkg-gensymbols.man 14683msgid "" 14684"Overrides the command check level, even if the B<-c> command-line argument " 14685"was given (note that this goes against the common convention of command-line " 14686"arguments having precedence over environment variables)." 14687msgstr "" 14688 14689#. type: Plain text 14690#: dpkg-gensymbols.man 14691msgid "B<https://people.redhat.com/drepper/symbol-versioning>" 14692msgstr "" 14693 14694#. type: Plain text 14695#: dpkg-gensymbols.man 14696msgid "B<https://people.redhat.com/drepper/goodpractice.pdf>" 14697msgstr "" 14698 14699#. type: Plain text 14700#: dpkg-gensymbols.man 14701msgid "B<https://people.redhat.com/drepper/dsohowto.pdf>" 14702msgstr "" 14703 14704#. type: Plain text 14705#: dpkg-gensymbols.man 14706msgid "B<deb-symbols>(5), B<dpkg-shlibdeps>(1)." 14707msgstr "" 14708 14709#. type: TH 14710#: dpkg-maintscript-helper.man 14711#, no-wrap 14712msgid "dpkg-maintscript-helper" 14713msgstr "" 14714 14715#. type: Plain text 14716#: dpkg-maintscript-helper.man 14717msgid "" 14718"dpkg-maintscript-helper - works around known dpkg limitations in maintainer " 14719"scripts" 14720msgstr "" 14721 14722#. type: Plain text 14723#: dpkg-maintscript-helper.man 14724msgid "" 14725"B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> I<maint-script-" 14726"parameter>..." 14727msgstr "" 14728 14729#. type: SH 14730#: dpkg-maintscript-helper.man 14731#, no-wrap 14732msgid "COMMANDS AND PARAMETERS" 14733msgstr "" 14734 14735#. type: Plain text 14736#: dpkg-maintscript-helper.man 14737msgid "B<supports> I<command>" 14738msgstr "" 14739 14740#. type: Plain text 14741#: dpkg-maintscript-helper.man 14742msgid "B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]" 14743msgstr "" 14744 14745#. type: Plain text 14746#: dpkg-maintscript-helper.man 14747msgid "" 14748"B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> " 14749"[I<package>]]" 14750msgstr "" 14751 14752#. type: Plain text 14753#: dpkg-maintscript-helper.man 14754msgid "" 14755"B<symlink_to_dir> I<pathname> I<old-target> [I<prior-version> [I<package>]]" 14756msgstr "" 14757 14758#. type: Plain text 14759#: dpkg-maintscript-helper.man 14760msgid "" 14761"B<dir_to_symlink> I<pathname> I<new-target> [I<prior-version> [I<package>]]" 14762msgstr "" 14763 14764#. type: Plain text 14765#: dpkg-maintscript-helper.man 14766msgid "" 14767"This program is designed to be run within maintainer scripts to achieve some " 14768"tasks that B<dpkg> can't (yet) handle natively either because of design " 14769"decisions or due to current limitations." 14770msgstr "" 14771 14772#. type: Plain text 14773#: dpkg-maintscript-helper.man 14774msgid "" 14775"Many of those tasks require coordinated actions from several maintainer " 14776"scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes " 14777"the same call simply needs to be put in all scripts and the program will " 14778"automatically adapt its behaviour based on the environment variable " 14779"B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you " 14780"have to forward after a double hyphen." 14781msgstr "" 14782 14783#. type: SH 14784#: dpkg-maintscript-helper.man 14785#, no-wrap 14786msgid "COMMON PARAMETERS" 14787msgstr "" 14788 14789#. type: TP 14790#: dpkg-maintscript-helper.man 14791#, no-wrap 14792msgid "I<prior-version>" 14793msgstr "" 14794 14795#. type: Plain text 14796#: dpkg-maintscript-helper.man 14797msgid "" 14798"Defines the latest version of the package whose upgrade should trigger the " 14799"operation. It is important to calculate I<prior-version> correctly so that " 14800"the operations are correctly performed even if the user rebuilt the package " 14801"with a local version. If I<prior-version> is empty or omitted, then the " 14802"operation is tried on every upgrade (note: it's safer to give the version " 14803"and have the operation tried only once)." 14804msgstr "" 14805 14806#. type: Plain text 14807#: dpkg-maintscript-helper.man 14808msgid "" 14809"If the conffile has not been shipped for several versions, and you are now " 14810"modifying the maintainer scripts to clean up the obsolete file, I<prior-" 14811"version> should be based on the version of the package that you are now " 14812"preparing, not the first version of the package that lacked the conffile. " 14813"This applies to all other actions in the same way." 14814msgstr "" 14815 14816#. type: Plain text 14817#: dpkg-maintscript-helper.man 14818msgid "" 14819"For example, for a conffile removed in version B<2.0-1> of a package, " 14820"I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to " 14821"be removed even if the user rebuilt the previous version B<1.0-1> as " 14822"B<1.0-1local1>. Or a package switching a path from a symlink (shipped in " 14823"version B<1.0-1>) to a directory (shipped in version B<2.0-1>), but only " 14824"performing the actual switch in the maintainer scripts in version B<3.0-1>, " 14825"should set I<prior-version> to B<3.0-1~>." 14826msgstr "" 14827 14828#. type: TP 14829#: dpkg-maintscript-helper.man 14830#, no-wrap 14831msgid "I<package>" 14832msgstr "" 14833 14834#. type: Plain text 14835#: dpkg-maintscript-helper.man 14836msgid "" 14837"The package name owning the pathname(s). When the package is “Multi-Arch: " 14838"same” this parameter must include the architecture qualifier, otherwise it " 14839"should B<not> usually include the architecture qualifier (as it would " 14840"disallow cross-grades, or switching from being architecture specific to " 14841"architecture B<all> or vice versa). If the parameter is empty or omitted, " 14842"the B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment " 14843"variables (as set by B<dpkg> when running the maintainer scripts) will be " 14844"used to generate an arch-qualified package name." 14845msgstr "" 14846 14847#. type: TP 14848#: dpkg-maintscript-helper.man 14849#, no-wrap 14850msgid "B<-->" 14851msgstr "" 14852 14853#. type: Plain text 14854#: dpkg-maintscript-helper.man 14855msgid "" 14856"All the parameters of the maintainer scripts have to be forwarded to the " 14857"program after B<-->." 14858msgstr "" 14859 14860#. type: SH 14861#: dpkg-maintscript-helper.man 14862#, no-wrap 14863msgid "CONFFILE RELATED TASKS" 14864msgstr "" 14865 14866#. type: Plain text 14867#: dpkg-maintscript-helper.man 14868msgid "" 14869"When upgrading a package, B<dpkg> will not automatically remove a conffile " 14870"(a configuration file for which B<dpkg> should preserve user changes) if it " 14871"is not present in the newer version. There are two principal reasons for " 14872"this; the first is that the conffile could've been dropped by accident and " 14873"the next version could restore it, users wouldn't want their changes thrown " 14874"away. The second is to allow packages to transition files from a dpkg-" 14875"maintained conffile to a file maintained by the package's maintainer " 14876"scripts, usually with a tool like debconf or ucf." 14877msgstr "" 14878 14879#. type: Plain text 14880#: dpkg-maintscript-helper.man 14881msgid "" 14882"This means that if a package is intended to rename or remove a conffile, it " 14883"must explicitly do so and B<dpkg-maintscript-helper> can be used to " 14884"implement graceful deletion and moving of conffiles within maintainer " 14885"scripts." 14886msgstr "" 14887 14888#. type: SS 14889#: dpkg-maintscript-helper.man 14890#, no-wrap 14891msgid "Removing a conffile" 14892msgstr "" 14893 14894#. type: Plain text 14895#: dpkg-maintscript-helper.man 14896msgid "" 14897"If a conffile is completely removed, it should be removed from disk, unless " 14898"the user has modified it. If there are local modifications, they should be " 14899"preserved. If the package upgrades aborts, the newly obsolete conffile " 14900"should not disappear." 14901msgstr "" 14902 14903#. type: Plain text 14904#: dpkg-maintscript-helper.man 14905msgid "" 14906"All of this is implemented by putting the following shell snippet in the " 14907"B<preinst>, B<postinst> and B<postrm> maintainer scripts:" 14908msgstr "" 14909 14910#. type: Plain text 14911#: dpkg-maintscript-helper.man 14912#, no-wrap 14913msgid "" 14914" dpkg-maintscript-helper rm_conffile \\e\n" 14915" I<conffile> I<prior-version> I<package> -- \"$@\"\n" 14916msgstr "" 14917 14918#. type: Plain text 14919#: dpkg-maintscript-helper.man 14920msgid "I<conffile> is the filename of the conffile to remove." 14921msgstr "I<配置文件> 参数是要移除的配置文件名。" 14922 14923#. type: Plain text 14924#: dpkg-maintscript-helper.man 14925msgid "" 14926"Current implementation: in the B<preinst>, it checks if the conffile was " 14927"modified and renames it either to I<conffile>B<.dpkg-remove> (if not " 14928"modified) or to I<conffile>B<.dpkg-backup> (if modified). In the " 14929"B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept " 14930"for reference as it contains user modifications but the former will be " 14931"removed. If the package upgrade aborts, the B<postrm> reinstalls the " 14932"original conffile. During purge, the B<postrm> will also delete the B<.dpkg-" 14933"bak> file kept up to now." 14934msgstr "" 14935 14936#. type: SS 14937#: dpkg-maintscript-helper.man 14938#, no-wrap 14939msgid "Renaming a conffile" 14940msgstr "重命名配置文件" 14941 14942#. type: Plain text 14943#: dpkg-maintscript-helper.man 14944msgid "" 14945"If a conffile is moved from one location to another, you need to make sure " 14946"you move across any changes the user has made. This may seem a simple change " 14947"to the B<preinst> script at first, however that will result in the user " 14948"being prompted by B<dpkg> to approve the conffile edits even though they are " 14949"not responsible of them." 14950msgstr "" 14951 14952#. type: Plain text 14953#: dpkg-maintscript-helper.man 14954msgid "" 14955"Graceful renaming can be implemented by putting the following shell snippet " 14956"in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:" 14957msgstr "" 14958 14959#. type: Plain text 14960#: dpkg-maintscript-helper.man 14961#, no-wrap 14962msgid "" 14963" dpkg-maintscript-helper mv_conffile \\e\n" 14964" I<old-conffile> I<new-conffile> I<prior-version> I<package> -- \"$@\"\n" 14965msgstr "" 14966 14967#. type: Plain text 14968#: dpkg-maintscript-helper.man 14969msgid "" 14970"I<old-conffile> and I<new-conffile> are the old and new name of the conffile " 14971"to rename." 14972msgstr "" 14973 14974#. type: Plain text 14975#: dpkg-maintscript-helper.man 14976msgid "" 14977"Current implementation: the B<preinst> checks if the conffile has been " 14978"modified, if yes it's left on place otherwise it's renamed to I<old-" 14979"conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes I<old-" 14980"conffile>B<.dpkg-remove> and renames I<old-conffile> to I<new-conffile> if " 14981"I<old-conffile> is still available. On abort-upgrade/abort-install, the " 14982"B<postrm> renames I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if " 14983"required." 14984msgstr "" 14985 14986#. type: SH 14987#: dpkg-maintscript-helper.man 14988#, no-wrap 14989msgid "SYMLINK AND DIRECTORY SWITCHES" 14990msgstr "符号链接和目录切换" 14991 14992#. type: Plain text 14993#: dpkg-maintscript-helper.man 14994msgid "" 14995"When upgrading a package, B<dpkg> will not automatically switch a symlink to " 14996"a directory or vice-versa. Downgrades are not supported and the path will be " 14997"left as is." 14998msgstr "" 14999 15000#. type: SS 15001#: dpkg-maintscript-helper.man 15002#, no-wrap 15003msgid "Switching a symlink to directory" 15004msgstr "将符号链接切换为目录" 15005 15006#. type: Plain text 15007#: dpkg-maintscript-helper.man 15008msgid "" 15009"If a symlink is switched to a real directory, you need to make sure before " 15010"unpacking that the symlink is removed. This may seem a simple change to the " 15011"B<preinst> script at first, however that will result in some problems in " 15012"case of admin local customization of the symlink or when downgrading the " 15013"package." 15014msgstr "" 15015 15016#. type: Plain text 15017#: dpkg-maintscript-helper.man 15018#, no-wrap 15019msgid "" 15020" dpkg-maintscript-helper symlink_to_dir \\e\n" 15021" I<pathname> I<old-target> I<prior-version> I<package> -- \"$@\"\n" 15022msgstr "" 15023 15024#. type: Plain text 15025#: dpkg-maintscript-helper.man 15026msgid "" 15027"I<pathname> is the absolute name of the old symlink (the path will be a " 15028"directory at the end of the installation) and I<old-target> is the target " 15029"name of the former symlink at I<pathname>. It can either be absolute or " 15030"relative to the directory containing I<pathname>." 15031msgstr "" 15032 15033#. type: Plain text 15034#: dpkg-maintscript-helper.man 15035msgid "" 15036"Current implementation: the B<preinst> checks if the symlink exists and " 15037"points to I<old-target>, if not then it's left in place, otherwise it's " 15038"renamed to I<pathname>B<.dpkg-backup>. On configuration, the B<postinst> " 15039"removes I<pathname>B<.dpkg-backup> if I<pathname>B<.dpkg-backup> is still a " 15040"symlink. On abort-upgrade/abort-install, the B<postrm> renames I<pathname>B<." 15041"dpkg-backup> back to I<pathname> if required." 15042msgstr "" 15043 15044#. type: SS 15045#: dpkg-maintscript-helper.man 15046#, no-wrap 15047msgid "Switching a directory to symlink" 15048msgstr "将目录切换为符号链接" 15049 15050#. type: Plain text 15051#: dpkg-maintscript-helper.man 15052msgid "" 15053"If a real directory is switched to a symlink, you need to make sure before " 15054"unpacking that the directory is removed. This may seem a simple change to " 15055"the B<preinst> script at first, however that will result in some problems in " 15056"case the directory contains conffiles, pathnames owned by other packages, " 15057"locally created pathnames, or when downgrading the package." 15058msgstr "" 15059 15060#. type: Plain text 15061#: dpkg-maintscript-helper.man 15062msgid "" 15063"Graceful switching can be implemented by putting the following shell snippet " 15064"in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:" 15065msgstr "" 15066 15067#. type: Plain text 15068#: dpkg-maintscript-helper.man 15069#, no-wrap 15070msgid "" 15071" dpkg-maintscript-helper dir_to_symlink \\e\n" 15072" I<pathname> I<new-target> I<prior-version> I<package> -- \"$@\"\n" 15073msgstr "" 15074 15075#. type: Plain text 15076#: dpkg-maintscript-helper.man 15077msgid "" 15078"I<pathname> is the absolute name of the old directory (the path will be a " 15079"symlink at the end of the installation) and I<new-target> is the target of " 15080"the new symlink at I<pathname>. It can either be absolute or relative to the " 15081"directory containing I<pathname>." 15082msgstr "" 15083 15084#. type: Plain text 15085#: dpkg-maintscript-helper.man 15086msgid "" 15087"Current implementation: the B<preinst> checks if the directory exists, does " 15088"not contain conffiles, pathnames owned by other packages, or locally created " 15089"pathnames, if not then it's left in place, otherwise it's renamed to " 15090"I<pathname>B<.dpkg-backup>, and an empty staging directory named I<pathname> " 15091"is created, marked with a file so that dpkg can track it. On configuration, " 15092"the B<postinst> finishes the switch if I<pathname>B<.dpkg-backup> is still a " 15093"directory and I<pathname> is the staging directory; it removes the staging " 15094"directory mark file, moves the newly created files inside the staging " 15095"directory to the symlink target I<new-target>/, replaces the now empty " 15096"staging directory I<pathname> with a symlink to I<new-target>, and removes " 15097"I<pathname>B<.dpkg-backup>. On abort-upgrade/abort-install, the B<postrm> " 15098"renames I<pathname>B<.dpkg-backup> back to I<pathname> if required." 15099msgstr "" 15100 15101#. type: SH 15102#: dpkg-maintscript-helper.man 15103#, no-wrap 15104msgid "INTEGRATION IN PACKAGES" 15105msgstr "" 15106 15107#. type: Plain text 15108#: dpkg-maintscript-helper.man 15109msgid "" 15110"When using a packaging helper, please check if it has native B<dpkg-" 15111"maintscript-helper> integration, which might make your life easier. See for " 15112"example B<dh_installdeb>(1)." 15113msgstr "" 15114 15115#. type: Plain text 15116#: dpkg-maintscript-helper.man 15117msgid "" 15118"Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it " 15119"unconditionally requires a pre-dependency to ensure that the required " 15120"version of B<dpkg> has been unpacked before. The required version depends on " 15121"the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2, for " 15122"B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14:" 15123msgstr "" 15124 15125#. type: Plain text 15126#: dpkg-maintscript-helper.man 15127#, no-wrap 15128msgid " B<Pre-Depends:> dpkg (E<gt>= 1.17.14)\n" 15129msgstr "" 15130 15131#. type: Plain text 15132#: dpkg-maintscript-helper.man 15133msgid "" 15134"But in many cases the operation done by the program is not critical for the " 15135"package, and instead of using a pre-dependency we can call the program only " 15136"if we know that the required command is supported by the currently installed " 15137"B<dpkg>:" 15138msgstr "" 15139 15140#. type: Plain text 15141#: dpkg-maintscript-helper.man 15142#, no-wrap 15143msgid "" 15144" if dpkg-maintscript-helper supports I<command>; then\n" 15145" dpkg-maintscript-helper I<command> ...\n" 15146" fi\n" 15147msgstr "" 15148 15149#. type: Plain text 15150#: dpkg-maintscript-helper.man 15151msgid "" 15152"The command B<supports> will return 0 on success, 1 otherwise. The " 15153"B<supports> command will check if the environment variables as set by dpkg " 15154"and required by the script are present, and will consider it a failure in " 15155"case the environment is not sufficient." 15156msgstr "" 15157 15158#. type: Plain text 15159#: dpkg-maintscript-helper.man 15160msgid "" 15161"Sets the color mode (since dpkg 1.19.1). The currently accepted values are: " 15162"B<auto> (default), B<always> and B<never>." 15163msgstr "" 15164 15165#. type: Plain text 15166#: dpkg-maintscript-helper.man 15167msgid "B<dh_installdeb>(1)." 15168msgstr "" 15169 15170#. type: TH 15171#: dpkg-mergechangelogs.man 15172#, no-wrap 15173msgid "dpkg-mergechangelogs" 15174msgstr "" 15175 15176#. type: Plain text 15177#: dpkg-mergechangelogs.man 15178msgid "dpkg-mergechangelogs - 3-way merge of debian/changelog files" 15179msgstr "" 15180 15181#. type: Plain text 15182#: dpkg-mergechangelogs.man 15183msgid "" 15184"B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]" 15185msgstr "" 15186 15187#. type: Plain text 15188#: dpkg-mergechangelogs.man 15189msgid "" 15190"This program will use the 3 provided versions of the Debian changelog to " 15191"generate a merged changelog file. The resulting changelog is stored in the " 15192"file I<out> or output to the standard output if that parameter is not given." 15193msgstr "" 15194 15195#. type: Plain text 15196#: dpkg-mergechangelogs.man 15197msgid "" 15198"Each entry is identified by its version number and they are assumed to be " 15199"not conflicting, they are simply merged in the right order (by decreasing " 15200"version number). When B<--merge-prereleases> is used, the part of the " 15201"version number after the last tilde is dropped so that 1.0-1~exp1 and " 15202"1.0-1~exp5 are considered to be the same entry. When the same version is " 15203"available in both I<new-a> and I<new-b>, a standard line-based 3-way merge " 15204"is attempted (provided that the module Algorithm::Merge is available — it's " 15205"part of the package libalgorithm-merge-perl — otherwise you get a global " 15206"conflict on the content of the entry)." 15207msgstr "" 15208 15209#. type: TP 15210#: dpkg-mergechangelogs.man 15211#, fuzzy, no-wrap 15212#| msgid "B<-R>, B<--recursive>" 15213msgid "B<-m>, B<--merge-prereleases>" 15214msgstr "B<-R>, B<--recursive>" 15215 15216#. type: Plain text 15217#: dpkg-mergechangelogs.man 15218msgid "" 15219"Drop the part after the last tilde in the version number when doing version " 15220"comparison to identify if two entries are supposed to be the same or not." 15221msgstr "" 15222 15223#. type: Plain text 15224#: dpkg-mergechangelogs.man 15225msgid "" 15226"This is useful when you keep using the same changelog entry but you increase " 15227"its version number regularly. For instance, you might have 2.3-1~exp1, " 15228"2.3-1~exp2, ... until the official release 2.3-1 and they are all the same " 15229"changelog entry that has evolved over time." 15230msgstr "" 15231 15232#. type: SH 15233#: dpkg-mergechangelogs.man 15234#, no-wrap 15235msgid "LIMITATIONS" 15236msgstr "" 15237 15238#. type: Plain text 15239#: dpkg-mergechangelogs.man 15240msgid "" 15241"Anything that is not parsed by Dpkg::Changelog is lost during the merge. " 15242"This might include stuff like comments which were not supposed to be there, " 15243"etc." 15244msgstr "" 15245 15246#. type: SH 15247#: dpkg-mergechangelogs.man 15248#, no-wrap 15249msgid "INTEGRATION WITH GIT" 15250msgstr "" 15251 15252#. type: Plain text 15253#: dpkg-mergechangelogs.man 15254msgid "" 15255"If you want to use this program to merge Debian changelog files in a git " 15256"repository, you have first to register a new merge driver in B<.git/config> " 15257"or B<~/.gitconfig>:" 15258msgstr "" 15259 15260#. type: Plain text 15261#: dpkg-mergechangelogs.man 15262#, no-wrap 15263msgid "" 15264" [merge \"dpkg-mergechangelogs\"]\n" 15265" name = debian/changelog merge driver\n" 15266" driver = dpkg-mergechangelogs -m %O %A %B %A\n" 15267msgstr "" 15268 15269#. type: Plain text 15270#: dpkg-mergechangelogs.man 15271msgid "" 15272"Then you have to setup the merge attribute for the debian/changelog file " 15273"either in B<.gitattributes> in the repository itself, or in B<.git/info/" 15274"attributes>:" 15275msgstr "" 15276 15277#. type: Plain text 15278#: dpkg-mergechangelogs.man 15279#, no-wrap 15280msgid " debian/changelog merge=dpkg-mergechangelogs\n" 15281msgstr "" 15282 15283#. type: TH 15284#: dpkg-name.man 15285#, no-wrap 15286msgid "dpkg-name" 15287msgstr "" 15288 15289#. type: Plain text 15290#: dpkg-name.man 15291msgid "dpkg-name - rename Debian packages to full package names" 15292msgstr "" 15293 15294#. type: Plain text 15295#: dpkg-name.man 15296msgid "B<dpkg-name> [I<option>...] [B<-->] I<file>..." 15297msgstr "" 15298 15299#. type: Plain text 15300#: dpkg-name.man 15301msgid "" 15302"This manual page documents the B<dpkg-name> program which provides an easy " 15303"way to rename B<Debian> packages into their full package names. A full " 15304"package name consists of I<package>B<_>I<version>B<_>I<architecture>B<." 15305">I<package-type> as specified in the control file of the package. The " 15306"I<version> part of the filename consists of the upstream version information " 15307"optionally followed by a hyphen and the revision information. The I<package-" 15308"type> part comes from that field if present or fallbacks to B<deb>." 15309msgstr "" 15310 15311#. type: TP 15312#: dpkg-name.man 15313#, no-wrap 15314msgid "B<-a>, B<--no-architecture>" 15315msgstr "" 15316 15317#. type: Plain text 15318#: dpkg-name.man 15319msgid "The destination filename will not have the architecture information." 15320msgstr "" 15321 15322#. type: TP 15323#: dpkg-name.man 15324#, no-wrap 15325msgid "B<-k>, B<--symlink>" 15326msgstr "" 15327 15328#. type: Plain text 15329#: dpkg-name.man 15330msgid "Create a symlink, instead of moving." 15331msgstr "" 15332 15333#. type: TP 15334#: dpkg-name.man 15335#, no-wrap 15336msgid "B<-o>, B<--overwrite>" 15337msgstr "" 15338 15339#. type: Plain text 15340#: dpkg-name.man 15341msgid "" 15342"Existing files will be overwritten if they have the same name as the " 15343"destination filename." 15344msgstr "" 15345 15346#. type: TP 15347#: dpkg-name.man 15348#, no-wrap 15349msgid "B<-s>, B<--subdir> [I<dir>]" 15350msgstr "" 15351 15352#. type: Plain text 15353#: dpkg-name.man 15354msgid "" 15355"Files will be moved into a subdirectory. If the directory given as argument " 15356"exists the files will be moved into that directory otherwise the name of the " 15357"target directory is extracted from the section field in the control part of " 15358"the package. The target directory will be «unstable/binary-I<architecture>/" 15359"I<section>». If the section is not found in the control, then B<no-section> " 15360"is assumed, and in this case, as well as for sections B<non-free> and " 15361"B<contrib> the target directory is «I<section>/binary-I<architecture>». The " 15362"section field is not required so a lot of packages will find their way to " 15363"the B<no-section> area. Use this option with care, it's messy." 15364msgstr "" 15365 15366#. type: TP 15367#: dpkg-name.man 15368#, no-wrap 15369msgid "B<-c>, B<--create-dir>" 15370msgstr "" 15371 15372#. type: Plain text 15373#: dpkg-name.man 15374msgid "" 15375"This option can used together with the B<-s> option. If a target directory " 15376"isn't found it will be created automatically. B<Use this option with care.>" 15377msgstr "" 15378 15379#. type: TP 15380#: dpkg-name.man 15381#, no-wrap 15382msgid "B<-v>, B<--version>" 15383msgstr "" 15384 15385#. type: Plain text 15386#: dpkg-name.man 15387msgid "" 15388"Some packages don't follow the name structure " 15389"I<package>B<_>I<version>B<_>I<architecture>B<.deb>. Packages renamed by " 15390"B<dpkg-name> will follow this structure. Generally this will have no impact " 15391"on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other " 15392"installation tools might depend on this naming structure." 15393msgstr "" 15394 15395#. type: TP 15396#: dpkg-name.man 15397#, no-wrap 15398msgid "B<dpkg-name bar-foo.deb>" 15399msgstr "" 15400 15401#. type: Plain text 15402#: dpkg-name.man 15403msgid "" 15404"The file B<bar-foo.deb> will be renamed to bar-foo_1.0-2_i386.deb or " 15405"something similar (depending on whatever information is in the control part " 15406"of B<bar-foo.deb>)." 15407msgstr "" 15408 15409#. type: TP 15410#: dpkg-name.man 15411#, no-wrap 15412msgid "B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>" 15413msgstr "" 15414 15415#. type: Plain text 15416#: dpkg-name.man 15417msgid "" 15418"All files with the extension B<deb> in the directory /root/debian and its " 15419"subdirectory's will be renamed by B<dpkg-name> if required into names with " 15420"no architecture information." 15421msgstr "" 15422 15423#. type: TP 15424#: dpkg-name.man 15425#, no-wrap 15426msgid "B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>" 15427msgstr "" 15428 15429#. type: Plain text 15430#: dpkg-name.man 15431msgid "" 15432"B<Don't do this.> Your archive will be messed up completely because a lot of " 15433"packages don't come with section information. B<Don't do this.>" 15434msgstr "" 15435 15436#. type: TP 15437#: dpkg-name.man 15438#, no-wrap 15439msgid "B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>" 15440msgstr "" 15441 15442#. type: Plain text 15443#: dpkg-name.man 15444msgid "This can be used when building new packages." 15445msgstr "" 15446 15447#. type: Plain text 15448#: dpkg-name.man 15449msgid "" 15450"B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dpkg-deb>(1), B<find>(1), " 15451"B<xargs>(1)." 15452msgstr "" 15453 15454#. type: TH 15455#: dpkg-parsechangelog.man 15456#, no-wrap 15457msgid "dpkg-parsechangelog" 15458msgstr "" 15459 15460#. type: Plain text 15461#: dpkg-parsechangelog.man 15462msgid "dpkg-parsechangelog - parse Debian changelog files" 15463msgstr "" 15464 15465#. type: Plain text 15466#: dpkg-parsechangelog.man 15467msgid "B<dpkg-parsechangelog> [I<option>...]" 15468msgstr "" 15469 15470#. type: Plain text 15471#: dpkg-parsechangelog.man 15472msgid "" 15473"B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian " 15474"source tree and outputs the information in it to standard output in a " 15475"machine-readable form." 15476msgstr "" 15477 15478#. type: TP 15479#: dpkg-parsechangelog.man 15480#, fuzzy, no-wrap 15481#| msgid "B<--unpack >I<package-file>..." 15482msgid "B<-l>, B<--file> I<changelog-file>" 15483msgstr "B<--unpack >I<package-file>..." 15484 15485#. type: Plain text 15486#: dpkg-parsechangelog.man 15487msgid "" 15488"Specifies the changelog file to read information from. A ‘-’ can be used to " 15489"specify reading from standard input. The default is B<debian/changelog>." 15490msgstr "" 15491 15492#. type: TP 15493#: dpkg-parsechangelog.man 15494#, no-wrap 15495msgid "B<-F> I<changelog-format>" 15496msgstr "" 15497 15498#. type: Plain text 15499#: dpkg-parsechangelog.man 15500msgid "" 15501"Specifies the format of the changelog. By default the format is read from a " 15502"special line near the bottom of the changelog or failing that defaults to " 15503"the B<debian> standard format. See also B<CHANGELOG FORMATS>." 15504msgstr "" 15505 15506#. type: TP 15507#: dpkg-parsechangelog.man 15508#, fuzzy, no-wrap 15509#| msgid "B<--root=>I<dir>" 15510msgid "B<-L> I<libdir>" 15511msgstr "B<--root=>I<dir>" 15512 15513#. type: Plain text 15514#: dpkg-parsechangelog.man 15515msgid "" 15516"Obsolete option without effect (since dpkg 1.18.8). Setting the perl " 15517"environment variables B<PERL5LIB> or B<PERLLIB> has a similar effect when " 15518"looking for the parser perl modules." 15519msgstr "" 15520 15521#. type: TP 15522#: dpkg-parsechangelog.man 15523#, no-wrap 15524msgid "B<-S>, B<--show-field> I<field>" 15525msgstr "" 15526 15527#. type: Plain text 15528#: dpkg-parsechangelog.man 15529msgid "" 15530"Specifies the name of the field to show (since dpkg 1.17.0). The field name " 15531"is not printed, only its value." 15532msgstr "" 15533 15534#. type: SS 15535#: dpkg-parsechangelog.man 15536#, no-wrap 15537msgid "Parser Options" 15538msgstr "" 15539 15540#. type: Plain text 15541#: dpkg-parsechangelog.man 15542msgid "" 15543"The following options can be used to influence the output of the changelog " 15544"parser, e.g. the range of entries or the format of the output." 15545msgstr "" 15546 15547#. type: TP 15548#: dpkg-parsechangelog.man 15549#, no-wrap 15550msgid "B<--format>I< output-format>" 15551msgstr "" 15552 15553#. type: Plain text 15554#: dpkg-parsechangelog.man 15555msgid "" 15556"Set the output format. Currently supported values are B<dpkg> and " 15557"B<rfc822>. B<dpkg> is the classic output format (from before this option " 15558"existed) and the default. It consists of one paragraph in Debian control " 15559"format (see B<deb-control>(5)). If more than one entry is requested, then " 15560"most fields are taken from the first entry (usually the most recent entry), " 15561"except otherwise stated:" 15562msgstr "" 15563 15564#. type: TP 15565#: dpkg-parsechangelog.man 15566#, no-wrap 15567msgid "B<Source:>I< pkg-name>" 15568msgstr "" 15569 15570#. type: TP 15571#: dpkg-parsechangelog.man 15572#, no-wrap 15573msgid "B<Version:>I< version>" 15574msgstr "" 15575 15576#. type: TP 15577#: dpkg-parsechangelog.man 15578#, no-wrap 15579msgid "B<Distribution:>I< target-distribution>" 15580msgstr "" 15581 15582#. type: TP 15583#: dpkg-parsechangelog.man 15584#, no-wrap 15585msgid "B<Urgency:>I< urgency>" 15586msgstr "" 15587 15588#. type: Plain text 15589#: dpkg-parsechangelog.man 15590msgid "" 15591"The highest urgency of all included entries is used, followed by the " 15592"concatenated (space-separated) comments from all the versions requested." 15593msgstr "" 15594 15595#. type: TP 15596#: dpkg-parsechangelog.man 15597#, no-wrap 15598msgid "B<Maintainer:>I< author>" 15599msgstr "" 15600 15601#. type: TP 15602#: dpkg-parsechangelog.man 15603#, no-wrap 15604msgid "B<Date:>I< date>" 15605msgstr "" 15606 15607#. type: Plain text 15608#: dpkg-parsechangelog.man 15609msgid "" 15610"The date of the entry as a string, as it appears in the changelog. With a " 15611"B<strptime>(3) format \"B<%a, %d %b %Y %T %z>\", but where the day of the " 15612"week might not actually correspond to the real day obtained from the rest of " 15613"the date string. If you need a more accurate representation of the date, " 15614"use the B<Timestamp> field, but take into account it might not be possible " 15615"to map it back to the exact value in this field." 15616msgstr "" 15617 15618#. type: TP 15619#: dpkg-parsechangelog.man 15620#, no-wrap 15621msgid "B<Timestamp:>I< timestamp>" 15622msgstr "" 15623 15624#. type: Plain text 15625#: dpkg-parsechangelog.man 15626msgid "" 15627"The date of the entry as a timestamp in seconds since the epoch (since dpkg " 15628"1.18.8)." 15629msgstr "" 15630 15631#. type: TP 15632#: dpkg-parsechangelog.man 15633#, no-wrap 15634msgid "B<Closes:>I< bug-number>" 15635msgstr "" 15636 15637#. type: Plain text 15638#: dpkg-parsechangelog.man 15639msgid "The Closes fields of all included entries are merged." 15640msgstr "" 15641 15642#. type: TP 15643#: dpkg-parsechangelog.man 15644#, no-wrap 15645msgid "B<Changes:>I< changelog-entries>" 15646msgstr "" 15647 15648#. type: Plain text 15649#: dpkg-parsechangelog.man 15650msgid "" 15651"The text of all changelog entries is concatenated. To make this field a " 15652"valid Debian control format multiline field empty lines are replaced with a " 15653"single full stop and all lines is intended by one space character. The exact " 15654"content depends on the changelog format." 15655msgstr "" 15656 15657#. type: Plain text 15658#: dpkg-parsechangelog.man 15659msgid "" 15660"The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> " 15661"fields are mandatory." 15662msgstr "" 15663 15664#. type: Plain text 15665#: dpkg-parsechangelog.man 15666msgid "There might be additional user-defined fields present." 15667msgstr "" 15668 15669#. type: Plain text 15670#: dpkg-parsechangelog.man 15671msgid "" 15672"The B<rfc822> format uses the same fields but outputs a separate paragraph " 15673"for each changelog entry so that all metadata for each entry is preserved." 15674msgstr "" 15675 15676#. type: TP 15677#: dpkg-parsechangelog.man 15678#, fuzzy, no-wrap 15679#| msgid "B<--version>" 15680msgid "B<--reverse>" 15681msgstr "B<--version>" 15682 15683#. type: Plain text 15684#: dpkg-parsechangelog.man 15685msgid "" 15686"Include all changes in reverse order (since dpkg 1.19.1). Note: for the " 15687"B<dpkg> format the first entry will be the most ancient entry." 15688msgstr "" 15689 15690#. type: TP 15691#: dpkg-parsechangelog.man update-alternatives.man 15692#, no-wrap 15693msgid "B<--all>" 15694msgstr "" 15695 15696#. type: Plain text 15697#: dpkg-parsechangelog.man 15698msgid "" 15699"Include all changes. Note: other options have no effect when this is in use." 15700msgstr "" 15701 15702#. type: TP 15703#: dpkg-parsechangelog.man 15704#, fuzzy, no-wrap 15705#| msgid "B<-E>, B<--skip-same-version>" 15706msgid "B<-s>, B<--since> I<version>" 15707msgstr "B<-E>, B<--skip-same-version>" 15708 15709#. type: TQ 15710#: dpkg-parsechangelog.man 15711#, fuzzy, no-wrap 15712#| msgid "B<--version>" 15713msgid "B<-v> I<version>" 15714msgstr "B<--version>" 15715 15716#. type: Plain text 15717#: dpkg-parsechangelog.man 15718msgid "Include all changes later than I<version>." 15719msgstr "" 15720 15721#. type: TP 15722#: dpkg-parsechangelog.man 15723#, fuzzy, no-wrap 15724#| msgid "B<-E>, B<--skip-same-version>" 15725msgid "B<-u>, B<--until> I<version>" 15726msgstr "B<-E>, B<--skip-same-version>" 15727 15728#. type: Plain text 15729#: dpkg-parsechangelog.man 15730msgid "Include all changes earlier than I<version>." 15731msgstr "" 15732 15733#. type: TP 15734#: dpkg-parsechangelog.man 15735#, fuzzy, no-wrap 15736#| msgid "B<-E>, B<--skip-same-version>" 15737msgid "B<-f>, B<--from> I<version>" 15738msgstr "B<-E>, B<--skip-same-version>" 15739 15740#. type: Plain text 15741#: dpkg-parsechangelog.man 15742msgid "Include all changes equal or later than I<version>." 15743msgstr "" 15744 15745#. type: TP 15746#: dpkg-parsechangelog.man 15747#, fuzzy, no-wrap 15748#| msgid "B<-E>, B<--skip-same-version>" 15749msgid "B<-t>, B<--to> I<version>" 15750msgstr "B<-E>, B<--skip-same-version>" 15751 15752#. type: Plain text 15753#: dpkg-parsechangelog.man 15754msgid "Include all changes up to or equal than I<version>." 15755msgstr "" 15756 15757#. type: TP 15758#: dpkg-parsechangelog.man 15759#, fuzzy, no-wrap 15760#| msgid "B<-C>, B<--audit> [I<package-name>...]" 15761msgid "B<-c>, B<--count> I<number>" 15762msgstr "B<-C>, B<--audit> [I<package-name>...]" 15763 15764#. type: TQ 15765#: dpkg-parsechangelog.man 15766#, fuzzy, no-wrap 15767#| msgid "B<--abort-after=>I<number>" 15768msgid "B<-n> I<number>" 15769msgstr "B<--abort-after=>I<number>" 15770 15771#. type: Plain text 15772#: dpkg-parsechangelog.man 15773msgid "" 15774"Include I<number> entries from the top (or the tail if I<number> is lower " 15775"than 0)." 15776msgstr "" 15777 15778#. type: TP 15779#: dpkg-parsechangelog.man 15780#, fuzzy, no-wrap 15781#| msgid "B<--abort-after=>I<number>" 15782msgid "B<-o>, B<--offset> I<number>" 15783msgstr "B<--abort-after=>I<number>" 15784 15785#. type: Plain text 15786#: dpkg-parsechangelog.man 15787msgid "" 15788"Change the starting point for B<--count>, counted from the top (or the tail " 15789"if I<number> is lower than 0)." 15790msgstr "" 15791 15792#. type: SH 15793#: dpkg-parsechangelog.man 15794#, no-wrap 15795msgid "CHANGELOG FORMATS" 15796msgstr "" 15797 15798#. type: Plain text 15799#: dpkg-parsechangelog.man 15800msgid "" 15801"It is possible to use a different format to the standard one, by providing a " 15802"parser for that alternative format." 15803msgstr "" 15804 15805#. type: Plain text 15806#: dpkg-parsechangelog.man 15807msgid "" 15808"In order to have B<dpkg-parsechangelog> run the new parser, a line must be " 15809"included within the last 40 lines of the changelog file, matching the Perl " 15810"regular expression: “B<\\eschangelog-format:\\es+([0-9a-z]+)\\eW>”. The " 15811"part in parentheses should be the name of the format. For example:" 15812msgstr "" 15813 15814#. type: Plain text 15815#: dpkg-parsechangelog.man 15816#, no-wrap 15817msgid " @@@ changelog-format: I<otherformat> @@@\n" 15818msgstr "" 15819 15820#. type: Plain text 15821#: dpkg-parsechangelog.man 15822msgid "" 15823"Changelog format names are non-empty strings of lowercase alphanumerics (“a-" 15824"z0-9”)." 15825msgstr "" 15826 15827#. type: Plain text 15828#: dpkg-parsechangelog.man 15829msgid "" 15830"If such a line exists then B<dpkg-parsechangelog> will look for the parser " 15831"as a B<Dpkg::Changelog::>I<Otherformat> perl module; it is an error for it " 15832"not being present. The parser name in the perl module will be automatically " 15833"capitalized. The default changelog format is B<debian>, and a parser for it " 15834"is provided by default." 15835msgstr "" 15836 15837#. type: Plain text 15838#: dpkg-parsechangelog.man 15839msgid "" 15840"The parser should be derived from the Dpkg::Changelog class and implement " 15841"the required documented interface." 15842msgstr "" 15843 15844#. type: Plain text 15845#: dpkg-parsechangelog.man 15846msgid "" 15847"If the changelog format which is being parsed always or almost always leaves " 15848"a blank line between individual change notes, these blank lines should be " 15849"stripped out, so as to make the resulting output compact." 15850msgstr "" 15851 15852#. type: Plain text 15853#: dpkg-parsechangelog.man 15854msgid "" 15855"If the changelog format does not contain date or package name information " 15856"this information should be omitted from the output. The parser should not " 15857"attempt to synthesize it or find it from other sources." 15858msgstr "" 15859 15860#. type: Plain text 15861#: dpkg-parsechangelog.man 15862msgid "" 15863"If the changelog does not have the expected format the parser should error " 15864"out, rather than trying to muddle through and possibly generating incorrect " 15865"output." 15866msgstr "" 15867 15868#. type: Plain text 15869#: dpkg-parsechangelog.man 15870msgid "A changelog parser may not interact with the user at all." 15871msgstr "" 15872 15873#. type: Plain text 15874#: dpkg-parsechangelog.man 15875msgid "" 15876"All B<Parser Options> except for B<-v> are only supported since dpkg 1.14.16." 15877msgstr "" 15878 15879#. type: Plain text 15880#: dpkg-parsechangelog.man 15881msgid "" 15882"Short option parsing with non-bundled values available only since dpkg " 15883"1.18.0." 15884msgstr "" 15885 15886#. type: TP 15887#: dpkg-parsechangelog.man 15888#, no-wrap 15889msgid "B<debian/changelog>" 15890msgstr "" 15891 15892#. type: Plain text 15893#: dpkg-parsechangelog.man 15894msgid "" 15895"The changelog file, used to obtain version-dependent information about the " 15896"source package, such as the urgency and distribution of an upload, the " 15897"changes made since a particular release, and the source version number " 15898"itself." 15899msgstr "" 15900 15901#. type: Plain text 15902#: dpkg-parsechangelog.man 15903#, fuzzy 15904#| msgid "B<--unpack >I<package-file>..." 15905msgid "B<deb-changelog>(5)." 15906msgstr "B<--unpack >I<package-file>..." 15907 15908#. type: TH 15909#: dpkg-query.man 15910#, no-wrap 15911msgid "dpkg-query" 15912msgstr "" 15913 15914#. type: Plain text 15915#: dpkg-query.man 15916msgid "dpkg-query - a tool to query the dpkg database" 15917msgstr "" 15918 15919#. type: Plain text 15920#: dpkg-query.man 15921msgid "B<dpkg-query> [I<option>...] I<command>" 15922msgstr "" 15923 15924#. type: Plain text 15925#: dpkg-query.man 15926msgid "" 15927"B<dpkg-query> is a tool to show information about packages listed in the " 15928"B<dpkg> database." 15929msgstr "" 15930 15931#. type: TP 15932#: dpkg-query.man 15933#, no-wrap 15934msgid "B<-l>, B<--list> [I<package-name-pattern>...]" 15935msgstr "" 15936 15937#. type: Plain text 15938#: dpkg-query.man 15939msgid "" 15940"List all known packages matching one or more patterns, regardless of their " 15941"status, which includes any real or virtual package referenced in any " 15942"dependency relationship field (such as B<Breaks>, B<Enhances>, etc.). If no " 15943"I<package-name-pattern> is given, list all packages in I<%ADMINDIR%/status>, " 15944"excluding the ones marked as not-installed (i.e. those which have been " 15945"previously purged). Normal shell wildcard characters are allowed in " 15946"I<package-name-pattern>. Please note you will probably have to quote " 15947"I<package-name-pattern> to prevent the shell from performing filename " 15948"expansion. For example this will list all package names starting with " 15949"``libc6'':" 15950msgstr "" 15951 15952#. type: Plain text 15953#: dpkg-query.man 15954#, no-wrap 15955msgid " B<dpkg-query -l 'libc6*'>\n" 15956msgstr "" 15957 15958#. type: Plain text 15959#: dpkg-query.man 15960msgid "" 15961"The first three columns of the output show the desired action, the package " 15962"status, and errors, in that order." 15963msgstr "" 15964 15965#. type: Plain text 15966#: dpkg-query.man 15967msgid "Desired action:" 15968msgstr "" 15969 15970#. type: Plain text 15971#: dpkg-query.man 15972#, no-wrap 15973msgid "" 15974" u = Unknown\n" 15975" i = Install\n" 15976" h = Hold\n" 15977" r = Remove\n" 15978" p = Purge\n" 15979msgstr "" 15980 15981#. type: Plain text 15982#: dpkg-query.man 15983msgid "Package status:" 15984msgstr "" 15985 15986#. type: Plain text 15987#: dpkg-query.man 15988#, no-wrap 15989msgid "" 15990" n = Not-installed\n" 15991" c = Config-files\n" 15992" H = Half-installed\n" 15993" U = Unpacked\n" 15994" F = Half-configured\n" 15995" W = Triggers-awaiting\n" 15996" t = Triggers-pending\n" 15997" i = Installed\n" 15998msgstr "" 15999 16000#. type: Plain text 16001#: dpkg-query.man 16002msgid "Error flags:" 16003msgstr "" 16004 16005#. type: Plain text 16006#: dpkg-query.man 16007#, no-wrap 16008msgid "" 16009" E<lt>emptyE<gt> = (none)\n" 16010" R = Reinst-required\n" 16011msgstr "" 16012 16013#. type: Plain text 16014#: dpkg-query.man 16015msgid "" 16016"An uppercase status or error letter indicates the package is likely to cause " 16017"severe problems. Please refer to B<dpkg>(1) for information about the above " 16018"states and flags." 16019msgstr "" 16020 16021#. type: Plain text 16022#: dpkg-query.man 16023msgid "" 16024"The output format of this option is not configurable, but varies " 16025"automatically to fit the terminal width. It is intended for human readers, " 16026"and is not easily machine-readable. See B<-W> (B<--show>) and B<--" 16027"showformat> for a way to configure the output format." 16028msgstr "" 16029 16030#. type: TP 16031#: dpkg-query.man 16032#, no-wrap 16033msgid "B<-W>, B<--show> [I<package-name-pattern>...]" 16034msgstr "" 16035 16036#. type: Plain text 16037#: dpkg-query.man 16038msgid "" 16039"Just like the B<--list> option this will list all packages matching the " 16040"given pattern. However the output can be customized using the B<--" 16041"showformat> option. The default output format gives one line per matching " 16042"package, each line having the name (extended with the architecture qualifier " 16043"for B<Multi-Arch> B<same> packages) and installed version of the package, " 16044"separated by a tab." 16045msgstr "" 16046 16047#. type: TP 16048#: dpkg-query.man 16049#, fuzzy, no-wrap 16050#| msgid "B<-C>, B<--audit> [I<package-name>...]" 16051msgid "B<-s>, B<--status> [I<package-name>...]" 16052msgstr "B<-C>, B<--audit> [I<package-name>...]" 16053 16054#. type: Plain text 16055#: dpkg-query.man 16056msgid "" 16057"Report status of specified package. This just displays the entry in the " 16058"installed package status database. If no I<package-name> is specified it " 16059"will display all package entries in the status database (since dpkg " 16060"1.19.1). When multiple I<package-name> entries are listed, the requested " 16061"status entries are separated by an empty line, with the same order as " 16062"specified on the argument list." 16063msgstr "" 16064 16065#. type: TP 16066#: dpkg-query.man 16067#, no-wrap 16068msgid "B<-L>, B<--listfiles> I<package-name>..." 16069msgstr "" 16070 16071#. type: Plain text 16072#: dpkg-query.man 16073msgid "" 16074"List files installed to your system from I<package-name>. When multiple " 16075"I<package-name> are listed, the requested lists of files are separated by an " 16076"empty line, with the same order as specified on the argument list. However, " 16077"note that files created by package-specific installation-scripts are not " 16078"listed." 16079msgstr "" 16080 16081#. type: TP 16082#: dpkg-query.man 16083#, no-wrap 16084msgid "B<--control-list> I<package-name>" 16085msgstr "" 16086 16087#. type: Plain text 16088#: dpkg-query.man 16089msgid "" 16090"List control files installed to your system from I<package-name> (since dpkg " 16091"1.16.5). These can be used as input arguments to B<--control-show>." 16092msgstr "" 16093 16094#. type: TP 16095#: dpkg-query.man 16096#, no-wrap 16097msgid "B<--control-show> I<package-name> I<control-file>" 16098msgstr "" 16099 16100#. type: Plain text 16101#: dpkg-query.man 16102msgid "" 16103"Print the I<control-file> installed to your system from I<package-name> to " 16104"the standard output (since dpkg 1.16.5)." 16105msgstr "" 16106 16107#. type: TP 16108#: dpkg-query.man 16109#, no-wrap 16110msgid "B<-c>, B<--control-path> I<package-name> [I<control-file>]" 16111msgstr "" 16112 16113#. type: Plain text 16114#: dpkg-query.man 16115msgid "" 16116"List paths for control files installed to your system from I<package-name> " 16117"(since dpkg 1.15.4). If I<control-file> is specified then only list the " 16118"path for that control file if it is present." 16119msgstr "" 16120 16121#. type: Plain text 16122#: dpkg-query.man 16123msgid "" 16124"B<Warning>: this command is deprecated as it gives direct access to the " 16125"internal dpkg database, please switch to use B<--control-list> and B<--" 16126"control-show> instead for all cases where those commands might give the same " 16127"end result. Although, as long as there is still at least one case where this " 16128"command is needed (i.e. when having to remove a damaging postrm maintainer " 16129"script), and while there is no good solution for that, this command will not " 16130"get removed." 16131msgstr "" 16132 16133#. type: TP 16134#: dpkg-query.man 16135#, no-wrap 16136msgid "B<-S>, B<--search> I<filename-search-pattern>..." 16137msgstr "" 16138 16139#. type: Plain text 16140#: dpkg-query.man 16141msgid "" 16142"Search for packages that own files corresponding to the given pattern. " 16143"Standard shell wildcard characters can be used in the pattern, where " 16144"asterisk (B<*>) and question mark (B<?>) will match a slash, and backslash " 16145"(B<\\e>) will be used as an escape character." 16146msgstr "" 16147 16148#. type: Plain text 16149#: dpkg-query.man 16150msgid "" 16151"If the first character in the I<filename-search-pattern> is none of ‘B<*[?/" 16152">’ then it will be considered a substring match and will be implicitly " 16153"surrounded by ‘B<*>’ (as in B<*>I<filename-search-pattern>B<*>). If the " 16154"subsequent string contains any of ‘B<*[?\\e>’, then it will handled like a " 16155"glob pattern, otherwise any trailing ‘B</>’ or ‘B</.>’ will be removed and a " 16156"literal path lookup will be performed." 16157msgstr "" 16158 16159#. type: Plain text 16160#: dpkg-query.man 16161msgid "" 16162"This command will not list extra files created by maintainer scripts, nor " 16163"will it list alternatives." 16164msgstr "" 16165 16166#. type: TP 16167#: dpkg-query.man 16168#, fuzzy, no-wrap 16169#| msgid "B<-C>, B<--audit> [I<package-name>...]" 16170msgid "B<-p>, B<--print-avail> [I<package-name>...]" 16171msgstr "B<-C>, B<--audit> [I<package-name>...]" 16172 16173#. type: Plain text 16174#: dpkg-query.man 16175msgid "" 16176"Display details about packages, as found in I<%ADMINDIR%/available>. If no " 16177"I<package-name> is specified, it will display all package entries in the " 16178"I<available> database (since dpkg 1.19.1). When multiple I<package-name> " 16179"are listed, the requested I<available> entries are separated by an empty " 16180"line, with the same order as specified on the argument list." 16181msgstr "" 16182 16183#. type: Plain text 16184#: dpkg-query.man 16185msgid "" 16186"Users of APT-based frontends should use B<apt-cache show> I<package-name> " 16187"instead as the I<available> file is only kept up-to-date when using " 16188"B<dselect>." 16189msgstr "" 16190 16191#. type: Plain text 16192#: dpkg-query.man dpkg-trigger.man 16193msgid "" 16194"Change the location of the B<dpkg> database. The default location is I<" 16195"%ADMINDIR%>." 16196msgstr "" 16197 16198#. type: TP 16199#: dpkg-query.man 16200#, no-wrap 16201msgid "B<--load-avail>" 16202msgstr "" 16203 16204#. type: Plain text 16205#: dpkg-query.man 16206msgid "" 16207"Also load the available file when using the B<--show> and B<--list> " 16208"commands, which now default to only querying the status file (since dpkg " 16209"1.16.2)." 16210msgstr "" 16211 16212#. type: TP 16213#: dpkg-query.man 16214#, no-wrap 16215msgid "B<-f>, B<--showformat=>I<format>" 16216msgstr "" 16217 16218#. type: Plain text 16219#: dpkg-query.man 16220msgid "" 16221"This option is used to specify the format of the output B<--show> will " 16222"produce (short option since dpkg 1.13.1). The format is a string that will " 16223"be output for each package listed." 16224msgstr "" 16225 16226#. type: Plain text 16227#: dpkg-query.man 16228msgid "In the format string, “B<\\e>” introduces escapes:" 16229msgstr "" 16230 16231#. type: Plain text 16232#: dpkg-query.man 16233#, no-wrap 16234msgid "" 16235" B<\\en> newline\n" 16236" B<\\er> carriage return\n" 16237" B<\\et> tab\n" 16238msgstr "" 16239 16240#. type: Plain text 16241#: dpkg-query.man 16242msgid "" 16243"“B<\\e>” before any other character suppresses any special meaning of the " 16244"following character, which is useful for “B<\\e>” and “B<$>”." 16245msgstr "" 16246 16247#. type: Plain text 16248#: dpkg-query.man 16249msgid "" 16250"Package information can be included by inserting variable references to " 16251"package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”. Fields " 16252"are printed right-aligned unless the width is negative in which case left " 16253"alignment will be used. The following I<field>s are recognized but they are " 16254"not necessarily available in the status file (only internal fields or fields " 16255"stored in the binary package end up in it):" 16256msgstr "" 16257 16258#. type: Plain text 16259#: dpkg-query.man 16260#, no-wrap 16261msgid "" 16262" B<Architecture>\n" 16263" B<Bugs>\n" 16264" B<Conffiles> (internal)\n" 16265" B<Config-Version> (internal)\n" 16266" B<Conflicts>\n" 16267" B<Breaks>\n" 16268" B<Depends>\n" 16269" B<Description>\n" 16270" B<Enhances>\n" 16271" B<Essential>\n" 16272" B<Filename> (internal, front-end related)\n" 16273" B<Homepage>\n" 16274" B<Installed-Size>\n" 16275" B<MD5sum> (internal, front-end related)\n" 16276" B<MSDOS-Filename> (internal, front-end related)\n" 16277" B<Maintainer>\n" 16278" B<Origin>\n" 16279" B<Package>\n" 16280" B<Pre-Depends>\n" 16281" B<Priority>\n" 16282" B<Provides>\n" 16283" B<Recommends>\n" 16284" B<Replaces>\n" 16285" B<Revision> (obsolete)\n" 16286" B<Section>\n" 16287" B<Size> (internal, front-end related)\n" 16288" B<Source>\n" 16289" B<Status> (internal)\n" 16290" B<Suggests>\n" 16291" B<Tag> (usually not in .deb but in repository Packages files)\n" 16292" B<Triggers-Awaited> (internal)\n" 16293" B<Triggers-Pending> (internal)\n" 16294" B<Version>\n" 16295msgstr "" 16296 16297#. type: Plain text 16298#: dpkg-query.man 16299msgid "" 16300"The following are virtual fields, generated by B<dpkg-query> from values " 16301"from other fields (note that these do not use valid names for fields in " 16302"control files):" 16303msgstr "" 16304 16305#. type: TP 16306#: dpkg-query.man 16307#, no-wrap 16308msgid "B<binary:Package>" 16309msgstr "" 16310 16311#. type: Plain text 16312#: dpkg-query.man 16313msgid "" 16314"It contains the binary package name with a possible architecture qualifier " 16315"like “libc6:amd64” (since dpkg 1.16.2). An architecture qualifier will be " 16316"present to make the package name unambiguous, for example if the package has " 16317"a B<Multi-Arch> field with a value of B<same> or the package is of a foreign " 16318"architecture." 16319msgstr "" 16320 16321#. type: TP 16322#: dpkg-query.man 16323#, fuzzy, no-wrap 16324#| msgid "dpkg-source" 16325msgid "B<binary:Synopsis>" 16326msgstr "dpkg-source" 16327 16328#. type: Plain text 16329#: dpkg-query.man 16330#, fuzzy 16331#| msgid "B<bad-version>: Process even packages with wrong versions." 16332msgid "It contains the package short description (since dpkg 1.19.1)." 16333msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 16334 16335#. type: TP 16336#: dpkg-query.man 16337#, no-wrap 16338msgid "B<binary:Summary>" 16339msgstr "" 16340 16341#. type: Plain text 16342#: dpkg-query.man 16343msgid "This is an alias for B<binary:Synopsis> (since dpkg 1.16.2)." 16344msgstr "" 16345 16346#. type: TP 16347#: dpkg-query.man 16348#, no-wrap 16349msgid "B<db:Status-Abbrev>" 16350msgstr "" 16351 16352#. type: Plain text 16353#: dpkg-query.man 16354msgid "" 16355"It contains the abbreviated package status (as three characters), such as " 16356"“ii ” or “iHR” (since dpkg 1.16.2). See the B<--list> command description " 16357"for more details." 16358msgstr "" 16359 16360#. type: TP 16361#: dpkg-query.man 16362#, no-wrap 16363msgid "B<db:Status-Want>" 16364msgstr "" 16365 16366#. type: Plain text 16367#: dpkg-query.man 16368msgid "" 16369"It contains the package wanted status, part of the Status field (since dpkg " 16370"1.17.11)." 16371msgstr "" 16372 16373#. type: TP 16374#: dpkg-query.man 16375#, no-wrap 16376msgid "B<db:Status-Status>" 16377msgstr "" 16378 16379#. type: Plain text 16380#: dpkg-query.man 16381msgid "" 16382"It contains the package status word, part of the Status field (since dpkg " 16383"1.17.11)." 16384msgstr "" 16385 16386#. type: TP 16387#: dpkg-query.man 16388#, no-wrap 16389msgid "B<db:Status-Eflag>" 16390msgstr "" 16391 16392#. type: Plain text 16393#: dpkg-query.man 16394msgid "" 16395"It contains the package status error flag, part of the Status field (since " 16396"dpkg 1.17.11)." 16397msgstr "" 16398 16399#. type: TP 16400#: dpkg-query.man 16401#, fuzzy, no-wrap 16402#| msgid "B<--unpack >I<package-file>..." 16403msgid "B<db-fsys:Files>" 16404msgstr "B<--unpack >I<package-file>..." 16405 16406#. type: Plain text 16407#: dpkg-query.man 16408#, fuzzy 16409#| msgid "B<bad-version>: Process even packages with wrong versions." 16410msgid "" 16411"It contains the list of the package filesystem entries separated by newlines " 16412"(since dpkg 1.19.3)." 16413msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 16414 16415#. type: TP 16416#: dpkg-query.man 16417#, no-wrap 16418msgid "B<db-fsys:Last-Modified>" 16419msgstr "" 16420 16421#. type: Plain text 16422#: dpkg-query.man 16423msgid "" 16424"It contains the timestamp in seconds of the last time the package filesystem " 16425"entries were modified (since dpkg 1.19.3)." 16426msgstr "" 16427 16428#. type: TP 16429#: dpkg-query.man 16430#, no-wrap 16431msgid "B<source:Package>" 16432msgstr "" 16433 16434#. type: Plain text 16435#: dpkg-query.man 16436msgid "" 16437"It contains the source package name for this binary package (since dpkg " 16438"1.16.2)." 16439msgstr "" 16440 16441#. type: Plain text 16442#: dpkg-query.man 16443msgid "" 16444"It contains the source package version for this binary package (since dpkg " 16445"1.16.2)" 16446msgstr "" 16447 16448#. type: Plain text 16449#: dpkg-query.man 16450#, fuzzy 16451#| msgid "B<bad-version>: Process even packages with wrong versions." 16452msgid "" 16453"It contains the source package upstream version for this binary package " 16454"(since dpkg 1.18.16)" 16455msgstr "B<bad-version>: 容忍错误的软件包版本并继续。" 16456 16457#. type: Plain text 16458#: dpkg-query.man 16459msgid "" 16460"The default format string is “B<${binary:Package}\\et${Version}\\en>”. " 16461"Actually, all other fields found in the status file (i.e. user defined " 16462"fields) can be requested, too. They will be printed as-is, though, no " 16463"conversion nor error checking is done on them. To get the name of the " 16464"B<dpkg> maintainer and the installed version, you could run:" 16465msgstr "" 16466 16467#. type: Plain text 16468#: dpkg-query.man 16469#, no-wrap 16470msgid " B<dpkg-query -W -f='${binary:Package} ${Version}\\et${Maintainer}\\en' dpkg>\n" 16471msgstr "" 16472 16473#. type: Plain text 16474#: dpkg-query.man 16475msgid "The requested query was successfully performed." 16476msgstr "" 16477 16478#. type: Plain text 16479#: dpkg-query.man 16480msgid "" 16481"The requested query failed either fully or partially, due to no file or " 16482"package being found (except for B<--control-path>, B<--control-list> and B<--" 16483"control-show> were such errors are fatal)." 16484msgstr "" 16485 16486#. type: Plain text 16487#: dpkg-query.man 16488msgid "" 16489"Sets the program to execute when spawning a command via a shell (since dpkg " 16490"1.19.2)." 16491msgstr "" 16492 16493#. type: Plain text 16494#: dpkg-query.man 16495msgid "" 16496"Sets the pager command to use (since dpkg 1.19.1), which will be executed " 16497"with «B<$SHELL -c>». If B<SHELL> is not set, «B<sh>» will be used instead. " 16498"The B<DPKG_PAGER> overrides the B<PAGER> environment variable (since dpkg " 16499"1.19.2)." 16500msgstr "" 16501 16502#. type: Plain text 16503#: dpkg-query.man dpkg-trigger.man 16504msgid "" 16505"If set and the B<--admindir> option has not been specified, it will be used " 16506"as the B<dpkg> data directory." 16507msgstr "" 16508 16509#. type: Plain text 16510#: dpkg-query.man 16511msgid "" 16512"Defined by B<dpkg-query> to “B<-FRSXMQ>”, if not already set, when spawning " 16513"a pager (since dpkg 1.19.2). To change the default behavior, this variable " 16514"can be preset to some other value including an empty string, or the B<PAGER> " 16515"or B<DPKG_PAGER> variables can be set to disable specific options with «B<-" 16516"+>», for example B<DPKG_PAGER=\"less -+F\">." 16517msgstr "" 16518 16519#. type: TH 16520#: dpkg-scanpackages.man 16521#, no-wrap 16522msgid "dpkg-scanpackages" 16523msgstr "" 16524 16525#. type: Plain text 16526#: dpkg-scanpackages.man 16527msgid "dpkg-scanpackages - create Packages index files" 16528msgstr "" 16529 16530#. type: Plain text 16531#: dpkg-scanpackages.man 16532msgid "" 16533"B<dpkg-scanpackages> [I<option>...] I<binary-path> [I<override-file> [I<path-" 16534"prefix>]] B<E<gt>> I<Packages>" 16535msgstr "" 16536 16537#. type: Plain text 16538#: dpkg-scanpackages.man 16539msgid "" 16540"B<dpkg-scanpackages> sorts through a tree of Debian binary packages and " 16541"creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the " 16542"user what packages are available for installation. These Packages files are " 16543"the same as those found on Debian archive sites and CD-ROMs. You might use " 16544"B<dpkg-scanpackages> yourself if making a directory of local packages to " 16545"install on a cluster of machines." 16546msgstr "" 16547 16548#. type: Plain text 16549#: dpkg-scanpackages.man 16550msgid "" 16551"B<Note:> If you want to access the generated Packages file with B<apt> you " 16552"will probably need to compress the file with B<xz>(1) (generating a " 16553"Packages.xz file), B<bzip2>(1) (generating a Packages.bz2 file) or " 16554"B<gzip>(1) (generating a Packages.gz file). apt ignores uncompressed " 16555"Packages files except on local access (i.e. B<file://> sources)." 16556msgstr "" 16557 16558#. type: Plain text 16559#: dpkg-scanpackages.man 16560msgid "" 16561"I<binary-path> is the name of the tree of the binary packages to process " 16562"(for example, B<contrib/binary-i386>). It is best to make this relative to " 16563"the root of the Debian archive, because every Filename field in the new " 16564"Packages file will start with this string." 16565msgstr "" 16566 16567#. type: Plain text 16568#: dpkg-scanpackages.man 16569msgid "" 16570"I<override-file> is the name of a file to read which contains information " 16571"about how the package fits into the distribution (the file can be compressed " 16572"since dpkg 1.15.5); see B<deb-override>(5)." 16573msgstr "" 16574 16575#. type: Plain text 16576#: dpkg-scanpackages.man 16577msgid "" 16578"I<path-prefix> is an optional string to be prepended to the Filename fields." 16579msgstr "" 16580 16581#. type: Plain text 16582#: dpkg-scanpackages.man 16583msgid "" 16584"If more than one version of a package is found only the newest one is " 16585"included in the output. If they have the same version and only differ in " 16586"architecture only the first one found is used." 16587msgstr "" 16588 16589#. type: TP 16590#: dpkg-scanpackages.man 16591#, no-wrap 16592msgid "B<-t>, B<--type> I<type>" 16593msgstr "" 16594 16595#. type: Plain text 16596#: dpkg-scanpackages.man 16597msgid "Scan for *.I<type> packages, instead of *.deb." 16598msgstr "" 16599 16600#. type: IP 16601#: dpkg-scanpackages.man dpkg-scansources.man 16602#, no-wrap 16603msgid "B<-e>, B<--extra-override> I<file>" 16604msgstr "" 16605 16606#. type: Plain text 16607#: dpkg-scanpackages.man 16608msgid "" 16609"Scan I<file> to find supplementary overrides (the file can be compressed " 16610"since dpkg 1.15.5). See B<deb-extra-override>(5) for more information on " 16611"its format." 16612msgstr "" 16613 16614#. type: TP 16615#: dpkg-scanpackages.man 16616#, no-wrap 16617msgid "B<-a>, B<--arch> I<arch>" 16618msgstr "" 16619 16620#. type: Plain text 16621#: dpkg-scanpackages.man 16622msgid "" 16623"Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of " 16624"scanning for all debs." 16625msgstr "" 16626 16627#. type: TP 16628#: dpkg-scanpackages.man 16629#, no-wrap 16630msgid "B<-h>, B<--hash> I<hash-list>" 16631msgstr "" 16632 16633#. type: Plain text 16634#: dpkg-scanpackages.man 16635msgid "" 16636"Only generate file hashes for the comma-specified list specified (since dpkg " 16637"1.17.14). The default is to generate all currently supported hashes. " 16638"Supported values: B<md5>, B<sha1>, B<sha256>." 16639msgstr "" 16640 16641#. type: TP 16642#: dpkg-scanpackages.man 16643#, no-wrap 16644msgid "B<-m>, B<--multiversion>" 16645msgstr "" 16646 16647#. type: Plain text 16648#: dpkg-scanpackages.man 16649msgid "Include all found packages in the output." 16650msgstr "" 16651 16652#. type: TP 16653#: dpkg-scanpackages.man 16654#, no-wrap 16655msgid "B<-M>, B<--medium> I<id-string>" 16656msgstr "" 16657 16658#. type: Plain text 16659#: dpkg-scanpackages.man 16660msgid "" 16661"Add an B<X-Medium> field containing the value I<id-string> (since dpkg " 16662"1.15.5). This field is required if you want to generate B<Packages.cd> " 16663"files for use by the multicd access method of dselect." 16664msgstr "" 16665 16666#. type: SH 16667#: dpkg-scanpackages.man dpkg-shlibdeps.man dpkg-source.man 16668#: update-alternatives.man 16669#, no-wrap 16670msgid "DIAGNOSTICS" 16671msgstr "" 16672 16673#. type: Plain text 16674#: dpkg-scanpackages.man 16675msgid "" 16676"B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also " 16677"warns about packages that are in the wrong subdirectory, are duplicated, " 16678"have a Filename field in their control file, are missing from the override " 16679"file, or have maintainer substitutions which do not take effect." 16680msgstr "" 16681 16682#. type: Plain text 16683#: dpkg-scanpackages.man 16684msgid "" 16685"B<dpkg>(1), B<dselect>(1), B<deb-override>(5), B<deb-extra-override>(5), " 16686"B<dpkg-scansources>(1)." 16687msgstr "" 16688 16689#. type: TH 16690#: dpkg-scansources.man 16691#, no-wrap 16692msgid "dpkg-scansources" 16693msgstr "" 16694 16695#. type: Plain text 16696#: dpkg-scansources.man 16697msgid "dpkg-scansources - create Sources index files" 16698msgstr "" 16699 16700#. type: Plain text 16701#: dpkg-scansources.man 16702msgid "" 16703"B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> [I<path-" 16704"prefix>]] B<E<gt>> I<Sources>" 16705msgstr "" 16706 16707#. type: Plain text 16708#: dpkg-scansources.man 16709msgid "" 16710"B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files. These " 16711"are used to create a Debian source index, which is output to stdout." 16712msgstr "" 16713 16714#. type: Plain text 16715#: dpkg-scansources.man 16716msgid "" 16717"The I<override-file>, if given, is used to set priorities in the resulting " 16718"index records and to override the maintainer field given in the I<.dsc> " 16719"files. The file can be compressed (since dpkg 1.15.5). See B<deb-" 16720"override>(5) for the format of this file. Note: Since the override file is " 16721"indexed by binary, not source packages, there's a bit of a problem here. The " 16722"current implementation uses the highest priority of all the binary packages " 16723"produced by a I<.dsc> file for the priority of the source package, and the " 16724"override entry for the first binary package listed in the I<.dsc> file to " 16725"modify maintainer information. This might change." 16726msgstr "" 16727 16728#. type: Plain text 16729#: dpkg-scansources.man 16730msgid "" 16731"The I<path-prefix>, if given, is prepended to the directory field in the " 16732"generated source index. You generally use this to make the directory fields " 16733"contain the path from the top of the Debian archive hierarchy." 16734msgstr "" 16735 16736#. type: Plain text 16737#: dpkg-scansources.man 16738msgid "" 16739"B<Note:> If you want to access the generated Sources file with B<apt>(8) " 16740"you will probably need to compress the file with B<gzip>(1) (generating a " 16741"Sources.gz file). apt ignores uncompressed Sources files except on local " 16742"access (i.e. B<file://> sources)." 16743msgstr "" 16744 16745#. type: IP 16746#: dpkg-scansources.man 16747#, no-wrap 16748msgid "B<-n>, B<--no-sort>" 16749msgstr "" 16750 16751#. type: Plain text 16752#: dpkg-scansources.man 16753msgid "" 16754"Don't sort the index records. Normally they are sorted by source package " 16755"name." 16756msgstr "" 16757 16758#. type: Plain text 16759#: dpkg-scansources.man 16760msgid "" 16761"Scan I<file> to find supplementary overrides (since dpkg 1.15.4; the file " 16762"can be compressed since dpkg 1.15.5). See B<deb-extra-override>(5) for " 16763"more information on its format." 16764msgstr "" 16765 16766#. type: IP 16767#: dpkg-scansources.man 16768#, no-wrap 16769msgid "B<-s>, B<--source-override> I<file>" 16770msgstr "" 16771 16772#. type: Plain text 16773#: dpkg-scansources.man 16774msgid "" 16775"Use I<file> as the source override file (the file can be compressed since " 16776"dpkg 1.15.5). The default is the name of the override file you specified " 16777"with I<.src> appended." 16778msgstr "" 16779 16780#. type: Plain text 16781#: dpkg-scansources.man 16782msgid "" 16783"The source override file is in a different format from the binary override " 16784"file. It contains only two whitespace separated fields, the first is the " 16785"source package name and the second is the section. Blank lines and comment " 16786"lines are ignored in the normal manner. If a package appears in both files " 16787"the source override takes precedence for setting the section." 16788msgstr "" 16789 16790#. type: TP 16791#: dpkg-scansources.man update-alternatives.man 16792#, no-wrap 16793msgid "B<--debug>" 16794msgstr "" 16795 16796#. type: Plain text 16797#: dpkg-scansources.man 16798msgid "Turn debugging on." 16799msgstr "" 16800 16801#. type: Plain text 16802#: dpkg-scansources.man 16803msgid "B<deb-override>(5), B<deb-extra-override>(5), B<dpkg-scanpackages>(1)." 16804msgstr "" 16805 16806#. type: TH 16807#: dpkg-shlibdeps.man 16808#, no-wrap 16809msgid "dpkg-shlibdeps" 16810msgstr "" 16811 16812#. type: Plain text 16813#: dpkg-shlibdeps.man 16814msgid "dpkg-shlibdeps - generate shared library substvar dependencies" 16815msgstr "" 16816 16817#. type: Plain text 16818#: dpkg-shlibdeps.man 16819msgid "B<dpkg-shlibdeps> [I<option>...] [B<-e>]I<executable> [I<option>...]" 16820msgstr "" 16821 16822#. type: Plain text 16823#: dpkg-shlibdeps.man 16824msgid "" 16825"B<dpkg-shlibdeps> calculates shared library dependencies for executables " 16826"named in its arguments. The dependencies are added to the substitution " 16827"variables file B<debian/substvars> as variable names B<shlibs:>I<dependency-" 16828"field> where I<dependency-field> is a dependency field name. Any other " 16829"variables starting with B<shlibs:> are removed from the file." 16830msgstr "" 16831 16832#. type: Plain text 16833#: dpkg-shlibdeps.man 16834msgid "" 16835"B<dpkg-shlibdeps> has two possible sources of information to generate " 16836"dependency information. Either I<symbols> files or I<shlibs> files. For each " 16837"binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries " 16838"that it's linked with. Then, for each library, it looks up either the " 16839"I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if " 16840"debian/shlibs.local contains the relevant dependency). Both files are " 16841"supposed to be provided by the library package and should thus be available " 16842"as %ADMINDIR%/info/I<package>.I<symbols> or %ADMINDIR%/info/I<package>." 16843"I<shlibs>. The package name is identified in two steps: find the library " 16844"file on the system (looking in the same directories that B<ld.so> would " 16845"use), then use B<dpkg -S >I<library-file> to lookup the package providing " 16846"the library." 16847msgstr "" 16848 16849#. type: SS 16850#: dpkg-shlibdeps.man 16851#, no-wrap 16852msgid "Symbols files" 16853msgstr "" 16854 16855#. type: Plain text 16856#: dpkg-shlibdeps.man 16857msgid "" 16858"Symbols files contain finer-grained dependency information by providing the " 16859"minimum dependency for each symbol that the library exports. The script " 16860"tries to find a symbols file associated to a library package in the " 16861"following places (first match is used):" 16862msgstr "" 16863 16864#. type: IP 16865#: dpkg-shlibdeps.man 16866#, no-wrap 16867msgid "debian/*/DEBIAN/symbols" 16868msgstr "" 16869 16870#. type: Plain text 16871#: dpkg-shlibdeps.man 16872msgid "" 16873"Shared library information generated by the current build process that also " 16874"invoked B<dpkg-shlibdeps>. They are generated by B<dpkg-gensymbols>(1). " 16875"They are only used if the library is found in a package's build tree. The " 16876"symbols file in that build tree takes precedence over symbols files from " 16877"other binary packages." 16878msgstr "" 16879 16880#. type: IP 16881#: dpkg-shlibdeps.man 16882#, no-wrap 16883msgid "%PKGCONFDIR%/symbols/I<package>.symbols.I<arch>" 16884msgstr "" 16885 16886#. type: IP 16887#: dpkg-shlibdeps.man 16888#, no-wrap 16889msgid "%PKGCONFDIR%/symbols/I<package>.symbols" 16890msgstr "" 16891 16892#. type: Plain text 16893#: dpkg-shlibdeps.man 16894msgid "" 16895"Per-system overriding shared library dependency information. I<arch> is the " 16896"architecture of the current system (obtained by B<dpkg-architecture -" 16897"qDEB_HOST_ARCH>)." 16898msgstr "" 16899 16900#. type: IP 16901#: dpkg-shlibdeps.man 16902#, no-wrap 16903msgid "Output from “B<dpkg-query --control-path> I<package> symbols”" 16904msgstr "" 16905 16906#. type: Plain text 16907#: dpkg-shlibdeps.man 16908msgid "" 16909"Package-provided shared library dependency information. Unless overridden " 16910"by B<--admindir>, those files are located in %ADMINDIR%." 16911msgstr "" 16912 16913#. type: Plain text 16914#: dpkg-shlibdeps.man 16915msgid "" 16916"While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers " 16917"the (biggest) minimal version needed for each library. At the end of the " 16918"process, it is able to write out the minimal dependency for every library " 16919"used (provided that the information of the I<symbols> files are accurate)." 16920msgstr "" 16921 16922#. type: Plain text 16923#: dpkg-shlibdeps.man 16924msgid "" 16925"As a safe-guard measure, a symbols file can provide a B<Build-Depends-" 16926"Package> meta-information field and B<dpkg-shlibdeps> will extract the " 16927"minimal version required by the corresponding package in the B<Build-" 16928"Depends> field and use this version if it's higher than the minimal version " 16929"computed by scanning symbols." 16930msgstr "" 16931 16932#. type: SS 16933#: dpkg-shlibdeps.man 16934#, no-wrap 16935msgid "Shlibs files" 16936msgstr "" 16937 16938#. type: Plain text 16939#: dpkg-shlibdeps.man 16940msgid "" 16941"Shlibs files associate directly a library to a dependency (without looking " 16942"at the symbols). It's thus often stronger than really needed but very safe " 16943"and easy to handle." 16944msgstr "" 16945 16946#. type: Plain text 16947#: dpkg-shlibdeps.man 16948msgid "" 16949"The dependencies for a library are looked up in several places. The first " 16950"file providing information for the library of interest is used:" 16951msgstr "" 16952 16953#. type: IP 16954#: dpkg-shlibdeps.man 16955#, no-wrap 16956msgid "debian/shlibs.local" 16957msgstr "" 16958 16959#. type: Plain text 16960#: dpkg-shlibdeps.man 16961msgid "Package-local overriding shared library dependency information." 16962msgstr "" 16963 16964#. type: IP 16965#: dpkg-shlibdeps.man 16966#, no-wrap 16967msgid "%PKGCONFDIR%/shlibs.override" 16968msgstr "" 16969 16970#. type: Plain text 16971#: dpkg-shlibdeps.man 16972msgid "Per-system overriding shared library dependency information." 16973msgstr "" 16974 16975#. type: IP 16976#: dpkg-shlibdeps.man 16977#, no-wrap 16978msgid "debian/*/DEBIAN/shlibs" 16979msgstr "" 16980 16981#. type: Plain text 16982#: dpkg-shlibdeps.man 16983msgid "" 16984"Shared library information generated by the current build process that also " 16985"invoked B<dpkg-shlibdeps>. They are only used if the library is found in a " 16986"package's build tree. The shlibs file in that build tree takes precedence " 16987"over shlibs files from other binary packages." 16988msgstr "" 16989 16990#. type: IP 16991#: dpkg-shlibdeps.man 16992#, no-wrap 16993msgid "Output from “B<dpkg-query --control-path> I<package> shlibs”" 16994msgstr "" 16995 16996#. type: IP 16997#: dpkg-shlibdeps.man 16998#, no-wrap 16999msgid "%PKGCONFDIR%/shlibs.default" 17000msgstr "" 17001 17002#. type: Plain text 17003#: dpkg-shlibdeps.man 17004msgid "Per-system default shared library dependency information." 17005msgstr "" 17006 17007#. type: Plain text 17008#: dpkg-shlibdeps.man 17009msgid "" 17010"The extracted dependencies are then directly used (except if they are " 17011"filtered out because they have been identified as duplicate, or as weaker " 17012"than another dependency)." 17013msgstr "" 17014 17015#. type: Plain text 17016#: dpkg-shlibdeps.man 17017msgid "" 17018"B<dpkg-shlibdeps> interprets non-option arguments as executable names, just " 17019"as if they'd been supplied as B<-e>I<executable>." 17020msgstr "" 17021 17022#. type: TP 17023#: dpkg-shlibdeps.man 17024#, no-wrap 17025msgid "B<-e>I<executable>" 17026msgstr "" 17027 17028#. type: Plain text 17029#: dpkg-shlibdeps.man 17030msgid "" 17031"Include dependencies appropriate for the shared libraries required by " 17032"I<executable>. This option can be used multiple times." 17033msgstr "" 17034 17035#. type: Plain text 17036#: dpkg-shlibdeps.man 17037msgid "" 17038"Prepend I<directory> to the list of directories to search for private shared " 17039"libraries (since dpkg 1.17.0). This option can be used multiple times." 17040msgstr "" 17041 17042#. type: TP 17043#: dpkg-shlibdeps.man 17044#, no-wrap 17045msgid "B<-d>I<dependency-field>" 17046msgstr "" 17047 17048#. type: Plain text 17049#: dpkg-shlibdeps.man 17050msgid "" 17051"Add dependencies to be added to the control file dependency field " 17052"I<dependency-field>. (The dependencies for this field are placed in the " 17053"variable B<shlibs:>I<dependency-field>.)" 17054msgstr "" 17055 17056#. type: Plain text 17057#: dpkg-shlibdeps.man 17058msgid "" 17059"The B<-d>I<dependency-field> option takes effect for all executables after " 17060"the option, until the next B<-d>I<dependency-field>. The default " 17061"I<dependency-field> is B<Depends>." 17062msgstr "" 17063 17064#. type: Plain text 17065#: dpkg-shlibdeps.man 17066msgid "" 17067"If the same dependency entry (or set of alternatives) appears in more than " 17068"one of the recognized dependency field names B<Pre-Depends>, B<Depends>, " 17069"B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will " 17070"automatically remove the dependency from all fields except the one " 17071"representing the most important dependencies." 17072msgstr "" 17073 17074#. type: TP 17075#: dpkg-shlibdeps.man 17076#, no-wrap 17077msgid "B<-p>I<varname-prefix>" 17078msgstr "" 17079 17080#. type: Plain text 17081#: dpkg-shlibdeps.man 17082msgid "" 17083"Start substitution variables with I<varname-prefix>B<:> instead of B<shlibs:" 17084">. Likewise, any existing substitution variables starting with I<varname-" 17085"prefix>B<:> (rather than B<shlibs:>) are removed from the substitution " 17086"variables file." 17087msgstr "" 17088 17089#. type: Plain text 17090#: dpkg-shlibdeps.man 17091msgid "" 17092"Print substitution variable settings to standard output (or I<filename> if " 17093"specified, since dpkg 1.17.2), rather than being added to the substitution " 17094"variables file (B<debian/substvars> by default)." 17095msgstr "" 17096 17097#. type: TP 17098#: dpkg-shlibdeps.man 17099#, no-wrap 17100msgid "B<-t>I<type>" 17101msgstr "" 17102 17103#. type: Plain text 17104#: dpkg-shlibdeps.man 17105msgid "" 17106"Prefer shared library dependency information tagged for the given package " 17107"type. If no tagged information is available, falls back to untagged " 17108"information. The default package type is B<deb>. Shared library dependency " 17109"information is tagged for a given type by prefixing it with the name of the " 17110"type, a colon, and whitespace." 17111msgstr "" 17112 17113#. type: TP 17114#: dpkg-shlibdeps.man 17115#, no-wrap 17116msgid "B<-L>I<local-shlibs-file>" 17117msgstr "" 17118 17119#. type: Plain text 17120#: dpkg-shlibdeps.man 17121msgid "" 17122"Read overriding shared library dependency information from I<local-shlibs-" 17123"file> instead of B<debian/shlibs.local>." 17124msgstr "" 17125 17126#. type: Plain text 17127#: dpkg-shlibdeps.man 17128msgid "" 17129"Write substitution variables in I<substvars-file>; the default is B<debian/" 17130"substvars>." 17131msgstr "" 17132 17133#. type: TP 17134#: dpkg-shlibdeps.man 17135#, no-wrap 17136msgid "B<-v>" 17137msgstr "" 17138 17139#. type: Plain text 17140#: dpkg-shlibdeps.man 17141msgid "" 17142"Enable verbose mode (since dpkg 1.14.8). Numerous messages are displayed to " 17143"explain what B<dpkg-shlibdeps> does." 17144msgstr "" 17145 17146#. type: TP 17147#: dpkg-shlibdeps.man 17148#, no-wrap 17149msgid "B<-x>I<package>" 17150msgstr "" 17151 17152#. type: Plain text 17153#: dpkg-shlibdeps.man 17154msgid "" 17155"Exclude the package from the generated dependencies (since dpkg 1.14.8). " 17156"This is useful to avoid self-dependencies for packages which provide ELF " 17157"binaries (executables or library plugins) using a library contained in the " 17158"same package. This option can be used multiple times to exclude several " 17159"packages." 17160msgstr "" 17161 17162#. type: TP 17163#: dpkg-shlibdeps.man 17164#, no-wrap 17165msgid "B<-S>I<package-build-dir>" 17166msgstr "" 17167 17168#. type: Plain text 17169#: dpkg-shlibdeps.man 17170msgid "" 17171"Look into I<package-build-dir> first when trying to find a library (since " 17172"dpkg 1.14.15). This is useful when the source package builds multiple " 17173"flavors of the same library and you want to ensure that you get the " 17174"dependency from a given binary package. You can use this option multiple " 17175"times: directories will be tried in the same order before directories of " 17176"other binary packages." 17177msgstr "" 17178 17179#. type: TP 17180#: dpkg-shlibdeps.man 17181#, fuzzy, no-wrap 17182#| msgid "B<--unpack >I<package-file>..." 17183msgid "B<-I>I<package-build-dir>" 17184msgstr "B<--unpack >I<package-file>..." 17185 17186#. type: Plain text 17187#: dpkg-shlibdeps.man 17188msgid "" 17189"Ignore I<package-build-dir> when looking for shlibs, symbols, and shared " 17190"library files (since dpkg 1.18.5). You can use this option multiple times." 17191msgstr "" 17192 17193#. type: TP 17194#: dpkg-shlibdeps.man 17195#, no-wrap 17196msgid "B<--ignore-missing-info>" 17197msgstr "" 17198 17199#. type: Plain text 17200#: dpkg-shlibdeps.man 17201msgid "" 17202"Do not fail if dependency information can't be found for a shared library " 17203"(since dpkg 1.14.8). Usage of this option is discouraged, all libraries " 17204"should provide dependency information (either with shlibs files, or with " 17205"symbols files) even if they are not yet used by other packages." 17206msgstr "" 17207 17208#. type: TP 17209#: dpkg-shlibdeps.man 17210#, no-wrap 17211msgid "B<--warnings=>I<value>" 17212msgstr "" 17213 17214#. type: Plain text 17215#: dpkg-shlibdeps.man 17216msgid "" 17217"I<value> is a bit field defining the set of warnings that can be emitted by " 17218"B<dpkg-shlibdeps> (since dpkg 1.14.17). Bit 0 (value=1) enables the warning " 17219"“symbol I<sym> used by I<binary> found in none of the libraries”, bit 1 " 17220"(value=2) enables the warning “package could avoid a useless dependency” and " 17221"bit 2 (value=4) enables the warning “I<binary> should not be linked against " 17222"I<library>”. The default I<value> is 3: the first two warnings are active " 17223"by default, the last one is not. Set I<value> to 7 if you want all warnings " 17224"to be active." 17225msgstr "" 17226 17227#. type: SS 17228#: dpkg-shlibdeps.man 17229#, no-wrap 17230msgid "Warnings" 17231msgstr "警告" 17232 17233#. type: Plain text 17234#: dpkg-shlibdeps.man 17235msgid "" 17236"Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of " 17237"the generated package, it is able to emit warnings in several cases. They " 17238"inform you of things that can be improved in the package. In most cases, " 17239"those improvements concern the upstream sources directly. By order of " 17240"decreasing importance, here are the various warnings that you can encounter:" 17241msgstr "" 17242 17243#. type: TP 17244#: dpkg-shlibdeps.man 17245#, no-wrap 17246msgid "B<symbol>I< sym>B< used by >I<binary>B< found in none of the libraries.>" 17247msgstr "" 17248 17249#. type: Plain text 17250#: dpkg-shlibdeps.man 17251msgid "" 17252"The indicated symbol has not been found in the libraries linked with the " 17253"binary. The I<binary> is most likely a library and it needs to be linked " 17254"with an additional library during the build process (option B<-l>I<library> " 17255"of the linker)." 17256msgstr "" 17257 17258#. type: TP 17259#: dpkg-shlibdeps.man 17260#, no-wrap 17261msgid "I<binary>B< contains an unresolvable reference to symbol >I<sym>B<: it's probably a plugin>" 17262msgstr "" 17263 17264#. type: Plain text 17265#: dpkg-shlibdeps.man 17266msgid "" 17267"The indicated symbol has not been found in the libraries linked with the " 17268"binary. The I<binary> is most likely a plugin and the symbol is probably " 17269"provided by the program that loads this plugin. In theory a plugin doesn't " 17270"have any SONAME but this binary does have one and as such it could not be " 17271"clearly identified as such. However the fact that the binary is stored in a " 17272"non-public directory is a strong indication that's it's not a normal shared " 17273"library. If the binary is really a plugin, then disregard this warning. But " 17274"there's always the possibility that it's a real library and that programs " 17275"linking to it are using an RPATH so that the dynamic loader finds it. In " 17276"that case, the library is broken and needs to be fixed." 17277msgstr "" 17278 17279#. type: TP 17280#: dpkg-shlibdeps.man 17281#, no-wrap 17282msgid "B<package could avoid a useless dependency if >I<binary>B< was not linked against >I<library>B< (it uses none of the library's symbols)>" 17283msgstr "" 17284 17285#. type: Plain text 17286#: dpkg-shlibdeps.man 17287msgid "" 17288"None of the I<binaries> that are linked with I<library> use any of the " 17289"symbols provided by the library. By fixing all the binaries, you would avoid " 17290"the dependency associated to this library (unless the same dependency is " 17291"also generated by another library that is really used)." 17292msgstr "" 17293 17294#. type: TP 17295#: dpkg-shlibdeps.man 17296#, no-wrap 17297msgid "B<package could avoid a useless dependency if >I<binaries>B< were not linked against >I<library>B< (they use none of the library's symbols)>" 17298msgstr "" 17299 17300#. type: Plain text 17301#: dpkg-shlibdeps.man 17302msgid "Exactly the same as the above warning, but for multiple binaries." 17303msgstr "" 17304 17305#. type: TP 17306#: dpkg-shlibdeps.man 17307#, no-wrap 17308msgid "I<binary>B< should not be linked against >I<library>B< (it uses none of the library's symbols)>" 17309msgstr "" 17310 17311#. type: Plain text 17312#: dpkg-shlibdeps.man 17313msgid "" 17314"The I<binary> is linked to a library that it doesn't need. It's not a " 17315"problem but some small performance improvements in binary load time can be " 17316"obtained by not linking this library to this binary. This warning checks the " 17317"same information as the previous one but does it for each binary instead of " 17318"doing the check globally on all binaries analyzed." 17319msgstr "" 17320 17321#. type: SS 17322#: dpkg-shlibdeps.man 17323#, no-wrap 17324msgid "Errors" 17325msgstr "错误" 17326 17327#. type: Plain text 17328#: dpkg-shlibdeps.man 17329msgid "" 17330"B<dpkg-shlibdeps> will fail if it can't find a public library used by a " 17331"binary or if this library has no associated dependency information (either " 17332"shlibs file or symbols file). A public library has a SONAME and is versioned " 17333"(libsomething.so.I<X>). A private library (like a plugin) should not have a " 17334"SONAME and doesn't need to be versioned." 17335msgstr "" 17336 17337#. type: TP 17338#: dpkg-shlibdeps.man 17339#, no-wrap 17340msgid "B<couldn't find library >I<library-soname>B< needed by >I<binary>B< (its RPATH is '>I<rpath>B<')>" 17341msgstr "" 17342 17343#. type: Plain text 17344#: dpkg-shlibdeps.man 17345msgid "" 17346"The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> " 17347"has been unable to find the library. B<dpkg-shlibdeps> creates a list of " 17348"directories to check as following: directories listed in the RPATH of the " 17349"binary, directories added by the B<-l> option, directories listed in the " 17350"B<LD_LIBRARY_PATH> environment variable, cross multiarch directories (ex. /" 17351"lib/arm64-linux-gnu, /usr/lib/arm64-linux-gnu), standard public directories " 17352"(/lib, /usr/lib), directories listed in /etc/ld.so.conf, and obsolete " 17353"multilib directories (/lib32, /usr/lib32, /lib64, /usr/lib64). Then it " 17354"checks those directories in the package's build tree of the binary being " 17355"analyzed, in the packages' build trees indicated with the B<-S> command-line " 17356"option, in other packages' build trees that contains a DEBIAN/shlibs or " 17357"DEBIAN/symbols file and finally in the root directory. If the library is " 17358"not found in any of those directories, then you get this error." 17359msgstr "" 17360 17361#. type: Plain text 17362#: dpkg-shlibdeps.man 17363msgid "" 17364"If the library not found is in a private directory of the same package, then " 17365"you want to add the directory with B<-l>. If it's in another binary package " 17366"being built, you want to make sure that the shlibs/symbols file of this " 17367"package is already created and that B<-l> contains the appropriate directory " 17368"if it also is in a private directory." 17369msgstr "" 17370 17371#. type: TP 17372#: dpkg-shlibdeps.man 17373#, no-wrap 17374msgid "B<no dependency information found for >I<library-file>B< (used by >I<binary>B<).>" 17375msgstr "" 17376 17377#. type: Plain text 17378#: dpkg-shlibdeps.man 17379msgid "" 17380"The library needed by I<binary> has been found by B<dpkg-shlibdeps> in " 17381"I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency " 17382"information for that library. To find out the dependency, it has tried to " 17383"map the library to a Debian package with the help of B<dpkg -S >I<library-" 17384"file>. Then it checked the corresponding shlibs and symbols files in " 17385"%ADMINDIR%/info/, and in the various package's build trees (debian/*/" 17386"DEBIAN/)." 17387msgstr "" 17388 17389#. type: Plain text 17390#: dpkg-shlibdeps.man 17391msgid "" 17392"This failure can be caused by a bad or missing shlibs or symbols file in the " 17393"package of the library. It might also happen if the library is built within " 17394"the same source package and if the shlibs files has not yet been created (in " 17395"which case you must fix debian/rules to create the shlibs before calling " 17396"B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under " 17397"a non-canonical name (example: /usr/lib/openoffice.org/../lib/libssl." 17398"so.0.9.8 instead of /usr/lib/libssl.so.0.9.8) that's not associated to any " 17399"package, B<dpkg-shlibdeps> tries to work around this by trying to fallback " 17400"on a canonical name (using B<realpath>(3)) but it might not always work. " 17401"It's always best to clean up the RPATH of the binary to avoid problems." 17402msgstr "" 17403 17404#. type: Plain text 17405#: dpkg-shlibdeps.man 17406msgid "" 17407"Calling B<dpkg-shlibdeps> in verbose mode (B<-v>) will provide much more " 17408"information about where it tried to find the dependency information. This " 17409"might be useful if you don't understand why it's giving you this error." 17410msgstr "" 17411 17412#. type: Plain text 17413#: dpkg-shlibdeps.man 17414msgid "B<deb-shlibs>(5), B<deb-symbols>(5), B<dpkg-gensymbols>(1)." 17415msgstr "" 17416 17417#. type: TH 17418#: dpkg-source.man 17419#, no-wrap 17420msgid "dpkg-source" 17421msgstr "dpkg-source" 17422 17423#. type: Plain text 17424#: dpkg-source.man 17425msgid "dpkg-source - Debian source package (.dsc) manipulation tool" 17426msgstr "" 17427 17428#. type: Plain text 17429#: dpkg-source.man 17430msgid "B<dpkg-source> [I<option>...] I<command>" 17431msgstr "" 17432 17433#. type: Plain text 17434#: dpkg-source.man 17435msgid "B<dpkg-source> packs and unpacks Debian source archives." 17436msgstr "" 17437 17438#. type: Plain text 17439#: dpkg-source.man 17440msgid "" 17441"None of these commands allow multiple options to be combined into one, and " 17442"they do not allow the value for an option to be specified in a separate " 17443"argument." 17444msgstr "" 17445 17446#. type: TP 17447#: dpkg-source.man 17448#, no-wrap 17449msgid "B<-x>, B<--extract> I<filename>.dsc [I<output-directory>]" 17450msgstr "" 17451 17452#. type: Plain text 17453#: dpkg-source.man 17454msgid "" 17455"Extract a source package (B<--extract> since dpkg 1.17.14). One non-option " 17456"argument must be supplied, the name of the Debian source control file (B<." 17457"dsc>). An optional second non-option argument may be supplied to specify " 17458"the directory to extract the source package to, this must not exist. If no " 17459"output directory is specified, the source package is extracted into a " 17460"directory named I<source>-I<version> under the current working directory." 17461msgstr "" 17462 17463#. type: Plain text 17464#: dpkg-source.man 17465msgid "" 17466"B<dpkg-source> will read the names of the other file(s) making up the source " 17467"package from the control file; they are assumed to be in the same directory " 17468"as the B<.dsc>." 17469msgstr "" 17470 17471#. type: Plain text 17472#: dpkg-source.man 17473msgid "" 17474"The files in the extracted package will have their permissions and " 17475"ownerships set to those which would have been expected if the files and " 17476"directories had simply been created - directories and executable files will " 17477"be 0777 and plain files will be 0666, both modified by the extractors' " 17478"umask; if the parent directory is setgid then the extracted directories will " 17479"be too, and all the files and directories will inherit its group ownership." 17480msgstr "" 17481 17482#. type: Plain text 17483#: dpkg-source.man 17484msgid "" 17485"If the source package uses a non-standard format (currently this means all " 17486"formats except “1.0”), its name will be stored in B<debian/source/format> so " 17487"that the following builds of the source package use the same format by " 17488"default." 17489msgstr "" 17490 17491#. type: TP 17492#: dpkg-source.man 17493#, no-wrap 17494msgid "B<-b>, B<--build> I<directory> [I<format-specific-parameters>]" 17495msgstr "" 17496 17497#. type: Plain text 17498#: dpkg-source.man 17499msgid "" 17500"Build a source package (B<--build> since dpkg 1.17.14). The first non-" 17501"option argument is taken as the name of the directory containing the " 17502"debianized source tree (i.e. with a debian sub-directory and maybe changes " 17503"to the original files). Depending on the source package format used to " 17504"build the package, additional parameters might be accepted." 17505msgstr "" 17506 17507#. type: Plain text 17508#: dpkg-source.man 17509msgid "" 17510"B<dpkg-source> will build the source package with the first format found in " 17511"this ordered list: the format indicated with the I<--format> command line " 17512"option, the format indicated in B<debian/source/format>, “1.0”. The " 17513"fallback to “1.0” is deprecated and will be removed at some point in the " 17514"future, you should always document the desired source format in B<debian/" 17515"source/format>. See section B<SOURCE PACKAGE FORMATS> for an extensive " 17516"description of the various source package formats." 17517msgstr "" 17518 17519#. type: TP 17520#: dpkg-source.man 17521#, no-wrap 17522msgid "B<--print-format> I<directory>" 17523msgstr "" 17524 17525#. type: Plain text 17526#: dpkg-source.man 17527msgid "" 17528"Print the source format that would be used to build the source package if " 17529"B<dpkg-source --build >I<directory> was called (in the same conditions and " 17530"with the same parameters; since dpkg 1.15.5)." 17531msgstr "" 17532 17533#. type: TP 17534#: dpkg-source.man 17535#, no-wrap 17536msgid "B<--before-build> I<directory>" 17537msgstr "" 17538 17539#. type: Plain text 17540#: dpkg-source.man 17541msgid "" 17542"Run the corresponding hook of the source package format (since dpkg " 17543"1.15.8). This hook is called before any build of the package (B<dpkg-" 17544"buildpackage> calls it very early even before B<debian/rules clean>). This " 17545"command is idempotent and can be called multiple times. Not all source " 17546"formats implement something in this hook, and those that do usually prepare " 17547"the source tree for the build for example by ensuring that the Debian " 17548"patches are applied." 17549msgstr "" 17550 17551#. type: TP 17552#: dpkg-source.man 17553#, no-wrap 17554msgid "B<--after-build> I<directory>" 17555msgstr "" 17556 17557#. type: Plain text 17558#: dpkg-source.man 17559msgid "" 17560"Run the corresponding hook of the source package format (since dpkg " 17561"1.15.8). This hook is called after any build of the package (B<dpkg-" 17562"buildpackage> calls it last). This command is idempotent and can be called " 17563"multiple times. Not all source formats implement something in this hook, and " 17564"those that do usually use it to undo what B<--before-build> has done." 17565msgstr "" 17566 17567#. type: TP 17568#: dpkg-source.man 17569#, no-wrap 17570msgid "B<--commit> [I<directory>] ..." 17571msgstr "" 17572 17573#. type: Plain text 17574#: dpkg-source.man 17575msgid "" 17576"Record changes in the source tree unpacked in I<directory> (since dpkg " 17577"1.16.1). This command can take supplementary parameters depending on the " 17578"source format. It will error out for formats where this operation doesn't " 17579"mean anything." 17580msgstr "" 17581 17582#. type: Plain text 17583#: dpkg-source.man 17584msgid "" 17585"Show the usage message and exit. The format specific build and extract " 17586"options can be shown by using the B<--format> option." 17587msgstr "" 17588 17589#. type: SS 17590#: dpkg-source.man 17591#, no-wrap 17592msgid "Generic build options" 17593msgstr "" 17594 17595#. type: Plain text 17596#: dpkg-source.man 17597msgid "" 17598"Specifies the main source control file to read information from. The default " 17599"is B<debian/control>. If given with relative pathname this is interpreted " 17600"starting at the source tree's top level directory." 17601msgstr "" 17602 17603#. type: Plain text 17604#: dpkg-source.man 17605msgid "" 17606"Specifies the changelog file to read information from. The default is " 17607"B<debian/changelog>. If given with relative pathname this is interpreted " 17608"starting at the source tree's top level directory." 17609msgstr "" 17610 17611#. type: TP 17612#: dpkg-source.man 17613#, no-wrap 17614msgid "B<--format=>I<value>" 17615msgstr "" 17616 17617#. type: Plain text 17618#: dpkg-source.man 17619msgid "" 17620"Use the given format for building the source package (since dpkg 1.14.17). " 17621"It does override any format given in B<debian/source/format>." 17622msgstr "" 17623 17624#. type: Plain text 17625#: dpkg-source.man 17626msgid "" 17627"Read substitution variables in I<substvars-file>; the default is to not read " 17628"any file. This option can be used multiple times to read substitution " 17629"variables from multiple files (since dpkg 1.15.6)." 17630msgstr "" 17631 17632#. type: TP 17633#: dpkg-source.man 17634#, no-wrap 17635msgid "B<-Z>I<compression>, B<--compression>=I<compression>" 17636msgstr "" 17637 17638#. type: Plain text 17639#: dpkg-source.man 17640msgid "" 17641"Specify the compression to use for created tarballs and diff files (B<--" 17642"compression> since dpkg 1.15.5). Note that this option will not cause " 17643"existing tarballs to be recompressed, it only affects new files. Supported " 17644"values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>. The default is I<xz> for " 17645"formats 2.0 and newer, and I<gzip> for format 1.0. I<xz> is only supported " 17646"since dpkg 1.15.5." 17647msgstr "" 17648 17649#. type: TP 17650#: dpkg-source.man 17651#, no-wrap 17652msgid "B<-z>I<level>, B<--compression-level>=I<level>" 17653msgstr "" 17654 17655#. type: Plain text 17656#: dpkg-source.man 17657msgid "" 17658"Compression level to use (B<--compression-level> since dpkg 1.15.5). As " 17659"with B<-Z> it only affects newly created files. Supported values are: I<1> " 17660"to I<9>, I<best>, and I<fast>. The default is I<9> for gzip and bzip2, I<6> " 17661"for xz and lzma." 17662msgstr "" 17663 17664#. type: TP 17665#: dpkg-source.man 17666#, no-wrap 17667msgid "B<-i>[I<regex>], B<--diff-ignore>[=I<regex>]" 17668msgstr "" 17669 17670#. type: Plain text 17671#: dpkg-source.man 17672msgid "" 17673"You may specify a perl regular expression to match files you want filtered " 17674"out of the list of files for the diff (B<--diff-ignore> since dpkg 1.15.6). " 17675"(This list is generated by a find command.) (If the source package is being " 17676"built as a version 3 source package using a VCS, this can be used to ignore " 17677"uncommitted changes on specific files. Using -i.* will ignore all of them.)" 17678msgstr "" 17679 17680#. type: Plain text 17681#: dpkg-source.man 17682msgid "" 17683"The B<-i> option by itself enables this setting with a default regex " 17684"(preserving any modification to the default regex done by a previous use of " 17685"B<--extend-diff-ignore>) that will filter out control files and directories " 17686"of the most common revision control systems, backup and swap files and " 17687"Libtool build output directories. There can only be one active regex, of " 17688"multiple B<-i> options only the last one will take effect." 17689msgstr "" 17690 17691#. type: Plain text 17692#: dpkg-source.man 17693msgid "" 17694"This is very helpful in cutting out extraneous files that get included in " 17695"the diff, e.g. if you maintain your source in a revision control system and " 17696"want to use a checkout to build a source package without including the " 17697"additional files and directories that it will usually contain (e.g. CVS/, ." 17698"cvsignore, .svn/). The default regex is already very exhaustive, but if you " 17699"need to replace it, please note that by default it can match any part of a " 17700"path, so if you want to match the begin of a filename or only full " 17701"filenames, you will need to provide the necessary anchors (e.g. ‘(^|/)’, " 17702"‘($|/)’) yourself." 17703msgstr "" 17704 17705#. type: TP 17706#: dpkg-source.man 17707#, no-wrap 17708msgid "B<--extend-diff-ignore>=I<regex>" 17709msgstr "" 17710 17711#. type: Plain text 17712#: dpkg-source.man 17713msgid "" 17714"The perl regular expression specified will extend the default value used by " 17715"B<--diff-ignore> and its current value, if set (since dpkg 1.15.6). It does " 17716"this by concatenating “B<|>I<regex>” to the existing value. This option is " 17717"convenient to use in B<debian/source/options> to exclude some auto-generated " 17718"files from the automatic patch generation." 17719msgstr "" 17720 17721#. type: TP 17722#: dpkg-source.man 17723#, no-wrap 17724msgid "B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]" 17725msgstr "" 17726 17727#. type: Plain text 17728#: dpkg-source.man 17729msgid "" 17730"If this option is specified, the pattern will be passed to B<tar>(1)'s B<--" 17731"exclude> option when it is called to generate a .orig.tar or .tar file (B<--" 17732"tar-ignore> since dpkg 1.15.6). For example, B<-I>CVS will make tar skip " 17733"over CVS directories when generating a .tar.gz file. The option may be " 17734"repeated multiple times to list multiple patterns to exclude." 17735msgstr "" 17736 17737#. type: Plain text 17738#: dpkg-source.man 17739msgid "" 17740"B<-I> by itself adds default B<--exclude> options that will filter out " 17741"control files and directories of the most common revision control systems, " 17742"backup and swap files and Libtool build output directories." 17743msgstr "" 17744 17745#. type: Plain text 17746#: dpkg-source.man 17747msgid "" 17748"B<Note:> While they have similar purposes, B<-i> and B<-I> have very " 17749"different syntax and semantics. B<-i> can only be specified once and takes a " 17750"perl compatible regular expression which is matched against the full " 17751"relative path of each file. B<-I> can specified multiple times and takes a " 17752"filename pattern with shell wildcards. The pattern is applied to the full " 17753"relative path but also to each part of the path individually. The exact " 17754"semantic of tar's B<--exclude> option is somewhat complicated, see https://" 17755"www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation." 17756msgstr "" 17757 17758#. type: Plain text 17759#: dpkg-source.man 17760msgid "" 17761"The default regex and patterns for both options can be seen in the output of " 17762"the B<--help> command." 17763msgstr "" 17764 17765#. type: SS 17766#: dpkg-source.man 17767#, no-wrap 17768msgid "Generic extract options" 17769msgstr "" 17770 17771#. type: TP 17772#: dpkg-source.man 17773#, no-wrap 17774msgid "B<--no-copy>" 17775msgstr "" 17776 17777#. type: Plain text 17778#: dpkg-source.man 17779msgid "" 17780"Do not copy original tarballs near the extracted source package (since dpkg " 17781"1.14.17)." 17782msgstr "" 17783 17784#. type: TP 17785#: dpkg-source.man 17786#, no-wrap 17787msgid "B<--no-check>" 17788msgstr "" 17789 17790#. type: Plain text 17791#: dpkg-source.man 17792msgid "" 17793"Do not check signatures and checksums before unpacking (since dpkg 1.14.17)." 17794msgstr "" 17795 17796#. type: TP 17797#: dpkg-source.man 17798#, no-wrap 17799msgid "B<--no-overwrite-dir>" 17800msgstr "" 17801 17802#. type: Plain text 17803#: dpkg-source.man 17804msgid "" 17805"Do not overwrite the extraction directory if it already exists (since dpkg " 17806"1.18.8)." 17807msgstr "" 17808 17809#. type: TP 17810#: dpkg-source.man 17811#, no-wrap 17812msgid "B<--require-valid-signature>" 17813msgstr "" 17814 17815#. type: Plain text 17816#: dpkg-source.man 17817msgid "" 17818"Refuse to unpack the source package if it doesn't contain an OpenPGP " 17819"signature that can be verified (since dpkg 1.15.0) either with the user's " 17820"I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of " 17821"the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg> and " 17822"I</usr/share/keyrings/debian-maintainers.gpg>)." 17823msgstr "" 17824 17825#. type: TP 17826#: dpkg-source.man 17827#, no-wrap 17828msgid "B<--require-strong-checksums>" 17829msgstr "" 17830 17831#. type: Plain text 17832#: dpkg-source.man 17833msgid "" 17834"Refuse to unpack the source package if it does not contain any strong " 17835"checksums (since dpkg 1.18.7). Currently the only known checksum considered " 17836"strong is B<SHA-256>." 17837msgstr "" 17838 17839#. type: TP 17840#: dpkg-source.man 17841#, no-wrap 17842msgid "B<--ignore-bad-version>" 17843msgstr "" 17844 17845#. type: Plain text 17846#: dpkg-source.man 17847msgid "" 17848"Turns the bad source package version check into a non-fatal warning (since " 17849"dpkg 1.17.7). This option should only be necessary when extracting ancient " 17850"source packages with broken versions, just for backwards compatibility." 17851msgstr "" 17852 17853#. type: SH 17854#: dpkg-source.man 17855#, no-wrap 17856msgid "SOURCE PACKAGE FORMATS" 17857msgstr "" 17858 17859#. type: Plain text 17860#: dpkg-source.man 17861msgid "" 17862"If you don't know what source format to use, you should probably pick either " 17863"“3.0 (quilt)” or “3.0 (native)”. See https://wiki.debian.org/Projects/" 17864"DebSrc3.0 for information on the deployment of those formats within Debian." 17865msgstr "" 17866 17867#. type: SS 17868#: dpkg-source.man 17869#, no-wrap 17870msgid "Format: 1.0" 17871msgstr "" 17872 17873#. type: Plain text 17874#: dpkg-source.man 17875msgid "" 17876"A source package in this format consists either of a B<.orig.tar.gz> " 17877"associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package " 17878"is said to be I<native>). Optionally the original tarball might be " 17879"accompanied by a detached upstream signature B<.orig.tar.gz.asc>, extraction " 17880"supported since dpkg 1.18.5." 17881msgstr "" 17882 17883#. type: Plain text 17884#: dpkg-source.man 17885msgid "B<Extracting>" 17886msgstr "" 17887 17888#. type: Plain text 17889#: dpkg-source.man 17890msgid "" 17891"Extracting a native package is a simple extraction of the single tarball in " 17892"the target directory. Extracting a non-native package is done by first " 17893"unpacking the B<.orig.tar.gz> and then applying the patch contained in the " 17894"B<.diff.gz> file. The timestamp of all patched files is reset to the " 17895"extraction time of the source package (this avoids timestamp skews leading " 17896"to problems when autogenerated files are patched). The diff can create new " 17897"files (the whole debian directory is created that way) but can't remove " 17898"files (empty files will be left over)." 17899msgstr "" 17900 17901#. type: Plain text 17902#: dpkg-source.man 17903msgid "B<Building>" 17904msgstr "" 17905 17906#. type: Plain text 17907#: dpkg-source.man 17908msgid "" 17909"Building a native package is just creating a single tarball with the source " 17910"directory. Building a non-native package involves extracting the original " 17911"tarball in a separate “.orig” directory and regenerating the B<.diff.gz> by " 17912"comparing the source package I<directory> with the .orig directory." 17913msgstr "" 17914 17915#. type: Plain text 17916#: dpkg-source.man 17917msgid "B<Build options (with --build):>" 17918msgstr "" 17919 17920#. type: Plain text 17921#: dpkg-source.man 17922msgid "" 17923"If a second non-option argument is supplied it should be the name of the " 17924"original source directory or tarfile or the empty string if the package is a " 17925"Debian-specific one and so has no debianization diffs. If no second argument " 17926"is supplied then B<dpkg-source> will look for the original source tarfile " 17927"I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source " 17928"directory I<directory>B<.orig> depending on the B<-sX> arguments." 17929msgstr "" 17930 17931#. type: Plain text 17932#: dpkg-source.man 17933msgid "" 17934"B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing " 17935"tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, B<-" 17936"sU> and B<-sR> should be used instead." 17937msgstr "" 17938 17939#. type: Plain text 17940#: dpkg-source.man 17941msgid "" 17942"Specifies to expect the original source as a tarfile, by default " 17943"I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>. It will leave " 17944"this original source in place as a tarfile, or copy it to the current " 17945"directory if it isn't already there. The tarball will be unpacked into " 17946"I<directory>B<.orig> for the generation of the diff." 17947msgstr "" 17948 17949#. type: TP 17950#: dpkg-source.man 17951#, no-wrap 17952msgid "B<-sp>" 17953msgstr "" 17954 17955#. type: Plain text 17956#: dpkg-source.man 17957msgid "Like B<-sk> but will remove the directory again afterwards." 17958msgstr "" 17959 17960#. type: Plain text 17961#: dpkg-source.man 17962msgid "" 17963"Specifies that the original source is expected as a directory, by default " 17964"I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a " 17965"new original source archive from it." 17966msgstr "" 17967 17968#. type: Plain text 17969#: dpkg-source.man 17970msgid "Like B<-su> but will remove that directory after it has been used." 17971msgstr "" 17972 17973#. type: Plain text 17974#: dpkg-source.man 17975msgid "" 17976"Specifies that the original source is available both as a directory and as a " 17977"tarfile. B<dpkg-source> will use the directory to create the diff, but the " 17978"tarfile to create the B<.dsc>. This option must be used with care - if the " 17979"directory and tarfile do not match a bad source archive will be generated." 17980msgstr "" 17981 17982#. type: Plain text 17983#: dpkg-source.man 17984msgid "" 17985"Specifies to not look for any original source, and to not generate a diff. " 17986"The second argument, if supplied, must be the empty string. This is used for " 17987"Debian-specific packages which do not have a separate upstream source and " 17988"therefore have no debianization diffs." 17989msgstr "" 17990 17991#. type: TP 17992#: dpkg-source.man 17993#, no-wrap 17994msgid "B<-sa> or B<-sA>" 17995msgstr "" 17996 17997#. type: Plain text 17998#: dpkg-source.man 17999msgid "" 18000"Specifies to look for the original source archive as a tarfile or as a " 18001"directory - the second argument, if any, may be either, or the empty string " 18002"(this is equivalent to using B<-sn>). If a tarfile is found it will unpack " 18003"it to create the diff and remove it afterwards (this is equivalent to B<-" 18004"sp>); if a directory is found it will pack it to create the original source " 18005"and remove it afterwards (this is equivalent to B<-sr>); if neither is found " 18006"it will assume that the package has no debianization diffs, only a " 18007"straightforward source archive (this is equivalent to B<-sn>). If both are " 18008"found then B<dpkg-source> will ignore the directory, overwriting it, if B<-" 18009"sA> was specified (this is equivalent to B<-sP>) or raise an error if B<-" 18010"sa> was specified. B<-sa> is the default." 18011msgstr "" 18012 18013#. type: TP 18014#: dpkg-source.man 18015#, no-wrap 18016msgid "B<--abort-on-upstream-changes>" 18017msgstr "" 18018 18019#. type: Plain text 18020#: dpkg-source.man 18021msgid "" 18022"The process fails if the generated diff contains changes to files outside of " 18023"the debian sub-directory (since dpkg 1.15.8). This option is not allowed in " 18024"B<debian/source/options> but can be used in B<debian/source/local-options>." 18025msgstr "" 18026 18027#. type: Plain text 18028#: dpkg-source.man 18029msgid "B<Extract options (with --extract):>" 18030msgstr "" 18031 18032#. type: Plain text 18033#: dpkg-source.man 18034msgid "In all cases any existing original source tree will be removed." 18035msgstr "" 18036 18037#. type: Plain text 18038#: dpkg-source.man 18039msgid "" 18040"Used when extracting then the original source (if any) will be left as a " 18041"tarfile. If it is not already located in the current directory or if an " 18042"existing but different file is there it will be copied there. (B<This is " 18043"the default>)." 18044msgstr "" 18045 18046#. type: Plain text 18047#: dpkg-source.man 18048msgid "Unpacks the original source tree." 18049msgstr "" 18050 18051#. type: Plain text 18052#: dpkg-source.man 18053msgid "" 18054"Ensures that the original source is neither copied to the current directory " 18055"nor unpacked. Any original source tree that was in the current directory is " 18056"still removed." 18057msgstr "" 18058 18059#. type: Plain text 18060#: dpkg-source.man 18061msgid "" 18062"All the B<-s>I<X> options are mutually exclusive. If you specify more than " 18063"one only the last one will be used." 18064msgstr "" 18065 18066#. type: TP 18067#: dpkg-source.man 18068#, no-wrap 18069msgid "B<--skip-debianization>" 18070msgstr "" 18071 18072#. type: Plain text 18073#: dpkg-source.man 18074msgid "" 18075"Skips application of the debian diff on top of the upstream sources (since " 18076"dpkg 1.15.1)." 18077msgstr "" 18078 18079#. type: SS 18080#: dpkg-source.man 18081#, no-wrap 18082msgid "Format: 2.0" 18083msgstr "" 18084 18085#. type: Plain text 18086#: dpkg-source.man 18087msgid "" 18088"Extraction supported since dpkg 1.13.9, building supported since dpkg " 18089"1.14.8. Also known as wig&pen. This format is not recommended for wide-" 18090"spread usage, the format “3.0 (quilt)” replaces it. Wig&pen was the first " 18091"specification of a new-generation source package format." 18092msgstr "" 18093 18094#. type: Plain text 18095#: dpkg-source.man 18096msgid "" 18097"The behaviour of this format is the same as the “3.0 (quilt)” format except " 18098"that it doesn't use an explicit list of patches. All files in B<debian/" 18099"patches/> matching the perl regular expression B<[\\ew-]+> must be valid " 18100"patches: they are applied at extraction time." 18101msgstr "" 18102 18103#. type: Plain text 18104#: dpkg-source.man 18105msgid "" 18106"When building a new source package, any change to the upstream source is " 18107"stored in a patch named B<zz_debian-diff-auto>." 18108msgstr "" 18109 18110#. type: SS 18111#: dpkg-source.man 18112#, no-wrap 18113msgid "Format: 3.0 (native)" 18114msgstr "" 18115 18116#. type: Plain text 18117#: dpkg-source.man 18118msgid "" 18119"Supported since dpkg 1.14.17. This format is an extension of the native " 18120"package format as defined in the 1.0 format. It supports all compression " 18121"methods and will ignore by default any VCS specific files and directories as " 18122"well as many temporary files (see default value associated to B<-I> option " 18123"in the B<--help> output)." 18124msgstr "" 18125 18126#. type: SS 18127#: dpkg-source.man 18128#, no-wrap 18129msgid "Format: 3.0 (quilt)" 18130msgstr "" 18131 18132#. type: Plain text 18133#: dpkg-source.man 18134msgid "" 18135"Supported since dpkg 1.14.17. A source package in this format contains at " 18136"least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, " 18137"B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It " 18138"can also contain additional original tarballs (B<.orig->I<component>B<.tar." 18139">I<ext>). I<component> can only contain alphanumeric (‘a-zA-Z0-9’) " 18140"characters and hyphens (‘-’). Optionally each original tarball can be " 18141"accompanied by a detached upstream signature (B<.orig.tar.>I<ext>B<.asc> and " 18142"B<.orig->I<component>B<.tar.>I<ext>B<.asc>), extraction supported since dpkg " 18143"1.17.20, building supported since dpkg 1.18.5." 18144msgstr "" 18145 18146#. type: Plain text 18147#: dpkg-source.man 18148msgid "" 18149"The main original tarball is extracted first, then all additional original " 18150"tarballs are extracted in subdirectories named after the I<component> part " 18151"of their filename (any pre-existing directory is replaced). The debian " 18152"tarball is extracted on top of the source directory after prior removal of " 18153"any pre-existing B<debian> directory. Note that the debian tarball must " 18154"contain a B<debian> sub-directory but it can also contain binary files " 18155"outside of that directory (see B<--include-binaries> option)." 18156msgstr "" 18157 18158#. type: Plain text 18159#: dpkg-source.man 18160msgid "" 18161"All patches listed in B<debian/patches/>I<vendor>B<.series> or B<debian/" 18162"patches/series> are then applied, where I<vendor> will be the lowercase name " 18163"of the current vendor, or B<debian> if there is no vendor defined. If the " 18164"former file is used and the latter one doesn't exist (or is a symlink), then " 18165"the latter is replaced with a symlink to the former. This is meant to " 18166"simplify usage of B<quilt> to manage the set of patches. Vendor-specific " 18167"series files are intended to make it possible to serialize multiple " 18168"development branches based on the vendor, in a declarative way, in " 18169"preference to open-coding this handling in B<debian/rules>. This is " 18170"particularly useful when the source would need to be patched conditionally " 18171"because the affected files do not have built-in conditional occlusion " 18172"support. Note however that while B<dpkg-source> parses correctly series " 18173"files with explicit options used for patch application (stored on each line " 18174"after the patch filename and one or more spaces), it does ignore those " 18175"options and always expect patches that can be applied with the B<-p1> option " 18176"of B<patch>. It will thus emit a warning when it encounters such options, " 18177"and the build is likely to fail." 18178msgstr "" 18179 18180#. type: Plain text 18181#: dpkg-source.man 18182msgid "" 18183"Note that B<lintian>(1) will emit unconditional warnings when using vendor " 18184"series due to a controversial Debian specific ruling, which should not " 18185"affect any external usage; to silence these, the dpkg lintian profile can be " 18186"used by passing «B<--profile dpkg>» to B<lintian>(1)." 18187msgstr "" 18188 18189#. type: Plain text 18190#: dpkg-source.man 18191msgid "" 18192"The timestamp of all patched files is reset to the extraction time of the " 18193"source package (this avoids timestamp skews leading to problems when " 18194"autogenerated files are patched)." 18195msgstr "" 18196 18197#. type: Plain text 18198#: dpkg-source.man 18199msgid "" 18200"Contrary to B<quilt>'s default behaviour, patches are expected to apply " 18201"without any fuzz. When that is not the case, you should refresh such patches " 18202"with B<quilt>, or B<dpkg-source> will error out while trying to apply them." 18203msgstr "" 18204 18205#. type: Plain text 18206#: dpkg-source.man 18207msgid "" 18208"Similarly to B<quilt>'s default behaviour, the patches can remove files too." 18209msgstr "" 18210 18211#. type: Plain text 18212#: dpkg-source.man 18213msgid "" 18214"The file B<.pc/applied-patches> is created if some patches have been applied " 18215"during the extraction." 18216msgstr "" 18217 18218#. type: Plain text 18219#: dpkg-source.man 18220msgid "" 18221"All original tarballs found in the current directory are extracted in a " 18222"temporary directory by following the same logic as for the unpack, the " 18223"debian directory is copied over in the temporary directory, and all patches " 18224"except the automatic patch (B<debian-changes->I<version> or B<debian-" 18225"changes>, depending on B<--single-debian-patch>) are applied. The temporary " 18226"directory is compared to the source package directory. When the diff is non-" 18227"empty, the build fails unless B<--single-debian-patch> or B<--auto-commit> " 18228"has been used, in which case the diff is stored in the automatic patch. If " 18229"the automatic patch is created/deleted, it's added/removed from the series " 18230"file and from the B<quilt> metadata." 18231msgstr "" 18232 18233#. type: Plain text 18234#: dpkg-source.man 18235msgid "" 18236"Any change on a binary file is not representable in a diff and will thus " 18237"lead to a failure unless the maintainer deliberately decided to include that " 18238"modified binary file in the debian tarball (by listing it in B<debian/source/" 18239"include-binaries>). The build will also fail if it finds binary files in the " 18240"debian sub-directory unless they have been whitelisted through B<debian/" 18241"source/include-binaries>." 18242msgstr "" 18243 18244#. type: Plain text 18245#: dpkg-source.man 18246msgid "" 18247"The updated debian directory and the list of modified binaries is then used " 18248"to generate the debian tarball." 18249msgstr "" 18250 18251#. type: Plain text 18252#: dpkg-source.man 18253msgid "" 18254"The automatically generated diff doesn't include changes on VCS specific " 18255"files as well as many temporary files (see default value associated to B<-i> " 18256"option in the B<--help> output). In particular, the B<.pc> directory used by " 18257"B<quilt> is ignored during generation of the automatic patch." 18258msgstr "" 18259 18260#. type: Plain text 18261#: dpkg-source.man 18262msgid "" 18263"Note: B<dpkg-source> B<--before-build> (and B<--build>) will ensure that all " 18264"patches listed in the series file are applied so that a package build always " 18265"has all patches applied. It does this by finding unapplied patches (they are " 18266"listed in the B<series> file but not in B<.pc/applied-patches>), and if the " 18267"first patch in that set can be applied without errors, it will apply them " 18268"all. The option B<--no-preparation> can be used to disable this behavior." 18269msgstr "" 18270 18271#. type: Plain text 18272#: dpkg-source.man 18273msgid "B<Recording changes>" 18274msgstr "" 18275 18276#. type: TP 18277#: dpkg-source.man 18278#, no-wrap 18279msgid "B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]" 18280msgstr "" 18281 18282#. type: Plain text 18283#: dpkg-source.man 18284msgid "" 18285"Generates a patch corresponding to the local changes that are not managed by " 18286"the B<quilt> patch system and integrates it in the patch system under the " 18287"name I<patch-name>. If the name is missing, it will be asked interactively. " 18288"If I<patch-file> is given, it is used as the patch corresponding to the " 18289"local changes to integrate. Once integrated, an editor is launched so that " 18290"you can edit the meta-information in the patch header." 18291msgstr "" 18292 18293#. type: Plain text 18294#: dpkg-source.man 18295msgid "" 18296"Passing I<patch-file> is mainly useful after a build failure that pre-" 18297"generated this file, and on this ground the given file is removed after " 18298"integration. Note also that the changes contained in the patch file must " 18299"already be applied on the tree and that the files modified by the patch must " 18300"not have supplementary unrecorded changes." 18301msgstr "" 18302 18303#. type: Plain text 18304#: dpkg-source.man 18305msgid "" 18306"If the patch generation detects modified binary files, they will be " 18307"automatically added to B<debian/source/include-binaries> so that they end up " 18308"in the debian tarball (exactly like B<dpkg-source --include-binaries --" 18309"build> would do)." 18310msgstr "" 18311 18312#. type: Plain text 18313#: dpkg-source.man 18314msgid "B<Build options>" 18315msgstr "" 18316 18317#. type: TP 18318#: dpkg-source.man 18319#, no-wrap 18320msgid "B<--allow-version-of-quilt-db=>I<version>" 18321msgstr "" 18322 18323#. type: Plain text 18324#: dpkg-source.man 18325msgid "" 18326"Allow B<dpkg-source> to build the source package if the version of the " 18327"B<quilt> metadata is the one specified, even if B<dpkg-source> doesn't know " 18328"about it (since dpkg 1.15.5.4). Effectively this says that the given " 18329"version of the B<quilt> metadata is compatible with the version 2 that " 18330"B<dpkg-source> currently supports. The version of the B<quilt> metadata is " 18331"stored in B<.pc/.version>." 18332msgstr "" 18333 18334#. type: TP 18335#: dpkg-source.man 18336#, no-wrap 18337msgid "B<--include-removal>" 18338msgstr "" 18339 18340#. type: Plain text 18341#: dpkg-source.man 18342msgid "" 18343"Do not ignore removed files and include them in the automatically generated " 18344"patch." 18345msgstr "" 18346 18347#. type: TP 18348#: dpkg-source.man 18349#, no-wrap 18350msgid "B<--include-timestamp>" 18351msgstr "" 18352 18353#. type: Plain text 18354#: dpkg-source.man 18355msgid "Include timestamp in the automatically generated patch." 18356msgstr "" 18357 18358#. type: TP 18359#: dpkg-source.man 18360#, no-wrap 18361msgid "B<--include-binaries>" 18362msgstr "" 18363 18364#. type: Plain text 18365#: dpkg-source.man 18366msgid "" 18367"Add all modified binaries in the debian tarball. Also add them to B<debian/" 18368"source/include-binaries>: they will be added by default in subsequent builds " 18369"and this option is thus no more needed." 18370msgstr "" 18371 18372#. type: TP 18373#: dpkg-source.man 18374#, no-wrap 18375msgid "B<--no-preparation>" 18376msgstr "" 18377 18378#. type: Plain text 18379#: dpkg-source.man 18380msgid "" 18381"Do not try to prepare the build tree by applying patches which are " 18382"apparently unapplied (since dpkg 1.14.18)." 18383msgstr "" 18384 18385#. type: TP 18386#: dpkg-source.man 18387#, no-wrap 18388msgid "B<--single-debian-patch>" 18389msgstr "" 18390 18391#. type: Plain text 18392#: dpkg-source.man 18393msgid "" 18394"Use B<debian/patches/debian-changes> instead of B<debian/patches/debian-" 18395"changes->I<version> for the name of the automatic patch generated during " 18396"build (since dpkg 1.15.5.4). This option is particularly useful when the " 18397"package is maintained in a VCS and a patch set can't reliably be generated. " 18398"Instead the current diff with upstream should be stored in a single patch. " 18399"The option would be put in B<debian/source/local-options> and would be " 18400"accompanied by a B<debian/source/local-patch-header> file explaining how the " 18401"Debian changes can be best reviewed, for example in the VCS that is used." 18402msgstr "" 18403 18404#. type: TP 18405#: dpkg-source.man 18406#, no-wrap 18407msgid "B<--create-empty-orig>" 18408msgstr "" 18409 18410#. type: Plain text 18411#: dpkg-source.man 18412msgid "" 18413"Automatically create the main original tarball as empty if it's missing and " 18414"if there are supplementary original tarballs (since dpkg 1.15.6). This " 18415"option is meant to be used when the source package is just a bundle of " 18416"multiple upstream software and where there's no “main” software." 18417msgstr "" 18418 18419#. type: TP 18420#: dpkg-source.man 18421#, no-wrap 18422msgid "B<--no-unapply-patches, --unapply-patches>" 18423msgstr "" 18424 18425#. type: Plain text 18426#: dpkg-source.man 18427msgid "" 18428"By default, B<dpkg-source> will automatically unapply the patches in the B<--" 18429"after-build> hook if it did apply them during B<--before-build> (B<--unapply-" 18430"patches> since dpkg 1.15.8, B<--no-unapply-patches> since dpkg 1.16.5). " 18431"Those options allow you to forcefully disable or enable the patch " 18432"unapplication process. Those options are only allowed in B<debian/source/" 18433"local-options> so that all generated source packages have the same behavior " 18434"by default." 18435msgstr "" 18436 18437#. type: Plain text 18438#: dpkg-source.man 18439msgid "" 18440"The process fails if an automatic patch has been generated (since dpkg " 18441"1.15.8). This option can be used to ensure that all changes were properly " 18442"recorded in separate B<quilt> patches prior to the source package build. " 18443"This option is not allowed in B<debian/source/options> but can be used in " 18444"B<debian/source/local-options>." 18445msgstr "" 18446 18447#. type: TP 18448#: dpkg-source.man 18449#, no-wrap 18450msgid "B<--auto-commit>" 18451msgstr "" 18452 18453#. type: Plain text 18454#: dpkg-source.man 18455msgid "" 18456"The process doesn't fail if an automatic patch has been generated, instead " 18457"it's immediately recorded in the B<quilt> series." 18458msgstr "" 18459 18460#. type: Plain text 18461#: dpkg-source.man 18462msgid "B<Extract options>" 18463msgstr "" 18464 18465#. type: Plain text 18466#: dpkg-source.man 18467msgid "" 18468"Skips extraction of the debian tarball on top of the upstream sources (since " 18469"dpkg 1.15.1)." 18470msgstr "" 18471 18472#. type: TP 18473#: dpkg-source.man 18474#, no-wrap 18475msgid "B<--skip-patches>" 18476msgstr "" 18477 18478#. type: Plain text 18479#: dpkg-source.man 18480msgid "Do not apply patches at the end of the extraction (since dpkg 1.14.18)." 18481msgstr "" 18482 18483#. type: SS 18484#: dpkg-source.man 18485#, no-wrap 18486msgid "Format: 3.0 (custom)" 18487msgstr "" 18488 18489#. type: Plain text 18490#: dpkg-source.man 18491msgid "" 18492"Supported since dpkg 1.14.17. This format is special. It doesn't represent " 18493"a real source package format but can be used to create source packages with " 18494"arbitrary files." 18495msgstr "" 18496 18497#. type: Plain text 18498#: dpkg-source.man 18499msgid "" 18500"All non-option arguments are taken as files to integrate in the generated " 18501"source package. They must exist and are preferably in the current directory. " 18502"At least one file must be given." 18503msgstr "" 18504 18505#. type: TP 18506#: dpkg-source.man 18507#, no-wrap 18508msgid "B<--target-format=>I<value>" 18509msgstr "" 18510 18511#. type: Plain text 18512#: dpkg-source.man 18513msgid "" 18514"B<Required>. Defines the real format of the generated source package. The " 18515"generated .dsc file will contain this value in its B<Format> field and not " 18516"“3.0 (custom)”." 18517msgstr "" 18518 18519#. type: SS 18520#: dpkg-source.man 18521#, no-wrap 18522msgid "Format: 3.0 (git)" 18523msgstr "" 18524 18525#. type: Plain text 18526#: dpkg-source.man 18527msgid "Supported since dpkg 1.14.17. This format is experimental." 18528msgstr "" 18529 18530#. type: Plain text 18531#: dpkg-source.man 18532msgid "" 18533"A source package in this format consists of a single bundle of a git " 18534"repository B<.git> to hold the source of a package. There may also be a B<." 18535"gitshallow> file listing revisions for a shallow git clone." 18536msgstr "" 18537 18538#. type: Plain text 18539#: dpkg-source.man 18540msgid "" 18541"The bundle is cloned as a git repository to the target directory. If there " 18542"is a gitshallow file, it is installed as I<.git/shallow> inside the cloned " 18543"git repository." 18544msgstr "" 18545 18546#. type: Plain text 18547#: dpkg-source.man 18548msgid "" 18549"Note that by default the new repository will have the same branch checked " 18550"out that was checked out in the original source. (Typically “master”, but " 18551"it could be anything.) Any other branches will be available under I<remotes/" 18552"origin/>." 18553msgstr "" 18554 18555#. type: Plain text 18556#: dpkg-source.man 18557msgid "" 18558"Before going any further, some checks are done to ensure that we don't have " 18559"any non-ignored uncommitted changes." 18560msgstr "" 18561 18562#. type: Plain text 18563#: dpkg-source.man 18564msgid "" 18565"B<git-bundle>(1) is used to generate a bundle of the git repository. By " 18566"default, all branches and tags in the repository are included in the bundle." 18567msgstr "" 18568 18569#. type: TP 18570#: dpkg-source.man 18571#, no-wrap 18572msgid "B<--git-ref=>I<ref>" 18573msgstr "" 18574 18575#. type: Plain text 18576#: dpkg-source.man 18577msgid "" 18578"Allows specifying a git ref to include in the git bundle. Use disables the " 18579"default behavior of including all branches and tags. May be specified " 18580"multiple times. The I<ref> can be the name of a branch or tag to include. It " 18581"may also be any parameter that can be passed to B<git-rev-list>(1). For " 18582"example, to include only the master branch, use B<--git-ref=>master. To " 18583"include all tags and branches, except for the private branch, use B<--git-" 18584"ref=>--all B<--git-ref=>^private" 18585msgstr "" 18586 18587#. type: TP 18588#: dpkg-source.man 18589#, no-wrap 18590msgid "B<--git-depth=>I<number>" 18591msgstr "" 18592 18593#. type: Plain text 18594#: dpkg-source.man 18595msgid "" 18596"Creates a shallow clone with a history truncated to the specified number of " 18597"revisions." 18598msgstr "" 18599 18600#. type: SS 18601#: dpkg-source.man 18602#, no-wrap 18603msgid "Format: 3.0 (bzr)" 18604msgstr "" 18605 18606#. type: Plain text 18607#: dpkg-source.man 18608msgid "" 18609"Supported since dpkg 1.14.17. This format is experimental. It generates a " 18610"single tarball containing the bzr repository." 18611msgstr "" 18612 18613#. type: Plain text 18614#: dpkg-source.man 18615msgid "" 18616"The tarball is unpacked and then bzr is used to checkout the current branch." 18617msgstr "" 18618 18619#. type: Plain text 18620#: dpkg-source.man 18621msgid "" 18622"Then the VCS specific part of the source directory is copied over to a " 18623"temporary directory. Before this temporary directory is packed in a tarball, " 18624"various cleanup are done to save space." 18625msgstr "" 18626 18627#. type: SS 18628#: dpkg-source.man 18629#, no-wrap 18630msgid "no source format specified in debian/source/format" 18631msgstr "" 18632 18633#. type: Plain text 18634#: dpkg-source.man 18635msgid "" 18636"The file B<debian/source/format> should always exist and indicate the " 18637"desired source format. For backwards compatibility, format “1.0” is assumed " 18638"when the file doesn't exist but you should not rely on this: at some point " 18639"in the future B<dpkg-source> will be modified to fail when that file doesn't " 18640"exist." 18641msgstr "" 18642 18643#. type: Plain text 18644#: dpkg-source.man 18645msgid "" 18646"The rationale is that format “1.0” is no longer the recommended format, you " 18647"should usually pick one of the newer formats (“3.0 (quilt)”, “3.0 (native)”) " 18648"but B<dpkg-source> will not do this automatically for you. If you want to " 18649"continue using the old format, you should be explicit about it and put “1.0” " 18650"in B<debian/source/format>." 18651msgstr "" 18652 18653#. type: SS 18654#: dpkg-source.man 18655#, no-wrap 18656msgid "the diff modifies the following upstream files" 18657msgstr "" 18658 18659#. type: Plain text 18660#: dpkg-source.man 18661msgid "" 18662"When using source format “1.0” it is usually a bad idea to modify upstream " 18663"files directly as the changes end up hidden and mostly undocumented in the ." 18664"diff.gz file. Instead you should store your changes as patches in the debian " 18665"directory and apply them at build-time. To avoid this complexity you can " 18666"also use the format “3.0 (quilt)” that offers this natively." 18667msgstr "" 18668 18669#. type: SS 18670#: dpkg-source.man 18671#, no-wrap 18672msgid "cannot represent change to I<file>" 18673msgstr "" 18674 18675#. type: Plain text 18676#: dpkg-source.man 18677msgid "" 18678"Changes to upstream sources are usually stored with patch files, but not all " 18679"changes can be represented with patches: they can only alter the content of " 18680"plain text files. If you try replacing a file with something of a different " 18681"type (for example replacing a plain file with a symlink or a directory), you " 18682"will get this error message." 18683msgstr "" 18684 18685#. type: SS 18686#: dpkg-source.man 18687#, no-wrap 18688msgid "newly created empty file I<file> will not be represented in diff" 18689msgstr "" 18690 18691#. type: Plain text 18692#: dpkg-source.man 18693msgid "" 18694"Empty files can't be created with patch files. Thus this change is not " 18695"recorded in the source package and you are warned about it." 18696msgstr "" 18697 18698#. type: SS 18699#: dpkg-source.man 18700#, no-wrap 18701msgid "executable mode I<perms> of I<file> will not be represented in diff" 18702msgstr "" 18703 18704#. type: Plain text 18705#: dpkg-source.man 18706msgid "" 18707"Patch files do not record permissions of files and thus executable " 18708"permissions are not stored in the source package. This warning reminds you " 18709"of that fact." 18710msgstr "" 18711 18712#. type: SS 18713#: dpkg-source.man 18714#, no-wrap 18715msgid "special mode I<perms> of I<file> will not be represented in diff" 18716msgstr "" 18717 18718#. type: Plain text 18719#: dpkg-source.man 18720msgid "" 18721"Patch files do not record permissions of files and thus modified permissions " 18722"are not stored in the source package. This warning reminds you of that fact." 18723msgstr "" 18724 18725#. type: Plain text 18726#: dpkg-source.man 18727msgid "" 18728"If set, it will be used as the timestamp (as seconds since the epoch) to " 18729"clamp the mtime in the B<tar>(5) file entries." 18730msgstr "" 18731 18732#. type: TP 18733#: dpkg-source.man 18734#, no-wrap 18735msgid "B<VISUAL>" 18736msgstr "" 18737 18738#. type: TQ 18739#: dpkg-source.man 18740#, no-wrap 18741msgid "B<EDITOR>" 18742msgstr "" 18743 18744#. type: Plain text 18745#: dpkg-source.man 18746msgid "Used by the “2.0” and “3.0 (quilt)” source format modules." 18747msgstr "" 18748 18749#. type: TP 18750#: dpkg-source.man 18751#, no-wrap 18752msgid "B<GIT_DIR>" 18753msgstr "" 18754 18755#. type: TQ 18756#: dpkg-source.man 18757#, no-wrap 18758msgid "B<GIT_INDEX_FILE>" 18759msgstr "" 18760 18761#. type: TQ 18762#: dpkg-source.man 18763#, no-wrap 18764msgid "B<GIT_OBJECT_DIRECTORY>" 18765msgstr "" 18766 18767#. type: TQ 18768#: dpkg-source.man 18769#, no-wrap 18770msgid "B<GIT_ALTERNATE_OBJECT_DIRECTORIES>" 18771msgstr "" 18772 18773#. type: TQ 18774#: dpkg-source.man 18775#, no-wrap 18776msgid "B<GIT_WORK_TREE>" 18777msgstr "" 18778 18779#. type: Plain text 18780#: dpkg-source.man 18781msgid "Used by the “3.0 (git)” source format modules." 18782msgstr "" 18783 18784#. type: SS 18785#: dpkg-source.man 18786#, no-wrap 18787msgid "debian/source/format" 18788msgstr "" 18789 18790#. type: Plain text 18791#: dpkg-source.man 18792msgid "" 18793"This file contains on a single line the format that should be used to build " 18794"the source package (possible formats are described above). No leading or " 18795"trailing spaces are allowed." 18796msgstr "" 18797 18798#. type: SS 18799#: dpkg-source.man 18800#, no-wrap 18801msgid "debian/source/include-binaries" 18802msgstr "" 18803 18804#. type: Plain text 18805#: dpkg-source.man 18806msgid "" 18807"This file contains a list of binary files (one per line) that should be " 18808"included in the debian tarball. Leading and trailing spaces are stripped. " 18809"Lines starting with ‘B<#>’ are comments and are skipped. Empty lines are " 18810"ignored." 18811msgstr "" 18812 18813#. type: SS 18814#: dpkg-source.man 18815#, no-wrap 18816msgid "debian/source/options" 18817msgstr "" 18818 18819#. type: Plain text 18820#: dpkg-source.man 18821msgid "" 18822"This file contains a list of long options that should be automatically " 18823"prepended to the set of command line options of a B<dpkg-source --build> or " 18824"B<dpkg-source --print-format> call. Options like B<--compression> and B<--" 18825"compression-level> are well suited for this file." 18826msgstr "" 18827 18828#. type: Plain text 18829#: dpkg-source.man 18830msgid "" 18831"Each option should be put on a separate line. Empty lines and lines starting " 18832"with ‘B<#>’ are ignored. The leading ‘B<-->’ should be stripped and short " 18833"options are not allowed. Optional spaces are allowed around the ‘B<=>’ " 18834"symbol and optional quotes are allowed around the value. Here's an example " 18835"of such a file:" 18836msgstr "" 18837 18838#. type: Plain text 18839#: dpkg-source.man 18840#, no-wrap 18841msgid "" 18842" # let dpkg-source create a debian.tar.bz2 with maximal compression\n" 18843" compression = \"bzip2\"\n" 18844" compression-level = 9\n" 18845" # use debian/patches/debian-changes as automatic patch\n" 18846" single-debian-patch\n" 18847" # ignore changes on config.{sub,guess}\n" 18848" extend-diff-ignore = \"(^|/)(config.sub|config.guess)$\"\n" 18849msgstr "" 18850 18851#. type: Plain text 18852#: dpkg-source.man 18853msgid "" 18854"Note: B<format> options are not accepted in this file, you should use " 18855"B<debian/source/format> instead." 18856msgstr "" 18857 18858#. type: SS 18859#: dpkg-source.man 18860#, no-wrap 18861msgid "debian/source/local-options" 18862msgstr "" 18863 18864#. type: Plain text 18865#: dpkg-source.man 18866msgid "" 18867"Exactly like B<debian/source/options> except that the file is not included " 18868"in the generated source package. It can be useful to store a preference tied " 18869"to the maintainer or to the VCS repository where the source package is " 18870"maintained." 18871msgstr "" 18872 18873#. type: SS 18874#: dpkg-source.man 18875#, no-wrap 18876msgid "debian/source/local-patch-header R<and> debian/source/patch-header" 18877msgstr "" 18878 18879#. type: Plain text 18880#: dpkg-source.man 18881msgid "" 18882"Free form text that is put on top of the automatic patch generated in " 18883"formats “2.0” or “3.0 (quilt)”. B<local-patch-header> is not included in the " 18884"generated source package while B<patch-header> is." 18885msgstr "" 18886 18887#. type: SS 18888#: dpkg-source.man 18889#, no-wrap 18890msgid "debian/patches/I<vendor>.series" 18891msgstr "" 18892 18893#. type: SS 18894#: dpkg-source.man 18895#, no-wrap 18896msgid "debian/patches/series" 18897msgstr "" 18898 18899#. type: Plain text 18900#: dpkg-source.man 18901msgid "" 18902"This file lists all patches that have to be applied (in the given order) on " 18903"top of the upstream source package. Leading and trailing spaces are " 18904"stripped. The I<vendor> will be the lowercase name of the current vendor, " 18905"or B<debian> if there is no vendor defined. If the vendor-specific series " 18906"file does not exist, the vendor-less series file will be used. Lines " 18907"starting with ‘B<#>’ are comments and are skipped. Empty lines are " 18908"ignored. Remaining lines start with a patch filename (relative to the " 18909"B<debian/patches/> directory) up to the first space character or the end of " 18910"line. Optional B<quilt> options can follow up to the end of line or the " 18911"first ‘B<#>’ preceded by one or more spaces (which marks the start of a " 18912"comment up to the end of line)." 18913msgstr "" 18914 18915#. type: Plain text 18916#: dpkg-source.man 18917msgid "" 18918"The point at which field overriding occurs compared to certain standard " 18919"output field settings is rather confused." 18920msgstr "" 18921 18922#. type: Plain text 18923#: dpkg-source.man 18924#, fuzzy 18925#| msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 18926msgid "B<deb-src-control>(5), B<deb-changelog>(5), B<dsc>(5)." 18927msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 18928 18929#. type: TH 18930#: dpkg-split.man 18931#, no-wrap 18932msgid "dpkg-split" 18933msgstr "" 18934 18935#. type: Plain text 18936#: dpkg-split.man 18937msgid "dpkg-split - Debian package archive split/join tool" 18938msgstr "" 18939 18940#. type: Plain text 18941#: dpkg-split.man 18942msgid "B<dpkg-split> [I<option>...] I<command>" 18943msgstr "" 18944 18945#. type: Plain text 18946#: dpkg-split.man 18947msgid "" 18948"B<dpkg-split> splits Debian binary package files into smaller parts and " 18949"reassembles them again, to support the storage of large package files on " 18950"small media such as floppy disks." 18951msgstr "" 18952 18953#. type: Plain text 18954#: dpkg-split.man 18955msgid "" 18956"It can be operated manually using the B<--split>, B<--join> and B<--info> " 18957"options." 18958msgstr "" 18959 18960#. type: Plain text 18961#: dpkg-split.man 18962msgid "" 18963"It also has an automatic mode, invoked using the B<--auto> option, where it " 18964"maintains a queue of parts seen but not yet reassembled and reassembles a " 18965"package file when it has seen all of its parts. The B<--listq> and B<--" 18966"discard> options allow the management of the queue." 18967msgstr "" 18968 18969#. type: Plain text 18970#: dpkg-split.man 18971msgid "" 18972"All splitting, joining and queueing operations produce informative messages " 18973"on standard output; these may safely be ignored." 18974msgstr "" 18975 18976#. type: TP 18977#: dpkg-split.man 18978#, no-wrap 18979msgid "B<-s>, B<--split> I<complete-archive> [I<prefix>]" 18980msgstr "" 18981 18982#. type: Plain text 18983#: dpkg-split.man 18984msgid "Splits a single Debian binary package into several parts." 18985msgstr "" 18986 18987#. type: Plain text 18988#: dpkg-split.man 18989msgid "" 18990"The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part " 18991"number, starting at 1, and I<M> is the total number of parts (both in " 18992"decimal)." 18993msgstr "" 18994 18995#. type: Plain text 18996#: dpkg-split.man 18997msgid "" 18998"If no I<prefix> is supplied then the I<complete-archive> filename is taken, " 18999"including directory, with any trailing B<.deb> removed." 19000msgstr "" 19001 19002#. type: TP 19003#: dpkg-split.man 19004#, no-wrap 19005msgid "B<-j>, B<--join> I<part>..." 19006msgstr "" 19007 19008#. type: Plain text 19009#: dpkg-split.man 19010msgid "" 19011"Joins the parts of a package file together, reassembling the original file " 19012"as it was before it was split." 19013msgstr "" 19014 19015#. type: Plain text 19016#: dpkg-split.man 19017msgid "" 19018"The part files given as arguments must be all the parts of exactly the same " 19019"original binary file. Each part must occur exactly once in the argument " 19020"list, though the parts to not need to be listed in order." 19021msgstr "" 19022 19023#. type: Plain text 19024#: dpkg-split.man 19025msgid "" 19026"The parts must of course all have been generated with the same part size " 19027"specified at split time, which means that they must usually have been " 19028"generated by the same invocation of B<dpkg-split --split>." 19029msgstr "" 19030 19031#. type: Plain text 19032#: dpkg-split.man 19033msgid "The parts' filenames are not significant for the reassembly process." 19034msgstr "" 19035 19036#. type: Plain text 19037#: dpkg-split.man 19038msgid "" 19039"By default the output file is called I<package>B<_>I<version>B<_>I<arch>B<." 19040"deb>." 19041msgstr "" 19042 19043#. type: TP 19044#: dpkg-split.man 19045#, no-wrap 19046msgid "B<-I>, B<--info> I<part>..." 19047msgstr "" 19048 19049#. type: Plain text 19050#: dpkg-split.man 19051msgid "" 19052"Prints information, in a human-readable format, about the part file(s) " 19053"specified. Arguments which are not binary package parts produce a message " 19054"saying so instead (but still on standard output)." 19055msgstr "" 19056 19057#. type: TP 19058#: dpkg-split.man 19059#, no-wrap 19060msgid "B<-a>, B<--auto -o> I<complete-output part>" 19061msgstr "" 19062 19063#. type: Plain text 19064#: dpkg-split.man 19065msgid "Automatically queue parts and reassemble a package if possible." 19066msgstr "" 19067 19068#. type: Plain text 19069#: dpkg-split.man 19070msgid "" 19071"The I<part> specified is examined, and compared with other parts of the same " 19072"package (if any) in the queue of packages file parts." 19073msgstr "" 19074 19075#. type: Plain text 19076#: dpkg-split.man 19077msgid "" 19078"If all parts of the package file of which I<part> is a part are available " 19079"then the package is reassembled and written to I<complete-output> (which " 19080"should not usually already exist, though this is not an error)." 19081msgstr "" 19082 19083#. type: Plain text 19084#: dpkg-split.man 19085msgid "" 19086"If not then the I<part> is copied into the queue and I<complete-output> is " 19087"not created." 19088msgstr "" 19089 19090#. type: Plain text 19091#: dpkg-split.man 19092msgid "" 19093"If I<part> is not a split binary package part then B<dpkg-split> will exit " 19094"with status B<1>; if some other trouble occurs then it will exit with status " 19095"B<2>." 19096msgstr "" 19097 19098#. type: Plain text 19099#: dpkg-split.man 19100msgid "" 19101"The B<--output> or B<-o> option must be supplied when using B<--auto>. (If " 19102"this were not mandatory the calling program would not know what output file " 19103"to expect.)" 19104msgstr "" 19105 19106#. type: TP 19107#: dpkg-split.man 19108#, no-wrap 19109msgid "B<-l>, B<--listq>" 19110msgstr "" 19111 19112#. type: Plain text 19113#: dpkg-split.man 19114msgid "Lists the contents of the queue of packages to be reassembled." 19115msgstr "" 19116 19117#. type: Plain text 19118#: dpkg-split.man 19119msgid "" 19120"For each package file of which parts are in the queue the output gives the " 19121"name of the package, the parts in the queue, and the total number of bytes " 19122"stored in the queue." 19123msgstr "" 19124 19125#. type: TP 19126#: dpkg-split.man 19127#, no-wrap 19128msgid "B<-d>, B<--discard> [I<package>...]" 19129msgstr "" 19130 19131#. type: Plain text 19132#: dpkg-split.man 19133msgid "" 19134"This discards parts from the queue of those waiting for the remaining parts " 19135"of their packages." 19136msgstr "" 19137 19138#. type: Plain text 19139#: dpkg-split.man 19140msgid "" 19141"If no I<package> is specified then the queue is cleared completely; if any " 19142"are specified then only parts of the relevant package(s) are deleted." 19143msgstr "" 19144 19145#. type: TP 19146#: dpkg-split.man 19147#, no-wrap 19148msgid "B<--depotdir>I< directory>" 19149msgstr "" 19150 19151#. type: Plain text 19152#: dpkg-split.man 19153msgid "" 19154"Specifies an alternative directory for the queue of parts awaiting automatic " 19155"reassembly. The default is B<%ADMINDIR%>." 19156msgstr "" 19157 19158#. type: TP 19159#: dpkg-split.man 19160#, no-wrap 19161msgid "B<-S>, B<--partsize> I<kibibytes>" 19162msgstr "" 19163 19164#. type: Plain text 19165#: dpkg-split.man 19166msgid "" 19167"Specifies the maximum part size when splitting, in kibibytes (1024 bytes). " 19168"The default is 450 KiB." 19169msgstr "指定最大分块尺寸，单位为 kibibytes (1024 字节)。默认 450 KiB。" 19170 19171#. type: TP 19172#: dpkg-split.man 19173#, no-wrap 19174msgid "B<-o>, B<--output> I<complete-output>" 19175msgstr "" 19176 19177#. type: Plain text 19178#: dpkg-split.man 19179msgid "Specifies the output file name for a reassembly." 19180msgstr "" 19181 19182#. type: Plain text 19183#: dpkg-split.man 19184msgid "" 19185"This overrides the default for a manual reassembly (B<--join>) and is " 19186"mandatory for an automatic queue-or-reassemble (B<--auto>)." 19187msgstr "" 19188 19189#. type: TP 19190#: dpkg-split.man 19191#, no-wrap 19192msgid "B<-Q>, B<--npquiet>" 19193msgstr "" 19194 19195#. type: Plain text 19196#: dpkg-split.man 19197msgid "" 19198"When doing automatic queue-or-reassembly B<dpkg-split> usually prints a " 19199"message if it is given a I<part> that is not a binary package part. This " 19200"option suppresses this message, to allow programs such as B<dpkg> to cope " 19201"with both split and unsplit packages without producing spurious messages." 19202msgstr "" 19203 19204#. type: TP 19205#: dpkg-split.man 19206#, no-wrap 19207msgid "B<--msdos>" 19208msgstr "" 19209 19210#. type: Plain text 19211#: dpkg-split.man 19212msgid "" 19213"Forces the output filenames generated by B<--split> to be msdos-compatible." 19214msgstr "强制 B<--split> 输出 msdos 兼容的文件名。" 19215 19216#. type: Plain text 19217#: dpkg-split.man 19218msgid "" 19219"This mangles the prefix - either the default derived from the input filename " 19220"or the one supplied as an argument: alphanumerics are lowercased, plus signs " 19221"are replaced by B<x>'s and all other characters are discarded." 19222msgstr "" 19223 19224#. type: Plain text 19225#: dpkg-split.man 19226msgid "" 19227"The result is then truncated as much as is necessary, and filenames of the " 19228"form I<prefixN>B<of>I<M>B<.deb> are generated." 19229msgstr "" 19230 19231#. type: Plain text 19232#: dpkg-split.man 19233msgid "" 19234"The requested split, merge, or other command succeeded. B<--info> commands " 19235"count as successful even if the files are not binary package parts." 19236msgstr "" 19237 19238#. type: Plain text 19239#: dpkg-split.man 19240msgid "" 19241"Only occurs with B<--auto> and indicates that the I<part> file was not a " 19242"binary package part." 19243msgstr "" 19244 19245#. type: Plain text 19246#: dpkg-split.man 19247msgid "" 19248"Fatal or unrecoverable error due to invalid command-line usage, a file that " 19249"looked like a package part file but was corrupted, or interactions with the " 19250"system, such as accesses to the database, memory allocations, etc." 19251msgstr "" 19252 19253#. type: Plain text 19254#: dpkg-split.man 19255msgid "" 19256"If set, it will be used as the timestamp (as seconds since the epoch) in the " 19257"B<deb-split>(5)'s B<ar>(5) container." 19258msgstr "" 19259 19260#. type: TP 19261#: dpkg-split.man 19262#, no-wrap 19263msgid "I<%ADMINDIR%/parts>" 19264msgstr "" 19265 19266#. type: Plain text 19267#: dpkg-split.man 19268msgid "" 19269"The default queue directory for part files awaiting automatic reassembly." 19270msgstr "" 19271 19272#. type: Plain text 19273#: dpkg-split.man 19274msgid "" 19275"The filenames used in this directory are in a format internal to B<dpkg-" 19276"split> and are unlikely to be useful to other programs, and in any case the " 19277"filename format should not be relied upon." 19278msgstr "" 19279 19280#. type: Plain text 19281#: dpkg-split.man 19282msgid "" 19283"Full details of the packages in the queue are impossible to get without " 19284"digging into the queue directory yourself." 19285msgstr "" 19286 19287#. type: Plain text 19288#: dpkg-split.man 19289msgid "" 19290"There is no easy way to test whether a file that may be a binary package " 19291"part is one." 19292msgstr "" 19293 19294#. type: Plain text 19295#: dpkg-split.man 19296msgid "B<deb>(5), B<deb-control>(5), B<dpkg-deb>(1), B<dpkg>(1)." 19297msgstr "" 19298 19299#. type: TH 19300#: dpkg-statoverride.man 19301#, no-wrap 19302msgid "dpkg-statoverride" 19303msgstr "" 19304 19305#. type: Plain text 19306#: dpkg-statoverride.man 19307msgid "dpkg-statoverride - override ownership and mode of files" 19308msgstr "" 19309 19310#. type: Plain text 19311#: dpkg-statoverride.man 19312msgid "B<dpkg-statoverride> [I<option>...] I<command>" 19313msgstr "" 19314 19315#. type: Plain text 19316#: dpkg-statoverride.man 19317msgid "" 19318"“B<stat overrides>” are a way to tell B<dpkg>(1) to use a different owner " 19319"or mode for a path when a package is installed (this applies to any " 19320"filesystem object that B<dpkg> handles, including directories, devices, " 19321"etc.). This can be used to force programs that are normally setuid to be " 19322"install without a setuid flag, or only executable by a certain group." 19323msgstr "" 19324 19325#. type: Plain text 19326#: dpkg-statoverride.man 19327msgid "" 19328"B<dpkg-statoverride> is a utility to manage the list of stat overrides. It " 19329"has three basic functions: adding, removing and listing overrides." 19330msgstr "" 19331 19332#. type: TP 19333#: dpkg-statoverride.man 19334#, no-wrap 19335msgid "B<--add>I< user group mode path>" 19336msgstr "" 19337 19338#. type: Plain text 19339#: dpkg-statoverride.man 19340msgid "" 19341"Add an override for I<path>. I<path> does not need to exist when this " 19342"command is used; the override will be stored and used later. Users and " 19343"groups can be specified by their name (for example B<root> or B<nobody>), or " 19344"by their number by prepending the number with a ‘B<#>’ (for example B<#0> or " 19345"B<#65534>). The I<mode> needs to be specified in octal." 19346msgstr "" 19347 19348#. type: Plain text 19349#: dpkg-statoverride.man 19350msgid "" 19351"If B<--update> is specified and I<path> exists, it is immediately set to the " 19352"new owner and mode." 19353msgstr "" 19354 19355#. type: TP 19356#: dpkg-statoverride.man 19357#, no-wrap 19358msgid "B<--remove>I< path>" 19359msgstr "" 19360 19361#. type: Plain text 19362#: dpkg-statoverride.man 19363msgid "" 19364"Remove an override for I<path>, the status of I<path> is left unchanged by " 19365"this command." 19366msgstr "" 19367 19368#. type: TP 19369#: dpkg-statoverride.man 19370#, no-wrap 19371msgid "B<--list> [I<glob-pattern>]" 19372msgstr "" 19373 19374#. type: Plain text 19375#: dpkg-statoverride.man 19376msgid "" 19377"List all overrides. If a glob pattern is specified restrict the output to " 19378"overrides which match the glob." 19379msgstr "" 19380 19381#. type: Plain text 19382#: dpkg-statoverride.man 19383#, fuzzy 19384#| msgid "Give help about the B<--force->I<thing> options." 19385msgid "Give help about the B<--force->I<thing> options (since dpkg 1.19.5)." 19386msgstr "显示有关 B<--force->I<thing> 选项的帮助。" 19387 19388#. type: Plain text 19389#: dpkg-statoverride.man 19390msgid "" 19391"Set the administrative directory to I<directory>. This is where the " 19392"I<statoverride> file is stored. Defaults to «I<%ADMINDIR%>»." 19393msgstr "" 19394 19395#. type: Plain text 19396#: dpkg-statoverride.man 19397msgid "" 19398"Set the installation directory, which refers to the directory where packages " 19399"get installed (since dpkg 1.19.2). Defaults to «I</>»." 19400msgstr "" 19401 19402#. type: Plain text 19403#: dpkg-statoverride.man 19404#, fuzzy 19405#| msgid "" 19406#| "Force or refuse (B<no-force> and B<refuse> mean the same thing) to do " 19407#| "some things. I<things> is a comma separated list of things specified " 19408#| "below. B<--force-help> displays a message describing them. Things marked " 19409#| "with (*) are forced by default." 19410msgid "" 19411"Force or refuse (B<no-force> and B<refuse> mean the same thing) to do some " 19412"things (since dpkg 1.19.5). I<things> is a comma separated list of things " 19413"specified below. B<--force-help> displays a message describing them. " 19414"Things marked with (*) are forced by default." 19415msgstr "" 19416"强制或拒绝做某事（B<no-force> 和 B<refuse> 所指相同）。I<things> 是一个逗号分" 19417"隔的事件表，具体事件请参见下文。B<--force-help> 会给出相应的帮助信息。另外，" 19418"标记了（*）的事件是默认选择强制的。" 19419 19420#. type: Plain text 19421#: dpkg-statoverride.man 19422#, fuzzy 19423#| msgid "" 19424#| "I<Warning: These options are mostly intended to be used by experts only. " 19425#| "Using them without fully understanding their effects may break your whole " 19426#| "system.>" 19427msgid "" 19428"I<Warning: These options are mostly intended to be used by experts only. " 19429"Using them without fully understanding their effects may break your whole " 19430"system.>" 19431msgstr "" 19432"I<警告: 这些选项大多数是提供给专家用户使用的。在没有完全理解它们的效果的情况" 19433"下使用，很可能会破坏您的整个系统。>" 19434 19435#. type: TP 19436#: dpkg-statoverride.man update-alternatives.man 19437#, no-wrap 19438msgid "B<--force>" 19439msgstr "" 19440 19441#. type: Plain text 19442#: dpkg-statoverride.man 19443msgid "" 19444"Force an action, even if a sanity check would otherwise prohibit it. This " 19445"is necessary to override an existing override. This option is deprecated " 19446"(since dpkg 1.19.5), it is replaced by B<--force-all>." 19447msgstr "" 19448 19449#. type: TP 19450#: dpkg-statoverride.man 19451#, no-wrap 19452msgid "B<--update>" 19453msgstr "" 19454 19455#. type: Plain text 19456#: dpkg-statoverride.man 19457msgid "" 19458"Immediately try to change the I<path> to the new owner and mode if it exists." 19459msgstr "" 19460 19461#. type: Plain text 19462#: dpkg-statoverride.man 19463msgid "Be less verbose about what we do." 19464msgstr "" 19465 19466#. type: Plain text 19467#: dpkg-statoverride.man 19468msgid "" 19469"For B<--list>, if there are no overrides or none match the supplied glob." 19470msgstr "" 19471 19472#. type: Plain text 19473#: dpkg-statoverride.man 19474msgid "" 19475"If set and none of the B<--force->I<...> options have been specified, it " 19476"will be used as the force options to use (since dpkg 1.19.5)." 19477msgstr "" 19478 19479#. type: TP 19480#: dpkg-statoverride.man 19481#, no-wrap 19482msgid "I<%ADMINDIR%/statoverride>" 19483msgstr "" 19484 19485#. type: Plain text 19486#: dpkg-statoverride.man 19487msgid "" 19488"File which contains the current list of stat overrides of the system. It is " 19489"located in the B<dpkg> administration directory, along with other files " 19490"important to B<dpkg>, such as I<status> or I<available>." 19491msgstr "" 19492 19493#. type: Plain text 19494#: dpkg-statoverride.man 19495msgid "" 19496"Note: B<dpkg-statoverride> preserves the old copy of this file, with " 19497"extension “-old”, before replacing it with the new one." 19498msgstr "" 19499 19500#. type: TH 19501#: dpkg-trigger.man 19502#, no-wrap 19503msgid "dpkg-trigger" 19504msgstr "" 19505 19506#. type: Plain text 19507#: dpkg-trigger.man 19508msgid "dpkg-trigger - a package trigger utility" 19509msgstr "" 19510 19511#. type: Plain text 19512#: dpkg-trigger.man 19513msgid "B<dpkg-trigger> [I<option>...] I<trigger-name>" 19514msgstr "" 19515 19516#. type: Plain text 19517#: dpkg-trigger.man 19518msgid "B<dpkg-trigger> [I<option>...] I<command>" 19519msgstr "" 19520 19521#. type: Plain text 19522#: dpkg-trigger.man 19523msgid "" 19524"B<dpkg-trigger> is a tool to explicitly activate triggers and check for its " 19525"support on the running B<dpkg>." 19526msgstr "" 19527 19528#. type: Plain text 19529#: dpkg-trigger.man 19530msgid "" 19531"This can be used by maintainer scripts in complex and conditional situations " 19532"where the file triggers, or the declarative B<activate> triggers control " 19533"file directive, are insufficiently rich. It can also be used for testing and " 19534"by system administrators (but note that the triggers won't actually be run " 19535"by B<dpkg-trigger>)." 19536msgstr "" 19537 19538#. type: Plain text 19539#: dpkg-trigger.man 19540msgid "Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>." 19541msgstr "" 19542 19543#. type: TP 19544#: dpkg-trigger.man 19545#, no-wrap 19546msgid "B<--check-supported>" 19547msgstr "" 19548 19549#. type: Plain text 19550#: dpkg-trigger.man 19551msgid "" 19552"Check if the running B<dpkg> supports triggers (usually called from a " 19553"postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> " 19554"with an error message to stderr if not. Normally, however, it is better just " 19555"to activate the desired trigger with B<dpkg-trigger>." 19556msgstr "" 19557 19558#. type: TP 19559#: dpkg-trigger.man 19560#, no-wrap 19561msgid "B<--by-package=>I<package>" 19562msgstr "" 19563 19564#. type: Plain text 19565#: dpkg-trigger.man 19566msgid "" 19567"Override trigger awaiter (normally set by B<dpkg> through the " 19568"B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, " 19569"naming the package to which the script belongs, and this will be used by " 19570"default)." 19571msgstr "" 19572 19573#. type: TP 19574#: dpkg-trigger.man 19575#, no-wrap 19576msgid "B<--no-await>" 19577msgstr "" 19578 19579#. type: Plain text 19580#: dpkg-trigger.man 19581msgid "" 19582"This option arranges that the calling package T (if any) need not await the " 19583"processing of this trigger; the interested package(s) I, will not be added " 19584"to T's trigger processing awaited list and T's status is unchanged. T may " 19585"be considered installed even though I may not yet have processed the trigger." 19586msgstr "" 19587 19588#. type: TP 19589#: dpkg-trigger.man 19590#, no-wrap 19591msgid "B<--await>" 19592msgstr "" 19593 19594#. type: Plain text 19595#: dpkg-trigger.man 19596msgid "" 19597"This option does the inverse of B<--no-await> (since dpkg 1.17.21). If the " 19598"interested package has declared a “noawait” directive, then this option will " 19599"not be effective. It is currently the default behavior." 19600msgstr "" 19601 19602#. type: TP 19603#: dpkg-trigger.man 19604#, no-wrap 19605msgid "B<--no-act>" 19606msgstr "" 19607 19608#. type: Plain text 19609#: dpkg-trigger.man 19610msgid "Just test, do not actually change anything." 19611msgstr "" 19612 19613#. FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev. 19614#. type: Plain text 19615#: dpkg-trigger.man 19616msgid "" 19617"B<dpkg>(1), B<deb-triggers>(5), B</usr/share/doc/dpkg-dev/triggers.txt.gz>." 19618msgstr "" 19619 19620#. type: TH 19621#: dpkg-vendor.man 19622#, no-wrap 19623msgid "dpkg-vendor" 19624msgstr "" 19625 19626#. type: Plain text 19627#: dpkg-vendor.man 19628msgid "dpkg-vendor - queries information about distribution vendors" 19629msgstr "" 19630 19631#. type: Plain text 19632#: dpkg-vendor.man 19633msgid "B<dpkg-vendor> [I<option>...] I<command>" 19634msgstr "" 19635 19636#. type: Plain text 19637#: dpkg-vendor.man 19638msgid "" 19639"B<dpkg-vendor> is a tool to query information about vendors listed in B<" 19640"%PKGCONFDIR%/origins>. B<%PKGCONFDIR%/origins/default> contains information " 19641"about the current vendor." 19642msgstr "" 19643 19644#. type: TP 19645#: dpkg-vendor.man 19646#, no-wrap 19647msgid "B<--is>I< vendor>" 19648msgstr "" 19649 19650#. type: Plain text 19651#: dpkg-vendor.man 19652msgid "" 19653"Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with " 19654"B<1>." 19655msgstr "" 19656 19657#. type: TP 19658#: dpkg-vendor.man 19659#, no-wrap 19660msgid "B<--derives-from>I< vendor>" 19661msgstr "" 19662 19663#. type: Plain text 19664#: dpkg-vendor.man 19665msgid "" 19666"Exits with B<0> if the current vendor distribution is a derivative of " 19667"I<vendor>, otherwise exits with B<1>. It uses the B<Parent> field to browse " 19668"all ancestors of the current vendor." 19669msgstr "" 19670 19671#. type: TP 19672#: dpkg-vendor.man 19673#, no-wrap 19674msgid "B<--query>I< field>" 19675msgstr "" 19676 19677#. type: Plain text 19678#: dpkg-vendor.man 19679msgid "" 19680"Print on standard output the value of the vendor-specific I<field> for the " 19681"current vendor." 19682msgstr "" 19683 19684#. type: TP 19685#: dpkg-vendor.man 19686#, no-wrap 19687msgid "B<--vendor>I< vendor>" 19688msgstr "" 19689 19690#. type: Plain text 19691#: dpkg-vendor.man 19692msgid "" 19693"Assumes the current vendor is I<vendor> instead of discovering it with the " 19694"B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>." 19695msgstr "" 19696 19697#. type: Plain text 19698#: dpkg-vendor.man 19699msgid "" 19700"This setting defines the current vendor. If not set, it will discover the " 19701"current vendor by reading B<%PKGCONFDIR%/origins/default>." 19702msgstr "" 19703 19704#. type: Plain text 19705#: dpkg-vendor.man 19706msgid "B<deb-origin>(5)." 19707msgstr "" 19708 19709#. type: TH 19710#: dselect.man 19711#, no-wrap 19712msgid "dselect" 19713msgstr "" 19714 19715#. type: Plain text 19716#: dselect.man 19717msgid "dselect - Debian package management frontend" 19718msgstr "" 19719 19720#. type: Plain text 19721#: dselect.man 19722#, fuzzy 19723#| msgid "B<dpkg> [I<option>...] I<action>" 19724msgid "B<dselect> [I<option>...] [I<command>...]" 19725msgstr "B<dpkg> [I<option>...] I<action>" 19726 19727#. type: Plain text 19728#: dselect.man 19729#, no-wrap 19730msgid "" 19731"B<dselect>\n" 19732"is one of the primary user interfaces for managing packages on a Debian\n" 19733"system. At the B<dselect> main menu, the system administrator can:\n" 19734" - Update the list of available package versions,\n" 19735" - View the status of installed and available packages,\n" 19736" - Alter package selections and manage dependencies,\n" 19737" - Install new packages or upgrade to newer versions.\n" 19738msgstr "" 19739 19740#. type: Plain text 19741#: dselect.man 19742msgid "" 19743"B<dselect> operates as a front-end to B<dpkg>(1), the low-level Debian " 19744"package handling tool. It features a full-screen package selections manager " 19745"with package depends and conflicts resolver. When run with administrator " 19746"privileges, packages can be installed, upgraded and removed. Various access " 19747"methods can be configured to retrieve available package version information " 19748"and installable packages from package repositories. Depending on the used " 19749"access method, these repositories can be public archive servers on the " 19750"internet, local archive servers or cdroms. The recommended access method is " 19751"I<apt>, which is provided by the package B<apt>." 19752msgstr "" 19753 19754#. type: Plain text 19755#: dselect.man 19756msgid "" 19757"Normally B<dselect> is invoked without parameters. An interactive menu is " 19758"presented, offering the user a list of commands. If a command is given as " 19759"argument, then that command is started immediately. Several command line " 19760"parameters are still available to modify the running behaviour of B<dselect> " 19761"or show additional information about the program." 19762msgstr "" 19763 19764#. type: Plain text 19765#: dselect.man 19766#, fuzzy 19767#| msgid "" 19768#| "All options can be specified both on the command line and in the B<dpkg> " 19769#| "configuration file I<%PKGCONFDIR%/dpkg.cfg> or fragment files (with names " 19770#| "matching this shell pattern '[0-9a-zA-Z_-]*') on the configuration " 19771#| "directory I<%PKGCONFDIR%/dpkg.cfg.d/>. Each line in the configuration " 19772#| "file is either an option (exactly the same as the command line option but " 19773#| "without leading hyphens) or a comment (if it starts with a B<#>)." 19774msgid "" 19775"All options can be specified both on the command line and in the B<dselect> " 19776"configuration file I<%PKGCONFDIR%/dselect.cfg> or the files on the " 19777"configuration directory I<%PKGCONFDIR%/dselect.cfg.d/>. Each line in the " 19778"configuration file is either an option (exactly the same as the command line " 19779"option but without leading hyphens) or a comment (if it starts with a " 19780"‘B<#>’)." 19781msgstr "" 19782"所有选项都可以在命令行中或者在 B<dpkg> 配置文件 I<%PKGCONFDIR%/dpkg.cfg> 中指" 19783"定，在配置目录 I<%PKGCONFDIR%/dpkg.cfg.d/> 里的零碎文件中指定也可（零碎文件需" 19784"要匹配 shell 模式 '[0-9a-zA-Z_-]*'）。配置文件中的每一行可以是选项（与命令行" 19785"选项一致，但无需连字符）也可以是注释（以 B<#> 开头）。" 19786 19787#. type: Plain text 19788#: dselect.man 19789msgid "" 19790"Changes the directory where the dpkg ‘I<status>’, ‘I<available>’ and similar " 19791"files are located. This defaults to I<%ADMINDIR%> and normally there " 19792"shouldn't be any need to change it." 19793msgstr "" 19794 19795#. type: TP 19796#: dselect.man 19797#, fuzzy, no-wrap 19798#| msgid "B<-D>I<octal>B<, --debug=>I<octal>" 19799msgid "B<-D>I<file>, B<--debug> I<file>" 19800msgstr "B<-D>I<octal>B<, --debug=>I<octal>" 19801 19802#. type: Plain text 19803#: dselect.man 19804msgid "Turn on debugging. Debugging information is sent to I<file>." 19805msgstr "" 19806 19807#. type: TP 19808#: dselect.man 19809#, no-wrap 19810msgid "B<--expert>" 19811msgstr "" 19812 19813#. type: Plain text 19814#: dselect.man 19815msgid "" 19816"Turns on expert mode, i.e. doesn't display possibly annoying help messages." 19817msgstr "" 19818 19819#. type: TP 19820#: dselect.man 19821#, no-wrap 19822msgid "B<--colour>|B<--color> I<screenpart>:[I<foreground>],[I<background>][:I<attr>[I<+attr>]...]" 19823msgstr "" 19824 19825#. type: Plain text 19826#: dselect.man 19827msgid "" 19828"Configures screen colors. This works only if your display supports colors. " 19829"This option may be used multiple times (and is best used in I<dselect.cfg>). " 19830"Each use changes the color (and optionally, other attributes) of one part of " 19831"the screen. The parts of the screen (from top to bottom) are:" 19832msgstr "" 19833 19834#. type: TP 19835#: dselect.man 19836#, no-wrap 19837msgid "B<title>" 19838msgstr "" 19839 19840#. type: Plain text 19841#: dselect.man 19842msgid "The screen title." 19843msgstr "" 19844 19845#. type: TP 19846#: dselect.man 19847#, no-wrap 19848msgid "B<listhead>" 19849msgstr "" 19850 19851#. type: Plain text 19852#: dselect.man 19853msgid "The header line above the list of packages." 19854msgstr "" 19855 19856#. type: TP 19857#: dselect.man 19858#, no-wrap 19859msgid "B<list>" 19860msgstr "" 19861 19862#. type: Plain text 19863#: dselect.man 19864msgid "The scrolling list of packages (and also some help text)." 19865msgstr "" 19866 19867#. type: TP 19868#: dselect.man 19869#, no-wrap 19870msgid "B<listsel>" 19871msgstr "" 19872 19873#. type: Plain text 19874#: dselect.man 19875msgid "The selected item in the list." 19876msgstr "" 19877 19878#. type: TP 19879#: dselect.man 19880#, no-wrap 19881msgid "B<pkgstate>" 19882msgstr "" 19883 19884#. type: Plain text 19885#: dselect.man 19886msgid "" 19887"In the list of packages, the text indicating the current state of each " 19888"package." 19889msgstr "" 19890 19891#. type: TP 19892#: dselect.man 19893#, no-wrap 19894msgid "B<pkgstatesel>" 19895msgstr "" 19896 19897#. type: Plain text 19898#: dselect.man 19899msgid "" 19900"In the list of packages, the text indicating the current state of the " 19901"currently selected package." 19902msgstr "" 19903 19904#. type: TP 19905#: dselect.man 19906#, no-wrap 19907msgid "B<infohead>" 19908msgstr "" 19909 19910#. type: Plain text 19911#: dselect.man 19912msgid "" 19913"The header line that displays the state of the currently selected package." 19914msgstr "" 19915 19916#. type: TP 19917#: dselect.man 19918#, no-wrap 19919msgid "B<infodesc>" 19920msgstr "" 19921 19922#. type: Plain text 19923#: dselect.man 19924msgid "The package's short description." 19925msgstr "" 19926 19927#. type: TP 19928#: dselect.man 19929#, no-wrap 19930msgid "B<info>" 19931msgstr "" 19932 19933#. type: Plain text 19934#: dselect.man 19935msgid "Used to display package info such as the package's description." 19936msgstr "" 19937 19938#. type: TP 19939#: dselect.man 19940#, no-wrap 19941msgid "B<infofoot>" 19942msgstr "" 19943 19944#. type: Plain text 19945#: dselect.man 19946msgid "The last line of the screen when selecting packages." 19947msgstr "" 19948 19949#. type: TP 19950#: dselect.man 19951#, no-wrap 19952msgid "B<query>" 19953msgstr "" 19954 19955#. type: Plain text 19956#: dselect.man 19957msgid "Used to display query lines" 19958msgstr "" 19959 19960#. type: TP 19961#: dselect.man 19962#, no-wrap 19963msgid "B<helpscreen>" 19964msgstr "" 19965 19966#. type: Plain text 19967#: dselect.man 19968msgid "Color of help screens." 19969msgstr "" 19970 19971#. type: Plain text 19972#: dselect.man 19973msgid "" 19974"After the part of the screen comes a colon and the color specification. You " 19975"can specify either the foreground color, the background color, or both, " 19976"overriding the compiled-in colors. Use standard curses color names." 19977msgstr "" 19978 19979#. type: Plain text 19980#: dselect.man 19981msgid "" 19982"Optionally, after the color specification is another colon, and an attribute " 19983"specification. This is a list of one or more attributes, separated by plus " 19984"(‘+’) characters. Available attributes include (not all of these will work " 19985"on all terminals): B<normal>, B<standout>, B<underline>, B<reverse>, " 19986"B<blink>, B<bright>, B<dim>, B<bold>" 19987msgstr "" 19988 19989#. type: Plain text 19990#: dselect.man 19991msgid "Print a brief help text and exit successfully." 19992msgstr "" 19993 19994#. type: Plain text 19995#: dselect.man 19996msgid "Print version information and exit successfully." 19997msgstr "" 19998 19999#. type: Plain text 20000#: dselect.man 20001msgid "" 20002"When B<dselect> is started it can perform the following commands, either " 20003"directly if it was specified on the command line or by prompting the user " 20004"with a menu of available commands if running interactively:" 20005msgstr "" 20006 20007#. type: SS 20008#: dselect.man 20009#, no-wrap 20010msgid "access" 20011msgstr "" 20012 20013#. type: Plain text 20014#: dselect.man 20015msgid "Choose and configure an access method to access package repositories." 20016msgstr "" 20017 20018#. type: Plain text 20019#: dselect.man 20020msgid "" 20021"By default, B<dselect> provides several methods such as I<cdrom>, " 20022"I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount> " 20023"or I<ftp>, but other packages may provide additional methods, eg. the I<apt> " 20024"access method provided by the B<apt> package." 20025msgstr "" 20026 20027#. type: Plain text 20028#: dselect.man 20029msgid "The use of the I<apt> access method is strongly recommended." 20030msgstr "" 20031 20032#. type: SS 20033#: dselect.man 20034#, no-wrap 20035msgid "update" 20036msgstr "" 20037 20038#. type: Plain text 20039#: dselect.man 20040msgid "Refresh the available packages database." 20041msgstr "" 20042 20043#. type: Plain text 20044#: dselect.man 20045msgid "" 20046"Retrieves a list of available package versions from the package repository, " 20047"configured for the current access method, and update the dpkg database. The " 20048"package lists are commonly provided by the repository as files named " 20049"I<Packages> or I<Packages.gz>. These files can be generated by repository " 20050"maintainers, using the program B<dpkg-scanpackages>(1)." 20051msgstr "" 20052 20053#. type: Plain text 20054#: dselect.man 20055msgid "" 20056"Details of the update command depend on the access method's implementation. " 20057"Normally the process is straightforward and requires no user interaction." 20058msgstr "" 20059 20060#. type: SS 20061#: dselect.man 20062#, no-wrap 20063msgid "select" 20064msgstr "" 20065 20066#. type: Plain text 20067#: dselect.man 20068msgid "View or manage package selections and dependencies." 20069msgstr "" 20070 20071#. type: Plain text 20072#: dselect.man 20073msgid "" 20074"This is the main function of B<dselect>. In the select screen, the user can " 20075"review a list of all available and installed packages. When run with " 20076"administrator privileges, it is also possible to interactively change " 20077"packages selection state. B<dselect> tracks the implications of these " 20078"changes to other depending or conflicting packages." 20079msgstr "" 20080 20081#. type: Plain text 20082#: dselect.man 20083msgid "" 20084"When a conflict or failed depends is detected, a dependency resolution " 20085"subscreen is prompted to the user. In this screen, a list of conflicting or " 20086"depending packages is shown, and for each package listed, the reason for its " 20087"listing is shown. The user may apply the suggestions proposed by B<dselect>, " 20088"override them, or back out all the changes, including the ones that created " 20089"the unresolved depends or conflicts." 20090msgstr "" 20091 20092#. type: Plain text 20093#: dselect.man 20094msgid "" 20095"The use of the interactive package selections management screen is explained " 20096"in more detail below." 20097msgstr "" 20098 20099#. type: SS 20100#: dselect.man 20101#, no-wrap 20102msgid "install" 20103msgstr "" 20104 20105#. type: Plain text 20106#: dselect.man 20107msgid "Installs selected packages." 20108msgstr "" 20109 20110#. type: Plain text 20111#: dselect.man 20112msgid "" 20113"The configured access method will fetch installable or upgradable packages " 20114"from the relevant repositories and install these using B<dpkg>. Depending " 20115"on the implementation of the access method, all packages can be prefetched " 20116"before installation, or fetched when needed. Some access methods may also " 20117"remove packages that were marked for removal." 20118msgstr "" 20119 20120#. type: Plain text 20121#: dselect.man 20122msgid "" 20123"If an error occurred during install, it is usually advisable to run install " 20124"again. In most cases, the problems will disappear or be solved. If problems " 20125"persist or the installation performed was incorrect, please investigate into " 20126"the causes and circumstances, and file a bug in the Debian bug tracking " 20127"system. Instructions on how to do this can be found at https://bugs.debian." 20128"org/ or by reading the documentation for B<bug>(1) or B<reportbug>(1), if " 20129"these are installed." 20130msgstr "" 20131 20132#. type: Plain text 20133#: dselect.man 20134msgid "" 20135"Details of the install command depend on the access method's " 20136"implementation. The user's attention and input may be required during " 20137"installation, configuration or removal of packages. This depends on the " 20138"maintainer scripts in the package. Some packages make use of the " 20139"B<debconf>(1) library, allowing for more flexible or even automated " 20140"installation setups." 20141msgstr "" 20142 20143#. type: SS 20144#: dselect.man 20145#, no-wrap 20146msgid "config" 20147msgstr "" 20148 20149#. type: Plain text 20150#: dselect.man 20151msgid "Configures any previously installed, but not fully configured packages." 20152msgstr "" 20153 20154#. type: SS 20155#: dselect.man 20156#, no-wrap 20157msgid "remove" 20158msgstr "" 20159 20160#. type: Plain text 20161#: dselect.man 20162msgid "Removes or purges installed packages, that are marked for removal." 20163msgstr "" 20164 20165#. type: SS 20166#: dselect.man 20167#, no-wrap 20168msgid "quit" 20169msgstr "" 20170 20171#. type: Plain text 20172#: dselect.man 20173msgid "Quit B<dselect>." 20174msgstr "" 20175 20176#. type: Plain text 20177#: dselect.man 20178msgid "Exits the program with zero (successful) errorcode." 20179msgstr "" 20180 20181#. type: SH 20182#: dselect.man 20183#, no-wrap 20184msgid "PACKAGE SELECTIONS MANAGEMENT" 20185msgstr "" 20186 20187#. type: SS 20188#: dselect.man 20189#, no-wrap 20190msgid "Introduction" 20191msgstr "" 20192 20193#. type: Plain text 20194#: dselect.man 20195msgid "" 20196"B<dselect> directly exposes the administrator to some of the complexities " 20197"involved with managing large sets of packages with many interdependencies. " 20198"For a user who is unfamiliar with the concepts and the ways of the Debian " 20199"package management system, it can be quite overwhelming. Although B<dselect> " 20200"is aimed at easing package management and administration, it is only " 20201"instrumental in doing so and cannot be assumed to be a sufficient substitute " 20202"for administrator skill and understanding. The user is required to be " 20203"familiar with the concepts underlying the Debian packaging system. In case " 20204"of doubt, consult the B<dpkg>(1) manpage and the distribution policy." 20205msgstr "" 20206 20207#. type: Plain text 20208#: dselect.man 20209msgid "" 20210"Unless B<dselect> is run in expert or immediate mode, a help screen is first " 20211"displayed when choosing this command from the menu. The user is I<strongly> " 20212"advised to study all of the information presented in the online help " 20213"screens, when one pops up. The online help screens can at any time be " 20214"invoked with the ‘B<?>’ key." 20215msgstr "" 20216 20217#. type: SS 20218#: dselect.man 20219#, no-wrap 20220msgid "Screen layout" 20221msgstr "" 20222 20223#. type: Plain text 20224#: dselect.man 20225msgid "" 20226"The select screen is by default split in a top and a bottom half. The top " 20227"half shows a list of packages. A cursor bar can select an individual " 20228"package, or a group of packages, if applicable, by selecting the group " 20229"header. The bottom half of the screen shows some details about the package " 20230"currently selected in the top half of the screen. The type of detail that " 20231"is displayed can be varied." 20232msgstr "" 20233 20234#. type: Plain text 20235#: dselect.man 20236msgid "" 20237"Pressing the ‘B<I>’ key toggles a full-screen display of the packages list, " 20238"an enlarged view of the package details, or the equally split screen." 20239msgstr "" 20240 20241#. type: SS 20242#: dselect.man 20243#, no-wrap 20244msgid "Package details view" 20245msgstr "" 20246 20247#. type: Plain text 20248#: dselect.man 20249#, no-wrap 20250msgid "" 20251"The package details view by default shows the extended package description\n" 20252"for the package that is currently selected in the packages status list.\n" 20253"The type of detail can be toggled by pressing the ‘B<i>’ key.\n" 20254"This alternates between:\n" 20255" - the extended description\n" 20256" - the control information for the installed version\n" 20257" - the control information for the available version\n" 20258msgstr "" 20259 20260#. type: Plain text 20261#: dselect.man 20262msgid "" 20263"In a dependency resolution screen, there is also the possibility of viewing " 20264"the specific unresolved depends or conflicts related to the package and " 20265"causing it to be listed." 20266msgstr "" 20267 20268#. type: SS 20269#: dselect.man 20270#, no-wrap 20271msgid "Packages status list" 20272msgstr "" 20273 20274#. type: Plain text 20275#: dselect.man 20276msgid "" 20277"The main select screen displays a list of all packages known to the Debian " 20278"package management system. This includes packages installed on the system " 20279"and packages known from the available packages database." 20280msgstr "" 20281 20282#. type: Plain text 20283#: dselect.man 20284msgid "" 20285"For every package, the list shows the package's status, priority, section, " 20286"installed and available architecture, installed and available versions, the " 20287"package name and its short description, all in one line. By pressing the " 20288"‘B<A>’ key, the display of the installed and available architecture can be " 20289"toggled between on an off. By pressing the ‘B<V>’ key, the display of the " 20290"installed and available version can be toggled between on an off. By " 20291"pressing the ‘B<v>’ key, the package status display is toggled between " 20292"verbose and shorthand. Shorthand display is the default." 20293msgstr "" 20294 20295#. type: Plain text 20296#: dselect.man 20297msgid "" 20298"The shorthand status indication consists of four parts: an error flag, which " 20299"should normally be clear, the current status, the last selection state and " 20300"the current selection state. The first two relate to the actual state of " 20301"the package, the second pair are about the selections set by the user." 20302msgstr "" 20303 20304#. type: Plain text 20305#: dselect.man 20306#, no-wrap 20307msgid "" 20308"These are the meanings of the shorthand package status indicator codes:\n" 20309" Error flag:\n" 20310" I<empty> no error\n" 20311" B<R> serious error, needs reinstallation;\n" 20312" Installed state:\n" 20313" I<empty> not installed;\n" 20314" B<*> fully installed and configured;\n" 20315" B<-> not installed but some config files may remain;\n" 20316" B<U> unpacked but not yet configured;\n" 20317" B<C> half-configured (an error happened);\n" 20318" B<I> half-installed (an error happened).\n" 20319" Current and requested selections:\n" 20320" B<*> marked for installation or upgrade;\n" 20321" B<-> marked for removal, configuration files remain;\n" 20322" B<=> on hold: package will not be processed at all;\n" 20323" B<_> marked for purge, also remove configuration;\n" 20324" B<n> package is new and has yet to be marked.\n" 20325msgstr "" 20326 20327#. type: SS 20328#: dselect.man 20329#, no-wrap 20330msgid "Cursor and screen movement" 20331msgstr "" 20332 20333#. type: Plain text 20334#: dselect.man 20335msgid "" 20336"The package selection list and the dependency conflict resolution screens " 20337"can be navigated using motion commands mapped to the following keys:" 20338msgstr "" 20339 20340#. type: Plain text 20341#: dselect.man 20342#, no-wrap 20343msgid "" 20344" B<p, Up, k> move cursor bar up\n" 20345" B<n, Down, j> move cursor bar down\n" 20346" B<P, Pgup, Backspace> scroll list 1 page up\n" 20347" B<N, Pgdn, Space> scroll list 1 page down\n" 20348" B<^p> scroll list 1 line up\n" 20349" B<^n> scroll list 1 line down\n" 20350" B<t, Home> jump to top of list\n" 20351" B<e, End> jump to end of list\n" 20352" B<u> scroll info 1 page up\n" 20353" B<d> scroll info 1 page down\n" 20354" B<^u> scroll info 1 line up\n" 20355" B<^d> scroll info 1 line down\n" 20356" B<B, Left-arrow> pan display 1/3 screen left\n" 20357" B<F, Right-arrow> pan display 1/3 screen right\n" 20358" B<^b> pan display 1 character left\n" 20359" B<^f> pan display 1 character right\n" 20360msgstr "" 20361 20362#. type: SS 20363#: dselect.man 20364#, no-wrap 20365msgid "Searching and sorting" 20366msgstr "" 20367 20368#. type: Plain text 20369#: dselect.man 20370msgid "" 20371"The list of packages can be searched by package name. This is done by " 20372"pressing ‘B</>’, and typing a simple search string. The string is " 20373"interpreted as a B<regex>(7) regular expression. If you add ‘B</d>’ to the " 20374"search expression, dselect will also search in descriptions. If you add ‘B</" 20375"i>’ the search will be case insensitive. You may combine these two suffixes " 20376"like this: ‘B</id>’. Repeated searching is accomplished by repeatedly " 20377"pressing the ‘B<n>’ or ‘B<\\e>’ keys, until the wanted package is found. If " 20378"the search reaches the bottom of the list, it wraps to the top and continues " 20379"searching from there." 20380msgstr "" 20381 20382#. type: Plain text 20383#: dselect.man 20384#, no-wrap 20385msgid "" 20386"The list sort order can be varied by pressing\n" 20387"the ‘B<o>’ and ‘B<O>’ keys repeatedly.\n" 20388"The following nine sort orderings can be selected:\n" 20389" alphabet available status\n" 20390" priority+section available+priority status+priority\n" 20391" section+priority available+section status+section\n" 20392msgstr "" 20393 20394#. type: Plain text 20395#: dselect.man 20396msgid "" 20397"Where not listed above explicitly, alphabetic order is used as the final " 20398"subordering sort key." 20399msgstr "" 20400 20401#. type: SS 20402#: dselect.man 20403#, no-wrap 20404msgid "Altering selections" 20405msgstr "" 20406 20407#. type: Plain text 20408#: dselect.man 20409#, no-wrap 20410msgid "" 20411"The requested selection state of individual packages may be\n" 20412"altered with the following commands:\n" 20413" B<+, Insert> install or upgrade\n" 20414" B<=, H> hold in present state and version\n" 20415" B<:, G> unhold: upgrade or leave uninstalled\n" 20416" B<-, Delete> remove, but leave configuration\n" 20417" B<_> remove & purge configuration\n" 20418msgstr "" 20419 20420#. type: Plain text 20421#: dselect.man 20422msgid "" 20423"When the change request results in one or more unsatisfied depends or " 20424"conflicts, B<dselect> prompts the user with a dependency resolution screen. " 20425"This will be further explained below." 20426msgstr "" 20427 20428#. type: Plain text 20429#: dselect.man 20430msgid "" 20431"It is also possible to apply these commands to groups of package selections, " 20432"by pointing the cursor bar onto a group header. The exact grouping of " 20433"packages is dependent on the current list ordering settings." 20434msgstr "" 20435 20436#. type: Plain text 20437#: dselect.man 20438msgid "" 20439"Proper care should be taken when altering large groups of selections, " 20440"because this can instantaneously create large numbers of unresolved depends " 20441"or conflicts, all of which will be listed in one dependency resolution " 20442"screen, making them very hard to handle. In practice, only hold and unhold " 20443"operations are useful when applied to groups." 20444msgstr "" 20445 20446#. type: SS 20447#: dselect.man 20448#, no-wrap 20449msgid "Resolving depends and conflicts" 20450msgstr "" 20451 20452#. type: Plain text 20453#: dselect.man 20454msgid "" 20455"When the change request results in one or more unsatisfied depends or " 20456"conflicts, B<dselect> prompts the user with a dependency resolution screen. " 20457"First however, an informative help screen is displayed." 20458msgstr "" 20459 20460#. type: Plain text 20461#: dselect.man 20462msgid "" 20463"The top half of this screen lists all the packages that will have unresolved " 20464"depends or conflicts, as a result of the requested change, and all the " 20465"packages whose installation can resolve any of these depends or whose " 20466"removal can resolve any of the conflicts. The bottom half defaults to show " 20467"the depends or conflicts that cause the currently selected package to be " 20468"listed." 20469msgstr "" 20470 20471#. type: Plain text 20472#: dselect.man 20473msgid "" 20474"When the sublist of packages is displayed initially, B<dselect> may have " 20475"already set the requested selection status of some of the listed packages, " 20476"in order to resolve the depends or conflicts that caused the dependency " 20477"resolution screen to be displayed. Usually, it is best to follow up the " 20478"suggestions made by B<dselect>." 20479msgstr "" 20480 20481#. type: Plain text 20482#: dselect.man 20483msgid "" 20484"The listed packages' selection state may be reverted to the original " 20485"settings, as they were before the unresolved depends or conflicts were " 20486"created, by pressing the ‘B<R>’ key. By pressing the ‘B<D>’ key, the " 20487"automatic suggestions are reset, but the change that caused the dependency " 20488"resolution screen to be prompted is kept as requested. Finally, by pressing " 20489"‘B<U>’, the selections are again set to the automatic suggestion values." 20490msgstr "" 20491 20492#. type: SS 20493#: dselect.man 20494#, no-wrap 20495msgid "Establishing the requested selections" 20496msgstr "" 20497 20498#. type: Plain text 20499#: dselect.man 20500msgid "" 20501"By pressing B<enter>, the currently displayed set of selections is accepted. " 20502"If B<dselect> detects no unresolved depends as a result of the requested " 20503"selections, the new selections will be set. However, if there are any " 20504"unresolved depends, B<dselect> will again prompt the user with a dependency " 20505"resolution screen." 20506msgstr "" 20507 20508#. type: Plain text 20509#: dselect.man 20510msgid "" 20511"To alter a set of selections that creates unresolved depends or conflicts " 20512"and forcing B<dselect> to accept it, press the ‘B<Q>’ key. This sets the " 20513"selections as specified by the user, unconditionally. Generally, don't do " 20514"this unless you've read the fine print." 20515msgstr "" 20516 20517#. type: Plain text 20518#: dselect.man 20519msgid "" 20520"The opposite effect, to back out any selections change requests and go back " 20521"to the previous list of selections, is attained by pressing the ‘B<X>’ or " 20522"B<escape> keys. By repeatedly pressing these keys, any possibly detrimental " 20523"changes to the requested package selections can be backed out completely to " 20524"the last established settings." 20525msgstr "" 20526 20527#. type: Plain text 20528#: dselect.man 20529msgid "" 20530"If you mistakenly establish some settings and wish to revert all the " 20531"selections to what is currently installed on the system, press the ‘B<C>’ " 20532"key. This is somewhat similar to using the unhold command on all packages, " 20533"but provides a more obvious panic button in cases where the user pressed " 20534"B<enter> by accident." 20535msgstr "" 20536 20537#. type: Plain text 20538#: dselect.man 20539msgid "The requested command was successfully performed." 20540msgstr "" 20541 20542#. type: Plain text 20543#: dselect.man 20544msgid "" 20545"If set, B<dselect> will use it as the directory from which to read the user " 20546"specific configuration file." 20547msgstr "" 20548 20549#. type: Plain text 20550#: dselect.man 20551msgid "" 20552"The B<dselect> package selection interface is confusing to some new users. " 20553"Reportedly, it even makes seasoned kernel developers cry." 20554msgstr "" 20555 20556#. type: Plain text 20557#: dselect.man 20558msgid "The documentation is lacking." 20559msgstr "" 20560 20561#. type: Plain text 20562#: dselect.man 20563msgid "There is no help option in the main menu." 20564msgstr "" 20565 20566#. type: Plain text 20567#: dselect.man 20568msgid "The visible list of available packages cannot be reduced." 20569msgstr "" 20570 20571#. type: Plain text 20572#: dselect.man 20573msgid "" 20574"The built in access methods can no longer stand up to current quality " 20575"standards. Use the access method provided by apt, it is not only not broken, " 20576"it is also much more flexible than the built in access methods." 20577msgstr "" 20578 20579#. type: Plain text 20580#: dselect.man 20581msgid "B<dpkg>(1), B<apt-get>(8), B<sources.list>(5), B<deb>(5)." 20582msgstr "" 20583 20584#. type: TH 20585#: dselect.cfg.man 20586#, no-wrap 20587msgid "dselect.cfg" 20588msgstr "" 20589 20590#. type: Plain text 20591#: dselect.cfg.man 20592msgid "dselect.cfg - dselect configuration file" 20593msgstr "" 20594 20595#. type: Plain text 20596#: dselect.cfg.man 20597msgid "" 20598"This file contains default options for dselect. Each line contains a single " 20599"option which is exactly the same as a normal command line option for dselect " 20600"except for the leading hyphens which are not used here. Quotes surrounding " 20601"option values are stripped. Comments are allowed by starting a line with a " 20602"hash sign (‘B<#>’)." 20603msgstr "" 20604 20605#. type: Plain text 20606#: dselect.cfg.man 20607msgid "I<%PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*>" 20608msgstr "" 20609 20610#. type: Plain text 20611#: dselect.cfg.man 20612msgid "I<%PKGCONFDIR%/dselect.cfg>" 20613msgstr "" 20614 20615#. type: Plain text 20616#: dselect.cfg.man 20617msgid "I<~/.dselect.cfg>" 20618msgstr "" 20619 20620#. type: Plain text 20621#: dselect.cfg.man 20622msgid "B<dselect>(1)." 20623msgstr "" 20624 20625#. type: TH 20626#: start-stop-daemon.man 20627#, no-wrap 20628msgid "start-stop-daemon" 20629msgstr "" 20630 20631#. type: Plain text 20632#: start-stop-daemon.man 20633msgid "start-stop-daemon - start and stop system daemon programs" 20634msgstr "" 20635 20636#. type: Plain text 20637#: start-stop-daemon.man 20638msgid "B<start-stop-daemon> [I<option>...] I<command>" 20639msgstr "" 20640 20641#. type: Plain text 20642#: start-stop-daemon.man 20643msgid "" 20644"B<start-stop-daemon> is used to control the creation and termination of " 20645"system-level processes. Using one of the matching options, B<start-stop-" 20646"daemon> can be configured to find existing instances of a running process." 20647msgstr "" 20648 20649#. type: Plain text 20650#: start-stop-daemon.man 20651msgid "" 20652"Note: unless B<--pid> or B<--pidfile> are specified, B<start-stop-daemon> " 20653"behaves similar to B<killall>(1). B<start-stop-daemon> will scan the " 20654"process table looking for any processes which match the process name, parent " 20655"pid, uid, and/or gid (if specified). Any matching process will prevent B<--" 20656"start> from starting the daemon. All matching processes will be sent the " 20657"TERM signal (or the one specified via B<--signal> or B<--retry>) if B<--" 20658"stop> is specified. For daemons which have long-lived children which need to " 20659"live through a B<--stop>, you must specify a pidfile." 20660msgstr "" 20661 20662#. type: TP 20663#: start-stop-daemon.man 20664#, no-wrap 20665msgid "B<-S>, B<--start> [B<-->] I<arguments>" 20666msgstr "" 20667 20668#. type: Plain text 20669#: start-stop-daemon.man 20670msgid "" 20671"Check for the existence of a specified process. If such a process exists, " 20672"B<start-stop-daemon> does nothing, and exits with error status 1 (0 if B<--" 20673"oknodo> is specified). If such a process does not exist, it starts an " 20674"instance, using either the executable specified by B<--exec> or, if " 20675"specified, by B<--startas>. Any arguments given after B<--> on the command " 20676"line are passed unmodified to the program being started." 20677msgstr "" 20678 20679#. type: TP 20680#: start-stop-daemon.man 20681#, no-wrap 20682msgid "B<-K>, B<--stop>" 20683msgstr "" 20684 20685#. type: Plain text 20686#: start-stop-daemon.man 20687msgid "" 20688"Checks for the existence of a specified process. If such a process exists, " 20689"B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits " 20690"with error status 0. If such a process does not exist, B<start-stop-daemon> " 20691"exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is " 20692"specified, then B<start-stop-daemon> will check that the process(es) have " 20693"terminated." 20694msgstr "" 20695 20696#. type: TP 20697#: start-stop-daemon.man 20698#, no-wrap 20699msgid "B<-T>, B<--status>" 20700msgstr "" 20701 20702#. type: Plain text 20703#: start-stop-daemon.man 20704msgid "" 20705"Check for the existence of a specified process, and returns an exit status " 20706"code, according to the LSB Init Script Actions (since version 1.16.1)." 20707msgstr "" 20708 20709#. type: TP 20710#: start-stop-daemon.man 20711#, no-wrap 20712msgid "B<-H>, B<--help>" 20713msgstr "" 20714 20715#. type: Plain text 20716#: start-stop-daemon.man 20717msgid "Show usage information and exit." 20718msgstr "" 20719 20720#. type: TP 20721#: start-stop-daemon.man 20722#, no-wrap 20723msgid "B<-V>, B<--version>" 20724msgstr "" 20725 20726#. type: Plain text 20727#: start-stop-daemon.man 20728msgid "Show the program version and exit." 20729msgstr "" 20730 20731#. type: SS 20732#: start-stop-daemon.man 20733#, no-wrap 20734msgid "Matching options" 20735msgstr "" 20736 20737#. type: TP 20738#: start-stop-daemon.man 20739#, no-wrap 20740msgid "B<--pid> I<pid>" 20741msgstr "" 20742 20743#. type: Plain text 20744#: start-stop-daemon.man 20745msgid "" 20746"Check for a process with the specified I<pid> (since version 1.17.6). The " 20747"I<pid> must be a number greater than 0." 20748msgstr "" 20749 20750#. type: TP 20751#: start-stop-daemon.man 20752#, no-wrap 20753msgid "B<--ppid> I<ppid>" 20754msgstr "" 20755 20756#. type: Plain text 20757#: start-stop-daemon.man 20758msgid "" 20759"Check for a process with the specified parent pid I<ppid> (since version " 20760"1.17.7). The I<ppid> must be a number greater than 0." 20761msgstr "" 20762 20763#. type: TP 20764#: start-stop-daemon.man 20765#, no-wrap 20766msgid "B<-p>, B<--pidfile> I<pid-file>" 20767msgstr "" 20768 20769#. type: Plain text 20770#: start-stop-daemon.man 20771msgid "Check whether a process has created the file I<pid-file>." 20772msgstr "" 20773 20774#. type: Plain text 20775#: start-stop-daemon.man 20776msgid "" 20777"Note: using this matching option alone might cause unintended processes to " 20778"be acted on, if the old process terminated without being able to remove the " 20779"I<pid-file>." 20780msgstr "" 20781 20782#. type: Plain text 20783#: start-stop-daemon.man 20784msgid "" 20785"B<Warning:> using this match option with a world-writable pidfile or using " 20786"it alone with a daemon that writes the pidfile as an unprivileged (non-" 20787"root) user will be refused with an error (since version 1.19.3) as this is " 20788"a security risk, because either any user can write to it, or if the daemon " 20789"gets compromised, the contents of the pidfile cannot be trusted, and then a " 20790"privileged runner (such as an init script executed as root) would end up " 20791"acting on any system process. Using I</dev/null> is exempt from these " 20792"checks." 20793msgstr "" 20794 20795#. type: TP 20796#: start-stop-daemon.man 20797#, no-wrap 20798msgid "B<-x>, B<--exec> I<executable>" 20799msgstr "" 20800 20801#. type: Plain text 20802#: start-stop-daemon.man 20803msgid "" 20804"Check for processes that are instances of this I<executable>. The " 20805"I<executable> argument should be an absolute pathname. Note: this might not " 20806"work as intended with interpreted scripts, as the executable will point to " 20807"the interpreter. Take into account processes running from inside a chroot " 20808"will also be matched, so other match restrictions might be needed." 20809msgstr "" 20810 20811#. type: TP 20812#: start-stop-daemon.man 20813#, no-wrap 20814msgid "B<-n>, B<--name> I<process-name>" 20815msgstr "" 20816 20817#. type: Plain text 20818#: start-stop-daemon.man 20819msgid "" 20820"Check for processes with the name I<process-name>. The I<process-name> is " 20821"usually the process filename, but it could have been changed by the process " 20822"itself. Note: on most systems this information is retrieved from the process " 20823"comm name from the kernel, which tends to have a relatively short length " 20824"limit (assuming more than 15 characters is non-portable)." 20825msgstr "" 20826 20827#. type: TP 20828#: start-stop-daemon.man 20829#, no-wrap 20830msgid "B<-u>, B<--user> I<username>|I<uid>" 20831msgstr "" 20832 20833#. type: Plain text 20834#: start-stop-daemon.man 20835msgid "" 20836"Check for processes owned by the user specified by I<username> or I<uid>. " 20837"Note: using this matching option alone will cause all processes matching the " 20838"user to be acted on." 20839msgstr "" 20840 20841#. type: SS 20842#: start-stop-daemon.man 20843#, no-wrap 20844msgid "Generic options" 20845msgstr "" 20846 20847#. type: TP 20848#: start-stop-daemon.man 20849#, no-wrap 20850msgid "B<-g>, B<--group> I<group>|I<gid>" 20851msgstr "" 20852 20853#. type: Plain text 20854#: start-stop-daemon.man 20855msgid "Change to I<group> or I<gid> when starting the process." 20856msgstr "" 20857 20858#. type: TP 20859#: start-stop-daemon.man 20860#, no-wrap 20861msgid "B<-s>, B<--signal> I<signal>" 20862msgstr "" 20863 20864#. type: Plain text 20865#: start-stop-daemon.man 20866msgid "" 20867"With B<--stop>, specifies the signal to send to processes being stopped " 20868"(default TERM)." 20869msgstr "" 20870 20871#. type: TP 20872#: start-stop-daemon.man 20873#, no-wrap 20874msgid "B<-R>, B<--retry> I<timeout>|I<schedule>" 20875msgstr "" 20876 20877#. type: Plain text 20878#: start-stop-daemon.man 20879msgid "" 20880"With B<--stop>, specifies that B<start-stop-daemon> is to check whether the " 20881"process(es) do finish. It will check repeatedly whether any matching " 20882"processes are running, until none are. If the processes do not exit it will " 20883"then take further action as determined by the schedule." 20884msgstr "" 20885 20886#. type: Plain text 20887#: start-stop-daemon.man 20888msgid "" 20889"If I<timeout> is specified instead of I<schedule>, then the schedule " 20890"I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the " 20891"signal specified with B<--signal>." 20892msgstr "" 20893 20894#. type: Plain text 20895#: start-stop-daemon.man 20896msgid "" 20897"I<schedule> is a list of at least two items separated by slashes (B</>); " 20898"each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means " 20899"to send that signal, or I<timeout>, which means to wait that many seconds " 20900"for processes to exit, or B<forever>, which means to repeat the rest of the " 20901"schedule forever if necessary." 20902msgstr "" 20903 20904#. type: Plain text 20905#: start-stop-daemon.man 20906msgid "" 20907"If the end of the schedule is reached and B<forever> is not specified, then " 20908"B<start-stop-daemon> exits with error status 2. If a schedule is specified, " 20909"then any signal specified with B<--signal> is ignored." 20910msgstr "" 20911 20912#. type: TP 20913#: start-stop-daemon.man 20914#, no-wrap 20915msgid "B<-a>, B<--startas> I<pathname>" 20916msgstr "" 20917 20918#. type: Plain text 20919#: start-stop-daemon.man 20920msgid "" 20921"With B<--start>, start the process specified by I<pathname>. If not " 20922"specified, defaults to the argument given to B<--exec>." 20923msgstr "" 20924 20925#. type: TP 20926#: start-stop-daemon.man 20927#, no-wrap 20928msgid "B<-t>, B<--test>" 20929msgstr "" 20930 20931#. type: Plain text 20932#: start-stop-daemon.man 20933msgid "" 20934"Print actions that would be taken and set appropriate return value, but take " 20935"no action." 20936msgstr "" 20937 20938#. type: TP 20939#: start-stop-daemon.man 20940#, no-wrap 20941msgid "B<-o>, B<--oknodo>" 20942msgstr "" 20943 20944#. type: Plain text 20945#: start-stop-daemon.man 20946msgid "Return exit status 0 instead of 1 if no actions are (would be) taken." 20947msgstr "" 20948 20949#. type: TP 20950#: start-stop-daemon.man 20951#, no-wrap 20952msgid "B<-q>, B<--quiet>" 20953msgstr "" 20954 20955#. type: Plain text 20956#: start-stop-daemon.man 20957msgid "Do not print informational messages; only display error messages." 20958msgstr "" 20959 20960#. type: TP 20961#: start-stop-daemon.man 20962#, no-wrap 20963msgid "B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]" 20964msgstr "" 20965 20966#. type: Plain text 20967#: start-stop-daemon.man 20968msgid "" 20969"Change to this username/uid before starting the process. You can also " 20970"specify a group by appending a B<:>, then the group or gid in the same way " 20971"as you would for the B<chown>(1) command (I<user>B<:>I<group>). If a user " 20972"is specified without a group, the primary GID for that user is used. When " 20973"using this option you must realize that the primary and supplemental groups " 20974"are set as well, even if the B<--group> option is not specified. The B<--" 20975"group> option is only for groups that the user isn't normally a member of " 20976"(like adding per process group membership for generic users like B<nobody>)." 20977msgstr "" 20978 20979#. type: TP 20980#: start-stop-daemon.man 20981#, no-wrap 20982msgid "B<-r>, B<--chroot> I<root>" 20983msgstr "" 20984 20985#. type: Plain text 20986#: start-stop-daemon.man 20987msgid "" 20988"Chdir and chroot to I<root> before starting the process. Please note that " 20989"the pidfile is also written after the chroot." 20990msgstr "" 20991 20992#. type: TP 20993#: start-stop-daemon.man 20994#, no-wrap 20995msgid "B<-d>, B<--chdir> I<path>" 20996msgstr "" 20997 20998#. type: Plain text 20999#: start-stop-daemon.man 21000msgid "" 21001"Chdir to I<path> before starting the process. This is done after the chroot " 21002"if the B<-r>|B<--chroot> option is set. When not specified, B<start-stop-" 21003"daemon> will chdir to the root directory before starting the process." 21004msgstr "" 21005 21006#. type: TP 21007#: start-stop-daemon.man 21008#, no-wrap 21009msgid "B<-b>, B<--background>" 21010msgstr "" 21011 21012#. type: Plain text 21013#: start-stop-daemon.man 21014msgid "" 21015"Typically used with programs that don't detach on their own. This option " 21016"will force B<start-stop-daemon> to fork before starting the process, and " 21017"force it into the background. B<Warning: start-stop-daemon> cannot check " 21018"the exit status if the process fails to execute for B<any> reason. This is a " 21019"last resort, and is only meant for programs that either make no sense " 21020"forking on their own, or where it's not feasible to add the code for them to " 21021"do this themselves." 21022msgstr "" 21023 21024#. type: TP 21025#: start-stop-daemon.man 21026#, fuzzy, no-wrap 21027#| msgid "B<--version>" 21028msgid "B<--notify-await>" 21029msgstr "B<--version>" 21030 21031#. type: Plain text 21032#: start-stop-daemon.man 21033msgid "" 21034"Wait for the background process to send a readiness notification before " 21035"considering the service started (since version 1.19.3). This implements " 21036"parts of the systemd readiness protocol, as specified in the B<sd_notify>(3) " 21037"man page. The following variables are supported:" 21038msgstr "" 21039 21040#. type: TP 21041#: start-stop-daemon.man 21042#, no-wrap 21043msgid "B<READY=1>" 21044msgstr "" 21045 21046#. type: Plain text 21047#: start-stop-daemon.man 21048msgid "The program is ready to give service, so we can exit safely." 21049msgstr "" 21050 21051#. type: TP 21052#: start-stop-daemon.man 21053#, no-wrap 21054msgid "B<EXTEND_TIMEOUT_USEC=>I<number>" 21055msgstr "" 21056 21057#. type: Plain text 21058#: start-stop-daemon.man 21059msgid "" 21060"The program requests to extend the timeout by I<number> microseconds. This " 21061"will reset the current timeout to the specified value." 21062msgstr "" 21063 21064#. type: TP 21065#: start-stop-daemon.man 21066#, fuzzy, no-wrap 21067#| msgid "B<--abort-after=>I<number>" 21068msgid "B<ERRNO=>I<number>" 21069msgstr "B<--abort-after=>I<number>" 21070 21071#. type: Plain text 21072#: start-stop-daemon.man 21073msgid "" 21074"The program is exiting with an error. Do the same and print the user-" 21075"friendly string for the B<errno> value." 21076msgstr "" 21077 21078#. type: TP 21079#: start-stop-daemon.man 21080#, no-wrap 21081msgid "B<--notify-timeout>I<timeout>" 21082msgstr "" 21083 21084#. type: Plain text 21085#: start-stop-daemon.man 21086msgid "" 21087"Set a timeout for the B<--notify-await> option (since version 1.19.3). When " 21088"the timeout is reached, B<start-stop-daemon> will exit with an error code, " 21089"and no readiness notification will be awaited. The default is B<60> seconds." 21090msgstr "" 21091 21092#. type: TP 21093#: start-stop-daemon.man 21094#, no-wrap 21095msgid "B<-C>, B<--no-close>" 21096msgstr "" 21097 21098#. type: Plain text 21099#: start-stop-daemon.man 21100msgid "" 21101"Do not close any file descriptor when forcing the daemon into the background " 21102"(since version 1.16.5). Used for debugging purposes to see the process " 21103"output, or to redirect file descriptors to log the process output. Only " 21104"relevant when using B<--background>." 21105msgstr "" 21106 21107#. type: TP 21108#: start-stop-daemon.man 21109#, no-wrap 21110msgid "B<-N>, B<--nicelevel> I<int>" 21111msgstr "" 21112 21113#. type: Plain text 21114#: start-stop-daemon.man 21115msgid "This alters the priority of the process before starting it." 21116msgstr "" 21117 21118#. type: TP 21119#: start-stop-daemon.man 21120#, no-wrap 21121msgid "B<-P>, B<--procsched> I<policy>B<:>I<priority>" 21122msgstr "" 21123 21124#. type: Plain text 21125#: start-stop-daemon.man 21126msgid "" 21127"This alters the process scheduler policy and priority of the process before " 21128"starting it (since version 1.15.0). The priority can be optionally " 21129"specified by appending a B<:> followed by the value. The default I<priority> " 21130"is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>." 21131msgstr "" 21132 21133#. type: TP 21134#: start-stop-daemon.man 21135#, no-wrap 21136msgid "B<-I>, B<--iosched> I<class>B<:>I<priority>" 21137msgstr "" 21138 21139#. type: Plain text 21140#: start-stop-daemon.man 21141msgid "" 21142"This alters the IO scheduler class and priority of the process before " 21143"starting it (since version 1.15.0). The priority can be optionally " 21144"specified by appending a B<:> followed by the value. The default I<priority> " 21145"is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The " 21146"currently supported values for I<class> are B<idle>, B<best-effort> and " 21147"B<real-time>." 21148msgstr "" 21149 21150#. type: TP 21151#: start-stop-daemon.man 21152#, no-wrap 21153msgid "B<-k>, B<--umask> I<mask>" 21154msgstr "" 21155 21156#. type: Plain text 21157#: start-stop-daemon.man 21158msgid "" 21159"This sets the umask of the process before starting it (since version " 21160"1.13.22)." 21161msgstr "" 21162 21163#. type: TP 21164#: start-stop-daemon.man 21165#, no-wrap 21166msgid "B<-m>, B<--make-pidfile>" 21167msgstr "" 21168 21169#. type: Plain text 21170#: start-stop-daemon.man 21171msgid "" 21172"Used when starting a program that does not create its own pid file. This " 21173"option will make B<start-stop-daemon> create the file referenced with B<--" 21174"pidfile> and place the pid into it just before executing the process. Note, " 21175"the file will only be removed when stopping the program if B<--remove-" 21176"pidfile> is used. B<Note:> This feature may not work in all cases. Most " 21177"notably when the program being executed forks from its main process. Because " 21178"of this, it is usually only useful when combined with the B<--background> " 21179"option." 21180msgstr "" 21181 21182#. type: TP 21183#: start-stop-daemon.man 21184#, no-wrap 21185msgid "B<--remove-pidfile>" 21186msgstr "" 21187 21188#. type: Plain text 21189#: start-stop-daemon.man 21190msgid "" 21191"Used when stopping a program that does not remove its own pid file (since " 21192"version 1.17.19). This option will make B<start-stop-daemon> remove the " 21193"file referenced with B<--pidfile> after terminating the process." 21194msgstr "" 21195 21196#. type: Plain text 21197#: start-stop-daemon.man 21198msgid "Print verbose informational messages." 21199msgstr "" 21200 21201#. type: Plain text 21202#: start-stop-daemon.man 21203msgid "" 21204"The requested action was performed. If B<--oknodo> was specified, it's also " 21205"possible that nothing had to be done. This can happen when B<--start> was " 21206"specified and a matching process was already running, or when B<--stop> was " 21207"specified and there were no matching processes." 21208msgstr "" 21209 21210#. type: Plain text 21211#: start-stop-daemon.man 21212msgid "If B<--oknodo> was not specified and nothing was done." 21213msgstr "" 21214 21215#. type: Plain text 21216#: start-stop-daemon.man 21217msgid "" 21218"If B<--stop> and B<--retry> were specified, but the end of the schedule was " 21219"reached and the processes were still running." 21220msgstr "" 21221 21222#. type: TP 21223#: start-stop-daemon.man 21224#, no-wrap 21225msgid "B<3>" 21226msgstr "" 21227 21228#. type: Plain text 21229#: start-stop-daemon.man 21230msgid "Any other error." 21231msgstr "" 21232 21233#. type: Plain text 21234#: start-stop-daemon.man 21235msgid "" 21236"When using the B<--status> command, the following status codes are returned:" 21237msgstr "" 21238 21239#. type: Plain text 21240#: start-stop-daemon.man 21241msgid "Program is running." 21242msgstr "" 21243 21244#. type: Plain text 21245#: start-stop-daemon.man 21246msgid "Program is not running and the pid file exists." 21247msgstr "" 21248 21249#. type: Plain text 21250#: start-stop-daemon.man 21251msgid "Program is not running." 21252msgstr "" 21253 21254#. type: TP 21255#: start-stop-daemon.man 21256#, no-wrap 21257msgid "B<4>" 21258msgstr "" 21259 21260#. type: Plain text 21261#: start-stop-daemon.man 21262msgid "Unable to determine program status." 21263msgstr "" 21264 21265#. type: Plain text 21266#: start-stop-daemon.man 21267msgid "" 21268"Start the B<food> daemon, unless one is already running (a process named " 21269"food, running as user food, with pid in food.pid):" 21270msgstr "" 21271 21272#. type: Plain text 21273#: start-stop-daemon.man 21274#, no-wrap 21275msgid "" 21276"start-stop-daemon --start --oknodo --user food --name food \\e\n" 21277"\t--pidfile /run/food.pid --startas /usr/sbin/food \\e\n" 21278"\t--chuid food -- --daemon\n" 21279msgstr "" 21280 21281#. type: Plain text 21282#: start-stop-daemon.man 21283msgid "Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:" 21284msgstr "" 21285 21286#. type: Plain text 21287#: start-stop-daemon.man 21288#, no-wrap 21289msgid "" 21290"start-stop-daemon --stop --oknodo --user food --name food \\e\n" 21291"\t--pidfile /run/food.pid --retry 5\n" 21292msgstr "" 21293 21294#. type: Plain text 21295#: start-stop-daemon.man 21296msgid "Demonstration of a custom schedule for stopping B<food>:" 21297msgstr "" 21298 21299#. type: Plain text 21300#: start-stop-daemon.man 21301#, no-wrap 21302msgid "" 21303"start-stop-daemon --stop --oknodo --user food --name food \\e\n" 21304"\t--pidfile /run/food.pid --retry=TERM/30/KILL/5\n" 21305msgstr "" 21306 21307#. type: TH 21308#: update-alternatives.man 21309#, no-wrap 21310msgid "update-alternatives" 21311msgstr "" 21312 21313#. type: Plain text 21314#: update-alternatives.man 21315msgid "" 21316"update-alternatives - maintain symbolic links determining default commands" 21317msgstr "" 21318 21319#. type: Plain text 21320#: update-alternatives.man 21321msgid "B<update-alternatives> [I<option>...] I<command>" 21322msgstr "" 21323 21324#. type: Plain text 21325#: update-alternatives.man 21326msgid "" 21327"B<update-alternatives> creates, removes, maintains and displays information " 21328"about the symbolic links comprising the Debian alternatives system." 21329msgstr "" 21330 21331#. type: Plain text 21332#: update-alternatives.man 21333msgid "" 21334"It is possible for several programs fulfilling the same or similar functions " 21335"to be installed on a single system at the same time. For example, many " 21336"systems have several text editors installed at once. This gives choice to " 21337"the users of a system, allowing each to use a different editor, if desired, " 21338"but makes it difficult for a program to make a good choice for an editor to " 21339"invoke if the user has not specified a particular preference." 21340msgstr "" 21341 21342#. type: Plain text 21343#: update-alternatives.man 21344msgid "" 21345"Debian's alternatives system aims to solve this problem. A generic name in " 21346"the filesystem is shared by all files providing interchangeable " 21347"functionality. The alternatives system and the system administrator " 21348"together determine which actual file is referenced by this generic name. " 21349"For example, if the text editors B<ed>(1) and B<nvi>(1) are both installed " 21350"on the system, the alternatives system will cause the generic name I</usr/" 21351"bin/editor> to refer to I</usr/bin/nvi> by default. The system administrator " 21352"can override this and cause it to refer to I</usr/bin/ed> instead, and the " 21353"alternatives system will not alter this setting until explicitly requested " 21354"to do so." 21355msgstr "" 21356 21357#. type: Plain text 21358#: update-alternatives.man 21359msgid "" 21360"The generic name is not a direct symbolic link to the selected alternative. " 21361"Instead, it is a symbolic link to a name in the I<alternatives> " 21362"I<directory>, which in turn is a symbolic link to the actual file " 21363"referenced. This is done so that the system administrator's changes can be " 21364"confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why " 21365"this is a Good Thing." 21366msgstr "" 21367 21368#. type: Plain text 21369#: update-alternatives.man 21370msgid "" 21371"When each package providing a file with a particular functionality is " 21372"installed, changed or removed, B<update-alternatives> is called to update " 21373"information about that file in the alternatives system. B<update-" 21374"alternatives> is usually called from the B<postinst> (configure) or B<prerm> " 21375"(remove and deconfigure) scripts in Debian packages." 21376msgstr "" 21377 21378#. type: Plain text 21379#: update-alternatives.man 21380msgid "" 21381"It is often useful for a number of alternatives to be synchronized, so that " 21382"they are changed as a group; for example, when several versions of the " 21383"B<vi>(1) editor are installed, the man page referenced by I</usr/share/man/" 21384"man1/vi.1> should correspond to the executable referenced by I</usr/bin/" 21385"vi>. B<update-alternatives> handles this by means of I<master> and I<slave> " 21386"links; when the master is changed, any associated slaves are changed too. A " 21387"master link and its associated slaves make up a I<link> I<group>." 21388msgstr "" 21389 21390#. type: Plain text 21391#: update-alternatives.man 21392msgid "" 21393"Each link group is, at any given time, in one of two modes: automatic or " 21394"manual. When a group is in automatic mode, the alternatives system will " 21395"automatically decide, as packages are installed and removed, whether and how " 21396"to update the links. In manual mode, the alternatives system will retain " 21397"the choice of the administrator and avoid changing the links (except when " 21398"something is broken)." 21399msgstr "" 21400 21401#. type: Plain text 21402#: update-alternatives.man 21403msgid "" 21404"Link groups are in automatic mode when they are first introduced to the " 21405"system. If the system administrator makes changes to the system's automatic " 21406"settings, this will be noticed the next time B<update-alternatives> is run " 21407"on the changed link's group, and the group will automatically be switched to " 21408"manual mode." 21409msgstr "" 21410 21411#. type: Plain text 21412#: update-alternatives.man 21413msgid "" 21414"Each alternative has a I<priority> associated with it. When a link group is " 21415"in automatic mode, the alternatives pointed to by members of the group will " 21416"be those which have the highest priority." 21417msgstr "" 21418 21419#. type: Plain text 21420#: update-alternatives.man 21421msgid "" 21422"When using the B<--config> option, B<update-alternatives> will list all of " 21423"the choices for the link group of which given I<name> is the master " 21424"alternative name. The current choice is marked with a ‘*’. You will then " 21425"be prompted for your choice regarding this link group. Depending on the " 21426"choice made, the link group might no longer be in I<auto> mode. You will " 21427"need to use the B<--auto> option in order to return to the automatic mode " 21428"(or you can rerun B<--config> and select the entry marked as automatic)." 21429msgstr "" 21430 21431#. type: Plain text 21432#: update-alternatives.man 21433msgid "" 21434"If you want to configure non-interactively you can use the B<--set> option " 21435"instead (see below)." 21436msgstr "" 21437 21438#. type: Plain text 21439#: update-alternatives.man 21440msgid "" 21441"Different packages providing the same file need to do so B<cooperatively>. " 21442"In other words, the usage of B<update-alternatives> is B<mandatory> for all " 21443"involved packages in such case. It is not possible to override some file in " 21444"a package that does not employ the B<update-alternatives> mechanism." 21445msgstr "" 21446 21447#. type: SH 21448#: update-alternatives.man 21449#, no-wrap 21450msgid "TERMINOLOGY" 21451msgstr "" 21452 21453#. type: Plain text 21454#: update-alternatives.man 21455msgid "" 21456"Since the activities of B<update-alternatives> are quite involved, some " 21457"specific terms will help to explain its operation." 21458msgstr "" 21459 21460#. type: TP 21461#: update-alternatives.man 21462#, no-wrap 21463msgid "generic name (or alternative link)" 21464msgstr "" 21465 21466#. type: Plain text 21467#: update-alternatives.man 21468msgid "" 21469"A name, like I</usr/bin/editor>, which refers, via the alternatives system, " 21470"to one of a number of files of similar function." 21471msgstr "" 21472 21473#. type: TP 21474#: update-alternatives.man 21475#, no-wrap 21476msgid "alternative name" 21477msgstr "" 21478 21479#. type: Plain text 21480#: update-alternatives.man 21481msgid "The name of a symbolic link in the alternatives directory." 21482msgstr "" 21483 21484#. type: TP 21485#: update-alternatives.man 21486#, no-wrap 21487msgid "alternative (or alternative path)" 21488msgstr "" 21489 21490#. type: Plain text 21491#: update-alternatives.man 21492msgid "" 21493"The name of a specific file in the filesystem, which may be made accessible " 21494"via a generic name using the alternatives system." 21495msgstr "" 21496 21497#. type: TP 21498#: update-alternatives.man 21499#, no-wrap 21500msgid "alternatives directory" 21501msgstr "" 21502 21503#. type: Plain text 21504#: update-alternatives.man 21505msgid "" 21506"A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks." 21507msgstr "" 21508 21509#. type: TP 21510#: update-alternatives.man 21511#, no-wrap 21512msgid "administrative directory" 21513msgstr "" 21514 21515#. type: Plain text 21516#: update-alternatives.man 21517msgid "" 21518"A directory, by default I<%ADMINDIR%/alternatives>, containing B<update-" 21519"alternatives>' state information." 21520msgstr "" 21521 21522#. type: TP 21523#: update-alternatives.man 21524#, no-wrap 21525msgid "link group" 21526msgstr "" 21527 21528#. type: Plain text 21529#: update-alternatives.man 21530msgid "A set of related symlinks, intended to be updated as a group." 21531msgstr "" 21532 21533#. type: TP 21534#: update-alternatives.man 21535#, no-wrap 21536msgid "master link" 21537msgstr "" 21538 21539#. type: Plain text 21540#: update-alternatives.man 21541msgid "" 21542"The alternative link in a link group which determines how the other links in " 21543"the group are configured." 21544msgstr "" 21545 21546#. type: TP 21547#: update-alternatives.man 21548#, no-wrap 21549msgid "slave link" 21550msgstr "" 21551 21552#. type: Plain text 21553#: update-alternatives.man 21554msgid "" 21555"An alternative link in a link group which is controlled by the setting of " 21556"the master link." 21557msgstr "" 21558 21559#. type: TP 21560#: update-alternatives.man 21561#, no-wrap 21562msgid "automatic mode" 21563msgstr "" 21564 21565#. type: Plain text 21566#: update-alternatives.man 21567msgid "" 21568"When a link group is in automatic mode, the alternatives system ensures that " 21569"the links in the group point to the highest priority alternative appropriate " 21570"for the group." 21571msgstr "" 21572 21573#. type: TP 21574#: update-alternatives.man 21575#, no-wrap 21576msgid "manual mode" 21577msgstr "" 21578 21579#. type: Plain text 21580#: update-alternatives.man 21581msgid "" 21582"When a link group is in manual mode, the alternatives system will not make " 21583"any changes to the system administrator's settings." 21584msgstr "" 21585 21586#. type: TP 21587#: update-alternatives.man 21588#, no-wrap 21589msgid "B<--install> I<link name path priority> [B<--slave> I<link name path>]..." 21590msgstr "" 21591 21592#. type: Plain text 21593#: update-alternatives.man 21594msgid "" 21595"Add a group of alternatives to the system. I<link> is the generic name for " 21596"the master link, I<name> is the name of its symlink in the alternatives " 21597"directory, and I<path> is the alternative being introduced for the master " 21598"link. The arguments after B<--slave> are the generic name, symlink name in " 21599"the alternatives directory and the alternative path for a slave link. Zero " 21600"or more B<--slave> options, each followed by three arguments, may be " 21601"specified. Note that the master alternative must exist or the call will " 21602"fail. However if a slave alternative doesn't exist, the corresponding slave " 21603"alternative link will simply not be installed (a warning will still be " 21604"displayed). If some real file is installed where an alternative link has to " 21605"be installed, it is kept unless B<--force> is used." 21606msgstr "" 21607 21608#. type: Plain text 21609#: update-alternatives.man 21610msgid "" 21611"If the alternative name specified exists already in the alternatives " 21612"system's records, the information supplied will be added as a new set of " 21613"alternatives for the group. Otherwise, a new group, set to automatic mode, " 21614"will be added with this information. If the group is in automatic mode, and " 21615"the newly added alternatives' priority is higher than any other installed " 21616"alternatives for this group, the symlinks will be updated to point to the " 21617"newly added alternatives." 21618msgstr "" 21619 21620#. type: TP 21621#: update-alternatives.man 21622#, no-wrap 21623msgid "B<--set> I<name path>" 21624msgstr "" 21625 21626#. type: Plain text 21627#: update-alternatives.man 21628msgid "" 21629"Set the program I<path> as alternative for I<name.> This is equivalent to " 21630"B<--config> but is non-interactive and thus scriptable." 21631msgstr "" 21632 21633#. type: TP 21634#: update-alternatives.man 21635#, no-wrap 21636msgid "B<--remove> I<name path>" 21637msgstr "" 21638 21639#. type: Plain text 21640#: update-alternatives.man 21641msgid "" 21642"Remove an alternative and all of its associated slave links. I<name> is a " 21643"name in the alternatives directory, and I<path> is an absolute filename to " 21644"which I<name> could be linked. If I<name> is indeed linked to I<path>, " 21645"I<name> will be updated to point to another appropriate alternative (and the " 21646"group is put back in automatic mode), or removed if there is no such " 21647"alternative left. Associated slave links will be updated or removed, " 21648"correspondingly. If the link is not currently pointing to I<path>, no links " 21649"are changed; only the information about the alternative is removed." 21650msgstr "" 21651 21652#. type: TP 21653#: update-alternatives.man 21654#, no-wrap 21655msgid "B<--remove-all> I<name>" 21656msgstr "" 21657 21658#. type: Plain text 21659#: update-alternatives.man 21660msgid "" 21661"Remove all alternatives and all of their associated slave links. I<name> is " 21662"a name in the alternatives directory." 21663msgstr "" 21664 21665#. type: Plain text 21666#: update-alternatives.man 21667msgid "" 21668"Call B<--config> on all alternatives. It can be usefully combined with B<--" 21669"skip-auto> to review and configure all alternatives which are not configured " 21670"in automatic mode. Broken alternatives are also displayed. Thus a simple " 21671"way to fix all broken alternatives is to call B<yes '' | update-alternatives " 21672"--force --all>." 21673msgstr "" 21674 21675#. type: TP 21676#: update-alternatives.man 21677#, no-wrap 21678msgid "B<--auto> I<name>" 21679msgstr "" 21680 21681#. type: Plain text 21682#: update-alternatives.man 21683msgid "" 21684"Switch the link group behind the alternative for I<name> to automatic mode. " 21685"In the process, the master symlink and its slaves are updated to point to " 21686"the highest priority installed alternatives." 21687msgstr "" 21688 21689#. type: TP 21690#: update-alternatives.man 21691#, no-wrap 21692msgid "B<--display> I<name>" 21693msgstr "" 21694 21695#. type: Plain text 21696#: update-alternatives.man 21697msgid "" 21698"Display information about the link group. Information displayed includes " 21699"the group's mode (auto or manual), the master and slave links, which " 21700"alternative the master link currently points to, what other alternatives are " 21701"available (and their corresponding slave alternatives), and the highest " 21702"priority alternative currently installed." 21703msgstr "" 21704 21705#. type: TP 21706#: update-alternatives.man 21707#, no-wrap 21708msgid "B<--get-selections>" 21709msgstr "" 21710 21711#. type: Plain text 21712#: update-alternatives.man 21713msgid "" 21714"List all master alternative names (those controlling a link group) and " 21715"their status (since version 1.15.0). Each line contains up to 3 fields " 21716"(separated by one or more spaces). The first field is the alternative name, " 21717"the second one is the status (either B<auto> or B<manual>), and the last one " 21718"contains the current choice in the alternative (beware: it's a filename and " 21719"thus might contain spaces)." 21720msgstr "" 21721 21722#. type: Plain text 21723#: update-alternatives.man 21724msgid "" 21725"Read configuration of alternatives on standard input in the format generated " 21726"by B<--get-selections> and reconfigure them accordingly (since version " 21727"1.15.0)." 21728msgstr "" 21729 21730#. type: TP 21731#: update-alternatives.man 21732#, no-wrap 21733msgid "B<--query> I<name>" 21734msgstr "" 21735 21736#. type: Plain text 21737#: update-alternatives.man 21738msgid "" 21739"Display information about the link group like B<--display> does, but in a " 21740"machine parseable way (since version 1.15.0, see section B<QUERY FORMAT> " 21741"below)." 21742msgstr "" 21743 21744#. type: TP 21745#: update-alternatives.man 21746#, no-wrap 21747msgid "B<--list> I<name>" 21748msgstr "" 21749 21750#. type: Plain text 21751#: update-alternatives.man 21752msgid "Display all targets of the link group." 21753msgstr "" 21754 21755#. type: TP 21756#: update-alternatives.man 21757#, no-wrap 21758msgid "B<--config> I<name>" 21759msgstr "" 21760 21761#. type: Plain text 21762#: update-alternatives.man 21763msgid "" 21764"Show available alternatives for a link group and allow the user to " 21765"interactively select which one to use. The link group is updated." 21766msgstr "" 21767 21768#. type: TP 21769#: update-alternatives.man 21770#, no-wrap 21771msgid "B<--altdir>I< directory>" 21772msgstr "" 21773 21774#. type: Plain text 21775#: update-alternatives.man 21776msgid "" 21777"Specifies the alternatives directory, when this is to be different from the " 21778"default." 21779msgstr "" 21780 21781#. type: Plain text 21782#: update-alternatives.man 21783msgid "" 21784"Specifies the administrative directory, when this is to be different from " 21785"the default." 21786msgstr "" 21787 21788#. type: TP 21789#: update-alternatives.man 21790#, no-wrap 21791msgid "B<--log>I< file>" 21792msgstr "" 21793 21794#. type: Plain text 21795#: update-alternatives.man 21796msgid "" 21797"Specifies the log file (since version 1.15.0), when this is to be different " 21798"from the default (%LOGDIR%/alternatives.log)." 21799msgstr "" 21800 21801#. type: Plain text 21802#: update-alternatives.man 21803msgid "" 21804"Allow replacing or dropping any real file that is installed where an " 21805"alternative link has to be installed or removed." 21806msgstr "" 21807 21808#. type: TP 21809#: update-alternatives.man 21810#, no-wrap 21811msgid "B<--skip-auto>" 21812msgstr "" 21813 21814#. type: Plain text 21815#: update-alternatives.man 21816msgid "" 21817"Skip configuration prompt for alternatives which are properly configured in " 21818"automatic mode. This option is only relevant with B<--config> or B<--all>." 21819msgstr "" 21820 21821#. type: Plain text 21822#: update-alternatives.man 21823msgid "Do not generate any comments unless errors occur." 21824msgstr "" 21825 21826#. type: TP 21827#: update-alternatives.man 21828#, no-wrap 21829msgid "B<--verbose>" 21830msgstr "" 21831 21832#. type: Plain text 21833#: update-alternatives.man 21834msgid "Generate more comments about what is being done." 21835msgstr "" 21836 21837#. type: Plain text 21838#: update-alternatives.man 21839msgid "" 21840"Generate even more comments, helpful for debugging, about what is being done " 21841"(since version 1.19.3)." 21842msgstr "" 21843 21844#. type: Plain text 21845#: update-alternatives.man 21846msgid "" 21847"Problems were encountered whilst parsing the command line or performing the " 21848"action." 21849msgstr "" 21850 21851#. type: Plain text 21852#: update-alternatives.man 21853msgid "" 21854"If set and the B<--admindir> option has not been specified, it will be used " 21855"as the base administrative directory." 21856msgstr "" 21857 21858#. type: TP 21859#: update-alternatives.man 21860#, no-wrap 21861msgid "I<%CONFDIR%/alternatives/>" 21862msgstr "" 21863 21864#. type: Plain text 21865#: update-alternatives.man 21866msgid "" 21867"The default alternatives directory. Can be overridden by the B<--altdir> " 21868"option." 21869msgstr "" 21870 21871#. type: TP 21872#: update-alternatives.man 21873#, no-wrap 21874msgid "I<%ADMINDIR%/alternatives/>" 21875msgstr "" 21876 21877#. type: Plain text 21878#: update-alternatives.man 21879msgid "" 21880"The default administration directory. Can be overridden by the B<--" 21881"admindir> option." 21882msgstr "" 21883 21884#. type: SH 21885#: update-alternatives.man 21886#, no-wrap 21887msgid "QUERY FORMAT" 21888msgstr "" 21889 21890#. type: Plain text 21891#: update-alternatives.man 21892msgid "" 21893"The B<--query> format is using an RFC822-like flat format. It's made of I<n> " 21894"+ 1 blocks where I<n> is the number of alternatives available in the queried " 21895"link group. The first block contains the following fields:" 21896msgstr "" 21897 21898#. type: TP 21899#: update-alternatives.man 21900#, no-wrap 21901msgid "B<Name:>I< name>" 21902msgstr "" 21903 21904#. type: Plain text 21905#: update-alternatives.man 21906msgid "The alternative name in the alternative directory." 21907msgstr "" 21908 21909#. type: TP 21910#: update-alternatives.man 21911#, no-wrap 21912msgid "B<Link:>I< link>" 21913msgstr "" 21914 21915#. type: Plain text 21916#: update-alternatives.man 21917msgid "The generic name of the alternative." 21918msgstr "" 21919 21920#. type: TP 21921#: update-alternatives.man 21922#, no-wrap 21923msgid "B<Slaves:>I< list-of-slaves>" 21924msgstr "" 21925 21926#. type: Plain text 21927#: update-alternatives.man 21928msgid "" 21929"When this field is present, the B<next> lines hold all slave links " 21930"associated to the master link of the alternative. There is one slave per " 21931"line. Each line contains one space, the generic name of the slave " 21932"alternative, another space, and the path to the slave link." 21933msgstr "" 21934 21935#. type: TP 21936#: update-alternatives.man 21937#, no-wrap 21938msgid "B<Status:>I< status>" 21939msgstr "" 21940 21941#. type: Plain text 21942#: update-alternatives.man 21943msgid "The status of the alternative (B<auto> or B<manual>)." 21944msgstr "" 21945 21946#. type: TP 21947#: update-alternatives.man 21948#, no-wrap 21949msgid "B<Best:>I< best-choice>" 21950msgstr "" 21951 21952#. type: Plain text 21953#: update-alternatives.man 21954msgid "" 21955"The path of the best alternative for this link group. Not present if there " 21956"is no alternatives available." 21957msgstr "" 21958 21959#. type: TP 21960#: update-alternatives.man 21961#, no-wrap 21962msgid "B<Value:>I< currently-selected-alternative>" 21963msgstr "" 21964 21965#. type: Plain text 21966#: update-alternatives.man 21967msgid "" 21968"The path of the currently selected alternative. It can also take the magic " 21969"value B<none>. It is used if the link doesn't exist." 21970msgstr "" 21971 21972#. type: Plain text 21973#: update-alternatives.man 21974msgid "" 21975"The other blocks describe the available alternatives in the queried link " 21976"group:" 21977msgstr "" 21978 21979#. type: TP 21980#: update-alternatives.man 21981#, no-wrap 21982msgid "B<Alternative:>I< path-of-this-alternative>" 21983msgstr "" 21984 21985#. type: Plain text 21986#: update-alternatives.man 21987msgid "Path to this block's alternative." 21988msgstr "" 21989 21990#. type: TP 21991#: update-alternatives.man 21992#, no-wrap 21993msgid "B<Priority:>I< priority-value>" 21994msgstr "" 21995 21996#. type: Plain text 21997#: update-alternatives.man 21998msgid "Value of the priority of this alternative." 21999msgstr "" 22000 22001#. type: Plain text 22002#: update-alternatives.man 22003msgid "" 22004"When this field is present, the B<next> lines hold all slave alternatives " 22005"associated to the master link of the alternative. There is one slave per " 22006"line. Each line contains one space, the generic name of the slave " 22007"alternative, another space, and the path to the slave alternative." 22008msgstr "" 22009 22010#. type: SS 22011#: update-alternatives.man 22012#, no-wrap 22013msgid "Example" 22014msgstr "" 22015 22016#. type: Plain text 22017#: update-alternatives.man 22018#, no-wrap 22019msgid "" 22020"$ update-alternatives --query editor\n" 22021"Name: editor\n" 22022"Link: /usr/bin/editor\n" 22023"Slaves:\n" 22024" editor.1.gz /usr/share/man/man1/editor.1.gz\n" 22025" editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz\n" 22026" editor.it.1.gz /usr/share/man/it/man1/editor.1.gz\n" 22027" editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz\n" 22028" editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz\n" 22029"Status: auto\n" 22030"Best: /usr/bin/vim.basic\n" 22031"Value: /usr/bin/vim.basic\n" 22032msgstr "" 22033 22034#. type: Plain text 22035#: update-alternatives.man 22036#, no-wrap 22037msgid "" 22038"Alternative: /bin/ed\n" 22039"Priority: -100\n" 22040"Slaves:\n" 22041" editor.1.gz /usr/share/man/man1/ed.1.gz\n" 22042msgstr "" 22043 22044#. type: Plain text 22045#: update-alternatives.man 22046#, no-wrap 22047msgid "" 22048"Alternative: /usr/bin/vim.basic\n" 22049"Priority: 50\n" 22050"Slaves:\n" 22051" editor.1.gz /usr/share/man/man1/vim.1.gz\n" 22052" editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz\n" 22053" editor.it.1.gz /usr/share/man/it/man1/vim.1.gz\n" 22054" editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz\n" 22055" editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz\n" 22056msgstr "" 22057 22058#. type: Plain text 22059#: update-alternatives.man 22060msgid "" 22061"With B<--verbose> B<update-alternatives> chatters incessantly about its " 22062"activities on its standard output channel. If problems occur, B<update-" 22063"alternatives> outputs error messages on its standard error channel and " 22064"returns an exit status of 2. These diagnostics should be self-explanatory; " 22065"if you do not find them so, please report this as a bug." 22066msgstr "" 22067 22068#. type: Plain text 22069#: update-alternatives.man 22070msgid "" 22071"There are several packages which provide a text editor compatible with " 22072"B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the " 22073"link group B<vi>, which includes links for the program itself and the " 22074"associated manpage." 22075msgstr "" 22076 22077#. type: Plain text 22078#: update-alternatives.man 22079msgid "" 22080"To display the available packages which provide B<vi> and the current " 22081"setting for it, use the B<--display> action:" 22082msgstr "" 22083 22084#. type: Plain text 22085#: update-alternatives.man 22086msgid "B<update-alternatives --display vi>" 22087msgstr "" 22088 22089#. type: Plain text 22090#: update-alternatives.man 22091msgid "" 22092"To choose a particular B<vi> implementation, use this command as root and " 22093"then select a number from the list:" 22094msgstr "" 22095 22096#. type: Plain text 22097#: update-alternatives.man 22098msgid "B<update-alternatives --config vi>" 22099msgstr "" 22100 22101#. type: Plain text 22102#: update-alternatives.man 22103msgid "" 22104"To go back to having the B<vi> implementation chosen automatically, do this " 22105"as root:" 22106msgstr "" 22107 22108#. type: Plain text 22109#: update-alternatives.man 22110msgid "B<update-alternatives --auto vi>" 22111msgstr "" 22112 22113#. type: Plain text 22114#: update-alternatives.man 22115msgid "B<ln>(1), FHS, the Filesystem Hierarchy Standard." 22116msgstr "B<ln>(1), FHS, 文件系统层次结构标准。" 22117 22118#~ msgid "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 22119#~ msgstr "B<deb-old>(5), B<dpkg-deb>(1), B<deb-control>(5)." 22120 22121#, fuzzy 22122#~| msgid "B<--admindir=>I<dir>" 22123#~ msgid "B<--buildinfo-id=>I<identifier>" 22124#~ msgstr "B<--admindir=>I<dir>" 22125 22126#~ msgid "REQUIRED FIELDS" 22127#~ msgstr "必填字段" 22128 22129#~ msgid "OPTIONAL FIELDS" 22130#~ msgstr "选填字段" 22131