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 specific 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 cancellation or asynchronous signals.
RETURN VALUES
This routine returns
TRUE
if the operation was successful, and
FALSE
otherwise.