switch_root.8 (632B)
- .Dd February 2, 2015
- .Dt SWITCH_ROOT 8
- .Os ubase
- .Sh NAME
- .Nm switch_root
- .Nd switch to another filesystem as the root of the mount tree
- .Sh SYNOPSIS
- .Nm
- .Op Fl c Ar console
- .Ar newroot init
- .Sh DESCRIPTION
- .Nm
- removes all files and directories on the current root filesystem and
- overmounts it with
- .Ar newroot .
- If a
- .Ar console
- is specified, redirect stdio and stderr to it. After the switch, execute
- .Ar init .
- .Pp
- .Nm
- can only be run as PID 1 in an initramfs or tmpfs with a regular and
- executable /sbin/init.
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl c
- Redirect stdio and stderr to
- .Ar console
- after switching to
- .Ar newroot .
- .El