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

NAME

6       rbflook - Retrieve a copy of a buffered LAM message packet.
7

SYNOPSIS

9       #include <net.h>
10
11       int rbflook (int node, struct nmsg *nh, int seq);
12

DESCRIPTION

14       The  message  packet  is  identified  solely by a sequence number, seq.
15       Sequence numbers of buffered packets are learned by  a  prior  call  to
16       rbfstate(2).  Note that the packets and their sequence numbers reported
17       by rbfstate(2) are only a snapshot of a buffer  daemon's  state.   When
18       rbflook() is called, some or all of packets reported by rbfstate(2) may
19       have been forwarded and new ones (with unknown  sequence  numbers)  may
20       have  arrived.   The most useful application of rbflook() is to debug a
21       blocked system of processes and messages.
22
23       The nh argument is a network message descriptor that is  only  used  to
24       supply  a  packet  buffer  and maximum packet length (up to MAXNMSGLEN,
25       defined in <net.h>).  The synchronization fields of the descriptor  are
26       not used.  Only the sequence number identifies the message packet.
27

ERRORS

29       EWOULDBLOCK     No  message  packet  with  the supplied sequence number
30                       could be found.
31

SEE ALSO

33       rbfstate(2)
34
35
36
37LAM 7.1.2                         March, 2006                       RBFLOOK(2)
Impressum