SDK API > BS2_SetDebugFileLogEx


[+ 2.8.3] SDK내의 로그메시지를 분할 파일로 출력시켜 응용프로그램 등의 디버깅에 활용할 수 있습니다.
4번째 인자 fileMaxSizeMB를 통해, 파일 당 최대 크기를 지정할 수 있으며 MB 단위로 지정합니다.
이 값을 0으로 설정하면 파일 분할 저장을 진행하지 않습니다.
파일은 절대경로 또는 상대경로로 지정할 수 있으며, 이후 SDK 운영중에 발생되는 로그메시지는 해당 경로에 자동으로 생성됩니다.
이때 저장되는 파일명은 YYYYMMDD_x.log의 형태를 갖습니다. (_x는 fileMaxSize를 초과할 때마다 0부터 순차 부여)

함수

#include "BS_API.h"
 
int BS2_SetDebugFileLogEx(uint32_t level, uint32_t module, const char* logPath, int fileMaxSizeMB);

파라미터

  • [In] level : 오류 수준을 지정
매크로 의미
DEBUG_LOG_FATAL 0x00000001 치명적인 오류
DEBUG_LOG_ERROR 0x00000002 일반 오류
DEBUG_LOG_WARN 0x00000004 경고
DEBUG_LOG_API 0x00000008 API 호출 IN 및 OUT
DEBUG_LOG_INFO 0x00000010 오류 외의 정보
DEBUG_LOG_TRACE 0x00000100 SDK 자체 디버깅 목적의 정보
DEBUG_LOG_SYSTEM 0x0000000F 모든 오류수준을 출력
DEBUG_LOG_OPERATION_ALL 0x000000FF 모든 오류수준과 일반 정보를 출력
DEBUG_LOG_ALL 0xFFFFFFFF 모든 정보 출력
  • [In] module : 모듈을 지정
매크로
DEBUG_MODULE_KEEP_ALIVE 0x00000001 Keep alive 모듈
DEBUG_MODULE_SOCKET_MANAGER 0x00000002 소켓 관리 모듈
DEBUG_MODULE_SOCKET_HANDLER 0x00000004 소켓 운영 모듈
DEBUG_MODULE_DEVICE 0x00000008 장치 모듈
DEBUG_MODULE_DEVICE_MANAGER 0x00000010 장치 관리 모듈
DEBUG_MODULE_EVENT_DISPATCHER 0x00000020 이벤트 처리기 모듈
DEBUG_MODULE_API 0x00000040 API
DEBUG_MODULE_MISC 0x00000080 기타
DEBUG_MODULE_PACKET 0x00000100 통신 패킷 처리 모듈
DEBUG_MODULE_NOTIFY_MANAGER 0x00000400 Notify 처리 모듈
DEBUG_MODULE_EVENT 0x00000800 USB event log 처리 모듈
DEBUG_MODULE_USB 0x00001000 USB import 처리 모듈
DEBUG_MODULE_ALL 0xFFFFFFFF 전체 모듈
  • [In] logPath : 로그파일이 출력될 경로
  • [In] fileMaxSizeMB : 저장할 파일의 최대크기

반환값

성공적으로 수행될 경우 BS_SDK_SUCCESS를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.

샘플코드(C++)

sample_setdebugfilelogex.cpp
const char* CURRENT_DIR = ".";
const int MAX_SIZE_LOG_FILE = 100;  // 100MB
int sdkResult = BS2_SetDebugFileLogEx(DEBUG_LOG_ALL, DEBUG_MODULE_ALL, CURRENT_DIR, MAX_SIZE_LOG_FILE);
if (BS_SDK_SUCCESS != sdkResult)
{
	printf("BS2_SetDebugFileLogEx call failed: %d", sdkResult);
	return;
}

샘플코드(C#)

sample_setdebugfilelogex.cs
const string CURRENT_DIR = ".";
const int MAX_SIZE_LOG_FILE = 100;  // 100MB
IntPtr ptrDir = Marshal.StringToHGlobalAnsi(CURRENT_DIR);
result = (BS2ErrorCode)API.BS2_SetDebugFileLogEx(Constants.DEBUG_LOG_OPERATION_ALL, Constants.DEBUG_MODULE_ALL, ptrDir, MAX_SIZE_LOG_FILE);
Marshal.FreeHGlobal(ptrDir);
if (result != BS2ErrorCode.BS_SDK_SUCCESS)
{
	Console.WriteLine("Got error({0}).", result);
	return;
}