libjaylink/log.c

   1 /*
   2  * This file is part of the libjaylink project.
   3  *
   4  * Copyright (C) 2014-2015 Marc Schink <jaylink-dev@marcschink.de>
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include <stdio.h>
  21 #include <stdarg.h>
  22
  23 #include "libjaylink.h"
  24 #include "libjaylink-internal.h"
  25
  26 /**
  27  * @file
  28  *
  29  * Logging functions.
  30  */
  31
  32 /**
  33  * Set the libjaylink log level.
  34  *
  35  * @param[in,out] ctx libjaylink context.
  36  * @param[in] level Log level to set. See #jaylink_log_level for valid values.
  37  *
  38  * @retval JAYLINK_OK Success.
  39  * @retval JAYLINK_ERR_ARG Invalid arguments.
  40  */
  41 JAYLINK_API int jaylink_log_set_level(struct jaylink_context *ctx, int level)
  42 {
  43         if (!ctx)
  44                 return JAYLINK_ERR_ARG;
  45
  46         if (level < JAYLINK_LOG_LEVEL_NONE || level > JAYLINK_LOG_LEVEL_DEBUG)
  47                 return JAYLINK_ERR_ARG;
  48
  49         ctx->log_level = level;
  50
  51         return JAYLINK_OK;
  52 }
  53
  54 /**
  55  * Get the libjaylink log level.
  56  *
  57  * @param[in] ctx libjaylink context.
  58  *
  59  * @return The current log level on success, or a negative error code
  60  *         on failure. See #jaylink_log_level for a description of each
  61  *         individual log level.
  62  */
  63 JAYLINK_API int jaylink_log_get_level(const struct jaylink_context *ctx)
  64 {
  65         if (!ctx)
  66                 return JAYLINK_ERR_ARG;
  67
  68         return ctx->log_level;
  69 }
  70
  71 /** @private */
  72 static void log_vprintf(struct jaylink_context *ctx, int level,
  73                 const char *format, va_list args)
  74 {
  75         /*
  76          * Filter out messages with higher verbosity than the verbosity of the
  77          * current log level.
  78          */
  79         if (level > ctx->log_level)
  80                 return;
  81
  82         fprintf(stderr, "jaylink: ");
  83         vfprintf(stderr, format, args);
  84         fprintf(stderr, "\n");
  85 }
  86
  87 /** @private */
  88 JAYLINK_PRIV void log_err(struct jaylink_context *ctx, const char *format, ...)
  89 {
  90         va_list args;
  91
  92         if (!ctx)
  93                 return;
  94
  95         va_start(args, format);
  96         log_vprintf(ctx, JAYLINK_LOG_LEVEL_ERROR, format, args);
  97         va_end(args);
  98 }
  99
 100 /** @private */
 101 JAYLINK_PRIV void log_warn(struct jaylink_context *ctx, const char *format, ...)
 102 {
 103         va_list args;
 104
 105         if (!ctx)
 106                 return;
 107
 108         va_start(args, format);
 109         log_vprintf(ctx, JAYLINK_LOG_LEVEL_WARNING, format, args);
 110         va_end(args);
 111 }
 112
 113 /** @private */
 114 JAYLINK_PRIV void log_info(struct jaylink_context *ctx, const char *format, ...)
 115 {
 116         va_list args;
 117
 118         if (!ctx)
 119                 return;
 120
 121         va_start(args, format);
 122         log_vprintf(ctx, JAYLINK_LOG_LEVEL_INFO, format, args);
 123         va_end(args);
 124 }
 125
 126 /** @private */
 127 JAYLINK_PRIV void log_dbg(struct jaylink_context *ctx, const char *format, ...)
 128 {
 129         va_list args;
 130
 131         if (!ctx)
 132                 return;
 133
 134         va_start(args, format);
 135         log_vprintf(ctx, JAYLINK_LOG_LEVEL_DEBUG, format, args);
 136         va_end(args);
 137 }