diff options
author | Jack Lloyd <[email protected]> | 2019-01-21 08:29:41 -0500 |
---|---|---|
committer | Jack Lloyd <[email protected]> | 2019-01-21 08:29:41 -0500 |
commit | 1a41ab7c75aeea08fffd5378b3569a0c529f7e4c (patch) | |
tree | 1b744ba0caeaea113a3a1c55768746cef76382ea /doc/manual | |
parent | 7c0a86beec3af57e3220195ac89049b946138adc (diff) |
Minor updates to filter docs
Diffstat (limited to 'doc/manual')
-rw-r--r-- | doc/manual/filters.rst | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/manual/filters.rst b/doc/manual/filters.rst index 6b867159b..04baebf5d 100644 --- a/doc/manual/filters.rst +++ b/doc/manual/filters.rst @@ -253,6 +253,9 @@ in raw binary. In many situations you'll want to perform a sequence of operations on multiple branches of the fork; in which case, use the filter described in :ref:`chain`. +There is also a ``Threaded_Fork`` which acts the same as ``Fork``, +except it runs each of the filters in its own thread. + .. _chain: Chain @@ -683,6 +686,10 @@ as simple as possible to write new filter types. There are four functions that need to be implemented by a class deriving from ``Filter``: +.. cpp:function:: std::string Filter::name() const + + This should just return a useful decription of the filter object. + .. cpp:function:: void Filter::write(const uint8_t* input, size_t length) This function is what is called when a filter receives input for it @@ -699,6 +706,12 @@ functions that need to be implemented by a class deriving from also a version of ``send`` taking a single byte argument, as a convenience. + .. note:: + + Normally a filter does not need to override ``send``, though it + can for special handling. It does however need to call this + function whenever it wants to produce output. + .. cpp:function:: void Filter::start_msg() Implementing this function is optional. Implement it if your filter |