drivers/s390/char/vmur.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Linux driver for System z and s390 unit record devices
   4  * (z/VM virtual punch, reader, printer)
   5  *
   6  * Copyright IBM Corp. 2001, 2007
   7  * Authors: Malcolm Beattie <beattiem@uk.ibm.com>
   8  *          Michael Holzheu <holzheu@de.ibm.com>
   9  *          Frank Munzert <munzert@de.ibm.com>
  10  */
  11
  12 #ifndef _VMUR_H_
  13 #define _VMUR_H_
  14
  15 #include <linux/refcount.h>
  16 #include <linux/workqueue.h>
  17
  18 #define DEV_CLASS_UR_I 0x20 /* diag210 unit record input device class */
  19 #define DEV_CLASS_UR_O 0x10 /* diag210 unit record output device class */
  20 /*
  21  * we only support z/VM's default unit record devices:
  22  * both in SPOOL directory control statement and in CP DEFINE statement
  23  *      RDR defaults to 2540 reader
  24  *      PUN defaults to 2540 punch
  25  *      PRT defaults to 1403 printer
  26  */
  27 #define READER_PUNCH_DEVTYPE    0x2540
  28 #define PRINTER_DEVTYPE         0x1403
  29
  30 /* z/VM spool file control block SFBLOK */
  31 struct file_control_block {
  32         char reserved_1[8];
  33         char user_owner[8];
  34         char user_orig[8];
  35         __s32 data_recs;
  36         __s16 rec_len;
  37         __s16 file_num;
  38         __u8  file_stat;
  39         __u8  dev_type;
  40         char  reserved_2[6];
  41         char  file_name[12];
  42         char  file_type[12];
  43         char  create_date[8];
  44         char  create_time[8];
  45         char  reserved_3[6];
  46         __u8  file_class;
  47         __u8  sfb_lok;
  48         __u64 distr_code;
  49         __u32 reserved_4;
  50         __u8  current_starting_copy_number;
  51         __u8  sfblock_cntrl_flags;
  52         __u8  reserved_5;
  53         __u8  more_status_flags;
  54         char  rest[200];
  55 } __attribute__ ((packed));
  56
  57 #define FLG_SYSTEM_HOLD 0x04
  58 #define FLG_CP_DUMP     0x10
  59 #define FLG_USER_HOLD   0x20
  60 #define FLG_IN_USE      0x80
  61
  62 /*
  63  * A struct urdev is created for each ur device that is made available
  64  * via the ccw_device driver model.
  65  */
  66 struct urdev {
  67         struct ccw_device *cdev;        /* Backpointer to ccw device */
  68         struct mutex io_mutex;          /* Serialises device IO */
  69         struct completion *io_done;     /* do_ur_io waits; irq completes */
  70         struct device *device;
  71         struct cdev *char_device;
  72         struct ccw_dev_id dev_id;       /* device id */
  73         size_t reclen;                  /* Record length for *write* CCWs */
  74         int class;                      /* VM device class */
  75         int io_request_rc;              /* return code from I/O request */
  76         refcount_t ref_count;           /* reference counter */
  77         wait_queue_head_t wait;         /* wait queue to serialize open */
  78         int open_flag;                  /* "urdev is open" flag */
  79         spinlock_t open_lock;           /* serialize critical sections */
  80         struct work_struct uevent_work; /* work to send uevent */
  81 };
  82
  83 /*
  84  * A struct urfile is allocated at open() time for each device and
  85  * freed on release().
  86  */
  87 struct urfile {
  88         struct urdev *urd;
  89         unsigned int flags;
  90         size_t dev_reclen;
  91         __u16 file_reclen;
  92 };
  93
  94 /*
  95  * Device major/minor definitions.
  96  */
  97
  98 #define UR_MAJOR 0      /* get dynamic major */
  99 /*
 100  * We map minor numbers directly to device numbers (0-FFFF) for simplicity.
 101  * This avoids having to allocate (and manage) slot numbers.
 102  */
 103 #define NUM_MINORS 65536
 104
 105 /* Limiting each I/O to 511 records limits chan prog to 4KB (511 r/w + 1 NOP) */
 106 #define MAX_RECS_PER_IO         511
 107 #define WRITE_CCW_CMD           0x01
 108
 109 #define TRACE(x...) debug_sprintf_event(vmur_dbf, 1, x)
 110 #define CCWDEV_CU_DI(cutype, di) \
 111                 CCW_DEVICE(cutype, 0x00), .driver_info = (di)
 112
 113 #define FILE_RECLEN_OFFSET      4064 /* reclen offset in spool data block */
 114
 115 #endif /* _VMUR_H_ */