Index for Section 3

Alphabetical listing for H

Bottom of page

hostalias(3)
NAME
  hostalias - 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
  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.

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

Index for Section 3

Alphabetical listing for H

Top of page