NAME

hostalias − Searches 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 compatibility with previous versions of the operating system.  int hostalias_r(
        char ∗name,
        char ∗buf,
        int len);

PARAMETERS

namePoints to the name of the host to retrieve aliases for. 

bufSpecifies the buffer for the host alias. 

lenSpecifies 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:

hostalias

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. 

[ESRCH]Host alias could not be found. 

[EINVAL]The buf parameter is invalid or too small. 

RELATED INFORMATION

Functions: res_mkquery(3), getenv(3).