SCHROOT.CONF(5) Debian sbuild SCHROOT.CONF(5) (NAME) schroot.conf - chroot schroot (DESCRIPTION) schroot.conf UTF-8 chroot schroot . () `#' ("") . `#' . INI - () . (General options) chroot - . chroot . chroot chroot . : [sid] . " Chroot" . - : type=type chroot. : `plain' `directory' `file' `loopback' `block-device' `btrfs-snapshot' `zfs-snapshot' `lvm-snapshot'. `plain' . chroot `plain' `directory' ( "chroot plain directory" ). description=description chroot. "" . priority=number chroot. number . "oldstable" "oldstable-security" `0' "stable" "stable-security" `1' "testing" `2' "unstable" `3' . . schroot . message-verbosity=verbosity (verbosity) schroot chroot. : `quiet' ( ) `normal' () `verbose' ( ). --quiet --verbose . users=user1,user2,... chroot . ( groups ). groups=group1,group2,... chroot . . root-users=user1,user2,... (root) chroot . ( users groups ). "" . root-groups=group1,group2,... (root) chroot . ( users groups ). "" . aliases=alias1,alias2,... ( ) chroot. chroot "sid" `unstable' . chroot . profile=directory script-config=filename chroot chroot () . /etc/schroot . `default' . source . : `minimal' ( ) `desktop' ( chroot chroot ) `sbuild' ( chroot ). . setup.config setup.copyfiles setup.fstab setup.nssdatabases profile . profile script-config . script-config profile "/config" . `default/config' . . script-config ( profile ). script-config . source script-config schroot profile script-config setup.config source . source schroot.conf source setup.config . gdm3 fstab desktop/fstab . preserve-environment `true' chroot . / . "" . setup.config=filename source . script-config . Bourne . chroot . source (idempotent) . schroot.conf . . schroot-script-config(5) . source . setup.copyfiles=filename chroot ( ). chroot . setup.fstab=filename chroot . /etc/fstab fstab(5) . fs_dir chroot . (canonicalise) chroot . setup.nssdatabases=filename chroot . : `passwd' `shadow' `group' `gshadow'. : `services' `protocols' `networks' `hosts'. getent(1) /etc/nsswitch.conf . setup.services=service1,service2,... chroot. . command-prefix=command,option1,option2,... . chroot . nice ionice eatmydata chroot . nice ionice / . eatmydata fsync chroot (snapshot) . personality=persona (personality) . chroot . : `bsd' `hpux' `irix32' `irix64' `irixn32' `iscr4' `linux' `linux32' `linux_32bit' `osf4' `osr5' `riscos' `scorvr3' `solaris' `sunos' `svr4' `uw7' `wysev386' `xenix'. `linux' . `undefined' ( ) . chroot `linux32' . `undefined' . `undefined' . preserve-environment=true|false chroot . true . X chroot . --preserve-environment . shell=shell (login shell) : SHELL ( --preserve-environment preserve-environment ) `passwd' /bin/bash /bin/sh. . --shell . environment-filter=regex chroot . POSIX chroot . : "^(BASH_ENV|CDPATH|ENV|HOSTALIASES|IFS|KRB5_CONFIG|KRBCONFDIR |KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMAIN|NLSPATH|PATH_LOCALE |RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TERMPATH)$". chroot plain directory (Plain and directory chroots) chroot `plain' `directory' . chroot directory chroot plain . /proc chroot plain chroot chroot directory . chroot directory chroot (filesystem union chroot) ( " chroot " ). chroot () : directory=directory chroot. . . chroot bind-mount chroot `plain' --rbind mount(8) chroot `directory' --bind (sub-mounts) ( /etc/fstab fstab ). chroot (File chroots) chroot `file' chroot . chroot (source chroot) ( " chroot " ). chroot chroot ( `file' ) . : file=filename chroot (). tar ( ) gzip bzip2 xz lzop lz4 . : .tar .tar.gz .tar.bz2 .tar.xz .tar.lzop .tar.lz4 .tgz .tbz .txz .tzo .tlz4. root . zip zip (named pipes) (device nodes) chroot . location=path chroot . chroot /squeeze "/squeeze" . chroot / chroot . chroot (Loopback chroots) chroot `loopback' . . chroot chroot (mountable chroot) chroot (filesystem union chroot) ( " chroot " " chroot " ) : file=filename . "/srv/chroot/sid". chroot (Block device chroots) chroot `block-device' . . chroot chroot (mountable chroot) chroot (filesystem union chroot) ( " chroot " " chroot " ) : device=device . "/dev/sda5". chroot Btrfs (Btrfs snapshot chroots) chroot `btrfs-snapshot' (snapshot) (subvolume) Btrfs Btrfs . . . chroot chroot (source chroot) ( " chroot " ). chroot chroot ( `directory' ) . : btrfs-source-subvolume=directory . btrfs-snapshot-directory=directory . chroot ZFS (ZFS snapshot chroots) chroot `zfs-snapshot' () ZFS (dataset) ZFS . . . chroot chroot (source chroot) ( " chroot " ). chroot chroot ( `directory' ) . : zfs-dataset=dataset_name ZFS . zfs-snapshot-options=snapshot_options . zfs snapshot . chroot LVM (LVM snapshot chroots) chroot `lvm-snapshot' (LV) LVM . LV LV . LV . chroot LVM chroot (source chroot) ( " chroot " ) `block-device' . chroot chroot ( `block-device' ) . : lvm-snapshot-options=snapshot_options . lvcreate(8) . "-L 2g" (GiB). : LV ( -n ) ( -s ) LV schroot . chroot (Custom chroots) chroot `custom' chroot chroot . chroot ++C . chroot . chroot chroot . : custom-session-cloneable=true|false chroot () ( ). custom-session-purgeable=true|false chroot ( ). custom-source-cloneable=true|false chroot chroot ( ). chroot (Source chroot options) chroot `btrfs-snapshot' `file' `lvm-snapshot' chroot . chroot chroot ( " chroot " ). chroot . chroot chroot source: ( ) chroot . chroot wheezy (chroot:wheezy) chroot source:wheezy . schroot chroot -source chroot ( wheezy-source ). schroot 1.5.0 source: -source . schroot(1) . chroot : source-clone=true|false chroot chroot () . true false . chroot . source-users=user1,user2,... chroot . . users chroot . source-groups=group1,group2,... chroot . . groups chroot . source-root-users=user1,user2,... chroot . ( users ). root-users chroot . "" . source-root-groups=group1,group2,... chroot . ( groups ). root-groups chroot . "" . chroot (Mountable chroot options) chroot `block-device' `loopback' `lvm-snapshot' . chroot chroot . chroot : mount-options=options . mount(8) . "-o atime,sync,user_xattr". location=path chroot . chroot /chroot/sid "/chroot/sid" . chroot / chroot . chroot (Filesystem Union chroot options) chroot `block-device' `directory' `loopback' (filesystem unions) (overlay) . . chroot . union-type . chroot chroot ( " chroot " ). . union-type=type . : `aufs' `overlayfs' `overlay' ( 4.0 ) `unionfs'. `none' . union-mount-options=options ( ) union-type . "-o" mount . `aufs' `overlayfs' `unionfs' . : "${CHROOT_UNION_OVERLAY_DIRECTORY}" "${CHROOT_UNION_UNDERLAY_DIRECTORY}" overlay underlay . schroot-setup(5) . union-overlay-directory=directory (overlay) . `/var/lib/schroot/union/overlay' . union-underlay-directory=directory (underlay) . `/var/lib/schroot/union/underlay' . (Customisation) . . - . : "^([a-z][a- z0-9]*\.)+[a-z][a-z0-9-]*$". : debian.apt-update=true debian.distribution=unstable : DEBIAN_APT_UPDATE=true DEBIAN_DISTRIBUTION=unstable . --option . . : user-modifiable-keys=key1,key2,.. --option . root-modifiable-keys=key1,key2,.. (root) --option . user-modifiable-keys . (Localisation) . (locale) . : description[en_GB]=British English translation description en_GB . description[fr]=French translation description . CHROOT (CHROOT NAMES) chroot . . (`-') (`.') (`_') . : (Generic) chroot . . `dpkg-old' `dpkg-dist' `dpkg-new' `dpkg-tmp' . dpkg . (SECURITY) (Untrusted users) chroot ! chroot chroot . . chroot . (Profiles) script-config chroot chroot . /dev . bind mount /var . fstab chroot . chroot . ( chroot ) / ( ) . . (EXAMPLE) # Sample configuration [sid] type=plain description=Debian unstable description[fr_FR]=Debian instable directory=/srv/chroot/sid priority=3 users=jim groups=sbuild root-users=rleigh aliases=unstable,default [etch] type=block-device description=Debian testing (32-bit) priority=2 groups=users #groups=sbuild-security aliases=testing device=/dev/hda_vg/etch_chroot mount-options=-o atime personality=linux32 [sid-file] type=file description=Debian sid file-based chroot priority=3 groups=sbuild file=/srv/chroots/sid.tar.gz [sid-snapshot] type=lvm-snapshot description=Debian unstable LVM snapshot priority=3 groups=sbuild users=rleigh source-root-users=rleigh source-root-groups=admin device=/dev/hda_vg/sid_chroot mount-options=-o atime,sync,user_xattr lvm-snapshot-options=--size 2G (FILES) chroot (Chroot definitions) /etc/schroot/schroot.conf chroot . root . /etc/schroot/chroot.d chroot . /etc/schroot/schroot.conf . chroot . (Setup script configuration) /etc/schroot/default . config . schroot-script-config(5) . script-config . /etc/schroot/script-defaults . : copyfiles chroot . /etc/schroot/copyfiles-defaults . fstab fstab(5) chroot . chroot . /etc/schroot/mount-defaults . nssdatabases ( /etc/nsswitch.conf / ) chroot . /etc/schroot/nssdatabases-defaults . (AUTHORS) Roger Leigh. (COPYRIGHT) Copyright (C) 2005-2012 Roger Leigh schroot 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. (SEE ALSO) sbuild(1), schroot(1), schroot-script-config(5), schroot-faq(7), mount(8). Version 1.6.13 14 Aug 2022 SCHROOT.CONF(5)