map/das-dn/third_party/nopoll/nopoll_log.c

#include <nopoll.h>
#include <nopoll_private.h>

/** 
 * \defgroup nopoll_log noPoll Log: Console log reporting for noPoll library
 */

/** 
 * \addtogroup nopoll_log
 * @{
 */

/** 
 * @brief Allows to check if the log reporting inside the system is
 * enabled.
 *
 * @return nopoll_true if the log is enabled or nopoll_false
 */
nopoll_bool      nopoll_log_is_enabled (noPollCtx * ctx) 
{
	if (ctx == NULL)
		return nopoll_false;

	/* return current value */
	return ctx->debug_enabled;
}

/** 
 *
 * @brief Allows to get current log configuration, to use colors.
 * 
 * @return nopoll_true if the color log is enabled or nopoll_false
 */
nopoll_bool    nopoll_log_color_is_enabled (noPollCtx * ctx)
{

	if (ctx == NULL)
		return nopoll_false;
	
	/* return current value */
	return ctx->debug_color_enabled;
}

/** 
 * @brief Allows to control how to activate the log reporting to the
 * console from the nopoll core library.
 *
 * @param ctx The context where the operation will take place.
 * 
 * @param value nopoll_true to enable log to console, otherwise nopoll_false is
 * returned.
 */
void     nopoll_log_enable (noPollCtx * ctx, nopoll_bool value)
{
	if (ctx == NULL)
		return;

	/* activate debuging according to the variable */
	ctx->debug_enabled = value;
	return;
}

/** 
 * @brief Allows to control how to activate the colog log reporting to
 * the console from the nopoll core library.
 *
 * @param ctx The context where the operation will take place.
 * 
 * @param value nopoll_true to enable log to console, otherwise nopoll_false is
 * returned.
 */
void     nopoll_log_color_enable (noPollCtx * ctx, nopoll_bool value)
{
	if (ctx == NULL)
		return;

	/* activate color debuging according to the variable */
	ctx->debug_color_enabled = value;
	return;
}

/** 
 * @brief Allows to define a log handler that will receive all logs
 * produced under the provided content.
 *
 * @param ctx The context that is going to be configured.
 *
 * @param handler The handler to be called for each log to be
 * notified. Passing in NULL is allowed to remove any previously
 * configured handler.
 *
 * @param user_data User defined pointer to be passed in into the
 * handler configured along with the log notified.
 */
void            nopoll_log_set_handler (noPollCtx * ctx, noPollLogHandler handler, noPollPtr user_data)
{
	nopoll_return_if_fail (ctx, ctx);

	ctx->log_handler   = handler;
	ctx->log_user_data = user_data;

	return;
}

/** 
 * @internal Allows to drop a log to the console.
 *
 * This function allow to drop a log to the console using the given
 * domain, as an identification of which subsystem have reported the
 * information, and report level. This report level is used to notify
 * the consideration of the log reported.
 * 
 * The function allows to provide a printf like interface to report
 * messages. Here are some examples:
 * 
 * \code
 * // drop a log about current library initialization
 * nopoll_log (ctx, NOPOLL_LEVEL_DEBUG, "library properly initialized status=%d", status);
 * \endcode
 *
 *
 * @param ctx The context where the operation will take place.
 *
 * @param level The level that this message is classificed. 
 * 
 * @param message The message to report. The message to report must be
 * not NULL.
 */
void __nopoll_log (noPollCtx * ctx, const char * function_name, const char * file, int line, noPollDebugLevel level, const char * message, ...)
{

#ifdef SHOW_DEBUG_LOG
	va_list      args;
	char       * log_msg;
	char       * log_msg2;

	if (ctx && ctx->log_handler) {
		/* print the message */
		va_start (args, message);
		log_msg = nopoll_strdup_printfv (message, args);
		va_end (args);

		log_msg2 = log_msg;
		log_msg = nopoll_strdup_printf ("%s:%d %s ", file, line, log_msg);
		nopoll_free (log_msg2);

		ctx->log_handler (ctx, level, log_msg, ctx->log_user_data);
		nopoll_free (log_msg);
		return;
	}

	/* check if the log is enabled */
	if (! nopoll_log_is_enabled (ctx))
		return;

	/* printout the process pid */
	if (nopoll_log_color_is_enabled (ctx)) 
		printf ("\e[1;36m(proc %d)\e[0m: ", getpid ());
	else
		printf ("(proc %d): ", getpid ());

	/* drop a log according to the level */
	if (nopoll_log_color_is_enabled (ctx)) {
		switch (level) {
		case NOPOLL_LEVEL_DEBUG:
			printf ("(\e[1;32mdebug\e[0m) ");
			break;
		case NOPOLL_LEVEL_WARNING:
			printf ("(\e[1;33mwarning\e[0m) ");
			break;
		case NOPOLL_LEVEL_CRITICAL:
			printf ("(\e[1;31mcritical\e[0m) ");
			break;
		}
	} else {
		switch (level) {
		case NOPOLL_LEVEL_DEBUG:
			printf ("(debug)");
			break;
		case NOPOLL_LEVEL_WARNING:
			printf ("(warning)");
			break;
		case NOPOLL_LEVEL_CRITICAL:
			printf ("(critical) ");
			break;
		}
	}

	/* drop a log according to the domain */
	printf ("%s:%d ", file, line);

	/* print the message */
	va_start (args, message);
	vprintf (message, args);
	va_end (args);

	printf ("\n");

	/* ensure that the log is droped to the console */
	fflush (stdout);
#endif

	/* return */
	return;
}

/* @} */