libvirt/src/logging.h

/*
 * logging.h: internal logging and debugging
 *
 * Copyright (C) 2006-2008 Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
 *
 */

#ifndef __VIRTLOG_H_
#define __VIRTLOG_H_

#include "internal.h"

/*
 * If configured with --enable-debug=yes then library calls
 * are printed to stderr for debugging or to an appropriate channel
 * defined at runtime of from the libvirt daemon configuration file
 */
#ifdef ENABLE_DEBUG
#define VIR_DEBUG(category, fmt,...)                                    \
    virLogMessage(category, VIR_LOG_DEBUG, 0, fmt, __VA_ARGS__)
#define VIR_INFO(category, fmt,...)                                    \
    virLogMessage(category, VIR_LOG_INFO, 0, fmt, __VA_ARGS__)
#define VIR_WARN(category, fmt,...)                                    \
    virLogMessage(category, VIR_LOG_WARN, 0, fmt, __VA_ARGS__)
#define VIR_ERROR(category, fmt,...)                                    \
    virLogMessage(category, VIR_LOG_ERROR, 0, fmt, __VA_ARGS__)
#else
#define VIR_DEBUG(category, fmt,...) \
    do { } while (0)
#define VIR_INFO(category, fmt,...) \
    do { } while (0)
#define VIR_WARN(category, fmt,...) \
    do { } while (0)
#define VIR_ERROR(category, fmt,...) \
    do { } while (0)
#endif /* !ENABLE_DEBUG */

#define DEBUG(fmt,...) VIR_DEBUG(__FILE__, fmt, __VA_ARGS__)
#define DEBUG0(msg) VIR_DEBUG(__FILE__, "%s", msg)
#define INFO(fmt,...) VIR_INFO(__FILE__, fmt, __VA_ARGS__)
#define INFO0(msg) VIR_INFO(__FILE__, "%s", msg)
#define WARN(fmt,...) VIR_WARN(__FILE__, fmt, __VA_ARGS__)
#define WARN0(msg) VIR_WARN(__FILE__, "%s", msg)
#define ERROR(fmt,...) VIR_ERROR(__FILE__, fmt, __VA_ARGS__)
#define ERROR0(msg) VIR_ERROR(__FILE__, "%s", msg)


/*
 * To be made public
 */
typedef enum {
    VIR_LOG_DEBUG = 1,
    VIR_LOG_INFO,
    VIR_LOG_WARN,
    VIR_LOG_ERROR,
} virLogPriority;

/**
 * virLogOutputFunc:
 * @data: extra output logging data
 * @category: the category for the message
 * @priority: the priority for the message
 * @msg: the message to log, preformatted and zero terminated
 * @len: the lenght of the message in bytes without the terminating zero
 *
 * Callback function used to output messages
 *
 * Returns the number of bytes written or -1 in case of error
 */
typedef int (*virLogOutputFunc) (void *data, const char *category,
                                 int priority, const char *str, int len);

/**
 * virLogCloseFunc:
 * @data: extra output logging data
 *
 * Callback function used to close a log output
 */
typedef void (*virLogCloseFunc) (void *data);

extern int virLogSetDefaultPriority(int priority);
extern int virLogDefineFilter(const char *match, int priority, int flags);
extern int virLogDefineOutput(virLogOutputFunc f, virLogCloseFunc c,
                              void *data, int priority, int flags);

#if 0
extern char *virLogGetDump(int flags);
#endif

/*
 * Internal logging API
 */

extern int virLogStartup(void);
extern int virLogReset(void);
extern void virLogShutdown(void);
extern int virLogParseFilters(const char *filters);
extern int virLogParseOutputs(const char *output);
extern void virLogMessage(const char *category, int priority, int flags,
                          const char *fmt, ...) ATTRIBUTE_FORMAT(printf, 4, 5);

#endif