€•ÉX      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ*/translations/zh_CN/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/zh_TW/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/it_IT/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ja_JP/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ko_KR/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/sp_SP/bpf/map_cgroup_storage”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ%SPDX-License-Identifier: GPL-2.0-only”h]”hŒ%SPDX-License-Identifier: GPL-2.0-only”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒD/var/lib/git/docbuild/linux/Documentation/bpf/map_cgroup_storage.rst”h Kubh¢)”}”(hŒCopyright (C) 2020 Google LLC.”h]”hŒCopyright (C) 2020 Google LLC.”…””}”hh´sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hhhžhhŸh³h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒBPF_MAP_TYPE_CGROUP_STORAGE”h]”hŒBPF_MAP_TYPE_CGROUP_STORAGE”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhŒ	paragraph”“”)”}”(hX$  The ``BPF_MAP_TYPE_CGROUP_STORAGE`` map type represents a local fix-sized
storage. It is only available with ``CONFIG_CGROUP_BPF``, and to programs that
attach to cgroups; the programs are made available by the same Kconfig. The
storage is identified by the cgroup the program is attached to.”h]”(hŒThe ”…””}”(hhÙhžhhŸNh NubhŒliteral”“”)”}”(hŒ``BPF_MAP_TYPE_CGROUP_STORAGE``”h]”hŒBPF_MAP_TYPE_CGROUP_STORAGE”…””}”(hhãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhhÙubhŒJ map type represents a local fix-sized
storage. It is only available with ”…””}”(hhÙhžhhŸNh Nubhâ)”}”(hŒ``CONFIG_CGROUP_BPF``”h]”hŒCONFIG_CGROUP_BPF”…””}”(hhõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhhÙubhŒ¢, and to programs that
attach to cgroups; the programs are made available by the same Kconfig. The
storage is identified by the cgroup the program is attached to.”…””}”(hhÙhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhØ)”}”(hŒúThe map provide a local storage at the cgroup that the BPF program is attached
to. It provides a faster and simpler access than the general purpose hash
table, which performs a hash table lookups, and requires user to track live
cgroups on their own.”h]”hŒúThe map provide a local storage at the cgroup that the BPF program is attached
to. It provides a faster and simpler access than the general purpose hash
table, which performs a hash table lookups, and requires user to track live
cgroups on their own.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhØ)”}”(hŒÀThis document describes the usage and semantics of the
``BPF_MAP_TYPE_CGROUP_STORAGE`` map type. Some of its behaviors was changed in
Linux 5.9 and this document will describe the differences.”h]”(hŒ7This document describes the usage and semantics of the
”…””}”(hj  hžhhŸNh Nubhâ)”}”(hŒ``BPF_MAP_TYPE_CGROUP_STORAGE``”h]”hŒBPF_MAP_TYPE_CGROUP_STORAGE”…””}”(hj#  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj  ubhŒj map type. Some of its behaviors was changed in
Linux 5.9 and this document will describe the differences.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒUsage”h]”hŒUsage”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj;  hžhhŸh³h KubhØ)”}”(hŒ€The map uses key of type of either ``__u64 cgroup_inode_id`` or
``struct bpf_cgroup_storage_key``, declared in ``linux/bpf.h``::”h]”(hŒ#The map uses key of type of either ”…””}”(hjL  hžhhŸNh Nubhâ)”}”(hŒ``__u64 cgroup_inode_id``”h]”hŒ__u64 cgroup_inode_id”…””}”(hjT  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjL  ubhŒ or
”…””}”(hjL  hžhhŸNh Nubhâ)”}”(hŒ!``struct bpf_cgroup_storage_key``”h]”hŒstruct bpf_cgroup_storage_key”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjL  ubhŒ, declared in ”…””}”(hjL  hžhhŸNh Nubhâ)”}”(hŒ``linux/bpf.h``”h]”hŒlinux/bpf.h”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjL  ubhŒ:”…””}”(hjL  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khj;  hžhubhŒliteral_block”“”)”}”(hŒ\struct bpf_cgroup_storage_key {
        __u64 cgroup_inode_id;
        __u32 attach_type;
};”h]”hŒ\struct bpf_cgroup_storage_key {
        __u64 cgroup_inode_id;
        __u32 attach_type;
};”…””}”hj’  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h Khj;  hžhubhØ)”}”(hŒj``cgroup_inode_id`` is the inode id of the cgroup directory.
``attach_type`` is the program's attach type.”h]”(hâ)”}”(hŒ``cgroup_inode_id``”h]”hŒcgroup_inode_id”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj   ubhŒ* is the inode id of the cgroup directory.
”…””}”(hj   hžhhŸNh Nubhâ)”}”(hŒ``attach_type``”h]”hŒattach_type”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj   ubhŒ  is the programâ€™s attach type.”…””}”(hj   hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K!hj;  hžhubhØ)”}”(hXH  Linux 5.9 added support for type ``__u64 cgroup_inode_id`` as the key type.
When this key type is used, then all attach types of the particular cgroup and
map will share the same storage. Otherwise, if the type is
``struct bpf_cgroup_storage_key``, then programs of different attach types
be isolated and see different storages.”h]”(hŒ!Linux 5.9 added support for type ”…””}”(hjÎ  hžhhŸNh Nubhâ)”}”(hŒ``__u64 cgroup_inode_id``”h]”hŒ__u64 cgroup_inode_id”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjÎ  ubhŒœ as the key type.
When this key type is used, then all attach types of the particular cgroup and
map will share the same storage. Otherwise, if the type is
”…””}”(hjÎ  hžhhŸNh Nubhâ)”}”(hŒ!``struct bpf_cgroup_storage_key``”h]”hŒstruct bpf_cgroup_storage_key”…””}”(hjè  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjÎ  ubhŒQ, then programs of different attach types
be isolated and see different storages.”…””}”(hjÎ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K$hj;  hžhubhØ)”}”(hŒCTo access the storage in a program, use ``bpf_get_local_storage``::”h]”(hŒ(To access the storage in a program, use ”…””}”(hj   hžhhŸNh Nubhâ)”}”(hŒ``bpf_get_local_storage``”h]”hŒbpf_get_local_storage”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj   ubhŒ:”…””}”(hj   hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K*hj;  hžhubj‘  )”}”(hŒ1void *bpf_get_local_storage(void *map, u64 flags)”h]”hŒ1void *bpf_get_local_storage(void *map, u64 flags)”…””}”hj   sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h K,hj;  hžhubhØ)”}”(hŒ3``flags`` is reserved for future use and must be 0.”h]”(hâ)”}”(hŒ	``flags``”h]”hŒflags”…””}”(hj2  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj.  ubhŒ* is reserved for future use and must be 0.”…””}”(hj.  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K.hj;  hžhubhØ)”}”(hXZ  There is no implicit synchronization. Storages of ``BPF_MAP_TYPE_CGROUP_STORAGE``
can be accessed by multiple programs across different CPUs, and user should
take care of synchronization by themselves. The bpf infrastructure provides
``struct bpf_spin_lock`` to synchronize the storage. See
``tools/testing/selftests/bpf/progs/test_spin_lock.c``.”h]”(hŒ2There is no implicit synchronization. Storages of ”…””}”(hjJ  hžhhŸNh Nubhâ)”}”(hŒ``BPF_MAP_TYPE_CGROUP_STORAGE``”h]”hŒBPF_MAP_TYPE_CGROUP_STORAGE”…””}”(hjR  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjJ  ubhŒ™
can be accessed by multiple programs across different CPUs, and user should
take care of synchronization by themselves. The bpf infrastructure provides
”…””}”(hjJ  hžhhŸNh Nubhâ)”}”(hŒ``struct bpf_spin_lock``”h]”hŒstruct bpf_spin_lock”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjJ  ubhŒ! to synchronize the storage. See
”…””}”(hjJ  hžhhŸNh Nubhâ)”}”(hŒ6``tools/testing/selftests/bpf/progs/test_spin_lock.c``”h]”hŒ2tools/testing/selftests/bpf/progs/test_spin_lock.c”…””}”(hjv  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjJ  ubhŒ.”…””}”(hjJ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K0hj;  hžhubeh}”(h]”Œusage”ah ]”h"]”Œusage”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒExamples”h]”hŒExamples”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj–  hžhhŸh³h K7ubhØ)”}”(hŒ:Usage with key type as ``struct bpf_cgroup_storage_key``::”h]”(hŒUsage with key type as ”…””}”(hj§  hžhhŸNh Nubhâ)”}”(hŒ!``struct bpf_cgroup_storage_key``”h]”hŒstruct bpf_cgroup_storage_key”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj§  ubhŒ:”…””}”(hj§  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K9hj–  hžhubj‘  )”}”(hXc  #include <bpf/bpf.h>

