fpathconf()

Получить значение параметра настроек для файла

Прототип:

#include <unistd.h>
long fpathconf( int filedes,
int name );

Аргументы:

filedes
Дескриптор файла, значение параметра настроек которого нужно получить.
name
Название параметра настроек.

Библиотека:

libc

Описание:

Функция fpathconf() возвращает значение параметра настроек, определенного name, ассоциированного с файлом filedes.

Параметры настройки определены в <confname.h> и включают минимум следющие значения:

_PC_ASYNC_IO
Определен (не равен -1), если для файла поддерживается асинхронный ввод/вывод.
_PC_CHOWN_RESTRICTED
Если определен (не равен -1), указывает, что использование функции chown() ограничено процессом с соответствующими правами и изменением идентификатора группы файла на эффективный идентификатор группы процесса или на один из дополнительных идентификаторов группы.
_PC_LINK_DIR
Определен (не равен -1), если файловая система допускает удаление ссылок на директории.
_PC_LINK_MAX
Максимальное значение счетчика ссылок файла.
_PC_MAX_CANON
Максимальное количество байт в каноничном буфере ввода терминала (буфере редактирования).
_PC_MAX_INPUT
Максимальное количество байт в буфере сырого ввода терминала.
_PC_NAME_MAX
Максимальное число байт в имени файла (не включая завершающий нулевой символ).
_PC_NO_TRUNC
Если определен (не равен -1), указывает, что использование компонентов пути к файлу длиннее, чем значение, заданное _PC_NAME_MAX, вызывает ошибку.
_PC_PATH_MAX
Максимальное число байт в пути к файлу (не включая завершающий нулевой символ).
_PC_PIPE_BUF
Максимальное число байт, которое может быть автоматически записано в канал.
_PC_PRIO_IO
Определен (не равен -1), если для файла поддерживается приоретизированный ввод/вывод.
_PC_SYNC_IO
Определен (не равен -1), если для файла поддерживается синхронный ввод/вывод.
_PC_VDISABLE
Если определен (не равен -1), то является символьным значением, которое используется для индивидуального отключения специальных управляющих символов в управляющей структуре struct termios.

Возвращаемое значение:

Запрошенный параметр настроек. Если возникла ошибка, функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EINVAL
Аргумент name некорректен или параметр настроек не поддерживается для filedes.
EBADF
Аргумент filedes некорректен.

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int main()
{
long value;
value = fpathconf( 0, _PC_MAX_INPUT );
printf( "Input buffer size is %ld bytes\n", value );
return (EXIT_SUCCESS);
}

Классификация:

POSIX 1003.1

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

confstr(), pathconf(), sysconf(), struct termios




Предыдущий раздел: Описание API системной библиотеки