# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Roger Leigh # This file is distributed under the same license as the schroot package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: schroot 1.7.0\n" "POT-Creation-Date: 2013-04-01 17:30+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: SH #: man/authors.man:1 #, no-wrap msgid "AUTHORS" msgstr "" #. type: Plain text #: man/authors.man:2 msgid "Roger Leigh." msgstr "" #. type: SH #: man/copyright.man:1 #, no-wrap msgid "COPYRIGHT" msgstr "" #. type: Plain text #: man/copyright.man:3 msgid "Copyright \\(co 2005-2013 Roger Leigh \\f[CR]Erleigh@debian.orgE\\fR" msgstr "" #. type: Plain text #: man/copyright.man:7 msgid "" "B<\\*[PROGRAM]> is free software: you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation, either version 3 of the License, or (at your option) " "any later version." msgstr "" #. type: TH #: man/schroot.1.man:20 #, no-wrap msgid "SCHROOT" msgstr "" #. type: TH #: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20 #, no-wrap msgid "\\*[RELEASE_DATE]" msgstr "" #. type: TH #: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20 #, no-wrap msgid "Version \\*[VERSION]" msgstr "" #. type: TH #: man/schroot.1.man:20 man/schroot-setup.5.man:18 man/schroot.conf.5.man:18 man/schroot-script-config.5.man:18 man/schroot-faq.7.man:18 man/dchroot.1.man:20 man/dchroot-dsa.1.man:20 #, no-wrap msgid "Debian sbuild" msgstr "" #. type: SH #: man/schroot.1.man:21 man/schroot-setup.5.man:19 man/schroot.conf.5.man:19 man/schroot-script-config.5.man:19 man/schroot-faq.7.man:19 man/dchroot.1.man:21 man/dchroot-dsa.1.man:21 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man/schroot.1.man:23 msgid "schroot - securely enter a chroot environment" msgstr "" #. type: SH #: man/schroot.1.man:23 man/dchroot.1.man:23 man/dchroot-dsa.1.man:23 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man/schroot.1.man:44 msgid "" "B [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\\[or]B<--session-name=>I] [B<-d " ">I\\[or]B<--directory=>I] [B<-u " ">I\\[or]B<--user=>I] [B<-p>\\[or]B<--preserve-environment>] " "[B<-s >I\\[or]B<--shell=>I] [B<-q>\\[or]B<--quiet> \\[or] " "B<-v>\\[or]B<--verbose>] [B<-c >I\\[or]B<--chroot=>I \\[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] [B<-->] [B [ B [ " "B [ B]]]]" msgstr "" #. type: SH #: man/schroot.1.man:44 man/schroot-setup.5.man:21 man/schroot.conf.5.man:21 man/schroot-script-config.5.man:21 man/schroot-faq.7.man:21 man/dchroot.1.man:34 man/dchroot-dsa.1.man:33 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man/schroot.1.man:48 msgid "" "B allows the user to run a command or a login shell in a chroot " "environment. If no command is specified, a login shell will be started in " "the user's current working directory inside the chroot." msgstr "" #. type: Plain text #: man/schroot.1.man:51 msgid "" "The command is a program, plus as many optional arguments as required. Each " "argument may be separately quoted." msgstr "" #. type: Plain text #: man/schroot.1.man:54 man/dchroot.1.man:48 man/dchroot-dsa.1.man:45 msgid "" "The directory the command or login shell is run in depends upon the " "context. See I<--directory> option below for a complete description." msgstr "" #. type: Plain text #: man/schroot.1.man: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\\[rq], below." msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:61 #, no-wrap msgid "OVERVIEW" msgstr "" #. type: Plain text #: man/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 or B, schroot does not virtualise the entire system; it only " "virtualises the filesystem, and some parts of the filesystem may still be " "shared with the host. It is therefore fast, lightweight and flexible. " "However, it does not virtualise other aspects of the system, such as shared " "memory, networking, devices etc., and so may be less secure than other " "systems, depending upon its intended use. Some examples of existing uses " "for schroot include:" msgstr "" #. type: IP #: man/schroot.1.man:71 man/schroot.1.man:75 man/schroot.1.man:78 man/schroot.1.man:81 man/schroot.1.man:83 man/schroot.1.man:88 man/schroot.conf.5.man:477 man/schroot.conf.5.man:480 man/schroot.conf.5.man:483 man/schroot.conf.5.man:486 man/schroot-faq.7.man:122 man/schroot-faq.7.man:127 man/schroot-faq.7.man:133 man/schroot-faq.7.man:135 man/schroot-faq.7.man:137 man/schroot-faq.7.man:154 man/schroot-faq.7.man:159 man/schroot-faq.7.man:161 man/schroot-faq.7.man:163 man/schroot-faq.7.man:165 man/dchroot.1.man:120 man/dchroot.1.man:122 man/dchroot.1.man:127 man/dchroot.1.man:134 man/dchroot.1.man:143 man/dchroot.1.man:145 man/dchroot-dsa.1.man:109 man/dchroot-dsa.1.man:116 man/dchroot-dsa.1.man:118 man/dchroot-dsa.1.man:126 man/dchroot-dsa.1.man:128 #, no-wrap msgid "\\[bu]" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:78 msgid "" "Using a I or I environment, to guarantee the reproducibility " "and integrity of a given task" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:83 msgid "Running 32-bit programs using a 32-bit chroot on a 64-bit host system" msgstr "" #. type: Plain text #: man/schroot.1.man:88 msgid "" "Automatic building of Debian packages using B(1), which builds each " "package in a pristine chroot snapshot when using LVM snapshots or unions" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:118 msgid "" "A chroot may be used directly as root by running B(8), but normal " "users are not able to use this command. B 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(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 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(5)." msgstr "" #. type: SH #: man/schroot.1.man:118 man/dchroot.1.man:58 man/dchroot-dsa.1.man:53 #, no-wrap msgid "OPTIONS" msgstr "" #. type: Plain text #: man/schroot.1.man:120 msgid "B accepts the following options:" msgstr "" #. type: SS #: man/schroot.1.man:120 #, no-wrap msgid "Actions" msgstr "" #. type: TP #: man/schroot.1.man:121 man/dchroot.1.man:61 man/dchroot-dsa.1.man:56 #, no-wrap msgid "B<-h>, B<--help>" msgstr "" #. type: Plain text #: man/schroot.1.man:124 man/dchroot.1.man:64 man/dchroot-dsa.1.man:59 msgid "Show help summary." msgstr "" #. type: TP #: man/schroot.1.man:124 man/dchroot.1.man:113 man/dchroot-dsa.1.man:103 #, no-wrap msgid "B<-V>, B<--version>" msgstr "" #. type: Plain text #: man/schroot.1.man:127 man/dchroot.1.man:116 man/dchroot-dsa.1.man:106 msgid "Print version information." msgstr "" #. type: TP #: man/schroot.1.man:127 man/dchroot.1.man:71 man/dchroot-dsa.1.man:69 #, no-wrap msgid "B<-l>, B<--list>" msgstr "" #. type: Plain text #: man/schroot.1.man:130 man/dchroot.1.man:74 man/dchroot-dsa.1.man:72 msgid "List all available chroots." msgstr "" #. type: TP #: man/schroot.1.man:130 man/dchroot.1.man:74 man/dchroot-dsa.1.man:72 #, no-wrap msgid "B<-i>, B<--info>" msgstr "" #. type: Plain text #: man/schroot.1.man:133 msgid "Print detailed information about the specified chroots." msgstr "" #. type: TP #: man/schroot.1.man:133 man/dchroot.1.man:81 man/dchroot-dsa.1.man:79 #, no-wrap msgid "B<--config>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:138 #, no-wrap msgid "B<--location>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:143 man/schroot.conf.5.man:31 #, no-wrap msgid "General options" msgstr "" #. type: TP #: man/schroot.1.man:144 man/dchroot.1.man:106 man/dchroot-dsa.1.man:95 #, no-wrap msgid "B<-q>, B<--quiet>" msgstr "" #. type: Plain text #: man/schroot.1.man:147 man/dchroot.1.man:109 msgid "Print only essential messages." msgstr "" #. type: TP #: man/schroot.1.man:147 man/dchroot.1.man:109 man/dchroot-dsa.1.man:99 #, no-wrap msgid "B<-v>, B<--verbose>" msgstr "" #. type: Plain text #: man/schroot.1.man:150 msgid "Print all messages." msgstr "" #. type: SS #: man/schroot.1.man:150 #, no-wrap msgid "Chroot selection" msgstr "" #. type: TP #: man/schroot.1.man:151 man/dchroot.1.man:67 man/dchroot-dsa.1.man:63 #, no-wrap msgid "B<-c>, B<--chroot=>I" msgstr "" #. type: Plain text #: man/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; see the " "section \\[lq]I\\[rq], below." msgstr "" #. type: TP #: man/schroot.1.man:157 man/dchroot.1.man:64 man/dchroot-dsa.1.man:59 #, no-wrap msgid "B<-a>, B<--all>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:165 #, no-wrap msgid "B<--all-chroots>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:169 #, no-wrap msgid "B<--all-sessions>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:173 #, no-wrap msgid "B<--all-source-chroots>" msgstr "" #. type: Plain text #: man/schroot.1.man:177 msgid "" "Select all source chroots. Identical to I<--all>, except that chroots and " "sessions are not considered." msgstr "" #. type: TP #: man/schroot.1.man:177 #, no-wrap msgid "B<--exclude-aliases>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:181 #, no-wrap msgid "Chroot environment" msgstr "" #. type: TP #: man/schroot.1.man:182 man/dchroot-dsa.1.man:85 #, no-wrap msgid "B<-d>, B<--directory=>I" msgstr "" #. type: Plain text #: man/schroot.1.man:187 msgid "" "Change to I inside the chroot before running the command or login " "shell. If I is not available, schroot will exit with an error " "status." msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:194 #, no-wrap msgid "B<-u>, B<--user=>I" msgstr "" #. type: Plain text #: man/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\\[rq], below." msgstr "" #. type: TP #: man/schroot.1.man:199 #, no-wrap msgid "B<-p>, B<--preserve-environment>" msgstr "" #. type: Plain text #: man/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\\[rq], below." msgstr "" #. type: TP #: man/schroot.1.man:205 #, no-wrap msgid "B<-s>, B<--shell=>I" msgstr "" #. type: Plain text #: man/schroot.1.man:214 msgid "" "Use I 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 and finally I. 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 #: man/schroot.1.man:214 #, no-wrap msgid "B<-o>, B<--option=>I" msgstr "" #. type: Plain text #: man/schroot.1.man:223 msgid "" "Set an option. The value of selected configuration keys in I " "may be modified using this option. The key must be present in the " "\\f[CI]user-modifiable-keys\\fR configuration key in I, 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 #: man/schroot.1.man:223 #, no-wrap msgid "Session actions" msgstr "" #. type: TP #: man/schroot.1.man:224 #, no-wrap msgid "B<--automatic-session>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:228 #, no-wrap msgid "B<-b>, B<--begin-session>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:234 #, no-wrap msgid "B<--recover-session>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:240 #, no-wrap msgid "B<-r>, B<--run-session>" msgstr "" #. type: Plain text #: man/schroot.1.man:244 msgid "" "Run an existing session. The session ID is specified with the I<--chroot> " "option." msgstr "" #. type: TP #: man/schroot.1.man:244 #, no-wrap msgid "B<-e>, B<--end-session>" msgstr "" #. type: Plain text #: man/schroot.1.man:248 msgid "" "End an existing session. The session ID is specified with the I<--chroot> " "option." msgstr "" #. type: SS #: man/schroot.1.man:248 #, no-wrap msgid "Session options" msgstr "" #. type: TP #: man/schroot.1.man:249 #, no-wrap msgid "B<-n>, B<--session-name=>I" msgstr "" #. type: Plain text #: man/schroot.1.man:257 msgid "" "Name a session. The specified I 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(5)." msgstr "" #. type: TP #: man/schroot.1.man:257 #, no-wrap msgid "B<-f>, B<--force>" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:263 #, no-wrap msgid "Separator" msgstr "" #. type: TP #: man/schroot.1.man:264 #, no-wrap msgid "B<-->" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:268 #, no-wrap msgid "AUTHENTICATION" msgstr "" #. type: Plain text #: man/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 #: man/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 supported " "without PAM)." msgstr "" #. type: Plain text #: man/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), " "but this may be disabled to prevent root from accessing any chroots except " "if specifically permitted. In such a situation, root must be added to the " "allowed users or groups as for any other user or group. If PAM is not " "available, the root user will be permitted to access all chroots, even when " "not explicitly granted access." msgstr "" #. type: SH #: man/schroot.1.man:289 #, no-wrap msgid "CHROOT NAMESPACES" msgstr "" #. type: SS #: man/schroot.1.man:290 #, no-wrap msgid "Namespace basics" msgstr "" #. type: Plain text #: man/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. A namespace is a prefix to a chroot name. " "Currently there are three namespaces: \\[oq]chroot:\\[cq], " "\\[oq]source:\\[cq] and \\[oq]session:\\[cq]. Use I<--list --all> to list " "all available chroots in all namespaces. Because \\[oq]:\\[cq] is used as " "the separator between namespace and chroot names, it is not permitted to use " "this character in chroot names." msgstr "" #. type: Plain text #: man/schroot.1.man: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 #: man/schroot.1.man:305 #, no-wrap msgid "Source chroots" msgstr "" #. type: Plain text #: man/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 to allow easy access to the filesystem used as a source for " "snapshotting. These are regular chroots as well, just with the snapshotting " "disabled. For a chroot named \\[lq]sid-snapshot\\[rq] (i.e. with a fully " "qualified name of \\[lq]chroot:sid-snapshot\\[rq]), there will also be a " "corresponding source chroot named \\[lq]source:sid-snapshot\\[rq]. Earlier " "versions of schroot provided source chroots with a \\[oq]-source\\[cq] " "suffix. These are also provided for compatibility. In this example, this " "would be called \\[lq]chroot:sid-snapshot-source\\[rq]. These compatibility " "names will be dropped in a future version, so programs and scripts should " "switch to using the namespace-qualified names rather than the old suffix." msgstr "" #. type: SS #: man/schroot.1.man:318 #, no-wrap msgid "Session chroots" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:324 #, no-wrap msgid "Actions and default namespaces" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:333 #, no-wrap msgid "PERFORMANCE" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:342 man/dchroot.1.man:153 man/dchroot-dsa.1.man:134 #, no-wrap msgid "DIRECTORY FALLBACKS" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:352 #, no-wrap msgid "Login shell" msgstr "" #. type: tbl table #: man/schroot.1.man:356 man/schroot.1.man:379 man/schroot.1.man:395 man/dchroot.1.man:168 man/dchroot.1.man:186 man/dchroot.1.man:203 man/dchroot-dsa.1.man:149 man/dchroot-dsa.1.man:166 #, no-wrap msgid "Transition\n" msgstr "" #. type: tbl table #: man/schroot.1.man:357 man/schroot.1.man:380 man/schroot.1.man:396 man/dchroot.1.man:169 man/dchroot.1.man:187 man/dchroot.1.man:204 man/dchroot-dsa.1.man:150 man/dchroot-dsa.1.man:167 #, no-wrap msgid "(Host \\[-E] Chroot)\tComment\n" msgstr "" #. type: tbl table #: man/schroot.1.man:358 man/schroot.1.man:381 man/schroot.1.man:397 man/dchroot.1.man:170 man/dchroot.1.man:188 man/dchroot.1.man:205 man/dchroot-dsa.1.man:151 man/dchroot-dsa.1.man:168 #, no-wrap msgid "_\n" msgstr "" #. type: tbl table #: man/schroot.1.man:359 man/schroot.1.man:382 man/dchroot.1.man:189 #, no-wrap msgid "CWD \\[-E] CWD\tT{\n" msgstr "" #. type: tbl table #: man/schroot.1.man:360 man/schroot.1.man:383 #, no-wrap msgid "Normal behaviour (if I<--directory> is not used)\n" msgstr "" #. type: tbl table #: man/schroot.1.man:361 man/schroot.1.man:364 man/schroot.1.man:367 man/schroot.1.man:370 man/schroot.1.man:373 man/schroot.1.man:384 man/schroot.1.man:387 man/dchroot.1.man:174 man/dchroot.1.man:177 man/dchroot.1.man:180 man/dchroot.1.man:191 man/dchroot.1.man:194 man/dchroot.1.man:197 man/dchroot-dsa.1.man:154 man/dchroot-dsa.1.man:157 man/dchroot-dsa.1.man:160 #, no-wrap msgid "T}\n" msgstr "" #. type: tbl table #: man/schroot.1.man:362 #, no-wrap msgid "CWD \\[-E] $HOME\tT{\n" msgstr "" #. type: tbl table #: man/schroot.1.man:363 #, no-wrap msgid "If CWD is nonexistent and --preserve-environment is used\n" msgstr "" #. type: tbl table #: man/schroot.1.man:365 man/dchroot.1.man:171 man/dchroot-dsa.1.man:152 #, no-wrap msgid "CWD \\[-E] passwd pw_dir\tT{\n" msgstr "" #. type: tbl table #: man/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 #: man/schroot.1.man:368 man/dchroot.1.man:175 man/dchroot.1.man:192 man/dchroot-dsa.1.man:155 #, no-wrap msgid "CWD \\[-E] /\tT{\n" msgstr "" #. type: tbl table #: man/schroot.1.man:369 #, no-wrap msgid "None of the above exist\n" msgstr "" #. type: tbl table #: man/schroot.1.man:371 man/schroot.1.man:385 man/dchroot.1.man:178 man/dchroot.1.man:195 man/dchroot-dsa.1.man:158 #, no-wrap msgid "B\tT{\n" msgstr "" #. type: tbl table #: man/schroot.1.man:372 man/dchroot.1.man:179 man/dchroot.1.man:196 man/dchroot-dsa.1.man:159 #, no-wrap msgid "If / is nonexistent\n" msgstr "" #. type: SS #: man/schroot.1.man:375 #, no-wrap msgid "Command" msgstr "" #. type: tbl table #: man/schroot.1.man:386 man/dchroot.1.man:193 #, no-wrap msgid "If CWD is nonexistent\n" msgstr "" #. type: Plain text #: man/schroot.1.man:391 man/schroot.1.man:403 man/dchroot.1.man:211 man/dchroot-dsa.1.man:174 msgid "No fallbacks should exist under any circumstances." msgstr "" #. type: SS #: man/schroot.1.man:391 man/dchroot.1.man:199 man/dchroot-dsa.1.man:162 #, no-wrap msgid "--directory used" msgstr "" #. type: tbl table #: man/schroot.1.man:398 man/dchroot.1.man:206 man/dchroot-dsa.1.man:169 #, no-wrap msgid "CWD \\[-E] DIR\tNormal behaviour\n" msgstr "" #. type: tbl table #: man/schroot.1.man:399 man/dchroot.1.man:207 man/dchroot-dsa.1.man:170 #, no-wrap msgid "B\tIf DIR is nonexistent\n" msgstr "" #. type: SS #: man/schroot.1.man:403 man/dchroot.1.man:211 man/dchroot-dsa.1.man:174 #, no-wrap msgid "Debugging" msgstr "" #. type: Plain text #: man/schroot.1.man:407 man/dchroot.1.man:215 man/dchroot-dsa.1.man:178 msgid "" "Note that I<--debug=notice> will show the internal fallback list computed " "for the session." msgstr "" #. type: SH #: man/schroot.1.man:407 man/dchroot.1.man:215 man/dchroot-dsa.1.man:178 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: SS #: man/schroot.1.man:408 #, no-wrap msgid "List available chroots" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:417 #, no-wrap msgid "Get information about a chroot" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:444 msgid "" "Use I<--all> or I<-c> multiple times to use all or multiple chroots, " "respectively." msgstr "" #. type: SS #: man/schroot.1.man:444 #, no-wrap msgid "Running commands in a chroot" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/schroot.1.man:469 #, no-wrap msgid "Switching users" msgstr "" #. type: Plain text #: man/schroot.1.man:475 #, no-wrap msgid "" "% \\f[CB]schroot -c sid -u root\\fR\\[CR]\n" "Password:\n" "[sid chroot] (rleigh\\[-E]root) Running login shell: " "\\[lq]/bin/bash\\[rq]\n" "# \n" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:481 #, no-wrap msgid "Sessions" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:490 msgid "Let's start by looking at a session-capable chroot:" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:523 msgid "" "Note that the I option is set to \\[oq]true\\[cq]. This is " "a requirement in order to use session management, and is supported by most " "chroot types. Next, we will create a new session:" msgstr "" #. type: Plain text #: man/schroot.1.man: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 #: man/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 #: man/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 #: man/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 #: man/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 #: man/schroot.1.man:580 msgid "Now the session has been created, commands may be run in it:" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/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 #: man/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 #: man/schroot.1.man:608 man/dchroot.1.man:246 man/dchroot-dsa.1.man:199 #, no-wrap msgid "TROUBLESHOOTING" msgstr "" #. type: Plain text #: man/schroot.1.man:615 man/dchroot.1.man:253 man/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 option to turn on debugging " "messages. This gives a great deal more information. Valid debug levels are " "\\[oq]none\\[cq], and \\[oq]notice\\[cq], \\[oq]info\\[cq], " "\\[oq]warning\\[cq] and \\[oq]critical\\[cq] in order of increasing " "severity. The lower the severity level, the more output." msgstr "" #. type: Plain text #: man/schroot.1.man:618 man/dchroot.1.man:256 man/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 #: man/schroot.1.man:620 man/dchroot.1.man:258 man/dchroot-dsa.1.man:211 msgid "\\f[CR]Debian\\ buildd-tools\\ Developers\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:622 man/dchroot.1.man:260 man/dchroot-dsa.1.man:213 msgid "\\f[CR]Ebuildd-tools-devel@lists.alioth.debian.orgE\\fR" msgstr "" #. type: SH #: man/schroot.1.man:622 man/dchroot.1.man:260 man/dchroot-dsa.1.man:213 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: man/schroot.1.man:630 man/dchroot.1.man:268 man/dchroot-dsa.1.man:221 msgid "" "On the B and B architectures, Linux kernels up to and " "including at least version 2.6.17 have broken B(2) support, " "which results in a failure to set the personality. This will be seen as an " "\\[lq]Operation not permitted\\[rq] (EPERM) error. To work around this " "problem, set \\f[CI]personality\\fR to \\[oq]undefined\\[cq], or upgrade to " "a more recent kernel." msgstr "" #. type: SH #: man/schroot.1.man:630 man/schroot-setup.5.man:51 man/schroot-script-config.5.man:34 #, no-wrap msgid "ENVIRONMENT" msgstr "" #. type: Plain text #: man/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 #: man/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(5) for further details." msgstr "" #. type: SH #: man/schroot.1.man:649 man/schroot-setup.5.man:199 man/schroot.conf.5.man:683 man/dchroot.1.man:268 man/dchroot-dsa.1.man:221 #, no-wrap msgid "FILES" msgstr "" #. type: SS #: man/schroot.1.man:650 #, no-wrap msgid "Configuration files" msgstr "" #. type: TP #: man/schroot.1.man:651 man/schroot.conf.5.man:685 man/dchroot.1.man:269 man/dchroot-dsa.1.man:222 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_CONF]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:655 man/schroot.conf.5.man:689 msgid "" "The system-wide chroot definition file. This file must be owned by the root " "user, and not be writable by other." msgstr "" #. type: TP #: man/schroot.1.man:655 man/schroot.conf.5.man:689 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_CONF_CHROOT_D]\\fR" msgstr "" #. type: Plain text #: man/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(8) when run " "with the I<--lsbsysinit> option." msgstr "" #. type: TP #: man/schroot.1.man:663 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:667 msgid "The system-wide chroot setup script directories. See B(5)." msgstr "" #. type: TP #: man/schroot.1.man:667 #, no-wrap msgid "\\f[BI]/etc/pam.d/schroot\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:670 msgid "PAM configuration." msgstr "" #. type: SS #: man/schroot.1.man:670 #, no-wrap msgid "System directories" msgstr "" #. type: TP #: man/schroot.1.man:671 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_LIBEXEC_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:674 msgid "Directory containing helper programs used by setup scripts." msgstr "" #. type: SS #: man/schroot.1.man:674 #, no-wrap msgid "Session directories" msgstr "" #. type: Plain text #: man/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 #: man/schroot.1.man:677 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_SESSION_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:680 msgid "Directory containing the session configuration for each active session." msgstr "" #. type: TP #: man/schroot.1.man:680 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_MOUNT_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:683 msgid "Directory used to mount the filesystems used by each active session." msgstr "" #. type: TP #: man/schroot.1.man:683 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_UNDERLAY_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:686 msgid "Directory used for filesystem union source (underlay)." msgstr "" #. type: TP #: man/schroot.1.man:686 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_OVERLAY_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:689 msgid "Directory used for filesystem union writeable overlay." msgstr "" #. type: TP #: man/schroot.1.man:689 #, no-wrap msgid "\\f[BI]\\*[SCHROOT_FILE_UNPACK_DIR]\\fR" msgstr "" #. type: Plain text #: man/schroot.1.man:692 msgid "Directory used for unpacking file chroots." msgstr "" #. type: SH #: man/schroot.1.man:694 man/schroot-setup.5.man:267 man/schroot.conf.5.man:723 man/schroot-script-config.5.man:73 man/schroot-faq.7.man:256 man/dchroot.1.man:279 man/dchroot-dsa.1.man:234 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man/schroot.1.man:701 msgid "" "B(1), B(1), B(2), B(8), " "B(5), B(7), B(5)." msgstr "" #. type: TH #: man/schroot-setup.5.man:18 #, no-wrap msgid "SCHROOT-SETUP" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:21 msgid "schroot-setup - schroot chroot setup scripts" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:27 msgid "" "B uses scripts to set up and then clean up the chroot environment. " "The directory \\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR contains scripts run when " "a chroot is created and destroyed. Several environment variables are set " "while the scripts are being run, which allows their behaviour to be " "customised, depending upon, for example, the type of chroot in use." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:32 msgid "" "The scripts are run in name order, like those run by B(8), by using " "the same style of execution as B(8)." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:34 msgid "The setup scripts are all invoked with two options:" msgstr "" #. type: IP #: man/schroot-setup.5.man:34 #, no-wrap msgid "1" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:36 msgid "The action to perform." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:41 msgid "" "When a session is first started, the chroot is set up by running the scripts " "in \\*[SCHROOT_CONF_SETUP_D] with the \\[oq]setup-start\\[cq] option. When " "the session is ended, the scripts in I<\\*[SCHROOT_CONF_SETUP_D]> are run in " "reverse order with the \\[oq]setup-stop\\[cq] option." msgstr "" #. type: IP #: man/schroot-setup.5.man:41 #, no-wrap msgid "2" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:43 msgid "The chroot status." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:47 msgid "" "This is either \\[oq]ok\\[cq] if there are no problems, or \\[oq]fail\\[cq] " "if something went wrong. For example, particular actions may be skipped on " "failure." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:51 msgid "" "Note that the scripts should be I. They B be idempotent " "during the \\[oq]setup-stop\\[cq] phase, because they may be run more than " "once, for example on failure." msgstr "" #. type: SS #: man/schroot-setup.5.man:52 #, no-wrap msgid "General variables" msgstr "" #. type: TP #: man/schroot-setup.5.man:53 #, no-wrap msgid "AUTH_USER" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:56 msgid "The username of the user the command in the chroot will run as." msgstr "" #. type: TP #: man/schroot-setup.5.man:56 man/schroot-setup.5.man:111 #, no-wrap msgid "CHROOT_NAME" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:60 msgid "" "The chroot name. Note that this is the name of the orignal chroot before " "session creation; you probably want SESSION_ID." msgstr "" #. type: TP #: man/schroot-setup.5.man:60 #, no-wrap msgid "HOST" msgstr "" #. type: TP #: man/schroot-setup.5.man:62 #, no-wrap msgid "HOST_OS" msgstr "" #. type: TP #: man/schroot-setup.5.man:64 #, no-wrap msgid "HOST_VENDOR" msgstr "" #. type: TP #: man/schroot-setup.5.man:66 #, no-wrap msgid "HOST_CPU" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:72 msgid "" "The host system architecture schroot is running upon. This may be used to " "introduce architecture-specific behaviour into the setup scripts where " "required. HOST is the GNU triplet for the architecture, while HOST_OS, " "HOST_VENDOR and HOST_CPU are the component parts of the triplet." msgstr "" #. type: TP #: man/schroot-setup.5.man:72 #, no-wrap msgid "LIBEXEC_DIR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:75 msgid "The directory under which helper programs are located." msgstr "" #. type: TP #: man/schroot-setup.5.man:75 #, no-wrap msgid "MOUNT_DIR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:79 msgid "" "The directory under which non-filesystem chroots are mounted (e.g. block " "devices and LVM snapshots)." msgstr "" #. type: TP #: man/schroot-setup.5.man:79 #, no-wrap msgid "PID" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:82 msgid "The process ID of the schroot process." msgstr "" #. type: TP #: man/schroot-setup.5.man:82 #, no-wrap msgid "PLATFORM" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:89 msgid "" "The operating system platform schroot is running upon. This may be used to " "introduce platform-specific behaviour into the setup scripts where " "required. Note that the HOST variables are probably what are required. In " "the context of schroot, the platform is the supported configuration and " "behaviour for a given architecture, and may be identical between different " "architectures." msgstr "" #. type: TP #: man/schroot-setup.5.man:89 #, no-wrap msgid "SESSION_ID" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:92 msgid "The session identifier." msgstr "" #. type: TP #: man/schroot-setup.5.man:92 #, no-wrap msgid "VERBOSE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:98 msgid "" "Set to \\[oq]quiet\\[cq] if only error messages should be printed, " "\\[oq]normal\\[cq] if other messages may be printed as well, and " "\\[oq]verbose\\[cq] if all messages may be printed. Previously called " "AUTH_VERBOSITY." msgstr "" #. type: TP #: man/schroot-setup.5.man:98 #, no-wrap msgid "CHROOT_SESSION_CREATE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:101 msgid "" "Set to \\[oq]true\\[cq] if a session will be created, otherwise " "\\[oq]false\\[cq]." msgstr "" #. type: TP #: man/schroot-setup.5.man:101 #, no-wrap msgid "CHROOT_SESSION_CLONE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:104 msgid "" "Set to \\[oq]true\\[cq] if a session will be cloned, otherwise " "\\[oq]false\\[cq]." msgstr "" #. type: TP #: man/schroot-setup.5.man:104 #, no-wrap msgid "CHROOT_SESSION_PURGE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:107 msgid "" "Set to \\[oq]true\\[cq] if a session will be purged, otherwise " "\\[oq]false\\[cq]." msgstr "" #. type: TP #: man/schroot-setup.5.man:107 #, no-wrap msgid "CHROOT_TYPE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:111 msgid "" "The type of the chroot. This is useful for restricting a setup task to " "particular types of chroot (e.g. only block devices or LVM snapshots)." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:115 msgid "" "The name of the chroot. This is useful for restricting a setup task to a " "particular chroot, or set of chroots." msgstr "" #. type: TP #: man/schroot-setup.5.man:115 #, no-wrap msgid "CHROOT_ALIAS" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:122 msgid "" "The name of the alias used to select the chroot. This is useful for " "specialising a setup task based upon one of its alternative alias names, or " "the default chroot name. For example, it could be used to specify " "additional sources in I, such as a stable-security " "alias for a stable chroot, or an experimental alias for an unstable chroot." msgstr "" #. type: TP #: man/schroot-setup.5.man:122 #, no-wrap msgid "CHROOT_DESCRIPTION" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:125 msgid "The description of the chroot." msgstr "" #. type: TP #: man/schroot-setup.5.man:125 #, no-wrap msgid "CHROOT_MOUNT_LOCATION" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:129 msgid "" "The location to mount the chroot. It is used for mount point creation and " "mounting." msgstr "" #. type: TP #: man/schroot-setup.5.man:129 man/schroot-setup.5.man:159 #, no-wrap msgid "CHROOT_LOCATION" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:133 msgid "" "The location of the chroot inside the mount point. This is to allow " "multiple chroots on a single filesystem. Set for all mountable chroot " "types." msgstr "" #. type: TP #: man/schroot-setup.5.man:133 #, no-wrap msgid "CHROOT_PATH" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:138 msgid "" "The absolute path to the chroot. This is typically CHROOT_MOUNT_LOCATION " "and CHROOT_LOCATION concatenated together. This is the path which should be " "used to access the chroots." msgstr "" #. type: SS #: man/schroot-setup.5.man:138 #, no-wrap msgid "Plain and directory chroot variables" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:140 msgid "These chroot types use only general variables." msgstr "" #. type: SS #: man/schroot-setup.5.man:140 #, no-wrap msgid "File variables" msgstr "" #. type: TP #: man/schroot-setup.5.man:141 #, no-wrap msgid "CHROOT_FILE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:144 msgid "The file containing the chroot files." msgstr "" #. type: TP #: man/schroot-setup.5.man:144 #, no-wrap msgid "CHROOT_FILE_REPACK" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:148 msgid "" "Set to \\[oq]true\\[cq] to repack the chroot into an archive file on ending " "a session, otherwise \\[oq]false\\[cq]." msgstr "" #. type: SS #: man/schroot-setup.5.man:148 #, no-wrap msgid "Mountable chroot variables" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:151 msgid "These variables are only set for directly mountable chroot types." msgstr "" #. type: TP #: man/schroot-setup.5.man:151 #, no-wrap msgid "CHROOT_MOUNT_DEVICE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:155 msgid "The device to mount containing the chroot. mounting." msgstr "" #. type: TP #: man/schroot-setup.5.man:155 #, no-wrap msgid "CHROOT_MOUNT_OPTIONS" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:159 msgid "Options to pass to B(8)." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:163 msgid "" "The location of the chroot inside the mount point. This allows the " "existence of multiple chroots on a single filesystem." msgstr "" #. type: SS #: man/schroot-setup.5.man:163 #, no-wrap msgid "Filesystem union variables" msgstr "" #. type: TP #: man/schroot-setup.5.man:164 #, no-wrap msgid "CHROOT_UNION_TYPE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:167 msgid "Union filesystem type." msgstr "" #. type: TP #: man/schroot-setup.5.man:167 #, no-wrap msgid "CHROOT_UNION_MOUNT_OPTIONS" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:170 msgid "Union filesystem mount options." msgstr "" #. type: TP #: man/schroot-setup.5.man:170 #, no-wrap msgid "CHROOT_UNION_OVERLAY_DIRECTORY" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:173 msgid "Union filesystem overlay directory (writable)." msgstr "" #. type: TP #: man/schroot-setup.5.man:173 #, no-wrap msgid "CHROOT_UNION_UNDERLAY_DIRECTORY" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:176 msgid "Union filesystem underlay directory (read-only)." msgstr "" #. type: SS #: man/schroot-setup.5.man:176 #, no-wrap msgid "Block device variables" msgstr "" #. type: TP #: man/schroot-setup.5.man:177 #, no-wrap msgid "CHROOT_DEVICE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:182 msgid "" "The device containing the chroot root filesystem. This is usually, but not " "necessarily, the device which will be mounted. For example, an LVM snapshot " "this will be the original logical volume." msgstr "" #. type: SS #: man/schroot-setup.5.man:182 #, no-wrap msgid "LVM snapshot variables" msgstr "" #. type: TP #: man/schroot-setup.5.man:183 #, no-wrap msgid "CHROOT_LVM_SNAPSHOT_NAME" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:187 msgid "Snapshot name to pass to B(8)." msgstr "" #. type: TP #: man/schroot-setup.5.man:187 #, no-wrap msgid "CHROOT_LVM_SNAPSHOT_DEVICE" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:190 msgid "The name of the LVM snapshot device." msgstr "" #. type: TP #: man/schroot-setup.5.man:190 #, no-wrap msgid "CHROOT_LVM_SNAPSHOT_OPTIONS" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:194 msgid "Options to pass to B(8)." msgstr "" #. type: SS #: man/schroot-setup.5.man:194 #, no-wrap msgid "Custom variables" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:199 msgid "" "Custom keys set in I will be uppercased and set in the " "environment as described in B(5)." msgstr "" #. type: SS #: man/schroot-setup.5.man:200 man/schroot.conf.5.man:694 #, no-wrap msgid "Setup script configuration" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:203 man/schroot.conf.5.man:697 msgid "" "The directory \\f[BI]\\*[SCHROOT_SYSCONF_DIR]/default\\fR contains the " "default settings used by setup scripts." msgstr "" #. type: TP #: man/schroot-setup.5.man:203 man/schroot.conf.5.man:697 #, no-wrap msgid "\\f[BI]config\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:211 man/schroot.conf.5.man:705 msgid "" "Main configuration file read by setup scripts. The format of this file is " "described in B(5). This is the default value for the " "\\f[CI]script-config\\fR key. Note that this was formerly named " "I<\\*[SCHROOT_SYSCONF_DIR]/script-defaults>. The following files are " "referenced by default:" msgstr "" #. type: TP #: man/schroot-setup.5.man:211 man/schroot.conf.5.man:705 #, no-wrap msgid "\\f[BI]copyfiles\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:215 man/schroot.conf.5.man:709 msgid "" "A list of files to copy into the chroot from the host system. Note that " "this was formerly named I<\\*[SCHROOT_SYSCONF_DIR]/copyfiles-defaults>." msgstr "" #. type: TP #: man/schroot-setup.5.man:215 man/schroot.conf.5.man:709 #, no-wrap msgid "\\f[BI]fstab\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:222 man/schroot.conf.5.man:716 msgid "" "A file in the format decribed in B(5), used to mount filesystems " "inside the chroot. The mount location is relative to the root of the " "chroot. Note that this was formerly named " "I<\\*[SCHROOT_SYSCONF_DIR]/mount-defaults>." msgstr "" #. type: TP #: man/schroot-setup.5.man:222 man/schroot.conf.5.man:716 #, no-wrap msgid "\\f[BI]nssdatabases\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:227 man/schroot.conf.5.man:721 msgid "" "System databases (as described in I on GNU/Linux " "systems) to copy into the chroot from the host. Note that this was formerly " "named I<\\*[SCHROOT_SYSCONF_DIR]/nssdatabases-defaults>." msgstr "" #. type: SS #: man/schroot-setup.5.man:227 #, no-wrap msgid "Setup scripts" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:229 msgid "" "The directory \\f[BI]\\*[SCHROOT_CONF_SETUP_D]\\fR contains the chroot setup " "scripts." msgstr "" #. type: TP #: man/schroot-setup.5.man:229 #, no-wrap msgid "\\f[BI]00check\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:232 msgid "Print debugging diagnostics and perform basic sanity checking." msgstr "" #. type: TP #: man/schroot-setup.5.man:232 #, no-wrap msgid "\\f[BI]05file\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:235 msgid "Unpack, clean up, and repack file-based chroots." msgstr "" #. type: TP #: man/schroot-setup.5.man:235 #, no-wrap msgid "\\f[BI]05fsunion\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:238 msgid "Create and remove union filesystems." msgstr "" #. type: TP #: man/schroot-setup.5.man:238 #, no-wrap msgid "\\f[BI]05lvm\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:241 msgid "Create and remove LVM snapshots." msgstr "" #. type: TP #: man/schroot-setup.5.man:241 #, no-wrap msgid "\\f[BI]10mount\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:244 msgid "Mount and unmount filesystems." msgstr "" #. type: TP #: man/schroot-setup.5.man:244 #, no-wrap msgid "\\f[BI]15binfmt\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:249 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 #: man/schroot-setup.5.man:249 #, no-wrap msgid "\\f[BI]15killprocs\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:253 msgid "" "Kill processes still running inside the chroot when ending a session, which " "would prevent unmounting of filesystems and cleanup of any other resources." msgstr "" #. type: TP #: man/schroot-setup.5.man:253 #, no-wrap msgid "\\f[BI]20copyfiles\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:257 msgid "" "Copy files from the host system into the chroot. Configure networking by " "copying I and I, for example." msgstr "" #. type: TP #: man/schroot-setup.5.man:257 #, no-wrap msgid "\\f[BI]20nssdatabases\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:261 msgid "" "Configure system databases by copying passwd, shadow, group etc. into the " "chroot." msgstr "" #. type: TP #: man/schroot-setup.5.man:261 #, no-wrap msgid "\\f[BI]50chrootname\\fR" msgstr "" #. type: Plain text #: man/schroot-setup.5.man:265 msgid "" "Set the chroot name (I) in the chroot. This may be used " "by the shell prompt to display the current chroot." msgstr "" #. type: Plain text #: man/schroot-setup.5.man:272 msgid "" "B(1), B(5), B(5), B(5), " "B(8)." msgstr "" #. type: TH #: man/schroot.conf.5.man:18 #, no-wrap msgid "SCHROOT.CONF" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:21 msgid "schroot.conf - chroot definition file for schroot" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:24 msgid "" "\\f[BI]schroot.conf\\fR is a plain UTF-8 text file, describing the chroots " "available for use with schroot." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:28 msgid "" "Comments are introduced following a \\[oq]\\f[CR]\\[sh]\\fR\\[cq] " "(\\[lq]hash\\[rq]) character at the beginning of a line, or following any " "other text. All text right of the \\[oq]\\f[CR]\\[sh]\\fR\\[cq] is treated " "as a comment." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:31 msgid "" "The configuration format is an INI-style format, split into groups of " "key-value pairs separated by section names in square brackets." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:35 msgid "" "A chroot is defined as a group of key-value pairs, which is started by a " "name in square brackets on a line by itself. The file may contain multiple " "groups which therefore define multiple chroots." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:38 msgid "" "A chroot definition is started by the name of the chroot in square " "brackets. For example," msgstr "" #. type: Plain text #: man/schroot.conf.5.man:40 msgid "\\f[CR]\\[lB]sid\\[rB]\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:43 msgid "" "The name is subject to certain naming restrictions. For further details, " "see the section \\[lq]I\\[rq] below." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:45 msgid "This is then followed by several key-value pairs, one per line:" msgstr "" #. type: TP #: man/schroot.conf.5.man:45 #, no-wrap msgid "\\f[CBI]type=\\f[CI]type\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:53 msgid "" "The type of the chroot. Valid types are \\[oq]plain\\[cq], " "\\[oq]directory\\[cq], \\[oq]file\\[cq], \\[oq]loopback\\[cq], " "\\[oq]block-device\\[cq], \\[oq]btrfs-snapshot\\[cq] and " "\\[oq]lvm-snapshot\\[cq]. If empty or omitted, the default type is " "\\[oq]plain\\[cq]. Note that \\[oq]plain\\[cq] chroots do not run setup " "scripts and mount filesystems; \\[oq]directory\\[cq] is recommended for " "normal use (see \\[lq]I\\[rq], below)." msgstr "" #. type: TP #: man/schroot.conf.5.man:53 #, no-wrap msgid "\\f[CBI]description=\\f[CI]description\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:57 msgid "" "A short description of the chroot. This may be localised for different " "languages; see the section \\[lq]I\\[rq] below." msgstr "" #. type: TP #: man/schroot.conf.5.man:57 #, no-wrap msgid "\\f[CBI]priority=\\f[CI]number\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:67 msgid "" "Set the priority of a chroot. \\f[CI]number\\fR is a positive integer " "indicating whether a distribution is older than another. For example, " "\\[lq]oldstable\\[rq] and \\[lq]oldstable-security\\[rq] might be " "\\[oq]0\\[cq], while \\[lq]stable\\[rq] and \\[lq]stable-security\\[rq] are " "\\[oq]1\\[cq], \\[lq]testing\\[rq] is \\[oq]2\\[cq] and \\[lq]unstable\\[rq] " "is \\[oq]3\\[cq]. The values are not important, but the difference between " "them is. This option is deprecated and no longer used by schroot, but is " "still permitted to be used; it will be obsoleted and removed in a future " "release." msgstr "" #. type: TP #: man/schroot.conf.5.man:67 #, no-wrap msgid "\\f[CBI]message-verbosity=\\f[CI]verbosity\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:74 msgid "" "Set the verbosity of messages printed by schroot when setting up, running " "commands and cleaning up the chroot. Valid settings are \\[oq]quiet\\[cq] " "(suppress most messages), \\[oq]normal\\[cq] (the default) and " "\\[oq]verbose\\[cq] (show all messages). This setting is overridden by the " "options I<--quiet> and I<--verbose>." msgstr "" #. type: TP #: man/schroot.conf.5.man:74 #, no-wrap msgid "\\f[CBI]users=\\f[CI]user1,user2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:79 msgid "" "A comma-separated list of users which are allowed access to the chroot. If " "empty or omitted, no users will be allowed access (unless a group they " "belong to is also specified in \\f[CI]groups\\fR)." msgstr "" #. type: TP #: man/schroot.conf.5.man:79 #, no-wrap msgid "\\f[CBI]groups=\\f[CI]group1,group2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:83 msgid "" "A comma-separated list of groups which are allowed access to the chroot. If " "empty or omitted, no groups of users will be allowed access." msgstr "" #. type: TP #: man/schroot.conf.5.man:83 #, no-wrap msgid "\\f[CBI]root-users=\\f[CI]user1,user2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:90 msgid "" "A comma-separated list of users which are allowed B 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\\[rq] below." msgstr "" #. type: TP #: man/schroot.conf.5.man:90 #, no-wrap msgid "\\f[CBI]root-groups=\\f[CI]group1,group2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:97 msgid "" "A comma-separated list of groups which are allowed B 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\\[rq] below." msgstr "" #. type: TP #: man/schroot.conf.5.man:97 #, no-wrap msgid "\\f[CBI]aliases=\\f[CI]alias1,alias2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:103 msgid "" "A comma-separated list of aliases (alternate names) for this chroot. For " "example, a chroot named \\[lq]sid\\[rq] might have an \\[oq]unstable\\[cq] " "alias for convenience. Aliases are subject to the same naming restrictions " "as the chroot name itself." msgstr "" #. type: TP #: man/schroot.conf.5.man:103 #, no-wrap msgid "\\f[CBI]profile=\\f[CI]directory\\fR" msgstr "" #. type: TP #: man/schroot.conf.5.man:105 #, no-wrap msgid "\\f[CBI]script-config=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/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 #: man/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\\[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 #: man/schroot.conf.5.man:139 msgid "" "Desktop users should note that the fstab file I 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 #: man/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 #: man/schroot.conf.5.man:146 msgid "" "Note that the different profiles have different security implications; see " "the section \\[lq]I\\[rq] below for further details." msgstr "" #. type: TP #: man/schroot.conf.5.man:146 #, no-wrap msgid "\\f[CBI]setup.config=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:163 msgid "" "All the default settings in this file are now settable using configuration " "keys in I, as detailed below. Existing configuration should " "be modified to use these keys in place of this file. See " "B(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 #: man/schroot.conf.5.man:163 #, no-wrap msgid "\\f[CBI]setup.copyfiles=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:167 #, no-wrap msgid "\\f[CBI]setup.fstab=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/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, " "documented in B(5). The only difference is that the mountpoint path " "I 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 #: man/schroot.conf.5.man:177 #, no-wrap msgid "\\f[CBI]setup.nssdatabases=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/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(1) so all " "database sources listed in I will be used for each " "database." msgstr "" #. type: TP #: man/schroot.conf.5.man:187 #, no-wrap msgid "\\f[CBI]setup.services=\\f[CI]service1,service2,...\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:191 #, no-wrap msgid "\\f[CBI]command-prefix=\\f[CI]command,option1,option2,...\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:200 #, no-wrap msgid "\\f[CBI]personality=\\f[CI]persona\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:214 #, no-wrap msgid "\\f[CBI]preserve-environment=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/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 #: man/schroot.conf.5.man:221 #, no-wrap msgid "\\f[CBI]shell=\\f[CI]shell\\fR" msgstr "" #. type: Plain text #: man/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 " "and finally I. This setting overrides this list, and will use the " "shell specified. It may be overridden using the I<--shell> option." msgstr "" #. type: TP #: man/schroot.conf.5.man:229 #, no-wrap msgid "\\f[CBI]environment-filter=\\f[CI]regex\\fR" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/schroot.conf.5.man:241 #, no-wrap msgid "Plain and directory chroots" msgstr "" #. type: Plain text #: man/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 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 options (see \\[lq]I\\[rq], " "below)." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:252 msgid "These chroot types have an additional (mandatory) configuration option:" msgstr "" #. type: TP #: man/schroot.conf.5.man:252 #, no-wrap msgid "\\f[CBI]directory=\\f[CI]directory\\fR" msgstr "" #. type: Plain text #: man/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(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 file just like in I on the host)." msgstr "" #. type: SS #: man/schroot.conf.5.man:264 #, no-wrap msgid "File chroots" msgstr "" #. type: Plain text #: man/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 options (see \\[lq]I\\[rq], below). Note " "that a corresponding source chroot (of type \\[oq]file\\[cq]) will be " "created for each chroot of this type; this is for convenient access to the " "source archive, e.g. for the purpose of updating. These additional options " "are also implemented:" msgstr "" #. type: TP #: man/schroot.conf.5.man:271 man/schroot.conf.5.man:294 #, no-wrap msgid "\\f[CBI]file=\\f[CI]filename\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:280 msgid "" "The file containing the archived chroot environment (mandatory). This must " "be a tar (tape archive), optionally compressed with gzip or bzip2. The file " "extensions used to determine the type are are I<.tar>, I<.tar.gz>, " "I<.tar.bz2>, I<.tgz>, and I<.tbz>. This file must be owned by the root " "user, and not be writable by other. Note that zip archives are no longer " "supported; zip was not able to archive named pipes and device nodes, so was " "not suitable for archiving chroots." msgstr "" #. type: TP #: man/schroot.conf.5.man:280 man/schroot.conf.5.man:427 #, no-wrap msgid "\\f[CBI]location=\\f[CI]path\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:287 msgid "" "This is the path to the chroot I the archive. For example, if the " "archive contains a chroot in I, you would specify " "\\[lq]/squeeze\\[rq] here. If the chroot is the only thing in the archive, " "i.e. I is the root filesystem for the chroot, this option should be left " "blank, or omitted entirely." msgstr "" #. type: SS #: man/schroot.conf.5.man:287 #, no-wrap msgid "Loopback chroots" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:294 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 and " "B options (see \\[lq]I\\[rq] and \\[lq]I\\[rq], below), " "plus an additional option:" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:298 msgid "" "This is the filename of the file containing the filesystem, including the " "absolute path. For example \\[lq]/srv/chroot/sid\\[rq]." msgstr "" #. type: SS #: man/schroot.conf.5.man:298 #, no-wrap msgid "Block device chroots" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:305 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 and " "B options (see \\[lq]I\\[rq] and \\[lq]I\\[rq], below), " "plus an additional option:" msgstr "" #. type: TP #: man/schroot.conf.5.man:305 #, no-wrap msgid "\\f[CBI]device=\\f[CI]device\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:309 msgid "" "This is the device name of the block device, including the absolute path. " "For example, \\[lq]/dev/sda5\\[rq]." msgstr "" #. type: SS #: man/schroot.conf.5.man:309 #, no-wrap msgid "Btrfs snapshot chroots" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:319 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 options (see \\[lq]I\\[rq], below). " "Note that a corresponding source chroot (of type \\[oq]directory\\[cq]) will " "be created for each chroot of this type; this is for convenient access to " "the source volume. These additional options are also implemented:" msgstr "" #. type: TP #: man/schroot.conf.5.man:319 #, no-wrap msgid "\\f[CBI]btrfs-source-subvolume=\\f[CI]directory\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:322 msgid "The directory containing the source subvolume." msgstr "" #. type: TP #: man/schroot.conf.5.man:322 #, no-wrap msgid "\\f[CBI]btrfs-snapshot-directory=\\f[CI]directory\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:325 msgid "The directory in which to store the snapshots of the above source subvolume." msgstr "" #. type: SS #: man/schroot.conf.5.man:325 #, no-wrap msgid "LVM snapshot chroots" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:330 msgid "" "Chroots of type \\[oq]lvm-snapshot\\[cq] are a filesystem available on an " "LVM logical volume (LV). A snapshot LV will be created from this LV on " "demand, and then the snapshot will be mounted. At the end of the session, " "the snapshot LV will be unmounted and removed." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:337 msgid "" "LVM snapshot chroots implement the B options (see " "\\[lq]I\\[rq], below), and all the options for " "\\[oq]block-device\\[cq]. Note that a corresponding source chroot (of type " "\\[oq]block-device\\[cq]) will be created for each chroot of this type; this " "is for convenient access to the source device. This additional option is " "also implemented:" msgstr "" #. type: TP #: man/schroot.conf.5.man:337 #, no-wrap msgid "\\f[CBI]lvm-snapshot-options=\\f[CI]snapshot_options\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:344 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 the " "LV name (I<-n>), the snapshot option (I<-s>) and the original LV path may " "not be specfied here; they are set automatically by schroot." msgstr "" #. type: SS #: man/schroot.conf.5.man:344 #, no-wrap msgid "Custom chroots" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:354 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 #: man/schroot.conf.5.man:354 #, no-wrap msgid "\\f[CBI]custom-session-cloneable=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:358 msgid "" "Set whether or not sessions may be cloned using this chroot (enabled by " "default)." msgstr "" #. type: TP #: man/schroot.conf.5.man:358 #, no-wrap msgid "\\f[CBI]custom-session-purgeable=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:362 msgid "" "Set whether or not sessions may be cloned using this chroot (disabled by " "default)." msgstr "" #. type: TP #: man/schroot.conf.5.man:362 #, no-wrap msgid "\\f[CBI]custom-source-cloneable=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:366 msgid "" "Set whether or not source chroots may be cloned using this chroot (disabled " "by default)." msgstr "" #. type: SS #: man/schroot.conf.5.man:366 #, no-wrap msgid "Source chroot options" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:384 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\\[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 namespace, to allow convenient access to the " "original (non-snapshotted) data, and to aid in chroot maintenance. I.e. for " "a chroot named I (I), a corresponding " "I 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 using the above example). Note that these " "compatibility names will be removed in schroot 1.5.0, so the use of the " "I namespace is preferred over the use of the I<-source> suffix " "form. See B(1) for further details." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:386 msgid "These chroots provide the following additional options:" msgstr "" #. type: TP #: man/schroot.conf.5.man:386 #, no-wrap msgid "\\f[CBI]source-clone=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:392 msgid "" "Set whether the source chroot should be automatically cloned (created) for " "this chroot. The default is \\f[CI]true\\fR to automatically clone, but if " "desired may be disabled by setting to \\f[CI]false\\fR. If disabled, the " "source chroot will be inaccessible." msgstr "" #. type: TP #: man/schroot.conf.5.man:392 #, no-wrap msgid "\\f[CBI]source-users=\\f[CI]user1,user2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:397 msgid "" "A comma-separated list of users which are allowed access to the source " "chroot. If empty or omitted, no users will be allowed access. This will " "become the \\f[CI]users\\fR option in the source chroot." msgstr "" #. type: TP #: man/schroot.conf.5.man:397 #, no-wrap msgid "\\f[CBI]source-groups=\\f[CI]group1,group2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:402 msgid "" "A comma-separated list of groups which are allowed access to the source " "chroot. If empty or omitted, no users will be allowed access. This will " "become the \\f[CI]groups\\fR option in the source chroot." msgstr "" #. type: TP #: man/schroot.conf.5.man:402 #, no-wrap msgid "\\f[CBI]source-root-users=\\f[CI]user1,user2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:409 msgid "" "A comma-separated list of users which are allowed B 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\\[rq] below." msgstr "" #. type: TP #: man/schroot.conf.5.man:409 #, no-wrap msgid "\\f[CBI]source-root-groups=\\f[CI]group1,group2,...\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:417 msgid "" "A comma-separated list of groups which are allowed B 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\\[rq] below." msgstr "" #. type: SS #: man/schroot.conf.5.man:417 #, no-wrap msgid "Mountable chroot options" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:422 msgid "" "The \\[oq]block-device\\[cq], \\[oq]loopback\\[cq] and " "\\[oq]lvm-snapshot\\[cq] chroot types implement device mounting. These are " "chroots which require the mounting of a device in order to access the " "chroot. These chroots provide the following additional options:" msgstr "" #. type: TP #: man/schroot.conf.5.man:422 #, no-wrap msgid "\\f[CBI]mount-options=\\f[CI]options\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:427 msgid "" "Mount options for the block device. These are additional options to pass to " "B(8). For example, \\[lq]-o atime,sync,user_xattr\\[rq]." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:434 msgid "" "This is the path to the chroot I the filesystem on the device. For " "example, if the filesystem contains a chroot in I, you would " "specify \\[lq]/chroot/sid\\[rq] here. If the chroot is the only thing on " "the filesystem, i.e. I is the root filesystem for the chroot, this option " "should be left blank, or omitted entirely." msgstr "" #. type: SS #: man/schroot.conf.5.man:434 #, no-wrap msgid "Filesystem Union chroot options" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:446 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, " "which will provide additional options (see \\[lq]I\\[rq], above). All entries are optional." msgstr "" #. type: TP #: man/schroot.conf.5.man:446 #, no-wrap msgid "\\f[CBI]union-type=\\f[CI]type\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:451 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 #: man/schroot.conf.5.man:451 #, no-wrap msgid "\\f[CBI]union-mount-options=\\f[CI]options\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:465 msgid "" "Union filesystem mount options (branch configuration), used for mounting the " "union filesystem specified with I. 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 " "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(5) for a complete variable list." msgstr "" #. type: TP #: man/schroot.conf.5.man:465 #, no-wrap msgid "\\f[CBI]union-overlay-directory\\f[CI]=directory\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:469 msgid "" "Specify the directory where the writeable overlay session directories will " "be created. The default is \\[oq]\\*[SCHROOT_OVERLAY_DIR]\\[cq]." msgstr "" #. type: TP #: man/schroot.conf.5.man:469 #, no-wrap msgid "\\f[CBI]union-underlay-directory\\f[CI]=directory\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:473 msgid "" "Specify the directory where the read-only underlying directories will be " "created. The default is \\[oq]\\*[SCHROOT_UNDERLAY_DIR]\\[cq]." msgstr "" #. type: SS #: man/schroot.conf.5.man:473 #, no-wrap msgid "Chroot isolation" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:477 msgid "" "On Linux systems, it is possible to isolate some resources when running a " "command inside the chroot. These include:" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:480 msgid "The network" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:483 msgid "System V semaphore undo lists" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:486 msgid "System V IPC messages, semaphores and shared memory" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:489 msgid "The UTS (uname) namespace" msgstr "" #. type: TP #: man/schroot.conf.5.man:490 #, no-wrap msgid "\\f[CBI]unshare.net=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:495 msgid "" "Unshare networking. Network devices will not be shared with the host. By " "default, only the local loopback interface will be available. A custom " "setup script could make additional adjustments to the networking " "configuration." msgstr "" #. type: TP #: man/schroot.conf.5.man:495 #, no-wrap msgid "\\f[CBI]unshare.sysvipc=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:499 msgid "" "Unshare System V IPC. This creates a new IPC namespace (messages, " "semaphores and shared memory are not shared with the host)." msgstr "" #. type: TP #: man/schroot.conf.5.man:499 #, no-wrap msgid "\\f[CBI]unshare.sysvsem=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:502 msgid "Unshare System V semaphore undo values. This creates a separate undo list." msgstr "" #. type: TP #: man/schroot.conf.5.man:502 #, no-wrap msgid "\\f[CBI]unshare.uts=\\f[CI]true\\fR|\\f[CI]false\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:506 msgid "" "Unshare the UTS namespace. A different hostname and domainname may be " "configured in the chroot, and will not be shared with the host." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:511 msgid "" "Note that to specify this as overrides on the command-line, the key names " "should be added to the \\f[CI]user-modifiable-keys\\fR or " "\\f[CI]rootr-modifiable-keys\\fR keys keys. See the section " "\\[lq]I\\[rq] below." msgstr "" #. type: SS #: man/schroot.conf.5.man:511 #, no-wrap msgid "Customisation" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:520 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 #: man/schroot.conf.5.man:522 msgid "For example:" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:526 #, no-wrap msgid "" "debian.apt-update=true\n" "debian.distribution=unstable\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:530 msgid "would set the following environment:" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:534 #, no-wrap msgid "" "DEBIAN_APT_UPDATE=true\n" "DEBIAN_DISTRIBUTION=unstable\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:539 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 #: man/schroot.conf.5.man:543 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 #: man/schroot.conf.5.man:543 #, no-wrap msgid "\\f[CBI]user-modifiable-keys=\\f[CI]key1,key2,..\\fR" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:546 msgid "Set the keys which users may modify using I<--option>." msgstr "" #. type: TP #: man/schroot.conf.5.man:546 #, no-wrap msgid "\\f[CBI]root-modifiable-keys=\\f[CI]key1,key2,..\\fR Set the keys which the" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:551 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 #: man/schroot.conf.5.man:551 #, no-wrap msgid "Localisation" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:555 msgid "" "Some keys may be localised in multiple languages. This is achieved by " "adding the locale name in square brackets after the key name. For example:" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:558 #, no-wrap msgid "description[en_GB]=\\f[CI]British English translation\\fR\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:562 msgid "This will localise the \\f[CI]description\\fR key for the en_GB locale." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:565 #, no-wrap msgid "description[fr]=\\f[CI]French translation\\fR\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:569 msgid "This will localise the \\f[CI]description\\fR key for all French locales." msgstr "" #. type: SH #: man/schroot.conf.5.man:569 #, no-wrap msgid "CHROOT NAMES" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:576 msgid "" "A number of characters or words are not permitted in a chroot name, session " "name or configuration filename. The name may not contain a leading period " "(\\[oq].\\[cq]). The characters \\[oq]:\\[cq] (colon), \\[oq],\\[cq] " "(comma) and \\[oq]/\\[cq] (forward slash) are not permitted anywhere in the " "name. The name may also not contain a trailing tilde (\\[oq]~\\[cq]). The " "rationale for these restrictions is given below." msgstr "" #. type: TP #: man/schroot.conf.5.man:576 #, no-wrap msgid "\\[oq]B<.>\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:583 msgid "" "A leading period could be used to create a name with a relative path in it, " "in combination with \\[oq]/\\[cq], and this could allow overwriting of files " "on the host filesystem. Not allowing this character also means hidden files " "cannot be created. It also means some editor backups are automatically " "ignored. Periods are allowed anywhere else in the name." msgstr "" #. type: TP #: man/schroot.conf.5.man:583 #, no-wrap msgid "\\[oq]B<:>\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:589 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(8)." msgstr "" #. type: TP #: man/schroot.conf.5.man:589 #, no-wrap msgid "\\[oq]B\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:593 msgid "" "Names containing this character are not valid filenames. A forward slash " "would potentially allow creation of files in subdirectories." msgstr "" #. type: TP #: man/schroot.conf.5.man:593 #, no-wrap msgid "\\[oq]B<,>\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:597 msgid "" "Commas are used to separate items in lists. Aliases are separated by commas " "and hence can't contain commas in their name." msgstr "" #. type: TP #: man/schroot.conf.5.man:597 #, no-wrap msgid "\\[oq]B<~>\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:601 msgid "" "Filenames containing trailing tildes are used for editor backup files, which " "are ignored. Tildes are allowed anywhere else in the name." msgstr "" #. type: TP #: man/schroot.conf.5.man:601 #, no-wrap msgid "\\[oq]B\\[cq]" msgstr "" #. type: TQ #: man/schroot.conf.5.man:603 #, no-wrap msgid "\\[oq]B\\[cq]" msgstr "" #. type: TQ #: man/schroot.conf.5.man:605 #, no-wrap msgid "\\[oq]B\\[cq]" msgstr "" #. type: TQ #: man/schroot.conf.5.man:607 #, no-wrap msgid "\\[oq]B\\[cq]" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:611 msgid "" "These names may not appear at the end of a name. These are saved copies of " "conffiles used by the dpkg package manager, and will be ignored." msgstr "" #. type: SH #: man/schroot.conf.5.man:611 #, no-wrap msgid "SECURITY" msgstr "" #. type: SS #: man/schroot.conf.5.man:612 #, no-wrap msgid "Untrusted users" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:618 msgid "" "Note that giving untrusted users root access to chroots is a B! 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." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:621 msgid "" "B B" msgstr "" #. type: SS #: man/schroot.conf.5.man:621 #, no-wrap msgid "Profiles" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:632 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, 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. Check the profile's I file to be " "certain of what will be mounted, and the other profile files to see which " "files and system databases will be copied into the chroot. Choose a " "different profile or edit the files to further restrict what is made " "available inside the chroot." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:638 msgid "" "There is a tradeoff between security (keeping the chroot as minimal as " "possible) and usability (which sometimes requires access to parts of the " "host filesystem). The different profiles make different tradeoffs, and it " "is important that you assess which meets the security/usability tradeoff you " "require." msgstr "" #. type: SH #: man/schroot.conf.5.man:638 #, no-wrap msgid "EXAMPLE" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:641 #, no-wrap msgid "# Sample configuration\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:652 #, no-wrap msgid "" "[sid]\n" "type=plain\n" "description=Debian unstable\n" "description[fr_FR]=Debian instable\n" "directory=/srv/chroot/sid\n" "priority=3\n" "users=jim\n" "groups=sbuild\n" "root-users=rleigh\n" "aliases=unstable,default\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:663 #, no-wrap msgid "" "[etch]\n" "type=block-device\n" "description=Debian testing (32-bit)\n" "priority=2\n" "groups=users\n" "#groups=sbuild-security\n" "aliases=testing\n" "device=/dev/hda_vg/etch_chroot\n" "mount-options=-o atime\n" "personality=linux32\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:670 #, no-wrap msgid "" "[sid-file]\n" "type=file\n" "description=Debian sid file-based chroot\n" "priority=3\n" "groups=sbuild\n" "file=/srv/chroots/sid.tar.gz\n" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:682 #, no-wrap msgid "" "[sid-snapshot]\n" "type=lvm-snapshot\n" "description=Debian unstable LVM snapshot\n" "priority=3\n" "groups=sbuild\n" "users=rleigh\n" "source-root-users=rleigh\n" "source-root-groups=admin\n" "device=/dev/hda_vg/sid_chroot\n" "mount-options=-o atime,sync,user_xattr\n" "lvm-snapshot-options=--size 2G\n" msgstr "" #. type: SS #: man/schroot.conf.5.man:684 #, no-wrap msgid "Chroot definitions" msgstr "" #. type: Plain text #: man/schroot.conf.5.man:694 msgid "" "Additional chroot definitions may be placed in files under this directory. " "They are treated in exactly that same manner as I<\\*[SCHROOT_CONF]>. Each " "file may contain one or more chroot definitions." msgstr "" #. type: Plain text #: man/schroot.conf.5.man:728 msgid "" "B(1), B(1), B(5), B(7), " "B(8)." msgstr "" #. type: TH #: man/schroot-script-config.5.man:18 #, no-wrap msgid "SCHROOT-SCRIPT-CONFIG" msgstr "" #. type: Plain text #: man/schroot-script-config.5.man:21 msgid "schroot-script-config - schroot chroot setup script configuration" msgstr "" #. type: Plain text #: man/schroot-script-config.5.man:29 msgid "" "B uses scripts to set up and then clean up the chroot environment. " "These scripts may be customised using the \\f[CI]script-config\\fR key in " "I<\\*[SCHROOT_CONF]>. This key specifies a file which the setup scripts " "will source when they are run. The file is a Bourne shell script, and in " "consequence may contain any valid shell code, in addition to simple variable " "assignments. This will, for example, allow behaviour to be customised " "according to the specific chroot type or name." msgstr "" #. type: Plain text #: man/schroot-script-config.5.man: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, as detailed below. " "Existing configuration should be modified to use these keys in place of this " "file." msgstr "" #. type: Plain text #: man/schroot-script-config.5.man:37 msgid "" "The environment is the same as for all setup scripts, described in " "B(5)." msgstr "" #. type: SH #: man/schroot-script-config.5.man:37 #, no-wrap msgid "VARIABLES" msgstr "" #. type: Plain text #: man/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 #: man/schroot-script-config.5.man:43 #, no-wrap msgid "SETUP_COPYFILES" msgstr "" #. type: Plain text #: man/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 #: man/schroot-script-config.5.man:48 #, no-wrap msgid "SETUP_FSTAB" msgstr "" #. type: Plain text #: man/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, " "documented in B(5). The only difference is that the mountpoint path " "I 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 #: man/schroot-script-config.5.man:59 #, no-wrap msgid "SETUP_NSSDATABASES" msgstr "" #. type: Plain text #: man/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(1) so all database " "sources listed in I will be used for each database. " "Note that this is settable using the \\f[CI]setup.nssdatabases\\fR key." msgstr "" #. type: Plain text #: man/schroot-script-config.5.man:78 msgid "" "B(1), B(1), B(1), B(5), " "B(5)." msgstr "" #. type: TH #: man/schroot-faq.7.man:18 #, no-wrap msgid "SCHROOT-FAQ" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:21 msgid "schroot - frequently asked questions" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:24 msgid "" "This manual page covers various frequently asked questions about " "configuration and usage of schroot." msgstr "" #. type: SH #: man/schroot-faq.7.man:24 man/dchroot-dsa.1.man:106 #, no-wrap msgid "CONFIGURATION" msgstr "" #. type: SS #: man/schroot-faq.7.man:25 #, no-wrap msgid "Why is schroot overwriting configuration files in the chroot?" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:34 msgid "" "By default, schroot copies over the system NSS databases " "(\\[oq]passwd\\[cq], \\[oq]shadow\\[cq], \\[oq]group\\[cq], " "\\[oq]gshadow\\[cq], \\[oq]services\\[cq], \\[oq]protocols\\[cq], " "\\[oq]networks\\[cq], and \\[oq]hosts\\[cq], etc.) into the chroot. The " "reason for this is that the chroot environment is not a completely separate " "system, and it copying them over keeps them synchronised. However, this is " "not always desirable, particularly if installing a package in the chroot " "creates system users and groups which are not present on the host, since " "these will disappear next time the databases are copied over." msgstr "" #. type: Plain text #: man/schroot-faq.7.man: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. 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 #: man/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 #: man/schroot-faq.7.man:46 #, no-wrap msgid "Should I use the plain or directory chroot type?" msgstr "" #. type: Plain text #: man/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 or B which don't " "do anything other than running a command or shell in a directory. On the " "other hand, directory chroots do run setup scripts, which can mount " "additional filesystems and do other setup tasks." msgstr "" #. type: SH #: man/schroot-faq.7.man:57 #, no-wrap msgid "ADVANCED CONFIGURATION" msgstr "" #. type: SS #: man/schroot-faq.7.man:58 #, no-wrap msgid "What are snapshots and unions?" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:70 msgid "" "Some chroot types support I. This means when you start a session, " "you get a I 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(1) to " "build Debian packages, and this program uses schroot to create a clean build " "environment for each package. Without snapshotting, the chroot would need " "to be reset to its initial state at the end of each build to make it ready " "for the next one, and any debris left over from package removals or earlier " "builds could interfere with the next build." msgstr "" #. type: Plain text #: man/schroot-faq.7.man: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(8) during chroot session setup. However, these use up a lot of " "disk space. A newer method is to use Btrfs snapshots which use up much less " "disk space (chroot type \\[oq]btrfs-snapshot\\[cq]), and may be more " "reliable than LVM snapshots. Btrfs is however still experimental, but it is " "hoped that it will become the recommended method as it matures." msgstr "" #. type: Plain text #: man/schroot-faq.7.man: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 #: man/schroot-faq.7.man:87 #, no-wrap msgid "USAGE" msgstr "" #. type: SS #: man/schroot-faq.7.man:88 #, no-wrap msgid "Can I run a d\\[ae]mons in a chroot?" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/schroot-faq.7.man:108 msgid "" "In consequence, it's not possible to run a d\\[ae]mon I with " "schroot. You can however do it if you create a session with " "I<--begin-session> and then run the d\\[ae]mon with I<--run-session>. It's " "your responsibility to end the session with I<--end-session> when the daemon " "has terminated or you no longer need it." msgstr "" #. type: SS #: man/schroot-faq.7.man:108 #, no-wrap msgid "How do I manually cleaning up a broken session?" msgstr "" #. type: Plain text #: man/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\\[rq] " "section in B(1), any files with the name of the session ID need " "deleting, and any directories with the name of the session ID need umounting " "(if there are any filesystems mounted under it), and then also removing." msgstr "" #. type: Plain text #: man/schroot-faq.7.man:122 msgid "For example, to remove a session named I by hand:" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:124 msgid "Remove the session configuration file" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:126 #, no-wrap msgid "%\\ \\f[CB]rm\\ \\*[SCHROOT_SESSION_DIR]/my-session\\fR\\[CR]\n" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:129 msgid "Check for mounted filesystems" msgstr "" #. type: Plain text #: man/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 #: man/schroot-faq.7.man:135 msgid "Unmount any mounted filesystems" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:137 msgid "Remove I<\\*[SCHROOT_MOUNT_DIR]/my-session>" msgstr "" #. type: Plain text #: man/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 #: man/schroot-faq.7.man:144 msgid "" "B Do not remove any directories without checking if there are any " "filesystems mounted below them, since filesystems such as I could " "still be bind mounted. Doing so could cause irretrievable data loss!" msgstr "" #. type: SH #: man/schroot-faq.7.man:144 #, no-wrap msgid "ADVANCED USAGE" msgstr "" #. type: SS #: man/schroot-faq.7.man:145 #, no-wrap msgid "How do I use sessions?" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:147 msgid "In normal use, running a command might look like this:" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:149 #, no-wrap msgid "%\\ \\f[CB]schroot\\ -c squeeze -- command\\fR\\[CR]\n" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:154 msgid "" "which would run the command I in the I chroot. While it's " "not apparent that a session is being used here, schroot is actually doing " "the following steps:" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:159 msgid "" "Creating a session using the I chroot. This will be automatically " "given a unique name, such as " "I, though you don't usually " "need to know about this" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:161 msgid "Setup scripts are run to create the session chroot and configure it for you" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:163 msgid "The command I is run inside the session chroot" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:165 msgid "Setup scripts are run to clean up the session chroot" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:167 msgid "The session is deleted" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/schroot-faq.7.man:187 msgid "" "This created a new session based upon the I chroot. The unique " "name for the session, the session ID, was printed to standard output, so we " "could also save it as a shell variable at the same time like so:" msgstr "" #. type: Plain text #: man/schroot-faq.7.man: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 #: man/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 #: man/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 #: man/schroot-faq.7.man:201 man/schroot-faq.7.man:220 msgid "or" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:203 #, no-wrap msgid "% \\f[CB]schroot --run-session -c \"$SESSION\" -- command1\\fR\\[CR]\n" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:206 msgid "and then as many more commands as we like" msgstr "" #. type: Plain text #: man/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 #: man/schroot-faq.7.man:213 msgid "etc." msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/schroot-faq.7.man:222 #, no-wrap msgid "% \\f[CB]schroot --end-session -c \"$SESSION\"\\fR\\[CR]\n" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/schroot-faq.7.man:231 #, no-wrap msgid "CONTRIBUTING" msgstr "" #. type: SS #: man/schroot-faq.7.man:232 #, no-wrap msgid "Getting help and getting involved" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:239 msgid "" "The mailing list " "\\f[CR]Ebuildd-tools-devel@lists.alioth.debian.orgE\\fR is used for " "both user support and development discussion. The list may be subscribed to " "from the project website at " "\\f[CR]https://alioth.debian.org/projects/buildd-tools/\\fR or the Mailman " "list interface at " "\\f[CR]http://lists.alioth.debian.org/mailman/listinfo/buildd-tools-devel\\fR." msgstr "" #. type: SS #: man/schroot-faq.7.man:239 #, no-wrap msgid "Reporting bugs" msgstr "" #. type: Plain text #: man/schroot-faq.7.man:244 msgid "" "On Debian systems, bugs may be reported using the B(1) tool, or " "alternatively by mailing \\f[CR]Esubmit@bugs.debian.orgE\\fR (see " "\\f[CR]http://bugs.debian.org\\fR for details on how to do that)." msgstr "" #. type: SS #: man/schroot-faq.7.man:244 #, no-wrap msgid "Getting the latest sources" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/schroot-faq.7.man:261 msgid "" "B(1), B(1), B(1), B(5), " "B(5)." msgstr "" #. type: ds PROGRAM #: man/dchroot.1.man:19 #, no-wrap msgid "dchroot" msgstr "" #. type: TH #: man/dchroot.1.man:20 #, no-wrap msgid "DCHROOT" msgstr "" #. type: Plain text #: man/dchroot.1.man:23 msgid "dchroot - enter a chroot environment" msgstr "" #. type: Plain text #: man/dchroot.1.man:34 msgid "" "B [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] " "[B<-d>\\[or]B<--preserve-environment>] [B<-q>\\[or]B<--quiet> \\[or] " "B<-v>\\[or]B<--verbose>] [B<-c >I\\[or]B<--chroot=>I \\[or] " "B<--all>] [B [ B [ B [ B]]]]" msgstr "" #. type: Plain text #: man/dchroot.1.man:38 msgid "" "B allows the user to run a command or a login shell in a chroot " "environment. If no command is specified, a login shell will be started in " "the user's home directory inside the chroot." msgstr "" #. type: Plain text #: man/dchroot.1.man:45 msgid "" "The command is one or more arguments which will be run in the user's default " "shell using its I<-c> option. As a result, shell code may be embedded in " "this argument. If multiple command options are used, they are concatenated " "together, separated by spaces. Users should be aware of the shell quoting " "issues this presents, and should use B if necessary, which does not " "have any quoting issues." msgstr "" #. type: Plain text #: man/dchroot.1.man:55 msgid "" "This version of dchroot is a compatibility wrapper around the B(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\\[rq] below for known incompatibilities " "with older versions of dchroot." msgstr "" #. type: Plain text #: man/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 #: man/dchroot.1.man:60 msgid "B accepts the following options:" msgstr "" #. type: SS #: man/dchroot.1.man:60 man/dchroot-dsa.1.man:55 #, no-wrap msgid "Basic options" msgstr "" #. type: Plain text #: man/dchroot.1.man:67 msgid "Select all chroots." msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/dchroot.1.man:78 #, no-wrap msgid "B<-p>, B<--path>" msgstr "" #. type: Plain text #: man/dchroot.1.man:81 msgid "Print location (path) of the specified chroots." msgstr "" #. type: Plain text #: man/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 #: man/dchroot.1.man:87 #, no-wrap msgid "B<--directory=>I" msgstr "" #. type: Plain text #: man/dchroot.1.man:92 msgid "" "Change to I inside the chroot before running the command or login " "shell. If I is not available, dchroot will exit with an error " "status." msgstr "" #. type: Plain text #: man/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 #: man/dchroot.1.man:101 #, no-wrap msgid "B<-d>, B<--preserve-environment>" msgstr "" #. type: Plain text #: man/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 #: man/dchroot.1.man:113 msgid "" "Print all messages. Note that earlier versions of dchroot did not include " "this option." msgstr "" #. type: Plain text #: man/dchroot.1.man:118 msgid "Note that earlier versions of dchroot did not provide long options." msgstr "" #. type: SH #: man/dchroot.1.man:118 man/dchroot-dsa.1.man:107 #, no-wrap msgid "INCOMPATIBILITIES" msgstr "" #. type: SS #: man/dchroot.1.man:119 #, no-wrap msgid "Debian dchroot prior to version 0.99.0" msgstr "" #. type: Plain text #: man/dchroot.1.man:122 man/dchroot-dsa.1.man:118 msgid "Log messages are worded and formatted differently." msgstr "" #. type: Plain text #: man/dchroot.1.man:127 msgid "" "B(1) is no longer used to run commands in the chroot; this is done by " "dchroot internally. This change may cause subtle differences. If you find " "an incompatibility, please report it so it may be corrected." msgstr "" #. type: Plain text #: man/dchroot.1.man:133 msgid "" "dchroot provides a restricted subset of the functionality implemented by " "B, but is still schroot underneath. Thus dchroot is still subject " "to schroot security checking, including PAM authentication and " "authorisation, and session management, for example, and hence may behave " "slightly differently to older dchroot versions in some circumstances." msgstr "" #. type: SS #: man/dchroot.1.man:133 man/dchroot-dsa.1.man:108 #, no-wrap msgid "Debian dchroot prior to version 1.5.1" msgstr "" #. type: Plain text #: man/dchroot.1.man:140 msgid "" "This version of dchroot uses I to store the configuration for " "available chroots, rather than the I file used historically. " "dchroot supported automatic migration of I to the " "I 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 #: man/dchroot.1.man:140 man/dchroot-dsa.1.man:115 #, no-wrap msgid "DSA dchroot" msgstr "" #. type: Plain text #: man/dchroot.1.man:143 msgid "" "Machines run by the Debian System Administrators for the Debian Project have " "a B package which provides an alternate dchroot implementation." msgstr "" #. type: Plain text #: man/dchroot.1.man:145 man/dchroot-dsa.1.man:128 msgid "All the above incompatibilities apply." msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/dchroot.1.man:164 man/dchroot-dsa.1.man:145 #, no-wrap msgid "Login shell or command" msgstr "" #. type: tbl table #: man/dchroot.1.man:172 #, no-wrap msgid "Normal behaviour (if --directory and I<--preserve-environment> are not\n" msgstr "" #. type: tbl table #: man/dchroot.1.man:173 #, no-wrap msgid "used)\n" msgstr "" #. type: tbl table #: man/dchroot.1.man:176 man/dchroot-dsa.1.man:156 #, no-wrap msgid "If passwd pw_dir is nonexistent\n" msgstr "" #. type: SS #: man/dchroot.1.man:182 #, no-wrap msgid "--preserve-environment used" msgstr "" #. type: tbl table #: man/dchroot.1.man:190 #, no-wrap msgid "Normal behaviour (if I<--preserve-environment> used)\n" msgstr "" #. type: Plain text #: man/dchroot.1.man:219 #, no-wrap msgid "" "$ \\f[CB]dchroot -l\\fR\\[CR]\n" "Available chroots: sarge [default], sid\n" msgstr "" #. type: Plain text #: man/dchroot.1.man:222 #, no-wrap msgid "" "$ \\f[CB]dchroot -p sid\\fR\\[CR]\n" "/srv/chroot/sid\n" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/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 #: man/dchroot.1.man:273 man/dchroot-dsa.1.man:226 msgid "" "The system-wide B definition file. This file must be owned by the " "root user, and not be writable by other." msgstr "" #. type: Plain text #: man/dchroot.1.man:278 msgid "" "This implementation of dchroot uses the same command-line options as the " "original B by David Kimdon \\f[CR]Edwhedon@debian.orgE\\fR, " "but is an independent implementation." msgstr "" #. type: Plain text #: man/dchroot.1.man:284 man/dchroot-dsa.1.man:239 msgid "" "B(1), B(1), B(2), B(5), " "B(5)." msgstr "" #. type: ds PROGRAM #: man/dchroot-dsa.1.man:19 #, no-wrap msgid "dchroot-dsa" msgstr "" #. type: TH #: man/dchroot-dsa.1.man:20 #, no-wrap msgid "DCHROOT-DSA" msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:23 msgid "dchroot-dsa - enter a chroot environment" msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:33 msgid "" "B [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\\[or]B<--directory=>I] " "[B<-q>\\[or]B<--quiet> \\[or] B<-v>\\[or]B<--verbose>] [B<-c " ">I\\[or]B<--chroot=>I \\[or] B<--all> \\[or] B " "[B]" msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:37 msgid "" "B allows the user to run a command or a login shell in a chroot " "environment. If no command is specified, a login shell will be started in " "the user's home directory inside the chroot." msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:39 msgid "The user's environment will be preserved inside the chroot." msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:42 msgid "" "The command is a single argument which must be an absolute path to the " "program. Additional options are not permitted." msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:52 msgid "" "This version of dchroot-dsa is a compatibility wrapper around the " "B(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\\[rq] below for known " "incompatibilities with older versions of dchroot-dsa." msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:55 msgid "B accepts the following options:" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/dchroot-dsa.1.man:76 #, no-wrap msgid "B<-p>, B<--listpaths>" msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:79 msgid "Print absolute locations (paths) of the available chroots." msgstr "" #. type: Plain text #: man/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 #: man/dchroot-dsa.1.man:90 msgid "" "Change to I inside the chroot before running the command or login " "shell. If I is not available, dchroot-dsa will exit with an " "error status." msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/dchroot-dsa.1.man:115 msgid "" "This version of dchroot-dsa uses I to store the configuration " "for available chroots, rather than the I file used " "historically. dchroot-dsa supported automatic migration of I " "to the I 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 #: man/dchroot-dsa.1.man:124 msgid "" "dchroot-dsa provides a restricted subset of the functionality implemented by " "B, but is still schroot underneath. Thus dchroot-dsa is still " "subject to schroot security checking, including PAM authentication and " "authorisation, and session management, for example, and hence may behave " "slightly differently to earlier versions of dchroot-dsa in some " "circumstances." msgstr "" #. type: SS #: man/dchroot-dsa.1.man:124 #, no-wrap msgid "Debian dchroot" msgstr "" #. type: Plain text #: man/dchroot-dsa.1.man:126 msgid "A B package provides an alternative dchroot implementation." msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/dchroot-dsa.1.man:153 #, no-wrap msgid "Normal behaviour (if --directory is not used)\n" msgstr "" #. type: Plain text #: man/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 #: man/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 #: man/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 #: man/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 #: man/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 #: man/dchroot-dsa.1.man:233 msgid "" "This implementation of dchroot-dsa uses the same command-line options as the " "B found on machines run by the Debian System Administrators for the " "Debian Project. These machines have a B source package which " "provides a B package, written by Ben Collins " "\\f[CR]Ebcollins@debian.orgE\\fR and Martin Schulze " "\\f[CR]Ejoey@debian.orgE\\fR." msgstr ""