hwlocality\_distances\_remove(3) Library Functions Manual hwlocality\_distances\_remove(3)

# [NAME](#NAME)

hwlocality\_distances\_remove - Remove distances between objects

# [SYNOPSIS](#SYNOPSIS)

## [Functions](#Functions)

int **hwloc\_distances\_remove** (**hwloc\_topology\_t** topology)  
int **hwloc\_distances\_remove\_by\_depth** (**hwloc\_topology\_t** topology, int depth)  
int **hwloc\_distances\_remove\_by\_type** (**hwloc\_topology\_t** topology, **hwloc\_obj\_type\_t** type)  
int **hwloc\_distances\_release\_remove** (**hwloc\_topology\_t** topology, struct **hwloc\_distances\_s** \*distances)

# [Detailed Description](#Detailed_Description)

# [Function Documentation](#Function_Documentation)

## [int hwloc\_distances\_release\_remove (**hwloc\_topology\_t** topology, struct **hwloc\_distances\_s** * distances)](#int_hwloc_distances_release_remove_%28)

Release and remove the given distance matrice from the topology. This function includes a call to **hwloc\_distances\_release()**.

**Returns**

0 on success, -1 on error.

## [int hwloc\_distances\_remove (**hwloc\_topology\_t** topology)](#int_hwloc_distances_remove_%28)

Remove all distance matrices from a topology. Remove all distance matrices, either provided by the user or gathered through the OS.

If these distances were used to group objects, these additional Group objects are not removed from the topology.

**Returns**

0 on success, -1 on error.

## [int hwloc\_distances\_remove\_by\_depth (**hwloc\_topology\_t** topology, int depth)](#int_hwloc_distances_remove_by_depth_%28)

Remove distance matrices for objects at a specific depth in the topology. Identical to **hwloc\_distances\_remove()** but only applies to one level of the topology.

**Returns**

0 on success, -1 on error.

## [int hwloc\_distances\_remove\_by\_type (**hwloc\_topology\_t** topology, **hwloc\_obj\_type\_t** type) \[inline\]](#int_hwloc_distances_remove_by_type_%28)

Remove distance matrices for objects of a specific type in the topology. Identical to **hwloc\_distances\_remove()** but only applies to one level of the topology.

**Returns**

0 on success, -1 on error.

# [Author](#Author)

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

Version 2.15.0 Hardware Locality (hwloc)

---

Document: hwloc_distances_remove_by_depth(3) from hwloc-cuda-12.6 2.15.0-r0 (Chainguard OS)
Source: https://github.com/open-mpi/hwloc