pxfchdir(3F)

NAME
     PXFCHDIR - Changes the current directory to a specified directory

SYNOPSIS
     CHARACTER*n path
     INTEGER ilen, ierror
     CALL PXFCHDIR(path, ilen, ierror)

STANDARDS
     IEEE standard interface for FORTRAN 77

DESCRIPTION
     This routine is in libfortran.so which is linked by default when
     compiling programs with the MIPSpro 7 Fortran 90 compiler or when
     compiling programs with the -craylibs option to the MIPSpro F77
     compiler.

     The PXFCHDIR subroutine uses the chdir(2) system call to change the
     current working directory to the specified directory.

     All arguments must be of default kind unless documented otherwise.  On
     IRIX systems, the default kind is KIND=4.

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

     path      An input character variable or array element containing the
               new directory.

     ilen      An input integer variable containing the length of path in
               characters.  If ilen is zero, all trailing blanks are
               removed before calling chdir().

     ierror    An output integer variable that contains zero if the current
               working directory was changed or nonzero if the change of
               directories was not made.

     In addition to the errors returned by the chdir(2) system call,
     PXFCHDIR may return the following errors:

     EINVAL    If ilen is less than 0 or if ilen is greater than LEN(path)

     ENOMEM    If PXFCHDIR is unable to obtain memory to copy path

NOTES
     The PXF_DEFINITIONS module can be used by Fortran 90 users to enable
     caller-callee interface checking.

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

SEE ALSO
     chdir(2)