Document where we diverge from other implementations (due to different

fields in passwd(5)).  OK otto@ a while ago.

4 files changed, 56 insertions, 4 deletions

diff --git a/usr.sbin/user/user.8 b/usr.sbin/user/user.8
index 30747804319..87c4c3767e4 100644
--- a/usr.sbin/user/user.8
+++ b/usr.sbin/user/user.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: user.8,v 1.11 2003/06/15 06:40:15 jmc Exp $
+.\" $OpenBSD: user.8,v 1.12 2004/06/14 17:11:46 millert Exp $
 .\" $NetBSD: user.8,v 1.9 2001/06/05 11:31:21 wiz Exp $
 .\"
 .\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
@@ -132,6 +132,19 @@ and those backend commands
 .Xr userdel 8 ,
 .Xr userinfo 8 ,
 .Xr usermod 8
+.Sh STANDARDS
+Other implementations of the
+.Nm user
+utilities use the
+.Ar inactive-time
+parameter to refer to the maximum number of days allowed between logins (this
+us used to lock "stale" accounts that have not been used for a period of time).
+However, on
+.Ox
+systems this parameter refers instead to the password change time.
+This is due to differences in the
+.Xr passwd 5
+database compared to other operating systems.
 .Sh HISTORY
 The
 .Nm
diff --git a/usr.sbin/user/useradd.8 b/usr.sbin/user/useradd.8
index 01b28360d33..c3a8658569b 100644
--- a/usr.sbin/user/useradd.8
+++ b/usr.sbin/user/useradd.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: useradd.8,v 1.20 2004/06/04 18:04:21 otto Exp $
+.\" $OpenBSD: useradd.8,v 1.21 2004/06/14 17:11:46 millert Exp $
 .\" $NetBSD: useradd.8,v 1.26 2003/02/25 10:36:21 wiz Exp $
 .\"
 .\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
@@ -270,6 +270,19 @@ utility exits 0 on success, and \*(Gt0 if an error occurs.
 .Xr user 8 ,
 .Xr userdel 8 ,
 .Xr usermod 8
+.Sh STANDARDS
+Other implementations of the
+.Nm useradd
+utility use the
+.Ar inactive-time
+parameter to refer to the maximum number of days allowed between logins (this
+us used to lock "stale" accounts that have not been used for a period of time).
+However, on
+.Ox
+systems this parameter refers instead to the password change time.
+This is due to differences in the
+.Xr passwd 5
+database compared to other operating systems.
 .Sh HISTORY
 The
 .Nm
diff --git a/usr.sbin/user/usermgmt.conf.5 b/usr.sbin/user/usermgmt.conf.5
index 2f81035990b..49e5dac4e41 100644
--- a/usr.sbin/user/usermgmt.conf.5
+++ b/usr.sbin/user/usermgmt.conf.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: usermgmt.conf.5,v 1.4 2004/06/06 21:16:48 jmc Exp $
+.\" $OpenBSD: usermgmt.conf.5,v 1.5 2004/06/14 17:11:46 millert Exp $
 .\" $NetBSD: usermgmt.conf.5,v 1.3 2002/10/02 13:49:11 grant Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
@@ -124,6 +124,19 @@ with which to populate the new user's home directory.
 .It Pa /etc/skel/*
 .It Pa /etc/login.conf
 .El
+.Sh STANDARDS
+Other implementations of the
+.Xr user 8
+utilities use the
+.Ar inactive-time
+parameter to refer to the maximum number of days allowed between logins (this
+us used to lock "stale" accounts that have not been used for a period of time).
+However, on
+.Ox
+systems this parameter refers instead to the password change time.
+This is due to differences in the
+.Xr passwd 5
+database compared to other operating systems.
 .Sh SEE ALSO
 .Xr login.conf 5 ,
 .Xr passwd 5 ,
diff --git a/usr.sbin/user/usermod.8 b/usr.sbin/user/usermod.8
index 364d3f9cdc8..d4d46c640f1 100644
--- a/usr.sbin/user/usermod.8
+++ b/usr.sbin/user/usermod.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: usermod.8,v 1.17 2004/06/04 18:04:21 otto Exp $
+.\" $OpenBSD: usermod.8,v 1.18 2004/06/14 17:11:46 millert Exp $
 .\" $NetBSD: usermod.8,v 1.17 2003/02/14 16:11:37 grant Exp $
 .\"
 .\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
@@ -222,6 +222,19 @@ utility exits 0 on success, and \*(Gt0 if an error occurs.
 .Xr passwd 5 ,
 .Xr usermgmt.conf 5 ,
 .Xr pwd_mkdb 8
+.Sh STANDARDS
+Other implementations of the
+.Nm usermod
+utility use the
+.Ar inactive-time
+parameter to refer to the maximum number of days allowed between logins (this
+us used to lock "stale" accounts that have not been used for a period of time).
+However, on
+.Ox
+systems this parameter refers instead to the password change time.
+This is due to differences in the
+.Xr passwd 5
+database compared to other operating systems.
 .Sh HISTORY
 The
 .Nm