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 allo-
     cated 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_CPU-
	 BIND_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_CPU-
	 BIND_THREAD as flags.

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

Hardware Locality (hwloc)	 Version 2.12.1 	     hwlocality_linux(3)

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

home | help