.. _bag-merge:

===========
 bag-merge
===========

.. program:: bag-merge

Synopsis
========

:samp:`bag-merge {[OPTIONS]} -o {OUTPUT} {INPUT1} {[INPUT2 ...]}`

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

Copy :term:`event` s from :term:`log file` s :samp:`{INPUT1}`,
:samp:`{INPUT2}` etc. into a new :term:`log file` :samp:`{OUTPUT}`.

.. only:: html

   .. seealso::

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

      :ref:`rsb:idl-options`
        The usual IDL-related commandline options are accepted.

      :ref:`replay-related-options`
        The usual replay-related commandline options are accepted.

.. only:: man

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

   .. include:: common.rst
      :start-line: 25

.. option:: --output-file OUTPUT, -o OUTPUT

   Write transformed events into file :samp:`{OUTPUT}`. The file
   format is determined based on the file type (which is determined
   based on the file extension) of :samp:`{OUTPUT}`.

   .. Tip::

      The output of :option:`common --help-for` ``all`` includes a
      list of supported file formats.

Examples
========

* .. code-block:: sh

     $ bag-merge -o bla.tide '/vol/my-separate-logs/**/*.tide'

  The above command merges all :term:`log file` s matching the glob
  expression ``/vol/my-separate-logs/**/*.tide`` into a single
  :term:`log file` named ``bla.tide``.