1.Dd October 12, 1987
2.Dt NEWKEY 8
3.Os
4.Sh NAME
5.Nm newkey
6.Nd create a new key in the publickey database
7.Sh SYNOPSIS
8.Nm
9.Fl h Ar hostname
10.Nm
11.Fl u Ar username
12.Sh DEPRECATION NOTICE
13.Nm
14is deprecated and is not available as of
15.Fx 15.0.
16.Sh DESCRIPTION
17The
18.Nm
19utility is normally run by the network administrator on the
20Network Interface Service
21.Pq NIS
22master machine in order to establish public keys for
23users and super-users on the network.
24These keys are needed for using secure
25RPC
26or secure
27NFS .
28.Pp
29The
30.Nm
31utility will prompt for the login password of the given username and then
32create a new public/secret key pair in
33.Pa /etc/publickey
34encrypted with the login password of the given user.
35.Pp
36Use of this program is
37not required: users may create their own keys using
38.Xr chkey 1 .
39.Sh OPTIONS
40.Bl -tag -width indent
41.It Fl h Ar hostname
42Create a new public key for the super-user at the given hostname.
43Prompts for the root password of the given hostname.
44.It Fl u Ar username
45Create a new public key for the given username.
46Prompts for the
47NIS
48password of the given username.
49.El
50.Sh SEE ALSO
51.Xr chkey 1 ,
52.Xr keylogin 1 ,
53.Xr publickey 5 ,
54.Xr keyserv 8
55.Sh NOTES
56The Network Information Service
57.Pq NIS
58was formerly known as Sun Yellow Pages
59.Pq YP .
60The functionality of the two remains the same;
61only the name has changed.
62