bfstate

Langue: en

Autres versions - même langue

Version: 179724 (CentOS - 06/07/09)

Section: 1 (Commandes utilisateur)

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

SEE ALSO

bfctl(1), mpimsg(1)