HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

381

382

383

384

385

386

387

388

389

390

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

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]);

int getsecretkey(

const char netname [

MAXNETNAMELEN],

char secretkey[

HEXKEYBYTES],

const char *passwd );

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 support

asynchronous cancellationor asynchronous signals.

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)) or the NIS map

‘‘publickey.byname’’ or the NIS table ‘‘cred.org_dir’’. 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, used to decrypt the encrypted secret key stored in

the database.

RETURN VALUES

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

getpublickey() gets the public key from any source other than NIS+, all authenticated NIS+ opera-

tions may fail. To ensure that this does not happen, edit the nsswitch.conf() ﬁle to make sure that

the public key is obtained from NIS+.