log.h

Go to the documentation of this file.

// -*- mode: c -*-
#ifndef COBARO_LOG0_LOG_H
#define COBARO_LOG0_LOG_H

/****************************************************************
COPYRIGHT_BEGIN
Copyright (C) 2015, cobaro.org
All rights reserved.
COPYRIGHT_END
****************************************************************/

// All available in C99
#include <inttypes.h>
#include <stdarg.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>


enum cobaro_log_types {
    COBARO_STRING = 1,  
    COBARO_INTEGER = 2,  
    COBARO_REAL = 3,  
    COBARO_IPV4 = 4  
};


enum cobaro_log_levels {
    COBARO_LOG_EMERG = 0,  
    COBARO_LOG_ALERT,  
    COBARO_LOG_CRIT,  
    COBARO_LOG_ERR,  
    COBARO_LOG_WARNING,  
    COBARO_LOG_NOTICE,  
    COBARO_LOG_INFO,  
    COBARO_LOG_DEBUG,  
    COBARO_LOG_LEVELS_COUNT  
};


#define COBARO_LOG_PARAM_MAX (8) // Search log.c for PARAM_MAX_FIX if changed


struct cobaro_log {

    uint32_t id;

    uint32_t code;

    struct cobaro_log *next;

    uint8_t level;

    // 3 spare bytes here.

    char pad[44];

    struct {
        uint8_t type;

        // 7 spare bytes here.

        union {
            char s[48];
            
            int64_t i;

            double f;

            uint32_t ipv4;
        } v;
    } p[COBARO_LOG_PARAM_MAX];

};

// log->code       is the numeric identifier for a specific log.
// log->p[0].type  is the type of the value.
// log->p[0].v.s   is a reference to a string value.


typedef struct cobaro_log *cobaro_log_t;

typedef struct cobaro_loghandle *cobaro_loghandle_t;



char *cobaro_log_version(void);

cobaro_loghandle_t cobaro_log_init(char **messages);

void cobaro_log_messages_set(cobaro_loghandle_t lh, char **messages);

void cobaro_log_fini(cobaro_loghandle_t lh);

cobaro_log_t cobaro_log_claim(cobaro_loghandle_t lh);

void cobaro_log_set_string(cobaro_log_t log, int argnum, const char *source);

void cobaro_log_set_integer(cobaro_log_t log, int argnum, int64_t source);

void cobaro_log_set_double(cobaro_log_t log, int argnum, double source);

void cobaro_log_set_ipv4(cobaro_log_t log, int argnum, uint32_t source);

void cobaro_log_publish(cobaro_loghandle_t lh, cobaro_log_t log);

cobaro_log_t cobaro_log_next(cobaro_loghandle_t lh);

void cobaro_log_return(cobaro_loghandle_t lh, cobaro_log_t log);

bool cobaro_log(cobaro_loghandle_t lh, cobaro_log_t log);

void cobaro_log_to_syslog(cobaro_loghandle_t lh, cobaro_log_t log);

int cobaro_log_to_file(cobaro_loghandle_t lh, cobaro_log_t log, FILE *f);

int cobaro_log_to_string(cobaro_loghandle_t lh, cobaro_log_t log,
             char *buffer, size_t buflen);

bool cobaro_log_loglevel_set(cobaro_loghandle_t lh, int level);

bool cobaro_log_file_set(cobaro_loghandle_t lh, FILE *f);

bool cobaro_log_syslog_set(cobaro_loghandle_t lh);



#endif /* COBARO_LOG0_LOG_H */