Linux repositories inspector
GNU
2019-03-06

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

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 (\(aq\0\(aq) в конец строки. Это может быть обнаружено сравнением возвращённого 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);
⇧ Top