publickey(3N)                    UNIX System V                    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)




























10/89                                                                    Page 1