Provided by: manpages-ru_0.98-4_all bug

ИМЯ

       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  kB) и огромных страницах (2 или 4 MB). Похожим образом и
       на платформе ia64 аппартная часть знает об  огромных  страницах  разных
       размеров.  Упомянутые  системные  вызовы обслуживают выделение огромных
       страниц в память  процесса  или  их  освобождение.   Огромные  страницы
       остаются в памяти и не сбрасываются на своппиг.

       Параметр  key  -  это некий идентификатор. Он равен нулю, если выделено
       ноль страниц и  нет  страниц  унаследованных  процессами-потомками.  Он
       больше   нуля,   если   несколько   страниц   разделяются   несколькими
       приложениями, использующими один и тот же  key  и  приложения  являются
       процессами-потомками.

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

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

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

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

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

       В  случае  успеха  alloc_hugepages  возвращает  выделенный  виртуальный
       адрес, а free_hugepages возвращает ноль. В случае ошибки возврщается -1
       и значение errno устанавливается должным образом.

ОШИБКИ

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

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

       Данные системные вызовы существуют только в Linux 2.5.36 - 2.5.54.  Эти
       вызовы являются специфичными для Linux на процессорах Intel и не должны
       использоваться  в  программах, которые задумываются как переносимые. На
       самом   деле,   номера   этих   системных    вызовов    отмечены    для
       переиспользования,  так  что  программы  которые  используют их могут в
       будущих ядрах вытворять что-то совсем непонятное.

ФАЙЛЫ

       /proc/sys/vm/nr_hugepages Количество настроенных страниц hugetlb.  Этот
       файл можно как читать так и писать.

       /proc/meminfo Предоставляет информацию о количестве настроенных страниц
       hugetlb и их размер в трёх переменных HugePages_Total,  HugePages_Free,
       Hugepagesize.

ЗАМЕЧАНИЯ

       Данные  системные  вызовы  умерли. Теперь вместо них можно использовать
       файловую систему hugetlbfs.  Память,  выделяемая  огромными  страницами
       (если   процессор   позволяет   их   использование)   получается  через
       отображение файлов в этой виртуальной файловой системе.

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

ПЕРЕВОД

       Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2003