GNU CommonC++
Public Member Functions | List of all members
ost::unixstream Class Reference

A more natural C++ "unixstream" class for use by non-threaded applications. More...

#include <unix.h>

Inheritance diagram for ost::unixstream:
ost::UnixStream ost::Socket

Public Member Functions

 unixstream ()
 Construct an unopened "tcpstream" object. More...
 
 unixstream (const char *pathname, int buffer=512)
 Construct and "open" (connect) the tcp stream to a remote socket. More...
 
 unixstream (UnixSocket &unixsock, int buffer=512)
 Construct and "accept" (connect) the tcp stream through a server. More...
 
void open (const char *pathname, int buffer=512)
 Open a tcp stream connection. More...
 
void open (UnixSocket &unixsock, int buffer=512)
 Open a tcp stream connection by accepting a tcp socket. More...
 
void close (void)
 Close the active tcp stream connection. More...
 
bool operator! () const
 Test to see if stream is open. More...
 
- Public Member Functions inherited from ost::UnixStream
 UnixStream (UnixSocket &server, int size=512, bool throwflag=true, timeout_t timeout=0)
 Create a Unix domain stream by accepting a connection from a bound Unix domain socket acting as a server. More...
 
 UnixStream (const char *pathname, int size=512, bool throwflag=true, timeout_t to=0)
 Create a Unix domain stream by connecting to a Unix domain socket. More...
 
void setTimeout (timeout_t to)
 Set the I/O operation timeout for socket I/O operations. More...
 
 UnixStream (const UnixStream &source)
 A copy constructor creates a new stream buffer. More...
 
virtual ~UnixStream ()
 Flush and empty all buffers, and then remove the allocated buffers. More...
 
int sync (void)
 Flushes the stream input and output buffers, writes pending output. More...
 
bool isPending (Pending pend, timeout_t timeout=TIMEOUT_INF)
 Get the status of pending stream data. More...
 
int getBufferSize (void) const
 Return the size of the current stream buffering used. More...
 
- Public Member Functions inherited from ost::Socket
virtual ~Socket ()
 The socket base class may be "thrown" as a result of an error, and the "catcher" may then choose to destroy the object. More...
 
Socketoperator= (const Socket &from)
 Sockets may also be duplicated by the assignment operator. More...
 
virtual IPV4Host getIPV4Sender (tpport_t *port=NULL) const
 May be used to examine the origin of data waiting in the socket receive queue. More...
 
IPV4Host getSender (tpport_t *port=NULL) const
 
virtual IPV6Host getIPV6Sender (tpport_t *port=NULL) const
 
IPV4Host getIPV4Peer (tpport_t *port=NULL) const
 Get the host address and port of the socket this socket is connected to. More...
 
IPV4Host getPeer (tpport_t *port=NULL) const
 
IPV6Host getIPV6Peer (tpport_t *port=NULL) const
 
IPV4Host getIPV4Local (tpport_t *port=NULL) const
 Get the local address and port number this socket is currently bound to. More...
 
IPV4Host getLocal (tpport_t *port=NULL) const
 
IPV6Host getIPV6Local (tpport_t *port=NULL) const
 
IPV4Host getIPV4NAT (tpport_t *port=NULL) const
 Perform NAT table lookup for this socket. More...
 
IPV4Host getNAT (tpport_t *port) const
 
IPV6Host getIPV6NAT (tpport_t *port=NULL) const
 
void setCompletion (bool immediate)
 Used to specify blocking mode for the socket. More...
 
Error setLinger (bool linger)
 Enable lingering sockets on close. More...
 
Error setKeepAlive (bool enable)
 Set the keep-alive status of this socket and if keep-alive messages will be sent. More...
 
Error setTypeOfService (Tos service)
 Set packet scheduling on platforms which support ip quality of service conventions. More...
 
bool isConnected (void) const
 Can test to see if this socket is "connected", and hence whether a "catch" can safely call getPeer(). More...
 
bool isActive (void) const
 Test to see if the socket is at least operating or if it is mearly initialized. More...
 
bool operator! () const
 Operator based testing to see if a socket is currently active. More...
 
bool isBroadcast (void) const
 Return if broadcast has been enabled for the specified socket. More...
 
bool isRouted (void) const
 Return if socket routing is enabled. More...
 
Error getErrorNumber (void) const
 Often used by a "catch" to fetch the last error of a thrown socket. More...
 
