lam_rfstate

Langue: en

Version: 58978 (mandriva - 22/10/07)

Section: 2 (Appels système)

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)