Index (Multithreaded Programming Guide)

Multithreaded Programming Guide

Previous: Appendix C MT Safety Levels: Library Interfaces


Numbers and Symbols

	64-bit environment
		large file support ( )
		large virtual address space ( )
		libraries ( )
		/proc restrictions ( )
		registers ( )

	32-bit architectures ( )

	__errno ( )

	__t_errno ( )


A

	Ada ( )

	adb ( ) ( )

	adding
		to LWP pool ( )
		signals to mask ( )

	aio_errno ( )

	AIO_INPROGRESS ( )

	aio_result_t ( ) ( ) ( )

	aiocancel(3) ( ) ( )

	aioread(3) ( ) ( ) ( )

	aiowait(3) ( )

	aiowrite(3) ( ) ( )

	algorithms
		faster with MT ( )
		parallel ( )
		sequential ( )

	alternate signal stacks ( ) ( )

	ANSI C ( )

	application-level threads ( )

	architecture
		multiprocessor ( )
		SPARC ( ) ( ) ( )

	assert statement ( ) ( ) ( )

	Async-Signal-Safe
		signal handlers ( )
		functions ( ) ( )

	asynchronous
		event notification ( )
		I/O ( ) ( ) ( )
		semaphore use ( )
		signals ( ) ( )

	atomic, defined ( )

	automatic
		LWP number adjustments ( )
		stack allocation ( )


B

	binary semaphores ( )

	binding
		reasons to bind ( ) ( ) ( ) ( )
		threads to LWPs ( )
		values to keys ( ) ( )

	bottlenecks ( )

	bound threads ( ) ( ) ( ) ( ) ( )
		alternate signal stacks ( )
		concurrency ( )
		defined ( )
		mixing with unbound threads ( )
		no LWP caching ( )
		priority ( )
		reasons to bind ( ) ( )
		scheduling class ( )


C

	C++ ( )

	cache, defined ( )

	caching
		not for bound thread LWPs ( )
		threads data structure ( )

	changing the signal mask ( ) ( )

	coarse-grained locking ( )

	code lock ( ) ( )

	code monitor ( ) ( )

	compile flag
		-D_POSIX_C_SOURCE ( )
		-D_REENTRANT ( )
		_REENTRANT ( )
		single-threaded application ( )

	completion semantics ( )

	concurrency ( ) ( ) ( ) ( )
		level ( )
		unbound threads ( )

	cond_broadcast ( ) ( )

	cond_destroy ( )

	cond_init ( )

	cond_init(3T) ( ) ( )

	cond_signal ( ) ( )

	cond_timedwait ( )

	cond_wait ( )

	cond_wait(3T) ( )

	condition variables ( ) ( ) ( ) ( )

	contention ( ) ( )

	continue execution ( )

	coroutine linkage ( )

	counting semaphores ( ) ( )

	creating
		stacks ( ) ( ) ( ) ( ) ( )
		thread-specific keys ( ) ( ) ( ) ( ) ( ) ( )
		threads ( ) ( ) ( ) ( )

	critical section ( )

	custom stack ( ) ( ) ( )


D

	daemon threads ( )

	data
		global ( )
		local ( )
		lock ( ) ( )
		profile ( )
		races ( )
		shared ( ) ( )
		thread specific
			See thread-specific data

	dbx ( )

	deadlock ( ) ( )

	debugging ( ) ( )
		adb ( )
		asynchronous signals ( )
		dbx ( )
		deadlocks ( )
		hidden gap in synchronization ( )
		inadequate stack size ( )
		large automatic arrays ( )
		long-jumping without releasing mutex lock ( )
		no synchronization of global memory ( )
		passing pointer to caller's stack ( )
		recursive deadlock ( )
		reevaluate conditions after return from condition wait ( )

	deleting signals from mask ( )

	destructor function ( ) ( )

	detached threads ( ) ( ) ( ) ( ) ( )

	Dijkstra, E. W. ( )


