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

  
 
  

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

NAME
     hwlocality_windows - Windows-specific helpers

SYNOPSIS
   Functions
     int  hwloc_windows_get_nr_processor_groups  (hwloc_topology_t topology, un-
	 signed long flags)
     int  hwloc_windows_get_processor_group_cpuset  (hwloc_topology_t  topology,
	 unsigned pg_index, hwloc_cpuset_t cpuset, unsigned long flags)

Detailed Description
     These  functions query Windows processor groups. These groups partition the
     operating system into virtual sets of up to 64 neighbor  PUs.  Threads  and
     processes may only be bound inside a single group. Although Windows proces-
     sor  groups may be exposed in the hwloc hierarchy as hwloc Groups, they are
     also often merged into existing hwloc objects such as NUMA nodes  or  Pack-
     ages. This API provides explicit information about Windows processor groups
     so  that  applications  know whether binding to a large set of PUs may fail
     because it spans over multiple Windows processor groups.

Function Documentation
   int	hwloc_windows_get_nr_processor_groups  (hwloc_topology_t  topology,  un-
     signed long flags)
     Get the number of Windows processor groups. flags must be 0 for now.

     Returns
	 at least 1 on success.

	 -1  on  error,  for instance if the topology does not match the current
	 system (e.g. loaded from another machine through XML).

   int hwloc_windows_get_processor_group_cpuset (hwloc_topology_t topology,  un-
     signed pg_index, hwloc_cpuset_t cpuset, unsigned long flags)
     Get the CPU-set of a Windows processor group. Get the set of PU included in
     the  processor  group specified by pg_index. pg_index must be between 0 and
     the value returned by hwloc_windows_get_nr_processor_groups() minus 1.

     flags must be 0 for now.

     Returns
	 0 on success.

	 -1 on error, for instance if pg_index is invalid, or  if  the	topology
	 does  not  match  the	current system (e.g. loaded from another machine
	 through XML).

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

Hardware Locality (hwloc)	 Version 2.12.1 	   hwlocality_windows(3)

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

home | help