11fde5734STony Krowiak /* SPDX-License-Identifier: GPL-2.0 */ 21fde5734STony Krowiak /* 31fde5734STony Krowiak * Private data and functions for adjunct processor VFIO matrix driver. 41fde5734STony Krowiak * 51fde5734STony Krowiak * Author(s): Tony Krowiak <akrowiak@linux.ibm.com> 665f06713STony Krowiak * Halil Pasic <pasic@linux.ibm.com> 7ec89b55eSPierre Morel * Pierre Morel <pmorel@linux.ibm.com> 81fde5734STony Krowiak * 91fde5734STony Krowiak * Copyright IBM Corp. 2018 101fde5734STony Krowiak */ 111fde5734STony Krowiak 121fde5734STony Krowiak #ifndef _VFIO_AP_PRIVATE_H_ 131fde5734STony Krowiak #define _VFIO_AP_PRIVATE_H_ 141fde5734STony Krowiak 151fde5734STony Krowiak #include <linux/types.h> 161fde5734STony Krowiak #include <linux/device.h> 171fde5734STony Krowiak #include <linux/mdev.h> 181fde5734STony Krowiak #include <linux/delay.h> 191fde5734STony Krowiak #include <linux/mutex.h> 20e5282de9SPierre Morel #include <linux/kvm_host.h> 21eb0feefdSJason Gunthorpe #include <linux/vfio.h> 221fde5734STony Krowiak 231fde5734STony Krowiak #include "ap_bus.h" 241fde5734STony Krowiak 251fde5734STony Krowiak #define VFIO_AP_MODULE_NAME "vfio_ap" 261fde5734STony Krowiak #define VFIO_AP_DRV_NAME "vfio_ap" 271fde5734STony Krowiak 281fde5734STony Krowiak /** 29*5ef4f710STony Krowiak * struct ap_matrix_dev - Contains the data for the matrix device. 30*5ef4f710STony Krowiak * 311fde5734STony Krowiak * @device: generic device structure associated with the AP matrix device 3265f06713STony Krowiak * @available_instances: number of mediated matrix devices that can be created 3365f06713STony Krowiak * @info: the struct containing the output from the PQAP(QCI) instruction 34*5ef4f710STony Krowiak * @mdev_list: the list of mediated matrix devices created 35*5ef4f710STony Krowiak * @lock: mutex for locking the AP matrix device. This lock will be 3665f06713STony Krowiak * taken every time we fiddle with state managed by the vfio_ap 3765f06713STony Krowiak * driver, be it using @mdev_list or writing the state of a 3865f06713STony Krowiak * single ap_matrix_mdev device. It's quite coarse but we don't 3965f06713STony Krowiak * expect much contention. 40*5ef4f710STony Krowiak * @vfio_ap_drv: the vfio_ap device driver 411fde5734STony Krowiak */ 421fde5734STony Krowiak struct ap_matrix_dev { 431fde5734STony Krowiak struct device device; 4465f06713STony Krowiak atomic_t available_instances; 4565f06713STony Krowiak struct ap_config_info info; 4665f06713STony Krowiak struct list_head mdev_list; 4765f06713STony Krowiak struct mutex lock; 4836360658SPierre Morel struct ap_driver *vfio_ap_drv; 491fde5734STony Krowiak }; 501fde5734STony Krowiak 511fde5734STony Krowiak extern struct ap_matrix_dev *matrix_dev; 521fde5734STony Krowiak 5365f06713STony Krowiak /** 54*5ef4f710STony Krowiak * struct ap_matrix - matrix of adapters, domains and control domains 5565f06713STony Krowiak * 5665f06713STony Krowiak * @apm_max: max adapter number in @apm 57*5ef4f710STony Krowiak * @apm: identifies the AP adapters in the matrix 5865f06713STony Krowiak * @aqm_max: max domain number in @aqm 59*5ef4f710STony Krowiak * @aqm: identifies the AP queues (domains) in the matrix 6065f06713STony Krowiak * @adm_max: max domain number in @adm 61*5ef4f710STony Krowiak * @adm: identifies the AP control domains in the matrix 62*5ef4f710STony Krowiak * 63*5ef4f710STony Krowiak * The AP matrix is comprised of three bit masks identifying the adapters, 64*5ef4f710STony Krowiak * queues (domains) and control domains that belong to an AP matrix. The bits in 65*5ef4f710STony Krowiak * each mask, from left to right, correspond to IDs 0 to 255. When a bit is set 66*5ef4f710STony Krowiak * the corresponding ID belongs to the matrix. 6765f06713STony Krowiak */ 6865f06713STony Krowiak struct ap_matrix { 6965f06713STony Krowiak unsigned long apm_max; 7065f06713STony Krowiak DECLARE_BITMAP(apm, 256); 7165f06713STony Krowiak unsigned long aqm_max; 7265f06713STony Krowiak DECLARE_BITMAP(aqm, 256); 7365f06713STony Krowiak unsigned long adm_max; 7465f06713STony Krowiak DECLARE_BITMAP(adm, 256); 7565f06713STony Krowiak }; 7665f06713STony Krowiak 7765f06713STony Krowiak /** 78*5ef4f710STony Krowiak * struct ap_matrix_mdev - Contains the data associated with a matrix mediated 79*5ef4f710STony Krowiak * device. 80*5ef4f710STony Krowiak * @vdev: the vfio device 81*5ef4f710STony Krowiak * @node: allows the ap_matrix_mdev struct to be added to a list 8265f06713STony Krowiak * @matrix: the adapters, usage domains and control domains assigned to the 8365f06713STony Krowiak * mediated matrix device. 84258287c9STony Krowiak * @group_notifier: notifier block used for specifying callback function for 85258287c9STony Krowiak * handling the VFIO_GROUP_NOTIFY_SET_KVM event 86*5ef4f710STony Krowiak * @iommu_notifier: notifier block used for specifying callback function for 87*5ef4f710STony Krowiak * handling the VFIO_IOMMU_NOTIFY_DMA_UNMAP even 88258287c9STony Krowiak * @kvm: the struct holding guest's state 89*5ef4f710STony Krowiak * @pqap_hook: the function pointer to the interception handler for the 90*5ef4f710STony Krowiak * PQAP(AQIC) instruction. 91*5ef4f710STony Krowiak * @mdev: the mediated device 9265f06713STony Krowiak */ 9365f06713STony Krowiak struct ap_matrix_mdev { 94eb0feefdSJason Gunthorpe struct vfio_device vdev; 9565f06713STony Krowiak struct list_head node; 9665f06713STony Krowiak struct ap_matrix matrix; 97258287c9STony Krowiak struct notifier_block group_notifier; 9862e358ceSPierre Morel struct notifier_block iommu_notifier; 99258287c9STony Krowiak struct kvm *kvm; 1001e753732STony Krowiak crypto_hook pqap_hook; 10162e358ceSPierre Morel struct mdev_device *mdev; 10265f06713STony Krowiak }; 10365f06713STony Krowiak 104*5ef4f710STony Krowiak /** 105*5ef4f710STony Krowiak * struct vfio_ap_queue - contains the data associated with a queue bound to the 106*5ef4f710STony Krowiak * vfio_ap device driver 107*5ef4f710STony Krowiak * @matrix_mdev: the matrix mediated device 108*5ef4f710STony Krowiak * @saved_pfn: the guest PFN pinned for the guest 109*5ef4f710STony Krowiak * @apqn: the APQN of the AP queue device 110*5ef4f710STony Krowiak * @saved_isc: the guest ISC registered with the GIB interface 111*5ef4f710STony Krowiak */ 112ec89b55eSPierre Morel struct vfio_ap_queue { 113ec89b55eSPierre Morel struct ap_matrix_mdev *matrix_mdev; 114ec89b55eSPierre Morel unsigned long saved_pfn; 115ec89b55eSPierre Morel int apqn; 116ec89b55eSPierre Morel #define VFIO_AP_ISC_INVALID 0xff 117ec89b55eSPierre Morel unsigned char saved_isc; 118ec89b55eSPierre Morel }; 1196c12a638STony Krowiak 1206c12a638STony Krowiak int vfio_ap_mdev_register(void); 1216c12a638STony Krowiak void vfio_ap_mdev_unregister(void); 1226c12a638STony Krowiak int vfio_ap_mdev_reset_queue(struct vfio_ap_queue *q, 1236c12a638STony Krowiak unsigned int retry); 1246c12a638STony Krowiak 1251fde5734STony Krowiak #endif /* _VFIO_AP_PRIVATE_H_ */ 126