From: Masatake YAMATO <yamato@redhat.com>
Date: Fri, 9 Sep 2022 17:09:01 +0000 (+0900)
Subject: lsfd: (man) write about PIDFD.* columns
X-Git-Tag: v2.39-rc1~527^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f2116342e9b2ddc4d581496078a8b222330af90e;p=thirdparty%2Futil-linux.git

lsfd: (man) write about PIDFD.* columns
---

diff --git a/misc-utils/lsfd.1.adoc b/misc-utils/lsfd.1.adoc
index f782b83c21..20d9e981e5 100644
--- a/misc-utils/lsfd.1.adoc
+++ b/misc-utils/lsfd.1.adoc
@@ -217,6 +217,28 @@ Block device name resolved by `/proc/partition`.
 PID <``number``>::
 PID of the process opening the file.
 
+PIDFD.COMM <``string``>::
+Command of the process targeted by the pidfd.
+
+PIDFD.NSPID <``string``>::
+Value of NSpid field in ``/proc/``_pid_``/fdinfo/``_fd_ of the pidfd.
++
+Quoted from kernel/fork.c of Linux source tree:
++
+____
+If pid namespaces are supported then this function will also print
+the pid of a given pidfd refers to for all descendant pid namespaces
+starting from the current pid namespace of the instance, i.e. the
+Pid field and the first entry in the NSpid field will be identical.
+...
+Note that this differs from the Pid and NSpid fields in
+/proc/<pid>/status where Pid and NSpid are always shown relative to
+the  pid namespace of the procfs instance.
+____
+
+PIDFD.PID <``number``>::
+PID of the process targeted by the pidfd.
+
 POS <``number``>::
 File position.