freebsd-nq/usr.bin/newkey/newkey.8

.\" @(#)newkey.8 1.3 91/03/11 TIRPC 1.0; from 1.12 90/02/03 SMI;
.\" $FreeBSD$
.Dd October 12, 1987
.Dt NEWKEY 8
.Os
.Sh NAME
.Nm newkey
.Nd create a new key in the publickey database
.Sh SYNOPSIS
.Nm
.Fl h Ar hostname
.Nm
.Fl u Ar username
.Sh DESCRIPTION
The
.Nm
utility 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
The
.Nm
utility 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.
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`.\" @(#)newkey.8 1.3 91/03/11 TIRPC 1.0; from 1.12 90/02/03 SMI;`
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`.\" $FreeBSD$`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Dd October 12, 1987`
			`.Dt NEWKEY 8`
			`.Os`
			`.Sh NAME`
			`.Nm newkey`
			`.Nd create a new key in the publickey database`
			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 19:21:22 +00:00			`.Nm`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Fl h Ar hostname`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 19:21:22 +00:00			`.Nm`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Fl u Ar username`
			`.Sh DESCRIPTION`
The .Nm utility 2002-07-14 15:12:00 +00:00			`The`
			`.Nm`
			`utility is normally run by the network administrator on the`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`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`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`RPC`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`or secure`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`NFS\s0.`
			`.Pp`
The .Nm utility 2002-07-14 15:12:00 +00:00			`The`
			`.Nm`
			`utility will prompt for the login password of the given username and then`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`create a new public/secret key pair in`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Pa /etc/publickey`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`encrypted with the login password of the given user.`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Pp`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`Use of this program is`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`not required: users may create their own keys using`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.Xr chkey 1 .`
			`.Sh OPTIONS`
			`.Bl -tag -width indent`
			`.It Fl h Ar hostname`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`Create a new public key for the super-user at the given hostname.`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`Prompts for the root password of the given hostname.`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.It Fl u Ar username`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`Create a new public key for the given username.`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`Prompts for the`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`NIS`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`password of the given username.`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.El`
			`.Sh SEE ALSO`
			`.Xr chkey 1 ,`
			`.Xr keylogin 1 ,`
			`.Xr publickey 5 ,`
			`.Xr keyserv 8`
			`.Sh NOTES`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`The Network Information Service`
			`(\s-1NIS\s0)`
			`was formerly known as Sun Yellow Pages`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`(\s-1YP\s0).`
Import newkey. This is the program used to generate new Secure RPC public and secret key pairs. 1997-05-28 15:52:07 +00:00			`The functionality of the two remains the same;`
			`only the name has changed.`