usr.bin/keyinfo/keyinfo.1

   1 .\"     from: @(#)keyinfo.1     1.1 (Bellcore) 7/20/93
   2 .\" $FreeBSD: src/usr.bin/keyinfo/keyinfo.1,v 1.7.2.2 2001/12/21 10:07:20 ru Exp $
   3 .\"
   4 .Dd April 26, 1996
   5 .Dt KEYINFO 1
   6 .Os
   7 .Sh NAME
   8 .Nm keyinfo
   9 .Nd display current S/Key sequence number and seed
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Ar username
  13 .Sh DESCRIPTION
  14 .Nm
  15 takes an optional user name and displays the user\'s current sequence
  16 number and seed found in the S/Key database
  17 .Pa /etc/skeykeys .
  18 .Pp
  19 The command can be useful when generating a list of passwords for use
  20 on a field trip, by combining with the command
  21 .Xr key 1
  22 in the form:
  23 .Bd -literal -offset indent
  24 key -n  <number of passwords> `keyinfo` | lpr
  25 .Ed
  26 .Pp
  27 The optional
  28 .Ar username
  29 argument specifies the S/Key user for whom to display the information.
  30 The default is to display S/Key information
  31 on the user who invokes the command.
  32 Only the superuser can ask for another user's key information.
  33 .Sh EXAMPLES
  34 Usage example:
  35 .Bd -literal -offset indent
  36 $ keyinfo
  37 .Ed
  38 .Pp
  39 This would produce the following output:
  40 .Bd -literal -offset indent
  41 98 ws91340
  42 .Ed
  43 .Sh DIAGNOSTICS
  44 The
  45 .Nm
  46 utility
  47 exits with status 0 if a key for the requested user has been found,
  48 else with status 1.
  49 .Sh SEE ALSO
  50 .Xr key 1 ,
  51 .Xr keyinit 1
  52 .Sh AUTHORS
  53 .An -nosplit
  54 Original command by
  55 .An Phil Karn ,
  56 .An Neil M. Haller
  57 and
  58 .An John S. Walden .
  59 Rewritten in Perl by
  60 .An J\(:org Wunsch
  61 so that it could be made setuid, with the S/Key keys file read-protected
  62 from the users.
  63 Rewritten in C by
  64 .An Warner Losh .