switch_root

switch to another filesystem as the root of the mount tree

Synopsis

switch_root [-hV]

switch_root newroot init [arg...]

add an example, a script, a trick and tips

: email address (won't be displayed)
: name

Step 2

Thanks for this example ! - It will be moderated and published shortly.

Feel free to post other examples Oops ! There is a tiny cockup. A damn 404 cockup. Please contact the loosy team who maintains and develops this wonderful site by clicking in the mighty feedback button on the side of the page. Say what happened. Thanks!

examples

no example yet ...

... Feel free to add your own example above to help other Linux-lovers !

description

switch_root moves already mounted /proc, /dev and /sys to newroot and makes newroot the new root filesystem and starts init process.

WARNING: switch_root removes recursively all files and directories on the current root filesystem.

options

-h, --help

show help and exit

-V, --version

show version number and exit

availability

The switch_root command is part of the util-linux package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.

notes

switch_root will fail to function if newroot is not the root of a mount. If you want to switch root into a directory that does not meet this requirement then you can first use a bind-mounting trick to turn any directory into a mount point:

mount --bind $DIR $DIR

return value

switch_root returns 0 on success and 1 on failure.

see also

mount chroot init mkinitrd

authors

Peter Jones <pjones[:at:]redhat[:dot:]com>
Jeremy Katz <katzj[:at:]redhat[:dot:]com>
Karel Zak <kzak[:at:]redhat[:dot:]com>