addr_resolv.h

Go to the documentation of this file.

 
/* The buffers returned by these functions are all allocated with a
 * packet lifetime and does not 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
 * you must copy the content to an wmem_file_scope() buffer.
 */
 
#ifndef __RESOLV_H__
#define __RESOLV_H__
 
#include <epan/address.h>
#include <epan/tvbuff.h>
#include <wsutil/inet_cidr.h>
#include <epan/to_str.h>
#include <wiretap/wtap.h>
#include "ws_symbol_export.h"
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
#ifndef MAXNAMELEN
#define MAXNAMELEN      64  /* max name length (most names: DNS labels, services, eth) */
#endif
 
#ifndef MAXVLANNAMELEN
#define MAXVLANNAMELEN      128 /* max vlan name length */
#endif
 
#ifndef MAXDNSNAMELEN
#define MAXDNSNAMELEN   256 /* max total length of a domain name in the DNS */
#endif
 
#define BASE_ENTERPRISES     BASE_CUSTOM
#define STRINGS_ENTERPRISES  CF_FUNC(enterprises_base_custom)
 
typedef struct _e_addr_resolve {
  bool mac_name;                          
  bool network_name;                      
  bool transport_name;                    
  bool dns_pkt_addr_resolution;           
  bool handshake_sni_addr_resolution;     
  bool use_external_net_name_resolver;    
  bool vlan_name;                         
  bool ss7pc_name;                        
  bool maxmind_geoip;                     
  bool tac_name;                          
} e_addr_resolve;
 
#define ADDR_RESOLV_MACADDR(at) \
    (((at)->type == AT_ETHER) || ((at)->type == AT_EUI64))
 
#define ADDR_RESOLV_NETADDR(at) \
    (((at)->type == AT_IPv4) || ((at)->type == AT_IPv6) || ((at)->type == AT_IPX))
 
struct hashether;
typedef struct hashether hashether_t;
 
struct hasheui64;
typedef struct hasheui64 hasheui64_t;
 
struct hashwka;
typedef struct hashwka hashwka_t;
 
struct hashmanuf;
typedef struct hashmanuf hashmanuf_t;
 
typedef struct _serv_port_key {
    uint16_t          port;
    port_type         type;
} serv_port_key_t;
 
/* Used for manually edited DNS resolved names */
typedef struct _resolved_name {
    char             name[MAXDNSNAMELEN];
} resolved_name_t;
 
/*
 * Flags for various resolved name hash table entries.
 */
#define TRIED_RESOLVE_ADDRESS    (1U<<0)  /* name resolution is being/has been tried */
#define NAME_RESOLVED            (1U<<1)  /* the name field contains a host name, not a printable address */
#define RESOLVED_ADDRESS_USED    (1U<<2)  /* a get_hostname* call returned the host name */
#define STATIC_HOSTNAME          (1U<<3)  /* do not update entries from hosts file with DNS responses */
#define NAME_RESOLVED_PREFIX     (1U<<4)  /* name was generated from a prefix (e.g., OUI) instead of the entire address */
 
#define TRIED_OR_RESOLVED_MASK   (TRIED_RESOLVE_ADDRESS | NAME_RESOLVED)
#define USED_AND_RESOLVED_MASK   (NAME_RESOLVED | RESOLVED_ADDRESS_USED)
 
/*
 * Flag controlling what names to resolve.
 */
WS_DLL_PUBLIC e_addr_resolve gbl_resolv_flags;
 
/* global variables */
 
extern char *g_ethers_path;
extern char *g_ipxnets_path;
extern char *g_pethers_path;
extern char *g_pipxnets_path;
 
/* Functions in addr_resolv.c */
 
WS_DLL_PUBLIC hashipv4_t * new_ipv4(const unsigned addr);
 
WS_DLL_PUBLIC bool fill_dummy_ip4(const unsigned addr, hashipv4_t* volatile tp);
 
WS_DLL_PUBLIC char *udp_port_to_display(wmem_allocator_t *allocator, unsigned port);
 
 
WS_DLL_PUBLIC char *tcp_port_to_display(wmem_allocator_t *allocator, unsigned port);
 
WS_DLL_PUBLIC char *dccp_port_to_display(wmem_allocator_t *allocator, unsigned port);
 
WS_DLL_PUBLIC char *sctp_port_to_display(wmem_allocator_t *allocator, unsigned port);
 
WS_DLL_PUBLIC const char *serv_name_lookup(port_type proto, unsigned port);
 
WS_DLL_PUBLIC const char *enterprises_lookup(uint32_t value, const char *unknown_str);
 
WS_DLL_PUBLIC const char *try_enterprises_lookup(uint32_t value);
 
WS_DLL_PUBLIC void enterprises_base_custom(char *buf, uint32_t value);
 
WS_DLL_PUBLIC const char *try_serv_name_lookup(port_type proto, unsigned port);
 
WS_DLL_PUBLIC char *port_with_resolution_to_str(wmem_allocator_t *scope,
                                        port_type proto, unsigned port);
 
WS_DLL_PUBLIC int port_with_resolution_to_str_buf(char *buf, unsigned long buf_size,
                                        port_type proto, unsigned port);
 
/*
 * Asynchronous host name lookup initialization, processing, and cleanup
 */
 
/* Setup name resolution preferences */
struct pref_module;
extern void addr_resolve_pref_init(struct pref_module *nameres);
extern void addr_resolve_pref_apply(void);
 
WS_DLL_PUBLIC void disable_name_resolution(void);
 
