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.1-2008.

ПРИМЕР
Следующий фрагмент кода определяет расположение всех системных утилит 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), pathconf(3), sysconf(3), system(3)