1997-05-28 05:00:11 +00:00
|
|
|
.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1999-07-12 20:50:10 +00:00
|
|
|
.\"
|
1997-05-28 05:00:11 +00:00
|
|
|
.TH PUBLICKEY 3R "6 October 1987"
|
|
|
|
|
.SH NAME
|
|
|
|
|
publickey, getpublickey, getsecretkey \- get public or secret key
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.nf
|
|
|
|
|
.B #include <rpc/rpc.h>
|
|
|
|
|
.B #include <rpc/key_prot.h>
|
|
|
|
|
.LP
|
|
|
|
|
.B getpublickey(netname, publickey)
|
|
|
|
|
.B char netname[\s-1MAXNETNAMELEN\s0+1];
|
|
|
|
|
.B char publickey[\s-1HEXKEYBYTES\s0+1];
|
|
|
|
|
.LP
|
|
|
|
|
.B getsecretkey(netname, secretkey, passwd)
|
|
|
|
|
.B char netname[\s-1MAXNETNAMELEN\s0+1];
|
|
|
|
|
.B char secretkey[\s-1HEXKEYBYTES\s0+1];
|
|
|
|
|
.B char *passwd;
|
|
|
|
|
.fi
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.IX "getpublickey function" "" "\fLgetpublickey()\fP function"
|
|
|
|
|
.IX "getsecretkey function" "" "\fLgetsecretkey()\fP function"
|
|
|
|
|
These routines are used to get public and secret keys from the
|
|
|
|
|
.SM YP
|
|
|
|
|
database.
|
|
|
|
|
.B getsecretkey(\|)
|
|
|
|
|
has an extra argument,
|
|
|
|
|
.IR 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
|
|
|
|
|
.SM NULL\s0-terminated,
|
2000-03-02 09:14:21 +00:00
|
|
|
hexadecimal strings.
|
|
|
|
|
If the password supplied to
|
1997-05-28 05:00:11 +00:00
|
|
|
.B getsecretkey(\|)
|
|
|
|
|
fails to decrypt the secret key, the routine will return 1 but the
|
|
|
|
|
.I secretkey
|
|
|
|
|
argument will be a
|
|
|
|
|
.SM NULL
|
|
|
|
|
string (``'').
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR publickey (5)
|
|
|
|
|
.LP
|
|
|
|
|
.I \s-1RPC\s0 Programmer's Manual
|
|
|
|
|
in
|
|
|
|
|
.TX NETP
|
