Annotation of sys/dev/raidframe/rf_stripelocks.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: rf_stripelocks.h,v 1.3 2002/12/16 07:01:05 tdeval Exp $ */
2: /* $NetBSD: rf_stripelocks.h,v 1.3 1999/02/05 00:06:18 oster Exp $ */
3:
4: /*
5: * Copyright (c) 1995 Carnegie-Mellon University.
6: * All rights reserved.
7: *
8: * Author: Mark Holland
9: *
10: * Permission to use, copy, modify and distribute this software and
11: * its documentation is hereby granted, provided that both the copyright
12: * notice and this permission notice appear in all copies of the
13: * software, derivative works or modified versions, and any portions
14: * thereof, and that both notices appear in supporting documentation.
15: *
16: * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
17: * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
18: * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
19: *
20: * Carnegie Mellon requests users of this software to return to
21: *
22: * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
23: * School of Computer Science
24: * Carnegie Mellon University
25: * Pittsburgh PA 15213-3890
26: *
27: * any improvements or extensions that they make and grant Carnegie the
28: * rights to redistribute these changes.
29: */
30:
31: /*****************************************************************************
32: *
33: * stripelocks.h -- Header file for locking stripes.
34: *
35: * Note that these functions are called from the execution routines of certain
36: * DAG Nodes, and so they must be NON-BLOCKING to assure maximum parallelism
37: * in the DAG. Accordingly, when a node wants to acquire a lock, it calls
38: * AcquireStripeLock, supplying a pointer to a callback function. If the lock
39: * is free at the time of the call, 0 is returned, indicating that the lock
40: * has been acquired. If the lock is not free, 1 is returned, and a copy of
41: * the function pointer and argument are held in the lock table. When the
42: * lock becomes free, the callback function is invoked.
43: *
44: *****************************************************************************/
45:
46: #ifndef _RF__RF_STRIPELOCKS_H_
47: #define _RF__RF_STRIPELOCKS_H_
48:
49: #include <sys/buf.h>
50:
51: #include "rf_types.h"
52: #include "rf_threadstuff.h"
53: #include "rf_general.h"
54:
55: struct RF_LockReqDesc_s {
56: RF_IoType_t type; /* Read or write. */
57: RF_int64 start, stop; /*
58: * Start and end of range to
59: * be locked.
60: */
61: RF_int64 start2, stop2;/*
62: * Start and end of 2nd range
63: * to be locked.
64: */
65: void (*cbFunc) (struct buf *);
66: /* Callback function. */
67: void *cbArg; /*
68: * Argument to callback
69: * function.
70: */
71: RF_LockReqDesc_t *next; /* Next element in chain. */
72: RF_LockReqDesc_t *templink; /*
73: * For making short-lived lists
74: * of request descriptors.
75: */
76: };
77:
78: #define RF_ASSERT_VALID_LOCKREQ(_lr_) do { \
79: RF_ASSERT(RF_IO_IS_R_OR_W((_lr_)->type)); \
80: } while (0)
81:
82: struct RF_StripeLockDesc_s {
83: RF_StripeNum_t stripeID; /* The stripe ID. */
84: RF_LockReqDesc_t *granted; /*
85: * Unordered list of granted
86: * requests.
87: */
88: RF_LockReqDesc_t *waitersH; /* FIFO queue of all waiting
89: * reqs, both read and write
90: * (Head and Tail).
91: */
92: RF_LockReqDesc_t *waitersT;
93: int nWriters; /*
94: * Number of writers either
95: * granted or waiting.
96: */
97: RF_StripeLockDesc_t *next; /*
98: * For hash table collision
99: * resolution.
100: */
101: };
102:
103: struct RF_LockTableEntry_s {
104: RF_DECLARE_MUTEX (mutex); /* Mutex on this hash chain. */
105: RF_StripeLockDesc_t *descList; /*
106: * Hash chain of lock
107: * descriptors.
108: */
109: };
110:
111: /*
112: * Initializes a stripe lock descriptor. _defSize is the number of sectors
113: * that we lock when there is no parity information in the ASM (e.g. RAID0).
114: */
115:
116: #define RF_INIT_LOCK_REQ_DESC(_lrd, _typ, _cbf, _cba, _asm, _defSize) \
117: do { \
118: (_lrd).type = _typ; \
119: (_lrd).start2 = -1; \
120: (_lrd).stop2 = -1; \
121: if ((_asm)->parityInfo) { \
122: (_lrd).start = (_asm)->parityInfo->startSector; \
123: (_lrd).stop = (_asm)->parityInfo->startSector + \
124: (_asm)->parityInfo->numSector-1; \
125: if ((_asm)->parityInfo->next) { \
126: (_lrd).start2 = \
127: (_asm)->parityInfo->next->startSector; \
128: (_lrd).stop2 = \
129: (_asm)->parityInfo->next->startSector + \
130: (_asm)->parityInfo->next->numSector-1; \
131: } \
132: } else { \
133: (_lrd).start = 0; \
134: (_lrd).stop = (_defSize); \
135: } \
136: (_lrd).templink= NULL; \
137: (_lrd).cbFunc = (_cbf); \
138: (_lrd).cbArg = (void *) (_cba); \
139: } while (0)
140:
141: int rf_ConfigureStripeLockFreeList(RF_ShutdownList_t **);
142: RF_LockTableEntry_t *rf_MakeLockTable(void);
143: void rf_ShutdownStripeLocks(RF_LockTableEntry_t *);
144: int rf_ConfigureStripeLocks(RF_ShutdownList_t **, RF_Raid_t *, RF_Config_t *);
145: int rf_AcquireStripeLock(RF_LockTableEntry_t *, RF_StripeNum_t,
146: RF_LockReqDesc_t *);
147: void rf_ReleaseStripeLock(RF_LockTableEntry_t *, RF_StripeNum_t,
148: RF_LockReqDesc_t *);
149:
150: #endif /* !_RF__RF_STRIPELOCKS_H_ */
CVSweb