Subversion Repositories or1k

.\" @(#)publickey.3r    2.1 88/08/07 4.0 RPCSRC

.\" $FreeBSD: src/lib/libc/rpc/publickey.3,v 1.4 2000/03/02 09:13:46 sheldonh Exp $

.\"

.TH PUBLICKEY 3R  "6 October 1987"

.SH NAME

publickey, getpublickey, getsecretkey \- get public or secret key

.SH SYNOPSIS

.nf

.B #include 

.B #include 

.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,

hexadecimal strings.

If the password supplied to

.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