1 /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR MIT) */ 2 /****************************************************************************** 3 * privcmd.h 4 * 5 * Interface to /proc/xen/privcmd. 6 * 7 * Copyright (c) 2003-2005, K A Fraser 8 * 9 * This program is free software; you can redistribute it and/or 10 * modify it under the terms of the GNU General Public License version 2 11 * as published by the Free Software Foundation; or, when distributed 12 * separately from the Linux kernel or incorporated into other 13 * software packages, subject to the following license: 14 * 15 * Permission is hereby granted, free of charge, to any person obtaining a copy 16 * of this source file (the "Software"), to deal in the Software without 17 * restriction, including without limitation the rights to use, copy, modify, 18 * merge, publish, distribute, sublicense, and/or sell copies of the Software, 19 * and to permit persons to whom the Software is furnished to do so, subject to 20 * the following conditions: 21 * 22 * The above copyright notice and this permission notice shall be included in 23 * all copies or substantial portions of the Software. 24 * 25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 26 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 27 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 28 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 29 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 30 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 31 * IN THE SOFTWARE. 32 */ 33 34 #ifndef __LINUX_PUBLIC_PRIVCMD_H__ 35 #define __LINUX_PUBLIC_PRIVCMD_H__ 36 37 #include <linux/types.h> 38 #include <linux/compiler.h> 39 #include <xen/interface/xen.h> 40 41 struct privcmd_hypercall { 42 __u64 op; 43 __u64 arg[5]; 44 }; 45 46 struct privcmd_mmap_entry { 47 __u64 va; 48 /* 49 * This should be a GFN. It's not possible to change the name because 50 * it's exposed to the user-space. 51 */ 52 __u64 mfn; 53 __u64 npages; 54 }; 55 56 struct privcmd_mmap { 57 int num; 58 domid_t dom; /* target domain */ 59 struct privcmd_mmap_entry __user *entry; 60 }; 61 62 struct privcmd_mmapbatch { 63 int num; /* number of pages to populate */ 64 domid_t dom; /* target domain */ 65 __u64 addr; /* virtual address */ 66 xen_pfn_t __user *arr; /* array of mfns - or'd with 67 PRIVCMD_MMAPBATCH_*_ERROR on err */ 68 }; 69 70 #define PRIVCMD_MMAPBATCH_MFN_ERROR 0xf0000000U 71 #define PRIVCMD_MMAPBATCH_PAGED_ERROR 0x80000000U 72 73 struct privcmd_mmapbatch_v2 { 74 unsigned int num; /* number of pages to populate */ 75 domid_t dom; /* target domain */ 76 __u64 addr; /* virtual address */ 77 const xen_pfn_t __user *arr; /* array of mfns */ 78 int __user *err; /* array of error codes */ 79 }; 80 81 struct privcmd_dm_op_buf { 82 void __user *uptr; 83 size_t size; 84 }; 85 86 struct privcmd_dm_op { 87 domid_t dom; 88 __u16 num; 89 const struct privcmd_dm_op_buf __user *ubufs; 90 }; 91 92 struct privcmd_mmap_resource { 93 domid_t dom; 94 __u32 type; 95 __u32 id; 96 __u32 idx; 97 __u64 num; 98 __u64 addr; 99 }; 100 101 /* 102 * @cmd: IOCTL_PRIVCMD_HYPERCALL 103 * @arg: &privcmd_hypercall_t 104 * Return: Value returned from execution of the specified hypercall. 105 * 106 * @cmd: IOCTL_PRIVCMD_MMAPBATCH_V2 107 * @arg: &struct privcmd_mmapbatch_v2 108 * Return: 0 on success (i.e., arg->err contains valid error codes for 109 * each frame). On an error other than a failed frame remap, -1 is 110 * returned and errno is set to EINVAL, EFAULT etc. As an exception, 111 * if the operation was otherwise successful but any frame failed with 112 * -ENOENT, then -1 is returned and errno is set to ENOENT. 113 */ 114 #define IOCTL_PRIVCMD_HYPERCALL \ 115 _IOC(_IOC_NONE, 'P', 0, sizeof(struct privcmd_hypercall)) 116 #define IOCTL_PRIVCMD_MMAP \ 117 _IOC(_IOC_NONE, 'P', 2, sizeof(struct privcmd_mmap)) 118 #define IOCTL_PRIVCMD_MMAPBATCH \ 119 _IOC(_IOC_NONE, 'P', 3, sizeof(struct privcmd_mmapbatch)) 120 #define IOCTL_PRIVCMD_MMAPBATCH_V2 \ 121 _IOC(_IOC_NONE, 'P', 4, sizeof(struct privcmd_mmapbatch_v2)) 122 #define IOCTL_PRIVCMD_DM_OP \ 123 _IOC(_IOC_NONE, 'P', 5, sizeof(struct privcmd_dm_op)) 124 #define IOCTL_PRIVCMD_RESTRICT \ 125 _IOC(_IOC_NONE, 'P', 6, sizeof(domid_t)) 126 #define IOCTL_PRIVCMD_MMAP_RESOURCE \ 127 _IOC(_IOC_NONE, 'P', 7, sizeof(struct privcmd_mmap_resource)) 128 129 #endif /* __LINUX_PUBLIC_PRIVCMD_H__ */ 130