BFSTATE(1) LAM COMMANDS BFSTATE(1)NAMEbfstate - Report status of LAM buffers.
SYNTAXbfstate [-ghlp] [-B <#msgs>] <node(s)>
OPTIONS-g Include information on system messages.
-h Print the command help menu.
-l Print buffer levels and limits.
-p Display individual packet information.
-B <#msgs> Limit the number of messages reported.
DESCRIPTION
Most MPI users will probably not need to use the bfstate command; see
mpimsg(1). This command is only installed if LAM/MPI was configured
with the --with-trillium switch.
The bfstate command displays information on LAM network message buffers
on any node in the multicomputer. For each message, bfstate outputs
the following information:
NODE node containing the message
DEST destination node of the message
EVENT message event (see nsend(2))
TYPE message type
LENGTH message length in bytes
The -l option prints the following summary on each node's buffer sys‐
tem, after all messages for that node have been displayed.
- maximum size of the internal buffer pool
- amount of space currently used in the pool.
Individual message buffers hold network message packets, which may be
only part of a complete user message. Normally, bfstate summarizes
packets into complete messages. If all packets for a message are not
on the same node, no information is displayed. The -p option disables
this behaviour and one line on information is displayed for each
packet. The -B option changes the maximum number of packet buffers
acquired (and hence displayable) from the node.
EXAMPLESbfstate n12-14
Display the status of all network message buffers on nodes 12
through 14.
DIAGNOSTICS
If no buffered messages are found, only the title line is displayed and
information from the -l option, if present.
SEE ALSObfctl(1), mpimsg(1)LAM 7.1.2 March, 2006 BFSTATE(1)
