Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

chdir(2)

chroot(2)

chroot(8)

Name

chroot − change root directory for a command

Syntax

/usr/bin/chroot newroot command

Description

The chroot program is executed relative to the new root. The meaning of any initial slashes (/) in path names is changed for a command and any of its children to newroot. Furthermore, the initial working directory is newroot.

The new root path name is always relative to the current root: even if a chroot is currently in effect, the newroot argument is relative to the current root of the running process. 

Restrictions

This program is restricted to processes with appropriate privileges. 

Use extreme caution when referencing special files in the new root file system. 

Examples

The following example will create the file x relative to the original root, not the new one. 

% chroot newroot command >x

See Also

chdir(2), chroot(2)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026