]> granicus.if.org Git - procps-ng/commitdiff
docs: Merge procps_ns_* into misc
authorCraig Small <csmall@dropbear.xyz>
Mon, 21 Dec 2020 01:41:10 +0000 (12:41 +1100)
committerCraig Small <csmall@dropbear.xyz>
Mon, 21 Dec 2020 01:41:10 +0000 (12:41 +1100)
doc/procps_misc.3
doc/procps_ns_get_id.3 [deleted file]
doc/procps_ns_get_name.3 [deleted file]
doc/procps_ns_read_pid.3 [deleted file]

index 5ec4231125d465b42bdd6b72b5b11df281cde158..7304736c9b2738869d21a419f442ace67d262044 100644 (file)
 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 .\" %%%LICENSE_END
 .\"
-.TH PROCPS_MISC 3 2020-10-20 "libproc-2"
+.TH PROCPS_MISC 3 2020-12-21 "libproc-2"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .SH NAME
 procps_misc \- API to system information in the /proc filesystem
 .SH SYNOPSIS
 .nf
+.B #include <proc/namespace.h>
+.PP
+.BI "int procps_ns_get_id(const char * " name ");"
+.BI "const char *procps_ns_get_name(const int " id ");"
+.BI "int procps_ns_read_pid(const int " pid ", struct procps_namespaces * " nsp ");"
+.PP
 .B #include <proc/sysinfo.h>
 .PP
 .B long procps_cpu_count(void);
@@ -88,6 +94,16 @@ To encode a given Linux version, such as using it to compare against the current
 version, use the following macro:
 .TP
 .BI LINUX_VERSION( major , minor , patch )
+.PP
+.BR procps_ns_get_id ()
+finds the ID of the namespace for the given namespace name.
+
+.BR procps_ns_get_name ()
+finds the name of the namespace of the given integer ID.
+
+.BR procps_ns_read_pid ()
+puts the inodes for the namespaces of the given process into
+the array pointed to \fInsp\fR.
 
 .SH RETURN VALUE
 For
@@ -115,6 +131,20 @@ Unable to parse the osrelease file.
 .BR procps_linux_version ()
 may also return any (negated) value that \fBfopen\fR() may set errno to.
 
+.BR procps_ns_get_id ()
+returns an integer for the namespace ID for the given name or
+.B \-EINVAL
+for an invalid input or an unknown namespace name.
+
+.BR procps_ns_get_name ()
+returns a statically allocated string containing the name of the
+namespace for the given ID. If the name is not found the function
+returns
+.B NULL
+
+.BR procps_ns_read_pid ()
+Returns 0 on success and \fB\-EINVAL\fR on failure.
+
 .SH FILES
 .TP
 .I /proc/loadavg
@@ -125,6 +155,8 @@ Contains the release version of the Linux kernel or proc filesystem.
 .TP
 .I /proc/sys/kernel/pid_max
 Contains the value at which PIDs wrap around, one greater than the maximum PID value.
+.IB /proc/ PID /ns
+contains the set of namespaces for a particular \fBPID\fR.
 
 .SH BUGS
 Due to the way the three numbers are encoded into a single integer,
diff --git a/doc/procps_ns_get_id.3 b/doc/procps_ns_get_id.3
deleted file mode 100644 (file)
index 03993f7..0000000
+++ /dev/null
@@ -1,76 +0,0 @@
-.\" (C) Copyright 2020 Craig Small <csmall@dropbear.xyz>
-.\"
-.\" %%%LICENSE_START(LGPL_2.1+)
-.\" This manual is free software; you can redistribute it and/or
-.\" modify it under the terms of the GNU Lesser General Public
-.\" License as published by the Free Software Foundation; either
-.\" version 2.1 of the License, or (at your option) any later version.
-.\"
-.\" This manual is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-.\" Lesser General Public License for more details.
-.\"
-.\" You should have received a copy of the GNU Lesser General Public
-.\" License along with this library; if not, write to the Free Software
-.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-.\" %%%LICENSE_END
-.\"
-.TH PROCPS_LINUX_VERSION 3 2020-05-18 "libproc-2"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.SH NAME
-procps_ns \-
-provide information on the namespaces
-.SH SYNOPSIS
-.nf
-.B #include <proc/namespace.h>
-.PP
-.BI "int procps_ns_get_id(const char * " name ");"
-.BI "const char *procps_ns_get_name(const int " id ");"
-.BI "int procps_ns_read_pid(const int " pid ", struct procps_namespaces * " nsp ");"
-.sp
-Link with \fI\-lprocps\fP.
-.SH DESCRIPTION
-The family of
-.BR procps_ns ()
-functions return information about the Linux namespaces.
-
-.BR procps_ns_get_id ()
-finds the ID of the namespace for the given namespace name.
-
-.BR procps_ns_get_name ()
-finds the name of the namespace of the given integer ID.
-
-.BR procps_ns_read_pid ()
-puts the inodes for the namespaces of the given process into
-the array pointed to \fInsp\fR.
-
-.SH RETURN VALUE
-.BR procps_ns_get_id ()
-returns an integer for the namespace ID for the given name or
-.B \-EINVAL
-for an invalid input or an unknown namespace name.
-
-.BR procps_ns_get_name ()
-returns a statically allocated string containing the name of the
-namespace for the given ID. If the name is not found the function
-returns
-.B NULL
-
-.BR procps_ns_read_pid ()
-Returns 0 on success and \fB\-EINVAL\fR on failure.
-
-.SH FILES
-.TP
-.IB /proc/ PID /ns
-contains the set of namespaces for a particular \fBPID\fR.
-
-.SH VERSIONS
-The
-.BR procps_ns ()
-set of functions first appeared in libproc-2 version 0.0.
-
-.SH SEE ALSO
-.BR proc (5),
-.BR namespaces (7).
diff --git a/doc/procps_ns_get_name.3 b/doc/procps_ns_get_name.3
deleted file mode 100644 (file)
index ba81a00..0000000
+++ /dev/null
@@ -1 +0,0 @@
-.so man3/procps_ns_get_id.3
diff --git a/doc/procps_ns_read_pid.3 b/doc/procps_ns_read_pid.3
deleted file mode 100644 (file)
index ba81a00..0000000
+++ /dev/null
@@ -1 +0,0 @@
-.so man3/procps_ns_get_id.3