virt-subproc/adt-virt-chroot.1

   1 .TH adt\-virt\-chroot 1 2007 autopkgtest "Linux Programmer's Manual"
   2 .SH NAME
   3 adt\-virt\-chroot \- autopkgtest virtualisation server using a chroot
   4 .SH SYNOPSYS
   5 .B adt\-virt\-chroot
   6 .RI [ options ]
   7 .BR = [\fBchroot\-name\fR]
   8 .br
   9 .B adt\-virt\-chroot
  10 .RI [ options ]
  11 .RI [\fB\-r\fR gain\-root\-cmd ]
  12 .I /path/to/chroot
  13 .SH DESCRIPTION
  14 .B adt\-virt\-chroot
  15 provides an autopkgtest virtualisation server using a chroot install
  16 (or similar).
  17
  18 Normally
  19 .B adt-virt-chroot
  20 will be invoked by
  21 .BR adt-run .
  22
  23 The chroot to use must be specified.  If it starts with a
  24 .B =
  25 character then it is taken to be a chroot name known to
  26 .BR dchroot (8).
  27 Otherwise it must start with a
  28 .B /
  29 and will be taken to an absolute path.
  30 .SH OPTIONS
  31 .TP
  32 .BR \-\-gain\-root | \-r " \fIgain\-root\-cmd\fR"
  33 Specifies that
  34 .B adt-virt-chroot
  35 can become root (on the host) by prefixing its commands with
  36 .IR gain-root-cmd .
  37 The command may consist of several words separated by whitespace,
  38 in which case words other than the first are supplied as additional
  39 arguments to the command; other shell (or other) metacharacters in
  40 .IR gain-root-cmd
  41 are not interpreted or modified by
  42 .BR adt-virt-chroot .
  43 The actual command to be run as root, and
  44 its arguments, are supplied as additional (separate) arguments to
  45 .IR gain-root-cmd .
  46
  47 Root privilege is needed, to successfully run
  48 .BR chroot (8),
  49 if the chroot to use is specified as an absolute path.  The default is
  50 not to take any special action when root will be needed, in which case
  51 for an absolute path chroot,
  52 .B adt-virt-chroot
  53 must be started as root.
  54 .TP
  55 .BR \-d " | " \-\-debug
  56 Enables debugging output.  Probably not hugely interesting.
  57
  58 .SH INPUT, OUTPUT AND EXIT STATUS
  59 The behaviour of
  60 .B adt-virt-chroot
  61 is as described by the AutomatedTesting virtualisation regime
  62 specification.
  63
  64 .SH SEE ALSO
  65 \fBadt\-run\fR(1),
  66 \fBadt\-virt-null\fR(1),
  67 \fBadt\-virt-xenlvm\fR(1),
  68 \fB/usr/share/doc/autopkgtest/\fR.
  69
  70 .SH AUTHORS AND COPYRIGHT
  71 This manpage is part of autopkgtest, a tool for testing Debian binary
  72 packages.  autopkgtest is Copyright (C) 2006-2007 Canonical Ltd and others.
  73
  74 See \fB/usr/share/doc/autopkgtest/CREDITS\fR for the list of
  75 contributors and full copying conditions.