Book Creator
 Add this page to your book
Book Creator
 Remove this page from your book  

 Manage book (0 page(s))
 Help

This is an old revision of the document!

FIXME This page is not fully translated, yet. Please help completing the translation.
(remove this paragraph once the translation is finished)

SDK API > BS2_SetDebugFileLogEx

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;
}