rpcstream - iostreamb specialized to RPC requests

SYNOPSIS

       #include <Dispatch/rpcstream.h>

DESCRIPTION

       rpcstream, irpcstream, and orpcstream specialize iostream,
       istream, and ostream, respectively, to RPC requests.  That
       is,  the  associated streambuf will be an rpcbuf.  Conver-
       sions will be formatted (that is, ASCII)  so  datums  will
       need to be separated by space characters.

CONSTRUCTORS

       rpcstream()
              Construct an unopened rpcstream.

PUBLIC OPERATIONS

       void listen(int port)
       void connect(const char* host, int port)
              Create a connection.  Any failure sets ios::failbit
              in the error state.

       int accept()
              Accept a pending connection and return the new file
              descriptor.

       void attach(int fd)
              Attach to a pre-existing connection.

       void close()
              Break  a  connection.   The  error state is cleared
              except on failure.

       void nonblocking(boolean)
       void verbose(boolean)
              Enable or disable non-blocking I/O and/or  printing
              of error messages.

       rpcbuf* rdbuf()
              Return  a pointer to the rpcbuf created by the rpc-
              stream.

       boolean incomplete_request()
       void incomplete_request(boolean)
              Get or set a flag.  Used  by  the  operations  that
              insert  an  RpcHdr  into an rpcstream or extract an
              RpcHdr from an rpcstream.

SEE ALSO

       IOS.INTRO(3C++), iostreamb(3I), rpcbuf(3I)