xref: /openbsd-src/usr.sbin/user/userinfo.8 (revision f2da64fbbbf1b03f09f390ab01267c93dfd77c4c)
1.\" $OpenBSD: userinfo.8,v 1.14 2013/07/16 11:13:34 schwarze Exp $
2.\" $NetBSD: userinfo.8,v 1.8 2003/02/14 16:11:37 grant Exp $
3.\"
4.\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Alistair G. Crooks.
17.\" 4. The name of the author may not be used to endorse or promote
18.\"    products derived from this software without specific prior written
19.\"    permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
22.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
25.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
27.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
29.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
30.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
31.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\"
34.Dd $Mdocdate: July 16 2013 $
35.Dt USERINFO 8
36.Os
37.Sh NAME
38.Nm userinfo
39.Nd display user information
40.Sh SYNOPSIS
41.Nm userinfo
42.Op Fl e
43.Ar user
44.Sh DESCRIPTION
45The
46.Nm
47utility displays information about the specified
48.Ar user .
49The fields shown are defined in
50.Xr master.passwd 5 .
51The encrypted password is only displayed if the calling user is the
52superuser.
53.Pp
54The options are as follows:
55.Bl -tag -width Ds
56.It Fl e
57Do not display anything (quiet mode).
58This form of the command is useful for
59scripts which need to check whether a particular user
60name or UID is already in use on the system.
61.El
62.Pp
63The
64.Ar user
65argument may be either a user name or a user ID (UID).
66.Sh EXIT STATUS
67The
68.Nm
69utility exits 0 if
70.Ar user
71exists, and non-zero if it does not.
72.Sh SEE ALSO
73.Xr id 1 ,
74.Xr passwd 5 ,
75.Xr groupinfo 8 ,
76.Xr user 8
77.Sh HISTORY
78The
79.Nm
80utility first appeared in
81.Ox 2.7 .
82.Sh AUTHORS
83The
84.Nm
85utility was written by
86.An Alistair G. Crooks Aq Mt agc@NetBSD.org .
87