Documentation/bpf/cpumasks.rst

26 2.1 ``struct bpf_cpumask *``
29 ``struct bpf_cpumask *`` is a cpumask that is allocated by BPF, on behalf of a
34 2.1.1 ``struct bpf_cpumask *`` lifecycle
37 A ``struct bpf_cpumask *`` is allocated, acquired, and released, using the
54                 struct bpf_cpumask __kptr * cpumask;
64         static int cpumask_map_insert(struct bpf_cpumask *mask, u32 pid)
68                 struct bpf_cpumask *old;
98                 struct bpf_cpumask *cpumask;
114 2.1.1 ``struct bpf_cpumask *`` as kptrs
117 As mentioned and illustrated above, these ``struct bpf_cpumask *`` objects can
118 also be stored in a map and used as kptrs. If a ``struct bpf_cpumask *`` is in
124 	/* struct containing the struct bpf_cpumask kptr which is stored in the map. */
126 		struct bpf_cpumask __kptr * bpf_cpumask;
141 	 * struct bpf_cpumask * kptr that is stored in a map can
147 		struct bpf_cpumask *kptr;
151 		/* Assume a bpf_cpumask * kptr was previously stored in the map. */
157 		/* Acquire a reference to the bpf_cpumask * kptr that's already stored in the map. */
160 			/* If no bpf_cpumask was present in the map, it's because
181 being queried, mutated, etc. A ``struct bpf_cpumask`` wraps a ``struct
183 **not** safe to cast a ``struct cpumask *`` to a ``struct bpf_cpumask *``, and
187 ``struct bpf_cpumask *`` as that argument. Any argument that simply queries the
194 etc a ``struct bpf_cpumask *``. This section of the document will describe the
202 argument must be a ``struct bpf_cpumask *``, as described above).
211 a CPU in a ``struct bpf_cpumask`` respectively:
227                 struct bpf_cpumask *cpumask;
263 We can also set and clear entire ``struct bpf_cpumask *`` objects in one
291                 struct bpf_cpumask *mask1, *mask2, *dst1, *dst2;