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