hwlocality_linux - Man Page
Linux-specific helpers
Synopsis
Functions
int hwloc_linux_set_tid_cpubind (hwloc_topology_t topology, pid_t tid, hwloc_const_cpuset_t set)
int hwloc_linux_get_tid_cpubind (hwloc_topology_t topology, pid_t tid, hwloc_cpuset_t set)
int hwloc_linux_get_tid_last_cpu_location (hwloc_topology_t topology, pid_t tid, hwloc_bitmap_t set)
int hwloc_linux_read_path_as_cpumask (const char *path, hwloc_bitmap_t set)
Detailed Description
This includes helpers for manipulating Linux kernel cpumap files, and hwloc equivalents of the Linux sched_setaffinity and sched_getaffinity system calls.
Function Documentation
int hwloc_linux_get_tid_cpubind (hwloc_topology_t topology, pid_t tid, hwloc_cpuset_t set)
Get the current binding of thread tid
. The CPU-set set
(previously allocated by the caller) is filled with the list of PUs which the thread was last bound to.
The behavior is exactly the same as the Linux sched_getaffinity system call, but uses a hwloc cpuset.
Returns
0 on success, -1 on error.
- Note
This is equivalent to calling hwloc_get_proc_cpubind() with HWLOC_CPUBIND_THREAD as flags.
int hwloc_linux_get_tid_last_cpu_location (hwloc_topology_t topology, pid_t tid, hwloc_bitmap_t set)
Get the last physical CPU where thread tid
ran. The CPU-set set
(previously allocated by the caller) is filled with the PU which the thread last ran on.
Returns
0 on success, -1 on error.
- Note
This is equivalent to calling hwloc_get_proc_last_cpu_location() with HWLOC_CPUBIND_THREAD as flags.
int hwloc_linux_read_path_as_cpumask (const char * path, hwloc_bitmap_t set)
Convert a linux kernel cpumask file path
into a hwloc bitmap set
. Might be used when reading CPU set from sysfs attributes such as topology and caches for processors, or local_cpus for devices.
Returns
0 on success, -1 on error.
- Note
This function ignores the HWLOC_FSROOT environment variable.
int hwloc_linux_set_tid_cpubind (hwloc_topology_t topology, pid_t tid, hwloc_const_cpuset_t set)
Bind a thread tid
on cpus given in cpuset set
. The behavior is exactly the same as the Linux sched_setaffinity system call, but uses a hwloc cpuset.
Returns
0 on success, -1 on error.
- Note
This is equivalent to calling hwloc_set_proc_cpubind() with HWLOC_CPUBIND_THREAD as flags.
Author
Generated automatically by Doxygen for Hardware Locality (hwloc) from the source code.
Referenced By
The man pages hwloc_linux_get_tid_cpubind(3), hwloc_linux_get_tid_last_cpu_location(3), hwloc_linux_read_path_as_cpumask(3) and hwloc_linux_set_tid_cpubind(3) are aliases of hwlocality_linux(3).