Provided by: dchroot_1.6.8-1ubuntu1.1_amd64 bug

NOM

       dchroot - entrer dans un environnement de chroot.

RÉSUMÉ

       dchroot  [-h|--help  |  -V|--version  |  -l|--list  |  -i|--info  | --config | --location]
       [--directory=répertoire]  [-d|--preserve-environment]  [-q|--quiet  |  -v|--verbose]   [-c
       chroot|--chroot=chroot | --all] [COMMANDE [ ARG1 [ ARG2 [ ARGn]]]]

DESCRIPTION

       dchroot  autorise  l'utilisateur à exécuter une commande ou un interpréteur de commande de
       connexion  dans  un  environnement  chrooté.  Si  aucune  commande  n'est   précisée,   un
       interpréteur  de  commande  de  connexion  sera  démarré  dans  le répertoire personnel de
       l'utilisateur dans le chroot.

       La commande est un ou plusieurs arguments  qui  seront  exécutés  dans  l'interpréteur  de
       commandes  par  défaut  de l'utilisateur en utilisant l'option -c. Par conséquent, du code
       shell peut être embarqué dans cet argument. Si  de  multiples  options  de  commande  sont
       utilisées,  elles  sont  concaténées  ensemble, séparées par des espaces. Les utilisateurs
       doivent faire attention aux problèmes de citation que cela présente, et  doivent  utiliser
       schroot si nécessaire, qui ne présente pas ces problèmes de citation.

       Le répertoire dans lequel la commande ou l'interpréteur de commandes initial sont exécutés
       dépend du contexte. Voir l'option --directory ci-dessous pour une description complète.

       Cette version de dchroot est  une  encapsulation  de  compatibilité  autour  du  programme
       schroot(1). Elle est fournie à des fins de rétro-comptabilité avec les options de ligne de
       commande de dchroot, mais schroot est recommandé pour des utilisations futures.  Voyez  la
       section  “Incompatibilités”  ci-dessous  pour plus d'informations sur des incompatibilités
       connues avec des versions plus anciennes de dchroot.

       Si aucun chroot n'est spécifié, le nom de chroot ou alias  ‘default’  sera  utilisé  à  la
       place.

OPTIONS

       dchroot accepte les options suivantes :

   Options basiques
       -h, --help
              Afficher un résumé de l'aide.

       -a, --all
              Sélectionner tous les chroots.

       -c, --chroot=chroot
              Spécifier un chroot à utiliser. Cette option peut être utilisée plusieurs fois pour
              spécifier plus d'un chroot, dans ce cas elle a un effet similaire à --all.

       -l, --list
              Lister tous les chroots disponibles.

       -i, --info
              Afficher des informations détaillées à propos des chroots spécifiés. Notez que  les
              versions précédentes de dchroot n'incluent pas cette option.

       -p, --path
              Afficher l'emplacement (chemin) des chroots sélectionnés.

       --config
              Afficher  la  configuration  des  chroots spécifiés. C'est utile pour tester que la
              configuration utilisée est la même que celle du fichier de configuration. Tous  les
              commentaires  du  fichier original sont omis. Notez que les versions précédentes de
              dchroot n'incluent pas cette option.

       --directory=répertoire
              Se déplacer dans le répertoire dans le  chroot  avant  d'exécuter  la  commande  ou
              l'interpréteur  de  commande  de  connexion. Si le répertoire n'est pas disponible,
              dchroot se terminera par un état d'erreur.

              Le comportement par défaut est comme  suit  (tous  les  répertoires  sont  dans  le
              chroot).  Sauf  si  l'option  --preserve-environment  est  utilisée  pour préserver
              l'environnement, l'interpréteur de  commande  de  connexion  ou  la  commande  sera
              exécuté  dans  le répertoire personnel de l'utilisateur, ou dans / si le répertoire
              personnel n'est pas disponible. Quand l'option --preserve-environment est utilisée,
              une  exécution  dans le répertoire courant sera utilisée, se rabattant sur / si non
              accessible. Si aucun des répertoires n'est disponible, dchroot se terminera par  un
              état d'erreur.

       -d, --preserve-environment
              Préserver  l'environnement  de  l'utilisateur  à  l'intérieur de l'environnement de
              chroot. Par défaut  un  environnement  propre  est  utilisé ;  cette  option  copie
              l'ensemble de l'environnement de l'utilisateur et le met en place dans la session.

       -q, --quiet
              Afficher uniquement les messages essentiels.

       -v, --verbose
              Afficher  tous  les  messages.  Notez  que  les  versions  précédentes  de  dchroot
              n'incluent pas cette option.

       -V, --version
              Afficher les informations de version.

       Notez que les versions précédentes de dchroot ne fournissent pas les options longues.