E

	EAGAIN ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	EBUSY ( ) ( ) ( ) ( ) ( )

	EDEADLK ( ) ( )

	EFAULT ( ) ( ) ( ) ( ) ( ) ( )

	EINTR ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	EINVAL ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	ENOMEM ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	ENOSPC ( )

	ENOSYS ( ) ( ) ( ) ( ) ( ) ( ) ( )

	ENOTRECOVERABLE ( ) ( )

	ENOTSUP ( ) ( ) ( ) ( ) ( )

	EOWNERDEAD ( ) ( )

	EPERM ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	errno ( ) ( ) ( ) ( )
		global variables ( )

	errno.h ( )

	error checking ( )

	ESRCH ( ) ( ) ( ) ( ) ( ) ( ) ( )

	ETIME ( )

	event notification ( )

	examining the signal mask ( ) ( )

	exec(2) ( ) ( ) ( ) ( )

	execution resources ( ) ( ) ( )

	exit(2) ( ) ( )

	exit(3C) ( )


F

	finding
		minimum stack size ( )
		thread concurrency level ( )
		thread priority ( )

	fine-grained locking ( )

	flags to thr_create() ( )

	flockfile(3S) ( )

	flowchart of compile options ( )

	fork ( )

	fork(2) ( ) ( )

	fork1(2) ( ) ( )

	FORTRAN ( )

	funlockfile(3S) ( )


G

	getc(3S) ( )

	getc_unlocked(3S) ( )

	gethostbyname(3N) ( )

	gethostbyname_r(3N) ( )

	getrusage(3B) ( )

	global
		data ( )
		side effects ( )
		state ( )
		variables ( ) ( ) ( ) ( )


H

	heap, malloc(3C) storage from ( )


I

	I/O
		asynchronous ( ) ( )
		nonsequential ( )
		standard ( )
		synchronous ( )

	inheriting priority ( )

	interrupt ( )

	interval timer ( )

	invariants ( ) ( )


J

	joining threads ( ) ( ) ( )


K

	kernel context switching ( )

	keys
		bind value to key ( )
		get specific key ( ) ( )
		global into private ( )
		storing value of ( ) ( )

	kill(2) ( ) ( )


L

	-lc ( ) ( )

	ld ( )

	libc ( ) ( ) ( )

	libC ( )

	libdl_stubs ( )

	libintl ( ) ( )

	libm ( ) ( )

	libmalloc ( ) ( )

	libmapmalloc ( ) ( )

	libnsl ( ) ( ) ( )

	libpthread ( ) ( )

	library
		C routines ( )
		MT safety ( )
		threads ( ) ( )

	libresolv ( )

	librt ( )

	libsocket ( ) ( )

	libthread ( ) ( ) ( ) ( )
		alternate library ( )

	libw ( ) ( )

	libX11 ( )

	lightweight processes ( ) ( ) ( ) ( ) ( )
		adding an LWP ( )
		creation ( )
		debugging ( )
		defined ( )
		independence ( )
		SunOS 4.0 ( )
		system calls ( )
		multiplexing ( )
		not supported ( )
		profile state ( )
		shortage ( )
		special capabilities ( )

	limits, resources ( )

	limits.h ( )

	linking ( )

	linking with alternate libthread library ( )
		LD_LIBRARY_PATH ( )
		LD_LIBRARY_PATH_64 ( )

	linking with libpthread
		-lc ( )
		ld ( )
		-lpthread ( )

	linking with libthread
		-lc ( )
		ld ( )
		-lthread ( )

	local variable ( )

	lock hierarchy ( )

	locking ( )
		coarse grained ( ) ( )
		code ( )
		conditional ( )
		data ( )
		fine-grained ( ) ( )
		guidelines ( ) ( )
		invariants ( )

	locks ( )
		mutual exclusion ( ) ( ) ( ) ( )
		read-write ( )
		readers/writer ( )

	longjmp(3C) ( ) ( )

	-lposix4 library, POSIX 1003.1c semaphore ( )

	-lpthread ( )

	lseek(2) ( )

	-lthread ( )

	LWPs
		See lightweight processes


