xref: /openbsd-src/usr.sbin/user/userinfo.8 (revision 7a3d14ecb20e7bd4167711f8dc52b019326d4275)
1*7a3d14ecSjsg.\" $OpenBSD: userinfo.8,v 1.15 2016/11/29 03:59:31 jsg Exp $
26806f038Smillert.\" $NetBSD: userinfo.8,v 1.8 2003/02/14 16:11:37 grant Exp $
3e02380dbSjakob.\"
4e02380dbSjakob.\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
5e02380dbSjakob.\"
6e02380dbSjakob.\" Redistribution and use in source and binary forms, with or without
7e02380dbSjakob.\" modification, are permitted provided that the following conditions
8e02380dbSjakob.\" are met:
9e02380dbSjakob.\" 1. Redistributions of source code must retain the above copyright
10e02380dbSjakob.\"    notice, this list of conditions and the following disclaimer.
11e02380dbSjakob.\" 2. Redistributions in binary form must reproduce the above copyright
12e02380dbSjakob.\"    notice, this list of conditions and the following disclaimer in the
13e02380dbSjakob.\"    documentation and/or other materials provided with the distribution.
14*7a3d14ecSjsg.\" 3. The name of the author may not be used to endorse or promote
15e02380dbSjakob.\"    products derived from this software without specific prior written
16e02380dbSjakob.\"    permission.
17e02380dbSjakob.\"
18e02380dbSjakob.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
19e02380dbSjakob.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20e02380dbSjakob.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21e02380dbSjakob.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
22e02380dbSjakob.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23e02380dbSjakob.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
24e02380dbSjakob.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25e02380dbSjakob.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26e02380dbSjakob.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
27e02380dbSjakob.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28e02380dbSjakob.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29e02380dbSjakob.\"
30e02380dbSjakob.\"
31*7a3d14ecSjsg.Dd $Mdocdate: November 29 2016 $
32e02380dbSjakob.Dt USERINFO 8
338aa50653Sjakob.Os
34e02380dbSjakob.Sh NAME
35e02380dbSjakob.Nm userinfo
366a289adfSjmc.Nd display user information
37e02380dbSjakob.Sh SYNOPSIS
3824a3a9d1Smpech.Nm userinfo
396a289adfSjmc.Op Fl e
40e02380dbSjakob.Ar user
41e02380dbSjakob.Sh DESCRIPTION
42e02380dbSjakobThe
43e02380dbSjakob.Nm
446a289adfSjmcutility displays information about the specified
456a289adfSjmc.Ar user .
466a289adfSjmcThe fields shown are defined in
476a289adfSjmc.Xr master.passwd 5 .
486a289adfSjmcThe encrypted password is only displayed if the calling user is the
496a289adfSjmcsuperuser.
50e02380dbSjakob.Pp
516a289adfSjmcThe options are as follows:
52e02380dbSjakob.Bl -tag -width Ds
53e02380dbSjakob.It Fl e
546a289adfSjmcDo not display anything (quiet mode).
554fb31a24SjmcThis form of the command is useful for
56e02380dbSjakobscripts which need to check whether a particular user
574fb31a24Sjmcname or UID is already in use on the system.
58e02380dbSjakob.El
59e02380dbSjakob.Pp
603c76c7c0SmillertThe
613c76c7c0Smillert.Ar user
626a289adfSjmcargument may be either a user name or a user ID (UID).
63741b6f30Sjmc.Sh EXIT STATUS
64e02380dbSjakobThe
65e02380dbSjakob.Nm
666a289adfSjmcutility exits 0 if
676a289adfSjmc.Ar user
686a289adfSjmcexists, and non-zero if it does not.
69e02380dbSjakob.Sh SEE ALSO
706a289adfSjmc.Xr id 1 ,
716806f038Smillert.Xr passwd 5 ,
726a289adfSjmc.Xr groupinfo 8 ,
736a289adfSjmc.Xr user 8
74e02380dbSjakob.Sh HISTORY
75e02380dbSjakobThe
76e02380dbSjakob.Nm
77e02380dbSjakobutility first appeared in
78f88889abSjakob.Ox 2.7 .
79b5667098Smpech.Sh AUTHORS
80e02380dbSjakobThe
81e02380dbSjakob.Nm
826806f038Smillertutility was written by
8344e68d47Sschwarze.An Alistair G. Crooks Aq Mt agc@NetBSD.org .
84