A
chroot
on
Unix and
Unix-like operating systems is an operation that changes the apparent
root directory
In a computer file system, and primarily used in the Unix and Unix-like operating systems, the root directory is the first or top-most directory in a hierarchy. It can be likened to the trunk of a tree, as the starting point where all branches ...
for the current running process and its
children
A child ( : children) is a human being between the stages of birth and puberty, or between the developmental period of infancy and puberty. The legal definition of ''child'' generally refers to a minor, otherwise known as a person younger ...
. A program that is run in such a modified environment cannot name (and therefore normally cannot access) files outside the designated directory tree. The term "chroot" may refer to the
system call or the wrapper program. The modified environment is called a chroot jail.
History
The chroot system call was introduced during development of
Version 7 Unix in 1979. One source suggests that
Bill Joy added it on 18 March 1982 – 17 months before
4.2BSD was released – in order to test its installation and build system. All versions of BSD that had a kernel have chroot(2). An early use of the term "jail" as applied to chroot comes from
Bill Cheswick creating a
honeypot to monitor a
hacker in 1991.
The first article about a jailbreak has been discussed on the security column of SunWorld Online which is written by Carole Fennelly; the August 1999 and January 1999 editions cover most of the chroot() topics.
To make it useful for
virtualization,
FreeBSD
FreeBSD is a free and open-source Unix-like operating system descended from the Berkeley Software Distribution (BSD), which was based on Research Unix. The first version of FreeBSD was released in 1993. In 2005, FreeBSD was the most popular ...
expanded the concept and in its 4.0 release in 2000 introduced the
jail
A prison, also known as a jail, gaol (dated, standard English, Australian, and historically in Canada), penitentiary (American English and Canadian English), detention center (or detention centre outside the US), correction center, correc ...
command.
By 2002, an article written by Nicolas Boiteux described how to create a jail on Linux
By 2003, first internet microservices providers with Linux jails provide SAAS/PAAS (shell containers, proxy, ircd, bots, ...) services billed for consumption into the jail by usage
By 2005,
Sun released
Solaris Containers (also known as Solaris Zones), described as "chroot on steroids."
By 2008,
LXC
Linux Containers (LXC) is an operating-system-level virtualization method for running multiple isolated Linux systems (containers) on a control host using a single Linux kernel.
The Linux kernel provides the cgroups functionality that allows l ...
(upon which
Docker was later built) adopted the "container" terminology and gained popularity in 2013 due to inclusion into
Linux kernel
The Linux kernel is a free and open-source, monolithic, modular, multitasking, Unix-like operating system kernel. It was originally authored in 1991 by Linus Torvalds for his i386-based PC, and it was soon adopted as the kernel for the GNU ope ...
3.8 of
user namespaces.
Uses
A chroot environment can be used to create and host a separate
virtualized copy of the software system. This can be useful for:
; Testing and development : A test environment can be set up in the chroot for software that would otherwise be too risky to deploy on a production system.
; Dependency control : Software can be developed, built and tested in a chroot populated only with its expected dependencies. This can prevent some kinds of linkage skew that can result from developers building projects with different sets of program libraries installed.
; Compatibility : Legacy software or software using a different
ABI must sometimes be run in a chroot because their supporting libraries or data files may otherwise clash in name or linkage with those of the host system.
; Recovery : Should a system be rendered unbootable, a chroot can be used to move back into the damaged environment after bootstrapping from an alternate root file system (such as from installation media, or a
Live CD).
; Privilege separation : Programs are allowed to carry open
file descriptor
In Unix and Unix-like computer operating systems, a file descriptor (FD, less frequently fildes) is a process-unique identifier (handle) for a file or other input/output resource, such as a pipe or network socket.
File descriptors typically have ...
s (for files,
pipelines and network connections) into the chroot, which can simplify jail design by making it unnecessary to leave working files inside the chroot directory. This also simplifies the common arrangement of running the potentially vulnerable parts of a privileged program in a sandbox, in order to pre-emptively contain a security breach. Note that chroot is not necessarily enough to contain a process with root privileges.
Limitations
The chroot mechanism is not intended to defend against intentional tampering by privileged (root) users. On most systems, chroot contexts do not stack properly and chrooted programs with sufficient privileges may perform
second chrootto break out. To mitigate the risk of these security weakness, chrooted programs should relinquish root privileges as soon as practical after chrooting, or other mechanisms – such as
FreeBSD jails – should be used instead. Note that some systems, such as
FreeBSD
FreeBSD is a free and open-source Unix-like operating system descended from the Berkeley Software Distribution (BSD), which was based on Research Unix. The first version of FreeBSD was released in 1993. In 2005, FreeBSD was the most popular ...
, take precautions to prevent a second chroot attack.
On systems that support device nodes on ordinary filesystems, a chrooted
root user can still create device nodes and mount the file systems on them; thus, the chroot mechanism is not intended by itself to be used to block low-level access to system devices by privileged users. It is not intended to restrict the use of resources like
I/O, bandwidth, disk space or CPU time. Most Unixes are not completely file system-oriented and leave potentially disruptive functionality like networking and process control available through the system call interface to a chrooted program.
At startup, programs expect to find
scratch space, configuration files,
device nodes and
shared libraries at certain preset locations. For a chrooted program to successfully start, the chroot directory must be populated with a minimum set of these files. This can make chroot difficult to use as a general sandboxing mechanism. Tools such a
Jailkitcan help to ease and automate this process.
Only the
root user can perform a chroot. This is intended to prevent users from putting a
setuid program inside a specially crafted chroot jail (for example, with a fake and file) that would fool it into a
privilege escalation.
Some Unixes offer extensions of the chroot mechanism to address at least some of these limitations (see
Implementations of operating system-level virtualization technology).
Graphical applications on chroot
It is possible to run graphical applications on a chrooted environment, using methods such as:
* Use
xhost (or copy the secret from .Xauthority)
* Nested X servers like
Xnest or the more modern
Xephyr (or start a real X server from inside the jail)
* Accessing the chroot via
SSH using the X11 forwarding (ssh -X) feature
xchrootan extended version of chroot for users and Xorg/X11 forwarding (socat/mount)
* An X11
VNC server and connecting a
VNC client outside the environment.
Notable applications
The
Postfix mail transfer agent operates as a pipeline of individually chrooted helper programs.
Like 4.2BSD before it, the Debian and Ubuntu internal package-building farms use chroots extensively to catch unintentional build dependencies between packages.
SUSE
SUSE ( , ) is a German-based multinational open-source software company that develops and sells Linux products to business customers. Founded in 1992, it was the first company to market Linux for enterprise. It is the developer of SUSE Linux Ent ...
uses a similar method with its ''build'' program. Fedora, Red Hat, and various other RPM-based distributions build all
RPMs using a chroot tool such a
mock
Many
FTP servers for POSIX systems use the chroot mechanism to sandbox untrusted FTP clients. This may be done by forking a process to handle an incoming connection, then chrooting the child (to avoid having to populate the chroot with libraries required for program startup).
If privilege separation is enabled, the
OpenSSH daemon will chroot an unprivileged helper process into an empty directory to handle pre-authentication network traffic for each client. The daemon can also sandbox SFTP and shell sessions in a chroot (from version 4.9p1 onwards).
ChromeOS can use a chroot to run a Linux instance using
Crouton,
providing an otherwise thin OS with access to hardware resources. The security implications related in this article apply here.
Linux host kernel virtual file systems and configuration files
To have a functional chroot environment in Linux, the kernel virtual file systems and configuration files also have to be mounted/copied from host to chroot.
# Mount Kernel Virtual File Systems
TARGETDIR="/mnt/chroot"
mount -t proc proc $TARGETDIR/proc
mount -t sysfs sysfs $TARGETDIR/sys
mount -t devtmpfs devtmpfs $TARGETDIR/dev
mount -t tmpfs tmpfs $TARGETDIR/dev/shm
mount -t devpts devpts $TARGETDIR/dev/pts
# Copy /etc/hosts
/bin/cp -f /etc/hosts $TARGETDIR/etc/
# Copy /etc/resolv.conf
/bin/cp -f /etc/resolv.conf $TARGETDIR/etc/resolv.conf
# Link /etc/mtab
chroot $TARGETDIR rm /etc/mtab 2> /dev/null
chroot $TARGETDIR ln -s /proc/mounts /etc/mtab
See also
*
List of Unix commands
*
Operating system-level virtualization
*
Sandbox (computer security)
*
sudo
sudo ( or ) is a program for Unix-like computer operating systems that enables users to run programs with the security privileges of another user, by default the superuser. It originally stood for "superuser do", as that was all it did, and it i ...
References
External links
*
*
*
Integrating GNU/Linux with Android using chroot
{{Core Utilities commands
Computer security procedures
Free virtualization software
Unix process- and task-management-related software
Virtualization software
Linux kernel features
System calls