Update README

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

diff --git a/original/man3/getpw.3 b/original/man3/getpw.3
index 860bfef..0d67f9f 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,9 +29,9 @@
 .\" 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 2010-10-21 "GNU" "Linux Programmer's Manual"
+.TH GETPW 3 2015-01-22 "GNU" "Linux Programmer's Manual"
 .SH NAME
-getpw \- Re-construct password line entry
+getpw \- reconstruct password line entry
 .SH SYNOPSIS
 .nf
 .BR "#define _GNU_SOURCE" "             /* See feature_test_macros(7) */"
@@ -67,22 +69,32 @@ struct passwd {
 .PP
 For more information about the fields of this structure, see
 .BR passwd (5).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR getpw ()
 function returns 0 on success; on error, it returns \-1, and
 .I errno
 is set to indicate the error.
+
+If
+.I uid
+is not found in the password database,
+.BR getpw ()
+returns \-1, sets
+.I errno
+to 0, and leaves
+.I buf
+unchanged.
 .SH ERRORS
 .TP
+.BR 0 " or " ENOENT
+No user corresponding to
+.IR uid .
+.TP
 .B EINVAL
 .I buf
 is NULL.
 .TP
-.B ENOENT
-No user corresponding to
-.IR uid .
-.TP
 .B ENOMEM
 Insufficient memory to allocate
 .I passwd
@@ -91,7 +103,7 @@ structure.
 .TP
 .I /etc/passwd
 password database file
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 SVr2.
 .SH BUGS
 The
@@ -100,7 +112,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),
@@ -109,3 +121,12 @@ It is obsoleted by
 .BR putpwent (3),
 .BR setpwent (3),
 .BR passwd (5)
+.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/.