secure_rpc.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

secure_rpc(3N) secure_rpc(3N)

NAME

secure_rpc: authdes_getucred(), authdes_seccreate(), getnetname(), host2netname(),

key_decryptsession(), key_encryptsession(), key_gendes(), key_setsecret(), key_secretkey_is_set(),

netname2host(), netname2user(), user2netname() - library routines for secure remote procedure calls

SYNOPSIS

#include <rpc/rpc.h>

#include <sys/types.h>

int authdes_getucred(

const struct authdes_cred *adc,

uid_t *uidp,

gid_t *gidp,

short *gidlenp ,

gid_t *gidlist );

AUTH *authdes_seccreate(

const char *name,

const unsigned int window,

const char *timehost ,

const des_block *ckey);

int getnetname(char

name[MAXNETNAMELEN+1]);

int host2netname(

char name[MAXNETNAMELEN+1],

const char *host ,

const char *domain);

int key_decryptsession(

const char *remotename ,

des_block *deskey );

int key_encryptsession(

const char *remotename ,

des_block *deskey );

int key_gendes(des_block *

deskey );

int key_setsecret(const char *

key);

int key_secretkey_is_set(void);

int netname2host(

const char *

name,

char *host ,

const int hostlen );

int netname2user(

const char *name,

uid_t *uidp,

gid_t *gidp,

int *gidlenp ,

gid_t gidlist [NGROUPS]);

int user2netname(

char name[MAXNETNAMELEN+1],

const uid_t uid,

const char *domain);

DESCRIPTION

RPC library routines allow C programs to make procedure calls on other machines across the network.

RPC supports various authentication ﬂavors. Among them are:

AUTH_NONE No authentication (none).

AUTH_SYS Traditional UNIX-style authentication.

AUTH_DES DES encryption-based authentication.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
secure_rpc(3N) secure_rpc(3N) NAME secure_rpc: authdes_getucred(), authdes_seccreate(), getnetname(), host2netname(), key_decryptsession(), key_encryptsession(), key_gendes(), key_setsecret(), key_secretkey_is_set(), netname2host(), netname2user(), user2netname() - library routines for secure remote procedure calls SYNOPSIS #include #include
PAGE 2
secure_rpc(3N) secure_rpc(3N) The authdes_getucred() and authdes_seccreate() routines implement the AUTH_DES authentication flavor. The keyserver daemon keyserv (see keyserv (1M)) must be running for the AUTH_DES authentication system to work, and keylogin (1) must have been run. Only the AUTH_DES style of authentication is discussed here. For information about the AUTH_NONE and AUTH_SYS styles of authentication, refer to rpc_clnt_auth(3N). The routines documented on this page are Thread Safe.
PAGE 3
secure_rpc(3N) secure_rpc(3N) function uses the domain hp.example.com rather than the default domain name of the machine. int key_decryptsession() This function is an interface to the keyserver daemon, which is associated with RPC’s secure authentication system (AUTH_DES authentication). User programs rarely need to call key_decryptsession() or the associated functions key_encryptsession(), key_gendes(), and key_setsecret().
PAGE 4
secure_rpc(3N) secure_rpc(3N) 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. SEE ALSO chkey(1), keyserv(1M), newkey(1M), rpc(3N), rpc_clnt_auth(3N).