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: diff --git a/docbook/wsdg_src/WSDG_chapter_capture.adoc b/docbook/wsdg_src/WSDG_chapter_capture.adoc index 81d45b9e55..01a4eea849 100644 --- a/docbook/wsdg_src/WSDG_chapter_capture.adoc +++ b/docbook/wsdg_src/WSDG_chapter_capture.adoc @@ -71,6 +71,12 @@ IMPORTANT: *Windows Users* Because of restrictions directly calling the script m In such a case, a batch file may be provided, which then in turn executes the script. Please refer to <> 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. + [[ChCaptureExtcapProcess]] ==== Extcap command line interface