confstr(3)

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

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <unistd.h>

size_t confstr(int name, char buf[.size], size_t size);

    Требования макроса тестирования свойств для 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.

If buf is not NULL and size is not zero, confstr() copies the value of the string to buf truncated to size - 1 bytes if necessary, with a null byte ('\0') as terminator. This can be detected by comparing the return value of confstr() against size.

If size is zero and buf is NULL, confstr() just returns the value as defined below.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
If name is a valid configuration variable, confstr() returns the number of bytes (including the terminating null byte) that would be required to hold the entire value of that variable. This value may be greater than size, which means that the value in buf is truncated.

Если значение 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)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.