publickey(3) [freebsd man page]

PUBLICKEY(3)						   BSD 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(const 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.  The getsecretkey() function 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 oth-
     erwise.  The keys are returned as NUL-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 NUL string (``'').

SEE ALSO

     publickey(5)

     RPC Programmer's Manual in /usr/share/doc/psd/23.rpc.

BSD
								  October 6, 1987							       BSD

getpublickey(3NSL)				       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:

	 o  the /etc/publickey file. See publickey(4).

	 o  the NIS map ``publickey.byname'' or the NIS+ table ``cred.org_dir''. The sources and their lookup order are specified in the /etc/nss-
	    witch.conf file. See nsswitch.conf(4).

       getsecretkey() has an extra argument, passwd, which is 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. Otherwise, the routines return 0. The keys are  returned  as  null-termi-
       nated,  hexadecimal  strings. If the password supplied to getsecretkey() 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 attributes:

       +-----------------------------+-----------------------------+
       |      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) file to make sure that the public key is obtained from NIS+.

   NOTES
       NIS+  might  not  be  supported in future releases of the SolarisTM Operating Environment. Tools to aid the migration from NIS+ to LDAP are
       available in the Solaris 9 operating environment. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10							    18 Dec 2001 						getpublickey(3NSL)