chroot(1M)                                                       chroot(1M)

NAME
     chroot - change root directory for a command

SYNOPSIS
     /usr/sbin/chroot newroot command

DESCRIPTION
     chroot causes the given command to be executed relative to the new
     root. The meaning of any initial slashes (/) in the path names is
     changed for the command and any of its child processes to newroot.
     Furthermore, upon execution, the initial working directory is newroot.

     Notice, however, that if you redirect the output of the command to a
     file:

          chroot newroot command > x

     will create the file x relative to the original root of the command,
     not the new one.

     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.

     This command can only be executed by the superuser.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed.

     If LCMESSAGES is undefined or is defined as the null string, it
     defaults to the value of LANG. If LANG is likewise undefined or null,
     the system acts as if it were not internationalized.

     If any of the locale variables has an invalid value, the system acts
     as if none of the variables was set.

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

NOTES
     One should exercise extreme caution when referencing device files in
     the new root file system.

SEE ALSO
     cd(1), chroot(2).








Page 1                       Reliant UNIX 5.44                Printed 11/98