DragonFly On-Line Manual Pages

PUBLICKEY(3)          DragonFly Library Functions Manual          PUBLICKEY(3)

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

LIBRARY
     RPC Service Library (librpcsvc, -lrpcsvc)

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

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

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

DESCRIPTION
     These routines are used to get public and secret keys from the YP
     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
     ("").

SEE ALSO
     publickey(5)

     Remote Procedure Call Programming Guide, 4.4BSD Programmer's
     Supplementary Documents (PSD).

DragonFly 5.9-DEVELOPMENT      November 14, 2009     DragonFly 5.9-DEVELOPMENT