RGBCube/serenity
1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-07-27 12:47:35 +00:00
Code Issues Activity Actions

LibC: Add POSIX spec comments for dirent APIs

Browse source
This commit is contained in:
Brian Gianforcaro 2021-12-27 19:25:02 -08:00 • committed by Andreas Kling
parent 52beeebe70
commit fa5d81be7a
1 changed files with 8 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Userland/Libraries/LibC/dirent.cpp
View file

@ -21,6 +21,7 @@
extern "C" { extern "C" {
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/opendir.html
DIR* opendir(const char* name) DIR* opendir(const char* name)
{ {
int fd = open(name, O_RDONLY | O_DIRECTORY); int fd = open(name, O_RDONLY | O_DIRECTORY);
@ -29,6 +30,7 @@ DIR* opendir(const char* name)
return fdopendir(fd); return fdopendir(fd);
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/fdopendir.html
DIR* fdopendir(int fd) DIR* fdopendir(int fd)
{ {
if (fd == -1) if (fd == -1)
@ -41,6 +43,7 @@ DIR* fdopendir(int fd)
return dirp; return dirp;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/closedir.html
int closedir(DIR* dirp) int closedir(DIR* dirp)
{ {
if (!dirp || dirp->fd == -1) if (!dirp || dirp->fd == -1)
@ -53,6 +56,7 @@ int closedir(DIR* dirp)
return rc; return rc;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/rewinddir.html
void rewinddir(DIR* dirp) void rewinddir(DIR* dirp)
{ {
free(dirp->buffer); free(dirp->buffer);
@ -133,6 +137,7 @@ static int allocate_dirp_buffer(DIR* dirp)
return 0; return 0;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/readdir.html
dirent* readdir(DIR* dirp) dirent* readdir(DIR* dirp)
{ {
if (!dirp) if (!dirp)
@ -166,6 +171,7 @@ static bool compare_sys_struct_dirent(sys_dirent* sys_ent, struct dirent* str_en
&& strncmp(sys_ent->name, str_ent->d_name, namelen) == 0; && strncmp(sys_ent->name, str_ent->d_name, namelen) == 0;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/readdir_r.html
int readdir_r(DIR* dirp, struct dirent* entry, struct dirent** result) int readdir_r(DIR* dirp, struct dirent* entry, struct dirent** result)
{ {
if (!dirp || dirp->fd == -1) { if (!dirp || dirp->fd == -1) {
@ -209,12 +215,14 @@ int readdir_r(DIR* dirp, struct dirent* entry, struct dirent** result)
return 0; return 0;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/dirfd.html
int dirfd(DIR* dirp) int dirfd(DIR* dirp)
{ {
VERIFY(dirp); VERIFY(dirp);
return dirp->fd; return dirp->fd;
} }
// https://pubs.opengroup.org/onlinepubs/9699919799/functions/scandir.html
int scandir(const char* dir_name, int scandir(const char* dir_name,
struct dirent*** namelist, struct dirent*** namelist,
int (*select)(const struct dirent*), int (*select)(const struct dirent*),