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