52 lines
1.1 KiB
Groff
52 lines
1.1 KiB
Groff
.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.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
|
|
.Fd "#include <rpc/rpc.h>"
|
|
.Fd "#include <rpc/key_prot.h>"
|
|
.Ft int
|
|
.Fo getpublickey
|
|
.Fa "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.
|
|
.Fn getsecretkey
|
|
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 NULL 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 NULL
|
|
string
|
|
.Pq Dq .
|
|
.Sh SEE ALSO
|
|
.Xr publickey 5
|
|
.Pp
|
|
.%T "RPC Programmer's Manual"
|
|
in
|
|
.Pa /usr/share/doc/psd/23.rpc .
|