<box begindoc>**This is automatically generated documentation.**  Edit after the "[[#COMMENTS|COMMENTS]]" heading; changes to the main body will be lost.</box>

====== SplitFirst Element Documentation ======

===== NAME =====

**SplitFirst** -- Click element;
splits the first N packets to output port 1, to port 0 otherwise.

===== SYNOPSIS =====

SplitFirst(THRESHOLD)

**Ports**: 1 input, 2 outputs\\ 
**Processing**: Push\\ 
**Drivers**: linuxmodule\\ 
**Package**: unibo_qos\\ 

===== DESCRIPTION =====

SplitFirst splits the first incoming THRESHOLD packets to output port 1: this
behavior is useful to use only the following packets (which should 
represent a more "stable" flow) to statistically hook a real-time (not-RTP) flow.


===== EXAMPLES =====

elementclass class_stat {
        $first, $av_length, $av_rate, $dscp |
        split::SplitFirst($first);
        check_length::CheckAverageLength($av_length);
        check_rate::Meter($av_rate);
        set::SetIPDSCP($dscp);
        input->split;
        split[1]->[1]output;
        split[0]->check_length;
        check_length[0]->[2]output;
        check_length[1]->check_rate;
        check_rate[0]->[3]output;
        check_rate[1]->set->[0]output;
        }
In the above example, SplitFirst is used in combination with CheckAveragelength, [[Meter]] and IPDSCP
elements to hook a real-time (not-RTP) flow and mark its packets' DSCP field.


===== ELEMENT HANDLERS =====


 ? **threshold ((write-only))**
 ! Number of first incoming packets to filter out.


===== SEE ALSO =====

[[CheckAverageLength]], [[Meter]], [[SetIPDSCP]]


Generated by 'click-elem2man' from 'package/splitfirst.hh' on 19/May/2006.


===== COMMENTS =====