xdr_admin(3N)                    UNIX System V                    xdr_admin(3N)


NAME
      xdradmin:  xdrgetpos, xdrinline, xdrreceof, xdrsetpos - library
      routines for external data representation

DESCRIPTION
      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
      See rpc(3N) for the definition of the XDR data structure.

      #include <rpc/xdr.h>

      uint
      xdrgetpos(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 *
      xdrinline(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:  xdrinline 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.

      boolt
      xdrreceof(XDR *xdrs);

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





10/89                                                                    Page 1

xdr_admin(3N)                    UNIX System V                    xdr_admin(3N)


      boolt
      xdrsetpos(XDR *xdrs, const uint pos);

            A macro that invokes the set position routine associated with the
            XDR stream xdrs.  The parameter pos is a position value obtained
            from xdrgetpos.  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
      rpc(3N), xdrcomplex(3N), xdrcreate(3N), xdrsimple(3N)







































Page 2                                                                    10/89