docs - More adjustments to the swapcache manual page.
[dragonfly.git] / usr.bin / newkey / newkey.8
blobe5dc831580017ff4507b518621c5b7cd167f0e86
1 .\" @(#)newkey.8 1.3 91/03/11 TIRPC 1.0; from 1.12 90/02/03 SMI;
2 .\" $FreeBSD: src/usr.bin/newkey/newkey.8,v 1.4.2.2 2001/07/22 12:40:28 dd Exp $
3 .\" $DragonFly: src/usr.bin/newkey/newkey.8,v 1.2 2003/06/17 04:29:30 dillon Exp $
4 .Dd October 12, 1987
5 .Dt NEWKEY 8
6 .Os
7 .Sh NAME
8 .Nm newkey
9 .Nd create a new key in the publickey database
10 .Sh SYNOPSIS
11 .Nm
12 .Fl h Ar hostname
13 .Nm
14 .Fl u Ar username
15 .Sh DESCRIPTION
16 .Nm Newkey
17 is normally run by the network administrator on the
18 Network Interface Service
19 (\s-1NIS\s0)
20 master machine in order to establish public keys for
21 users and super-users on the network.
22 These keys are needed for using secure
23 RPC
24 or secure
25 NFS\s0.
26 .Pp
27 .Nm Newkey
28 will prompt for the login password of the given username and then
29 create a new public/secret key pair in
30 .Pa /etc/publickey
31 encrypted with the login password of the given user.
32 .Pp
33 Use of this program is
34 not required: users may create their own keys using
35 .Xr chkey 1 .
36 .Sh OPTIONS
37 .Bl -tag -width indent
38 .It Fl h Ar hostname
39 Create a new public key for the super-user at the given hostname.
40 Prompts for the root password of the given hostname.
41 .It Fl u Ar username
42 Create a new public key for the given username.
43 Prompts for the
44 NIS
45 password of the given username.
46 .El
47 .Sh SEE ALSO
48 .Xr chkey 1 ,
49 .Xr keylogin 1 ,
50 .Xr publickey 5 ,
51 .Xr keyserv 8
52 .Sh NOTES
53 The Network Information Service
54 (\s-1NIS\s0)
55 was formerly known as Sun Yellow Pages
56 (\s-1YP\s0).
57 The functionality of the two remains the same;
58 only the name has changed.