schroot.conf

NOM

DESCRIPTION

Options générales

[sid]

type=type

The type of the chroot. Valid types are ‘plain’, ‘directory’, ‘file’, ‘loopback’, ‘block-device’, ‘btrfs-snapshot’, ‘zfs-snapshot’ and ‘lvm-snapshot’. If empty or omitted, the default type is ‘plain’. Note that ‘plain’ chroots do not run setup scripts and mount filesystems; ‘directory’ is recommended for normal use (see “ Plain and directory chroots”, below).

description=description

Une description courte du chroot. Elle peut être traduite en différentes langues ; consultez la section “ Localisation” ci-dessous.

priority=nombre

Définir la priorité d'un chroot. nombre est un entier positif indiquant si une distribution est plus ancienne qu'une autre. Par exemple, “oldstable” et “oldstable-security” peuvent être ‘0’ alors que “stable” et “stable-security” sont ‘1’, “testing” est ‘2’ et “unstable” est ‘3’. Les valeurs ne sont pas importantes, mais les différences entre elles le sont. Cette option est déconseillée et n'est plus utilisée par schroot, mais il est encore permis de l'utiliser, elle deviendra obsolète et sera retirée dans une prochaine version.

message-verbosity=verbosité

Définir la verbosité des messages affichés par schroot lors de la mise en place, de l'exécution des commandes et du nettoyage du chroot. Les paramètres valables sont ‘quiet’ (supprime la plupart des messages), ‘normal’ (par défaut) et ‘verbose’ (affiche tous les messages). Ce paramètre est écrasé par les options --quiet et --verbose.

users=utilisateur1,utilisateur2,…

Une liste séparée par des virgules des utilisateurs qui sont autorisés à accéder au chroot. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot (sauf s'il appartient à un groupe spécifié dans groups).

groups=groupe1,groupe2,...

Une liste séparée par des virgules des groupes qui sont autorisés à accéder au chroot. Si vide ou omis, aucun groupe d'utilisateurs ne sera autorisé à accéder au chroot.

root-users=utilisateur1,utilisateur2,...

Une liste séparée par des virgules des utilisateurs qui sont autorisés à devenir root dans le chroot sans mot de passe. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur ou un groupe auquel il appartient est dans users ou groups, respectivement, il peut obtenir un accès avec un mot de passe). Consultez la section “ Sécurité” ci-dessous.

root-groups=groupe1,groupe2,...

Une liste séparée par des virgules des groupes qui sont autorisés à devenir root dans le chroot sans mot de passe. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur ou un groupe auquel il appartient est dans users ou groups, respectivement, il peut obtenir un accès avec un mot de passe). Consultez la section “ Sécurité” ci-dessous.

aliases=alias1,alias2,...

Une liste séparée par des virgules des alias (noms alternatifs) pour ce chroot. Par exemple, un chroot, nommé “sid”, peut avoir un alias ‘unstable’ pour des raisons de commodité. Les alias sont sujets aux mêmes restrictions que le nom du chroot lui-même.

profile=répertoire

script-config=nom-de-fichier

Le comportement des scripts de mise en place des chroots peut être personnalisé pour chaque chroot en définissant un profil de configuration spécifique. Le nom du répertoire est relatif à /etc/schroot. Le nom par défaut est ‘default’. Les fichiers de ce répertoire seront recherchés par les scripts de mise en place dont le comportement peut par conséquent être personnalisé en sélectionnant le profil approprié. Les alternatives sont ‘minimal’ (pour une configuration minimale), ‘desktop’ (pour exécuter des programmes graphiques dans un chroot, autorisant plus de fonctionnalités du système hôte disponible dans le chroot) et ‘sbuild’ (pour utiliser le chroot pour la construction de paquet Debian). D'autres paquets peuvent fournir des profils supplémentaires. La valeur par défaut des clés setup.config, setup.copyfiles, setup.fstab et setup.nssdatabases est définie en fonction de la configuration de profile.

