-l library|--lib library

Specify an alternative wrapper library.

-s|--use-system-libs

Use system libraries before chroot's libraries. This might be a workaround if system dynamic linker (/lib/ld-linux.so.2 for Linux) can not load libc.so from fake chroot.

Try this setting if you noticed following errors:

 $ fakechroot /usr/sbin/chroot /tmp/sarge /bin/true
 /bin/true: relocation error: /srv/sarge/lib/tls/libc.so.6: symbol _dl
 _starting_up, version GLIBC_PRIVATE not defined in file ld-linux.so.2
  with link time reference

 $ fakechroot /usr/sbin/chroot /tmp/centos4 /bin/true
 Segmentation fault

[--] command

Any command you want to be ran as fakechroot. Use '--' if in the command you have other options that may confuse fakechroot's option parsing.

-h

Display help.

-v

Display version.

 $ export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin
 :/bin:/usr/bin/X11
 $ fakeroot -s fakechroot.save fakechroot debootstrap --variant=fakech
 root sarge /tmp/sarge

 $ fakeroot -i fakechroot.save fakechroot chroot /tmp/sarge /bin/bash
 # cd /
 # sh /usr/share/doc/fakechroot/examples/savemode.sh
 # echo deb http://ftp.debian.org/debian sarge main contrib non-free >
 /etc/apt/sources.list
 # echo deb-src http://ftp.debian.org/debian sarge main contrib non-fr
 ee >> /etc/apt/sources.list
 # apt-get update
 # apt-get install adduser whiptail build-essential devscripts
 # adduser --uid 1001 dexter
 # cd /tmp
 # apt-get source hello
 # cd hello-*
 # debuild --preserve-env -b
 # exit

/usr/lib/fakechroot/libfakechroot.so

The shared library containing the wrapper functions.

FAKECHROOT

The value is true for fake chroot environment.

FAKECHROOT_VERSION

The version of current fakechroot library.

FAKECHROOT_BASE

The root directory for fake chroot environment.

FAKECHROOT_EXCLUDE_PATH

The list of directories which are excluded from being chrooted. The elements of list are separated with colon.

LD_LIBRARY_PATH, LD_PRELOAD

Fakechroot is implemented by wrapping system calls. This is accomplished by setting LD_LIBRARY_PATH=/usr/lib/fakechroot and LD_PRELOAD=libfakechroot.so. That library is loaded before the system's C library, and so most of the library functions are intercepted by it. If you need to set either LD_LIBRARY_PATH or LD_PRELOAD from within a fakechroot environment, it should be set relative to the given paths, as in LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/foo/bar/

o

/lib/ld-linux.so.2 is always loaded from real environment. This path is hardcoded by linker for all binaries.

o

Every command executed within fakechroot needs to be linked to the same version of the C library as fakechroot itself. If the libraries in chroot are not compatible, try to use --use-system-libs option.

o

You can provide symlinks to the outside. The symlink have to be created before chroot is called. It can be useful for accessing the real /proc and /dev directory. You can also set the FAKECHROOT_EXCLUDE_PATH environment variable:

 $ export FAKECHROOT_EXCLUDE_PATH=/tmp:/proc:/dev:/var/run

o

Statically linked binaries doesn't work, especially (8), so you have to wrap this command with dummy version and i.e. set the dpkg diversion, see: dpkg-divert(8).

o

ldd(1) also doesn't work. You have to use wrapper. The example wrapper is available at scripts/ directory in fakechroot's source package and it is located at /usr/share/doc/fakechroot/examples directory.

o

The full screen applications hangs up if /dev/tty file is not a real device. Link /dev/tty file or whole /dev directory to the real one or remove it from fake chroot environment.

o

lckpwdf() and ulckpwdf() are ignored so passwd(1) command should work

o

Your real uid should exist in /etc/passwd. Create it with adduser --uid realuid realuser.

o

debuild(1) cleans environment. Use --preserve-env option to prevent this behaviour.