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



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

SYNOPSIS
     For -systype sysv 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 1/15/91                   Page 1