sgx_create_enclave函数说明

创建一个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: 检测到意外错误。

posted @ 2023-07-06 23:15  然然1907  阅读(98)  评论(0编辑  收藏  举报