ИМЯ

       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⟩.