epan/resolv.h

   1 /* resolv.h
   2  * Definitions for network object lookup
   3  *
   4  * $Id: resolv.h,v 1.7 2001/08/21 06:39:17 guy Exp $
   5  *
   6  * Laurent Deniel <deniel@worldnet.fr>
   7  *
   8  * Ethereal - Network traffic analyzer
   9  * By Gerald Combs <gerald@zing.org>
  10  * Copyright 1998 Gerald Combs
  11  *
  12  *
  13  * This program is free software; you can redistribute it and/or
  14  * modify it under the terms of the GNU General Public License
  15  * as published by the Free Software Foundation; either version 2
  16  * of the License, or (at your option) any later version.
  17  *
  18  * This program is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU General Public License for more details.
  22  *
  23  * You should have received a copy of the GNU General Public License
  24  * along with this program; if not, write to the Free Software
  25  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  26  */
  27
  28 #ifndef __RESOLV_H__
  29 #define __RESOLV_H__
  30
  31 #ifndef MAXNAMELEN
  32 #define MAXNAMELEN      64      /* max name length (hostname and port name) */
  33 #endif
  34
  35 /* global variables */
  36
  37 extern gchar *g_ethers_path;
  38 extern gchar *g_ipxnets_path;
  39 extern gchar *g_pethers_path;
  40 extern gchar *g_pipxnets_path;
  41
  42 /* Functions in resolv.c */
  43
  44 /* get_tcp_port returns the UDP port name or "%u" if not found */
  45 extern guchar *get_udp_port(guint port);
  46
  47 /* get_tcp_port returns the TCP port name or "%u" if not found */
  48 extern guchar *get_tcp_port(guint port);
  49
  50 /* get_sctp_port returns the SCTP port name or "%u" if not found */
  51 extern guchar *get_sctp_port(guint port);
  52
  53 /* get_hostname returns the host name or "%d.%d.%d.%d" if not found */
  54 extern guchar *get_hostname(guint addr);
  55
  56 /* get_hostname returns the host name, or numeric addr if not found */
  57 struct e_in6_addr;
  58 const guchar* get_hostname6(struct e_in6_addr *ad);
  59
  60 /* get_ether_name returns the logical name if found in ethers files else
  61    "<vendor>_%02x:%02x:%02x" if the vendor code is known else
  62    "%02x:%02x:%02x:%02x:%02x:%02x" */
  63 extern guchar *get_ether_name(const guint8 *addr);
  64
  65 /* get_ether_name returns the logical name if found in ethers files else NULL */
  66 extern guchar *get_ether_name_if_known(const guint8 *addr);
  67
  68 /* get_manuf_name returns the vendor name or "%02x:%02x:%02x" if not known */
  69 extern const guchar *get_manuf_name(const guint8 *addr);
  70
  71 /* get_ipxnet_name returns the logical name if found in an ipxnets file,
  72  * or a string formatted with "%X" if not */
  73 extern const guchar *get_ipxnet_name(const guint32 addr);
  74
  75 /* returns the ethernet address corresponding to name or NULL if not known */
  76 extern guint8 *get_ether_addr(const guchar *name);
  77
  78 /* returns the ipx network corresponding to name. If name is unknown,
  79  * 0 is returned and 'known' is set to FALSE. On success, 'known'
  80  * is set to TRUE. */
  81 guint32 get_ipxnet_addr(const guchar *name, gboolean *known);
  82
  83 /* adds a hostname/IP in the hash table */
  84 extern void add_host_name(guint addr, const guchar *name);
  85
  86 /* add ethernet address / name corresponding to IP address  */
  87 extern void add_ether_byip(guint ip, const guint8 *eth);
  88
  89 /* Translates a string representing the hostname or dotted-decimal IP address
  90  * into a numeric IP address value, returning TRUE if it succeeds and
  91  * FALSE if it fails. */
  92 gboolean get_host_ipaddr(const char *host, guint32 *addrp);
  93
  94 /*
  95  * Translate IPv6 numeric address or FQDN hostname, into binary IPv6 address.
  96  * Return TRUE if we succeed and set "*addrp" to that numeric IP address;
  97  * return FALSE if we fail.
  98  */
  99 gboolean get_host_ipaddr6(const char *host, struct e_in6_addr *addrp);
 100
 101 #endif /* __RESOLV_H__ */