#include <cat/catutil.h>
catnet_host *catnet_hostbyaddr(const char *addr);
The returned catnet_host structure looks as follows:
typedef struct catnet_host {
char **names; /* name, alias, ..., NULL */
char **addrs; /* addresses, as strings, NULL-terminated */
} catnet_host;
Where names is a NULL-terminated array of strings in which names[0]
is the official name and the rest are the different alias names.
addrs is a NULL-terminated array of addresses specified as strings (in dotted
decimal notation).
The entire catnet_host struct is stored in a single area of memory allocated by the function. This
memory must be freed by a single call to free().
If no data was found, NULL is returned.