freebsd-skq/usr.bin/newkey/newkey.8
charnier 7711e701aa Add usage(), use err(3).
Rewrote man page in mdoc format.
1997-07-29 06:54:16 +00:00

57 lines
1.3 KiB
Groff

.\" @(#)newkey.8 1.3 91/03/11 TIRPC 1.0; from 1.12 90/02/03 SMI;
.Dd October 12, 1987
.Dt NEWKEY 8
.Os
.Sh NAME
.Nm newkey
.Nd create a new key in the publickey database
.Sh SYNOPSIS
.Nm newkey
.Fl h Ar hostname
.Nm newkey
.Fl u Ar username
.Sh DESCRIPTION
.Nm Newkey
is normally run by the network administrator on the
Network Interface Service
(\s-1NIS\s0)
master machine in order to establish public keys for
users and super-users on the network.
These keys are needed for using secure
RPC
or secure
NFS\s0.
.Pp
.Nm Newkey
will prompt for the login password of the given username and then
create a new public/secret key pair in
.Pa /etc/publickey
encrypted with the login password of the given user.
.Pp
Use of this program is
not required: users may create their own keys using
.Xr chkey 1 .
.Sh OPTIONS
.Bl -tag -width indent
.It Fl h Ar hostname
Create a new public key for the super-user at the given hostname.
Prompts for the root password of the given hostname.
.It Fl u Ar username
Create a new public key for the given username.
Prompts for the
NIS
password of the given username.
.El
.Sh SEE ALSO
.Xr chkey 1 ,
.Xr keylogin 1 ,
.Xr publickey 5 ,
.Xr keyserv 8
.Sh NOTES
The Network Information Service
(\s-1NIS\s0)
was formerly known as Sun Yellow Pages
(\s-1YP\s0).
The functionality of the two remains the same;
only the name has changed.