usr.sbin/keyserv/keyserv.8

   1 .\" @(#)keyserv.1m 1.21 93/07/14 SMI; from SVr4
   2 .\"macro stdmacro
   3 .\" Copyright 1989 AT&T
   4 .\" @(#)keyserv.8c 1.8 89/03/29 SMI;
   5 .\".TH KEYSERV 8C "9 September 1987"
   6 .Dd September 14, 1992
   7 .Dt KEYSERV 8
   8 .Os
   9 .Sh NAME
  10 .Nm keyserv
  11 .Nd server for storing private encryption keys
  12 .Sh SYNOPSIS
  13 .Nm keyserv
  14 .Op Fl d
  15 .Op Fl D
  16 .Op Fl n
  17 .Op Fl p Ar path
  18 .Op Fl v
  19 .Sh DESCRIPTION
  20 .Nm Keyserv
  21 is a daemon that is used for storing the
  22 private encryption keys of each
  23 user logged into the system.
  24 These encryption keys are used for accessing
  25 secure network services such as secure NFS.
  26 .Pp
  27 Normally, root's key is read from the file
  28 .Pa /etc/.rootkey
  29 when the daemon is started.
  30 This is useful during power-fail reboots
  31 when no one is around to type a password.
  32 .Pp
  33 If a client with no secret key calls
  34 .Nm keyserv ,
  35 then the key of user
  36 .Em nobody
  37 is used instead as the default key.
  38 .Pp
  39 The following options are available:
  40 .Bl -tag -width indent
  41 .It Fl d
  42 Disable the use of default keys for
  43 .Em nobody .
  44 .It Fl D
  45 Run in debugging mode and log all requests to
  46 .Nm keyserv .
  47 .It Fl n
  48 Root's secret key is not read from
  49 .Pa /etc/.rootkey .
  50 Instead,
  51 .Nm
  52 prompts the user for the password to decrypt
  53 root's key stored in the
  54 .Pa /etc/publickey
  55 database and then stores the decrypted key in
  56 .Pa /etc/.rootkey
  57 for future use.
  58 This option is useful if the
  59 .Pa /etc/.rootkey
  60 file ever gets out of date or corrupted.
  61 .It Fl p Ar path
  62 Specify where to search for
  63 .Pa libdes.so.3 .
  64 Default is
  65 .Pa /usr/lib .
  66 .It Fl v
  67 Display status of DES support (enabled/disabled).
  68 .El
  69 .Sh FILES
  70 .Bl -tag -width /usr/lib/libdes.so.3. -compact
  71 .It Pa /etc/.rootkey
  72 .It Pa /usr/lib/libdes.so.3.
  73 .El
  74 .Sh "SEE ALSO"
  75 .Xr keylogin 1 ,
  76 .Xr keylogout 1 ,
  77 .Xr publickey 5