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''. 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 ALSOsecure_rpc(3NSL), nsswitch.conf(4), publickey(4), attributes(5)SunOS 5.11 10 Dec 2009 getpublickey(3NSL)