.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Modified Sat Jul 24 19:53:02 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" FIXME Many more values for 'name' are supported, some of which
.\" are documented under 'info libc confstr'.
.\" See <bits/confname.h> for the rest.
.\" These should all be added to this page.
.\" See also the POSIX.1-2001 specification of confstr()
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH confstr 3 "5 февраля 2023 г." "Linux man\-pages 6.03" 
.SH ИМЯ
confstr \- получает строковые переменные конфигурации
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <unistd.h>\fP
.PP
\fBsize_t confstr(int \fP\fIname\fP\fB, char \fP\fIbuf\fP\fB[.\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
.fi
.PP
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBconfstr\fP():
.nf
    _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE
.fi
.SH ОПИСАНИЕ
\fBconfstr\fP() получает значение строковой переменной, зависящей от
конфигурации.
.PP
Аргумент \fIname\fP это название системной переменной, значение которой нужно
получить. Поддерживаются следующие переменные:
.TP 
\fB_CS_GNU_LIBC_VERSION\fP (только библиотека GNU C; начиная с glibc 2.3.2)
Строка с версией библиотеки GNU C в системе (например, «glibc 2.3.4»).
.TP 
\fB_CS_GNU_LIBPTHREAD_VERSION\fP (только библиотека GNU C; начиная с glibc 2.3.2)
Строка, определяющая реализацию POSIX, которую предоставляет библиотека C
(например, «NPTL 2.3.4» или «linuxthreads\-0.10»).
.TP 
\fB_CS_PATH\fP
Значение переменной \fBPATH\fP, в которой указывается где можно найти все
утилиты стандарта POSIX.2.
.PP
If \fIbuf\fP is not NULL and \fIsize\fP is not zero, \fBconfstr\fP()  copies the
value of the string to \fIbuf\fP truncated to \fIsize \- 1\fP bytes if necessary,
with a null byte (\[aq]\e0\[aq]) as terminator.  This can be detected by
comparing the return value of \fBconfstr\fP()  against \fIsize\fP.
.PP
If \fIsize\fP is zero and \fIbuf\fP is NULL, \fBconfstr\fP()  just returns the value
as defined below.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
If \fIname\fP is a valid configuration variable, \fBconfstr\fP()  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 \fIsize\fP, which means that the value in \fIbuf\fP is truncated.
.PP
Если значение \fIname\fP — корректная переменная настройки, но эта переменная
не имеет значения, то \fBconfstr\fP() возвращает 0. Если значение \fIname\fP не
соответствует ни одной корректной переменной настройки, то \fBconfstr\fP()
возвращает 0 и \fIerrno\fP устанавливается в \fBEINVAL\fP.
.SH ОШИБКИ
.TP 
\fBEINVAL\fP
Некорректное значение \fIname\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
\fBconfstr\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.hy
.ad
.sp 1
.SH СТАНДАРТЫ
POSIX.1\-2001, POSIX.1\-2008.
.SH ПРИМЕРЫ
Следующий фрагмент кода определяет расположение всех системных утилит
POSIX.2:
.PP
.in +4n
.EX
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);
.EE
.in
.SH "СМ. ТАКЖЕ"
\fBgetconf\fP(1), \fBsh\fP(1), \fBexec\fP(3), \fBfpathconf\fP(3), \fBpathconf\fP(3),
\fBsysconf\fP(3), \fBsystem\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
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>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .