drivers/s390/block/dasd_int.h

   1 /*
   2  * File...........: linux/drivers/s390/block/dasd_int.h
   3  * Author(s)......: Holger Smolinski <Holger.Smolinski@de.ibm.com>
   4  *                  Horst Hummel <Horst.Hummel@de.ibm.com>
   5  *                  Martin Schwidefsky <schwidefsky@de.ibm.com>
   6  * Bugreports.to..: <Linux390@de.ibm.com>
   7  * (C) IBM Corporation, IBM Deutschland Entwicklung GmbH, 1999,2000
   8  *
   9  */
  10
  11 #ifndef DASD_INT_H
  12 #define DASD_INT_H
  13
  14 #ifdef __KERNEL__
  15
  16 /* erp debugging in dasd.c and dasd_3990_erp.c */
  17 #define ERP_DEBUG
  18
  19
  20 /* we keep old device allocation scheme; IOW, minors are still in 0..255 */
  21 #define DASD_PER_MAJOR (1U << (MINORBITS - DASD_PARTN_BITS))
  22 #define DASD_PARTN_MASK ((1 << DASD_PARTN_BITS) - 1)
  23
  24 /*
  25  * States a dasd device can have:
  26  *   new: the dasd_device structure is allocated.
  27  *   known: the discipline for the device is identified.
  28  *   basic: the device can do basic i/o.
  29  *   accept: the device is analysed (format is known).
  30  *   ready: partition detection is done and the device is can do block io.
  31  *   online: the device accepts requests from the block device queue.
  32  *
  33  * Things to do for startup state transitions:
  34  *   new -> known: find discipline for the device and create devfs entries.
  35  *   known -> basic: request irq line for the device.
  36  *   basic -> ready: do the initial analysis, e.g. format detection,
  37  *                   do block device setup and detect partitions.
  38  *   ready -> online: schedule the device tasklet.
  39  * Things to do for shutdown state transitions:
  40  *   online -> ready: just set the new device state.
  41  *   ready -> basic: flush requests from the block device layer, clear
  42  *                   partition information and reset format information.
  43  *   basic -> known: terminate all requests and free irq.
  44  *   known -> new: remove devfs entries and forget discipline.
  45  */
  46
  47 #define DASD_STATE_NEW    0
  48 #define DASD_STATE_KNOWN  1
  49 #define DASD_STATE_BASIC  2
  50 #define DASD_STATE_READY  3
  51 #define DASD_STATE_ONLINE 4
  52
  53 #include <linux/module.h>
  54 #include <linux/wait.h>
  55 #include <linux/blkdev.h>
  56 #include <linux/devfs_fs_kernel.h>
  57 #include <linux/genhd.h>
  58 #include <linux/hdreg.h>
  59 #include <linux/interrupt.h>
  60 #include <asm/ccwdev.h>
  61 #include <linux/workqueue.h>
  62 #include <asm/debug.h>
  63 #include <asm/dasd.h>
  64 #include <asm/idals.h>
  65
  66 /*
  67  * SECTION: Type definitions
  68  */
  69 struct dasd_device;
  70
  71 typedef int (*dasd_ioctl_fn_t) (struct block_device *bdev, int no, long args);
  72
  73 struct dasd_ioctl {
  74         struct list_head list;
  75         struct module *owner;
  76         int no;
  77         dasd_ioctl_fn_t handler;
  78 };
  79
  80 typedef enum {
  81         dasd_era_fatal = -1,    /* no chance to recover              */
  82         dasd_era_none = 0,      /* don't recover, everything alright */
  83         dasd_era_msg = 1,       /* don't recover, just report...     */
  84         dasd_era_recover = 2    /* recovery action recommended       */
  85 } dasd_era_t;
  86
  87 /* BIT DEFINITIONS FOR SENSE DATA */
  88 #define DASD_SENSE_BIT_0 0x80
  89 #define DASD_SENSE_BIT_1 0x40
  90 #define DASD_SENSE_BIT_2 0x20
  91 #define DASD_SENSE_BIT_3 0x10
  92
  93 /*
  94  * SECTION: MACROs for klogd and s390 debug feature (dbf)
  95  */
  96 #define DBF_DEV_EVENT(d_level, d_device, d_str, d_data...) \
  97 do { \
  98         debug_sprintf_event(d_device->debug_area, \
  99                             d_level, \
 100                             d_str "\n", \
 101                             d_data); \
 102 } while(0)
 103
 104 #define DBF_DEV_EXC(d_level, d_device, d_str, d_data...) \
 105 do { \
 106         debug_sprintf_exception(d_device->debug_area, \
 107                                 d_level, \
 108                                 d_str "\n", \
 109                                 d_data); \
 110 } while(0)
 111
 112 #define DBF_EVENT(d_level, d_str, d_data...)\
 113 do { \
 114         debug_sprintf_event(dasd_debug_area, \
 115                             d_level,\
 116                             d_str "\n", \
 117                             d_data); \
 118 } while(0)
 119
 120 #define DBF_EXC(d_level, d_str, d_data...)\
 121 do { \
 122         debug_sprintf_exception(dasd_debug_area, \
 123                                 d_level,\
 124                                 d_str "\n", \
 125                                 d_data); \
 126 } while(0)
 127
 128 /* definition of dbf debug levels */
 129 #define DBF_EMERG       0       /* system is unusable                   */
 130 #define DBF_ALERT       1       /* action must be taken immediately     */
 131 #define DBF_CRIT        2       /* critical conditions                  */
 132 #define DBF_ERR         3       /* error conditions                     */
 133 #define DBF_WARNING     4       /* warning conditions                   */
 134 #define DBF_NOTICE      5       /* normal but significant condition     */
 135 #define DBF_INFO        6       /* informational                        */
 136 #define DBF_DEBUG       6       /* debug-level messages                 */
 137
 138 /* messages to be written via klogd and dbf */
 139 #define DEV_MESSAGE(d_loglevel,d_device,d_string,d_args...)\
 140 do { \
 141         printk(d_loglevel PRINTK_HEADER " %s: " d_string "\n", \
 142                d_device->cdev->dev.bus_id, d_args); \
 143         DBF_DEV_EVENT(DBF_ALERT, d_device, d_string, d_args); \
 144 } while(0)
 145
 146 #define MESSAGE(d_loglevel,d_string,d_args...)\
 147 do { \
 148         printk(d_loglevel PRINTK_HEADER " " d_string "\n", d_args); \
 149         DBF_EVENT(DBF_ALERT, d_string, d_args); \
 150 } while(0)
 151
 152 /* messages to be written via klogd only */
 153 #define DEV_MESSAGE_LOG(d_loglevel,d_device,d_string,d_args...)\
 154 do { \
 155         printk(d_loglevel PRINTK_HEADER " %s: " d_string "\n", \
 156                d_device->cdev->dev.bus_id, d_args); \
 157 } while(0)
 158
 159 #define MESSAGE_LOG(d_loglevel,d_string,d_args...)\
 160 do { \
 161         printk(d_loglevel PRINTK_HEADER " " d_string "\n", d_args); \
 162 } while(0)
 163
 164 struct dasd_ccw_req {
 165         unsigned int magic;             /* Eye catcher */
 166         struct list_head list;          /* list_head for request queueing. */
 167
 168         /* Where to execute what... */
 169         struct dasd_device *device;     /* device the request is for */
 170         struct ccw1 *cpaddr;            /* address of channel program */
 171         char status;                    /* status of this request */
 172         short retries;                  /* A retry counter */
 173         unsigned long flags;            /* flags of this request */
 174
 175         /* ... and how */
 176         unsigned long starttime;        /* jiffies time of request start */
 177         int expires;                    /* expiration period in jiffies */
 178         char lpm;                       /* logical path mask */
 179         void *data;                     /* pointer to data area */
 180
 181         /* these are important for recovering erroneous requests          */
 182         struct irb irb;                 /* device status in case of an error */
 183         struct dasd_ccw_req *refers;    /* ERP-chain queueing. */
 184         void *function;                 /* originating ERP action */
 185
 186         /* these are for statistics only */
 187         unsigned long long buildclk;    /* TOD-clock of request generation */
 188         unsigned long long startclk;    /* TOD-clock of request start */
 189         unsigned long long stopclk;     /* TOD-clock of request interrupt */
 190         unsigned long long endclk;      /* TOD-clock of request termination */
 191
 192         /* Callback that is called after reaching final status. */
 193         void (*callback)(struct dasd_ccw_req *, void *data);
 194         void *callback_data;
 195 };
 196
 197 /*
 198  * dasd_ccw_req -> status can be:
 199  */
 200 #define DASD_CQR_FILLED   0x00  /* request is ready to be processed */
 201 #define DASD_CQR_QUEUED   0x01  /* request is queued to be processed */
 202 #define DASD_CQR_IN_IO    0x02  /* request is currently in IO */
 203 #define DASD_CQR_DONE     0x03  /* request is completed successfully */
 204 #define DASD_CQR_ERROR    0x04  /* request is completed with error */
 205 #define DASD_CQR_FAILED   0x05  /* request is finally failed */
 206 #define DASD_CQR_CLEAR    0x06  /* request is clear pending */
 207
 208 /* per dasd_ccw_req flags */
 209 #define DASD_CQR_FLAGS_USE_ERP   0      /* use ERP for this request */
 210 #define DASD_CQR_FLAGS_FAILFAST  1      /* FAILFAST */
 211
 212 /* Signature for error recovery functions. */
 213 typedef struct dasd_ccw_req *(*dasd_erp_fn_t) (struct dasd_ccw_req *);
 214
 215 /*
 216  * the struct dasd_discipline is
 217  * sth like a table of virtual functions, if you think of dasd_eckd
 218  * inheriting dasd...
 219  * no, currently we are not planning to reimplement the driver in C++
 220  */
 221 struct dasd_discipline {
 222         struct module *owner;
 223         char ebcname[8];        /* a name used for tagging and printks */
 224         char name[8];           /* a name used for tagging and printks */
 225         int max_blocks;         /* maximum number of blocks to be chained */
 226
 227         struct list_head list;  /* used for list of disciplines */
 228
 229         /*
 230          * Device recognition functions. check_device is used to verify
 231          * the sense data and the information returned by read device
 232          * characteristics. It returns 0 if the discipline can be used
 233          * for the device in question.
 234          * do_analysis is used in the step from device state "basic" to
 235          * state "accept". It returns 0 if the device can be made ready,
 236          * it returns -EMEDIUMTYPE if the device can't be made ready or
 237          * -EAGAIN if do_analysis started a ccw that needs to complete
 238          * before the analysis may be repeated.
 239          */
 240         int (*check_device)(struct dasd_device *);
 241         int (*do_analysis) (struct dasd_device *);
 242
 243         /*
 244          * Device operation functions. build_cp creates a ccw chain for
 245          * a block device request, start_io starts the request and
 246          * term_IO cancels it (e.g. in case of a timeout). format_device
 247          * returns a ccw chain to be used to format the device.
 248          */
 249         struct dasd_ccw_req *(*build_cp) (struct dasd_device *,
 250                                           struct request *);
 251         int (*start_IO) (struct dasd_ccw_req *);
 252         int (*term_IO) (struct dasd_ccw_req *);
 253         struct dasd_ccw_req *(*format_device) (struct dasd_device *,
 254                                                struct format_data_t *);
 255         int (*free_cp) (struct dasd_ccw_req *, struct request *);
 256         /*
 257          * Error recovery functions. examine_error() returns a value that
 258          * indicates what to do for an error condition. If examine_error()
 259          * returns 'dasd_era_recover' erp_action() is called to create a
 260          * special error recovery ccw. erp_postaction() is called after
 261          * an error recovery ccw has finished its execution. dump_sense
 262          * is called for every error condition to print the sense data
 263          * to the console.
 264          */
 265         dasd_era_t(*examine_error) (struct dasd_ccw_req *, struct irb *);
 266         dasd_erp_fn_t(*erp_action) (struct dasd_ccw_req *);
 267         dasd_erp_fn_t(*erp_postaction) (struct dasd_ccw_req *);
 268         void (*dump_sense) (struct dasd_device *, struct dasd_ccw_req *,
 269                             struct irb *);
 270
 271         /* i/o control functions. */
 272         int (*fill_geometry) (struct dasd_device *, struct hd_geometry *);
 273         int (*fill_info) (struct dasd_device *, struct dasd_information2_t *);
 274 };
 275
 276 extern struct dasd_discipline *dasd_diag_discipline_pointer;
 277
 278 struct dasd_device {
 279         /* Block device stuff. */
 280         struct gendisk *gdp;
 281         request_queue_t *request_queue;
 282         spinlock_t request_queue_lock;
 283         struct block_device *bdev;
 284         unsigned int devindex;
 285         unsigned long blocks;           /* size of volume in blocks */
 286         unsigned int bp_block;          /* bytes per block */
 287         unsigned int s2b_shift;         /* log2 (bp_block/512) */
 288         unsigned long flags;            /* per device flags */
 289         unsigned short features;        /* copy of devmap-features (read-only!) */
 290
 291         /* Device discipline stuff. */
 292         struct dasd_discipline *discipline;
 293         struct dasd_discipline *base_discipline;
 294         char *private;
 295
 296         /* Device state and target state. */
 297         int state, target;
 298         int stopped;            /* device (ccw_device_start) was stopped */
 299
 300         /* Open and reference count. */
 301         atomic_t ref_count;
 302         atomic_t open_count;
 303
 304         /* ccw queue and memory for static ccw/erp buffers. */
 305         struct list_head ccw_queue;
 306         spinlock_t mem_lock;
 307         void *ccw_mem;
 308         void *erp_mem;
 309         struct list_head ccw_chunks;
 310         struct list_head erp_chunks;
 311
 312         atomic_t tasklet_scheduled;
 313         struct tasklet_struct tasklet;
 314         struct work_struct kick_work;
 315         struct timer_list timer;
 316
 317         debug_info_t *debug_area;
 318
 319         struct ccw_device *cdev;
 320
 321 #ifdef CONFIG_DASD_PROFILE
 322         struct dasd_profile_info_t profile;
 323 #endif
 324 };
 325
 326 /* reasons why device (ccw_device_start) was stopped */
 327 #define DASD_STOPPED_NOT_ACC 1         /* not accessible */
 328 #define DASD_STOPPED_QUIESCE 2         /* Quiesced */
 329 #define DASD_STOPPED_PENDING 4         /* long busy */
 330 #define DASD_STOPPED_DC_WAIT 8         /* disconnected, wait */
 331 #define DASD_STOPPED_DC_EIO  16        /* disconnected, return -EIO */
 332
 333 /* per device flags */
 334 #define DASD_FLAG_DSC_ERROR     2       /* return -EIO when disconnected */
 335 #define DASD_FLAG_OFFLINE       3       /* device is in offline processing */
 336
 337 void dasd_put_device_wake(struct dasd_device *);
 338
 339 /*
 340  * Reference count inliners
 341  */
 342 static inline void
 343 dasd_get_device(struct dasd_device *device)
 344 {
 345         atomic_inc(&device->ref_count);
 346 }
 347
 348 static inline void
 349 dasd_put_device(struct dasd_device *device)
 350 {
 351         if (atomic_dec_return(&device->ref_count) == 0)
 352                 dasd_put_device_wake(device);
 353 }
 354
 355 /*
 356  * The static memory in ccw_mem and erp_mem is managed by a sorted
 357  * list of free memory chunks.
 358  */
 359 struct dasd_mchunk
 360 {
 361         struct list_head list;
 362         unsigned long size;
 363 } __attribute__ ((aligned(8)));
 364
 365 static inline void
 366 dasd_init_chunklist(struct list_head *chunk_list, void *mem,
 367                     unsigned long size)
 368 {
 369         struct dasd_mchunk *chunk;
 370
 371         INIT_LIST_HEAD(chunk_list);
 372         chunk = (struct dasd_mchunk *) mem;
 373         chunk->size = size - sizeof(struct dasd_mchunk);
 374         list_add(&chunk->list, chunk_list);
 375 }
 376
 377 static inline void *
 378 dasd_alloc_chunk(struct list_head *chunk_list, unsigned long size)
 379 {
 380         struct dasd_mchunk *chunk, *tmp;
 381
 382         size = (size + 7L) & -8L;
 383         list_for_each_entry(chunk, chunk_list, list) {
 384                 if (chunk->size < size)
 385                         continue;
 386                 if (chunk->size > size + sizeof(struct dasd_mchunk)) {
 387                         char *endaddr = (char *) (chunk + 1) + chunk->size;
 388                         tmp = (struct dasd_mchunk *) (endaddr - size) - 1;
 389                         tmp->size = size;
 390                         chunk->size -= size + sizeof(struct dasd_mchunk);
 391                         chunk = tmp;
 392                 } else
 393                         list_del(&chunk->list);
 394                 return (void *) (chunk + 1);
 395         }
 396         return NULL;
 397 }
 398
 399 static inline void
 400 dasd_free_chunk(struct list_head *chunk_list, void *mem)
 401 {
 402         struct dasd_mchunk *chunk, *tmp;
 403         struct list_head *p, *left;
 404
 405         chunk = (struct dasd_mchunk *)
 406                 ((char *) mem - sizeof(struct dasd_mchunk));
 407         /* Find out the left neighbour in chunk_list. */
 408         left = chunk_list;
 409         list_for_each(p, chunk_list) {
 410                 if (list_entry(p, struct dasd_mchunk, list) > chunk)
 411                         break;
 412                 left = p;
 413         }
 414         /* Try to merge with right neighbour = next element from left. */
 415         if (left->next != chunk_list) {
 416                 tmp = list_entry(left->next, struct dasd_mchunk, list);
 417                 if ((char *) (chunk + 1) + chunk->size == (char *) tmp) {
 418                         list_del(&tmp->list);
 419                         chunk->size += tmp->size + sizeof(struct dasd_mchunk);
 420                 }
 421         }
 422         /* Try to merge with left neighbour. */
 423         if (left != chunk_list) {
 424                 tmp = list_entry(left, struct dasd_mchunk, list);
 425                 if ((char *) (tmp + 1) + tmp->size == (char *) chunk) {
 426                         tmp->size += chunk->size + sizeof(struct dasd_mchunk);
 427                         return;
 428                 }
 429         }
 430         __list_add(&chunk->list, left, left->next);
 431 }
 432
 433 /*
 434  * Check if bsize is in { 512, 1024, 2048, 4096 }
 435  */
 436 static inline int
 437 dasd_check_blocksize(int bsize)
 438 {
 439         if (bsize < 512 || bsize > 4096 || (bsize & (bsize - 1)) != 0)
 440                 return -EMEDIUMTYPE;
 441         return 0;
 442 }
 443
 444 /* externals in dasd.c */
 445 #define DASD_PROFILE_ON  1
 446 #define DASD_PROFILE_OFF 0
 447
 448 extern debug_info_t *dasd_debug_area;
 449 extern struct dasd_profile_info_t dasd_global_profile;
 450 extern unsigned int dasd_profile_level;
 451 extern struct block_device_operations dasd_device_operations;
 452
 453 extern kmem_cache_t *dasd_page_cache;
 454
 455 struct dasd_ccw_req *
 456 dasd_kmalloc_request(char *, int, int, struct dasd_device *);
 457 struct dasd_ccw_req *
 458 dasd_smalloc_request(char *, int, int, struct dasd_device *);
 459 void dasd_kfree_request(struct dasd_ccw_req *, struct dasd_device *);
 460 void dasd_sfree_request(struct dasd_ccw_req *, struct dasd_device *);
 461
 462 static inline int
 463 dasd_kmalloc_set_cda(struct ccw1 *ccw, void *cda, struct dasd_device *device)
 464 {
 465         return set_normalized_cda(ccw, cda);
 466 }
 467
 468 struct dasd_device *dasd_alloc_device(void);
 469 void dasd_free_device(struct dasd_device *);
 470
 471 void dasd_enable_device(struct dasd_device *);
 472 void dasd_set_target_state(struct dasd_device *, int);
 473 void dasd_kick_device(struct dasd_device *);
 474
 475 void dasd_add_request_head(struct dasd_ccw_req *);
 476 void dasd_add_request_tail(struct dasd_ccw_req *);
 477 int  dasd_start_IO(struct dasd_ccw_req *);
 478 int  dasd_term_IO(struct dasd_ccw_req *);
 479 void dasd_schedule_bh(struct dasd_device *);
 480 int  dasd_sleep_on(struct dasd_ccw_req *);
 481 int  dasd_sleep_on_immediatly(struct dasd_ccw_req *);
 482 int  dasd_sleep_on_interruptible(struct dasd_ccw_req *);
 483 void dasd_set_timer(struct dasd_device *, int);
 484 void dasd_clear_timer(struct dasd_device *);
 485 int  dasd_cancel_req(struct dasd_ccw_req *);
 486 int dasd_generic_probe (struct ccw_device *, struct dasd_discipline *);
 487 void dasd_generic_remove (struct ccw_device *cdev);
 488 int dasd_generic_set_online(struct ccw_device *, struct dasd_discipline *);
 489 int dasd_generic_set_offline (struct ccw_device *cdev);
 490 int dasd_generic_notify(struct ccw_device *, int);
 491 void dasd_generic_auto_online (struct ccw_driver *);
 492
 493 /* externals in dasd_devmap.c */
 494 extern int dasd_max_devindex;
 495 extern int dasd_probeonly;
 496 extern int dasd_autodetect;
 497
 498 int dasd_devmap_init(void);
 499 void dasd_devmap_exit(void);
 500
 501 struct dasd_device *dasd_create_device(struct ccw_device *);
 502 void dasd_delete_device(struct dasd_device *);
 503
 504 int dasd_get_feature(struct ccw_device *, int);
 505 int dasd_set_feature(struct ccw_device *, int, int);
 506
 507 int dasd_add_sysfs_files(struct ccw_device *);
 508 void dasd_remove_sysfs_files(struct ccw_device *);
 509
 510 struct dasd_device *dasd_device_from_cdev(struct ccw_device *);
 511 struct dasd_device *dasd_device_from_devindex(int);
 512
 513 int dasd_parse(void);
 514 int dasd_busid_known(char *);
 515
 516 /* externals in dasd_gendisk.c */
 517 int  dasd_gendisk_init(void);
 518 void dasd_gendisk_exit(void);
 519 int dasd_gendisk_alloc(struct dasd_device *);
 520 void dasd_gendisk_free(struct dasd_device *);
 521 int dasd_scan_partitions(struct dasd_device *);
 522 void dasd_destroy_partitions(struct dasd_device *);
 523
 524 /* externals in dasd_ioctl.c */
 525 int  dasd_ioctl_init(void);
 526 void dasd_ioctl_exit(void);
 527 int  dasd_ioctl_no_register(struct module *, int, dasd_ioctl_fn_t);
 528 int  dasd_ioctl_no_unregister(struct module *, int, dasd_ioctl_fn_t);
 529 int  dasd_ioctl(struct inode *, struct file *, unsigned int, unsigned long);
 530 long dasd_compat_ioctl(struct file *, unsigned int, unsigned long);
 531
 532 /* externals in dasd_proc.c */
 533 int dasd_proc_init(void);
 534 void dasd_proc_exit(void);
 535
 536 /* externals in dasd_erp.c */
 537 struct dasd_ccw_req *dasd_default_erp_action(struct dasd_ccw_req *);
 538 struct dasd_ccw_req *dasd_default_erp_postaction(struct dasd_ccw_req *);
 539 struct dasd_ccw_req *dasd_alloc_erp_request(char *, int, int,
 540                                             struct dasd_device *);
 541 void dasd_free_erp_request(struct dasd_ccw_req *, struct dasd_device *);
 542 void dasd_log_sense(struct dasd_ccw_req *, struct irb *);
 543 void dasd_log_ccw(struct dasd_ccw_req *, int, __u32);
 544
 545 /* externals in dasd_3370_erp.c */
 546 dasd_era_t dasd_3370_erp_examine(struct dasd_ccw_req *, struct irb *);
 547
 548 /* externals in dasd_3990_erp.c */
 549 dasd_era_t dasd_3990_erp_examine(struct dasd_ccw_req *, struct irb *);
 550 struct dasd_ccw_req *dasd_3990_erp_action(struct dasd_ccw_req *);
 551
 552 /* externals in dasd_9336_erp.c */
 553 dasd_era_t dasd_9336_erp_examine(struct dasd_ccw_req *, struct irb *);
 554
 555 /* externals in dasd_9336_erp.c */
 556 dasd_era_t dasd_9343_erp_examine(struct dasd_ccw_req *, struct irb *);
 557 struct dasd_ccw_req *dasd_9343_erp_action(struct dasd_ccw_req *);
 558
 559 #endif                          /* __KERNEL__ */
 560
 561 #endif                          /* DASD_H */
 562
 563 /*
 564  * Overrides for Emacs so that we follow Linus's tabbing style.
 565  * Emacs will notice this stuff at the end of the file and automatically
 566  * adjust the settings for this buffer only.  This must remain at the end
 567  * of the file.
 568  * ---------------------------------------------------------------------------
 569  * Local variables:
 570  * c-indent-level: 4
 571  * c-brace-imaginary-offset: 0
 572  * c-brace-offset: -4
 573  * c-argdecl-indent: 4
 574  * c-label-offset: -4
 575  * c-continued-statement-offset: 4
 576  * c-continued-brace-offset: 0
 577  * indent-tabs-mode: 1
 578  * tab-width: 8
 579  * End:
 580  */