M

	main() ( )

	malloc(3C) ( )

	MAP_NORESERVE ( )

	MAP_SHARED ( )

	memory
		consistency ( )
		ordering, relaxed ( )
		strongly ordered ( )

	mmap(2) ( ) ( )

	monitor, code ( ) ( )

	mprotect(2) ( ) ( )

	MT-Safe libraries ( )

	multiple-readers, single-writer locks ( )

	multiplexing with LWPs ( )

	multiprocessors ( ) ( )

	multithreading, defined ( )

	mutex
		PTHREAD_MUTEX_ERRORCHECK ( )
		PTHREAD_MUTEX_NORMAL ( )
		PTHREAD_MUTEX_RECUSIVE ( )

	mutex, mutual exclusion locks ( )

	mutex_destroy ( )

	mutex_init ( )

	mutex_init(3T) ( ) ( )

	mutex_lock ( )

	mutex scope ( )

	mutex_trylock ( )

	mutex_trylock(3T) ( )

	mutex_unlock ( )

	mutual exclusion locks ( ) ( ) ( ) ( )
		attributes ( )
		deadlock ( )
		default attributes ( )
		scope, Solaris and POSIX ( )
		type attribute ( )


N

	`NDEBUG` ( )

	netdir ( )

	netselect ( )

	nice(2) ( ) ( ) ( )

	nondetached threads ( ) ( )

	nonsequential I/O ( )

	null
		threads ( ) ( ) ( )

	null procedures
		libpthread stub ( )
		libthread stub ( )


