Всё для linux

man 2 sync

Администратор — Fri, 24 Nov 2017 02:37:57 GMT

ИМЯ

sync, syncfs - записывает кэши файловых систем на диск

ОБЗОР

#include
void sync(void);

int syncfs(int fd);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

sync():
_XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии glibc <= 2.19: */ _BSD_SOURCE

syncfs():
_GNU_SOURCE

ОПИСАНИЕ

Вызов sync() приводит к записи в файловую систему всех отложенных изменений метаданных
файловой системы и кэшированных файловых данных.

Вызов syncfs() подобен sync(), но синхронизирует только файловую систему, содержащую файл,
на который указывает открытый файловый дескриптор fd.

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

При нормальном завершении работы syncfs() возвращает 0. В случае ошибки возвращается -1, а
errno устанавливается в соответствующее значение.

ОШИБКИ

Вызов sync() всегда выполняется без ошибок.

Вызов syncfs() может завершиться с ошибкой, по крайней мере, по следующей причине:

EBADF Значение fd не является правильным файловым дескриптором.

ВЕРСИИ

Системный вызов syncfs() впервые появился в Linux 2.6.39; поддержка в glibc добавлена в
версии 2.14.

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

sync(): POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

syncfs() есть только в Linux.

ЗАМЕЧАНИЯ

Начиная с glibc 2.2.2 Linux-прототип sync() стал соответствовать различным стандартам. В
glibc 2.21 и старее он объявлялся как «int sync(void)» и вызов sync() всегда возвращал 0.

В соответствии со стандартной спецификацией (например POSIX.1-2001), sync() только планирует
запись, и может закончить работу до того как запись будет на самом деле произведена. Однако
в Linux выполняется ожидание завершения операций ввода-вывода и поэтому sync() или syncfs()
предоставляют такие же гарантии как fsync при вызове для каждого файла в системе или
файловой системы, соответственно.

man 2 symlinkat

Администратор — Fri, 24 Nov 2017 02:37:36 GMT

ИМЯ

symlink, symlinkat - создаёт новое имя для файла

ОБЗОР

#include
int symlink(const char *target, const char *linkpath);

#include #include
int symlinkat(const char *target, int newdirfd, const char *linkpath);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

symlink():
_XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L
|| /* в версии glibc <= 2.19: */ _BSD_SOURCE

symlinkat():
Начиная с glibc 2.10:
_POSIX_C_SOURCE >= 200809L
До glibc 2.10:
_ATFILE_SOURCE

ОПИСАНИЕ

Вызов symlink() создаёт символьную ссылку с именем linkpath, которая содержит строку target.

Символьные ссылки интерпретируются «на лету», как будто бы содержимое ссылки было
подставлено вместо пути, по которому идёт поиск файла или каталога.

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

Символьная ссылка (также известная как «мягкая ссылка») может указывать как на существующий,
так и на несуществующий файлы; в последнем случае такая ссылка называется повисшей
(dangling).

Права доступа символьной ссылки не имеют значения; принадлежность определённому владельцу
игнорируется при переходе по ссылке, но проверяется при удалении или переименовании ссылки,
а также ссылки в каталог с установленным закрепляющим (sticky) битом (S_ISVTX).

Если linkpath существует, то он не будет перезаписан.

symlinkat()
Системный вызов symlinkat() работает также как системный вызов symlink(), за исключением
случаев, описанных здесь.

Если в linkpath задан относительный путь, то он считается относительно каталога, на который
ссылается файловый дескриптор newdirfd (а не относительно текущего рабочего каталога
вызывающего процесса, как это делается в symlink()).

Если в linkpath задан относительный путь и значение newdirfd равно AT_FDCWD, то linkpath
рассматривается относительно текущего рабочего каталога вызывающего процесса (как
symlink()).

Если в linkpath задан абсолютный путь, то newdirfd игнорируется.
EDQUOT Исчерпана пользовательская квота на ресурсы файловой системы. Ресурсами могут быть
иноды или дисковые блоки, в зависимости от реализации файловой системы.

EEXIST linkpath уже существует.

EFAULT Значение target или linkpath указывают за пределы доступного адресного пространства.

EIO Произошла ошибка ввода-вывода.

ELOOP Во время определения linkpath встретилось слишком много символьных ссылок.

ENAMETOOLONG
Слишком длинное значение аргумента target или linkpath.

