publickey(3N)           NETWORK FUNCTIONS           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).






























                          Last change:                          1