xref: /illumos-gate/usr/src/uts/intel/io/vmm/io/iommu.h (revision fdad6fbf87b201fdb96a704fc41fa8be1e4efbc8)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2011 NetApp, Inc.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 /*
29  * This file and its contents are supplied under the terms of the
30  * Common Development and Distribution License ("CDDL"), version 1.0.
31  * You may only use this file in accordance with the terms of version
32  * 1.0 of the CDDL.
33  *
34  * A full copy of the text of the CDDL should have accompanied this
35  * source.  A copy of the CDDL is also available via the Internet at
36  * http://www.illumos.org/license/CDDL.
37  */
38 /* This file is dual-licensed; see usr/src/contrib/bhyve/LICENSE */
39 
40 /*
41  * Copyright 2022 Oxide Computer Company
42  */
43 
44 #ifndef _IO_IOMMU_H_
45 #define	_IO_IOMMU_H_
46 
47 typedef int (*iommu_init_func_t)(void);
48 typedef void (*iommu_cleanup_func_t)(void);
49 typedef void (*iommu_enable_func_t)(void);
50 typedef void (*iommu_disable_func_t)(void);
51 typedef void *(*iommu_create_domain_t)(vm_paddr_t maxaddr);
52 typedef void (*iommu_destroy_domain_t)(void *domain);
53 typedef uint64_t (*iommu_create_mapping_t)(void *domain, vm_paddr_t gpa,
54     vm_paddr_t hpa, uint64_t len);
55 typedef uint64_t (*iommu_remove_mapping_t)(void *domain, vm_paddr_t gpa,
56     uint64_t len);
57 typedef void (*iommu_add_device_t)(void *domain, uint16_t rid);
58 typedef void (*iommu_remove_device_t)(void *domain, uint16_t rid);
59 typedef void (*iommu_invalidate_tlb_t)(void *domain);
60 
61 struct iommu_ops {
62 	iommu_init_func_t	init;		/* module wide */
63 	iommu_cleanup_func_t	cleanup;
64 	iommu_enable_func_t	enable;
65 	iommu_disable_func_t	disable;
66 
67 	iommu_create_domain_t	create_domain;	/* domain-specific */
68 	iommu_destroy_domain_t	destroy_domain;
69 	iommu_create_mapping_t	create_mapping;
70 	iommu_remove_mapping_t	remove_mapping;
71 	iommu_add_device_t	add_device;
72 	iommu_remove_device_t	remove_device;
73 	iommu_invalidate_tlb_t	invalidate_tlb;
74 };
75 
76 #define	IOMMU_OPS_SYM_NAME	"vmm_iommu_ops"
77 
78 void *iommu_host_domain(void);
79 void *iommu_create_domain(vm_paddr_t maxaddr);
80 void iommu_destroy_domain(void *domain);
81 void iommu_create_mapping(void *domain, vm_paddr_t gpa, vm_paddr_t hpa,
82     size_t len);
83 void iommu_remove_mapping(void *domain, vm_paddr_t gpa, size_t len);
84 void iommu_add_device(void *domain, uint16_t rid);
85 void iommu_remove_device(void *domain, uint16_t rid);
86 void iommu_invalidate_tlb(void *domain);
87 
88 /* Glue functions used by iommu provider(s) */
89 void *vmm_ptp_alloc(void);
90 void vmm_ptp_free(void *);
91 
92 #endif
93