[src/trunk]: src/share/man/man5 Updated to cater for login classes.

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

details:   https://anonhg.NetBSD.org/src/rev/56b1cda98e67
branches:  trunk
changeset: 480490:56b1cda98e67
user:      mjl <mjl%NetBSD.org@localhost>
date:      Fri Jan 14 01:04:24 2000 +0000

description:
Updated to cater for login classes.

diffstat:

 share/man/man5/passwd.5 |  29 ++++++++++++++++++++---------
 1 files changed, 20 insertions(+), 9 deletions(-)

diffs (90 lines):

diff -r 67ac4fb2fb1f -r 56b1cda98e67 share/man/man5/passwd.5
--- a/share/man/man5/passwd.5   Fri Jan 14 01:00:26 2000 +0000
+++ b/share/man/man5/passwd.5   Fri Jan 14 01:04:24 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: passwd.5,v 1.14 1999/12/16 22:02:00 abs Exp $
+.\"    $NetBSD: passwd.5,v 1.15 2000/01/14 01:04:24 mjl Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -34,7 +34,7 @@
 .\"
 .\"     @(#)passwd.5   8.1 (Berkeley) 6/5/93
 .\"
-.Dd January 16, 1999
+.Dd January 14, 2000
 .Dt PASSWD 5
 .Os
 .Sh NAME
@@ -76,7 +76,7 @@
 .It gid
 User's login group id.
 .It class
-User's general classification (unused).
+User's login class.
 .It change
 Password change time.
 .It expire
@@ -134,10 +134,13 @@
 .Pp
 The
 .Ar class
-field is currently unused.  In the near future it will be a key to
-a
+field is a key for a user's login class.
+Login classes are defined in
+.Xr login.conf 5 ,
+which is a
 .Xr termcap 5
-style database of user attributes.
+style database of user attributes, accounting, resource and
+environment settings.
 .Pp
 The
 .Ar change
@@ -164,7 +167,8 @@
 or
 .Ar expire
 fields are set, the system will remind the user of the impending
-change or expiry if they login within the 14 days before the event.
+change or expiry if they login within a configurable period 
+(defaulting to 14 days) before the event.
 .Pp
 The
 .Ar gecos
@@ -301,6 +305,8 @@
 .Xr login 1 ,
 .Xr passwd 1 ,
 .Xr getpwent 3 ,
+.Xr login_getclass 3 ,
+.Xr login.conf 5 ,
 .Xr netgroup 5 ,
 .Xr adduser 8 ,
 .Xr pwd_mkdb 8 ,
@@ -313,7 +319,7 @@
 User information should (and eventually will) be stored elsewhere.
 .Pp
 Placing
-Sq compat
+.Sq compat
 exclusions in the file after any inclusions will have
 unexpected results.
 .Sh COMPATIBILITY
@@ -327,7 +333,7 @@
 and
 .Dq expire
 are added, but are turned off by default.
-Class is currently not implemented, but change and expire are; to set them,
+To set them,
 use the current day in seconds from the epoch + whatever number of seconds
 of offset you want.
 .Bd -literal -offset indent
@@ -347,3 +353,8 @@
 .Pp
 The Hesiod support first appeared in
 .Nx 1.4 .
+.Pp
+The
+.Xr login.conf 5
+capability first appeared in
+.Nx 1.5 .