ИМЯ¶

posix_fadvise - предварительно декларирует вариант доступа для данных файла

СИНТАКСИС¶

#include <fcntl.h>

int posix_fadvise(int fd, off_t offset, off_t len, int advice);

posix_fadvise():

ОПИСАНИЕ¶

Программы могут использовать posix_fadvise() для объявления намерений осуществить доступ к файлу данных в скором будущем определённым образом, тем самым позволяя ядру выполнить некоторые операции по оптимизации.

Аргумент advice применяется к (не обязательно существующей) области, начинающейся с offset, длиной len байт (или до конца файла, если len равно 0) внутри файла, на который ссылается fd. Аргумент advice не является привязкой; он всего лишь выражает ожидание приложения.

Допустимые значения advice:

POSIX_FADV_NORMAL

Указывает, что приложение не может подсказать тип доступа для указанных данных. Если не указано предположение для открываемого файла, то используется предположение по умолчанию.

POSIX_FADV_SEQUENTIAL

Приложение ожидает последовательный доступ к указанным данным (чтение выполняется начиная с младших адресов).

POSIX_FADV_RANDOM

Указанные данные будут запрашиваться в случайном порядке.

POSIX_FADV_NOREUSE

Указанные данные будут запрошены только один раз.

В ядрах до версии 2.6.18, для POSIX_FADV_NOREUSE использовалась такая же семантика что и у POSIX_FADV_WILLNEED. Это, вероятно, было дефектом; начиная с ядра 2.6.18 для этого флага нет операции.

POSIX_FADV_WILLNEED

Указанные данные будут запрошены в скором будущем.

При POSIX_FADV_WILLNEED запускается неблокировочное чтение указанной области в страницу кэша. Число неблокированных данных может быть уменьшено ядром в зависимости от загрузки виртуальной памяти (несколько мегабайт памяти наверняка будут выделены, а больше, обычно, и не бывает нужно).

POSIX_FADV_DONTNEED

Указанные данные не будут запрошены в скором будущем.

При указании POSIX_FADV_DONTNEED вызов пытается высвободить кэшированные страницы, связанные с указанной областью. Это полезно, например, при потоковой обработке больших файлов. Программа может периодически запрашивать ядро об освобождении уже использованных кэшированных данных, так что полезные кэшированные страницы не будут освобождаться.

Запросы на удаление частичных страниц игнорируются. Предпочтительней сохранять необходимые данные, а не удалять ненужные. Если приложению требуется, чтобы данные считались подходящими для удаления, то offset и len должны быть выровнены по границе страницы.

Реализация может пытаться записать неактуальные (dirty) страницы указанную область, но это не гарантируется. Все не записанные неактуальные страницы не будут освобождены. Если приложение хочет обязательно освободить неактуальные страницы, то оно сначала должно вызвать fsync(2) или fdatasync(2).

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

При успешном выполнении возвращается 0. В случае ошибки возвращается номер ошибки.

ОШИБКИ¶

EBADF

Аргумент fd не является правильным файловым дескриптором.

EINVAL

Неверное значение advice.

ESPIPE

Указанный файловый дескриптор ссылается на канал (pipe) или FIFO (в этом случае в Linux до версии 2.6.16, возвращал EINVAL, хотя согласно POSIX ошибка должна быть ESPIPE).

ВЕРСИИ¶

Поддержка в ядре впервые появилась в Linux 2.5.60; используемый системный вызов называется fadvise64(). Поддержка в библиотеке glibc появилась в версии 2.2; обёрточная функция называется posix_fadvise().

Начиная с Linux 3.18 поддержка данного системного вызова необязательна, она зависит от того, собрано ли ядро с параметром CONFIG_ADVISE_SYSCALLS.

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

POSIX.1-2001, POSIX.1-2008. Заметим, что в POSIX.1-2001 TC1 тип аргумента len был изменён с size_t на off_t.

ЗАМЕЧАНИЯ¶

В Linux POSIX_FADV_NORMAL устанавливает окно упреждающего чтения согласно используемому размеру по умолчанию для ниже лежащего устройства; POSIX_FADV_SEQUENTIAL удваивает этот размер, а POSIX_FADV_RANDOM отменяет упреждающее чтение вообще. Эти изменения влияют на весь файл, а не только на указанную его область (но другие открытые обработчики файлов на этом файле не изменяются).

Содержимое буферного кэша ядра может быть очищено через интерфейс /proc/sys/vm/drop_caches, описанный в proc(5).

Можно получить снимок страниц файла, которые располагаются в буферном кэше: открыть файл, отобразить его через mmap(2) и затем применить mincore(2) к отображению.

long arm_fadvise64_64(int fd, int advice,
                      loff_t offset, loff_t len);

ДЕФЕКТЫ¶

В ядрах до версии 2.6.6, если значение len равнялось 0, то это воспринималось дословно как «ноль байт», а не как «все байты до конца файла».

СМ. ТАКЖЕ¶

fincore(1), mincore(2), readahead(2), sync_file_range(2), posix_fallocate(3), posix_madvise(3)

ЗАМЕЧАНИЯ¶

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

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alexey, Azamat Hackimov <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Kogan, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

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

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