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