1FEBOOTSTRAP-RUN(8)          Virtualization Support          FEBOOTSTRAP-RUN(8)
2
3
4

NAME

6       febootstrap-run - Run extra commands in febootstrap root filesystem
7

SYNOPSIS

9        febootstrap-run [--options] DIR [--] [CMD ...]
10

DESCRIPTION

12       This can be used to run extra commands in the febootstrap root
13       filesystem.  It is just a simple wrapper around the standard "fakeroot"
14       and "fakechroot" commands.
15
16       If given, the "CMD ..." is run inside the root filesystem.  The command
17       acts as if it was run as root and chrooted into the root filesystem.
18
19       If the command is omitted, then we start a shell.
20
21       If "CMD ..." could contain anything starting with a "-" character then
22       use "--" to separate "febootstrap-run" parameters from the command:
23
24        febootstrap-run ./f10 -- ls -l
25

OPTIONS

27       --ro
28           Usually any changes to permissions made by the command are recorded
29           in the "fakeroot.log" file.  However if "--ro" flag is given, then
30           changes to permissions are not recorded.  (Note: changes to file
31           contents still happen).
32

EXAMPLES

34       Remove a directory subtree safely:
35
36        febootstrap-run initramfs -- rm -r /etc
37
38       (This requires that you have a compatible 'rm' command in the root).
39
40       Another way to do complex operations from a script is to export a
41       function:
42
43        #!/bin/bash
44
45        do_stuff ()
46        {
47            # complex operations inside the root
48        }
49        export -f do_stuff
50        febootstrap-run root -- bash -c do_stuff
51

ENVIRONMENT VARIABLES

53       Some fakechroot(1) environment variables are applicable.  In particular
54       you may want to set:
55
56        export FAKECHROOT_EXCLUDE_PATH=/proc
57

SEE ALSO

59       febootstrap(8), febootstrap-install(8), fakeroot(1), fakechroot(1).
60

AUTHORS

62       Richard W.M. Jones <rjones @ redhat . com>
63
65       (C) Copyright 2009 Red Hat Inc.,
66       <http://people.redhat.com/~rjones/febootstrap>.
67
68       This program is free software; you can redistribute it and/or modify it
69       under the terms of the GNU General Public License as published by the
70       Free Software Foundation; either version 2 of the License, or (at your
71       option) any later version.
72
73       This program is distributed in the hope that it will be useful, but
74       WITHOUT ANY WARRANTY; without even the implied warranty of
75       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
76       General Public License for more details.
77
78       You should have received a copy of the GNU General Public License along
79       with this program; if not, write to the Free Software Foundation, Inc.,
80       675 Mass Ave, Cambridge, MA 02139, USA.
81
82
83
84febootstrap-2.9                   2010-09-17                FEBOOTSTRAP-RUN(8)
Impressum