[src/trunk]: src/lib/libutil document login_getpwclass(3)

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/edf94cb1a46a
branches:  trunk
changeset: 787497:edf94cb1a46a
user:      christos <christos%NetBSD.org@localhost>
date:      Thu Jun 20 20:42:30 2013 +0000

description:
document login_getpwclass(3)

diffstat:

 lib/libutil/Makefile    |   3 ++-
 lib/libutil/login_cap.3 |  15 +++++++++++++--
 2 files changed, 15 insertions(+), 3 deletions(-)

diffs (67 lines):

diff -r 8a366318b279 -r edf94cb1a46a lib/libutil/Makefile
--- a/lib/libutil/Makefile      Thu Jun 20 19:49:47 2013 +0000
+++ b/lib/libutil/Makefile      Thu Jun 20 20:42:30 2013 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.74 2013/05/02 07:17:09 matt Exp $
+#      $NetBSD: Makefile,v 1.75 2013/06/20 20:42:30 christos Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/4/93
 
 USE_SHLIBDIR=  yes
@@ -51,6 +51,7 @@
 MLINKS+=login_cap.3 login_getcapsize.3
 MLINKS+=login_cap.3 login_getcapstr.3
 MLINKS+=login_cap.3 login_getcaptime.3
+MLINKS+=login_cap.3 login_getpwclass.3
 MLINKS+=login_cap.3 login_close.3
 MLINKS+=login_cap.3 setclasscontext.3
 MLINKS+=login_cap.3 setusercontext.3
diff -r 8a366318b279 -r edf94cb1a46a lib/libutil/login_cap.3
--- a/lib/libutil/login_cap.3   Thu Jun 20 19:49:47 2013 +0000
+++ b/lib/libutil/login_cap.3   Thu Jun 20 20:42:30 2013 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: login_cap.3,v 1.18 2010/05/05 22:05:31 wiz Exp $
+.\" $NetBSD: login_cap.3,v 1.19 2013/06/20 20:42:30 christos Exp $
 .\"
 .\" Copyright (c) 1996,1997 Berkeley Software Design, Inc. All rights reserved.
 .\"
@@ -32,7 +32,7 @@
 .\"
 .\" BSDI login_cap.3,v 1.4 1997/11/07 16:22:27 jch Exp
 .\"
-.Dd October 6, 2007
+.Dd June 20, 2013
 .Dt LOGIN_CAP 3
 .Os
 .Sh NAME
@@ -42,6 +42,7 @@
 .Nm login_getcapsize ,
 .Nm login_getcapstr ,
 .Nm login_getcaptime ,
+.Nm login_getpwclass ,
 .Nm login_close ,
 .Nm setclasscontext ,
 .Nm setusercontext
@@ -63,6 +64,8 @@
 .Fn login_getcapstr "login_cap_t *lc" "const char *cap" "char *def" "char *err"
 .Ft quad_t
 .Fn login_getcaptime "login_cap_t *lc" "const char *cap" "quad_t def" "quad_t err"
+.Ft login_cap_t *
+.Fn login_getpwclass "struct passwd *pwd"
 .Ft void
 .Fn login_close "login_cap_t *lc"
 .Ft int
@@ -96,6 +99,14 @@
 .Fn login_close
 function.
 .Pp
+The
+.Fn login_getpwclass
+function is equivalent to:
+login_getclass(
+.Fa pwd
+? pwd->pw_class :
+.Dv NULL ).
+.Pp
 Once
 .Ar lc
 has been returned by