LAM_RFSTATE(2)

NAME
lam_rfstate - Report status of remote LAM file descriptors.

SYNOPSIS
#include <freq.h>

int lam_rfstate(int node, struct fstate *table, int maxsize);

DESCRIPTION
The remote function lam_rfstate() accesses a remote LAM file daemon and returns status information on all file descriptors.

The arguments to lam_rfstate() are: node, the target node identifier; table, an array of structures where status information will be stored; and maxsize, the number of elements in that array.

The file status structure is defined in <freq.h>.

    struct fstate {
    	int	fs_tfd
    	int	fs_tflags
    	int	fs_flow
    	int	fs_src_node
    	int	fs_src_event
    	int	fs_ncubix
    	int	fs_nheard
    	int	fs_req
    	char	fs_name[24]
    };

fs_tfd
    LAM file handle

fs_tflags
    LAM, POSIX, and internal filed flags

fs_flow
    total amount of data transferred to date

fs_src_node
    last client's nodeid

fs_src_event
    last client's reply event (negative PID)

fs_name
    trailing 24 bytes of file name

The fs_tflags field contains the original POSIX and LAM open flags as well as extra status flags added by the file daemon. See open(2) for information on POSIX open flags. See lam_rfposix(2) for information on LAM open flags. The LAM status flags are defined in <freq.h>.

FACTIVE
    The LAM file descriptor has an associated open POSIX file descriptor.

FLOCK
    The descriptor is permanently FACTIVE.

RETURN VALUE
Upon successful completion, the number of open file descriptors mananged by the remote file daemon is returned. The return value may be more or less than maxsize. If an error occurred, -1 is returned and the global variable errno is set to indicate the type of error.

SEE ALSO
fstate(1), lam_rfposix(2)