HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

551

552

553

554

555

556

557

558

559

560

getpublickey(3N) getpublickey(3N)

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

getpublickey()

and getsecretkey()

get public and secret keys for netname. The key may come

from one of the following sources: the

/etc/publickey

ﬁle (see publickey(4)), the NIS map

publickey.byname,or

user/host entries in the LDAP directory. The sources and their lookup

order are speciﬁed in the

/etc/nsswitch.conf

ﬁle (see nsswitch.conf(4)).

getsecretkey() has an extra argument, passwd, which is used to decrypt the encrypted secret key

stored in the database.

MULTITHREAD USAGE

Thread Safe: Yes

Cancel Safe: Yes

Fork Safe: No

Async-cancel Safe: No

Async-signal Safe: No

These functions can be called safely in a multithreaded environment. They may be cancellation points in

that they call functions that are cancel points.

In a multithreaded environment, these functions are not safe to be called by a child process after

fork()

and before exec(). These functions should not be called by a multithreaded application that supports

asynchronous cancellation or asynchronous signals.

RETURN VALUE

Both routines return 1 if they are successful in ﬁnding the key, 0 (zero) otherwise. 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.

WARNINGS

HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is supported. LDAP is the recommended

replacement for NIS+. HP fully supports the industry standard naming services based on LDAP.