P

	parallel
		algorithms ( )
		array computation ( )

	Pascal ( )

	PC, program counter ( )

	PC_GETCID ( )

	PC_GETCLINFO ( )

	PC_GETPARMS ( )

	PC_SETPARMS ( )

	per-process signal handler ( )

	per-thread signal handler ( )

	Peterson's Algorithm ( )

	PL/1 language ( )

	portability ( )

	POSIX 1003.4a ( )

	pread(2) ( ) ( )

	printf(3S) ( ) ( )

	printf problem ( )

	priocntl(2) ( ) ( ) ( )

	priority ( ) ( ) ( ) ( ) ( ) ( )
		finding for a thread ( )
		inheritance ( ) ( ) ( )
		and scheduling ( )
		range ( )
		setting for a thread ( )

	priority inversion ( )

	process
		terminating ( )
		traditional UNIX ( )

	producer/consumer problem ( ) ( ) ( )

	profil(2) ( )

	profiling an LWP ( )

	programmer-allocated stack ( ) ( ) ( ) ( )

	prolagen, semaphore, P operation ( )

	pthread_atfork ( )

	pthread_attr_getdetachstate ( )

	pthread_attr_getguardsize ( )

	pthread_attr_getinheritsched ( )

	pthread_attr_getschedparam ( )

	pthread_attr_getschedpolicy ( )

	pthread_attr_getscope ( )

	pthread_attr_getstackaddr ( )

	pthread_attr_getstacksize ( )

	pthread_attr_init ( )
		attribute values ( )

	pthread_attr_setdetachstate ( )

	pthread_attr_setguardsize ( )

	pthread_attr_setinheritsched ( )

	pthread_attr_setschedparam ( )

	pthread_attr_setschedpolicy ( )

	pthread_attr_setscope ( )

	pthread_attr_setstackaddr ( )

	pthread_attr_setstacksize ( )

	pthread_cancel ( )

	pthread_cleanup_pop ( )

	pthread_cleanup_push ( )

	pthread_cond_broadcast ( ) ( ) ( )
		example ( )

	pthread_cond_broadcast(3T) ( )

	pthread_cond_destroy ( )

	pthread_cond_init ( )

	pthread_cond_signal ( ) ( ) ( ) ( )
		example ( )

	pthread_cond_signal(3T) ( )

	pthread_cond_timedwait ( )
		example ( )

	pthread_cond_timedwait(3T) ( ) ( )

	pthread_cond_wait ( ) ( )

	`pthread_cond_wait` ( )

	pthread_cond_wait, example ( )

	pthread_cond_wait(3T) ( ) ( ) ( )

	pthread_condattr_destroy ( )

	pthread_condattr_getpshared ( )

	pthread_condattr_init ( )

	pthread_condattr_setpshared ( )

	pthread_create ( )

	pthread_detach ( )

	pthread_equal ( )

	pthread_exit ( ) ( )

	pthread_getconcurrency ( )

	pthread_getschedparam ( )

	pthread_getspecific ( ) ( ) ( )

	pthread.h ( )

	pthread_join ( ) ( )

	pthread_join(3T) ( ) ( )

	pthread_keycreate ( ) ( ) ( )

	pthread_keycreate(3T), example ( )

	pthread_keydelete ( )

	pthread_kill ( )

	pthread_kill(3T) ( )

	pthread_mutex_consistent_np ( )

	pthread_mutex_destroy ( )

	pthread_mutex_getprioceiling, get priority ceiling of mutex ( )

	pthread_mutex_init ( )

	pthread_mutex_lock ( )
		example ( ) ( )

	pthread_mutex_lock(3T), example ( )

	pthread_mutex_setprioceiling, set priority ceiling of mutex ( )

	pthread_mutex_trylock ( )

	`pthread_mutex_trylock` ( )

	pthread_mutex_unlock ( )
		example ( ) ( )

	pthread_mutex_unlock(3T), example ( )

	pthread_mutexattr_destroy ( ) ( )

	pthread_mutexattr_getprioceiling, get priority ceiling of mutex attribute ( )

	pthread_mutexattr_getprotocol, get protocol of mutex attribute ( )

	pthread_mutexattr_getpshared ( )

	pthread_mutexattr_getrobust_np, get robust attribute of mutex ( )

	pthread_mutexattr_gettype ( )

	pthread_mutexattr_init ( )

	pthread_mutexattr_setprioceiling, set priority ceiling of mutex attribute ( )

	pthread_mutexattr_setprotocol, set protocol of mutex attribute ( )

	pthread_mutexattr_setpshared ( )

	pthread_mutexattr_setrobust_np, set robust attribute of mutex ( )

	pthread_mutexattr_settype ( )

	pthread_once ( )

	PTHREAD_PRIO_INHERIT ( )

	PTHREAD_PRIO_NONE ( )

	PTHREAD_PRIO_PROTECT ( )

	pthread_rwlock_destroy ( )

	pthread_rwlock_init ( )

	pthread_rwlock_rdlock ( )

	pthread_rwlock_tryrdlock ( )

	pthread_rwlock_trywrlock ( )

	pthread_rwlock_unlock ( )

	pthread_rwlock_wrlock ( )

	pthread_rwlockattr_destroy ( )

	pthread_rwlockattr_getpshared ( )

	pthread_rwlockattr_init ( )

	pthread_rwlockattr_setpshared ( )

	PTHREAD_SCOPE_PROCESS ( ) ( )

	PTHREAD_SCOPE_SYSTEM ( ) ( )

	pthread_self ( )

	pthread_setcancelstate ( )

	pthread_setcanceltype ( )

	pthread_setconcurrency ( )

	pthread_setprio(3T) ( ) ( )

	pthread_setschedparam ( )

	pthread_setspecific ( ) ( ) ( )

	pthread_setspecific(3T), example ( )

	pthread_sigmask ( )

	pthread_sigsetmask(3T) ( )

	PTHREAD_STACK_MIN() ( )

	pthread_testcancel ( )

	pthread_yield ( )

	putc(3S) ( )

	putc_unlocked(3S) ( )

	pwrite(2) ( ) ( )


