NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OUTPUT | NOTES | AUTHORS | SEE ALSO | AVAILABILITY | COLOPHON


LSLOCKS(8)                  System Administration                 LSLOCKS(8)

NAME         top

       lslocks - list local system locks

SYNOPSIS         top

       lslocks [options]

DESCRIPTION         top

       lslocks lists information about all the currently held file locks in
       a Linux system.

OPTIONS         top

       -i, --noinaccessible
              Ignore lock files which are inaccessible for the current user.

       -J, --json
              Use JSON output format.

       -n, --noheadings
              Do not print a header line.

       -o, --output list
              Specify which output columns to print.  Use --help to get a
              list of all supported columns.

              The default list of columns may be extended if list is
              specified in the format +list (e.g. lslocks -o +BLOCKER).

       -p, --pid pid
              Display only the locks held by the process with this pid.

       -r, --raw
              Use the raw output format.

       -u, --notruncate
              Do not truncate text in columns.

       -V, --version
              Display version information and exit.

       -h, --help
              Display help text and exit.

OUTPUT         top

       COMMAND
              The command name of the process holding the lock.

       PID    The process ID of the process which holds the lock.

       TYPE   The type of lock; can be FLOCK (created with flock(2)) or
              POSIX (created with fcntl(2) and lockf(3)).

       SIZE   Size of the locked file.

       MODE   The lock's access permissions (read, write).  If the process
              is blocked and waiting for the lock, then the mode is
              postfixed with an '*' (asterisk).

       M      Whether the lock is mandatory; 0 means no (meaning the lock is
              only advisory), 1 means yes.  (See fcntl(2).)

       START  Relative byte offset of the lock.

       END    Ending offset of the lock.

       PATH   Full path of the lock.  If none is found, or there are no
              permissions to read the path, it will fall back to the
              device's mountpoint and "..." is appended to the path.  The
              path might be truncated; use --notruncate to get the full
              path.

       BLOCKER
              The PID of the process which blocks the lock.

NOTES         top

       The lslocks command is meant to replace the lslk(8) command,
       originally written by Victor A. Abell <abe@purdue.edu> and unmaintained
       since 2001.

AUTHORS         top

       Davidlohr Bueso <dave@gnu.org>

SEE ALSO         top

       flock(1), fcntl(2), lockf(3)

AVAILABILITY         top

       The lslocks command is part of the util-linux package and is
       available from https://www.kernel.org/pub/linux/utils/util-linux/.

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩.  If you have a
       bug report for this manual page, send it to
       util-linux@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository 
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2017-07-05.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to man-pages@man7.org

util-linux                      December 2014                     LSLOCKS(8)

Pages that refer to this page: fcntl(2)flock(2)proc(5)