Networking Services Library Functions          getpublickey(3NSL)

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

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

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

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

DESCRIPTION
     getpublickey() and getsecretkey() get public and secret keys
     for  netname.  The  key  may  come from one of the following
     sources: the /etc/publickey file (see publickey(4))  or  the
     NIS    map    ``publickey.byname''   or   the   NIS+   table
     ``cred.org_dir''. The sources and  their  lookup  order  are
     specified    in    the    /etc/nsswitch.conf    file    (see
     nsswitch.conf(4)).

     getsecretkey()  has  an  extra  argument,  passwd,  used  to
     decrypt the encrypted secret key stored in the database.

RETURN VALUES
     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  getsecret-
     key()  fails  to  decrypt  the  secret key, the routine will
     return 1 but the secretkey [0] will be set to NULL.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|

SEE ALSO
     secure_rpc(3NSL),  nsswitch.conf(4),  publickey(4),   attributes(5)
     

WARNINGS
     If getpublickey() gets the public key from any source  other
     than  NIS+,  all  authenticated NIS+ operations may fail. To
     ensure that this does not happen, edit the  nsswitch.conf(4)

SunOS 5.8           Last change: 30 Dec 1996                    1

Networking Services Library Functions          getpublickey(3NSL)

     file to make sure that the public key is obtained from NIS+.

SunOS 5.8           Last change: 30 Dec 1996                    2