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

NAME

6       fstate - Report information on LAM remote file daemon.
7

SYNTAX

9       fstate [-ah] [-F <ndesc>] <nodes>
10

OPTIONS

12       -a            Report on active descriptors only.
13
14       -h            Print the command help menu.
15
16       -F <ndesc>    Report up to a limit of <ndesc> descriptors.
17

DESCRIPTION

19       Most  MPI users will probably not need to use the fstate command.  This
20       command is only installed if LAM/MPI was configured  with  the  --with-
21       trillium switch.
22
23       The  fstate  command reports on open file descriptors maintained by the
24       remote file daemon.  With no options, information  is  printed  on  all
25       open descriptors under the following headings:
26
27       FD        the  LAM  descriptor handle, different than the client handle
28                 or actual UNIX handle
29
30       FLAGS     the open flags: R for read, W for write, A for active, L  for
31                 locked active
32
33       FLOW      the total number of bytes transferred in both directions
34
35       CLIENT    the node ID and process ID of the last client
36
37       NAME      the file name
38
39       The  file  deamon  is a UNIX process, and UNIX processes are limited in
40       the number of UNIX file descriptors (fd) that they can open at any  one
41       time.   Yet  the number of LAM processes is essentially unlimited.  LAM
42       descriptors are associated with each client's  open  user  descriptors,
43       and  are  used  by  LAM  to  identify  the  file.  They are temporarily
44       assigned UNIX file descriptors.  When this happens, the status  of  the
45       filed  descriptor  is  active.   Locked filed descriptors remain active
46       continuously.
47

EXAMPLE

49       fstate h
50           Report all filed descriptors, representing every open file  in  the
51           LAM network.
52

SEE ALSO

54       fctl(1)
55
56
57
58LAM 7.1.2                         March, 2006                        FSTATE(1)
Impressum