Linux Manuals session 3

NAME ares_getnameinfo – Address-to-nodename translation in protocol-independent manner SYNOPSIS #include <ares.h> typedef void (*ares_nameinfo_callback)(void *arg, int status, void ares_getnameinfo(ares_channel channel, const struct sockaddr *sa, ares_socklen_t salen, int flags, ares_nameinfo_callback callback, void *arg) DESCRIPTION The ares_getnameinfo function is defined for protocol-independent address translation. The function is a combination of ares_gethostbyaddr(3) and getservbyport(3). The function will translate…

NAME ares_gethostbyname_file – Lookup a name in the system’s hosts file SYNOPSIS #include <ares.h> int ares_gethostbyname_file(ares_channel channel, const char *name, int family, struct hostent **host) DESCRIPTION The ares_gethostbyname_file function performs a host lookup by name against the system’s hosts file (or equivalent local hostname database). The channel parameter is required, but no asynchronous queries are…

NAME ares_gethostbyname – Initiate a host query by name SYNOPSIS #include <ares.h> typedef void (*ares_host_callback)(void *arg, int status, void ares_gethostbyname(ares_channel channel, const char *name, int family, ares_host_callback callback, void *arg) DESCRIPTION The ares_gethostbyname function initiates a host query by name on the name service channel identified by channel. The parameter name gives the hostname as…

NAME ares_gethostbyaddr – Initiate a host query by address SYNOPSIS #include <ares.h> typedef void (*ares_host_callback)(void *arg, int status, void ares_gethostbyaddr(ares_channel channel, const void *addr, int addrlen, int family, ares_host_callback callback, void *arg) DESCRIPTION The ares_gethostbyaddr function initiates a host query by address on the name service channel identified by channel. The parameters addr and addrlen…

NAME ares_get_servers – Retrieve name servers from an initialized ares_channel SYNOPSIS #include <ares.h> int ares_get_servers(ares_channel channel, struct ares_addr_node **servers) DESCRIPTION The ares_get_servers(3) function retrieves name servers configuration from the channel data identified by channel, as a linked list of ares_addr_node structs storing a pointer to the first node at the address specified by servers. Function…

NAME ares_free_string – Free strings allocated by ares functions SYNOPSIS #include <ares.h> void ares_free_string(void *str) DESCRIPTION The ares_free_string function frees a string allocated by an ares function. SEE ALSO ares_mkquery(3) ares_expand_string(3) AUTHOR Greg Hudson, MIT Information Systems Copyright 2000 by the Massachusetts Institute of Technology. Index

NAME ares_free_hostent – Free host structure allocated by ares functions SYNOPSIS #include <ares.h> void ares_free_hostent(struct hostent *host) DESCRIPTION The ares_free_hostent function frees a struct hostent allocated by one of the functions ares_parse_a_reply(3), ares_parse_aaaa_reply(3), or ares_parse_ptr_reply(3). NOTES It is not necessary (and is not correct) to free the host structure passed to the callback functions for…

NAME ares_free_data – Free data allocated by several c-ares functions SYNOPSIS #include <ares.h> void ares_free_data(void *dataptr) cc file.c – lcares DESCRIPTION The ares_free_data(3) function frees one or more data structures allocated and returned by several c-ares functions. Specifically the data returned by the following list of functions must be deallocated using this function. ares_get_servers(3) When…

NAME ares_fds – Get file descriptors to select on for name service SYNOPSIS #include <ares.h> int ares_fds(ares_channel channel, fd_set *read_fds, DESCRIPTION The ares_fds function retrieves the set of file descriptors which the calling application should select on for reading and writing for the processing of name service queries pending on the name service channel identified…

NAME ares_expand_string – Expand a length encoded string SYNOPSIS #include <ares.h> int ares_expand_string(const unsigned char *encoded, const unsigned char *abuf, int alen, unsigned char **s, long *enclen) DESCRIPTION The ares_expand_string function converts a length encoded string to a NUL-terminated C string. The argument encoded gives the beginning of the encoded string, and the arguments abuf…

NAME ares_expand_name – Expand a DNS-encoded domain name SYNOPSIS #include <ares.h> int ares_expand_name(const unsigned char *encoded, const unsigned char *abuf, int alen, char **s, long *enclen) DESCRIPTION The ares_expand_name function converts a DNS-encoded domain name to a dot-separated C string. The argument encoded gives the beginning of the encoded domain name, and the arguments abuf…

