.. _bag-info:

==========
 bag-info
==========

.. program:: bag-info

Synopsis
========

:samp:`bag-info {[OPTIONS]} {LOGFILE}`

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

The :program:`bag-info` program can be used to inspect the structure
and, to some extent, contents of :term:`log files <log file>`. Given a
log file, it displays the :term:`channels <channel>` stored in the
file, some information regarding timing as well as some :term:`event`
counts and sizes.

.. only:: html

   .. seealso::

      :ref:`rsb:common-options`
        The usual RSB-related commandline options are accepted.

.. only:: man

   .. include:: common.rst
      :start-line: 7
      :end-line:   12

Examples
========

* .. code-block:: sh

     $ bag-info 1314442144.tide

  should produce output similar to the following::

    File "1314442144.tide"
      Events  : 7,620
      Start   : 2011-08-27T12:49:17.356679+02:00
      End     : 2011-08-27T12:56:41.333822+02:00
      Duration: 443.977143d0
      Channel "/KuHa/test/:UTF-8-STRING"
        Type    : (RSB-EVENT UTF-8-STRING)
        Events  : 28
        Start   : 2011-08-27T12:49:41.037310+02:00
        End     : 2011-08-27T12:56:10.710000+02:00
        Duration: 389.67269d0
        Rate    : 0.0718551767125379d0
    [...]