publickey(3N)							 publickey(3N)

NAME    [Toc]    [Back]

     publickey:	getpublickey, getsecretkey - retrieve public or	secret key

SYNOPSIS    [Toc]    [Back]

     #include <rpc/rpc.h>
     #include <rpc/key_prot.h>

     getpublickey(const	char netname[MAXNETNAMELEN],
	  char publickey[HEXKEYBYTES]);
     getsecretkey(const	char netname[MAXNETNAMELEN],
	  char secretkey[HEXKEYBYTES], const char *passwd);

DESCRIPTION    [Toc]    [Back]

     getpublickey and getsecretkey get public and secret keys for netname from
     the publickey(4) database.

     getsecretkey has an extra argument, passwd, 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 NULL-terminated, hexadecimal
     strings.  If the password supplied	to getsecretkey	fails to decrypt the
     secret key, the routine will return 1 but the secretkey argument will be
     a NULL string.

NOTE    [Toc]    [Back]

     These routines are	not supported, and no actual encryption	or decryption
     is	done.

SEE ALSO    [Toc]    [Back]

     secure_rpc(3N)


									PPPPaaaaggggeeee 1111