Unix Man (Справочное руководство)



STATFS(2)


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]; /* Имя пакета */




Содержание  Назад  Вперед