Technical Reference: Communications, Volume 1

xdr_pointer Subroutine

Purpose

Provides pointer chasing within structures and serializes null pointers.

Library

C Library (libc.a)

Syntax

#include <rpc/xdr.h>

xdr_pointer (xdrs, objpp, objsize, xdrobj) XDR * xdrs; char ** objpp; u_int objsize; xdrproc_t xdrobj;

Description

The xdr_pointer subroutine provides pointer chasing within structures and serializes null pointers. This subroutine can represent recursive data structures, such as binary trees or linked lists.

Parameters

xdrs	Points to the eXternal Data Representation (XDR) stream handle.
objpp	Points to the character pointer of the data structure.
objsize	Specifies the size of the structure.
xdrobj	Specifies the XDR filter for the object.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

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 and Understanding XDR Non-Filter Primitives in AIX 5L Version 5.1 Communications Programming Concepts.