rbflook(2)

rbflook2

Retrieve a copy of a buffered lam message packet.

Usage

#include <net.h>

int rbflook (int node, struct nmsg *nh, int seq);

Overview

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.

Releases

2 releases since Debian 2.1 (Slink); the text changed 1 time.

  1. 2.1
  2. 2.2

From lam2-dev 6.3.2-3 in Debian 2.2 (Potato). Parsed by carta from the page's man source.