c_lsstat - Ascertains file presence and access permissions

SYNTAX

#include "las.h"
#include "vll.h"

FUNCTION c_lsstat (hostname, mode)

     char               *hostname;
     long               *mode;

PARAMETERS

hostname (input, character, length (CMLEN))

Host filename of the label services file.

mode (input, integer)

The mode follows:

     = 0:     Tests to see if the file exists.
     = 1:     Execute access.
     = 2:     Write access (implies delete access).
     = 4:     Read access.

DESCRIPTION

The c_lsstat() call is used to ascertain file presence and access permissions. A return status of E_SUCC (0) implies that the test is a valid. For example: if mode = 2 and a status of E_SUCC is returned, the file has write access.

RETURN VALUE

c_lsstat() returns

     E_SUCC (0)  --> successful completion 
     E_FAIL (-1) --> operation failed  (no message)