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() получает значение строковой переменной, зависящей от конфигурации.
Если buf не равно NULL и значение len не равно нулю, то confstr() копирует строку в buf, укорачивая её до len - 1 байт, если это необходимо; также добавляет байт null (\(aq\0\(aq) в конец строки. Это может быть обнаружено сравнением возвращённого confstr() значения с len.
Аргумент 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. | |
Если 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);
abort(); confstr(_CS_PATH, pathbuf, n);
