VxWorks API Reference : OS Libraries
rpcLib - Remote Procedure Call (RPC) support library
rpcInit( ) - initialize the RPC package
rpcTaskInit( ) - initialize a task's access to the RPC package
This library supports Sun Microsystems' Remote Procedure Call (RPC) facility. RPC provides facilities for implementing distributed client/server-based architectures. The underlying communication mechanism can be completely hidden, permitting applications to be written without any reference to network sockets. The package is structured such that lower-level routines can optionally be accessed, allowing greater control of the communication protocols.
For more information and a tutorial on RPC, see Sun Microsystems' Remote Procedure Call Programming Guide. For an example of RPC usage, see /target/unsupported/demo/sprites.
The RPC facility is enabled when INCLUDE_RPC is defined.
VxWorks supports Network File System (NFS), which is built on top of RPC. If NFS is configured into the VxWorks system, RPC is automatically included as well.
A task must call rpcTaskInit( ) before making any calls to other routines in the RPC library. This routine creates task-specific data structures required by RPC. These task-specific data structures are automatically deleted when the task exits.
Because each task has its own RPC context, RPC-related objects (such as SVCXPRTs and CLIENTs) cannot be shared among tasks; objects created by one task cannot be passed to another for use. Such additional objects must be explicitly deleted (for example, using task deletion hooks).
rpc.h
nfsLib, nfsDrv, Sun Microsystems' Remote Procedure Call Programming Guide
rpcInit( ) - initialize the RPC package
STATUS rpcInit (void)
This routine must be called before any task can use the RPC facility; it spawns the portmap daemon. It is called automatically if INCLUDE_RPC is defined.
Under VxWorks AE, you can call this function from within the kernel protection domain only. This restriction does not apply under non-AE versions of VxWorks.
OK, or ERROR if the portmap daemon cannot be spawned.
rpcTaskInit( ) - initialize a task's access to the RPC package
STATUS rpcTaskInit (void)
This routine must be called by a task before it makes any calls to other routines in the RPC package.
Under VxWorks AE, you can call this function from within the kernel protection domain only. This restriction does not apply under non-AE versions of VxWorks.
OK, or ERROR if there is insufficient memory or the routine is unable to add a task delete hook.