2016-10-12 12:05:40 +00:00
|
|
|
.Dd September 29, 2016
|
|
|
|
|
.Dt CHROOT 8
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm chroot
|
|
|
|
|
.Nd run command with changed root directory
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
2024-06-16 20:42:30 +00:00
|
|
|
.Op Fl dI
|
2016-10-12 12:05:40 +00:00
|
|
|
.Ar newroot
|
|
|
|
|
.Oo
|
|
|
|
|
.Ar command
|
|
|
|
|
.Oo
|
|
|
|
|
.Ar arguments ...
|
|
|
|
|
.Oc
|
|
|
|
|
.Oc
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
changes the root directory to
|
|
|
|
|
.Ar newroot
|
|
|
|
|
and runs
|
|
|
|
|
.Ar command
|
|
|
|
|
with the given
|
|
|
|
|
.Ar arguments .
|
|
|
|
|
.Ar command
|
|
|
|
|
defaults to
|
|
|
|
|
.Xr sh 1 .
|
|
|
|
|
The working directory for
|
|
|
|
|
.Ar command
|
|
|
|
|
is changed to
|
|
|
|
|
.Pa / .
|
|
|
|
|
.Pp
|
|
|
|
|
The options are as follows:
|
|
|
|
|
.Bl -tag -width "12345678"
|
2017-03-19 16:32:36 +00:00
|
|
|
.It Fl d , Fl \-devices
|
2016-10-12 12:05:40 +00:00
|
|
|
Mount
|
|
|
|
|
.Pa /dev
|
|
|
|
|
from the host system into the
|
|
|
|
|
.Pa /dev
|
|
|
|
|
inside
|
|
|
|
|
.Ar newroot .
|
|
|
|
|
The mountpoint is removed when
|
|
|
|
|
.Ar command
|
2017-02-15 21:56:28 +00:00
|
|
|
completes.
|
|
|
|
|
This option is useful for running installations.
|
2024-06-16 20:42:30 +00:00
|
|
|
.It Fl I , Fl \-init
|
|
|
|
|
Become an init process using
|
|
|
|
|
.Xr setinit 2
|
|
|
|
|
and transfer the controlling terminal temporarily to the new session using the
|
|
|
|
|
.Sy TIOCSCTTY
|
|
|
|
|
.Xr ioctl 2 .
|
2016-10-12 12:05:40 +00:00
|
|
|
.El
|
|
|
|
|
.Sh ENVIRONMENT
|
|
|
|
|
The environment is preserved.
|
|
|
|
|
.Ev PATH
|
|
|
|
|
is used to search for
|
|
|
|
|
.Ar command .
|
|
|
|
|
.Sh EXIT STATUS
|
|
|
|
|
.Nm
|
|
|
|
|
will exit 0 on success and non-zero otherwise.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr chroot 2
|
