/*
 * @OSF_COPYRIGHT@
 * COPYRIGHT NOTICE
 * Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.
 * ALL RIGHTS RESERVED (DCE).  See the file named COPYRIGHT.DCE in the
 * src directory for the full copyright text.
 */
/*
 * HISTORY
 * $Log: cma_defer.h,v $
 * Revision 1.1.2.3  1992/12/15  22:27:45  alan
 * 	Insert copyright notices
 * 	[1992/12/07  19:37:54  alan]
 *
 * Revision 1.1.2.2  1992/09/03  14:36:34  bolinger
 * 	Replace current source file with equivalent from DEC BL10+
 * 	source base, as originally integrated in the
 * 	nosupport/threads_bl10 tree.  (See OT defect 5300.)
 * 	[1992/09/02  14:02:48  bolinger]
 * 
 * Revision 1.1.2.2  1992/05/08  23:13:06  bolinger
 * 	BL10 CMA sources from DEC.
 * 	[1992/05/08  23:12:52  bolinger]
 * 
 * Revision 1.1  1992/01/19  14:39:02  devrcs
 * 	Initial revision
 * 
 * $EndLog$
 */
/*
 *	%W%	(DEC OSF/1)	%G%
 */
/*
 *  Copyright (c) 1990, 1991 by
 *  Digital Equipment Corporation, Maynard Massachusetts.
 *  All rights reserved.
 *
 * This software is furnished under a licence and may be used and
 * copied only in accordance of the terms of such license and
 * with the inclusion of the above copyright notice. This
 * software or any other copies thereof may be provided or
 * otherwise made available to any other person. No title to and
 * ownership of the software is herby transferred.
 *
 * The information in this software is subject to change without
 * notice and should not be construed as a commitment by DIGITAL
 * Equipment Corporation.
 *
 * DIGITAL assumes no responability for the use or reliability
 * of its software on equipment which is not supplied by DIGITAL.
 */

/*
 * FACILITY:
 *
 *	CMA services
 *
 * ABSTRACT:
 *
 *	These routines allow actions which cannot be performed immediately
 *	to be deferred until a time when they can be performed immediately.
 *
 * AUTHOR:
 *
 *	Webb Scales
 *
 * CREATION DATE:
 *
 *	25 July 1990
 *
 * MODIFICATION HISTORY:
 *
 *	001	Dave Butenhof	03 August 1990
 *		Change the names of the semaphore deferral constants to fit
 *		new terms (wake_one and wake_all).
 *	002	Dave Butenhof	09 April 1991
 *		Use new type for "atomic bit" operation target
 *	003	Dave Butenhof	02 May 1991
 *		Remove defer_alert code.
 *	004	Paul Curtin	04 June 1991
 *		Add prototype for reinit routine.
 *	005	Dave Butenhof	21 November 1991
 *		Add prototype for cma__int_signal_int.
 *	006	Dave Butenhof	22 November 1991
 *		Fix 005.
 */


#ifndef CMA_DEFER
#define CMA_DEFER

/*
 * INCLUDE FILES
 */

#include <cma.h>
#include <cma_defs.h>
#include <cma_cond_defs.h>

/*
 * CONSTANTS AND MACROS
 */


/*
 * Define constants for deferral actions
 */
#define cma__c_defer_wake_one	1
#define cma__c_defer_wake_all	2
#define cma__c_defer_io_avail	3

/*
 * TYPEDEFS
 */


/*
 * GLOBAL DATA
 */

extern cma__t_atomic_bit cma__g_defers_processed; /* Zero if some defers exist*/


/*
 * INTERNAL INTERFACES
 */

/*
 * Defer unblocking of a thread: If the kernel is in its critical section,
 * any unblocking operation is deferred using this call.
 */
extern void
cma__defer _CMA_PROTOTYPE_ ((
	cma_t_integer	type,
	cma_t_address	value1,
	cma_t_address	value2));

/*
 * Initialize the defer mechanisms
 */
extern void
cma__init_defer _CMA_PROTOTYPE_ ((void));

/*
 * Internal deferred signal
 */
extern void
cma__int_signal_int _CMA_PROTOTYPE_ ((cma__t_int_cv	*int_cv));

/*
 * Re-initialize defer queue after fork
 */
extern void
cma__reinit_defer _CMA_PROTOTYPE_ ((
	cma_t_integer	    flag));

/*
 * Undefer unblocking of a thread: opon leaving the critical section,
 * all deferred operations are executed.
 */
extern cma_t_integer
cma__undefer _CMA_PROTOTYPE_ ((void));

#endif
/*  DEC/CMS REPLACEMENT HISTORY, Element CMA_DEFER.H */
/*  *9    22-NOV-1991 11:55:32 BUTENHOF "Fix prototype " */
/*  *8    21-NOV-1991 13:54:25 BUTENHOF "Add prototype for cma__int_signal_int()" */
/*  *7    10-JUN-1991 19:52:26 SCALES "Convert to stream format for ULTRIX build" */
/*  *6    10-JUN-1991 19:20:32 BUTENHOF "Fix the sccs headers" */
/*  *5    10-JUN-1991 18:21:22 SCALES "Add sccs headers for Ultrix" */
/*  *4     5-JUN-1991 16:16:55 CURTIN "fork work" */
/*  *3     2-MAY-1991 13:58:02 BUTENHOF "Remove defer_alert" */
/*  *2    12-APR-1991 23:35:23 BUTENHOF "Change type of internal locks" */
/*  *1    12-DEC-1990 21:44:21 BUTENHOF "Defer events while kernel locked" */
/*  DEC/CMS REPLACEMENT HISTORY, Element CMA_DEFER.H */