From nobody Sat Apr 09 21:48:27 2022 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 6B7661A8B0FD; Sat, 9 Apr 2022 21:48:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KbTJX0qhNz4dMv; Sat, 9 Apr 2022 21:48:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649540908; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=srlWykCojzDIpFtwENwkJFYhJAmj+j5zZJiQ2aU9XLg=; b=BLYhOgxFP/AlOrxrtxWHPqwHi4FOc1UW4Rc6Z3Nuo+hqKzzFyRRDheCTcZP3OjyLIaPEUB 3ipG4N49LkWzkg3+R5W0rxAAQ66ALscwY2GqOVzwnK/BYnXXrfwu20+TMeg7HFxF0ji1pj LQMZlkYoH2kmTPTRHlYMOdd/RJS+vBTen6PLgkoM/dHpSqPsmwzvzvXXiEnUE6+v1YtUHk QeEt74HlFk2xksKGy45KYWs7EkLZDoEkjk1ZytZokWb2boAqvWP3S61i5H4UjexXOFVAgV DOu99i2z3xoEoRhxVxTQAlsucoAFCfyp0Ovr3Z1v1JvJLvbZDCQR6u9gsljnPQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 99AC521D96; Sat, 9 Apr 2022 21:48:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 239LmRB2093217; Sat, 9 Apr 2022 21:48:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 239LmRSl093216; Sat, 9 Apr 2022 21:48:27 GMT (envelope-from git) Date: Sat, 9 Apr 2022 21:48:27 GMT Message-Id: <202204092148.239LmRSl093216@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Konstantin Belousov Subject: git: bd8701dede10 - main - Document procstat(1) advlock command List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: kib X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bd8701dede10cb308919152ca82d8200d09f204b Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649540908; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=srlWykCojzDIpFtwENwkJFYhJAmj+j5zZJiQ2aU9XLg=; b=l7JDkEWg4Nuzm7F68b05BEUHF630IXCBMkxG2qOV5/jDMxVsI968HEiMXgmsSxMlmbDLzP h3klYykN2P5wHQU77TLmjcStfFFDWojWKWSFJdsxLC2dBpY/gk7ZvmVIu7rFKI/SLa3hhD RmKAmR3jgy1oH/RxHe3uIN+wExquDnilGaUE18EIaB2IllmReh1vQhkEaQCoh9QmprFDUI F2nrG9RPlDFcRmgTG2UBOsAC0vxToFaLFP4ikrwrsOyhb4kU5ljkTpgDenIBbWtjBZW1gS lfdEGXcUe2wJnp0Wvt7t+AQUIwiywrOhizMi1VE9L6aSrbJPJGrUmvK56Bt+mQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649540908; a=rsa-sha256; cv=none; b=UGXihmCqtm5DnWa8vYEGCohUzEOm+nYMzHpw0czq3w1Lz+w2F06bI4hNx5IzQl4ZrfKVYk WTFfUGow7KMJRmIDO+Z/v12HPdSBaX61SbZbqUW2rLjBvQajQ7cXeOJeqixNj9bo/iXgYe K9FBnqbgHre1DrjKv/1GCkbRXYU6zumYMnUuXZMUsIqjW1PD9bKCUp3GtvEezXTOt7IeC9 pj7vtn0J7EQ46FJOdPf46NDuIHo0ybUdiO63VyyQb9pvK6Dtc8j5etgcXjbMDRoBxHLT93 DiM0Ov1fHatFClWhs0dKP/Ly/6NBdRUEAaXw3NDYuXNi7cVzi1DngbHTluUQNA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=bd8701dede10cb308919152ca82d8200d09f204b commit bd8701dede10cb308919152ca82d8200d09f204b Author: Konstantin Belousov AuthorDate: 2022-04-07 19:49:54 +0000 Commit: Konstantin Belousov CommitDate: 2022-04-09 21:47:50 +0000 Document procstat(1) advlock command Reviewed by: markj Sponsored by: The FreeBSD Foundation MFC after: 1 week Differential revision: https://reviews.freebsd.org/D34834 --- 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