confstr(3) получает строковые переменные конфигурации

ОБЗОР

#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);