pxfunlink

Date:

10-20-2011

NAME

PXFUNLINK - Removes a directory entry

SYNOPSIS

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

STANDARDS

IEEE Std 1003.9-1992 standard interface for FORTRAN 77

DESCRIPTION

The PXFUNLINK routine uses the unlink(2) system call to remove a directory entry for the named file.

All arguments must be of default kind unless documented otherwise. Default kind is KIND=4 for integer, real, complex, and logical arguments.

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

path

An input character variable or array element containing the name of a file.

ilen

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

ierror

An output integer variable that contains a zero if the named file was removed.

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

EINVAL

ilen < 0 or ilen > LEN(path).

ENOMEM

PXFUNLINK is unable to obtain memory to copy path.

EXAMPLES

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

SEE ALSO

unlink(2)