ping\_iterator\_get\_context(3) liboping ping\_iterator\_get\_context(3)

# [NAME](#NAME)

ping\_iterator\_get\_context, ping\_iterator\_set\_context - Store host-dependent data

# [SYNOPSIS](#SYNOPSIS)

```
  #include <oping.h>
  void *ping_iterator_get_context (pingobj_iter_t *iter);
  void  ping_iterator_set_context (pingobj_iter_t *iter, void *context);
```

# [DESCRIPTION](#DESCRIPTION)

**ping\_iterator\_set\_context** can be used to store host-specific data within the liboping structures. This data can be received again by calling **ping\_iterator\_get\_context**. The data itself is never touched by liboping. If you call ping\_host\_remove (see [**ping\_host\_add**(3)](/man/os/liboping/ping_host_add.3)) or ping\_destroy (see [**ping\_construct**(3)](/man/os/liboping/ping_construct.3)) and the context is not NULL liboping will assume you know what you're doing and simply ignore the fact this might be a memory leak.

The *iter* argument is an iterator object as returned by [**ping\_iterator\_get**(3)](/man/os/liboping/ping_iterator_get.3) and ping\_iterator\_next.

The *context* argument of **ping\_iterator\_set\_context** is a pointer to anything and may be NULL.

# [RETURN VALUE](#RETURN_VALUE)

**ping\_iterator\_get\_context** returns the same pointer previously passed to **ping\_iterator\_set\_context** or NULL if **ping\_iterator\_set\_context** has never been called before.

# [SEE ALSO](#SEE_ALSO)

[**ping\_iterator\_get**(3)](/man/os/liboping/ping_iterator_get.3), [**ping\_construct**(3)](/man/os/liboping/ping_construct.3), [**ping\_host\_add**(3)](/man/os/liboping/ping_host_add.3), [**liboping**(3)](/man/os/liboping/liboping.3)

# [AUTHOR](#AUTHOR)

liboping is written by Florian "octo" Forster &lt;ff at octo.it&gt;. Its homepage can be found at &lt;http://noping.cc/&gt;.

Copyright (c) 2006-2017 by Florian "octo" Forster.

2026-08-31 1.10.0

---

Document: ping_iterator_get_context(3) from liboping 1.10.0-r6 (Chainguard OS)
Source: https://github.com/octo/liboping.git