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

.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 DEPRECATION NOTICE
.Nm
is deprecated and is not available as of
.Fx 15.0.
.Sh DESCRIPTION
The
.Nm
utility is normally run by the network administrator on the
Network Interface Service
.Pq NIS
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 .
.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
.Pq NIS
was formerly known as Sun Yellow Pages
.Pq YP .
The functionality of the two remains the same;
only the name has changed.
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`
Add deprecation notices to publickey(5) tools Reviewed by: imp, manu MFC after: 3 days Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D40144 2023-09-20 11:31:14 +00:00			`.Sh DEPRECATION NOTICE`
			`.Nm`
			`is deprecated and is not available as of`
			`.Fx 15.0.`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.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`
mdoc cleanup Garbage collect unused sections, macros and arguments. Fix prologue and remove empty lines. Found by: mdocml 2010-06-02 10:20:23 +00:00			`.Pq 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			`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`
mdoc cleanup Garbage collect unused sections, macros and arguments. Fix prologue and remove empty lines. Found by: mdocml 2010-06-02 10:20:23 +00:00			`NFS .`
Add usage(), use err(3). Rewrote man page in mdoc format. 1997-07-29 06:54:16 +00:00			`.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`
mdoc cleanup Garbage collect unused sections, macros and arguments. Fix prologue and remove empty lines. Found by: mdocml 2010-06-02 10:20:23 +00:00			`.Pq 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			`was formerly known as Sun Yellow Pages`
mdoc cleanup Garbage collect unused sections, macros and arguments. Fix prologue and remove empty lines. Found by: mdocml 2010-06-02 10:20:23 +00:00			`.Pq YP .`
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.`