xref: /dragonfly/usr.bin/newkey/newkey.8 (revision a4da4a90)
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
17is 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
27.Nm Newkey
28will prompt for the login password of the given username and then
29create a new public/secret key pair in
30.Pa /etc/publickey
31encrypted with the login password of the given user.
32.Pp
33Use of this program is
34not 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
39Create a new public key for the super-user at the given hostname.
40Prompts for the root password of the given hostname.
41.It Fl u Ar username
42Create a new public key for the given username.
43Prompts for the
44NIS
45password 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
53The Network Information Service
54(\s-1NIS\s0)
55was formerly known as Sun Yellow Pages
56(\s-1YP\s0).
57The functionality of the two remains the same;
58only the name has changed.
59