freebsd-dev/usr.bin/keyinfo/keyinfo.1

.\"	from: @(#)keyinfo.1	1.1 (Bellcore) 7/20/93
.\"	$Id: keyinfo.1,v 1.5 1997/07/16 06:52:13 charnier Exp $
.\"
.Dd April 26, 1996
.Dt KEYINFO 1
.Os
.Sh NAME
.Nm keyinfo
.Nd display current S/Key sequence number and seed
.Sh SYNOPSIS
.Nm
.Op Ar username
.Sh DESCRIPTION
.Nm Keyinfo
takes an optional user name and displays the user\'s current sequence
number and seed found in the S/Key database
.Pa /etc/skeykeys .
.Pp
The command can be useful when generating a list of passwords for use
on a field trip, by combining with the command
.Nm key
in the form:
.sp
    > key \-n  <number of passwords> `keyinfo`|lpr
.Sh EXAMPLE
Usage example:
.sp 0
    > keyinfo
.sp 0
    0098 ws91340
.Sh ARGUMENTS
.Bl -tag -width indent
.It Ar username
The S/key user to display the information for.  The default is 
to display S/Key information on the user who invokes the command.
.El
.Sh DIAGNOSTICS
.Nm Keyinfo
exits with status 0 if a key for the requested user has been found,
else with status 1.
.Sh SEE ALSO
.Xr key 1 ,
.Xr keyinit 1
.Sh AUTHORS
Original command by
.An Phil Karn ,
.An Neil M. Haller ,
.An John S. Walden .
Rewritten in Perl by
.ie t J\(:org \%Wunsch
.el Joerg Wunsch
so it can be made setuid, and the S/Key keys file can be read-protected
from the users.
Implement keyinfo(1) as a setuid Perl script, so /etc/skeykeys can be made mode 0600. Pointed out by: kieber@sax.de (Ulf Kieber) Reviewed by: pst 1996-04-26 21:35:11 +00:00			`.\" from: @(#)keyinfo.1 1.1 (Bellcore) 7/20/93`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 07:48:45 +00:00			`.\" $Id: keyinfo.1,v 1.5 1997/07/16 06:52:13 charnier Exp $`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`.\"`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Dd April 26, 1996`
			`.Dt KEYINFO 1`
			`.Os`
			`.Sh NAME`
			`.Nm keyinfo`
			`.Nd display current S/Key sequence number and seed`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Ar username`
			`.Sh DESCRIPTION`
			`.Nm Keyinfo`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`takes an optional user name and displays the user\'s current sequence`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`number and seed found in the S/Key database`
			`.Pa /etc/skeykeys .`
			`.Pp`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`The command can be useful when generating a list of passwords for use`
			`on a field trip, by combining with the command`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Nm key`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`in the form:`
			`.sp`
Implement keyinfo(1) as a setuid Perl script, so /etc/skeykeys can be made mode 0600. Pointed out by: kieber@sax.de (Ulf Kieber) Reviewed by: pst 1996-04-26 21:35:11 +00:00			> key \-n <number of passwords> `keyinfo`\|lpr
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Sh EXAMPLE`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`Usage example:`
			`.sp 0`
Implement keyinfo(1) as a setuid Perl script, so /etc/skeykeys can be made mode 0600. Pointed out by: kieber@sax.de (Ulf Kieber) Reviewed by: pst 1996-04-26 21:35:11 +00:00			`> keyinfo`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`.sp 0`
			`0098 ws91340`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Sh ARGUMENTS`
			`.Bl -tag -width indent`
			`.It Ar username`
1) Added s/key support . 2 Added optional excessive login logging. 3) Added login acces control on a per host/tty base. 4) See skey(1) for skey descriptions and src/usr.bin/login/README for the logging and access control features. -Guido 1994-05-19 18:13:11 +00:00			`The S/key user to display the information for. The default is`
			`to display S/Key information on the user who invokes the command.`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.El`
			`.Sh DIAGNOSTICS`
			`.Nm Keyinfo`
Implement keyinfo(1) as a setuid Perl script, so /etc/skeykeys can be made mode 0600. Pointed out by: kieber@sax.de (Ulf Kieber) Reviewed by: pst 1996-04-26 21:35:11 +00:00			`exits with status 0 if a key for the requested user has been found,`
			`else with status 1.`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Sh SEE ALSO`
			`.Xr key 1 ,`
			`.Xr keyinit 1`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 07:48:45 +00:00			`.Sh AUTHORS`
			`Original command by`
			`.An Phil Karn ,`
			`.An Neil M. Haller ,`
			`.An John S. Walden .`
Implement keyinfo(1) as a setuid Perl script, so /etc/skeykeys can be made mode 0600. Pointed out by: kieber@sax.de (Ulf Kieber) Reviewed by: pst 1996-04-26 21:35:11 +00:00			`Rewritten in Perl by`
			`.ie t J\(:org \%Wunsch`
			`.el Joerg Wunsch`
			`so it can be made setuid, and the S/Key keys file can be read-protected`
			`from the users.`