1BFSTATE(1)                       LAM COMMANDS                       BFSTATE(1)
2
3
4

NAME

6       bfstate - Report status of LAM buffers.
7

SYNTAX

9       bfstate [-ghlp] [-B <#msgs>] <node(s)>
10

OPTIONS

12       -g          Include information on system messages.
13
14       -h          Print the command help menu.
15
16       -l          Print buffer levels and limits.
17
18       -p          Display individual packet information.
19
20       -B <#msgs>  Limit the number of messages reported.
21

DESCRIPTION

23       Most  MPI  users will probably not need to use the bfstate command; see
24       mpimsg(1).  This command is only installed if  LAM/MPI  was  configured
25       with the --with-trillium switch.
26
27       The bfstate command displays information on LAM network message buffers
28       on any node in the multicomputer.  For each  message,  bfstate  outputs
29       the following information:
30
31       NODE      node containing the message
32
33       DEST      destination node of the message
34
35       EVENT     message event (see nsend(2))
36
37       TYPE      message type
38
39       LENGTH    message length in bytes
40
41       The  -l  option prints the following summary on each node's buffer sys‐
42       tem, after all messages for that node have been displayed.
43
44       - maximum size of the internal buffer pool
45
46       - amount of space currently used in the pool.
47
48       Individual message buffers hold network message packets, which  may  be
49       only  part  of  a  complete user message.  Normally, bfstate summarizes
50       packets into complete messages.  If all packets for a message  are  not
51       on  the same node, no information is displayed.  The -p option disables
52       this behaviour and one  line  on  information  is  displayed  for  each
53       packet.   The  -B  option  changes the maximum number of packet buffers
54       acquired (and hence displayable) from the node.
55

EXAMPLES

57       bfstate n12-14
58           Display the status of all  network  message  buffers  on  nodes  12
59           through 14.
60

DIAGNOSTICS

62       If no buffered messages are found, only the title line is displayed and
63       information from the -l option, if present.
64

SEE ALSO

66       bfctl(1), mpimsg(1)
67
68
69
70LAM 7.1.2                         March, 2006                       BFSTATE(1)