source: libcf/trunk/include/cf_log.h@ 34

/**
 * @file    cf_log.h
 * @author  myusgun <myusgun@gmail.com>
 * @version 0.1
 *
 * @section 샘플코드
 * @code

#include "cf_log.h"

CF_Log_Ctx gLogCtx;

void main (const char * message)
{
    int         i, j;
    char        logname[16] = {0x00,};

    CF_DEBUG_CALLSTACK_PUSH (gDebugCtx);

    CF_Log_Initialize (10);

    // with context
    gLogCtx = CF_Log_CreateCtx (file, CF_LOG_BUFFER_DEFAULT);
    if (gLogCtx == NULL)
        CF_DEBUG_PRINT (stderr, "create log ctx error\n");

    for (i = 0 ; i < 10000 ; i++)
        CF_Log_Write (gLogCtx, "LOG_TEST", "turn %d\n", i);

    CF_DEBUG_CALLSTACK_POP (gDebugCtx, &gDebugCallstack);

    CF_Log_Write (gLogCtx, message,
                            "here is the end of function [file:%s line:%d func:%s]\n",
                            gDebugCallstack.file,
                            gDebugCallstack.line,
                            gDebugCallstack.function);

    CF_Log_DestroyCtx (gLogCtx);

    // with id number
    for (i = 0 ; i < 10 ; i++)
    {
        sprintf (logname, "logid%d.txt", i);
        CF_LOG_OPEN (i, logname, CF_LOG_BUFFER_NO);
    }

    for (i = 0 ; i < 10 ; i++)
    {
        for (j = 0 ; j < 10000 ; j++)
            CF_LOG_WRITE (i, "LOG_ID_TEST", "turn %d\n", j);

        CF_LOG_CLOSE (i);
    }

    CF_Log_Finalize ();
}

 * @endcode
 */
#ifndef __CF_LOG_H__
#define __CF_LOG_H__

#include "cf_base.h"

#define CF_ERROR_LOG_INITIALIZE         CF_ERROR_LOG - 1
#define CF_ERROR_LOG_INVALID_CTX        CF_ERROR_LOG - 2
#define CF_ERROR_LOG_SET_MULTITHREAD    CF_ERROR_LOG - 3
#define CF_ERROR_LOG_UNSET_MULTITHREAD  CF_ERROR_LOG - 4
#define CF_ERROR_LOG_LOCK_CTX           CF_ERROR_LOG - 5
#define CF_ERROR_LOG_UNLOCK_CTX         CF_ERROR_LOG - 6
#define CF_ERROR_LOG_FLUSH              CF_ERROR_LOG - 7
#define CF_ERROR_LOG_INVALID_MAPID      CF_ERROR_LOG - 8
#define CF_ERROR_LOG_NOT_MAPPED_ID      CF_ERROR_LOG - 9
#define CF_ERROR_LOG_ALREADY_MAPPED_ID  CF_ERROR_LOG - 10
#define CF_ERROR_LOG_NOT_INITIALIZE     CF_ERROR_LOG - 11

/**
 * 로그의 버퍼 크기를 기본 값으로 설정
 *
 * @see CF_Log_CreateCtx, CF_LOG_OPEN
 */
#define CF_LOG_BUFFER_DEFAULT           -1

/** 로그 기록 시 버퍼를 사용하지 않고 즉시 기록
 *
 * @see CF_Log_CreateCtx, CF_LOG_OPEN, CF_Log_Initialize
 */
#define CF_LOG_BUFFER_NO                0

/**
 * 로그에 아이디 넘버를 부여하여 생성 <br />
 * 로그 기록 시, 아이디 넘버를 사용하면 해당 로그로 기록할 수 있음
 *
 * @param __id      부여할 아이디 넘버
 * @param __file    로그 파일 경로
 * @param __memsize 로그 버퍼 크기
 *
 * @see CF_Log_MapCtxID
 */
#define CF_LOG_OPEN(__id,__file,__memsize)              \
    CF_Log_MapCtxID (__id, CF_Log_CreateCtx (__file, __memsize))

/**
 * 아이디 넘버에 해당하는 로그에 쓰기
 *
 * @param __id  로그의 아이디 넘버
 * @param __pf  로그의 프리픽스 문자열
 * @param __fmt 포맷 스트링
 * @param ...   가변 인자
 *
 * @see CF_Log_GetMappedCtx
 */
