| リビジョン | 30b85d43a7657eeac02462e8d84946358a5aa647 (tree) |
|---|---|
| 日時 | 2019-05-13 16:11:01 |
| 作者 | Max Filippov <jcmvbkbc@gmai...> |
| コミッター | Waldemar Brodkorb |
docs/defines.txt: clarify LFS-related macros
Add description for _LARGEFILE_SOURCE, _LARGEFILE64_SOURCE,
_FILE_OFFSET_BITS and USE_LARGEFILE, USE_LARGEFILE64 and
USE_FILE_OFFSET64 macros.
Signed-off-by: Max Filippov <jcmvbkbc@gmail.com>
docs/defines.txt (diff)| @@ -10,11 +10,28 @@ __USE_GNU, __USE_BSD, __USE_XOPEN[2K], __USE_SVID, __USE_POSIX... | ||
| 10 | 10 | If defined, user program which included us requests compat additions |
| 11 | 11 | from relevant standard or Unix flavor. See features.h for full list. |
| 12 | 12 | |
| 13 | -__USE_FILE_OFFSET64 | |
| 13 | +_LARGEFILE_SOURCE | |
| 14 | + If defined, headers will provide functions fseeko and ftello. | |
| 15 | +_LARGEFILE64_SOURCE | |
| 16 | + If defined, headers will in addition to data types, constants and | |
| 17 | + functions named xxx (e.g. off_t, struct stat, F_SETLK, ftruncate()) | |
| 18 | + supply data types, constants and functions named xxx64 (e.g. off64_t, | |
| 19 | + struct stat64, F_SETLK64, ftruncate64()) known as an interface for | |
| 20 | + 64-bit file offsets. | |
| 14 | 21 | __USE_LARGEFILE[64] |
| 15 | -_LARGEFILE[64]_SOURCE | |
| 22 | + Defined to 1 and used internally when built with _LARGEFILE[64]_SOURCE. | |
| 23 | + Undefined otherwise. | |
| 24 | + | |
| 16 | 25 | _FILE_OFFSET_BITS |
| 17 | - ??? | |
| 26 | + Select default filesystem interface. When defined as 64 the data types, | |
| 27 | + constants and functions mentioned in _LARGEFILE64_SOURCE as xxx are | |
| 28 | + aliased to the corresponding xxx64 data types, constants and functions. | |
| 29 | + _FILE_OFFSET_BITS=64 enables both __USE_LARGEFILE and __USE_LARGEFILE64. | |
| 30 | + This flag does not affect the way libc itself is built, it only affects | |
| 31 | + what declarations are provided to library user. | |
| 32 | +__USE_FILE_OFFSET64 | |
| 33 | + Defined to 1 and used internally when built with _FILE_OFFSET_BITS=64. | |
| 34 | + Undefined otherwise. | |
| 18 | 35 | |
| 19 | 36 | __THROW |
| 20 | 37 | Function annotation "I do not throw anything". |
Fork