xdr_admin(3N)                                                 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 *.

               Warning:  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.



   8/91                                                                 Page 1

   xdr_admin(3N)                                                 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.

               Warning:  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                                                                 8/91