********************************************************************************
*************************** Merger module **************************************
********************************************************************************

Table of Contents
=================

    1. Module description
    2. Interfaces
    3. Parameters
    5. How to use

1. Module description
=====================
This module merges traffic from multiple input interfaces to one output stream
(on one interface). There are two supported versions:
   - normal (default) - re-sending incoming data as they come.
   - timestamp aware - incoming data are sent with respect to timestamp.
     order. Sorting is very simple, sends record with the latest timestamp. If
     record with more late timestamp is received, it is resent immediately.
There are one thread for every input interface.

2. Interfaces
=============
Input: variable, one UniRec record in format (passed as parameter)
Output: 1, same UniRec format as input.

Default UniRec template is "<COLLECTOR_FLOW>".

3. Parameters
=============
   -n CNT  Sets count of input links. Must correspond to parameter -i (trap).
	-T      Set mode to timestamp aware (not set by default).
	-u FMT  UniRec specifier of input/output data (same to all links, default is
	        <COLLECTOR_FLOW>).

	Timestamp aware version only:

	-F      Sorts timestamps based on TIME_FIRST field, instead of TIME_LAST
	        (default).
   -t MS   Set initial timeout for incoming interfaces (in seconds). Timeout is
	        set to 0, if no data received in initial timeout (default 1s).
	        
5. How to use
=============
./merger -i "ttttu;localhost,8801;localhost,8802;localhost,8803;localhost,8804;
DNS_out" -n 4 -u "DST_IP,SRC_IP,BYTES,DNS_RR_TTL,DNS_ANSWERS,DNS_CLASS,DNS_ID,
DNS_PSIZE,DNS_QTYPE,DNS_RLENGTH,DST_PORT,SRC_PORT,DNS_DO,DNS_RCODE,PROTOCOL,
DNS_NAME,DNS_RDATA"

This command will start merger with 4 inputs (on localhost, TCP ports 8801 - 4),
output stream on Unix socket "DNS_out", with UniRec template given by listed
fields.
   
************************* End of Merger README *********************************
********************************************************************************
