xdr_admin(3N)							 xdr_admin(3N)

NAME    [Toc]    [Back]

     xdr_admin:	 xdr_getpos, xdr_inline, xdrrec_eof, xdr_setpos	- library
     routines for external data	representation

DESCRIPTION    [Toc]    [Back]

     XDR library routines allow	C programmers to describe arbitrary data
     structures	in a machine-independent fashion.  Protocols such as remote
     procedure calls (RPC) use these routines to describe the format of	the
     data.

     These routines deal specifically with the management of the XDR stream.

   Routines    [Toc]    [Back]
     See rpc(3N) for the definition of the XDR data structure.

     #include <rpc/xdr.h>

     u_int
     xdr_getpos(const XDR *xdrs);

	  A macro that invokes the get-position	routine	associated with	the
	  XDR stream, xdrs.  The routine returns an unsigned integer, which
	  indicates the	position of the	XDR byte stream.  A desirable feature
	  of XDR streams is that simple	arithmetic works with this number,
	  although the XDR stream instances need not guarantee this.
	  Therefore, applications written for portability should not depend on
	  this feature.

     long *
     xdr_inline(XDR *xdrs; const int len);

	  A macro that invokes the in-line routine associated with the XDR
	  stream, xdrs.	 The routine returns a pointer to a contiguous piece
	  of the stream's buffer; len is the byte length of the	desired
	  buffer.  Note:  pointer is cast to long *.

	  Note:	 xdr_inline may	return NULL (0)	if it cannot allocate a
	  contiguous piece of a	buffer.	 Therefore the behavior	may vary among
	  stream instances; it exists for the sake of efficiency, and
	  applications written for portability should not depend on this
	  feature.

     bool_t
     xdrrec_eof(XDR *xdrs);

	  This routine can be invoked only on streams created by
	  xdrrec_create.  After	consuming the rest of the current record in
	  the stream, this routine returns 1 if	the stream has no more input,
	  0 otherwise.






									Page 1






xdr_admin(3N)							 xdr_admin(3N)



     bool_t
     xdr_setpos(XDR *xdrs, const u_int pos);

	  A macro that invokes the set position	routine	associated with	the
	  XDR stream xdrs.  The	parameter pos is a position value obtained
	  from xdr_getpos.  This routine returns 1 if the XDR stream was
	  repositioned,	and 0 otherwise.

	  Note:	 it is difficult to reposition some types of XDR streams, so
	  this routine may fail	with one type of stream	and succeed with
	  another.  Therefore, applications written for	portability should not
	  depend on this feature.

SEE ALSO    [Toc]    [Back]

     rpc(3N), xdr_complex(3N), xdr_create(3N), xdr_simple(3N)


									PPPPaaaaggggeeee 2222