.\" -*- 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 "23 июля 2024 г." "Linux man\-pages 6.12" 
.SH НАИМЕНОВАНИЕ
telldir \- возвращает текущее положение в потоке каталога
.SH БИБЛИОТЕКА
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>
и
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 .