File: rbflook.2

package info (click to toggle)
lam 6.5.6-6
  • links: PTS
  • area: main
  • in suites: woody
  • size: 15,464 kB
  • ctags: 11,670
  • sloc: ansic: 101,210; cpp: 12,146; sh: 10,821; makefile: 4,050; fortran: 218
file content (33 lines) | stat: -rw-r--r-- 1,177 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
.TH RBFLOOK 2 "November, 2001" "LAM 6.5.6" "LAM REMOTE LIBRARY"
.SH NAME
rbflook \- Retrieve a copy of a buffered LAM message packet.
.SH SYNOPSIS
#include <net.h>
.HP
int rbflook (int node, struct nmsg *nh, int seq);
.SH DESCRIPTION
The message packet is identified solely by a sequence number,
.IR 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
.I 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
.I rbflook()
is to debug a blocked system of processes and messages.
.PP
The \fInh\fR 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.
.SH ERRORS
.TP 16
EWOULDBLOCK
No message packet with the supplied sequence number could be found.
.SH SEE ALSO
rbfstate(2)