.\" Copyright © 2005-2010 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. .\" .\" schroot is distributed in the hope that it will be useful, but .\" WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU .\" General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see .\" . .\" .ds RELEASE_DATE 14 Aug 2022 .ds VERSION 1.6.13 .ds SCHROOT_LIBEXEC_DIR /usr/lib/x86_64-linux-gnu/schroot .ds SCHROOT_MOUNT_DIR /var/run/schroot/mount .ds SCHROOT_SESSION_DIR /var/lib/schroot/session .ds SCHROOT_FILE_UNPACK_DIR /var/lib/schroot/unpack .ds SCHROOT_OVERLAY_DIR /var/lib/schroot/union/overlay .ds SCHROOT_UNDERLAY_DIR /var/lib/schroot/union/underlay .ds SCHROOT_SYSCONF_DIR /etc/schroot .ds SCHROOT_CONF /etc/schroot/schroot.conf .ds SCHROOT_CONF_CHROOT_D /etc/schroot/chroot.d .ds SCHROOT_CONF_SETUP_D /etc/schroot/setup.d .ds SCHROOT_DATA_DIR /usr/share/schroot .ds SCHROOT_SETUP_DATA_DIR /usr/share/schroot/setup .ds SCHROOT_LOCALE_DIR /usr/share/locale .ds PACKAGE_LOCALE_DIR /usr/share/locale .ds PROGRAM schroot .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SCHROOT\-SETUP 5 \*[RELEASE_DATE] "Version \*[VERSION]" "Debian sbuild" .SH NOM schroot\-setup —\ scripts de mise en place des chroots schroot .SH DESCRIPTION \fBschroot\fP utilise des scripts pour mettre en place et ensuite nettoyer les environnements de chroot. Le répertoire \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR 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é. .PP L'exécution des scripts se fait suivant l'ordre lexical des noms, comme pour ceux exécutés par \fBinit\fP(8), en utilisant le même style d'exécution que \fBrun\-parts\fP(8). .PP Les scripts de mise en place sont tous invoqués avec deux options\ : .IP 1 L'action à effectuer. .IP Quand une session est lancée, le chroot est mis en place en exécutant les scripts dans \*[SCHROOT_CONF_SETUP_D] avec l'option \[oq]setup\-start\[cq]. Quand la session est terminée, les scripts dans \fI\*[SCHROOT_CONF_SETUP_D]\fP sont exécutés dans l'ordre inverse avec l'option \[oq]setup\-stop\[cq]. .IP 2 Le statut du chroot. .IP C'est soit \[oq]ok\[cq] s'il n'y a aucun problème, soit \[oq]fail\[cq] si quelque chose s'est mal passé. Par exemple, certaines actions pourraient être ignorées en cas d'échec. .PP Notez que les scripts devraient être \fIidempotent\fP. Ils \fBdoivent\fP être idempotents pendant la phase \[oq]setup\-stop\[cq], car ils pourraient être exécutés plus d'une fois, par exemple en cas d'échec. .SH ENVIRONNEMENT .SS "Variables générales" .TP AUTH_USER Le nom d'utilisateur sous lequel la commande sera exécutée dans le chroot. .TP 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. .TP LIBEXEC_DIR Le répertoire dans lequel les programmes d'assistance sont situés. .TP 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 instantanés LVM). .TP PID L'identifiant de processus du processus schroot. .TP 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. .TP SESSION_ID Identifiant de session. .TP VERBOSE Défini à \[oq]quiet\[cq] si seuls les messages d'erreur doivent être affichés, \[oq]normal\[cq] pour afficher plus de messages et \[oq]verbose\[cq] si tous les messages doivent être affichés. Précédemment appelée AUTH_VERBOSITY. .TP CHROOT_SESSION_CREATE Défini à \[oq]true\[cq] si une session doit être créée, sinon \[oq]false\[cq]. .TP CHROOT_SESSION_CLONE Défini à \[oq]true\[cq] si une session doit être clonée, sinon \[oq]false\[cq]. .TP CHROOT_SESSION_PURGE Défini à \[oq]true\[cq] si une session doit être purgée, sinon \[oq]false\[cq]. .TP CHROOT_SESSION_SOURCE Défini à \[oq]true\[cq] si une session doit être créée depuis un chroot source, sinon \[oq]false\[cq]. .TP 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 instantanés LVM). .TP 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. .TP 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 d'un de ses noms d'alias ou du nom par défaut du chroot. Par exemple, il peut être utilisé pour spécifier des sources additionnelles dans \fI/etc/apt/sources.list\fP, comme un alias «\ stable\-security\ » pour un chroot «\ stable\ », ou un alias «\ experimental\ » pour un chroot «\ unstable\ ». .TP CHROOT_DESCRIPTION Description du chroot. .TP CHROOT_MOUNT_LOCATION Le lieu de montage du chroot. Il est utilisé pour la création et le montage des points de montage. .TP 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. .TP 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. .SS "Variables pour les chroots «\ plain\ » et «\ directory\ »" Ces types de chroot utilisent uniquement les variables générales. .SS "Variables pour les chroots fichier («\ file\ »)" .TP CHROOT_FILE Le fichier contenant les fichiers du chroot. .TP CHROOT_FILE_REPACK Défini à \[oq]true\[cq] pour recompacter le chroot dans une archive à la fin de la session, sinon \[oq]false\[cq]. .SS "Variables pour les chroots montables" .PP Ces variables sont seulement définies pour les types de chroot montables directement. .TP CHROOT_MOUNT_DEVICE Le périphérique à monter contenant le chroot. .TP CHROOT_MOUNT_OPTIONS Les options à passer à \fBmount\fP(8). .TP 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. .SS "Variables pour les chroots d'union de systèmes de fichiers" .TP CHROOT_UNION_TYPE Type d'union de systèmes de fichiers. .TP CHROOT_UNION_MOUNT_OPTIONS Options de montage des unions de systèmes de fichiers. .TP CHROOT_UNION_OVERLAY_DIRECTORY Répertoire pour la sur\-couche («\ overlay\ ») de l'union de systèmes de fichiers (inscriptible). .TP CHROOT_UNION_UNDERLAY_DIRECTORY Répertoire pour la sous\-couche («\ underlay\ ») de l'union de systèmes de fichiers (lecture\-seule). .SS "Variables des périphériques de type bloc" .TP 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 instantané LVM, ce sera le volume logique initial. .SS "Variables d'instantané LVM" .TP CHROOT_LVM_SNAPSHOT_NAME Nom de l'instantané à passer à \fBlvcreate\fP(8). .TP CHROOT_LVM_SNAPSHOT_DEVICE Le nom du périphérique de l'instantané LVM. .TP CHROOT_LVM_SNAPSHOT_OPTIONS Les options à passer à \fBlvcreate\fP(8). .SS "Variables personnalisées" .PP Les clés personnalisées définies dans \fIschroot.conf\fP seront mises en capitales et définies dans l'environnement comme décrit dans \fBschroot.conf\fP(5). .SH FICHIERS .SS "Configuration des scripts de mise en place" Le répertoire \f[BI]\*[SCHROOT_SYSCONF_DIR]/default\fR contient les configurations par défaut utilisées par les scripts de mise en place. .TP \f[BI]config\fR Fichier de configuration principal lu par les scripts de mise en place. Le format de ce fichier est décrit dans \fBschroot\-script\-config\fP(5). C'est la valeur par défaut pour la clé \f[CI]script\-config\fR. Notez que précédemment il était nommé \fI\*[SCHROOT_SYSCONF_DIR]/script\-defaults\fP. Les fichiers suivants sont référencés par défaut\ : .TP \f[BI]copyfiles\fR Une liste des fichiers à copier dans le chroot à partir du système hôte. Notez que précédemment elle était nommée \fI\*[SCHROOT_SYSCONF_DIR]/copyfiles\-defaults\fP. .TP \f[BI]fstab\fR Un fichier au format décrit dans \fBfstab\fP(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é \fI\*[SCHROOT_SYSCONF_DIR]/mount\-defaults\fP. .TP \f[BI]nssdatabases\fR Bases de données système (comme décrit dans \fI/etc/nsswitch.conf\fP sur les systèmes GNU/Linux) à copier dans le chroot depuis l'hôte. Notez que précédemment cela était nommé \fI\*[SCHROOT_SYSCONF_DIR]/nssdatabases\-defaults\fP. .SS "Scripts de mise en place" Le répertoire \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR contient les scripts de mise en place des chroots. .TP \f[BI]00check\fR Afficher les diagnostics de débogage et exécuter des vérifications d'intégrité. .TP \f[BI]05file\fR Décompresser, nettoyer et recompresser les chroots basés sur les fichiers. .TP \f[BI]05fsunion\fR Créer et enlever les unions de systèmes de fichiers. .TP \f[BI]05lvm\fR Créer et enlever les instantanés LVM. .TP \f[BI]10mount\fR Monter et démonter les systèmes de fichiers. .TP \f[BI]15binfmt\fR 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. .TP \f[BI]15killprocs\fR 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. .TP \f[BI]20copyfiles\fR Copier les fichiers depuis le système hôte dans le chroot. Par exemple, configurer le réseau en copiant \fIhosts\fP et \fIresolv.conf\fP. .TP \f[BI]20nssdatabases\fR Configurer les bases de données du système en copiant passwd, shadow, group,\ etc., dans le chroot. .TP \f[BI]50chrootname\fR Définir le nom de chroot (\fI/etc/debian_chroot\fP) dans le chroot. Il peut être utilisé par une invite de commande pour afficher le chroot courant. .SH AUTEURS Roger Leigh. .SH COPYRIGHT Copyright \(co 2005\-2012 Roger Leigh \f[CR]\fR .PP \fB\*[PROGRAM]\fP 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. .SH "VOIR AUSSI" \fBschroot\fP(1), \fBfstab\fP(5), \fBschroot.conf\fP(5), \fBschroot\-script\-config\fP(5), \fBrun\-parts\fP(8). .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: .\"# mode:nroff .\"# fill-column:79 .\"# End: .SH TRADUCTION Ce document est une traduction, réalisée par Thomas Blein le 30 mai 2012. L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise de ce document est toujours consultable en ajoutant l'option «\ \-L C\ » à la commande \fBman\fR. N'hésitez pas à signaler à l'auteur ou à la liste de traduction .nh <\fIdebian\-l10n\-french@lists.debian.org\fR>, .hy selon le cas, toute erreur dans cette page de manuel.