.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dirfd 3 "17 мая 2025 г." "Справочные страницы Linux 6.15" 
.SH НАИМЕНОВАНИЕ
dirfd \- получение файлового дескриптора потока каталога
.SH БИБЛИОТЕКА
Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP)
.SH ОБЗОР
.nf
\fB#include <sys/types.h>\fP
\fB#include <dirent.h>\fP
.P
\fBint dirfd(DIR *\fP\fIdirp\fP\fB);\fP
.fi
.P
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.P
\fBdirfd\fP():
.nf
    /* Начиная с glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH ОПИСАНИЕ
Функция \fBdirfd\fP() возвращает файловый дескриптор, связанный с потоком
каталога \fIdirp\fP.
.P
Этот файловый дескриптор используется внутри функции потоком каталога. В
результате он полезен только для функций, которые не зависят и не изменяют
положение в файле, например \fBfstat\fP(2) и \fBfchdir\fP(2). Он автоматически
закрывается при вызове \fBclosedir\fP(3).
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
On success, \fBdirfd\fP()  returns a file descriptor (a nonnegative integer).
On error, \-1 is returned, and \fIerrno\fP is set to indicate the error.
.SH ОШИБКИ
.\" glibc 2.8
В POSIX.1\-2008 определены две ошибки, ни одна из которых не возвращается
текущей реализацией.
.TP 
\fBEINVAL\fP
Значение \fIdirp\fP не указывает на допустимый поток каталога.
.TP 
\fBENOTSUP\fP
Реализация не поддерживает связь файлового дескриптора с каталогом.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBdirfd\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
POSIX.1\-2008.
.SH ИСТОРИЯ
.\" It is present in libc5 (since 5.1.2) and in glibc 2.
4.3BSD\-Reno (not in 4.2BSD).
.SH "СМОТРИТЕ ТАКЖЕ"
\fBopen\fP(2), \fBopenat\fP(2), \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3),
\fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и)
Yuri Kozlov <yuray@komyakino.ru>,
Иван Павлов <pavia00@gmail.com>
и
Kirill Rekhov <krekhov.dev@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 .