zeek/doc
Jon Siwek e835a55229 Add IPv6 support to signature header conditions.
- "src-ip" and "dst-ip" conditions can now use IPv6 addresses/subnets.
  They must be written in colon-hexadecimal representation and enclosed
  in square brackets (e.g. [fe80::1]).  Addresses #774.

- "icmp6" is now a valid protocol for use with "ip-proto" and "header"
  conditions.  This allows signatures to be written that can match
  against ICMPv6 payloads.  Addresses #880.

- "ip6" is now a valid protocol for use with the "header" condition.
  (also the "ip-proto" condition, but it results in a no-op in that
  case since signatures apply only to the inner-most IP packet when
  packets are tunneled).  This allows signatures to match specifically
  against IPv6 packets (whereas "ip" only matches against IPv4 packets).

- "ip-proto" conditions can now match against IPv6 packets.  Before,
  IPv6 packets were just silently ignored which meant DPD based on
  signatures did not function for IPv6 -- protocol analyzers would only
  get attached to a connection over IPv6 based on the well-known ports
  set in the "dpd_config" table.
2012-10-17 11:11:51 -05:00
..
_static Tweaks. 2012-01-09 18:28:43 -08:00
_templates A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
bin Changes to Broxygen master script package index 2011-12-02 13:59:33 -06:00
components Submodule README conformity changes 2011-11-29 12:18:42 -06:00
ext Remove deprecated attribute &disable_print_hook 2012-09-26 16:47:51 -05:00
images Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
scripts Enable GridFTP detection by default. Track/log SSL client certs. 2012-10-08 11:38:29 -05:00
.gitignore A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
CHANGES Fix documentation interlinkage and normalize console directive bodies. 2011-11-15 16:27:06 -06:00
cluster.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
CMakeLists.txt Add missing doc targets to top Makefile; remove old doc/Makefile. (fixes #705) 2011-12-01 09:16:38 -06:00
conf.py.in A set of script-reference polishing. 2012-01-09 18:04:34 -08:00
faq.rst Merge remote-tracking branch 'origin/fastpath' 2012-10-03 16:05:01 -07:00
geoip.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
index.rst Merge remote-tracking branch 'origin/master' into topic/bernhard/input 2012-01-12 11:07:12 -08:00
input.rst rename the update_finished event to end_of_data and make it fire in 2012-10-10 11:51:20 -07:00
INSTALL.rst Adapt more www niceties to broxygen (stylesheets, pygments); add more docs 2011-11-15 15:39:31 -06:00
logging-dataseries.rst Fix minor typos in dataseries documentation 2012-07-03 18:20:52 -05:00
logging-elasticsearch.rst More documentation updates. 2012-07-20 11:02:09 -04:00
logging.rst Linking ES docs into logging document. 2012-08-21 08:42:09 -07:00
notice.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
quickstart.rst Merge remote-tracking branch 'origin/fastpath' 2012-09-23 08:43:10 -07:00
README corrected some minor typos 2012-01-11 13:02:12 -06:00
reporting-problems.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00
signatures.rst Add IPv6 support to signature header conditions. 2012-10-17 11:11:51 -05:00
upgrade.rst Fix minor typos in documentation 2012-02-02 18:48:23 -06:00

Documentation
=============

This directory contains Bro documentation in reStructuredText format
(see http://docutils.sourceforge.net/rst.html).

It is the root of a Sphinx source tree and can be modified to add more
common/general documentation, style sheets, JavaScript, etc.  The Sphinx
config file is produced from ``conf.py.in``, and can be edited to change
various Sphinx options.

There is also a custom Sphinx domain implemented in ``source/ext/bro.py``
which adds some reST directives and roles that aid in generating useful
index entries and cross-references.  Other extensions can be added in
a similar fashion.

Either the ``make doc`` or ``make broxygen`` targets in the top-level
Makefile can be used to locally render the reST files into HTML.
Those targets depend on:

* Python interpreter >= 2.5
* `Sphinx <http://sphinx.pocoo.org/>`_ >= 1.0.1

After completion, HTML documentation is symlinked in ``build/html``.

There's also ``make docclean`` and ``make broxygenclean`` targets to
clean the resulting documentation.

Notes for Writing Documentation
-------------------------------

* If you want to refer to a document that's part of the
  distribution, it currently needs to be copied or otherwise symlinked
  somewhere in to this Sphinx source tree. Then, it can be referenced
  in a toc tree or with the :doc: role.  Use the :download: role to
  refer to static files that will not undergo sphinx rendering.

* If you want to refer to a page on the Bro web site, use an HTTP URL.

Guidelines
----------

TODO.