From Dirk via bug #5771: Add heuristic dissector for images and HTTP
[obnox/wireshark/wip.git] / capture_opts.c
index ccf73f62bb77e2ac235545efb9afb0bc978e89da..9ca76427c26a5d57319f9728982b624a54dd4c6c 100644 (file)
@@ -3,8 +3,8 @@
  *
  * $Id$
  *
- * Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@ethereal.com>
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
  * Copyright 1998 Gerald Combs
  *
  * This program is free software; you can redistribute it and/or
 #include <string.h>
 #include <ctype.h>
 
-#ifdef HAVE_IO_H
-# include <io.h>
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
 #endif
 
-#include <pcap.h>
-
 #include <glib.h>
 
 #include <epan/packet.h>
 
-#include "capture.h"
+#include "capture_opts.h"
 #include "ringbuffer.h"
 #include "clopts_common.h"
+#include "console_io.h"
+#include "cmdarg_err.h"
+
+#include "capture_ifinfo.h"
+#include "capture-pcap-util.h"
+#include <wsutil/file_util.h>
+
+static gboolean capture_opts_output_to_pipe(const char *save_file, gboolean *is_pipe);
+
 
 void
-capture_opts_init(capture_options *capture_opts, void *cfile)
+capture_opts_init(capture_options *capture_opts, void *cf)
 {
-  capture_opts->cf                      = cfile;            
-  capture_opts->cfilter                            = g_strdup("");     /* No capture filter string specified */
+  capture_opts->cf                      = cf;
+  capture_opts->cfilter                 = g_strdup("");     /* No capture filter string specified */
   capture_opts->iface                   = NULL;             /* Default is "pick the first interface" */
-#ifdef _WIN32
+  capture_opts->iface_descr             = NULL;
+#ifdef HAVE_PCAP_REMOTE
+  capture_opts->src_type                = CAPTURE_IFLOCAL;
+  capture_opts->remote_host             = NULL;
+  capture_opts->remote_port             = NULL;
+  capture_opts->auth_type               = CAPTURE_AUTH_NULL;
+  capture_opts->auth_username           = NULL;
+  capture_opts->auth_password           = NULL;
+  capture_opts->datatx_udp              = FALSE;
+  capture_opts->nocap_rpcap             = TRUE;
+  capture_opts->nocap_local             = FALSE;
+#endif
+#ifdef HAVE_PCAP_SETSAMPLING
+  capture_opts->sampling_method         = CAPTURE_SAMP_NONE;
+  capture_opts->sampling_param          = 0;
+#endif
+#if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
   capture_opts->buffer_size             = 1;                /* 1 MB */
 #endif
   capture_opts->has_snaplen             = FALSE;
   capture_opts->snaplen                 = WTAP_MAX_PACKET_SIZE; /* snapshot length - default is
-                                                                    infinite, in effect */
+                                                                   infinite, in effect */
   capture_opts->promisc_mode            = TRUE;             /* promiscuous mode is the default */
+  capture_opts->monitor_mode            = FALSE;
   capture_opts->linktype                = -1;               /* the default linktype */
-  capture_opts->capture_child           = FALSE;
+  capture_opts->saving_to_file          = FALSE;
   capture_opts->save_file               = NULL;
-  capture_opts->save_file_fd            = -1;
-  capture_opts->sync_mode               = TRUE;
+  capture_opts->group_read_access       = FALSE;
+  capture_opts->use_pcapng              = FALSE;            /* the default is pcap */
+  capture_opts->real_time_mode          = TRUE;
   capture_opts->show_info               = TRUE;
   capture_opts->quit_after_cap          = FALSE;
+  capture_opts->restart                 = FALSE;
 
   capture_opts->multi_files_on          = FALSE;
   capture_opts->has_file_duration       = FALSE;
@@ -74,48 +100,85 @@ capture_opts_init(capture_options *capture_opts, void *cfile)
 
   capture_opts->has_autostop_files      = FALSE;
   capture_opts->autostop_files          = 1;
-  capture_opts->has_autostop_packets    = FALSE;            
+  capture_opts->has_autostop_packets    = FALSE;
   capture_opts->autostop_packets        = 0;
   capture_opts->has_autostop_filesize   = FALSE;
-  capture_opts->autostop_filesize       = 1024 * 1024;      /* 1 MB */
+  capture_opts->autostop_filesize       = 1024;             /* 1 MB */
   capture_opts->has_autostop_duration   = FALSE;
   capture_opts->autostop_duration       = 60;               /* 1 min */
 
 
   capture_opts->fork_child              = -1;               /* invalid process handle */
+#ifdef _WIN32
+  capture_opts->signal_pipe_write_fd    = -1;
+#endif
+  capture_opts->state                   = CAPTURE_STOPPED;
+  capture_opts->output_to_pipe          = FALSE;
+#ifndef _WIN32
+  capture_opts->owner                   = getuid();
+  capture_opts->group                   = getgid();
+#endif
 }
 
 
