chroot(3) [php man page]

CHROOT(3)								 1								 CHROOT(3)

chroot - Change the root directory

SYNOPSIS

       bool chroot (string  $directory)

DESCRIPTION

	Changes the root directory of the current process to $directory, and changes the current working directory to "/".

	This  function is only available to GNU and BSD systems, and only when using the CLI, CGI or Embed SAPI. Also, this function requires root
       privileges.

PARAMETERS

	      o $directory
		- The path to change the root directory to.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      chroot(3) example

	      <?php
	      chroot("/path/to/your/chroot/");
	      echo getcwd();
	      ?>

	      The above example will output:

	      /

NOTES

       Note

	      This function is not implemented on Windows platforms.

PHP Documentation Group 														 CHROOT(3)

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

NAME

     chroot -- change root directory

SYNOPSIS

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

DESCRIPTION

     The chroot utility changes its current and root directories to the supplied directory newroot and then exec's command, if supplied, or an
     interactive copy of the user's login shell.

     If the -u, -g or -G options are given, the user, group and group list of the process are set to these values after the chroot has taken
     place.

ENVIRONMENT

     The following environment variable is referenced by chroot:

     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), setgid(2), setgroups(2), setuid(2), getgrnam(3), environ(7), jail(8)

HISTORY

     The chroot utility first appeared in 4.4BSD.

BSD
								   June 7, 2003 							       BSD