.\" -*- 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 "15 июня 2024 г." "Справочные страницы Linux 6.9.1" 
.SH ИМЯ
confstr \- получает строковые переменные конфигурации
.SH БИБЛИОТЕКА
Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <unistd.h>\fP
.P
\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
.P
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.P
\fBconfstr\fP():
.nf
    _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE
.fi
.SH ОПИСАНИЕ
\fBconfstr\fP() получает значение строковой переменной, зависящей от
конфигурации.
.P
Аргумент \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.
.P
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]\[rs]0\[aq]) as terminator.  This can be detected by
comparing the return value of \fBconfstr\fP()  against \fIsize\fP.
.P
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.
.P
Если значение \fIname\fP — корректная переменная настройки, но эта переменная
не имеет значения, то \fBconfstr\fP() возвращает 0. Если значение \fIname\fP не
соответствует ни одной корректной переменной настройки, то \fBconfstr\fP()
возвращает 0 и \fIerrno\fP устанавливается в \fBEINVAL\fP.
.SH ОШИБКИ
.TP 
\fBEINVAL\fP
Некорректное значение \fIname\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBconfstr\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001.
.SH ПРИМЕРЫ
Следующий фрагмент кода определяет расположение всех системных утилит
POSIX.2:
.P
.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
Этот перевод является свободной программной документацией; он распространяется
на условиях общедоступной лицензии GNU (GNU General Public License - GPL,
.UR https://www.gnu.org/licenses/gpl-3.0.html
.UE
версии 3 или более поздней) в отношении
авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
.PP
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста,
сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу
.MT <debian-l10n-russian@lists.debian.org>
списка рассылки русских переводчиков
.ME .