cosmopolitan/libc/thread
Justine Tunney dd8544c3bd
Delve into clock rabbit hole
The worst issue I had with consts.sh for clock_gettime is how it defined
too many clocks. So I looked into these clocks all day to figure out how
how they overlap in functionality. I discovered counter-intuitive things
such as how CLOCK_MONOTONIC should be CLOCK_UPTIME on MacOS and BSD, and
that CLOCK_BOOTTIME should be CLOCK_MONOTONIC on MacOS / BSD. Windows 10
also has some incredible new APIs, that let us simplify clock_gettime().

  - Linux CLOCK_REALTIME         -> GetSystemTimePreciseAsFileTime()
  - Linux CLOCK_MONOTONIC        -> QueryUnbiasedInterruptTimePrecise()
  - Linux CLOCK_MONOTONIC_RAW    -> QueryUnbiasedInterruptTimePrecise()
  - Linux CLOCK_REALTIME_COARSE  -> GetSystemTimeAsFileTime()
  - Linux CLOCK_MONOTONIC_COARSE -> QueryUnbiasedInterruptTime()
  - Linux CLOCK_BOOTTIME         -> QueryInterruptTimePrecise()

Documentation on the clock crew has been added to clock_gettime() in the
docstring and in redbean's documentation too. You can read that to learn
interesting facts about eight essential clocks that survived this purge.
This is original research you will not find on Google, OpenAI, or Claude

