xref: /netbsd-src/usr.sbin/user/user.8 (revision 5b84b3983f71fd20a534cfa5d1556623a8aaa717)
1.\" $NetBSD: user.8,v 1.20 2005/09/11 23:49:20 wiz Exp $ */
2.\"
3.\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\"    must display the following acknowledgement:
15.\"	This product includes software developed by Alistair G. Crooks.
16.\" 4. The name of the author may not be used to endorse or promote
17.\"    products derived from this software without specific prior written
18.\"    permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
21.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
24.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
26.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.\"
33.Dd September 9, 2005
34.Dt USER 8
35.Os
36.Sh NAME
37.Nm user
38.Nd manage user login information on the system
39.Sh SYNOPSIS
40.Nm
41.Cm add
42.Fl D
43.Op options
44.Nm
45.Cm add
46.Op options
47.Ar user
48.Nm
49.Cm del
50.Fl D
51.Op options
52.Nm
53.Cm del
54.Op options
55.Ar user
56.Nm
57.Cm info
58.Op options
59.Ar user
60.Nm
61.Cm mod
62.Op options
63.Ar user
64.Sh DESCRIPTION
65The
66.Nm
67utility acts as a frontend to the
68.Xr useradd 8 ,
69.Xr usermod 8 ,
70.Xr userinfo 8 ,
71and
72.Xr userdel 8
73commands.
74.Pp
75For a full explanation of the options, please see the relevant manual page.
76.Sh EXIT STATUS
77.Ex -std user
78.Sh FILES
79.Bl -tag -width /usr/share/examples/usermgmt -compact
80.It Pa /etc/skel/.[A-z]*
81Skeleton files for new user
82.It Pa /etc/usermgmt.conf
83Configuration file for
84.Nm ,
85.Xr group 8
86and the backend commands mentioned above.
87.\" .It Pa /usr/share/examples/usermgmt
88.\" A directory containing examples for
89.\" .Nm
90.\" and
91.\" .Xr group 8 .
92.El
93.Sh SEE ALSO
94.Xr chpass 1 ,
95.Xr group 5 ,
96.Xr passwd 5 ,
97.Xr usermgmt.conf 5 ,
98.Xr useradd 8 ,
99.Xr userdel 8 ,
100.Xr userinfo 8 ,
101.Xr usermod 8
102.Sh HISTORY
103The
104.Nm
105utility first appeared in
106.Nx 1.5 .
107It is based on the
108.Ar addnerd
109package by the same author.
110.Sh AUTHORS
111The
112.Nm
113utility was written by
114.An Alistair G. Crooks
115.Aq agc@NetBSD.org .
116