ENOENT Компонент пути linkpath не существует или является повисшей символьной ссылкой или
значение target или linkpath равно пустой строке.

ENOMEM Недостаточное количество памяти ядра.

ENOSPC На устройстве, содержащем файл, нет места для создания нового элемента каталога.

ENOTDIR
Компонент пути, использованный как каталог в linkpath, в действительности таковым не
является.

EPERM Файловая система, содержащая linkpath, не поддерживает создание символьных ссылок.

EROFS linkpath расположен в файловой системе, доступной только для чтения.

В symlinkat() дополнительно могут возникнуть следующие ошибки:

EBADF Значение newdirfd не является правильным файловым дескриптором.

ENOENT Значение linkpath является относительным путём и newdirfd ссылается на каталог,
который был удалён.

ENOTDIR
Значение linkpath содержит относительный путь и newdirfd содержит файловый
дескриптор, указывающий на файл, а не на каталог.

ВЕРСИИ

Системный вызов symlinkat() был добавлен в ядро Linux версии 2.6.16; поддержка в glibc
доступна с версии 2.4.

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

symlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.

symlinkat(): POSIX.1-2008.

ЗАМЕЧАНИЯ

Не выполняется проверка target.

При удаление имени, на который ссылается символьная ссылка, произойдёт удаление файла (если
только у него нет других жёстких ссылок). Если такое поведение нежелательно, используйте
link(2).

man 2 symlink

Администратор — Fri, 24 Nov 2017 02:37:11 GMT

ИМЯ

symlink, symlinkat - создаёт новое имя для файла

ОБЗОР

ОПИСАНИЕ

ВЕРСИИ

Системный вызов symlinkat() был добавлен в ядро Linux версии 2.6.16; поддержка в glibc
доступна с версии 2.4.

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

symlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.

symlinkat(): POSIX.1-2008.

ЗАМЕЧАНИЯ

man 2 swapon

Администратор — Fri, 24 Nov 2017 02:36:48 GMT

ИМЯ

swapon, swapoff - запускает/останавливает подкачку данных в файл/устройство

ОБЗОР

#include #include
int swapon(const char *path, int swapflags);
int swapoff(const char *path);

ОПИСАНИЕ

swapon() включает использование файла или блочного устройства, указанного в path, в качестве
подкачки данных. swapoff() выключает использование файла или блочного устройства, указанного
в path, в качестве подкачки данных.

Если при вызове swapon() в аргументе swapflags установлен флаг SWAP_FLAG_pFER, то новое
пространство подкачки будет иметь больший приоритет, чем используемый по умолчанию.
Приоритет задаётся в swapflags следующим образом:

