.. _bag-merge:

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

.. program:: bag-merge

Synopsis
========

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

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

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

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

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

.. option:: --channel NAME-OR-REGEXP, -c NAME-OR-REGEXP

   Select the channels matching :samp:`{NAME-OR-REGEXP}` for
   merging. This option can be specified multiple times.

Examples
========

* .. code-block:: sh

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

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