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