NAME ares_dup – Duplicate a resolver channel SYNOPSIS #include <ares.h> int ares_dup(ares_channel *dest, ares_channel source) DESCRIPTION The ares_dup(3) function duplicates an existing communications channel for name service lookups. If it returns successfully, ares_dup(3) will set the variable pointed to by dest to a handle used to identify the name service channel. The caller should invoke…

NAME ares_destroy_options – Destroy options initialized with ares_save_options SYNOPSIS #include <ares.h> void ares_destroy_options(struct ares_options *options) DESCRIPTION The ares_destroy_options function destroys the options struct identified by options, freeing all memory allocated by ares_save_options. SEE ALSO ares_save_options(3), ares_init_options(3) AUTHOR Brad House Copyright 1998 by the Massachusetts Institute of Technology. Index

NAME ares_destroy – Destroy a resolver channel SYNOPSIS #include <ares.h> void ares_destroy(ares_channel channel) DESCRIPTION The ares_destroy function destroys the name service channel identified by channel, freeing all memory and closing all sockets used by the channel. ares_destroy invokes the callbacks for each pending query on the channel, passing a status of ARES_EDESTRUCTION. These calls give…

NAME ares_create_query – Compose a single-question DNS query buffer SYNOPSIS #include <ares.h> int ares_create_query(const char *name, int dnsclass, int type, DESCRIPTION The ares_create_query function composes a DNS query with a single question. The parameter name gives the query name as a NUL-terminated C string of period-separated labels optionally ending with a period; periods and backslashes…

NAME ares_cancel – Cancel a resolve SYNOPSIS #include <ares.h> void ares_cancel(ares_channel channel) DESCRIPTION The ares_cancel function cancels all lookups/requests made on the the name service channel identified by channel. ares_cancel invokes the callbacks for each pending query on the channel, passing a status of ARES_ECANCELLED. These calls give the callbacks a chance to clean up…

NAME arc4random arc4random_buf arc4random_uniform arc4random_stir arc4random_addrandom – arc4 random number generator LIBRARY Lb libbsd SYNOPSIS In bsd/stdlib.h Ft u_int32_t Fn arc4random void Ft void Fn arc4random_buf void *buf size_t nbytes Ft u_int32_t Fn arc4random_uniform u_int32_t upper_bound Ft void Fn arc4random_stir void Ft void Fn arc4random_addrandom unsigned char *dat int datlen DESCRIPTION The Fn arc4random function…

NAME arc4random arc4random_buf arc4random_uniform arc4random_stir arc4random_addrandom – arc4 random number generator LIBRARY Lb libbsd SYNOPSIS In bsd/stdlib.h Ft u_int32_t Fn arc4random void Ft void Fn arc4random_buf void *buf size_t nbytes Ft u_int32_t Fn arc4random_uniform u_int32_t upper_bound Ft void Fn arc4random_stir void Ft void Fn arc4random_addrandom unsigned char *dat int datlen DESCRIPTION The Fn arc4random function…

NAME arc4random arc4random_buf arc4random_uniform arc4random_stir arc4random_addrandom – arc4 random number generator LIBRARY Lb libbsd SYNOPSIS In bsd/stdlib.h Ft u_int32_t Fn arc4random void Ft void Fn arc4random_buf void *buf size_t nbytes Ft u_int32_t Fn arc4random_uniform u_int32_t upper_bound Ft void Fn arc4random_stir void Ft void Fn arc4random_addrandom unsigned char *dat int datlen DESCRIPTION The Fn arc4random function…

NAME arc4random arc4random_buf arc4random_uniform arc4random_stir arc4random_addrandom – arc4 random number generator LIBRARY Lb libbsd SYNOPSIS In bsd/stdlib.h Ft u_int32_t Fn arc4random void Ft void Fn arc4random_buf void *buf size_t nbytes Ft u_int32_t Fn arc4random_uniform u_int32_t upper_bound Ft void Fn arc4random_stir void Ft void Fn arc4random_addrandom unsigned char *dat int datlen DESCRIPTION The Fn arc4random function…