zx_profile_create

摘要

创建调度器配置文件。

声明

#include <zircon/syscalls.h>

zx_status_t zx_profile_create(zx_handle_t profile_rsrc,
                              uint32_t options,
                              const zx_profile_info_t* profile,
                              zx_handle_t* out);

说明

zx_profile_create() 会创建一个新的配置文件对象。

参数 profile 用于指定配置文件中的设置，这些设置会在调用 zx_object_set_profile() 时应用于线程。通过 profile 中的字段如下所示。options 必须为零。

#define ZX_PROFILE_INFO_FLAG_PRIORITY (1 << 0)
#define ZX_PROFILE_INFO_FLAG_CPU_MASK (1 << 1)
#define ZX_PROFILE_INFO_FLAG_DEADLINE (1 << 2)
#define ZX_PROFILE_INFO_FLAG_NO_INHERIT (1 << 3)
#define ZX_PROFILE_INFO_FLAG_MEMORY_PRIORITY (1 << 4)

typedef struct zx_profile_info {
  // A bitmask of ZX_PROFILE_INFO_FLAG_* values. Controls overall profile
  // options as well as determining which other fields below have been specified.
  // Other fields are considered unset.
  uint32_t flags;

  uint8_t padding1[4];

  union {
    struct {
      // Scheduling priority. |flags| must have ZX_PROFILE_INFO_FLAG_PRIORITY or
      // ZX_PROFILE_INFO_FLAG_MEMORY_PRIORITY set.
      int32_t priority;
      uint8_t padding2[20];
    };

    // Scheduling deadline. |flags| must have ZX_PROFILE_INFO_FLAG_DEADLINE set.
    zx_sched_deadline_params_t deadline_params;
  };

  // CPUs that threads may be scheduled on. |flags| must have
  // ZX_PROFILE_INFO_FLAG_CPU_MASK set.
  zx_cpu_set_t cpu_affinity_mask;
} zx_profile_info_t;

flags 字段除了指定 zx_profile_info_t 结构中的哪些字段包含有效值。系统会忽略未设置相应 flag 位集的字段中的值。这样， 值为 0 且未设置字段进行区分的字段，即使 以后还会添加更多字段

ZX_PROFILE_INFO_FLAG_PRIORITY 和 ZX_PROFILE_INFO_FLAG_DEADLINE 用于指定配置文件的 scheduling discipline，即“公平调度”（对于 PRIORITY）或“截止时间调度”（对于 DEADLINE）。最多只能选择其中一个 同时选择多个学科。

ZX_PROFILE_INFO_FLAG_MEMORY_PRIORITY允许创建可应用于 VMAR，并且与任何与标志相关的调度均不兼容。选择内存优先级时，目前只有 ZX_PRIORITY_DEFAULT 和 ZX_PRIORITY_HIGH 有意义，前者是所有 VMAR 最初具有的默认值，后者表示应避免对应用了配置文件的对象执行所有内核发起的回收。

默认情况下，配置文件在分配给具有已分配所有者的 futex 中阻塞的线程后会参与配置文件继承（请参阅 zx_futex_wait()）。使用 ZX_PROFILE_INFO_FLAG_NO_INHERIT 创建的配置文件不会参与继承。当线程在具有所有者的 futex 中分配了此类配置文件块时，futex 的所有者不会收到来自阻塞线程的直接配置文件压力（但可能会收到来自阻塞线程后面阻塞的其他线程的压力）。

截止日期配置文件必须始终可继承。尝试创建不可继承的截止期限配置文件将失败，并返回 ZX_ERR_INVALID_ARGS。

成功后，系统会返回新资料的句柄。

权限

profile_rsrc 必须具有资源种类 ZX_RESOURCE_KIND_SYSTEM 和基准 ZX_RSRC_SYSTEM_PROFILE_BASE。

调用方作业政策必须允许 ZX_POL_NEW_PROFILE。

返回值

成功时，返回 ZX_OK 和新配置文件的句柄（通过 out）。如果失败，则返回负错误值。

错误

ZX_ERR_BAD_HANDLE profile_rsrc 不是有效的句柄。

ZX_ERR_ACCESS_DENIED profile_rsrc 不是配置文件资源。

ZX_ERR_INVALID_ARGS提供的一个或多个参数无效：

  • profile 或 out 是无效的指针
  • 标志包含未知选项
  • flags 无法指定调度规则、CPU 亲和性掩码或 内存优先级
  • flags 同时指定了多个时间安排规则。
  • 标志将调度纪律指定为截止期限，但配置文件也被标记为“不继承”。
  • 标志指定了调度纪律和内存优先级。
  • options 不为零
  • Priority 是无效的优先级

ZX_ERR_NO_MEMORY 因内存不足而失败。

另请参阅