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).
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, if present.