*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
-/* The buffers returned by these functions are all allocated with a
- * packet lifetime and does not have have to be freed.
+/* The buffers returned by these functions are all allocated with a
+ * packet lifetime and does not have have to be freed.
* However, take into account that when the packet dissection
* completes, these buffers will be automatically reclaimed/freed.
* If you need the buffer to remain for a longer scope than packet lifetime
#define __RESOLV_H__
#include <epan/address.h>
+#include <epan/tvbuff.h>
+#include "ws_symbol_export.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
#ifndef MAXNAMELEN
#define MAXNAMELEN 64 /* max name length (hostname and port name) */
#endif
+typedef struct _e_addr_resolve {
+ gboolean mac_name;
+ gboolean network_name;
+ gboolean transport_name;
+ gboolean concurrent_dns;
+ gboolean use_external_net_name_resolver;
+ gboolean load_hosts_file_from_profile_only;
+} e_addr_resolve;
+
+
+typedef struct hashether {
+ guint status; /* (See above) */
+ guint8 addr[6];
+ char hexaddr[6*3];
+ char resolved_name[MAXNAMELEN];
+} hashether_t;
+
+typedef struct serv_port {
+ gchar *udp_name;
+ gchar *tcp_name;
+ gchar *sctp_name;
+ gchar *dccp_name;
+} serv_port_t;
+
/*
- * Flag controlling what names to resolve.
+ * XXX Some of this is duplicated in addrinfo_list. We may want to replace the
+ * addr and name parts with a struct addrinfo or create our own addrinfo-like
+ * struct that simply points to the data below.
*/
-ETH_VAR_IMPORT guint32 g_resolv_flags;
-
-/* 32 types are sufficient (as are 640k of RAM) */
-/* FIXME: Maybe MANUF/m, IP/i, IP6/6, IPX/x, UDP+TCP/t etc would be
- more useful/consistent */
-#define RESOLV_NONE 0x0
-#define RESOLV_MAC 0x1
-#define RESOLV_NETWORK 0x2
-#define RESOLV_TRANSPORT 0x4
-#define RESOLV_CONCURRENT 0x8
+typedef struct hashipv4 {
+ guint addr;
+ gboolean is_dummy_entry; /* name is IPv4 address in dot format */
+ gboolean resolve; /* already tried to resolve it */
+ gchar ip[16];
+ gchar name[MAXNAMELEN];
+} hashipv4_t;
-#define RESOLV_ALL_ADDRS (RESOLV_MAC|RESOLV_NETWORK|RESOLV_TRANSPORT)
-#define RESOLV_ALL 0xFFFFFFFF
+/*
+ * Flag controlling what names to resolve.
+ */
+WS_DLL_PUBLIC e_addr_resolve gbl_resolv_flags;
/* global variables */
extern gchar *g_pethers_path;
extern gchar *g_pipxnets_path;
-/* Functions in resolv.c */
-
-/* Set the flags controlling what names to resolve */
-extern void resolv_set_flags(guint32 flags);
+/* Functions in addr_resolv.c */
/*
* get_udp_port() returns the port name corresponding to that UDP port,
* or the port number as a string if not found.
*/
-extern gchar *get_udp_port(guint port);
+WS_DLL_PUBLIC gchar *get_udp_port(guint port);
/*
* get_tcp_port() returns the port name corresponding to that TCP port,
* or the port number as a string if not found.
*/
-extern gchar *get_tcp_port(guint port);
+WS_DLL_PUBLIC gchar *get_tcp_port(guint port);
/*
* get_dccp_port() returns the port name corresponding to that DCCP port,
* get_sctp_port() returns the port name corresponding to that SCTP port,
* or the port number as a string if not found.
*/
-extern gchar *get_sctp_port(guint port);
+WS_DLL_PUBLIC gchar *get_sctp_port(guint port);
/* get_addr_name takes as input an "address", as defined in address.h */
/* it returns a string that contains: */
/* - if the address is of a type that can be translated into a name, and the user */
/* has activated name resolution, the translated name */
/* - if the address is of type AT_NONE, a pointer to the string "NONE" */
-/* - if the address is of any other type, the result of address_to_str on the argument, */
+/* - if the address is of any other type, the result of ep_address_to_str on the argument, */
/* which should be a string representation for the answer -e.g. "10.10.10.10" for IPv4 */
/* address 10.10.10.10 */
-const gchar *get_addr_name(address *addr);
+WS_DLL_PUBLIC
+const gchar *get_addr_name(const address *addr);
+const gchar *se_get_addr_name(const address *addr);
/* get_addr_name_buf solves an address in the same way as get_addr_name above */
-/* The difference is that get_addr_name_buf takes as input a buffer, in which it puts */
-/* the result, and a maximum string length -size-. the buffer should be large enough to */
-/* contain size characters plus the terminator */
+/* The difference is that get_addr_name_buf takes as input a buffer, into which it puts */
+/* the result which is always NUL ('\0') terminated. The buffer should be large enough to */
+/* contain size characters including the terminator */
-void get_addr_name_buf(address *addr, gchar *buf, guint size);
+void get_addr_name_buf(const address *addr, gchar *buf, gsize size);
/*
* Asynchronous host name lookup initialization, processing, and cleanup
*/
-/* host_name_lookup_init fires up an ADNS socket if we're using ADNS */
-extern void host_name_lookup_init(void);
+/* Setup name resolution preferences */
+struct pref_module;
+extern void addr_resolve_pref_init(struct pref_module *nameres);
-/* host_name_lookup_process does ADNS processing in GTK+ timeouts in Ethereal,
- and before processing each packet in Tethereal, if we're using ADNS */
-extern gint host_name_lookup_process(gpointer data);
-
-/* host_name_lookup_cleanup cleans up an ADNS socket if we're using ADNS */
-extern void host_name_lookup_cleanup(void);
+/** If we're using c-ares or ADNS, process outstanding host name lookups.
+ * This is called from a GLIB timeout in Wireshark and before processing
+ * each packet in TShark.
+ *
+ * @return True if any new objects have been resolved since the previous
+ * call. This can be used to trigger a display update, e.g. in Wireshark.
+ */
+WS_DLL_PUBLIC gboolean host_name_lookup_process(void);
/* get_hostname returns the host name or "%d.%d.%d.%d" if not found */
-extern gchar *get_hostname(guint addr);
+WS_DLL_PUBLIC const gchar *get_hostname(const guint addr);
/* get_hostname6 returns the host name, or numeric addr if not found */
struct e_in6_addr;
-const gchar* get_hostname6(struct e_in6_addr *ad);
+WS_DLL_PUBLIC const gchar* get_hostname6(const struct e_in6_addr *ad);
/* get_ether_name returns the logical name if found in ethers files else
"<vendor>_%02x:%02x:%02x" if the vendor code is known else
"%02x:%02x:%02x:%02x:%02x:%02x" */
-extern gchar *get_ether_name(const guint8 *addr);
+WS_DLL_PUBLIC gchar *get_ether_name(const guint8 *addr);
/* get_ether_name returns the logical name if found in ethers files else NULL */
-extern gchar *get_ether_name_if_known(const guint8 *addr);
+gchar *get_ether_name_if_known(const guint8 *addr);
-/* get_manuf_name returns the vendor name or "%02x:%02x:%02x" if not known */
+/*
+ * Given a sequence of 3 octets containing an OID, get_manuf_name()
+ * returns the vendor name, or "%02x:%02x:%02x" if not known.
+ */
extern const gchar *get_manuf_name(const guint8 *addr);
-/* get_manuf_name returns the vendor name or NULL if not known */
-extern const gchar *get_manuf_name_if_known(const guint8 *addr);
+/*
+ * Given a sequence of 3 octets containing an OID, get_manuf_name_if_known()
+ * returns the vendor name, or NULL if not known.
+ */
+WS_DLL_PUBLIC const gchar *get_manuf_name_if_known(const guint8 *addr);
+
+/*
+ * Given an integer containing a 24-bit OID, uint_get_manuf_name()
+ * returns the vendor name, or "%02x:%02x:%02x" if not known.
+ */
+extern const gchar *uint_get_manuf_name(const guint oid);
+
+/*
+ * Given an integer containing a 24-bit OID, uint_get_manuf_name_if_known()
+ * returns the vendor name, or NULL if not known.
+ */
+extern const gchar *uint_get_manuf_name_if_known(const guint oid);
+
+/*
+ * Given a tvbuff and an offset in that tvbuff for a 3-octet OID,
+ * tvb_get_manuf_name() returns the vendor name, or "%02x:%02x:%02x"
+ * if not known.
+ */
+WS_DLL_PUBLIC const gchar *tvb_get_manuf_name(tvbuff_t *tvb, gint offset);
+
+/*
+ * Given a tvbuff and an offset in that tvbuff for a 3-octet OID,
+ * tvb_get_manuf_name_if_known() returns the vendor name, or NULL
+ * if not known.
+ */
+WS_DLL_PUBLIC const gchar *tvb_get_manuf_name_if_known(tvbuff_t *tvb, gint offset);
+
+/* get_eui64_name returns "<vendor>_%02x:%02x:%02x:%02x:%02x:%02x" if the vendor code is known
+ "%02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x" */
+extern const gchar *get_eui64_name(const guint64 addr);
+
+/* get_eui64_name_if_known returns "<vendor>_%02x:%02x:%02x:%02x:%02x:%02x" if the vendor code is known else NULL */
+extern const gchar *get_eui64_name_if_known(const guint64 addr);
+
/* get_ipxnet_name returns the logical name if found in an ipxnets file,
* or a string formatted with "%X" if not */
guint32 get_ipxnet_addr(const gchar *name, gboolean *known);
/* adds a hostname/IPv4 in the hash table */
-extern void add_ipv4_name(guint addr, const gchar *name);
+WS_DLL_PUBLIC void add_ipv4_name(const guint addr, const gchar *name);
/* adds a hostname/IPv6 in the hash table */
-extern void add_ipv6_name(struct e_in6_addr *addr, const gchar *name);
+WS_DLL_PUBLIC void add_ipv6_name(const struct e_in6_addr *addr, const gchar *name);
-/* add ethernet address / name corresponding to IP address */
-extern void add_ether_byip(guint ip, const guint8 *eth);
+/** Add an additional "hosts" file for IPv4 and IPv6 name resolution.
+ *
+ * The file can be added before host_name_lookup_init() is called and
+ * will be re-read each time host_name_lookup_init() is called.
+ *
+ * @param hosts_file Absolute path to the hosts file.
+ *
+ * @return TRUE if the hosts file can be read.
+ */
+WS_DLL_PUBLIC gboolean add_hosts_file (const char *hosts_file);
+
+/* adds a hostname in the hash table */
+WS_DLL_PUBLIC gboolean add_ip_name_from_string (const char *addr, const char *name);
+
+/** Get a list of host name to address mappings we know about.
+ *
+ * Each list element is an addrinfo struct with the following fields defined:
+ * - ai_family: 0, AF_INET or AF_INET6
+ * - ai_addrlen: Length of ai_addr
+ * - ai_canonname: Host name or NULL
+ * - ai_addr: Pointer to a struct sockaddr or NULL (see below)
+ * - ai_next: Next element or NULL
+ * All other fields are zero-filled.
+ *
+ * If ai_family is 0, this is a dummy entry which should only appear at the beginning of the list.
+ *
+ * If ai_family is AF_INET, ai_addr points to a struct sockaddr_in with the following fields defined:
+ * - sin_family: AF_INET
+ * - sin_addr: Host IPv4 address
+ * All other fields are zero-filled.
+ *
+ * If ai_family is AF_INET6, ai_addr points to a struct sockaddr_in6 with the following fields defined:
+ * - sin6_family: AF_INET6
+ * - sin6_addr: Host IPv6 address
+ * All other fields are zero-filled.
+ *
+ * The list and its elements MUST NOT be modified or freed.
+ *
+ * @return The first element in our list of known addresses. May be NULL.
+ */
+WS_DLL_PUBLIC struct addrinfo *get_addrinfo_list(void);
-/* Translates a string representing the hostname or dotted-decimal IP address
- * into a numeric IP address value, returning TRUE if it succeeds and
- * FALSE if it fails. */
+/* add ethernet address / name corresponding to IP address */
+extern void add_ether_byip(const guint ip, const guint8 *eth);
+
+/** Translates a string representing a hostname or dotted-decimal IPv4 address
+ * into a numeric IPv4 address value in network byte order. If compiled with
+ * c-ares, the request will wait a maximum of 250ms for the request to finish.
+ * Otherwise the wait time will be system-dependent, ususally much longer.
+ * Immediately returns FALSE for hostnames if network name resolution is
+ * disabled.
+ *
+ * @param[in] host The hostname.
+ * @param[out] addrp The numeric IPv4 address in network byte order.
+ * @return TRUE on success, FALSE on failure, timeout.
+ */
+WS_DLL_PUBLIC
gboolean get_host_ipaddr(const char *host, guint32 *addrp);
-/*
- * Translate IPv6 numeric address or FQDN hostname, into binary IPv6 address.
- * Return TRUE if we succeed and set "*addrp" to that numeric IP address;
- * return FALSE if we fail.
+/** Translates a string representing a hostname or colon-hex IPv6 address
+ * into a numeric IPv6 address value in network byte order. If compiled with
+ * c-ares, the request will wait a maximum of 250ms for the request to finish.
+ * Otherwise the wait time will be system-dependent, usually much longer.
+ * Immediately returns FALSE for hostnames if network name resolution is
+ * disabled.
+ *
+ * @param[in] host The hostname.
+ * @param[out] addrp The numeric IPv6 address in network byte order.
+ * @return TRUE on success, FALSE on failure or timeout.
*/
+WS_DLL_PUBLIC
gboolean get_host_ipaddr6(const char *host, struct e_in6_addr *addrp);
/*
* Return "ip6" if it is IPv6, "ip" otherwise (including the case
* that we don't know)
*/
+WS_DLL_PUBLIC
const char* host_ip_af(const char *host);
+WS_DLL_PUBLIC
+GHashTable *get_manuf_hashtable(void);
+
+WS_DLL_PUBLIC
+GHashTable *get_wka_hashtable(void);
+
+WS_DLL_PUBLIC
+GHashTable *get_eth_hashtable(void);
+
+WS_DLL_PUBLIC
+GHashTable *get_serv_port_hashtable(void);
+
+WS_DLL_PUBLIC
+GHashTable *get_ipv4_hash_table(void);
+
+/*
+ * private functions (should only be called by epan directly)
+ */
+
+WS_DLL_LOCAL
+void name_resolver_init(void);
+
+/* (Re)Initialize hostname resolution subsystem */
+WS_DLL_LOCAL
+void host_name_lookup_init(void);
+
+/* Clean up only hostname resolutions (so they don't "leak" from one
+ * file to the next).
+ */
+WS_DLL_LOCAL
+void host_name_lookup_cleanup(void);
+
+WS_DLL_LOCAL
+void addr_resolv_init(void);
+
+WS_DLL_LOCAL
+void addr_resolv_cleanup(void);
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
#endif /* __RESOLV_H__ */