ldmp_bufest, ldmp_timeleft, ldmp_xmalloc, ldmp_xmfree 및 ldmp_errstr 커널 서비스

용도

현재 라이브 덤프에 대한 정보를 얻습니다.

구문

#include <sys/livedump.h>
kerrno_t ldmp_bufest (id, cb, len)
dumpid_t id;
ras_block_t cb;
size_t *len;

kerrno_t ldmp_timeleft (id, timeleft)
dumpid_t id;
long *timeleft;

kerrno_t ldmp_xmalloc (id, size, align, p)
dumpid_t id;
size_t size;
uint align;
void **p;

kerrno_t ldmp_xmfree (id, p)
dumpid_t id;
void *p;

kerrno_t ldmp_errstr (id, cb, str)
dumpid_t id;
ras_block_t cb;
char *str;

매개변수

항목 설명
맞추다 원하는 정렬의 로그 베이스 2를 지정합니다. 허용되는 최대 정렬은 12, 4096바이트 정렬입니다.
cb 구성 요소에 대한 ras_block_t를 지정합니다.
id 덤프의 ID를 지정합니다.
길이 이 패스에서 지정된 구성 요소에 의해 여전히 버퍼링될 수 있는 데이터의 추정치를 바이트 단위로 지정합니다.
p 할당되거나 해제될 메모리 블록을 지정합니다.
size 할당할 메모리 크기를 지정합니다.
STR 오류 메시지를 지정합니다.
남은 시간 이 패스에 남은 시간을 나노초 단위로 지정합니다. 이 값은 직렬화된 덤프에만 의미가 있습니다. 부정적일 수 있습니다.

설명

그만큼 ldmp_bufest 커널 서비스는 이 구성 요소에 사용 가능한 덤프 버퍼 저장소의 바이트 수를 추정합니다.

그만큼 ldmp_timeleft 커널 서비스는 이 패스에 남아 있는 시간을 나노초 단위로 추정합니다.

그만큼 ldmp_xmalloc 커널 서비스는 라이브 덤프 힙에서 스토리지를 할당합니다.

그만큼 ldmp_xmfree 커널 서비스는 라이브 덤프 힙 저장소를 해제합니다.

그만큼 ldmp_errstr 커널 서비스는 라이브 덤프 상태 보고의 일부로 오류를 기록합니다. 문자열은 라이브 덤프에 포함되며 공간이 충분한 경우 오류 로그 항목에 보고됩니다.
중요한: 오류 로그 항목의 최대 길이는 2048바이트입니다. 오류 문자열은 후행 NULL을 포함하여 128바이트로 제한되며 너무 길면 잘립니다. 구성 요소의 경로 이름도 기록됩니다.
팁: 그만큼 ldmp_errstr 커널 서비스를 여러 번 호출하여 여러 오류를 보고할 수 있습니다.
오류 로그 항목의 공간이 제한되어 있으므로 구성 요소에서 오류 문자열의 크기를 제한하는 것이 좋습니다.

리턴 값

항목 설명
0 성공적인 완료를 표시합니다.
EINVAL_RAS_xxx_BADARGS 서비스에 대한 인수가 유효하지 않음을 나타냅니다.
EFAULT_RAS_xxx_BADARGS 주소 인수가 유효한 주소가 아님을 나타냅니다.
ENOMEM_RAS_LDMP_XMALLOC 라이브 덤프 힙에 이 요청을 충족할 공간이 부족함을 나타냅니다.