• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 */
221