|
Strophe
0.9
XMPP client library
|
Runtime contexts, library initialization and shutdown, and versioning. More...
Macros | |
| #define | LIBXMPP_VERSION_MAJOR (0) |
| The major version number of Strophe. More... | |
| #define | LIBXMPP_VERSION_MINOR (0) |
| The minor version number of Strophe. More... | |
Functions | |
| void | xmpp_initialize (void) |
| Initialize the Strophe library. More... | |
| void | xmpp_shutdown (void) |
| Shutdown the Strophe library. More... | |
| int | xmpp_version_check (int major, int minor) |
| Check that Strophe supports a specific API version. More... | |
| static void * | _malloc (const size_t size, void *const userdata) |
| static void | _free (void *p, void *const userdata) |
| static void * | _realloc (void *p, const size_t size, void *const userdata) |
| static void | xmpp_default_logger (void *const userdata, const xmpp_log_level_t level, const char *const area, const char *const msg) |
| Log a message. More... | |
| xmpp_log_t * | xmpp_get_default_logger (xmpp_log_level_t level) |
| Get a default logger with filtering. More... | |
| void * | xmpp_alloc (const xmpp_ctx_t *const ctx, const size_t size) |
| Allocate memory in a Strophe context. More... | |
| void | xmpp_free (const xmpp_ctx_t *const ctx, void *p) |
| Free memory in a Strophe context. More... | |
| void * | xmpp_realloc (const xmpp_ctx_t *const ctx, void *p, const size_t size) |
| Reallocate memory in a Strophe context. More... | |
| void | xmpp_log (const xmpp_ctx_t *const ctx, const xmpp_log_level_t level, const char *const area, const char *const fmt, va_list ap) |
| Write a log message to the logger. More... | |
| void | xmpp_error (const xmpp_ctx_t *const ctx, const char *const area, const char *const fmt,...) |
| Write to the log at the ERROR level. More... | |
| void | xmpp_warn (const xmpp_ctx_t *const ctx, const char *const area, const char *const fmt,...) |
| Write to the log at the WARN level. More... | |
| void | xmpp_info (const xmpp_ctx_t *const ctx, const char *const area, const char *const fmt,...) |
| Write to the log at the INFO level. More... | |
| void | xmpp_debug (const xmpp_ctx_t *const ctx, const char *const area, const char *const fmt,...) |
| Write to the log at the DEBUG level. More... | |
| xmpp_ctx_t * | xmpp_ctx_new (const xmpp_mem_t *const mem, const xmpp_log_t *const log) |
| Create and initialize a Strophe context object. More... | |
| void | xmpp_ctx_free (xmpp_ctx_t *const ctx) |
| Free a Strophe context object that is no longer in use. More... | |
Variables | |
| static xmpp_mem_t | xmpp_default_mem |
| static const char *const | _xmpp_log_level_name [4] = {"DEBUG", "INFO", "WARN", "ERROR"} |
| static const xmpp_log_level_t | _xmpp_default_logger_levels [] |
| static const xmpp_log_t | _xmpp_default_loggers [] |
| static xmpp_log_t | xmpp_default_log = { NULL, NULL } |
Runtime contexts, library initialization and shutdown, and versioning.
| #define LIBXMPP_VERSION_MAJOR (0) |
The major version number of Strophe.
| #define LIBXMPP_VERSION_MINOR (0) |
The minor version number of Strophe.
|
static |
|
static |
|
static |
|
static |
Log a message.
The default logger writes to stderr.
| userdata | the opaque data used by the default logger. This contains the filter level in the default logger. |
| level | the level to log at |
| area | the area the log message is for |
| msg | the log message |
| void* xmpp_alloc | ( | const xmpp_ctx_t *const | ctx, |
| const size_t | size | ||
| ) |
Allocate memory in a Strophe context.
All Strophe functions will use this to allocate memory.
| ctx | a Strophe context object |
| size | the number of bytes to allocate |
| void xmpp_free | ( | const xmpp_ctx_t *const | ctx, |
| void * | p | ||
| ) |
Free memory in a Strophe context.
All Strophe functions will use this to free allocated memory.
| ctx | a Strophe context object |
| p | a pointer referencing memory to be freed |
| void* xmpp_realloc | ( | const xmpp_ctx_t *const | ctx, |
| void * | p, | ||
| const size_t | size | ||
| ) |
Reallocate memory in a Strophe context.
All Strophe functions will use this to reallocate memory.
| ctx | a Strophe context object |
| p | a pointer to previously allocated memory |
| size | the new size in bytes to allocate |
| void xmpp_log | ( | const xmpp_ctx_t *const | ctx, |
| const xmpp_log_level_t | level, | ||
| const char *const | area, | ||
| const char *const | fmt, | ||
| va_list | ap | ||
| ) |
Write a log message to the logger.
Write a log message to the logger for the context for the specified level and area. This function takes a printf-style format string and a variable argument list (in va_list) format. This function is not meant to be called directly, but is used via xmpp_error, xmpp_warn, xmpp_info, and xmpp_debug.
| ctx | a Strophe context object |
| level | the level at which to log |
| area | the area to log for |
| fmt | a printf-style format string for the message |
| ap | variable argument list supplied for the format string |
| void xmpp_error | ( | const xmpp_ctx_t *const | ctx, |
| const char *const | area, | ||
| const char *const | fmt, | ||
| ... | |||
| ) |
Write to the log at the ERROR level.
This is a convenience function for writing to the log at the ERROR level. It takes a printf-style format string followed by a variable list of arguments for formatting.
| ctx | a Strophe context object |
| area | the area to log for |
| fmt | a printf-style format string followed by a variable list of arguments to format |
| void xmpp_warn | ( | const xmpp_ctx_t *const | ctx, |
| const char *const | area, | ||
| const char *const | fmt, | ||
| ... | |||
| ) |
Write to the log at the WARN level.
This is a convenience function for writing to the log at the WARN level. It takes a printf-style format string followed by a variable list of arguments for formatting.
| ctx | a Strophe context object |
| area | the area to log for |
| fmt | a printf-style format string followed by a variable list of arguments to format |
| void xmpp_info | ( | const xmpp_ctx_t *const | ctx, |
| const char *const | area, | ||
| const char *const | fmt, | ||
| ... | |||
| ) |
Write to the log at the INFO level.
This is a convenience function for writing to the log at the INFO level. It takes a printf-style format string followed by a variable list of arguments for formatting.
| ctx | a Strophe context object |
| area | the area to log for |
| fmt | a printf-style format string followed by a variable list of arguments to format |
| void xmpp_debug | ( | const xmpp_ctx_t *const | ctx, |
| const char *const | area, | ||
| const char *const | fmt, | ||
| ... | |||
| ) |
Write to the log at the DEBUG level.
This is a convenience function for writing to the log at the DEBUG level. It takes a printf-style format string followed by a variable list of arguments for formatting.
| ctx | a Strophe context object |
| area | the area to log for |
| fmt | a printf-style format string followed by a variable list of arguments to format |
|
static |
|
static |
|
static |
|
static |
|
static |