더 이상 사용되지 않는 API

이 섹션은 다음 항목을 포함하고 있습니다.

eAC IR API

구조

가능한 반환 값

함수

eAC IR API

이 라이브러리는 CA ControlMinder 로그 파일인 seos.audit 및 seos.audit.bak에 대한 인터페이스를 제공합니다.

이 API는 외부 응용 프로그램이 감사 레코드를 시간순으로 확인할 수 있도록 합니다.

중요! 이 부록에 설명된 API는 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 사용할 수 있습니다. 자세한 내용은 이 안내서의 앞부분에 설명된 최신 IR API를 참조하십시오.

구조

데이터 위치

typedef struct
{
	char filename[MAX_PATH];		current log file
  	off_t offset;				offset
  	unsigned char md5_1[16];		md5 signature of current log file
  	unsigned char md5_2[16];		md5 signature of next log file
} IRDataPosition;

UTF8로 해석된 감사 레코드

typedef struct tagSeosUTF8LogInterpreted
{
	char *Label;		Label of an audit field in the record
	char *Value;		Value assigned in the audit record to the field
} SEOS_UTF8AUDLOGINTERP;

가능한 반환 값

사유 코드	정수 값	의미
IR_EAC_SUCCESS	0	성공
IR_EAC_NO_MORE_DATA	1	더 이상 데이터가 없음
IR_EAC_DATA_LOST	2	데이터가 손실됨
IR_EAC_GENERAL_FAIL	3	일반적 실패
IR_EAC_PSBLY_DATA_LOST	4	데이터가 손실되었을 수 있음

함수

int eacIR_LogInit(IRDataPosition *pos);

CA ControlMinder 설정에서 감사 파일 이름을 가져옵니다.

오프셋을 다시 설정하여 가장 오래된 로그 파일을 가져온 후 감사 레코드를 읽기 위해 이 파일을 엽니다.

eacIR_LogGetNext()를 호출하기 위해 IRDataPosition 포인터를 초기화합니다.

이 함수는 성공하면 IR_EAC_SUCCESS를 반환합니다.

이 함수가 실패할 경우에는IR_EAC_GENERAL_FAIL을 반환합니다.

IRDataPosition: (출력) IRDataPosition 구조에 대한 포인터입니다.

int eacIR_LogReset(IRDataPosition *pos);

인수로 지정된 데이터 위치에 따라 로그 파일(아직 있는 경우)을 엽니다.

이 함수는 저장된 이전 상태로 돌아가 해당 상태에서 작업을 계속할 수 있도록 합니다.

이 함수는 성공하면 IR_EAC_SUCCESS를 반환합니다.

이 함수가 실패할 경우에는IR_EAC_GENERAL_FAIL을 반환합니다.

IRDataPosition: (입력) IRDataPosition 구조에 대한 포인터입니다.

int eacIR_LogGetNext(IRDataPosition *pos, SEOS_UTF8AUDLOGINTERP **ppUtfMsg, int *log_type);

지정된 데이터 위치에 따라 다음 로드 레코드와 해당 유형을 반환합니다.

가능한 반환 값은 다음과 같습니다.

조건	값
성공	IR_EAC_SUCCESS
더 이상 데이터가 없음	IR_EAC_NO_MORE_DATA
데이터가 손실됨	IR_EAC_DATA_LOST
일반적 실패	IR_EAC_GENERAL_FAIL
데이터가 손실되었을 수 있음	IR_EAC_PSBLY_DATA_LOST

IRDataPosition: (입력) IRDataPosition에 대한 포인터로, 다음 로그 레코드를 가져올 위치를 나타냅니다.
UTF8 strings: (출력) UTF8 문자열로 해석된 레코드에 대한 포인터입니다.
int: (출력) 정수에 대한 포인터로, 다음 로그 레코드 유형을 나타냅니다.

int eacIR_LogTerminate(void);

읽기 위해 연 로그 파일을 닫습니다. API를 사용한 작업이 끝났으면 이 함수를 호출합니다.

이 함수는 성공하면 IR_EAC_SUCCESS를 반환합니다.

이 함수가 실패할 경우에는IR_EAC_GENERAL_FAIL을 반환합니다.

void eacIR_LogFreeInterpretRecord(void);

이 함수는 마지막으로 해석된 레코드를 해제합니다.

이 함수에는 반환 값이 없습니다.

참고: eacIR_LogGetNext() API는 실행 시마다 동일한 내부 함수를 호출하므로 다음 로그 레코드에 대한 호출을 실행하기 전에 이 API를 사용할 필요가 없습니다.

char *eacIR_LogGetVersion(void);

API 버전을 문자열로 반환합니다.

반환 값은 문자열 형식의 버전 번호입니다.