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

NAME

6       rbfstate - Report status of remote LAM buffers.
7

SYNOPSIS

9       #include <bfreq.h>
10
11       int  rbfstate  (int  node,  struct bfstatus *table, int maxsize, struct
12              bfparms *parms);
13

ARGUMENTS

15       node        target node for buffer status
16
17       table       array of message packet status structures (output)
18
19       maxsize     table size - This limits the number of messages  than  will
20                   be reported.
21
22       parms       additional information about the overall status of the net‐
23                   work buffer service (output)
24

DESCRIPTION

26       The message packet status structure is defined in <bfreq.h>.
27
28              struct bfstatus {
29                        int       bfs_node;
30                        int       bfs_event;
31                        int       bfs_type;
32                        int       bfs_length;
33                        int       bfs_flags;
34                        int       bfs_seq;
35              };
36
37       bfs_node          destination node of the buffered message packet
38
39       bfs_event         destination event (see nsend(2))
40
41       bfs_type          destination type (see nsend(2))
42
43       bfs_length        length in bytes of the message packet
44
45       bfs_flags         additional  boolean  information  about  the  message
46                         packet
47
48       bfs_seq           sequence  number that can be later used to retrieve a
49                         copy of the packet (see rbflook(2))
50
51       Additional information about the overall status of the  buffer  service
52       is stored in a buffer parameter structure, defined in <bfreq.h>.
53
54              struct bfparms {
55                        int       bfp_maxspace;
56                        int       bfp_nspace;
57              };
58
59       bfp_maxspace      maximum  size  in  bytes of the buffer pool (see rbf‐
60                         parms(2))
61
62       bfp_nspace        current amount of occupied space in the buffer pool
63

RETURN VALUE

65       Upon successful completion, the number of buffered message packets held
66       by  the remote buffer daemon is returned.  The return value may be more
67       or less than maxsize.  If an error occurred, -1  is  returned  and  the
68       global variable errno is set to indicate the error.
69

SEE ALSO

71       bfctl(1), bfstate(2), rbflook(2), rbfparms(2)
72
73
74
75LAM 7.1.2                         March, 2006                      RBFSTATE(2)
Impressum