Index for Section 3

Alphabetical listing for H

Bottom of page

hostalias(3)
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
  name	    Points to the name of the host to retrieve aliases for.

  buf	    Specifies the buffer for the host alias.

  len	    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.

  [ESRCH]   Host alias could not be found.

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

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

Index for Section 3

Alphabetical listing for H

Top of page