-/* debug only: print content of capture_opts to console */
+/* log content of capture_opts */
 void
-capture_opts_info(capture_options *capture_opts) {
-    g_warning("CAPTURE OPTIONS    :");
-    g_warning("File               : %s", capture_opts->cf);
-    g_warning("Filter             : %s", capture_opts->cfilter);
-    g_warning("Interface          : %s", capture_opts->iface);
+capture_opts_log(const char *log_domain, GLogLevelFlags log_level, capture_options *capture_opts) {
+    g_log(log_domain, log_level, "CAPTURE OPTIONS    :");
+    g_log(log_domain, log_level, "CFile              : 0x%p", capture_opts->cf);
+    g_log(log_domain, log_level, "Filter             : %s", capture_opts->cfilter);
+    g_log(log_domain, log_level, "Interface          : %s", capture_opts->iface);
+    /* iface_descr may not been filled in and some C Libraries hate a null ptr for %s */
+    g_log(log_domain, log_level, "Interface Descr    : %s",
+        capture_opts->iface_descr ? capture_opts->iface_descr : "<null>");
+#ifdef HAVE_PCAP_REMOTE
+    g_log(log_domain, log_level, "Capture source     : %s",
+        capture_opts->src_type == CAPTURE_IFLOCAL ? "Local interface" :
+        capture_opts->src_type == CAPTURE_IFREMOTE ? "Remote interface" :
+        "Unknown");
+    if (capture_opts->src_type == CAPTURE_IFREMOTE) {
+        g_log(log_domain, log_level, "Remote host        : %s", capture_opts->remote_host);
+        g_log(log_domain, log_level, "Remote port        : %s", capture_opts->remote_port);
+    }
+    g_log(log_domain, log_level, "Authentication     : %s",
+        capture_opts->auth_type == CAPTURE_AUTH_NULL ? "Null" :
+        capture_opts->auth_type == CAPTURE_AUTH_PWD ? "By username/password" :
+        "Unknown");
+    if (capture_opts->auth_type == CAPTURE_AUTH_PWD) {
+        g_log(log_domain, log_level, "Auth username      : %s", capture_opts->auth_password);
+        g_log(log_domain, log_level, "Auth password      : <hidden>");
+    }
+    g_log(log_domain, log_level, "UDP data transfer  : %u", capture_opts->datatx_udp);
+    g_log(log_domain, log_level, "No capture RPCAP   : %u", capture_opts->nocap_rpcap);
+    g_log(log_domain, log_level, "No capture local   : %u", capture_opts->nocap_local);
+#endif
+#if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
+    g_log(log_domain, log_level, "BufferSize         : %u (MB)", capture_opts->buffer_size);
+#endif
+    g_log(log_domain, log_level, "SnapLen         (%u): %u", capture_opts->has_snaplen, capture_opts->snaplen);
+    g_log(log_domain, log_level, "Promisc            : %u", capture_opts->promisc_mode);
+    g_log(log_domain, log_level, "LinkType           : %d", capture_opts->linktype);
+    g_log(log_domain, log_level, "SavingToFile       : %u", capture_opts->saving_to_file);
+    g_log(log_domain, log_level, "SaveFile           : %s", (capture_opts->save_file) ? capture_opts->save_file : "");
+    g_log(log_domain, log_level, "GroupReadAccess    : %u", capture_opts->group_read_access);
+    g_log(log_domain, log_level, "Fileformat         : %s", (capture_opts->use_pcapng) ? "PCAPNG" : "PCAP");
+    g_log(log_domain, log_level, "RealTimeMode       : %u", capture_opts->real_time_mode);
+    g_log(log_domain, log_level, "ShowInfo           : %u", capture_opts->show_info);
+    g_log(log_domain, log_level, "QuitAfterCap       : %u", capture_opts->quit_after_cap);
+
+    g_log(log_domain, log_level, "MultiFilesOn       : %u", capture_opts->multi_files_on);
+    g_log(log_domain, log_level, "FileDuration    (%u): %u", capture_opts->has_file_duration, capture_opts->file_duration);
+    g_log(log_domain, log_level, "RingNumFiles    (%u): %u", capture_opts->has_ring_num_files, capture_opts->ring_num_files);
+
+    g_log(log_domain, log_level, "AutostopFiles   (%u): %u", capture_opts->has_autostop_files, capture_opts->autostop_files);
+    g_log(log_domain, log_level, "AutostopPackets (%u): %u", capture_opts->has_autostop_packets, capture_opts->autostop_packets);
+    g_log(log_domain, log_level, "AutostopFilesize(%u): %u (KB)", capture_opts->has_autostop_filesize, capture_opts->autostop_filesize);
+    g_log(log_domain, log_level, "AutostopDuration(%u): %u", capture_opts->has_autostop_duration, capture_opts->autostop_duration);
+
+    g_log(log_domain, log_level, "ForkChild          : %d", capture_opts->fork_child);
 #ifdef _WIN32
-    g_warning("BufferSize         : %u (MB)", capture_opts->buffer_size);
+    g_log(log_domain, log_level, "SignalPipeWrite    : %d", capture_opts->signal_pipe_write_fd);
 #endif
-    g_warning("SnapLen         (%u): %u", capture_opts->has_snaplen, capture_opts->snaplen);
-    g_warning("Promisc            : %u", capture_opts->promisc_mode);
-    g_warning("LinkType           : %d", capture_opts->linktype);
-    g_warning("Child              : %u", capture_opts->capture_child);
-    g_warning("SaveFile           : %s", capture_opts->save_file);
-    g_warning("SaveFileFd         : %d", capture_opts->save_file_fd);
-    g_warning("SyncMode           : %u", capture_opts->sync_mode);
-    g_warning("ShowInfo           : %u", capture_opts->show_info);
-    g_warning("QuitAfterCap       : %u", capture_opts->quit_after_cap);
-
-    g_warning("MultiFilesOn       : %u", capture_opts->multi_files_on);
-    g_warning("FileDuration    (%u): %u", capture_opts->has_file_duration, capture_opts->file_duration);
-    g_warning("RingNumFiles    (%u): %u", capture_opts->has_ring_num_files, capture_opts->ring_num_files);
-
-    g_warning("AutostopFiles   (%u): %u", capture_opts->has_autostop_files, capture_opts->autostop_files);
-    g_warning("AutostopPackets (%u): %u", capture_opts->has_autostop_packets, capture_opts->autostop_packets);
-    g_warning("AutostopFilesize(%u): %u", capture_opts->has_autostop_filesize, capture_opts->autostop_filesize);
-    g_warning("AutostopDuration(%u): %u", capture_opts->has_autostop_duration, capture_opts->autostop_duration);
-
-    g_warning("ForkChild          : %d", capture_opts->fork_child);
 }
 
 /*
@@ -125,7 +188,7 @@ capture_opts_info(capture_options *capture_opts) {
  * in some fashion.
  */
 static gboolean
-set_autostop_criterion(capture_options *capture_opts, const char *appname, const char *autostoparg)
+set_autostop_criterion(capture_options *capture_opts, const char *autostoparg)
 {
   gchar *p, *colonp;
 
@@ -154,14 +217,14 @@ set_autostop_criterion(capture_options *capture_opts, const char *appname, const
   }
   if (strcmp(autostoparg,"duration") == 0) {
     capture_opts->has_autostop_duration = TRUE;
-    capture_opts->autostop_duration = get_positive_int(appname, p,"autostop duration");
+    capture_opts->autostop_duration = get_positive_int(p,"autostop duration");
   } else if (strcmp(autostoparg,"filesize") == 0) {
     capture_opts->has_autostop_filesize = TRUE;
-    capture_opts->autostop_filesize = get_positive_int(appname, p,"autostop filesize");
+    capture_opts->autostop_filesize = get_positive_int(p,"autostop filesize");
   } else if (strcmp(autostoparg,"files") == 0) {
     capture_opts->multi_files_on = TRUE;
     capture_opts->has_autostop_files = TRUE;
-    capture_opts->autostop_files = get_positive_int(appname, p,"autostop files");
+    capture_opts->autostop_files = get_positive_int(p,"autostop files");
   } else {
     return FALSE;
   }
@@ -176,13 +239,13 @@ set_autostop_criterion(capture_options *capture_opts, const char *appname, const
  * in some fashion.
  */
 static gboolean
-get_ring_arguments(capture_options *capture_opts, const char *appname, const char *arg)
+get_ring_arguments(capture_options *capture_opts, const char *arg)
 {
   gchar *p = NULL, *colonp;
 
   colonp = strchr(arg, ':');
   if (colonp == NULL)
-    return TRUE;
+    return FALSE;
 
   p = colonp;
   *p++ = '\0';
@@ -206,60 +269,228 @@ get_ring_arguments(capture_options *capture_opts, const char *appname, const cha
 
   if (strcmp(arg,"files") == 0) {
     capture_opts->has_ring_num_files = TRUE;
-    capture_opts->ring_num_files = get_natural_int(appname, p, "number of ring buffer files");
+    capture_opts->ring_num_files = get_positive_int(p, "number of ring buffer files");
   } else if (strcmp(arg,"filesize") == 0) {
     capture_opts->has_autostop_filesize = TRUE;
-    capture_opts->autostop_filesize = get_positive_int(appname, p, "ring buffer filesize");
+    capture_opts->autostop_filesize = get_positive_int(p, "ring buffer filesize");
   } else if (strcmp(arg,"duration") == 0) {
     capture_opts->has_file_duration = TRUE;
-    capture_opts->file_duration = get_positive_int(appname, p, "ring buffer duration");
+    capture_opts->file_duration = get_positive_int(p, "ring buffer duration");
   }
 
-  *colonp = ':';       /* put the colon back */
+  *colonp = ':';    /* put the colon back */
   return TRUE;
 }
 
+#ifdef HAVE_PCAP_SETSAMPLING
+/*
+ * Given a string of the form "<sampling type>:<value>", as might appear
+ * as an argument to a "-m" option, parse it and set the arguments in
+ * question.  Return an indication of whether it succeeded or failed
+ * in some fashion.
+ */
+static gboolean
+get_sampling_arguments(capture_options *capture_opts, const char *arg)
+{
+    gchar *p = NULL, *colonp;
 
-void
-capture_opts_add_opt(capture_options *capture_opts, const char *appname, int opt, const char *optarg, gboolean *start_capture)
+    colonp = strchr(arg, ':');
+    if (colonp == NULL)
+        return FALSE;
+
+    p = colonp;
+    *p++ = '\0';
+
+    while (isspace((guchar)*p))
+        p++;
+    if (*p == '\0') {
+        *colonp = ':';
+        return FALSE;
+    }
+
+    if (strcmp(arg, "count") == 0) {
+        capture_opts->sampling_method = CAPTURE_SAMP_BY_COUNT;
+        capture_opts->sampling_param = get_positive_int(p, "sampling count");
+    } else if (strcmp(arg, "timer") == 0) {
+        capture_opts->sampling_method = CAPTURE_SAMP_BY_TIMER;
+        capture_opts->sampling_param = get_positive_int(p, "sampling timer");
+    }
+    *colonp = ':';
+    return TRUE;
+}
+#endif
+
+#ifdef HAVE_PCAP_REMOTE
+/*
+ * Given a string of the form "<username>:<password>", as might appear
+ * as an argument to a "-A" option, parse it and set the arguments in
+ * question.  Return an indication of whether it succeeded or failed
+ * in some fashion.
+ */
+static gboolean
+get_auth_arguments(capture_options *capture_opts, const char *arg)
 {
-#ifdef _WIN32
-    int i;
+    gchar *p = NULL, *colonp;
+
+    colonp = strchr(arg, ':');
+    if (colonp == NULL)
+        return FALSE;
+
+    p = colonp;
+    *p++ = '\0';
+
+    while (isspace((guchar)*p))
+        p++;
+
+    capture_opts->auth_type = CAPTURE_AUTH_PWD;
+    capture_opts->auth_username = g_strdup(arg);
+    capture_opts->auth_password = g_strdup(p);
+    *colonp = ':';
+    return TRUE;
+}
 #endif
 
+static int
+capture_opts_add_iface_opt(capture_options *capture_opts, const char *optarg_str_p)
+{
+    long        adapter_index;
+    char        *p;
+    GList       *if_list;
+    if_info_t   *if_info;
+    int         err;
+    gchar       *err_str;
+
+
+    /*
+     * If the argument is a number, treat it as an index into the list
+     * of adapters, as printed by "tshark -D".
+     *
+     * This should be OK on UNIX systems, as interfaces shouldn't have
+     * names that begin with digits.  It can be useful on Windows, where
+     * more than one interface can have the same name.
+     */
+    adapter_index = strtol(optarg_str_p, &p, 10);
+    if (p != NULL && *p == '\0') {
+      if (adapter_index < 0) {
+        cmdarg_err("The specified adapter index is a negative number");
+        return 1;
+      }
+      if (adapter_index > INT_MAX) {
+        cmdarg_err("The specified adapter index is too large (greater than %d)",
+            INT_MAX);
+        return 1;
+      }
+      if (adapter_index == 0) {
+        cmdarg_err("There is no interface with that adapter index");
+        return 1;
+      }
+      if_list = capture_interface_list(&err, &err_str);
+      if (if_list == NULL) {
+        switch (err) {
+
+        case CANT_GET_INTERFACE_LIST:
+            cmdarg_err("%s", err_str);
+            g_free(err_str);
+            break;
+
+        case NO_INTERFACES_FOUND:
+            cmdarg_err("There are no interfaces on which a capture can be done");
+            break;
+        }
+        return 2;
+      }
+      if_info = (if_info_t *)g_list_nth_data(if_list, adapter_index - 1);
+      if (if_info == NULL) {
+        cmdarg_err("There is no interface with that adapter index");
+        return 1;
+      }
+      capture_opts->iface = g_strdup(if_info->name);
+      /*  We don't set iface_descr here because doing so requires
+       *  capture_ui_utils.c which requires epan/prefs.c which is
+       *  probably a bit too much dependency for here...
+       */
+      free_interface_list(if_list);
+    } else {
+      capture_opts->iface = g_strdup(optarg_str_p);
+    }
+
+    return 0;
+}
+
+int
+capture_opts_add_opt(capture_options *capture_opts, int opt, const char *optarg_str_p, gboolean *start_capture)
+{
+    int status;
+
     switch(opt) {
     case 'a':        /* autostop criteria */
-        if (set_autostop_criterion(capture_opts, appname, optarg) == FALSE) {
-          fprintf(stderr, "%s: Invalid or unknown -a flag \"%s\"\n", appname, optarg);
-          exit(1);
+        if (set_autostop_criterion(capture_opts, optarg_str_p) == FALSE) {
+          cmdarg_err("Invalid or unknown -a flag \"%s\"", optarg_str_p);
+          return 1;
+        }
+        break;
+#ifdef HAVE_PCAP_REMOTE
+    case 'A':
+        if (get_auth_arguments(capture_opts, optarg_str_p) == FALSE) {
+            cmdarg_err("Invalid or unknown -A arg \"%s\"", optarg_str_p);
+            return 1;
         }
         break;
+#endif
     case 'b':        /* Ringbuffer option */
         capture_opts->multi_files_on = TRUE;
-        if (get_ring_arguments(capture_opts, appname, optarg) == FALSE) {
-          fprintf(stderr, "%s: Invalid or unknown -b arg \"%s\"\n", appname, optarg);
-          exit(1);
+        if (get_ring_arguments(capture_opts, optarg_str_p) == FALSE) {
+          cmdarg_err("Invalid or unknown -b arg \"%s\"", optarg_str_p);
+          return 1;
         }
         break;
-    case 'c':        /* Capture xxx packets */
+#if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
+    case 'B':        /* Buffer size */
+        capture_opts->buffer_size = get_positive_int(optarg_str_p, "buffer size");
+        break;
+#endif
+    case 'c':        /* Capture n packets */
         capture_opts->has_autostop_packets = TRUE;
-        capture_opts->autostop_packets = get_positive_int(appname, optarg, "packet count");
+        capture_opts->autostop_packets = get_positive_int(optarg_str_p, "packet count");
         break;
     case 'f':        /* capture filter */
-        if (capture_opts->cfilter)
-            g_free(capture_opts->cfilter);
-        capture_opts->cfilter = g_strdup(optarg);
+        if (capture_opts->has_cfilter) {
+            cmdarg_err("More than one -f argument specified");
+            return 1;
+        }
+        capture_opts->has_cfilter = TRUE;
+        g_free(capture_opts->cfilter);
+        capture_opts->cfilter = g_strdup(optarg_str_p);
         break;
     case 'H':        /* Hide capture info dialog box */
         capture_opts->show_info = FALSE;
         break;
-    case 'i':        /* Use interface xxx */
-        capture_opts->iface = g_strdup(optarg);
+    case 'i':        /* Use interface x */
+        status = capture_opts_add_iface_opt(capture_opts, optarg_str_p);
+        if (status != 0) {
+            return status;
+        }
+        break;
+#ifdef HAVE_PCAP_CREATE
+    case 'I':        /* Capture in monitor mode */
+        capture_opts->monitor_mode = TRUE;
         break;
+#endif
     case 'k':        /* Start capture immediately */
         *start_capture = TRUE;
         break;
     /*case 'l':*/    /* Automatic scrolling in live capture mode */
+#ifdef HAVE_PCAP_SETSAMPLING
+    case 'm':
+        if (get_sampling_arguments(capture_opts, optarg_str_p) == FALSE) {
+            cmdarg_err("Invalid or unknown -m arg \"%s\"", optarg_str_p);
+            return 1;
+        }
+        break;
+#endif
+    case 'n':        /* Use pcapng format */
+        capture_opts->use_pcapng = TRUE;
+        break;
     case 'p':        /* Don't capture in promiscuous mode */
         capture_opts->promisc_mode = FALSE;
         break;
@@ -267,47 +498,239 @@ capture_opts_add_opt(capture_options *capture_opts, const char *appname, int opt
         capture_opts->quit_after_cap  = TRUE;
         *start_capture   = TRUE;  /*** -Q implies -k !! ***/
         break;
+#ifdef HAVE_PCAP_REMOTE
+    case 'r':
+        capture_opts->nocap_rpcap = FALSE;
+        break;
+#endif
     case 's':        /* Set the snapshot (capture) length */
         capture_opts->has_snaplen = TRUE;
-        capture_opts->snaplen = get_positive_int(appname, optarg, "snapshot length");
+        capture_opts->snaplen = get_natural_int(optarg_str_p, "snapshot length");
+        /*
+         * Make a snapshot length of 0 equivalent to the maximum packet
+         * length, mirroring what tcpdump does.
+         */
+        if (capture_opts->snaplen == 0)
+          capture_opts->snaplen = WTAP_MAX_PACKET_SIZE;
+        break;
+    case 'S':        /* "Real-Time" mode: used for following file ala tail -f */
+        capture_opts->real_time_mode = TRUE;
         break;
-    case 'S':        /* "Sync" mode: used for following file ala tail -f */
-        capture_opts->sync_mode = TRUE;
+#ifdef HAVE_PCAP_REMOTE
+    case 'u':
+        capture_opts->datatx_udp = TRUE;
         break;
-    case 'w':        /* Write to capture file xxx */
-        capture_opts->save_file = g_strdup(optarg);
-           break;
-    case 'W':        /* Write to capture file FD xxx */
-        capture_opts->save_file_fd = atoi(optarg);
+#endif
+    case 'w':        /* Write to capture file x */
+        capture_opts->saving_to_file = TRUE;
+        g_free(capture_opts->save_file);
+#if defined _WIN32 && GLIB_CHECK_VERSION(2,6,0)
+        /* since GLib 2.6, we need to convert filenames to utf8 for Win32 */
+        capture_opts->save_file = g_locale_to_utf8(optarg_str_p, -1, NULL, NULL, NULL);
+#else
+        capture_opts->save_file = g_strdup(optarg_str_p);
+#endif
+        status = capture_opts_output_to_pipe(capture_opts->save_file, &capture_opts->output_to_pipe);
+        return status;
+    case 'g':        /* enable group read access on the capture file(s) */
+        capture_opts->group_read_access = TRUE;
         break;
     case 'y':        /* Set the pcap data link type */
-#ifdef HAVE_PCAP_DATALINK_NAME_TO_VAL
-        capture_opts->linktype = pcap_datalink_name_to_val(optarg);
+        capture_opts->linktype = linktype_name_to_val(optarg_str_p);
         if (capture_opts->linktype == -1) {
-          fprintf(stderr, "%s: The specified data link type \"%s\" isn't valid\n",
-                  appname, optarg);
-          exit(1);
+          cmdarg_err("The specified data link type \"%s\" isn't valid",
+              optarg_str_p);
+          return 1;
         }
-#else /* HAVE_PCAP_DATALINK_NAME_TO_VAL */
-        /* XXX - just treat it as a number */
-        capture_opts->linktype = get_natural_int(appname, optarg, "data link type");
-#endif /* HAVE_PCAP_DATALINK_NAME_TO_VAL */
         break;
-#ifdef _WIN32
-      /* Hidden option supporting Sync mode */
-    case 'Z':        /* Write to pipe FD XXX */
-        /* associate stdout with pipe */
-        i = atoi(optarg);
-        if (dup2(i, 1) < 0) {
-          fprintf(stderr, "%s: Unable to dup pipe handle\n", appname);
-          exit(1);
-        }
-        break;
-#endif /* _WIN32 */
     default:
         /* the caller is responsible to send us only the right opt's */
         g_assert_not_reached();
     }
+
+    return 0;
+}
+
+void
+capture_opts_print_if_capabilities(if_capabilities_t *caps,
+                                   gboolean monitor_mode)
+{
+    GList *lt_entry;
+    data_link_info_t *data_link_info;
+
+    if (caps->can_set_rfmon)
+        fprintf_stderr("Data link types when %sin monitor mode (use option -y to set):\n",
+                       monitor_mode ? "" : "not ");
+    else
+        fprintf_stderr("Data link types (use option -y to set):\n");
+    for (lt_entry = caps->data_link_types; lt_entry != NULL;
+         lt_entry = g_list_next(lt_entry)) {
+        data_link_info = (data_link_info_t *)lt_entry->data;
+        fprintf_stderr("  %s", data_link_info->name);
+        if (data_link_info->description != NULL)
+            fprintf_stderr(" (%s)", data_link_info->description);
+        else
+            fprintf_stderr(" (not supported)");
+        fprintf_stderr("\n");
+    }
+}
+
+/* Print an ASCII-formatted list of interfaces. */
+void
+capture_opts_print_interfaces(GList *if_list)
+{
+    int         i;
+    GList       *if_entry;
+    if_info_t   *if_info;
+
+    i = 1;  /* Interface id number */
+    for (if_entry = g_list_first(if_list); if_entry != NULL;
+         if_entry = g_list_next(if_entry)) {
+        if_info = (if_info_t *)if_entry->data;
+        printf("%d. %s", i++, if_info->name);
+
+        /* Print the description if it exists */
+        if (if_info->description != NULL)
+            printf(" (%s)", if_info->description);
+        printf("\n");
+    }
+}
+
+
+void capture_opts_trim_snaplen(capture_options *capture_opts, int snaplen_min)
+{
+  if (capture_opts->snaplen < 1)
+    capture_opts->snaplen = WTAP_MAX_PACKET_SIZE;
+  else if (capture_opts->snaplen < snaplen_min)
+    capture_opts->snaplen = snaplen_min;
+}
+
+
+void capture_opts_trim_ring_num_files(capture_options *capture_opts)
+{
+  /* Check the value range of the ring_num_files parameter */
+  if (capture_opts->ring_num_files > RINGBUFFER_MAX_NUM_FILES) {
+    cmdarg_err("Too many ring buffer files (%u). Reducing to %u.\n", capture_opts->ring_num_files, RINGBUFFER_MAX_NUM_FILES);
+    capture_opts->ring_num_files = RINGBUFFER_MAX_NUM_FILES;
+  } else if (capture_opts->ring_num_files > RINGBUFFER_WARN_NUM_FILES) {
+    cmdarg_err("%u is a lot of ring buffer files.\n", capture_opts->ring_num_files);
+  }
+#if RINGBUFFER_MIN_NUM_FILES > 0
+  else if (capture_opts->ring_num_files < RINGBUFFER_MIN_NUM_FILES)
+    cmdarg_err("Too few ring buffer files (%u). Increasing to %u.\n", capture_opts->ring_num_files, RINGBUFFER_MIN_NUM_FILES);
+    capture_opts->ring_num_files = RINGBUFFER_MIN_NUM_FILES;
+#endif
+}
+
+
+gboolean capture_opts_trim_iface(capture_options *capture_opts, const char *capture_device)
+{
+    GList       *if_list;
+    if_info_t   *if_info;
+    int         err;
+    gchar       *err_str;
+
+
+    /* Did the user specify an interface to use? */
+    if (capture_opts->iface == NULL) {
+      /* No - is a default specified in the preferences file? */
+      if (capture_device != NULL) {
+          /* Yes - use it. */
+          capture_opts->iface = g_strdup(capture_device);
+         /*  We don't set iface_descr here because doing so requires
+          *  capture_ui_utils.c which requires epan/prefs.c which is
+          *  probably a bit too much dependency for here...
+          */
+      } else {
+        /* No - pick the first one from the list of interfaces. */
+        if_list = capture_interface_list(&err, &err_str);
+        if (if_list == NULL) {
+          switch (err) {
+
+          case CANT_GET_INTERFACE_LIST:
+              cmdarg_err("%s", err_str);
+              g_free(err_str);
+              break;
+
+          case NO_INTERFACES_FOUND:
+              cmdarg_err("There are no interfaces on which a capture can be done");
+              break;
+          }
+          return FALSE;
+        }
+        if_info = (if_info_t *)if_list->data;  /* first interface */
+        capture_opts->iface = g_strdup(if_info->name);
+        /*  We don't set iface_descr here because doing so requires
+         *  capture_ui_utils.c which requires epan/prefs.c which is
+         *  probably a bit too much dependency for here...
+         */
+        free_interface_list(if_list);
+      }
+    }
+
+    return TRUE;
+}
+
+
+
+#ifndef S_IFIFO
+#define S_IFIFO        _S_IFIFO
+#endif
+#ifndef S_ISFIFO
+#define S_ISFIFO(mode)  (((mode) & S_IFMT) == S_IFIFO)
+#endif
+
+/* copied from filesystem.c */
+static int capture_opts_test_for_fifo(const char *path)
+{
+  struct stat statb;
+
+  if (ws_stat(path, &statb) < 0)
+    return errno;
+
+  if (S_ISFIFO(statb.st_mode))
+    return ESPIPE;
+  else
+    return 0;
+}
+
+static gboolean capture_opts_output_to_pipe(const char *save_file, gboolean *is_pipe)
+{
+  int err;
+
+  *is_pipe = FALSE;
+
+  if (save_file != NULL) {
+    /* We're writing to a capture file. */
+    if (strcmp(save_file, "-") == 0) {
+      /* Writing to stdout. */
+      /* XXX - should we check whether it's a pipe?  It's arguably
+         silly to do "-w - >output_file" rather than "-w output_file",
+         but by not checking we might be violating the Principle Of
+         Least Astonishment. */
+      *is_pipe = TRUE;
+    } else {
+      /* not writing to stdout, test for a FIFO (aka named pipe) */
+      err = capture_opts_test_for_fifo(save_file);
+      switch (err) {
+
+      case ENOENT:      /* it doesn't exist, so we'll be creating it,
+                           and it won't be a FIFO */
+      case 0:           /* found it, but it's not a FIFO */
+        break;
+
+      case ESPIPE:      /* it is a FIFO */
+        *is_pipe = TRUE;
+        break;
+
+      default:          /* couldn't stat it              */
+        break;          /* ignore: later attempt to open */
+                        /*  will generate a nice msg     */
+      }
+    }
+  }
+
+  return 0;
 }
 
 #endif /* HAVE_LIBPCAP */