git: f9daaf452a8a - stable/13 - Document procstat(1) advlock command

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Sat, 16 Apr 2022 02:18:49 UTC
The branch stable/13 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=f9daaf452a8a5a3791debb6da61958a7d99a9ead

commit f9daaf452a8a5a3791debb6da61958a7d99a9ead
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2022-04-07 19:49:54 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2022-04-16 02:18:19 +0000

    Document procstat(1) advlock command
    
    (cherry picked from commit bd8701dede10cb308919152ca82d8200d09f204b)
---
 usr.bin/procstat/procstat.1 | 58 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/usr.bin/procstat/procstat.1 b/usr.bin/procstat/procstat.1
index affe69ffb615..65299c7f07e9 100644
--- a/usr.bin/procstat/procstat.1
+++ b/usr.bin/procstat/procstat.1
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 13, 2021
+.Dd April 7, 2022
 .Dt PROCSTAT 1
 .Os
 .Sh NAME
@@ -144,6 +144,23 @@ for details on command line arguments.
 The following commands are available for
 .Nm :
 .Bl -tag -width indent
+.It Ar advlock
+Print information about advisory locks on files.
+All three types of locks are listed, BSD-style
+.Xr lockf 2 ,
+POSIX-style
+.Xr fcntl 2
+.Va F_SETLK ,
+and remote
+.Xr lockd 8
+locks used by NFSv3.
+.Pp
+Note that neither the
+.Fl a
+option nor
+.Va pid
+list can be used to limit the display of the locks, mostly because
+some types of locks do not have local (or any) owning processes.
 .It Ar basic
 Print basic process statistics (this is the default).
 .It Ar binary | Fl b
@@ -710,6 +727,45 @@ auxiliary vector name
 .It VALUE
 auxiliary vector value
 .El
+.Ss Advisory Lock Information
+.Bl -tag -width indent -compact
+.It RW
+Read/Write type,
+.Va RO
+for read,
+.Va RW
+for write lock
+.It TYPE
+Type of the lock, one of
+.Va FLOCK
+for
+.Xr flock 2 ,
+.Va FCNTL
+for
+.Xr fcntl 2 ,
+.Va LOCKD
+for remote
+.It PID
+Process id of the owner, for
+.Va FCNTL
+and remote types
+.It SYSID
+Remote system id if applicable
+.It FSID
+File system id where the locked file resize
+.It RDEV
+rdev for the file system
+.It INO
+Unique file identifier (inode number) of the locked file
+on the file system
+.It START
+Start offset of the locked range
+.It LEN
+Length of the locked range.
+Zero means till EOF
+.It PATH
+If available, the path of the locked file
+.El
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES