Linux Certif

Toute la documentation sur la certification Linux LPI

rbfstate

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)