publickey(3R)                   ONC 5.4R3.00                   publickey(3R)


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

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

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

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

DESCRIPTION
       NOTE:  Secure RPC using DES Authentication is an additional feature
       that must be purchased separately from the DG/UX (Trademark) ONC
       (Trademark)/NFS® package.  You must have this feature to use the
       routines on this manual page.

       These routines are used to get public and secret keys from the NIS
       database.  getsecretkey() 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 getsecretkey() fails to decrypt
       the secret key, the routine will return 1 but the secretkey argument
       will be a NULL string (``'').

       Programs that use these routines must be loaded using the flag -l
       rpcsvc.

SEE ALSO
       rpc(3N), publickey(4).

       Chapter 6 "Remote Procedure Call Protocol Programming Guide" in
       Managing ONC/NFS and Its Facilities on the DG/UX System.


















Licensed material--property of copyright holder(s)                         1