.. _bag-cat:

=========
 bag-cat
=========

.. program:: bag-cat

Synopsis
========

:samp:`bag-cat {[OPTIONS]} {INPUT-FILE-OR--}`

Description
===========

Like UNIX :command:`cat`, the :program:`bag-cat` 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`.

The :ref:`usual RSB-related commandline options <rsb:common-options>`,
:ref:`IDL-related options <rsb:idl-options>` and :ref:`replay-related
options <common-options>` are accepted.

Examples
========

* .. code-block:: sh

     $ bag-cat isr.tide | head
     <sr db_start="80" db_utt="80" />
     <sr db_start="45" db_utt="46" />
     <?xml version="1.0" encoding="UTF-8" standalone="no" ?><speech_hyp [...]
     <?xml version="1.0" encoding="UTF-8" standalone="no" ?><speech_hyp [...]
     <?xml version="1.0" encoding="UTF-8" standalone="no" ?><speech_hyp [...]
     <?xml version="1.0" encoding="UTF-8" standalone="no" ?><speech_hyp [...]
     <?xml version="1.0" encoding="UTF-8" standalone="no" ?><speech_hyp [...]
     <speech_hyp xmlns:bxml="http://www.sleepycat.com/2002/dbxml" [...]
     <TIMESTAMP>1290275288296</TIMESTAMP>
* .. code-block:: sh

     $ bag-cat -c 'hyp' -c 'param' /tmp/nao.tide

  The above example prints the contents of all :term:`channels`
  matching one of the regular expressions ``hyp`` and ``param``.
* .. code-block:: sh

     $ bag-cat --style 'programmable/template :template "${create} ${data}\\n"' mydata.tide
     2011-12-13T17:03:25.533535+01:00 blup
     2011-12-13T17:03:25.534054+01:00 blup
     2011-12-13T17:03:25.534121+01:00 blup
     [...]

Caveats
=======

* Individual entries can no longer be distinguished (unless some
  in-band properties permit this)
* If multiple channels are printed, the channel from which a given
  part of the output originated is no longer apparent (unless some
  in-band properties allow determining this)
* Printing channels which contain binary content to a terminal may
  mess up the terminal and cause all sorts of mayhem