1 /*	$OpenBSD: rf_callback.h,v 1.3 2002/12/16 07:01:03 tdeval Exp $	*/
2 /*	$NetBSD: rf_callback.h,v 1.3 1999/02/05 00:06:06 oster Exp $	*/
3 
4 /*
5  * Copyright (c) 1995 Carnegie-Mellon University.
6  * All rights reserved.
7  *
8  * Author: Mark Holland
9  *
10  * Permission to use, copy, modify and distribute this software and
11  * its documentation is hereby granted, provided that both the copyright
12  * notice and this permission notice appear in all copies of the
13  * software, derivative works or modified versions, and any portions
14  * thereof, and that both notices appear in supporting documentation.
15  *
16  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
17  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
18  * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
19  *
20  * Carnegie Mellon requests users of this software to return to
21  *
22  *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
23  *  School of Computer Science
24  *  Carnegie Mellon University
25  *  Pittsburgh PA 15213-3890
26  *
27  * any improvements or extensions that they make and grant Carnegie the
28  * rights to redistribute these changes.
29  */
30 
31 /*****************************************************************************
32  *
33  * rf_callback.h -- Header file for callback.c
34  *
35  * The reconstruction code must manage concurrent I/Os on multiple drives.
36  * It sometimes needs to suspend operation on a particular drive until some
37  * condition occurs. We can't block the thread, of course, or we wouldn't
38  * be able to manage our other outstanding I/Os. Instead we just suspend
39  * new activity on the indicated disk, and create a callback descriptor and
40  * put it someplace where it will get invoked when the condition that's
41  * stalling us has cleared. When the descriptor is invoked, it will call
42  * a function that will restart operation on the indicated disk.
43  *
44  *****************************************************************************/
45 
46 #ifndef	_RF__RF_CALLBACK_H_
47 #define	_RF__RF_CALLBACK_H_
48 
49 #include "rf_types.h"
50 
51 struct RF_CallbackDesc_s {
52 	void		(*callbackFunc) (RF_CBParam_t);	/* Function to call. */
53 	RF_CBParam_t	  callbackArg;	/* Args to give to function, or */
54 	RF_CBParam_t	  callbackArg2;	/* just info about this callback. */
55 	RF_RowCol_t	  row;		/* Disk row and column IDs to */
56 	RF_RowCol_t	  col;		/* give to the callback func. */
57 	RF_CallbackDesc_t *next;	/* Next entry in list. */
58 };
59 
60 int  rf_ConfigureCallback(RF_ShutdownList_t **);
61 RF_CallbackDesc_t *rf_AllocCallbackDesc(void);
62 void rf_FreeCallbackDesc(RF_CallbackDesc_t *);
63 
64 #endif	/* !_RF__RF_CALLBACK_H_ */
65