| MBIND(2) | Руководство программиста Linux | MBIND(2) |
mbind - устанавливает политику на область памяти
#include <numaif.h>
long mbind(void *addr, unsigned long len, int mode,
const unsigned long *nodemask, unsigned long maxnode,
unsigned flags);
Компонуется при указании параметра -lnuma.
Вызов mbind() устанавливает политику памяти NUMA, состоящую из режима политики и нуля или более узлов, на область памяти, начинающуюся с addr и длиной len байт. Политикой памяти задаётся на каком узле будет выделяться память.
Если область памяти, заданная аргументами addr и len, включает «анонимную» область памяти — область памяти, созданную с помощью системного вызова mmap(2) с аргументом MAP_ANONYMOUS — или файл, отображённый в память с помощью вызова mmap(2) с флагом MAP_PRIVATE, то страницы будут выделены в соответствии с указанной политикой только когда приложение выполняет запись (сохранение) страницы. Для анонимных областей при первоначальном доступе на чтение будет использоваться общая страница ядра, содержащая только нули. Для отображённого файла с флагом MAP_PRIVATE, при первоначальном доступе на чтение будут выделены страницы в соответствии с политикой памяти нити, для которой происходит выделение страницы. Это может быть не та нить, которая вызвала mbind().
Указанная политика в заданной области памяти будет игнорироваться для всех отображений MAP_SHARED. Скорее всего, страницы будут выделены согласно политике памяти нити, для которой происходит выделение страницы. Но опять таки, это может быть не та нить, которая вызвала mbind().
Если заданная область памяти включает общую область памяти, созданную с помощью системного вызова shmget(2) и подключённую с помощью системного вызова shmat(2), то страницы, выделяемые для анонимной или общей области памяти, будут выделены согласно указанной политике, независимо от того, какой процесс подключил сегмент общей памяти, что вызвало выделение. Однако, если общая область памяти была создана с флагом SHM_HUGETLB, то огромные страницы будут выделяться согласно указанной политике, только если выделение страницы происходит из-за процесса, который вызвал mbind() для этой области.
По умолчанию, mbind() учитывается только при новых выделениях; если страницы внутри области уже были использованы до настройки политики, то политика не применяется. Такое поведение можно изменить с помощью флагов MPOL_MF_MOVE и MPOL_MF_MOVE_ALL, описанных далее.
В аргументе mode должно быть указано одно из следующих значений: MPOL_DEFAULT, MPOL_BIND, MPOL_INTERLEAVE, MPOL_PREFERRED или MPOL_LOCAL (описано далее). Для всех режимов политики, за исключением MPOL_DEFAULT, требуется, чтобы вызывающий указывал в аргументе nodemask узел или узлы, для которых применяется режим.
Аргумент mode также может содержать необязательный флаг режима. Поддерживаемые флаги режима:
В nodemask содержится битовая маска узлов, в которой содержится до maxnode бит. Размер битовой маски округляется до следующего кратного значения sizeof(unsigned long), но ядром будет использовано только до maxnode бит. Значением NULL в nodemask или значением maxnode равным 0 задаётся пустой набор узлов. Если значение maxnode равно 0, то аргумент nodemask игнорируется. Там, где требуется nodemask, его значение должно содержать, как минимум, один работающий узел, который разрешён нити текущим контекстом набора процессоров (если не указан флаг MPOL_F_STATIC_NODES) и у которого имеется память.
Аргумент mode должен включать одно из следующих значений:
Если в flags указан MPOL_MF_STRICT и mode не равно MPOL_DEFAULT, то вызов завершается ошибкой EIO, если существующие страницы в области памяти не следуют политике.
Если в flags указан MPOL_MF_MOVE, то ядро будет пытаться переместить все существующие страницы в области памяти так, чтобы они следовали политике. Страницы, используемые совместно с другими процессами, перемещаться не будут. Если также указан MPOL_MF_STRICT, что вызов завершается ошибкой EIO, если страницы не могут быть перемещены.
Если в flags указан MPOL_MF_MOVE_ALL, то ядро будет пытаться переместить все существующие страницы в области памяти независимо от того, используются ли они другими процессами. Для использования данного флага вызывающая нить должна быть привилегированной (CAP_SYS_NICE). Если также указан MPOL_MF_STRICT, то вызов завершается ошибкой EIO, если некоторые страницы нельзя переместить.
При успешном выполнении mbind() возвращается 0. При ошибке возвращается -1, а в errno содержится код ошибки.
Системный вызов mbind() был добавлен в ядро Linux версии 2.6.7.
Данный вызов есть только в Linux.
Информация о библиотеке доступна в numa(7).
Политика NUMA не поддерживается для области памяти отображения файла, который отображён с флагом MAP_SHARED.
Режим MPOL_DEFAULT может по разному влиять на mbind() и set_mempolicy(2). Когда указан MPOL_DEFAULT для set_mempolicy(2), политика памяти нити возвращается к политике по умолчанию или локальному выделению. Когда MPOL_DEFAULT указан для области памяти, используемой mbind(), все страницы, последовательно выделяемые для этой области, будут использовать политику памяти нити, которая задана с помощью set_mempolicy(2). Это эффективно удаляет явную политику из указанной области, «откатываясь» к возможной политике не по умолчанию. Для выбора явного «локального выделения» области памяти, укажите в mode значение MPOL_LOCAL или MPOL_PREFERRED с пустым набором узлов. Этот метод также сработает и в вызове set_mempolicy(2).
Поддержка политики для огромных страниц была добавлена в версию 2.6.16. Для эффективной работы политики чередования на огромных страничных отображениях, контролируемая память должна измеряться десятками мегабайт или больше.
Режим MPOL_MF_STRICT игнорируется для огромных страничных отображений.
Режимы MPOL_MF_MOVE и MPOL_MF_MOVE_ALL доступны только в Linux 2.6.16 и новее.
get_mempolicy(2), getcpu(2), mmap(2), set_mempolicy(2), shmat(2), shmget(2), numa(3), cpuset(7), numa(7), numactl(8)
| 2017-09-15 | Linux |