1331722Seadler/* 235124Sjb * Copyright (c) 1998 John Birrell <jb@cimlogic.com.au>. 335124Sjb * All rights reserved. 435124Sjb * 535124Sjb * Redistribution and use in source and binary forms, with or without 635124Sjb * modification, are permitted provided that the following conditions 735124Sjb * are met: 835124Sjb * 1. Redistributions of source code must retain the above copyright 935124Sjb * notice, this list of conditions and the following disclaimer. 1035124Sjb * 2. Redistributions in binary form must reproduce the above copyright 1135124Sjb * notice, this list of conditions and the following disclaimer in the 1235124Sjb * documentation and/or other materials provided with the distribution. 13165968Simp * 3. Neither the name of the author nor the names of any co-contributors 1435124Sjb * may be used to endorse or promote products derived from this software 1535124Sjb * without specific prior written permission. 1635124Sjb * 1735124Sjb * THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND 1835124Sjb * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1935124Sjb * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2035124Sjb * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 2135124Sjb * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2235124Sjb * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2335124Sjb * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2435124Sjb * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2535124Sjb * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2635124Sjb * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2735124Sjb * SUCH DAMAGE. 2835124Sjb * 2950476Speter * $FreeBSD: stable/11/lib/libc/include/libc_private.h 349688 2019-07-03 19:42:36Z kib $ 3035124Sjb * 3135124Sjb * Private definitions for libc, libc_r and libpthread. 3235124Sjb * 3335124Sjb */ 3435124Sjb 3535124Sjb#ifndef _LIBC_PRIVATE_H_ 3635124Sjb#define _LIBC_PRIVATE_H_ 37237434Skib#include <sys/_types.h> 38199606Sjhb#include <sys/_pthreadtypes.h> 3935124Sjb 4035124Sjb/* 4135124Sjb * This global flag is non-zero when a process has created one 4235124Sjb * or more threads. It is used to avoid calling locking functions 4335124Sjb * when they are not required. 4435124Sjb */ 45319430Svangyzen#ifndef __LIBC_ISTHREADED_DECLARED 46319430Svangyzen#define __LIBC_ISTHREADED_DECLARED 4735124Sjbextern int __isthreaded; 48319430Svangyzen#endif 4935124Sjb 5035124Sjb/* 51231868Skib * Elf_Auxinfo *__elf_aux_vector, the pointer to the ELF aux vector 52231868Skib * provided by kernel. Either set for us by rtld, or found at runtime 53231868Skib * on stack for static binaries. 54231868Skib * 55231868Skib * Type is void to avoid polluting whole libc with ELF types. 56231868Skib */ 57231868Skibextern void *__elf_aux_vector; 58231868Skib 59231868Skib/* 60228843Scperciva * libc should use libc_dlopen internally, which respects a global 61228843Scperciva * flag where loading of new shared objects can be restricted. 62228843Scperciva */ 63228843Scpercivavoid *libc_dlopen(const char *, int); 64228843Scperciva 65228843Scperciva/* 66228843Scperciva * For dynamic linker. 67228843Scperciva */ 68228843Scpercivavoid _rtld_error(const char *fmt, ...); 69228843Scperciva 70228843Scperciva/* 7135124Sjb * File lock contention is difficult to diagnose without knowing 7235124Sjb * where locks were set. Allow a debug library to be built which 7335124Sjb * records the source file and line number of each lock call. 7435124Sjb */ 7535124Sjb#ifdef _FLOCK_DEBUG 7635124Sjb#define _FLOCKFILE(x) _flockfile_debug(x, __FILE__, __LINE__) 7735124Sjb#else 7871579Sdeischen#define _FLOCKFILE(x) _flockfile(x) 7935124Sjb#endif 8035124Sjb 8135124Sjb/* 8235124Sjb * Macros for locking and unlocking FILEs. These test if the 8335124Sjb * process is threaded to avoid locking when not required. 8435124Sjb */ 8535124Sjb#define FLOCKFILE(fp) if (__isthreaded) _FLOCKFILE(fp) 8671579Sdeischen#define FUNLOCKFILE(fp) if (__isthreaded) _funlockfile(fp) 8735124Sjb 88234657Skibstruct _spinlock; 89254706Sjillesextern struct _spinlock __stdio_thread_lock __hidden; 90234657Skib#define STDIO_THREAD_LOCK() \ 91234657Skibdo { \ 92234657Skib if (__isthreaded) \ 93234657Skib _SPINLOCK(&__stdio_thread_lock); \ 94234657Skib} while (0) 95234657Skib#define STDIO_THREAD_UNLOCK() \ 96234657Skibdo { \ 97234657Skib if (__isthreaded) \ 98234657Skib _SPINUNLOCK(&__stdio_thread_lock); \ 99234657Skib} while (0) 100234657Skib 101278751Skibvoid __libc_spinlock_stub(struct _spinlock *); 102278751Skibvoid __libc_spinunlock_stub(struct _spinlock *); 103278751Skib 10493399Smarkm/* 105106866Sdeischen * Indexes into the pthread jump table. 106106866Sdeischen * 107106866Sdeischen * Warning! If you change this type, you must also change the threads 108106866Sdeischen * libraries that reference it (libc_r, libpthread). 109106866Sdeischen */ 110106866Sdeischentypedef enum { 111156319Sdeischen PJT_ATFORK, 112156319Sdeischen PJT_ATTR_DESTROY, 113156319Sdeischen PJT_ATTR_GETDETACHSTATE, 114156319Sdeischen PJT_ATTR_GETGUARDSIZE, 115156319Sdeischen PJT_ATTR_GETINHERITSCHED, 116156319Sdeischen PJT_ATTR_GETSCHEDPARAM, 117156319Sdeischen PJT_ATTR_GETSCHEDPOLICY, 118156319Sdeischen PJT_ATTR_GETSCOPE, 119156319Sdeischen PJT_ATTR_GETSTACKADDR, 120156319Sdeischen PJT_ATTR_GETSTACKSIZE, 121156319Sdeischen PJT_ATTR_INIT, 122156319Sdeischen PJT_ATTR_SETDETACHSTATE, 123156319Sdeischen PJT_ATTR_SETGUARDSIZE, 124156319Sdeischen PJT_ATTR_SETINHERITSCHED, 125156319Sdeischen PJT_ATTR_SETSCHEDPARAM, 126156319Sdeischen PJT_ATTR_SETSCHEDPOLICY, 127156319Sdeischen PJT_ATTR_SETSCOPE, 128156319Sdeischen PJT_ATTR_SETSTACKADDR, 129156319Sdeischen PJT_ATTR_SETSTACKSIZE, 130156319Sdeischen PJT_CANCEL, 131156319Sdeischen PJT_CLEANUP_POP, 132156319Sdeischen PJT_CLEANUP_PUSH, 133106866Sdeischen PJT_COND_BROADCAST, 134106866Sdeischen PJT_COND_DESTROY, 135106866Sdeischen PJT_COND_INIT, 136106866Sdeischen PJT_COND_SIGNAL, 137156319Sdeischen PJT_COND_TIMEDWAIT, 138106866Sdeischen PJT_COND_WAIT, 139156319Sdeischen PJT_DETACH, 140156319Sdeischen PJT_EQUAL, 141156319Sdeischen PJT_EXIT, 142106866Sdeischen PJT_GETSPECIFIC, 143156319Sdeischen PJT_JOIN, 144106866Sdeischen PJT_KEY_CREATE, 145106866Sdeischen PJT_KEY_DELETE, 146156319Sdeischen PJT_KILL, 147106866Sdeischen PJT_MAIN_NP, 148156319Sdeischen PJT_MUTEXATTR_DESTROY, 149156319Sdeischen PJT_MUTEXATTR_INIT, 150156319Sdeischen PJT_MUTEXATTR_SETTYPE, 151106866Sdeischen PJT_MUTEX_DESTROY, 152106866Sdeischen PJT_MUTEX_INIT, 153106866Sdeischen PJT_MUTEX_LOCK, 154106866Sdeischen PJT_MUTEX_TRYLOCK, 155106866Sdeischen PJT_MUTEX_UNLOCK, 156106866Sdeischen PJT_ONCE, 157106866Sdeischen PJT_RWLOCK_DESTROY, 158106866Sdeischen PJT_RWLOCK_INIT, 159106866Sdeischen PJT_RWLOCK_RDLOCK, 160106866Sdeischen PJT_RWLOCK_TRYRDLOCK, 161106866Sdeischen PJT_RWLOCK_TRYWRLOCK, 162106866Sdeischen PJT_RWLOCK_UNLOCK, 163106866Sdeischen PJT_RWLOCK_WRLOCK, 164106866Sdeischen PJT_SELF, 165156319Sdeischen PJT_SETCANCELSTATE, 166156319Sdeischen PJT_SETCANCELTYPE, 167106866Sdeischen PJT_SETSPECIFIC, 168106866Sdeischen PJT_SIGMASK, 169156319Sdeischen PJT_TESTCANCEL, 170201546Sdavidxu PJT_CLEANUP_POP_IMP, 171201546Sdavidxu PJT_CLEANUP_PUSH_IMP, 172213153Sdavidxu PJT_CANCEL_ENTER, 173213153Sdavidxu PJT_CANCEL_LEAVE, 174300043Skib PJT_MUTEX_CONSISTENT, 175300043Skib PJT_MUTEXATTR_GETROBUST, 176300043Skib PJT_MUTEXATTR_SETROBUST, 177349688Skib PJT_GETTHREADID_NP, 178106866Sdeischen PJT_MAX 179106866Sdeischen} pjt_index_t; 180106866Sdeischen 181106870Sdeischentypedef int (*pthread_func_t)(void); 182106880Sdeischentypedef pthread_func_t pthread_func_entry_t[2]; 183106866Sdeischen 184106880Sdeischenextern pthread_func_entry_t __thr_jtable[]; 185106866Sdeischen 186276681Skibvoid __set_error_selector(int *(*arg)(void)); 187276630Skibint _pthread_mutex_init_calloc_cb_stub(pthread_mutex_t *mutex, 188276630Skib void *(calloc_cb)(__size_t, __size_t)); 189276630Skib 190276630Skibtypedef int (*interpos_func_t)(void); 191276630Skibinterpos_func_t *__libc_interposing_slot(int interposno); 192276681Skibextern interpos_func_t __libc_interposing[] __hidden; 193276630Skib 194276630Skibenum { 195276630Skib INTERPOS_accept, 196276630Skib INTERPOS_accept4, 197276630Skib INTERPOS_aio_suspend, 198276630Skib INTERPOS_close, 199276630Skib INTERPOS_connect, 200276630Skib INTERPOS_fcntl, 201276630Skib INTERPOS_fsync, 202276630Skib INTERPOS_fork, 203276630Skib INTERPOS_msync, 204276630Skib INTERPOS_nanosleep, 205276630Skib INTERPOS_openat, 206276630Skib INTERPOS_poll, 207276630Skib INTERPOS_pselect, 208276630Skib INTERPOS_recvfrom, 209276630Skib INTERPOS_recvmsg, 210276630Skib INTERPOS_select, 211276630Skib INTERPOS_sendmsg, 212276630Skib INTERPOS_sendto, 213276630Skib INTERPOS_setcontext, 214276630Skib INTERPOS_sigaction, 215276630Skib INTERPOS_sigprocmask, 216276630Skib INTERPOS_sigsuspend, 217276630Skib INTERPOS_sigwait, 218276630Skib INTERPOS_sigtimedwait, 219276630Skib INTERPOS_sigwaitinfo, 220276630Skib INTERPOS_swapcontext, 221276630Skib INTERPOS_system, 222276630Skib INTERPOS_tcdrain, 223276630Skib INTERPOS_read, 224276630Skib INTERPOS_readv, 225276630Skib INTERPOS_wait4, 226276630Skib INTERPOS_write, 227276630Skib INTERPOS_writev, 228276630Skib INTERPOS__pthread_mutex_init_calloc_cb, 229278751Skib INTERPOS_spinlock, 230278751Skib INTERPOS_spinunlock, 231280818Skib INTERPOS_kevent, 232281712Skib INTERPOS_wait6, 233281712Skib INTERPOS_ppoll, 234295407Skib INTERPOS_map_stacks_exec, 235304980Skib INTERPOS_fdatasync, 236317618Svangyzen INTERPOS_clock_nanosleep, 237346156Skib INTERPOS_distribute_static_tls, 238276630Skib INTERPOS_MAX 239276630Skib}; 240276630Skib 241106866Sdeischen/* 242111618Snectar * yplib internal interfaces 243111618Snectar */ 244111618Snectar#ifdef YP 245111618Snectarint _yp_check(char **); 246111618Snectar#endif 247111618Snectar 248133754Sdfr/* 249133754Sdfr * Initialise TLS for static programs 250133754Sdfr */ 251133754Sdfrvoid _init_tls(void); 252111618Snectar 253111618Snectar/* 254199606Sjhb * Provides pthread_once()-like functionality for both single-threaded 255199606Sjhb * and multi-threaded applications. 256199606Sjhb */ 257199606Sjhbint _once(pthread_once_t *, void (*)(void)); 258199606Sjhb 259199606Sjhb/* 260133754Sdfr * Set the TLS thread pointer 261133754Sdfr */ 262133754Sdfrvoid _set_tp(void *tp); 263133754Sdfr 264133754Sdfr/* 26593399Smarkm * This is a pointer in the C run-time startup code. It is used 26693399Smarkm * by getprogname() and setprogname(). 26793399Smarkm */ 26893399Smarkmextern const char *__progname; 26993399Smarkm 270122069Sdeischen/* 271182225Sjasone * This function is used by the threading libraries to notify malloc that a 272182225Sjasone * thread is exiting. 273182225Sjasone */ 274182225Sjasonevoid _malloc_thread_cleanup(void); 275182225Sjasone 276182225Sjasone/* 277304524Skib * This function is used by the threading libraries to notify libc that a 278304524Skib * thread is exiting, so its thread-local dtors should be called. 279304524Skib */ 280304524Skibvoid __cxa_thread_call_dtors(void); 281312589Skibint __cxa_thread_atexit_hidden(void (*dtor_func)(void *), void *obj, 282312589Skib void *dso_symbol) __hidden; 283304524Skib 284304524Skib/* 285154248Sjasone * These functions are used by the threading libraries in order to protect 286154248Sjasone * malloc across fork(). 287122069Sdeischen */ 288154248Sjasonevoid _malloc_prefork(void); 289154248Sjasonevoid _malloc_postfork(void); 290122069Sdeischen 291276630Skibvoid _malloc_first_thread(void); 292276630Skib 293150040Sstefanf/* 294150040Sstefanf * Function to clean up streams, called from abort() and exit(). 295150040Sstefanf */ 296278889Skibextern void (*__cleanup)(void) __hidden; 297150040Sstefanf 298171219Speter/* 299171219Speter * Get kern.osreldate to detect ABI revisions. Explicitly 300281714Skib * ignores value of $OSVERSION and caches result. 301171219Speter */ 302276630Skibint __getosreldate(void); 303171219Speter#include <sys/_types.h> 304276630Skib#include <sys/_sigset.h> 305171219Speter 306276630Skibstruct aiocb; 307276630Skibstruct fd_set; 308276630Skibstruct iovec; 309280818Skibstruct kevent; 310276630Skibstruct msghdr; 311276630Skibstruct pollfd; 312276630Skibstruct rusage; 313276630Skibstruct sigaction; 314276630Skibstruct sockaddr; 315237434Skibstruct timespec; 316237434Skibstruct timeval; 317237434Skibstruct timezone; 318276630Skibstruct __siginfo; 319276630Skibstruct __ucontext; 320281712Skibstruct __wrusage; 321281712Skibenum idtype; 322276630Skibint __sys_aio_suspend(const struct aiocb * const[], int, 323276630Skib const struct timespec *); 324276630Skibint __sys_accept(int, struct sockaddr *, __socklen_t *); 325276630Skibint __sys_accept4(int, struct sockaddr *, __socklen_t *, int); 326276630Skibint __sys_clock_gettime(__clockid_t, struct timespec *ts); 327317618Svangyzenint __sys_clock_nanosleep(__clockid_t, int, 328317618Svangyzen const struct timespec *, struct timespec *); 329276630Skibint __sys_close(int); 330276630Skibint __sys_connect(int, const struct sockaddr *, __socklen_t); 331276630Skibint __sys_fcntl(int, int, ...); 332304980Skibint __sys_fdatasync(int); 333276630Skibint __sys_fsync(int); 334276630Skib__pid_t __sys_fork(void); 335276630Skibint __sys_ftruncate(int, __off_t); 336276630Skibint __sys_gettimeofday(struct timeval *, struct timezone *); 337280818Skibint __sys_kevent(int, const struct kevent *, int, struct kevent *, 338280818Skib int, const struct timespec *); 339276630Skib__off_t __sys_lseek(int, __off_t, int); 340276630Skibvoid *__sys_mmap(void *, __size_t, int, int, int, __off_t); 341276630Skibint __sys_msync(void *, __size_t, int); 342276630Skibint __sys_nanosleep(const struct timespec *, struct timespec *); 343276630Skibint __sys_open(const char *, int, ...); 344276630Skibint __sys_openat(int, const char *, int, ...); 345276630Skibint __sys_pselect(int, struct fd_set *, struct fd_set *, 346276630Skib struct fd_set *, const struct timespec *, 347276630Skib const __sigset_t *); 348305329Skibint __sys_ptrace(int, __pid_t, char *, int); 349276630Skibint __sys_poll(struct pollfd *, unsigned, int); 350281712Skibint __sys_ppoll(struct pollfd *, unsigned, const struct timespec *, 351281712Skib const __sigset_t *); 352276630Skib__ssize_t __sys_pread(int, void *, __size_t, __off_t); 353276630Skib__ssize_t __sys_pwrite(int, const void *, __size_t, __off_t); 354276630Skib__ssize_t __sys_read(int, void *, __size_t); 355276630Skib__ssize_t __sys_readv(int, const struct iovec *, int); 356276630Skib__ssize_t __sys_recv(int, void *, __size_t, int); 357276630Skib__ssize_t __sys_recvfrom(int, void *, __size_t, int, struct sockaddr *, 358276630Skib __socklen_t *); 359276630Skib__ssize_t __sys_recvmsg(int, struct msghdr *, int); 360276630Skibint __sys_select(int, struct fd_set *, struct fd_set *, 361276630Skib struct fd_set *, struct timeval *); 362276630Skib__ssize_t __sys_sendmsg(int, const struct msghdr *, int); 363276630Skib__ssize_t __sys_sendto(int, const void *, __size_t, int, 364276630Skib const struct sockaddr *, __socklen_t); 365276630Skibint __sys_setcontext(const struct __ucontext *); 366276630Skibint __sys_sigaction(int, const struct sigaction *, 367276630Skib struct sigaction *); 368276630Skibint __sys_sigprocmask(int, const __sigset_t *, __sigset_t *); 369276630Skibint __sys_sigsuspend(const __sigset_t *); 370276630Skibint __sys_sigtimedwait(const __sigset_t *, struct __siginfo *, 371276630Skib const struct timespec *); 372276630Skibint __sys_sigwait(const __sigset_t *, int *); 373276630Skibint __sys_sigwaitinfo(const __sigset_t *, struct __siginfo *); 374276630Skibint __sys_swapcontext(struct __ucontext *, 375276630Skib const struct __ucontext *); 376277032Skibint __sys_thr_kill(long, int); 377277032Skibint __sys_thr_self(long *); 378276630Skibint __sys_truncate(const char *, __off_t); 379276630Skib__pid_t __sys_wait4(__pid_t, int *, int, struct rusage *); 380281712Skib__pid_t __sys_wait6(enum idtype, __id_t, int *, int, 381281712Skib struct __wrusage *, struct __siginfo *); 382276630Skib__ssize_t __sys_write(int, const void *, __size_t); 383276630Skib__ssize_t __sys_writev(int, const struct iovec *, int); 384237434Skib 385287292Skibint __libc_sigaction(int, const struct sigaction *, 386287292Skib struct sigaction *) __hidden; 387287292Skibint __libc_sigprocmask(int, const __sigset_t *, __sigset_t *) 388287292Skib __hidden; 389287292Skibint __libc_sigsuspend(const __sigset_t *) __hidden; 390276630Skibint __libc_sigwait(const __sigset_t * __restrict, 391276630Skib int * restrict sig); 392276630Skibint __libc_system(const char *); 393276630Skibint __libc_tcdrain(int); 394276630Skibint __fcntl_compat(int fd, int cmd, ...); 395276630Skib 396277610Sjillesint __sys_futimens(int fd, const struct timespec *times) __hidden; 397277610Sjillesint __sys_utimensat(int fd, const char *path, 398277610Sjilles const struct timespec *times, int flag) __hidden; 399277610Sjilles 400179947Sed/* execve() with PATH processing to implement posix_spawnp() */ 401179947Sedint _execvpe(const char *, char * const *, char * const *); 402179947Sed 403211416Skibint _elf_aux_info(int aux, void *buf, int buflen); 404211706Skibstruct dl_phdr_info; 405211706Skibint __elf_phdr_match_addr(struct dl_phdr_info *, void *); 406231868Skibvoid __init_elf_aux_vector(void); 407295416Smarkjvoid __libc_map_stacks_exec(void); 408346156Skibvoid __libc_distribute_static_tls(__size_t, void *, __size_t, __size_t); 409346156Skib__uintptr_t __libc_static_tls_base(__size_t); 410211416Skib 411213153Sdavidxuvoid _pthread_cancel_enter(int); 412213153Sdavidxuvoid _pthread_cancel_leave(int); 413213153Sdavidxu 414320942Skibstruct _pthread_cleanup_info; 415320942Skibvoid ___pthread_cleanup_push_imp(void (*)(void *), void *, 416320942Skib struct _pthread_cleanup_info *); 417320942Skibvoid ___pthread_cleanup_pop_imp(int); 418320942Skib 419317342Skibvoid __throw_constraint_handler_s(const char * restrict msg, int error); 420317342Skib 42135124Sjb#endif /* _LIBC_PRIVATE_H_ */ 422