xref: /netbsd-src/sys/dev/raidframe/rf_psstatus.c (revision d48f14661dda8638fee055ba15d35bdfb29b9fa8)
1 /*	$NetBSD: rf_psstatus.c,v 1.31 2006/02/14 01:13:33 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@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  * psstatus.c
32  *
33  * The reconstruction code maintains a bunch of status related to the parity
34  * stripes that are currently under reconstruction.  This header file defines
35  * the status structures.
36  *
37  *****************************************************************************/
38 
39 #include <sys/cdefs.h>
40 __KERNEL_RCSID(0, "$NetBSD: rf_psstatus.c,v 1.31 2006/02/14 01:13:33 oster Exp $");
41 
42 #include <dev/raidframe/raidframevar.h>
43 
44 #include "rf_raid.h"
45 #include "rf_general.h"
46 #include "rf_debugprint.h"
47 #include "rf_psstatus.h"
48 #include "rf_shutdown.h"
49 
50 #if RF_DEBUG_PSS
51 #define Dprintf1(s,a)         if (rf_pssDebug) rf_debug_printf(s,(void *)((unsigned long)a),NULL,NULL,NULL,NULL,NULL,NULL,NULL)
52 #define Dprintf2(s,a,b)       if (rf_pssDebug) rf_debug_printf(s,(void *)((unsigned long)a),(void *)((unsigned long)b),NULL,NULL,NULL,NULL,NULL,NULL)
53 #define Dprintf3(s,a,b,c)     if (rf_pssDebug) rf_debug_printf(s,(void *)((unsigned long)a),(void *)((unsigned long)b),(void *)((unsigned long)c),NULL,NULL,NULL,NULL,NULL)
54 #else
55 #define Dprintf1(s,a)
56 #define Dprintf2(s,a,b)
57 #define Dprintf3(s,a,b,c)
58 #endif
59 
60 static void
61 RealPrintPSStatusTable(RF_Raid_t * raidPtr,
62     RF_PSStatusHeader_t * pssTable);
63 
64 #define RF_MAX_FREE_PSS  32
65 #define RF_MIN_FREE_PSS   8
66 
67 static void rf_ShutdownPSStatus(void *);
68 
69 static void
70 rf_ShutdownPSStatus(void *arg)
71 {
72 
73 	pool_destroy(&rf_pools.pss);
74 }
75 
76 int
77 rf_ConfigurePSStatus(RF_ShutdownList_t **listp)
78 {
79 
80 	rf_pool_init(&rf_pools.pss, sizeof(RF_ReconParityStripeStatus_t),
81 		     "raidpsspl", RF_MIN_FREE_PSS, RF_MAX_FREE_PSS);
82 	rf_ShutdownCreate(listp, rf_ShutdownPSStatus, NULL);
83 
84 	return (0);
85 }
86 
87 void
88 rf_InitPSStatus(RF_Raid_t *raidPtr)
89 {
90 	raidPtr->pssTableSize = RF_PSS_DEFAULT_TABLESIZE;
91 }
92 
93 
94 /*****************************************************************************************
95  * sets up the pss table
96  * We pre-allocate a bunch of entries to avoid as much as possible having to
97  * malloc up hash chain entries.
98  ****************************************************************************************/
99 RF_PSStatusHeader_t *
100 rf_MakeParityStripeStatusTable(RF_Raid_t *raidPtr)
101 {
102 	RF_PSStatusHeader_t *pssTable;
103 	int     i;
104 
105 	RF_Malloc(pssTable,
106 		  raidPtr->pssTableSize * sizeof(RF_PSStatusHeader_t),
107 		  (RF_PSStatusHeader_t *));
108 	for (i = 0; i < raidPtr->pssTableSize; i++) {
109 		rf_mutex_init(&pssTable[i].mutex);
110 	}
111 	return (pssTable);
112 }
113 
114 void
115 rf_FreeParityStripeStatusTable(RF_Raid_t *raidPtr,
116 			       RF_PSStatusHeader_t *pssTable)
117 {
118 #if RF_DEBUG_PSS
119 	int     i;
120 
121 	if (rf_pssDebug)
122 		RealPrintPSStatusTable(raidPtr, pssTable);
123 
124 	for (i = 0; i < raidPtr->pssTableSize; i++) {
125 		if (pssTable[i].chain) {
126 			printf("ERROR: pss hash chain not null at recon shutdown\n");
127 		}
128 	}
129 #endif
130 	RF_Free(pssTable, raidPtr->pssTableSize * sizeof(RF_PSStatusHeader_t));
131 }
132 
133 
134 /* looks up the status structure for a parity stripe.
135  * if the create_flag is on, uses (and returns) newpssPtr if
136  * a parity status structure doesn't exist
137  * otherwise returns NULL if the status structure does not exist
138  *
139  * ASSUMES THE PSS DESCRIPTOR IS LOCKED UPON ENTRY
140  *
141  * flags - whether or not to use newpssPtr if the needed PSS
142  *         doesn't exist and what flags to set it to initially
143  */
144 RF_ReconParityStripeStatus_t *
145 rf_LookupRUStatus(RF_Raid_t *raidPtr, RF_PSStatusHeader_t *pssTable,
146 		  RF_StripeNum_t psID, RF_ReconUnitNum_t which_ru,
147 		  RF_PSSFlags_t flags, RF_ReconParityStripeStatus_t *newpssPtr)
148 {
149 	RF_PSStatusHeader_t *hdr = &pssTable[RF_HASH_PSID(raidPtr, psID)];
150 	RF_ReconParityStripeStatus_t *p, *pssPtr = hdr->chain;
151 
152 	for (p = pssPtr; p; p = p->next) {
153 		if (p->parityStripeID == psID && p->which_ru == which_ru)
154 			break;
155 	}
156 
157 	if (!p && (flags & RF_PSS_CREATE)) {
158 		p = newpssPtr;
159 		p->next = hdr->chain;
160 		hdr->chain = p;
161 
162 		p->parityStripeID = psID;
163 		p->which_ru = which_ru;
164 		p->flags = flags;
165 		p->rbuf = NULL;
166 		p->writeRbuf = NULL;
167 		p->xorBufCount = 0;
168 		p->blockCount = 0;
169 		p->procWaitList = NULL;
170 		p->blockWaitList = NULL;
171 		p->bufWaitList = NULL;
172 	} else
173 		if (p) {	/* we didn't create, but we want to specify
174 				 * some new status */
175 			p->flags |= flags;	/* add in whatever flags we're
176 						 * specifying */
177 		}
178 	if (p && (flags & RF_PSS_RECON_BLOCKED)) {
179 		p->blockCount++;/* if we're asking to block recon, bump the
180 				 * count */
181 		Dprintf3("raid%d: Blocked recon on psid %ld.  count now %d\n",
182 			 raidPtr->raidid, psID, p->blockCount);
183 	}
184 	return (p);
185 }
186 /* deletes an entry from the parity stripe status table.  typically used
187  * when an entry has been allocated solely to block reconstruction, and
188  * no recon was requested while recon was blocked.  Assumes the hash
189  * chain is ALREADY LOCKED.
190  */
191 void
192 rf_PSStatusDelete(RF_Raid_t *raidPtr, RF_PSStatusHeader_t *pssTable,
193 		  RF_ReconParityStripeStatus_t *pssPtr)
194 {
195 	RF_PSStatusHeader_t *hdr = &(pssTable[RF_HASH_PSID(raidPtr, pssPtr->parityStripeID)]);
196 	RF_ReconParityStripeStatus_t *p = hdr->chain, *pt = NULL;
197 
198 	while (p) {
199 		if (p == pssPtr) {
200 			if (pt)
201 				pt->next = p->next;
202 			else
203 				hdr->chain = p->next;
204 			p->next = NULL;
205 			rf_FreePSStatus(raidPtr, p);
206 			return;
207 		}
208 		pt = p;
209 		p = p->next;
210 	}
211 	RF_ASSERT(0);		/* we must find it here */
212 }
213 /* deletes an entry from the ps status table after reconstruction has completed */
214 void
215 rf_RemoveFromActiveReconTable(RF_Raid_t *raidPtr, RF_StripeNum_t psid,
216 			      RF_ReconUnitNum_t which_ru)
217 {
218 	RF_PSStatusHeader_t *hdr = &(raidPtr->reconControl->pssTable[RF_HASH_PSID(raidPtr, psid)]);
219 	RF_ReconParityStripeStatus_t *p, *pt;
220 	RF_CallbackDesc_t *cb, *cb1;
221 
222 	RF_LOCK_MUTEX(hdr->mutex);
223 	while(hdr->lock) {
224 		ltsleep(&hdr->lock, PRIBIO, "rf_racrecon", 0, &hdr->mutex);
225 	}
226 	hdr->lock = 1;
227 	RF_UNLOCK_MUTEX(hdr->mutex);
228 	for (pt = NULL, p = hdr->chain; p; pt = p, p = p->next) {
229 		if ((p->parityStripeID == psid) && (p->which_ru == which_ru))
230 			break;
231 	}
232 	if (p == NULL) {
233 		rf_PrintPSStatusTable(raidPtr);
234 	}
235 	RF_ASSERT(p);		/* it must be there */
236 
237 	Dprintf2("PSS: deleting pss for psid %ld ru %d\n", psid, which_ru);
238 
239 	/* delete this entry from the hash chain */
240 	if (pt)
241 		pt->next = p->next;
242 	else
243 		hdr->chain = p->next;
244 	p->next = NULL;
245 
246 	RF_LOCK_MUTEX(hdr->mutex);
247 	hdr->lock = 0;
248 	RF_UNLOCK_MUTEX(hdr->mutex);
249 
250 	/* wakup anyone waiting on the parity stripe ID */
251 	cb = p->procWaitList;
252 	p->procWaitList = NULL;
253 	while (cb) {
254 		Dprintf1("Waking up access waiting on parity stripe ID %ld\n", p->parityStripeID);
255 		cb1 = cb->next;
256 		(cb->callbackFunc) (cb->callbackArg);
257 		rf_FreeCallbackDesc(cb);
258 		cb = cb1;
259 	}
260 
261 	rf_FreePSStatus(raidPtr, p);
262 }
263 
264 RF_ReconParityStripeStatus_t *
265 rf_AllocPSStatus(RF_Raid_t *raidPtr)
266 {
267 	RF_ReconParityStripeStatus_t *p;
268 
269 	p = pool_get(&rf_pools.pss, PR_WAITOK);
270 	memset(p, 0, sizeof(RF_ReconParityStripeStatus_t));
271 	return (p);
272 }
273 
274 void
275 rf_FreePSStatus(RF_Raid_t *raidPtr, RF_ReconParityStripeStatus_t *p)
276 {
277 	RF_ASSERT(p->procWaitList == NULL);
278 	RF_ASSERT(p->blockWaitList == NULL);
279 	RF_ASSERT(p->bufWaitList == NULL);
280 
281 	pool_put(&rf_pools.pss, p);
282 }
283 
284 static void
285 RealPrintPSStatusTable(RF_Raid_t *raidPtr, RF_PSStatusHeader_t *pssTable)
286 {
287 	int     i, j, procsWaiting, blocksWaiting, bufsWaiting;
288 	RF_ReconParityStripeStatus_t *p;
289 	RF_CallbackDesc_t *cb;
290 
291 	printf("\nParity Stripe Status Table\n");
292 	for (i = 0; i < raidPtr->pssTableSize; i++) {
293 		for (p = pssTable[i].chain; p; p = p->next) {
294 			procsWaiting = blocksWaiting = bufsWaiting = 0;
295 			for (cb = p->procWaitList; cb; cb = cb->next)
296 				procsWaiting++;
297 			for (cb = p->blockWaitList; cb; cb = cb->next)
298 				blocksWaiting++;
299 			for (cb = p->bufWaitList; cb; cb = cb->next)
300 				bufsWaiting++;
301 			printf("PSID %ld RU %d : blockCount %d %d/%d/%d proc/block/buf waiting, issued ",
302 			    (long) p->parityStripeID, p->which_ru, p->blockCount, procsWaiting, blocksWaiting, bufsWaiting);
303 			for (j = 0; j < raidPtr->numCol; j++)
304 				printf("%c", (p->issued[j]) ? '1' : '0');
305 			if (!p->flags)
306 				printf(" flags: (none)");
307 			else {
308 				if (p->flags & RF_PSS_UNDER_RECON)
309 					printf(" under-recon");
310 				if (p->flags & RF_PSS_FORCED_ON_WRITE)
311 					printf(" forced-w");
312 				if (p->flags & RF_PSS_FORCED_ON_READ)
313 					printf(" forced-r");
314 				if (p->flags & RF_PSS_RECON_BLOCKED)
315 					printf(" blocked");
316 				if (p->flags & RF_PSS_BUFFERWAIT)
317 					printf(" bufwait");
318 			}
319 			printf("\n");
320 		}
321 	}
322 }
323 
324 void
325 rf_PrintPSStatusTable(RF_Raid_t *raidPtr)
326 {
327 	RF_PSStatusHeader_t *pssTable = raidPtr->reconControl->pssTable;
328 	RealPrintPSStatusTable(raidPtr, pssTable);
329 }
330