const char * getErrorString (void) const
 Often used by a "catch" to fetch the user set error string of a thrown socket, but only if EXTENDED error codes are used. More...
 
long getSystemError (void) const
 
const char * getSystemErrorString (void) const
 

Additional Inherited Members

- Public Types inherited from ost::Socket
enum  Family { IPV6 = AF_INET6, IPV4 = AF_INET }
 
enum  Error {
  errSuccess = 0, errCreateFailed, errCopyFailed, errInput,
  errInputInterrupt, errResourceFailure, errOutput, errOutputInterrupt,
  errNotConnected, errConnectRefused, errConnectRejected, errConnectTimeout,
  errConnectFailed, errConnectInvalid, errConnectBusy, errConnectNoRoute,
  errBindingFailed, errBroadcastDenied, errRoutingDenied, errKeepaliveDenied,
  errServiceDenied, errServiceUnavailable, errMulticastDisabled, errTimeout,
  errNoDelay, errExtended, errLookupFail, errSearchErr,
  errInvalidValue
}
 
enum  Tos {
  tosLowDelay = 0, tosThroughput, tosReliability, tosMinCost,
  tosInvalid
}
 
enum  Pending { pendingInput, pendingOutput, pendingError }
 
typedef enum Family Family
 
typedef enum Error Error
 
typedef enum Tos Tos
 
typedef enum Pending Pending
 
- Static Public Member Functions inherited from ost::Socket
static bool check (Family fam)
 See if a specific protocol family is available in the current runtime environment. More...
 
- Protected Types inherited from ost::Socket
enum  State {
  INITIAL, AVAILABLE, BOUND, CONNECTED,
  CONNECTING, STREAM
}
 
typedef enum State State
 
- Protected Member Functions inherited from ost::UnixStream
 UnixStream (bool throwflag=true)
 The constructor required for "unixstream", a more C++ style version of the TCPStream class. More...
 
void allocate (int size)
 Used to allocate the buffer space needed for iostream operations. More...
 
void endStream (void)
 Used to terminate the buffer space and cleanup the socket connection. More...
 
virtual int underflow (void)
 This streambuf method is used to load the input buffer through the established unix domain socket connection. More...
 
int uflow (void)
 This streambuf method is used for doing unbuffered reads through the established unix domain socket connection when in interactive mode. More...
 
int overflow (int ch)
 This streambuf method is used to write the output buffer through the established unix domain connection. More...
 
void connect (const char *pathname, int size)
 Create a Unix domain stream by connecting to a Unix domain socket. More...
 
std::iostream * unixstr (void)
 Used in derived classes to refer to the current object via it's iostream. More...
 
- Protected Attributes inherited from ost::UnixStream
timeout_t timeout
 
int bufsize
 
char * gbuf
 
char * pbuf
 
- Static Protected Attributes inherited from ost::Socket
static Mutex mutex
 

Detailed Description

A more natural C++ "unixstream" class for use by non-threaded applications.

This class behaves a lot more like fstream and similar classes.

Author
Alex Pavloff alex@.nosp@m.pavl.nosp@m.off.n.nosp@m.et C++ "fstream" style unixstream class.

Constructor & Destructor Documentation

ost::unixstream::unixstream ( )

Construct an unopened "tcpstream" object.

ost::unixstream::unixstream ( const char *  pathname,
int  buffer = 512 
)

Construct and "open" (connect) the tcp stream to a remote socket.

Parameters
pathnamepathname to socket file
buffersize for streaming (optional).
ost::unixstream::unixstream ( UnixSocket unixsock,
int  buffer = 512 
)

Construct and "accept" (connect) the tcp stream through a server.

Parameters
unixsocksocket to accept from.
buffersize for streaming (optional).

Member Function Documentation

void ost::unixstream::close ( void  )

Close the active tcp stream connection.

void ost::unixstream::open ( const char *  pathname,
int  buffer = 512 
)
inline

Open a tcp stream connection.

This will close the currently active connection first.

Parameters
pathnamepathname to socket file
buffersize for streaming (optional)

References ost::UnixStream::connect().

void ost::unixstream::open ( UnixSocket unixsock,
int  buffer = 512 
)

Open a tcp stream connection by accepting a tcp socket.

Parameters
unixsocksocket to accept from.
buffersize for streaming (optional)
bool ost::unixstream::operator! ( ) const

Test to see if stream is open.


The documentation for this class was generated from the following file: