Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	  pub-
       lickey[HEXKEYBYTES+1]);

       int   getsecretkey(const	  char	 netname[MAXNETNAMELEN],   char	   se-
       cretkey[HEXKEYBYTES+1], const char *passwd);

DESCRIPTION
       getpublickey()  and  getsecretkey() get public and secret keys for net-
       name. 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	speci-
	     fied in the /etc/nsswitch.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. Oth-
       erwise, 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  se-
       cretkey [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 Operat-
       ing  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.9			  18 Dec 2001		    getpublickey(3NSL)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | WARNINGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getpublickey&sektion=3nsl&manpath=SunOS+5.9>

home | help