Rudiments
|
Public Member Functions | |
serviceentry () | |
serviceentry (const serviceentry &s) | |
serviceentry & | operator= (const serviceentry &s) |
~serviceentry () | |
bool | initialize (const char *servicename, const char *protocol) |
bool | initialize (int32_t port, const char *protocol) |
const char * | getName () const |
int32_t | getPort () const |
const char * | getProtocol () const |
const char *const * | getAliasList () const |
Static Public Member Functions | |
static int32_t | getPort (const char *servicename, const char *protocol) |
static char * | getName (int32_t port, const char *protocol) |
static bool | needsMutex () |
static void | setMutex (threadmutex *mtx) |
The serviceentry class provides methods for retrieving entries from the service file (/etc/services on unix).
serviceentry::serviceentry | ( | ) |
Creates an instance of the serviceentry class.
serviceentry::serviceentry | ( | const serviceentry & | s | ) |
Creates an instance of the serviceentry class that is a copy of "s".
serviceentry::~serviceentry | ( | ) |
Deletes this instance of the serviceentry class.
const char* const* serviceentry::getAliasList | ( | ) | const |
Returns a NULL-terminated list of aliases for the service entry.
const char* serviceentry::getName | ( | ) | const |
Returns the name of the service entry.
|
static |
Convenience method. Sets "name" to the name of the service that a server listening on "port", using "protocol" (tcp, udp, etc.) would be serving. Note that "name" is allocated internally and returned. The calling program must free the buffer.
Note that the return value is allocated internally and returned. The calling program must free the buffer.
Returns NULL if an error occurred or one of the paramters was invalid.
int32_t serviceentry::getPort | ( | ) | const |
Returns the port that a server for this service entry would listen on.
|
static |
Convenience method. Returns the port that the server for "servicename" using "protocol" (tcp, udp, etc.) would listen on.
Returns -1 if an error occurred or one of the paramters was invalid.
const char* serviceentry::getProtocol | ( | ) | const |
Returns the protocol (tcp, udp, etc.) for this service entry.
bool serviceentry::initialize | ( | const char * | servicename, |
const char * | protocol | ||
) |
Looks up a service entry by "servicename" and "protocol" (tcp, udp, etc.). Returns true on success and false on failure.
bool serviceentry::initialize | ( | int32_t | port, |
const char * | protocol | ||
) |
Looks up a service entry by the "port" that a server for would listen on and the "protocol" that it would use (tcp, udp, etc.). Returns true on success and false on failure.
|
static |
Returns true if this class needs a mutex to operate safely in a threaded environment and false otherwise.
serviceentry& serviceentry::operator= | ( | const serviceentry & | s | ) |
Makes this instance of the serviceentry class identical to "s".
|
static |
Allows you to supply a mutex is the class needs it. (see needsMutex()). If your application is not multithreaded, then there is no need to supply a mutex.