1TELLDIR(3)                 Linux Programmer's Manual                TELLDIR(3)
2
3
4

NAME

6       telldir - return current location in directory stream
7

SYNOPSIS

9       #include <dirent.h>
10
11       long telldir(DIR *dirp);
12
13   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
14
15       telldir(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
16

DESCRIPTION

18       The telldir() function returns the current location associated with the
19       directory stream dirp.
20

RETURN VALUE

22       On success, the telldir() function returns the current location in  the
23       directory stream.  On error, -1 is returned, and errno is set appropri‐
24       ately.
25

ERRORS

27       EBADF  Invalid directory stream descriptor dirp.
28

CONFORMING TO

30       4.3BSD, POSIX.1-2001.
31

NOTES

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

SEE ALSO

38       closedir(3),   opendir(3),   readdir(3),   rewinddir(3),    scandir(3),
39       seekdir(3)
40

COLOPHON

42       This  page  is  part of release 3.25 of the Linux man-pages project.  A
43       description of the project, and information about reporting  bugs,  can
44       be found at http://www.kernel.org/doc/man-pages/.
45
46
47
48                                  2009-03-11                        TELLDIR(3)