Update NEWS and some minor fixes for docs/zeekygen

This commit is contained in:
Tim Wojtulewicz 2021-11-23 13:11:16 -07:00
parent 9135345fa8
commit e82a78616b
3 changed files with 29 additions and 1 deletions

27
NEWS
View file

@ -55,6 +55,24 @@ New Functionality
rebuilds. Previously, updates to included Zeek scripts didn't reliably rebuilds. Previously, updates to included Zeek scripts didn't reliably
trigger a rebuild. trigger a rebuild.
- Added PacketAnalyzer::register_for_port(s) functions to the packet analyzer
framework in script-land. This allows a packet analyzer to register a port
mapping with a parent analyzer just like any other numeric identifier, while
also adding that port to the now-global Analyzer::ports table used by BPF
filtering.
- Added AllAnalyzers::Tag enum type that combines the existing Analyzer::Tag,
PacketAnalyzer::Tag, and Files::Tags into a single enum. The existing types
still exist, but the new type can be used as an argument for
functions/hooks/events that need to handle any of the analyzer types.
- Added protocol detection functionality to the packet analyzer framework.
Packet analyzers can register for protocol detection using the
``PacketAnalyzer::register_protocol_detection`` script function and implement
the ``PacketAnalyzer::DetectProtocol`` method in C++. This allows packet
analyzer plugins to detect a protocol via byte matching or other heuristics
instead of relying solely on a numeric identifier for forwarding.
Changed Functionality Changed Functionality
--------------------- ---------------------
@ -81,12 +99,21 @@ Changed Functionality
on the local NIC - which typically causes the total-length of affected packets to be set to on the local NIC - which typically causes the total-length of affected packets to be set to
zero. zero.
- The existing tunnel analyzers for AYIYA, Geneve, GTPv1, Teredo, and VXLAN
are now packet analyzers.
Removed Functionality Removed Functionality
--------------------- ---------------------
Deprecated Functionality Deprecated Functionality
------------------------ ------------------------
- The ``protocol_confirmation`` and ``protocol_violation`` events along with
the corresponding ``Analyzer::ProtocolConfirmation` and
``Analyzer::ProtocolViolation`` C++ methods are marked as deprecated. They are
replaced by ``analyzer_confirmation`` and ``analyzer_violation`` which can also
now be implemented in packet analyzers.
Zeek 4.1.0 Zeek 4.1.0
========== ==========

View file

@ -10,7 +10,7 @@
##! the analyzers themselves, and documented in their analyzer-specific ##! the analyzers themselves, and documented in their analyzer-specific
##! description along with the events that they generate. ##! description along with the events that they generate.
##! ##!
##! Analyzer tags are also inserted into a global :zeek:type:`AllAnalyzers` enum ##! Analyzer tags are also inserted into a global :zeek:type:`AllAnalyzers::Tag` enum
##! type. This type contains duplicates of all of the :zeek:type:`Analyzer::Tag`, ##! type. This type contains duplicates of all of the :zeek:type:`Analyzer::Tag`,
##! :zeek:type:`PacketAnalyzer::Tag` and :zeek:type:`Files::Tag` enum values ##! :zeek:type:`PacketAnalyzer::Tag` and :zeek:type:`Files::Tag` enum values
##! and can be used for arguments to function/hook/event definitions where they ##! and can be used for arguments to function/hook/event definitions where they

View file

@ -282,6 +282,7 @@ void ProtoAnalyzerTarget::DoCreateAnalyzerDoc(FILE* f) const
fprintf(f, "==================\n\n"); fprintf(f, "==================\n\n");
WriteAnalyzerTagDefn(f, "Analyzer"); WriteAnalyzerTagDefn(f, "Analyzer");
WriteAnalyzerTagDefn(f, "AllAnalyzers");
plugin::Manager::plugin_list plugins = plugin_mgr->ActivePlugins(); plugin::Manager::plugin_list plugins = plugin_mgr->ActivePlugins();
plugin::Manager::plugin_list::const_iterator it; plugin::Manager::plugin_list::const_iterator it;