Notez que la clé profile remplace l'ancienne clé script-config. La clé script-config est exactement la même que profile, mais “/config” y est ajoutée. Le nom de fichier par défaut est ‘default/config’. Chacune de ces deux clés peuvent être utilisées. script-config sera prioritaire ( profile sera indéfini). script-config est déconseillée et sera retirée dans une prochaine version. Notez que profile est équivalent à script-config si le fichier recherché par script-config ne contient que les variables standard fournies par schroot. Si des variables supplémentaires ou des scripts shell sont ajoutés, veuillez également définir setup.config qui permettra à ces fichiers d'être toujours recherchés. Il est recommandé de remplacer l'utilisation de fichiers recherchés par des clés supplémentaires dans schroot.conf quand cela est possible. Il sera toujours possible de rechercher des fichiers de configuration supplémentaires en utilisant setup.config.

À noter pour les utilisateurs graphiques que le fichier fstab desktop/fstab aura besoin d'une modification si vous utilisez gdm3 ; veuillez consulter les commentaires dans ce fichier pour plus d'information. La clé preserve-environment doit être définie à ‘true’ pour que l'environnement soit préservé dans le chroot.

Si aucun des profils de configuration fournis ci-dessus ne convient à vos besoins, ils peuvent être édités pour les personnaliser davantage et/ou copiés et utilisés en tant que modèles pour de tous nouveaux profils.

Notez que les différents profils ont des implications de sécurité différentes ; consultez la section “ Sécurité” ci-dessous pour plus d'informations.

setup.config=nom-de-fichier

Cette clé spécifie un fichier que les scripts de mise en place vont rechercher quand ils seront exécutés. La valeur par défaut est celle définie par script-config. Le fichier est un script de type Bourne shell, et par conséquent peut contenir tout code shell valable, en plus des simples affectations de variable. Cela permet, par exemple, d'adapter les comportements en fonction d'un type spécifique ou nom de chroot. Notez que le script sera chargé à chaque invocation des scripts de mise en place et doit être idempotent.

Toutes les configurations par défaut dans le fichier sont maintenant définissables en utilisant les clés de configuration dans schroot.conf, comme détaillé ci-dessous. Les configurations existantes devront être modifiées pour utiliser ces clés à la place de ce fichier. Consultez schroot-script-config(5) pour plus de détails. Ce type de fichier de configuration de script de mise en place n'est plus fourni dans les profils standard, mais continuera à être recherché s'il est présent et que cette clé est définie.

setup.copyfiles=nom-de-fichier

Un fichier contenant une liste de fichiers à copier dans le chroot (un fichier par ligne). Le fichier aura le même chemin absolu dans le chroot.

setup.fstab=nom-de-fichier

Le fichier de la table des systèmes de fichiers à utiliser pour monter les systèmes de fichiers dans le chroot. Le format de ce fichier est le même que pour /etc/fstab, documenté dans fstab(5). La seule différence est que le chemin du point de montage fs_dir est relatif au chroot plutôt qu'à la racine. Notez également que les points de montage sont canonisés sur l'hôte, ce qui permet de s'assurer que les liens symboliques absolus pointent à l'intérieur du chroot. Cependant, les chemins complexes contenant des liens symboliques multiples peuvent être incorrectement résolus. Il est déconseillé d'utiliser les liens symboliques imbriqués comme points de montage.

setup.nssdatabases=nom-de-fichier

Un fichier listant les bases de données du système à copier dans le chroot. Les bases de données par défaut sont ‘passwd’, ‘shadow’, ‘group’ et ‘gshadow’. Les autres bases de données qui pourraient être ajoutées incluent ‘services’, ‘protocols’, ‘networks’ et ‘hosts’. Les bases de données sont copiées en utilisant getent(1) pour que toutes les sources de bases de données listées dans /etc/nsswitch.conf soient utilisées pour chaque base de données.

setup.services=service1,service2,…

Une liste des services à exécuter dans le chroot séparés par des virgules. Ceux-ci seront démarrés quand la session démarrera et arrêtés quand la session se terminera.

command-prefix=commande,option1,option2,...

Une liste séparée par des virgules d'une commande et des options de la commande. Cette commande et ses options seront préfixées à toutes les commandes exécutées dans le chroot. C'est utile pour ajouter des commandes comme nice, ionice ou eatmydata pour toutes les commandes exécutées dans le chroot. nice et ionice affecteront l'ordonnancement CPU et I/O. eatmydata ignore les opérations fsync sur le système de fichiers et est utile pour les chroots d'instantané jetable où vous ne vous souciez pas des pertes de données, mais désirez une grande vitesse.

personality=persona

