CONFSTR(3)

ИМЯ
confstr - получает строковые переменные конфигурации

ОБЗОР
#include <unistd.h>

size_t confstr(int name, char *buf, size_t len);

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

confstr(): _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE

ОПИСАНИЕ
confstr() получает значение строковой переменной, зависящей от конфигурации.

Аргумент name это название системной переменной, значение которой нужно получить. Поддерживаются следующие переменные:

_CS_GNU_LIBC_VERSION (только библиотека GNU C; начиная с glibc 2.3.2)
    Строка с версией библиотеки GNU C в системе (например, «glibc 2.3.4»).

_CS_GNU_LIBPTHREAD_VERSION (только библиотека GNU C; начиная с glibc 2.3.2)
    Строка, определяющая реализацию POSIX, которую предоставляет библиотека C (например, «NPTL 2.3.4» или «linuxthreads-0.10»).

_CS_PATH
    Значение переменной PATH, в которой указывается где можно найти все утилиты стандарта POSIX.2.

Если buf не равно NULL и значение len не равно нулю, то confstr() копирует строку в buf, укорачивая её до len - 1 байт, если это необходимо; также добавляет байт null ('\0') в конец строки. Это может быть обнаружено сравнением возвращённого confstr() значения с len.

Если len равно нулю и buf равно NULL, то confstr() просто возвращает значение, как сказано ниже.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Если значение name — корректная переменная настройки, то confstr() возвращает количество байт (включая завершающий байт null), которое необходимо для хранения всего значения этой переменной. Это значение может быть больше len, что означает, что значение в buf обрезанное. Если значение name — корректная переменная настройки, но эта переменная не имеет значения, то confstr() возвращает 0. Если значение name не соответствует ни одной корректной переменной настройки, то confstr() возвращает 0 и errno устанавливается в EINVAL.

ОШИБКИ

EINVAL
    Некорректное значение name.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
confstr() | безвредность в нитях | безвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001.

ПРИМЕР
Следующий фрагмент кода определяет расположение всех системных утилит POSIX.2:
char *pathbuf;
size_t n;
n = confstr(_CS_PATH, NULL, (size_t) 0);
pathbuf = malloc(n);
if (pathbuf == NULL)
    abort();
confstr(_CS_PATH, pathbuf, n);

СМОТРИТЕ ТАКЖЕ
getconf(1), sh(1), exec(3), fpathconf(3) sysconf(3) pathconf(3) system(3)