1LAM_RFSTATE(2)                LAM REMOTE LIBRARY                LAM_RFSTATE(2)
2
3
4

NAME

6       lam_rfstate - Report status of remote LAM file descriptors.
7

SYNOPSIS

9       #include <freq.h>
10
11       int lam_rfstate(int node, struct fstate *table, int maxsize);
12

DESCRIPTION

14       The remote function lam_rfstate() accesses a remote LAM file daemon and
15       returns status information on all file descriptors.
16
17       The arguments to lam_rfstate() are: node, the target  node  identifier;
18       table,  an array of structures where status information will be stored;
19       and maxsize, the number of elements in that array.
20
21       The file status structure is defined in <freq.h>.
22
23              struct fstate {
24                        int       fs_tfd
25                        int       fs_tflags
26                        int       fs_flow
27                        int       fs_src_node
28                        int       fs_src_event
29                        int       fs_ncubix
30                        int       fs_nheard
31                        int       fs_req
32                        char      fs_name[24]
33              };
34
35       fs_tfd          LAM file handle
36
37       fs_tflags       LAM, POSIX, and internal filed flags
38
39       fs_flow         total amount of data transferred to date
40
41       fs_src_node     last client's nodeid
42
43       fs_src_event    last client's reply event (negative PID)
44
45       fs_name         trailing 24 bytes of file name
46
47       The fs_tflags field contains the original POSIX and LAM open  flags  as
48       well  as  extra status flags added by the file daemon.  See open(2) for
49       information on POSIX open flags.  See lam_rfposix(2) for information on
50       LAM open flags.  The LAM status flags are defined in <freq.h>.
51
52       FACTIVE   The LAM file descriptor has an associated open POSIX file de‐
53                 scriptor.
54
55       FLOCK     The descriptor is permanently FACTIVE.
56

RETURN VALUE

58       Upon successful completion, the number of open  file  descriptors  man‐
59       anged  by  the remote file daemon is returned.  The return value may be
60       more or less than maxsize.  If an error occurred, -1  is  returned  and
61       the global variable errno is set to indicate the type of error.
62

SEE ALSO

64       fstate(1), lam_rfposix(2)
65
66
67
68LAM 7.1.2                         March, 2006                   LAM_RFSTATE(2)
Impressum