1 /******************************************************************************
2  * privcmd.h
3  *
4  * Interface to /dev/xen/privcmd.
5  *
6  * Copyright (c) 2003-2005, K A Fraser
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License version 2
10  * as published by the Free Software Foundation; or, when distributed
11  * separately from the Linux kernel or incorporated into other
12  * software packages, subject to the following license:
13  *
14  * Permission is hereby granted, free of charge, to any person obtaining a copy
15  * of this source file (the "Software"), to deal in the Software without
16  * restriction, including without limitation the rights to use, copy, modify,
17  * merge, publish, distribute, sublicense, and/or sell copies of the Software,
18  * and to permit persons to whom the Software is furnished to do so, subject to
19  * the following conditions:
20  *
21  * The above copyright notice and this permission notice shall be included in
22  * all copies or substantial portions of the Software.
23  *
24  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
27  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
29  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
30  * IN THE SOFTWARE.
31  */
32 
33 #ifndef __XEN_PRIVCMD_H__
34 #define __XEN_PRIVCMD_H__
35 
36 struct ioctl_privcmd_hypercall
37 {
38 	unsigned long op; /* hypercall number */
39 	unsigned long arg[5]; /* arguments */
40 	long retval; /* return value */
41 };
42 typedef struct ioctl_privcmd_hypercall privcmd_hypercall_t;
43 
44 struct ioctl_privcmd_mmapbatch {
45 	int num;     /* number of pages to populate */
46 	domid_t dom; /* target domain */
47 	unsigned long addr;  /* virtual address */
48 	const xen_pfn_t *arr; /* array of mfns */
49 	int *err; /* array of error codes */
50 };
51 typedef struct ioctl_privcmd_mmapbatch privcmd_mmapbatch_t;
52 
53 typedef struct privcmd_mmap_entry {
54 	unsigned long va;
55 	unsigned long mfn;
56 	unsigned long npages;
57 } privcmd_mmap_entry_t;
58 
59 struct ioctl_privcmd_mmapresource {
60 	domid_t dom; /* target domain */
61 	unsigned int type; /* type of resource to map */
62 	unsigned int id; /* type-specific resource identifier */
63 	unsigned int idx; /* the index of the initial frame to be mapped */
64 	unsigned long num; /* number of frames of the resource to be mapped */
65 	unsigned long addr; /* physical address to map into */
66 };
67 typedef struct ioctl_privcmd_mmapresource privcmd_mmap_resource_t;
68 
69 struct privcmd_dmop_buf {
70 	void *uptr; /* pointer to memory (in calling process) */
71 	size_t size; /* size of the buffer */
72 };
73 typedef struct privcmd_dmop_buf privcmd_dm_op_buf_t;
74 
75 struct ioctl_privcmd_dmop {
76 	domid_t dom; /* target domain */
77 	unsigned int num; /* num of buffers */
78 	const struct privcmd_dmop_buf *ubufs; /* array of buffers */
79 };
80 typedef struct ioctl_privcmd_dmop privcmd_dm_op_t;
81 
82 #define IOCTL_PRIVCMD_HYPERCALL					\
83 	_IOWR('E', 0, struct ioctl_privcmd_hypercall)
84 #define IOCTL_PRIVCMD_MMAPBATCH					\
85 	_IOWR('E', 1, struct ioctl_privcmd_mmapbatch)
86 #define IOCTL_PRIVCMD_MMAP_RESOURCE				\
87 	_IOW('E', 2, struct ioctl_privcmd_mmapresource)
88 #define IOCTL_PRIVCMD_DM_OP					\
89 	_IOW('E', 3, struct ioctl_privcmd_dmop)
90 #define IOCTL_PRIVCMD_RESTRICT					\
91 	_IOW('E', 4, domid_t)
92 
93 #endif /* !__XEN_PRIVCMD_H__ */
94