Initial import from FreeBSD RELENG_4:
[games.git] / usr.bin / newkey / newkey.8
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 .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
15 .Nm Newkey
16 is normally run by the network administrator on the
17 Network Interface Service
18 (\s-1NIS\s0)
19 master machine in order to establish public keys for
20 users and super-users on the network.
21 These keys are needed for using secure
22 RPC
23 or secure
24 NFS\s0.
25 .Pp
26 .Nm Newkey
27 will prompt for the login password of the given username and then
28 create a new public/secret key pair in
29 .Pa /etc/publickey
30 encrypted with the login password of the given user.
31 .Pp
32 Use of this program is
33 not required: users may create their own keys using
34 .Xr chkey 1 .
35 .Sh OPTIONS
36 .Bl -tag -width indent
37 .It Fl h Ar hostname
38 Create a new public key for the super-user at the given hostname.
39 Prompts for the root password of the given hostname.
40 .It Fl u Ar username
41 Create a new public key for the given username.
42 Prompts for the
43 NIS
44 password of the given username.
45 .El
46 .Sh SEE ALSO
47 .Xr chkey 1 ,
48 .Xr keylogin 1 ,
49 .Xr publickey 5 ,
50 .Xr keyserv 8
51 .Sh NOTES
52 The Network Information Service
53 (\s-1NIS\s0)
54 was formerly known as Sun Yellow Pages
55 (\s-1YP\s0).
56 The functionality of the two remains the same;
57 only the name has changed.