NAME

rpccmd − Control the RPC system

SYNOPSIS

rpccmd  [options]

OPTIONS

−onTurn on the server half of the RPC system. 

−offTurn off the server half of the RPC system. 

−ping hostDo an RPC test against the specified host. 

−b sizeThe amount of data to send in each RPC test. 

−t [0|1]Set the value of the rpc_Tracing variable.  RPC tracing facilitates debugging, but adds overhead to each RPC. 

−D [0|1]Set the value of the rpc_Debug variable.  A non-zero value causes each RPC to be logged to /dev/syslog.  This really slows things down! 

−T [0|1]Set the value of the rpc_NoTimeouts variable.  A non-zero value makes all RPCs try forever.  This is dangerous because a server call-back to a dead client will hang the server. 

−C [0|1]Turn off/on timings of RPC on the client side.  Use rpcstat to dump out the histograms of times that are taken by the kernel. 

−S [0|1]Turn off/on timing of the RPC service times as measured by the server. 

−CresetReset the client-side timing histograms. 

−SresetReset the server-side timing histograms. 

−maxServers number
Set the maximum number of allowed rpc server processes.

−numServers number
Create more rpc servers until this number exists.

−negAcksOnAllow the machine to generate negative acknowledgements. 

−negAcksOffPrevent the machine from generating negative acknowledgements. 

−channelNegAcksOn
Turn on the client policy of ramping down the number of channels it uses with a server that has returned a negative acknowledgement recently.

−channelNegAcksOff
Turn off the client policy of ramping down the number of channels it uses with a server that has returned a negative acknowledgement recently. Use back-off instead.

−numPingsNumber of pings to send to the specified host (defaults to 100). 

−sanity [0|1]Turn off/on sanity checking of RPC packets.  The types of sanity checks done are intended for debugging purposes and probably shouldn’t be used during normal operation. 

INTRODUCTION

This command is used to set various control parameters of the RPC system.  The most important is the −on option, which is used during the boot sequence to enable RPC service after local initialization (i.e. disk checks) is done.  The −ping option is used to ping another sprite host.  This is useful to find out if the host is up, and the make sure that the host knows you are alive.  This does an RPC_SEND, and the amount of data sent can be specified with the −b option. 

Each of the −t, −D, −T, −C, and −S options set the value of a kernel variable.  −t is used to turn on or off the trace of the last 100 RPC packets.  −D is used to turn on or off debugging print statements.  −T is used to turn on or off "no timeout mode".  This mode is useful when debugging a client and you don’t want the server to timeout and think the client has crashed.  It is dangerous, however, because if the server ever makes a call-back to a truely dead client it will hang until the no timeout mode is turned off. 

The −C and −S options turn on or off timings of individual RPCs.  −C controls timing on the client side, and −S controls timing on the server side.  The timings are kept in histogram form.  Use the −Creset and −Sreset options to zero out the histograms.  Use rpcstat to display them. 

SEE ALSO

rpcstat

KEYWORDS

rpc, trace, debug

Sprite version 1.0  —  July 10, 1992