struct {
        __uint(type, BPF_MAP_TYPE_CGROUP_STORAGE);
        __type(key, struct bpf_cgroup_storage_key);
        __type(value, __u32);
} cgroup_storage SEC(".maps");

int program(struct __sk_buff *skb)
{
        __u32 *ptr = bpf_get_local_storage(&cgroup_storage, 0);
        __sync_fetch_and_add(ptr, 1);

        return 0;
}”h]”hXc  #include <bpf/bpf.h>

struct {
        __uint(type, BPF_MAP_TYPE_CGROUP_STORAGE);
        __type(key, struct bpf_cgroup_storage_key);
        __type(value, __u32);
} cgroup_storage SEC(".maps");

int program(struct __sk_buff *skb)
{
        __u32 *ptr = bpf_get_local_storage(&cgroup_storage, 0);
        __sync_fetch_and_add(ptr, 1);

        return 0;
}”…””}”hjÇ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h K;hj–  hžhubhØ)”}”(hŒ(Userspace accessing map declared above::”h]”hŒ'Userspace accessing map declared above:”…””}”(hjÕ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KKhj–  hžhubj‘  )”}”(hX  #include <linux/bpf.h>
#include <linux/libbpf.h>

__u32 map_lookup(struct bpf_map *map, __u64 cgrp, enum bpf_attach_type type)
{
        struct bpf_cgroup_storage_key = {
                .cgroup_inode_id = cgrp,
                .attach_type = type,
        };
        __u32 value;
        bpf_map_lookup_elem(bpf_map__fd(map), &key, &value);
        // error checking omitted
        return value;
}”h]”hX  #include <linux/bpf.h>
#include <linux/libbpf.h>

