~~NOTOC~~
[[sdk_api]] > [[BS2_SetDebugFileLogEx]]

----

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

int BS2_SetDebugFileLogEx(uint32_t level, uint32_t module, const char* logPath, int fileMaxSizeMB);
</code>

==== 파라미터 ====
  * [In] ''//level//'' : 오류 수준을 지정
<WRAP group 70%>
^매크로 ^값 ^의미 ^
|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 |모든 정보 출력 |
</WRAP>
  * [In] ''//module//'' : 모듈을 지정
<WRAP group 70%>
^매크로 ^값 ^
|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 |전체 모듈 |
</WRAP>
  * [In] ''//logPath//'' : 로그파일이 출력될 경로
  * [In] ''//fileMaxSizeMB//'' : 저장할 파일의 최대크기
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.
==== 샘플코드(C++) ====

<file cpp 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;
}
</file>

==== 샘플코드(C#) ====
<file csharp 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;
}
</file>