GETDENTS(2) | Podręcznik programisty Linuksa | GETDENTS(2) |
getdents - pobranie wpisów z katalogu
#include <unistd.h> #include <linux/types.h> #include <linux/dirent.h> #include <linux/unistd.h> _syscall3(int, getdents, uint, fd, struct dirent *, dirp, uint, count); int getdents(unsigned int fd, struct dirent *dirp, unsigned int count);
Uwaga! To tłumaczenie może być nieaktualne!
getdents odczytuje kolejne struktury dirent z katalogu wskazywanego przez fd do obszaru pamięci wskazywanego przez dirp. Parametr count jest rozmiarem obszaru pamięci.
Struktura dirent jest zadeklarowana następująco:
struct dirent {
long d_ino; /* numer i-węzła */
off_t d_off; /* offset do następnego dirent */
unsigned short d_reclen; /* długość tego dirent */
char d_name [NAZWA_MAX+1]; /* nazwa pliku (zakończona NUL) */ }
d_ino jest numerem i-węzła. d_off jest odległością od początku katalogu do początku następnej struktury dirent. d_reclen jest wielkością tej całej struktury dirent. d_name jest nazwą pliku zakończoną znakiem NUL.
Ta funkcja zastępuje readdir(2).
Po pomyślnym zakończeniu zwracana jest ilość odczytanych bajtów. Na końcu katalogu zwracane jest 0. Przy błędzie zwracane jest -1 i odpowiednio ustawiane errno.
SVr4, SVID. SVr4 dokumentuje dodatkowe błędy ENOLINK, EIO.
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.
1995-07-22 | Linux 1.3.6 |