WS_DLL_PUBLIC bool host_name_lookup_process(void);
 
WS_DLL_PUBLIC const char *get_hostname(const unsigned addr);
 
WS_DLL_PUBLIC char *get_hostname_wmem(wmem_allocator_t *allocator, const unsigned addr);
 
WS_DLL_PUBLIC const char *get_hostname6(const ws_in6_addr *ad);
 
WS_DLL_PUBLIC char *get_hostname6_wmem(wmem_allocator_t *allocator, const ws_in6_addr *ad);
 
WS_DLL_PUBLIC const char *get_ether_name(const uint8_t *addr);
 
WS_DLL_PUBLIC const char *get_hostname_ss7pc(const uint8_t ni, const uint32_t pc);
 
WS_DLL_PUBLIC void fill_unresolved_ss7pc(const char * pc_addr, const uint8_t ni, const uint32_t pc);
 
WS_DLL_PUBLIC const char *tvb_get_ether_name(tvbuff_t *tvb, unsigned offset);
 
WS_DLL_PUBLIC const char *get_ether_name_if_known(const uint8_t *addr);
 
extern const char *get_manuf_name(const uint8_t *addr, size_t size);
 
WS_DLL_PUBLIC const char *get_manuf_name_if_known(const uint8_t *addr, size_t size);
 
WS_DLL_PUBLIC const char *uint_get_manuf_name_if_known(const uint32_t oid);
 
WS_DLL_PUBLIC const char *tvb_get_manuf_name(tvbuff_t *tvb, unsigned offset);
 
WS_DLL_PUBLIC const char *tvb_get_manuf_name_if_known(tvbuff_t *tvb, unsigned offset);
 
extern const char *get_eui64_name(const uint8_t *addr);
 
WS_DLL_PUBLIC char *eui64_to_display(wmem_allocator_t *allocator, const uint64_t addr);
 
WS_DLL_PUBLIC char *get_ipxnet_name(wmem_allocator_t *allocator, const uint32_t addr);
 
WS_DLL_PUBLIC char *get_vlan_name(wmem_allocator_t *allocator, const uint16_t id);
 
WS_DLL_PUBLIC unsigned get_hash_ether_status(hashether_t* ether);
 
WS_DLL_PUBLIC bool get_hash_ether_used(hashether_t* ether);
 
WS_DLL_PUBLIC char* get_hash_ether_hexaddr(hashether_t* ether);
 
WS_DLL_PUBLIC char* get_hash_ether_resolved_name(hashether_t* ether);
 
WS_DLL_PUBLIC bool get_hash_manuf_used(hashmanuf_t* manuf);
 
WS_DLL_PUBLIC char* get_hash_manuf_resolved_name(hashmanuf_t* manuf);
 
WS_DLL_PUBLIC bool get_hash_wka_used(hashwka_t* wka);
 
WS_DLL_PUBLIC char* get_hash_wka_resolved_name(hashwka_t* wka);
 
WS_DLL_PUBLIC void add_ipv4_name(const unsigned addr, const char *name, const bool static_entry);
 
WS_DLL_PUBLIC void add_ipv6_name(const ws_in6_addr *addr, const char *name, const bool static_entry);
 
WS_DLL_PUBLIC bool add_hosts_file(const char *hosts_file);
 
WS_DLL_PUBLIC bool add_ip_name_from_string(const char *addr, const char *name);
 
WS_DLL_PUBLIC resolved_name_t* get_edited_resolved_name(const char* addr);
 
WS_DLL_PUBLIC addrinfo_lists_t *get_addrinfo_list(void);
 
WS_DLL_PUBLIC void add_ether_byip(const unsigned ip, const uint8_t *eth);
 
WS_DLL_PUBLIC
bool get_host_ipaddr(const char *host, uint32_t *addrp);
 
WS_DLL_PUBLIC
bool get_host_ipaddr6(const char *host, ws_in6_addr *addrp);
 
WS_DLL_PUBLIC
wmem_map_t *get_manuf_hashtable(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_wka_hashtable(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_eth_hashtable(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_serv_port_hashtable(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_ipxnet_hash_table(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_vlan_hash_table(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_ipv4_hash_table(void);
 
WS_DLL_PUBLIC
wmem_map_t *get_ipv6_hash_table(void);
 
 
/*
 * XXX - if we ever have per-session host name etc. information, we
 * should probably have the "resolve synchronously or asynchronously"
 * flag be per-session, set with an epan API.
 */
WS_DLL_PUBLIC
void set_resolution_synchrony(bool synchronous);
 
/*
 * private functions (should only be called by epan directly)
 */
 
WS_DLL_LOCAL
void name_resolver_init(void);
 
WS_DLL_LOCAL
void host_name_lookup_reset(const char* app_env_var_prefix);
 
WS_DLL_LOCAL
void addr_resolv_init(const char* app_env_var_prefix);
 
WS_DLL_LOCAL
void addr_resolv_cleanup(void);
 
WS_DLL_PUBLIC
bool str_to_ip(const char *str, void *dst);
 
WS_DLL_PUBLIC
bool str_to_ip6(const char *str, void *dst);
 
WS_DLL_LOCAL
bool str_to_eth(const char *str, uint8_t (*eth_bytes)[6]);
 
WS_DLL_LOCAL
unsigned ipv6_oat_hash(const void *key);
 
WS_DLL_LOCAL
gboolean ipv6_equal(const void *v1, const void *v2);
 
WS_DLL_PUBLIC const char *tac_name_lookup(const unsigned addr);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* __RESOLV_H__ */