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