INCOMPATIBILITÉS

   Debian dchroot antérieur à la version 0.99.0
       •      Les messages d'information sont formulés et formatés différemment.

       •      su(1) n'est plus utilisé  pour  exécuter  les  commandes  dans  le  chroot ;  c'est
              effectué  en  interne  par  dchroot.  Ce  changement  peut  causer  des différences
              subtiles. Si vous trouvez une incompatibilité, merci de le  signaler  pour  qu'elle
              puisse être corrigée.

       •      dchroot  fournit  un nombre restreint des fonctionnalités implémentées par schroot,
              mais c'est quand même schroot qui est en-dessous. Par conséquent dchroot est encore
              soumis  aux  vérifications  de  sécurité de schroot, incluant l'authentification et
              autorisation PAM et la gestion des sessions, par exemple, et par conséquent peut se
              comporter  légèrement  différemment  des  versions  plus  anciennes de dchroot dans
              certaines circonstances.

   Debian dchroot antérieur à la version 1.5.1
       •      Cette version de dchroot utilise schroot.conf pour sauver la configuration pour les
              chroots  disponibles,  au  lieu  du  fichier  dchroot.conf  utilisé historiquement.
              dchroot prend en charge la migration automatique de dchroot.conf vers le format  de
              fichier par clé de schroot.conf avec l'option --config des versions 0.2.2 à 1.5.0 ;
              la prise en charge des formats plus anciens n'est plus disponible.

   dchroot DSA
       Les machines exécutées par les Administrateurs Système Debian pour le projet Debian ont un
       paquet dchroot-dsa qui fourni une implémentation alternative de dchroot.

       •      Toutes les incompatibilités ci-dessus s'appliquent.

       •      Cette  version  de  dchroot  possède des options de ligne de commande incompatibles
              alors que certaines de ces options sont supportées ou ont des options  équivalentes
              avec un nom différent, l'option -c n'est pas nécessaire pour spécifier un chroot et
              cette version  de  dchroot  ne  peut  pas  implémenter  ce  comportement  de  façon
              rétro-compatible  (parce  que si -c est omis, le chroot par défaut est utilisé). Le
              dchroot DSA utilise le premier argument non-option  comme  chroot  à  utiliser,  ne
              permettant l'utilisation que d'un seul chroot à la fois.

