Commit Graph

39 Commits

Author SHA1 Message Date
Michael Kerrisk f6dc36110c getpwnam.3: Fix discussion of _SC_GETPW_R_SIZE_MAX
The value is not meant to be a maximum (as was specified in
SUSv3) but an initial guess at the required size
(as specified in SUSv4).

Reported-by: Ulrich Drepper <drepper@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-23 20:21:23 +12:00
Michael Kerrisk 958680cd75 getpwent.3, getpwnam.3: Note that pw_gecos is not in POSIX
And change the comment describing this field

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 11:54:48 +02:00
Michael Kerrisk 011520b834 getpwnam.3: Some rewording and restructuring
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 11:43:32 +02:00
Michael Kerrisk 008f1ecc43 intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:17 +02:00
Michael Kerrisk f496f649a2 getpwnam.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:07 +02:00
Michael Kerrisk 42afc4076c getpwnam.3: tfix
Reported-by: <sunjiangangok@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-12-03 15:17:53 +01:00
Michael Kerrisk db85058b5f getgrnam.3, getpwnam.3: srcfix: note that glibc 2.7 fixes error handling for "not found" case
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-01 08:30:46 +13:00
Michael Kerrisk 48e4cfa0de getgrent.3, getgrnam.3, getpwent.3, getpwnam.3: Note that returned pointer should not be given to free()
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-30 12:37:43 +13:00
Michael Kerrisk 57c1b002d9 getpwnam.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-30 11:41:07 +13:00
Michael Kerrisk 1ed5046249 getpwnam.3: SEE ALSO: add getspnam(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 17:39:35 +13:00
Michael Kerrisk c6ec368541 getpwnam.3: Add an EXAMPLE program for getpwnam_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:33 -05:00
Michael Kerrisk 3adc12e97f getpwnam.3: Rename arguments to getpwnam_r() and getpwuid_r()
s/pwbuf/pwd/ and s/pwbufp/result/, for consistency
with POSIX.1 argument names.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 17:51:32 -05:00
Michael Kerrisk bbab485de0 getpwnam.3: Clarify and add more detail in RETURN VALUE description
The page was a bit fuzzy in describing the return values for
various cases.  In particular, it needed to be more explicit
in describing what happens for the "not found" case.

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andreas Henriksson <andreas@fatal.se>
2008-11-07 17:51:32 -05:00
Michael Kerrisk 0f200f076c Add/fix feature test macro requirements. 2008-08-29 15:50:13 +00:00
Michael Kerrisk 44a2c3286c Even when the CONFORMING TO section is just a list of standards,
they should be terminated by a period.
2008-07-15 13:39:17 +00:00
Michael Kerrisk c4bb193f3c s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
2008-07-10 20:53:08 +00:00
Michael Kerrisk b213341443 ffix 2008-07-10 12:54:32 +00:00
Michael Kerrisk 18701562c1 s/user name/username/ 2008-06-30 14:36:59 +00:00
Michael Kerrisk c825020667 Fixed unbalanced .nf/fi pairs. 2007-12-23 21:05:57 +00:00
Michael Kerrisk 62218dc0fd Format SYNOPSIS consistently. 2007-12-23 08:20:39 +00:00
Michael Kerrisk bd9b2a9c46 ffix 2007-12-22 22:10:40 +00:00
Michael Kerrisk 94e9d9febd Replace "-" by "\-" where a real dash is required. 2007-12-22 16:40:46 +00:00
Michael Kerrisk bd19142309 enclose code smaples/structure defns/etc in ".in +4n / .in" 2007-12-19 06:16:04 +00:00
Michael Kerrisk a08ea57c20 Make the standard indent for code samples, shell session
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
Michael Kerrisk 0daa9e92d0 Fix redundant formatting macros 2007-09-20 16:26:31 +00:00
Michael Kerrisk cc4615cc78 Added/updated glibc feature test macro requirements 2007-07-08 12:11:40 +00:00
Michael Kerrisk 2f0af33ba6 ffix 2007-06-22 19:42:52 +00:00
Michael Kerrisk 988db66164 strip trailing white space 2007-06-21 22:55:04 +00:00
Michael Kerrisk 3a72373c40 Added section numbers to page xrefs 2007-05-21 22:14:09 +00:00
Michael Kerrisk 60a90ecdae Convert function formatting of the form "\fBname\fP()" to ".BR name ()". 2007-05-12 09:06:04 +00:00
Michael Kerrisk c13182efa3 Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk 68e1685c25 Updated CONFORMING TO section 2006-08-03 13:57:30 +00:00
Michael Kerrisk 63aa9df02f Automated unformatting of parentheses using unformat_parens.sh 2005-10-19 07:07:02 +00:00
Michael Kerrisk 6b2fc2945f Add NOTES text describing relationship of pw_dir and HOME and
pointing out that applications should preferentially
inspect HOME
2005-09-21 12:02:23 +00:00
Michael Kerrisk 34c97781c7 s/id/ID/ 2005-07-19 06:20:42 +00:00
Michael Kerrisk b14d4aa5b8 Classical BSD versions are now always named x.yBSD (formerly
there was a mix of x.yBSD and BSD x.y).
2005-07-18 15:05:56 +00:00
Michael Kerrisk f936cf268d Minor wording changes 2005-07-04 08:58:13 +00:00
Michael Kerrisk f2738b392c Replace mention of /etc/{passwd,group} by refernces to
"passwd/group database", and LDAP and NIS.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117

Miscellaneous wording improvements
Consistent DESCRIPTION and ERRORS wording across these pages.
2005-07-01 16:50:33 +00:00
Michael Kerrisk fea681dafb Import of man-pages 1.70 2004-11-03 13:51:07 +00:00