.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2002 Andries Brouwer (aeb@cwi.nl)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dirfd 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
dirfd \- получение файлового дескриптора потока каталога
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <sys/types.h>\fP
\fB#include <dirent.h>\fP
.PP
\fBint dirfd(DIR *\fP\fIdirp\fP\fB);\fP
.fi
.PP
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBdirfd\fP():
.nf
    /* Since glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH ОПИСАНИЕ
Функция \fBdirfd\fP() возвращает файловый дескриптор, связанный с потоком
каталога \fIdirp\fP.
.PP
Этот файловый дескриптор используется внутри функции потоком каталога. В
результате он полезен только для функций, которые не зависят и не изменяют
положение в файле, например \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
.sp 1
.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>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .