GETPUBLICKEY(3NSL) Networking Services Library Functions GETPUBLICKEY(3NSL)
getpublickey, getsecretkey, publickey - retrieve public or secret key
#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);
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(5).
o NIS map ``publickey.byname''. The sources and their
lookup order are specified in the /etc/nsswitch.conf file.
See nsswitch.conf(5).
getsecretkey() has an extra argument, passwd, which is used to
decrypt the encrypted secret key stored in the database.
Both routines return 1 if they are successful in finding the key.
Otherwise, the routines return 0. The keys are returned as null-
terminated, 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.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+
secure_rpc(3NSL), nsswitch.conf(5), publickey(5), attributes(7)
February 25, 2017 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(5).
o NIS map ``publickey.byname''. The sources and their
lookup order are specified in the /etc/nsswitch.conf file.
See nsswitch.conf(5).
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-
terminated, 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(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+
SEE ALSO
secure_rpc(3NSL), nsswitch.conf(5), publickey(5), attributes(7)
February 25, 2017 GETPUBLICKEY(3NSL)