.\" -*- 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 "2 maio 2024" "Linux man\-pages 6.8" 
.SH NOME
telldir \- retorna a localização atual no fluxo de diretório
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <dirent.h>\fP
.P
\fBlong telldir(DIR *\fP\fIdirp\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\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 DESCRIÇÃO
A função \fBtelldir\fP() retorna a localização atual associada com o fluxo de
diretório \fIdirp\fP.
.SH "VALOR DE RETORNO"
No caso de sucesso, a função \fBtelldir()\fP retorna a localização atual no
fluxo de diretório. No caso de erro, \-1 é retornado e \fIerrno\fP é definido
para indicar o erro.
.SH ERROS
.TP 
\fBEBADF\fP
Descritor de fluxo de diretório \fIdirp\fP inválido.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBtelldir\fP()
T}	Thread safety	MT\-Safe
.TE
.SH PADRÕES
POSIX.1\-2008.
.SH HISTÓRICO
POSIX.1\-2001, 4.3BSD.
.P
Até o glibc 2.1.1, o tipo de retorno de \fBtelldir\fP() era
\fIoff_t\fP. POSIX.1\-2001 especifica \fIlong\fP, e este é o tipo usado desde o
glibc 2.1.2.
.P
.\" https://lwn.net/Articles/544298/
Nos primeiros sistemas de arquivos, o valor retornado por \fBtelldir\fP() era
um simples deslocamento de arquivo dentro de um diretório. Os sistemas de
arquivos modernos usam estruturas de árvore ou hash, em vez de tabelas
simples, para representar diretórios. Nesses sistemas de arquivos, o valor
retornado por \fBtelldir\fP() (e usado internamente por \fBreaddir\fP(3)) é um
"cookie" usado pela implementação para derivar uma posição dentro de um
diretório. Os programas aplicativos devem tratar isso estritamente como um
valor opaco, fazendo suposições sobre seu conteúdo.
.SH "VEJA TAMBÉM"
\fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
\fBscandir\fP(3), \fBseekdir\fP(3)
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Daniel Chicayban <daniel@chicayban.com.br>,
Ricardo C.O.Freitas <english.quest@best-service.com>
e
Rafael Fontenelle <rafaelff@gnome.org>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .