febootstrap-run.pod

   1 =head1 NAME
   2
   3 febootstrap-run - Run extra commands in febootstrap root filesystem
   4
   5 =head1 SYNOPSIS
   6
   7  febootstrap-run [--options] DIR [--] [CMD ...]
   8
   9 =head1 DESCRIPTION
  10
  11 This can be used to run extra commands in the febootstrap root
  12 filesystem.  It is just a simple wrapper around the standard
  13 C<fakeroot> and C<fakechroot> commands.
  14
  15 If given, the C<CMD ...> is run inside the root filesystem.  The
  16 command acts as if it was run as root and chrooted into the root
  17 filesystem.
  18
  19 If the command is omitted, then we start a shell.
  20
  21 If C<CMD ...> could contain anything starting with a C<-> character
  22 then use C<--> to separate C<febootstrap-run> parameters from the
  23 command:
  24
  25  febootstrap-run ./f10 -- ls -l
  26
  27 =head1 OPTIONS
  28
  29 =over 4
  30
  31 =item B<--ro>
  32
  33 Usually any changes to permissions made by the command are recorded in
  34 the C<fakeroot.log> file.  However if C<--ro> flag is given, then
  35 changes to permissions are not recorded.  (Note: changes to file
  36 contents still happen).
  37
  38 =back
  39
  40 =head1 ENVIRONMENT VARIABLES
  41
  42 Some L<fakechroot(1)> environment variables are applicable.  In
  43 particular you may want to set:
  44
  45  export FAKECHROOT_EXCLUDE_PATH=/proc
  46
  47 =head1 SEE ALSO
  48
  49 L<febootstrap(8)>,
  50 L<fakeroot(1)>,
  51 L<fakechroot(1)>.
  52
  53 =head1 AUTHORS
  54
  55 Richard W.M. Jones <rjones @ redhat . com>
  56
  57 =head1 COPYRIGHT
  58
  59 (C) Copyright 2009 Red Hat Inc.,
  60 L<http://et.redhat.com/~rjones/febootstrap>.
  61
  62 This program is free software; you can redistribute it and/or modify
  63 it under the terms of the GNU General Public License as published by
  64 the Free Software Foundation; either version 2 of the License, or
  65 (at your option) any later version.
  66
  67 This program is distributed in the hope that it will be useful,
  68 but WITHOUT ANY WARRANTY; without even the implied warranty of
  69 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  70 GNU General Public License for more details.
  71
  72 You should have received a copy of the GNU General Public License
  73 along with this program; if not, write to the Free Software
  74 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.