X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man3%2Fconfstr.3;h=dcf5426f9a8af7d8f9fbf5d0c06a880c50513d7d;hb=3e4c47dde200c58cb75c26e683de79efb5991714;hp=cc5c63375a516bdd063b97a0caf1a1969ae0a425;hpb=e313308d808cbb020a1c9b1b17591b94b91f0b28;p=thirdparty%2Fman-pages.git

diff --git a/man3/confstr.3 b/man3/confstr.3
index cc5c63375a..dcf5426f9a 100644
--- a/man3/confstr.3
+++ b/man3/confstr.3
@@ -1,5 +1,6 @@
 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,28 +20,31 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
-.\" License.
+.\" %%%LICENSE_END
+.\"
 .\" Modified Sat Jul 24 19:53:02 1993 by Rik Faith (faith@cs.unc.edu)
+.\"
 .\" FIXME Many more values for 'name' are supported, some of which
-.\"	are documented under 'info confstr'.
-.\"	See <bits/confname.h> for the rest.
-.\"	These should all be added to this page.
-.\"	See also the POSIX.1-2001 specification of confstr()
-.TH CONFSTR 3  2010-02-03 "GNU" "Linux Programmer's Manual"
+.\" are documented under 'info confstr'.
+.\" See <bits/confname.h> for the rest.
+.\" These should all be added to this page.
+.\" See also the POSIX.1-2001 specification of confstr()
+.\"
+.TH CONFSTR 3  2019-03-06 "GNU" "Linux Programmer's Manual"
 .SH NAME
 confstr \- get configuration dependent string variables
 .SH SYNOPSIS
 .nf
 .B #include <unistd.h>
-.sp
+.PP
 .BI "size_t confstr(int " "name" ", char *" buf ", size_t " len );
 .fi
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .BR confstr ():
 _POSIX_C_SOURCE\ >=\ 2 || _XOPEN_SOURCE
 .SH DESCRIPTION
@@ -54,11 +58,11 @@ The following variables are supported:
 .TP
 .BR _CS_GNU_LIBC_VERSION " (GNU C library only; since glibc 2.3.2)"
 A string which identifies the GNU C library version on this system
-(e.g, "glibc 2.3.4").
+(e.g., "glibc 2.3.4").
 .TP
 .BR _CS_GNU_LIBPTHREAD_VERSION " (GNU C library only; since glibc 2.3.2)"
 A string which identifies the POSIX implementation supplied by this
-C library (e.g, "NPTL 2.3.4" or "linuxthreads-0.10").
+C library (e.g., "NPTL 2.3.4" or "linuxthreads-0.10").
 .TP
 .B _CS_PATH
 A value for the
@@ -76,7 +80,7 @@ copies the value of the string to
 .I buf
 truncated to
 .I len \- 1
-characters if necessary, with a null byte (\(aq\\0\(aq) as terminator.
+bytes if necessary, with a null byte (\(aq\e0\(aq) as terminator.
 This can be detected by comparing the return value of
 .BR confstr ()
 against
@@ -89,7 +93,7 @@ is zero and
 is NULL,
 .BR confstr ()
 just returns the value as defined below.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 If
 .I name
 is a valid configuration variable,
@@ -101,7 +105,7 @@ This value may be greater than
 which means that the value in
 .I buf
 is truncated.
-
+.PP
 If
 .I name
 is a valid configuration variable,
@@ -119,29 +123,44 @@ is set to
 .SH ERRORS
 .TP
 .B EINVAL
-If the value of
+The value of
 .I name
 is invalid.
-.SH "CONFORMING TO"
-POSIX.1-2001.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR confstr ()
+T}	Thread safety	MT-Safe
+.TE
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008.
 .SH EXAMPLE
 The following code fragment determines the path where to find
 the POSIX.2 system utilities:
-.br
-.nf
+.PP
 .in +4n
-
+.EX
 char *pathbuf;
 size_t n;
 
-n = confstr(_CS_PATH,NULL,(size_t) 0);
+n = confstr(_CS_PATH, NULL, (size_t) 0);
 pathbuf = malloc(n);
 if (pathbuf == NULL)
     abort();
 confstr(_CS_PATH, pathbuf, n);
+.EE
 .in
-.fi
-.SH "SEE ALSO"
+.SH SEE ALSO
+.BR getconf (1),
 .BR sh (1),
 .BR exec (3),
+.BR fpathconf (3),
+.BR pathconf (3),
+.BR sysconf (3),
 .BR system (3)