I've tested this change by porting *NSYNC to become fully clock agnostic
since it has extensive tests for spotting irregularities in time. I have
also included these tests in the default build so they no longer need to
be run manually. Both CLOCK_REALTIME and CLOCK_MONOTONIC are good across
the entire amd64 and arm64 test fleets.
2024-09-04 01:32:46 -07:00
..
alarm.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
BUILD.mk Make malloc() go 200x faster 2024-06-05 02:02:14 -07:00
freebsd.internal.h Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
getitimer.c Get rid of .internal.h convention in LIBC_INTRIN 2024-07-19 19:38:00 -07:00
getstackbottom.c Rewrite memory manager 2024-06-22 05:45:11 -07:00
itimer.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
itimer.internal.h Reduce header complexity 2023-11-28 14:39:42 -08:00
lock.h Fix bugs with new memory manager 2024-06-29 10:53:57 -07:00
makecontext.c Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
mktls.c Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
openbsd.internal.h Rewrite memory manager 2024-06-22 05:45:11 -07:00
posixthread.internal.h Update Musl Libc code 2024-07-30 22:51:29 -07:00
pt.internal.h Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_destroy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getdetachstate.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getguardsize.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_getinheritsched.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getschedparam.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getschedpolicy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getscope.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getsigaltstack_np.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_getsigaltstacksize_np.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_getsigmask_np.c Apply clang-format update to repo (#1154) 2024-04-25 10:38:00 -07:00
pthread_attr_getstack.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_getstacksize.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_init.c Make some improvements of little consequence 2024-07-27 08:20:18 -07:00
pthread_attr_setdetachstate.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setguardsize.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_setinheritsched.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setschedparam.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setschedpolicy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setscope.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setsigaltstack_np.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_setsigaltstacksize_np.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_setsigmask_np.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_attr_setstack.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_attr_setstacksize.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_barrier_destroy.c Make more improvements to threads and mappings 2024-07-24 01:19:54 -07:00
pthread_barrier_init.c Make more improvements to threads and mappings 2024-07-24 01:19:54 -07:00
pthread_barrier_wait.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_barrierattr_destroy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_barrierattr_getpshared.c Make more improvements to threads and mappings 2024-07-24 01:19:54 -07:00
pthread_barrierattr_init.c Make more improvements to threads and mappings 2024-07-24 01:19:54 -07:00
pthread_barrierattr_setpshared.c Make more improvements to threads and mappings 2024-07-24 01:19:54 -07:00
pthread_cancel.c Fix bugs in poll(), select(), ppoll(), and pselect() 2024-09-02 00:29:52 -07:00
pthread_cond_broadcast.c Make Cosmo mutexes competitive with Apple Libc 2024-09-02 19:03:11 -07:00
pthread_cond_destroy.c Add unit test for process shared conditions 2024-07-22 18:48:54 -07:00
pthread_cond_init.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_cond_signal.c Make Cosmo mutexes competitive with Apple Libc 2024-09-02 19:03:11 -07:00
pthread_cond_timedwait.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_cond_wait.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_condattr_destroy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_condattr_getclock.c Delve into clock rabbit hole 2024-09-04 01:32:46 -07:00
pthread_condattr_getpshared.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_condattr_init.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_condattr_setclock.c Delve into clock rabbit hole 2024-09-04 01:32:46 -07:00
pthread_condattr_setpshared.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
pthread_create.c Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
pthread_decimate_np.c Improve multithreading 2024-07-21 14:40:45 -07:00
pthread_detach.c Delve into clock rabbit hole 2024-09-04 01:32:46 -07:00
pthread_equal.c Add much of C11 threads.h API 2024-04-28 07:04:08 -07:00
pthread_exit.c Freshen build/bootstrap/cocmd 2024-07-27 23:22:11 -07:00
pthread_getaffinity_np.c Make some improvements of little consequence 2024-07-27 08:20:18 -07:00
pthread_getattr_np.c Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
pthread_getname_np.c Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
pthread_getschedparam.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_getspecific.c Make malloc() go 200x faster 2024-06-05 02:02:14 -07:00
pthread_getthreadid_np.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_getunique_np.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_join.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_key_create.c Make POSIX threads improvements 2024-06-30 15:38:59 -07:00
pthread_key_delete.c Make POSIX threads improvements 2024-06-30 15:38:59 -07:00
pthread_kill.c Get rid of .internal.h convention in LIBC_INTRIN 2024-07-19 19:38:00 -07:00
pthread_once.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_reschedule.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_destroy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_init.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_rdlock.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_tryrdlock.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_trywrlock.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_unlock.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlock_wrlock.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlockattr_destroy.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlockattr_getpshared.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlockattr_init.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_rwlockattr_setpshared.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_self.c Add much of C11 threads.h API 2024-04-28 07:04:08 -07:00
pthread_setaffinity_np.c Make some improvements of little consequence 2024-07-27 08:20:18 -07:00
pthread_setcanceltype.c Get rid of .internal.h convention in LIBC_INTRIN 2024-07-19 19:38:00 -07:00
pthread_setname_np.c Get rid of .internal.h convention in LIBC_INTRIN 2024-07-19 19:38:00 -07:00
pthread_setschedparam.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_setschedparam_freebsd.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_setschedprio.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_sigmask.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_timedjoin_np.c Delve into clock rabbit hole 2024-09-04 01:32:46 -07:00
pthread_tryjoin_np.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
pthread_zombify.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
README.md Use *NSYNC for POSIX threads locking APIs 2022-09-11 11:04:50 -07:00
sem_destroy.c Apply clang-format update to repo (#1154) 2024-04-25 10:38:00 -07:00
sem_getvalue.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
sem_init.c Apply clang-format update to repo (#1154) 2024-04-25 10:38:00 -07:00
sem_open.c Support process shared condition variables 2024-07-22 16:35:29 -07:00
sem_post.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
sem_timedwait.c Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
sem_trywait.c Apply clang-format update to repo (#1154) 2024-04-25 10:38:00 -07:00
sem_wait.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
semaphore.h Remove bad defines from early days of project 2024-07-24 12:11:21 -07:00
setitimer.c Get rid of .internal.h convention in LIBC_INTRIN 2024-07-19 19:38:00 -07:00
thrd_create.c Add much of C11 threads.h API 2024-04-28 07:04:08 -07:00
thrd_detach.c Add much of C11 threads.h API 2024-04-28 07:04:08 -07:00
thrd_join.c Add much of C11 threads.h API 2024-04-28 07:04:08 -07:00
thread.h Introduce pthread_condattr_setclock() 2024-09-02 23:45:42 -07:00
thread2.h Add dontthrow attribute to most libc functions 2024-01-09 01:26:03 -08:00
threads.h Remove more _Atomic keywords from public headers 2024-07-24 13:56:03 -07:00
tls.h Update Musl Libc code 2024-07-30 22:51:29 -07:00
tls2.internal.h Add back missing TlsAlloc() call 2024-07-21 20:45:27 -07:00
ualarm.c Delve into clock rabbit hole 2024-09-04 01:32:46 -07:00
xnu.internal.h Reduce header complexity 2023-11-28 14:39:42 -08:00

Cosmpolitan POSIX Threads Library

Cosmopolitan Libc implements threading as it is written in The Open Group Base Specifications Issue 7, 2018 edition IEEE Std 1003.1-2017 (Revision of IEEE Std 1003.1-2008) in addition to GNU extensions.