Add hardware timestamping support

pcap provides a pcap_set_tstamp_type function, which can be used to request
hardware timestamps from a supporting kernel.

This patch adds support for aforementioned function as well as two new
command line options to dumpcap, wireshark and tshark:

    --list-time-stamp-types
                             List time stamp types supported for the interface
    --time-stamp-type <type>
                             Change the interface's timestamp method

Name choice mimics those used by tcpdump(1), which already supports this
feature. However, unlike tcpdump, we provide both options unconditionally.
If Wireshark was configured without pcap_set_tstamp_type being available,
--list-time-stamp-types reports an empty list.

Change-Id: I418a4b2b84cb01949cd262aad0ad8427f5ac0652
Signed-off-by: Ahmad Fatoum <ahmad.fatoum@siemens.com>
Reviewed-on: https://code.wireshark.org/review/23113
Petri-Dish: Guy Harris <guy@alum.mit.edu>
Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org>
Reviewed-by: Anders Broman <a.broman58@gmail.com>

2 files changed, 18 insertions, 2 deletions

diff --git a/docbook/wsug_src/WSUG_app_tools.asciidoc b/docbook/wsug_src/WSUG_app_tools.asciidoc
index 87c88559f0..e05b033ecf 100644
--- a/docbook/wsug_src/WSUG_app_tools.asciidoc
+++ b/docbook/wsug_src/WSUG_app_tools.asciidoc
@@ -42,8 +42,10 @@ Capture interface:
   -I                       capture in monitor mode, if available
   -B <buffer size>         size of kernel buffer (def: 2MB)
   -y <link type>           link layer type (def: first appropriate)
+  --time-stamp-type <type> timestamp method for interface
   -D                       print list of interfaces and exit
   -L                       print list of link-layer types of iface and exit
+  --list-time-stamp-types  print list of timestamp types for iface and exit
 
 Capture stop conditions:
   -c <packet count>        stop after n packets (def: infinite)
@@ -185,8 +187,10 @@ Capture interface:
   -I                       capture in monitor mode, if available
   -B <buffer size>         size of kernel buffer in MiB (def: 2MiB)
   -y <link type>           link layer type (def: first appropriate)
+  --time-stamp-type <type> timestamp method for interface
   -D                       print list of interfaces and exit
   -L                       print list of link-layer types of iface and exit
+  --list-time-stamp-types  print list of timestamp types for iface and exit
   -d                       print generated BPF code for capture filter
   -k                       set channel on wifi interface <freq>,[<type>]
   -S                       print statistics for each interface once per second
diff --git a/docbook/wsug_src/WSUG_chapter_customize.asciidoc b/docbook/wsug_src/WSUG_chapter_customize.asciidoc
index 1f797bd7db..618303529a 100644
--- a/docbook/wsug_src/WSUG_chapter_customize.asciidoc
+++ b/docbook/wsug_src/WSUG_chapter_customize.asciidoc
@@ -56,8 +56,10 @@ Capture interface:
   -I                       capture in monitor mode, if available
   -B <buffer size>         size of kernel buffer (def: 2MB)
   -y <link type>           link layer type (def: first appropriate)
+  --time-stamp-type <type> timestamp method for interface
   -D                       print list of interfaces and exit
   -L                       print list of link-layer types of iface and exit
+  --list-time-stamp-types  print list of timestamp types for iface and exit
 
 Capture stop conditions:
   -c <packet count>        stop after n packets (def: infinite)
@@ -273,6 +275,10 @@ updated automatically as packets arrive during a capture ( as specified by the
 
 List the data link types supported by the interface and exit.
 
+--list-time-stamp-types::
+
+List timestamp types configurable for the iface and exit
+
 -m <font>::
 
 This option sets the name of the font used for most text displayed by Wireshark.
@@ -420,10 +426,16 @@ This option sets the name of the file to be used to save captured packets.
 
 -y <capture link type>::
 
-If a capture is started from the command line with -k, set the data
-link type to use while capturing packets. The values reported by -L
+If a capture is started from the command line with `-k`, set the data
+link type to use while capturing packets. The values reported by `-L`
 are the values that can be used.
 
+--time-stamp-type <type>::
+
+If a capture is started from the command line with `-k`, set the data
+link type to use while capturing packets. The values reported by
+`--list-time-stamp-types` are the values that can be used.
+
 -X <eXtension option>::
 
 Specify an option to be passed to a TShark module. The eXtension option is in