From nobody Sat Apr 16 02:18:49 2022 X-Original-To: dev-commits-src-branches@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 577A17C8071; Sat, 16 Apr 2022 02:18:50 +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 4KgH1k0C54z4m7y; Sat, 16 Apr 2022 02:18:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1650075530; 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=b1dH4DRacjxTkDNdbfIWrPqWxzncOy1gW2B16VyBmJQ=; b=JZ1pufEZC00hCWz/xeow8juUhmleglyiZ+BE7ehwgjnZa1bdRjyx3O1p0X0gYALxgfNVFT a/w6fTHe/1By1J93e6tIiSHVLgMUGxDfgtUVG9K+DEcPfb7vNQErIXOP50L/Rff+LiV2Nk v8RPNOKzT/LmL7qLSIHzSWK8tNfaryHrKKxbJH82x5+n0ps+18VCCiVxxFA8WBes1wj8WU yxT9kv/W/PvIgLgFzuL0YdIgzqH1eVZk3+TA+vDXzgGdrtsJPUyGPKq7AjN350Qe3h4Xor y7jJPMUhbRPKD4beZrov7WGOD9H6wob1FhxZifnk1YtobEmcGBV9v53Ktv8gtA== 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 CA81520B64; Sat, 16 Apr 2022 02:18:49 +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 23G2Inue025554; Sat, 16 Apr 2022 02:18:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23G2In4i025553; Sat, 16 Apr 2022 02:18:49 GMT (envelope-from git) Date: Sat, 16 Apr 2022 02:18:49 GMT Message-Id: <202204160218.23G2In4i025553@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Konstantin Belousov Subject: git: f9daaf452a8a - stable/13 - Document procstat(1) advlock command List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/stable/13 X-Git-Reftype: branch X-Git-Commit: f9daaf452a8a5a3791debb6da61958a7d99a9ead Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1650075530; 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=b1dH4DRacjxTkDNdbfIWrPqWxzncOy1gW2B16VyBmJQ=; b=I4ZohlPSWSvOUPCJEBuSGZAqL5nnK8ZRvhErDXX1dBNep7nYDPPKVMFFucz6IqSS2ZRIIA /WNKv0af7YYcyd5WVXdmA72QXv+ByA3e0KJnRH+BFFZZHfhTA++3qQJL4qya7VWJ/FonGo ynT02qLrhD+sXTTM52mADN8j4OhWcTVGyib/L0H1Zap++UERh7U5x1b0/KdBPDbYDTlIvf aKDPd0c3F1t5ObdFq1qujZxp+jnwqGwRcUE5AVcID4SdvVwmH8+THIQ+pivi3fMaylHSc7 kE7V6qfBUGy8y+GsRHxumddcBQuu9avo+Zqy1Mug8A5jnuT8OHtb5WSqMtrFPA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1650075530; a=rsa-sha256; cv=none; b=CgjSikVjLq3oLIuOh0vYWr9HdNeIBLg6eGbd0fbekyXYbKke/i1fk3mFFlAnAH0LghFNSW malAeL65D07GpooZwIk5rrnfQ01znT8EYOUFMCfSni1NfuGI4sSrO5sQndJ3lMHV40XlCy EsQ+Qh4kjKJnutMTHpL/BDhpk3PBMlj3OLsVT1X0h+iCCJhXZYRO/odkR+jFVLPEj8VFvq 2R4m6JaAXeZDTSl7mDPivmACzoIFXogmAakzZ1RFwmKinaCnTDwVwMmX62c903uuPhcACY 6AKBVKgI4r60r4qt7L7uTS/42Nxxtt/oRKQe5x2SfzQIEa06cStidxmhdM0P1w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=f9daaf452a8a5a3791debb6da61958a7d99a9ead commit f9daaf452a8a5a3791debb6da61958a7d99a9ead Author: Konstantin Belousov AuthorDate: 2022-04-07 19:49:54 +0000 Commit: Konstantin Belousov 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