R

	_r ( )

	read(2) ( ) ( )

	read-write locks ( ) ( )
		attribute ( )
		attributes ( )

	readers/writer locks ( )

	realtime ( )
		scheduling ( ) ( )

	red zone ( ) ( ) ( )

	reentrant ( )
		described ( )
		functions ( ) ( )
		strategies for making ( )

	register state ( )

	relaxed memory ordering ( )

	remote procedure call RPC ( )

	replacing signal mask ( )

	resume execution ( ) ( )

	RPC ( ) ( ) ( )

	RT,
		See realtime

	rw_rdlock(3T) ( )

	rw_tryrdlock ( )

	rw_trywrlock ( )

	rw_unlock(3T) ( )

	rw_wrlock ( )

	rwlock_destroy ( )

	rwlock_init(3T) ( ) ( )


S

	SA_RESTART ( )

	safety, threads interfaces ( ) ( )

	scheduling
		class ( ) ( )
		compute-bound threads ( )
		priorities ( )
		realtime ( ) ( )
		system class ( )
		timeshare ( ) ( )

	sem_destroy ( )

	sem_init ( )
		example ( )

	sem_post ( ) ( )
		example ( )

	sem_trywait ( ) ( )

	sem_wait ( ) ( )
		example ( )

	sema_destroy ( )

	sema_init ( )

	sema_init(3T) ( )

	sema_post ( )

	sema_post(3T) ( )

	sema_trywait ( )

	sema_wait ( )

	semaphores ( ) ( ) ( )
		binary ( )
		counting ( )
		counting, defined ( )
		decrement semaphore value ( )
		increment semaphore value ( )
		interprocess ( )
		intraprocess ( )
		named ( )

	sending signal to thread ( ) ( )

	sequential algorithms ( )

	setjmp(3C) ( ) ( ) ( )

	shared data ( ) ( )

	shared-memory multiprocessor ( )

	SIG_BLOCK ( )

	SIG_DFL ( )

	SIG_IGN ( )

	SIG_SETMASK ( )

	SIG_UNBLOCK ( )

	sigaction(2) ( ) ( ) ( ) ( ) ( )

	sigaltstack(2) ( )

	SIGFPE ( ) ( )

	SIGILL ( )

	SIGINT ( ) ( ) ( )

	SIGIO ( ) ( )

	siglongjmp(3C) ( ) ( ) ( )

	signal(2) ( )

	signal(5) ( )

	signal.h ( ) ( ) ( ) ( ) ( )

	signals
		access mask ( ) ( )
		add to mask ( )
		asynchronous ( ) ( )
		delete from mask ( )
		handler ( ) ( ) ( )
		inheritance ( )
		masks ( )
		pending ( ) ( )
		replace current mask ( )
		send to thread ( ) ( )
		SIG_BLOCK ( )
		SIG_SETMASK ( )
		SIG_UNBLOCK ( )
		SIGSEGV ( )
		stack ( )
		unmasked and caught ( )

	sigprocmask(2) ( )

	SIGPROF ( )

	SIGSEGV ( ) ( )

	sigsend(2) ( )

	sigsetjmp(3C) ( ) ( )

	sigtimedwait(2) ( )

	SIGVTALRM ( )

	sigwait(2) ( ) ( ) ( ) ( )

	SIGWAITING ( )

	single-threaded
		assumptions ( )
		code ( )
		defined ( )
		processes ( )

	size of stack ( ) ( ) ( ) ( ) ( )

	stack ( ) ( )
		address ( ) ( )
		boundaries ( )
		creation ( ) ( )
		custom ( )
		deallocation ( )
		minimum size ( ) ( )
		overflows ( )
		parameters ( )
		pointer ( )
		programmer-allocated ( ) ( ) ( ) ( )
		red zone ( ) ( ) ( )
		returning a pointer to ( )
		size ( ) ( ) ( ) ( ) ( ) ( )

	stack_base ( ) ( )

	stack_size ( ) ( )

	standard I/O ( )

	standards ( )

	start_routine ( )

	static storage ( ) ( )

	stdio ( ) ( )

	store buffer ( )

	storing thread key value ( ) ( )

	streaming a tape drive ( )

	strongly ordered memory ( )

	strtoaddr ( )

	suspending a new thread ( )

	swap space ( )

	synchronization objects ( ) ( )
		condition variables ( ) ( ) ( )
		mutex locks ( ) ( )
		read-write locks ( )
		semaphores ( ) ( ) ( ) ( ) ( )

	synchronous I/O ( ) ( )

	system calls
		handling errors ( )
		and LWPs ( )

	system scheduling class ( )


