PUBLICKEY(3R-BSD)   RISC/os Reference Manual    PUBLICKEY(3R-BSD)



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

SYNOPSIS
     For -systype svr3 and -systype bsd43:

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

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

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

DESCRIPTION
     These routines are used to get public and secret keys from
     the NIS (Network Information Service) database.  getsecret-
     key() has an extra argument, passwd, which is 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 getsecret-
     key() fails to decrypt the secret key, the routine will
     return 1 but the secretkey argument will be a NULL string
     (``'').

SEE ALSO
     publickey(4).

     Chapter 19 in the Programmer's Guide.

ORIGIN
     Sun Microsystems, NFS 4.0

NOTE
     These routines are not resolved by libc.a.  See intro(3R)
     for more information.













                        Printed 11/19/92                   Page 1