__u32 map_lookup(struct bpf_map *map, __u64 cgrp, enum bpf_attach_type type)
{
        struct bpf_cgroup_storage_key = {
                .cgroup_inode_id = cgrp,
                .attach_type = type,
        };
        __u32 value;
        bpf_map_lookup_elem(bpf_map__fd(map), &key, &value);
        // error checking omitted
        return value;
}”…””}”hjã  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h KMhj–  hžhubhØ)”}”(hŒAAlternatively, using just ``__u64 cgroup_inode_id`` as key type::”h]”(hŒAlternatively, using just ”…””}”(hjñ  hžhhŸNh Nubhâ)”}”(hŒ``__u64 cgroup_inode_id``”h]”hŒ__u64 cgroup_inode_id”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjñ  ubhŒ as key type:”…””}”(hjñ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K\hj–  hžhubj‘  )”}”(hXK  #include <bpf/bpf.h>

struct {
        __uint(type, BPF_MAP_TYPE_CGROUP_STORAGE);
        __type(key, __u64);
        __type(value, __u32);
} cgroup_storage SEC(".maps");

int program(struct __sk_buff *skb)
{
        __u32 *ptr = bpf_get_local_storage(&cgroup_storage, 0);
        __sync_fetch_and_add(ptr, 1);

        return 0;
}”h]”hXK  #include <bpf/bpf.h>

