NAME
fstate - Report information on LAM remote file daemon.
SYNTAX
fstate [-ah] [-F <ndesc>] <nodes>
OPTIONS
- -a
- Report on active descriptors only.
- -h
- Print the command help menu.
- -F <ndesc>
- Report up to a limit of <ndesc> descriptors.
DESCRIPTION
Most MPI users will probably not need to use
the fstate command. This command is only installed if
LAM/MPI was configured with the --with-trillium switch.
The fstate command reports on open file descriptors
maintained by the remote file daemon. With no options, information
is printed on all open descriptors under the following headings:
- FD
- the LAM descriptor handle, different than the client handle or
actual UNIX handle
- FLAGS
- the open flags: R for read, W for write, A for active, L for
locked active
- FLOW
- the total number of bytes transferred in both directions
- CLIENT
- the node ID and process ID of the last client
- NAME
- the file name
The file deamon is a UNIX process, and UNIX processes are
limited in the number of UNIX file descriptors (fd) that they can
open at any one time. Yet the number of LAM processes is
essentially unlimited. LAM descriptors are associated with each
client's open user descriptors, and are used by LAM to identify the
file. They are temporarily assigned UNIX file descriptors. When
this happens, the status of the filed descriptor is active. Locked
filed descriptors remain active continuously.
EXAMPLE
- fstate h
- Report all filed descriptors, representing every open file in
the LAM network.
SEE ALSO
fctl(1)