---
name: "febootstrap-run"
section: "8"
platform: "linux"
package: "febootstrap"
version: "2.7-0.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/febootstrap-run"
---

# febootstrap-run(8)

Run extra commands in febootstrap root filesystem

## NAME

febootstrap-run - Run extra commands in febootstrap root filesystem

## SYNOPSIS

```
 febootstrap-run [--options] DIR [--] [CMD ...]
```

## DESCRIPTION

This can be used to run extra commands in the febootstrap root filesystem.  It is just a simple wrapper around the standard `"fakeroot"` and `"fakechroot"` commands.

If given, the `"CMD ..."` is run inside the root filesystem.  The command acts as if it was run as root and chrooted into the root filesystem.

If the command is omitted, then we start a shell.

If `"CMD ..."` could contain anything starting with a `"-"` character then use `"--"` to separate `"febootstrap-run"` parameters from the command:

```
 febootstrap-run ./f10 -- ls -l
```

## OPTIONS

- **--ro**

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

## EXAMPLES

Remove a directory subtree safely:

```
 febootstrap-run initramfs -- rm -r /etc
```

(This requires that you have a compatible 'rm' command in the root).

Another way to do complex operations from a script is to export a function:

```
 #!/bin/bash
 do_stuff ()
 {
     # complex operations inside the root
 }
 export -f do_stuff
 febootstrap-run root -- bash -c do_stuff
```

## ENVIRONMENT VARIABLES

Some [*fakechroot*(1)](/fakechroot/1.md) environment variables are applicable.  In particular you may want to set:

```
 export FAKECHROOT_EXCLUDE_PATH=/proc
```

## SEE ALSO

[*febootstrap*(8)](/febootstrap/8.md), [*febootstrap-install*(8)](/febootstrap-install/8.md), [*fakeroot*(1)](/fakeroot/1.md), [*fakechroot*(1)](/fakechroot/1.md).

## AUTHORS

Richard W.M. Jones \<rjones @ redhat . com\>

## COPYRIGHT

(C) Copyright 2009 Red Hat Inc., \<http://people.redhat.com/~rjones/febootstrap\>.

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.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.