STATFS(2)
НАЗВАНИЕ
statfs, fstatfs - получение информации о файловой системе
СИНТАКСИС
#include <sys/types.h>
#include <sys/statfs.h>
int statfs (path, buf, len, fstyp)
char *path;
struct statfs *buf;
int len, fstyp;
int fstatfs (fildes, buf, len, fstyp)
int fildes;
struct statfs *buf;
int len, fstyp;
ОПИСАНИЕ
Системный вызов statfs возвращает "родовой суперблок",
описывающий файловую систему. Вызов может использоваться для запроса информации как о смонтированной, так и о
несмонтированной файловой системе; использование вызова
несколько различается в этих двух случаях. В обоих случаях аргумент buf является указателем на структуру
(описываемую ниже), поля которой заполняются в результате выполнения системного вызова, а аргумент len задает количество байт информации, которые система должна
поместить в структуру. Значение len не должно превышать
размер структуры: sizeof (struct statfs) и обычно len
содержит именно этот размер; если аргумент len содержит
меньшее значение, то система поместит в структуру ровно
заданное количество байт, что дает возможность в более
поздних версиях добавлять к структуре statfs новые поля
без перетрансляции старых программ.
Если исследуемая файловая система в текущий момент
смонтирована, то маршрутное имя path должно быть именем
файла, который располагается в данной файловой системе.
В этом случае тип файловой системы известен ОС, и аргумент fstyp должен быть нулевым. Для несмонтированной
файловой системы маршрутное имя path должно быть именем
специального блочного файла, содержащего ее, и аргумент
fstyp должен содержать (ненулевой) тип файловой системы. В обоих случаях право доступа на чтение, запись или
выполнение названного файла не требуется, но все каталоги, перечисленные в маршрутном имени, должны быть
доступны на поиск.
Структура statfs, на которую указывает аргумент buf,
состоит из следующих полей:
short f_fstyp; /* Тип файловой системы */
short f_bsize; /* Размер блока */
short f_frsize; /* Размер сегмента */
long f_blocks; /* Общее количество блоков */
long f_bfree; /* Счетчик свободных блоков */
long f_files; /* Общее кол-во описателей файлов */
long f_ffree; /* Счетчик свобод. описат. файлов */
char f_fname [6]; /* Имя тома */
char f_fpack [6]; /* Имя пакета */
Системный вызов fstatfs отличается от statfs только
тем, что файл идентифицируется не маршрутным именем, а
дескриптором открытого файла fildes, сформированным в
результате успешного завершения следующих системных вызовов: open(2), creat(2), dup(2), fcntl(2) или pipe(2).
Системный вызов statfs является более поздним вариантом
системного вызова ustat(2) и в новых программах предпочтение следует отдавать statfs.
Системные вызовы statfs и fstatfs завершаются неудачей,
если выполнено хотя бы одно из следующих условий:
- [ENOTDIR]
- Компонент маршрута не является каталогом.
- [ENOENT]
- Заданный файл не существует.
- [EACCES]
- Нет права на поиск для компонента маршрута.
- [EFAULT]
- Аргументы buf или path указывают за пределы
отведенного процессу адресного пространства.
- [EBADF]
- Аргумент fildes не является корректным
дескриптором открытого файла.
- [EINVAL]
- Аргумент fstyp содержит некорректный тип
файловой системы; path задает не специальный блочный файл и аргумент fstyp не равен
0; аргумент len отрицателен или превышает
sizeof (struct statfs).
- [ENOLINK]
- Маршрутное имя path указывает на удаленный
компьютер, связи с которым в данный момент
нет.
- [EMULTIHOP] Компоненты path требуют многократного обращения к удаленным компьютерам.
СМ. ТАКЖЕ
chmod(2), chown(2), creat(2), link(2), mknod(2),
pipe(2), read(2), time(2), unlink(2), utime(2),
ustat(2), write(2), fs(4).
ДИАГНОСТИКА
При успешном завершении результат равен 0; в случае
ошибки возвращается -1, а переменной errno присваивается код ошибки.