Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (t - v) telldir(3)
ERRORS
If any of the following conditions occurs, the telldir( ) function sets errno to the corresponding
value:
[EBADF] The dir_pointer parameter does not point to a valid directory structure open for
reading. This error is returned instead of [EFAULT] if the process has copied
and altered the structure pointed to by the dir_pointer parameter after the system
has freed the buffer that contains the structure.
[EBIGDIR] The last name returned by a call to the readdir( ) function was preceeded by
more than 65534 names with the same two leading characters. The directory is
too big.
[EFAULT] The dir_pointer parameter does not point to a valid directory structure open for
reading.
RELATED INFORMATION
Functions: closedir(3), mkdir(2), opendir(3), readdir(3), rewinddir(3), rmdir(2), seekdir(3).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. The following
features are affected in the HP implementation:
• After a call to one of the exec set of functions, all open directory streams are closed
automatically.
• The ramifications of having both the parent and child processes access the same OSS
directory after a call to the fork( ) or tdm_fork( ) function are undefined.
• The consequences of calling directory functions with a dir_pointer parameter that does
not refer to a currently opened directory stream are defined. (The error value [EBADF]
or [EFAULT] is returned or a SIGSEGV or SIGILL signal is returned.)
• The error values [EBADF], [EBIGDIR], or [EFAULT] can be returned.
The following are HP extensions to the XPG4 specification:
• The error values [EBADF], [EBIGDIR], and [EFAULT] can be returned.
• The telldir( ) function can return -1.
527187-017 Hewlett-Packard Company 7−27