NAME
	  chroot - Changes the effective root directory

     SYNOPSIS
	  int chroot (
	       const char *path	);

     PARAMETERS
	  path Points to the new effective root	directory. If the path
	       parameter refers	to a symbolic link, the	chroot() func-
	       tion sets the effective root directory to the directory
	       pointed to by the symbolic link.

     DESCRIPTION
	  The chroot() function	causes the directory named by the path
	  parameter to become the effective root directory.

	  The effective	root directory is the starting point when
	  searching for	a file's pathname that begins with a /
	  (slash). The current working directory is not	affected by
	  the chroot() function.

	  The calling process must have	superuser privilege in order
	  to change the	effective root directory.  The calling process
	  must also have search	access to the new effective root
	  directory.

	  The .. (dot-dot) entry in the	effective root directory is
	  interpreted to mean the effective root directory itself.
	  Thus,	.. (dot-dot) cannot be used to access files outside
	  the subtree rooted at	the effective root directory.

     NOTES
	  AES Support Level: Trial use

     RETURN VALUES
	  Upon successful completion, a	value of 0 (zero) is returned.
	  If the chroot() function fails, a value of -1	is returned
	  and errno is set to indicate the error.

     ERRORS
	  If the chroot() function fails, the effective	root directory
	  remains unchanged and	errno may be set to one	of the follow-
	  ing values:

	  [EACCES]  Search permission is denied	for any	component of
		    the	pathname.

	  [EPERM]   The	process	does not have appropriate privilege.

	  [EFAULT]  The	path parameter points outside the process'
		    allocated address space.

	  [EIO]	    An I/O error occurred while	reading	from or	writ-
		    ing	to the file system.

	  [ENOENT]  The	path parameter does not	exist or points	to an
		    empty string.

	  [ENAMETOOLONG]
		    The	length of the path argument exceeds PATH_MAX
		    or a pathname component is longer than NAME_MAX.

	  [ENOTDIR] A component	of path	is not a directory.

	  [ELOOP]   More than MAXSYMLINKS symbolic links are encoun-
		    tered while	resolving path.

     RELATED INFORMATION
	  Functions: chdir(2)

	  Commands: chdir(1)