diff options
Diffstat (limited to 'sys/dev/raidframe/rf_decluster.h')
| -rw-r--r-- | sys/dev/raidframe/rf_decluster.h | 178 |
1 files changed, 91 insertions, 87 deletions
diff --git a/sys/dev/raidframe/rf_decluster.h b/sys/dev/raidframe/rf_decluster.h index e4e3ac40c7d..b1b3cc9a3c9 100644 --- a/sys/dev/raidframe/rf_decluster.h +++ b/sys/dev/raidframe/rf_decluster.h @@ -1,5 +1,6 @@ -/* $OpenBSD: rf_decluster.h,v 1.2 1999/02/16 00:02:35 niklas Exp $ */ +/* $OpenBSD: rf_decluster.h,v 1.3 2002/12/16 07:01:03 tdeval Exp $ */ /* $NetBSD: rf_decluster.h,v 1.3 1999/02/05 00:06:09 oster Exp $ */ + /* * Copyright (c) 1995 Carnegie-Mellon University. * All rights reserved. @@ -27,17 +28,17 @@ * rights to redistribute these changes. */ -/*---------------------------------------------------------------------- +/***************************************************************************** * - * decluster.h -- header file for declustered layout code + * decluster.h -- Header file for declustered layout code. * * Adapted from raidSim version July 1994 * Created 10-21-92 (MCH) * - *--------------------------------------------------------------------*/ + *****************************************************************************/ -#ifndef _RF__RF_DECLUSTER_H_ -#define _RF__RF_DECLUSTER_H_ +#ifndef _RF__RF_DECLUSTER_H_ +#define _RF__RF_DECLUSTER_H_ #include "rf_types.h" @@ -47,95 +48,98 @@ * the associated inverse mapping. */ struct RF_SpareTableEntry_s { - u_int spareDisk; /* disk to which this block is spared */ - u_int spareBlockOffsetInSUs; /* offset into spare table for that - * disk */ + u_int spareDisk; /* Disk where this block is spared. */ + u_int spareBlockOffsetInSUs; /* + * Offset into spare table for that + * disk. + */ }; -#define RF_SPAREMAP_NAME_LEN 128 -/* this is the layout-specific info structure for the declustered layout. +#define RF_SPAREMAP_NAME_LEN 128 + +/* + * This is the layout-specific info structure for the declustered layout. */ struct RF_DeclusteredConfigInfo_s { - RF_StripeCount_t groupSize; /* no. of stripe units per parity - * stripe */ - RF_RowCol_t **LayoutTable; /* the block design table */ - RF_RowCol_t **OffsetTable; /* the sector offset table */ - RF_RowCol_t **BlockTable; /* the block membership table */ - RF_StripeCount_t SUsPerFullTable; /* stripe units per full table */ - RF_StripeCount_t SUsPerTable; /* stripe units per table */ - RF_StripeCount_t PUsPerBlock; /* parity units per block */ - RF_StripeCount_t SUsPerBlock; /* stripe units per block */ - RF_StripeCount_t BlocksPerTable; /* block design tuples per - * table */ - RF_StripeCount_t NumParityReps; /* tables per full table */ - RF_StripeCount_t TableDepthInPUs; /* PUs on one disk in 1 table */ - RF_StripeCount_t FullTableDepthInPUs; /* PUs on one disk in 1 - * fulltable */ - RF_StripeCount_t FullTableLimitSUID; /* SU where partial fulltables - * start */ - RF_StripeCount_t ExtraTablesPerDisk; /* # of tables in last - * fulltable */ - RF_SectorNum_t DiskOffsetOfLastFullTableInSUs; /* disk offs of partial - * ft, if any */ - RF_StripeCount_t numCompleteFullTablesPerDisk; /* ft identifier of - * partial ft, if any */ - u_int Lambda; /* the pair count in the block design */ + /* Number of stripe units per parity stripe. */ + RF_StripeCount_t groupSize; + /* The block design table. */ + RF_RowCol_t **LayoutTable; + RF_RowCol_t **OffsetTable; + /* The sector offset table. */ + RF_RowCol_t **BlockTable; + /* The block membership table. */ + RF_StripeCount_t SUsPerFullTable; + /* Stripe units per full table. */ + RF_StripeCount_t SUsPerTable; + /* Stripe units per table. */ + RF_StripeCount_t PUsPerBlock; + /* Parity units per block. */ + RF_StripeCount_t SUsPerBlock; + /* Stripe units per block. */ + RF_StripeCount_t BlocksPerTable; + /* Block design tuples per table. */ + RF_StripeCount_t NumParityReps; + /* Tables per full table. */ + RF_StripeCount_t TableDepthInPUs; + /* PUs on one disk in 1 table. */ + RF_StripeCount_t FullTableDepthInPUs; + /* PUs on one disk in 1 fulltable. */ + RF_StripeCount_t FullTableLimitSUID; + /* SU where partial fulltables start. */ + RF_StripeCount_t ExtraTablesPerDisk; + /* Number of tables in last fulltable. */ + RF_SectorNum_t DiskOffsetOfLastFullTableInSUs; + /* Disk offsets of partial fulltable, if any. */ + RF_StripeCount_t numCompleteFullTablesPerDisk; + /* Fulltable identifier of partial fulltable, if any. */ + u_int Lambda; + /* The pair count in the block design. */ - /* these are used only in the distributed-sparing case */ - RF_StripeCount_t FullTablesPerSpareRegion; /* # of ft's comprising - * 1 spare region */ - RF_StripeCount_t TablesPerSpareRegion; /* # of tables */ - RF_SectorCount_t SpareSpaceDepthPerRegionInSUs; /* spare - * space/disk/region */ - RF_SectorCount_t SpareRegionDepthInSUs; /* # of units/disk/region */ - RF_SectorNum_t DiskOffsetOfLastSpareSpaceChunkInSUs; /* locates sp space - * after partial ft */ - RF_StripeCount_t TotSparePUsPerDisk; /* total number of spare PUs - * per disk */ - RF_StripeCount_t NumCompleteSRs; - RF_SpareTableEntry_t **SpareTable; /* remap table for spare space */ - char sparemap_fname[RF_SPAREMAP_NAME_LEN]; /* where to find - * sparemap. not used in - * kernel */ + /* These are used only in the distributed-sparing case. */ + RF_StripeCount_t FullTablesPerSpareRegion; + /* Number of fulltables comprising 1 spare region. */ + RF_StripeCount_t TablesPerSpareRegion; + /* Number of tables. */ + RF_SectorCount_t SpareSpaceDepthPerRegionInSUs; + /* Spare space/disk/region. */ + RF_SectorCount_t SpareRegionDepthInSUs; + /* Number of units/disk/region. */ + RF_SectorNum_t DiskOffsetOfLastSpareSpaceChunkInSUs; + /* Locates spare space after partial fulltable. */ + RF_StripeCount_t TotSparePUsPerDisk; + /* Total number of spare PUs per disk. */ + RF_StripeCount_t NumCompleteSRs; + RF_SpareTableEntry_t **SpareTable; + /* Remap table for spare space. */ + char sparemap_fname[RF_SPAREMAP_NAME_LEN]; + /* Where to find sparemap. Not used in kernel. */ }; -int -rf_ConfigureDeclustered(RF_ShutdownList_t ** listp, RF_Raid_t * raidPtr, - RF_Config_t * cfgPtr); -int -rf_ConfigureDeclusteredDS(RF_ShutdownList_t ** listp, RF_Raid_t * raidPtr, - RF_Config_t * cfgPtr); +int rf_ConfigureDeclustered(RF_ShutdownList_t **, RF_Raid_t *, RF_Config_t *); +int rf_ConfigureDeclusteredDS(RF_ShutdownList_t **, RF_Raid_t *, + RF_Config_t *); -void -rf_MapSectorDeclustered(RF_Raid_t * raidPtr, RF_RaidAddr_t raidSector, - RF_RowCol_t * row, RF_RowCol_t * col, RF_SectorNum_t * diskSector, int remap); -void -rf_MapParityDeclustered(RF_Raid_t * raidPtr, RF_RaidAddr_t raidSector, - RF_RowCol_t * row, RF_RowCol_t * col, RF_SectorNum_t * diskSector, int remap); -void -rf_IdentifyStripeDeclustered(RF_Raid_t * raidPtr, RF_RaidAddr_t addr, - RF_RowCol_t ** diskids, RF_RowCol_t * outRow); -void -rf_MapSIDToPSIDDeclustered(RF_RaidLayout_t * layoutPtr, - RF_StripeNum_t stripeID, RF_StripeNum_t * psID, - RF_ReconUnitNum_t * which_ru); -int rf_InstallSpareTable(RF_Raid_t * raidPtr, RF_RowCol_t frow, RF_RowCol_t fcol); -void rf_FreeSpareTable(RF_Raid_t * raidPtr); +void rf_MapSectorDeclustered(RF_Raid_t *, RF_RaidAddr_t, RF_RowCol_t *, + RF_RowCol_t *, RF_SectorNum_t *, int); +void rf_MapParityDeclustered(RF_Raid_t *, RF_RaidAddr_t, RF_RowCol_t *, + RF_RowCol_t *, RF_SectorNum_t *, int); +void rf_IdentifyStripeDeclustered(RF_Raid_t *, RF_RaidAddr_t, RF_RowCol_t **, + RF_RowCol_t *); +void rf_MapSIDToPSIDDeclustered(RF_RaidLayout_t *, RF_StripeNum_t, + RF_StripeNum_t *, RF_ReconUnitNum_t *); +int rf_InstallSpareTable(RF_Raid_t *, RF_RowCol_t, RF_RowCol_t); +void rf_FreeSpareTable(RF_Raid_t *); -RF_HeadSepLimit_t rf_GetDefaultHeadSepLimitDeclustered(RF_Raid_t * raidPtr); -int rf_GetDefaultNumFloatingReconBuffersDeclustered(RF_Raid_t * raidPtr); +RF_HeadSepLimit_t rf_GetDefaultHeadSepLimitDeclustered(RF_Raid_t *); +int rf_GetDefaultNumFloatingReconBuffersDeclustered(RF_Raid_t *); -void -rf_decluster_adjust_params(RF_RaidLayout_t * layoutPtr, - RF_StripeNum_t * SUID, RF_StripeCount_t * sus_per_fulltable, - RF_StripeCount_t * fulltable_depth, RF_StripeNum_t * base_suid); -void -rf_remap_to_spare_space( - RF_RaidLayout_t * layoutPtr, - RF_DeclusteredConfigInfo_t * info, RF_RowCol_t row, RF_StripeNum_t FullTableID, - RF_StripeNum_t TableID, RF_SectorNum_t BlockID, RF_StripeNum_t base_suid, - RF_StripeNum_t SpareRegion, RF_RowCol_t * outCol, RF_StripeNum_t * outSU); -int rf_SetSpareTable(RF_Raid_t * raidPtr, void *data); -RF_ReconUnitCount_t rf_GetNumSpareRUsDeclustered(RF_Raid_t * raidPtr); +void rf_decluster_adjust_params(RF_RaidLayout_t *, RF_StripeNum_t *, + RF_StripeCount_t *, RF_StripeCount_t *, RF_StripeNum_t *); +void rf_remap_to_spare_space(RF_RaidLayout_t *, RF_DeclusteredConfigInfo_t *, + RF_RowCol_t, RF_StripeNum_t, RF_StripeNum_t, RF_SectorNum_t, + RF_StripeNum_t, RF_StripeNum_t, RF_RowCol_t *, RF_StripeNum_t *); +int rf_SetSpareTable(RF_Raid_t *, void *); +RF_ReconUnitCount_t rf_GetNumSpareRUsDeclustered(RF_Raid_t *); -#endif /* !_RF__RF_DECLUSTER_H_ */ +#endif /* ! _RF__RF_DECLUSTER_H_ */ |