]> Pileus Git - ~andy/linux/blob - include/linux/amd-iommu.h
iommu/amd: Add routines to bind/unbind a pasid
[~andy/linux] / include / linux / amd-iommu.h
1 /*
2  * Copyright (C) 2007-2010 Advanced Micro Devices, Inc.
3  * Author: Joerg Roedel <joerg.roedel@amd.com>
4  *         Leo Duran <leo.duran@amd.com>
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of the GNU General Public License version 2 as published
8  * by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
18  */
19
20 #ifndef _ASM_X86_AMD_IOMMU_H
21 #define _ASM_X86_AMD_IOMMU_H
22
23 #include <linux/types.h>
24
25 #ifdef CONFIG_AMD_IOMMU
26
27 struct task_struct;
28 struct pci_dev;
29
30 extern int amd_iommu_detect(void);
31 extern int amd_iommu_bind_pasid(struct pci_dev *pdev, int pasid,
32                                 struct task_struct *task);
33 extern void amd_iommu_unbind_pasid(struct pci_dev *pdev, int pasid);
34
35
36 /**
37  * amd_iommu_enable_device_erratum() - Enable erratum workaround for device
38  *                                     in the IOMMUv2 driver
39  * @pdev: The PCI device the workaround is necessary for
40  * @erratum: The erratum workaround to enable
41  *
42  * The function needs to be called before amd_iommu_init_device().
43  * Possible values for the erratum number are for now:
44  * - AMD_PRI_DEV_ERRATUM_ENABLE_RESET - Reset PRI capability when PRI
45  *                                      is enabled
46  * - AMD_PRI_DEV_ERRATUM_LIMIT_REQ_ONE - Limit number of outstanding PRI
47  *                                       requests to one
48  */
49 #define AMD_PRI_DEV_ERRATUM_ENABLE_RESET                0
50 #define AMD_PRI_DEV_ERRATUM_LIMIT_REQ_ONE               1
51
52 extern void amd_iommu_enable_device_erratum(struct pci_dev *pdev, u32 erratum);
53
54 /**
55  * amd_iommu_init_device() - Init device for use with IOMMUv2 driver
56  * @pdev: The PCI device to initialize
57  * @pasids: Number of PASIDs to support for this device
58  *
59  * This function does all setup for the device pdev so that it can be
60  * used with IOMMUv2.
61  * Returns 0 on success or negative value on error.
62  */
63 extern int amd_iommu_init_device(struct pci_dev *pdev, int pasids);
64
65 /**
66  * amd_iommu_free_device() - Free all IOMMUv2 related device resources
67  *                           and disable IOMMUv2 usage for this device
68  * @pdev: The PCI device to disable IOMMUv2 usage for'
69  */
70 extern void amd_iommu_free_device(struct pci_dev *pdev);
71
72 /**
73  * amd_iommu_bind_pasid() - Bind a given task to a PASID on a device
74  * @pdev: The PCI device to bind the task to
75  * @pasid: The PASID on the device the task should be bound to
76  * @task: the task to bind
77  *
78  * The function returns 0 on success or a negative value on error.
79  */
80 extern int amd_iommu_bind_pasid(struct pci_dev *pdev, int pasid,
81                                 struct task_struct *task);
82
83 /**
84  * amd_iommu_unbind_pasid() - Unbind a PASID from its task on
85  *                            a device
86  * @pdev: The device of the PASID
87  * @pasid: The PASID to unbind
88  *
89  * When this function returns the device is no longer using the PASID
90  * and the PASID is no longer bound to its task.
91  */
92 extern void amd_iommu_unbind_pasid(struct pci_dev *pdev, int pasid);
93
94 #else
95
96 static inline int amd_iommu_detect(void) { return -ENODEV; }
97
98 #endif
99
100 #endif /* _ASM_X86_AMD_IOMMU_H */