*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> chroot (8)              



NAME    [Toc]    [Back]

     chroot - change root directory

SYNOPSIS    [Toc]    [Back]

     chroot [-g group,group,...] [-u user] newroot [command]

DESCRIPTION    [Toc]    [Back]

     The chroot command changes its root directory  to  the  supplied directory
     newroot and executes command, if supplied, or an interactive
copy of the
     user's shell.

     The chroot command is restricted to the superuser.

     The options are as follows:

     -g group,group,...
             Override the primary  and  supplemental  group  IDs.
The primary
             group ID is set to the first group in the list.  Any
             groups are placed in the supplemental group ID  vector.  Each
             group listed must exist in the group(5) databases.

     -u user
             Set  user  ID to user (which must exist in the passwd(5) database).
             The primary and supplemental group IDs will  be  set
based on the
             user's   entries   in  the  passwd(5)  and  group(5)
databases unless
             overridden by the -g option.

ENVIRONMENT    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     chdir(2),  chroot(2),  setgid(2),  setgroups(2),  setuid(2),
     passwd(5), environ(7)

HISTORY    [Toc]    [Back]

     The chroot utility first appeared in 4.4BSD.

CAVEATS    [Toc]    [Back]

     chroot  should  never  be installed setuid root, as it would
then be possible
 to exploit the program to gain root privileges.

OpenBSD     3.6                        February      7,      2003
[ Back ]
 Similar pages
Name OS Title
chroot HP-UX change root directory for a command
chroot IRIX change root directory for a command
chroot Tru64 Change the effective root directory
pivot_root Linux change the root file system
pivot_root Linux change the root file system
chroot Tru64 Changes the root directory of a command
pxfchroot IRIX Changes the root directory to a specified directory
chroot Linux run command or interactive shell with special root directory
fchdir HP-UX change working directory
chdir Linux change working directory
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service