← Back to branch summary

~ubuntu-branches/ubuntu/precise/linux-ti-omap4/precise-security

« back to all changes in this revision

Viewing changes to include/linux/fsl_hypervisor.h

  • Committer: Package Import Robot
  • Author(s): Paolo Pisati, Paolo Pisati
  • Date: 2011-12-06 15:56:07 UTC
  • Revision ID: package-import@ubuntu.com-20111206155607-pcf44kv5fmhk564f
Tags: 3.2.0-1401.1
[ Paolo Pisati ]

* Rebased on top of Ubuntu-3.2.0-3.8
* Tilt-tracking @ ef2487af4bb15bdd0689631774b5a5e3a59f74e2
* Delete debian.ti-omap4/control, it shoudln't be tracked
* Fix architecture spelling (s/armel/armhf/)
* [Config] Update configs following 3.2 import
* [Config] Fix compilation: disable CODA and ARCH_OMAP3
* [Config] Fix compilation: disable Ethernet Faraday
* Update series to precise

Show diffs side-by-side

added added

removed removed

Lines of Context:
include/linux/fsl_hypervisor.h
 
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 FSL_HYPERVISOR_H
 
41
#define FSL_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
#ifdef __KERNEL__
 
220
 
 
221
/**
 
222
 * fsl_hv_event_register() - register a callback for failover events
 
223
 * @nb: pointer to caller-supplied notifier_block structure
 
224
 *
 
225
 * This function is called by device drivers to register their callback
 
226
 * functions for fail-over events.
 
227
 *
 
228
 * The caller should allocate a notifier_block object and initialize the
 
229
 * 'priority' and 'notifier_call' fields.
 
230
 */
 
231
int fsl_hv_failover_register(struct notifier_block *nb);
 
232
 
 
233
/**
 
234
 * fsl_hv_event_unregister() - unregister a callback for failover events
 
235
 * @nb: the same 'nb' used in previous fsl_hv_failover_register call
 
236
 */
 
237
int fsl_hv_failover_unregister(struct notifier_block *nb);
 
238
 
 
239
#endif
 
240
 
 
241
#endif