aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMichael Mann <mmann78@netscape.net>2019-06-09 08:06:00 -0400
committerAnders Broman <a.broman58@gmail.com>2019-06-09 23:17:31 +0000
commit6476ec79aaea3f90fa840c787dbe1bfeb0b01176 (patch)
tree92be995fda71febe68aec0398fe84070beb638f2 /doc
parentf93edf223b697f7ffbb577acf8312acf6637bf83 (diff)
Document why extcap utilities can't be run "by hand" on Windows
Bug: 15591 Change-Id: Icb8246ba196df026736ce1e54eb2ace2c7cd49b0 Reviewed-on: https://code.wireshark.org/review/33530 Petri-Dish: Michael Mann <mmann78@netscape.net> Tested-by: Petri Dish Buildbot Reviewed-by: Anders Broman <a.broman58@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/extcap.pod10
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/extcap.pod b/doc/extcap.pod
index c268acfacf..171e3a6dbf 100644
--- a/doc/extcap.pod
+++ b/doc/extcap.pod
@@ -29,13 +29,19 @@ called by the GUI in a row. In the following chapters we will refer to them as
"the extcaps".
Extcaps may be any binary or script within the extcap directory. Please note, that scripts
-need to be executable without prefacing a script interpreter before the call. To go deeper
-into the extcap utility development, please refer to README.extcap.
+need to be executable without prefacing a script interpreter before the call.
WINDOWS USER: Because of restrictions directly calling the script may not always work.
In such a case, a batch file may be provided, which then in turn executes the script. Please
refer to doc/extcap_example.py for more information.
+When Wireshark launches an extcap, it automatically adds its installation path
+(c:\Program Files\Wireshark\) to the DLL search path so that the extcap library dependencies
+can be found (it is not designed to be launched by hand). This is done on purpose. There should
+only be extcap programs (executable, python scripts, ...) in the extcap folder to reduce the startup
+time and not have Wireshark trying to execute other file types.
+
+
=head1 GRAMMAR ELEMENTS
Grammar elements: