RBFSTATE(2) LAM REMOTE LIBRARY RBFSTATE(2)NAMErbfstate - Report status of remote LAM buffers.
SYNOPSIS
#include <bfreq.h>
int rbfstate (int node, struct bfstatus *table, int maxsize, struct
bfparms *parms);
ARGUMENTS
node target node for buffer status
table array of message packet status structures (output)
maxsize table size - This limits the number of messages than will
be reported.
parms additional information about the overall status of the net‐
work buffer service (output)
DESCRIPTION
The message packet status structure is defined in <bfreq.h>.
struct bfstatus {
int bfs_node;
int bfs_event;
int bfs_type;
int bfs_length;
int bfs_flags;
int bfs_seq;
};
bfs_node destination node of the buffered message packet
bfs_event destination event (see nsend(2))
bfs_type destination type (see nsend(2))
bfs_length length in bytes of the message packet
bfs_flags additional boolean information about the message
packet
bfs_seq sequence number that can be later used to retrieve a
copy of the packet (see rbflook(2))
Additional information about the overall status of the buffer service
is stored in a buffer parameter structure, defined in <bfreq.h>.
struct bfparms {
int bfp_maxspace;
int bfp_nspace;
};
bfp_maxspace maximum size in bytes of the buffer pool (see rbf‐
parms(2))
bfp_nspace current amount of occupied space in the buffer pool
RETURN VALUE
Upon successful completion, the number of buffered message packets held
by the remote buffer 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 error.
SEE ALSObfctl(1), bfstate(2), rbflook(2), rbfparms(2)LAM 7.1.2 March, 2006 RBFSTATE(2)