PRESTOCTL(3R) — RPC SERVICES LIBRARY

NAME

prestoctl − Prestoserve control RPC protocol

PROTOCOL

/usr/include/rpcsvc/prestoctl.x

DESCRIPTION

The prestoctl protocol provides four procedural interfaces to a server’s Prestoserve subsystem:

PRESTOCTL_GETSTATE
This procedure takes no arguments and returns a boolean indicating success (TRUE) followed by the current struct presto_state, which represents the current status of the Prestoserve subsystem, or failure (FALSE) followed by an ASCII error string.

PRESTOCTL_SETBYTES
This procedure takes an unsigned integer argument, size which represents the number of bytes used in the Prestoserve cache. The procedure returns a boolean indicating success (TRUE) followed by the current struct presto_state, or failure (FALSE) followed by an ASCII error string.

PRESTOCTL_TOGGLE
This procedure takes a boolean argument which sets the Prestoserve board state to “UP” (boolean value TRUE) or “DOWN” (boolean value FALSE). The procedure returns a boolean indicating success (TRUE) followed by the current struct presto_state, or failure (FALSE) followed by an ASCII error string.

PRESTOCTL_GET_FS_STATUS
This procedure takes the name of an NFS filesystem mounted from a server on a client (e.g., /export/exec/sun3). This procedure returns a boolean indicating success (TRUE) followed by the struct presto_fs_status for the filesystem specified, or failure (FALSE) followed by an ASCII error string.

PROGRAMMING

rpcgen prestoctl.x

The following are produced by compiling prestoctl.x:

prestoctl.h The C interface that defines common data structures, client side entry points and common XDR routines.

prestoctl_xdr.c The C implementation of the common XDR routines.

prestoctl_clnt.c The C implementation of the client side entry points.

prestoctl_svc.c The server side main() and service wrapper code. Be aware that presto_chango(8) installs a /usr/etc/prestoctl_svc daemon which implements the server for this protocol.

FILES

/usr/include/rpcsvc/prestoctl.x
machine readable specification for this protocol.

Museum