Content-type: text/html Man page of hostalias

hostalias

Section: C Library Functions (3)
Index Return to Main Contents
 

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

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.  

RELATED INFORMATION

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


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:55 GMT, October 02, 2010