dlog.h

Go to the documentation of this file.

/*  MIT License
 *
 * Copyright (c) 2012-2020 Samsung Electronics Co., Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is furnished
 * to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE. */
 

 
 
#ifndef _DLOG_H_
#define _DLOG_H_
 
#include <stdarg.h>
#include <string.h>
#include <tizen_error.h>
/*
 * This is for checking dlog_print format string.
 */
#pragma GCC diagnostic warning "-Wformat"
#include "dlog-internal.h"
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
 
/*
 * This is the local tag used for the following simplified
 * logging macros. You can change this preprocessor definition
 * before using the other macros to change the tag.
 */
#ifndef LOG_TAG
#define LOG_TAG NULL
#endif
 

 

typedef enum {
    DLOG_ERROR_NONE = TIZEN_ERROR_NONE, 
    DLOG_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, 
    DLOG_ERROR_NOT_PERMITTED = TIZEN_ERROR_NOT_PERMITTED 
} dlog_error_e;
 

 

 

typedef enum {
    DLOG_UNKNOWN = 0,
    DLOG_DEFAULT, // doesn't seem actually used or translated into any other level
    DLOG_VERBOSE, 
    DLOG_DEBUG,   
    DLOG_INFO,    
    DLOG_WARN,    
    DLOG_ERROR,   
    DLOG_FATAL,   
    DLOG_SILENT,  
    DLOG_PRIO_MAX
} log_priority;
 
/* TODO: developers notoriously misuse ERROR as a generic "high priority" tag,
 * even for things that aren't actually errors. Consider adding some sort of
 * `DLOG_INFO_HIGH` or something that would retain the benefits of `DLOG_ERROR`,
 * i.e. be high enough to pass default filters and (green?) coloring in dlogutil. */

 

 

int dlog_print(log_priority prio, const char *tag, const char *fmt, ...)  __attribute__((format(printf, 3, 4)));
 

int dlog_vprint(log_priority prio, const char *tag, const char *fmt, va_list ap);

 
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* _DLOG_H_*/