Module Name: src Committed By: wiz Date: Wed May 5 22:05:32 UTC 2010
Modified Files: src/lib/libutil: login_cap.3 pidfile.3 pw_init.3 pw_lock.3 Log Message: Mark up NULL with Dv. To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/lib/libutil/login_cap.3 cvs rdiff -u -r1.11 -r1.12 src/lib/libutil/pidfile.3 cvs rdiff -u -r1.14 -r1.15 src/lib/libutil/pw_init.3 cvs rdiff -u -r1.13 -r1.14 src/lib/libutil/pw_lock.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/lib/libutil/login_cap.3 diff -u src/lib/libutil/login_cap.3:1.17 src/lib/libutil/login_cap.3:1.18 --- src/lib/libutil/login_cap.3:1.17 Wed May 13 23:02:52 2009 +++ src/lib/libutil/login_cap.3 Wed May 5 22:05:31 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: login_cap.3,v 1.17 2009/05/13 23:02:52 wiz Exp $ +.\" $NetBSD: login_cap.3,v 1.18 2010/05/05 22:05:31 wiz Exp $ .\" .\" Copyright (c) 1996,1997 Berkeley Software Design, Inc. All rights reserved. .\" @@ -78,7 +78,9 @@ .Li default if .Ar class -is NULL or the empty string) +is +.Dv NULL +or the empty string) from .Pa /etc/login.conf (see @@ -86,7 +88,8 @@ If the entry is found, a .Li login_cap_t pointer is returned. -NULL is returned if the user class is not found. +.Dv NULL +is returned if the user class is not found. When the .Li login_cap_t structure is no longer needed, it should be freed by the @@ -159,16 +162,21 @@ .Ar flags . The .Ar lc -argument, if not NULL, contains the class information that should +argument, if not +.Dv NULL , +contains the class information that should be used. The .Ar pwd -argument, if not NULL, provides information about the user. +argument, if not +.Dv NULL , +provides information about the user. Both .Ar lc and .Ar pwd -cannot be NULL. +cannot be +.Dv NULL . The .Ar uid argument is used in place of the user id contained in the @@ -256,8 +264,9 @@ .Fa def or .Fa err -(whichever is relevant) are non-NULL the returned value is simply what -was passed in to +(whichever is relevant) are +.Pf non- Dv NULL +the returned value is simply what was passed in to .Fn login_getcapstr . Therefore it is not possible to blindly .Fn free Index: src/lib/libutil/pidfile.3 diff -u src/lib/libutil/pidfile.3:1.11 src/lib/libutil/pidfile.3:1.12 --- src/lib/libutil/pidfile.3:1.11 Tue May 4 06:41:27 2010 +++ src/lib/libutil/pidfile.3 Wed May 5 22:05:31 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: pidfile.3,v 1.11 2010/05/04 06:41:27 jruoho Exp $ +.\" $NetBSD: pidfile.3,v 1.12 2010/05/05 22:05:31 wiz Exp $ .\" .\" Copyright (c) 1999 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -48,7 +48,8 @@ .Pa /var/run/basename.pid . If the .Ar basename -argument is NULL, +argument is +.Dv NULL , .Fn pidfile will determine the program name and use that instead. .Pp Index: src/lib/libutil/pw_init.3 diff -u src/lib/libutil/pw_init.3:1.14 src/lib/libutil/pw_init.3:1.15 --- src/lib/libutil/pw_init.3:1.14 Wed Aug 4 15:07:37 2004 +++ src/lib/libutil/pw_init.3 Wed May 5 22:05:31 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: pw_init.3,v 1.14 2004/08/04 15:07:37 wiz Exp $ +.\" $NetBSD: pw_init.3,v 1.15 2010/05/05 22:05:31 wiz Exp $ .\" .\" Copyright (c) 1995 .\" The Regents of the University of California. All rights reserved. @@ -86,7 +86,8 @@ .Pa /etc/ptmp if .Fa filename -is NULL). +is +.Dv NULL ) . If .Fa notsetuid is nonzero, @@ -112,7 +113,9 @@ .Fa pw . If .Fa old_pw -is not NULL, it checks to make sure the old entry is the same as +is not +.Dv NULL , +it checks to make sure the old entry is the same as the one described in .Fa old_pw or the process is aborted. Index: src/lib/libutil/pw_lock.3 diff -u src/lib/libutil/pw_lock.3:1.13 src/lib/libutil/pw_lock.3:1.14 --- src/lib/libutil/pw_lock.3:1.13 Sat Feb 17 09:37:55 2007 +++ src/lib/libutil/pw_lock.3 Wed May 5 22:05:31 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: pw_lock.3,v 1.13 2007/02/17 09:37:55 wiz Exp $ +.\" $NetBSD: pw_lock.3,v 1.14 2010/05/05 22:05:31 wiz Exp $ .\" .\" Copyright (c) 1995 .\" The Regents of the University of California. All rights reserved. @@ -94,7 +94,9 @@ to clean up the lock file. If the .Ar username -argument is not NULL, only database entries pertaining to the specified user +argument is not +.Dv NULL , +only database entries pertaining to the specified user will be modified. If the .Ar secureonly