Home | History | Annotate | Line # | Download | only in raidframe
rf_desc.h revision 1.4 
      1 /*	$NetBSD: rf_desc.h,v 1.4 1999/02/05 00:06:09 oster 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 (at) 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 #ifndef _RF__RF_DESC_H_
     30 #define _RF__RF_DESC_H_
     31 
     32 #include "rf_archs.h"
     33 #include "rf_types.h"
     34 #include "rf_etimer.h"
     35 #include "rf_dag.h"
     36 
     37 struct RF_RaidReconDesc_s {
     38 	RF_Raid_t *raidPtr;	/* raid device descriptor */
     39 	RF_RowCol_t row;	/* row of failed disk */
     40 	RF_RowCol_t col;	/* col of failed disk */
     41 	int     state;		/* how far along the reconstruction operation
     42 				 * has gotten */
     43 	RF_RaidDisk_t *spareDiskPtr;	/* describes target disk for recon
     44 					 * (not used in dist sparing) */
     45 	int     numDisksDone;	/* the number of surviving disks that have
     46 				 * completed their work */
     47 	RF_RowCol_t srow;	/* row ID of the spare disk (not used in dist
     48 				 * sparing) */
     49 	RF_RowCol_t scol;	/* col ID of the spare disk (not used in dist
     50 				 * sparing) */
     51 	/*
     52          * Prevent recon from hogging CPU
     53          */
     54 	RF_Etimer_t recon_exec_timer;
     55 	RF_uint64 reconExecTimerRunning;
     56 	RF_uint64 reconExecTicks;
     57 	RF_uint64 maxReconExecTicks;
     58 
     59 #if RF_RECON_STATS > 0
     60 	RF_uint64 hsStallCount;	/* head sep stall count */
     61 	RF_uint64 numReconExecDelays;
     62 	RF_uint64 numReconEventWaits;
     63 #endif				/* RF_RECON_STATS > 0 */
     64 	RF_RaidReconDesc_t *next;
     65 };
     66 
     67 struct RF_RaidAccessDesc_s {
     68 	RF_Raid_t *raidPtr;	/* raid device descriptor */
     69 	RF_IoType_t type;	/* read or write */
     70 	RF_RaidAddr_t raidAddress;	/* starting address in raid address
     71 					 * space */
     72 	RF_SectorCount_t numBlocks;	/* number of blocks (sectors) to
     73 					 * transfer */
     74 	RF_StripeCount_t numStripes;	/* number of stripes involved in
     75 					 * access */
     76 	caddr_t bufPtr;		/* pointer to data buffer */
     77 	RF_RaidAccessFlags_t flags;	/* flags controlling operation */
     78 	int     state;		/* index into states telling how far along the
     79 				 * RAID operation has gotten */
     80 	RF_AccessState_t *states;	/* array of states to be run */
     81 	int     status;		/* pass/fail status of the last operation */
     82 	RF_DagList_t *dagArray;	/* array of dag lists, one list per stripe */
     83 	RF_AccessStripeMapHeader_t *asmap;	/* the asm for this I/O */
     84 	void   *bp;		/* buf pointer for this RAID acc.  ignored
     85 				 * outside the kernel */
     86 	RF_DagHeader_t **paramDAG;	/* allows the DAG to be returned to
     87 					 * the caller after I/O completion */
     88 	RF_AccessStripeMapHeader_t **paramASM;	/* allows the ASM to be
     89 						 * returned to the caller
     90 						 * after I/O completion */
     91 	RF_AccTraceEntry_t tracerec;	/* perf monitoring information for a
     92 					 * user access (not for dag stats) */
     93 	void    (*callbackFunc) (RF_CBParam_t);	/* callback function for this
     94 						 * I/O */
     95 	void   *callbackArg;	/* arg to give to callback func */
     96 	int     tid;		/* debug only, user-level only: thread id of
     97 				 * thr that did this access */
     98 
     99 	RF_AllocListElem_t *cleanupList;	/* memory to be freed at the
    100 						 * end of the access */
    101 
    102 	RF_RaidAccessDesc_t *next;
    103 	RF_RaidAccessDesc_t *head;
    104 
    105 	int     numPending;
    106 
    107 	        RF_DECLARE_MUTEX(mutex)	/* these are used to implement
    108 					 * blocking I/O */
    109 	        RF_DECLARE_COND(cond)
    110 	int     async_flag;
    111 
    112 	RF_Etimer_t timer;	/* used for timing this access */
    113 };
    114 #endif				/* !_RF__RF_DESC_H_ */
    115