publickey(3N)                                                 publickey(3N)


   NAME
         publickey: getpublickey, getsecretkey - retrieve public or secret key

   SYNOPSIS
         #include <rpc/rpc.h>
         #include <rpc/keyprot.h>

         getpublickey(const char netname[MAXNETNAMELEN],
               char publickey[HEXKEYBYTES]);

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

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

   SEE ALSO
         publickey(4).

























   8/91                                                                 Page 1