Provided by: libhwloc-doc_1.8-1ubuntu1_all

**NAME**

Distributing items over a topology -Functionsstatic inline voidhwloc_distributev(hwloc_topology_ttopology,hwloc_obj_t*root, unsigned n_roots,hwloc_cpuset_t*cpuset, unsigned n, unsigned until) static inline voidhwloc_distribute(hwloc_topology_ttopology,hwloc_obj_troot,hwloc_cpuset_t*set, unsigned n, unsigned until)

**Detailed** **Description**

**Function** **Documentation**

staticinlinevoidhwloc_distribute(hwloc_topology_ttopology,hwloc_obj_troot,hwloc_cpuset_t*set,unsignedn,unsigneduntil)[static]staticinlinevoidhwloc_distributev(hwloc_topology_ttopology,hwloc_obj_t*roots,unsignedn_roots,hwloc_cpuset_t*set,unsignedn,unsigneduntil)[static]Distribute n items over the topology under root. Distribute n items over the topology under roots. Array cpuset will be filled with n cpusets recursively distributed linearly over the topology under root, down to depth until (which can be INT_MAX to distribute down to the finest level). This is typically useful when an application wants to distribute n threads over a machine, giving each of them as much private cache as possible and keeping them locally in number order. The caller may typically want to also callhwloc_bitmap_singlify()before binding a thread so that it does not move at all.Note:This function requires the root object to have a CPU set. This is the same as hwloc_distribute, but takes an array of roots instead of just one root.Note:This function requires the roots objects to have a CPU set.

**Author**

Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code.