[0m


CHROOT(1V)	    UNIX Programmer's Manual	       CHROOT(1V)



[1mNAME
     [0mchroot - execute a command with a new root directory

[1mSYNOPSIS
     chroot root command

DESCRIPTION
     [0mThe _c_h_r_o_o_t command changes its root directory to the given
     directory, changes its current directory to this directory
     (the new root directory) then executes the command.  The
     command consists of the remainder of the command line argu-
     ments.

     The command name must be the full path name of the command
     relative to the new root directory.

     For the change in root directory to succeed the command must
     be executed with superuser priveleges.

[1mSEE ALSO
     [0m_c_h_r_o_o_t(8), _c_h_r_o_o_t(2), _c_h_d_i_r(2)

[1mNOTES
     [0mThe executed command cannot name any files below the new
     root.  The command is usually used with a specially prepared
     directory tree to provide a restricted environment for users
     or systems which cannot be authenticated using the normal
     password system.  See the description of anonymous ftp in
     _f_t_p_d(8).

     The BSD version of the command described in _c_h_r_o_o_t(8) and
     located in /_s_b_i_n sets the effective user and group ids of
     the new command to the real user and group ids.  This imple-
     mentation of _c_h_r_o_o_t does not do this.  Using the wrong com-
     mand can create a security loophole.




















Printed 7/4/92	    Revision 1.1 of 10/10/90			1



[0m