hwloc_topo...nd_support(3)

๐Ÿ’– hwloc_topology_membind_support ๐Ÿ’–

okay so bestie, this page is from the Library Functions Manual, and the main character is hwloc_topology_membind_support โ€” the memory-binding support flag moment for a topology. Itโ€™s giving โ€œwhat bind stuff is actually supported around here?โ€ โœจ


โœจ NAME โœจ

hwloc_topology_membind_support โ€” thatโ€™s the name, no cap. ๐Ÿ’…

๐ŸŽ€ SYNOPSIS ๐ŸŽ€

First things first, queen: include the header.

#include <hwloc.h>

๐Ÿฆ‹ Data Fields ๐Ÿฆ‹

Hereโ€™s the full flag lineup, and yes, every single one is an unsigned char:

  • unsigned char set_thisproc_membind
  • unsigned char get_thisproc_membind
  • unsigned char set_proc_membind
  • unsigned char get_proc_membind
  • unsigned char set_thisthread_membind
  • unsigned char get_thisthread_membind
  • unsigned char set_area_membind
  • unsigned char get_area_membind
  • unsigned char alloc_membind
  • unsigned char firsttouch_membind
  • unsigned char bind_membind
  • unsigned char interleave_membind
  • unsigned char nexttouch_membind
  • unsigned char migrate_membind
  • unsigned char get_area_memlocation
  • unsigned char weighted_interleave_membind

๐ŸŒธ Detailed Description ๐ŸŒธ

These are literally:

Flags describing actual memory binding support for this topology.

So like, this is the vibe check for memory-binding support on the topology. ๐Ÿ”ฅ

And hereโ€™s the important caveat, bestie:

A flag may be set even if the feature isn't supported in all cases (e.g. binding to random sets of non-contiguous objects).

Translation: donโ€™t assume a set flag means every possible wild case is covered. The original specifically calls out the โ€œrandom sets of non-contiguous objectsโ€ example, so keep that in mind. ๐Ÿซถ

๐Ÿ”ฅ Field Documentation ๐Ÿ”ฅ

unsigned char hwloc_topology_membind_support::alloc_membind

Allocating a bound memory area is supported โ€” slay. ๐Ÿ’–

unsigned char hwloc_topology_membind_support::bind_membind

The Bind policy is supported. Periodt. ๐Ÿ‘‘

unsigned char hwloc_topology_membind_support::firsttouch_membind

The First-touch policy is supported. ๐ŸŽ€

unsigned char hwloc_topology_membind_support::get_area_membind

Getting the binding of a given memory area is supported. Got it, bestie. ๐Ÿฆ‹

unsigned char hwloc_topology_membind_support::get_area_memlocation

Getting the last NUMA nodes where a memory area was allocated is supported. Thatโ€™s the tea. โ˜•

unsigned char hwloc_topology_membind_support::get_proc_membind

Getting the binding of a whole given process is supported. ๐Ÿ’œ

unsigned char hwloc_topology_membind_support::get_thisproc_membind

Getting the binding of the whole current process is supported. Hi bestie, thatโ€™s you. ๐Ÿซถ

unsigned char hwloc_topology_membind_support::get_thisthread_membind

Getting the binding of the current thread only is supported. Very โ€œmain character threadโ€ energy. ๐Ÿงš

unsigned char hwloc_topology_membind_support::interleave_membind

The Interleave policy is supported. ๐ŸŒˆ

unsigned char hwloc_topology_membind_support::migrate_membind

Migration flags are supported. ๐Ÿš€

unsigned char hwloc_topology_membind_support::nexttouch_membind

The Next-touch migration policy is supported. โœจ

unsigned char hwloc_topology_membind_support::set_area_membind

Binding a given memory area is supported. ๐Ÿ’…

unsigned char hwloc_topology_membind_support::set_proc_membind

Binding a whole given process is supported. ๐Ÿ”ฅ

unsigned char hwloc_topology_membind_support::set_thisproc_membind

Binding the whole current process is supported. ๐Ÿ‘‘

unsigned char hwloc_topology_membind_support::set_thisthread_membind

Binding the current thread only is supported. ๐ŸŽ€

unsigned char hwloc_topology_membind_support::weighted_interleave_membind

The Weighted interleave policy is supported. Iconic, honestly. ๐ŸŒŸ

๐Ÿงš Author ๐Ÿงš

This page was generated automatically by Doxygen for Hardware Locality (hwloc) from the source code. No mysterious manpage goblin hand-wrote this one, bestie. ๐Ÿ’œ


Cute sign-off time: the footerโ€™s source/version is Hardware Locality (hwloc), Version 2.15.0, and the page name down there is hwloc_topo...nd_support(3). The original footer doesnโ€™t print a separate date, so weโ€™re not inventing one ๐Ÿ˜Œ. Bye bestie! ๐Ÿ’–โœจ

๐Ÿ“ฆ where this page comes from