CHROOT(8) BSD System Manager's Manual CHROOT(8)

NAME
     cchhrroooott - change root directory

SYNOPSIS
     cchhrroooott [-uu -uusseerr] [-gg -ggrroouupp] [-GG -ggrroouupp,,ggrroouupp,,......] newroot [command]

DESCRIPTION
     The cchhrroooott command changes its root directory to the supplied directory
     newroot and exec's command, if supplied, or an interactive copy of your
     shell.

     If the -uu, -gg or -GG options are given, the user, group and group list of
     the process are set to these values after the chroot has taken place.
     See setgid(2), setgroups(2), setuid(2), getgrnam(3) and getpwnam(3).

     Note, command or the shell are run as your real-user-id.

ENVIRONMENT     The following environment variable is referenced by cchhrroooott:

     SHELL  If set, the string specified by SHELL is interpreted as the name
            of the shell to exec.  If the variable SHELL is not set, /bin/sh
            is used.

SEE ALSO
     chdir(2), chroot(2), environ(7)

HISTORY     The cchhrroooott utility first appeared in 4.4BSD.

SSEECCUURRIITTYY CCOONNSSIIDDEERRAATTIIOONNSS
     cchhrroooott should never be installed setuid root, as it would then be possi-
     ble to exploit the program to gain root privileges.

4.3 Berkeley Distribution       October 6, 1998      4.3 Berkeley Distribution