Commit e4528f
2026-08-26 12:19:20 Bob Green: -/-| /dev/null .. programming/man pages/dirfd(3).md | |
| @@ 0,0 1,46 @@ | |
| + | % dirfd(3) Version 1.0 | Library Functions Manual |
| + | *** |
| + | |
| + | ## NAME |
| + | |
| + | **dirfd** — get directory stream file descriptor |
| + | |
| + | ### LIBRARY |
| + | |
| + | libmega C library (-lmega) |
| + | |
| + | ### SYNOPSIS |
| + | |
| + | ``` |
| + | #include <dirent.h> |
| + | |
| + | int dirfd(DIR *dirp); |
| + | ``` |
| + | |
| + | ### DESCRIPTION |
| + | The function **dirfd()** returns the file descriptor associated with the directory stream **_dirp_**. |
| + | |
| + | Not really sure why you'd want this as messing with the fd directly will cause all sorts of bad thimgs to happen, but the function is in the standard librarry, so here it is. You have been warned. |
| + | |
| + | ### RETURN VALUE |
| + | Never succeeds as this implementation doesn't work that way, so -1 is always returned, and **_errno_** is set to indicate the error. |
| + | |
| + | ### ERRORS |
| + | **==NAME==()** can fail with the following errors: |
| + | |
| + | * ENOTSUP - this implementation does not associate a file descriptor with the directory stream. |
| + | |
| + | ### NOTES |
| + | |
| + | None. |
| + | |
| + | ### BUGS |
| + | |
| + | See GitHub Issues: <https://github.com/znac049/mega-micros-sbc3/issues> |
| + | |
| + | ### AUTHOR |
| + | |
| + | Bob Green <bob@chippers.org.uk> |
| + | |
| + | ### SEE ALSO |
| + | **open(2)**, **closedir(3)**, **opendir(3)**, **readdir(3)**, **rewinddir(3)**, **seekdir(3)**, **telldir(3)** |