526互联

sgx_create_enclave函数说明

发布时间 2023-07-06 23:24:19作者: 李潇然

创建一个Enclave的函数如下：

sgx_status_t sgx_create_enclave(
             const char *file_name,
             const int debug,
             sgx_launch_token_t *launch_token,
             int *launch_token_updated,
             sgx_enclave_id_t *enclave_id,
             sgx_misc_attribute_t *misc_attr
        );

 

下面介绍一下每个变量的含义：

  • file_name: 名称或到enclave镜像的完整路径。如果项目使用Unicode，则文件明使用Unicode编码，如果项目使用多字节字符集，file_name应该是一个ANSI字符串。

  • debug [in]: 1表示在debug模式下创建enclave, 在调试模式下创建的enclave内的代码/数据内存可由调试器或enclave外的其他软件访问,不受Enclave保护。SGX_DEBUG_FLAG这个宏变量表示是否在Debug模式下创建Enclave，这个变量在makefile文件中可以更改。

  • launch_token [in/out]: 指向sgx_launch_token_t对象的指针，用于初始化要创建的enclave, 不能为NULL。调用者可以提供一个全0的buffer作为sgx_launch_token_t，该函数将尝试创建一个有效的sgx_launch_token_t类型的变量token，并将其存储在这个buffer中。调用者存储这个值，并在以后的调用中重用它来创建相同的enclave。当然，某些平台配置可以更改token使其失效，如果这个token失效了。该函数会更新它使其有效。

  • launch_token_updated [out]： 输出是0或1，0表示没有更新token。1表示已更新了token。

  • enclave_id [out]： sgx_enclave_id_t的指针，这个指针接收enclave ID或句柄，不能为NULL。

  • misc_attr [out, optional]： 指向sgx_misc_attribute_t结构的指针，它接收enclave的misc select和属性。如果不需要该信息，则该指针为空。
    下面介绍一下这个函数的返回值：

  • SGX_SUCCESS： 成功加载并初始化了enclave。

  • SGX_ERROR_INVALID_ENCLAVE： enclave文件已损坏。

  • SGX_ERROR_INVALID_PARAMETER： ’ enclave_id ‘、’ updated ‘或’ token '参数为NULL。

  • SGX_ERROR_OUT_OF_MEMORY： 没有足够的内存来完成sgx_create_enclave()。

  • SGX_ERROR_ENCLAVE_FILE_ACCESS： 无法打开enclave文件。这可能是由于没有找到enclave文件或没有访问enclave文件的特权造成的。

  • SGX_ERROR_INVALID_METADATA： 嵌入到enclave镜像中的元数据已损坏或丢失。

  • SGX_ERROR_INVALID_VERSION： enclave元数据版本(由签名工具创建)和不可信库版本(uRTS)不匹配。

  • SGX_ERROR_INVALID_SIGNATURE： enclave的签名无效。

  • SGX_ERROR_OUT_OF_EPC： 受保护的内存已用完。例如，用户创建了太多的enclave, 或者enclave需要太多的内存，我们无法加载完成某个操作所需的架构包。

  • SGX_ERROR_NO_DEVICE： Intel SGX设备无效。这可能是因为没有安装Intel SGX驱动程序或禁用了Intel SGX驱动程序。

  • SGX_ERROR_MEMORY_MAP_CONFLICT： 在创建enclave期间，加载程序和另一个线程之间存在映射内存的竞争条件。加载程序可能无法映射虚拟地址。如果遇到此错误代码，请再次创建enclave。

  • SGX_ERROR_DEVICE_BUSY： 创建enclave时，Intel SGX驱动程序或低层系统非常繁忙。如果遇到此错误代码，我们建议再次创建enclave。

  • SGX_ERROR_MODE_INCOMPATIBLE： enclave模式与当前RTS模式不兼容。例如，64位应用程序尝试加载32位的enclave，或者模拟uRTS模式尝试使用硬件模式加载enclave。

  • SGX_ERROR_SERVICE_UNAVAILABLE： sgx_create_enclave()需要AE服务来获得token。如果服务不可用，则可能无法启动enclave。

  • SGX_ERROR_SERVICE_TIMEOUT： 对AE服务的请求超时。

  • SGX_ERROR_SERVICE_INVALID_PRIVILEGE： 请求需要enclave的一些特殊属性，但是没有特权。

  • SGX_ERROR_NDEBUG_ENCLAVE： enclave被签名为发布的enclave，不能创建为可调试的enclave。

  • SGX_ERROR_UNDEFINED_SYMBOL： enclave包含一个import表。在构建enclave时，签名工具通常应该报告这种类型的错误。

  • SGX_ERROR_INVALID_MISC： MiscSelct/MiscMask设置不正确。

  • SGX_ERROR_HYPERV_ENABLED： 检测到Windows* 10操作系统和Hyper-V*的不兼容版本。在这种情况下，需要禁用目标机器上的Hyper-V。

  • SGX_ERROR_IPLDR_ENCRYPTED： 调用了sgx_create_enclave，但是对enclave进行了加密

  • SGX_ERROR_UNEXPECTED: 检测到意外错误。