.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu)
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH telldir 3 "31 октября 2023 г." "Linux man\-pages 6.06" 
.SH ИМЯ
telldir \- возвращает текущее положение в потоке каталога
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <dirent.h>\fP
.P
\fBlong telldir(DIR *\fP\fIdirp\fP\fB);\fP
.fi
.P
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.P
\fBtelldir\fP():
.nf
    _XOPEN_SOURCE
       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
       || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH ОПИСАНИЕ
Функция \fBtelldir\fP() возвращает текущее положение, связанное с потоком
каталога \fIdirp\fP.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
On success, the \fBtelldir\fP()  function returns the current location in the
directory stream.  On error, \-1 is returned, and \fIerrno\fP is set to indicate
the error.
.SH ОШИБКИ
.TP 
\fBEBADF\fP
Неверный дескриптор потока каталога \fIdirp\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBtelldir\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001, 4.3BSD.
.P
Up to glibc 2.1.1, the return type of \fBtelldir\fP()  was \fIoff_t\fP.
POSIX.1\-2001 specifies \fIlong\fP, and this is the type used since glibc 2.1.2.
.P
.\" https://lwn.net/Articles/544298/
В старых файловых системах возвращаемое \fBtelldir\fP() значение было просто
файловым смещением в каталоге. В современных файловых системах для
представления каталогов используются структуры деревьев или хэшей, а не
плоские таблицы. В таких файловых системах значение, возвращаемое
\fBtelldir\fP() (и используемое внутри \fBreaddir\fP(3)) — некая «подсказка»,
которая используется реализацией для получения позиции в
каталоге. Прикладные программы должны считать это значение «чёрным ящиком» и
\fIне\fP делать предположений о его содержимом.
.SH "СМ. ТАКЖЕ"
\fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
\fBscandir\fP(3), \fBseekdir\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
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 .