RepoMirrors
/
musl
mirror of git://git.musl-libc.org/musl
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
musl/include/dirent.h

80 lines
1.6 KiB
C
Raw Normal View History

initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifndef _DIRENT_H
#define _DIRENT_H
#ifdef __cplusplus
extern "C" {
#endif
#define __NEED_ino_t
#define __NEED_off_t
#include <bits/alltypes.h>
typedef struct __DIR_s DIR;
struct dirent
{
ino_t d_ino;
off_t d_off;
unsigned short d_reclen;
unsigned char d_type;
fix handling of d_name in struct dirent basically there are 3 choices for how to implement this variable-size string member: 1. C99 flexible array member: breaks using dirent.h with pre-C99 compiler. 2. old way: length-1 string: generates array bounds warnings in caller. 3. new way: length-NAME_MAX string. no problems, simplifies all code. of course the usable part in the pointer returned by readdir might be shorter than NAME_MAX+1 bytes, but that is allowed by the standard and doesn't hurt anything.
2011-06-06 22:04:28 +00:00
char d_name[256];
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
};
d_fileno alias for d_ino in dirent this is nonstandard but since POSIX reserved d_ prefix in dirent.h we might as well define it unconditionally. some programs depend on it.
2011-04-03 14:24:59 +00:00
#define d_fileno d_ino
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int closedir(DIR *);
DIR *fdopendir(int);
DIR *opendir(const char *);
struct dirent *readdir(DIR *);
int readdir_r(DIR *, struct dirent *, struct dirent **);
void rewinddir(DIR *);
void seekdir(DIR *, long);
long telldir(DIR *);
int dirfd(DIR *);
int alphasort(const struct dirent **, const struct dirent **);
int scandir(const char *, struct dirent ***, int (*)(const struct dirent *), int (*)(const struct dirent **, const struct dirent **));
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
#if defined(_GNU_SOURCE) || defined(_BSD_SOURCE)
add macros for use with d_type extension field in dirent
2011-03-07 23:32:36 +00:00
#define DT_UNKNOWN 0
#define DT_FIFO 1
#define DT_CHR 2
#define DT_DIR 4
#define DT_BLK 6
#define DT_REG 8
#define DT_LNK 10
#define DT_SOCK 12
#define DT_WHT 14
#define IFTODT(x) ((x)>>12 & 017)
#define DTTOIF(x) ((x)<<12)
fix typos in dirent.h
2011-03-08 22:34:26 +00:00
#endif
add macros for use with d_type extension field in dirent
2011-03-07 23:32:36 +00:00
add (currently stubbed due to stubbed strverscmp) versionsort function based on patch by Emil Renner Berthing, with minor changes to dirent.h for LFS64 and organization of declarations this code should work unmodified once a real strverscmp is added, but I've been hesitant to add it because the GNU strverscmp behavior is harmful in a lot of cases (for instance if you have numeric filenames in hex). at some point I plan on trying to design a variant of the algorithm that behaves better on a mix of filename styles.
2012-06-13 15:14:38 +00:00
#ifdef _GNU_SOURCE
int versionsort(const struct dirent **, const struct dirent **);
#endif
publicly expose getdents api under _BSD_SOURCE
2012-08-13 18:50:30 +00:00
#ifdef _BSD_SOURCE
int getdents(int, struct dirent *, size_t);
#endif
_GNU_SOURCE is supposed to imply _LARGEFILE64_SOURCE this is ugly and stupid, but now that the *64 symbol names exist, a lot of broken GNU software detects them in configure, then either breaks during build due to missing off64_t definition, or attempts to compile without function declarations/prototypes. "fixing" it here is easier than telling everyone to add yet another feature test macro to their builds.
2012-06-04 12:03:56 +00:00
#if defined(_LARGEFILE64_SOURCE) || defined(_GNU_SOURCE)
add support for ugly *64 functions with _LARGEFILE64_SOURCE musl does not support legacy 32-bit-off_t whatsoever. off_t is always 64 bit, and correct programs that use off_t and the standard functions will just work out of the box. (on glibc, they would require -D_FILE_OFFSET_BITS=64 to work.) however, some programs instead define _LARGEFILE64_SOURCE and use alternate versions of all the standard types and functions with "64" appended to their names. we do not want code to actually get linked against these functions (it's ugly and inconsistent), so macros are used instead of prototypes with weak aliases in the library itself. eventually the weak aliases may be added at the library level for the sake of using code that was originally built against glibc, but the macros will still be the desired solution in the headers.
2012-05-04 04:13:23 +00:00
#define dirent64 dirent
#define readdir64 readdir
#define readdir64_r readdir_r
#define scandir64 scandir
#define alphasort64 alphasort
add (currently stubbed due to stubbed strverscmp) versionsort function based on patch by Emil Renner Berthing, with minor changes to dirent.h for LFS64 and organization of declarations this code should work unmodified once a real strverscmp is added, but I've been hesitant to add it because the GNU strverscmp behavior is harmful in a lot of cases (for instance if you have numeric filenames in hex). at some point I plan on trying to design a variant of the algorithm that behaves better on a mix of filename styles.
2012-06-13 15:14:38 +00:00
#define versionsort64 versionsort
add support for ugly *64 functions with _LARGEFILE64_SOURCE musl does not support legacy 32-bit-off_t whatsoever. off_t is always 64 bit, and correct programs that use off_t and the standard functions will just work out of the box. (on glibc, they would require -D_FILE_OFFSET_BITS=64 to work.) however, some programs instead define _LARGEFILE64_SOURCE and use alternate versions of all the standard types and functions with "64" appended to their names. we do not want code to actually get linked against these functions (it's ugly and inconsistent), so macros are used instead of prototypes with weak aliases in the library itself. eventually the weak aliases may be added at the library level for the sake of using code that was originally built against glibc, but the macros will still be the desired solution in the headers.
2012-05-04 04:13:23 +00:00
#define off64_t off_t
#define ino64_t ino_t
publicly expose getdents api under _BSD_SOURCE
2012-08-13 18:50:30 +00:00
#ifdef _BSD_SOURCE
#define getdents64 getdents
#endif
add support for ugly *64 functions with _LARGEFILE64_SOURCE musl does not support legacy 32-bit-off_t whatsoever. off_t is always 64 bit, and correct programs that use off_t and the standard functions will just work out of the box. (on glibc, they would require -D_FILE_OFFSET_BITS=64 to work.) however, some programs instead define _LARGEFILE64_SOURCE and use alternate versions of all the standard types and functions with "64" appended to their names. we do not want code to actually get linked against these functions (it's ugly and inconsistent), so macros are used instead of prototypes with weak aliases in the library itself. eventually the weak aliases may be added at the library level for the sake of using code that was originally built against glibc, but the macros will still be the desired solution in the headers.
2012-05-04 04:13:23 +00:00
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifdef __cplusplus
fix typos in dirent.h
2011-03-08 22:34:26 +00:00
}
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#endif
#endif