T

	tape drive, streaming ( )

	terminating
		process ( )
		threads ( )

	THR_BOUND ( ) ( )

	thr_continue ( )

	thr_continue(3T) ( )

	thr_create ( )

	thr_create(3T) ( ) ( )

	THR_DAEMON ( )

	THR_DETACHED ( )

	thr_exit ( )

	thr_exit(3T) ( )

	thr_getconcurrency ( )

	thr_getconcurrency(3T) ( )

	thr_getprio ( )

	thr_getspecific ( )

	thr_join ( )

	thr_keycreate ( )

	thr_kill ( )

	thr_kill(3T) ( )

	thr_min_stack(3T) ( ) ( )

	THR_NEW_LWP ( ) ( ) ( )

	thr_self(3T) ( ) ( )

	thr_setconcurrency ( )

	thr_setconcurrency(3T) ( ) ( ) ( ) ( ) ( )

	thr_setprio ( )

	thr_setspecific ( )

	thr_sigsetmask(3T) ( )

	THR_SUSPENDED ( )

	thr_yield(3T) ( ) ( )

	thread-directed signal ( )

	thread.h ( )

	thread-private storage ( )

	thread-specific data ( ) ( )
		global ( ) ( ) ( )
		global into private ( )
		new storage class ( )
		private ( )

	thread synchronization
		condition variables ( )
		mutex locks ( )
		mutual exclusion locks ( )
		read-write locks ( )
		semaphores ( ) ( ) ( )

	threads
		compute-bound ( )
		concurrencyconcurrency ( )
		creating ( ) ( ) ( ) ( ) ( ) ( )
		daemon ( )
		defined ( )
		detached ( ) ( ) ( ) ( )
		exit codes ( )
		exit status ( )
		identifiers ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		initial ( )
		joining ( ) ( ) ( )
		keyskeys ( )
		library ( ) ( )
		lightweight processes ( )
		nondetached ( ) ( )
		null ( ) ( ) ( )
		prioritypriority ( )
		private data ( )
		safety ( ) ( )
		signalssignals ( )
		stacksstack ( )
		suspended ( )
		suspending ( )
		synchronizing ( ) ( )
		terminating ( ) ( ) ( )
		thread-specific data ( )
		unbound threads ( )
		user-level ( ) ( ) ( )

	time-out ( ) ( )

	time slicing ( )

	timeshare scheduling class ( ) ( ) ( )

	tiuser.h ( )

	TLI ( ) ( )

	tools
		adb ( )
		dbx ( )
		debugger ( )

	total store order ( )

	trap ( )

	TS,
		See timeshare scheduling class

	TSD
		See thread-specific data


U

	unbound threads ( )
		alternate signal stacks ( )
		caching ( )
		concurrency ( ) ( )
		defined ( )
		disadvantage ( )
		mixing with bound threads ( )
		priorities ( ) ( )
		reasons not to bind ( ) ( )
		and scheduling ( ) ( ) ( )
		and thr_setconcurrency(3T) ( ) ( )
		and pthread_setprio(3T) ( ) ( )

	unistd.h ( )

	UNIX ( ) ( ) ( ) ( ) ( ) ( ) ( )

	user-level threads ( ) ( ) ( )

	user space ( )

	USYNC_PROCESS ( ) ( ) ( ) ( ) ( ) ( ) ( )

	USYNC_PROCESS_ROBUST ( )

	USYNC_THREAD ( ) ( ) ( ) ( ) ( ) ( )


V

	variables
		condition ( ) ( ) ( ) ( )
		global ( )
		primitive ( )

	verhogen, semaphore, V operation ( )

	vfork(2) ( )


W

	write(2) ( ) ( )


X

	XDR ( )

Previous: Appendix C MT Safety Levels: Library Interfaces