1

#ifndef LOG_H

     2

#define LOG_H

     3

     4

/** @file log.h

     5

 *

     6

 * Local logging functions

     7

 */

     8

#include "error.h"

     9

    10

/**

    11

 * Log level definitions

    12

 *

    13

 * XXX: these names conflict with <syslog.h>

    14

 */

    15

enum log_level {

    16

    LOG_DEBUG,

    17

    LOG_INFO,

    18

    LOG_WARN,

    19

    LOG_ERROR,

    20

    LOG_FATAL,

    21

};

    22

    23

/**

    24

 * List of log_level values as strings, NULL-terminated

    25

 */

    26

extern const char *log_level_names[];

    27

    28

/**

    29

 * The default log level

    30

 */

    31

#define LOG_LEVEL_DEFAULT LOG_INFO

    32

    33

/**

    34

 * Log a message with the given level

    35

 */

    36

void log_msg (enum log_level level, const char *func, const char *format, ...)

    37

    __attribute__ ((format (printf, 3, 4)));

    38

    39

/**

    40

 * Set the current log level to filter out messages below the given level

    41

 */

    42

void set_log_level (enum log_level level);

    43

    44

/**

    45

 * Shorthand for log_msg

    46

 */

    47

#define log_debug(...) log_msg(LOG_DEBUG, __func__, __VA_ARGS__)

    48

#define log_info(...)  log_msg(LOG_INFO,  __func__, __VA_ARGS__)

    49

#define log_warn(...)  log_msg(LOG_WARN,  __func__, __VA_ARGS__)

    50

#define log_error(...) log_msg(LOG_ERROR, __func__, __VA_ARGS__)

    51

#define log_fatal(...) log_msg(LOG_FATAL, __func__, __VA_ARGS__)

    52

    53

/**

    54

 * Log a message with LOG_ERROR, appending the formatted error code

    55

 */

    56

void _log_err (enum log_level level, err_t err, const char *func, const char *format, ...)

    57

    __attribute__ ((format (printf, 4, 5)));

    58

    59

void _log_err_info (enum log_level level, struct error_info *err, const char *func, const char *format, ...)

    60

    __attribute__ ((format (printf, 4, 5)));

    61

    62

/**

    63

 * Log using errno.

    64

 */

    65

void _log_perr (enum log_level level, const char *func, const char *format, ...)

    66

    __attribute__ ((format (printf, 3, 4)));

    67

    68

#define log_err(err, ...) _log_err(LOG_ERROR, err, __func__, __VA_ARGS__)

    69

#define log_err_info(err_info, ...) _log_err_info(LOG_ERROR, err_info, __func__, __VA_ARGS__)

    70

    71

/**

    72

 * log_fatal + exit failure

    73

 */

    74

#define FATAL(...) do { log_fatal(__VA_ARGS__); exit(EXIT_FAILURE); } while (0)

    75

    76

/**

    77

 * log_err + exit failure

    78

 */

    79

#define FATAL_ERR(err_code, ...) do { _log_err(LOG_FATAL, err_code, __func__, __VA_ARGS__); exit(EXIT_FAILURE); } while (0)

    80

    81

/**

    82

 * log_err_info + exit failure

    83

 */

    84

#define FATAL_ERROR(err_info, ...) do { _log_err_info(LOG_FATAL, err_info, __func__, __VA_ARGS__); exit(EXIT_FAILURE); } while (0)

    85

    86

/**

    87

 * log_perr + exit failure

    88

 */

    89

#define FATAL_PERROR(...) do { _log_perr(LOG_FATAL, __func__, __VA_ARGS__); exit(EXIT_FAILURE); } while (0)

    90

    91

#endif /* LOG_H */