---
name: "rbfstate"
section: "2"
platform: "linux"
package: "lam2-dev"
version: "6.3.2-3"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/rbfstate"
---

# rbfstate(2)

Report status of remote LAM buffers.

## 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)](/nsend/2.md))

- bfs\_type

  destination type (see [nsend(2)](/nsend/2.md))

- 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)](/rbflook/2.md))

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)](/rbfparms/2.md))

- 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)](/bfctl/1.md), bfstate(2), [rbflook(2)](/rbflook/2.md), [rbfparms(2)](/rbfparms/2.md)