.. _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`. Given a log file,
it displays the :term:`channels` stored in the file, some information
regarding timing as well as some :term:`event` counts and sizes.

The :ref:`usual commandline options <common-options>` are accepted.

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
    [...]