GNU CommonC++
|
A more natural C++ "unixstream" class for use by non-threaded applications. More...
#include <unix.h>
Public Member Functions | |
unixstream () | |
Construct an unopened "tcpstream" object. | |
unixstream (const char *pathname, int buffer=512) | |
Construct and "open" (connect) the tcp stream to a remote socket. | |
unixstream (UnixSocket &unixsock, int buffer=512) | |
Construct and "accept" (connect) the tcp stream through a server. | |
void | open (const char *pathname, int buffer=512) |
Open a tcp stream connection. | |
void | open (UnixSocket &unixsock, int buffer=512) |
Open a tcp stream connection by accepting a tcp socket. | |
void | close (void) |
Close the active tcp stream connection. | |
bool | operator! () const |
Test to see if stream is open. | |
![]() | |
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. | |
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. | |
void | setTimeout (timeout_t to) |
Set the I/O operation timeout for socket I/O operations. | |
UnixStream (const UnixStream &source) | |
A copy constructor creates a new stream buffer. | |
virtual | ~UnixStream () |
Flush and empty all buffers, and then remove the allocated buffers. | |
int | sync (void) |
Flushes the stream input and output buffers, writes pending output. | |
bool | isPending (Pending pend, timeout_t timeout=TIMEOUT_INF) |
Get the status of pending stream data. | |
int | getBufferSize (void) const |
Return the size of the current stream buffering used. | |
![]() | |
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. | |
Socket & | operator= (const Socket &from) |
Sockets may also be duplicated by the assignment operator. | |
virtual IPV4Host | getIPV4Sender (tpport_t *port=NULL) const |
May be used to examine the origin of data waiting in the socket receive queue. | |
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. | |
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. | |
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. | |
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. | |
Error | setLinger (bool linger) |
Enable lingering sockets on close. | |
Error | setKeepAlive (bool enable) |
Set the keep-alive status of this socket and if keep-alive messages will be sent. | |
Error | setTypeOfService (Tos service) |
Set packet scheduling on platforms which support ip quality of service conventions. | |
bool | isConnected (void) const |
Can test to see if this socket is "connected", and hence whether a "catch" can safely call getPeer(). | |
bool | isActive (void) const |
Test to see if the socket is at least operating or if it is mearly initialized. | |
bool | isBroadcast (void) const |
Return if broadcast has been enabled for the specified socket. | |
bool | isRouted (void) const |
Return if socket routing is enabled. | |
Error | getErrorNumber (void) const |
Often used by a "catch" to fetch the last error of a thrown socket. | |
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. | |
long | getSystemError (void) const |
const char * | getSystemErrorString (void) const |
Additional Inherited Members | |
![]() | |
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 bool | check (Family fam) |
See if a specific protocol family is available in the current runtime environment. | |
![]() | |
enum | State { INITIAL, AVAILABLE, BOUND, CONNECTED, CONNECTING, STREAM } |
typedef enum State | State |
![]() | |
UnixStream (bool throwflag=true) | |
The constructor required for "unixstream", a more C++ style version of the TCPStream class. | |
void | allocate (int size) |
Used to allocate the buffer space needed for iostream operations. | |
void | endStream (void) |
Used to terminate the buffer space and cleanup the socket connection. | |
virtual int | underflow (void) |
This streambuf method is used to load the input buffer through the established unix domain socket connection. | |
int | uflow (void) |
This streambuf method is used for doing unbuffered reads through the established unix domain socket connection when in interactive mode. | |
int | overflow (int ch) |
This streambuf method is used to write the output buffer through the established unix domain connection. | |
void | connect (const char *pathname, int size) |
Create a Unix domain stream by connecting to a Unix domain socket. | |
std::iostream * | unixstr (void) |
Used in derived classes to refer to the current object via it's iostream. | |
![]() | |
timeout_t | timeout |
int | bufsize |
char * | gbuf |
char * | pbuf |
![]() | |
static Mutex | mutex |
A more natural C++ "unixstream" class for use by non-threaded applications.
This class behaves a lot more like fstream and similar classes.
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.
pathname | pathname to socket file |
buffer | size for streaming (optional). |
ost::unixstream::unixstream | ( | UnixSocket & | unixsock, |
int | buffer = 512 |
||
) |
Construct and "accept" (connect) the tcp stream through a server.
unixsock | socket to accept from. |
buffer | size for streaming (optional). |
void ost::unixstream::close | ( | void | ) |
Close the active tcp stream connection.
|
inline |
Open a tcp stream connection.
This will close the currently active connection first.
pathname | pathname to socket file |
buffer | size 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.
unixsock | socket to accept from. |
buffer | size for streaming (optional) |
bool ost::unixstream::operator! | ( | ) | const |
Test to see if stream is open.
Reimplemented from ost::Socket.