RBFSTATE(2)

NAME
rbfstate - 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 network 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 rbfparms(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 ALSO
bfctl(1), bfstate(2), rbflook(2), rbfparms(2)