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