17.4. Управление ресурсами ядра
Postgres Pro иногда может исчерпывать некоторые ресурсы операционной системы до предела, особенно при запуске нескольких копий сервера в одной системе или при работе с очень большими базами. В этом разделе описываются ресурсы ядра, которые использует Postgres Pro, и подходы к решению проблем, связанных с ограниченностью этих ресурсов.
17.4.1. Разделяемая память и семафоры
Postgres Pro требует, чтобы операционная система предоставляла средства межпроцессного взаимодействия (IPC), в частности, разделяемую память и семафоры. Системы семейства Unix обычно предоставляют функции IPC в стиле «System V» или функции IPC в стиле «POSIX» или и те, и другие. В Windows эти механизмы реализованы по-другому, но здесь это не рассматривается.
По умолчанию Postgres Pro запрашивает очень небольшой объём разделяемой памяти System V и намного больший объём анонимной разделяемой памяти mmap
. Возможен также вариант использования одной большой области памяти System V (см. shared_memory_type). Помимо этого при запуске сервера создаётся значительное количество семафоров (в стиле System V или POSIX). В настоящее время семафоры POSIX используются в системах Linux и FreeBSD, а на других платформах используются семафоры System V.
Функции IPC в стиле System V обычно сталкиваются с лимитами на уровне системы. Когда Postgres Pro превышает один из этих лимитов, сервер отказывается запускаться, но должен выдать полезное сообщение, говорящее об ошибке и о том, что с ней делать. (См. также Подраздел 17.3.1.) Соответствующие параметры ядра в разных системах называются аналогично (они перечислены в Таблице 17.1), но устанавливаются по-разному. Ниже предлагаются способы их изменения для некоторых систем.
Таблица 17.1. Параметры IPC в стиле System V
Имя | Описание | Значения, необходимые для запуска одного экземпляра Postgres Pro |
---|---|---|
SHMMAX | Максимальный размер сегмента разделяемой памяти (в байтах) | как минимум 1 КБ, но значение по умолчанию обычно гораздо больше |
SHMMIN | Минимальный размер сегмента разделяемой памяти (в байтах) | 1 |
SHMALL | Общий объём доступной разделяемой памяти (в байтах или страницах) | если в байтах, то же, что и SHMMAX ; если в страницах, то ceil(SHMMAX/PAGE_SIZE) , плюс потребность других приложений |
SHMSEG | Максимальное число сегментов разделяемой памяти для процесса | требуется только 1 сегмент, но значение по умолчанию гораздо больше |
SHMMNI | Максимальное число сегментов разделяемой памяти для всей системы | как SHMSEG плюс потребность других приложений |
SEMMNI | Максимальное число идентификаторов семафоров (т. е., их наборов) | как минимум ceil((max_connections + autovacuum_max_workers + max_wal_senders + max_worker_processes + 5) / 16) плюс потребность других приложений |
SEMMNS | Максимальное число семафоров для всей системы | ceil((max_connections + autovacuum_max_workers + max_wal_senders + max_worker_processes + 5) / 16) * 17 плюс потребность других приложений |
SEMMSL | Максимальное число семафоров в наборе | не меньше 17 |
SEMMAP | Число записей в карте семафоров | см. текст |
SEMVMX | Максимальное значение семафора | не меньше 1000 (по умолчанию оно обычно равно 32767; без необходимости менять его не следует) |
Postgres Pro запрашивает небольшой блок разделяемой памяти System V (обычно 48 байт на 64-битной платформе) для каждой копии сервера. В большинстве современных операционных систем такой объём выделяется без проблем. Однако если запускать много копий сервера или явно настроить сервер для использования больших объёмов разделяемой памяти System V (см. shared_memory_type и dynamic_shared_memory_type), может понадобиться увеличить значение SHMALL
, задающее общий объём разделяемой памяти System V, доступный для всей системы. Заметьте, что SHMALL
во многих системах задаётся в страницах, а не в байтах.
Менее вероятны проблемы с минимальным размером сегментов разделяемой памяти (SHMMIN
), который для Postgres Pro не должен превышать примерно 32 байт (обычно это всего 1 байт). Максимальное число сегментов для всей системы (SHMMNI
) или для одного процесса (SHMSEG
) тоже обычно не влияет на работоспособность сервера, если только это число не равно нулю.
Когда Postgres Pro использует семафоры System V, он занимает по одному семафору на одно разрешённое подключение (max_connections), на разрешённый рабочий процесс автоочистки (autovacuum_max_workers), разрешённый процесс-передатчик WAL (max_wal_senders и фоновый процесс (max_worker_processes), в наборах по 16. В каждом таком наборе есть также 17-й семафор, содержащий «магическое число», позволяющий обнаруживать коллизии с наборами семафоров других приложений. Максимальное число семафоров в системе задаётся параметром SEMMNS
, который, следовательно, должен быть равен как минимум сумме max_connections
, autovacuum_max_workers
, max_wal_senders
и max_worker_processes
, плюс один дополнительный на каждые 16 семафоров подключений и рабочих процессов (см. формулу в Таблице 17.1). Параметр SEMMNI
определяет максимальное число наборов семафоров, которые могут существовать в системе в один момент времени. Таким образом, его значение должно быть не меньше чем ceil((max_connections + autovacuum_max_workers + max_wal_senders + max_worker_processes + 6) / 16)
. В качестве временного решения проблем, которые вызываются этими ограничениями, но обычно сопровождаются некорректными сообщениями функции semget
, например, «No space left on device» (На устройстве не осталось места) можно уменьшить число разрешённых соединений.
В некоторых случаях может потребоваться увеличить SEMMAP
как минимум до уровня SEMMNS
. Если в системе есть такой параметр (а во многих системах его нет), он определяет размер карты ресурсов семафоров, в которой выделяется запись для каждого непрерывного блока семафоров. Когда набор семафоров освобождается, эта запись либо добавляется к существующей соседней записи, либо регистрируется как новая запись в карте. Если карта переполняется, освобождаемые семафоры теряются (до перезагрузки). Таким образом, фрагментация пространства семафоров может со временем привести к уменьшению числа доступных семафоров.
Другие параметры, связанные с «аннулированием операций» с семафорами, например, SEMMNU
и SEMUME
, на работу Postgres Pro не влияют.
При использовании семафоров POSIX требуемое их количество не отличается от количества для System V, то есть по одному семафору на разрешённое подключение (max_connections), на разрешённый рабочий процесс автоочистки (autovacuum_max_workers), разрешённый процесс-передатчик WAL (max_wal_senders) и фоновый процесс (max_worker_processes). На платформах, где предпочитается этот вариант, отсутствует определённый лимит ядра на количество семафоров POSIX.
- AIX
Для таких параметров, как
SHMMAX
, никакая дополнительная настройка не должна требоваться, так как система, похоже, позволяет использовать всю память в качестве разделяемой. Подобная конфигурация используется обычно и для других баз данных, например, для DB/2.Однако может понадобиться изменить глобальные параметры
ulimit
в/etc/security/limits
, так как стандартные жёсткие ограничения на размер (fsize
) и количество файлов (nofiles
) могут быть недостаточно большими.- FreeBSD
Параметры разделяемой памяти по умолчанию вполне приемлемы, если вы не выберете в
shared_memory_type
вариантsysv
. Семафоры System V на этой платформе не используются.Значения параметров IPC по умолчанию можно изменить, используя возможности
sysctl
илиloader
. С помощьюsysctl
можно задать следующие параметры:#
sysctl kern.ipc.shmall=32768
#
sysctl kern.ipc.shmmax=134217728
Чтобы эти изменения сохранялись после перезагрузки, измените
/etc/sysctl.conf
.Если вы выбрали в
shared_memory_type
вариантsysv
, возможно, вы захотите настроить ядро так, чтобы разделяемая память System V всегда находилась в ОЗУ и никогда не выгружалась в пространство подкачки. Это можно сделать, установив с помощьюsysctl
параметрkern.ipc.shm_use_phys
.Если вы запускаете сервер в «камере» FreeBSD, установите для параметра
sysvshm
значениеnew
, чтобы у сервера было собственное отдельное пространство имён разделяемой памяти System V. (До версии 11.0 во FreeBSD требовалось разрешать общий доступ из камер к пространству имён IPC ведущего узла и принимать меры для недопущения конфликтов.)- NetBSD
Параметры разделяемой памяти по умолчанию вполне приемлемы, если вы не выберете в
shared_memory_type
вариантsysv
. Обычно имеет смысл увеличитьkern.ipc.semmni
иkern.ipc.semmns
, так как их значения по умолчанию в NetBSD слишком малы.Параметры IPC можно изменить, воспользовавшись командой
sysctl
, например:$
sysctl -w kern.ipc.semmni=100
Чтобы эти параметры сохранялись после перезагрузки, измените
/etc/sysctl.conf
.Если вы выбрали в
shared_memory_type
вариантsysv
, возможно, вы захотите настроить ядро так, чтобы разделяемая память System V всегда находилась в ОЗУ и никогда не выгружалась в пространство подкачки. Это можно сделать, установив с помощьюsysctl
параметрkern.ipc.shm_use_phys
.- OpenBSD
Параметры разделяемой памяти по умолчанию вполне приемлемы, если вы не выберете в
shared_memory_type
вариантsysv
Обычно имеет смысл увеличитьkern.seminfo.semmni
иkern.seminfo.semmns
, так как их значения по умолчанию в OpenBSD слишком малы.Параметры IPC можно изменить, воспользовавшись командой
sysctl
, например:$
sysctl kern.seminfo.semmni=100
Чтобы эти параметры сохранялись после перезагрузки, измените
/etc/sysctl.conf
.- HP-UX
Значения по умолчанию как правило вполне удовлетворяют обычным потребностям.
Параметры IPC можно установить в менеджере системного администрирования (System Administration Manager, SAM) в разделе → . Установив нужные параметры, выполните операцию (Создать ядро).
- Linux
Параметры разделяемой памяти по умолчанию вполне приемлемы, если вы не выберете в
shared_memory_type
вариантsysv
. И даже в этом случае их потребуется увеличить только для старых ядер, в которых эти параметры по умолчанию имеют маленькие значения. Семафоры System V на этой платформе не используются.Параметры разделяемой памяти можно изменить, воспользовавшись командой
sysctl
. Например, так можно выделить 16 ГБ:$
sysctl -w kernel.shmmax=17179869184
$
sysctl -w kernel.shmall=4194304
Чтобы сохранить эти изменения после перезагрузки, воспользуйтесь файлом
/etc/sysctl.conf
.- macOS
Параметры разделяемой памяти и семафоров по умолчанию вполне приемлемы, если вы не выберете в
shared_memory_type
вариантsysv
.Для настройки разделяемой памяти в macOS рекомендуется создать файл
/etc/sysctl.conf
и записать в него присваивания переменных следующим образом:kern.sysv.shmmax=4194304 kern.sysv.shmmin=1 kern.sysv.shmmni=32 kern.sysv.shmseg=8 kern.sysv.shmall=1024
Заметьте, что в некоторых версиях macOS, все пять параметров разделяемой памяти должны быть установлены в
/etc/sysctl.conf
, иначе их значения будут проигнорированы.Значение
SHMMAX
должно быть кратно 4096.SHMALL
на этой платформе измеряется в страницах (по 4 КБ).Все параметры, кроме
SHMMNI
можно изменить «на лету», воспользовавшись командой sysctl. Но тем не менее лучше задавать выбранные вами значения в/etc/sysctl.conf
, чтобы они сохранялись после перезагрузки.- Solaris
illumos Параметры разделяемой памяти по умолчанию вполне приемлемы для большинства применений Postgres Pro. По умолчанию Solaris устанавливает в
SHMMAX
четверть объёма ОЗУ. Чтобы выбрать другое значение, задайте соответствующий параметр проекта, связанного с пользователемpostgres
. Например, выполните от имениroot
такую команду:projadd -c "Postgres Pro DB User" -K "project.max-shm-memory=(privileged,8GB,deny)" -U postgres -G postgres user.postgres
Эта команда создаёт проект
user.postgres
и устанавливает максимальный объём разделяемой памяти для пользователяpostgres
равным 8 ГБ. Это изменение вступает в силу при следующем входе этого пользователя или при перезапуске Postgres Pro (не перезагрузке конфигурации). При этом подразумевается, что Postgres Pro выполняется пользователемpostgres
в группеpostgres
. Перезагружать систему после этой команды не нужно.Для серверов баз данных, рассчитанных на большое количество подключений, рекомендуется также изменить следующие параметры:
project.max-shm-ids=(priv,32768,deny) project.max-sem-ids=(priv,4096,deny) project.max-msg-ids=(priv,4096,deny)
Кроме того, если Postgres Pro у вас выполняется внутри зоны, может понадобиться также увеличить лимиты на использование ресурсов зоны. Получить дополнительную информацию о
проектах
и командеprctl
можно в Руководстве системного администратора (System Administrator's Guide), «Главе 2: Проекты и задачи» (Chapter2: Projects and Tasks).
17.4.2. RemoveIPC в systemd
Если используется systemd, необходимо позаботиться о том, чтобы ресурсы IPC (включая разделяемую память) не освобождались преждевременно операционной системой. Это особенно актуально при сборке и установке Postgres Pro из исходного кода. Пользователей дистрибутивных пакетов Postgres Pro это касается в меньшей степени, так как пользователь postgres
обычно создаётся как системный пользователь.
Параметр RemoveIPC
в logind.conf
определяет, должны ли объекты IPC удаляться при полном выходе пользователя из системы. На системных пользователей это не распространяется. Этот параметр по умолчанию включён в стандартной сборке systemd, но в некоторых дистрибутивах операционных систем он по умолчанию отключён.
Обычно негативный эффект включения этого параметра проявляется в том, что объекты разделяемой памяти, используемые для параллельного выполнения запросов, удаляются без видимых причин, что приводит к появлению ошибок и предупреждений при попытке открыть и удалить их, например:
WARNING: could not remove shared memory segment "/PostgreSQL.1450751626": No such file or directory
(ПРЕДУПРЕЖДЕНИЕ: ошибка при удалении сегмента разделяемой памяти "/PostgreSQL.1450751626": Нет такого файла или каталога) Различные типы объектов IPC (разделяемая память/семафоры, System V/POSIX) обрабатываются в systemd несколько по-разному, поэтому могут наблюдаться ситуации, когда некоторые ресурсы IPC не удаляются так, как другие. Однако полагаться на эти тонкие различия не рекомендуется.
Событие «выхода пользователя из системы» может произойти при выполнении задачи обслуживания или если администратор войдёт под именем postgres
, а затем выйдет, либо случится что-то подобное, так что предотвратить это довольно сложно.
Какой пользователь является «системным», определяется во время компиляции systemd, исходя из значения SYS_UID_MAX
в /etc/login.defs
.
Скрипт упаковывания и развёртывания сервера должен предусмотрительно создавать пользователя postgres
как системного пользователя, используя команды useradd -r
, adduser --system
или равнозначные.
Если же учётная запись пользователя была создана некорректно и изменить её невозможно, рекомендуется задать
RemoveIPC=no
в /etc/systemd/logind.conf
или другом подходящем файле конфигурации.
Внимание
Необходимо предпринять минимум одно из этих двух действий, иначе сервер Postgres Pro будет очень нестабильным.
17.4.3. Ограничения ресурсов
В Unix-подобных операционных системах существуют различные типы ограничений ресурсов, которые могут влиять на работу сервера Postgres Pro. Особенно важны ограничения на число процессов для пользователя, число открытых файлов и объём памяти для каждого процесса. Каждое из этих ограничений имеет «жёсткий» и «мягкий» предел. Мягкий предел действительно ограничивает использование ресурса, но пользователь может увеличить его значение до жёсткого предела. Изменить жёсткий предел может только пользователь root. За изменение этих параметров отвечает системный вызов setrlimit
. Управлять этими ресурсами в командной строке позволяет встроенная команда ulimit
(в оболочках Bourne) и limit
(csh). В системах семейства BSD различными ограничениями ресурсов, устанавливаемыми при входе пользователя, управляет файл /etc/login.conf
. За подробностями обратитесь к документации операционной системы. Для Postgres Pro интерес представляют параметры maxproc
, openfiles
и datasize
. Они могут задаваться, например так:
default:\ ... :datasize-cur=256M:\ :maxproc-cur=256:\ :openfiles-cur=256:\ ...
(Здесь -cur
обозначает мягкий предел. Чтобы задать жёсткий предел, нужно заменить это окончание на -max
.)
Ядро также может устанавливать общесистемные ограничения на использование некоторых ресурсов.
В Linux максимальное число открытых файлов, которое поддерживает ядро, определяется параметром ядра
fs.file-max
. Изменить этот предел можно, воспользовавшись командойsysctl -w fs.file-max=
. Чтобы эти изменения сохранялись после перезагрузки, следует добавить присваивание в файлN
/etc/sysctl.conf
. Максимальное число файлов для одного процесса задаётся при компиляции ядра; за дополнительными сведения обратитесь к/usr/src/linux/Documentation/proc.txt
.
Сервер Postgres Pro использует для обслуживания каждого подключения отдельный процесс, так что возможное число процессов должно быть не меньше числа разрешённых соединений плюс число процессов, требуемых для остальной системы. Это обычно не проблема, но когда в одной системе работает множество серверов, предел может быть достигнут.
В качестве максимального числа открытых файлов по умолчанию обычно выбираются «социально-ориентированные» значения, позволяющие использовать одну систему нескольким пользователям так, чтобы ни один из них не потреблял слишком много системных ресурсов. Если вы запускаете в системе несколько серверов, это должно вполне устраивать, но на выделенных машинах может возникнуть желание увеличить этот предел.
С другой стороны, некоторые системы позволяют отдельным процессам открывать очень много файлов и если это делают сразу несколько процессов, они могут легко исчерпать общесистемный предел. Если вы столкнётесь с такой ситуацией, но не захотите менять общесистемное ограничение, вы можете ограничить использование открытых файлов сервером Postgres Pro, установив параметр конфигурации max_files_per_process.
Ещё одно ограничение в ядре, с которым можно столкнуться, когда устанавливается большое количество клиентских подключений, — максимальная длина очереди подключений к сокету. Если количество запросов на подключение за короткий промежуток времени превышает этот максимум, некоторые из них будут отклонены до того, как главный процесс сможет их обработать, при этом клиенты получат неинформативное сообщение об ошибке подключения типа «Resource temporarily unavailable» (Ресурс временно недоступен) или «Connection refused» (Не удалось подключиться). Предел длины очереди на многих платформах по умолчанию составляет 128. Чтобы увеличить его, настройте соответствующий параметр ядра через sysctl и перезапустите главный процесс. Этот параметр называется net.core.somaxconn
в Linux, kern.ipc.soacceptqueue
в последних версиях FreeBSD и kern.ipc.somaxconn
в macOS и на других платформах BSD.
17.4.4. Чрезмерное выделение памяти в Linux
В Linux механизм виртуальной памяти по умолчанию работает не оптимально для Postgres Pro. Вследствие того, что ядро выделяет память в чрезмерном объёме, оно может уничтожить главный управляющий процесс Postgres Pro (postmaster), если при выделении памяти процессу Postgres Pro или другому процессу виртуальная память будет исчерпана.
Когда это происходит, вы можете получить примерно такое сообщение ядра (где именно искать это сообщение, можно узнать в документации вашей системы):
Out of Memory: Killed process 12345 (postgres).
Это сообщение говорит о том, что процесс postgres
был уничтожен из-за нехватки памяти. Хотя существующие подключения к базе данных будут работать по-прежнему, новые подключения приниматься не будут. Чтобы восстановить работу сервера, Postgres Pro придётся перезапустить.
Один из способов обойти эту проблему — запускать Postgres Pro на компьютере, где никакие другие процессы не займут всю память. Если физической памяти недостаточно, решить проблему также можно, увеличив объём пространства подкачки, так как уничтожение процессов при нехватке памяти происходит только когда заканчивается и физическая память, и место в пространстве подкачки.
Если памяти не хватает по вине самого Postgres Pro, эту проблему можно решить, изменив конфигурацию сервера. В некоторых случаях может помочь уменьшение конфигурационных параметров, связанных с памятью, а именно shared_buffers
, work_mem
и hash_mem_multiplier
. В других случаях проблема может возникать, потому что разрешено слишком много подключений к самому серверу баз данных. Чаще всего в такой ситуации стоит уменьшить число подключений max_connections
и организовать внешний пул соединений.
«Чрезмерное выделение» памяти можно предотвратить, изменив поведение ядра. Хотя при этом OOM killer (уничтожение процессов при нехватке памяти) всё равно может вызываться, вероятность такого уничтожения значительно уменьшается, а значит поведение системы становится более стабильным. Для этого нужно включить режим строгого выделения памяти, воспользовавшись sysctl
:
sysctl -w vm.overcommit_memory=2
либо поместив соответствующую запись в /etc/sysctl.conf
. Возможно, вы также захотите изменить связанный параметр vm.overcommit_ratio
. За подробностями обратитесь к документации ядра https://www.kernel.org/doc/Documentation/vm/overcommit-accounting.
Другой подход, который можно применить (возможно, вместе с изменением vm.overcommit_memory
), заключается в исключении процесса postmaster из числа возможных жертв при нехватке памяти. Для этого нужно задать для свойства поправка очков OOM этого процесса значение -1000
. Проще всего это можно сделать, выполнив
echo -1000 > /proc/self/oom_score_adj
в скрипте запуска управляющего процесса непосредственно перед тем, как запускать postmaster. Заметьте, что делать это надо под именем root, иначе ничего не изменится, поэтому проще всего вставить эту команду в стартовый скрипт, принадлежащий пользователю root. Если вы делаете это, вы также должны установить в данном скрипте эти переменные окружения перед запуском главного процесса:
export PG_OOM_ADJUST_FILE=/proc/self/oom_score_adj export PG_OOM_ADJUST_VALUE=0
С такими параметрами дочерние процессы главного будут запускаться с обычной, нулевой поправкой очков OOM, так что при необходимости механизм OOM сможет уничтожать их. Вы можете задать и другое значение для PG_OOM_ADJUST_VALUE
, если хотите, чтобы дочерние процессы исполнялись с другой поправкой OOM. (PG_OOM_ADJUST_VALUE
также можно опустить, в этом случае подразумевается нулевое значение.) Если вы не установите PG_OOM_ADJUST_FILE
, дочерние процессы будут работать с той же поправкой очков OOM, которая задана для главного процесса, что неразумно, так как всё это делается как раз для того, чтобы главный процесс оказался на особом положении.
17.4.5. Огромные страницы в Linux
Использование огромных страниц (huge pages) снижает накладные расходы при работе с большими непрерывными блоками памяти, что характерно для Postgres Pro, особенно при большом объёме shared_buffers. Чтобы такие страницы можно было задействовать в Postgres Pro, ядро должно быть собрано с параметрами CONFIG_HUGETLBFS=y
и CONFIG_HUGETLB_PAGE=y
. Также вам понадобится настроить параметр ядра vm.nr_hugepages
. Чтобы оценить требуемое количество огромных страниц, запустите Postgres Pro без поддержки огромных страниц и определите размер сегмента анонимной разделяемой памяти процесса postmaster, а также узнайте размер огромной страницы, воспользовавшись файловой системой /proc
. Например, вы можете получить:
$head -1 $PGDATA/postmaster.pid
4170 $pmap 4170 | awk '/rw-s/ && /zero/ {print $2}'
6490428K $grep ^Hugepagesize /proc/meminfo
Hugepagesize: 2048 kB
В данном случае 6490428
/ 2048
даёт примерно 3169.154
, так что нам потребуется минимум 3170
огромных страниц, и мы можем задать это значение так:
$ sysctl -w vm.nr_hugepages=3170
Большее значение стоит указать, если огромные страницы будут использоваться и другими программами в этой системе. Не забудьте добавить этот параметр в /etc/sysctl.conf
, чтобы он действовал и после перезагрузки.
Иногда ядро не может выделить запрошенное количество огромных страниц сразу, поэтому может потребоваться повторить эту команду или перезагрузить систему. (Немедленно после перезагрузки должен быть свободен больший объём памяти для преобразования в огромные страницы.) Чтобы проверить текущую ситуацию с размещением огромных страниц, выполните:
$ grep Huge /proc/meminfo
Также может потребоваться дать пользователю операционной системы, запускающему сервер БД, право использовать огромные страницы, установив его группу в vm.hugetlb_shm_group
с помощью sysctl, и/или разрешить блокировать память, выполнив ulimit -l
.
По умолчанию Postgres Pro использует огромные страницы, когда считает это возможным, а в противном случае переходит к обычным страницам. Чтобы задействовать огромные страницы принудительно, можно установить для huge_pages значение on
в postgresql.conf
. Заметьте, что с таким значением Postgres Pro не сможет запуститься, если не получит достаточного количества огромных страниц.
Более подробно о механизме огромных страниц в Linux можно узнать в документации ядра: https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt.