pxfchroot

Date:: 10-20-2011

NAME

PXFCHROOT - Changes the root directory to a specified directory

SYNOPSIS

CHARACTER*n path
INTEGER ilen, ierror
CALL PXFCHROOT(path, ilen, ierror)

IMPLEMENTATION

Cray Linux Environment (CLE)

STANDARDS

IEEE standard interface for FORTRAN 77

DESCRIPTION

The PXFCHROOT subroutine uses the chroot(2) system call to change the root directory to the specified directory.

When using the Cray Fortran compiler, all arguments must be of default kind unless documented otherwise. The default kind is KIND=4 for integer, real, complex, and logical arguments.

The following is a list of valid arguments for this subroutine:

path: Input character variable or array element containing the name of a file.
ilen: Input integer variable containing the length of path in characters. If ilen is zero, all trailing blanks are removed before calling chroot().
ierror: Output integer variable that contains zero if the root directory was changed to the directory specified by path or nonzero if the root directory was not changed.

In addition to the errors returned by the chroot system call, PXFCHROOT may return the following errors:

EINVAL: If ilen is less than 0 or if ilen is greater than LEN(path)
ENOMEM: If PXFCHROOT is unable to obtain memory to copy path

EXAMPLES

program test
character*(12) path
integer ilen, ierr
path = '/dir/test'
ilen = 0
call pxfchroot(path,ilen,ierr)
if (ierr.ne.0) then
    print *,'FAIL: error from pxfchroot = ',ierr
else
    print *,'PASS: No error from pxfchroot'
endif
end