uapi/asm/sgx.h

1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
3  * Copyright(c) 2016-20 Intel Corporation.
12  * enum sgx_page_flags - page control flags
13  * %SGX_PAGE_MEASURE:	Measure the page contents with a sequence of
40  * struct sgx_enclave_create - parameter structure for the
42  * @src:	address for the SECS page data
49  * struct sgx_enclave_add_pages - parameter structure for the
51  * @src:	start address for the page data
52  * @offset:	starting page offset
53  * @length:	length of the data (multiple of the page size)
55  * @flags:	page control flags
56  * @count:	number of bytes added (multiple of the page size)
60 	__u64 offset;  member
68  * struct sgx_enclave_init - parameter structure for the
77  * struct sgx_enclave_provision - parameter structure for the
86  * struct sgx_enclave_restrict_permissions - parameters for ioctl
88  * @offset:	starting page offset (page aligned relative to enclave base
90  * @length:	length of memory (multiple of the page size)
91  * @permissions:new permission bits for pages in range described by @offset
94  * @count:	(output) bytes successfully changed (multiple of page size)
97 	__u64 offset;  member
105  * struct sgx_enclave_modify_types - parameters for ioctl
107  * @offset:	starting page offset (page aligned relative to enclave base
109  * @length:	length of memory (multiple of the page size)
110  * @page_type:	new type for pages in range described by @offset and @length
112  * @count:	(output) bytes successfully changed (multiple of page size)
115 	__u64 offset;  member
123  * struct sgx_enclave_remove_pages - %SGX_IOC_ENCLAVE_REMOVE_PAGES parameters
124  * @offset:	starting page offset (page aligned relative to enclave base
126  * @length:	length of memory (multiple of the page size)
127  * @count:	(output) bytes successfully changed (multiple of page size)
131  * ioctl() should be used to change the page type to PT_TRIM. After that
133  * %SGX_IOC_ENCLAVE_REMOVE_PAGES can be used to complete the page removal.
136 	__u64 offset;  member
144  * typedef sgx_enclave_user_handler_t - Exit handler function accepted by
149  * exit. An invalid ENCLU function number will cause -EINVAL to be returned
153  * - <= 0:	The given value is returned back to the caller.
154  * - > 0:	ENCLU function to invoke, either EENTER or ERESUME.
161  * struct sgx_enclave_run - the execution context of __vdso_sgx_enter_enclave()
188  * typedef vdso_sgx_enter_enclave_t - Prototype for __vdso_sgx_enter_enclave(),
190  * @rdi:	Pass-through value for RDI
191  * @rsi:	Pass-through value for RSI
192  * @rdx:	Pass-through value for RDX
194  * @r8:		Pass-through value for R8
195  * @r9:		Pass-through value for R9
196  * @run:	struct sgx_enclave_run, must be non-NULL
199  * x86-64 ABI, e.g. doesn't handle XSAVE state.  Except for non-volatile
201  * state in accordance with the x86-64 ABI is the responsibility of the enclave
205  * All general purpose registers except RAX, RBX and RCX are passed as-is to the
210  * pre-enclave state, e.g. to retrieve @run.exception and @run.user_handler
220  * reported exceptions, -EFAULT is returned and details about the exception are
224  * - 0:		ENCLU function was successfully executed.
225  * - -EINVAL:	Invalid ENCL number (neither EENTER nor ERESUME).