📄 flow-fanout.html.in
字号:
<HTML><HEAD><TITLE>flow-fanout</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.73"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><H1><ANAME="AEN1"><SPANCLASS="APPLICATION">flow-fanout</SPAN></A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN6"></A><H2>Name</H2><SPANCLASS="APPLICATION">flow-fanout</SPAN> -- Fanout (replicate) flow exports to many destinations.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN10"></A><H2>Synopsis</H2><P><BCLASS="COMMAND">flow-fanout</B> [-h] [-A<TTCLASS="REPLACEABLE"><I> AS0_substitution</I></TT>] [-d<TTCLASS="REPLACEABLE"><I> debug_level</I></TT>] [-f<TTCLASS="REPLACEABLE"><I> filter_fname</I></TT>] [-F<TTCLASS="REPLACEABLE"><I> filter_definition</I></TT>] [-m<TTCLASS="REPLACEABLE"><I> privacy_mask</I></TT>] [-p<TTCLASS="REPLACEABLE"><I> pidfile</I></TT>] [-s] [-S<TTCLASS="REPLACEABLE"><I> stat_interval</I></TT>] [-V<TTCLASS="REPLACEABLE"><I> pdu_version</I></TT>] [-x<TTCLASS="REPLACEABLE"><I> xmit_delay</I></TT>] {<TTCLASS="REPLACEABLE"><I>localip/remoteip/port</I></TT>} {<TTCLASS="REPLACEABLE"><I>localip/remoteip/port</I></TT>...}</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37"></A><H2>DESCRIPTION</H2><P>The <BCLASS="COMMAND">flow-fanout</B> utility will replicate flows arrivingon localip/remoteip/port to destination(s) specified by localip/remoteip/port.</P><P>Flows processed by multiple exporters will be mixed into a single outputstream. This functionality appeared to support Cisco Catalyst exports andmay have other uses.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN42"></A><H2>OPTIONS</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT>-A<TTCLASS="REPLACEABLE"><I> AS0_substitution</I></TT></DT><DD><P>Cisco's NetFlow exports represent the local autonomous system as 0 instead ofthe real value. This option can be used to replace the 0 in the export withthe a configured value. Unfortunately under certain configurations AS 0 canalso represent a cache miss or non forwarded traffic so use with caution.</P></DD><DT>-d<TTCLASS="REPLACEABLE"><I> debug_level</I></TT></DT><DD><P>Enable debugging.</P></DD><DT>-f<TTCLASS="REPLACEABLE"><I> filter_fname</I></TT></DT><DD><P>Filter list filename. Defaults to <TTCLASS="FILENAME">@localstatedir@/cfg/filter</TT>.</P></DD><DT>-F<TTCLASS="REPLACEABLE"><I> filter_definition</I></TT></DT><DD><P>Select the active definition. Defaults to default.</P></DD><DT>-h</DT><DD><P>Display help.</P></DD><DT>-m<TTCLASS="REPLACEABLE"><I> privacy_mask</I></TT></DT><DD><P>Apply <TTCLASS="REPLACEABLE"><I>privacy_mask</I></TT> to the source and destination IPaddress of flows. For example a privacy_mask of 255.255.255.0 would convertflows with source/destination IP addresses 10.1.1.1 and 10.2.2.2 to 10.1.1.0and 10.2.2.0 respectively.</P></DD><DT>-p<TTCLASS="REPLACEABLE"><I> pidfile</I></TT></DT><DD><P>Configure the process ID file. Use - to disable pid file creation.</P></DD><DT>-s</DT><DD><P>Spoof the source IP address. If the IP address is 0 then it is replacedwith the exporter source IP.</P></DD><DT>-S<TTCLASS="REPLACEABLE"><I> stat_interval</I></TT></DT><DD><P>When configured <BCLASS="COMMAND">flow-fanout</B> will emit a timestampedmessage on stderr every <TTCLASS="REPLACEABLE"><I>stat_interval</I></TT> minutesindicating counters such as the number of flows received, packets processed,and lost flows.</P></DD><DT>-V<TTCLASS="REPLACEABLE"><I> pdu_version</I></TT></DT><DD><P>Use <TTCLASS="REPLACEABLE"><I>pdu_version</I></TT> format output.<PCLASS="LITERALLAYOUT"> 1 NetFlow version 1 (No sequence numbers, AS, or mask)<br> 5 NetFlow version 5<br> 6 NetFlow version 6 (5+ Encapsulation size)<br> 7 NetFlow version 7 (Catalyst switches)<br> 8.1 NetFlow AS Aggregation<br> 8.2 NetFlow Proto Port Aggregation<br> 8.3 NetFlow Source Prefix Aggregation<br> 8.4 NetFlow Destination Prefix Aggregation<br> 8.5 NetFlow Prefix Aggregation<br> 8.6 NetFlow Destination (Catalyst switches)<br> 8.7 NetFlow Source Destination (Catalyst switches)<br> 8.8 NetFlow Full Flow (Catalyst switches)<br> 8.9 NetFlow ToS AS Aggregation<br> 8.10 NetFlow ToS Proto Port Aggregation<br> 8.11 NetFlow ToS Source Prefix Aggregation<br> 8.12 NetFlow ToS Destination Prefix Aggregation<br> 8.13 NetFlow ToS Prefix Aggregation<br> 8.14 NetFlow ToS Prefix Port Aggregation<br> 1005 Flow-Tools tagged version 5</P></P></DD><DT>-x<TTCLASS="REPLACEABLE"><I> xmit_delay</I></TT></DT><DD><P>Configure a microsecond transmit delay between packets. This may be necessary in some configurations to prevent a transmit buffer overrun.</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN104"></A><H2>EXAMPLES</H2><DIVCLASS="INFORMALEXAMPLE"><ANAME="AEN106"></A><P></P><P>Replicate flows arriving to local IP address 10.0.0.1 from the routerexporting with IP address 10.1.1.1 on port 9500 to localhost port 9500and 10.5.5.5 port 9200. The exports sent to 10.5.5.5 will be sent witha source IP address of 10.0.0.5 which must be a valid local IP address.</P><P> <BCLASS="COMMAND">flow-fanout 10.0.0.1/10.1.1.1/9500 0/0/9500 10.0.0.5/10.5.5.5/9200</B></P><P></P></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN110"></A><H2>BUGS</H2><P>NetFlow exports do not contain the exporter IP address inside the payload sothe original exporter IP address (typically a router) will be lost when using<BCLASS="COMMAND">flow-fanout</B>. A work around for this protocol limitationis to use local IP aliases and the <TTCLASS="REPLACEABLE"><I>localip</I></TT> option.When the spoofing option is used multiple exporters with different IP addresseswill share the same sequence number but will have the original source IP.Fixing this requires per source : destination sequence number mapping. Itis much easier to just use multiple instances of flow-fanout running ondifferent ports. </P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN115"></A><H2>AUTHOR</H2><P>Mark Fullmer<TTCLASS="EMAIL"><<AHREF="mailto:maf@splintered.net">maf@splintered.net</A>></TT></P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN122"></A><H2>SEE ALSO</H2><P><SPANCLASS="APPLICATION">flow-tools</SPAN>(1)</P></DIV></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -