capture/capture-pcap-util-int.h

   1 /** @file
   2  *
   3  * Definitions of routines internal to the libpcap/WinPcap/Npcap utilities
   4  *
   5  * Wireshark - Network traffic analyzer
   6  * By Gerald Combs <gerald@wireshark.org>
   7  * Copyright 1998 Gerald Combs
   8  *
   9  * SPDX-License-Identifier: GPL-2.0-or-later
  10  */
  11
  12 #ifndef __PCAP_UTIL_INT_H__
  13 #define __PCAP_UTIL_INT_H__
  14
  15 extern if_info_t *if_info_new(const char *name, const char *description,
  16         bool loopback);
  17 extern void if_info_add_address(if_info_t *if_info, struct sockaddr *addr);
  18 #ifdef HAVE_PCAP_REMOTE
  19 extern GList *get_interface_list_findalldevs_ex(const char *hostname,
  20     const char *port, int auth_type, const char *username, const char *passwd,
  21     int *err, char **err_str);
  22 #endif /* HAVE_PCAP_REMOTE */
  23 extern GList *get_interface_list_findalldevs(int *err, char **err_str);
  24
  25 extern if_capabilities_t *get_if_capabilities_local(interface_options *interface_opts,
  26     cap_device_open_status *status, char **status_str);
  27 extern pcap_t *open_capture_device_local(capture_options *capture_opts,
  28     interface_options *interface_opts, int timeout,
  29     cap_device_open_status *open_status,
  30     char (*open_status_str)[PCAP_ERRBUF_SIZE]);
  31 #ifdef HAVE_PCAP_CREATE
  32 extern if_capabilities_t *get_if_capabilities_pcap_create(interface_options *interface_opts,
  33     cap_device_open_status *status, char **status_str);
  34 extern pcap_t *open_capture_device_pcap_create(capture_options *capture_opts,
  35     interface_options *interface_opts, int timeout,
  36     cap_device_open_status *open_status,
  37     char (*open_status_str)[PCAP_ERRBUF_SIZE]);
  38 #endif /* HAVE_PCAP_CREATE */
  39 extern if_capabilities_t *get_if_capabilities_pcap_open_live(interface_options *interface_opts,
  40     cap_device_open_status *status, char **status_str);
  41 extern pcap_t *open_capture_device_pcap_open_live(interface_options *interface_opts,
  42     int timeout, cap_device_open_status *open_status,
  43     char (*open_status_str)[PCAP_ERRBUF_SIZE]);
  44
  45 /*
  46  * Get an error message string for a CANT_GET_INTERFACE_LIST error from
  47  * "get_interface_list()".  This is used to let the error message string
  48  * be platform-dependent.
  49  */
  50 extern char *cant_get_if_list_error_message(const char *err_str);
  51
  52 /*
  53  * Get a longer, secondary error message corrresponding to why getting
  54  * capabilities or opening a device failed. This is used to let the error
  55  * message string be platform-dependent.
  56  */
  57 extern const char *get_pcap_failure_secondary_error_message(cap_device_open_status open_status,
  58     const char *open_status_str);
  59
  60 #endif /* __PCAP_UTIL_INT_H__ */