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

FreeBSD Manual Pages

  
 
  

home | help
hwlocality...ma_bitmask(3)  Library Functions Manual  hwlocality...ma_bitmask(3)

NAME
     hwlocality_linux_libnuma_bitmask - Interoperability with Linux libnuma bit-
     mask

SYNOPSIS
   Functions
     struct  bitmask  *  hwloc_cpuset_to_linux_libnuma_bitmask (hwloc_topology_t
	 topology, hwloc_const_cpuset_t cpuset)
     struct bitmask *  hwloc_nodeset_to_linux_libnuma_bitmask  (hwloc_topology_t
	 topology, hwloc_const_nodeset_t nodeset)
     int   hwloc_cpuset_from_linux_libnuma_bitmask  (hwloc_topology_t  topology,
	 hwloc_cpuset_t cpuset, const struct bitmask *bitmask)
     int  hwloc_nodeset_from_linux_libnuma_bitmask  (hwloc_topology_t  topology,
	 hwloc_nodeset_t nodeset, const struct bitmask *bitmask)

Detailed Description
     This  interface  helps  converting between Linux libnuma bitmasks and hwloc
     cpusets and nodesets.

     Note
	 Topology topology must match the current machine.

	 The behavior of libnuma is undefined if the kernel is	not  NUMA-aware.
	 (when	CONFIG_NUMA is not set in the kernel configuration). This helper
	 and libnuma may thus not be strictly compatible in this case, which may
	 be detected by checking whether numa_available() returns -1.

Function Documentation
   int	 hwloc_cpuset_from_linux_libnuma_bitmask   (hwloc_topology_t   topology,
     hwloc_cpuset_t cpuset, const struct bitmask * bitmask) [inline]
     Convert  libnuma  bitmask	bitmask into hwloc CPU set cpuset. This function
     may be used after calling many numa_ functions that use a struct bitmask as
     an output parameter.

     Returns
	 0 on success.

	 -1 with errno set to ENOMEM if some internal reallocation failed.

   struct  bitmask  *  hwloc_cpuset_to_linux_libnuma_bitmask   (hwloc_topology_t
     topology, hwloc_const_cpuset_t cpuset) [inline]
     Convert  hwloc  CPU  set  cpuset into the returned libnuma bitmask. The re-
     turned bitmask should later be freed with numa_bitmask_free.

     This function may be used before calling many numa_ functions  that  use  a
     struct bitmask as an input parameter.

     Returns
	 newly allocated struct bitmask, or NULL on error.

   int	 hwloc_nodeset_from_linux_libnuma_bitmask   (hwloc_topology_t  topology,
     hwloc_nodeset_t nodeset, const struct bitmask * bitmask) [inline]
     Convert libnuma bitmask bitmask into hwloc  NUMA  node  set  nodeset.  This
     function  may  be used after calling many numa_ functions that use a struct
     bitmask as an output parameter.

     Returns
	 0 on success.

	 -1 with errno set to ENOMEM if some internal reallocation failed.

   struct  bitmask  *  hwloc_nodeset_to_linux_libnuma_bitmask  (hwloc_topology_t
     topology, hwloc_const_nodeset_t nodeset) [inline]
     Convert  hwloc NUMA node set nodeset into the returned libnuma bitmask. The
     returned bitmask should later be freed with numa_bitmask_free.

     This function may be used before calling many numa_ functions  that  use  a
     struct bitmask as an input parameter.

     Returns
	 newly allocated struct bitmask, or NULL on error.

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

Hardware Locality (hwloc)	 Version 2.12.1       hwlocality...ma_bitmask(3)

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

home | help