Subversion Repositories HelenOS

Rev

Rev 4578 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (c) 2009 Lukas Mejdrech
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  *
  9.  * - Redistributions of source code must retain the above copyright
  10.  *   notice, this list of conditions and the following disclaimer.
  11.  * - Redistributions in binary form must reproduce the above copyright
  12.  *   notice, this list of conditions and the following disclaimer in the
  13.  *   documentation and/or other materials provided with the distribution.
  14.  * - The name of the author may not be used to endorse or promote products
  15.  *   derived from this software without specific prior written permission.
  16.  *
  17.  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18.  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20.  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21.  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26.  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27.  */
  28.  
  29. /** @addtogroup netdb
  30.  *  @{
  31.  */
  32.  
  33. /** @file
  34.  *  Structures and interfaces according to the BSD netdb.h file.
  35.  */
  36.  
  37. #ifndef __NET_NETDB_H__
  38. #define __NET_NETDB_H__
  39.  
  40. #include <sys/types.h>
  41.  
  42. /** Structure returned by network data base library.
  43.  *  All addresses are supplied in host order, and returned in network order (suitable for use in system calls).
  44.  */
  45. struct  hostent {
  46.     /** Official host name.
  47.      */
  48.     char *  h_name;
  49.     /** Alias list.
  50.      */
  51.     char ** h_aliases;
  52.     /** Host address type.
  53.      */
  54.     int     h_addrtype;
  55.     /** Address length.
  56.      */
  57.     int     h_length;
  58.     /** List of addresses from name server.
  59.      */
  60.     char ** h_addr_list;
  61.     /** Address, for backward compatiblity.
  62.      */
  63. #define h_addr  h_addr_list[ 0 ]
  64. };
  65.  
  66. /** @name Host entry address types definitions.
  67.  */
  68. /*@{*/
  69.  
  70. /** Authoritative Answer Host not found address type.
  71.  */
  72. #define HOST_NOT_FOUND  1
  73.  
  74. /** Non-Authoritive Host not found, or SERVERFAIL address type.
  75.  */
  76. #define TRY_AGAIN   2
  77.  
  78. /** Non recoverable errors, FORMERR, REFUSED, NOTIMP address type.
  79.  */
  80. #define NO_RECOVERY 3
  81.  
  82. /** Valid name, no data record of requested type address type.
  83.  */
  84. #define NO_DATA     4
  85.  
  86. /** No address, look for MX record address type.
  87.  */
  88. #define NO_ADDRESS  NO_DATA
  89.  
  90. /*@}*/
  91.  
  92. /** Returns host entry by the host address.
  93.  *  \todo address type?
  94.  *  @param address The host address. Input parameter.
  95.  *  @param len The address length. Input parameter.
  96.  *  @param type The address type. Input parameter.
  97.  *  @returns Host entry information.
  98.  */
  99. struct hostent *    gethostbyaddr( const void * address, int len, int type );
  100.  
  101. /** Returns host entry by the host name.
  102.  *  @param name The host name. Input parameter.
  103.  *  @returns Host entry information.
  104.  */
  105. struct hostent *    gethostbyname( const char * name );
  106.  
  107. #endif
  108.  
  109. /** @}
  110.  */
  111.