libc_private.h revision 281981
1263409Smarcel/* 2263409Smarcel * Copyright (c) 1998 John Birrell <jb@cimlogic.com.au>. 3263409Smarcel * All rights reserved. 4263409Smarcel * 5263409Smarcel * Redistribution and use in source and binary forms, with or without 6263409Smarcel * modification, are permitted provided that the following conditions 7263409Smarcel * are met: 8263409Smarcel * 1. Redistributions of source code must retain the above copyright 9263409Smarcel * notice, this list of conditions and the following disclaimer. 10263409Smarcel * 2. Redistributions in binary form must reproduce the above copyright 11263409Smarcel * notice, this list of conditions and the following disclaimer in the 12263409Smarcel * documentation and/or other materials provided with the distribution. 13263409Smarcel * 3. Neither the name of the author nor the names of any co-contributors 14263409Smarcel * may be used to endorse or promote products derived from this software 15263409Smarcel * without specific prior written permission. 16263409Smarcel * 17263409Smarcel * THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND 18263409Smarcel * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19263409Smarcel * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20263409Smarcel * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21263409Smarcel * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22263409Smarcel * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23263409Smarcel * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24263409Smarcel * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25263409Smarcel * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26263409Smarcel * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27263409Smarcel * SUCH DAMAGE. 28263409Smarcel * 29263409Smarcel * $FreeBSD: stable/10/lib/libc/include/libc_private.h 281981 2015-04-25 08:14:08Z kib $ 30263409Smarcel * 31263442Smarcel * Private definitions for libc, libc_r and libpthread. 32263674Smarcel * 33263442Smarcel */ 34263409Smarcel 35263674Smarcel#ifndef _LIBC_PRIVATE_H_ 36263674Smarcel#define _LIBC_PRIVATE_H_ 37263409Smarcel#include <sys/_types.h> 38268161Smarcel#include <sys/_pthreadtypes.h> 39263409Smarcel 40263409Smarcel/* 41263409Smarcel * This global flag is non-zero when a process has created one 42292341Semaste * or more threads. It is used to avoid calling locking functions 43292341Semaste * when they are not required. 44292341Semaste */ 45268161Smarcelextern int __isthreaded; 46268161Smarcel 47268161Smarcel/* 48268161Smarcel * Elf_Auxinfo *__elf_aux_vector, the pointer to the ELF aux vector 49263409Smarcel * provided by kernel. Either set for us by rtld, or found at runtime 50292341Semaste * on stack for static binaries. 51263674Smarcel * 52263674Smarcel * Type is void to avoid polluting whole libc with ELF types. 53263487Smarcel */ 54263409Smarcelextern void *__elf_aux_vector; 55263409Smarcel 56272030Smarcel/* 57272030Smarcel * libc should use libc_dlopen internally, which respects a global 58263409Smarcel * flag where loading of new shared objects can be restricted. 59263409Smarcel */ 60272030Smarcelvoid *libc_dlopen(const char *, int); 61272030Smarcel 62263409Smarcel/* 63263409Smarcel * For dynamic linker. 64263674Smarcel */ 65272776Smarcelvoid _rtld_error(const char *fmt, ...); 66263674Smarcel 67272776Smarcel/* 68263674Smarcel * File lock contention is difficult to diagnose without knowing 69272776Smarcel * where locks were set. Allow a debug library to be built which 70272776Smarcel * records the source file and line number of each lock call. 71272776Smarcel */ 72272776Smarcel#ifdef _FLOCK_DEBUG 73263674Smarcel#define _FLOCKFILE(x) _flockfile_debug(x, __FILE__, __LINE__) 74263674Smarcel#else 75263442Smarcel#define _FLOCKFILE(x) _flockfile(x) 76268161Smarcel#endif 77263442Smarcel 78263674Smarcel/* 79263674Smarcel * Macros for locking and unlocking FILEs. These test if the 80263674Smarcel * process is threaded to avoid locking when not required. 81272776Smarcel */ 82263674Smarcel#define FLOCKFILE(fp) if (__isthreaded) _FLOCKFILE(fp) 83263674Smarcel#define FUNLOCKFILE(fp) if (__isthreaded) _funlockfile(fp) 84263674Smarcel 85263674Smarcelstruct _spinlock; 86263674Smarcelextern struct _spinlock __stdio_thread_lock __hidden; 87263674Smarcel#define STDIO_THREAD_LOCK() \ 88263674Smarceldo { \ 89263674Smarcel if (__isthreaded) \ 90263674Smarcel _SPINLOCK(&__stdio_thread_lock); \ 91263674Smarcel} while (0) 92263843Smarcel#define STDIO_THREAD_UNLOCK() \ 93272776Smarceldo { \ 94263674Smarcel if (__isthreaded) \ 95263843Smarcel _SPINUNLOCK(&__stdio_thread_lock); \ 96263674Smarcel} while (0) 97263674Smarcel 98272776Smarcelvoid __libc_spinlock_stub(struct _spinlock *); 99263843Smarcelvoid __libc_spinunlock_stub(struct _spinlock *); 100272776Smarcel 101263674Smarcel/* 102263674Smarcel * Indexes into the pthread jump table. 103263674Smarcel * 104272776Smarcel * Warning! If you change this type, you must also change the threads 105263674Smarcel * libraries that reference it (libc_r, libpthread). 106263674Smarcel */ 107263843Smarceltypedef enum { 108263674Smarcel PJT_ATFORK, 109263674Smarcel PJT_ATTR_DESTROY, 110272776Smarcel PJT_ATTR_GETDETACHSTATE, 111263843Smarcel PJT_ATTR_GETGUARDSIZE, 112272776Smarcel PJT_ATTR_GETINHERITSCHED, 113263674Smarcel PJT_ATTR_GETSCHEDPARAM, 114263674Smarcel PJT_ATTR_GETSCHEDPOLICY, 115268161Smarcel PJT_ATTR_GETSCOPE, 116263674Smarcel PJT_ATTR_GETSTACKADDR, 117263674Smarcel PJT_ATTR_GETSTACKSIZE, 118263674Smarcel PJT_ATTR_INIT, 119263674Smarcel PJT_ATTR_SETDETACHSTATE, 120263674Smarcel PJT_ATTR_SETGUARDSIZE, 121263674Smarcel PJT_ATTR_SETINHERITSCHED, 122263674Smarcel PJT_ATTR_SETSCHEDPARAM, 123263674Smarcel PJT_ATTR_SETSCHEDPOLICY, 124263442Smarcel PJT_ATTR_SETSCOPE, 125263442Smarcel PJT_ATTR_SETSTACKADDR, 126263409Smarcel PJT_ATTR_SETSTACKSIZE, 127263409Smarcel PJT_CANCEL, 128263409Smarcel PJT_CLEANUP_POP, 129263409Smarcel PJT_CLEANUP_PUSH, 130263440Smarcel PJT_COND_BROADCAST, 131263442Smarcel PJT_COND_DESTROY, 132263700Smarcel PJT_COND_INIT, 133263700Smarcel PJT_COND_SIGNAL, 134263409Smarcel PJT_COND_TIMEDWAIT, 135263409Smarcel PJT_COND_WAIT, 136263409Smarcel PJT_DETACH, 137 PJT_EQUAL, 138 PJT_EXIT, 139 PJT_GETSPECIFIC, 140 PJT_JOIN, 141 PJT_KEY_CREATE, 142 PJT_KEY_DELETE, 143 PJT_KILL, 144 PJT_MAIN_NP, 145 PJT_MUTEXATTR_DESTROY, 146 PJT_MUTEXATTR_INIT, 147 PJT_MUTEXATTR_SETTYPE, 148 PJT_MUTEX_DESTROY, 149 PJT_MUTEX_INIT, 150 PJT_MUTEX_LOCK, 151 PJT_MUTEX_TRYLOCK, 152 PJT_MUTEX_UNLOCK, 153 PJT_ONCE, 154 PJT_RWLOCK_DESTROY, 155 PJT_RWLOCK_INIT, 156 PJT_RWLOCK_RDLOCK, 157 PJT_RWLOCK_TRYRDLOCK, 158 PJT_RWLOCK_TRYWRLOCK, 159 PJT_RWLOCK_UNLOCK, 160 PJT_RWLOCK_WRLOCK, 161 PJT_SELF, 162 PJT_SETCANCELSTATE, 163 PJT_SETCANCELTYPE, 164 PJT_SETSPECIFIC, 165 PJT_SIGMASK, 166 PJT_TESTCANCEL, 167 PJT_CLEANUP_POP_IMP, 168 PJT_CLEANUP_PUSH_IMP, 169 PJT_CANCEL_ENTER, 170 PJT_CANCEL_LEAVE, 171 PJT_MAX 172} pjt_index_t; 173 174typedef int (*pthread_func_t)(void); 175typedef pthread_func_t pthread_func_entry_t[2]; 176 177extern pthread_func_entry_t __thr_jtable[]; 178 179void __set_error_selector(int *(*arg)(void)); 180int _pthread_mutex_init_calloc_cb_stub(pthread_mutex_t *mutex, 181 void *(calloc_cb)(__size_t, __size_t)); 182 183typedef int (*interpos_func_t)(void); 184interpos_func_t *__libc_interposing_slot(int interposno); 185extern interpos_func_t __libc_interposing[] __hidden; 186 187enum { 188 INTERPOS_accept, 189 INTERPOS_accept4, 190 INTERPOS_aio_suspend, 191 INTERPOS_close, 192 INTERPOS_connect, 193 INTERPOS_fcntl, 194 INTERPOS_fsync, 195 INTERPOS_fork, 196 INTERPOS_msync, 197 INTERPOS_nanosleep, 198 INTERPOS_openat, 199 INTERPOS_poll, 200 INTERPOS_pselect, 201 INTERPOS_recvfrom, 202 INTERPOS_recvmsg, 203 INTERPOS_select, 204 INTERPOS_sendmsg, 205 INTERPOS_sendto, 206 INTERPOS_setcontext, 207 INTERPOS_sigaction, 208 INTERPOS_sigprocmask, 209 INTERPOS_sigsuspend, 210 INTERPOS_sigwait, 211 INTERPOS_sigtimedwait, 212 INTERPOS_sigwaitinfo, 213 INTERPOS_swapcontext, 214 INTERPOS_system, 215 INTERPOS_tcdrain, 216 INTERPOS_read, 217 INTERPOS_readv, 218 INTERPOS_wait4, 219 INTERPOS_write, 220 INTERPOS_writev, 221 INTERPOS__pthread_mutex_init_calloc_cb, 222 INTERPOS_spinlock, 223 INTERPOS_spinunlock, 224 INTERPOS_kevent, 225 INTERPOS_wait6, 226 INTERPOS_ppoll, 227 INTERPOS_MAX 228}; 229 230/* 231 * yplib internal interfaces 232 */ 233#ifdef YP 234int _yp_check(char **); 235#endif 236 237/* 238 * Initialise TLS for static programs 239 */ 240void _init_tls(void); 241 242/* 243 * Provides pthread_once()-like functionality for both single-threaded 244 * and multi-threaded applications. 245 */ 246int _once(pthread_once_t *, void (*)(void)); 247 248/* 249 * Set the TLS thread pointer 250 */ 251void _set_tp(void *tp); 252 253/* 254 * This is a pointer in the C run-time startup code. It is used 255 * by getprogname() and setprogname(). 256 */ 257extern const char *__progname; 258 259/* 260 * This function is used by the threading libraries to notify malloc that a 261 * thread is exiting. 262 */ 263void _malloc_thread_cleanup(void); 264 265/* 266 * These functions are used by the threading libraries in order to protect 267 * malloc across fork(). 268 */ 269void _malloc_prefork(void); 270void _malloc_postfork(void); 271 272void _malloc_first_thread(void); 273 274/* 275 * Function to clean up streams, called from abort() and exit(). 276 */ 277extern void (*__cleanup)(void) __hidden; 278 279/* 280 * Get kern.osreldate to detect ABI revisions. Explicitly 281 * ignores value of $OSVERSION and caches result. Prototypes 282 * for the wrapped "new" pad-less syscalls are here for now. 283 */ 284int __getosreldate(void); 285#include <sys/_types.h> 286#include <sys/_sigset.h> 287 288/* With pad */ 289__off_t __sys_freebsd6_lseek(int, int, __off_t, int); 290int __sys_freebsd6_ftruncate(int, int, __off_t); 291int __sys_freebsd6_truncate(const char *, int, __off_t); 292__ssize_t __sys_freebsd6_pread(int, void *, __size_t, int, __off_t); 293__ssize_t __sys_freebsd6_pwrite(int, const void *, __size_t, int, __off_t); 294void * __sys_freebsd6_mmap(void *, __size_t, int, int, int, int, __off_t); 295 296struct aiocb; 297struct fd_set; 298struct iovec; 299struct kevent; 300struct msghdr; 301struct pollfd; 302struct rusage; 303struct sigaction; 304struct sockaddr; 305struct timespec; 306struct timeval; 307struct timezone; 308struct __siginfo; 309struct __ucontext; 310struct __wrusage; 311enum idtype; 312int __sys_aio_suspend(const struct aiocb * const[], int, 313 const struct timespec *); 314int __sys_accept(int, struct sockaddr *, __socklen_t *); 315int __sys_accept4(int, struct sockaddr *, __socklen_t *, int); 316int __sys_clock_gettime(__clockid_t, struct timespec *ts); 317int __sys_close(int); 318int __sys_connect(int, const struct sockaddr *, __socklen_t); 319int __sys_fcntl(int, int, ...); 320int __sys_fsync(int); 321__pid_t __sys_fork(void); 322int __sys_ftruncate(int, __off_t); 323int __sys_gettimeofday(struct timeval *, struct timezone *); 324int __sys_kevent(int, const struct kevent *, int, struct kevent *, 325 int, const struct timespec *); 326__off_t __sys_lseek(int, __off_t, int); 327void *__sys_mmap(void *, __size_t, int, int, int, __off_t); 328int __sys_msync(void *, __size_t, int); 329int __sys_nanosleep(const struct timespec *, struct timespec *); 330int __sys_open(const char *, int, ...); 331int __sys_openat(int, const char *, int, ...); 332int __sys_pselect(int, struct fd_set *, struct fd_set *, 333 struct fd_set *, const struct timespec *, 334 const __sigset_t *); 335int __sys_poll(struct pollfd *, unsigned, int); 336int __sys_ppoll(struct pollfd *, unsigned, const struct timespec *, 337 const __sigset_t *); 338__ssize_t __sys_pread(int, void *, __size_t, __off_t); 339__ssize_t __sys_pwrite(int, const void *, __size_t, __off_t); 340__ssize_t __sys_read(int, void *, __size_t); 341__ssize_t __sys_readv(int, const struct iovec *, int); 342__ssize_t __sys_recv(int, void *, __size_t, int); 343__ssize_t __sys_recvfrom(int, void *, __size_t, int, struct sockaddr *, 344 __socklen_t *); 345__ssize_t __sys_recvmsg(int, struct msghdr *, int); 346int __sys_select(int, struct fd_set *, struct fd_set *, 347 struct fd_set *, struct timeval *); 348__ssize_t __sys_sendmsg(int, const struct msghdr *, int); 349__ssize_t __sys_sendto(int, const void *, __size_t, int, 350 const struct sockaddr *, __socklen_t); 351int __sys_setcontext(const struct __ucontext *); 352int __sys_sigaction(int, const struct sigaction *, 353 struct sigaction *); 354int __sys_sigprocmask(int, const __sigset_t *, __sigset_t *); 355int __sys_sigsuspend(const __sigset_t *); 356int __sys_sigtimedwait(const __sigset_t *, struct __siginfo *, 357 const struct timespec *); 358int __sys_sigwait(const __sigset_t *, int *); 359int __sys_sigwaitinfo(const __sigset_t *, struct __siginfo *); 360int __sys_swapcontext(struct __ucontext *, 361 const struct __ucontext *); 362int __sys_thr_kill(long, int); 363int __sys_thr_self(long *); 364int __sys_truncate(const char *, __off_t); 365__pid_t __sys_wait4(__pid_t, int *, int, struct rusage *); 366__pid_t __sys_wait6(enum idtype, __id_t, int *, int, 367 struct __wrusage *, struct __siginfo *); 368__ssize_t __sys_write(int, const void *, __size_t); 369__ssize_t __sys_writev(int, const struct iovec *, int); 370 371int __libc_sigwait(const __sigset_t * __restrict, 372 int * restrict sig); 373int __libc_system(const char *); 374int __libc_tcdrain(int); 375int __fcntl_compat(int fd, int cmd, ...); 376 377/* execve() with PATH processing to implement posix_spawnp() */ 378int _execvpe(const char *, char * const *, char * const *); 379 380int _elf_aux_info(int aux, void *buf, int buflen); 381struct dl_phdr_info; 382int __elf_phdr_match_addr(struct dl_phdr_info *, void *); 383void __init_elf_aux_vector(void); 384 385void _pthread_cancel_enter(int); 386void _pthread_cancel_leave(int); 387 388#endif /* _LIBC_PRIVATE_H_ */ 389