getpublickey man page on SunOS

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

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
       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:

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

	 ·  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. 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.

SunOS 5.10			  10 Nov 2005		    getpublickey(3NSL)
[top]

List of man pages available for SunOS

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