FSTATE(1)

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 doom command.

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)