opensolaris man page for getsecretkey

Query: getsecretkey

OS: opensolaris

Section: 3nsl

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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
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 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 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.11 10 Nov 2005 getpublickey(3NSL)
Related Man Pages
publickey(3nsl) - sunos
getsecretkey(3nsl) - centos
publickey(3nsl) - bsd
getpublickey(3nsl) - x11r4
getpublickey(3nsl) - suse
Similar Topics in the Unix Linux Community
How to learn UNIX
Grep the 'not running' jobs and will send the update in mail with its name(job)
Solaris 10 - password complexity not working
What is good?
Shopt -s histappend