xref: /linux/include/uapi/linux/vfio_zdev.h (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  * VFIO Region definitions for ZPCI devices
4  *
5  * Copyright IBM Corp. 2020
6  *
7  * Author(s): Pierre Morel <pmorel@linux.ibm.com>
8  *            Matthew Rosato <mjrosato@linux.ibm.com>
9  */
10 
11 #ifndef _VFIO_ZDEV_H_
12 #define _VFIO_ZDEV_H_
13 
14 #include <linux/types.h>
15 #include <linux/vfio.h>
16 
17 /**
18  * VFIO_DEVICE_INFO_CAP_ZPCI_BASE - Base PCI Function information
19  *
20  * This capability provides a set of descriptive information about the
21  * associated PCI function.
22  */
23 struct vfio_device_info_cap_zpci_base {
24 	struct vfio_info_cap_header header;
25 	__u64 start_dma;	/* Start of available DMA addresses */
26 	__u64 end_dma;		/* End of available DMA addresses */
27 	__u16 pchid;		/* Physical Channel ID */
28 	__u16 vfn;		/* Virtual function number */
29 	__u16 fmb_length;	/* Measurement Block Length (in bytes) */
30 	__u8 pft;		/* PCI Function Type */
31 	__u8 gid;		/* PCI function group ID */
32 	/* End of version 1 */
33 	__u32 fh;		/* PCI function handle */
34 	/* End of version 2 */
35 };
36 
37 /**
38  * VFIO_DEVICE_INFO_CAP_ZPCI_GROUP - Base PCI Function Group information
39  *
40  * This capability provides a set of descriptive information about the group of
41  * PCI functions that the associated device belongs to.
42  */
43 struct vfio_device_info_cap_zpci_group {
44 	struct vfio_info_cap_header header;
45 	__u64 dasm;		/* DMA Address space mask */
46 	__u64 msi_addr;		/* MSI address */
47 	__u64 flags;
48 #define VFIO_DEVICE_INFO_ZPCI_FLAG_REFRESH 1 /* Program-specified TLB refresh */
49 	__u16 mui;		/* Measurement Block Update Interval */
50 	__u16 noi;		/* Maximum number of MSIs */
51 	__u16 maxstbl;		/* Maximum Store Block Length */
52 	__u8 version;		/* Supported PCI Version */
53 	/* End of version 1 */
54 	__u8 reserved;
55 	__u16 imaxstbl;		/* Maximum Interpreted Store Block Length */
56 	/* End of version 2 */
57 };
58 
59 /**
60  * VFIO_DEVICE_INFO_CAP_ZPCI_UTIL - Utility String
61  *
62  * This capability provides the utility string for the associated device, which
63  * is a device identifier string made up of EBCDID characters.  'size' specifies
64  * the length of 'util_str'.
65  */
66 struct vfio_device_info_cap_zpci_util {
67 	struct vfio_info_cap_header header;
68 	__u32 size;
69 	__u8 util_str[];
70 };
71 
72 /**
73  * VFIO_DEVICE_INFO_CAP_ZPCI_PFIP - PCI Function Path
74  *
75  * This capability provides the PCI function path string, which is an identifier
76  * that describes the internal hardware path of the device. 'size' specifies
77  * the length of 'pfip'.
78  */
79 struct vfio_device_info_cap_zpci_pfip {
80 	struct vfio_info_cap_header header;
81 	__u32 size;
82 	__u8 pfip[];
83 };
84 
85 #endif
86