Inherits socketclient, and unixsocketutil.
Public Member Functions | |
| unixsocketclient () | |
| unixsocketclient (const unixsocketclient &u) | |
| unixsocketclient & | operator= (const unixsocketclient &u) |
| virtual | ~unixsocketclient () |
| int32_t | connect (const char *filename, int32_t timeoutsec, int32_t timeoutusec, uint32_t retrywait, uint32_t tries) |
| void | initialize (constnamevaluepairs *cd) |
| void | initialize (const char *filename, int32_t timeoutsec, int32_t timeoutusec, uint32_t retrywait, uint32_t tries) |
| int32_t | connect () |
| bool | close () |
 Public Member Functions inherited from socketclient | |
| socketclient () | |
| socketclient (const socketclient &c) | |
| socketclient & | operator= (const socketclient &c) |
| virtual | ~socketclient () |
| virtual bool | supportsBlockingNonBlockingModes () |
| virtual bool | useNonBlockingMode () const |
| virtual bool | useBlockingMode () const |
| virtual bool | isUsingNonBlockingMode () const |
| virtual int32_t | ioCtl (int32_t command, void *arg) const |
| Public Member Functions inherited from client | |
| client () | |
| client (const client &c) | |
| client & | operator= (const client &c) |
| virtual | ~client () |
| virtual const char * | getVerboseConnectError () |
| virtual void | setVerboseConnectError (const char *error) |
| Public Member Functions inherited from filedescriptor | |
| filedescriptor () | |
| filedescriptor (const filedescriptor &f) | |
| filedescriptor & | operator= (const filedescriptor &f) |
| virtual | ~filedescriptor () |
| int32_t | getFileDescriptor () const |
| void | setFileDescriptor (int32_t filedesc) |
| int32_t | duplicate () const |
| bool | duplicate (int32_t newfd) const |
| void | setSecurityContext (securitycontext *ctx) |
| securitycontext * | getSecurityContext () |
| ssize_t | write (uint16_t number) |
| ssize_t | write (uint32_t number) |
| ssize_t | write (uint64_t number) |
| ssize_t | write (int16_t number) |
| ssize_t | write (int32_t number) |
| ssize_t | write (int64_t number) |
| ssize_t | write (float number) |
| ssize_t | write (double number) |
| ssize_t | write (unsigned char character) |
| ssize_t | write (char character) |
| ssize_t | write (bool value) |
| ssize_t | write (const unsigned char *string) |
| ssize_t | write (const char *string) |
| ssize_t | write (const unsigned char *string, size_t size) |
| ssize_t | write (const char *string, size_t length) |
| ssize_t | write (const void *buffer, size_t size) |
| ssize_t | write (uint16_t number, int32_t sec, int32_t usec) |
| ssize_t | write (uint32_t number, int32_t sec, int32_t usec) |
| ssize_t | write (uint64_t number, int32_t sec, int32_t usec) |
| ssize_t | write (int16_t number, int32_t sec, int32_t usec) |
| ssize_t | write (int32_t number, int32_t sec, int32_t usec) |
| ssize_t | write (int64_t number, int32_t sec, int32_t usec) |
| ssize_t | write (float number, int32_t sec, int32_t usec) |
| ssize_t | write (double number, int32_t sec, int32_t usec) |
| ssize_t | write (unsigned char character, int32_t sec, int32_t usec) |
| ssize_t | write (char character, int32_t sec, int32_t usec) |
| ssize_t | write (bool value, int32_t sec, int32_t usec) |
| ssize_t | write (const unsigned char *string, int32_t sec, int32_t usec) |
| ssize_t | write (const char *string, int32_t sec, int32_t usec) |
| ssize_t | write (const unsigned char *string, size_t size, int32_t sec, int32_t usec) |
| ssize_t | write (const char *string, size_t size, int32_t sec, int32_t usec) |
| ssize_t | write (const void *buffer, size_t size, int32_t sec, int32_t usec) |
| size_t | printf (const char *format,...) |
| size_t | printf (const char *format, va_list *argp) |
| void | safePrint (unsigned char c) |
| void | safePrint (const unsigned char *str) |
| void | safePrint (const unsigned char *str, int32_t length) |
| void | safePrint (char c) |
| void | safePrint (const char *str) |
| void | safePrint (const char *str, int32_t length) |
| void | printBits (unsigned char value) |
| void | printBits (uint16_t value) |
| void | printBits (uint32_t value) |
| void | printBits (uint64_t value) |
| void | printBits (char value) |
| void | printBits (int16_t value) |
| void | printBits (int32_t value) |
| void | printBits (int64_t value) |
| void | printBits (const unsigned char *bits, uint64_t size) |
| ssize_t | read (uint16_t *buffer) |
| ssize_t | read (uint32_t *buffer) |
| ssize_t | read (uint64_t *buffer) |
| ssize_t | read (int16_t *buffer) |
| ssize_t | read (int32_t *buffer) |
| ssize_t | read (int64_t *buffer) |
| ssize_t | read (float *buffer) |
| ssize_t | read (double *buffer) |
| ssize_t | read (unsigned char *buffer) |
| ssize_t | read (char *buffer) |
| ssize_t | read (bool *buffer) |
| ssize_t | read (unsigned char *buffer, size_t size) |
| ssize_t | read (char *buffer, size_t length) |
| ssize_t | read (void *buf, size_t size) |
| ssize_t | read (char **buffer, const char *terminator) |
| ssize_t | read (char **buffer, const char *terminator, size_t maxbytes) |
| ssize_t | read (uint16_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (uint32_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (uint64_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (int16_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (int32_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (int64_t *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (float *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (double *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (unsigned char *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (char *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (bool *buffer, int32_t sec, int32_t usec) |
| ssize_t | read (unsigned char *buffer, size_t size, int32_t sec, int32_t usec) |
| ssize_t | read (char *buffer, size_t size, int32_t sec, int32_t usec) |
| ssize_t | read (void *buf, size_t size, int32_t sec, int32_t usec) |
| ssize_t | read (char **buffer, const char *terminator, int32_t sec, int32_t usec) |
| ssize_t | read (char **buffer, const char *terminator, size_t maxbytes, int32_t sec, int32_t usec) |
| ssize_t | read (char **buffer, const char *terminator, size_t maxbytes, char escapechar, int32_t sec, int32_t usec) |
| int32_t | waitForNonBlockingRead (int32_t sec, int32_t usec) const |
| int32_t | waitForNonBlockingWrite (int32_t sec, int32_t usec) const |
| void | retryInterruptedReads () |
| void | dontRetryInterruptedReads () |
| bool | getRetryInterruptedReads () const |
| void | retryInterruptedWrites () |
| void | dontRetryInterruptedWrites () |
| bool | getRetryInterruptedWrites () const |
| void | retryInterruptedWaits () |
| void | dontRetryInterruptedWaits () |
| bool | getRetryInterruptedWaits () const |
| void | retryInterruptedFcntl () |
| void | dontRetryInterruptedFcntl () |
| bool | getRetryInterruptedFcntl () const |
| void | retryInterruptedIoctl () |
| void | dontRetryInterruptedIoctl () |
| bool | getRetryInterruptedIoctl () const |
| void | allowShortReads () |
| void | dontAllowShortReads () |
| void | allowShortWrites () |
| void | dontAllowShortWrites () |
| virtual bool | passFileDescriptor (int32_t fd) |
| virtual bool | receiveFileDescriptor (int32_t *fd) |
| virtual bool | passSocket (int32_t sock) |
| virtual bool | receiveSocket (int32_t *sock) |
| void | translateByteOrder () |
| void | dontTranslateByteOrder () |
| virtual int32_t | fCntl (int32_t command, long arg) const |
| bool | useNaglesAlgorithm () |
| bool | dontUseNaglesAlgorithm () |
| bool | setSocketWriteBufferSize (int32_t size) |
| bool | getSocketWriteBufferSize (int32_t *size) |
| bool | setSocketReadBufferSize (int32_t size) |
| bool | getSocketReadBufferSize (int32_t *size) |
| bool | disableIPv4 () |
| bool | enableIPv4 () |
| const char * | getType () const |
| char * | getPeerAddress () const |
| bool | setWriteBufferSize (ssize_t size) const |
| bool | flushWriteBuffer (int32_t sec, int32_t usec) |
| bool | setReadBufferSize (ssize_t size) const |
| bool | closeOnExec () |
| bool | dontCloseOnExec () |
| bool | getCloseOnExec () |
Additional Inherited Members | |
| Static Public Member Functions inherited from filedescriptor | |
| static bool | createPipe (filedescriptor *readfd, filedescriptor *writefd) |
| static uint16_t | hostToNet (uint16_t value) |
| static uint32_t | hostToNet (uint32_t value) |
| static uint64_t | hostToNet (uint64_t value) |
| static uint16_t | netToHost (uint16_t value) |
| static uint32_t | netToHost (uint32_t value) |
| static uint64_t | netToHost (uint64_t value) |
| static uint16_t | hostToLittleEndian (uint16_t value) |
| static uint32_t | hostToLittleEndian (uint32_t value) |
| static uint64_t | hostToLittleEndian (uint64_t value) |
| static uint16_t | littleEndianToHost (uint16_t value) |
| static uint32_t | littleEndianToHost (uint32_t value) |
| static uint64_t | littleEndianToHost (uint64_t value) |
Detailed Description
The unixsocketclient class allows you to write programs that can talk to other programs on the same machine over TCP stream sockets.
Inet sockets (see the inetsocketclient class) can be used by clients and servers on the same machine as well, but Unix sockets generally perform better.
Some platforms (line Windows) don't support Unix sockets. For those platforms, Unix sockets are simulated using Inet sockets on localhost by translating the socket filename to a port. See unixsocketutil::filenameToPort() for details.
The unixsocketclient class provides methods for connecting to servers. Its ultimate parent class: filedescriptor provides methods for reading and writing data and closing connections.
Constructor & Destructor Documentation
◆ unixsocketclient() [1/2]
| unixsocketclient::unixsocketclient | ( | ) |
Creates an instance of the unixsocketclient class.
◆ unixsocketclient() [2/2]
| unixsocketclient::unixsocketclient | ( | const unixsocketclient & | u | ) |
Creates an instance of the unixsocketclient class. that is a copy of "u".
◆ ~unixsocketclient()
|
virtual |
Deletes this instance of unixsocketclient.
Member Function Documentation
◆ close()
|
virtual |
Closes the socket. Returns true on success and false on failure.
Reimplemented from filedescriptor.
◆ connect()
|
virtual |
Attempts to connect to the "filename" set earlier. If the connection fails, it will retry, for a total of "tries" attempts, waiting "retrywait" seconds between each attempt.
Setting "tries" to 0 will cause it to try to connect indefinitely. Setting "retrywait" to 0 will cause it to try to connect over and over as fast as possible (not recommended).
Each attempt to connect will wait "timeoutsec" seconds and "timeoutusec" microseconds for the connect to succeed. Specifying -1 for either parameter will cause the attempt to wait until the underlying protocol times out which may be up to 2 minutes.
Returns RESULT_SUCCESS on success and RESULT_ERROR on failure.
Reimplemented from client.
◆ initialize() [1/2]
| void unixsocketclient::initialize | ( | const char * | filename, |
| int32_t | timeoutsec, | ||
| int32_t | timeoutusec, | ||
| uint32_t | retrywait, | ||
| uint32_t | tries | ||
| ) |
Initializes the class to use "filename", "timeoutsec", "timeoutusec", "retrywait" and "tries" when connect() is called.
◆ initialize() [2/2]
|
virtual |
◆ operator=()
| unixsocketclient& unixsocketclient::operator= | ( | const unixsocketclient & | u | ) |
Makes this instance of the unixsocketclient class identical to "u".
