Scroll to navigation

ALLOC_HUGEPAGES(2) Руководство программиста Linux ALLOC_HUGEPAGES(2)

ИМЯ

alloc_hugepages, free_hugepages - выделяет или освобождает огромные страницы

СИНТАКСИС

void *alloc_hugepages(int key, void *addr, size_t len,
                      int prot, int flag);
int free_hugepages(void *addr);

ОПИСАНИЕ

Системные вызовы alloc_hugepages() и free_hugepages() появились в Linux 2.5.36 и удалены в 2.5.54. Они существовали только на архитектурах i386 и ia64 (при сборке с параметром CONFIG_HUGETLB_PAGE). В Linux 2.4.20 такие номера системных вызовов остались, но сами вызовы завершаются с ошибкой ENOSYS.

На i386 аппаратура управления памятью умеет работать с обычными страницами (4 КиБ) и огромными страницами (2 или 4 МиБ). Подобно этому, ia64 умеет работать с огромными страницами разных размеров. Эти системные вызовы служат для отображения огромных страниц в память процесса или её освобождения. Огромные страницы блокируются в памяти и не могут быть вытеснены в пространство подкачки.

Аргумент key служит идентификатором. При нулевом значении страницы считаются частными и не наследуются потомками. При положительном значении страницы совместно используются несколькими приложениями посредством одинакового key и наследуются процессами-потомками.

Аргумент addr в free_hugepages() указывает какую страницу нужно освободить: его значением является результат вызова alloc_hugepages(). (Память, на самом деле, освобождается только когда все пользователи её освободят.) Аргумент addr в alloc_hugepages() — это подсказка, которой ядро может и не воспользоваться. Адреса должны быть выровнены соответствующим образом.

Аргумент len задаёт длину требуемого сегмент. Он должен быть кратен размеру огромной страницы.

Аргумент prot определяет тип защиты сегмента памяти. Может быть указано одно из значений: PROT_READ, PROT_WRITE, PROT_EXEC.

Аргумент flag игнорируется, если key не является положительным. В этом случае, если flagIPC_CREAT, то создаётся новый сегмент огромной страницы, если не существует ни один из указанных идентификаторов. Если флаг не задан, то возвращается ENOENT, если не существует сегмента с заданным идентификатором.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении alloc_hugepages() возвращает выделенный виртуальный адрес, а free_hugepages() возвращает ноль. При ошибке возвращается -1, а errno устанавливается соответствующим образом.

ОШИБКИ

Системный вызов не поддерживается данным ядром.

ФАЙЛЫ

/proc/sys/vm/nr_hugepages
Количество настроенных страниц hugetlb. Доступен для чтения и записи.
/proc/meminfo
Выдаёт информацию о числе настроенных страниц hugetlb и их размере в трёх переменных: HugePages_Total, HugePages_Free, Hugepagesize.

СООТВЕТСТВИЕ СТАНДАРТАМ

Эти вызовы есть только в Linux для процессоров Intel и не должны использоваться в переносимых программах.

ЗАМЕЧАНИЯ

Данные системные вызовы были удалены; они существуют только в ядрах Linux версий с 2.5.36 по 2.5.54. Вместо них теперь можно использовать файловую систему hugetlbfs. Память, поддерживаемая огромными страницами (если есть поддержка в ЦП), получается с помощью mmap(2) в отображаемые файлы этой виртуальной файловой системе.

Максимальное число огромных страниц можно задать в параметре загрузки ядра hugepages=.

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Dmitry Bolkhovskikh <d20052005@yandex.ru> и Yuri Kozlov <yuray@komyakino.ru>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

15 сентября 2017 г. Linux