BFSTATE(1) LAM COMMANDS BFSTATE(1) 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(1,5) will probably not need to use the bfstate command; see mpimsg(1). This command is only installed if(3,n) LAM/MPI was configured with the --with-trillium switch. The bfstate command displays information on LAM network message buffers on any node in(1,8) 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(1,8) 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(1,8) 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(3,n) present. SEE ALSO bfctl(1), mpimsg(1) LAM 7.0.6 May, 2004 BFSTATE(1)