NAME

rpc_mgmt_set_server_stack_size- specifies the stack size for server call threads

SYNOPSIS

#include <dce/rpc.h>

void rpc_mgmt_set_server_stack_size(
	unsigned32 thread_stack_size,
	unsigned32 *status);

PARAMETERS

Input

thread_stack_size

Specifies the stack size, in bytes, for call threads created when the server calls rpc_server_listen(). Select this value based on the stack requirements of the remote procedures offered by the server.

Output

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_not_supported

Not supported.

DESCRIPTION

The rpc_mgmt_set_server_stack_size() routine specifies the thread stack size to use when the RPC run-time system creates call threads for executing remote procedure calls. Call threads are created when the server applications calls rpc_server_listen(). The max_calls_exec argument to the rpc_server_listen() routine specifies the number of call threads created.

The server must call this routine before calling the rpc_server_listen() routine. If a server does not call this routine, the default per-thread stack size from the underlying threads package is used.

The thread stack size set by rpc_mgmt_set_server_stack_size() applies only to call threads created when the server subsequently calls rpc_server_listen().

Some thread packages do not support the specification or modification of thread stack sizes.

RETURN VALUE

None.

SEE ALSO

rpc_server_listen().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.