nfslockadm(1M) — Reliant UNIX 5.44c4

nfslockadm(1M)                                               nfslockadm(1M)

NAME
     nfslockadm - display and delete locks on an NFS server

SYNOPSIS
     nfslockadm -i

     nfslockadm option ...

DESCRIPTION
     With nfslockadm file and record locks on an NFS server can be
     displayed and deleted.

     You can display granted and blocked locks from local processes and NFS
     client processes.

     You can delete granted locks from NFS client processes.

     nfslockadm may only be executed by the superuser. When invoked with
     the -i option, nfslockadm will display a help text and switch to
     interactive command mode.

     The following commands are possible in this mode:

   Displaying Locks

     show file fname
          displays all granted locks on the local file fname if the file
          lies within an exported file system

     show client cname
          displays all granted locks of client cname

     show granted
          displays all granted locks

     show all
          displays all granted and blocked locks

     The displayed data contains

     -  an index for the lock (which is used to delete a specific lock)

     -  device and inode number of the locked file (not for blocked files)

     -  lock type (shared or exclusive)

     -  locked area (offset and length)

     -  name and process ID of the client

     -  if the lock is blocked: owner (= client name and process ID) of the
        lock that is blocking the one displayed.



Page 1                       Reliant UNIX 5.44                Printed 11/98

nfslockadm(1M)                                               nfslockadm(1M)

     The data is displayed in pages. After a page has been displayed you
     can terminate the display function by entering q. Any other key will
     display the next page of data.

   Deleting Locks

     CAUTION: Delete locks only if you are sure that this will not lead to
     data inconsistencies! Particular attention must be paid in the follow-
     ing situations:

     -  the client host is not running but still holds locks on the server

     -  client processes that are no longer active still hold locks on the
        server

     The commands for deleting locks must be confirmed for safety reasons:

     delete id
          deletes the lock with the index id from the most recently
          displayed lock table. This is only possible when a display has
          previously been invoked.

     delete client cname
          deletes all granted locks from the client cname

   Miscellaneous Commands

     help displays the help text

     quit terminates nfslockadm

     If a valid option apart from -i is given, nfslockadm displays the cor-
     responding locks on standard output. The interactive command mode will
     not be entered. The options have the following meaning:

     -f fname
          displays all granted locks on the file fname if the file lies
          within an exported file system.

          Corresponds to the output of show file.

     -c cname
          displays all granted locks from client cname.

          Corresponds to the output of show client.

     -g   displays all granted locks.

          Corresponds to the output of show granted.





Page 2                       Reliant UNIX 5.44                Printed 11/98

nfslockadm(1M)                                               nfslockadm(1M)

     -a   displays all granted and blocked locks.

          Corresponds to the output of show all.

     With these options all display functions from the interactive command
     mode can also be invoked non-interactively. Moreover, this offers a
     simple way to store the displayed data in files by redirecting the
     output.

SEE ALSO
     getrlent(3N), removerlock(3N).











































Page 3                       Reliant UNIX 5.44                Printed 11/98

Museum

Related Articles