usr.bin/skeyinit/skeyinit.1

   1 .\"     $NetBSD: skeyinit.1,v 1.13 2005/09/11 23:26:14 wiz Exp $
   2 .\"     @(#)skeyinit.1  1.1     10/28/93
   3 .\"
   4 .Dd September 19, 2005
   5 .Dt SKEYINIT 1
   6 .Os
   7 .Sh NAME
   8 .Nm skeyinit
   9 .Nd change password or add user to S/Key authentication system
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl sxz
  13 .Op Fl k Ar passphrase
  14 .Op Fl n Ar count
  15 .Op Fl p Ar password
  16 .Op Fl t Ar hash
  17 .Op Ar user
  18 .Sh DESCRIPTION
  19 .Nm
  20 initializes the system so you can use S/Key one-time passwords to login.
  21 The program will ask you to enter a secret pass phrase;
  22 enter a phrase of several words in response.
  23 After the S/Key database
  24 has been updated you can login using either your regular password
  25 or using S/Key one-time passwords.
  26 .Pp
  27 .Nm
  28 requires you to type a secret password, so it should be used
  29 only on a secure terminal.
  30 .Sh OPTIONS
  31 .Bl -tag -width Ds
  32 .It Fl k Ar passphrase
  33 Use pass phrase
  34 .Ar passphrase
  35 instead of asking for one to be entered.
  36 .It Fl n Ar count
  37 Start the
  38 .Xr skey 1
  39 sequence at
  40 .Ar count
  41 (default is 100).
  42 .It Fl p Ar password
  43 Use password
  44 .Ar password
  45 instead of asking for one to be entered.
  46 .It Fl s
  47 allows the user to set the seed and count for complete control
  48 of the parameters.
  49 To do this run
  50 .Nm
  51 in one window and put in your count and seed; then run
  52 .Xr skey 1
  53 in another window to generate the correct 6 english words
  54 for that count and seed.
  55 You can then
  56 .Dq cut-and-paste
  57 or type the words into the
  58 .Nm
  59 window.
  60 .It Fl t Ar hash
  61 Selects the hash algorithm to use.
  62 Available choices are md4 (the default), md5, or sha1.
  63 .It Fl x
  64 Displays one-time password in hexadecimal instead of ASCII.
  65 .It Fl z
  66 Allows the user to zero their S/Key entry.
  67 .It Ar user
  68 The username to be changed/added.
  69 By default the current user is operated on, only root may
  70 change other user's entries.
  71 .El
  72 .Sh FILES
  73 .Bl -tag -width /etc/skeykeys
  74 .It Pa /etc/skeykeys
  75 database of information for the S/Key system.
  76 .El
  77 .Sh SEE ALSO
  78 .Xr skey 1 ,
  79 .Xr skeyaudit 1 ,
  80 .Xr skeyinfo 1
  81 .Sh AUTHORS
  82 .An Phil Karn
  83 .An Neil M. Haller
  84 .An John S. Walden
  85 .An Scott Chasin