1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Private stuff for vfio_ccw driver 4 * 5 * Copyright IBM Corp. 2017 6 * Copyright Red Hat, Inc. 2019 7 * 8 * Author(s): Dong Jia Shi <bjsdjshi@linux.vnet.ibm.com> 9 * Xiao Feng Ren <renxiaof@linux.vnet.ibm.com> 10 * Cornelia Huck <cohuck@redhat.com> 11 */ 12 13 #ifndef _VFIO_CCW_PRIVATE_H_ 14 #define _VFIO_CCW_PRIVATE_H_ 15 16 #include <linux/completion.h> 17 #include <linux/eventfd.h> 18 #include <linux/workqueue.h> 19 #include <linux/vfio_ccw.h> 20 #include <linux/vfio.h> 21 #include <linux/mdev.h> 22 #include <asm/crw.h> 23 #include <asm/debug.h> 24 25 #include "css.h" 26 #include "vfio_ccw_cp.h" 27 28 #define VFIO_CCW_OFFSET_SHIFT 10 29 #define VFIO_CCW_OFFSET_TO_INDEX(off) (off >> VFIO_CCW_OFFSET_SHIFT) 30 #define VFIO_CCW_INDEX_TO_OFFSET(index) ((u64)(index) << VFIO_CCW_OFFSET_SHIFT) 31 #define VFIO_CCW_OFFSET_MASK (((u64)(1) << VFIO_CCW_OFFSET_SHIFT) - 1) 32 33 /* capability chain handling similar to vfio-pci */ 34 struct vfio_ccw_private; 35 struct vfio_ccw_region; 36 37 struct vfio_ccw_regops { 38 ssize_t (*read)(struct vfio_ccw_private *private, char __user *buf, 39 size_t count, loff_t *ppos); 40 ssize_t (*write)(struct vfio_ccw_private *private, 41 const char __user *buf, size_t count, loff_t *ppos); 42 void (*release)(struct vfio_ccw_private *private, 43 struct vfio_ccw_region *region); 44 }; 45 46 struct vfio_ccw_region { 47 u32 type; 48 u32 subtype; 49 const struct vfio_ccw_regops *ops; 50 void *data; 51 size_t size; 52 u32 flags; 53 }; 54 55 int vfio_ccw_register_dev_region(struct vfio_ccw_private *private, 56 unsigned int subtype, 57 const struct vfio_ccw_regops *ops, 58 size_t size, u32 flags, void *data); 59 void vfio_ccw_unregister_dev_regions(struct vfio_ccw_private *private); 60 61 int vfio_ccw_register_async_dev_regions(struct vfio_ccw_private *private); 62 int vfio_ccw_register_schib_dev_regions(struct vfio_ccw_private *private); 63 int vfio_ccw_register_crw_dev_regions(struct vfio_ccw_private *private); 64 65 struct vfio_ccw_crw { 66 struct list_head next; 67 struct crw crw; 68 }; 69 70 /** 71 * struct vfio_ccw_parent 72 * 73 * @dev: embedded device struct 74 * @parent: parent data structures for mdevs created 75 * @mdev_type(s): identifying information for mdevs created 76 */ 77 struct vfio_ccw_parent { 78 struct device dev; 79 80 struct mdev_parent parent; 81 struct mdev_type mdev_type; 82 struct mdev_type *mdev_types[]; 83 }; 84 85 /** 86 * struct vfio_ccw_private 87 * @vdev: Embedded VFIO device 88 * @state: internal state of the device 89 * @completion: synchronization helper of the I/O completion 90 * @io_region: MMIO region to input/output I/O arguments/results 91 * @io_mutex: protect against concurrent update of I/O regions 92 * @region: additional regions for other subchannel operations 93 * @cmd_region: MMIO region for asynchronous I/O commands other than START 94 * @schib_region: MMIO region for SCHIB information 95 * @crw_region: MMIO region for getting channel report words 96 * @num_regions: number of additional regions 97 * @cp: channel program for the current I/O operation 98 * @irb: irb info received from interrupt 99 * @scsw: scsw info 100 * @io_trigger: eventfd ctx for signaling userspace I/O results 101 * @crw_trigger: eventfd ctx for signaling userspace CRW information 102 * @req_trigger: eventfd ctx for signaling userspace to return device 103 * @io_work: work for deferral process of I/O handling 104 * @crw_work: work for deferral process of CRW handling 105 */ 106 struct vfio_ccw_private { 107 struct vfio_device vdev; 108 int state; 109 struct completion *completion; 110 struct ccw_io_region *io_region; 111 struct mutex io_mutex; 112 struct vfio_ccw_region *region; 113 struct ccw_cmd_region *cmd_region; 114 struct ccw_schib_region *schib_region; 115 struct ccw_crw_region *crw_region; 116 int num_regions; 117 118 struct channel_program cp; 119 struct irb irb; 120 union scsw scsw; 121 struct list_head crw; 122 123 struct eventfd_ctx *io_trigger; 124 struct eventfd_ctx *crw_trigger; 125 struct eventfd_ctx *req_trigger; 126 struct work_struct io_work; 127 struct work_struct crw_work; 128 } __aligned(8); 129 130 int vfio_ccw_sch_quiesce(struct subchannel *sch); 131 void vfio_ccw_sch_io_todo(struct work_struct *work); 132 void vfio_ccw_crw_todo(struct work_struct *work); 133 134 extern struct mdev_driver vfio_ccw_mdev_driver; 135 136 /* 137 * States of the device statemachine. 138 */ 139 enum vfio_ccw_state { 140 VFIO_CCW_STATE_NOT_OPER, 141 VFIO_CCW_STATE_STANDBY, 142 VFIO_CCW_STATE_IDLE, 143 VFIO_CCW_STATE_CP_PROCESSING, 144 VFIO_CCW_STATE_CP_PENDING, 145 /* last element! */ 146 NR_VFIO_CCW_STATES 147 }; 148 149 /* 150 * Asynchronous events of the device statemachine. 151 */ 152 enum vfio_ccw_event { 153 VFIO_CCW_EVENT_NOT_OPER, 154 VFIO_CCW_EVENT_IO_REQ, 155 VFIO_CCW_EVENT_INTERRUPT, 156 VFIO_CCW_EVENT_ASYNC_REQ, 157 VFIO_CCW_EVENT_OPEN, 158 VFIO_CCW_EVENT_CLOSE, 159 /* last element! */ 160 NR_VFIO_CCW_EVENTS 161 }; 162 163 /* 164 * Action called through jumptable. 165 */ 166 typedef void (fsm_func_t)(struct vfio_ccw_private *, enum vfio_ccw_event); 167 extern fsm_func_t *vfio_ccw_jumptable[NR_VFIO_CCW_STATES][NR_VFIO_CCW_EVENTS]; 168 169 static inline void vfio_ccw_fsm_event(struct vfio_ccw_private *private, 170 enum vfio_ccw_event event) 171 { 172 struct subchannel *sch = to_subchannel(private->vdev.dev->parent); 173 174 if (sch) 175 trace_vfio_ccw_fsm_event(sch->schid, private->state, event); 176 vfio_ccw_jumptable[private->state][event](private, event); 177 } 178 179 extern struct workqueue_struct *vfio_ccw_work_q; 180 extern struct kmem_cache *vfio_ccw_io_region; 181 extern struct kmem_cache *vfio_ccw_cmd_region; 182 extern struct kmem_cache *vfio_ccw_schib_region; 183 extern struct kmem_cache *vfio_ccw_crw_region; 184 185 /* s390 debug feature, similar to base cio */ 186 extern debug_info_t *vfio_ccw_debug_msg_id; 187 extern debug_info_t *vfio_ccw_debug_trace_id; 188 189 #define VFIO_CCW_TRACE_EVENT(imp, txt) \ 190 debug_text_event(vfio_ccw_debug_trace_id, imp, txt) 191 192 #define VFIO_CCW_MSG_EVENT(imp, args...) \ 193 debug_sprintf_event(vfio_ccw_debug_msg_id, imp, ##args) 194 195 static inline void VFIO_CCW_HEX_EVENT(int level, void *data, int length) 196 { 197 debug_event(vfio_ccw_debug_trace_id, level, data, length); 198 } 199 200 #endif 201