# SOME DESCRIPTIVE TITLE. # Copyright (C) 1996, 1997, 1998 Ian Jackson, Christian Schwarz, 1998-2017, # The Debian Policy Mailing List # This file is distributed under the same license as the Debian Policy # Manual package. # FIRST AUTHOR , 2018. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Debian Policy Manual 4.1.6.0\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2022-12-15 15:54-0700\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.8.0\n" #: ../../ch-customized-programs.rst:2 msgid "Customized programs" msgstr "" #: ../../ch-customized-programs.rst:7 msgid "Architecture specification strings" msgstr "" #: ../../ch-customized-programs.rst:9 msgid "" "If a program needs to specify an *architecture specification string* in " "some place, it should select one of the strings provided by ``dpkg-" "architecture -L``. The strings are in the format ``os-arch``, though the " "OS part is sometimes elided, as when the OS is Linux." msgstr "" #: ../../ch-customized-programs.rst:14 msgid "" "Note that we don't want to use ``arch-debian-linux`` to apply to the rule" " ``architecture-vendor-os`` since this would make our programs " "incompatible with other Linux distributions. We also don't use something " "like ``arch-unknown-linux``, since the ``unknown`` does not look very " "good." msgstr "" #: ../../ch-customized-programs.rst:23 msgid "Architecture wildcards" msgstr "" #: ../../ch-customized-programs.rst:25 msgid "" "A package may specify an architecture wildcard. Architecture wildcards " "are in the format ``any`` (which matches every architecture), ``os``-any," " or any-\\ ``cpu``. [#]_" msgstr "" #: ../../ch-customized-programs.rst:32 msgid "Daemons" msgstr "" #: ../../ch-customized-programs.rst:34 msgid "" "The configuration files ``/etc/services``, ``/etc/protocols``, and " "``/etc/rpc`` are managed by the ``netbase`` package and must not be " "modified by other packages." msgstr "" #: ../../ch-customized-programs.rst:38 msgid "" "If a package requires a new entry in one of these files, the maintainer " "should get in contact with the ``netbase`` maintainer, who will add the " "entries and release a new version of the ``netbase`` package." msgstr "" #: ../../ch-customized-programs.rst:42 msgid "" "The configuration file ``/etc/inetd.conf`` must not be modified by the " "package's scripts except via the ``update-inetd`` script or the " "``DebianNet.pm`` Perl module. See their documentation for details on how " "to add entries." msgstr "" #: ../../ch-customized-programs.rst:47 msgid "" "If a package wants to install an example entry into ``/etc/inetd.conf``, " "the entry must be preceded with exactly one hash character (``#``). Such " "lines are treated as \"commented out by user\" by the ``update-inetd`` " "script and are not changed or activated during package updates." msgstr "" #: ../../ch-customized-programs.rst:55 msgid "Using pseudo-ttys and modifying wtmp, utmp and lastlog" msgstr "" #: ../../ch-customized-programs.rst:57 msgid "" "Some programs need to create pseudo-ttys. This should be done using " "Unix98 ptys if the C library supports it. The resulting program must not " "be installed setuid root, unless that is required for other " "functionality." msgstr "" #: ../../ch-customized-programs.rst:62 msgid "" "The files ``/var/run/utmp``, ``/var/log/wtmp`` and ``/var/log/lastlog`` " "must be installed writable by group ``utmp``. Programs which need to " "modify those files must be installed setgid ``utmp``." msgstr "" #: ../../ch-customized-programs.rst:69 msgid "Editors and pagers" msgstr "" #: ../../ch-customized-programs.rst:71 msgid "" "Some programs have the ability to launch an editor or pager program to " "edit or display a text document. Since there are lots of different " "editors and pagers available in the Debian distribution, the system " "administrator and each user should have the possibility to choose their " "preferred editor and pager." msgstr "" #: ../../ch-customized-programs.rst:77 msgid "" "In addition, every program should choose a good default editor/pager if " "none is selected by the user or system administrator." msgstr "" #: ../../ch-customized-programs.rst:80 msgid "" "Thus, every program that launches an editor or pager must use the EDITOR " "or PAGER environment variable to determine the editor or pager the user " "wishes to use. If these variables are not set, the programs " "``/usr/bin/editor`` and ``/usr/bin/pager`` should be used, respectively. " "These commands may be invoked explicitly (e.g., as ``/usr/bin/editor``) " "or via a PATH search (e.g., as ``editor``)." msgstr "" #: ../../ch-customized-programs.rst:87 msgid "" "These two files are managed through the ``dpkg`` \"alternatives\" " "mechanism. Every package providing an editor or pager must call the " "``update-alternatives`` script to register as an alternative for " "``/usr/bin/editor`` or ``/usr/bin/pager`` as appropriate. The alternative" " should have a slave alternative for ``/usr/share/man/man1/editor.1.gz`` " "or ``/usr/share/man/man1/pager.1.gz`` pointing to the corresponding " "manual page." msgstr "" #: ../../ch-customized-programs.rst:96 msgid "" "If it is very hard to adapt a program to make use of the EDITOR or PAGER " "variables, that program may be configured to use ``/usr/bin/sensible-" "editor`` and ``/usr/bin/sensible-pager`` as the editor or pager program " "respectively. These are two scripts provided in the sensible-utils " "package that check the EDITOR and PAGER variables and launch the " "appropriate program, and fall back to ``/usr/bin/editor`` and " "``/usr/bin/pager`` if the variable is not set." msgstr "" #: ../../ch-customized-programs.rst:104 msgid "" "A program may also use the VISUAL environment variable to determine the " "user's choice of editor. If it exists, it should take precedence over " "EDITOR. This is in fact what ``/usr/bin/sensible-editor`` does." msgstr "" #: ../../ch-customized-programs.rst:108 msgid "" "It is not required for a package to depend on ``editor`` and ``pager``, " "nor is it required for a package to provide such virtual packages. [#]_" msgstr "" #: ../../ch-customized-programs.rst:115 msgid "Web servers and applications" msgstr "" #: ../../ch-customized-programs.rst:117 msgid "" "This section describes the locations and URLs that should be used by all " "web servers and web applications in the Debian system." msgstr "" #: ../../ch-customized-programs.rst:120 msgid "Cgi-bin executable files are installed in the directory" msgstr "" #: ../../ch-customized-programs.rst:126 msgid "or a subdirectory of that directory, and the script" msgstr "" #: ../../ch-customized-programs.rst:132 msgid "should be referred to as" msgstr "" #: ../../ch-customized-programs.rst:138 msgid "(Deleted)" msgstr "" #: ../../ch-customized-programs.rst:140 msgid "Access to images" msgstr "" #: ../../ch-customized-programs.rst:142 msgid "" "Images for a package should be stored in ``/usr/share/images/package`` " "and referred to through an alias ``/images/`` as::" msgstr "" #: ../../ch-customized-programs.rst:147 msgid "Web Document Root" msgstr "" #: ../../ch-customized-programs.rst:149 msgid "" "Web Applications should try to avoid storing files in the Web Document " "Root. Instead they should use the /usr/share/doc/package directory for " "documents. If access to the web document root is unavoidable then use" msgstr "" #: ../../ch-customized-programs.rst:158 msgid "" "as the Document Root. This might be just a symbolic link to the location " "where the system administrator has put the real document root." msgstr "" #: ../../ch-customized-programs.rst:162 msgid "Providing httpd and/or httpd-cgi" msgstr "" #: ../../ch-customized-programs.rst:164 msgid "" "All web servers should provide the virtual package ``httpd``. If a web " "server has CGI support it should provide ``httpd-cgi`` additionally." msgstr "" #: ../../ch-customized-programs.rst:168 msgid "" "All web applications which do not contain CGI scripts should depend on " "``httpd``, all those web applications which ``do`` contain CGI scripts, " "should depend on ``httpd-cgi``." msgstr "" #: ../../ch-customized-programs.rst:175 msgid "Mail transport, delivery and user agents" msgstr "" #: ../../ch-customized-programs.rst:177 msgid "" "Debian packages which process electronic mail, whether mail user agents " "(MUAs) or mail transport agents (MTAs), must ensure that they are " "compatible with the configuration decisions below. Failure to do this may" " result in lost mail, broken ``From:`` lines, and other serious brain " "damage!" msgstr "" #: ../../ch-customized-programs.rst:183 msgid "" "The mail spool is ``/var/mail`` and the interface to send a mail message " "is ``/usr/sbin/sendmail`` (as per the FHS). On older systems, the mail " "spool may be physically located in ``/var/spool/mail``, but all access to" " the mail spool should be via the ``/var/mail`` symlink. The mail spool " "is part of the base system and not part of the MTA package." msgstr "" #: ../../ch-customized-programs.rst:189 msgid "" "All Debian MUAs, MTAs, MDAs and other mailbox accessing programs (such as" " IMAP daemons) must lock the mailbox in an NFS-safe way. This means that " "``fcntl()`` locking must be combined with dot locking. To avoid " "deadlocks, a program should use ``fcntl()`` first and dot locking after " "this, or alternatively implement the two locking methods in a non " "blocking way. [#]_ Using the functions ``maillock`` and ``mailunlock`` " "provided by the ``liblockfile*`` packages is the recommended way to " "accomplish this." msgstr "" #: ../../ch-customized-programs.rst:198 msgid "" "Mailboxes are generally either mode 600 and owned by user or mode 660 and" " owned by ``user:mail``. [#]_ The local system administrator may choose " "a different permission scheme; packages should not make assumptions about" " the permission and ownership of mailboxes unless required (such as when " "creating a new mailbox). A MUA may remove a mailbox (unless it has " "nonstandard permissions) in which case the MTA or another MUA must " "recreate it if needed." msgstr "" #: ../../ch-customized-programs.rst:206 msgid "" "The mail spool is 2775 ``root:mail``, and MUAs should be setgid mail to " "do the locking mentioned above (and must obviously avoid accessing other " "users' mailboxes using this privilege)." msgstr "" #: ../../ch-customized-programs.rst:210 msgid "" "``/etc/aliases`` is the source file for the system mail aliases (e.g., " "postmaster, usenet, etc.), it is the one which the sysadmin and " "``postinst`` scripts may edit. After ``/etc/aliases`` is edited the " "program or human editing it must call ``newaliases``. All MTA packages " "must come with a ``newaliases`` program, even if it does nothing, but " "older MTA packages did not do this so programs should not fail if " "``newaliases`` cannot be found. Note that because of this, all MTA " "packages must have ``Provides``, ``Conflicts`` and ``Replaces: mail-" "transport-agent`` control fields." msgstr "" #: ../../ch-customized-programs.rst:220 msgid "" "The convention of writing ``forward to address`` in the mailbox itself is" " not supported. Use a ``.forward`` file instead." msgstr "" #: ../../ch-customized-programs.rst:223 msgid "" "The ``rmail`` program used by UUCP for incoming mail should be " "``/usr/sbin/rmail``. Likewise, ``rsmtp``, for receiving batch-SMTP-over-" "UUCP, should be ``/usr/sbin/rsmtp`` if it is supported." msgstr "" #: ../../ch-customized-programs.rst:227 msgid "" "If your package needs to know what hostname to use on (for example) " "outgoing news and mail messages which are generated locally, you should " "use the file ``/etc/mailname``. It will contain the portion after the " "username and ``@`` (at) sign for email addresses of users on the machine " "(followed by a newline)." msgstr "" #: ../../ch-customized-programs.rst:233 msgid "" "Such a package should check for the existence of this file when it is " "being configured. If it exists, it should be used without comment, " "although an MTA's configuration script may wish to prompt the user even " "if it finds that this file exists. If the file does not exist, the " "package should prompt the user for the value (preferably using " "``debconf``) and store it in ``/etc/mailname`` as well as using it in the" " package's configuration. The prompt should make it clear that the name " "will not just be used by that package. For example, in this situation the" " ``inn`` package could say something like:" msgstr "" #: ../../ch-customized-programs.rst:251 msgid "where syshostname is the output of ``hostname --fqdn``." msgstr "" #: ../../ch-customized-programs.rst:256 msgid "News system configuration" msgstr "" #: ../../ch-customized-programs.rst:258 msgid "" "All the configuration files related to the NNTP (news) servers and " "clients should be located under ``/etc/news``." msgstr "" #: ../../ch-customized-programs.rst:261 msgid "" "There are some configuration issues that apply to a number of news " "clients and server packages on the machine. These are:" msgstr "" #: ../../ch-customized-programs.rst:266 msgid "``/etc/news/organization``" msgstr "" #: ../../ch-customized-programs.rst:265 msgid "" "A string which should appear as the organization header for all messages " "posted by NNTP clients on the machine" msgstr "" #: ../../ch-customized-programs.rst:270 msgid "``/etc/news/server``" msgstr "" #: ../../ch-customized-programs.rst:269 msgid "" "Contains the FQDN of the upstream NNTP server, or localhost if the local " "machine is an NNTP server." msgstr "" #: ../../ch-customized-programs.rst:272 msgid "" "Other global files may be added as required for cross-package news " "configuration." msgstr "" #: ../../ch-customized-programs.rst:278 msgid "Programs for the X Window System" msgstr "" #: ../../ch-customized-programs.rst:283 msgid "Providing X support and package priorities" msgstr "" #: ../../ch-customized-programs.rst:285 msgid "" "Programs that can be configured with support for the X Window System must" " be configured to do so and must declare any package dependencies " "necessary to satisfy their runtime requirements when using the X Window " "System. If such a package is of higher priority than the X packages on " "which it depends, it is required that either the X-specific components be" " split into a separate package, or that an alternative version of the " "package, which includes X support, be provided, or that the package's " "priority be lowered." msgstr "" #: ../../ch-customized-programs.rst:297 msgid "Packages providing an X server" msgstr "" #: ../../ch-customized-programs.rst:299 msgid "" "Packages that provide an X server that, directly or indirectly, " "communicates with real input and display hardware should declare in their" " ``Provides`` control field that they provide the virtual package " "``xserver``. [#]_" msgstr "" #: ../../ch-customized-programs.rst:307 msgid "Packages providing a terminal emulator" msgstr "" #: ../../ch-customized-programs.rst:309 msgid "" "Packages that provide a terminal emulator for the X Window System which " "meet the criteria listed below should declare in their ``Provides`` " "control field that they provide the virtual package ``x-terminal-" "emulator``. They should also register themselves as an alternative for " "``/usr/bin/x-terminal-emulator``, with a priority of 20. That alternative" " should have a slave alternative for ``/usr/share/man/man1/x-terminal-" "emulator.1.gz`` pointing to the corresponding manual page." msgstr "" #: ../../ch-customized-programs.rst:318 msgid "To be an ``x-terminal-emulator``, a program must:" msgstr "" #: ../../ch-customized-programs.rst:320 msgid "Be able to emulate a DEC VT100 terminal, or a compatible terminal." msgstr "" #: ../../ch-customized-programs.rst:322 msgid "" "Support the command-line option ``-e command``, which creates a new " "terminal window [#]_ and runs the specified command. may be " "multiple arguments, which form the argument list to the executed program." " In other words, the behavior is as though the arguments were passed " "directly to ``execvp``, bypassing the shell. (``xterm``'s behavior of " "falling back on using the shell if ``-e`` had a single argument and exec " "failed is permissible but not required.)" msgstr "" #: ../../ch-customized-programs.rst:331 msgid "" "Support the command-line option ``-T title``, which creates a new " "terminal window with the window title title." msgstr "" #: ../../ch-customized-programs.rst:337 msgid "Packages providing a window manager" msgstr "" #: ../../ch-customized-programs.rst:339 msgid "" "Packages that provide a window manager should declare in their " "``Provides`` control field that they provide the virtual package ``x" "-window-manager``. They should also register themselves as an alternative" " for ``/usr/bin/x-window-manager``, with a priority calculated as " "follows:" msgstr "" #: ../../ch-customized-programs.rst:345 msgid "Start with a priority of 40." msgstr "" #: ../../ch-customized-programs.rst:347 msgid "" "If the window manager complies with `The Window Manager Specification " "Project `_, " "written by the `Free Desktop Group `_," " add 40 points." msgstr "" #: ../../ch-customized-programs.rst:352 msgid "" "If the window manager permits the X session to be restarted using a " "*different* window manager (without killing the X server) in its default " "configuration, add 10 points; otherwise add none." msgstr "" #: ../../ch-customized-programs.rst:356 msgid "" "That alternative should have a slave alternative for " "``/usr/share/man/man1/x-window-manager.1.gz`` pointing to the " "corresponding manual page." msgstr "" #: ../../ch-customized-programs.rst:363 msgid "Packages providing fonts" msgstr "" #: ../../ch-customized-programs.rst:365 msgid "" "Packages that provide fonts for the X Window System [#]_ must do a " "number of things to ensure that they are both available without " "modification of the X or font server configuration, and that they do not " "corrupt files used by other font packages to register information about " "themselves." msgstr "" #: ../../ch-customized-programs.rst:371 msgid "" "Fonts of any type supported by the X Window System must be in a separate " "binary package from any executables, libraries, or documentation (except " "that specific to the fonts shipped, such as their license information). " "If one or more of the fonts so packaged are necessary for proper " "operation of the package with which they are associated the font package " "may be Recommended; if the fonts merely provide an enhancement, a " "Suggests relationship may be used. Packages must not Depend on font " "packages. [#]_" msgstr "" #: ../../ch-customized-programs.rst:380 msgid "" "BDF fonts must be converted to PCF fonts with the ``bdftopcf`` utility " "(available in the ``xfonts-utils`` package, ``gzip``\\ ped, and placed in" " a directory that corresponds to their resolution:" msgstr "" #: ../../ch-customized-programs.rst:384 msgid "100 dpi fonts must be placed in ``/usr/share/fonts/X11/100dpi/``." msgstr "" #: ../../ch-customized-programs.rst:386 msgid "75 dpi fonts must be placed in ``/usr/share/fonts/X11/75dpi/``." msgstr "" #: ../../ch-customized-programs.rst:388 msgid "" "Character-cell fonts, cursor fonts, and other low-resolution fonts must " "be placed in ``/usr/share/fonts/X11/misc/``." msgstr "" #: ../../ch-customized-programs.rst:391 msgid "" "Type 1 fonts must be placed in ``/usr/share/fonts/X11/Type1/``. If font " "metric files are available, they must be placed here as well." msgstr "" #: ../../ch-customized-programs.rst:394 msgid "" "Subdirectories of ``/usr/share/fonts/X11/`` other than those listed above" " must be neither created nor used. (The ``PEX``, ``CID``, ``Speedo``, and" " ``cyrillic`` directories are excepted for historical reasons, but " "installation of files into these directories remains discouraged.)" msgstr "" #: ../../ch-customized-programs.rst:400 msgid "" "Font packages may, instead of placing files directly in the X font " "directories listed above, provide symbolic links in that font directory " "pointing to the files' actual location in the filesystem. Such a location" " must comply with the FHS." msgstr "" #: ../../ch-customized-programs.rst:405 msgid "" "Font packages should not contain both 75dpi and 100dpi versions of a " "font. If both are available, they should be provided in separate binary " "packages with ``-75dpi`` or ``-100dpi`` appended to the names of the " "packages containing the corresponding fonts." msgstr "" #: ../../ch-customized-programs.rst:410 msgid "" "Fonts destined for the ``misc`` subdirectory should not be included in " "the same package as 75dpi or 100dpi fonts; instead, they should be " "provided in a separate package with ``-misc`` appended to its name." msgstr "" #: ../../ch-customized-programs.rst:415 msgid "" "Font packages must not provide the files ``fonts.dir``, ``fonts.alias``, " "or ``fonts.scale`` in a font directory:" msgstr "" #: ../../ch-customized-programs.rst:418 msgid "``fonts.dir`` files must not be provided at all." msgstr "" #: ../../ch-customized-programs.rst:420 msgid "" "``fonts.alias`` and ``fonts.scale`` files, if needed, should be provided " "in the directory ``/etc/X11/fonts/fontdir/package.extension``, where " "fontdir is the name of the subdirectory of ``/usr/share/fonts/X11/`` " "where the package's corresponding fonts are stored (e.g., ``75dpi`` or " "``misc``), package is the name of the package that provides these fonts, " "and extension is either ``scale`` or ``alias``, whichever corresponds to " "the file contents." msgstr "" #: ../../ch-customized-programs.rst:429 msgid "" "Font packages must declare a dependency on ``xfonts-utils`` in their " "``Depends`` or ``Pre-Depends`` control field." msgstr "" #: ../../ch-customized-programs.rst:432 msgid "" "Font packages that provide one or more ``fonts.scale`` files as described" " above must invoke ``update-fonts-scale`` on each directory into which " "they installed fonts *before* invoking ``update-fonts-dir`` on that " "directory. This invocation must occur in both the ``postinst`` (for all " "arguments) and ``postrm`` (for all arguments except ``upgrade``) scripts." msgstr "" #: ../../ch-customized-programs.rst:439 msgid "" "Font packages that provide one or more ``fonts.alias`` files as described" " above must invoke ``update-fonts-alias`` on each directory into which " "they installed fonts. This invocation must occur in both the ``postinst``" " (for all arguments) and ``postrm`` (for all arguments except " "``upgrade``) scripts." msgstr "" #: ../../ch-customized-programs.rst:445 msgid "" "Font packages must invoke ``update-fonts-dir`` on each directory into " "which they installed fonts. This invocation must occur in both the " "``postinst`` (for all arguments) and ``postrm`` (for all arguments except" " ``upgrade``) scripts." msgstr "" #: ../../ch-customized-programs.rst:450 msgid "" "Font packages must not provide alias names for the fonts they include " "which collide with alias names already in use by fonts already packaged." msgstr "" #: ../../ch-customized-programs.rst:454 msgid "" "Font packages must not provide fonts with the same XLFD registry name as " "another font already packaged." msgstr "" #: ../../ch-customized-programs.rst:460 msgid "Application defaults files" msgstr "" #: ../../ch-customized-programs.rst:462 msgid "" "Application defaults files must be installed in the directory ``/etc/X11" "/app-defaults/`` (use of a localized subdirectory of ``/etc/X11/`` as " "described in the *X Toolkit Intrinsics - C Language Interface* manual is " "also permitted). They must be registered as ``conffile``\\ s or handled " "as configuration files." msgstr "" #: ../../ch-customized-programs.rst:468 msgid "" "Customization of programs' X resources may also be supported with the " "provision of a file with the same name as that of the package placed in " "the ``/etc/X11/Xresources/`` directory, which must be registered as a " "``conffile`` or handled as a configuration file. [#]_" msgstr "" #: ../../ch-customized-programs.rst:476 msgid "Installation directory issues" msgstr "" #: ../../ch-customized-programs.rst:478 msgid "" "Historically, packages using the X Window System used a separate set of " "installation directories from other packages. This practice has been " "discontinued and packages using the X Window System should now generally " "be installed in the same directories as any other package. Specifically, " "packages must not install files under the ``/usr/X11R6/`` directory and " "the ``/usr/X11R6/`` directory hierarchy should be regarded as obsolete." msgstr "" #: ../../ch-customized-programs.rst:485 msgid "" "Include files previously installed under ``/usr/X11R6/include/X11/`` " "should be installed into ``/usr/include/X11/``. For files previously " "installed into subdirectories of ``/usr/X11R6/lib/X11/``, package " "maintainers should determine if subdirectories of ``/usr/lib/`` and " "``/usr/share/`` can be used. If not, a subdirectory of ``/usr/lib/X11/`` " "should be used." msgstr "" #: ../../ch-customized-programs.rst:492 msgid "" "Configuration files for window, display, or session managers or other " "applications that are tightly integrated with the X Window System may be " "placed in a subdirectory of ``/etc/X11/`` corresponding to the package " "name. Other X Window System applications should use the ``/etc/`` " "directory unless otherwise mandated by policy (such as for " ":ref:`s-appdefaults`)." msgstr "" #: ../../ch-customized-programs.rst:502 msgid "Perl programs and modules" msgstr "" #: ../../ch-customized-programs.rst:504 msgid "Perl programs and modules should follow the current Perl policy." msgstr "" #: ../../ch-customized-programs.rst:506 msgid "" "The Perl policy can be found in the ``perl-policy`` files in the " "``debian-policy`` package. It is also available from the Debian web " "mirrors at https://www.debian.org/doc/packaging-manuals/perl-policy/." msgstr "" #: ../../ch-customized-programs.rst:513 msgid "Emacs lisp programs" msgstr "" #: ../../ch-customized-programs.rst:515 msgid "" "Please refer to the \"Debian Emacs Policy\" for details of how to package" " emacs lisp programs." msgstr "" #: ../../ch-customized-programs.rst:518 msgid "" "The Emacs policy is available in ``debian-emacs-policy.gz`` of the " "emacsen-common package. It is also available from the Debian web mirrors " "at https://www.debian.org/doc/packaging-manuals/debian-emacs-policy." msgstr "" #: ../../ch-customized-programs.rst:525 msgid "Games" msgstr "" #: ../../ch-customized-programs.rst:527 msgid "" "The permissions on ``/var/games`` are mode 755, owner ``root`` and group " "``root``." msgstr "" #: ../../ch-customized-programs.rst:530 msgid "Each game decides on its own security policy." msgstr "" #: ../../ch-customized-programs.rst:532 msgid "" "Games which require protected, privileged access to high-score files, " "saved games, etc., may be made set-\\ *group*-id (mode 2755) and owned by" " ``root:games``, and use files and directories with appropriate " "permissions (770 ``root:games``, for example). They must not be made " "set-\\ *user*-id, as this causes security problems. (If an attacker can " "subvert any set-user-id game they can overwrite the executable of any " "other, causing other players of these games to run a Trojan horse " "program. With a set-group-id game the attacker only gets access to less " "important game data, and if they can get at the other players' accounts " "at all it will take considerably more effort.)" msgstr "" #: ../../ch-customized-programs.rst:543 msgid "" "Some packages, for example some fortune cookie programs, are configured " "by the upstream authors to install with their data files or other static " "information made unreadable so that they can only be accessed through " "set-id programs provided. You should not do this in a Debian package: " "anyone can download the ``.deb`` file and read the data from it, so there" " is no point making the files unreadable. Not making the files unreadable" " also means that you don't have to make so many programs set-id, which " "reduces the risk of a security hole." msgstr "" #: ../../ch-customized-programs.rst:552 msgid "" "As described in the FHS, binaries of games should be installed in the " "directory ``/usr/games``. This also applies to games that use the X " "Window System. Manual pages for games (X and non-X games) should be " "installed in ``/usr/share/man/man6``." msgstr "" #: ../../ch-customized-programs.rst:558 msgid "" "Internally, the package system normalizes the GNU triplets and the Debian" " arches into Debian arch triplets (which are kind of inverted GNU " "triplets), with the first component of the triplet representing the libc " "and ABI in use, and then does matching against those triplets. However, " "such triplets are an internal implementation detail that should not be " "used by packages directly. The libc and ABI portion is handled internally" " by the package system based on the os and cpu." msgstr "" #: ../../ch-customized-programs.rst:568 msgid "The Debian base system already provides an editor and a pager program." msgstr "" #: ../../ch-customized-programs.rst:572 msgid "" "If it is not possible to establish both locks, the system shouldn't wait " "for the second lock to be established, but remove the first lock, wait a " "(random) time, and start over locking again." msgstr "" #: ../../ch-customized-programs.rst:577 msgid "" "There are two traditional permission schemes for mail spools: mode 600 " "with all mail delivery done by processes running as the destination user," " or mode 660 and owned by group mail with mail delivery done by a process" " running as a system user in group mail. Historically, Debian required " "mode 660 mail spools to enable the latter model, but that model has " "become increasingly uncommon and the principle of least privilege " "indicates that mail systems that use the first model should use " "permissions of 600. If delivery to programs is permitted, it's easier to " "keep the mail system secure if the delivery agent runs as the destination" " user. Debian Policy therefore permits either scheme." msgstr "" #: ../../ch-customized-programs.rst:590 msgid "" "This implements current practice, and provides an actual policy for usage" " of the ``xserver`` virtual package which appears in the virtual packages" " list. In a nutshell, X servers that interface directly with the display " "and input hardware or via another subsystem (e.g., GGI) should provide " "``xserver``. Things like ``Xvfb``, ``Xnest``, and ``Xprt`` should not." msgstr "" #: ../../ch-customized-programs.rst:598 msgid "" "\"New terminal window\" does not necessarily mean a new top-level X " "window directly parented by the window manager; it could, if the terminal" " emulator application were so coded, be a new \"view\" in a multiple-" "document interface (MDI)." msgstr "" #: ../../ch-customized-programs.rst:604 msgid "" "For the purposes of Debian Policy, a \"font for the X Window System\" is " "one which is accessed via X protocol requests. Fonts for the Linux " "console, for PostScript renderer, or any other purpose, do not fit this " "definition. Any tool which makes such fonts available to the X Window " "System, however, must abide by this font policy." msgstr "" #: ../../ch-customized-programs.rst:611 msgid "" "This is because an X client may be displayed by a remote X server, in " "which case X fonts are provided by the remote X server, not retrieved " "locally; the Debian package system is empowered to deal only with the " "local file system." msgstr "" #: ../../ch-customized-programs.rst:617 msgid "" "Note that this mechanism is not the same as using app-defaults; app-" "defaults are tied to the client binary on the local file system, whereas " "X resources are stored in the X server and affect all connecting clients." msgstr "" #~ msgid "" #~ "Web Applications should try to avoid " #~ "storing files in the Web Document " #~ "Root. Instead they should use the " #~ "/usr/share/doc/package directory for documents " #~ "and register the Web Application via " #~ "the doc-base package. If access to" #~ " the web document root is unavoidable" #~ " then use" #~ msgstr "" #~ msgid "" #~ "This is because the X server may" #~ " retrieve fonts from the local file" #~ " system or over the network from " #~ "an X font server; the Debian " #~ "package system is empowered to deal " #~ "only with the local file system." #~ msgstr "" #~ msgid "" #~ "It is recommended that images for " #~ "a package be stored in " #~ "``/usr/share/images/package`` and may be " #~ "referred to through an alias " #~ "``/images/`` as" #~ msgstr "" #~ msgid "Start with a priority of 20." #~ msgstr "" #~ msgid "" #~ "If the window manager supports the " #~ "Debian menu system, add 20 points " #~ "if this support is available in " #~ "the package's default configuration (i.e., " #~ "no configuration files belonging to the" #~ " system or user have to be " #~ "edited to activate the feature); if " #~ "configuration files must be modified, " #~ "add only 10 points." #~ msgstr ""