mirror of
https://github.com/freebsd/freebsd-src
synced 2024-07-23 03:06:48 +00:00
dc36d6f9bb
Remove ancient SCCS tags from the tree, automated scripting, with two minor fixup to keep things compiling. All the common forms in the tree were removed with a perl script. Sponsored by: Netflix
52 lines
1.1 KiB
Groff
52 lines
1.1 KiB
Groff
.\"
|
|
.Dd October 6, 1987
|
|
.Dt PUBLICKEY 3
|
|
.Os
|
|
.Sh NAME
|
|
.Nm publickey , getpublickey , getsecretkey
|
|
.Nd "get public or secret key"
|
|
.Sh LIBRARY
|
|
.Lb librpcsvc
|
|
.Sh SYNOPSIS
|
|
.In rpc/rpc.h
|
|
.In rpc/key_prot.h
|
|
.Ft int
|
|
.Fo getpublickey
|
|
.Fa "const char netname[MAXNETNAMELEN+1]"
|
|
.Fa "char publickey[HEXKEYBYTES+1]"
|
|
.Fc
|
|
.Ft int
|
|
.Fo getsecretkey
|
|
.Fa "char netname[MAXNETNAMELEN+1]"
|
|
.Fa "char secretkey[HEXKEYBYTES+1]"
|
|
.Fa "char *passwd"
|
|
.Fc
|
|
.Sh DESCRIPTION
|
|
These routines are used to get public and secret keys from the
|
|
.Tn YP
|
|
database.
|
|
The
|
|
.Fn getsecretkey
|
|
function
|
|
has an extra argument,
|
|
.Fa passwd ,
|
|
which is used to decrypt the encrypted secret key stored in the database.
|
|
Both routines return 1 if they are successful in finding the key, 0 otherwise.
|
|
The keys are returned as
|
|
.Dv NUL Ns \-terminated ,
|
|
hexadecimal strings.
|
|
If the password supplied to
|
|
.Fn getsecretkey
|
|
fails to decrypt the secret key, the routine will return 1 but the
|
|
.Fa secretkey
|
|
argument will be a
|
|
.Dv NUL
|
|
string
|
|
.Pq Dq .
|
|
.Sh SEE ALSO
|
|
.Xr publickey 5
|
|
.Pp
|
|
.%T "RPC Programmer's Manual"
|
|
in
|
|
.Pa /usr/share/doc/psd/23.rpc .
|