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