|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Calls chroot(2)
NAME
chroot, fchroot - change root directory
SYNOPSIS
#include <unistd.h>
int chroot(const char *path);
int fchroot(int fildes);
DESCRIPTION
The chroot() and fchroot() functions cause a directory to
become the root directory, the starting point for path
searches for path names beginning with / (slash). The user's
working directory is unaffected by the chroot() and
fchroot() functions.
The path argument points to a path name naming a directory.
The fildes argument to fchroot() is the open file descriptor
of the directory which is to become the root.
The privilege {PRIV_PROC_CHROOT} must be asserted in the
effective set of the process to change the root directory.
While it is always possible to change to the system root
using the fchroot() function, it is not guaranteed to
succeed in any other case, even if fildes is valid in all
respects.
The ".." entry in the root directory is interpreted to mean
the root directory itself. Therefore, ".." cannot be used to
access files outside the subtree rooted at the root direc-
tory. Instead, fchroot() can be used to reset the root to a
directory that was opened before the root directory was
changed.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is
returned, the root directory remains unchanged, and errno is
set to indicate the error.
ERRORS
The chroot() function will fail if:
EACCES Search permission is denied for a
component of the path prefix of dir-
name, or search permission is denied
for the directory referred to by
dirname.
SunOS 5.10 Last change: 20 Jan 2003 1
System Calls chroot(2)
EBADF The descriptor is not valid.
EFAULT The path argument points to an ille-
gal address.
EINVAL The fchroot() function attempted to
change to a directory the is not the
system root and external cir-
cumstances do not allow this.
EINTR A signal was caught during the exe-
cution of the chroot() function.
EIO An I/O error occurred while reading
from or writing to the file system.
ELOOP Too many symbolic links were encoun-
tered in translating path.
ENAMETOOLONG The length of the path argument
exceeds PATH_MAX, or the length of a
path component exceeds NAME_MAX
while _POSIX_NO_TRUNC is in effect.
ENOENT The named directory does not exist
or is a null pathname.
ENOLINK The path argument points to a remote
machine and the link to that machine
is no longer active.
ENOTDIR Any component of the path name is
not a directory.
SunOS 5.10 Last change: 20 Jan 2003 2
System Calls chroot(2)
EPERM The {PRIV_PROC_CHROOT} privilege is
not asserted in the effective set of
the calling process.
SEE ALSO
chroot(1M), chdir(2), privileges(5)
WARNINGS
The only use of fchroot() that is appropriate is to change
back to the system root.
SunOS 5.10 Last change: 20 Jan 2003 3
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:56 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits)
(openSUSE 10.2)
svn man page (5209 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2884 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2492 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2408 hits)
(Suse Linux 10.1)
|
Man Pages 
