NAME

       ixp_pending_write,     ixp_pending_print,     ixp_pending_vprint,     ixp_pending_pushfid,
       ixp_pending_clunk, ixp_pending_flush, ixp_pending_respond, IxpPending

SYNOPSIS

       #include <ixp_srvutil.h>

       void ixp_pending_write(IxpPending *pending, const char *dat, long ndat);

       int ixp_pending_print(IxpPending *pending, const char *fmt, ...);

       int ixp_pending_vprint(IxpPending *pending, const char *fmt, va_list ap);

       void ixp_pending_pushfid(IxpPending *pending, IxpFid *fid);

       bool ixp_pending_clunk(Ixp9Req *req);

       void ixp_pending_flush(Ixp9Req *req);

       void ixp_pending_respond(Ixp9Req *req);

       typedef struct IxpPending       IxpPending;
       struct IxpPending {
               /* Private members */
               ...
       }

DESCRIPTION

       These functions aid in writing virtual files used for broadcasting events or writing  data
       when  it  becomes  available.  When  a  file  to  be  used with these functions is opened,
       ixp_pending_pushfid should be called with its IxpFid(3) as  an  argument.  This  sets  the
       IxpFid's  pending  member to true.  Thereafter, for each file with its pending member set,
       ixp_pending_respond should be called for each TRead request,  ixp_pending_clunk  for  each
       TClunk request, and ixp_pending_flush for each TFlush request.

       ixp_pending_write  queues  the  data in dat of length ndat to be written to each currently
       pending fid in pending. If there is a read request pending for a given fid,  the  data  is
       written immediately. Otherwise, it is written the next time ixp_pending_respond is called.
       Likewise, if there is data queued  when  ixp_pending_respond  is  called,  it  is  written
       immediately, otherwise the request is queued.

       ixp_pending_print  and  ixp_pending_vprint  call  ixp_pending_write after formatting their
       arguments with ixp_vsmprint(3).

       The IxpPending data structure is opaque and should  be  initialized  zeroed  before  using
       these functions for the first time.

RETURN VALUE

       ixp_pending_clunk returns true if pending has any more pending IxpFids.