.. _tools: ======= Tools ======= .. toctree:: :hidden: common tool-record tool-play tool-info tool-introspect tool-cat tool-merge .. seealso:: :ref:`common-options` For a description of common options accepted by more than one program. The following tools are available: * :ref:`tool-record` This tool is used to capture and store :ref:`RSB ` :term:`events ` from one or more :term:`channels `. The captured :term:`events ` are serialized and written to one or more :term:`channels ` (based on their :term:`scopes ` and :term:`payload` types) of a :term:`log file`. * :ref:`tool-play` This tool "replays" :term:`events ` stored in a :term:`log file`. :term:`Events ` from all :term:`channels ` or a subset of the :term:`channels ` stored in a :term:`log file` are deserialized and sent via :ref:`RSB ` :term:`informers ` preserving the recorded timing as closely as possible. Other replay timings are also possible. * :ref:`tool-info` The purpose of this tool is inspecting :term:`log files `. It is capable of extracting and displaying some high-level information form :term:`log files `. * :ref:`tool-introspect` Gathers introspection information from :term:`log files ` and displays (or otherwise processes) it in various ways. * :ref:`tool-cat` Like UNIX :command:`cat`, this program makes a stream of data available on its standard output stream. Unlike UNIX :command:`cat`, the data is obtained by processing :term:`log files `. * :ref:`tool-merge` This tool merges multiple :term:`log files ` into one, optionally applying transformations to :term:`log file` :term:`channels ` and/or entries in the process.