getpublickey man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETPUBLICKEY(3NSL)					    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
       The  getpublickey()  and getsecretkey() functions get public and secret
       keys for netname. The key may come from one of the following sources:

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

	   o	  NIS	map   ``publickey.byname''   or	  the	 NIS+	 table
		  ``cred.org_dir''.   The  sources  and their lookup order are
		  specified  in	 the   /etc/nsswitch.conf   file.   See	  nss‐
		  witch.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
       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 Solaris operating
       system.	Tools to aid the migration from NIS+ to LDAP are available  in
       the    current	Solaris	  release.   For   more	  information,	 visit
       http://www.sun.com/directory/nisplus/transition.html.

				 Nov 10, 2005		    GETPUBLICKEY(3NSL)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net