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

.\"	from: @(#)keyinfo.1	1.1 (Bellcore) 7/20/93
.\" $FreeBSD$
.\"
.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
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
.Xr key 1
in the form:
.Bd -literal -offset indent
key -n  <number of passwords> `keyinfo` | lpr
.Ed
.Pp
The optional
.Ar username
argument specifies the S/Key user for whom to display the information.
The default is to display S/Key information
on the user who invokes the command.
Only the superuser can ask for another user's key information.
.Sh EXAMPLES
Usage example:
.Bd -literal -offset indent
$ keyinfo
.Ed
.Pp
This would produce the following output:
.Bd -literal -offset indent
98 ws91340
.Ed
.Sh DIAGNOSTICS
The
.Nm
utility
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
.An -nosplit
Original command by
.An Phil Karn ,
.An Neil M. Haller
and
.An John S. Walden .
Rewritten in Perl by
.An J\(:org Wunsch
so that it could be made setuid, with the S/Key keys file read-protected
from the users.
Rewritten in C by
.An Warner Losh .
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`
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`.\" $FreeBSD$`
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`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`.Nm`
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`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`.Xr key 1`
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:`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`.Bd -literal -offset indent`
			key -n <number of passwords> `keyinfo` \| lpr
			`.Ed`
			`.Pp`
			`The optional`
			`.Ar username`
			`argument specifies the S/Key user for whom to display the information.`
			`The default is to display S/Key information`
			`on the user who invokes the command.`
Eliminate the only setuid perl script in the tree. Original 'C' progam submitted by Juriy Goloveshkin. A different 'C' program also submitted by dima. I merged and rewrote them to include error handling, use getlogin for user name and only the BSD boilerplate license remained from the original code. We also only allow root to get other user's keys. Review, bikeshed and bdelint(1): myself, kris, dima, markm 2000-08-10 22:53:49 +00:00			`Only the superuser can ask for another user's key information.`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`.Sh EXAMPLES`
			`Usage example:`
			`.Bd -literal -offset indent`
			`$ keyinfo`
			`.Ed`
			`.Pp`
			`This would produce the following output:`
			`.Bd -literal -offset indent`
			`98 ws91340`
			`.Ed`
Rewrote man page in mdoc format. 1997-07-16 06:52:13 +00:00			`.Sh DIAGNOSTICS`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`The`
			`.Nm`
			`utility`
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`
mdoc(7) police: do not split author names in the AUTHORS section. 2000-11-22 09:35:58 +00:00			`.An -nosplit`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 07:48:45 +00:00			`Original command by`
			`.An Phil Karn ,`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`.An Neil M. Haller`
			`and`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 07:48:45 +00:00			`.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`
Avoid use of direct troff requests in mdoc(7) manual pages. 2000-11-10 17:46:15 +00:00			`.An J\(:org Wunsch`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`so that it could be made setuid, with the S/Key keys file read-protected`
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 the users.`
While we're in here: Remove extraneous arguments to the Nm macro. Mark up cross-references properly. Use proper block displays (Bd). Use proper mark-up for author names (An). Remove the bogus ARGUMENTS section. Raname EXAMPLE -> EXAMPLES. Spell ``S/Key'' consistently. 2000-08-11 08:40:10 +00:00			`Rewritten in C by`
			`.An Warner Losh .`