Provided by: schroot_0.2.8-1ubuntu1_i386 bug

NAME

       schroot-setup - schroot chroot setup scripts

DESCRIPTION

       schroot  uses  scripts  to  to  set  up  and  then  clean up the chroot
       environment.      The     directories     /etc/schroot/setup.d      and
       /etc/schroot/exec.d  contain  scripts  run when a chroot is created and
       destroyed, and entered and  left,  respectively.   Several  environment
       variables  are  set while the scripts are being run, which allows their
       behaviour to be customised, depending upon, for example,  the  type  of
       chroot in use.

       The  scripts are run in name order, like those run by init(8), by using
       run-parts(8).

       The setup scripts are all invoked with two options:

       1      The action to perform.

              When a session is first started, the chroot is set up by running
              the  scripts  in  /etc/schroot/setup.d  with  the  “setup-start”
              option.  When a command  or  shell  is  run  in  the  configured
              chroot,  the  scripts  in  /etc/schroot/exec.d  are run with the
              “exec-start”  option.   After  the  command   or   command   has
              completed,  the  scripts  are  run  in  reverse  order  with the
              “exec-stop” option.  Finally, when the  session  is  ended,  the
              scripts  in  /etc/schroot/setup.d  are run in reverse order with
              the “setup-stop” option.

       2      The chroot status.

              This is either “ok” if there  are  no  problems,  or  “fail”  if
              something  went  wrong.   For example, particular actions may be
              skipped on failure.

ENVIRONMENT

   General variables
       AUTH_USER
              The username of the user the command in the chroot will run  as.

       AUTH_VERBOSITY
              Set  to  “quiet”  if  only  error  messages  should  be printed,
              “normal” if other messages may be printed as well, and “verbose”
              if all messages may be printed.

       MOUNT_DIR
              The  directory  under  which  non-filesystem chroots are mounted
              (e.g. block devices and LVM snapshots).

       LIBEXEC_DIR
              The directory under which helper programs are located.

       PID    The process ID of the schroot process.

       SESSION_ID
              The session identifier.

       CHROOT_TYPE
              The type of the chroot.  This is useful for restricting a  setup
              task  to  particular types of chroot (e.g. only block devices or
              LVM snapshots).

       CHROOT_NAME
              The name of the chroot.  This is useful for restricting a  setup
              task to a particular chroot, or set of chroots.

       CHROOT_DESCRIPTION
              The description of the chroot.

       CHROOT_MOUNT_LOCATION
              The  location  to  mount the chroot.  It is used for mount point
              creation and mounting.

       CHROOT_LOCATION
              The location of the chroot inside the mount point.  This  is  to
              allow multiple chroots on a single filesystem.

       CHROOT_PATH
              The   absolute   path   to   the   chroot.   This  is  typically
              CHROOT_MOUNT_LOCATION and CHROOT_LOCATION concatenated together.
              This is the path which should be used to access the chroots.

       CHROOT_MOUNT_DEVICE
              The  device containing the chroot root filesystem.  This is only
              set for chroots which require mounting.

   Plain chroot variables
       CHROOT_LOCATION
              The location of the chroot.  This is useful for creating  files,
              or copying files into the chroot.

   File variables
       CHROOT_FILE
              The file containing the chroot files.

       CHROOT_FILE_REPACK
              Set  to  “true”  to  repack  the  chroot into an archive file on
              ending a session, otherwise “false”.

   Block device variables
       CHROOT_DEVICE
              The device containing the chroot root filesystem.  This usually,
              but  not  necessarily  the  device  which  will be mounted.  For
              example, an LVM snapshot  this  will  be  the  original  logical
              volume.

       CHROOT_MOUNT_OPTIONS
              Options to pass to mount(8).

   LVM snapshot variables
       CHROOT_LVM_SNAPSHOT_NAME
              Snapshot name to pass to lvcreate(8).

       CHROOT_LVM_SNAPSHOT_DEVICE
              The name of the LVM snapshot device.

       CHROOT_LVM_SNAPSHOT_OPTIONS
              Options to pass to lvcreate(8).

FILES

   /etc/schroot/setup.d
       The system-wide chroot setup directory.

       00check
              Print debugging diagnostics and perform basic sanity checking.

       05file Unpack, clean up, and repack file-based chroots.

       05lvm  Create and remove LVM snapshots.

       10mount
              Mount and unmount filesystems.

       20network
              Configure  networking  by  copying  resolv.conf  from  the  host
              system.

       30passwd
              Configure passwd, shadow and groups in the chroot.  This  copies
              the files from the host system.

       50chrootname
              Set  the  chroot  name (/etc/debian_chroot) in the chroot.  This
              may be used by the shell prompt to display the current chroot.

       50sbuild
              If  sbuild(1)  is  installed,  set  up  the  build  directories,
              including  ownership  and permissions, inside the chroot for use
              by sbuild.

   /etc/schroot/exec.d
       The system-wide chroot execution directory

       00check
              Print debugging diagnostics and perform basic sanity checking.

AUTHORS

       Roger Leigh.

COPYRIGHT

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

       This program 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 2 of the License, or (at  your
       option) any later version.

SEE ALSO

       sbuild(1), schroot.conf(5), run-parts(8).