Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
hwlocality_linux(3)	   Library Functions Manual	   hwlocality_linux(3)

NAME
       hwlocality_linux	- 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.

Hardware Locality (hwloc)	Version	2.11.2		   hwlocality_linux(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hwloc_linux_get_tid_cpubind&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help