xref: /illumos-gate/usr/src/uts/intel/io/vmm/io/iommu.h (revision 32640292)
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  * Copyright 2022 Oxide Computer Company
39  */
40 
41 #ifndef _IO_IOMMU_H_
42 #define	_IO_IOMMU_H_
43 
44 typedef int (*iommu_init_func_t)(void);
45 typedef void (*iommu_cleanup_func_t)(void);
46 typedef void (*iommu_enable_func_t)(void);
47 typedef void (*iommu_disable_func_t)(void);
48 typedef void *(*iommu_create_domain_t)(vm_paddr_t maxaddr);
49 typedef void (*iommu_destroy_domain_t)(void *domain);
50 typedef uint64_t (*iommu_create_mapping_t)(void *domain, vm_paddr_t gpa,
51     vm_paddr_t hpa, uint64_t len);
52 typedef uint64_t (*iommu_remove_mapping_t)(void *domain, vm_paddr_t gpa,
53     uint64_t len);
54 typedef void (*iommu_add_device_t)(void *domain, uint16_t rid);
55 typedef void (*iommu_remove_device_t)(void *domain, uint16_t rid);
56 typedef void (*iommu_invalidate_tlb_t)(void *domain);
57 
58 struct iommu_ops {
59 	iommu_init_func_t	init;		/* module wide */
60 	iommu_cleanup_func_t	cleanup;
61 	iommu_enable_func_t	enable;
62 	iommu_disable_func_t	disable;
63 
64 	iommu_create_domain_t	create_domain;	/* domain-specific */
65 	iommu_destroy_domain_t	destroy_domain;
66 	iommu_create_mapping_t	create_mapping;
67 	iommu_remove_mapping_t	remove_mapping;
68 	iommu_add_device_t	add_device;
69 	iommu_remove_device_t	remove_device;
70 	iommu_invalidate_tlb_t	invalidate_tlb;
71 };
72 
73 #define	IOMMU_OPS_SYM_NAME	"vmm_iommu_ops"
74 
75 void *iommu_host_domain(void);
76 void *iommu_create_domain(vm_paddr_t maxaddr);
77 void iommu_destroy_domain(void *domain);
78 void iommu_create_mapping(void *domain, vm_paddr_t gpa, vm_paddr_t hpa,
79     size_t len);
80 void iommu_remove_mapping(void *domain, vm_paddr_t gpa, size_t len);
81 void iommu_add_device(void *domain, uint16_t rid);
82 void iommu_remove_device(void *domain, uint16_t rid);
83 void iommu_invalidate_tlb(void *domain);
84 
85 /* Glue functions used by iommu provider(s) */
86 void *vmm_ptp_alloc(void);
87 void vmm_ptp_free(void *);
88 
89 #endif
90