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