chroot man page on OSF1

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
OSF1 logo
[printable version]

chroot(2)							     chroot(2)

NAME
       chroot - Change the effective root directory

SYNOPSIS
       #include <unistd.h>

       int chroot(
	       const char *path );

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       chroot(): XSH4.0, XSH4.2, XSH5.0

       The chroot() function is marked as a LEGACY function in XSH5.0  and  is
       not considered portable to other conforming implementations.

       Refer  to  the  standards(5)  reference page for more information about
       industry standards and associated tags.

PARAMETERS
       Points to the new effective  root  directory.  If  the  path  parameter
       refers  to  a  symbolic	link, the chroot() function 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.

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 following values: Search
       permission is  denied  for  any	component  of  the  pathname.	[Tru64
       UNIX]  The path parameter points outside the process' allocated address
       space.  [Tru64 UNIX]  An I/O error occurred while reading from or writ‐
       ing  to	the  file  system.   More  than MAXSYMLINKS symbolic links are
       encountered while resolving path.  The  length  of  the	path  argument
       exceeds	PATH_MAX or a pathname component is longer than NAME_MAX.  The
       path parameter does not exist or points to an empty string.   A	compo‐
       nent of path is not a directory.	 The process does not have appropriate
       privilege.

SEE ALSO
       Functions: chdir(2)

       Commands: cd(1)

       Standards: standards(5)

								     chroot(2)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net