hostalias(3)hostalias(3)NAMEhostalias - Search for host aliases
SYNOPSIS
#include <sys/types.h> #include <netinet/in.h> #include
<arpa/nameser.h> #include <resolv.h>
char *hostalias(
char *name );
The following function is supported in order to maintain backward com‐
patibility with previous versions of the operating system. int hostal‐
ias_r(
char *name,
char *buf,
int len );
PARAMETERS
Points to the name of the host to retrieve aliases for. Specifies the
buffer for the host alias. Specifies the length of buf.
DESCRIPTION
The hostalias() function searches for the alias associated with the
name. The HOSTALIASES environment variable defines the name of a file
in which aliases are kept, in the form:
host alias
NOTES
The hostalias_r() function is the reentrant version of the hostalias()
function. It is supported in order to maintain backward compatibility
with previous versions of the operating system. When successful,
hostalias_r() provides the alias name(s) in the buffer pointed at by
buf, and returns a value of 0 (zero). (This buffer should be at least
MAXDNAME characters.) Otherwise, it returns a value of -1 and may set
errno.
RETURN VALUES
Upon successful completion, the hostalias() function returns the host
alias. Otherwise, a null pointer is returned.
ERRORS
If the following condition occurs, the hostalias_r() function sets
errno to the corresponding value. Host alias could not be found. The
buf parameter is invalid or too small.
SEE ALSO
Functions: res_mkquery(3), getenv(3).
hostalias(3)