[PATCH 12/40] nitro_enclaves: Name the device's error codes in the UAPI header

From: Alexander Graf

Date: Wed Nov 11 2026 - 18:03:51 EST


The nitro_enclaves device refuses a command with an errno or with an
NE_ERR_ code, which ne_do_request() passes on to user space as it is.
The codes of its own that the device returns start at 276, after the
driver's, and we want the device to be able to add more of them later.

Name the device's codes in the header, so that a caller can tell for
example a refused flag from an invalid slot, and document three ranges:
the driver's original codes from 256, the device's codes from 276 to
511, and codes only the driver returns from 1024. That way new codes on
either side never collide. 511 stays below the kernel-internal error
codes, and 1024 well below MAX_ERRNO, so user space reads every code as
an error.

Signed-off-by: Alexander Graf <graf@xxxxxxxxxx>
---
include/uapi/linux/nitro_enclaves.h | 142 ++++++++++++++++++++++++++++
1 file changed, 142 insertions(+)

diff --git a/include/uapi/linux/nitro_enclaves.h b/include/uapi/linux/nitro_enclaves.h
index 8ccf16e9cf5fb..6dd00c41c07d5 100644
--- a/include/uapi/linux/nitro_enclaves.h
+++ b/include/uapi/linux/nitro_enclaves.h
@@ -567,6 +567,148 @@ struct ne_add_memory_region_args {
*/
#define NE_ERR_INVALID_ENCLAVE_CID (275)

+/**
+ * DOC: NE error code ranges
+ *
+ * The NE_ERR_ codes come from three ranges:
+ *
+ * * 256 to 275 - The driver's original codes. The NE PCI device also
+ * returns NE_ERR_MEM_MAX_REGIONS, with the same meaning.
+ * * 276 to 511 - Codes the NE PCI device returns. The driver passes them on
+ * to the caller unchanged, and the device adds new codes upward from the
+ * last one defined here. The range ends below the kernel-internal error
+ * codes, which start at 512.
+ * * 1024 and above - Codes only the driver returns, added upward from 1024.
+ */
+
+/**
+ * NE_ERR_INVALID_FLAGS - The command's reserved flags field was not zero.
+ */
+#define NE_ERR_INVALID_FLAGS (276)
+/**
+ * NE_ERR_INVALID_ALIGNMENT - An address or a size the command carries is
+ * misaligned or too small.
+ */
+#define NE_ERR_INVALID_ALIGNMENT (277)
+/**
+ * NE_ERR_INVALID_SIZE - A size or count the command carries is zero, too large
+ * or too short.
+ */
+#define NE_ERR_INVALID_SIZE (278)
+/**
+ * NE_ERR_INVALID_SLOT - The slot the command names does not exist.
+ */
+#define NE_ERR_INVALID_SLOT (279)
+/**
+ * NE_ERR_INVALID_DEVICE - The command names a device, an address or a memory
+ * range the device does not accept.
+ */
+#define NE_ERR_INVALID_DEVICE (280)
+/**
+ * NE_ERR_TOO_MANY_DEVICES - The enclave already has as many devices as it may.
+ */
+#define NE_ERR_TOO_MANY_DEVICES (281)
+/**
+ * NE_ERR_TOO_MANY_VQS - The device already has as many queues as it may.
+ */
+#define NE_ERR_TOO_MANY_VQS (282)
+/**
+ * NE_ERR_NO_RESOURCES - The device could not put together something of its own
+ * that the command needs.
+ */
+#define NE_ERR_NO_RESOURCES (283)
+/**
+ * NE_ERR_ALREADY_EXISTS - The slot already has what the command gives it.
+ */
+#define NE_ERR_ALREADY_EXISTS (284)
+/**
+ * NE_ERR_MISSING_INFO_PAGE - The slot has no info page, or the one it has is too
+ * small for what the command writes there.
+ */
+#define NE_ERR_MISSING_INFO_PAGE (285)
+/**
+ * NE_ERR_INVALID_FLAG - A flag bit the device does not know, or does not allow
+ * here, was set.
+ */
+#define NE_ERR_INVALID_FLAG (286)
+/**
+ * NE_ERR_RESERVED_FLAG - A reserved flag bit was set.
+ */
+#define NE_ERR_RESERVED_FLAG (287)
+/**
+ * NE_ERR_MISSING_PCIE - A flag that depends on the PCIe flag was set without it.
+ */
+#define NE_ERR_MISSING_PCIE (288)
+/**
+ * NE_ERR_INCOMPATIBLE_FLAGS - The flags asked for cannot be had together.
+ */
+#define NE_ERR_INCOMPATIBLE_FLAGS (289)
+/**
+ * NE_ERR_EIF_FLAG_MISMATCH - The image's matched flags are not the ones the
+ * enclave was started with.
+ */
+#define NE_ERR_EIF_FLAG_MISMATCH (290)
+/**
+ * NE_ERR_DEVICE_DISALLOWED - The device type asked for is not allowed.
+ */
+#define NE_ERR_DEVICE_DISALLOWED (291)
+/**
+ * NE_ERR_HOTPLUG_DISABLED - The enclave does not take devices once it is
+ * running.
+ */
+#define NE_ERR_HOTPLUG_DISABLED (292)
+/**
+ * NE_ERR_BAD_EIF - The enclave image is missing, or did not pass validation when
+ * the enclave was started.
+ */
+#define NE_ERR_BAD_EIF (293)
+/**
+ * NE_ERR_MISSING_PCIE_VIRTIO - A flag that depends on the virtio-PCIe flag was
+ * set without it.
+ */
+#define NE_ERR_MISSING_PCIE_VIRTIO (294)
+/**
+ * NE_ERR_BAD_PAYLOAD_VERSION - The request's payload version is one the device
+ * does not take.
+ */
+#define NE_ERR_BAD_PAYLOAD_VERSION (295)
+/**
+ * NE_ERR_INFO_VECTORS_EXHAUSTED - No notification vector is left.
+ */
+#define NE_ERR_INFO_VECTORS_EXHAUSTED (296)
+/**
+ * NE_ERR_TOO_MANY_ENCLAVES - The instance already has as many enclaves as its
+ * quota allows. A terminal answer: neither
+ * resending the command nor donating more memory
+ * changes it.
+ */
+#define NE_ERR_TOO_MANY_ENCLAVES (297)
+/**
+ * NE_ERR_NO_MEM_SLOTS_ON_NODE - The memory budget of one NUMA node is used up,
+ * which -ENOSPC does not distinguish from the
+ * budget as a whole.
+ */
+#define NE_ERR_NO_MEM_SLOTS_ON_NODE (298)
+/**
+ * NE_ERR_NUMA_SPAN - The enclave's CPUs and memory span more than one host NUMA
+ * node, and the enclave was not set up to span nodes.
+ */
+#define NE_ERR_NUMA_SPAN (299)
+/**
+ * NE_ERR_NUMA_ALIGNMENT - The memory of a guest NUMA node other than the last
+ * is not a multiple of the guest's memory section size.
+ */
+#define NE_ERR_NUMA_ALIGNMENT (300)
+/**
+ * NE_ERR_LOW_RAM_TOO_SMALL - The lowest contiguous run of enclave memory is too
+ * small for the boot layout the enclave needs.
+ */
+#define NE_ERR_LOW_RAM_TOO_SMALL (301)
+/**
+ * NE_ERR_ZERO_REGION - The enclave's memory layout has a region of size zero.
+ */
+#define NE_ERR_ZERO_REGION (302)
+
/**
* DOC: Image load info flags
*/
--
2.47.1