NOMBRE

       telldir - devuelve la posición actual en un flujo directorio

SINOPSIS

       #include <dirent.h>

       long telldir(DIR *dirp);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

       telldir():
        _XOPEN_SOURCE
           || /* Glibc since 2.19: */ _DEFAULT_SOURCE
           || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPCIÓN

       La función telldir() devuelve la posición actual asociada al flujo de directorio dirp.

VALOR DEVUELTO

       On  success, the telldir()  function returns the current location in the directory stream.
       On error, -1 is returned, and errno is set appropriately.

ERRORES

       EBADF  Descriptor de flujo de directorio inválido dirp.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌──────────┬────────────────────┬───────────────────┐
       │Interfaz  │ Atributo           │ Valor             │
       ├──────────┼────────────────────┼───────────────────┤
       │telldir() │ Seguridad del hilo │ Multi-hilo seguro │
       └──────────┴────────────────────┴───────────────────┘

CONFORME A

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

NOTAS

       In glibc up to version 2.1.1, the return  type  of  telldir()   was  off_t.   POSIX.1-2001
       specifies long, and this is the type used since glibc 2.1.2.

       In  early  filesystems, the value returned by telldir()  was a simple file offset within a
       directory.  Modern filesystems use tree or hash structures, rather than  flat  tables,  to
       represent  directories.   On  such filesystems, the value returned by telldir()  (and used
       internally by readdir(3))  is a "cookie" that is used by the implementation  to  derive  a
       position within a directory.  Application programs should treat this strictly as an opaque
       value, making no assumptions about its contents.

VÉASE TAMBIÉN

       closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar  una
       descripción  del  proyecto, información sobre cómo informar errores y la última versión de
       esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del  manual  fue  creada  por  Gerardo  Aburruzaga
       García <gerardo.aburruzaga@uca.es>

       Esta  traducción  es  documentación  libre;  lea  la  GNU General Public License Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones  de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción de esta página del manual, envíe un correo
       electrónico a debian-l10n-spanish@lists.debian.org ⟨⟩.

                                        15 Septiembre 2017                             TELLDIR(3)