Provided by: schroot_1.6.8-1ubuntu1.1_amd64 
NOM
schroot-setup — scripts de mise en place des chroots schroot
DESCRIPTION
schroot utilise des scripts pour mettre en place et ensuite nettoyer les environnements de
chroot. Le répertoire /etc/schroot/setup.d contient des scripts qui sont exécutés lorsque
un chroot est créé ou détruit. Plusieurs variables d'environnements sont définies quand
les scripts sont exécutés, ce qui permet de personnaliser leur comportement, par exemple
en fonction du type de chroot utilisé.
L'exécution des scripts se fait suivant l'ordre lexical des noms, comme pour ceux exécutés
par init(8), en utilisant le même style d'exécution que run-parts(8).
Les scripts de mise en place sont tous invoqués avec deux options :
1 L'action à effectuer.
Quand une session est lancée, le chroot est mis en place en exécutant les scripts
dans /etc/schroot/setup.d avec l'option ‘setup-start’. Quand la session est
terminée, les scripts dans /etc/schroot/setup.d sont exécutés dans l'ordre inverse
avec l'option ‘setup-stop’.
2 Le statut du chroot.
C'est soit ‘ok’ s'il n'y a aucun problème, soit ‘fail’ si quelque chose s'est mal
passé. Par exemple, certaines actions pourraient être ignorées en cas d'échec.
Notez que les scripts devraient être idempotent. Ils doivent être idempotent pendant la
phase ‘setup-stop’, car ils pourraient être exécutés plus d'une fois, par exemple en cas
d'échec.
ENVIRONNEMENT
Variables générales
AUTH_USER
Le nom d'utilisateur sous lequel la commande sera exécutée dans le chroot.
CHROOT_NAME
Le nom du chroot. Notez que c'est le nom du chroot d'origine avant la création de
session ; vous voulez probablement SESSION_ID.
HOST
HOST_OS
HOST_VENDOR
HOST_CPU
L'architecture du système hôte sur lequel schroot est exécuté. Cela peut être
utilisé pour des comportements spécifiques à l'architecture dans les scripts de
mise en place quand cela est nécessaire. HOST est le triplet GNU pour
l'architecture, alors que HOST_OS, HOST_VENDOR et HOST_CPU sont les parties
composant ce triplet.
LIBEXEC_DIR
Le répertoire dans lequel les programmes d'assistance sont localisés.
MOUNT_DIR
Le répertoire dans lequel les chroots non système de fichiers sont montés (par
exemple périphériques de blocs et clichés LVM).
PID L'identifiant de processus du processus schroot.
PLATFORM
Le système d'exploitation de la plate-forme sur laquelle schroot est exécuté. Il
peut être utilisé pour introduire des comportements dépendant de la plate-forme
dans les scripts de mise en place quand cela est nécessaire. Notez que les
variables HOST sont probablement ce qui est requis. Dans le contexte de schroot, la
plate-forme est la configuration prise en charge et le comportement pour une
architecture donnée, et peut être identique parmi plusieurs architectures.
SESSION_ID
Identifiant de session.
VERBOSE
Définir à ‘quiet’ si seuls les messages d'erreur doivent être affichés, ‘normal’
pour afficher plus de messages et ‘verbose’ si tous les messages doivent être
affichés. Précédemment appelée AUTH_VERBOSITY.
CHROOT_SESSION_CREATE
Définir à ‘true’ si une session sera créée, sinon ‘false’.
CHROOT_SESSION_CLONE
Définir à ‘true’ si une session sera clonée, sinon ‘false’.
CHROOT_SESSION_PURGE
Définir à ‘true’ si une session sera purgée, sinon ‘false’.
CHROOT_TYPE
Le type de chroot. C'est utile pour restreindre une tâche de mise en place à des
types de chroot particuliers (par exemple seulement les périphériques de blocs ou
les clichés LVM).
CHROOT_NAME
Le nom du chroot. C'est utile pour restreindre une tâche de mise en place à un
chroot particulier ou un ensemble de chroots.
CHROOT_ALIAS
Le nom de l'alias utilisé pour sélectionner le chroot. C'est utile pour spécialiser
une tâche de mise en place en fonction de l'un de ses noms d'alias, ou le nom par
défaut du chroot. Par exemple, il peut être utilisé pour spécifier des sources
additionnelles dans /etc/apt/sources.list, comme un alias « stable-security » pour
un chroot « stable », ou un alias « experimental » pour un chroot « unstable ».
CHROOT_DESCRIPTION
Description du chroot.
CHROOT_MOUNT_LOCATION
Le lieu de montage du chroot. Il est utilisé pour la création et le montage des
points de montage.
CHROOT_LOCATION
La localisation du chroot à l'intérieur du point de montage. Cela permet
d'autoriser plusieurs chroots sur un système de fichiers unique. Définie pour
l'ensemble des types de chroot.
CHROOT_PATH
Le chemin absolu du chroot. C'est typiquement CHROOT_MOUNT_LOCATION et
CHROOT_LOCATION concaténés ensemble. C'est le chemin qui doit être utilisé pour
accéder aux chroots.
Variables pour les chroots « plain » et « directory »
Ces types de chroot utilisent uniquement les variables générales.
Variables pour les chroots fichier (« file »)
CHROOT_FILE
Le fichier contenant les fichiers du chroot.
CHROOT_FILE_REPACK
Définir à ‘true’ pour recompacter le chroot dans une archive à la fin de la
session, sinon ‘false’.
Variables pour les chroots montables
Ces variables sont seulement définies pour les types de chroot montables directement.
CHROOT_MOUNT_DEVICE
Le périphérique à monter contenant le chroot.
CHROOT_MOUNT_OPTIONS
Les options à passer à mount(8).
CHROOT_LOCATION
La localisation du chroot à l'intérieur du point de montage. Permet d'autoriser
l'existence de plusieurs chroots sur un système de fichiers unique.
Variables pour les chroots d'union de systèmes de fichiers
CHROOT_UNION_TYPE
Type d'union de systèmes de fichiers.
CHROOT_UNION_MOUNT_OPTIONS
Options de montage des unions de systèmes de fichiers.
CHROOT_UNION_OVERLAY_DIRECTORY
Répertoire pour la sur-couche (« overlay ») de l'union de systèmes de fichiers
(inscriptible).
CHROOT_UNION_UNDERLAY_DIRECTORY
Répertoire pour la sous-couche (« underlay ») de l'union de systèmes de fichiers
(lecture-seule).
Variables des périphériques de type bloc
CHROOT_DEVICE
Le périphérique contenant le système de fichiers root du chroot. C'est normalement,
mais non nécessairement, le périphérique qui sera monté. Par exemple pour un cliché
LVM, ce sera le volume logique initial.
Variables de clichés LVM
CHROOT_LVM_SNAPSHOT_NAME
Nom du cliché à passer à lvcreate(8).
CHROOT_LVM_SNAPSHOT_DEVICE
Le nom du périphérique de cliché LVM.
CHROOT_LVM_SNAPSHOT_OPTIONS
Les options à passer à lvcreate(8).
Variables personnalisées
Les clés personnalisées définies dans schroot.conf seront capitalisées et définies dans
l'environnement comme décrit dans schroot.conf(5).
FICHIERS
Configuration des scripts de mise en place
Le répertoire /etc/schroot/default contient les configurations par défaut utilisées par
les 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
Base 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 elle était
nommée /etc/schroot/nssdatabases-defaults.
Scripts de mise en place
Le répertoire /etc/schroot/setup.d contient les scripts de mise en place des chroots.
00check
Afficher les diagnostics de débogage et exécute des vérifications d'intégrité.
05file Décompresser, nettoyer, et recompresser les chroots basés sur les fichiers.
05fsunion
Créer et enlever les unions de système de fichiers.
05lvm Créer et enlever les clichés LVM.
10mount
Monter et démonter les systèmes de fichiers.
15binfmt
Mettre en place l'émulateur QEMU en utilisant binfmt-support. Cela permet
d'utiliser de manière transparente un chroot pour une architecture CPU différente,
fournissant une alternative à la compilation croisée ou à l'émulation d'une machine
complète.
15killprocs
Tuer les processus qui continuent à s'exécuter dans le chroot quand une session se
termine et qui pourraient empêcher le démontage des systèmes de fichiers et le
nettoyage des autres ressources.
20copyfiles
Copier les fichiers depuis le système hôte dans le chroot. Par exemple, configure
le réseau en copiant hosts et resolv.conf.
20nssdatabases
Configurer les bases de données du système en copiant passwd, shadow, group, etc.
dans le chroot.
50chrootname
Définir le nom de chroot (/etc/debian_chroot) dans le chroot. Il peut être utilisé
par une invite de commande pour afficher le chroot courant.
AUTEURS
Roger Leigh.
COPYRIGHT
Copyright © 2005-2012 Roger Leigh <rleigh@debian.org>
schroot est un logiciel libre : vous pouvez le redistribuer et/ou le modifier aux
conditions définies dans la licence publique générale GNU telle que publiée par la Free
Software Foundation ; version 2 ou, selon votre préférence, toute version ultérieure.
VOIR AUSSI
schroot(1), fstab(5), schroot.conf(5), schroot-script-config(5), run-parts(8).