Définir les personnalités (domaine d'exécution des processus) à utiliser. Cette option est utile par exemple lors de l'utilisation d'un chroot 32 bits sur un système 64 bits. Les options valables sous Linux sont ‘bsd’, ‘hpux’, ‘irix32’, ‘irix64’, ‘irixn32’, ‘iscr4’, ‘linux’, ‘linux32’, ‘linux_32bit’, ‘osf4’, ‘osr5’, ‘riscos’, ‘scorvr3’, ‘solaris’, ‘sunos’, ‘svr4’, ‘uw7’, ‘wysev386’ et ‘xenix’. La valeur par défaut est ‘linux’. Il y a aussi l'option spéciale ‘undefined’ (personnalité non définie). Pour un chroot 32 bits sur un système 64 bits, ‘linux32’ est l'option requise. La seule option valable pour les systèmes non Linux est ‘undefined’. La valeur par défaut pour les systèmes non Linux est ‘undefined’.

preserve-environment=true|false

Par défaut, l'environnement ne sera pas préservé à l'intérieur du chroot. À la place, un environnement minimal sera utilisé. Définir à true pour toujours préserver l'environnement. C'est utile par exemple lors de l'exécution des applications graphiques à l'intérieur du chroot qui ont besoin de l'environnement pour fonctionner correctement. L'environnement peut également être préservé en utilisant l'option --preserve-environment.

shell=shell

Lors de l'exécution d'un interpréteur de commande de connexion plusieurs interpréteurs de commandes potentiels seront considérés dans cet ordre : la commande dans la variable d'environnement SHELL (si l'option --preserve-environment est utilisée ou si preserve-environment est activé), l'interpréteur de commandes de l'utilisateur dans la base de données ‘passwd’, /bin/bash et finalement /bin/sh. Ce paramètre écrase cette liste et utilisera l'interpréteur de commandes spécifié. Il peut être écrasé en utilisant l'option --shell.

environment-filter=regex

L'environnement à définir dans le chroot sera filtré dans le but d'enlever les variables d'environnement qui peuvent poser un problème de sécurité. Toute variable d'environnement qui correspondrait à l'expression régulière POSIX étendue spécifiée sera supprimée avant l'exécution de toute commande dans le chroot.

Les variables d'environnement potentiellement dangereuses sont retirées par sécurité par défaut en utilisant l'expression régulière suivante : “^(BASH_ENV|CDPATH|ENV|HOSTALIASES|IFS|KRB5_CONFIG|KRBCONFDIR|KRBTKFILE|KRB_CONF|LD_.*|LOCALDOMAIN|NLSPATH|PATH_LOCALE|RES_OPTIONS|TERMINFO|TERMINFO_DIRS|TERMPATH)$”.

Chroots « plain » et « directory »

directory=répertoire

Le répertoire contenant l'environnement de chroot. C'est là où la racine sera déplacée lors de l'exécution d'un interpréteur de commande de connexion ou d'une commande. Le répertoire doit exister et être accessible en lecture et exécution pour autoriser les utilisateurs à y accéder. Notez que sur les systèmes Linux il sera monté autre part pour être utilisé comme chroot ; le répertoire pour les chroots ‘plain’ est monté avec l'option --rbind pour mount(8), alors que pour les chroots ‘directory’ l'option --bind sera utilisée à la place pour que les sous-montages ne soient pas conservés (ils doivent être définis dans le fichier fstab comme dans le fichier /etc/fstab de l'hôte).

Chroots « file »

file=nom-de-fichier

Le fichier contenant l'environnement de chroot archivé (requis). Cela doit être une archive tar, facultativement compressée par gzip, bzip2, xz, lzop ou lz4. Les extensions de fichier utilisées pour déterminer le type sont .tar, .tar.gz, .tar.bz2, .tar.xz, .tar.lzop, .tar.lz4, .tgz, .tbz, .txz, .tzo et .tlz4. Ce fichier doit appartenir à l'utilisateur root et être non inscriptible par les autres. Notez que les archives zip ne sont plus gérées ; zip n'était capable d'archiver ni les tubes nommés (« named pipes ») ni les nœuds de périphériques (« device nodes ») et n'était donc pas adéquat pour archiver des chroots.

location=chemin

