HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

301

302

303

304

305

306

307

308

309

310

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

rpc_control(3N) rpc_control(3N)

NAME

rpc_control - library routine for manipulating global RPC attributes for client and server applications

SYNOPSIS

bool_t rpc_control(int op, void *info);

DESCRIPTION

This RPC library routine allows applicationsto set and modify global RPC attributes that apply to clients as

well as servers. At present, it supports only server side operations. op indicates the type of operation, and

info is a pointer to the operation speciﬁc information. The supported values of op and their argument

types, and what they do are:

RPC_SVC_MTMODE_SET int * set multithread mode

RPC_SVC_MTMODE_GET int * get multithread mode

There are three multithread (MT) modes. These are:

RPC_SVC_MT_NONE Single threaded mode (default)

RPC_SVC_MT_USER User MT mode

Unless the application sets the User MT modes, it will stay in the default (single threaded) mode. Once a

mode is set, it cannot be changed.

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.

RETURN VALUES

This routine returns TRUE if the operation was successful, and FALSE otherwise.