ubase/switch_root.8

32 lines
632 B
Groff

.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