publickey(3N)                                          publickey(3N)


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

       SYNOPSIS
             cc [options] file -lnsl
             #include <rpc/rpc.h>
             #include <rpc/key_prot.h>
             int getpublickey(const char netname[MAXNETNAMELEN],
                   char publickey[HEXKEYBYTES]);
             int 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.

       REFERENCES
             publickey(4)




















                           Copyright 1994 Novell, Inc.               Page 1