VServer 1.9.2 (patch-2.6.8.1-vs1.9.2.diff)
[linux-2.6.git] / drivers / s390 / block / dasd.c
1 /*
2  * File...........: linux/drivers/s390/block/dasd.c
3  * Author(s)......: Holger Smolinski <Holger.Smolinski@de.ibm.com>
4  *                  Horst Hummel <Horst.Hummel@de.ibm.com>
5  *                  Carsten Otte <Cotte@de.ibm.com>
6  *                  Martin Schwidefsky <schwidefsky@de.ibm.com>
7  * Bugreports.to..: <Linux390@de.ibm.com>
8  * (C) IBM Corporation, IBM Deutschland Entwicklung GmbH, 1999-2001
9  *
10  * $Revision: 1.147 $
11  */
12
13 #include <linux/config.h>
14 #include <linux/kmod.h>
15 #include <linux/init.h>
16 #include <linux/interrupt.h>
17 #include <linux/ctype.h>
18 #include <linux/major.h>
19 #include <linux/slab.h>
20 #include <linux/buffer_head.h>
21
22 #include <asm/ccwdev.h>
23 #include <asm/ebcdic.h>
24 #include <asm/idals.h>
25 #include <asm/todclk.h>
26
27 /* This is ugly... */
28 #define PRINTK_HEADER "dasd:"
29
30 #include "dasd_int.h"
31 /*
32  * SECTION: Constant definitions to be used within this file
33  */
34 #define DASD_CHANQ_MAX_SIZE 4
35
36 /*
37  * SECTION: exported variables of dasd.c
38  */
39 debug_info_t *dasd_debug_area;
40 struct dasd_discipline *dasd_diag_discipline_pointer;
41
42 MODULE_AUTHOR("Holger Smolinski <Holger.Smolinski@de.ibm.com>");
43 MODULE_DESCRIPTION("Linux on S/390 DASD device driver,"
44                    " Copyright 2000 IBM Corporation");
45 MODULE_SUPPORTED_DEVICE("dasd");
46 MODULE_PARM(dasd, "1-" __MODULE_STRING(256) "s");
47 MODULE_LICENSE("GPL");
48
49 /*
50  * SECTION: prototypes for static functions of dasd.c
51  */
52 static int  dasd_alloc_queue(struct dasd_device * device);
53 static void dasd_setup_queue(struct dasd_device * device);
54 static void dasd_free_queue(struct dasd_device * device);
55 static void dasd_flush_request_queue(struct dasd_device *);
56 static void dasd_int_handler(struct ccw_device *, unsigned long, struct irb *);
57 static void dasd_flush_ccw_queue(struct dasd_device *, int);
58 static void dasd_tasklet(struct dasd_device *);
59 static void do_kick_device(void *data);
60
61 /*
62  * SECTION: Operations on the device structure.
63  */
64 static wait_queue_head_t dasd_init_waitq;
65
66 /*
67  * Allocate memory for a new device structure.
68  */
69 struct dasd_device *
70 dasd_alloc_device(void)
71 {
72         struct dasd_device *device;
73
74         device = kmalloc(sizeof (struct dasd_device), GFP_ATOMIC);
75         if (device == NULL)
76                 return ERR_PTR(-ENOMEM);
77         memset(device, 0, sizeof (struct dasd_device));
78         /* open_count = 0 means device online but not in use */
79         atomic_set(&device->open_count, -1);
80
81         /* Get two pages for normal block device operations. */
82         device->ccw_mem = (void *) __get_free_pages(GFP_ATOMIC | GFP_DMA, 1);
83         if (device->ccw_mem == NULL) {
84                 kfree(device);
85                 return ERR_PTR(-ENOMEM);
86         }
87         /* Get one page for error recovery. */
88         device->erp_mem = (void *) get_zeroed_page(GFP_ATOMIC | GFP_DMA);
89         if (device->erp_mem == NULL) {
90                 free_pages((unsigned long) device->ccw_mem, 1);
91                 kfree(device);
92                 return ERR_PTR(-ENOMEM);
93         }
94
95         dasd_init_chunklist(&device->ccw_chunks, device->ccw_mem, PAGE_SIZE*2);
96         dasd_init_chunklist(&device->erp_chunks, device->erp_mem, PAGE_SIZE);
97         spin_lock_init(&device->mem_lock);
98         spin_lock_init(&device->request_queue_lock);
99         atomic_set (&device->tasklet_scheduled, 0);
100         tasklet_init(&device->tasklet, 
101                      (void (*)(unsigned long)) dasd_tasklet,
102                      (unsigned long) device);
103         INIT_LIST_HEAD(&device->ccw_queue);
104         init_timer(&device->timer);
105         INIT_WORK(&device->kick_work, do_kick_device, device);
106         device->state = DASD_STATE_NEW;
107         device->target = DASD_STATE_NEW;
108
109         return device;
110 }
111
112 /*
113  * Free memory of a device structure.
114  */
115 void
116 dasd_free_device(struct dasd_device *device)
117 {
118         if (device->private)
119                 kfree(device->private);
120         free_page((unsigned long) device->erp_mem);
121         free_pages((unsigned long) device->ccw_mem, 1);
122         kfree(device);
123 }
124
125 /*
126  * Make a new device known to the system.
127  */
128 static inline int
129 dasd_state_new_to_known(struct dasd_device *device)
130 {
131         int rc;
132
133         /*
134          * As long as the device is not in state DASD_STATE_NEW we want to 
135          * keep the reference count > 0.
136          */
137         dasd_get_device(device);
138
139         rc = dasd_alloc_queue(device);
140         if (rc) {
141                 dasd_put_device(device);
142                 return rc;
143         }
144
145         device->state = DASD_STATE_KNOWN;
146         return 0;
147 }
148
149 /*
150  * Let the system forget about a device.
151  */
152 static inline void
153 dasd_state_known_to_new(struct dasd_device * device)
154 {
155         /* Forget the discipline information. */
156         device->discipline = NULL;
157         device->state = DASD_STATE_NEW;
158
159         dasd_free_queue(device);
160
161         /* Give up reference we took in dasd_state_new_to_known. */
162         dasd_put_device(device);
163 }
164
165 /*
166  * Request the irq line for the device.
167  */
168 static inline int
169 dasd_state_known_to_basic(struct dasd_device * device)
170 {
171         int rc;
172
173         /* Allocate and register gendisk structure. */
174         rc = dasd_gendisk_alloc(device);
175         if (rc)
176                 return rc;
177
178         /* register 'device' debug area, used for all DBF_DEV_XXX calls */
179         device->debug_area = debug_register(device->cdev->dev.bus_id, 0, 2,
180                                             8 * sizeof (long));
181         debug_register_view(device->debug_area, &debug_sprintf_view);
182         debug_set_level(device->debug_area, DBF_ERR);
183         DBF_DEV_EVENT(DBF_EMERG, device, "%s", "debug area created");
184
185         device->state = DASD_STATE_BASIC;
186         return 0;
187 }
188
189 /*
190  * Release the irq line for the device. Terminate any running i/o.
191  */
192 static inline void
193 dasd_state_basic_to_known(struct dasd_device * device)
194 {
195         dasd_gendisk_free(device);
196         dasd_flush_ccw_queue(device, 1);
197         DBF_DEV_EVENT(DBF_EMERG, device, "%p debug area deleted", device);
198         if (device->debug_area != NULL) {
199                 debug_unregister(device->debug_area);
200                 device->debug_area = NULL;
201         }
202         device->state = DASD_STATE_KNOWN;
203 }
204
205 /*
206  * Do the initial analysis. The do_analysis function may return
207  * -EAGAIN in which case the device keeps the state DASD_STATE_BASIC
208  * until the discipline decides to continue the startup sequence
209  * by calling the function dasd_change_state. The eckd disciplines
210  * uses this to start a ccw that detects the format. The completion
211  * interrupt for this detection ccw uses the kernel event daemon to
212  * trigger the call to dasd_change_state. All this is done in the
213  * discipline code, see dasd_eckd.c.
214  * After the analysis ccw is done (do_analysis returned 0 or error)
215  * the block device is setup. Either a fake disk is added to allow
216  * formatting or a proper device request queue is created.
217  */
218 static inline int
219 dasd_state_basic_to_ready(struct dasd_device * device)
220 {
221         int rc;
222
223         rc = 0;
224         if (device->discipline->do_analysis != NULL)
225                 rc = device->discipline->do_analysis(device);
226         if (rc)
227                 return rc;
228         dasd_setup_queue(device);
229         device->state = DASD_STATE_READY;
230         if (dasd_scan_partitions(device) != 0)
231                 device->state = DASD_STATE_BASIC;
232         return 0;
233 }
234
235 /*
236  * Remove device from block device layer. Destroy dirty buffers.
237  * Forget format information. Check if the target level is basic
238  * and if it is create fake disk for formatting.
239  */
240 static inline void
241 dasd_state_ready_to_basic(struct dasd_device * device)
242 {
243         dasd_flush_ccw_queue(device, 0);
244         dasd_destroy_partitions(device);
245         dasd_flush_request_queue(device);
246         device->blocks = 0;
247         device->bp_block = 0;
248         device->s2b_shift = 0;
249         device->state = DASD_STATE_BASIC;
250 }
251
252 /*
253  * Make the device online and schedule the bottom half to start
254  * the requeueing of requests from the linux request queue to the
255  * ccw queue.
256  */
257 static inline int
258 dasd_state_ready_to_online(struct dasd_device * device)
259 {
260         device->state = DASD_STATE_ONLINE;
261         dasd_schedule_bh(device);
262         return 0;
263 }
264
265 /*
266  * Stop the requeueing of requests again.
267  */
268 static inline void
269 dasd_state_online_to_ready(struct dasd_device * device)
270 {
271         device->state = DASD_STATE_READY;
272 }
273
274 /*
275  * Device startup state changes.
276  */
277 static inline int
278 dasd_increase_state(struct dasd_device *device)
279 {
280         int rc;
281
282         rc = 0;
283         if (device->state == DASD_STATE_NEW &&
284             device->target >= DASD_STATE_KNOWN)
285                 rc = dasd_state_new_to_known(device);
286
287         if (!rc &&
288             device->state == DASD_STATE_KNOWN &&
289             device->target >= DASD_STATE_BASIC)
290                 rc = dasd_state_known_to_basic(device);
291
292         if (!rc &&
293             device->state == DASD_STATE_BASIC &&
294             device->target >= DASD_STATE_READY)
295                 rc = dasd_state_basic_to_ready(device);
296
297         if (!rc &&
298             device->state == DASD_STATE_READY &&
299             device->target >= DASD_STATE_ONLINE)
300                 rc = dasd_state_ready_to_online(device);
301
302         return rc;
303 }
304
305 /*
306  * Device shutdown state changes.
307  */
308 static inline int
309 dasd_decrease_state(struct dasd_device *device)
310 {
311         if (device->state == DASD_STATE_ONLINE &&
312             device->target <= DASD_STATE_READY)
313                 dasd_state_online_to_ready(device);
314         
315         if (device->state == DASD_STATE_READY &&
316             device->target <= DASD_STATE_BASIC)
317                 dasd_state_ready_to_basic(device);
318         
319         if (device->state == DASD_STATE_BASIC && 
320             device->target <= DASD_STATE_KNOWN)
321                 dasd_state_basic_to_known(device);
322         
323         if (device->state == DASD_STATE_KNOWN &&
324             device->target <= DASD_STATE_NEW)
325                 dasd_state_known_to_new(device);
326
327         return 0;
328 }
329
330 /*
331  * This is the main startup/shutdown routine.
332  */
333 static void
334 dasd_change_state(struct dasd_device *device)
335 {
336         int rc;
337
338         if (device->state == device->target)
339                 /* Already where we want to go today... */
340                 return;
341         if (device->state < device->target)
342                 rc = dasd_increase_state(device);
343         else
344                 rc = dasd_decrease_state(device);
345         if (rc && rc != -EAGAIN)
346                 device->target = device->state;
347
348         if (device->state == device->target)
349                 wake_up(&dasd_init_waitq);
350 }
351
352 /*
353  * Kick starter for devices that did not complete the startup/shutdown
354  * procedure or were sleeping because of a pending state.
355  * dasd_kick_device will schedule a call do do_kick_device to the kernel
356  * event daemon.
357  */
358 static void
359 do_kick_device(void *data)
360 {
361         struct dasd_device *device;
362
363         device = (struct dasd_device *) data;
364         dasd_change_state(device);
365         dasd_schedule_bh(device);
366         dasd_put_device(device);
367 }
368
369 void
370 dasd_kick_device(struct dasd_device *device)
371 {
372         dasd_get_device(device);
373         /* queue call to dasd_kick_device to the kernel event daemon. */
374         schedule_work(&device->kick_work);
375 }
376
377 /*
378  * Set the target state for a device and starts the state change.
379  */
380 void
381 dasd_set_target_state(struct dasd_device *device, int target)
382 {
383         /* If we are in probeonly mode stop at DASD_STATE_READY. */
384         if (dasd_probeonly && target > DASD_STATE_READY)
385                 target = DASD_STATE_READY;
386         if (device->target != target) {
387                 if (device->state == target)
388                         wake_up(&dasd_init_waitq);
389                 device->target = target;
390         }
391         if (device->state != device->target)
392                 dasd_change_state(device);
393 }
394
395 /*
396  * Enable devices with device numbers in [from..to].
397  */
398 static inline int
399 _wait_for_device(struct dasd_device *device)
400 {
401         return (device->state == device->target);
402 }
403
404 void
405 dasd_enable_device(struct dasd_device *device)
406 {
407         dasd_set_target_state(device, DASD_STATE_ONLINE);
408         if (device->state <= DASD_STATE_KNOWN)
409                 /* No discipline for device found. */
410                 dasd_set_target_state(device, DASD_STATE_NEW);
411         /* Now wait for the devices to come up. */
412         wait_event(dasd_init_waitq, _wait_for_device(device));
413 }
414
415 /*
416  * SECTION: device operation (interrupt handler, start i/o, term i/o ...)
417  */
418 #ifdef CONFIG_DASD_PROFILE
419
420 struct dasd_profile_info_t dasd_global_profile;
421 unsigned int dasd_profile_level = DASD_PROFILE_OFF;
422
423 /*
424  * Increments counter in global and local profiling structures.
425  */
426 #define dasd_profile_counter(value, counter, device) \
427 { \
428         int index; \
429         for (index = 0; index < 31 && value >> (2+index); index++); \
430         dasd_global_profile.counter[index]++; \
431         device->profile.counter[index]++; \
432 }
433
434 /*
435  * Add profiling information for cqr before execution.
436  */
437 static inline void
438 dasd_profile_start(struct dasd_device *device, struct dasd_ccw_req * cqr,
439                    struct request *req)
440 {
441         struct list_head *l;
442         unsigned int counter;
443
444         if (dasd_profile_level != DASD_PROFILE_ON)
445                 return;
446
447         /* count the length of the chanq for statistics */
448         counter = 0;
449         list_for_each(l, &device->ccw_queue)
450                 if (++counter >= 31)
451                         break;
452         dasd_global_profile.dasd_io_nr_req[counter]++;
453         device->profile.dasd_io_nr_req[counter]++;
454 }
455
456 /*
457  * Add profiling information for cqr after execution.
458  */
459 static inline void
460 dasd_profile_end(struct dasd_device *device, struct dasd_ccw_req * cqr,
461                  struct request *req)
462 {
463         long strtime, irqtime, endtime, tottime;        /* in microseconds */
464         long tottimeps, sectors;
465
466         if (dasd_profile_level != DASD_PROFILE_ON)
467                 return;
468
469         sectors = req->nr_sectors;
470         if (!cqr->buildclk || !cqr->startclk ||
471             !cqr->stopclk || !cqr->endclk ||
472             !sectors)
473                 return;
474
475         strtime = ((cqr->startclk - cqr->buildclk) >> 12);
476         irqtime = ((cqr->stopclk - cqr->startclk) >> 12);
477         endtime = ((cqr->endclk - cqr->stopclk) >> 12);
478         tottime = ((cqr->endclk - cqr->buildclk) >> 12);
479         tottimeps = tottime / sectors;
480
481         if (!dasd_global_profile.dasd_io_reqs)
482                 memset(&dasd_global_profile, 0,
483                        sizeof (struct dasd_profile_info_t));
484         dasd_global_profile.dasd_io_reqs++;
485         dasd_global_profile.dasd_io_sects += sectors;
486
487         if (!device->profile.dasd_io_reqs)
488                 memset(&device->profile, 0,
489                        sizeof (struct dasd_profile_info_t));
490         device->profile.dasd_io_reqs++;
491         device->profile.dasd_io_sects += sectors;
492
493         dasd_profile_counter(sectors, dasd_io_secs, device);
494         dasd_profile_counter(tottime, dasd_io_times, device);
495         dasd_profile_counter(tottimeps, dasd_io_timps, device);
496         dasd_profile_counter(strtime, dasd_io_time1, device);
497         dasd_profile_counter(irqtime, dasd_io_time2, device);
498         dasd_profile_counter(irqtime / sectors, dasd_io_time2ps, device);
499         dasd_profile_counter(endtime, dasd_io_time3, device);
500 }
501 #else
502 #define dasd_profile_start(device, cqr, req) do {} while (0)
503 #define dasd_profile_end(device, cqr, req) do {} while (0)
504 #endif                          /* CONFIG_DASD_PROFILE */
505
506 /*
507  * Allocate memory for a channel program with 'cplength' channel
508  * command words and 'datasize' additional space. There are two
509  * variantes: 1) dasd_kmalloc_request uses kmalloc to get the needed
510  * memory and 2) dasd_smalloc_request uses the static ccw memory
511  * that gets allocated for each device.
512  */
513 struct dasd_ccw_req *
514 dasd_kmalloc_request(char *magic, int cplength, int datasize,
515                    struct dasd_device * device)
516 {
517         struct dasd_ccw_req *cqr;
518
519         /* Sanity checks */
520         if ( magic == NULL || datasize > PAGE_SIZE ||
521              (cplength*sizeof(struct ccw1)) > PAGE_SIZE)
522                 BUG();
523         debug_text_event ( dasd_debug_area, 1, "ALLC");
524         debug_text_event ( dasd_debug_area, 1, magic);
525         debug_int_event ( dasd_debug_area, 1, cplength);
526         debug_int_event ( dasd_debug_area, 1, datasize);
527
528         cqr = kmalloc(sizeof(struct dasd_ccw_req), GFP_ATOMIC);
529         if (cqr == NULL)
530                 return ERR_PTR(-ENOMEM);
531         memset(cqr, 0, sizeof(struct dasd_ccw_req));
532         cqr->cpaddr = NULL;
533         if (cplength > 0) {
534                 cqr->cpaddr = kmalloc(cplength*sizeof(struct ccw1),
535                                       GFP_ATOMIC | GFP_DMA);
536                 if (cqr->cpaddr == NULL) {
537                         kfree(cqr);
538                         return ERR_PTR(-ENOMEM);
539                 }
540                 memset(cqr->cpaddr, 0, cplength*sizeof(struct ccw1));
541         }
542         cqr->data = NULL;
543         if (datasize > 0) {
544                 cqr->data = kmalloc(datasize, GFP_ATOMIC | GFP_DMA);
545                 if (cqr->data == NULL) {
546                         if (cqr->cpaddr != NULL)
547                                 kfree(cqr->cpaddr);
548                         kfree(cqr);
549                         return ERR_PTR(-ENOMEM);
550                 }
551                 memset(cqr->data, 0, datasize);
552         }
553         strncpy((char *) &cqr->magic, magic, 4);
554         ASCEBC((char *) &cqr->magic, 4);
555         set_bit(DASD_CQR_FLAGS_USE_ERP, &cqr->flags);
556         dasd_get_device(device);
557         return cqr;
558 }
559
560 struct dasd_ccw_req *
561 dasd_smalloc_request(char *magic, int cplength, int datasize,
562                    struct dasd_device * device)
563 {
564         unsigned long flags;
565         struct dasd_ccw_req *cqr;
566         char *data;
567         int size;
568
569         /* Sanity checks */
570         if ( magic == NULL || datasize > PAGE_SIZE ||
571              (cplength*sizeof(struct ccw1)) > PAGE_SIZE)
572                 BUG();
573         debug_text_event ( dasd_debug_area, 1, "ALLC");
574         debug_text_event ( dasd_debug_area, 1, magic);
575         debug_int_event ( dasd_debug_area, 1, cplength);
576         debug_int_event ( dasd_debug_area, 1, datasize);
577
578         size = (sizeof(struct dasd_ccw_req) + 7L) & -8L;
579         if (cplength > 0)
580                 size += cplength * sizeof(struct ccw1);
581         if (datasize > 0)
582                 size += datasize;
583         spin_lock_irqsave(&device->mem_lock, flags);
584         cqr = (struct dasd_ccw_req *)
585                 dasd_alloc_chunk(&device->ccw_chunks, size);
586         spin_unlock_irqrestore(&device->mem_lock, flags);
587         if (cqr == NULL)
588                 return ERR_PTR(-ENOMEM);
589         memset(cqr, 0, sizeof(struct dasd_ccw_req));
590         data = (char *) cqr + ((sizeof(struct dasd_ccw_req) + 7L) & -8L);
591         cqr->cpaddr = NULL;
592         if (cplength > 0) {
593                 cqr->cpaddr = (struct ccw1 *) data;
594                 data += cplength*sizeof(struct ccw1);
595                 memset(cqr->cpaddr, 0, cplength*sizeof(struct ccw1));
596         }
597         cqr->data = NULL;
598         if (datasize > 0) {
599                 cqr->data = data;
600                 memset(cqr->data, 0, datasize);
601         }
602         strncpy((char *) &cqr->magic, magic, 4);
603         ASCEBC((char *) &cqr->magic, 4);
604         set_bit(DASD_CQR_FLAGS_USE_ERP, &cqr->flags);
605         dasd_get_device(device);
606         return cqr;
607 }
608
609 /*
610  * Free memory of a channel program. This function needs to free all the
611  * idal lists that might have been created by dasd_set_cda and the
612  * struct dasd_ccw_req itself.
613  */
614 void
615 dasd_kfree_request(struct dasd_ccw_req * cqr, struct dasd_device * device)
616 {
617 #ifdef CONFIG_ARCH_S390X
618         struct ccw1 *ccw;
619
620         /* Clear any idals used for the request. */
621         ccw = cqr->cpaddr;
622         do {
623                 clear_normalized_cda(ccw);
624         } while (ccw++->flags & (CCW_FLAG_CC | CCW_FLAG_DC));
625 #endif
626         debug_text_event ( dasd_debug_area, 1, "FREE");
627         debug_int_event ( dasd_debug_area, 1, (long) cqr);
628         if (cqr->cpaddr != NULL)
629                 kfree(cqr->cpaddr);
630         if (cqr->data != NULL)
631                 kfree(cqr->data);
632         kfree(cqr);
633         dasd_put_device(device);
634 }
635
636 void
637 dasd_sfree_request(struct dasd_ccw_req * cqr, struct dasd_device * device)
638 {
639         unsigned long flags;
640
641         debug_text_event(dasd_debug_area, 1, "FREE");
642         debug_int_event(dasd_debug_area, 1, (long) cqr);
643         spin_lock_irqsave(&device->mem_lock, flags);
644         dasd_free_chunk(&device->ccw_chunks, cqr);
645         spin_unlock_irqrestore(&device->mem_lock, flags);
646         dasd_put_device(device);
647 }
648
649 /*
650  * Check discipline magic in cqr.
651  */
652 static inline int
653 dasd_check_cqr(struct dasd_ccw_req *cqr)
654 {
655         struct dasd_device *device;
656
657         if (cqr == NULL)
658                 return -EINVAL;
659         device = cqr->device;
660         if (strncmp((char *) &cqr->magic, device->discipline->ebcname, 4)) {
661                 DEV_MESSAGE(KERN_WARNING, device,
662                             " dasd_ccw_req 0x%08x magic doesn't match"
663                             " discipline 0x%08x",
664                             cqr->magic,
665                             *(unsigned int *) device->discipline->name);
666                 return -EINVAL;
667         }
668         return 0;
669 }
670
671 /*
672  * Terminate the current i/o and set the request to clear_pending.
673  * Timer keeps device runnig.
674  * ccw_device_clear can fail if the i/o subsystem
675  * is in a bad mood.
676  */
677 int
678 dasd_term_IO(struct dasd_ccw_req * cqr)
679 {
680         struct dasd_device *device;
681         int retries, rc;
682
683         /* Check the cqr */
684         rc = dasd_check_cqr(cqr);
685         if (rc)
686                 return rc;
687         retries = 0;
688         device = (struct dasd_device *) cqr->device;
689         while ((retries < 5) && (cqr->status == DASD_CQR_IN_IO)) {
690                 rc = ccw_device_clear(device->cdev, (long) cqr);
691                 switch (rc) {
692                 case 0: /* termination successful */
693                         if (cqr->retries > 0) {
694                                 cqr->retries--;
695                                 cqr->status = DASD_CQR_CLEAR;
696                         } else
697                                 cqr->status = DASD_CQR_FAILED;
698                         cqr->stopclk = get_clock();
699                         break;
700                 case -ENODEV:
701                         DBF_DEV_EVENT(DBF_ERR, device, "%s",
702                                       "device gone, retry");
703                         break;
704                 case -EIO:
705                         DBF_DEV_EVENT(DBF_ERR, device, "%s",
706                                       "I/O error, retry");
707                         break;
708                 case -EINVAL:
709                 case -EBUSY:
710                         DBF_DEV_EVENT(DBF_ERR, device, "%s",
711                                       "device busy, retry later");
712                         break;
713                 default:
714                         DEV_MESSAGE(KERN_ERR, device,
715                                     "line %d unknown RC=%d, please "
716                                     "report to linux390@de.ibm.com",
717                                     __LINE__, rc);
718                         BUG();
719                         break;
720                 }
721                 retries++;
722         }
723         dasd_schedule_bh(device);
724         return rc;
725 }
726
727 /*
728  * Start the i/o. This start_IO can fail if the channel is really busy.
729  * In that case set up a timer to start the request later.
730  */
731 int
732 dasd_start_IO(struct dasd_ccw_req * cqr)
733 {
734         struct dasd_device *device;
735         int rc;
736
737         /* Check the cqr */
738         rc = dasd_check_cqr(cqr);
739         if (rc)
740                 return rc;
741         device = (struct dasd_device *) cqr->device;
742         if (cqr->retries < 0) {
743                 DEV_MESSAGE(KERN_DEBUG, device,
744                             "start_IO: request %p (%02x/%i) - no retry left.",
745                             cqr, cqr->status, cqr->retries);
746                 cqr->status = DASD_CQR_FAILED;
747                 return -EIO;
748         }
749         cqr->startclk = get_clock();
750         cqr->starttime = jiffies;
751         cqr->retries--;
752         rc = ccw_device_start(device->cdev, cqr->cpaddr, (long) cqr,
753                               cqr->lpm, 0);
754         switch (rc) {
755         case 0:
756                 cqr->status = DASD_CQR_IN_IO;
757                 break;
758         case -EBUSY:
759                 DBF_DEV_EVENT(DBF_ERR, device, "%s",
760                               "start_IO: device busy, retry later");
761                 break;
762         case -ETIMEDOUT:
763                 DBF_DEV_EVENT(DBF_ERR, device, "%s",
764                               "start_IO: request timeout, retry later");
765                 break;
766         case -ENODEV:
767         case -EIO:
768                 DBF_DEV_EVENT(DBF_ERR, device, "%s",
769                               "start_IO: device gone, retry");
770                 break;
771         default:
772                 DEV_MESSAGE(KERN_ERR, device,
773                             "line %d unknown RC=%d, please report"
774                             " to linux390@de.ibm.com", __LINE__, rc);
775                 BUG();
776                 break;
777         }
778         return rc;
779 }
780
781 /*
782  * Timeout function for dasd devices. This is used for different purposes
783  *  1) missing interrupt handler for normal operation
784  *  2) delayed start of request where start_IO failed with -EBUSY
785  *  3) timeout for missing state change interrupts
786  * The head of the ccw queue will have status DASD_CQR_IN_IO for 1),
787  * DASD_CQR_QUEUED for 2) and 3).
788  */
789 static void
790 dasd_timeout_device(unsigned long ptr)
791 {
792         unsigned long flags;
793         struct dasd_device *device;
794
795         device = (struct dasd_device *) ptr;
796         spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
797         /* re-activate request queue */
798         device->stopped &= ~DASD_STOPPED_PENDING;
799         spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
800         dasd_schedule_bh(device);
801 }
802
803 /*
804  * Setup timeout for a device in jiffies.
805  */
806 void
807 dasd_set_timer(struct dasd_device *device, int expires)
808 {
809         if (expires == 0) {
810                 if (timer_pending(&device->timer))
811                         del_timer(&device->timer);
812                 return;
813         }
814         if (timer_pending(&device->timer)) {
815                 if (mod_timer(&device->timer, jiffies + expires))
816                         return;
817         }
818         device->timer.function = dasd_timeout_device;
819         device->timer.data = (unsigned long) device;
820         device->timer.expires = jiffies + expires;
821         add_timer(&device->timer);
822 }
823
824 /*
825  * Clear timeout for a device.
826  */
827 void
828 dasd_clear_timer(struct dasd_device *device)
829 {
830         if (timer_pending(&device->timer))
831                 del_timer(&device->timer);
832 }
833
834 static void
835 dasd_handle_killed_request(struct ccw_device *cdev, unsigned long intparm)
836 {
837         struct dasd_ccw_req *cqr;
838         struct dasd_device *device;
839
840         cqr = (struct dasd_ccw_req *) intparm;
841         if (cqr->status != DASD_CQR_IN_IO) {
842                 MESSAGE(KERN_DEBUG,
843                         "invalid status in handle_killed_request: "
844                         "bus_id %s, status %02x",
845                         cdev->dev.bus_id, cqr->status);
846                 return;
847         }
848
849         device = (struct dasd_device *) cqr->device;
850         if (device == NULL ||
851             device != dasd_device_from_cdev(cdev) ||
852             strncmp(device->discipline->ebcname, (char *) &cqr->magic, 4)) {
853                 MESSAGE(KERN_DEBUG, "invalid device in request: bus_id %s",
854                         cdev->dev.bus_id);
855                 return;
856         }
857
858         /* Schedule request to be retried. */
859         cqr->status = DASD_CQR_QUEUED;
860
861         dasd_clear_timer(device);
862         dasd_schedule_bh(device);
863         dasd_put_device(device);
864 }
865
866 static void
867 dasd_handle_state_change_pending(struct dasd_device *device)
868 {
869         struct dasd_ccw_req *cqr;
870         struct list_head *l, *n;
871
872         device->stopped &= ~DASD_STOPPED_PENDING;
873
874         /* restart all 'running' IO on queue */
875         list_for_each_safe(l, n, &device->ccw_queue) {
876                 cqr = list_entry(l, struct dasd_ccw_req, list);
877                 if (cqr->status == DASD_CQR_IN_IO) {
878                         cqr->status = DASD_CQR_QUEUED;
879                 }
880         }
881         dasd_clear_timer(device);
882         dasd_schedule_bh(device);
883 }
884
885 /*
886  * Interrupt handler for "normal" ssch-io based dasd devices.
887  */
888 void
889 dasd_int_handler(struct ccw_device *cdev, unsigned long intparm,
890                  struct irb *irb)
891 {
892         struct dasd_ccw_req *cqr, *next;
893         struct dasd_device *device;
894         unsigned long long now;
895         int expires;
896         dasd_era_t era;
897         char mask;
898
899         if (IS_ERR(irb)) {
900                 switch (PTR_ERR(irb)) {
901                 case -EIO:
902                         dasd_handle_killed_request(cdev, intparm);
903                         break;
904                 case -ETIMEDOUT:
905                         printk(KERN_WARNING"%s(%s): request timed out\n",
906                                __FUNCTION__, cdev->dev.bus_id);
907                         //FIXME - dasd uses own timeout interface...
908                         break;
909                 default:
910                         printk(KERN_WARNING"%s(%s): unknown error %ld\n",
911                                __FUNCTION__, cdev->dev.bus_id, PTR_ERR(irb));
912                 }
913                 return;
914         }
915
916         now = get_clock();
917
918         DBF_EVENT(DBF_ERR, "Interrupt: bus_id %s CS/DS %04x ip %08x",
919                   cdev->dev.bus_id, ((irb->scsw.cstat<<8)|irb->scsw.dstat),
920                   (unsigned int) intparm);
921
922         /* first of all check for state change pending interrupt */
923         mask = DEV_STAT_ATTENTION | DEV_STAT_DEV_END | DEV_STAT_UNIT_EXCEP;
924         if ((irb->scsw.dstat & mask) == mask) {
925                 device = dasd_device_from_cdev(cdev);
926                 if (!IS_ERR(device)) {
927                         dasd_handle_state_change_pending(device);
928                         dasd_put_device(device);
929                 }
930                 return;
931         }
932
933         cqr = (struct dasd_ccw_req *) intparm;
934
935         /* check for unsolicited interrupts */
936         if (cqr == NULL) {
937                 MESSAGE(KERN_DEBUG,
938                         "unsolicited interrupt received: bus_id %s",
939                         cdev->dev.bus_id);
940                 return;
941         }
942
943         device = (struct dasd_device *) cqr->device;
944         if (device == NULL ||
945             strncmp(device->discipline->ebcname, (char *) &cqr->magic, 4)) {
946                 MESSAGE(KERN_DEBUG, "invalid device in request: bus_id %s",
947                         cdev->dev.bus_id);
948                 return;
949         }
950
951         /* Check for clear pending */
952         if (cqr->status == DASD_CQR_CLEAR &&
953             irb->scsw.fctl & SCSW_FCTL_CLEAR_FUNC) {
954                 cqr->status = DASD_CQR_QUEUED;
955                 dasd_clear_timer(device);
956                 dasd_schedule_bh(device);
957                 return;
958         }
959
960         /* check status - the request might have been killed by dyn detach */
961         if (cqr->status != DASD_CQR_IN_IO) {
962                 MESSAGE(KERN_DEBUG,
963                         "invalid status: bus_id %s, status %02x",
964                         cdev->dev.bus_id, cqr->status);
965                 return;
966         }
967         DBF_DEV_EVENT(DBF_DEBUG, device, "Int: CS/DS 0x%04x",
968                       ((irb->scsw.cstat << 8) | irb->scsw.dstat));
969
970         /* Find out the appropriate era_action. */
971         if (irb->scsw.fctl & SCSW_FCTL_HALT_FUNC) 
972                 era = dasd_era_fatal;
973         else if (irb->scsw.dstat == (DEV_STAT_CHN_END | DEV_STAT_DEV_END) &&
974                  irb->scsw.cstat == 0 &&
975                  !irb->esw.esw0.erw.cons)
976                 era = dasd_era_none;
977         else if (!test_bit(DASD_CQR_FLAGS_USE_ERP, &cqr->flags))
978                 era = dasd_era_fatal; /* don't recover this request */
979         else if (irb->esw.esw0.erw.cons)
980                 era = device->discipline->examine_error(cqr, irb);
981         else 
982                 era = dasd_era_recover;
983
984         DBF_DEV_EVENT(DBF_DEBUG, device, "era_code %d", era);
985         expires = 0;
986         if (era == dasd_era_none) {
987                 cqr->status = DASD_CQR_DONE;
988                 cqr->stopclk = now;
989                 /* Start first request on queue if possible -> fast_io. */
990                 if (cqr->list.next != &device->ccw_queue) {
991                         next = list_entry(cqr->list.next,
992                                           struct dasd_ccw_req, list);
993                         if ((next->status == DASD_CQR_QUEUED) &&
994                             (!device->stopped)) {
995                                 if (device->discipline->start_IO(next) == 0)
996                                         expires = next->expires;
997                                 else
998                                         DEV_MESSAGE(KERN_DEBUG, device, "%s",
999                                                     "Interrupt fastpath "
1000                                                     "failed!");
1001                         }
1002                 }
1003         } else {                /* error */
1004                 memcpy(&cqr->irb, irb, sizeof (struct irb));
1005 #ifdef ERP_DEBUG
1006                 /* dump sense data */
1007                 dasd_log_sense(cqr, irb);
1008 #endif
1009                 switch (era) {
1010                 case dasd_era_fatal:
1011                         cqr->status = DASD_CQR_FAILED;
1012                         cqr->stopclk = now;
1013                         break;
1014                 case dasd_era_recover:
1015                         cqr->status = DASD_CQR_ERROR;
1016                         break;
1017                 default:
1018                         BUG();
1019                 }
1020         }
1021         if (expires != 0)
1022                 dasd_set_timer(device, expires);
1023         else
1024                 dasd_clear_timer(device);
1025         dasd_schedule_bh(device);
1026 }
1027
1028 /*
1029  * posts the buffer_cache about a finalized request
1030  */
1031 static inline void
1032 dasd_end_request(struct request *req, int uptodate)
1033 {
1034         if (end_that_request_first(req, uptodate, req->hard_nr_sectors))
1035                 BUG();
1036         add_disk_randomness(req->rq_disk);
1037         end_that_request_last(req);
1038 }
1039
1040 /*
1041  * Process finished error recovery ccw.
1042  */
1043 static inline void
1044 __dasd_process_erp(struct dasd_device *device, struct dasd_ccw_req *cqr)
1045 {
1046         dasd_erp_fn_t erp_fn;
1047
1048         if (cqr->status == DASD_CQR_DONE)
1049                 DBF_DEV_EVENT(DBF_NOTICE, device, "%s", "ERP successful");
1050         else
1051                 DEV_MESSAGE(KERN_ERR, device, "%s", "ERP unsuccessful");
1052         erp_fn = device->discipline->erp_postaction(cqr);
1053         erp_fn(cqr);
1054 }
1055
1056 /*
1057  * Process ccw request queue.
1058  */
1059 static inline void
1060 __dasd_process_ccw_queue(struct dasd_device * device,
1061                          struct list_head *final_queue)
1062 {
1063         struct list_head *l, *n;
1064         struct dasd_ccw_req *cqr;
1065         dasd_erp_fn_t erp_fn;
1066
1067 restart:
1068         /* Process request with final status. */
1069         list_for_each_safe(l, n, &device->ccw_queue) {
1070                 cqr = list_entry(l, struct dasd_ccw_req, list);
1071                 /* Stop list processing at the first non-final request. */
1072                 if (cqr->status != DASD_CQR_DONE &&
1073                     cqr->status != DASD_CQR_FAILED &&
1074                     cqr->status != DASD_CQR_ERROR)
1075                         break;
1076                 /*  Process requests with DASD_CQR_ERROR */
1077                 if (cqr->status == DASD_CQR_ERROR) {
1078                         if (cqr->irb.scsw.fctl & SCSW_FCTL_HALT_FUNC) {
1079                                 cqr->status = DASD_CQR_FAILED;
1080                                 cqr->stopclk = get_clock();
1081                         } else {
1082                                 if (cqr->irb.esw.esw0.erw.cons) {
1083                                         erp_fn = device->discipline->erp_action(cqr);
1084                                         erp_fn(cqr);
1085                                 } else
1086                                         dasd_default_erp_action(cqr);
1087                         }
1088                         goto restart;
1089                 }
1090                 /* Process finished ERP request. */
1091                 if (cqr->refers) {
1092                         __dasd_process_erp(device, cqr);
1093                         goto restart;
1094                 }
1095
1096                 /* Rechain finished requests to final queue */
1097                 cqr->endclk = get_clock();
1098                 list_move_tail(&cqr->list, final_queue);
1099         }
1100 }
1101
1102 static void
1103 dasd_end_request_cb(struct dasd_ccw_req * cqr, void *data)
1104 {
1105         struct request *req;
1106
1107         req = (struct request *) data;
1108         dasd_profile_end(cqr->device, cqr, req);
1109         spin_lock_irq(&cqr->device->request_queue_lock);
1110         dasd_end_request(req, (cqr->status == DASD_CQR_DONE));
1111         spin_unlock_irq(&cqr->device->request_queue_lock);
1112         dasd_sfree_request(cqr, cqr->device);
1113 }
1114
1115
1116 /*
1117  * Fetch requests from the block device queue.
1118  */
1119 static inline void
1120 __dasd_process_blk_queue(struct dasd_device * device)
1121 {
1122         request_queue_t *queue;
1123         struct request *req;
1124         struct dasd_ccw_req *cqr;
1125         int nr_queued;
1126
1127         queue = device->request_queue;
1128         /* No queue ? Then there is nothing to do. */
1129         if (queue == NULL)
1130                 return;
1131
1132         /*
1133          * We requeue request from the block device queue to the ccw
1134          * queue only in two states. In state DASD_STATE_READY the
1135          * partition detection is done and we need to requeue requests
1136          * for that. State DASD_STATE_ONLINE is normal block device
1137          * operation.
1138          */
1139         if (device->state != DASD_STATE_READY &&
1140             device->state != DASD_STATE_ONLINE)
1141                 return;
1142         nr_queued = 0;
1143         /* Now we try to fetch requests from the request queue */
1144         list_for_each_entry(cqr, &device->ccw_queue, list)
1145                 if (cqr->status == DASD_CQR_QUEUED)
1146                         nr_queued++;
1147         while (!blk_queue_plugged(queue) &&
1148                elv_next_request(queue) &&
1149                 nr_queued < DASD_CHANQ_MAX_SIZE) {
1150                 req = elv_next_request(queue);
1151                 if (test_bit(DASD_FLAG_RO, &device->flags) &&
1152                     rq_data_dir(req) == WRITE) {
1153                         DBF_EVENT(DBF_ERR,
1154                                   "(%s) Rejecting write request %p",
1155                                   device->cdev->dev.bus_id,
1156                                   req);
1157                         blkdev_dequeue_request(req);
1158                         dasd_end_request(req, 0);
1159                         continue;
1160                 }
1161                 if (device->stopped & DASD_STOPPED_DC_EIO) {
1162                         blkdev_dequeue_request(req);
1163                         dasd_end_request(req, 0);
1164                         continue;
1165                 }
1166                 cqr = device->discipline->build_cp(device, req);
1167                 if (IS_ERR(cqr)) {
1168                         if (PTR_ERR(cqr) == -ENOMEM)
1169                                 break;  /* terminate request queue loop */
1170                         DBF_EVENT(DBF_ERR,
1171                                   "(%s) CCW creation failed on request %p",
1172                                   device->cdev->dev.bus_id,
1173                                   req);
1174                         blkdev_dequeue_request(req);
1175                         dasd_end_request(req, 0);
1176                         continue;
1177                 }
1178                 cqr->callback = dasd_end_request_cb;
1179                 cqr->callback_data = (void *) req;
1180                 cqr->status = DASD_CQR_QUEUED;
1181                 blkdev_dequeue_request(req);
1182                 list_add_tail(&cqr->list, &device->ccw_queue);
1183                 dasd_profile_start(device, cqr, req);
1184                 nr_queued++;
1185         }
1186 }
1187
1188 /*
1189  * Take a look at the first request on the ccw queue and check
1190  * if it reached its expire time. If so, terminate the IO.
1191  */
1192 static inline void
1193 __dasd_check_expire(struct dasd_device * device)
1194 {
1195         struct dasd_ccw_req *cqr;
1196
1197         if (list_empty(&device->ccw_queue))
1198                 return;
1199         cqr = list_entry(device->ccw_queue.next, struct dasd_ccw_req, list);
1200         if (cqr->status == DASD_CQR_IN_IO && cqr->expires != 0) {
1201                 if (time_after_eq(jiffies, cqr->expires + cqr->starttime)) {
1202                         if (device->discipline->term_IO(cqr) != 0)
1203                                 /* Hmpf, try again in 1/10 sec */
1204                                 dasd_set_timer(device, 10);
1205                 }
1206         }
1207 }
1208
1209 /*
1210  * Take a look at the first request on the ccw queue and check
1211  * if it needs to be started.
1212  */
1213 static inline void
1214 __dasd_start_head(struct dasd_device * device)
1215 {
1216         struct dasd_ccw_req *cqr;
1217         int rc;
1218
1219         if (list_empty(&device->ccw_queue))
1220                 return;
1221         cqr = list_entry(device->ccw_queue.next, struct dasd_ccw_req, list);
1222         if ((cqr->status == DASD_CQR_QUEUED) &&
1223             (!device->stopped)) {
1224                 /* try to start the first I/O that can be started */
1225                 rc = device->discipline->start_IO(cqr);
1226                 if (rc == 0)
1227                         dasd_set_timer(device, cqr->expires);
1228                 else
1229                         /* Hmpf, try again in 1/2 sec */
1230                         dasd_set_timer(device, 50);
1231         }
1232 }
1233
1234 /*
1235  * Remove requests from the ccw queue. 
1236  */
1237 static void
1238 dasd_flush_ccw_queue(struct dasd_device * device, int all)
1239 {
1240         struct list_head flush_queue;
1241         struct list_head *l, *n;
1242         struct dasd_ccw_req *cqr;
1243
1244         INIT_LIST_HEAD(&flush_queue);
1245         spin_lock_irq(get_ccwdev_lock(device->cdev));
1246         list_for_each_safe(l, n, &device->ccw_queue) {
1247                 cqr = list_entry(l, struct dasd_ccw_req, list);
1248                 /* Flush all request or only block device requests? */
1249                 if (all == 0 && cqr->callback == dasd_end_request_cb)
1250                         continue;
1251                 if (cqr->status == DASD_CQR_IN_IO)
1252                         device->discipline->term_IO(cqr);
1253                 if (cqr->status != DASD_CQR_DONE ||
1254                     cqr->status != DASD_CQR_FAILED) {
1255                         cqr->status = DASD_CQR_FAILED;
1256                         cqr->stopclk = get_clock();
1257                 }
1258                 /* Process finished ERP request. */
1259                 if (cqr->refers) {
1260                         __dasd_process_erp(device, cqr);
1261                         continue;
1262                 }
1263                 /* Rechain request on device request queue */
1264                 cqr->endclk = get_clock();
1265                 list_move_tail(&cqr->list, &flush_queue);
1266         }
1267         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1268         /* Now call the callback function of flushed requests */
1269         list_for_each_safe(l, n, &flush_queue) {
1270                 cqr = list_entry(l, struct dasd_ccw_req, list);
1271                 if (cqr->callback != NULL)
1272                         (cqr->callback)(cqr, cqr->callback_data);
1273         }
1274 }
1275
1276 /*
1277  * Acquire the device lock and process queues for the device.
1278  */
1279 static void
1280 dasd_tasklet(struct dasd_device * device)
1281 {
1282         struct list_head final_queue;
1283         struct list_head *l, *n;
1284         struct dasd_ccw_req *cqr;
1285
1286         atomic_set (&device->tasklet_scheduled, 0);
1287         INIT_LIST_HEAD(&final_queue);
1288         spin_lock_irq(get_ccwdev_lock(device->cdev));
1289         /* Check expire time of first request on the ccw queue. */
1290         __dasd_check_expire(device);
1291         /* Finish off requests on ccw queue */
1292         __dasd_process_ccw_queue(device, &final_queue);
1293         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1294         /* Now call the callback function of requests with final status */
1295         list_for_each_safe(l, n, &final_queue) {
1296                 cqr = list_entry(l, struct dasd_ccw_req, list);
1297                 list_del(&cqr->list);
1298                 if (cqr->callback != NULL)
1299                         (cqr->callback)(cqr, cqr->callback_data);
1300         }
1301         spin_lock_irq(&device->request_queue_lock);
1302         spin_lock(get_ccwdev_lock(device->cdev));
1303         /* Get new request from the block device request queue */
1304         __dasd_process_blk_queue(device);
1305         /* Now check if the head of the ccw queue needs to be started. */
1306         __dasd_start_head(device);
1307         spin_unlock(get_ccwdev_lock(device->cdev));
1308         spin_unlock_irq(&device->request_queue_lock);
1309         dasd_put_device(device);
1310 }
1311
1312 /*
1313  * Schedules a call to dasd_tasklet over the device tasklet.
1314  */
1315 void
1316 dasd_schedule_bh(struct dasd_device * device)
1317 {
1318         /* Protect against rescheduling. */
1319         if (atomic_compare_and_swap (0, 1, &device->tasklet_scheduled))
1320                 return;
1321         dasd_get_device(device);
1322         tasklet_hi_schedule(&device->tasklet);
1323 }
1324
1325 /*
1326  * Queue a request to the head of the ccw_queue. Start the I/O if
1327  * possible.
1328  */
1329 void
1330 dasd_add_request_head(struct dasd_ccw_req *req)
1331 {
1332         struct dasd_device *device;
1333         unsigned long flags;
1334
1335         device = req->device;
1336         spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
1337         req->status = DASD_CQR_QUEUED;
1338         req->device = device;
1339         list_add(&req->list, &device->ccw_queue);
1340         /* let the bh start the request to keep them in order */
1341         dasd_schedule_bh(device);
1342         spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
1343 }
1344
1345 /*
1346  * Queue a request to the tail of the ccw_queue. Start the I/O if
1347  * possible.
1348  */
1349 void
1350 dasd_add_request_tail(struct dasd_ccw_req *req)
1351 {
1352         struct dasd_device *device;
1353         unsigned long flags;
1354
1355         device = req->device;
1356         spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
1357         req->status = DASD_CQR_QUEUED;
1358         req->device = device;
1359         list_add_tail(&req->list, &device->ccw_queue);
1360         /* let the bh start the request to keep them in order */
1361         dasd_schedule_bh(device);
1362         spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
1363 }
1364
1365 /*
1366  * Wakeup callback.
1367  */
1368 static void
1369 dasd_wakeup_cb(struct dasd_ccw_req *cqr, void *data)
1370 {
1371         wake_up((wait_queue_head_t *) data);
1372 }
1373
1374 static inline int
1375 _wait_for_wakeup(struct dasd_ccw_req *cqr)
1376 {
1377         struct dasd_device *device;
1378         int rc;
1379
1380         device = cqr->device;
1381         spin_lock_irq(get_ccwdev_lock(device->cdev));
1382         rc = cqr->status == DASD_CQR_DONE || cqr->status == DASD_CQR_FAILED;
1383         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1384         return rc;
1385 }
1386
1387 /*
1388  * Attempts to start a special ccw queue and waits for its completion.
1389  */
1390 int
1391 dasd_sleep_on(struct dasd_ccw_req * cqr)
1392 {
1393         wait_queue_head_t wait_q;
1394         struct dasd_device *device;
1395         int rc;
1396         
1397         device = cqr->device;
1398         spin_lock_irq(get_ccwdev_lock(device->cdev));
1399         
1400         init_waitqueue_head (&wait_q);
1401         cqr->callback = dasd_wakeup_cb;
1402         cqr->callback_data = (void *) &wait_q;
1403         cqr->status = DASD_CQR_QUEUED;
1404         list_add_tail(&cqr->list, &device->ccw_queue);
1405         
1406         /* let the bh start the request to keep them in order */
1407         dasd_schedule_bh(device);
1408         
1409         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1410
1411         wait_event(wait_q, _wait_for_wakeup(cqr));
1412         
1413         /* Request status is either done or failed. */
1414         rc = (cqr->status == DASD_CQR_FAILED) ? -EIO : 0;
1415         return rc;
1416 }
1417
1418 /*
1419  * Attempts to start a special ccw queue and wait interruptible
1420  * for its completion.
1421  */
1422 int
1423 dasd_sleep_on_interruptible(struct dasd_ccw_req * cqr)
1424 {
1425         wait_queue_head_t wait_q;
1426         struct dasd_device *device;
1427         int rc, finished;
1428
1429         device = cqr->device;
1430         spin_lock_irq(get_ccwdev_lock(device->cdev));
1431
1432         init_waitqueue_head (&wait_q);
1433         cqr->callback = dasd_wakeup_cb;
1434         cqr->callback_data = (void *) &wait_q;
1435         cqr->status = DASD_CQR_QUEUED;
1436         list_add_tail(&cqr->list, &device->ccw_queue);
1437
1438         /* let the bh start the request to keep them in order */
1439         dasd_schedule_bh(device);
1440         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1441
1442         finished = 0;
1443         while (!finished) {
1444                 rc = wait_event_interruptible(wait_q, _wait_for_wakeup(cqr));
1445                 if (rc != -ERESTARTSYS) {
1446                         /* Request status is either done or failed. */
1447                         rc = (cqr->status == DASD_CQR_FAILED) ? -EIO : 0;
1448                         break;
1449                 }
1450                 spin_lock_irq(get_ccwdev_lock(device->cdev));
1451                 if (cqr->status == DASD_CQR_IN_IO &&
1452                     device->discipline->term_IO(cqr) == 0) {
1453                         list_del(&cqr->list);
1454                         finished = 1;
1455                 }
1456                 spin_unlock_irq(get_ccwdev_lock(device->cdev));
1457         }
1458         return rc;
1459 }
1460
1461 /*
1462  * Whoa nelly now it gets really hairy. For some functions (e.g. steal lock
1463  * for eckd devices) the currently running request has to be terminated
1464  * and be put back to status queued, before the special request is added
1465  * to the head of the queue. Then the special request is waited on normally.
1466  */
1467 static inline int
1468 _dasd_term_running_cqr(struct dasd_device *device)
1469 {
1470         struct dasd_ccw_req *cqr;
1471         int rc;
1472
1473         if (list_empty(&device->ccw_queue))
1474                 return 0;
1475         cqr = list_entry(device->ccw_queue.next, struct dasd_ccw_req, list);
1476         rc = device->discipline->term_IO(cqr);
1477         if (rc == 0) {
1478                 /* termination successful */
1479                 cqr->status = DASD_CQR_QUEUED;
1480                 cqr->startclk = cqr->stopclk = 0;
1481                 cqr->starttime = 0;
1482         }
1483         return rc;
1484 }
1485
1486 int
1487 dasd_sleep_on_immediatly(struct dasd_ccw_req * cqr)
1488 {
1489         wait_queue_head_t wait_q;
1490         struct dasd_device *device;
1491         int rc;
1492         
1493         device = cqr->device;
1494         spin_lock_irq(get_ccwdev_lock(device->cdev));
1495         rc = _dasd_term_running_cqr(device);
1496         if (rc) {
1497                 spin_unlock_irq(get_ccwdev_lock(device->cdev));
1498                 return rc;
1499         }
1500         
1501         init_waitqueue_head (&wait_q);
1502         cqr->callback = dasd_wakeup_cb;
1503         cqr->callback_data = (void *) &wait_q;
1504         cqr->status = DASD_CQR_QUEUED;
1505         list_add(&cqr->list, &device->ccw_queue);
1506         
1507         /* let the bh start the request to keep them in order */
1508         dasd_schedule_bh(device);
1509         
1510         spin_unlock_irq(get_ccwdev_lock(device->cdev));
1511
1512         wait_event(wait_q, _wait_for_wakeup(cqr));
1513         
1514         /* Request status is either done or failed. */
1515         rc = (cqr->status == DASD_CQR_FAILED) ? -EIO : 0;
1516         return rc;
1517 }
1518
1519 /*
1520  * Cancels a request that was started with dasd_sleep_on_req.
1521  * This is useful to timeout requests. The request will be
1522  * terminated if it is currently in i/o.
1523  * Returns 1 if the request has been terminated.
1524  */
1525 int
1526 dasd_cancel_req(struct dasd_ccw_req *cqr)
1527 {
1528         struct dasd_device *device = cqr->device;
1529         unsigned long flags;
1530         int rc;
1531
1532         rc = 0;
1533         spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
1534         switch (cqr->status) {
1535         case DASD_CQR_QUEUED:
1536                 /* request was not started - just set to failed */
1537                 cqr->status = DASD_CQR_FAILED;
1538                 break;
1539         case DASD_CQR_IN_IO:
1540                 /* request in IO - terminate IO and release again */
1541                 if (device->discipline->term_IO(cqr) != 0)
1542                         /* what to do if unable to terminate ??????
1543                            e.g. not _IN_IO */
1544                         cqr->status = DASD_CQR_FAILED;
1545                 cqr->stopclk = get_clock();
1546                 rc = 1;
1547                 break;
1548         case DASD_CQR_DONE:
1549         case DASD_CQR_FAILED:
1550                 /* already finished - do nothing */
1551                 break;
1552         default:
1553                 DEV_MESSAGE(KERN_ALERT, device,
1554                             "invalid status %02x in request",
1555                             cqr->status);
1556                 BUG();
1557
1558         }
1559         spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
1560         dasd_schedule_bh(device);
1561         return rc;
1562 }
1563
1564 /*
1565  * SECTION: Block device operations (request queue, partitions, open, release).
1566  */
1567
1568 /*
1569  * Dasd request queue function. Called from ll_rw_blk.c
1570  */
1571 static void
1572 do_dasd_request(request_queue_t * queue)
1573 {
1574         struct dasd_device *device;
1575
1576         device = (struct dasd_device *) queue->queuedata;
1577         spin_lock(get_ccwdev_lock(device->cdev));
1578         /* Get new request from the block device request queue */
1579         __dasd_process_blk_queue(device);
1580         /* Now check if the head of the ccw queue needs to be started. */
1581         __dasd_start_head(device);
1582         spin_unlock(get_ccwdev_lock(device->cdev));
1583 }
1584
1585 /*
1586  * Allocate and initialize request queue.
1587  */
1588 static int
1589 dasd_alloc_queue(struct dasd_device * device)
1590 {
1591         device->request_queue = blk_init_queue(do_dasd_request,
1592                                                &device->request_queue_lock);
1593         if (device->request_queue == NULL)
1594                 return -ENOMEM;
1595
1596         device->request_queue->queuedata = device;
1597 #if 0
1598         elevator_exit(device->request_queue);
1599         rc = elevator_init(device->request_queue, &elevator_noop);
1600         if (rc) {
1601                 blk_cleanup_queue(device->request_queue);
1602                 return rc;
1603         }
1604 #endif
1605         return 0;
1606 }
1607
1608 /*
1609  * Allocate and initialize request queue.
1610  */
1611 static void
1612 dasd_setup_queue(struct dasd_device * device)
1613 {
1614         int max;
1615
1616         blk_queue_hardsect_size(device->request_queue, device->bp_block);
1617         max = device->discipline->max_blocks << device->s2b_shift;
1618         blk_queue_max_sectors(device->request_queue, max);
1619         blk_queue_max_phys_segments(device->request_queue, -1L);
1620         blk_queue_max_hw_segments(device->request_queue, -1L);
1621         blk_queue_max_segment_size(device->request_queue, -1L);
1622         blk_queue_segment_boundary(device->request_queue, -1L);
1623 }
1624
1625 /*
1626  * Deactivate and free request queue.
1627  */
1628 static void
1629 dasd_free_queue(struct dasd_device * device)
1630 {
1631         if (device->request_queue) {
1632                 blk_cleanup_queue(device->request_queue);
1633                 device->request_queue = NULL;
1634         }
1635 }
1636
1637 /*
1638  * Flush request on the request queue.
1639  */
1640 static void
1641 dasd_flush_request_queue(struct dasd_device * device)
1642 {
1643         struct request *req;
1644
1645         if (!device->request_queue)
1646                 return;
1647         
1648         spin_lock_irq(&device->request_queue_lock);
1649         while (!list_empty(&device->request_queue->queue_head)) {
1650                 req = elv_next_request(device->request_queue);
1651                 if (req == NULL)
1652                         break;
1653                 dasd_end_request(req, 0);
1654                 blkdev_dequeue_request(req);
1655         }
1656         spin_unlock_irq(&device->request_queue_lock);
1657 }
1658
1659 static int
1660 dasd_open(struct inode *inp, struct file *filp)
1661 {
1662         struct gendisk *disk = inp->i_bdev->bd_disk;
1663         struct dasd_device *device = disk->private_data;
1664         int rc;
1665
1666         atomic_inc(&device->open_count);
1667         if (test_bit(DASD_FLAG_OFFLINE, &device->flags)) {
1668                 rc = -ENODEV;
1669                 goto unlock;
1670         }
1671
1672         if (!try_module_get(device->discipline->owner)) {
1673                 rc = -EINVAL;
1674                 goto unlock;
1675         }
1676
1677         if (dasd_probeonly) {
1678                 MESSAGE(KERN_INFO,
1679                         "No access to device %s due to probeonly mode",
1680                         disk->disk_name);
1681                 rc = -EPERM;
1682                 goto out;
1683         }
1684
1685         if (device->state < DASD_STATE_BASIC) {
1686                 DBF_DEV_EVENT(DBF_ERR, device, " %s",
1687                               " Cannot open unrecognized device");
1688                 rc = -ENODEV;
1689                 goto out;
1690         }
1691
1692         return 0;
1693
1694 out:
1695         module_put(device->discipline->owner);
1696 unlock:
1697         atomic_dec(&device->open_count);
1698         return rc;
1699 }
1700
1701 static int
1702 dasd_release(struct inode *inp, struct file *filp)
1703 {
1704         struct gendisk *disk = inp->i_bdev->bd_disk;
1705         struct dasd_device *device = disk->private_data;
1706
1707         atomic_dec(&device->open_count);
1708         module_put(device->discipline->owner);
1709         return 0;
1710 }
1711
1712 struct block_device_operations
1713 dasd_device_operations = {
1714         .owner          = THIS_MODULE,
1715         .open           = dasd_open,
1716         .release        = dasd_release,
1717         .ioctl          = dasd_ioctl,
1718 };
1719
1720
1721 static void
1722 dasd_exit(void)
1723 {
1724 #ifdef CONFIG_PROC_FS
1725         dasd_proc_exit();
1726 #endif
1727         dasd_ioctl_exit();
1728         dasd_gendisk_exit();
1729         dasd_devmap_exit();
1730         devfs_remove("dasd");
1731         if (dasd_debug_area != NULL) {
1732                 debug_unregister(dasd_debug_area);
1733                 dasd_debug_area = NULL;
1734         }
1735 }
1736
1737 /*
1738  * SECTION: common functions for ccw_driver use
1739  */
1740
1741 /* initial attempt at a probe function. this can be simplified once
1742  * the other detection code is gone */
1743 int
1744 dasd_generic_probe (struct ccw_device *cdev,
1745                     struct dasd_discipline *discipline)
1746 {
1747         int ret;
1748
1749         ret = dasd_add_sysfs_files(cdev);
1750         if (ret) {
1751                 printk(KERN_WARNING
1752                        "dasd_generic_probe: could not add sysfs entries "
1753                        "for %s\n", cdev->dev.bus_id);
1754         }
1755
1756         cdev->handler = &dasd_int_handler;
1757
1758         return ret;
1759 }
1760
1761 /* this will one day be called from a global not_oper handler.
1762  * It is also used by driver_unregister during module unload */
1763 void
1764 dasd_generic_remove (struct ccw_device *cdev)
1765 {
1766         struct dasd_device *device;
1767
1768         dasd_remove_sysfs_files(cdev);
1769         device = dasd_device_from_cdev(cdev);
1770         if (IS_ERR(device))
1771                 return;
1772         if (test_and_set_bit(DASD_FLAG_OFFLINE, &device->flags)) {
1773                 /* Already doing offline processing */
1774                 dasd_put_device(device);
1775                 return;
1776         }
1777         /*
1778          * This device is removed unconditionally. Set offline
1779          * flag to prevent dasd_open from opening it while it is
1780          * no quite down yet.
1781          */
1782         dasd_set_target_state(device, DASD_STATE_NEW);
1783         /* dasd_delete_device destroys the device reference. */
1784         dasd_delete_device(device);
1785 }
1786
1787 /* activate a device. This is called from dasd_{eckd,fba}_probe() when either
1788  * the device is detected for the first time and is supposed to be used
1789  * or the user has started activation through sysfs */
1790 int
1791 dasd_generic_set_online (struct ccw_device *cdev,
1792                          struct dasd_discipline *discipline)
1793
1794 {
1795         struct dasd_device *device;
1796         int rc;
1797
1798         device = dasd_create_device(cdev);
1799         if (IS_ERR(device))
1800                 return PTR_ERR(device);
1801
1802         if (test_bit(DASD_FLAG_USE_DIAG, &device->flags)) {
1803                 if (!dasd_diag_discipline_pointer) {
1804                         printk (KERN_WARNING
1805                                 "dasd_generic couldn't online device %s "
1806                                 "- discipline DIAG not available\n",
1807                                 cdev->dev.bus_id);
1808                         dasd_delete_device(device);
1809                         return -ENODEV;
1810                 }
1811                 discipline = dasd_diag_discipline_pointer;
1812         }
1813         device->discipline = discipline;
1814
1815         rc = discipline->check_device(device);
1816         if (rc) {
1817                 printk (KERN_WARNING
1818                         "dasd_generic couldn't online device %s "
1819                         "with discipline %s\n", 
1820                         cdev->dev.bus_id, discipline->name);
1821                 dasd_delete_device(device);
1822                 return rc;
1823         }
1824
1825         dasd_set_target_state(device, DASD_STATE_ONLINE);
1826         if (device->state <= DASD_STATE_KNOWN) {
1827                 printk (KERN_WARNING
1828                         "dasd_generic discipline not found for %s\n",
1829                         cdev->dev.bus_id);
1830                 rc = -ENODEV;
1831                 dasd_set_target_state(device, DASD_STATE_NEW);
1832                 dasd_delete_device(device);
1833         } else
1834                 pr_debug("dasd_generic device %s found\n",
1835                                 cdev->dev.bus_id);
1836
1837         /* FIXME: we have to wait for the root device but we don't want
1838          * to wait for each single device but for all at once. */
1839         wait_event(dasd_init_waitq, _wait_for_device(device));
1840
1841         dasd_put_device(device);
1842
1843         return rc;
1844 }
1845
1846 int
1847 dasd_generic_set_offline (struct ccw_device *cdev)
1848 {
1849         struct dasd_device *device;
1850         int max_count;
1851
1852         device = dasd_device_from_cdev(cdev);
1853         if (IS_ERR(device))
1854                 return PTR_ERR(device);
1855         if (test_and_set_bit(DASD_FLAG_OFFLINE, &device->flags)) {
1856                 /* Already doing offline processing */
1857                 dasd_put_device(device);
1858                 return 0;
1859         }
1860         /*
1861          * We must make sure that this device is currently not in use.
1862          * The open_count is increased for every opener, that includes
1863          * the blkdev_get in dasd_scan_partitions. We are only interested
1864          * in the other openers.
1865          */
1866         max_count = device->bdev ? 0 : -1;
1867         if (atomic_read(&device->open_count) > max_count) {
1868                 printk (KERN_WARNING "Can't offline dasd device with open"
1869                         " count = %i.\n",
1870                         atomic_read(&device->open_count));
1871                 clear_bit(DASD_FLAG_OFFLINE, &device->flags);
1872                 dasd_put_device(device);
1873                 return -EBUSY;
1874         }
1875         dasd_set_target_state(device, DASD_STATE_NEW);
1876         /* dasd_delete_device destroys the device reference. */
1877         dasd_delete_device(device);
1878
1879         return 0;
1880 }
1881
1882 int
1883 dasd_generic_notify(struct ccw_device *cdev, int event)
1884 {
1885         struct dasd_device *device;
1886         struct dasd_ccw_req *cqr;
1887         unsigned long flags;
1888         int ret;
1889
1890         device = dasd_device_from_cdev(cdev);
1891         if (IS_ERR(device))
1892                 return 0;
1893         spin_lock_irqsave(get_ccwdev_lock(cdev), flags);
1894         ret = 0;
1895         switch (event) {
1896         case CIO_GONE:
1897         case CIO_NO_PATH:
1898                 if (device->state < DASD_STATE_BASIC)
1899                         break;
1900                 /* Device is active. We want to keep it. */
1901                 if (test_bit(DASD_FLAG_DSC_ERROR, &device->flags)) {
1902                         list_for_each_entry(cqr, &device->ccw_queue, list)
1903                                 if (cqr->status == DASD_CQR_IN_IO)
1904                                         cqr->status = DASD_CQR_FAILED;
1905                         device->stopped |= DASD_STOPPED_DC_EIO;
1906                         dasd_schedule_bh(device);
1907                 } else {
1908                         list_for_each_entry(cqr, &device->ccw_queue, list)
1909                                 if (cqr->status == DASD_CQR_IN_IO)
1910                                         cqr->status = DASD_CQR_QUEUED;
1911                         device->stopped |= DASD_STOPPED_DC_WAIT;
1912                         dasd_set_timer(device, 0);
1913                 }
1914                 ret = 1;
1915                 break;
1916         case CIO_OPER:
1917                 /* FIXME: add a sanity check. */
1918                 device->stopped &= ~(DASD_STOPPED_DC_WAIT|DASD_STOPPED_DC_EIO);
1919                 dasd_schedule_bh(device);
1920                 ret = 1;
1921                 break;
1922         }
1923         spin_unlock_irqrestore(get_ccwdev_lock(cdev), flags);
1924         dasd_put_device(device);
1925         return ret;
1926 }
1927
1928 /*
1929  * Automatically online either all dasd devices (dasd_autodetect) or
1930  * all devices specified with dasd= parameters.
1931  */
1932 void
1933 dasd_generic_auto_online (struct ccw_driver *dasd_discipline_driver)
1934 {
1935         struct device_driver *drv;
1936         struct device *d, *dev;
1937         struct ccw_device *cdev;
1938
1939         drv = get_driver(&dasd_discipline_driver->driver);
1940         down_read(&drv->bus->subsys.rwsem);
1941         dev = NULL;
1942         list_for_each_entry(d, &drv->devices, driver_list) {
1943                 dev = get_device(d);
1944                 if (!dev)
1945                         continue;
1946                 cdev = to_ccwdev(dev);
1947                 if (dasd_autodetect || dasd_busid_known(cdev->dev.bus_id) == 0)
1948                         ccw_device_set_online(cdev);
1949                 put_device(dev);
1950         }
1951         up_read(&drv->bus->subsys.rwsem);
1952         put_driver(drv);
1953 }
1954
1955 static int __init
1956 dasd_init(void)
1957 {
1958         int rc;
1959
1960         init_waitqueue_head(&dasd_init_waitq);
1961
1962         /* register 'common' DASD debug area, used for all DBF_XXX calls */
1963         dasd_debug_area = debug_register("dasd", 0, 2, 8 * sizeof (long));
1964         if (dasd_debug_area == NULL) {
1965                 rc = -ENOMEM;
1966                 goto failed;
1967         }
1968         debug_register_view(dasd_debug_area, &debug_hex_ascii_view);
1969         debug_set_level(dasd_debug_area, DBF_ERR);
1970
1971         DBF_EVENT(DBF_EMERG, "%s", "debug area created");
1972
1973         dasd_diag_discipline_pointer = NULL;
1974
1975         rc = devfs_mk_dir("dasd");
1976         if (rc)
1977                 goto failed;
1978         rc = dasd_devmap_init();
1979         if (rc)
1980                 goto failed;
1981         rc = dasd_gendisk_init();
1982         if (rc)
1983                 goto failed;
1984         rc = dasd_parse();
1985         if (rc)
1986                 goto failed;
1987         rc = dasd_ioctl_init();
1988         if (rc)
1989                 goto failed;
1990 #ifdef CONFIG_PROC_FS
1991         rc = dasd_proc_init();
1992         if (rc)
1993                 goto failed;
1994 #endif
1995
1996         return 0;
1997 failed:
1998         MESSAGE(KERN_INFO, "%s", "initialization not performed due to errors");
1999         dasd_exit();
2000         return rc;
2001 }
2002
2003 module_init(dasd_init);
2004 module_exit(dasd_exit);
2005
2006 EXPORT_SYMBOL(dasd_debug_area);
2007 EXPORT_SYMBOL(dasd_diag_discipline_pointer);
2008
2009 EXPORT_SYMBOL(dasd_add_request_head);
2010 EXPORT_SYMBOL(dasd_add_request_tail);
2011 EXPORT_SYMBOL(dasd_cancel_req);
2012 EXPORT_SYMBOL(dasd_clear_timer);
2013 EXPORT_SYMBOL(dasd_enable_device);
2014 EXPORT_SYMBOL(dasd_int_handler);
2015 EXPORT_SYMBOL(dasd_kfree_request);
2016 EXPORT_SYMBOL(dasd_kick_device);
2017 EXPORT_SYMBOL(dasd_kmalloc_request);
2018 EXPORT_SYMBOL(dasd_schedule_bh);
2019 EXPORT_SYMBOL(dasd_set_target_state);
2020 EXPORT_SYMBOL(dasd_set_timer);
2021 EXPORT_SYMBOL(dasd_sfree_request);
2022 EXPORT_SYMBOL(dasd_sleep_on);
2023 EXPORT_SYMBOL(dasd_sleep_on_immediatly);
2024 EXPORT_SYMBOL(dasd_sleep_on_interruptible);
2025 EXPORT_SYMBOL(dasd_smalloc_request);
2026 EXPORT_SYMBOL(dasd_start_IO);
2027 EXPORT_SYMBOL(dasd_term_IO);
2028
2029 EXPORT_SYMBOL_GPL(dasd_generic_probe);
2030 EXPORT_SYMBOL_GPL(dasd_generic_remove);
2031 EXPORT_SYMBOL_GPL(dasd_generic_notify);
2032 EXPORT_SYMBOL_GPL(dasd_generic_set_online);
2033 EXPORT_SYMBOL_GPL(dasd_generic_set_offline);
2034 EXPORT_SYMBOL_GPL(dasd_generic_auto_online);
2035
2036 /*
2037  * Overrides for Emacs so that we follow Linus's tabbing style.
2038  * Emacs will notice this stuff at the end of the file and automatically
2039  * adjust the settings for this buffer only.  This must remain at the end
2040  * of the file.
2041  * ---------------------------------------------------------------------------
2042  * Local variables:
2043  * c-indent-level: 4
2044  * c-brace-imaginary-offset: 0
2045  * c-brace-offset: -4
2046  * c-argdecl-indent: 4
2047  * c-label-offset: -4
2048  * c-continued-statement-offset: 4
2049  * c-continued-brace-offset: 0
2050  * indent-tabs-mode: 1
2051  * tab-width: 8
2052  * End:
2053  */