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