#define CF_LOG_WRITE(__id,__pf,__fmt,...)               \
    CF_Log_Write (CF_Log_GetMappedCtx (__id),__pf,__fmt,##__VA_ARGS__)

/**
 * 아이디 넘버에 해당하는 로그를 닫고 해제
 *
 * @param __id 로그의 아이디 넘버
 *
 * @see CF_Log_UnmapCtxID
 */
#define CF_LOG_CLOSE(__id)      CF_Log_UnmapCtxID (__id)

/** 로그 컨텍스트 */
typedef void *  CF_Log_Ctx;

#ifdef __cplusplus
extern "C" {
#endif

/**
 * 로그를 사용하기 위해 초기화
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드
 *
 * @param logPool 아이디 넘버 최대 값
 */
CF_EXPORT int
CF_Log_Initialize       (const int logPool);

/**
 * 로그가 모두 사용된 후 자원 해제
 *
 * @return CF_OK 반환
 */
CF_EXPORT int
CF_Log_Finalize         (void);

/**
 * 로그 컨텍스트 생성
 *
 * @return 성공 시, 로그 컨텍스트; 실패 시, NULL
 *
 * @param path      로그 파일 경로
 * @param memsize   로그 버퍼 크기
 *
 * @see CF_LOG_BUFFER_DEFAULT, CF_LOG_BUFFER_NO
 */
CF_EXPORT CF_Log_Ctx
CF_Log_CreateCtx        (const char * path,
                         const int  memsize);

/**
 * 로그 컨텍스트 해제
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드 
 *
 * @param ctx 로그 컨텍스트
 */
CF_EXPORT int
CF_Log_DestroyCtx       (CF_Log_Ctx ctx);

/**
 * 로그 컨텍스트에 멀티쓰레드 모드 설정
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드 
 *
 * @param ctx 로그 컨텍스트
 */
CF_EXPORT int
CF_Log_SetMultiThread   (CF_Log_Ctx ctx);

/**
 * 로그 컨텍스트에 멀티쓰레드 모드 설정 해제
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드 
 *
 * @param ctx 로그 컨텍스트
 */
CF_EXPORT int
CF_Log_UnsetMultiThread (CF_Log_Ctx ctx);

/**
 * 로그 컨텍스트에 따라 로그 쓰기
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드
 *
 * @param ctx       로그 컨텍스트
 * @param prefix    로그의 프리픽스 문자열
 * @param fmt       포맷 스트링
 * @param ...       가변 인자
 */
CF_EXPORT int
CF_Log_Write            (CF_Log_Ctx ctx,
                         const char * prefix,
                         const char * fmt, ...);

/**
 * 로그 버퍼의 데이터를 즉시 로그 파일에 쓰기
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드
 *
 * @param ctx 로그 컨텍스트
 */
CF_EXPORT int
CF_Log_Flush            (CF_Log_Ctx ctx);

/**
 * 로그 컨텍스트에 아이디 넘버 할당<br />
 * 로그 기록 시, 아이디 넘버를 사용하면 해당 로그로 기록할 수 있음
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드
 *
 * @param mapid 부여할 아이디 넘버
 * @param ctx   로그 컨텍스트
 *
 * @remark 반드시 먼저 초기화 해야하며, 초기화 시에 주어진 번호보다 작은 아이디 넘버를 사용해야 함
 *
 * @see CF_LOG_OPEN, CF_Log_CreateCtx
 */
CF_EXPORT int
CF_Log_MapCtxID         (const int          mapid,
                         const CF_Log_Ctx   ctx);

/**
 * 아이디 넘버에 해당하는 로그를 닫고 해당하는 컨텍스트를 해제
 *
 * @return 성공 시, CF_OK; 실패 시, 오류 코드
 *
 * @param mapid 로그의 아이디 넘버
 *
 * @remark 아이디 넘버에 해당하는 컨텍스트가 해제되므로 주의
 *
 * @see CF_LOG_CLOSE, CF_Log_DestroyCtx
 */
CF_EXPORT int
CF_Log_UnmapCtxID       (const int mapid);

/**
 * 아이디 넘버에 해당하는 로그 컨텍스트를 얻기
 *
 * @return 성공 시, 로그 컨텍스트; 실패 시, NULL
 *
 * @param mapid 로그의 아이디 넘버
 */
CF_EXPORT CF_Log_Ctx
CF_Log_GetMappedCtx     (const int mapid);

#ifdef __cplusplus
}
#endif

#endif // #ifndef __CF_LOG_H__