|author||Gerald Combs <firstname.lastname@example.org>||2018-03-15 17:19:06 -0700|
|committer||Anders Broman <email@example.com>||2018-03-16 06:08:53 +0000|
Update some documentation to prefer CMake.
Change-Id: I8140edaee152ce1e9978d8df8a0f0e3dd077322e Reviewed-on: https://code.wireshark.org/review/26490 Reviewed-by: Anders Broman <firstname.lastname@example.org>
Diffstat (limited to 'doc/README.packaging')
1 files changed, 10 insertions, 18 deletions
diff --git a/doc/README.packaging b/doc/README.packaging
index 3665a2073a..86d443af64 100644
@@ -13,7 +13,7 @@ The canonical location for every Wireshark source release is
If your packaging system downloads a copy of the Wireshark sources, use
this location. Don't use https://www.wireshark.org/download/src.
@@ -32,10 +32,7 @@ newer. Make sure your package complies with this license.
-In versions up to and including 0.99.6, it was necessary to run
-Wireshark with elevated privileges in order to be able to capture
-traffic. With version 0.99.7, all function calls that require elevated
-privileges have been moved out of the GUI to dumpcap.
+All function calls that require elevated privileges are in dumpcap.
WIRESHARK CONTAINS OVER TWO MILLION LINES OF SOURCE CODE. DO NOT RUN
THEM AS ROOT.
@@ -46,25 +43,20 @@ There are several configure-time options on non-Windows systems that
affect the privileges a normal user needs to capture traffic and list
- --enable-setcap-install Install dumpcap with cap_net_admin and
- cap_net_raw capabilities. Linux only.
+ Install dumpcap with cap_net_admin and cap_net_raw capabilities.
+ Linux only.
- --enable-setuid-install Install dumpcap setuid root.
- --with-libcap If running as root, try to grab
- CAP_NET_ADMIN and CAP_NET_RAW, then drop
- privileges. Linux only.
- --with-dumpcap-group=... Restricts dumpcap execution to the
- specified group.
+ Install dumpcap setuid root.
These are necessary for non-root users to be able to capture on most
systems, e.g. on Linux or FreeBSD if the user doesn't have permissions
to access /dev/bpf*. Setcap installation is preferred over setuid on
-Linux. If "--enable-setcap-install" is used it will override any setuid
+Linux. If "-DDUMPCAP_INSTALL_OPTION=capabilities" is used it will
+override any setuid settings.
-The "--with-libcap" option is only useful when dumpcap is installed
+The "-DENABLE_CAP" option is only useful when dumpcap is installed
setuid. If it is enabled dumpcap will try to drop any setuid privileges
it may have while retaining the CAP_NET_ADMIN and CAP_NET_RAW
capabilities. It is enabled by default, if the Linux capabilities