(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man3 / getpw.3

diff --git a/original/man3/getpw.3 b/original/man3/getpw.3
index 9f0a16b..f2ac6e3 100644 (file)
--- a/original/man3/getpw.3
+++ b/original/man3/getpw.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%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,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -27,12 +29,12 @@
 .\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de)
 .\"
-.TH GETPW 3 2007-12-12 "GNU" "Linux Programmer's Manual"
+.TH GETPW 3 2010-10-21 "GNU" "Linux Programmer's Manual"
 .SH NAME
-getpw \- Re-construct password line entry
+getpw \- reconstruct password line entry
 .SH SYNOPSIS
 .nf
-.B #define _GNU_SOURCE
+.BR "#define _GNU_SOURCE" "             /* See feature_test_macros(7) */"
 .B #include <sys/types.h>
 .B #include <pwd.h>
 .sp
@@ -58,13 +60,16 @@ struct passwd {
     char   *pw_passwd;     /* user password */
     uid_t   pw_uid;        /* user ID */
     gid_t   pw_gid;        /* group ID */
-    char   *pw_gecos;      /* real name */
+    char   *pw_gecos;      /* user information */
     char   *pw_dir;        /* home directory */
     char   *pw_shell;      /* shell program */
 };
 .fi
 .in
-.SH "RETURN VALUE"
+.PP
+For more information about the fields of this structure, see
+.BR passwd (5).
+.SH RETURN VALUE
 The
 .BR getpw ()
 function returns 0 on success; on error, it returns \-1, and
@@ -88,7 +93,7 @@ structure.
 .TP
 .I /etc/passwd
 password database file
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 SVr2.
 .SH BUGS
 The
@@ -97,7 +102,7 @@ function is dangerous as it may overflow the provided buffer
 .IR buf .
 It is obsoleted by
 .BR getpwuid (3).
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR endpwent (3),
 .BR fgetpwent (3),
 .BR getpwent (3),
@@ -106,3 +111,11 @@ It is obsoleted by
 .BR putpwent (3),
 .BR setpwent (3),
 .BR passwd (5)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.