wireshark/debian
João Valverde dc7f0b88bb Refactor our logging and extend the wslog API
Experience has shown that:

  1. The current logging methods are not very reliable or practical.
A logging bitmask makes little sense as the user-facing interface (who
would want debug but not crtical messages for example?); it's
computer-friendly and user-unfriendly. More importantly the console
log level preference is initialized too late in the startup process
to be used for the logging subsystem and that fact raises a number
of annoying and hard-to-fix usability issues.

  2. Coding around G_MESSAGES_DEBUG to comply with our log level mask
and not clobber the user's settings or not create unexpected log misses
is unworkable and generally follows the principle of most surprise.
The fact that G_MESSAGES_DEBUG="all" can leak to other programs using
GLib is also annoying.

  3. The non-structured GLib logging API is very opinionated and lacks
configurability beyond replacing the log handler.

  4. Windows GUI has some special code to attach to a console,
but it would be nice to abstract away the rest under a single
interface.

  5. Using this logger seems to be noticeably faster.

Deprecate the console log level preference and extend our API to
implement a log handler in wsutil/wslog.h to provide easy-to-use,
flexible and dependable logging during all execution phases.

Log levels have a hierarchy, from most verbose to least verbose
(debug to error). When a given level is set everything above that
is also enabled.

The log level can be set with an environment variable or a command
line option (parsed as soon as possible but still later than the
environment). The default log level is "message".

Dissector logging is not included because it is not clear what log
domain they should use. An explosion to thousands of domains is
not desirable and putting everything in a single domain is probably
too coarse and noisy. For now I think it makes sense to let them do
their own thing using g_log_default_handler() and continue using the
G_MESSAGES_DEBUG mechanism with specific domains for each individual
dissector.

In the future a mechanism may be added to selectively enable these
domains at runtime while trying to avoid the problems introduced
by G_MESSAGES_DEBUG.
2021-06-11 09:40:28 +00:00
..
patches HTTPS (almost) everywhere. 2019-07-26 18:44:40 +00:00
po [Automatic update for 2019-12-01] 2019-12-01 08:20:14 +00:00
source debian: Bump standards version to 3.9.7 used in Ubuntu 16.04 2016-10-17 15:30:05 +00:00
tests debian: Add autopkgtest for testing starting GUI and CLI 2019-07-24 09:40:55 +00:00
README.Debian Clean up URLs. 2020-10-02 20:13:42 -07:00
README.Debian.security
changelog Version: 3.3.0 → 3.5.0. 2020-10-22 19:15:42 +00:00
compat
control wiretap: Convert ascend.y to Lemon. 2020-11-30 08:15:43 +00:00
copyright HTTPS In More Places, update some URLs. 2019-07-27 07:55:36 +00:00
dirs
ethereal-common.NEWS HTTPS (almost) everywhere. 2019-07-26 18:44:40 +00:00
headers-check.c debian: config.h is not a public header 2021-03-04 10:16:41 +00:00
libwireshark-data.install Transition from GeoIP Legacy to MaxMindDB. 2018-03-06 18:02:21 +00:00
libwireshark-dev.install debian: config.h is not a public header 2021-03-04 10:16:41 +00:00
libwireshark0.install debian: Ship codecs libraries in libwireshark0 2020-03-15 16:55:31 +00:00
libwireshark0.lintian-overrides debian: add lintian-overrides for libwireshark0 (spelling-error-in-binary) 2018-07-27 06:57:00 +00:00
libwireshark0.symbols http: Add dissection of HTTP2-Settings 2021-05-08 17:14:45 +00:00
libwiretap-dev.install
libwiretap0.docs
libwiretap0.install usbdump: Add usbdump wiretap plugin as functional example 2018-01-30 05:44:38 +00:00
libwiretap0.symbols wiretap: un-export some routines. 2021-05-31 04:39:59 -07:00
libwsutil-dev.install debian: add ws_compiler_tests.h to libwsutils-dev.install 2017-10-27 08:52:25 +00:00
libwsutil0.install
libwsutil0.symbols Refactor our logging and extend the wslog API 2021-06-11 09:40:28 +00:00
license-text-about-dialog debian: remove double spaces. 2020-01-07 12:45:00 +00:00
maxmind_db_paths Transition from GeoIP Legacy to MaxMindDB. 2018-03-06 18:02:21 +00:00
postinst
rules GitLab CI: Build merge-req:ubuntu-dpkg using Ninja. 2020-12-29 10:09:36 +00:00
templates debian: Use debconf messages instead of "echo" in postinst/postrm 2017-08-07 22:39:06 +00:00
tshark.docs
tshark.install
tshark.lintian-overrides debian: Update lintian-overrides to cover updated manpages 2016-10-18 04:06:12 +00:00
tshark.manpages
wireshark-common.config
wireshark-common.install Fix up the lists of binaries and man pages in dpkgs. 2019-01-11 23:20:24 +00:00
wireshark-common.lintian-overrides debian/control: fix minor Lintian warnings related to Priority, etc. 2019-06-21 16:59:14 +00:00
wireshark-common.manpages Fix up the lists of binaries and man pages in dpkgs. 2019-01-11 23:20:24 +00:00
wireshark-common.postinst debian: Fix permission change in case of local diversions 2019-07-24 09:40:35 +00:00
wireshark-common.postrm debian/control: fix minor Lintian warnings related to Priority, etc. 2019-06-21 16:59:14 +00:00
wireshark-dev.docs
wireshark-dev.install CMake: Change installation path for modules 2018-08-24 14:39:08 +00:00
wireshark-dev.manpages
wireshark-dev.prerm
wireshark-doc.docs
wireshark-qt.docs
wireshark-qt.install Linux: rename metadata according to spec 2020-12-10 18:11:12 +00:00
wireshark-qt.lintian-overrides debian: Update lintian-overrides to cover updated manpages 2016-10-18 04:06:12 +00:00
wireshark-qt.manpages

README.Debian.security

 Handling security fixes in source package wireshark

Wireshark is a network protocol analyzer and it's ability to perform deep
packet inspection in live traffic may encourage users to use Wireshark/Tshark
as a part of an intrusion detection or traffic monitoring system.
In that case, please note that Wireshark/Tshark may contain remotely
triggerable bugs causing crashes or allowing code injection.

Bugs allowing code injection will be fixed in regular Debian Security
Advisories, but fixes for pure crash bugs may be delayed.

 -- Balint Reczey <balint@balintreczey.hu> Fri, 10 Jul 2009 15:38:33 +0200