NAME
bfstate - Report status of LAM buffers.
SYNTAX
bfstate [-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 system, 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.
EXAMPLES
- bfstate 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,
title line is displayed and information from the -l option,
if present.
SEE ALSO
bfctl(1),
mpimsg(1)