Salut Thomas, Conformément à la proposition de #588962, je veux bien que tu m'envoies le fichier quand tu auras traduit une ou deux pages (même si ce n'est qu'un premier jet non relu) afin de préparer l'intégration des pages de manuel au paquet. S'il y a des chaînes de trop (à ne pas traduire) dans le fichier POT, indique-les moi aussi afin d'essayer les virer avec des options de po4a. Amicalement David
# 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-27 19:00-0400\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
#: man/authors.man:1
#, no-wrap
msgid "AUTHORS"
msgstr ""
#. type: Plain text
#: man/authors.man:2
msgid "Roger Leigh."
msgstr ""
#. type: SH
#: man/copyright.man:1
#, no-wrap
msgid "COPYRIGHT"
msgstr ""
#. type: Plain text
#: man/copyright.man:3
msgid "Copyright \\(co 2005-2011 Roger Leigh \\f[CR]E<lt>rleigh@debian.orgE<gt>\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:20
#, no-wrap
msgid "SCHROOT"
msgstr ""
#. type: TH
#: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20
#, no-wrap
msgid "\\*[RELEASE_DATE]"
msgstr ""
#. type: TH
#: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20
#, no-wrap
msgid "Version \\*[VERSION]"
msgstr ""
#. type: TH
#: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20
#, no-wrap
msgid "Debian sbuild"
msgstr ""
#. type: SH
#: man/schroot.1.man:21 man/schroot-setup.5.man:19 man/schroot.conf.5.man:19 man/schroot-script-config.5.man:19 man/schroot-faq.7.man:19 man/dchroot.1.man:21 man/dchroot-dsa.1.man:21
#, no-wrap
msgid "NAME"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:23
msgid "schroot - securely enter a chroot environment"
msgstr ""
#. type: SH
#: man/schroot.1.man:23 man/dchroot.1.man:23 man/dchroot-dsa.1.man:23
#, no-wrap
msgid "SYNOPSIS"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:41 man/schroot-setup.5.man:21 man/schroot.conf.5.man:21 man/schroot-script-config.5.man:21 man/schroot-faq.7.man:21 man/dchroot.1.man:34 man/dchroot-dsa.1.man:33
#, no-wrap
msgid "DESCRIPTION"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:51 man/dchroot.1.man:48 man/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
#: man/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
#: man/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
#: man/schroot.1.man:58
#, no-wrap
msgid "OVERVIEW"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:68 man/schroot.1.man:72 man/schroot.1.man:75 man/schroot.1.man:78 man/schroot.1.man:80 man/schroot.1.man:85 man/schroot-faq.7.man:119 man/schroot-faq.7.man:124 man/schroot-faq.7.man:130 man/schroot-faq.7.man:132 man/schroot-faq.7.man:134 man/schroot-faq.7.man:151 man/schroot-faq.7.man:156 man/schroot-faq.7.man:158 man/schroot-faq.7.man:160 man/schroot-faq.7.man:162 man/dchroot.1.man:123 man/dchroot.1.man:125 man/dchroot.1.man:127 man/dchroot.1.man:130 man/dchroot.1.man:152 man/dchroot.1.man:154 man/dchroot.1.man:159 man/dchroot.1.man:164 man/dchroot.1.man:173 man/dchroot.1.man:175 man/dchroot.1.man:183 man/dchroot-dsa.1.man:111 man/dchroot-dsa.1.man:113 man/dchroot-dsa.1.man:115 man/dchroot-dsa.1.man:138 man/dchroot-dsa.1.man:140 man/dchroot-dsa.1.man:148 man/dchroot-dsa.1.man:150 man/dchroot-dsa.1.man:156
#, no-wrap
msgid "\\[bu]"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot.1.man:80
msgid "Running 32-bit programs using a 32-bit chroot on a 64-bit host system"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot.1.man:101 man/dchroot.1.man:60 man/dchroot-dsa.1.man:55
#, no-wrap
msgid "OPTIONS"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:103
msgid "B<schroot> accepts the following options:"
msgstr ""
#. type: SS
#: man/schroot.1.man:103
#, no-wrap
msgid "Actions"
msgstr ""
#. type: TP
#: man/schroot.1.man:104 man/dchroot.1.man:63 man/dchroot-dsa.1.man:58
#, no-wrap
msgid "B<-h>, B<--help>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:107 man/dchroot.1.man:66 man/dchroot-dsa.1.man:61
msgid "Show help summary."
msgstr ""
#. type: TP
#: man/schroot.1.man:107 man/dchroot.1.man:115 man/dchroot-dsa.1.man:105
#, no-wrap
msgid "B<-V>, B<--version>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:110 man/dchroot.1.man:118 man/dchroot-dsa.1.man:108
msgid "Print version information."
msgstr ""
#. type: TP
#: man/schroot.1.man:110 man/dchroot.1.man:73 man/dchroot-dsa.1.man:71
#, no-wrap
msgid "B<-l>, B<--list>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:113 man/dchroot.1.man:76 man/dchroot-dsa.1.man:74
msgid "List all available chroots."
msgstr ""
#. type: TP
#: man/schroot.1.man:113 man/dchroot.1.man:76 man/dchroot-dsa.1.man:74
#, no-wrap
msgid "B<-i>, B<--info>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:116
msgid "Print detailed information about the specified chroots."
msgstr ""
#. type: TP
#: man/schroot.1.man:116 man/dchroot.1.man:83 man/dchroot-dsa.1.man:81
#, no-wrap
msgid "B<--config>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:121
#, no-wrap
msgid "B<--location>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:126 man/schroot.conf.5.man:31
#, no-wrap
msgid "General options"
msgstr ""
#. type: TP
#: man/schroot.1.man:127 man/dchroot.1.man:108 man/dchroot-dsa.1.man:97
#, no-wrap
msgid "B<-q>, B<--quiet>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:130 man/dchroot.1.man:111
msgid "Print only essential messages."
msgstr ""
#. type: TP
#: man/schroot.1.man:130 man/dchroot.1.man:111 man/dchroot-dsa.1.man:101
#, no-wrap
msgid "B<-v>, B<--verbose>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:133
msgid "Print all messages."
msgstr ""
#. type: SS
#: man/schroot.1.man:133
#, no-wrap
msgid "Chroot selection"
msgstr ""
#. type: TP
#: man/schroot.1.man:134 man/dchroot.1.man:69 man/dchroot-dsa.1.man:65
#, no-wrap
msgid "B<-c>, B<--chroot=>I<chroot>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:140 man/dchroot.1.man:66 man/dchroot-dsa.1.man:61
#, no-wrap
msgid "B<-a>, B<--all>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:148
#, no-wrap
msgid "B<--all-chroots>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:152
#, no-wrap
msgid "B<--all-sessions>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:156
#, no-wrap
msgid "B<--all-source-chroots>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:160
msgid ""
"Select all source chroots. Identical to I<--all>, except that chroots and "
"sessions are not considered."
msgstr ""
#. type: SS
#: man/schroot.1.man:160
#, no-wrap
msgid "Chroot environment"
msgstr ""
#. type: TP
#: man/schroot.1.man:161 man/dchroot-dsa.1.man:87
#, no-wrap
msgid "B<-d>, B<--directory=>I<directory>"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:173
#, no-wrap
msgid "B<-u>, B<--user=>I<user>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:178
#, no-wrap
msgid "B<-p>, B<--preserve-environment>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:184
#, no-wrap
msgid "Session actions"
msgstr ""
#. type: TP
#: man/schroot.1.man:185
#, no-wrap
msgid "B<--automatic-session>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:189
#, no-wrap
msgid "B<-b>, B<--begin-session>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:195
#, no-wrap
msgid "B<--recover-session>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:201
#, no-wrap
msgid "B<-r>, B<--run-session>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:205
msgid ""
"Run an existing session. The session ID is specified with the I<--chroot> "
"option."
msgstr ""
#. type: TP
#: man/schroot.1.man:205
#, no-wrap
msgid "B<-e>, B<--end-session>"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:209
msgid ""
"End an existing session. The session ID is specified with the I<--chroot> "
"option."
msgstr ""
#. type: SS
#: man/schroot.1.man:209
#, no-wrap
msgid "Session options"
msgstr ""
#. type: TP
#: man/schroot.1.man:210
#, no-wrap
msgid "B<-n>, B<--session-name=>I<session-name>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:218
#, no-wrap
msgid "B<-f>, B<--force>"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:224
#, no-wrap
msgid "Separator"
msgstr ""
#. type: TP
#: man/schroot.1.man:225
#, no-wrap
msgid "B<-->"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:229
#, no-wrap
msgid "AUTHENTICATION"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot.1.man:250
#, no-wrap
msgid "CHROOT NAMESPACES"
msgstr ""
#. type: SS
#: man/schroot.1.man:251
#, no-wrap
msgid "Namespace basics"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:266
#, no-wrap
msgid "Source chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:279
#, no-wrap
msgid "Session chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:285
#, no-wrap
msgid "Actions and default namespaces"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:294
#, no-wrap
msgid "PERFORMANCE"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:303 man/dchroot.1.man:211 man/dchroot-dsa.1.man:184
#, no-wrap
msgid "DIRECTORY FALLBACKS"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:313
#, no-wrap
msgid "Login shell"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:317 man/schroot.1.man:340 man/schroot.1.man:356 man/dchroot.1.man:226 man/dchroot.1.man:244 man/dchroot.1.man:261 man/dchroot-dsa.1.man:199 man/dchroot-dsa.1.man:216
#, no-wrap
msgid "Transition\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:318 man/schroot.1.man:341 man/schroot.1.man:357 man/dchroot.1.man:227 man/dchroot.1.man:245 man/dchroot.1.man:262 man/dchroot-dsa.1.man:200 man/dchroot-dsa.1.man:217
#, no-wrap
msgid "(Host \\[-E<gt>] Chroot)\tComment\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:319 man/schroot.1.man:342 man/schroot.1.man:358 man/dchroot.1.man:228 man/dchroot.1.man:246 man/dchroot.1.man:263 man/dchroot-dsa.1.man:201 man/dchroot-dsa.1.man:218
#, no-wrap
msgid "_\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:320 man/schroot.1.man:343 man/dchroot.1.man:247
#, no-wrap
msgid "CWD \\[-E<gt>] CWD\tT{\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:321 man/schroot.1.man:344
#, no-wrap
msgid "Normal behaviour (if I<--directory> is not used)\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:322 man/schroot.1.man:325 man/schroot.1.man:328 man/schroot.1.man:331 man/schroot.1.man:334 man/schroot.1.man:345 man/schroot.1.man:348 man/dchroot.1.man:232 man/dchroot.1.man:235 man/dchroot.1.man:238 man/dchroot.1.man:249 man/dchroot.1.man:252 man/dchroot.1.man:255 man/dchroot-dsa.1.man:204 man/dchroot-dsa.1.man:207 man/dchroot-dsa.1.man:210
#, no-wrap
msgid "T}\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:323
#, no-wrap
msgid "CWD \\[-E<gt>] $HOME\tT{\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:324
#, no-wrap
msgid "If CWD is nonexistent and --preserve-environment is used\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:326 man/dchroot.1.man:229 man/dchroot-dsa.1.man:202
#, no-wrap
msgid "CWD \\[-E<gt>] passwd pw_dir\tT{\n"
msgstr ""
#. type: tbl table
#: man/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
#: man/schroot.1.man:329 man/dchroot.1.man:233 man/dchroot.1.man:250 man/dchroot-dsa.1.man:205
#, no-wrap
msgid "CWD \\[-E<gt>] /\tT{\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:330
#, no-wrap
msgid "None of the above exist\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:332 man/schroot.1.man:346 man/dchroot.1.man:236 man/dchroot.1.man:253 man/dchroot-dsa.1.man:208
#, no-wrap
msgid "B<FAIL>\tT{\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:333 man/dchroot.1.man:237 man/dchroot.1.man:254 man/dchroot-dsa.1.man:209
#, no-wrap
msgid "If / is nonexistent\n"
msgstr ""
#. type: SS
#: man/schroot.1.man:336
#, no-wrap
msgid "Command"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:347 man/dchroot.1.man:251
#, no-wrap
msgid "If CWD is nonexistent\n"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:352 man/schroot.1.man:364 man/dchroot.1.man:269 man/dchroot-dsa.1.man:224
msgid "No fallbacks should exist under any circumstances."
msgstr ""
#. type: SS
#: man/schroot.1.man:352 man/dchroot.1.man:257 man/dchroot-dsa.1.man:212
#, no-wrap
msgid "--directory used"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:359 man/dchroot.1.man:264 man/dchroot-dsa.1.man:219
#, no-wrap
msgid "CWD \\[-E<gt>] DIR\tNormal behaviour\n"
msgstr ""
#. type: tbl table
#: man/schroot.1.man:360 man/dchroot.1.man:265 man/dchroot-dsa.1.man:220
#, no-wrap
msgid "B<FAIL>\tIf DIR is nonexistent\n"
msgstr ""
#. type: SS
#: man/schroot.1.man:364 man/dchroot.1.man:269 man/dchroot-dsa.1.man:224
#, no-wrap
msgid "Debugging"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:368 man/dchroot.1.man:273 man/dchroot-dsa.1.man:228
msgid ""
"Note that I<--debug=notice> will show the internal fallback list computed "
"for the session."
msgstr ""
#. type: SH
#: man/schroot.1.man:368 man/dchroot.1.man:273 man/dchroot-dsa.1.man:228
#, no-wrap
msgid "EXAMPLES"
msgstr ""
#. type: SS
#: man/schroot.1.man:369
#, no-wrap
msgid "List available chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:378
#, no-wrap
msgid "Get information about a chroot"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:405
msgid ""
"Use I<--all> or I<-c> multiple times to use all or multiple chroots, "
"respectively."
msgstr ""
#. type: SS
#: man/schroot.1.man:405
#, no-wrap
msgid "Running commands in a chroot"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:430
#, no-wrap
msgid "Switching users"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:442
#, no-wrap
msgid "Sessions"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:451
msgid "Let's start by looking at a session-capable chroot:"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot.1.man:541
msgid "Now the session has been created, commands may be run in it:"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot.1.man:569 man/dchroot.1.man:304 man/dchroot-dsa.1.man:249
#, no-wrap
msgid "TROUBLESHOOTING"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:576 man/dchroot.1.man:311 man/dchroot-dsa.1.man:256
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
#: man/schroot.1.man:579 man/dchroot.1.man:314 man/dchroot-dsa.1.man:259
msgid ""
"If you are still having trouble, the developers may be contacted on the "
"mailing list:"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:581 man/dchroot.1.man:316 man/dchroot-dsa.1.man:261
msgid "\\f[CR]Debian\\ buildd-tools\\ Developers\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:583 man/dchroot.1.man:318 man/dchroot-dsa.1.man:263
msgid "\\f[CR]E<lt>buildd-tools-devel@lists.alioth.debian.orgE<gt>\\fR"
msgstr ""
#. type: SH
#: man/schroot.1.man:583 man/dchroot.1.man:318 man/dchroot-dsa.1.man:263
#, no-wrap
msgid "BUGS"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:591 man/dchroot.1.man:326
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
#: man/schroot.1.man:591 man/schroot-setup.5.man:51 man/schroot-script-config.5.man:29
#, no-wrap
msgid "ENVIRONMENT"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.1.man:610 man/schroot-setup.5.man:194 man/schroot.conf.5.man:512 man/dchroot.1.man:326 man/dchroot-dsa.1.man:265
#, no-wrap
msgid "FILES"
msgstr ""
#. type: SS
#: man/schroot.1.man:611
#, no-wrap
msgid "Configuration files"
msgstr ""
#. type: TP
#: man/schroot.1.man:612 man/schroot.conf.5.man:514 man/dchroot.1.man:332 man/dchroot-dsa.1.man:271
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_CONF]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:616 man/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
#: man/schroot.1.man:616 man/schroot.conf.5.man:518
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_CONF_CHROOT_D]\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:624
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:628
msgid "The system-wide chroot setup script directories. See B<schroot-setup>(5)."
msgstr ""
#. type: TP
#: man/schroot.1.man:628
#, no-wrap
msgid "\\f[BI]/etc/pam.d/schroot\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:631
msgid "PAM configuration."
msgstr ""
#. type: SS
#: man/schroot.1.man:631
#, no-wrap
msgid "System directories"
msgstr ""
#. type: TP
#: man/schroot.1.man:632
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_LIBEXEC_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:635
msgid "Directory containing helper programs used by setup scripts."
msgstr ""
#. type: SS
#: man/schroot.1.man:635
#, no-wrap
msgid "Session directories"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.1.man:638
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_SESSION_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:641
msgid "Directory containing the session configuration for each active session."
msgstr ""
#. type: TP
#: man/schroot.1.man:641
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_MOUNT_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:644
msgid "Directory used to mount the filesystems used by each active session."
msgstr ""
#. type: TP
#: man/schroot.1.man:644
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_UNDERLAY_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:647
msgid "Directory used for filesystem union source (underlay)."
msgstr ""
#. type: TP
#: man/schroot.1.man:647
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_OVERLAY_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:650
msgid "Directory used for filesystem union writeable overlay."
msgstr ""
#. type: TP
#: man/schroot.1.man:650
#, no-wrap
msgid "\\f[BI]\\*[SCHROOT_FILE_UNPACK_DIR]\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.1.man:653
msgid "Directory used for unpacking file chroots."
msgstr ""
#. type: SH
#: man/schroot.1.man:655 man/schroot-setup.5.man:257 man/schroot.conf.5.man:552 man/schroot-script-config.5.man:62 man/schroot-faq.7.man:253 man/dchroot.1.man:345 man/dchroot-dsa.1.man:286
#, no-wrap
msgid "SEE ALSO"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:18
#, no-wrap
msgid "SCHROOT-SETUP"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:21
msgid "schroot-setup - schroot chroot setup scripts"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-setup.5.man:34
msgid "The setup scripts are all invoked with two options:"
msgstr ""
#. type: IP
#: man/schroot-setup.5.man:34 man/dchroot.1.man:193 man/dchroot-dsa.1.man:166
#, no-wrap
msgid "1"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:36
msgid "The action to perform."
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:41 man/dchroot.1.man:203 man/dchroot-dsa.1.man:176
#, no-wrap
msgid "2"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:43
msgid "The chroot status."
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-setup.5.man:52
#, no-wrap
msgid "General variables"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:53
#, no-wrap
msgid "AUTH_USER"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:56
msgid "The username of the user the command in the chroot will run as."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:56 man/schroot-setup.5.man:111
#, no-wrap
msgid "CHROOT_NAME"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:60
#, no-wrap
msgid "HOST"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:62
#, no-wrap
msgid "HOST_OS"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:64
#, no-wrap
msgid "HOST_VENDOR"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:66
#, no-wrap
msgid "HOST_CPU"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:72
#, no-wrap
msgid "LIBEXEC_DIR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:75
msgid "The directory under which helper programs are located."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:75
#, no-wrap
msgid "MOUNT_DIR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:79
#, no-wrap
msgid "PID"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:82
msgid "The process ID of the schroot process."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:82
#, no-wrap
msgid "PLATFORM"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:89
#, no-wrap
msgid "SESSION_ID"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:92
msgid "The session identifier."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:92
#, no-wrap
msgid "VERBOSE"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:98
#, no-wrap
msgid "CHROOT_SESSION_CREATE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:101
msgid ""
"Set to \\[oq]true\\[cq] if a session will be created, otherwise "
"\\[oq]false\\[cq]."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:101
#, no-wrap
msgid "CHROOT_SESSION_CLONE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:104
msgid ""
"Set to \\[oq]true\\[cq] if a session will be cloned, otherwise "
"\\[oq]false\\[cq]."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:104
#, no-wrap
msgid "CHROOT_SESSION_PURGE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:107
msgid ""
"Set to \\[oq]true\\[cq] if a session will be purged, otherwise "
"\\[oq]false\\[cq]."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:107
#, no-wrap
msgid "CHROOT_TYPE"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-setup.5.man:115
#, no-wrap
msgid "CHROOT_ALIAS"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:122
#, no-wrap
msgid "CHROOT_DESCRIPTION"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:125
msgid "The description of the chroot."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:125
#, no-wrap
msgid "CHROOT_MOUNT_LOCATION"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:129
msgid ""
"The location to mount the chroot. It is used for mount point creation and "
"mounting."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:129 man/schroot-setup.5.man:159
#, no-wrap
msgid "CHROOT_LOCATION"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:133
#, no-wrap
msgid "CHROOT_PATH"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:138
#, no-wrap
msgid "Plain and directory chroot variables"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:140
msgid "These chroot types use only general variables."
msgstr ""
#. type: SS
#: man/schroot-setup.5.man:140
#, no-wrap
msgid "File variables"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:141
#, no-wrap
msgid "CHROOT_FILE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:144
msgid "The file containing the chroot files."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:144
#, no-wrap
msgid "CHROOT_FILE_REPACK"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:148
#, no-wrap
msgid "Mountable chroot variables"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:151
msgid "These variables are only set for directly mountable chroot types."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:151
#, no-wrap
msgid "CHROOT_MOUNT_DEVICE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:155
msgid "The device to mount containing the chroot. mounting."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:155
#, no-wrap
msgid "CHROOT_MOUNT_OPTIONS"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:159
msgid "Options to pass to B<mount>(8)."
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:163
#, no-wrap
msgid "Filesystem union variables"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:164
#, no-wrap
msgid "CHROOT_UNION_TYPE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:167
msgid "Union filesystem type."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:167
#, no-wrap
msgid "CHROOT_UNION_MOUNT_OPTIONS"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:170
msgid "Union filesystem mount options."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:170
#, no-wrap
msgid "CHROOT_UNION_OVERLAY_DIRECTORY"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:173
msgid "Union filesystem overlay directory (writable)."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:173
#, no-wrap
msgid "CHROOT_UNION_UNDERLAY_DIRECTORY"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:176
msgid "Union filesystem underlay directory (read-only)."
msgstr ""
#. type: SS
#: man/schroot-setup.5.man:176
#, no-wrap
msgid "Block device variables"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:177
#, no-wrap
msgid "CHROOT_DEVICE"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:182
#, no-wrap
msgid "LVM snapshot variables"
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:183
#, no-wrap
msgid "CHROOT_LVM_SNAPSHOT_NAME"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:187
msgid "Snapshot name to pass to B<lvcreate>(8)."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:187
#, no-wrap
msgid "CHROOT_LVM_SNAPSHOT_DEVICE"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:190
msgid "The name of the LVM snapshot device."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:190
#, no-wrap
msgid "CHROOT_LVM_SNAPSHOT_OPTIONS"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:194
msgid "Options to pass to B<lvcreate>(8)."
msgstr ""
#. type: SS
#: man/schroot-setup.5.man:195 man/schroot.conf.5.man:523
#, no-wrap
msgid "Setup script configuration"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:198 man/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
#: man/schroot-setup.5.man:198 man/schroot.conf.5.man:526
#, no-wrap
msgid "\\f[BI]config\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:206 man/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
#: man/schroot-setup.5.man:206 man/schroot.conf.5.man:534
#, no-wrap
msgid "\\f[BI]copyfiles\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:210 man/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
#: man/schroot-setup.5.man:210 man/schroot.conf.5.man:538
#, no-wrap
msgid "\\f[BI]fstab\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:217 man/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
#: man/schroot-setup.5.man:217 man/schroot.conf.5.man:545
#, no-wrap
msgid "\\f[BI]nssdatabases\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:222 man/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
#: man/schroot-setup.5.man:222
#, no-wrap
msgid "Setup scripts"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:224
msgid ""
"The directory \\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR contains the chroot setup "
"scripts."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:224
#, no-wrap
msgid "\\f[BI]00check\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:227
msgid "Print debugging diagnostics and perform basic sanity checking."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:227
#, no-wrap
msgid "\\f[BI]05file\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:230
msgid "Unpack, clean up, and repack file-based chroots."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:230
#, no-wrap
msgid "\\f[BI]05fsunion\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:233
msgid "Create and remove union filesystems."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:233
#, no-wrap
msgid "\\f[BI]05lvm\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:236
msgid "Create and remove LVM snapshots."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:236
#, no-wrap
msgid "\\f[BI]10mount\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:239
msgid "Mount and unmount filesystems."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:239
#, no-wrap
msgid "\\f[BI]15killprocs\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:243
#, no-wrap
msgid "\\f[BI]20copyfiles\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-setup.5.man:247
#, no-wrap
msgid "\\f[BI]20nssdatabases\\fR"
msgstr ""
#. type: Plain text
#: man/schroot-setup.5.man:251
msgid ""
"Configure system databases by copying passwd, shadow, group etc. into the "
"chroot."
msgstr ""
#. type: TP
#: man/schroot-setup.5.man:251
#, no-wrap
msgid "\\f[BI]50chrootname\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:18
#, no-wrap
msgid "SCHROOT.CONF"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:21
msgid "schroot.conf - chroot definition file for schroot"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot.conf.5.man:40
msgid "\\f[CR]\\[lB]sid\\[rB]\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:45
msgid "This is then followed by several key-value pairs, one per line:"
msgstr ""
#. type: TP
#: man/schroot.conf.5.man:45
#, no-wrap
msgid "\\f[CBI]type=\\f[CI]type\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:53
#, no-wrap
msgid "\\f[CBI]description=\\f[CI]description\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:57
#, no-wrap
msgid "\\f[CBI]priority=\\f[CI]number\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:67
#, no-wrap
msgid "\\f[CBI]message-verbosity=\\f[CI]verbosity\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:74
#, no-wrap
msgid "\\f[CBI]users=\\f[CI]user1,user2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:79
#, no-wrap
msgid "\\f[CBI]groups=\\f[CI]group1,group2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:83
#, no-wrap
msgid "\\f[CBI]root-users=\\f[CI]user1,user2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:90
#, no-wrap
msgid "\\f[CBI]root-groups=\\f[CI]group1,group2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:97
#, no-wrap
msgid "\\f[CBI]aliases=\\f[CI]alias1,alias2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:103
#, no-wrap
msgid "\\f[CBI]script-config=\\f[CI]filename\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot.conf.5.man:128
#, no-wrap
msgid "\\f[CBI]command-prefix=\\f[CI]command,option1,option2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:137
#, no-wrap
msgid "\\f[CBI]personality=\\f[CI]persona\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:151
#, no-wrap
msgid "\\f[CBI]preserve-environment=\\f[CI]true\\fR|\\f[CI]false\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:158
#, no-wrap
msgid "\\f[CBI]environment-filter=\\f[CI]regex\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot.conf.5.man:170
#, no-wrap
msgid "Plain and directory chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:181
msgid "These chroot types have an additional (mandatory) configuration option:"
msgstr ""
#. type: TP
#: man/schroot.conf.5.man:181
#, no-wrap
msgid "\\f[CBI]directory=\\f[CI]directory\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:193
#, no-wrap
msgid "File chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:200 man/schroot.conf.5.man:223
#, no-wrap
msgid "\\f[CBI]file=\\f[CI]filename\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:209 man/schroot.conf.5.man:334
#, no-wrap
msgid "\\f[CBI]location=\\f[CI]path\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:216
#, no-wrap
msgid "Loopback chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:227
#, no-wrap
msgid "Block device chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:234
#, no-wrap
msgid "\\f[CBI]device=\\f[CI]device\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:238
#, no-wrap
msgid "Btrfs snapshot chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:248
#, no-wrap
msgid "\\f[CBI]btrfs-source-subvolume=\\f[CI]directory\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:251
msgid "The directory containing the source subvolume."
msgstr ""
#. type: TP
#: man/schroot.conf.5.man:251
#, no-wrap
msgid "\\f[CBI]btrfs-snapshot-directory=\\f[CI]directory\\fR"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:254
msgid "The directory in which to store the snapshots of the above source subvolume."
msgstr ""
#. type: SS
#: man/schroot.conf.5.man:254
#, no-wrap
msgid "LVM snapshot chroots"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:266
#, no-wrap
msgid "\\f[CBI]lvm-snapshot-options=\\f[CI]snapshot_options\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:273
#, no-wrap
msgid "Source chroot options"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:293
msgid "These chroots provide the following additional options:"
msgstr ""
#. type: TP
#: man/schroot.conf.5.man:293
#, no-wrap
msgid "\\f[CBI]source-clone=\\f[CI]true\\fR|\\f[CI]false\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:299
#, no-wrap
msgid "\\f[CBI]source-users=\\f[CI]user1,user2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:304
#, no-wrap
msgid "\\f[CBI]source-groups=\\f[CI]group1,group2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:309
#, no-wrap
msgid "\\f[CBI]source-root-users=\\f[CI]user1,user2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:316
#, no-wrap
msgid "\\f[CBI]source-root-groups=\\f[CI]group1,group2,...\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:324
#, no-wrap
msgid "Mountable chroot options"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:329
#, no-wrap
msgid "\\f[CBI]mount-options=\\f[CI]options\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:341
#, no-wrap
msgid "Filesystem Union chroot options"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:353
#, no-wrap
msgid "\\f[CBI]union-type=\\f[CI]type\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:358
#, no-wrap
msgid "\\f[CBI]union-mount-options=\\f[CI]options\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:372
#, no-wrap
msgid "\\f[CBI]union-overlay-directory\\f[CI]=directory\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:376
#, no-wrap
msgid "\\f[CBI]union-underlay-directory\\f[CI]=directory\\fR"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:380
#, no-wrap
msgid "Localisation"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:387
#, no-wrap
msgid "description[en_GB]=\\f[CI]British English translation\\fR\n"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:391
msgid "This will localise the \\f[CI]description\\fR key for the en_GB locale."
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:394
#, no-wrap
msgid "description[fr]=\\f[CI]French translation\\fR\n"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:398
msgid "This will localise the \\f[CI]description\\fR key for all French locales."
msgstr ""
#. type: SH
#: man/schroot.conf.5.man:398
#, no-wrap
msgid "CHROOT NAMES"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:405
#, no-wrap
msgid "\\[oq]B<.>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:412
#, no-wrap
msgid "\\[oq]B<:>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:418
#, no-wrap
msgid "\\[oq]B</>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:422
#, no-wrap
msgid "\\[oq]B<,>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:426
#, no-wrap
msgid "\\[oq]B<~>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:430
#, no-wrap
msgid "\\[oq]B<dpkg-old>\\[cq]"
msgstr ""
#. type: TQ
#: man/schroot.conf.5.man:432
#, no-wrap
msgid "\\[oq]B<dpkg-dist>\\[cq]"
msgstr ""
#. type: TQ
#: man/schroot.conf.5.man:434
#, no-wrap
msgid "\\[oq]B<dpkg-new>\\[cq]"
msgstr ""
#. type: TQ
#: man/schroot.conf.5.man:436
#, no-wrap
msgid "\\[oq]B<dpkg-tmp>\\[cq]"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot.conf.5.man:440
#, no-wrap
msgid "SECURITY"
msgstr ""
#. type: SS
#: man/schroot.conf.5.man:441
#, no-wrap
msgid "Untrusted users"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:450
#, no-wrap
msgid "Profiles"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot.conf.5.man:467
#, no-wrap
msgid "EXAMPLE"
msgstr ""
#. type: Plain text
#: man/schroot.conf.5.man:470
#, no-wrap
msgid "# Sample configuration\n"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot.conf.5.man:513
#, no-wrap
msgid "Chroot definitions"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-script-config.5.man:18
#, no-wrap
msgid "SCHROOT-SCRIPT-CONFIG"
msgstr ""
#. type: Plain text
#: man/schroot-script-config.5.man:21
msgid "schroot-script-config - schroot chroot setup script configuration"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-script-config.5.man:32
#, no-wrap
msgid "VARIABLES"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-script-config.5.man:38
#, no-wrap
msgid "COPYFILES"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-script-config.5.man:42
#, no-wrap
msgid "FSTAB"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-script-config.5.man:49
#, no-wrap
msgid "NSSDATABASES"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-faq.7.man:18
#, no-wrap
msgid "SCHROOT-FAQ"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:21
msgid "schroot - frequently asked questions"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:24
msgid ""
"This manual page covers various frequently asked questions about "
"configuration and usage of schroot."
msgstr ""
#. type: SH
#: man/schroot-faq.7.man:24 man/dchroot.1.man:120 man/dchroot-dsa.1.man:108
#, no-wrap
msgid "CONFIGURATION"
msgstr ""
#. type: SS
#: man/schroot-faq.7.man:25
#, no-wrap
msgid "Why is schroot overwriting configuration files in the chroot?"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot-faq.7.man:43
#, no-wrap
msgid "Should I use the plain or directory chroot type?"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:54
#, no-wrap
msgid "ADVANCED CONFIGURATION"
msgstr ""
#. type: SS
#: man/schroot-faq.7.man:55
#, no-wrap
msgid "What are snapshots and unions?"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot-faq.7.man:84
#, no-wrap
msgid "USAGE"
msgstr ""
#. type: SS
#: man/schroot-faq.7.man:85
#, no-wrap
msgid "Can I run a d\\[ae]mons in a chroot?"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/schroot-faq.7.man:105
#, no-wrap
msgid "How do I manually cleaning up a broken session?"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:119
msgid "For example, to remove a session named I<my-session> by hand:"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:121
msgid "Remove the session configuration file"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:123
#, no-wrap
msgid "%\\ \\f[CB]rm\\ \\*[SCHROOT_SESSION_DIR]/my-session\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:126
msgid "Check for mounted filesystems"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:132
msgid "Unmount any mounted filesystems"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:134
msgid "Remove I<\\*[SCHROOT_MOUNT_DIR]/my-session>"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-faq.7.man:141
#, no-wrap
msgid "ADVANCED USAGE"
msgstr ""
#. type: SS
#: man/schroot-faq.7.man:142
#, no-wrap
msgid "How do I use sessions?"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:144
msgid "In normal use, running a command might look like this:"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:146
#, no-wrap
msgid "%\\ \\f[CB]schroot\\ -c squeeze -- command\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-faq.7.man:158
msgid "Setup scripts are run to create the session chroot and configure it for you"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:160
msgid "The command I<command> is run inside the session chroot"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:162
msgid "Setup scripts are run to clean up the session chroot"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:164
msgid "The session is deleted"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/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
#: man/schroot-faq.7.man:198 man/schroot-faq.7.man:217
msgid "or"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:200
#, no-wrap
msgid "% \\f[CB]schroot --run-session -c \"$SESSION\" -- command1\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/schroot-faq.7.man:203
msgid "and then as many more commands as we like"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:210
msgid "etc."
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-faq.7.man:219
#, no-wrap
msgid "% \\f[CB]schroot --end-session -c \"$SESSION\"\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/schroot-faq.7.man:228
#, no-wrap
msgid "CONTRIBUTING"
msgstr ""
#. type: SS
#: man/schroot-faq.7.man:229
#, no-wrap
msgid "Getting help and getting involved"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:236
#, no-wrap
msgid "Reporting bugs"
msgstr ""
#. type: Plain text
#: man/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
#: man/schroot-faq.7.man:241
#, no-wrap
msgid "Getting the latest sources"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/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
#: man/dchroot.1.man:19
#, no-wrap
msgid "dchroot"
msgstr ""
#. type: TH
#: man/dchroot.1.man:20
#, no-wrap
msgid "DCHROOT"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:23
msgid "dchroot - enter a chroot environment"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/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
#: man/dchroot.1.man:56
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<Migration>\\[rq] below for help migrating an existing "
"dchroot configuration to schroot. See the section "
"\\[lq]I<Incompatibilities>\\[rq] below for known incompatibilities with "
"older versions of dchroot."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:60
msgid ""
"If no chroot is specified, the chroot name or alias \\[oq]default\\[cq] will "
"be used as a fallback. If using the configuration in I<\\*[DCHROOT_CONF]>, "
"the first chroot in the file is the default."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:62
msgid "B<dchroot> accepts the following options:"
msgstr ""
#. type: SS
#: man/dchroot.1.man:62 man/dchroot-dsa.1.man:57
#, no-wrap
msgid "Basic options"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:69
msgid "Select all chroots."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:73
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
#: man/dchroot.1.man:80
msgid ""
"Print detailed information about the specified chroots. Note that earlier "
"versions of dchroot did not include this option."
msgstr ""
#. type: TP
#: man/dchroot.1.man:80
#, no-wrap
msgid "B<-p>, B<--path>"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:83
msgid "Print location (path) of the specified chroots."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:89
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
#: man/dchroot.1.man:89
#, no-wrap
msgid "B<--directory=>I<directory>"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:94
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
#: man/dchroot.1.man:103
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
#: man/dchroot.1.man:103
#, no-wrap
msgid "B<-d>, B<--preserve-environment>"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:108
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
#: man/dchroot.1.man:115
msgid ""
"Print all messages. Note that earlier versions of dchroot did not include "
"this option."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:120
msgid "Note that earlier versions of dchroot did not provide long options."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:123
msgid ""
"The dchroot configuration file, I<\\*[DCHROOT_CONF]>, used by earlier "
"versions of dchroot, has the following format:"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:125 man/dchroot-dsa.1.man:113
msgid "\\[oq]#\\[cq] starts a comment line."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:127 man/dchroot-dsa.1.man:115
msgid "Blank lines are ignored."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:130
msgid ""
"Chroot definitions are a single line containing an \\f[CBI]identifier\\fR, "
"\\f[CBI]path\\fR, and an optional \\f[CBI]personality\\fR separated by "
"whitespace."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:132
msgid "The first chroot is also the default chroot."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:134 man/dchroot-dsa.1.man:122
msgid "An example file:"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:138
#, no-wrap
msgid "# Example comment\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:141
#, no-wrap
msgid ""
"sarge /srv/chroot/sarge\n"
"sid /srv/chroot/sid linux32\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:150
msgid ""
"This file defines a chroot called \\[oq]sarge\\[cq], located at "
"I</srv/chroot/sarge>, and a second chroot called \\[oq]sid\\[cq], located at "
"I</srv/chroot/sid>. The second chroot uses the \\[oq]linux32\\[cq] "
"personality, which allows a 32-bit chroot to be used on a 64-bit system. "
"\\[oq]sarge\\[cq] is the default chroot, because it was listed first, which "
"means if the I<-c> option is omitted this chroot will be used."
msgstr ""
#. type: SH
#: man/dchroot.1.man:150 man/dchroot-dsa.1.man:136
#, no-wrap
msgid "INCOMPATIBILITIES"
msgstr ""
#. type: SS
#: man/dchroot.1.man:151
#, no-wrap
msgid "Debian dchroot prior to version 0.99.0"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:154 man/dchroot-dsa.1.man:140
msgid "Log messages are worded and formatted differently."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:159
msgid ""
"The parsing of I<\\*[DCHROOT_CONF]> uses a smaller list of allowed "
"whitespace characters (space and tab), which may cause a parse error during "
"tokenising if the file contains odd characters as separators, such as "
"carriage returns, vertical tabs and form feeds."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:164
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
#: man/dchroot.1.man:170
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
#: man/dchroot.1.man:170 man/dchroot-dsa.1.man:137
#, no-wrap
msgid "DSA dchroot"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:173
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
#: man/dchroot.1.man:175 man/dchroot-dsa.1.man:150
msgid "All the above incompatibilities apply."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:183
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
#: man/dchroot.1.man:190
msgid ""
"This version of dchroot has an incompatible format for I<dchroot.conf>. "
"While the first two fields are the same, the remaining fields are an "
"optional \\f[CBI]users\\fR, a list of users permitted to access the chroot, "
"instead of the \\f[CI]personality\\fR field allowed by this version. If "
"access restrictions are needed, please use I<\\*[SCHROOT_CONF]> and add the "
"allowed users there, as shown in \\[lq]I<Migration>\\[rq] below."
msgstr ""
#. type: SH
#: man/dchroot.1.man:190 man/dchroot-dsa.1.man:163
#, no-wrap
msgid "MIGRATION"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:193
msgid ""
"To migrate an existing B<dchroot> configuration to B<schroot>, perform the "
"following steps:"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:196
msgid ""
"Dump the dchroot configuration in schroot keyfile format to "
"I<\\*[SCHROOT_CONF]>."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:200
#, no-wrap
msgid "# \\f[CB]dchroot --config E<gt>E<gt> \\*[SCHROOT_CONF]\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:208 man/dchroot-dsa.1.man:181
msgid ""
"Edit I<\\*[SCHROOT_CONF]> to add access to the users and/or groups which are "
"to be allowed to access the chroots, and make any other desired changes to "
"the configuration. See B<schroot.conf>(5)."
msgstr ""
#. type: IP
#: man/dchroot.1.man:208 man/dchroot-dsa.1.man:181
#, no-wrap
msgid "3"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:211
msgid ""
"Remove I<\\*[DCHROOT_CONF]>, so that dchroot will subsequently use "
"I<\\*[SCHROOT_CONF]> for its configuration."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:222
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
#: man/dchroot.1.man:222 man/dchroot-dsa.1.man:195
#, no-wrap
msgid "Login shell or command"
msgstr ""
#. type: tbl table
#: man/dchroot.1.man:230
#, no-wrap
msgid "Normal behaviour (if --directory and I<--preserve-environment> are not\n"
msgstr ""
#. type: tbl table
#: man/dchroot.1.man:231
#, no-wrap
msgid "used)\n"
msgstr ""
#. type: tbl table
#: man/dchroot.1.man:234 man/dchroot-dsa.1.man:206
#, no-wrap
msgid "If passwd pw_dir is nonexistent\n"
msgstr ""
#. type: SS
#: man/dchroot.1.man:240
#, no-wrap
msgid "--preserve-environment used"
msgstr ""
#. type: tbl table
#: man/dchroot.1.man:248
#, no-wrap
msgid "Normal behaviour (if I<--preserve-environment> used)\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:277
#, no-wrap
msgid ""
"$ \\f[CB]dchroot -l\\fR\\[CR]\n"
"Available chroots: sarge [default], sid\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:280
#, no-wrap
msgid ""
"$ \\f[CB]dchroot -p sid\\fR\\[CR]\n"
"/srv/chroot/sid\n"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:285
#, 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
#: man/dchroot.1.man:291
#, 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
#: man/dchroot.1.man:295
#, 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
#: man/dchroot.1.man:304
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: TP
#: man/dchroot.1.man:327 man/dchroot-dsa.1.man:266
#, no-wrap
msgid "\\f[BI]\\*[DCHROOT_CONF]\\fR"
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:332
msgid ""
"The system-wide B<dchroot> chroot definition file. This file must be owned "
"by the root user, and not be writable by other. If present, this file will "
"be used in preference to I<\\*[SCHROOT_CONF]>."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:339 man/dchroot-dsa.1.man:278
msgid ""
"The system-wide B<schroot> definition file. This file must be owned by the "
"root user, and not be writable by other. It is recommended that this file "
"be used in preference to I<\\*[DCHROOT_CONF]>, because the chroots can be "
"used interchangeably with schroot, and the user and group security policies "
"provided by schroot are also enforced."
msgstr ""
#. type: Plain text
#: man/dchroot.1.man:344
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
#: man/dchroot.1.man:350 man/dchroot-dsa.1.man:291
msgid ""
"B<schroot>(1), B<sbuild>(1), B<chroot>(2), B<schroot-setup>(5), "
"B<schroot.conf>(5)."
msgstr ""
#. type: ds PROGRAM
#: man/dchroot-dsa.1.man:19
#, no-wrap
msgid "dchroot-dsa"
msgstr ""
#. type: TH
#: man/dchroot-dsa.1.man:20
#, no-wrap
msgid "DCHROOT-DSA"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:23
msgid "dchroot-dsa - enter a chroot environment"
msgstr ""
#. type: Plain text
#: man/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
#: man/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
#: man/dchroot-dsa.1.man:39
msgid "The user's environment will be preserved inside the chroot."
msgstr ""
#. type: Plain text
#: man/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
#: man/dchroot-dsa.1.man:54
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<Migration>\\[rq] below for help migrating your "
"existing dchroot-dsa configuration to schroot. See the section "
"\\[lq]I<Incompatibilities>\\[rq] below for known incompatibilities with "
"older versions of dchroot-dsa."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:57
msgid "B<dchroot-dsa> accepts the following options:"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:65
msgid ""
"Select all chroots. Note that earlier versions of dchroot-dsa did not "
"include this option."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.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>. 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
#: man/dchroot-dsa.1.man:78
msgid ""
"Print detailed information about the available chroots. Note that earlier "
"versions of dchroot-dsa did not include this option."
msgstr ""
#. type: TP
#: man/dchroot-dsa.1.man:78
#, no-wrap
msgid "B<-p>, B<--listpaths>"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:81
msgid "Print absolute locations (paths) of the available chroots."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:87
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
#: man/dchroot-dsa.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-dsa will exit with an "
"error status."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:97
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
#: man/dchroot-dsa.1.man:101
msgid ""
"Print only essential messages. Note that earlier versions of dchroot-dsa "
"did not include this option."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:105
msgid ""
"Print all messages. Note that earlier versions of dchroot-dsa did not "
"include this option."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:111
msgid ""
"The original B<dchroot-dsa> configuration file, I<\\*[DCHROOT_CONF]>, used "
"by earlier versions of dchroot-dsa, has the following format:"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:120
msgid ""
"Chroot definitions are a single line containing an \\f[CBI]identifier\\fR, "
"\\f[CBI]path\\fR, and \\f[CBI]users\\fR, an optional user list separated by "
"whitespace (space and tab), or a colon (\\[oq]:\\[cq]), semicolon "
"(\\[oq];\\[cq]), or comma (\\[oq],\\[cq])."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:129
#, no-wrap
msgid ""
"# Example comment\n"
"\n"
"sarge /srv/chroot/sarge\n"
"sid /srv/chroot/sid rleigh,fred\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:136
msgid ""
"This file defines a chroot called \\[oq]sarge\\[cq], located at "
"I</srv/chroot/sarge>, and a second chroot called \\[oq]sid\\[cq], located at "
"I</srv/chroot/sid>. The second chroot specifies that it may only be used by "
"the users \\[lq]rleigh\\[rq] and \\[lq]fred\\[rq]."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:146
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
#: man/dchroot-dsa.1.man:146
#, no-wrap
msgid "Debian dchroot"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:148
msgid "A B<dchroot> package provides an alternative dchroot implementation."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:156
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
#: man/dchroot-dsa.1.man:163
msgid ""
"This version of dchroot has an incompatible format for I<dchroot.conf>. "
"While the first two fields are the same, the third field is a optional "
"\\f[CBI]personality\\fR, instead of the \\f[CI]users\\fR user list permitted "
"to access the chroot allowed by this version. If personality support is "
"needed, please use I<schroot.conf> and add the allowed users there, as shown "
"in \\[lq]I<Migration>\\[rq] below."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:166
msgid ""
"To migrate an existing B<dchroot-dsa> configuration to B<schroot>, perform "
"the following steps:"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:169
msgid ""
"Dump the dchroot-dsa configuration in schroot keyfile format to "
"I<\\*[SCHROOT_CONF]>."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:173
#, no-wrap
msgid "# \\f[CB]dchroot-dsa --config E<gt>E<gt> \\*[SCHROOT_CONF]\\fR\\[CR]\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:184
msgid ""
"Remove I<\\*[DCHROOT_CONF]>, so that dchroot-dsa will subsequently use "
"I<\\*[SCHROOT_CONF]> for its configuration."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:195
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
#: man/dchroot-dsa.1.man:203
#, no-wrap
msgid "Normal behaviour (if --directory is not used)\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:232
#, no-wrap
msgid ""
"$ \\f[CB]dchroot-dsa -l\\fR\\[CR]\n"
"Available chroots: sarge, sid\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:236
#, no-wrap
msgid ""
"$ \\f[CB]dchroot-dsa --listpaths\\fR\\[CR]\n"
"/srv/chroot/sarge\n"
"/srv/chroot/sid\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:239
#, no-wrap
msgid ""
"$ \\f[CB]dchroot-dsa -q sid -- /bin/uname\\fR\\[CR]\n"
"Linux\n"
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:243
#, 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
#: man/dchroot-dsa.1.man:249
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
#: man/dchroot-dsa.1.man:265
msgid "None known at this time."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:271
msgid ""
"The system-wide B<dchroot-dsa> chroot definition file. This file must be "
"owned by the root user, and not be writable by other. If present, this file "
"will be used in preference to I<\\*[SCHROOT_CONF]>."
msgstr ""
#. type: Plain text
#: man/dchroot-dsa.1.man:285
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 ""
Attachment:
signature.asc
Description: OpenPGP digital signature