NAME

get_mempolicy - 스레드의 NUMA 메모리 정책 가져오기

SYNOPSIS

#include <numaif.h>

long get_mempolicy(int *mode, unsigned long *nodemask,
                   unsigned long maxnode, void *addr,
                   unsigned long flags);

-lnuma로 링크.

주의: 이 시스템 호출에 대한 glibc 래퍼가 없다. NOTES 참고.

DESCRIPTION

get_mempolicy()는 flags 설정에 따라서 호출 스레드 또는 메모리 주소의 NUMA 정책을 가져온다.

NUMA 머신에는 CPU들과 거리가 다른 여러 개의 메모리 컨트롤러가 있다. 메모리 정책은 스레드를 위한 메모리를 어느 노드에서 할당할지 규정한다.

flags를 0으로 지정하면 호출 스레드의 (set_mempolicy(2)로 설정한) 기본 정책에 대한 정보를 mode 및 nodemask가 가리키는 버퍼로 반환한다. 이 인자들로 반환되는 값으로 set_mempolicy(2) 하면 get_mempolicy() 호출 시점의 상태로 스레드의 정책을 복원할 수 있다. flags가 0일 때 addr은 NULL로 지정해야 한다.

flags에 MPOL_F_MEMS_ALLOWED를 지정하면 (리눅스 2.6.24부터 사용 가능) mode 인자는 무시하며 노드(메모리)들의 집합을 nodemask로 반환하는데, 그 노드들을 스레드에서 이후 mbind(2)나 (모드 플래그 없는) set_mempolicy(2) 호출에서 지정할 수 있다. MPOL_F_MEMS_ALLOWED를 MPOL_F_ADDR이나 MPOL_F_NODE와 함께 쓸 수 없다.

flags에 MPOL_F_ADDR을 지정하면 addr에 준 메모리 주소에 적용되는 정책에 대한 정보를 반환한다. mbind(2)나 numa(3)에서 설명하는 헬퍼 함수들 중 하나를 사용해 addr을 포함한 메모리 범위에 정책을 설정했다면 그 정책이 스레드의 기본 정책과 다를 수 있다.

mode 인자가 NULL이 아닌 경우 get_mempolicy()는 요청 받은 NUMA 정책의 정책 모드와 선택적인 모드 플래그를 그 인자가 가리키는 위치에 저장하게 된다. nodemask가 NULL이 아니면 정책에 연계된 노드 마스크를 그 인자가 가리키는 위치에 저장하게 된다. maxnode는 nodemask에 저장할 수 있는 노드 ID 수를 나타낸다. 즉 가장 큰 노드 ID 더하기 1이다. maxnode로 지정한 값을 항상 sizeof(unsigned long)*8의 배수로 올림 한다.

flags에 MPOL_F_NODE와 MPOL_F_ADDR을 모두 지정한 경우 get_mempolicy()는 주소 addr이 할당된 노드의 노드 ID를 mode가 가리키는 위치로 반환한다. 지정한 주소에 대해 할당된 페이지가 아직 없으면 스레드에서 그 주소에 읽기 (적재) 접근을 수행한 것처럼 페이지를 할당하고서 그 페이지가 할당된 노드의 ID를 반환한다.

flags에 MPOL_F_NODE는 지정하고 MPOL_F_ADDR은 지정하지 않았으며 스레드의 현재 정책이 MPOL_INTERLEAVE인 경우에는 스레드를 위해 할당된 내부 커널 페이지들의 인터리빙에 쓰일 다음 노드의 노드 ID를 NULL 아닌 mode 인자가 가리키는 위치에 반환하게 된다. mmap(2) 호출을 MAP_PRIVATE 플래그로 사용해 읽기 접근용으로 맵 한 프로세스 메모리 범위들과 MAP_SHARED 플래그로 사용해 모든 접근용으로 맵 한 메모리 범위들 내의 메모리 맵 파일들에 대한 페이지들이 거기 포함된다.

다른 플래그 값들은 예약돼 있다.

가능한 정책들에 대한 소개는 set_mempolicy(2)를 보라.

RETURN VALUE

성공 시 get_mempolicy()는 0을 반환한다. 오류 시 -1을 반환하며 오류를 나타내도록 errno를 설정한다.

ERRORS

EFAULT

nodemask와 maxnode로 지정한 메모리 범위의 일부 내지 전체가 접근 가능한 주소 공간 밖을 가리킨다.

EINVAL

maxnode로 지정한 값이 시스템에서 지원하는 노드 ID 수보다 작다. 또는 flags에 MPOL_F_NODE와 MPOL_F_ADDR 외의 값을 지정했다. 또는 flags에 MPOL_F_ADDR을 지정했고 addr이 NULL이거나, flags에 MPOL_F_ADDR을 지정하지 않았고 addr이 NULL이 아니다. 또는 flags에 MPOL_F_ADDR이 아니라 MPOL_F_NODE를 지정했고 현재 스레드 정책이 MPOL_INTERLEAVE가 아니다. 또는 flags에 MPOL_F_MEMS_ALLOWED를 MPOL_F_ADDR이나 MPOL_F_NODE와 함께 지정했다. (또 다른 EINVAL 경우들이 있다.)

VERSIONS

리눅스 커널 버전 2.6.7에서 get_mempolicy() 시스템 호출이 추가되었다.

CONFORMING TO

이 시스템 호출은 리눅스 전용이다.

NOTES

glibc에서 이 시스템 호출의 래퍼를 제공하지 않는다. 라이브러리 지원에 대한 정보는 numa(7)를 보라.

SEE ALSO

getcpu(2), mbind(2), mmap(2), set_mempolicy(2), numa(3), numa(7), numactl(8)

---

2021-03-22