xref: /openbsd-src/usr.sbin/tokenadm/tokenadm.8 (revision b2ea75c1b17e1a9a339660e7ed45cd24946b230e)
1.\" $OpenBSD: tokenadm.8,v 1.3 2001/08/01 21:18:13 millert Exp $
2.\"
3.\" Copyright (c) 1996 Berkeley Software Design, Inc. 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 Berkeley Software Design,
16.\"	Inc.
17.\" 4. The name of Berkeley Software Design, Inc.  may not be used to endorse
18.\"    or promote products derived from this software without specific prior
19.\"    written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN, INC. ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL BERKELEY SOFTWARE DESIGN, INC. BE LIABLE
25.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31.\" SUCH DAMAGE.
32.\"
33.\"	BSDI $From: tokenadm.8,v 1.3 1996/09/06 00:44:07 prb Exp $
34.\"
35.Dd August 23, 1996
36.Dt TOKENADM 8
37.Os
38.Sh NAME
39.Nm activadm ,
40.Nm cryptoadm ,
41.Nm snkadm
42.Nd manage the ActivCard, CRYPTOCard and SNK-004 token databases
43.Sh SYNOPSIS
44.Nm tokenadm
45.Op Fl 1BDERT
46.Op Fl d
47.Op Fl e
48.Op Fl m Ar [-]mode
49.Op Fl r
50.Op Ar user Op ...
51.Sh DESCRIPTION
52The
53.Nm tokenadm
54utility is display and edit user entries in the various token databases.
55It may also be invoked as one the following:
56.Nm activadm , cryptoadm ,
57or
58.Nm snkadm .
59.Pp
60The options are as follows:
61.Bl -tag -width Ds
62.It Fl 1
63Display users, one per line.
64.It Fl B
65Display users with no banner.
66.It Fl D
67Display disabled users.
68.It Fl E
69Display enabled users.
70.It Fl R
71Display users in reverse order.
72.It Fl T
73Display users in terse format (only the user names).
74Unless
75.Fl 1
76is also specified, four users will be displayed per line.
77.It Fl d
78Disable users without removing them from the database.
79This prevents the users from authenticating, but does not lose their
80shared secret.
81The
82.Fl m
83flag may also be used with the
84.Fl d
85flag.
86.It Fl e
87Enable users.
88This should be used to re-enable users who were disabled by the
89.Fl m
90flag may also be used with the
91.Fl e
92flag
93option.
94.It Fl m
95Add
96[or remove]
97the specified mode of authentication for the user.
98Modes available are decimal (dec), hexadecimal (hex), phonebook (phone),
99and reduced-input (rim).
100Not all modes are available for all types of cards.
101The
102.Fl m
103flag may be used alone or in conjunction with either the
104.Fl de
105flags.
106When ever reduced-input mode is set the reduced-input state is reset.
107This should be done if a paper copy of challenge/responses had been
108produced and then misplaced.
109.It Fl r
110Remove users from the database.
111.El
112.sp
113Use of any of the
114.Fl 1BDERT
115flags precludes the use of any of the
116.Fl demr
117flags.
118The
119.Fl demr
120flags all require at least one
121.Ar user
122argument.
123.Sh SEE ALSO
124.Xr x99token 1 ,
125.Xr login.conf 5 ,
126.Xr login_token 8 ,
127.Xr tokeninit 8
128