Manually tweak a few pages that weren't covered by the script used in the previous commit. Cc: Ingo Schwarze <schwarze@xxxxxxxxxxx> Cc: "G. Branden Robinson" <g.branden.robinson@xxxxxxxxx> Signed-off-by: Alejandro Colomar <alx@xxxxxxxxxx> --- man3/get_nprocs.3 | 96 +++++++++++++++++++++++++++++++++- man3/get_nprocs_conf.3 | 96 +--------------------------------- man3/program_invocation_name.3 | 2 +- man7/sysvipc.7 | 2 +- 4 files changed, 98 insertions(+), 98 deletions(-) diff --git a/man3/get_nprocs.3 b/man3/get_nprocs.3 index 63c03bac7..98478cb80 100644 --- a/man3/get_nprocs.3 +++ b/man3/get_nprocs.3 @@ -1 +1,95 @@ -.so man3/get_nprocs_conf.3 +.\" Copyright (c) 2012, Petr Benas +.\" and Copyright (c) 2012, Michael Kerrisk <mtk.man-pages@xxxxxxxxx> +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.TH get_nprocs 3 (date) "Linux man-pages (unreleased)" +.SH NAME +get_nprocs, get_nprocs_conf \- get number of processors +.SH LIBRARY +Standard C library +.RI ( libc ", " \-lc ) +.SH SYNOPSIS +.nf +.B #include <sys/sysinfo.h> +.PP +.B int get_nprocs(void); +.B int get_nprocs_conf(void); +.fi +.SH DESCRIPTION +The function +.BR get_nprocs_conf () +returns the number of processors configured by the operating system. +.PP +The function +.BR get_nprocs () +returns the number of processors currently available in the system. +This may be less than the number returned by +.BR get_nprocs_conf () +because processors may be offline (e.g., on hotpluggable systems). +.SH RETURN VALUE +As given in DESCRIPTION. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.ad l +.nh +.TS +allbox; +lbx lb lb +l l l. +Interface Attribute Value +T{ +.BR get_nprocs (), +.BR get_nprocs_conf () +T} Thread safety MT-Safe +.TE +.hy +.ad +.sp 1 +.SH STANDARDS +These functions are GNU extensions. +.SH NOTES +The current +.\" glibc 2.15 +implementation of these functions is rather expensive, +since they open and parse files in the +.I /sys +filesystem each time they are called. +.PP +The following +.BR sysconf (3) +calls make use of the functions documented on this page +to return the same information. +.PP +.in +4n +.EX +np = sysconf(_SC_NPROCESSORS_CONF); /* processors configured */ +np = sysconf(_SC_NPROCESSORS_ONLN); /* processors available */ +.EE +.in +.SH EXAMPLES +The following example shows how +.BR get_nprocs () +and +.BR get_nprocs_conf () +can be used. +.PP +.\" SRC BEGIN (get_nprocs_conf.c) +.EX +#include <stdio.h> +#include <stdlib.h> +#include <sys/sysinfo.h> + +int +main(void) +{ + printf("This system has %d processors configured and " + "%d processors available.\en", + get_nprocs_conf(), get_nprocs()); + exit(EXIT_SUCCESS); +} +.EE +.\" SRC END +.SH SEE ALSO +.BR nproc (1) diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3 index 1cf7f2070..7de3e2b31 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -1,95 +1 @@ -.\" Copyright (c) 2012, Petr Benas -.\" and Copyright (c) 2012, Michael Kerrisk <mtk.man-pages@xxxxxxxxx> -.\" -.\" SPDX-License-Identifier: Linux-man-pages-copyleft -.\" -.TH GET_NPROCS 3 (date) "Linux man-pages (unreleased)" -.SH NAME -get_nprocs, get_nprocs_conf \- get number of processors -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.B #include <sys/sysinfo.h> -.PP -.B int get_nprocs(void); -.B int get_nprocs_conf(void); -.fi -.SH DESCRIPTION -The function -.BR get_nprocs_conf () -returns the number of processors configured by the operating system. -.PP -The function -.BR get_nprocs () -returns the number of processors currently available in the system. -This may be less than the number returned by -.BR get_nprocs_conf () -because processors may be offline (e.g., on hotpluggable systems). -.SH RETURN VALUE -As given in DESCRIPTION. -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.ad l -.nh -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.BR get_nprocs (), -.BR get_nprocs_conf () -T} Thread safety MT-Safe -.TE -.hy -.ad -.sp 1 -.SH STANDARDS -These functions are GNU extensions. -.SH NOTES -The current -.\" glibc 2.15 -implementation of these functions is rather expensive, -since they open and parse files in the -.I /sys -filesystem each time they are called. -.PP -The following -.BR sysconf (3) -calls make use of the functions documented on this page -to return the same information. -.PP -.in +4n -.EX -np = sysconf(_SC_NPROCESSORS_CONF); /* processors configured */ -np = sysconf(_SC_NPROCESSORS_ONLN); /* processors available */ -.EE -.in -.SH EXAMPLES -The following example shows how -.BR get_nprocs () -and -.BR get_nprocs_conf () -can be used. -.PP -.\" SRC BEGIN (get_nprocs_conf.c) -.EX -#include <stdio.h> -#include <stdlib.h> -#include <sys/sysinfo.h> - -int -main(void) -{ - printf("This system has %d processors configured and " - "%d processors available.\en", - get_nprocs_conf(), get_nprocs()); - exit(EXIT_SUCCESS); -} -.EE -.\" SRC END -.SH SEE ALSO -.BR nproc (1) +.so man3/get_nprocs.3 diff --git a/man3/program_invocation_name.3 b/man3/program_invocation_name.3 index 6110d826e..97d787470 100644 --- a/man3/program_invocation_name.3 +++ b/man3/program_invocation_name.3 @@ -21,7 +21,7 @@ .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" -.TH INVOCATION_NAME 3 (date) "Linux man-pages (unreleased)" +.TH program_invocation_name 3 (date) "Linux man-pages (unreleased)" .SH NAME program_invocation_name, program_invocation_short_name \- \ obtain name used to invoke calling program diff --git a/man7/sysvipc.7 b/man7/sysvipc.7 index e801794b0..4b3576157 100644 --- a/man7/sysvipc.7 +++ b/man7/sysvipc.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH SVIPC 7 (date) "Linux man-pages (unreleased)" +.TH sysvipc 7 (date) "Linux man-pages (unreleased)" .SH NAME sysvipc \- System V interprocess communication mechanisms .SH DESCRIPTION -- 2.37.2