subset ****** .. _subset.comment: :kw:`comment` ============= ================= ================================================================ **scopable** False **required** False **provisioning** False **default** **inheritance** leaf > head **scope order** specific > generic ================= ================================================================ Helps users understand the role of the service and resources, which is nice to on-call support people having to operate on a service they are not usually responsible for. .. _subset.parallel: :kw:`parallel` ============== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** False **inheritance** leaf > head **scope order** specific > generic **candidates** True | False **convert** boolean ================= ================================================================ If set to ``true``, actions are executed in parallel amongst the subset member resources. .. _subset.pg_blkio_weight: :kw:`pg_blkio_weight` ===================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Block IO relative weight. Value: between 10 and 1000. Kernel default: 1000. .. _subset.pg_cpu_quota: :kw:`pg_cpu_quota` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ The percent ratio of one core to allocate to the process group if % is specified, else the absolute value to set in the process group parameter. For example, on Linux cgroups, ``-1`` means unlimited, and a positive absolute value means the number of microseconds to allocate each period. ``50%@all`` means 50% of all cores, and ``50%@2`` means 50% of two cores. .. _subset.pg_cpu_shares: :kw:`pg_cpu_shares` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Kernel default value is used, which usually is 1024 shares. In a cpu-bound situation, ensure the service does not use more than its share of cpu ressource. The actual percentile depends on shares allowed to other services. .. _subset.pg_cpus: :kw:`pg_cpus` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified cpus. Cpus are specified as list or range : 0,1,2 or 0-2 .. _subset.pg_mem_limit: :kw:`pg_mem_limit` ================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. .. _subset.pg_mem_oom_control: :kw:`pg_mem_oom_control` ======================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ A flag (0 or 1) that enables or disables the Out of Memory killer for a cgroup. If enabled (0), tasks that attempt to consume more memory than they are allowed are immediately killed by the OOM killer. The OOM killer is enabled by default in every cgroup using the memory subsystem; to disable it, write 1. .. _subset.pg_mem_swappiness: :kw:`pg_mem_swappiness` ======================= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** integer ================= ================================================================ Set a swappiness value for the process group. .. _subset.pg_mems: :kw:`pg_mems` ============= ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] ================= ================================================================ Allow service process to bind only the specified memory nodes. Memory nodes are specified as list or range : 0,1,2 or 0-2 .. _subset.pg_vmem_limit: :kw:`pg_vmem_limit` =================== ================= ================================================================ **scopable** True **required** False **provisioning** False **default** None **inheritance** leaf **scope order** specific > generic **depends** create_pg in [True] **convert** size ================= ================================================================ Ensures the service does not use more than specified memory+swap (in bytes). The Out-Of-Memory killer get triggered in case of tresspassing. The specified value must be greater than :kw:`pg_mem_limit`.