xref: /illumos-gate/usr/src/lib/libnsl/include/mt.h (revision 7257d1b4)
17c478bd9Sstevel@tonic-gate /*
27c478bd9Sstevel@tonic-gate  * CDDL HEADER START
37c478bd9Sstevel@tonic-gate  *
47c478bd9Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
5*7257d1b4Sraf  * Common Development and Distribution License (the "License").
6*7257d1b4Sraf  * You may not use this file except in compliance with the License.
77c478bd9Sstevel@tonic-gate  *
87c478bd9Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bd9Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
107c478bd9Sstevel@tonic-gate  * See the License for the specific language governing permissions
117c478bd9Sstevel@tonic-gate  * and limitations under the License.
127c478bd9Sstevel@tonic-gate  *
137c478bd9Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
147c478bd9Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bd9Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
167c478bd9Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
177c478bd9Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
187c478bd9Sstevel@tonic-gate  *
197c478bd9Sstevel@tonic-gate  * CDDL HEADER END
207c478bd9Sstevel@tonic-gate  */
227c478bd9Sstevel@tonic-gate /*
23*7257d1b4Sraf  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
247c478bd9Sstevel@tonic-gate  * Use is subject to license terms.
257c478bd9Sstevel@tonic-gate  */
277c478bd9Sstevel@tonic-gate #ifndef	_LIBNSL_INCLUDE_MT_H
287c478bd9Sstevel@tonic-gate #define	_LIBNSL_INCLUDE_MT_H
307c478bd9Sstevel@tonic-gate #pragma ident	"%Z%%M%	%I%	%E% SMI"
327c478bd9Sstevel@tonic-gate /*
337c478bd9Sstevel@tonic-gate  * Threading and mutual exclusion declarations of primitives used for
347c478bd9Sstevel@tonic-gate  *	MT operation of libnsl code.
357c478bd9Sstevel@tonic-gate  *
367c478bd9Sstevel@tonic-gate  * Note: These primitives are designed to achieve the effect of avoiding a
377c478bd9Sstevel@tonic-gate  *	 deadlock possibility by an interface operation being called from
387c478bd9Sstevel@tonic-gate  *	 a signal handler while holding a lock.
397c478bd9Sstevel@tonic-gate  * Note: the sig_*() functions use the _sigoff() and _sigon() consolidation
407c478bd9Sstevel@tonic-gate  *       private interfaces provided by libc to defer all asynchronously
417c478bd9Sstevel@tonic-gate  *       generated signals for the duration of holding the lock.  Unlike
427c478bd9Sstevel@tonic-gate  *	 blocking all signals with sigprocmask() or thr_sigsetmask(),
437c478bd9Sstevel@tonic-gate  *	 _sigoff() allows signals with default dispositions to exercise
447c478bd9Sstevel@tonic-gate  *	 their default actions (killing the process, stopping the process).
457c478bd9Sstevel@tonic-gate  */
477c478bd9Sstevel@tonic-gate #include <thread.h>
487c478bd9Sstevel@tonic-gate #include <pthread.h>
497c478bd9Sstevel@tonic-gate #include <signal.h>
507c478bd9Sstevel@tonic-gate #include <synch.h>
527c478bd9Sstevel@tonic-gate #ifdef	__cplusplus
537c478bd9Sstevel@tonic-gate extern "C" {
547c478bd9Sstevel@tonic-gate #endif
567c478bd9Sstevel@tonic-gate extern sigset_t fillset;	/* for actually blocking all signals */
587c478bd9Sstevel@tonic-gate extern void sig_mutex_lock(mutex_t *);
597c478bd9Sstevel@tonic-gate extern void sig_mutex_unlock(mutex_t *);
607c478bd9Sstevel@tonic-gate extern void sig_rw_rdlock(rwlock_t *);
617c478bd9Sstevel@tonic-gate extern void sig_rw_wrlock(rwlock_t *);
627c478bd9Sstevel@tonic-gate extern void sig_rw_unlock(rwlock_t *);
647c478bd9Sstevel@tonic-gate extern void _sigoff(void);
657c478bd9Sstevel@tonic-gate extern void _sigon(void);
677c478bd9Sstevel@tonic-gate extern void *thr_get_storage(pthread_key_t *, size_t, void(*)(void *));
697c478bd9Sstevel@tonic-gate #ifdef	__cplusplus
707c478bd9Sstevel@tonic-gate }
717c478bd9Sstevel@tonic-gate #endif
737c478bd9Sstevel@tonic-gate #endif	/* _LIBNSL_INCLUDE_MT_H */