ARES_SET_SORTLIST(3)

💅 ARES_SET_SORTLIST — the sort your DNS results era

okay bestie, gather round, because this one is from the Library Functions Manual and it is lowkey iconic. We're talking ares_set_sortlist(3), the function that decides what order your addresses come back in. Main character energy fr fr. 🎀

✨ NAME ✨

ares_set_sortlist — Initialize an ares_channel_t *sortlist configuration 🦋

✨ SYNOPSIS ✨

#include <ares.h>

int ares_set_sortlist(ares_channel_t *channel, const char *sortstr)

like, two args, one int, we're literally so back 💅

✨ DESCRIPTION ✨

so the ares_set_sortlist(3) function initializes an address sortlist configuration for the channel data identified by channel, so that addresses returned by ares_gethostbyname(3) are sorted according to the sortlist. no cap, it's giving custom order 👑

The sortstr string you hand it holds a space separated list of IP-address-netmask pairs. The netmask is optional — but if it's there, it follows the address after a slash. For example:

"130.155.160.0/255.255.240.0 130.155.0.0"

see how the second one said "no netmask for me, I'm free"? yeah. optional fr.

⚠️ heads up bestie: this function replaces any potentially previously configured address sortlist with the ones given in the configuration string. so if you had a sortlist before, it's gone-gone. bye. 💀

✨ RETURN VALUES ✨

ares_set_sortlist(3) may return any of the following values, and yes we're listing every single one because we don't skip ✨

• ARES_SUCCESS — the sortlist configuration was successfully initialized. slay!! 🎉
• ARES_ENOMEM — the process's available memory was exhausted. 😭 tragic.
• ARES_ENODATA — the channel data identified by channel was invalid. 🚩
• ARES_ENOTINITIALIZED — c-ares library initialization not yet performed. bestie you gotta init first!! 🙈

✨ SEE ALSO ✨

• ares_init_options(3)
• ares_dup(3)

go read those too, iykyk 🫶

✨ AVAILABILITY ✨

ares_set_sortlist(3) was added in c-ares 1.11.0 ⭐

and that's the whole page, bestie 💖 this one came from the Library Functions Manual and was dated 23 November 2015 — a vintage classic, honestly, still serving looks. now go sort those addresses. periodt. 🌈💅✨