C'est le chemin du chroot à l'intérieur de l'archive. Par exemple, si l'archive contient un chroot dans /squeeze, vous devriez spécifier ici “/squeeze”. Si le chroot est la seule chose à l'intérieur de l'archive, c'est-à-dire si / est la racine du système de fichiers pour le chroot, cette option doit être laissée vide ou omise complètement.

Chroots loopback

file=nom-de-fichier

C'est le nom du fichier contenant le système de fichiers, incluant le chemin absolu. Par exemple, “/srv/chroot/sid”.

Chroots périphérique de blocs (« block device »).

device=périphérique

C'est le nom du périphérique contenant le périphérique bloc, incluant le chemin absolu. Par exemple, “/dev/sda5”.

Chroots d'instantanés Btrfs

btrfs-source-subvolume=répertoire

Le répertoire contenant le sous-volume source.

btrfs-snapshot-directory=répertoire

Le répertoire dans lequel les instantanés du sous-volume ci-dessus seront enregistrés.

ZFS snapshot chroots

zfs-dataset=dataset_name

Name of the ZFS source dataset to use.

zfs-snapshot-options=snapshot_options

Snapshot options. These are additional options to pass to zfs snapshot.

Chroots d'instantanés LVM

lvm-snapshot-options=options_d'instantanés

Options d'instantanés. Ce sont les options supplémentaires à passer à lvcreate(8). Par exemple, “-L 2g” pour créer des instantanés de 2 GiB. Note : le nom du LV (-n), les options des instantanés ( -s) et le chemin original du LV ne devraient pas être spécifiés ici ; ils sont définis automatiquement par schroot.

Chroots personnalisés

custom-session-cloneable=true|false

Définir si les sessions peuvent être clonées en utilisant ce chroot ou non (activé par défaut).

custom-session-purgeable=true|false

Définir si les sessions peuvent être purgées en utilisant ce chroot ou non (désactivé par défaut).

custom-source-cloneable=true|false

Définir si les chroots source peuvent être clonés en utilisant ce chroot ou non (désactivé par défaut).

Options des chroots source

source-clone=true|false

Définir si le chroot source doit être cloné automatiquement (créé) pour ce chroot. La valeur par défaut est true pour cloner automatiquement, mais si besoin le clonage peut être désactivé en la définissant à false. Si le clonage est désactivé, le chroot source sera inaccessible.

source-users=utilisateur1,utilisateur2,...

Une liste séparée par des virgules des utilisateurs qui sont autorisés à accéder au chroot source. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot. Cela deviendra l'option users dans le chroot source.

source-groups=groupe1,groupe2,...

Une liste séparée par des virgules des groupes qui sont autorisés à accéder au chroot source. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot. Cela deviendra l'option groups dans le chroot source.

source-root-users=utilisateur1,utilisateur2,...

Une liste séparée par des virgules des utilisateurs qui sont autorisés à devenir root dans le chroot source sans mot de passe. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur est dans users, il peut obtenir un accès avec un mot de passe). Cela deviendra l'option root-users dans le chroot source. Consultez la section “ Sécurité” ci-dessous.

source-root-groups=groupe1,groupe2,...

Une liste séparée par des virgules des groupes qui sont autorisés à devenir root dans le chroot source sans mot de passe. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un groupe auquel appartient l'utilisateur est dans groups, il peut obtenir cet accès avec un mot de passe). Cela deviendra l'option root-groups dans le chroot source. Consultez la section “ Sécurité” ci-dessous.

Options des chroots montables

mount-options=options

Les options de montage pour le périphérique bloc. Ce sont des options supplémentaires à passer à mount(8). Par exemple, “-o atime,sync,user_xattr”.

location=chemin

C'est le chemin vers le chroot à l'intérieur du système de fichiers sur le périphérique. Par exemple, si le système de fichiers contient un chroot dans /chroot/sid, vous spécifieriez ici “/chroot/sid”. Si le chroot est la seule chose sur le système de fichiers, c'est-à-dire que / est la racine du système de fichiers pour le chroot, cette option doit être laissée vide ou omise entièrement.

Options de chroot d'union de systèmes de fichiers

union-type=type

Définir le type d'union de systèmes de fichiers. Pour le moment les systèmes de fichiers pris en charge sont ‘aufs’, ‘overlayfs’, ‘overlay’ (à partir de Linux 4.0+) et ‘unionfs’. La valeur par défaut est ‘none’ qui désactive cette caractéristique.

union-mount-options=options

