/* capture.h
* Definitions for packet capture windows
*
- * $Id: capture.h,v 1.13 1999/08/18 16:28:22 gram Exp $
+ * $Id$
*
* Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@zing.org>
+ * By Gerald Combs <gerald@ethereal.com>
* Copyright 1998 Gerald Combs
*
- *
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
- *
+ *
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
- *
+ *
* 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.
#ifndef __CAPTURE_H__
#define __CAPTURE_H__
+/** @file
+ * Capture related things.
+ */
+
+/** Name we give to the child process when doing a "-S" capture. */
+#define CHILD_NAME "ethereal-capture"
+
#ifdef HAVE_LIBPCAP
-#ifndef lib_pcap_h
-#include <pcap.h>
+/** Capture options coming from user interface */
+typedef struct {
+#ifdef _WIN32
+ int buffer_size; /**< the capture buffer size (MB) */
#endif
+ gboolean has_snaplen; /**< TRUE if maximum capture packet
+ length is specified */
+ int snaplen; /**< Maximum captured packet length */
+ int promisc_mode; /**< Capture in promiscuous mode */
+ int linktype; /**< Data link type to use, or -1 for
+ "use default" */
+ int sync_mode; /**< Fork a child to do the capture,
+ and sync between them */
+ gboolean show_info; /**< show the info dialog */
-/* The version of pcap.h that comes with some systems is missing these
- * #defines.
- */
+ gboolean multi_files_on; /**< TRUE if ring buffer in use */
-#ifndef DLT_RAW
-#define DLT_RAW 12
-#endif
+ gboolean has_file_duration; /**< TRUE if ring duration specified */
+ gint32 file_duration; /* Switch file after n seconds */
+ gboolean has_ring_num_files;/**< TRUE if ring num_files specified */
+ guint32 ring_num_files; /**< Number of multiple buffer files */
+ gboolean has_autostop_files;/**< TRUE if maximum number of capture files
+ are specified */
+ gint32 autostop_files; /**< Maximum number of capture files */
-#ifndef DLT_SLIP_BSDOS
-#define DLT_SLIP_BSDOS 13
-#endif
+ gboolean has_autostop_packets; /**< TRUE if maximum packet count is
+ specified */
+ int autostop_packets; /**< Maximum packet count */
+ gboolean has_autostop_filesize; /**< TRUE if maximum capture file size
+ is specified */
+ gint32 autostop_filesize; /**< Maximum capture file size */
+ gboolean has_autostop_duration; /**< TRUE if maximum capture duration
+ is specified */
+ gint32 autostop_duration; /**< Maximum capture duration */
+} capture_options;
-#ifndef DLT_PPP_BSDOS
-#define DLT_PPP_BSDOS 14
-#endif
+/** Global capture options. */
+extern capture_options capture_opts;
+
+/** Makes a "capture only mode". Implies -k */
+extern gboolean quit_after_cap;
+
+/** If this is the child for "-S" */
+extern gboolean capture_child;
+/** Open a specified file, or create a temporary file, and start a capture
+ to the file in question. Returns TRUE if the capture starts
+ successfully, FALSE otherwise. */
+gboolean do_capture(const char *save_file);
+
+/** Do the low-level work of a capture. */
+int capture(gboolean *stats_known, struct pcap_stat *stats);
+
+/** Stop a capture from a menu item. */
+void capture_stop(void);
+
+/** Terminate the capture child cleanly when exiting. */
+void kill_capture_child(void);
+
+/** Number of packet counts.
+ * @todo improve this macro (put something like this into epan/packet.h?) */
+#define CAPTURE_PACKET_COUNTS sizeof(packet_counts) / sizeof (gint)
+
+/** Current Capture info. */
+typedef struct {
+ /* handles */
+ gpointer callback_data; /**< capture callback handle */
+ gpointer ui; /**< user interfaces own handle */
+
+ /* capture info */
+ packet_counts *counts; /**< protocol specific counters */
+ time_t running_time; /**< running time since last update */
+ gint new_packets; /**< packets since last update */
+} capture_info;
+
+
+/** Create the capture info dialog */
+extern void capture_info_create(
+capture_info *cinfo,
+gchar *iface);
+
+/** Update the capture info counters in the dialog */
+extern void capture_info_update(
+capture_info *cinfo);
+
+/** Destroy the capture info dialog again */
+extern void capture_info_destroy(
+capture_info *cinfo);
-void capture_prep_cb(GtkWidget *, gpointer);
-void capture(void);
#endif /* HAVE_LIBPCAP */
+
#endif /* capture.h */