diff options
| author | Roger Leigh <rleigh@debian.org> | 2012-01-23 09:15:50 +0000 |
|---|---|---|
| committer | Roger Leigh <rleigh@debian.org> | 2012-01-23 09:15:50 +0000 |
| commit | e590ed029ea43ab5b4740dabf777f6b60d91876b (patch) | |
| tree | 9540c11ab8c2d4c2c09f3741c67ddbdbed6febd0 /man | |
| parent | 5ac4317c648d7cbcd65c052a31c5459dcefbab4a (diff) | |
| parent | f04845fb6a9d18ab1d66288ed3112a44f13683eb (diff) | |
| download | schroot-e590ed029ea43ab5b4740dabf777f6b60d91876b.tar.gz | |
Merge branch 'po4a'
Diffstat (limited to 'man')
| -rw-r--r-- | man/Makefile.am | 7 | ||||
| -rw-r--r-- | man/po4a/addendum.template | 22 | ||||
| -rw-r--r-- | man/po4a/po/schroot-man.pot | 4573 | ||||
| -rw-r--r-- | man/po4a/po4a.cfg | 28 |
4 files changed, 4630 insertions, 0 deletions
diff --git a/man/Makefile.am b/man/Makefile.am index 329d8e8b..ac406c6b 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -108,3 +108,10 @@ CONFIG =\ config.man: Makefile echo -e "$(CONFIG)" | sed -e 's/^[ ]//' > $@ +update-po: + $(PO4A) po4a/po4a.cfg + +dist-hook: +# Update POT and POs for manual pages + $(PO4A) --rm-backups po4a/po4a.cfg + diff --git a/man/po4a/addendum.template b/man/po4a/addendum.template new file mode 100644 index 00000000..d4534944 --- /dev/null +++ b/man/po4a/addendum.template @@ -0,0 +1,22 @@ +PO4A-HEADER:mode=after;position=^\.SH "SEE ALSO";beginboundary=^\.SH +.SH TRANSLATOR(S) +This manpage has been translated by TRANSLATOR NAME <email> on TRANSLATION +DATE. + +If you find any mistake in this translation, please send an e-mail to the +translator or to the +.nh +<\fIdebian\-l10n\-LANGUAGE@lists.debian.org\fR>, +.hy +mailing-list. + +# Note to translators: +# Please translate this text in a file called language_code.add +# The addendum MUST use the same encoding as your po file +# Feel free to adapt the text at your convenience. +# Do not forget to translate "SEE ALSO" and "TRANSLATOR(S)" +# The "SEE ALSO" part in the header must be *exactly* the same translation +# as the one in your xx.po file. +# Do not include this comment in your addendum (i.e. all lines starting +# with a #). +# See po4a(7) for further information. diff --git a/man/po4a/po/schroot-man.pot b/man/po4a/po/schroot-man.pot new file mode 100644 index 00000000..6c30f37a --- /dev/null +++ b/man/po4a/po/schroot-man.pot @@ -0,0 +1,4573 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2011-11-28 23:37+0000\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: SH +#: authors.man:1 +#, no-wrap +msgid "AUTHORS" +msgstr "" + +#. type: Plain text +#: authors.man:2 +msgid "Roger Leigh." +msgstr "" + +#. type: SH +#: copyright.man:1 +#, no-wrap +msgid "COPYRIGHT" +msgstr "" + +#. type: Plain text +#: copyright.man:3 +msgid "Copyright \\(co 2005-2011 Roger Leigh \\f[CR]E<lt>rleigh@debian.orgE<gt>\\fR" +msgstr "" + +#. type: Plain text +#: copyright.man:7 +msgid "" +"B<\\*[PROGRAM]> is free software: you can redistribute it and/or modify it " +"under the terms of the GNU General Public License as published by the Free " +"Software Foundation, either version 3 of the License, or (at your option) " +"any later version." +msgstr "" + +#. type: TH +#: schroot.1.man:20 +#, no-wrap +msgid "SCHROOT" +msgstr "" + +#. type: TH +#: schroot.1.man:20 schroot-setup.5.man:18 schroot.conf.5.man:18 schroot-script-config.5.man:18 schroot-faq.7.man:18 dchroot.1.man:20 dchroot-dsa.1.man:20 +#, no-wrap +msgid "\\*[RELEASE_DATE]" +msgstr "" + +#. type: TH +#: schroot.1.man:20 schroot-setup.5.man:18 schroot.conf.5.man:18 schroot-script-config.5.man:18 schroot-faq.7.man:18 dchroot.1.man:20 dchroot-dsa.1.man:20 +#, no-wrap +msgid "Version \\*[VERSION]" +msgstr "" + +#. type: TH +#: schroot.1.man:20 schroot-setup.5.man:18 schroot.conf.5.man:18 schroot-script-config.5.man:18 schroot-faq.7.man:18 dchroot.1.man:20 dchroot-dsa.1.man:20 +#, no-wrap +msgid "Debian sbuild" +msgstr "" + +#. type: SH +#: schroot.1.man:21 schroot-setup.5.man:19 schroot.conf.5.man:19 schroot-script-config.5.man:19 schroot-faq.7.man:19 dchroot.1.man:21 dchroot-dsa.1.man:21 +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: schroot.1.man:23 +msgid "schroot - securely enter a chroot environment" +msgstr "" + +#. type: SH +#: schroot.1.man:23 dchroot.1.man:23 dchroot-dsa.1.man:23 +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: schroot.1.man:41 +msgid "" +"B<schroot> [B<-h>\\[or]B<--help> \\[or] B<-V>\\[or]B<--version> \\[or] " +"B<-l>\\[or]B<--list> \\[or] B<-i>\\[or]B<--info> \\[or] B<--config> \\[or] " +"B<--location> \\[or] B<--automatic-session> \\[or] " +"B<-b>\\[or]B<--begin-session> \\[or] B<--recover-session> \\[or] " +"B<-r>\\[or]B<--run-session> \\[or] B<-e>\\[or]B<--end-session>] " +"[B<-f>\\[or]B<--force>] [B<-n " +">I<session-name>\\[or]B<--session-name=>I<session-name>] [B<-d " +">I<directory>\\[or]B<--directory=>I<directory>] [B<-u " +">I<user>\\[or]B<--user=>I<user>] [B<-p>\\[or]B<--preserve-environment>] " +"[B<-q>\\[or]B<--quiet> \\[or] B<-v>\\[or]B<--verbose>] [B<-c " +">I<chroot>\\[or]B<--chroot=>I<chroot> \\[or] B<--all> \\[or] " +"B<--all-chroots> \\[or] B<--all-source-chroots> \\[or] B<--all-sessions>] " +"[B<-->] [B<COMMAND> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]" +msgstr "" + +#. type: SH +#: schroot.1.man:41 schroot-setup.5.man:21 schroot.conf.5.man:21 schroot-script-config.5.man:21 schroot-faq.7.man:21 dchroot.1.man:34 dchroot-dsa.1.man:33 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: schroot.1.man:45 +msgid "" +"B<schroot> allows the user to run a command or a login shell in a chroot " +"environment. If no command is specified, a login shell will be started in " +"the user's current working directory inside the chroot." +msgstr "" + +#. type: Plain text +#: schroot.1.man:48 +msgid "" +"The command is a program, plus as many optional arguments as required. Each " +"argument may be separately quoted." +msgstr "" + +#. type: Plain text +#: schroot.1.man:51 dchroot.1.man:48 dchroot-dsa.1.man:45 +msgid "" +"The directory the command or login shell is run in depends upon the " +"context. See I<--directory> option below for a complete description." +msgstr "" + +#. type: Plain text +#: schroot.1.man:55 +msgid "" +"All chroot usage will be logged in the system logs. Under some " +"circumstances, the user may be required to authenticate themselves; see the " +"section \\[lq]I<Authentication>\\[rq], below." +msgstr "" + +#. type: Plain text +#: schroot.1.man:58 +msgid "" +"If no chroot is specified, the chroot name or alias \\[oq]default\\[cq] will " +"be used as a fallback. This is equivalent to \\[lq]--chroot=default\\[rq]." +msgstr "" + +#. type: SH +#: schroot.1.man:58 +#, no-wrap +msgid "OVERVIEW" +msgstr "" + +#. type: Plain text +#: schroot.1.man:68 +msgid "" +"There is often a need to run programs in a virtualised environment rather " +"than on the host system directly. Unlike other virtualisation systems such " +"as B<kvm> or B<Xen>, schroot does not virtualise the entire system; it only " +"virtualises the filesystem, and some parts of the filesystem may still be " +"shared with the host. It is therefore fast, lightweight and flexible. " +"However, it does not virtualise other aspects of the system, such as shared " +"memory, networking, devices etc., and so may be less secure than other " +"systems, depending upon its intended use. Some examples of existing uses " +"for schroot include:" +msgstr "" + +#. type: IP +#: schroot.1.man:68 schroot.1.man:72 schroot.1.man:75 schroot.1.man:78 schroot.1.man:80 schroot.1.man:85 schroot-faq.7.man:119 schroot-faq.7.man:124 schroot-faq.7.man:130 schroot-faq.7.man:132 schroot-faq.7.man:134 schroot-faq.7.man:151 schroot-faq.7.man:156 schroot-faq.7.man:158 schroot-faq.7.man:160 schroot-faq.7.man:162 dchroot.1.man:120 dchroot.1.man:122 dchroot.1.man:127 dchroot.1.man:134 dchroot.1.man:143 dchroot.1.man:145 dchroot-dsa.1.man:109 dchroot-dsa.1.man:116 dchroot-dsa.1.man:118 dchroot-dsa.1.man:126 dchroot-dsa.1.man:128 +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: schroot.1.man:72 +msgid "" +"Running an untrusted program in a sandbox, so that it can't interfere with " +"files on the host system; this may also be used to limit the damage a " +"compromised service can inflict upon the host" +msgstr "" + +#. type: Plain text +#: schroot.1.man:75 +msgid "" +"Using a I<defined> or I<clean> environment, to guarantee the reproducibility " +"and integrity of a given task" +msgstr "" + +#. type: Plain text +#: schroot.1.man:78 +msgid "" +"Using different versions of an operating system, or even different operating " +"systems altogether, e.g. different GNU/Linux distributions" +msgstr "" + +#. type: Plain text +#: schroot.1.man:80 +msgid "Running 32-bit programs using a 32-bit chroot on a 64-bit host system" +msgstr "" + +#. type: Plain text +#: schroot.1.man:85 +msgid "" +"Automatic building of Debian packages using B<sbuild>(1), which builds each " +"package in a pristine chroot snapshot when using LVM snapshots or unions" +msgstr "" + +#. type: Plain text +#: schroot.1.man:92 +msgid "" +"Supporting multiple system images in a cluster setup, where modifying the " +"base image is time-consuming and/or supporting all the required " +"configurations needed by users is difficult: different chroots can support " +"all the different configurations required, and cluster users may be given " +"access to the chroots they need (which can include root access for trusted " +"users to maintain their own images)" +msgstr "" + +#. type: Plain text +#: schroot.1.man:101 +msgid "" +"A chroot may be used directly as root by running B<chroot>(8), but normal " +"users are not able to use this command. B<schroot> allows access to chroots " +"for normal users using the same mechanism, but with permissions checking and " +"allowing additional automated setup of the chroot environment, such as " +"mounting additional filesystems and other configuration tasks. This " +"automated setup is done through the action of I<setup scripts> which may be " +"customised and extended to perform any actions required." +msgstr "" + +#. type: SH +#: schroot.1.man:101 dchroot.1.man:58 dchroot-dsa.1.man:53 +#, no-wrap +msgid "OPTIONS" +msgstr "" + +#. type: Plain text +#: schroot.1.man:103 +msgid "B<schroot> accepts the following options:" +msgstr "" + +#. type: SS +#: schroot.1.man:103 +#, no-wrap +msgid "Actions" +msgstr "" + +#. type: TP +#: schroot.1.man:104 dchroot.1.man:61 dchroot-dsa.1.man:56 +#, no-wrap +msgid "B<-h>, B<--help>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:107 dchroot.1.man:64 dchroot-dsa.1.man:59 +msgid "Show help summary." +msgstr "" + +#. type: TP +#: schroot.1.man:107 dchroot.1.man:113 dchroot-dsa.1.man:103 +#, no-wrap +msgid "B<-V>, B<--version>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:110 dchroot.1.man:116 dchroot-dsa.1.man:106 +msgid "Print version information." +msgstr "" + +#. type: TP +#: schroot.1.man:110 dchroot.1.man:71 dchroot-dsa.1.man:69 +#, no-wrap +msgid "B<-l>, B<--list>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:113 dchroot.1.man:74 dchroot-dsa.1.man:72 +msgid "List all available chroots." +msgstr "" + +#. type: TP +#: schroot.1.man:113 dchroot.1.man:74 dchroot-dsa.1.man:72 +#, no-wrap +msgid "B<-i>, B<--info>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:116 +msgid "Print detailed information about the specified chroots." +msgstr "" + +#. type: TP +#: schroot.1.man:116 dchroot.1.man:81 dchroot-dsa.1.man:79 +#, no-wrap +msgid "B<--config>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:121 +msgid "" +"Print configuration of the specified chroots. This is useful for testing " +"that the configuration in use is the same as the configuration file. Any " +"comments in the original file will be missing." +msgstr "" + +#. type: TP +#: schroot.1.man:121 +#, no-wrap +msgid "B<--location>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:126 +msgid "" +"Print location (path) of the specified chroots. Note that chroot types " +"which can only be used within a session will not have a location until they " +"are active." +msgstr "" + +#. type: SS +#: schroot.1.man:126 schroot.conf.5.man:31 +#, no-wrap +msgid "General options" +msgstr "" + +#. type: TP +#: schroot.1.man:127 dchroot.1.man:106 dchroot-dsa.1.man:95 +#, no-wrap +msgid "B<-q>, B<--quiet>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:130 dchroot.1.man:109 +msgid "Print only essential messages." +msgstr "" + +#. type: TP +#: schroot.1.man:130 dchroot.1.man:109 dchroot-dsa.1.man:99 +#, no-wrap +msgid "B<-v>, B<--verbose>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:133 +msgid "Print all messages." +msgstr "" + +#. type: SS +#: schroot.1.man:133 +#, no-wrap +msgid "Chroot selection" +msgstr "" + +#. type: TP +#: schroot.1.man:134 dchroot.1.man:67 dchroot-dsa.1.man:63 +#, no-wrap +msgid "B<-c>, B<--chroot=>I<chroot>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:140 +msgid "" +"Specify a chroot or active session to use. This option may be used multiple " +"times to specify more than one chroot, in which case its effect is similar " +"to I<--all>. The chroot name may be prefixed with a I<namespace>; see the " +"section \\[lq]I<Chroot Namespaces>\\[rq], below." +msgstr "" + +#. type: TP +#: schroot.1.man:140 dchroot.1.man:64 dchroot-dsa.1.man:59 +#, no-wrap +msgid "B<-a>, B<--all>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:148 +msgid "" +"Select all chroots, source chroots and active sessions. When a command has " +"been specified, the command will be run in all chroots, source chroots and " +"active sessions. If I<--info> has been used, display information about all " +"chroots. This option does not make sense to use with a login shell (when no " +"command has been specified). This option is equivalent to " +"\\[lq]--all-chroots --all-source-chroots --all-sessions\\[rq]." +msgstr "" + +#. type: TP +#: schroot.1.man:148 +#, no-wrap +msgid "B<--all-chroots>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:152 +msgid "" +"Select all chroots. Identical to I<--all>, except that source chroots and " +"active sessions are not considered." +msgstr "" + +#. type: TP +#: schroot.1.man:152 +#, no-wrap +msgid "B<--all-sessions>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:156 +msgid "" +"Select all active sessions. Identical to I<--all>, except that chroots and " +"source chroots are not considered." +msgstr "" + +#. type: TP +#: schroot.1.man:156 +#, no-wrap +msgid "B<--all-source-chroots>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:160 +msgid "" +"Select all source chroots. Identical to I<--all>, except that chroots and " +"sessions are not considered." +msgstr "" + +#. type: SS +#: schroot.1.man:160 +#, no-wrap +msgid "Chroot environment" +msgstr "" + +#. type: TP +#: schroot.1.man:161 dchroot-dsa.1.man:85 +#, no-wrap +msgid "B<-d>, B<--directory=>I<directory>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:166 +msgid "" +"Change to I<directory> inside the chroot before running the command or login " +"shell. If I<directory> is not available, schroot will exit with an error " +"status." +msgstr "" + +#. type: Plain text +#: schroot.1.man:173 +msgid "" +"The default behaviour is as follows (all directory paths are inside the " +"chroot). A login shell is run in the current working directory. If this is " +"not available, it will try $HOME (when I<--preserve-environment> is used), " +"then the user's home directory, and I</> inside the chroot in turn. A " +"command is always run in the current working directory inside the chroot. " +"If none of the directories are available, schroot will exit with an error " +"status." +msgstr "" + +#. type: TP +#: schroot.1.man:173 +#, no-wrap +msgid "B<-u>, B<--user=>I<user>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:178 +msgid "" +"Run as a different user. The default is to run as the current user. If " +"required, the user may be required to authenticate themselves with a " +"password. For further information, see the section " +"\\[lq]I<Authentication>\\[rq], below." +msgstr "" + +#. type: TP +#: schroot.1.man:178 +#, no-wrap +msgid "B<-p>, B<--preserve-environment>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:184 +msgid "" +"Preserve the user's environment inside the chroot environment. The default " +"is to use a clean environment; this option copies the entire user " +"environment and sets it in the session. The environment variables allowed " +"are subject to certain restrictions; see the section " +"\\[lq]I<Environment>\\[rq], below." +msgstr "" + +#. type: SS +#: schroot.1.man:184 +#, no-wrap +msgid "Session actions" +msgstr "" + +#. type: TP +#: schroot.1.man:185 +#, no-wrap +msgid "B<--automatic-session>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:189 +msgid "" +"Begin, run and end a session automatically. This is the default action, so " +"does not require specifying in normal operation." +msgstr "" + +#. type: TP +#: schroot.1.man:189 +#, no-wrap +msgid "B<-b>, B<--begin-session>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:195 +msgid "" +"Begin a session. A unique session identifier (session ID) is returned on " +"standard output. The session ID is required to use the other session " +"options. Note that the session identifier may be specified with the " +"I<--session-name> option." +msgstr "" + +#. type: TP +#: schroot.1.man:195 +#, no-wrap +msgid "B<--recover-session>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:201 +msgid "" +"Recover an existing session. If an existing session has become unavailable, " +"for example becoming unmounted due to a reboot, this option will make the " +"session available for use again, for example by remounting it. The session " +"ID is specified with the I<--chroot> option." +msgstr "" + +#. type: TP +#: schroot.1.man:201 +#, no-wrap +msgid "B<-r>, B<--run-session>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:205 +msgid "" +"Run an existing session. The session ID is specified with the I<--chroot> " +"option." +msgstr "" + +#. type: TP +#: schroot.1.man:205 +#, no-wrap +msgid "B<-e>, B<--end-session>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:209 +msgid "" +"End an existing session. The session ID is specified with the I<--chroot> " +"option." +msgstr "" + +#. type: SS +#: schroot.1.man:209 +#, no-wrap +msgid "Session options" +msgstr "" + +#. type: TP +#: schroot.1.man:210 +#, no-wrap +msgid "B<-n>, B<--session-name=>I<session-name>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:218 +msgid "" +"Name a session. The specified I<session-name> replaces the default session " +"name containing an automatically-generated session ID. The session name " +"must not contain a namespace qualifier, since sessions are always created " +"within the \\[oq]session:\\[cq] namespace. The session name is also subject " +"to the chroot naming restrictions documented in B<schroot.conf>(5)." +msgstr "" + +#. type: TP +#: schroot.1.man:218 +#, no-wrap +msgid "B<-f>, B<--force>" +msgstr "" + +#. type: Plain text +#: schroot.1.man:224 +msgid "" +"Force a session operation, even if it would otherwise fail. This may be " +"used to forcibly end a session, even if it has active users. This does not " +"guarantee that the session will be ended cleanly; filesystems may not be " +"unmounted, for example." +msgstr "" + +#. type: SS +#: schroot.1.man:224 +#, no-wrap +msgid "Separator" +msgstr "" + +#. type: TP +#: schroot.1.man:225 +#, no-wrap +msgid "B<-->" +msgstr "" + +#. type: Plain text +#: schroot.1.man:229 +msgid "" +"End of options. Used to indicate the end of the schroot options; any " +"following options will be passed to the command being run, rather than to " +"schroot." +msgstr "" + +#. type: SH +#: schroot.1.man:229 +#, no-wrap +msgid "AUTHENTICATION" +msgstr "" + +#. type: Plain text +#: schroot.1.man:235 +msgid "" +"If the user is not an allowed user, or a member of the allowed groups (or if " +"changing to root, the allowed root users or allowed root groups) for the " +"specified chroot(s), permission will be immediately denied. If switching " +"users, and the user running the command has access, the user will be " +"required to authenticate themselves using the credentials of the user being " +"switched to." +msgstr "" + +#. type: Plain text +#: schroot.1.man:241 +msgid "" +"On systems supporting Pluggable Authentication Modules (PAM), schroot will " +"use PAM for authentication and authorisation of users. If and when " +"required, schroot will prompt for a password. If PAM is not available, all " +"authentication will automatically fail (user switching is I<not> supported " +"without PAM)." +msgstr "" + +#. type: Plain text +#: schroot.1.man:250 +msgid "" +"Note that when PAM is in use, the root user is not granted any special " +"privileges by default in the program. However, the default PAM " +"configuration permits root to log in without a password (I<pam_rootok.so>), " +"but this may be disabled to prevent root from accessing any chroots except " +"if specifically permitted. In such a situation, root must be added to the " +"allowed users or groups as for any other user or group. If PAM is not " +"available, the root user will be permitted to access all chroots, even when " +"not explicitly granted access." +msgstr "" + +#. type: SH +#: schroot.1.man:250 +#, no-wrap +msgid "CHROOT NAMESPACES" +msgstr "" + +#. type: SS +#: schroot.1.man:251 +#, no-wrap +msgid "Namespace basics" +msgstr "" + +#. type: Plain text +#: schroot.1.man:260 +msgid "" +"There are three different types of chroot: regular chroots, source chroots " +"and session chroots. These different types of chroot are separated into " +"different I<namespaces>. A namespace is a prefix to a chroot name. " +"Currently there are three namespaces: \\[oq]chroot:\\[cq], " +"\\[oq]source:\\[cq] and \\[oq]session:\\[cq]. Use I<--list --all> to list " +"all available chroots in all namespaces. Because \\[oq]:\\[cq] is used as " +"the separator between namespace and chroot names, it is not permitted to use " +"this character in chroot names." +msgstr "" + +#. type: Plain text +#: schroot.1.man:266 +msgid "" +"Depending upon the action you request schroot to take, it may look for the " +"chroot in one of the three namespaces, or a particular namespace may be " +"specified. For example, a chroot named \\[lq]sid\\[rq] is actually named " +"\\[lq]chroot:sid\\[rq] if the namespace is included, but the namespace may " +"be omitted for most actions." +msgstr "" + +#. type: SS +#: schroot.1.man:266 +#, no-wrap +msgid "Source chroots" +msgstr "" + +#. type: Plain text +#: schroot.1.man:279 +msgid "" +"Some chroot types, for example LVM snapshots and Btrfs snapshots, provide " +"session-managed copy-on-write snapshots of the chroot. These also provide a " +"I<source chroot> to allow easy access to the filesystem used as a source for " +"snapshotting. These are regular chroots as well, just with the snapshotting " +"disabled. For a chroot named \\[lq]sid-snapshot\\[rq] (i.e. with a fully " +"qualified name of \\[lq]chroot:sid-snapshot\\[rq]), there will also be a " +"corresponding source chroot named \\[lq]source:sid-snapshot\\[rq]. Earlier " +"versions of schroot provided source chroots with a \\[oq]-source\\[cq] " +"suffix. These are also provided for compatibility. In this example, this " +"would be called \\[lq]chroot:sid-snapshot-source\\[rq]. These compatibility " +"names will be dropped in a future version, so programs and scripts should " +"switch to using the namespace-qualified names rather than the old suffix." +msgstr "" + +#. type: SS +#: schroot.1.man:279 +#, no-wrap +msgid "Session chroots" +msgstr "" + +#. type: Plain text +#: schroot.1.man:285 +msgid "" +"All sessions created with I<--begin-session> are placed within the " +"\\[oq]session:\\[cq] namespace. A session named with I<--session-name> may " +"have any name, even the same name as the chroot it was created from, " +"providing that it is unique within this namespace. This was not permitted " +"in previous versions of schroot which did not have namespaces." +msgstr "" + +#. type: SS +#: schroot.1.man:285 +#, no-wrap +msgid "Actions and default namespaces" +msgstr "" + +#. type: Plain text +#: schroot.1.man:294 +msgid "" +"All actions use \\[oq]chroot:\\[cq] as the default namespace, with some " +"session actions being the exception. I<--run-session>, I<--recover-session> " +"and I<--end-session> use \\[oq]session:\\[cq] as the default namespace " +"instead, since these actions work on session chroots. The upshot is that " +"the namespace is usually never required except when you need to work with a " +"chroot in a namespace other than the default, such as when using a source " +"chroot. To make chroot selection unambiguous, it is always possible to use " +"the full name including the namespace, even when not strictly required." +msgstr "" + +#. type: SH +#: schroot.1.man:294 +#, no-wrap +msgid "PERFORMANCE" +msgstr "" + +#. type: Plain text +#: schroot.1.man:303 +msgid "" +"Performance on some filesystems, for example Btrfs, is bad when running dpkg " +"due to the amount of fsync operations performed. This may be mitigated by " +"installing the eatmydata package and then adding eatmydata to the " +"\\f[CI]command-prefix\\fR configuration key, which disables all fsync " +"operations. Note that this should only be done in snapshot chroots where " +"data loss is not an issue. This is useful when using a chroot for package " +"building, for example." +msgstr "" + +#. type: SH +#: schroot.1.man:303 dchroot.1.man:153 dchroot-dsa.1.man:134 +#, no-wrap +msgid "DIRECTORY FALLBACKS" +msgstr "" + +#. type: Plain text +#: schroot.1.man:313 +msgid "" +"schroot will select an appropriate directory to use within the chroot based " +"upon whether an interactive login shell will be used, or a command invoked, " +"and additionally if the I<--directory> option is used. In the case of " +"running commands directly, or explicitly specifying a directory, only one " +"directory will be used for safety and consistency, while for a login shell " +"several possibilities may be tried. The following subsections list the " +"fallback sequence for each case. CWD is the current working directory, DIR " +"is the directory specified with I<--directory>." +msgstr "" + +#. type: SS +#: schroot.1.man:313 +#, no-wrap +msgid "Login shell" +msgstr "" + +#. type: tbl table +#: schroot.1.man:317 schroot.1.man:340 schroot.1.man:356 dchroot.1.man:168 dchroot.1.man:186 dchroot.1.man:203 dchroot-dsa.1.man:149 dchroot-dsa.1.man:166 +#, no-wrap +msgid "Transition\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:318 schroot.1.man:341 schroot.1.man:357 dchroot.1.man:169 dchroot.1.man:187 dchroot.1.man:204 dchroot-dsa.1.man:150 dchroot-dsa.1.man:167 +#, no-wrap +msgid "(Host \\[-E<gt>] Chroot)\tComment\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:319 schroot.1.man:342 schroot.1.man:358 dchroot.1.man:170 dchroot.1.man:188 dchroot.1.man:205 dchroot-dsa.1.man:151 dchroot-dsa.1.man:168 +#, no-wrap +msgid "_\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:320 schroot.1.man:343 dchroot.1.man:189 +#, no-wrap +msgid "CWD \\[-E<gt>] CWD\tT{\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:321 schroot.1.man:344 +#, no-wrap +msgid "Normal behaviour (if I<--directory> is not used)\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:322 schroot.1.man:325 schroot.1.man:328 schroot.1.man:331 schroot.1.man:334 schroot.1.man:345 schroot.1.man:348 dchroot.1.man:174 dchroot.1.man:177 dchroot.1.man:180 dchroot.1.man:191 dchroot.1.man:194 dchroot.1.man:197 dchroot-dsa.1.man:154 dchroot-dsa.1.man:157 dchroot-dsa.1.man:160 +#, no-wrap +msgid "T}\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:323 +#, no-wrap +msgid "CWD \\[-E<gt>] $HOME\tT{\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:324 +#, no-wrap +msgid "If CWD is nonexistent and --preserve-environment is used\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:326 dchroot.1.man:171 dchroot-dsa.1.man:152 +#, no-wrap +msgid "CWD \\[-E<gt>] passwd pw_dir\tT{\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:327 +#, no-wrap +msgid "" +"If CWD is nonexistent (or --preserve-environment is used and no $HOME " +"exists)\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:329 dchroot.1.man:175 dchroot.1.man:192 dchroot-dsa.1.man:155 +#, no-wrap +msgid "CWD \\[-E<gt>] /\tT{\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:330 +#, no-wrap +msgid "None of the above exist\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:332 schroot.1.man:346 dchroot.1.man:178 dchroot.1.man:195 dchroot-dsa.1.man:158 +#, no-wrap +msgid "B<FAIL>\tT{\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:333 dchroot.1.man:179 dchroot.1.man:196 dchroot-dsa.1.man:159 +#, no-wrap +msgid "If / is nonexistent\n" +msgstr "" + +#. type: SS +#: schroot.1.man:336 +#, no-wrap +msgid "Command" +msgstr "" + +#. type: tbl table +#: schroot.1.man:347 dchroot.1.man:193 +#, no-wrap +msgid "If CWD is nonexistent\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:352 schroot.1.man:364 dchroot.1.man:211 dchroot-dsa.1.man:174 +msgid "No fallbacks should exist under any circumstances." +msgstr "" + +#. type: SS +#: schroot.1.man:352 dchroot.1.man:199 dchroot-dsa.1.man:162 +#, no-wrap +msgid "--directory used" +msgstr "" + +#. type: tbl table +#: schroot.1.man:359 dchroot.1.man:206 dchroot-dsa.1.man:169 +#, no-wrap +msgid "CWD \\[-E<gt>] DIR\tNormal behaviour\n" +msgstr "" + +#. type: tbl table +#: schroot.1.man:360 dchroot.1.man:207 dchroot-dsa.1.man:170 +#, no-wrap +msgid "B<FAIL>\tIf DIR is nonexistent\n" +msgstr "" + +#. type: SS +#: schroot.1.man:364 dchroot.1.man:211 dchroot-dsa.1.man:174 +#, no-wrap +msgid "Debugging" +msgstr "" + +#. type: Plain text +#: schroot.1.man:368 dchroot.1.man:215 dchroot-dsa.1.man:178 +msgid "" +"Note that I<--debug=notice> will show the internal fallback list computed " +"for the session." +msgstr "" + +#. type: SH +#: schroot.1.man:368 dchroot.1.man:215 dchroot-dsa.1.man:178 +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: SS +#: schroot.1.man:369 +#, no-wrap +msgid "List available chroots" +msgstr "" + +#. type: Plain text +#: schroot.1.man:377 +#, no-wrap +msgid "" +"% \\f[CB]schroot -l\\fR\\[CR]\n" +"chroot:default\n" +"chroot:etch\n" +"chroot:sid\n" +"chroot:testing\n" +"chroot:unstable\n" +msgstr "" + +#. type: SS +#: schroot.1.man:378 +#, no-wrap +msgid "Get information about a chroot" +msgstr "" + +#. type: Plain text +#: schroot.1.man:401 +#, no-wrap +msgid "" +"% \\f[CB]schroot -i -c sid\\fR\\[CR]\n" +" \\[em]\\[em]\\[em] Chroot \\[em]\\[em]\\[em]\n" +" Name sid\n" +" Description Debian sid (unstable)\n" +" Type plain\n" +" Priority 3\n" +" Users rleigh\n" +" Groups sbuild\n" +" Root Users\n" +" Root Groups sbuild\n" +" Aliases unstable unstable-sbuild unstable-p\n" +"owerpc-sbuild\n" +" Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\\e\n" +"FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\\e\n" +"IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\\e\n" +"RMPATH)$\n" +" Run Setup Scripts true\n" +" Script Configuration script-defaults\n" +" Session Managed true\n" +" Personality linux32\n" +" Location /srv/chroot/sid\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:405 +msgid "" +"Use I<--all> or I<-c> multiple times to use all or multiple chroots, " +"respectively." +msgstr "" + +#. type: SS +#: schroot.1.man:405 +#, no-wrap +msgid "Running commands in a chroot" +msgstr "" + +#. type: Plain text +#: schroot.1.man:421 +#, no-wrap +msgid "" +"% \\f[CB]schroot -c sid /bin/ls\\fR\\[CR]\n" +"[sid chroot] Running command: \\[lq]/bin/ls\\[rq]\n" +"CVS sbuild-chroot.c sbuild-session.h schroot.conf.5\n" +"Makefile sbuild-chroot.h schroot.1 schroot.conf.5.in\n" +"Makefile.am sbuild-config.c schroot.1.in\n" +"Makefile.in sbuild-config.h schroot.c\n" +"pam sbuild-session.c schroot.conf\n" +"% \\f[CB]schroot -c sid -- ls -1 | head -n 5\\fR\\[CR]\n" +"[sid chroot] Running command: \\[lq]ls -1\\[rq]\n" +"ABOUT-NLS\n" +"AUTHORS\n" +"COPYING\n" +"ChangeLog\n" +"INSTALL\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:430 +msgid "" +"Use I<--> to allow options beginning with \\[oq]-\\[cq] or \\[oq]--\\[cq] in " +"the command to run in the chroot. This prevents them being interpreted as " +"options for schroot itself. Note that the top line was echoed to standard " +"error, and the remaining lines to standard output. This is intentional, so " +"that program output from commands run in the chroot may be piped and " +"redirected as required; the data will be the same as if the command was run " +"directly on the host system." +msgstr "" + +#. type: SS +#: schroot.1.man:430 +#, no-wrap +msgid "Switching users" +msgstr "" + +#. type: Plain text +#: schroot.1.man:436 +#, no-wrap +msgid "" +"% \\f[CB]schroot -c sid -u root\\fR\\[CR]\n" +"Password:\n" +"[sid chroot] (rleigh\\[-E<gt>]root) Running login shell: " +"\\[lq]/bin/bash\\[rq]\n" +"# \n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:442 +msgid "" +"If the user \\[oq]rleigh\\[cq] was in \\f[CI]root-users\\fR in " +"I<\\*[SCHROOT_CONF]>, or one of the groups he belonged to was in " +"\\f[CI]root-groups\\fR, they would be granted root access without " +"authentication, but the PAM authorisation step is still applied." +msgstr "" + +#. type: SS +#: schroot.1.man:442 +#, no-wrap +msgid "Sessions" +msgstr "" + +#. type: Plain text +#: schroot.1.man:449 +msgid "" +"A chroot may be needed to run more than one command. In particular, where " +"the chroot is created on the fly from an LVM LV or a file on disc, there is " +"a need to make the chroot persistent while a given task (or set of tasks) is " +"performed. Sessions exist for this purpose. For simple chroot types such " +"as \\[oq]plain\\[cq] and \\[oq]directory\\[cq], sessions may be created but " +"are not strictly necessary." +msgstr "" + +#. type: Plain text +#: schroot.1.man:451 +msgid "Let's start by looking at a session-capable chroot:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:479 +#, no-wrap +msgid "" +"% \\f[CB]schroot -i -c sid-snap\\fR\\[CR]\n" +" \\[em]\\[em]\\[em] Chroot \\[em]\\[em]\\[em]\n" +" Name sid-snap\n" +" Description Debian sid snapshot\n" +" Type lvm-snapshot\n" +" Priority 3\n" +" Users maks rleigh\n" +" Groups sbuild\n" +" Root Users\n" +" Root Groups root sbuild\n" +" Aliases\n" +" Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\\e\n" +"FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\\e\n" +"IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\\e\n" +"RMPATH)$\n" +" Run Setup Scripts true\n" +" Script Configuration script-defaults\n" +" Session Managed true\n" +" Personality linux\n" +" Device /dev/hda_vg/sid_chroot\n" +" Mount Options -o atime,async,user_xattr\n" +" Source Users\n" +" Source Groups root rleigh\n" +" Source Root Users\n" +" Source Root Groups root rleigh\n" +" LVM Snapshot Options --size 2G -c 128\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:484 +msgid "" +"Note that the I<Session Managed> option is set to \\[oq]true\\[cq]. This is " +"a requirement in order to use session management, and is supported by most " +"chroot types. Next, we will create a new session:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:488 +#, no-wrap +msgid "" +"% \\f[CB]schroot -b -c sid-snap\\fR\\[CR]\n" +"sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:492 +msgid "" +"The session ID of the newly-created session is returned on standard output. " +"It is common to store it like this:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:497 +#, no-wrap +msgid "" +"% \\f[CB]SESSION=$(schroot -b -c sid-snap)\\fR\\[CR]\n" +"% \\f[CB]echo $SESSION\\fR\\[CR]\n" +"sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:501 +msgid "" +"The session may be used just like any normal chroot. This is what the " +"session looks like:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:538 +#, no-wrap +msgid "" +"% \\f[CB]schroot -i -c " +"sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f\\fR\\[CR]\n" +" \\[em]\\[em]\\[em] Session \\[em]\\[em]\\[em]\n" +" Name sid-snap-46195b04-0893-49bf-beb8-0d\\e\n" +"4ccc899f0f\n" +" Description Debian sid snapshot\n" +" Type lvm-snapshot\n" +" Priority 3\n" +" Users maks rleigh\n" +" Groups sbuild\n" +" Root Users\n" +" Root Groups root sbuild\n" +" Aliases\n" +" Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\\e\n" +"FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\\e\n" +"IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\\e\n" +"RMPATH)$\n" +" Run Setup Scripts true\n" +" Script Configuration script-defaults\n" +" Session Managed true\n" +" Personality linux\n" +" Mount Location /var/lib/schroot/mount/sid-snap-461\\e\n" +"95b04-0893-49bf-beb8-0d4ccc899f0f\n" +" Path /var/lib/schroot/mount/sid-snap-461\\e\n" +"95b04-0893-49bf-beb8-0d4ccc899f0f\n" +" Mount Device /dev/hda_vg/sid-snap-46195b04-0893-\\e\n" +"49bf-beb8-0d4ccc899f0f\n" +" Device /dev/hda_vg/sid_chroot\n" +" Mount Options -o atime,async,user_xattr\n" +" Source Users\n" +" Source Groups root rleigh\n" +" Source Root Users\n" +" Source Root Groups root rleigh\n" +" LVM Snapshot Device /dev/hda_vg/sid-snap-46195b04-0893-\\e\n" +"49bf-beb8-0d4ccc899f0f\n" +" LVM Snapshot Options --size 2G -c 128\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:541 +msgid "Now the session has been created, commands may be run in it:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:552 +#, no-wrap +msgid "" +"% \\f[CB]schroot -r -c sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f -- " +"\\e\n" +" uname -sr\\fR\\[CR]\n" +"I: [sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f chroot] Running \\e\n" +"command: \\[lq]uname -sr\\[rq]\n" +"Linux 2.6.18-3-powerpc\n" +"% \\f[CB]schroot -r -c $SESSION -- uname -sr\\fR\\[CR]\n" +"I: [sid-snap-fe170af9-d9be-4800-b1bd-de275858b938 chroot] Running \\e\n" +"command: \\[lq]uname -sr\\[rq]\n" +"Linux 2.6.18-3-powerpc\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:556 +msgid "" +"When all the commands to run in the session have been performed, the session " +"may be ended:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:560 +#, no-wrap +msgid "" +"\\f[CR]% \\f[CB]schroot -e -c " +"sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f\\f[CB]\\[CR]\n" +"\\f[CR]% \\f[CB]schroot -e -c $SESSION\\f[CB]\\[CR]\\fR\n" +msgstr "" + +#. type: Plain text +#: schroot.1.man:564 +msgid "" +"Finally, the session names can be long and unwieldy. A name may be " +"specified instead of using the automatically generated session ID:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:568 +#, no-wrap +msgid "" +"\\f[CR]% \\f[CB]schroot -b -c sid-snap -n my-session-name\\f[CB]\\[CR]\n" +"\\f[CR]my-session-name\\fR\n" +msgstr "" + +#. type: SH +#: schroot.1.man:569 dchroot.1.man:246 dchroot-dsa.1.man:199 +#, no-wrap +msgid "TROUBLESHOOTING" +msgstr "" + +#. type: Plain text +#: schroot.1.man:576 dchroot.1.man:253 dchroot-dsa.1.man:206 +msgid "" +"If something is not working, and it's not clear from the error messages what " +"is wrong, try using the B<--debug=>I<level> option to turn on debugging " +"messages. This gives a great deal more information. Valid debug levels are " +"\\[oq]none\\[cq], and \\[oq]notice\\[cq], \\[oq]info\\[cq], " +"\\[oq]warning\\[cq] and \\[oq]critical\\[cq] in order of increasing " +"severity. The lower the severity level, the more output." +msgstr "" + +#. type: Plain text +#: schroot.1.man:579 dchroot.1.man:256 dchroot-dsa.1.man:209 +msgid "" +"If you are still having trouble, the developers may be contacted on the " +"mailing list:" +msgstr "" + +#. type: Plain text +#: schroot.1.man:581 dchroot.1.man:258 dchroot-dsa.1.man:211 +msgid "\\f[CR]Debian\\ buildd-tools\\ Developers\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:583 dchroot.1.man:260 dchroot-dsa.1.man:213 +msgid "\\f[CR]E<lt>buildd-tools-devel@lists.alioth.debian.orgE<gt>\\fR" +msgstr "" + +#. type: SH +#: schroot.1.man:583 dchroot.1.man:260 dchroot-dsa.1.man:213 +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: schroot.1.man:591 dchroot.1.man:268 dchroot-dsa.1.man:221 +msgid "" +"On the B<mips> and B<mipsel> architectures, Linux kernels up to and " +"including at least version 2.6.17 have broken B<personality>(2) support, " +"which results in a failure to set the personality. This will be seen as an " +"\\[lq]Operation not permitted\\[rq] (EPERM) error. To work around this " +"problem, set \\f[CI]personality\\fR to \\[oq]undefined\\[cq], or upgrade to " +"a more recent kernel." +msgstr "" + +#. type: SH +#: schroot.1.man:591 schroot-setup.5.man:51 schroot-script-config.5.man:29 +#, no-wrap +msgid "ENVIRONMENT" +msgstr "" + +#. type: Plain text +#: schroot.1.man:601 +msgid "" +"By default, the environment is not preserved, and the following environment " +"variables are defined: HOME, LOGNAME, PATH, SHELL, TERM (preserved if " +"already defined), and USER. The environment variables SCHROOT_COMMAND, " +"SCHROOT_USER, SCHROOT_GROUP, SCHROOT_UID and SCHROOT_GID are set inside the " +"chroot specifying the command being run, the user name, group name, user ID " +"and group ID, respectively. Additionally, the environment variables " +"SCHROOT_SESSION_ID, SCHROOT_CHROOT_NAME and SCHROOT_ALIAS_NAME specify the " +"session ID, the original chroot name prior to session creation, and the " +"alias used to originally identify the selected chroot, respectively." +msgstr "" + +#. type: Plain text +#: schroot.1.man:610 +msgid "" +"The following, potentially dangerous, environment variables are removed for " +"safety by default: BASH_ENV, CDPATH, ENV, HOSTALIASES, IFS, KRB5_CONFIG, " +"KRBCONFDIR, KRBTKFILE, KRB_CONF, LD_.*, LOCALDOMAIN, NLSPATH, PATH_LOCALE, " +"RES_OPTIONS, TERMINFO, TERMINFO_DIRS, and TERMPATH. If desired, the " +"\\f[CI]environment-filter\\fR configuration key will allow the exclusion " +"list to the modified; see B<schroot.conf>(5) for further details." +msgstr "" + +#. type: SH +#: schroot.1.man:610 schroot-setup.5.man:194 schroot.conf.5.man:512 dchroot.1.man:268 dchroot-dsa.1.man:221 +#, no-wrap +msgid "FILES" +msgstr "" + +#. type: SS +#: schroot.1.man:611 +#, no-wrap +msgid "Configuration files" +msgstr "" + +#. type: TP +#: schroot.1.man:612 schroot.conf.5.man:514 dchroot.1.man:269 dchroot-dsa.1.man:222 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_CONF]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:616 schroot.conf.5.man:518 +msgid "" +"The system-wide chroot definition file. This file must be owned by the root " +"user, and not be writable by other." +msgstr "" + +#. type: TP +#: schroot.1.man:616 schroot.conf.5.man:518 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_CONF_CHROOT_D]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:624 +msgid "" +"Additional chroot definitions may be placed in files under this directory. " +"They are treated in exactly that same manner as I<\\*[SCHROOT_CONF]>. Each " +"file may contain one or more chroot definitions. Note that the files in " +"this directory follow the same naming rules as B<run-parts>(8) when run " +"with the I<--lsbsysinit> option." +msgstr "" + +#. type: TP +#: schroot.1.man:624 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:628 +msgid "The system-wide chroot setup script directories. See B<schroot-setup>(5)." +msgstr "" + +#. type: TP +#: schroot.1.man:628 +#, no-wrap +msgid "\\f[BI]/etc/pam.d/schroot\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:631 +msgid "PAM configuration." +msgstr "" + +#. type: SS +#: schroot.1.man:631 +#, no-wrap +msgid "System directories" +msgstr "" + +#. type: TP +#: schroot.1.man:632 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_LIBEXEC_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:635 +msgid "Directory containing helper programs used by setup scripts." +msgstr "" + +#. type: SS +#: schroot.1.man:635 +#, no-wrap +msgid "Session directories" +msgstr "" + +#. type: Plain text +#: schroot.1.man:638 +msgid "" +"Each directory contains a directory or file with the name of each session. " +"Not all chroot types make use of all the following directories." +msgstr "" + +#. type: TP +#: schroot.1.man:638 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_SESSION_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:641 +msgid "Directory containing the session configuration for each active session." +msgstr "" + +#. type: TP +#: schroot.1.man:641 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_MOUNT_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:644 +msgid "Directory used to mount the filesystems used by each active session." +msgstr "" + +#. type: TP +#: schroot.1.man:644 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_UNDERLAY_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:647 +msgid "Directory used for filesystem union source (underlay)." +msgstr "" + +#. type: TP +#: schroot.1.man:647 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_OVERLAY_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:650 +msgid "Directory used for filesystem union writeable overlay." +msgstr "" + +#. type: TP +#: schroot.1.man:650 +#, no-wrap +msgid "\\f[BI]\\*[SCHROOT_FILE_UNPACK_DIR]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.1.man:653 +msgid "Directory used for unpacking file chroots." +msgstr "" + +#. type: SH +#: schroot.1.man:655 schroot-setup.5.man:257 schroot.conf.5.man:552 schroot-script-config.5.man:62 schroot-faq.7.man:253 dchroot.1.man:279 dchroot-dsa.1.man:234 +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: schroot.1.man:662 +msgid "" +"B<dchroot>(1), B<sbuild>(1), B<chroot>(2), B<run-parts>(8), " +"B<schroot-setup>(5), B<schroot-faq>(7), B<schroot.conf>(5)." +msgstr "" + +#. type: TH +#: schroot-setup.5.man:18 +#, no-wrap +msgid "SCHROOT-SETUP" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:21 +msgid "schroot-setup - schroot chroot setup scripts" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:27 +msgid "" +"B<schroot> uses scripts to set up and then clean up the chroot environment. " +"The directory \\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR contains scripts run when " +"a chroot is created and destroyed. Several environment variables are set " +"while the scripts are being run, which allows their behaviour to be " +"customised, depending upon, for example, the type of chroot in use." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:32 +msgid "" +"The scripts are run in name order, like those run by B<init>(8), by using " +"the same style of execution as B<run-parts>(8)." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:34 +msgid "The setup scripts are all invoked with two options:" +msgstr "" + +#. type: IP +#: schroot-setup.5.man:34 +#, no-wrap +msgid "1" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:36 +msgid "The action to perform." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:41 +msgid "" +"When a session is first started, the chroot is set up by running the scripts " +"in \\*[SCHROOT_CONF_SETUP_D] with the \\[oq]setup-start\\[cq] option. When " +"the session is ended, the scripts in I<\\*[SCHROOT_CONF_SETUP_D]> are run in " +"reverse order with the \\[oq]setup-stop\\[cq] option." +msgstr "" + +#. type: IP +#: schroot-setup.5.man:41 +#, no-wrap +msgid "2" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:43 +msgid "The chroot status." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:47 +msgid "" +"This is either \\[oq]ok\\[cq] if there are no problems, or \\[oq]fail\\[cq] " +"if something went wrong. For example, particular actions may be skipped on " +"failure." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:51 +msgid "" +"Note that the scripts should be I<idempotent>. They B<must> be idempotent " +"during the \\[oq]setup-stop\\[cq] phase, because they may be run more than " +"once, for example on failure." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:52 +#, no-wrap +msgid "General variables" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:53 +#, no-wrap +msgid "AUTH_USER" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:56 +msgid "The username of the user the command in the chroot will run as." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:56 schroot-setup.5.man:111 +#, no-wrap +msgid "CHROOT_NAME" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:60 +msgid "" +"The chroot name. Note that this is the name of the orignal chroot before " +"session creation; you probably want SESSION_ID." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:60 +#, no-wrap +msgid "HOST" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:62 +#, no-wrap +msgid "HOST_OS" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:64 +#, no-wrap +msgid "HOST_VENDOR" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:66 +#, no-wrap +msgid "HOST_CPU" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:72 +msgid "" +"The host system architecture schroot is running upon. This may be used to " +"introduce architecture-specific behaviour into the setup scripts where " +"required. HOST is the GNU triplet for the architecture, while HOST_OS, " +"HOST_VENDOR and HOST_CPU are the component parts of the triplet." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:72 +#, no-wrap +msgid "LIBEXEC_DIR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:75 +msgid "The directory under which helper programs are located." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:75 +#, no-wrap +msgid "MOUNT_DIR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:79 +msgid "" +"The directory under which non-filesystem chroots are mounted (e.g. block " +"devices and LVM snapshots)." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:79 +#, no-wrap +msgid "PID" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:82 +msgid "The process ID of the schroot process." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:82 +#, no-wrap +msgid "PLATFORM" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:89 +msgid "" +"The operating system platform schroot is running upon. This may be used to " +"introduce platform-specific behaviour into the setup scripts where " +"required. Note that the HOST variables are probably what are required. In " +"the context of schroot, the platform is the supported configuration and " +"behaviour for a given architecture, and may be identical between different " +"architectures." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:89 +#, no-wrap +msgid "SESSION_ID" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:92 +msgid "The session identifier." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:92 +#, no-wrap +msgid "VERBOSE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:98 +msgid "" +"Set to \\[oq]quiet\\[cq] if only error messages should be printed, " +"\\[oq]normal\\[cq] if other messages may be printed as well, and " +"\\[oq]verbose\\[cq] if all messages may be printed. Previously called " +"AUTH_VERBOSITY." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:98 +#, no-wrap +msgid "CHROOT_SESSION_CREATE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:101 +msgid "" +"Set to \\[oq]true\\[cq] if a session will be created, otherwise " +"\\[oq]false\\[cq]." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:101 +#, no-wrap +msgid "CHROOT_SESSION_CLONE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:104 +msgid "" +"Set to \\[oq]true\\[cq] if a session will be cloned, otherwise " +"\\[oq]false\\[cq]." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:104 +#, no-wrap +msgid "CHROOT_SESSION_PURGE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:107 +msgid "" +"Set to \\[oq]true\\[cq] if a session will be purged, otherwise " +"\\[oq]false\\[cq]." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:107 +#, no-wrap +msgid "CHROOT_TYPE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:111 +msgid "" +"The type of the chroot. This is useful for restricting a setup task to " +"particular types of chroot (e.g. only block devices or LVM snapshots)." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:115 +msgid "" +"The name of the chroot. This is useful for restricting a setup task to a " +"particular chroot, or set of chroots." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:115 +#, no-wrap +msgid "CHROOT_ALIAS" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:122 +msgid "" +"The name of the alias used to select the chroot. This is useful for " +"specialising a setup task based upon one of its alternative alias names, or " +"the default chroot name. For example, it could be used to specify " +"additional sources in I</etc/apt/sources.list>, such as a stable-security " +"alias for a stable chroot, or an experimental alias for an unstable chroot." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:122 +#, no-wrap +msgid "CHROOT_DESCRIPTION" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:125 +msgid "The description of the chroot." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:125 +#, no-wrap +msgid "CHROOT_MOUNT_LOCATION" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:129 +msgid "" +"The location to mount the chroot. It is used for mount point creation and " +"mounting." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:129 schroot-setup.5.man:159 +#, no-wrap +msgid "CHROOT_LOCATION" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:133 +msgid "" +"The location of the chroot inside the mount point. This is to allow " +"multiple chroots on a single filesystem. Set for all mountable chroot " +"types." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:133 +#, no-wrap +msgid "CHROOT_PATH" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:138 +msgid "" +"The absolute path to the chroot. This is typically CHROOT_MOUNT_LOCATION " +"and CHROOT_LOCATION concatenated together. This is the path which should be " +"used to access the chroots." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:138 +#, no-wrap +msgid "Plain and directory chroot variables" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:140 +msgid "These chroot types use only general variables." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:140 +#, no-wrap +msgid "File variables" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:141 +#, no-wrap +msgid "CHROOT_FILE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:144 +msgid "The file containing the chroot files." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:144 +#, no-wrap +msgid "CHROOT_FILE_REPACK" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:148 +msgid "" +"Set to \\[oq]true\\[cq] to repack the chroot into an archive file on ending " +"a session, otherwise \\[oq]false\\[cq]." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:148 +#, no-wrap +msgid "Mountable chroot variables" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:151 +msgid "These variables are only set for directly mountable chroot types." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:151 +#, no-wrap +msgid "CHROOT_MOUNT_DEVICE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:155 +msgid "The device to mount containing the chroot. mounting." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:155 +#, no-wrap +msgid "CHROOT_MOUNT_OPTIONS" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:159 +msgid "Options to pass to B<mount>(8)." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:163 +msgid "" +"The location of the chroot inside the mount point. This allows the " +"existence of multiple chroots on a single filesystem." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:163 +#, no-wrap +msgid "Filesystem union variables" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:164 +#, no-wrap +msgid "CHROOT_UNION_TYPE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:167 +msgid "Union filesystem type." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:167 +#, no-wrap +msgid "CHROOT_UNION_MOUNT_OPTIONS" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:170 +msgid "Union filesystem mount options." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:170 +#, no-wrap +msgid "CHROOT_UNION_OVERLAY_DIRECTORY" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:173 +msgid "Union filesystem overlay directory (writable)." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:173 +#, no-wrap +msgid "CHROOT_UNION_UNDERLAY_DIRECTORY" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:176 +msgid "Union filesystem underlay directory (read-only)." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:176 +#, no-wrap +msgid "Block device variables" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:177 +#, no-wrap +msgid "CHROOT_DEVICE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:182 +msgid "" +"The device containing the chroot root filesystem. This is usually, but not " +"necessarily, the device which will be mounted. For example, an LVM snapshot " +"this will be the original logical volume." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:182 +#, no-wrap +msgid "LVM snapshot variables" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:183 +#, no-wrap +msgid "CHROOT_LVM_SNAPSHOT_NAME" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:187 +msgid "Snapshot name to pass to B<lvcreate>(8)." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:187 +#, no-wrap +msgid "CHROOT_LVM_SNAPSHOT_DEVICE" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:190 +msgid "The name of the LVM snapshot device." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:190 +#, no-wrap +msgid "CHROOT_LVM_SNAPSHOT_OPTIONS" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:194 +msgid "Options to pass to B<lvcreate>(8)." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:195 schroot.conf.5.man:523 +#, no-wrap +msgid "Setup script configuration" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:198 schroot.conf.5.man:526 +msgid "" +"The directory \\f[BI]\\*[SCHROOT_SYSCONF_DIR]/default\\fR contains the " +"default settings used by setup scripts." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:198 schroot.conf.5.man:526 +#, no-wrap +msgid "\\f[BI]config\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:206 schroot.conf.5.man:534 +msgid "" +"Main configuration file read by setup scripts. The format of this file is " +"described in B<schroot-script-config>(5). This is the default value for the " +"\\f[CI]script-config\\fR key. Note that this was formerly named " +"I<\\*[SCHROOT_SYSCONF_DIR]/script-defaults>. The following files are " +"referenced by default:" +msgstr "" + +#. type: TP +#: schroot-setup.5.man:206 schroot.conf.5.man:534 +#, no-wrap +msgid "\\f[BI]copyfiles\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:210 schroot.conf.5.man:538 +msgid "" +"A list of files to copy into the chroot from the host system. Note that " +"this was formerly named I<\\*[SCHROOT_SYSCONF_DIR]/copyfiles-defaults>." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:210 schroot.conf.5.man:538 +#, no-wrap +msgid "\\f[BI]fstab\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:217 schroot.conf.5.man:545 +msgid "" +"A file in the format decribed in B<fstab>(5), used to mount filesystems " +"inside the chroot. The mount location is relative to the root of the " +"chroot. Note that this was formerly named " +"I<\\*[SCHROOT_SYSCONF_DIR]/mount-defaults>." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:217 schroot.conf.5.man:545 +#, no-wrap +msgid "\\f[BI]nssdatabases\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:222 schroot.conf.5.man:550 +msgid "" +"System databases (as described in I</etc/nsswitch.conf> on GNU/Linux " +"systems) to copy into the chroot from the host. Note that this was formerly " +"named I<\\*[SCHROOT_SYSCONF_DIR]/nssdatabases-defaults>." +msgstr "" + +#. type: SS +#: schroot-setup.5.man:222 +#, no-wrap +msgid "Setup scripts" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:224 +msgid "" +"The directory \\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR contains the chroot setup " +"scripts." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:224 +#, no-wrap +msgid "\\f[BI]00check\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:227 +msgid "Print debugging diagnostics and perform basic sanity checking." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:227 +#, no-wrap +msgid "\\f[BI]05file\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:230 +msgid "Unpack, clean up, and repack file-based chroots." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:230 +#, no-wrap +msgid "\\f[BI]05fsunion\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:233 +msgid "Create and remove union filesystems." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:233 +#, no-wrap +msgid "\\f[BI]05lvm\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:236 +msgid "Create and remove LVM snapshots." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:236 +#, no-wrap +msgid "\\f[BI]10mount\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:239 +msgid "Mount and unmount filesystems." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:239 +#, no-wrap +msgid "\\f[BI]15killprocs\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:243 +msgid "" +"Kill processes still running inside the chroot when ending a session, which " +"would prevent unmounting of filesystems and cleanup of any other resources." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:243 +#, no-wrap +msgid "\\f[BI]20copyfiles\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:247 +msgid "" +"Copy files from the host system into the chroot. Configure networking by " +"copying I<hosts> and I<resolv.conf>, for example." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:247 +#, no-wrap +msgid "\\f[BI]20nssdatabases\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:251 +msgid "" +"Configure system databases by copying passwd, shadow, group etc. into the " +"chroot." +msgstr "" + +#. type: TP +#: schroot-setup.5.man:251 +#, no-wrap +msgid "\\f[BI]50chrootname\\fR" +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:255 +msgid "" +"Set the chroot name (I</etc/debian_chroot>) in the chroot. This may be used " +"by the shell prompt to display the current chroot." +msgstr "" + +#. type: Plain text +#: schroot-setup.5.man:262 +msgid "" +"B<schroot>(1), B<fstab>(5), B<schroot.conf>(5), B<schroot-script-config>(5), " +"B<run-parts>(8)." +msgstr "" + +#. type: TH +#: schroot.conf.5.man:18 +#, no-wrap +msgid "SCHROOT.CONF" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:21 +msgid "schroot.conf - chroot definition file for schroot" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:24 +msgid "" +"\\f[BI]schroot.conf\\fR is a plain UTF-8 text file, describing the chroots " +"available for use with schroot." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:28 +msgid "" +"Comments are introduced following a \\[oq]\\f[CR]\\[sh]\\fR\\[cq] " +"(\\[lq]hash\\[rq]) character at the beginning of a line, or following any " +"other text. All text right of the \\[oq]\\f[CR]\\[sh]\\fR\\[cq] is treated " +"as a comment." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:31 +msgid "" +"The configuration format is an INI-style format, split into groups of " +"key-value pairs separated by section names in square brackets." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:35 +msgid "" +"A chroot is defined as a group of key-value pairs, which is started by a " +"name in square brackets on a line by itself. The file may contain multiple " +"groups which therefore define multiple chroots." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:38 +msgid "" +"A chroot definition is started by the name of the chroot in square " +"brackets. For example," +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:40 +msgid "\\f[CR]\\[lB]sid\\[rB]\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:43 +msgid "" +"The name is subject to certain naming restrictions. For further details, " +"see the section \\[lq]I<Chroot Names>\\[rq] below." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:45 +msgid "This is then followed by several key-value pairs, one per line:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:45 +#, no-wrap +msgid "\\f[CBI]type=\\f[CI]type\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:53 +msgid "" +"The type of the chroot. Valid types are \\[oq]plain\\[cq], " +"\\[oq]directory\\[cq], \\[oq]file\\[cq], \\[oq]loopback\\[cq], " +"\\[oq]block-device\\[cq], \\[oq]btrfs-snapshot\\[cq] and " +"\\[oq]lvm-snapshot\\[cq]. If empty or omitted, the default type is " +"\\[oq]plain\\[cq]. Note that \\[oq]plain\\[cq] chroots do not run setup " +"scripts and mount filesystems; \\[oq]directory\\[cq] is recommended for " +"normal use (see \\[lq]I<Plain and directory chroots>\\[rq], below)." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:53 +#, no-wrap +msgid "\\f[CBI]description=\\f[CI]description\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:57 +msgid "" +"A short description of the chroot. This may be localised for different " +"languages; see the section \\[lq]I<Localisation>\\[rq] below." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:57 +#, no-wrap +msgid "\\f[CBI]priority=\\f[CI]number\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:67 +msgid "" +"Set the priority of a chroot. \\f[CI]number\\fR is a positive integer " +"indicating whether a distribution is older than another. For example, " +"\\[lq]oldstable\\[rq] and \\[lq]oldstable-security\\[rq] might be " +"\\[oq]0\\[cq], while \\[lq]stable\\[rq] and \\[lq]stable-security\\[rq] are " +"\\[oq]1\\[cq], \\[lq]testing\\[rq] is \\[oq]2\\[cq] and \\[lq]unstable\\[rq] " +"is \\[oq]3\\[cq]. The values are not important, but the difference between " +"them is. This option is deprecated and no longer used by schroot, but is " +"still permitted to be used; it will be obsoleted and removed in a future " +"release." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:67 +#, no-wrap +msgid "\\f[CBI]message-verbosity=\\f[CI]verbosity\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:74 +msgid "" +"Set the verbosity of messages printed by schroot when setting up, running " +"commands and cleaning up the chroot. Valid settings are \\[oq]quiet\\[cq] " +"(suppress most messages), \\[oq]normal\\[cq] (the default) and " +"\\[oq]verbose\\[cq] (show all messages). This setting is overridden by the " +"options I<--quiet> and I<--verbose>." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:74 +#, no-wrap +msgid "\\f[CBI]users=\\f[CI]user1,user2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:79 +msgid "" +"A comma-separated list of users which are allowed access to the chroot. If " +"empty or omitted, no users will be allowed access (unless a group they " +"belong to is also specified in \\f[CI]groups\\fR)." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:79 +#, no-wrap +msgid "\\f[CBI]groups=\\f[CI]group1,group2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:83 +msgid "" +"A comma-separated list of groups which are allowed access to the chroot. If " +"empty or omitted, no groups of users will be allowed access." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:83 +#, no-wrap +msgid "\\f[CBI]root-users=\\f[CI]user1,user2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:90 +msgid "" +"A comma-separated list of users which are allowed B<password-less> root " +"access to the chroot. If empty or omitted, no users will be allowed root " +"access without a password (but if a user or a group they belong to is in " +"\\f[CI]users\\fR or \\f[CI]groups\\fR, respectively, they may gain access " +"with a password). See the section \\[lq]I<Security>\\[rq] below." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:90 +#, no-wrap +msgid "\\f[CBI]root-groups=\\f[CI]group1,group2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:97 +msgid "" +"A comma-separated list of groups which are allowed B<password-less> root " +"access to the chroot. If empty or omitted, no users will be allowed root " +"access without a password (but if a user or a group they belong to is in " +"\\f[CI]users\\fR or \\f[CI]groups\\fR, respectively, they may gain access " +"with a password). See the section \\[lq]I<Security>\\[rq] below." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:97 +#, no-wrap +msgid "\\f[CBI]aliases=\\f[CI]alias1,alias2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:103 +msgid "" +"A comma-separated list of aliases (alternate names) for this chroot. For " +"example, a chroot named \\[lq]sid\\[rq] might have an \\[oq]unstable\\[cq] " +"alias for convenience. Aliases are subject to the same naming restrictions " +"as the chroot name itself." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:103 +#, no-wrap +msgid "\\f[CBI]script-config=\\f[CI]filename\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:113 +msgid "" +"The behaviour of the chroot setup scripts may be customised on a per-chroot " +"basis by providing a shell script which the scripts will source. The " +"filename is relative to I<\\*[SCHROOT_SYSCONF_DIR]>. The default filename " +"is \\[oq]default/config\\[cq]. Alternatives are \\[oq]minimal/config\\[cq] " +"(minimal configuration), \\[oq]desktop/config\\[cq] (for running desktop " +"applications in the chroot, making more functionality from the host system " +"available in the chroot) and \\[oq]sbuild/config\\[cq] (for using the chroot " +"for Debian package building)." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:117 +msgid "" +"Desktop users should note that the fstab file I<desktop/fstab> will need " +"editing if you use gdm3. The \\f[CI]preserve-environment\\fR key should " +"also be set to \\[oq]true\\[cq] so that the environment is preserved inside " +"the chroot." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:125 +msgid "" +"If none of the configuration profiles provided above meet your needs, then " +"they may be edited to further customise them, and/or copied and used as a " +"template for entirely new profiles. Settings for specific chroots may also " +"be set in a single script by using conditionals checking the chroot name " +"and/or type. Note that the script will be sourced once for each and every " +"script invocation, and must be idempotent. The file format is documented in " +"B<schroot-script-config>(5)." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:128 +msgid "" +"Note that the different profiles have different security implications; see " +"the section \\[lq]I<Security>\\[rq] below for further details." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:128 +#, no-wrap +msgid "\\f[CBI]command-prefix=\\f[CI]command,option1,option2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:137 +msgid "" +"A comma-separated list of a command and the options for the command. This " +"command and its options will be prefixed to all commands run inside the " +"chroot. This is useful for adding commands such as nice, ionice or " +"eatmydata for all commands run inside the chroot. nice and ionice will " +"affect CPU and I/O scheduling. eatmydata ingores filesystem fsync " +"operations, and is useful for throwaway snapshot chroots where you don't " +"care about dataloss, but do care about high speed." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:137 +#, no-wrap +msgid "\\f[CBI]personality=\\f[CI]persona\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:151 +msgid "" +"Set the personality (process execution domain) to use. This option is " +"useful when using a 32-bit chroot on 64-bit system, for example. Valid " +"options on Linux are \\[oq]bsd\\[cq], \\[oq]hpux\\[cq], \\[oq]irix32\\[cq], " +"\\[oq]irix64\\[cq], \\[oq]irixn32\\[cq], \\[oq]iscr4\\[cq], " +"\\[oq]linux\\[cq], \\[oq]linux32\\[cq], \\[oq]linux_32bit\\[cq], " +"\\[oq]osf4\\[cq], \\[oq]osr5\\[cq], \\[oq]riscos\\[cq], \\[oq]scorvr3\\[cq], " +"\\[oq]solaris\\[cq], \\[oq]sunos\\[cq], \\[oq]svr4\\[cq], \\[oq]uw7\\[cq], " +"\\[oq]wysev386\\[cq], and \\[oq]xenix\\[cq]. The default value is " +"\\[oq]linux\\[cq]. There is also the special option \\[oq]undefined\\[cq] " +"(personality not set). For a 32-bit chroot on a 64-bit system, " +"\\[oq]linux32\\[cq] is the option required. The only valid option for " +"non-Linux systems is \\[oq]undefined\\[cq]. The default value for non-Linux " +"systems is \\[oq]undefined\\[cq]." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:151 +#, no-wrap +msgid "\\f[CBI]preserve-environment=\\f[CI]true\\fR|\\f[CI]false\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:158 +msgid "" +"By default, the environment will not be preserved inside the chroot, instead " +"a minimal environment will be used. Set to \\f[CI]true\\fR to always " +"preserve the environment. This is useful for example when running X " +"applications inside the chroot, which need the environment to function " +"correctly. The environment may also be preserved using the " +"I<--preserve-environment> option." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:158 +#, no-wrap +msgid "\\f[CBI]environment-filter=\\f[CI]regex\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:164 +msgid "" +"The environment to be set in the chroot will be filtered in order to remove " +"environment variables which may pose a security risk. Any environment " +"variable matching the specified POSIX extended regular expression will be " +"removed prior to executing any command in the chroot." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:167 +msgid "" +"Potentially dangerous environment variables are removed for safety by " +"default using the following regular expression:" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:169 +msgid "\\[lq]\\f[CR]^(BASH_ENV\\:|CDPATH\\:|ENV\\:|HOSTALIASES\\:|IFS\\:|KRB5_CONFIG\\:|KRBCONFDIR\\:|KRBTKFILE\\:|KRB_CONF\\:|LD_.*\\:|LOCALDOMAIN\\:|NLSPATH\\:|PATH_LOCALE\\:|RES_OPTIONS\\:|TERMINFO\\:|TERMINFO_DIRS\\:|TERMPATH)$\\fR\\[rq]." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:170 +#, no-wrap +msgid "Plain and directory chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:179 +msgid "" +"Chroots of type \\[oq]plain\\[cq] or \\[oq]directory\\[cq] are directories " +"accessible in the filesystem. The two types are equivalent except for the " +"fact that directory chroots run setup scripts, whereas plain chroots do " +"not. In consequence, filesystems such as I</proc> are not mounted in plain " +"chroots; it is the responsibility of the system administrator to configure " +"such chroots by hand, whereas directory chroots are automatically " +"configured. Additionally, directory chroots implement the B<filesystem " +"union chroot> options (see \\[lq]I<Filesystem Union chroot options>\\[rq], " +"below)." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:181 +msgid "These chroot types have an additional (mandatory) configuration option:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:181 +#, no-wrap +msgid "\\f[CBI]directory=\\f[CI]directory\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:193 +msgid "" +"The directory containing the chroot environment. This is where the root " +"will be changed to when executing a login shell or a command. The directory " +"must exist and have read and execute permissions to allow users access to " +"it. Note that on Linux systems it will be bind-mounted elsewhere for use as " +"a chroot; the directory for \\[oq]plain\\[cq] chroots is mounted with the " +"I<--rbind> option to B<mount>(8), while for \\[oq]directory\\[cq] chroots " +"I<--bind> is used instead so that sub-mounts are not preserved (they should " +"be set in the I<fstab> file just like in I</etc/fstab> on the host)." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:193 +#, no-wrap +msgid "File chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:200 +msgid "" +"Chroots of type \\[oq]file\\[cq] are files on the current filesystem " +"containing an archive of the chroot files. They implement the B<source " +"chroot> options (see \\[lq]I<Source chroot options>\\[rq], below). Note " +"that a corresponding source chroot (of type \\[oq]file\\[cq]) will be " +"created for each chroot of this type; this is for convenient access to the " +"source archive, e.g. for the purpose of updating. These additional options " +"are also implemented:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:200 schroot.conf.5.man:223 +#, no-wrap +msgid "\\f[CBI]file=\\f[CI]filename\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:209 +msgid "" +"The file containing the archived chroot environment (mandatory). This must " +"be a tar (tape archive), optionally compressed with gzip or bzip2. The file " +"extensions used to determine the type are are I<.tar>, I<.tar.gz>, " +"I<.tar.bz2>, I<.tgz>, and I<.tbz>. This file must be owned by the root " +"user, and not be writable by other. Note that zip archives are no longer " +"supported; zip was not able to archive named pipes and device nodes, so was " +"not suitable for archiving chroots." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:209 schroot.conf.5.man:334 +#, no-wrap +msgid "\\f[CBI]location=\\f[CI]path\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:216 +msgid "" +"This is the path to the chroot I<inside> the archive. For example, if the " +"archive contains a chroot in I</squeeze>, you would specify " +"\\[lq]/squeeze\\[rq] here. If the chroot is the only thing in the archive, " +"i.e. I</> is the root filesystem for the chroot, this option should be left " +"blank, or omitted entirely." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:216 +#, no-wrap +msgid "Loopback chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:223 +msgid "" +"Chroots of type \\[oq]loopback\\[cq] are a filesystem available as a file on " +"disk, accessed via a loopback mount. The file will be loopback mounted and " +"unmounted on demand. Loopback chroots implement the B<mountable chroot> and " +"B<filesystem union chroot> options (see \\[lq]I<Mountable chroot " +"options>\\[rq] and \\[lq]I<Filesystem Union chroot options>\\[rq], below), " +"plus an additional option:" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:227 +msgid "" +"This is the filename of the file containing the filesystem, including the " +"absolute path. For example \\[lq]/srv/chroot/sid\\[rq]." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:227 +#, no-wrap +msgid "Block device chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:234 +msgid "" +"Chroots of type \\[oq]block-device\\[cq] are a filesystem available on an " +"unmounted block device. The device will be mounted and unmounted on " +"demand. Block device chroots implement the B<mountable chroot> and " +"B<filesystem union chroot> options (see \\[lq]I<Mountable chroot " +"options>\\[rq] and \\[lq]I<Filesystem Union chroot options>\\[rq], below), " +"plus an additional option:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:234 +#, no-wrap +msgid "\\f[CBI]device=\\f[CI]device\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:238 +msgid "" +"This is the device name of the block device, including the absolute path. " +"For example, \\[lq]/dev/sda5\\[rq]." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:238 +#, no-wrap +msgid "Btrfs snapshot chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:248 +msgid "" +"Chroots of type \\[oq]btrfs-snapshot\\[cq] are a Btrfs snapshot created from " +"an existing Btrfs subvolume on a mounted Btrfs filesystem. A snapshot will " +"be created from this source subvolume on demand at the start of a session, " +"and then the snapshot will be mounted. At the end of the session, the " +"snapshot will be unmounted and deleted. This chroot type implements the " +"B<source chroot> options (see \\[lq]I<Source chroot options>\\[rq], below). " +"Note that a corresponding source chroot (of type \\[oq]directory\\[cq]) will " +"be created for each chroot of this type; this is for convenient access to " +"the source volume. These additional options are also implemented:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:248 +#, no-wrap +msgid "\\f[CBI]btrfs-source-subvolume=\\f[CI]directory\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:251 +msgid "The directory containing the source subvolume." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:251 +#, no-wrap +msgid "\\f[CBI]btrfs-snapshot-directory=\\f[CI]directory\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:254 +msgid "The directory in which to store the snapshots of the above source subvolume." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:254 +#, no-wrap +msgid "LVM snapshot chroots" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:259 +msgid "" +"Chroots of type \\[oq]lvm-snapshot\\[cq] are a filesystem available on an " +"LVM logical volume (LV). A snapshot LV will be created from this LV on " +"demand, and then the snapshot will be mounted. At the end of the session, " +"the snapshot LV will be unmounted and removed." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:266 +msgid "" +"LVM snapshot chroots implement the B<source chroot> options (see " +"\\[lq]I<Source chroot options>\\[rq], below), and all the options for " +"\\[oq]block-device\\[cq]. Note that a corresponding source chroot (of type " +"\\[oq]block-device\\[cq]) will be created for each chroot of this type; this " +"is for convenient access to the source device. This additional option is " +"also implemented:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:266 +#, no-wrap +msgid "\\f[CBI]lvm-snapshot-options=\\f[CI]snapshot_options\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:273 +msgid "" +"Snapshot options. These are additional options to pass to lvcreate(8). For " +"example, \\[lq]-L 2g\\[rq] to create a snapshot 2 GiB in size. B<Note:> the " +"LV name (I<-n>), the snapshot option (I<-s>) and the original LV path may " +"not be specfied here; they are set automatically by schroot." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:273 +#, no-wrap +msgid "Source chroot options" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:291 +msgid "" +"The \\[oq]btrfs-snapshot\\[cq], \\[oq]file\\[cq] and " +"\\[oq]lvm-snapshot\\[cq] chroot types implement source chroots. " +"Additionally, chroot types with union support enabled implement source " +"chroots (see \\[lq]I<Filesystem Union chroot options>\\[rq], below). These " +"are chroots which automatically create a copy of themselves before use, and " +"are usually session managed. These chroots additionally provide an extra " +"chroot in the I<source:> namespace, to allow convenient access to the " +"original (non-snapshotted) data, and to aid in chroot maintenance. I.e. for " +"a chroot named I<wheezy> (I<chroot:wheezy>), a corresponding " +"I<source:wheezy> chroot will be created. For compatibility with older " +"versions of schroot which did not support namespaces, a chroot with a " +"I<-source> suffix appended to the chroot name will be created in addition " +"(i.e. I<wheezy-source> using the above example). Note that these " +"compatibility names will be removed in schroot 1.5.0, so the use of the " +"I<source:> namespace is preferred over the use of the I<-source> suffix " +"form. See B<schroot>(1) for further details." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:293 +msgid "These chroots provide the following additional options:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:293 +#, no-wrap +msgid "\\f[CBI]source-clone=\\f[CI]true\\fR|\\f[CI]false\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:299 +msgid "" +"Set whether the source chroot should be automatically cloned (created) for " +"this chroot. The default is \\f[CI]true\\fR to automatically clone, but if " +"desired may be disabled by setting to \\f[CI]false\\fR. If disabled, the " +"source chroot will be inaccessible." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:299 +#, no-wrap +msgid "\\f[CBI]source-users=\\f[CI]user1,user2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:304 +msgid "" +"A comma-separated list of users which are allowed access to the source " +"chroot. If empty or omitted, no users will be allowed access. This will " +"become the \\f[CI]users\\fR option in the source chroot." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:304 +#, no-wrap +msgid "\\f[CBI]source-groups=\\f[CI]group1,group2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:309 +msgid "" +"A comma-separated list of groups which are allowed access to the source " +"chroot. If empty or omitted, no users will be allowed access. This will " +"become the \\f[CI]groups\\fR option in the source chroot." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:309 +#, no-wrap +msgid "\\f[CBI]source-root-users=\\f[CI]user1,user2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:316 +msgid "" +"A comma-separated list of users which are allowed B<password-less> root " +"access to the source chroot. If empty or omitted, no users will be allowed " +"root access without a password (but if a user is in \\f[CI]users\\fR, they " +"may gain access with a password). This will become the " +"\\f[CI]root-users\\fR option in the source chroot. See the section " +"\\[lq]I<Security>\\[rq] below." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:316 +#, no-wrap +msgid "\\f[CBI]source-root-groups=\\f[CI]group1,group2,...\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:324 +msgid "" +"A comma-separated list of groups which are allowed B<password-less> root " +"access to the source chroot. If empty or omitted, no users will be allowed " +"root access without a password (but if a user's group is in " +"\\f[CI]groups\\fR, they may gain access with a password). This will become " +"the \\f[CI]root-groups\\fR option in the source chroot. See the section " +"\\[lq]I<Security>\\[rq] below." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:324 +#, no-wrap +msgid "Mountable chroot options" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:329 +msgid "" +"The \\[oq]block-device\\[cq], \\[oq]loopback\\[cq] and " +"\\[oq]lvm-snapshot\\[cq] chroot types implement device mounting. These are " +"chroots which require the mounting of a device in order to access the " +"chroot. These chroots provide the following additional options:" +msgstr "" + +#. type: TP +#: schroot.conf.5.man:329 +#, no-wrap +msgid "\\f[CBI]mount-options=\\f[CI]options\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:334 +msgid "" +"Mount options for the block device. These are additional options to pass to " +"B<mount>(8). For example, \\[lq]-o atime,sync,user_xattr\\[rq]." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:341 +msgid "" +"This is the path to the chroot I<inside> the filesystem on the device. For " +"example, if the filesystem contains a chroot in I</chroot/sid>, you would " +"specify \\[lq]/chroot/sid\\[rq] here. If the chroot is the only thing on " +"the filesystem, i.e. I</> is the root filesystem for the chroot, this option " +"should be left blank, or omitted entirely." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:341 +#, no-wrap +msgid "Filesystem Union chroot options" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:353 +msgid "" +"The \\[oq]block-device\\[cq], \\[oq]directory\\[cq] and \\[oq]loopback\\[cq] " +"chroot types allow for the creation of a session using filesystem unions to " +"overlay the original filesystem with a separate writable directory. The " +"original filesystem is read-only, with any modifications made to the " +"filesystem made in the overlying writable directory, leaving the original " +"filesystem unchanged. A union permits multiple sessions to access and make " +"changes to a single chroot simultaneously, while keeping the changes private " +"to each session. To enable this feature, set \\f[CI]union-type\\fR to any " +"supported value. If enabled, the chroot will also be a B<source chroot>, " +"which will provide additional options (see \\[lq]I<Source chroot " +"options>\\[rq], above). All entries are optional." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:353 +#, no-wrap +msgid "\\f[CBI]union-type=\\f[CI]type\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:358 +msgid "" +"Set the union filesystem type. Currently supported filesystems are " +"\\[oq]aufs\\[cq] and \\[oq]unionfs\\[cq]. The default is \\[oq]none\\[cq], " +"which disables this feature." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:358 +#, no-wrap +msgid "\\f[CBI]union-mount-options=\\f[CI]options\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:372 +msgid "" +"Union filesystem mount options (branch configuration), used for mounting the " +"union filesystem specified with I<union-type>. This replaces the complete " +"\\[lq]-o\\[rq] string for mount and allows for the creation of complex " +"filesystem unions. Note that \\[oq]aufs\\[cq] and \\[oq]unionfs\\[cq] have " +"different supported mount options. B<Note:> One can use the variables " +"\\[lq]${CHROOT_UNION_OVERLAY_DIRECTORY}\\[rq] and " +"\\[lq]${CHROOT_UNION_UNDERLAY_DIRECTORY}\\[rq] to refer to the writable " +"overlay session directory and read-only underlying directory which are to " +"form the union. See B<schroot-setup>(5) for a complete variable list." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:372 +#, no-wrap +msgid "\\f[CBI]union-overlay-directory\\f[CI]=directory\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:376 +msgid "" +"Specify the directory where the writeable overlay session directories will " +"be created. The default is \\[oq]\\*[SCHROOT_OVERLAY_DIR]\\[cq]." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:376 +#, no-wrap +msgid "\\f[CBI]union-underlay-directory\\f[CI]=directory\\fR" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:380 +msgid "" +"Specify the directory where the read-only underlying directories will be " +"created. The default is \\[oq]\\*[SCHROOT_UNDERLAY_DIR]\\[cq]." +msgstr "" + +#. type: SS +#: schroot.conf.5.man:380 +#, no-wrap +msgid "Localisation" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:384 +msgid "" +"Some keys may be localised in multiple languages. This is achieved by " +"adding the locale name in square brackets after the key name. For example:" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:387 +#, no-wrap +msgid "description[en_GB]=\\f[CI]British English translation\\fR\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:391 +msgid "This will localise the \\f[CI]description\\fR key for the en_GB locale." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:394 +#, no-wrap +msgid "description[fr]=\\f[CI]French translation\\fR\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:398 +msgid "This will localise the \\f[CI]description\\fR key for all French locales." +msgstr "" + +#. type: SH +#: schroot.conf.5.man:398 +#, no-wrap +msgid "CHROOT NAMES" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:405 +msgid "" +"A number of characters or words are not permitted in a chroot name, session " +"name or configuration filename. The name may not contain a leading period " +"(\\[oq].\\[cq]). The characters \\[oq]:\\[cq] (colon), \\[oq],\\[cq] " +"(comma) and \\[oq]/\\[cq] (forward slash) are not permitted anywhere in the " +"name. The name may also not contain a trailing tilde (\\[oq]~\\[cq]). The " +"rationale for these restrictions is given below." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:405 +#, no-wrap +msgid "\\[oq]B<.>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:412 +msgid "" +"A leading period could be used to create a name with a relative path in it, " +"in combination with \\[oq]/\\[cq], and this could allow overwriting of files " +"on the host filesystem. Not allowing this character also means hidden files " +"cannot be created. It also means some editor backups are automatically " +"ignored. Periods are allowed anywhere else in the name." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:412 +#, no-wrap +msgid "\\[oq]B<:>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:418 +msgid "" +"A colon is used as a namespace delimiter, and so is not permitted as part of " +"a chroot or session name. LVM snapshot names may also not contain this " +"character due to a naming restriction by B<lvcreate>(8)." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:418 +#, no-wrap +msgid "\\[oq]B</>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:422 +msgid "" +"Names containing this character are not valid filenames. A forward slash " +"would potentially allow creation of files in subdirectories." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:422 +#, no-wrap +msgid "\\[oq]B<,>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:426 +msgid "" +"Commas are used to separate items in lists. Aliases are separated by commas " +"and hence can't contain commas in their name." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:426 +#, no-wrap +msgid "\\[oq]B<~>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:430 +msgid "" +"Filenames containing trailing tildes are used for editor backup files, which " +"are ignored. Tildes are allowed anywhere else in the name." +msgstr "" + +#. type: TP +#: schroot.conf.5.man:430 +#, no-wrap +msgid "\\[oq]B<dpkg-old>\\[cq]" +msgstr "" + +#. type: TQ +#: schroot.conf.5.man:432 +#, no-wrap +msgid "\\[oq]B<dpkg-dist>\\[cq]" +msgstr "" + +#. type: TQ +#: schroot.conf.5.man:434 +#, no-wrap +msgid "\\[oq]B<dpkg-new>\\[cq]" +msgstr "" + +#. type: TQ +#: schroot.conf.5.man:436 +#, no-wrap +msgid "\\[oq]B<dpkg-tmp>\\[cq]" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:440 +msgid "" +"These names may not appear at the end of a name. These are saved copies of " +"conffiles used by the dpkg package manager, and will be ignored." +msgstr "" + +#. type: SH +#: schroot.conf.5.man:440 +#, no-wrap +msgid "SECURITY" +msgstr "" + +#. type: SS +#: schroot.conf.5.man:441 +#, no-wrap +msgid "Untrusted users" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:447 +msgid "" +"Note that giving untrusted users root access to chroots is a B<serious " +"security risk>! Although the untrusted user will only have root access to " +"files inside the chroot, in practice there are many obvious ways of breaking " +"out of the chroot and of disrupting services on the host system. As always, " +"this boils down to I<trust>." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:450 +msgid "" +"B<Do not give chroot root access to users you would not trust> B<with root " +"access to the host system.>" +msgstr "" + +#. type: SS +#: schroot.conf.5.man:450 +#, no-wrap +msgid "Profiles" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:461 +msgid "" +"Depending upon which profile you have configured with the " +"\\f[CI]script-config\\fR option, different filesystems will be mounted " +"inside the chroot, and different files will be copied into the chroot from " +"the host. Some profiles will mount the host's I</dev>, while others will " +"not. Some profiles also bind mount additional parts of the host filesystem " +"in order to allow use of certain features, including user's home directories " +"and specific parts of I</var>. Check the profile's I<fstab> file to be " +"certain of what will be mounted, and the other profile files to see which " +"files and system databases will be copied into the chroot. Choose a " +"different profile or edit the files to further restrict what is made " +"available inside the chroot." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:467 +msgid "" +"There is a tradeoff between security (keeping the chroot as minimal as " +"possible) and usability (which sometimes requires access to parts of the " +"host filesystem). The different profiles make different tradeoffs, and it " +"is important that you assess which meets the security/usability tradeoff you " +"require." +msgstr "" + +#. type: SH +#: schroot.conf.5.man:467 +#, no-wrap +msgid "EXAMPLE" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:470 +#, no-wrap +msgid "# Sample configuration\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:481 +#, no-wrap +msgid "" +"[sid]\n" +"type=plain\n" +"description=Debian unstable\n" +"description[fr_FR]=Debian instable\n" +"directory=/srv/chroot/sid\n" +"priority=3\n" +"users=jim\n" +"groups=sbuild\n" +"root-users=rleigh\n" +"aliases=unstable,default\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:492 +#, no-wrap +msgid "" +"[etch]\n" +"type=block-device\n" +"description=Debian testing (32-bit)\n" +"priority=2\n" +"groups=users\n" +"#groups=sbuild-security\n" +"aliases=testing\n" +"device=/dev/hda_vg/etch_chroot\n" +"mount-options=-o atime\n" +"personality=linux32\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:499 +#, no-wrap +msgid "" +"[sid-file]\n" +"type=file\n" +"description=Debian sid file-based chroot\n" +"priority=3\n" +"groups=sbuild\n" +"file=/srv/chroots/sid.tar.gz\n" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:511 +#, no-wrap +msgid "" +"[sid-snapshot]\n" +"type=lvm-snapshot\n" +"description=Debian unstable LVM snapshot\n" +"priority=3\n" +"groups=sbuild\n" +"users=rleigh\n" +"source-root-users=rleigh\n" +"source-root-groups=admin\n" +"device=/dev/hda_vg/sid_chroot\n" +"mount-options=-o atime,sync,user_xattr\n" +"lvm-snapshot-options=--size 2G\n" +msgstr "" + +#. type: SS +#: schroot.conf.5.man:513 +#, no-wrap +msgid "Chroot definitions" +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:523 +msgid "" +"Additional chroot definitions may be placed in files under this directory. " +"They are treated in exactly that same manner as I<\\*[SCHROOT_CONF]>. Each " +"file may contain one or more chroot definitions." +msgstr "" + +#. type: Plain text +#: schroot.conf.5.man:557 +msgid "" +"B<sbuild>(1), B<schroot>(1), B<schroot-script-config>(5), B<schroot-faq>(7), " +"B<mount>(8)." +msgstr "" + +#. type: TH +#: schroot-script-config.5.man:18 +#, no-wrap +msgid "SCHROOT-SCRIPT-CONFIG" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:21 +msgid "schroot-script-config - schroot chroot setup script configuration" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:29 +msgid "" +"B<schroot> uses scripts to set up and then clean up the chroot environment. " +"These scripts may be customised using the \\f[CI]script-config\\fR key in " +"I<\\*[SCHROOT_CONF]>. This key specifies a file which the setup scripts " +"will source when they are run. The file is a Bourne shell script, and in " +"consequence may contain any valid shell code, in addition to simple variable " +"assignments. This will, for example, allow behaviour to be customised " +"according to the specific chroot type or name." +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:32 +msgid "" +"The environment is the same as for all setup scripts, described in " +"B<schroot-setup>(5)." +msgstr "" + +#. type: SH +#: schroot-script-config.5.man:32 +#, no-wrap +msgid "VARIABLES" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:38 +msgid "" +"The following variables may be set to configure setup script behaviour. " +"Note that new variables may be added in future releases. Third-party " +"extensions to schroot which add their own setup scripts may add additional " +"variables which are not documented here; consult the extension documentation " +"for further details." +msgstr "" + +#. type: TP +#: schroot-script-config.5.man:38 +#, no-wrap +msgid "COPYFILES" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:42 +msgid "" +"A file containing a list of files to copy into the chroot (one file per " +"line). The file will have the same absolute location inside the chroot." +msgstr "" + +#. type: TP +#: schroot-script-config.5.man:42 +#, no-wrap +msgid "FSTAB" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:49 +msgid "" +"The filesystem table file to be used to mount filesystems within the " +"chroot. The format of this file is the same as for I</etc/fstab>, " +"documented in B<fstab>(5). The only difference is that the mountpoint path " +"I<fs_dir> is relative to the chroot, rather than the root." +msgstr "" + +#. type: TP +#: schroot-script-config.5.man:49 +#, no-wrap +msgid "NSSDATABASES" +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:60 +msgid "" +"A file listing the system databases to copy into the chroot. The default " +"databases are \\[oq]passwd\\[cq], \\[oq]shadow\\[cq], \\[oq]group\\[cq], " +"\\[oq]services\\[cq], \\[oq]protocols\\[cq], \\[oq]networks\\[cq], and " +"\\[oq]hosts\\[cq]. \\[oq]gshadow\\[cq] is not yet copied by default, due to " +"not being supported by all but the most recent version of the GNU C " +"library. The databases are copied using B<getent>(1) so all database " +"sources listed in I</etc/nsswitch.conf> will be used for each database." +msgstr "" + +#. type: Plain text +#: schroot-script-config.5.man:67 +msgid "" +"B<sbuild>(1), B<schroot>(1), B<sh>(1), B<schroot.conf>(5), " +"B<schroot-setup>(5)." +msgstr "" + +#. type: TH +#: schroot-faq.7.man:18 +#, no-wrap +msgid "SCHROOT-FAQ" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:21 +msgid "schroot - frequently asked questions" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:24 +msgid "" +"This manual page covers various frequently asked questions about " +"configuration and usage of schroot." +msgstr "" + +#. type: SH +#: schroot-faq.7.man:24 dchroot-dsa.1.man:106 +#, no-wrap +msgid "CONFIGURATION" +msgstr "" + +#. type: SS +#: schroot-faq.7.man:25 +#, no-wrap +msgid "Why is schroot overwriting configuration files in the chroot?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:34 +msgid "" +"By default, schroot copies over the system NSS databases " +"(\\[oq]passwd\\[cq], \\[oq]shadow\\[cq], \\[oq]group\\[cq], " +"\\[oq]gshadow\\[cq], \\[oq]services\\[cq], \\[oq]protocols\\[cq], " +"\\[oq]networks\\[cq], and \\[oq]hosts\\[cq], etc.) into the chroot. The " +"reason for this is that the chroot environment is not a completely separate " +"system, and it copying them over keeps them synchronised. However, this is " +"not always desirable, particularly if installing a package in the chroot " +"creates system users and groups which are not present on the host, since " +"these will disappear next time the databases are copied over." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:39 +msgid "" +"The suggested workaround here is to disable the copying by removing or " +"commenting out the databases in the NSSDATABASES file in the script-config " +"file for the chroot. These are " +"I<\\*[SCHROOT_SYSCONF_DIR]/default/nssdatabases> and " +"I<\\*[SCHROOT_SYSCONF_DIR]/default/config> by default." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:43 +msgid "" +"In the future, we will be working on a better scheme for keeping the host " +"and chroot databases in sync which can merge entries rather than overwriting " +"the entire database, which would preserve chroot-specific changes." +msgstr "" + +#. type: SS +#: schroot-faq.7.man:43 +#, no-wrap +msgid "Should I use the plain or directory chroot type?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:54 +msgid "" +"These two chroot types are basically equivalent, since they are both just " +"directories in the filesystem. plain is very simple and does not perform " +"any setup tasks; the only reason you would want to use it is if you're " +"upgrading from a program such as B<dchroot(1)> or B<chroot(8)> which don't " +"do anything other than running a command or shell in a directory. On the " +"other hand, directory chroots do run setup scripts, which can mount " +"additional filesystems and do other setup tasks." +msgstr "" + +#. type: SH +#: schroot-faq.7.man:54 +#, no-wrap +msgid "ADVANCED CONFIGURATION" +msgstr "" + +#. type: SS +#: schroot-faq.7.man:55 +#, no-wrap +msgid "What are snapshots and unions?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:67 +msgid "" +"Some chroot types support I<cloning>. This means when you start a session, " +"you get a I<copy> of the chroot which lasts just for the lifetime of the " +"session. This is useful when you want a temporary clean copy of a system " +"for a single task, which is then automatically deleted when you're done with " +"it. For example, the Debian package build d\\[ae]mons run B<sbuild>(1) to " +"build Debian packages, and this program uses schroot to create a clean build " +"environment for each package. Without snapshotting, the chroot would need " +"to be reset to its initial state at the end of each build to make it ready " +"for the next one, and any debris left over from package removals or earlier " +"builds could interfere with the next build." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:77 +msgid "" +"The most commonly-used snapshotting method is to use LVM snapshots (chroot " +"type \\[oq]lvm-snapshot\\[cq]). In this case the chroot must exist on an " +"LVM logical volume (LV); snapshots of an LV may then be made with " +"B<lvcreate>(8) during chroot session setup. However, these use up a lot of " +"disk space. A newer method is to use Btrfs snapshots which use up much less " +"disk space (chroot type \\[oq]btrfs-snapshot\\[cq]), and may be more " +"reliable than LVM snapshots. Btrfs is however still experimental, but it is " +"hoped that it will become the recommended method as it matures." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:84 +msgid "" +"Unions are an alternative to snapshots. In this situation, instead of " +"creating a copy of the chroot filesystem, we overlay a read-write temporary " +"filesystem on top of the chroot filesystem so that any modifications are " +"stored in the overlay, leaving the original chroot filesystem untouched. " +"The Linux kernel has yet to integrate support for union filesystems such as " +"aufs and unionfs, so LVM snapshots are still the recommended method at " +"present." +msgstr "" + +#. type: SH +#: schroot-faq.7.man:84 +#, no-wrap +msgid "USAGE" +msgstr "" + +#. type: SS +#: schroot-faq.7.man:85 +#, no-wrap +msgid "Can I run a d\\[ae]mons in a chroot?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:89 +msgid "" +"A common problem is trying to run a d\\[ae]mon in a chroot, and finding that " +"this doesn't work. Typically, the d\\[ae]mon is killed shortly after it " +"starts up." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:99 +msgid "" +"When schroot runs, it begins a session, runs the specified command or shell, " +"waits for the command or shell to exit, and then it ends the session. For a " +"normal command or shell, this works just fine. However, d\\[ae]mons " +"normally start up by running in the background and detaching from the " +"controlling terminal. They do this by forking twice and letting the parent " +"processes exit. Unfortunately, this means schroot detects that the program " +"exited (the d\\[ae]mon is a orphaned grandchild of this process) and it then " +"ends the session. Part of ending the session is killing all processes " +"running inside the chroot, which means the d\\[ae]mon is killed as the " +"session ends." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:105 +msgid "" +"In consequence, it's not possible to run a d\\[ae]mon I<directly> with " +"schroot. You can however do it if you create a session with " +"I<--begin-session> and then run the d\\[ae]mon with I<--run-session>. It's " +"your responsibility to end the session with I<--end-session> when the daemon " +"has terminated or you no longer need it." +msgstr "" + +#. type: SS +#: schroot-faq.7.man:105 +#, no-wrap +msgid "How do I manually cleaning up a broken session?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:116 +msgid "" +"Occasionally, it may be necessary to manually clean up sessions. If " +"something changes on your system which causes the setup scripts to fail when " +"ending a session, for example removal of a needed file or directory, it may " +"not be possible for schroot to clean everything up automatically. For each " +"of the session directories listed in the \\[lq]I<Session directories>\\[rq] " +"section in B<schroot>(1), any files with the name of the session ID need " +"deleting, and any directories with the name of the session ID need umounting " +"(if there are any filesystems mounted under it), and then also removing." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:119 +msgid "For example, to remove a session named I<my-session> by hand:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:121 +msgid "Remove the session configuration file" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:123 +#, no-wrap +msgid "%\\ \\f[CB]rm\\ \\*[SCHROOT_SESSION_DIR]/my-session\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:126 +msgid "Check for mounted filesystems" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:129 +#, no-wrap +msgid "" +"%\\ \\f[CB]\\*[SCHROOT_LIBEXEC_DIR]/schroot-listmounts\\ -m\\ \\e\n" +" \\*[SCHROOT_MOUNT_DIR]/my-session\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:132 +msgid "Unmount any mounted filesystems" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:134 +msgid "Remove I<\\*[SCHROOT_MOUNT_DIR]/my-session>" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:137 +msgid "" +"Repeat for the other directories such as I<\\*[SCHROOT_UNDERLAY_DIR]>, " +"I<\\*[SCHROOT_OVERLAY_DIR]> and I<\\*[SCHROOT_FILE_UNPACK_DIR]>" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:141 +msgid "" +"B<NOTE:> Do not remove any directories without checking if there are any " +"filesystems mounted below them, since filesystems such as I</home> could " +"still be bind mounted. Doing so could cause irretrievable data loss!" +msgstr "" + +#. type: SH +#: schroot-faq.7.man:141 +#, no-wrap +msgid "ADVANCED USAGE" +msgstr "" + +#. type: SS +#: schroot-faq.7.man:142 +#, no-wrap +msgid "How do I use sessions?" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:144 +msgid "In normal use, running a command might look like this:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:146 +#, no-wrap +msgid "%\\ \\f[CB]schroot\\ -c squeeze -- command\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:151 +msgid "" +"which would run the command I<command> in the I<squeeze> chroot. While it's " +"not apparent that a session is being used here, schroot is actually doing " +"the following steps:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:156 +msgid "" +"Creating a session using the I<squeeze> chroot. This will be automatically " +"given a unique name, such as " +"I<squeeze-57a69547-e014-4f5d-a98b-f4f35a005307>, though you don't usually " +"need to know about this" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:158 +msgid "Setup scripts are run to create the session chroot and configure it for you" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:160 +msgid "The command I<command> is run inside the session chroot" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:162 +msgid "Setup scripts are run to clean up the session chroot" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:164 +msgid "The session is deleted" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:176 +msgid "" +"Now, if you wanted to run more than one command, you could run a shell and " +"run them interactively, or you could put them into shell script and run that " +"instead. But you might want to do something in between, such as running " +"arbitrary commands from a program or script where you don't know which " +"commands to run in advance. You might also want to preseve the chroot state " +"in between commands, where the normal automatic session creation would reset " +"the state in between each command. This is what sessions are for: once " +"created, the session is persistent and won't be automatically removed. With " +"a session, you can run as many commands as you like, but you need to create " +"and delete the session by hand since schroot can't know by itself when " +"you're done with it unlike in the single command case above. This is quite " +"easy:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:179 +#, no-wrap +msgid "" +"% \\f[CB]schroot --begin-session -c squeeze\\fR\\[CR]\n" +"squeeze-57a69547-e014-4f5d-a98b-f4f35a005307\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:184 +msgid "" +"This created a new session based upon the I<squeeze> chroot. The unique " +"name for the session, the session ID, was printed to standard output, so we " +"could also save it as a shell variable at the same time like so:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:188 +#, no-wrap +msgid "" +"% \\f[CB]SESSION=$(schroot --begin-session -c squeeze)\\fR\\[CR]\n" +"% \\f[CB]echo $SESSION\\fR\\[CR]\n" +"squeeze-57a69547-e014-4f5d-a98b-f4f35a005307\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:192 +msgid "" +"Now we have created the session and got the session ID, we can run commands " +"in it using the session ID:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:195 +#, no-wrap +msgid "" +"% \\f[CB]schroot --run-session -c " +"squeeze-57a69547-e014-4f5d-a98b-f4f35a005307 \\e\n" +" -- command1\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:198 schroot-faq.7.man:217 +msgid "or" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:200 +#, no-wrap +msgid "% \\f[CB]schroot --run-session -c \"$SESSION\" -- command1\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:203 +msgid "and then as many more commands as we like" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:207 +#, no-wrap +msgid "" +"% \\f[CB]schroot --run-session -c \"$SESSION\" -- command2\\fR\\[CR]\n" +"% \\f[CB]schroot --run-session -c \"$SESSION\" -- command3\\fR\\[CR]\n" +"% \\f[CB]schroot --run-session -c \"$SESSION\" -- command4\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:210 +msgid "etc." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:212 +msgid "When we are done with the session, we can remove it with I<--end-session>:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:214 +#, no-wrap +msgid "" +"% \\f[CB]schroot --end-session -c " +"squeeze-57a69547-e014-4f5d-a98b-f4f35a005307\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:219 +#, no-wrap +msgid "% \\f[CB]schroot --end-session -c \"$SESSION\"\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:223 +msgid "" +"Since the automatically generated session names can be long and unwieldy, " +"the I<--session-name> option allows you to provide you own name:" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:227 +#, no-wrap +msgid "" +"% \\f[CB]schroot --begin-session -c squeeze --session-name " +"my-name\\fR\\[CR]\n" +"my-name\n" +msgstr "" + +#. type: SH +#: schroot-faq.7.man:228 +#, no-wrap +msgid "CONTRIBUTING" +msgstr "" + +#. type: SS +#: schroot-faq.7.man:229 +#, no-wrap +msgid "Getting help and getting involved" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:236 +msgid "" +"The mailing list " +"\\f[CR]E<lt>buildd-tools-devel@lists.alioth.debian.orgE<gt>\\fR is used for " +"both user support and development discussion. The list may be subscribed to " +"from the project website at " +"\\f[CR]https://alioth.debian.org/projects/buildd-tools/\\fR or the Mailman " +"list interface at " +"\\f[CR]http://lists.alioth.debian.org/mailman/listinfo/buildd-tools-devel\\fR." +msgstr "" + +#. type: SS +#: schroot-faq.7.man:236 +#, no-wrap +msgid "Reporting bugs" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:241 +msgid "" +"On Debian systems, bugs may be reported using the B<reportbug>(1) tool, or " +"alternatively by mailing \\f[CR]E<lt>submit@bugs.debian.orgE<gt>\\fR (see " +"\\f[CR]http://bugs.debian.org\\fR for details on how to do that)." +msgstr "" + +#. type: SS +#: schroot-faq.7.man:241 +#, no-wrap +msgid "Getting the latest sources" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:244 +msgid "" +"schroot is maintained in the git version control system. You can get the " +"latest sources from " +"\\f[CR]git://git.debian.org/git/buildd-tools/schroot\\fR." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:246 +#, no-wrap +msgid "% \\f[CB]git clone git://git.debian.org/git/buildd-tools/schroot\\fR\\[CR]\n" +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:251 +msgid "" +"The master branch containes the current development release. Stable " +"releases are found on branches, for example the 1.4 series of releases are " +"on the schroot-1.4 branch." +msgstr "" + +#. type: Plain text +#: schroot-faq.7.man:258 +msgid "" +"B<dchroot>(1), B<schroot>(1), B<sbuild>(1), B<schroot-setup>(5), " +"B<schroot.conf>(5)." +msgstr "" + +#. type: ds PROGRAM +#: dchroot.1.man:19 +#, no-wrap +msgid "dchroot" +msgstr "" + +#. type: TH +#: dchroot.1.man:20 +#, no-wrap +msgid "DCHROOT" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:23 +msgid "dchroot - enter a chroot environment" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:34 +msgid "" +"B<dchroot> [B<-h>\\[or]B<--help> \\[or] B<-V>\\[or]B<--version> \\[or] " +"B<-l>\\[or]B<--list> \\[or] B<-i>\\[or]B<--info> \\[or] B<--config> \\[or] " +"B<--location>] [B<--directory=>I<directory>] " +"[B<-d>\\[or]B<--preserve-environment>] [B<-q>\\[or]B<--quiet> \\[or] " +"B<-v>\\[or]B<--verbose>] [B<-c >I<chroot>\\[or]B<--chroot=>I<chroot> \\[or] " +"B<--all>] [B<COMMAND> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:38 +msgid "" +"B<dchroot> allows the user to run a command or a login shell in a chroot " +"environment. If no command is specified, a login shell will be started in " +"the user's home directory inside the chroot." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:45 +msgid "" +"The command is one or more arguments which will be run in the user's default " +"shell using its I<-c> option. As a result, shell code may be embedded in " +"this argument. If multiple command options are used, they are concatenated " +"together, separated by spaces. Users should be aware of the shell quoting " +"issues this presents, and should use B<schroot> if necessary, which does not " +"have any quoting issues." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:55 +msgid "" +"This version of dchroot is a compatibility wrapper around the B<schroot>(1) " +"program. It is provided for backward compatibility with the dchroot " +"command-line options, but schroot is recommended for future use. See the " +"section \\[lq]I<Incompatibilities>\\[rq] below for known incompatibilities " +"with older versions of dchroot." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:58 +msgid "" +"If no chroot is specified, the chroot name or alias \\[oq]default\\[cq] will " +"be used as a fallback." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:60 +msgid "B<dchroot> accepts the following options:" +msgstr "" + +#. type: SS +#: dchroot.1.man:60 dchroot-dsa.1.man:55 +#, no-wrap +msgid "Basic options" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:67 +msgid "Select all chroots." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:71 +msgid "" +"Specify a chroot to use. This option may be used multiple times to specify " +"more than one chroot, in which case its effect is similar to I<--all>." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:78 +msgid "" +"Print detailed information about the specified chroots. Note that earlier " +"versions of dchroot did not include this option." +msgstr "" + +#. type: TP +#: dchroot.1.man:78 +#, no-wrap +msgid "B<-p>, B<--path>" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:81 +msgid "Print location (path) of the specified chroots." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:87 +msgid "" +"Print configuration of the specified chroots. This is useful for testing " +"that the configuration in use is the same as the configuration file. Any " +"comments in the original file will be missing. Note that earlier versions " +"of dchroot did not include this option." +msgstr "" + +#. type: TP +#: dchroot.1.man:87 +#, no-wrap +msgid "B<--directory=>I<directory>" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:92 +msgid "" +"Change to I<directory> inside the chroot before running the command or login " +"shell. If I<directory> is not available, dchroot will exit with an error " +"status." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:101 +msgid "" +"The default behaviour is as follows (all directory paths are inside the " +"chroot). Unless the I<--preserve-environment> option is used to preserve " +"the environment, the login shell or command will run in the user's home " +"directory, or I</> if the home directory is not available. When the " +"I<--preserve-environment> option is used, it will attempt to use the current " +"working directory, again falling back to I</> if it is not accessible. If " +"none of the directories are available, dchroot will exit with an error " +"status." +msgstr "" + +#. type: TP +#: dchroot.1.man:101 +#, no-wrap +msgid "B<-d>, B<--preserve-environment>" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:106 +msgid "" +"Preserve the user's environment inside the chroot environment. The default " +"is to use a clean environment; this option copies the entire user " +"environment and sets it in the session." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:113 +msgid "" +"Print all messages. Note that earlier versions of dchroot did not include " +"this option." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:118 +msgid "Note that earlier versions of dchroot did not provide long options." +msgstr "" + +#. type: SH +#: dchroot.1.man:118 dchroot-dsa.1.man:107 +#, no-wrap +msgid "INCOMPATIBILITIES" +msgstr "" + +#. type: SS +#: dchroot.1.man:119 +#, no-wrap +msgid "Debian dchroot prior to version 0.99.0" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:122 dchroot-dsa.1.man:118 +msgid "Log messages are worded and formatted differently." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:127 +msgid "" +"B<su>(1) is no longer used to run commands in the chroot; this is done by " +"dchroot internally. This change may cause subtle differences. If you find " +"an incompatibility, please report it so it may be corrected." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:133 +msgid "" +"dchroot provides a restricted subset of the functionality implemented by " +"B<schroot>, but is still schroot underneath. Thus dchroot is still subject " +"to schroot security checking, including PAM authentication and " +"authorisation, and session management, for example, and hence may behave " +"slightly differently to older dchroot versions in some circumstances." +msgstr "" + +#. type: SS +#: dchroot.1.man:133 dchroot-dsa.1.man:108 +#, no-wrap +msgid "Debian dchroot prior to version 1.5.1" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:140 +msgid "" +"This version of dchroot uses I<schroot.conf> to store the configuration for " +"available chroots, rather than the I<dchroot.conf> file used historically. " +"dchroot supported automatic migration of I<dchroot.conf> to the " +"I<schroot.conf> keyfile format with its I<--config> option from versions " +"0.2.2 to 1.5.0; support for the old format is now no longer available." +msgstr "" + +#. type: SS +#: dchroot.1.man:140 dchroot-dsa.1.man:115 +#, no-wrap +msgid "DSA dchroot" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:143 +msgid "" +"Machines run by the Debian System Administrators for the Debian Project have " +"a B<dchroot-dsa> package which provides an alternate dchroot implementation." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:145 dchroot-dsa.1.man:128 +msgid "All the above incompatibilities apply." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:153 +msgid "" +"This version of dchroot has incompatible command-line options, and while " +"some of those options are supported or have equivalent options by a " +"different name, the I<-c> option is not required to specify a chroot, and " +"this version of dchroot cannot implement this behaviour in a " +"backward-compatible manner (because if I<-c> is omitted, the default chroot " +"is used). DSA dchroot uses the first non-option as the chroot to use, only " +"allowing one chroot to be used at once." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:164 +msgid "" +"dchroot will select an appropriate directory to use within the chroot based " +"upon whether the I<--directory> or I<--preserve-environment> options are " +"used. When explicitly specifying a directory, only one directory will be " +"used for safety and consistency, while for a login shell or command several " +"possibilities may be tried. Note that due to multiple fallbacks being " +"considered for commands, it is dangerous to run commands using dchroot; use " +"schroot instead. The following subsections list the fallback sequence for " +"each case. CWD is the current working directory, DIR is the directory " +"specified with I<--directory>." +msgstr "" + +#. type: SS +#: dchroot.1.man:164 dchroot-dsa.1.man:145 +#, no-wrap +msgid "Login shell or command" +msgstr "" + +#. type: tbl table +#: dchroot.1.man:172 +#, no-wrap +msgid "Normal behaviour (if --directory and I<--preserve-environment> are not\n" +msgstr "" + +#. type: tbl table +#: dchroot.1.man:173 +#, no-wrap +msgid "used)\n" +msgstr "" + +#. type: tbl table +#: dchroot.1.man:176 dchroot-dsa.1.man:156 +#, no-wrap +msgid "If passwd pw_dir is nonexistent\n" +msgstr "" + +#. type: SS +#: dchroot.1.man:182 +#, no-wrap +msgid "--preserve-environment used" +msgstr "" + +#. type: tbl table +#: dchroot.1.man:190 +#, no-wrap +msgid "Normal behaviour (if I<--preserve-environment> used)\n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:219 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot -l\\fR\\[CR]\n" +"Available chroots: sarge [default], sid\n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:222 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot -p sid\\fR\\[CR]\n" +"/srv/chroot/sid\n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:227 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot -q -c sid -- uname -smr\\fR\\[CR]\n" +"Linux 2.6.16.17 ppc\n" +"$ \\f[CB]dchroot -q -c sid -- \"uname -smr\"\\fR\\[CR]\n" +"Linux 2.6.16.17 ppc\n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:233 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot -q -c sid \"ls -1 / | tac | head -n 4\"\\fR\\[CR]\n" +"var\n" +"usr\n" +"tmp\n" +"sys\n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:237 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot -c sid\\fR\\[CR]\n" +"I: [sid chroot] Running login shell: \\[lq]/bin/bash\\[rq]\n" +"$ \n" +msgstr "" + +#. type: Plain text +#: dchroot.1.man:246 +msgid "" +"Use I<--> to allow options beginning with \\[oq]-\\[cq] or \\[oq]--\\[cq] in " +"the command to run in the chroot. This prevents them being interpreted as " +"options for dchroot itself. Note that the top line was echoed to standard " +"error, and the remaining lines to standard output. This is intentional, so " +"that program output from commands run in the chroot may be piped and " +"redirected as required; the data will be the same as if the command was run " +"directly on the host system." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:273 dchroot-dsa.1.man:226 +msgid "" +"The system-wide B<schroot> definition file. This file must be owned by the " +"root user, and not be writable by other." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:278 +msgid "" +"This implementation of dchroot uses the same command-line options as the " +"original B<dchroot> by David Kimdon \\f[CR]E<lt>dwhedon@debian.orgE<gt>\\fR, " +"but is an independent implementation." +msgstr "" + +#. type: Plain text +#: dchroot.1.man:284 dchroot-dsa.1.man:239 +msgid "" +"B<schroot>(1), B<sbuild>(1), B<chroot>(2), B<schroot-setup>(5), " +"B<schroot.conf>(5)." +msgstr "" + +#. type: ds PROGRAM +#: dchroot-dsa.1.man:19 +#, no-wrap +msgid "dchroot-dsa" +msgstr "" + +#. type: TH +#: dchroot-dsa.1.man:20 +#, no-wrap +msgid "DCHROOT-DSA" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:23 +msgid "dchroot-dsa - enter a chroot environment" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:33 +msgid "" +"B<dchroot-dsa> [B<-h>\\[or]B<--help> \\[or] B<-V>\\[or]B<--version> \\[or] " +"B<-l>\\[or]B<--list> \\[or] B<-i>\\[or]B<--info> \\[or] B<--config> \\[or] " +"B<-p>|B<--listpaths>] [B<-d >I<directory>\\[or]B<--directory=>I<directory>] " +"[B<-q>\\[or]B<--quiet> \\[or] B<-v>\\[or]B<--verbose>] [B<-c " +">I<chroot>\\[or]B<--chroot=>I<chroot> \\[or] B<--all> \\[or] B<CHROOT]> " +"[B<COMMAND>]" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:37 +msgid "" +"B<dchroot-dsa> allows the user to run a command or a login shell in a chroot " +"environment. If no command is specified, a login shell will be started in " +"the user's home directory inside the chroot." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:39 +msgid "The user's environment will be preserved inside the chroot." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:42 +msgid "" +"The command is a single argument which must be an absolute path to the " +"program. Additional options are not permitted." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:52 +msgid "" +"This version of dchroot-dsa is a compatibility wrapper around the " +"B<schroot>(1) program. It is provided for backward compatibility with the " +"dchroot-dsa command-line options, but schroot is recommended for future " +"use. See the section \\[lq]I<Incompatibilities>\\[rq] below for known " +"incompatibilities with older versions of dchroot-dsa." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:55 +msgid "B<dchroot-dsa> accepts the following options:" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:63 +msgid "" +"Select all chroots. Note that earlier versions of dchroot-dsa did not " +"include this option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:69 +msgid "" +"Specify a chroot to use. This option may be used multiple times to specify " +"more than one chroot, in which case its effect is similar to I<--all>. If " +"this option is not used, the first non-option argument specified the chroot " +"to use. Note that earlier versions of dchroot-dsa did not include this " +"option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:76 +msgid "" +"Print detailed information about the available chroots. Note that earlier " +"versions of dchroot-dsa did not include this option." +msgstr "" + +#. type: TP +#: dchroot-dsa.1.man:76 +#, no-wrap +msgid "B<-p>, B<--listpaths>" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:79 +msgid "Print absolute locations (paths) of the available chroots." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:85 +msgid "" +"Print configuration of the available chroots. This is useful for testing " +"that the configuration in use is the same as the configuration file. Any " +"comments in the original file will be missing. Note that earlier versions " +"of dchroot-dsa did not include this option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:90 +msgid "" +"Change to I<directory> inside the chroot before running the command or login " +"shell. If I<directory> is not available, dchroot-dsa will exit with an " +"error status." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:95 +msgid "" +"The default behaviour (all directory paths are inside the chroot) is to run " +"the login shell or command in the user's home directory, or I</> if the home " +"directory is not available. If none of the directories are available, " +"dchroot-dsa will exit with an error status." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:99 +msgid "" +"Print only essential messages. Note that earlier versions of dchroot-dsa " +"did not include this option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:103 +msgid "" +"Print all messages. Note that earlier versions of dchroot-dsa did not " +"include this option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:115 +msgid "" +"This version of dchroot-dsa uses I<schroot.conf> to store the configuration " +"for available chroots, rather than the I<dchroot.conf> file used " +"historically. dchroot-dsa supported automatic migration of I<dchroot.conf> " +"to the I<schroot.conf> keyfile format with its I<--config> option from " +"versions 0.2.2 to 1.5.0; support for the old format is now no longer " +"available." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:124 +msgid "" +"dchroot-dsa provides a restricted subset of the functionality implemented by " +"B<schroot>, but is still schroot underneath. Thus dchroot-dsa is still " +"subject to schroot security checking, including PAM authentication and " +"authorisation, and session management, for example, and hence may behave " +"slightly differently to earlier versions of dchroot-dsa in some " +"circumstances." +msgstr "" + +#. type: SS +#: dchroot-dsa.1.man:124 +#, no-wrap +msgid "Debian dchroot" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:126 +msgid "A B<dchroot> package provides an alternative dchroot implementation." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:134 +msgid "" +"This version of dchroot has incompatible command-line options, and while " +"some of those options are supported or have equivalent options by a " +"different name, the I<-c> option is required to specify a chroot. It also " +"allows a shell script to be used as the option instead of a single absolute " +"path, and allows multiple command options instead of a single option." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:145 +msgid "" +"dchroot-dsa will select an appropriate directory to use within the chroot " +"based upon whether the I<--directory> option is used. When explicitly " +"specifying a directory, only one directory will be used for safety and " +"consistency, while for a login shell or command several possibilities may be " +"tried. Note that due to multiple fallbacks being considered for commands, " +"it is dangerous to run commands using dchroot-dsa; use schroot instead. The " +"following subsections list the fallback sequence for each case. CWD is the " +"current working directory, DIR is the directory specified with " +"I<--directory>." +msgstr "" + +#. type: tbl table +#: dchroot-dsa.1.man:153 +#, no-wrap +msgid "Normal behaviour (if --directory is not used)\n" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:182 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot-dsa -l\\fR\\[CR]\n" +"Available chroots: sarge, sid\n" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:186 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot-dsa --listpaths\\fR\\[CR]\n" +"/srv/chroot/sarge\n" +"/srv/chroot/sid\n" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:189 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot-dsa -q sid -- /bin/uname\\fR\\[CR]\n" +"Linux\n" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:193 +#, no-wrap +msgid "" +"$ \\f[CB]dchroot-dsa sid\\fR\\[CR]\n" +"I: [sid chroot] Running login shell: \\[lq]/bin/bash\\[rq]\n" +"$\n" +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:199 +msgid "" +"Note that the top line was echoed to standard error, and the remaining lines " +"to standard output. This is intentional, so that program output from " +"commands run in the chroot may be piped and redirected as required; the data " +"will be the same as if the command was run directly on the host system." +msgstr "" + +#. type: Plain text +#: dchroot-dsa.1.man:233 +msgid "" +"This implementation of dchroot-dsa uses the same command-line options as the " +"B<dchroot> found on machines run by the Debian System Administrators for the " +"Debian Project. These machines have a B<dchroot-dsa> source package which " +"provides a B<dchroot-dsa> package, written by Ben Collins " +"\\f[CR]E<lt>bcollins@debian.orgE<gt>\\fR and Martin Schulze " +"\\f[CR]E<lt>joey@debian.orgE<gt>\\fR." +msgstr "" diff --git a/man/po4a/po4a.cfg b/man/po4a/po4a.cfg new file mode 100644 index 00000000..be70fc4a --- /dev/null +++ b/man/po4a/po4a.cfg @@ -0,0 +1,28 @@ +[po_directory] po4a/po/ + +[po4a_alias:man] man opt:"-M UTF-8 -L UTF-8" + +[type: man] authors.man $lang:translated/$lang/authors.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] copyright.man $lang:translated/$lang/copyright.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] schroot.1.man $lang:translated/$lang/schroot.1.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] schroot-setup.5.man $lang:translated/$lang/schroot-setup.5.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] schroot.conf.5.man lang:translated/$lang/schroot.conf.5.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] schroot-script-config.5.man $lang:translated/$lang/schroot-script-config.5.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] schroot-faq.7.man $lang:translated/$lang/schroot-faq.man \ + add_$lang:?po4a/add_$lang/$lang.add + +[type: man] dchroot.1.man $lang:translated/$lang/dchroot.1.man \ + add_$lang:?po4a/add_$lang/$lang.add +[type: man] dchroot-dsa.1.man $lang:translated/$lang/dchroot-dsa.1.man \ + add_$lang:?po4a/add_$lang/$lang.add + +# The following files could also be offered for translation, maybe separately +#[type: man] csbuild.1.man $lang:translated/$lang/csbuild.1.man \ +# add_$lang:?po4a/add_$lang/$lang.add + |