mirror of
https://github.com/jart/cosmopolitan.git
synced 2025-02-01 03:53:33 +00:00
5e8c928f1a
Every program built using Cosmopolitan is statically-linked. However there are some cases, e.g. GUIs and video drivers, where linking the host platform libraries is desirable. So what we do in such cases is launch a stub executable using the host platform's libc, and longjmp back into this executable. The stub executable passes back to us the platform-specific dlopen() implementation, which we shall then wrap. Here's the list of platforms that are supported so far: - x86-64 Linux w/ Glibc - x86-64 Linux w/ Musl Libc - x86-64 FreeBSD - x86-64 Windows - aarch64 Linux w/ Glibc - aarch64 MacOS What this means is your Cosmo programs can call foreign functions on your host operating system. However, it's important to note that any foreign library you link won't have the ability to call functions in your Cosmopolitan program. For example it's now technically possible that Lua can load a module, however that almost certainly won't work since the Lua module won't have access to Cosmo's Lua API. Kudos to @jacereda for figuring out how to do this.
84 lines
3 KiB
C
84 lines
3 KiB
C
#ifndef COSMOPOLITAN_LIBC_RUNTIME_SYSLIB_H_
|
|
#define COSMOPOLITAN_LIBC_RUNTIME_SYSLIB_H_
|
|
#if !(__ASSEMBLER__ + __LINKER__ + 0)
|
|
COSMOPOLITAN_C_START_
|
|
|
|
/**
|
|
* @fileoverview System DSO interfaces provided by APE loader.
|
|
*
|
|
* These functions are owned by the platform C library. Regardless of
|
|
* platform, POSIX APIs returning `long` will follow the Linux Kernel
|
|
* `-errno` convention, and hence should be wrapped with `_sysret()`.
|
|
*/
|
|
|
|
#define SYSLIB_MAGIC ('s' | 'l' << 8 | 'i' << 16 | 'b' << 24)
|
|
#define SYSLIB_VERSION 6
|
|
|
|
typedef uint64_t dispatch_time_t;
|
|
typedef uint64_t dispatch_semaphore_t;
|
|
|
|
struct Syslib {
|
|
int __magic;
|
|
int __version;
|
|
long (*__fork)(void);
|
|
long (*__pipe)(int[2]);
|
|
long (*__clock_gettime)(int, void *);
|
|
long (*__nanosleep)(const void *, void *);
|
|
long (*__mmap)(void *, size_t, int, int, int, int64_t);
|
|
int (*__pthread_jit_write_protect_supported_np)(void);
|
|
void (*__pthread_jit_write_protect_np)(int);
|
|
void (*__sys_icache_invalidate)(void *, size_t);
|
|
int (*__pthread_create)(void *, const void *, void *(*)(void *), void *);
|
|
void (*__pthread_exit)(void *);
|
|
int (*__pthread_kill)(long, int);
|
|
int (*__pthread_sigmask)(int, const void *restrict, void *restrict);
|
|
int (*__pthread_setname_np)(const char *);
|
|
dispatch_semaphore_t (*__dispatch_semaphore_create)(long);
|
|
long (*__dispatch_semaphore_signal)(dispatch_semaphore_t);
|
|
long (*__dispatch_semaphore_wait)(dispatch_semaphore_t, dispatch_time_t);
|
|
dispatch_time_t (*__dispatch_walltime)(const void *, int64_t);
|
|
/* v2 (2023-09-10) */
|
|
long (*__pthread_self)(void);
|
|
void (*__dispatch_release)(dispatch_semaphore_t);
|
|
int (*__raise)(int);
|
|
int (*__pthread_join)(long, void **);
|
|
void (*__pthread_yield_np)(void);
|
|
int __pthread_stack_min;
|
|
int __sizeof_pthread_attr_t;
|
|
int (*__pthread_attr_init)(void *);
|
|
int (*__pthread_attr_destroy)(void *);
|
|
int (*__pthread_attr_setstacksize)(void *, size_t);
|
|
int (*__pthread_attr_setguardsize)(void *, size_t);
|
|
/* v4 (2023-09-19) */
|
|
void (*__exit)(int);
|
|
long (*__close)(int);
|
|
long (*__munmap)(void *, size_t);
|
|
long (*__openat)(int, const void *, int, int);
|
|
long (*__write)(int, const void *, size_t);
|
|
long (*__read)(int, void *, size_t);
|
|
long (*__sigaction)(int, const void *, void *);
|
|
long (*__pselect)(int, void *, void *, void *, const void *, const void *);
|
|
long (*__mprotect)(void *, size_t, int);
|
|
/* v5 (2023-10-09) */
|
|
long (*__sigaltstack)(const void *, void *);
|
|
long (*__getentropy)(void *, size_t);
|
|
long (*__sem_open)(const char *, int, uint16_t, unsigned);
|
|
long (*__sem_unlink)(const char *);
|
|
long (*__sem_close)(int *);
|
|
long (*__sem_post)(int *);
|
|
long (*__sem_wait)(int *);
|
|
long (*__sem_trywait)(int *);
|
|
long (*__getrlimit)(int, void *);
|
|
long (*__setrlimit)(int, const void *);
|
|
// v6 (2023-11-03)
|
|
void *(*__dlopen)(const char *, int);
|
|
void *(*__dlsym)(void *, const char *);
|
|
int (*__dlclose)(void *);
|
|
char *(*__dlerror)(void);
|
|
};
|
|
|
|
extern struct Syslib *__syslib;
|
|
|
|
COSMOPOLITAN_C_END_
|
|
#endif /* !(__ASSEMBLER__ + __LINKER__ + 0) */
|
|
#endif /* COSMOPOLITAN_LIBC_RUNTIME_SYSLIB_H_ */
|