SCHROOT(1) Debian sbuild SCHROOT(1) (NAME) schroot - chroot (SYNOPSIS) schroot [-h|--help | -V|--version | -l|--list | -i|--info | --config | --location | --automatic-session | -b|--begin-session | --recover-session | -r|--run-session | -e|--end-session] [-f|--force] [-n session-name|--session-name=session-name] [-d directory|--directory=directory] [-u user|--user=user] [-p|--preserve-environment] [-s shell|--shell=shell] [-q|--quiet | -v|--verbose] [-c chroot|--chroot=chroot | [--all | --all-chroots | --all-source-chroots | --all-sessions] [--exclude-aliases]] [-o|--option=key=value] [--] [COMMAND [ ARG1 [ ARG2 [ ARGn]]]] (DESCRIPTION) schroot (login shell) chroot . chroot . . . . --directory . chroot . " (Authentication)" . chroot chroot `default' . "--chroot=default" . (OVERVIEW) . kvm Xen schroot . . (shared memory) . schroot : o (sandbox) o o GNU/Linux o chroot o Debian sbuild(1) LVM union chroot o (image) (cluster) / : chroot chroot ( root ) chroot root chroot(8) . schroot chroot . schroot chroot(8) chroot . chroot LVM Btrfs loopback (overlay) unionfs . chroot . schroot chroot . (setup scripts) . . . chroot `plain' chroot . schroot schroot.conf(5) ..SH " (OPTIONS)" schroot : -h, --help . -V, --version . -l, --list chroot . -i, --info chroot . --config chroot . . () . --location () chroot . chroot . -q, --quiet . -v, --verbose (). chroot -c, --chroot=chroot chroot . chroot --all . chroot namespace "Chroot Namespaces" . -a, --all chroot source chroot . chroot source chroot . --info chroot . (login shell ) . "--all-chroots --all-source-chroots --all-sessions" . --all-chroots chroot. --all source chroot . --all-sessions . --all chroot source chroot . --all-source-chroots source chroot. --all chroot . --exclude-aliases (aliases) chroot. chroot . chroot -d, --directory=directory directory chroot . directory schroot . ( chroot ): . $HOME ( --preserve-environment ) / chroot . chroot . schroot . -u, --user=user . . . "Authentication" . -p, --preserve-environment chroot. . "Environment" . -s, --shell=shell shell . : SHELL ( --preserve-environment preserve-environment ) `passwd' /bin/bash /bin/sh. . shell . -o, --option=key=value . schroot.conf . user-modifiable-keys schroot.conf ( ) root user-modifiable-keys . (setup scripts) chroot . --automatic-session . . -b, --begin-session . (session ID) . . --session-name . --recover-session . unmount ( mount ). --chroot . -r, --run-session . --chroot . -e, --end-session . --chroot ..SS " (Session options)" -n, --session-name=session-name . session-name (session ID) . `session:' . chroot schroot.conf(5) . -f, --force . . unmount . (Separator) -- . schroot schroot. (AUTHENTICATION) ( root root root) chroot() . . (PAM) schroot PAM . schroot . PAM ( PAM ). PAM root . PAM root (pam_rootok.so) root chroot . root . PAM root chroot . CHROOT (CHROOT NAMESPACES) (Namespace basics) chroot : chroot chroot chroot . chroot . chroot . : `chroot:' `source:' `session:'. --list --all chroot . `:' chroot chroot . schroot chroot . chroot "sid" "chroot:sid" . chroot (Source chroots) chroot LVM Btrfs (copy-on-write) chroot . source chroot . chroot . chroot "sid-snapshot" ( "chroot:sid-snapshot") chroot "source:sid-snapshot" . schroot `-source' . . chroot "chroot:sid-snapshot-source" . . chroot (Session chroots) --begin-session `session:' . --session-name chroot . schroot . (Actions and default namespaces) `chroot:' . --run-session --recover-session --end-session `session:' chroot . chroot chroot . chroot . (PERFORMANCE) Btrfs dpkg fsync . eatmydata eatmydata command-prefix fsync . chroot . chroot . (DIRECTORY FALLBACKS) schroot chroot --directory . . . CWD DIR --directory . (Login shell) +-------------------------------+------------------------------------------+ | | | |( -> Chroot) | | +-------------------------------+------------------------------------------+ |CWD -> CWD | ( | | | --directory | | | ) | |CWD -> $HOME | CWD | | | | | | --preserve-environment | | | | |CWD -> passwd pw_dir | CWD | | | ( | | | --preserve-environment | | | | | | $HOME | | | ) | |CWD -> / | | | | | | | | | | | |FAIL | / | | | | | (Command) | | |box; | | |l|lw(4i). | | | | | |( -> Chroot) | | +-------------------------------+------------------------------------------+ |CWD -> CWD | ( | | | --directory | | | ) | |FAIL | CWD | | | | +-------------------------------+------------------------------------------+ . --directory +-------------------------------+------------------------------------------------------------+ | | | |( -> Chroot) | | +-------------------------------+------------------------------------------------------------+ |CWD -> DIR | | |FAIL | DIR | +-------------------------------+------------------------------------------------------------+ . (Debugging) --debug=notice . (EXAMPLES) chroot % schroot -l chroot:default chroot:etch chroot:sid chroot:testing chroot:unstable chroot % schroot -i -c sid ------ Chroot ------ Name sid Description Debian sid (unstable) Type plain Priority 3 Users rleigh Groups sbuild Root Users Root Groups sbuild Aliases unstable unstable-sbuild unstable-p owerpc-sbuild Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\ FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\ IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\ RMPATH)$ Run Setup Scripts true Script Configuration script-defaults Session Managed true Personality linux32 Location /srv/chroot/sid --all -c chroot . chroot % schroot -c sid /bin/ls [sid chroot] Running command: "/bin/ls" CVS sbuild-chroot.c sbuild-session.h schroot.conf.5 Makefile sbuild-chroot.h schroot.1 schroot.conf.5.in Makefile.am sbuild-config.c schroot.1.in Makefile.in sbuild-config.h schroot.c pam sbuild-session.c schroot.conf % schroot -c sid -- ls -1 | head -n 5 [sid chroot] Running command: "ls -1" ABOUT-NLS AUTHORS COPYING ChangeLog INSTALL -- `-' `--' chroot . schroot . . chroot . % schroot -c sid -u root Password: [sid chroot] (rleigh->root) Running login shell: "/bin/bash" # `rleigh' root-users /etc/schroot/schroot.conf root-groups PAM . (Sessions) chroot . chroot LV LVM chroot ( ) . . chroot `plain' `directory' . chroot : % schroot -i -c sid-snap ------ Chroot ------ Name sid-snap Description Debian sid snapshot Type lvm-snapshot Priority 3 Users maks rleigh Groups sbuild Root Users Root Groups root sbuild Aliases Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\ FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\ IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\ RMPATH)$ Run Setup Scripts true Script Configuration script-defaults Session Managed true Personality linux Device /dev/hda_vg/sid_chroot Mount Options -o atime,async,user_xattr Source Users Source Groups root rleigh Source Root Users Source Root Groups root rleigh LVM Snapshot Options --size 2G -c 128 Session Managed `true' . chroot . : % schroot -b -c sid-snap sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f (session ID) . : % SESSION=$(schroot -b -c sid-snap) % echo $SESSION sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f chroot . : % schroot -i -c sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f ------ Session ------ Name sid-snap-46195b04-0893-49bf-beb8-0d\ 4ccc899f0f Description Debian sid snapshot Type lvm-snapshot Priority 3 Users maks rleigh Groups sbuild Root Users Root Groups root sbuild Aliases Environment Filter ^(BASH_ENV|CDPATH|ENV|HOSTALIASES|I\ FS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMA\ IN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TE\ RMPATH)$ Run Setup Scripts true Script Configuration script-defaults Session Managed true Personality linux Mount Location /var/lib/schroot/mount/sid-snap-461\ 95b04-0893-49bf-beb8-0d4ccc899f0f Path /var/lib/schroot/mount/sid-snap-461\ 95b04-0893-49bf-beb8-0d4ccc899f0f Mount Device /dev/hda_vg/sid-snap-46195b04-0893-\ 49bf-beb8-0d4ccc899f0f Device /dev/hda_vg/sid_chroot Mount Options -o atime,async,user_xattr Source Users Source Groups root rleigh Source Root Users Source Root Groups root rleigh LVM Snapshot Device /dev/hda_vg/sid-snap-46195b04-0893-\ 49bf-beb8-0d4ccc899f0f LVM Snapshot Options --size 2G -c 128 : % schroot -r -c sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f -- \ uname -sr I: [sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f chroot] Running \ command: "uname -sr" Linux 2.6.18-3-powerpc % schroot -r -c $SESSION -- uname -sr I: [sid-snap-fe170af9-d9be-4800-b1bd-de275858b938 chroot] Running \ command: "uname -sr" Linux 2.6.18-3-powerpc : % schroot -e -c sid-snap-46195b04-0893-49bf-beb8-0d4ccc899f0f % schroot -e -c $SESSION . : % schroot -b -c sid-snap -n my-session-name my-session-name (TROUBLESHOOTING) --debug=level . . : `none' `notice' `info' `warning' `critical'. . : Debian buildd-tools Developers (BUGS) mips mipsel .. personality(2) personality . "Operation not permitted" (EPERM) . personality `undefined' . (ENVIRONMENT) : HOME LOGNAME PATH SHELL TERM ( ) USER. SCHROOT_COMMAND SCHROOT_USER SCHROOT_GROUP SCHROOT_UID SCHROOT_GID chroot . SCHROOT_SESSION_ID SCHROOT_CHROOT_NAME SCHROOT_ALIAS_NAME chroot chroot . : BASH_ENV CDPATH ENV HOSTALIASES IFS KRB5_CONFIG KRBCONFDIR KRBTKFILE KRB_CONF LD_.* LOCALDOMAIN NLSPATH PATH_LOCALE RES_OPTIONS TERMINFO TERMINFO_DIRS TERMPATH. environment-filter schroot.conf(5) . (FILES) /etc/schroot/schroot.conf chroot . (root) . /etc/schroot/chroot.d chroot . /etc/schroot/schroot.conf . chroot . run-parts(8) --lsbsysinit . /etc/schroot/setup.d chroot . : schroot-setup(5). /etc/pam.d/schroot PAM. /usr/lib/schroot . . chroot . /var/lib/schroot/session . /var/run/schroot/mount (mount) . /var/lib/schroot/union/underlay (underlay). /var/lib/schroot/union/overlay (overlay). /var/lib/schroot/unpack chroot . (AUTHORS) Roger Leigh. (COPYRIGHT) Copyright (C) 2005-2012 Roger Leigh schroot : << >> (GNU General Public License) ( ) ..SH " (SEE ALSO)" dchroot(1), sbuild(1), chroot(2), schroot.conf(5). schroot-setup(5), schroot-faq(7), run-parts(8), Version 1.6.13 14 Aug 2022 SCHROOT(1)