From 69f83572509696a67f8fb3a52e7335825a19ea67 Mon Sep 17 00:00:00 2001
From: Jason McIntyre <jmc@cvs.openbsd.org>
Date: Sat, 20 Dec 2008 09:40:48 +0000
Subject: - various improvements from Ingo Schwarze; - remove non-functional -v
 option from docs/usage()

feedback/ok millert otto
---
 usr.sbin/user/groupinfo.8 | 46 ++++++++++++++++++++++++++++------------------
 usr.sbin/user/user.c      |  6 +++---
 usr.sbin/user/userinfo.8  | 37 +++++++++++++++++++------------------
 3 files changed, 50 insertions(+), 39 deletions(-)

(limited to 'usr.sbin/user')

diff --git a/usr.sbin/user/groupinfo.8 b/usr.sbin/user/groupinfo.8
index 6568d3d7072..cd66729243b 100644
--- a/usr.sbin/user/groupinfo.8
+++ b/usr.sbin/user/groupinfo.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: groupinfo.8,v 1.11 2007/05/31 19:20:30 jmc Exp $
+.\" $OpenBSD: groupinfo.8,v 1.12 2008/12/20 09:40:47 jmc Exp $
 .\" $NetBSD: groupinfo.8,v 1.3 2000/10/03 19:32:23 bjh21 Exp $
 .\"
 .\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
@@ -31,48 +31,46 @@
 .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: December 20 2008 $
 .Dt GROUPINFO 8
 .Os
 .Sh NAME
 .Nm groupinfo
-.Nd displays group information
+.Nd display group information
 .Sh SYNOPSIS
 .Nm groupinfo
-.Op Fl ev
+.Op Fl e
 .Ar group
 .Sh DESCRIPTION
 The
 .Nm
-utility retrieves the group information from the system.
+utility displays the name, group ID (GID),
+and members of the specified
+.Ar group .
 .Pp
-The following command line options are recognised:
+The options are as follows:
 .Bl -tag -width Ds
 .It Fl e
-return 0 if the group exists, and non-zero if the
-group does not exist, on the system.
-No information is displayed.
+Do not display anything (quiet mode).
 This form of the command is useful for
 scripts which need to check whether a particular group
 name or GID is already in use on the system.
-.It Fl v
-perform any actions in a verbose manner.
 .El
 .Pp
 The
 .Ar group
-argument may either be a group's name, or a GID.
+argument may be either a group name or a GID.
 .Pp
 The
 .Nm
-utility exits 0 if the group name or GID exists, and non-zero if it does not.
-.Sh FILES
-.Bl -tag -width /etc/usermgmt.conf -compact
-.It Pa /etc/usermgmt.conf
-.El
+utility exits 0 if
+.Ar group
+exists, and non-zero if it does not.
 .Sh SEE ALSO
+.Xr group 5 ,
 .Xr passwd 5 ,
-.Xr usermgmt.conf 5
+.Xr group 8 ,
+.Xr userinfo 8
 .Sh HISTORY
 The
 .Nm
@@ -83,3 +81,15 @@ The
 .Nm
 utility was written by
 .An Alistair G. Crooks Aq agc@NetBSD.org .
+.Sh CAVEATS
+If the specified
+.Ar group
+is the primary group of a user, but that user is not listed as a
+member of the
+.Ar group
+in the
+.Xr group 5
+file, the
+.Nm
+utility fails to list that user as a member of the
+.Ar group .
diff --git a/usr.sbin/user/user.c b/usr.sbin/user/user.c
index 712e6c2c28a..c0748ef7bba 100644
--- a/usr.sbin/user/user.c
+++ b/usr.sbin/user/user.c
@@ -1,4 +1,4 @@
-/* $OpenBSD: user.c,v 1.74 2008/12/16 05:25:55 guenther Exp $ */
+/* $OpenBSD: user.c,v 1.75 2008/12/20 09:40:47 jmc Exp $ */
 /* $NetBSD: user.c,v 1.69 2003/04/14 17:40:07 agc Exp $ */
 
 /*
@@ -1618,7 +1618,7 @@ usermgmt_usage(const char *prog)
 		(void) fprintf(stderr, "usage: %s [-prv] user\n", prog);
 #ifdef EXTENSIONS
 	} else if (strcmp(prog, "userinfo") == 0) {
-		(void) fprintf(stderr, "usage: %s [-ev] user\n", prog);
+		(void) fprintf(stderr, "usage: %s [-e] user\n", prog);
 #endif
 	} else if (strcmp(prog, "groupadd") == 0) {
 		(void) fprintf(stderr, "usage: %s [-ov] [-g gid] group\n",
@@ -1637,7 +1637,7 @@ usermgmt_usage(const char *prog)
 		    prog);
 #ifdef EXTENSIONS
 	} else if (strcmp(prog, "groupinfo") == 0) {
-		(void) fprintf(stderr, "usage: %s [-ev] group\n", prog);
+		(void) fprintf(stderr, "usage: %s [-e] group\n", prog);
 #endif
 	} else {
 		(void) fprintf(stderr, "This program must be called as {user,group}{add,del,mod,info},\n%s is not an understood name.\n", prog);
diff --git a/usr.sbin/user/userinfo.8 b/usr.sbin/user/userinfo.8
index 19f966a0a2f..172af7b9837 100644
--- a/usr.sbin/user/userinfo.8
+++ b/usr.sbin/user/userinfo.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: userinfo.8,v 1.11 2007/05/31 19:20:30 jmc Exp $
+.\" $OpenBSD: userinfo.8,v 1.12 2008/12/20 09:40:47 jmc Exp $
 .\" $NetBSD: userinfo.8,v 1.8 2003/02/14 16:11:37 grant Exp $
 .\"
 .\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
@@ -31,48 +31,49 @@
 .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: December 20 2008 $
 .Dt USERINFO 8
 .Os
 .Sh NAME
 .Nm userinfo
-.Nd displays user information
+.Nd display user information
 .Sh SYNOPSIS
 .Nm userinfo
-.Op Fl ev
+.Op Fl e
 .Ar user
 .Sh DESCRIPTION
 The
 .Nm
-utility retrieves the user information from the system.
+utility displays information about the specified
+.Ar user .
+The fields shown are defined in
+.Xr master.passwd 5 .
+The encrypted password is only displayed if the calling user is the
+superuser.
 .Pp
-The following command line options are recognised:
+The options are as follows:
 .Bl -tag -width Ds
 .It Fl e
-return 0 if the user exists, and non-zero if the
-user does not exist, on the system.
-No information is displayed.
+Do not display anything (quiet mode).
 This form of the command is useful for
 scripts which need to check whether a particular user
 name or UID is already in use on the system.
-.It Fl v
-perform any actions in a verbose manner.
 .El
 .Pp
 The
 .Ar user
-argument may either be a user's name, or a UID.
+argument may be either a user name or a user ID (UID).
 .Pp
 The
 .Nm
-utility exits 0 if the user name or UID exists, and non-zero if it does not.
-.Sh FILES
-.Bl -tag -width /etc/usermgmt.conf -compact
-.It Pa /etc/usermgmt.conf
-.El
+utility exits 0 if
+.Ar user
+exists, and non-zero if it does not.
 .Sh SEE ALSO
+.Xr id 1 ,
 .Xr passwd 5 ,
-.Xr usermgmt.conf 5
+.Xr groupinfo 8 ,
+.Xr user 8
 .Sh HISTORY
 The
 .Nm
-- 
cgit v1.2.3