RBFLOOK(2) LAM REMOTE LIBRARY RBFLOOK(2)NAMErbflook - Retrieve a copy of a buffered LAM message packet.
SYNOPSIS
#include <net.h>
int rbflook (int node, struct nmsg *nh, int seq);
DESCRIPTION
The message packet is identified solely by a sequence number, seq.
Sequence numbers of buffered packets are learned by a prior call to
rbfstate(2). Note that the packets and their sequence numbers reported
by rbfstate(2) are only a snapshot of a buffer daemon's state. When
rbflook() is called, some or all of packets reported by rbfstate(2) may
have been forwarded and new ones (with unknown sequence numbers) may
have arrived. The most useful application of rbflook() is to debug a
blocked system of processes and messages.
The nh argument is a network message descriptor that is only used to
supply a packet buffer and maximum packet length (up to MAXNMSGLEN,
defined in <net.h>). The synchronization fields of the descriptor are
not used. Only the sequence number identifies the message packet.
ERRORS
EWOULDBLOCK No message packet with the supplied sequence number
could be found.
SEE ALSOrbfstate(2)LAM 7.1.2 March, 2006 RBFLOOK(2)
