summaryrefslogtreecommitdiffstats
path: root/man/newgidmap.1.xml
diff options
context:
space:
mode:
Diffstat (limited to 'man/newgidmap.1.xml')
-rw-r--r--man/newgidmap.1.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/man/newgidmap.1.xml b/man/newgidmap.1.xml
index e4ebc69..e5b770e 100644
--- a/man/newgidmap.1.xml
+++ b/man/newgidmap.1.xml
@@ -116,6 +116,17 @@
<para>
Note that newgidmap may be used only once for a given process.
</para>
+ <para>
+ Instead of an integer process id, the first argument may be
+ specified as <replaceable>fd:N</replaceable>, where the integer N
+ is the file descriptor number for the calling process's opened
+ file descriptor for the directory <filename>/proc/[pid]</filename>.
+ In this case, <command>newgidmap</command> will use
+ <refentrytitle>openat</refentrytitle><manvolnum>2</manvolnum>
+ to open the <filename>gid_map</filename> file under that
+ directory, avoiding a TOCTTOU in case the process exits and
+ the pid is immediately reused.
+ </para>
</refsect1>