ping_host_add(3)

📦
version 1.10.0 · 8 versions
, in alpine 3.24, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ NAME ✨

ping_host_add — bestie, this is literally the function that adds a host to a liboping object 🎀 (it's from the liboping manual, section 3, iykyk)

🌸 SYNOPSIS 🌸

#include <oping.h>

int ping_host_add    (pingobj_t *obj, const char *host);
int ping_host_remove (pingobj_t *obj, const char *host);

okay so two little icons live here and they're a matching set, we love a duo 💅

💖 DESCRIPTION 💖

So ping_host_add is the main character here. What it does is: it tries to resolve the host argument, open a socket, and then associate everything with the liboping object obj. Like it's matching them up. Obsessed.

The obj argument is a pointer to a liboping object, as returned by ping_construct(3). So you don't just make one out of thin air, bestie, you gotta get it from there first 🫶

The host parameter is a '\0' terminated string which gets interpreted as a hostname or an IP address. Depending on the address family setting — which you set with ping_setopt(3) — the hostname gets resolved to an IPv4 or an IPv6 address. It's giving "choose your fighter" ✨

Then there's ping_host_remove. This one looks for host inside obj and removes it if it's found. And it's thorough too: it will close the socket and deallocate the memory, too. Cleanup queen 👑

⚠️ The names passed to ping_host_add and ping_host_remove must match. Like, exactly. And if you're sitting there going "wait, what name did I use", you can query it using ping_iterator_get_info(3) 💀

🔥 RETURN VALUE 🔥

If ping_host_add succeeds it returns zero. If an error occurs, a value less than zero is returned and the last error is saved internally. You can receive that error message using ping_get_error(3). So you're never left on read 😭

ping_host_remove returns zero upon success and less than zero if it failed. Currently the only reason for failure is that the host isn't found, but this is subject to change. Use ping_get_error(3) to receive the error message.

🌈 SEE ALSO 🌈

👑 AUTHOR 👑

liboping is written by Florian "octo" Forster <ff at octo.it>. Its homepage can be found at <http://noping.cc/>. Absolute icon behavior, fr fr.

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

okay and that's the whole page bestie!! this was the liboping version 1.10.0, dated 2017-05-11 — ty for coming to my ted talk, go add some hosts 💖✨🦋🌸🎀💅🫶

📦 where this page comes from