(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

Если в аргументе swapflags вызова swapon() указан флаг SWAP_FLAG_DISCARD, то освобождаемые
страницы подкачки будут исключены (discard) до того как они задействуются повторно (если
устройство подкачки поддерживает операцию исключения или обрезки). Это может улучшить
производительность на некоторых твердотельных накопителях, но, чаще всего, нет. Также
смотрите ЗАМЕЧАНИЯ.

Эти функции могут использоваться только привилегированным процессом (имеющим мандат
CAP_SYS_ADMIN).

Приоритет
Каждое пространство подкачки имеет приоритет, высокий или низкий. По умолчанию задается
низкий приоритет. Внутри пространств с низким приоритетом, новые пространства имеют ещё
меньший приоритет, чем старые.

Все приоритеты, установленные с помощью swapflags, выше используемого по умолчанию.
Приоритет может быть любым неотрицательным числом (определяется вызывающим). Большее
значение соответствует большему приоритету.

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

В Linux 1.3.6 работа ядра обычно следует этим правилам, но существуют исключения.

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

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

ОШИБКИ

EBUSY (для swapon()) Указанный path уже используется в качестве пространства подкачки.

EINVAL Файл path существует, но не ссылается на обычный файл или блочное устройство;

EINVAL (swapon()) Указанный путь не содержит правильной сигнатуры подкачки или располагается
в файловой системе, работающей в памяти, например, tmpfs(5).

ENOMEM Не хватает памяти ядра для запуска процесса подкачки.

EPERM Вызывающий не имеет мандата CAP_SYS_ADMIN. Или превышен лимит количества используемых
пространств подкачки; см. ЗАМЕЧАНИЯ далее.

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

Эти функции предназначены только для работы в Linux и не должны использоваться в переносимых
программах. Второй параметр swapflags впервые появился в Linux 1.3.2.

ЗАМЕЧАНИЯ

Раздел или путь должны быть подготовлены к подкачке при помощи mkswap(8).

Есть верхний предел на количество используемых файлов подкачки, он определяется константой
ядра MAX_SWAPFILES. До ядра версии 2.4.10 значение MAX_SWAPFILES было равно 8; начиная с
ядра 2.4.10, значение стало 32. Начиная с ядра 2.6.18, предел уменьшается на 2 (то есть
стало 30), если ядро собирается с параметром CONFIG_MIGRATION (который резервирует 2
элемента таблицы подкачки для возможности переноса страниц mbind(2) и migrate_pages(2)).
Начиная с ядра 2.6.32, предел ещё сокращается на 1, если ядро собирается с параметром
CONFIG_MEMORY_FAILURE.

Исключение (discard) страниц подкачки появилось в ядре версии 2.6.29, флаг условия
SWAP_FLAG_DISCARD появился в ядре версии 2.6.36, но пока при вызове swapon() исключается вся
область подкачки, даже если этот флаг не задан.

СМОТРИТЕ ТАКЖЕ

mkswap(8), swapoff(8), swapon(8)

man 2 swapoff

Администратор — Fri, 24 Nov 2017 02:36:27 GMT

ИМЯ

swapon, swapoff - запускает/останавливает подкачку данных в файл/устройство

ОБЗОР

#include #include
int swapon(const char *path, int swapflags);
int swapoff(const char *path);

ОПИСАНИЕ

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

ОШИБКИ

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

ЗАМЕЧАНИЯ

СМОТРИТЕ ТАКЖЕ

mkswap(8), swapoff(8), swapon(8)

man 2 subpage_prot

Администратор — Fri, 24 Nov 2017 02:36:03 GMT

ИМЯ

subpage_prot - определяет подстраничную защиту адресного диапазона

ОБЗОР

long subpage_prot(unsigned long addr, unsigned long len,
uint32_t *map);

Замечание: В glibc нет обёрточной функции для данного системного вызова; смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ

Системный вызов (есть только для PowerPC) subpage_prot() предоставляет возможность контроля
доступа к отдельным 4 КБ подстраницам в системах, где размер страницы равен 64 КБ.

Карта защиты налагается на страницы памяти для области, начинающейся с addr и имеющей размер
len байт. Значения обоих аргументов должны быть выровнены на 64-КБ границу.

Карта защиты задаётся в буфере, на который указывает map. В карте на каждую 4-килобайтную
подстраницу выделяется 2 бита; таким образом, в каждом 32-битном слове задаётся защита для
16 4-килобайтных подстраниц внутри 64-килобайтной страницы (поэтому количество 32-битных
слов, на которые указывает map, должно быть равно количеству 64-килобайтных страниц,
указанному в len). Каждое 2-битное поле в карте защиты может быть: 0 — полный доступ, 1 —
защита от записи, 2 или 3 — запрет на любой доступ.

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

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

ОШИБКИ

EFAULT Буфер, на который ссылается map, недоступен.

EINVAL Некорректное значение аргумента addr или len. Оба значения должны быть кратны размеру
системной страницы, и они не должны указывать на область вне адресного пространства
процесса, или на область, которая состоит из огромных страниц.

ENOMEM Не хватает памяти.

ВЕРСИИ

Данный системный вызов предоставляется для архитектуры PowerPC начиная с Linux 2.6.25. Для
его сборки в ядре должен быть указан параметр CONFIG_PPC_64K_PAGES. В библиотеке поддержка
данного вызова отсутствует.

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

Данный вызов есть только в Linux.

ЗАМЕЧАНИЯ

В glibc нет обёртки для данного системного вызова; запускайте его с помощью syscall(2).

Обычная страничная защита также работает (на уровне 64-килобайтных страниц); механизм
подстраничной защиты является дополнительным ограничением, поэтому указание 0 в 2-битном
поле не разрешит запись в страницу, которая защищена от записи другим способом.

Обоснование
Данный системный вызов предоставляется для облегчения написания эмуляторов, которые работают
с 64-КБ страницами в системах PowerPC. При эмуляции систем, в которых используется меньший
размер страницы (таких как x86), эмулятор не может использовать блок управления памятью
(MMU) и обычные системные вызовы управления защитой страниц (эмулятор может эмулировать MMU
с помощью ПО проверяя и, возможно, перераспределяя адрес при каждом обращении к памяти, но

Файл Documentation/vm/hugetlbpage.txt в дереве исходного кода ядра Linux

man 2 stty

Администратор — Fri, 24 Nov 2017 02:35:42 GMT

ИМЯ

afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock,
madvise1, mpx, prof, profil, putmsg, putpmsg, security, stty, tuxcall, ulimit, vserver -
нереализованные системные вызовы

ОБЗОР

Нереализованные системные вызовы.

ОПИСАНИЕ

Данные системные вызовы не реализованы в ядре Linux.

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

Эти системные вызовы всегда возвращают -1 и устанавливают для errno значение ENOSYS.

ЗАМЕЧАНИЯ

Заметим, что ftime(3), profil(3) и ulimit(3) реализованы в виде библиотечных функций.

Некоторые системные вызовы, такие как alloc_hugepages(2), free_hugepages(2), ioperm(2),
iopl(2) и vm86(2), существуют только для некоторых архитектур.

Некоторые системные вызовы, такие как ipc(2), create_module(2), init_module(2) и
delete_module(2), существуют в ядре Linux только, если при сборке ядра включена их
поддержка.

СМОТРИТЕ ТАКЖЕ

syscalls(2)

man 2 stime

Администратор — Fri, 24 Nov 2017 02:35:18 GMT

ИМЯ

stime - устанавливает системное время

ОБЗОР

#include
int stime(const time_t *t);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

stime():
начиная с glibc 2.19:
_DEFAULT_SOURCE
glibc 2.19 и старее:
_SVID_SOURCE

ОПИСАНИЕ

Вызов stime() устанавливает системное (не аппаратное) время и дату машины. Время, заданное в
t, измеряется в секундах с начала Эпохи, с 00:00:00 1 января 1970 года (UTC). Функцию
stime() может вызывать только суперпользователь.

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

ОШИБКИ

EFAULT Ошибка при получении информации из пространства пользователя.

EPERM Вызвавшему процессу не хватает прав. В Linux для этого требуется мандат CAP_SYS_TIME.

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

SVr4.

СМОТРИТЕ ТАКЖЕ

date(1), settimeofday(2), capabilities(7)

man 2 statx

Администратор — Fri, 24 Nov 2017 02:34:55 GMT

ИМЯ

statx - считывает состояние файла (расширенный вариант)

ОБЗОР

#include #include #include #include
int statx(int dirfd, const char *pathname, int flags,
unsigned int mask, struct statx *statxbuf);

Замечание: В glibc нет обёрточной функции для statx(); смотрите ЗАМЕЧАНИЯ.

ОПИСАНИЕ

Этот системный вызов возвращает информацию о файле, записывая её в буфер, на который
указывает statxbuf. Возвращаемый буфер представляет собой структуру следующего вида:

struct statx {
__u32 stx_mask; /* маска битов, показывающая
заполненные поля */
__u32 stx_blksize; /* размер блока ввода-вывода файловой системы */
__u64 stx_attributes; /* индикаторы дополнительных файловых атрибутов */
__u32 stx_nlink; /* количество жёстких ссылок */
__u32 stx_uid; /* идентификатор пользователя-владельца */
__u32 stx_gid; /* идентификатор группы-владельца */
__u16 stx_mode; /* тип файла и режим доступа */
__u64 stx_ino; /* номер иноды */
__u64 stx_size; /* полный размер в байтах */
__u64 stx_blocks; /* количество выделенных 512-байтовых блоков */
__u64 stx_attributes_mask;
/* маска, показывающая поддерживаемые атрибуты
в stx_attributes */

/* поля меток времени */
struct statx_timestamp stx_atime; /* последний доступ */
struct statx_timestamp stx_btime; /* создание */
struct statx_timestamp stx_ctime; /* последнее изменение состояния */
struct statx_timestamp stx_mtime; /* последнее изменение */

/* если файл представляет устройство, то в следующих
полях содержится идентификатор устройства */
__u32 stx_rdev_major; /* основной идентификатор */
__u32 stx_rdev_minor; /* дополнительный идентификатор */

/* поля идентификатора устройства с файловой системой,
в которой содержится файл */
__u32 stx_dev_major; /* основной идентификатор */
__u32 stx_dev_minor; /* дополнительный идентификатор */
};

Метки времени файла хранятся в структуре следующего вида:

struct statx_timestamp {
__s64 tv_sec; /* количество секунд с начала Эпохи (время UNIX) */
__u32 tv_nsec; /* количество наносекунд, начиная с tv_sec */
};

путями:

Абсолютный путь
Если pathname начинается с косой черты, то целевой файла задан абсолютным путём. В
этом случае значение dirfd игнорируется.

Относительный путь
Если pathname начинается не с косой черты и dirfd равно AT_FDCWD, то pathname
рассматривается относительно текущего рабочего каталога процесса.

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

По файловому дескриптору
Если значение pathname равно пустой строке и в flags (смотрите ниже) указан флаг
AT_EMPTY_PATH, то целевым файлом считается тот, на который указывает файловый
дескриптор в dirfd.

Значение flags можно использовать для уточнения поиска на основе пути. Оно составляется из
побитно слагаемых следующих констант:

AT_EMPTY_PATH
Если значение pathname равно пустой строке, то вызов выполняет действие с файлом, на
который ссылается dirfd (может быть получен с помощью open(2) с флагом O_PATH). В
этом случае dirfd может ссылаться на файл любого типа, а не только на каталог.

Если dirfd равно AT_FDCWD, то вызов использует текущий рабочий каталог.

Данный флаг существует только в Linux; для его получения определите _GNU_SOURCE.

AT_NO_AUTOMOUNT
Не выполнять автоматическое монтирование конечного компонента («basename») pathname,
если это каталог, который является точкой монтирования. Это позволяет вызывающему
получить атрибуты точки монтирования (а не расположения, где её предполагалось
смонтировать). Этот флаг можно использовать в инструментах, сканирующих каталоги, для
предотвращения массового автоматического монтирования каталогов в их точки
монтирования. Флаг AT_NO_AUTOMOUNT не учитывается, если к точке уже уже была
выполнено монтирование. Этот флаг есть только Linux; для его получения нужно задать
_GNU_SOURCE.

AT_SYMLINK_NOFOLLOW
Если значение pathname является символьной ссылкой, не разыменовывать её, а выдать
информацию о самой ссылке, подобно lstat(2).

Значение flags также может использоваться для контроля типа синхронизации, которое выполняет
ядро при опросе файла на удалённой файловой системе. Оно составляется из побитно слагаемых
следующих значений:

AT_STATX_SYNC_AS_STAT
Работать подобно stat(2). Используется по умолчанию и очень зависит от файловой
системы.

AT_STATX_FORCE_SYNC
Принудительно синхронизировать атрибуты с сервером. Может потребовать от сетевой
файловой системы выполнить запись данных для получения правильных меток времени.

STATX_TYPE Требуется stx_mode & S_IFMT
STATX_MODE Требуется stx_mode & ~S_IFMT
STATX_NLINK Требуется stx_nlink
STATX_UID Требуется stx_uid
STATX_GID Требуется stx_gid
STATX_ATIME Требуется stx_atime
STATX_MTIME Требуется stx_mtime
STATX_CTIME Требуется stx_ctime
STATX_INO Требуется stx_ino
STATX_SIZE Требуется stx_size
STATX_BLOCKS Требуется stx_blocks
STATX_BASIC_STATS [всё вышеперечисленное]
STATX_BTIME Требуется stx_btime
STATX_ALL [все доступные в данный момент поля]

Заметим, что ядро не не отклоняет значения в mask, отличные от вышеперечисленных. Вместо
этого оно просто информирует вызывающего, какие значения поддерживаются ядром и файловой
системой через поле statx.stx_mask. Поэтому не устанавливайте значение mask в UINT_MAX (все
биты), так как один или более бит в будущем могут использоваться для указания расширения
буфера.

Возвращаемая информация
Информация о состоянии целевого файла возвращается в структуре statx, на которую указывает
statxbuf. Она содержит stx_mask, в котором описывается возвращённая информация. Значение
stx_mask имеет тот же формат, что и аргумент mask, и установленные в нём бит показывают
какие поля были заполнены.

Стоит упомянуть, что ядро может вернуть поля, которые не был запрошены и запрошенные поля
могут быть не заполнены, в зависимости от поддержки в нижележащей файловой системе (поля,
которым были присвоены значение, но которые не были запрошены, можно игнорировать). В этих
случаях stx_mask будет не равно mask.

Если файловая система не поддерживает поле или если значение поле содержит непрезентабельное
значение (например, файл экзотического типа), то битовая маска в stx_mask, соответствующая
этому полю, будет очищена даже если пользователь запросил его, и в целях совместимости в
качестве значения, если возможно, будет помещена пустышка (например, в некоторых случаях
пустышки UID и GID могут задаваться при монтировании).

Файловая система также может заполнить поля, которые вызывающий не запрашивал, при условии,
что их значения доступны и это ничего стоит. Если это выполняется, то будут установлены
соответствующие биты в stx_mask.

Замечание: с целью производительности и простоты различные поля в структуре statx могут
содержать информацию о состоянии из различных моментов выполнения системного вызова.
Например, если изменяется stx_mode или stx_uid другим процессом посредством вызова chmod(2)
или chown(2), то stat() может вернуть старое значение stx_mode вместе с новым stx_uid, или
старое stx_uid вместе с новым stx_mode.

Помимо полей stx_mask (описанной выше) структура statx имеет следующие поля:

stx_blksize
«Предпочтительный» размер блока для эффективного ввода/вывода в файловой системе
(запись в файл более мелкими порциями может привести к неэффективному
чтению/изменению/повторной записи).

stx_attributes
Дополнительная информация о состоянии файла (подробности ниже).

stx_mode
Тип файла и режим. Дополнительную информацию смотрите в inode(7).

stx_ino
Номер иноды файла.

stx_size
Размер файла (если он обычный или является символьной ссылкой) в байтах. Размер
символьной ссылки равен длине пути файла, на который она ссылается, без конечного
нулевого байта.

stx_blocks
Количество блоков (по 512 байт), выделенных для файла на носителе (может быть меньше,
чем stx_size/512, когда в файле есть пропуски (holes)).

stx_attributes_mask
Маска, показывающая какие биты в stx_attributes поддерживаются VFS и файловой
системой.

stx_atime
Метка времени последнего доступа к файлу.

stx_btime
Метка времени создания файла.

stx_ctime
Метка времени последнего изменения состояния файла.

stx_mtime
Метка времени последнего изменения файла.

stx_dev_major и stx_dev_minor
Устройство, на котором находится файл (инода).

stx_rdev_major и stx_rdev_minor
Устройство, который этот файл (инода) представляет, если файл имеет блочный или
символьный тип устройства.

Дополнительную информацию об этих полях смотрите в inode(7).

Атрибуты файла
В поле stx_attributes содержится набор флагов (объединённых через ИЛИ), которые отображают
дополнительные атрибуты файла. Заметим, что для атрибута, не указанного как поддерживаемого
в stx_attributes_mask, имеющееся здесь значение является не корректным. Биты
stx_attributes_mask точно бит в бит соответствуют битам поля stx_attributes.

Флаги:

STATX_ATTR_COMpSSED
Файл сжат файловой системой и для доступа могут потребоваться дополнительные ресурсы.

STATX_ATTR_IMMUTABLE
Файл невозможно изменить: его нельзя переименовать или удалить, на этот файл нельзя
создать жёсткую ссылку и в него нельзя выполнить запись данных. Смотрите chattr(1).

STATX_ATTR_APPEND

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

ОШИБКИ

EACCES Запрещён поиск в одном из каталогов пути pathname (смотрите также
path_resolution(7)).

EBADF Значение dirfd не является правильным открытым файловым дескриптором.

EFAULT Значение pathname или statxbuf равно NULL или указывает на расположение вне
доступного процессу адресного пространства.

EINVAL Указано неверное значение в flags.

EINVAL В mask указан зарезервированный флаг.

ELOOP Во время определения пути встретилось слишком много символьных ссылок.

ENAMETOOLONG
Слишком длинное значение аргумента pathname.

ENOENT Компонент пути pathname не существует или в pathname указана пустая строка и в flags
не указан AT_EMPTY_PATH.

ENOMEM Не хватает памяти (например, памяти ядра).

ENOTDIR
Компонент префикса пути pathname содержит относительный путь и dirfd содержит
файловый дескриптор, указывающий на файл, а не на каталог.

ВЕРСИИ

Вызов statx() был добавлен в ядро Linux 4.11.

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

Вызов statx() есть только в Linux.

ЗАМЕЧАНИЯ

В glibc (пока) нет обёртки для системного вызова statx(); запускайте его с помощью
syscall(2).

СМОТРИТЕ ТАКЖЕ

ls(1), stat(1), access(2), chmod(2), chown(2), readlink(2), stat(2), utime(2),
capabilities(7), inode(7), symlink(7)

man 2 statvfs

Администратор — Fri, 24 Nov 2017 02:34:34 GMT

ИМЯ

statvfs, fstatvfs - получение статистики по файловой системе

ОБЗОР

#include
int statvfs(const char *path, struct statvfs *buf);
int fstatvfs(int fd, struct statvfs *buf);

ОПИСАНИЕ

Функция statvfs() возвращает информацию о смонтированной файловой системе. path является
путём любого файла, расположенного в смонтированной файловой системе. buf является
указателем на структуру statvfs, определённую примерно следующим образом:

struct statvfs {
unsigned long f_bsize; /* размер блока файловой системы */
unsigned long f_frsize; /* размер фрагмента */
fsblkcnt_t f_blocks; /* размер ФС в единицах f_frsize */
fsblkcnt_t f_bfree; /* количество свободных блоков */
fsblkcnt_t f_bavail; /* количество свободных блоков
для непривилегированных пользователей */
fsfilcnt_t f_files; /* количество inodes */
fsfilcnt_t f_ffree; /* количество свободных inodes */
fsfilcnt_t f_favail; /* количество свободных inodes
для непривилегированных пользователей */
unsigned long f_fsid; /* идентификатор файловой системы */
unsigned long f_flag; /* параметры монтирования */
unsigned long f_namemax; /* максимальная длина имени файла */
};

Типы fsblkcnt_t и fsfilcnt_t определены в файле используется тип unsigned long.

Значение поля f_flag — битовая маска различных параметров, которые были указаны при
монтировании этой файловой системы. В нём содержится ноль или несколько следующих флагов:

ST_MANDLOCK
Разрешена обязательная (mandatory) блокировка файловой системы (смотрите fcntl(2)).

ST_NOATIME
Не обновлять времена доступа; смотрите mount(2).

ST_NODEV
Запретить доступ к специальным файлам устройств в этой файловой системе.

ST_NODIRATIME
Не обновлять времена доступа к каталогам; смотрите mount(2).

ST_NOEXEC
Исполнение программ в этой файловой системе запрещено.

ST_NOSUID
Биты set-user-ID и set-group-ID игнорируются в exec(3) для исполняемых файлов в этой
файловой системе.

ST_RDONLY
Файловая система смонтирована в режиме только для чтения.

осмысленные данные.

fstatvfs() возвращает такую же информацию об открытом файле через его ссылку на дескриптор
fd.

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

ОШИБКИ

EACCES (statvfs()) Нет права на поиск одного из компонентов префикса пути path (см. также
path_resolution(7)).

EBADF (fstatvfs()) fd не является корректным открытым дескриптором файла.

EFAULT Buf или path указывает на неправильный адрес.

EINTR Данный вызов был прерван сигналом; смотрите signal(7).

EIO При чтении файловой системы произошла ошибка ввода-вывода.

ELOOP (statvfs()) Было обнаружено слишком много символьных ссылок при трансляции path.

ENAMETOOLONG
(statvfs()) Слишком длинное значение аргумента path.

ENOENT (statvfs()) Файл, указанный в path, не существует.

ENOMEM Недостаточное количество памяти ядра.

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

ENOTDIR
(statvfs()) Один из компонентов префикса пути path не является каталогом.

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

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

┌──────────────────────┬──────────────────────┬──────────┐
│Интерфейс │ Атрибут │ Значение │
├──────────────────────┼──────────────────────┼──────────┤
│statvfs(), fstatvfs() │ Безвредность в нитях │ MT-Safe │
└──────────────────────┴──────────────────────┴──────────┘

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

POSIX.1-2001, POSIX.1-2008.

В POSIX.1 в поле f_flag определены только флаги ST_NOSUID и ST_RDONLY. Чтобы получить
определения остальных флагов нужно определить _GNU_SOURCE.

ЗАМЕЧАНИЯ

Для поддержки данной библиотечной функции в ядре Linux есть системные вызовы statfs(2) и
fstatfs(2).

pathconf(path, _PC_ALLOC_SIZE_MIN);
pathconf(path, _PC_REC_MIN_XFER_SIZE);

используют, соответственно, поля f_frsize, f_frsize и f_bsize, возвращаемые вызовом
statvfs() с аргументом path.

СМОТРИТЕ ТАКЖЕ

statfs(2)