OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / man3 / confstr.3
index cc5c633..c39c1db 100644 (file)
@@ -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.
 .\"
 .\" 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"
+.\"
+.TH CONFSTR 3  2014-03-20 "GNU" "Linux Programmer's Manual"
 .SH NAME
 confstr \- get configuration dependent string variables
 .SH SYNOPSIS
@@ -76,7 +79,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\\0\(aq) as terminator.
 This can be detected by comparing the return value of
 .BR confstr ()
 against
@@ -89,7 +92,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,
@@ -119,10 +122,10 @@ is set to
 .SH ERRORS
 .TP
 .B EINVAL
-If the value of
+The value of
 .I name
 is invalid.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 POSIX.1-2001.
 .SH EXAMPLE
 The following code fragment determines the path where to find
@@ -134,14 +137,27 @@ the POSIX.2 system utilities:
 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);
 .in
 .fi
-.SH "SEE ALSO"
+.SH SEE ALSO
+.BR getconf (1),
 .BR sh (1),
 .BR exec (3),
+.BR fpathconf (3)
+.BR sysconf (3)
+.BR pathconf (3)
 .BR system (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.