Technical Reference: Communications, Volume 1

xdrrec_create Subroutine

Purpose

Provides an XDR stream that can contain long sequences of records.

Syntax

#include <rpc/xdr.h>

void xdrrec_create (xdrs, sendsize, recvsize, handle, readit, writeit) XDR * xdrs; u_int sendsize; u_int recvsize; char * handle; int (* readit) (), (* writeit) ();

The xdrrec_create subroutine provides an eXternal Data Representation (XDR) stream that can contain long sequences of records and handle them in both the encoding and decoding directions. The record contents contain data in XDR form. The routine initializes the XDR stream object pointed to by the xdrs parameter.

Note: This XDR stream implements an intermediate record stream. As a result, additional bytes are in the stream to provide record boundary information.

Parameters

xdrs	Points to the XDR stream handle.
sendsize	Sets the size of the input buffer to which data is written. If 0 is specified, the buffers are set to the system defaults.
recvsize	Sets the size of the output buffer from which data is read. If 0 is specified, the buffers are set to the system defaults.
handle	Points to the input/output buffer's handle, which is opaque.
readit	Points to the subroutine to call when a buffer needs to be filled. Similar to the read system call.
writeit	Points to the subroutine to call when a buffer needs to be flushed. Similar to the write system call.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

List of XDR Programming References.

eXternal Data Representation (XDR) Overview for Programming in AIX 5L Version 5.1 Communications Programming Concepts.

Understanding XDR Non-Filter Primitives in AIX 5L Version 5.1 Communications Programming Concepts.