Options de montage des unions de systèmes de fichiers (configuration des branches), utilisées pour monter l'union de systèmes de fichiers spécifiés avec union-type. Cela remplacera la chaîne de caractères complète “-o” pour les montages et autorise la création d'unions de systèmes de fichiers complexes. Notez que ‘aufs’, ‘overlayfs’ et ‘unionfs’ prennent en charge différentes options de montage. Note : Il est possible d'utiliser les variables “${CHROOT_UNION_OVERLAY_DIRECTORY}” et “${CHROOT_UNION_UNDERLAY_DIRECTORY}” pour se référer respectivement au répertoire de surcouche de session inscriptible et au répertoire en lecture seule sous-jacent qui forment l'union. Consultez schroot-setup(5) pour une liste complète des variables.

union-overlay-directory=répertoire

Spécifier le répertoire où les répertoires de la surcouche inscriptible pour la session seront créés. Par défaut, il s'agit de ‘/var/lib/schroot/union/overlay’.

union-underlay-directory=répertoire

Spécifier le répertoire où les répertoires de la sous-couche en lecture seule seront créés. Par défaut, il s'agit de ‘/var/lib/schroot/union/underlay’.

Personnalisation

debian.apt-update=true
debian.distribution=unstable

DEBIAN_APT_UPDATE=true
DEBIAN_DISTRIBUTION=unstable

user-modifiable-keys=clé1,clé2,..

Définir les clés que l'utilisateur peut modifier en utilisant --option.

root-modifiable-keys=clé1,clé2,..

Définir les clés que le superutilisateur peut modifier en utilisant --option. Notez que le superutilisateur peut utiliser les clés définies dans user-modifiable-keys en plus des clés définies ici.

Localisation

description[en_GB]= Traduction anglaise britannique

description[fr]= Traduction française

NOMS DES CHROOTS

Generic

Unfortunately, not all the places that deal with chroot names can handle non-printable and other characters properly, and it's hard to update all of them. This is mostly about the various shell scripts where it's also unwise to assume authors always create safe code.

‘dpkg-old’

‘dpkg-dist’ ‘ dpkg-new’ ‘ dpkg-tmp’ Ces noms ne doivent pas apparaître à la fin du nom. Ce sont des copies de sauvegarde des fichiers de configuration utilisées par le gestionnaire de paquet dpkg, et seront ignorées.

SÉCURITÉ

Utilisateurs non fiables

Profils

EXEMPLE

# Exemple de 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
description[fr_FR]=Chroot fichier basé sur Debian sid
priority=3
groups=sbuild
file=/srv/chroots/sid.tar.gz

[sid-snapshot]
type=lvm-snapshot
description=Debian unstable LVM snapshot
description[fr_FR]=instantané LVM de Debian unstable
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

FICHIERS

Définitions des chroots

/etc/schroot/schroot.conf

Le fichier de configuration des chroots pour l'ensemble du système. Ce fichier doit être possédé par l'utilisateur root et être non inscriptible par les autres.

/etc/schroot/chroot.d

Des définitions de chroot supplémentaires peuvent être placées dans des fichiers de ce répertoire. Elles sont traitées de la même façon que /etc/schroot/schroot.conf. Chaque fichier peut contenir une ou plusieurs définitions de chroot.

Configuration des scripts de mise en place

config

Fichier de configuration principal lu par les scripts de mise en place. Le format de ce fichier est décrit dans schroot-script-config(5). C'est la valeur par défaut pour la clé script-config. Notez que précédemment il était nommé /etc/schroot/script-defaults. Les fichiers suivants sont référencés par défaut :

copyfiles

Une liste des fichiers à copier dans le chroot à partir du système hôte. Notez que précédemment elle était nommée /etc/schroot/copyfiles-defaults.

fstab

Un fichier au format décrit dans fstab(5), utilisé pour monter les systèmes de fichiers dans le chroot. Le point de montage est relatif à la racine du chroot. Notez que précédemment il était nommé /etc/schroot/mount-defaults.

nssdatabases

Bases de données système (comme décrit dans /etc/nsswitch.conf sur les systèmes GNU/Linux) à copier dans le chroot depuis l'hôte. Notez que précédemment cela était nommé /etc/schroot/nssdatabases-defaults.

AUTEURS

COPYRIGHT

VOIR AUSSI

TRADUCTION