xdr_opaque()--Translate between Fixed-Size Data and Its XDR

 #include <rpc/xdr.h>

 bool_t xdr_opaque(XDR *xdrs,
                   caddr_t cp,
                   const u_int cnt);

The xdr_opaque() function is a filter primitive that translates between fixed-size opaque data and its external representation.

Parameters

xdrs  (Input) 

A pointer to the eXternal Data Representation (XDR) stream handle.

cp  (I/O) 

The address of the opaque object.

cnt  (Input) 

The size, in bytes, of the object. By definition, the actual data that is contained in the opaque object will not be portable to another system.

Authorities

No authorization is required.

Return Value

Error Conditions

None.

Error Messages

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how xdr_opaque() is used:

#include <stdio.h>
#include <xdr.h>

/*
 * Handle of an external client -
 * pid - process ID of the server process on our host
 * oid - object ID of the server assigned to that client
 * Typical case when the other side needs a handle, without
 * actually knowing what it is. We can use xdr_netobj()
 * or xdr_opaque().
 */
typedef struct handle
{
        int pid;
        int oid;
} handle ;

bool_t xdr_handle(XDR *xdrs, handle *p_handle )
{
     return xdr_opaque(xdrs,(caddr_t)p_handle,sizeof(handle));
}