struct {
        __uint(type, BPF_MAP_TYPE_CGROUP_STORAGE);
        __type(key, __u64);
        __type(value, __u32);
} cgroup_storage SEC(".maps");

int program(struct __sk_buff *skb)
{
        __u32 *ptr = bpf_get_local_storage(&cgroup_storage, 0);
        __sync_fetch_and_add(ptr, 1);

        return 0;
}”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h K^hj–  hžhubhØ)”}”(hŒAnd userspace::”h]”hŒAnd userspace:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Knhj–  hžhubj‘  )”}”(hX  #include <linux/bpf.h>
#include <linux/libbpf.h>

__u32 map_lookup(struct bpf_map *map, __u64 cgrp, enum bpf_attach_type type)
{
        __u32 value;
        bpf_map_lookup_elem(bpf_map__fd(map), &cgrp, &value);
        // error checking omitted
        return value;
}”h]”hX  #include <linux/bpf.h>
#include <linux/libbpf.h>

__u32 map_lookup(struct bpf_map *map, __u64 cgrp, enum bpf_attach_type type)
{
        __u32 value;
        bpf_map_lookup_elem(bpf_map__fd(map), &cgrp, &value);
        // error checking omitted
        return value;
}”…””}”hj-  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j  hŸh³h Kphj–  hžhubeh}”(h]”Œexamples”ah ]”h"]”Œexamples”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K7ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ	Semantics”h]”hŒ	Semantics”…””}”(hjF  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjC  hžhhŸh³h K|ubhØ)”}”(hŒß``BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE`` is a variant of this map type. This
per-CPU variant will have different memory regions for each CPU for each
storage. The non-per-CPU will have the same memory region for each storage.”h]”(hâ)”}”(hŒ&``BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE``”h]”hŒ"BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjT  ubhŒ¹ is a variant of this map type. This
per-CPU variant will have different memory regions for each CPU for each
storage. The non-per-CPU will have the same memory region for each storage.”…””}”(hjT  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K~hjC  hžhubhØ)”}”(hXM  Prior to Linux 5.9, the lifetime of a storage is precisely per-attachment, and
for a single ``CGROUP_STORAGE`` map, there can be at most one program loaded
that uses the map. A program may be attached to multiple cgroups or have
multiple attach types, and each attach creates a fresh zeroed storage. The
storage is freed upon detach.”h]”(hŒ\Prior to Linux 5.9, the lifetime of a storage is precisely per-attachment, and
for a single ”…””}”(hjp  hžhhŸNh Nubhâ)”}”(hŒ``CGROUP_STORAGE``”h]”hŒCGROUP_STORAGE”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjp  ubhŒß map, there can be at most one program loaded
that uses the map. A program may be attached to multiple cgroups or have
multiple attach types, and each attach creates a fresh zeroed storage. The
storage is freed upon detach.”…””}”(hjp  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K‚hjC  hžhubhØ)”}”(hXƒ  There is a one-to-one association between the map of each type (per-CPU and
non-per-CPU) and the BPF program during load verification time. As a result,
each map can only be used by one BPF program and each BPF program can only use
one storage map of each type. Because of map can only be used by one BPF
program, sharing of this cgroup's storage with other BPF programs were
impossible.”h]”hX…  There is a one-to-one association between the map of each type (per-CPU and
non-per-CPU) and the BPF program during load verification time. As a result,
each map can only be used by one BPF program and each BPF program can only use
one storage map of each type. Because of map can only be used by one BPF
program, sharing of this cgroupâ€™s storage with other BPF programs were
impossible.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KˆhjC  hžhubhØ)”}”(hX\  Since Linux 5.9, storage can be shared by multiple programs. When a program is
attached to a cgroup, the kernel would create a new storage only if the map
does not already contain an entry for the cgroup and attach type pair, or else
the old storage is reused for the new attachment. If the map is attach type
shared, then attach type is simply ignored during comparison. Storage is freed
only when either the map or the cgroup attached to is being freed. Detaching
will not directly free the storage, but it may cause the reference to the map
to reach zero and indirectly freeing all storage in the map.”h]”hX\  Since Linux 5.9, storage can be shared by multiple programs. When a program is
attached to a cgroup, the kernel would create a new storage only if the map
does not already contain an entry for the cgroup and attach type pair, or else
the old storage is reused for the new attachment. If the map is attach type
shared, then attach type is simply ignored during comparison. Storage is freed
only when either the map or the cgroup attached to is being freed. Detaching
will not directly free the storage, but it may cause the reference to the map
to reach zero and indirectly freeing all storage in the map.”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhjC  hžhubhØ)”}”(hX4  The map is not associated with any BPF program, thus making sharing possible.
However, the BPF program can still only associate with one map of each type
(per-CPU and non-per-CPU). A BPF program cannot use more than one
``BPF_MAP_TYPE_CGROUP_STORAGE`` or more than one
``BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE``.”h]”(hŒÜThe map is not associated with any BPF program, thus making sharing possible.
However, the BPF program can still only associate with one map of each type
(per-CPU and non-per-CPU). A BPF program cannot use more than one
”…””}”(hj¬  hžhhŸNh Nubhâ)”}”(hŒ``BPF_MAP_TYPE_CGROUP_STORAGE``”h]”hŒBPF_MAP_TYPE_CGROUP_STORAGE”…””}”(hj´  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj¬  ubhŒ or more than one
”…””}”(hj¬  hžhhŸNh Nubhâ)”}”(hŒ&``BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE``”h]”hŒ"BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhj¬  ubhŒ.”…””}”(hj¬  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K˜hjC  hžhubhØ)”}”(hX€  In all versions, userspace may use the attach parameters of cgroup and
attach type pair in ``struct bpf_cgroup_storage_key`` as the key to the BPF map
APIs to read or update the storage for a given attachment. For Linux 5.9
attach type shared storages, only the first value in the struct, cgroup inode
id, is used during comparison, so userspace may just specify a ``__u64``
directly.”h]”(hŒ[In all versions, userspace may use the attach parameters of cgroup and
attach type pair in ”…””}”(hjÞ  hžhhŸNh Nubhâ)”}”(hŒ!``struct bpf_cgroup_storage_key``”h]”hŒstruct bpf_cgroup_storage_key”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjÞ  ubhŒñ as the key to the BPF map
APIs to read or update the storage for a given attachment. For Linux 5.9
attach type shared storages, only the first value in the struct, cgroup inode
id, is used during comparison, so userspace may just specify a ”…””}”(hjÞ  hžhhŸNh Nubhâ)”}”(hŒ	``__u64``”h]”hŒ__u64”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1háhjÞ  ubhŒ

directly.”…””}”(hjÞ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KžhjC  hžhubhØ)”}”(hŒŽThe storage is bound at attach time. Even if the program is attached to parent
and triggers in child, the storage still belongs to the parent.”h]”hŒŽThe storage is bound at attach time. Even if the program is attached to parent
and triggers in child, the storage still belongs to the parent.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K¥hjC  hžhubhØ)”}”(hŒ}Userspace cannot create a new entry in the map or delete an existing entry.
Program test runs always use a temporary storage.”h]”hŒ}Userspace cannot create a new entry in the map or delete an existing entry.
Program test runs always use a temporary storage.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K¨hjC  hžhubeh}”(h]”Œ	semantics”ah ]”h"]”Œ	semantics”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K|ubeh}”(h]”Œbpf-map-type-cgroup-storage”ah ]”h"]”Œbpf_map_type_cgroup_storage”ah$]”h&]”uh1hÂhhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÇNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j_  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j9  j6  j“  j  j@  j=  j1  j.  uŒ	nametypes”}”(j9  ‰j“  ‰j@  ‰j1  ‰uh}”(j6  hÄj  j;  j=  j–  j.  jC  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.