mirror of
https://github.com/jart/cosmopolitan.git
synced 2025-02-07 23:13:34 +00:00
14e192e5ba
This is similar to the --ftrace (c function call trace) flag, except
it's less noisy since it only logs system calls to stderr. Having this
flag is valuable because (1) system call tracing tells us a lot about
the behavior of complex programs and (2) it's usually very hard to get
system call tracing on various operating systems, e.g. strace, ktrace,
dtruss, truss, nttrace, etc. Especially on Apple platforms where even
with the special boot trick, debuggers still aren't guaranteed to work.
make -j8 o//examples
o//examples/hello.com --strace
This is enabled by default in MODE=, MODE=opt, and MODE=dbg. In MODE=dbg
extra information will be printed.
make -j8 MODE=dbg o/dbg/examples
o/dbg/examples/hello.com --strace |& less
This change also changes:
- Rename IsText() → _istext()
- Rename IsUtf8() → _isutf8()
- Fix madvise() on Windows NT
- Fix empty string case of inet_ntop()
- vfork() wrapper now saves and restores errno
- Update xsigaction() to yoink syscall support
134 lines
9.3 KiB
C
134 lines
9.3 KiB
C
#ifndef COSMOPOLITAN_LIBC_X_H_
|
|
#define COSMOPOLITAN_LIBC_X_H_
|
|
#include "libc/calls/struct/rusage.h"
|
|
#include "libc/calls/struct/sigaction.h"
|
|
#include "libc/calls/struct/timespec.h"
|
|
#include "libc/calls/struct/timeval.h"
|
|
#include "libc/fmt/pflink.h"
|
|
#include "libc/stdio/stdio.h"
|
|
#if !(__ASSEMBLER__ + __LINKER__ + 0)
|
|
COSMOPOLITAN_C_START_
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│─╝
|
|
Standard Library veneers for folks not building embedded RTOS */
|
|
|
|
#define _XPNN paramsnonnull()
|
|
#define _XRET nothrow nocallback nodiscard returnsnonnull
|
|
#define _XMAL returnspointerwithnoaliases _XRET
|
|
#define _XMALPG returnsaligned((PAGESIZE)) _XMAL
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » system calls ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
int xsigaction(int, void *, uint64_t, uint64_t, struct sigaction *);
|
|
int xwrite(int, const void *, uint64_t);
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » memory ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
void xdie(void) wontreturn;
|
|
char *xdtoa(double) _XMAL;
|
|
char *xdtoaf(float) _XMAL;
|
|
char *xdtoal(long double) _XMAL;
|
|
char *xasprintf(const char *, ...) printfesque(1) paramsnonnull((1)) _XMAL;
|
|
char *xvasprintf(const char *, va_list) _XPNN _XMAL;
|
|
char *xgetline(struct FILE *) _XPNN mallocesque;
|
|
void *xmalloc(size_t) attributeallocsize((1)) _XMAL;
|
|
void *xrealloc(void *, size_t)
|
|
attributeallocsize((2)) nothrow nocallback nodiscard;
|
|
void *xcalloc(size_t, size_t) attributeallocsize((1, 2)) _XMAL;
|
|
void *xvalloc(size_t) attributeallocsize((1)) _XMALPG;
|
|
void *xmemalign(size_t, size_t) attributeallocalign((1))
|
|
attributeallocsize((2)) _XMAL;
|
|
void *xmemalignzero(size_t, size_t) attributeallocalign((1))
|
|
attributeallocsize((2)) _XMAL;
|
|
char *xstrdup(const char *) _XPNN _XMAL;
|
|
char *xstrndup(const char *, size_t) _XPNN _XMAL;
|
|
char *xstrcat(const char *, ...) paramsnonnull((1)) nullterminated() _XMAL;
|
|
char *xstrmul(const char *, size_t) paramsnonnull((1)) _XMAL;
|
|
char *xinet_ntop(int, const void *) _XPNN _XMAL;
|
|
void *xunbinga(size_t, const char16_t *) attributeallocalign((1)) _XMAL _XRET;
|
|
void *xunbing(const char16_t *) _XMAL _XRET;
|
|
char16_t *utf8toutf16(const char *, size_t, size_t *) nodiscard;
|
|
char *utf16toutf8(const char16_t *, size_t, size_t *) nodiscard;
|
|
wchar_t *utf8toutf32(const char *, size_t, size_t *) nodiscard;
|
|
wchar_t *utf16to32(const char16_t *, size_t, size_t *) nodiscard;
|
|
char *xhomedir(void) nodiscard;
|
|
char *xstripext(const char *) nodiscard;
|
|
char *xstripexts(const char *) nodiscard;
|
|
void *xload(bool *, void **, const void *, size_t, size_t);
|
|
void *xloadzd(bool *, void **, const void *, size_t, size_t, size_t, size_t,
|
|
uint32_t);
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » files ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
int rmrf(const char *);
|
|
int makedirs(const char *, unsigned);
|
|
char *xdirname(const char *) paramsnonnull() _XMAL;
|
|
char *xjoinpaths(const char *, const char *) paramsnonnull() _XMAL;
|
|
char *xreadlink(const char *) paramsnonnull() _XMAL;
|
|
char *xreadlinkat(int, const char *) paramsnonnull() _XMAL;
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » time ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
char *xiso8601i(int) mallocesque;
|
|
char *xiso8601tv(struct timeval *) mallocesque;
|
|
char *xiso8601ts(struct timespec *) mallocesque;
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » input / output ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
void *xslurp(const char *, size_t *)
|
|
paramsnonnull((1)) returnspointerwithnoaliases
|
|
returnsaligned((PAGESIZE)) nodiscard;
|
|
int xbarf(const char *, const void *, size_t);
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » safety ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
#define xstrcat(...) (xstrcat)(__VA_ARGS__, NULL)
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » processes ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
int xspawn(struct rusage *);
|
|
int xvspawn(void (*)(void *), void *, struct rusage *);
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » generic typing ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
#if __STDC_VERSION__ + 0 >= 201112
|
|
|
|
#define xiso8601(TS) \
|
|
_Generic(*(TS), struct timeval : xiso8601tv, default : xiso8601ts)(TS)
|
|
|
|
#endif /* C11 */
|
|
|
|
/*───────────────────────────────────────────────────────────────────────────│─╗
|
|
│ cosmopolitan § eXtended apis » link-time optimizations ─╬─│┼
|
|
╚────────────────────────────────────────────────────────────────────────────│*/
|
|
|
|
#if defined(__GNUC__) && !defined(__STRICT_ANSI__)
|
|
#define xasprintf(FMT, ...) (xasprintf)(PFLINK(FMT), ##__VA_ARGS__)
|
|
#define xvasprintf(FMT, VA) (xvasprintf)(PFLINK(FMT), VA)
|
|
#define xsigaction(SIG, HANDLER, FLAGS, MASK, OLD) \
|
|
({ \
|
|
__SIGACTION_YOINK(SIG); \
|
|
xsigaction(SIG, HANDLER, FLAGS, MASK, OLD); \
|
|
})
|
|
#endif
|
|
|
|
COSMOPOLITAN_C_END_
|
|
#endif /* !(__ASSEMBLER__ + __LINKER__ + 0) */
|
|
#endif /* COSMOPOLITAN_LIBC_X_H_ */
|