fstate



FSTATE(1)                        LAM COMMANDS                        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 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)



LAM 7.1.1                       September, 2004                      FSTATE(1)

Man(1) output converted with man2html