RÉPERTOIRES DE SUBSTITUTION

       dchroot  sélectionnera  un répertoire approprié à utiliser à l'intérieur du chroot suivant
       si les options --directory ou --preserve-environment sont utilisées. Quand  un  répertoire
       est  explicitement  spécifié, seul un répertoire sera utilisé pour des raisons de sécurité
       et d'intégrité. Notez qu'à cause des multiples solutions de  repli  considérées  pour  les
       commandes,  il  est  dangereux  d'exécuter  des  commandes en utilisant dchroot ; utiliser
       schroot à la place. Les sous-sections suivantes listent  les  séquences  de  solutions  de
       repli  pour  chaque  cas.  CWD est le répertoire de travail courant, DIR est le répertoire
       spécifié par --directory.

   Interpréteur de commande de connexion ou commande
       ┌────────────────────┬──────────────────────────────────────────┐
       │Transition          │                                          │
       │(Hôte → Chroot)     │ Commentaire                              │
       ├────────────────────┼──────────────────────────────────────────┤
       │CWD → passwd pw_dir │ Comportement normal (si  ni  --directory │
       │                    │ ni --preserve-environment ne sont        │
       │                    │  utilisés)                               │
       │CWD → /             │ Si passwd pw_dir n'existe pas            │
       │FAIL                │ Si / n'existe pas                        │
       └────────────────────┴──────────────────────────────────────────┘
   --preserve-environment est utilisé
       ┌────────────────┬──────────────────────────────────────────┐
       │Transition      │                                          │
       │(Hôte → Chroot) │ Commentaire                              │
       ├────────────────┼──────────────────────────────────────────┤
       │CWD → CWD       │ Comportement          normal         (si │
       │                │ --preserve-environment     n'est     pas │
       │                │ utilisé)                                 │
       │CWD → /         │ Si CWD n'existe pas                      │
       │FAIL            │ Si / n'existe pas                        │
       └────────────────┴──────────────────────────────────────────┘
   utilisation de --directory
       ┌────────────────┬──────────────────────────────────────────┐
       │Transition      │                                          │
       │(Hôte → Chroot) │ Commentaire                              │
       ├────────────────┼──────────────────────────────────────────┤
       │CWD → DIR       │ Comportement normal                      │
       │FAIL            │ Si DIR n'existe pas                      │
       └────────────────┴──────────────────────────────────────────┘
       Aucune solution de repli ne devrait exister en toute circonstance.

   Débogage
       Notez que --debug=notice affichera la liste interne des répertoires de repli calculée pour
       la session.

EXEMPLES

       $ dchroot -l↵
       Available chroots: sarge [default], sid

       $ dchroot -p sid↵
       /srv/chroot/sid

       $ dchroot -q -c sid -- uname -smr↵
       Linux 2.6.16.17 ppc
       $ dchroot -q -c sid -- "uname -smr"↵
       Linux 2.6.16.17 ppc

       $ dchroot -q -c sid "ls -1 / | tac | head -n 4"↵
       var
       usr
       tmp
       sys

       $ dchroot -c sid↵
       I: [sid chroot] Running login shell: “/bin/bash”
       $

       Utilisez -- pour autoriser les options débutant avec  ‘-’  ou  ‘--’  pour  la  commande  à
       exécuter  dans  le chroot. Cela empêche qu'elles soient interprétées en tant qu'options de
       dchroot. Notez que la première ligne a été affichée sur l'erreur standard, et le reste sur
       la  sortie  standard.  C'est intentionnel, pour que la sortie du programme exécuté dans le
       chroot puisse être redirigée via un pipe ou autre si besoin ; les données seront les mêmes
       que si la commande était exécutée directement sur le système hôte.

DÉPANNAGES

       Si  quelque  chose ne fonctionne pas, et qu'il n'est pas facile de déterminer ce qui ne va
       pas à partir des messages d'erreur, vous  pouvez  utiliser  l'option  --debug=niveau  pour
       activer  les  messages  de débogage. Cela donnera un plus grand nombre d'informations. Les
       niveaux de débogage valides sont ‘none’, ‘notice’, ‘info’,  ‘warning’  et  ‘critical’  par
       ordre croissant de sévérité. Plus le niveau de sévérité est faible, plus il y a de sortie.

       Si  vous avez toujours des problèmes, les développeurs peuvent être contactés sur la liste
       de diffusion (en anglais) :
       Debian buildd-tools Developers
       <buildd-tools-devel@lists.alioth.debian.org>

BOGUES

       Sur les architectures mips et mipsel, les noyaux Linux, jusqu'à la version 2.6.17 incluse,
       ont  une  prise en charge cassée des personality(2), qui a pour conséquence un échec de la
       mise en place  des  personnalités.  Cela  se  manifeste  par  une  erreur  “Operation  not
       permitted”  (EPERM). Pour contourner ce problème, définissez personality à ‘undefined’, ou
       mettez à jour votre noyau vers une version plus récente.

FICHIERS

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

AUTEURS

       Roger Leigh.

       L'implémentation  de dchroot utilise les mêmes options de ligne de commande que le dchroot
       d'origine de David Kimdon <dwhedon@debian.org>, mais est une implémentation indépendante.

COPYRIGHT

       Copyright © 2005-2012 Roger Leigh <rleigh@debian.org>

       dchroot 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), sbuild(1), chroot(2), schroot-setup(5), schroot.conf(5).