HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

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 applications to 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

RPC_SVC_MT_AUTO Automatic MT mode

Unless the application sets the Automatic or 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 cancellation or asynchronous signals.

RETURN VALUE

This routine returns

TRUE if the operation was successful, and FALSE otherwise.