diff options
Diffstat (limited to 'include/uapi/linux/fsl_hypervisor.h')
| -rw-r--r-- | include/uapi/linux/fsl_hypervisor.h | 220 |
1 files changed, 220 insertions, 0 deletions
diff --git a/include/uapi/linux/fsl_hypervisor.h b/include/uapi/linux/fsl_hypervisor.h new file mode 100644 index 000000000000..1bf04967fec4 --- /dev/null +++ b/include/uapi/linux/fsl_hypervisor.h | |||
| @@ -0,0 +1,220 @@ | |||
| 1 | /* | ||
| 2 | * Freescale hypervisor ioctl and kernel interface | ||
| 3 | * | ||
| 4 | * Copyright (C) 2008-2011 Freescale Semiconductor, Inc. | ||
| 5 | * Author: Timur Tabi <timur@freescale.com> | ||
| 6 | * | ||
| 7 | * Redistribution and use in source and binary forms, with or without | ||
| 8 | * modification, are permitted provided that the following conditions are met: | ||
| 9 | * * Redistributions of source code must retain the above copyright | ||
| 10 | * notice, this list of conditions and the following disclaimer. | ||
| 11 | * * Redistributions in binary form must reproduce the above copyright | ||
| 12 | * notice, this list of conditions and the following disclaimer in the | ||
| 13 | * documentation and/or other materials provided with the distribution. | ||
| 14 | * * Neither the name of Freescale Semiconductor nor the | ||
| 15 | * names of its contributors may be used to endorse or promote products | ||
| 16 | * derived from this software without specific prior written permission. | ||
| 17 | * | ||
| 18 | * | ||
| 19 | * ALTERNATIVELY, this software may be distributed under the terms of the | ||
| 20 | * GNU General Public License ("GPL") as published by the Free Software | ||
| 21 | * Foundation, either version 2 of that License or (at your option) any | ||
| 22 | * later version. | ||
| 23 | * | ||
| 24 | * This software is provided by Freescale Semiconductor "as is" and any | ||
| 25 | * express or implied warranties, including, but not limited to, the implied | ||
| 26 | * warranties of merchantability and fitness for a particular purpose are | ||
| 27 | * disclaimed. In no event shall Freescale Semiconductor be liable for any | ||
| 28 | * direct, indirect, incidental, special, exemplary, or consequential damages | ||
| 29 | * (including, but not limited to, procurement of substitute goods or services; | ||
| 30 | * loss of use, data, or profits; or business interruption) however caused and | ||
| 31 | * on any theory of liability, whether in contract, strict liability, or tort | ||
| 32 | * (including negligence or otherwise) arising in any way out of the use of this | ||
| 33 | * software, even if advised of the possibility of such damage. | ||
| 34 | * | ||
| 35 | * This file is used by the Freescale hypervisor management driver. It can | ||
| 36 | * also be included by applications that need to communicate with the driver | ||
| 37 | * via the ioctl interface. | ||
| 38 | */ | ||
| 39 | |||
| 40 | #ifndef _UAPIFSL_HYPERVISOR_H | ||
| 41 | #define _UAPIFSL_HYPERVISOR_H | ||
| 42 | |||
| 43 | #include <linux/types.h> | ||
| 44 | |||
| 45 | /** | ||
| 46 | * struct fsl_hv_ioctl_restart - restart a partition | ||
| 47 | * @ret: return error code from the hypervisor | ||
| 48 | * @partition: the ID of the partition to restart, or -1 for the | ||
| 49 | * calling partition | ||
| 50 | * | ||
| 51 | * Used by FSL_HV_IOCTL_PARTITION_RESTART | ||
| 52 | */ | ||
| 53 | struct fsl_hv_ioctl_restart { | ||
| 54 | __u32 ret; | ||
| 55 | __u32 partition; | ||
| 56 | }; | ||
| 57 | |||
| 58 | /** | ||
| 59 | * struct fsl_hv_ioctl_status - get a partition's status | ||
| 60 | * @ret: return error code from the hypervisor | ||
| 61 | * @partition: the ID of the partition to query, or -1 for the | ||
| 62 | * calling partition | ||
| 63 | * @status: The returned status of the partition | ||
| 64 | * | ||
| 65 | * Used by FSL_HV_IOCTL_PARTITION_GET_STATUS | ||
| 66 | * | ||
| 67 | * Values of 'status': | ||
| 68 | * 0 = Stopped | ||
| 69 | * 1 = Running | ||
| 70 | * 2 = Starting | ||
| 71 | * 3 = Stopping | ||
| 72 | */ | ||
| 73 | struct fsl_hv_ioctl_status { | ||
| 74 | __u32 ret; | ||
| 75 | __u32 partition; | ||
| 76 | __u32 status; | ||
| 77 | }; | ||
| 78 | |||
| 79 | /** | ||
| 80 | * struct fsl_hv_ioctl_start - start a partition | ||
| 81 | * @ret: return error code from the hypervisor | ||
| 82 | * @partition: the ID of the partition to control | ||
| 83 | * @entry_point: The offset within the guest IMA to start execution | ||
| 84 | * @load: If non-zero, reload the partition's images before starting | ||
| 85 | * | ||
| 86 | * Used by FSL_HV_IOCTL_PARTITION_START | ||
| 87 | */ | ||
| 88 | struct fsl_hv_ioctl_start { | ||
| 89 | __u32 ret; | ||
| 90 | __u32 partition; | ||
| 91 | __u32 entry_point; | ||
| 92 | __u32 load; | ||
| 93 | }; | ||
| 94 | |||
| 95 | /** | ||
| 96 | * struct fsl_hv_ioctl_stop - stop a partition | ||
| 97 | * @ret: return error code from the hypervisor | ||
| 98 | * @partition: the ID of the partition to stop, or -1 for the calling | ||
| 99 | * partition | ||
| 100 | * | ||
| 101 | * Used by FSL_HV_IOCTL_PARTITION_STOP | ||
| 102 | */ | ||
| 103 | struct fsl_hv_ioctl_stop { | ||
| 104 | __u32 ret; | ||
| 105 | __u32 partition; | ||
| 106 | }; | ||
| 107 | |||
| 108 | /** | ||
| 109 | * struct fsl_hv_ioctl_memcpy - copy memory between partitions | ||
| 110 | * @ret: return error code from the hypervisor | ||
| 111 | * @source: the partition ID of the source partition, or -1 for this | ||
| 112 | * partition | ||
| 113 | * @target: the partition ID of the target partition, or -1 for this | ||
| 114 | * partition | ||
| 115 | * @reserved: reserved, must be set to 0 | ||
| 116 | * @local_addr: user-space virtual address of a buffer in the local | ||
| 117 | * partition | ||
| 118 | * @remote_addr: guest physical address of a buffer in the | ||
| 119 | * remote partition | ||
| 120 | * @count: the number of bytes to copy. Both the local and remote | ||
| 121 | * buffers must be at least 'count' bytes long | ||
| 122 | * | ||
| 123 | * Used by FSL_HV_IOCTL_MEMCPY | ||
| 124 | * | ||
| 125 | * The 'local' partition is the partition that calls this ioctl. The | ||
| 126 | * 'remote' partition is a different partition. The data is copied from | ||
| 127 | * the 'source' paritition' to the 'target' partition. | ||
| 128 | * | ||
| 129 | * The buffer in the remote partition must be guest physically | ||
| 130 | * contiguous. | ||
| 131 | * | ||
| 132 | * This ioctl does not support copying memory between two remote | ||
| 133 | * partitions or within the same partition, so either 'source' or | ||
| 134 | * 'target' (but not both) must be -1. In other words, either | ||
| 135 | * | ||
| 136 | * source == local and target == remote | ||
| 137 | * or | ||
| 138 | * source == remote and target == local | ||
| 139 | */ | ||
| 140 | struct fsl_hv_ioctl_memcpy { | ||
| 141 | __u32 ret; | ||
| 142 | __u32 source; | ||
| 143 | __u32 target; | ||
| 144 | __u32 reserved; /* padding to ensure local_vaddr is aligned */ | ||
| 145 | __u64 local_vaddr; | ||
| 146 | __u64 remote_paddr; | ||
| 147 | __u64 count; | ||
| 148 | }; | ||
| 149 | |||
| 150 | /** | ||
| 151 | * struct fsl_hv_ioctl_doorbell - ring a doorbell | ||
| 152 | * @ret: return error code from the hypervisor | ||
| 153 | * @doorbell: the handle of the doorbell to ring doorbell | ||
| 154 | * | ||
| 155 | * Used by FSL_HV_IOCTL_DOORBELL | ||
| 156 | */ | ||
| 157 | struct fsl_hv_ioctl_doorbell { | ||
| 158 | __u32 ret; | ||
| 159 | __u32 doorbell; | ||
| 160 | }; | ||
| 161 | |||
| 162 | /** | ||
| 163 | * struct fsl_hv_ioctl_prop - get/set a device tree property | ||
| 164 | * @ret: return error code from the hypervisor | ||
| 165 | * @handle: handle of partition whose tree to access | ||
| 166 | * @path: virtual address of path name of node to access | ||
| 167 | * @propname: virtual address of name of property to access | ||
| 168 | * @propval: virtual address of property data buffer | ||
| 169 | * @proplen: Size of property data buffer | ||
| 170 | * @reserved: reserved, must be set to 0 | ||
| 171 | * | ||
| 172 | * Used by FSL_HV_IOCTL_DOORBELL | ||
| 173 | */ | ||
| 174 | struct fsl_hv_ioctl_prop { | ||
| 175 | __u32 ret; | ||
| 176 | __u32 handle; | ||
| 177 | __u64 path; | ||
| 178 | __u64 propname; | ||
| 179 | __u64 propval; | ||
| 180 | __u32 proplen; | ||
| 181 | __u32 reserved; /* padding to ensure structure is aligned */ | ||
| 182 | }; | ||
| 183 | |||
| 184 | /* The ioctl type, documented in ioctl-number.txt */ | ||
| 185 | #define FSL_HV_IOCTL_TYPE 0xAF | ||
| 186 | |||
| 187 | /* Restart another partition */ | ||
| 188 | #define FSL_HV_IOCTL_PARTITION_RESTART \ | ||
| 189 | _IOWR(FSL_HV_IOCTL_TYPE, 1, struct fsl_hv_ioctl_restart) | ||
| 190 | |||
| 191 | /* Get a partition's status */ | ||
| 192 | #define FSL_HV_IOCTL_PARTITION_GET_STATUS \ | ||
| 193 | _IOWR(FSL_HV_IOCTL_TYPE, 2, struct fsl_hv_ioctl_status) | ||
| 194 | |||
| 195 | /* Boot another partition */ | ||
| 196 | #define FSL_HV_IOCTL_PARTITION_START \ | ||
| 197 | _IOWR(FSL_HV_IOCTL_TYPE, 3, struct fsl_hv_ioctl_start) | ||
| 198 | |||
| 199 | /* Stop this or another partition */ | ||
| 200 | #define FSL_HV_IOCTL_PARTITION_STOP \ | ||
| 201 | _IOWR(FSL_HV_IOCTL_TYPE, 4, struct fsl_hv_ioctl_stop) | ||
| 202 | |||
| 203 | /* Copy data from one partition to another */ | ||
| 204 | #define FSL_HV_IOCTL_MEMCPY \ | ||
| 205 | _IOWR(FSL_HV_IOCTL_TYPE, 5, struct fsl_hv_ioctl_memcpy) | ||
| 206 | |||
| 207 | /* Ring a doorbell */ | ||
| 208 | #define FSL_HV_IOCTL_DOORBELL \ | ||
| 209 | _IOWR(FSL_HV_IOCTL_TYPE, 6, struct fsl_hv_ioctl_doorbell) | ||
| 210 | |||
| 211 | /* Get a property from another guest's device tree */ | ||
| 212 | #define FSL_HV_IOCTL_GETPROP \ | ||
| 213 | _IOWR(FSL_HV_IOCTL_TYPE, 7, struct fsl_hv_ioctl_prop) | ||
| 214 | |||
| 215 | /* Set a property in another guest's device tree */ | ||
| 216 | #define FSL_HV_IOCTL_SETPROP \ | ||
| 217 | _IOWR(FSL_HV_IOCTL_TYPE, 8, struct fsl_hv_ioctl_prop) | ||
| 218 | |||
| 219 | |||
| 220 | #endif /* _UAPIFSL_HYPERVISOR_H */ | ||
