posix_fadvise(2) | System Calls Manual | posix_fadvise(2) |
posix_fadvise - предварительно декларирует вариант доступа для данных файла
Standard C library (libc, -lc)
#include <fcntl.h>
int posix_fadvise(int fd, off_t offset, off_t len, int advice);
posix_fadvise():
_POSIX_C_SOURCE >= 200112L
Программы могут использовать posix_fadvise() для объявления намерений осуществить доступ к файлу данных в скором будущем определённым образом, тем самым позволяя ядру выполнить некоторые операции по оптимизации.
Аргумент advice применяется к (не обязательно существующей) области, начинающейся с offset, длиной len байт (или до конца файла, если len равно 0) внутри файла, на который ссылается fd. Аргумент advice не является привязкой; он всего лишь выражает ожидание приложения.
Допустимые значения advice:
При успешном выполнении возвращается 0. В случае ошибки возвращается номер ошибки.
Kernel support first appeared in Linux 2.5.60; the underlying system call is called fadvise64(). Library support has been provided since glibc 2.2, via the wrapper function 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) к отображению.
Обёрточная функция в библиотеке C называется posix_fadvise(). Используемый ей системный вызов называется fadvise64() (на некоторых архитектурах — fadvise64_64()); разница между ними в том, что в библиотечной функциитип аргумента len равен size_t, а у системного вызова — loff_t.
На некоторых архитектурах требуется, чтобы 64-битные аргументы были выровнены в подходящей паре регистров (подробности в syscall(2)). На таких архитектурах показанная в СИНТАКСИСЕ форма вызова posix_fadvise() приводила бы пустой трате регистра для заполнения между аргументами fd и offset. Поэтому на этих архитектурах определена версия системного вызова с исправленным порядком аргументов, иначе используется формат как у posix_fadvise().
Например, начиная с Linux 2.6.14, в ARM есть следующий системный вызов:
long arm_fadvise64_64(int fd, int advice, loff_t offset, loff_t len);
Данные, зависящие от архитектуры, детали, обычно, скрываются от приложений в обёрточной функции glibc posix_fadvise(), которая использует соответствующий архитектуре системный вызов.
Before Linux 2.6.6, if len was specified as 0, then this was interpreted literally as "zero bytes", rather than as meaning "all bytes through to the end of the file".
fincore(1), mincore(2), readahead(2), sync_file_range(2), posix_fallocate(3), posix_madvise(3)
Русский перевод этой страницы руководства был сделан 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.
4 декабря 2022 г. | Linux man-pages 6.03 |