All arguments must be options.
tcpbridge is a tool for selectively briding network traffic across two interfaces and optionally modifying the packets in betweeen
Optionally, packets can be edited in a variety of ways according to your needs.
For more details, please see the Tcpreplay Manual at: http://tcpreplay.synfin.net/trac/wiki/manual
Specify a list of comma delimited port mappingings consisting of colon delimited port number pairs. Each colon delimited port pair consists of the port to match followed by the port number to rewrite.
Causes the source and destination IP addresses to be pseudo randomized but still maintain client/server relationships. Since the randomization is deterministic based on the seed, you can reuse the same seed value to recreate the traffic.
Takes a comma delimited series of colon delimited CIDR netblock pairs. Each netblock pair is evaluated in order against the IP addresses. If the IP address in the packet matches the first netblock, it is rewriten using the second netblock as a mask against the high order bits.
Works just like the --pnat option, but only affects the source IP addresses in the IPv4 header.
Works just like the --pnat option, but only affects the destination IP addresses in the IPv4 header.
Takes a pair of colon delimited IP addresses which will be used to rewrite all traffic to appear to be between the two IP's.
By default --seed, --pnat and --endpoints will rewrite
broadcast and multicast IP and MAC addresses. Setting this flag
will keep broadcast/multicast IP and MAC addresses from being rewritten.
Causes each IP packet to have it's checksums recalcualted and fixed. Automatically enabled for packets modified with --seed, --pnat, --endpoints or --fixlen.
in the range 1 through MAXPACKET
Override the default 1500 byte MTU size for determining the maximum padding length.
Note, this option is pretty dangerous! We don't actually check to see if a FCS actually exists in the frame, we just blindly delete the last two bytes. Hence, you should only use this if you know know that your OS provides the FCS when reading raw packets.
Allows you to modify the TTL of all the IPv4 packets. Specify a number to hard-code the value or +/-value to increase or decrease by the value provided (limited to 1-255).
--ttl=10 --ttl=+7 --ttl=-64
Packets may be truncated during capture if the snaplen is smaller then the packet. This option allows you to modify the packet to pad the packet back out to the size stored in the IPv4 header or rewrite the IP header total length to reflect the stored packet length.
pad Truncated packets will be padded out so that the packet length matches the IPv4 total length
trunc Truncated packets will have their IPv4 total length field rewritten to match the actual packet length
del Delete the packet
By default, editing Layer 2 addresses will rewrite
broadcast and multicast MAC addresses. Setting this flag
will keep broadcast/multicast MAC addresses from being rewritten.
By default, no DLT (data link type) conversion will be made. To change the DLT type of the output pcap, select one of the following values:
enet Ethernet aka DLT_EN10MB
hdlc Cisco HDLC aka DLT_C_HDLC
User specified Layer 2 header and DLT type
Takes a pair of comma deliminated ethernet MAC addresses which will replace the destination MAC address of outbound packets. The first MAC address will be used for the server to client traffic and the optional second MAC address will be used for the client to server traffic.
Takes a pair of comma deliminated ethernet MAC addresses which will replace the source MAC address of outbound packets. The first MAC address will be used for the server to client traffic and the optional second MAC address will be used for the client to server traffic.
Allows you to rewrite ethernet frames to add a 802.1q header to standard 802.3 ethernet headers or remove the 802.1q VLAN tag information.
add Rewrites the existing 802.3 ethernet header as an 802.1q VLAN header
del Rewrites the existing 802.1q VLAN header as an 802.3 ethernet header
in the range 0 through 4095
in the range 0 through 1
in the range 0 through 7
The Cisco HDLC header has a 1 byte "control" field. Apparently this should always be 0, but if you can use any 1 byte value.
The Cisco HDLC header has a 1 byte "address" field which has two valid values:
You can however specify any single byte value.
Set the DLT value of the output pcap file.
Provide a series of comma deliminated hex values which will be used to rewrite or create the Layer 2 header of the packets. The first instance of this argument will rewrite both server and client traffic, but if this argument is specified a second time, it will be used for the client traffic.
in the range 0 through 5The default number for this option is:
If configured with --enable-debug, then you can specify a verbosity level for debugging output. Higher numbers increase verbosity.
Normally, tcpbridge will send and receive traffic in both directions (bi-directionally). However, if you choose this option, traffic will be sent uni-directionally.
greater than or equal to 1The default number for this option is:
By default, tcpbridge will send packets forever or until Ctrl-C. Alternatively, you can specify a maximum number of packets to send.
Override default of sending all packets stored in the capture file and only send packets which match the provided rule. Rules can be one of:
S:<CIDR1>,... - Source IP must match specified CIDR(s)
D:<CIDR1>,... - Destination IP must match specified CIDR(s)
B:<CIDR1>,... - Both source and destination IP must match specified CIDR(s)
E:<CIDR1>,... - Either IP must match specified CIDR(s)
P:<LIST> - Must be one of the listed packets where the list corresponds to the packet number in the capture file.
--include=P:1-5,9,15,72-would send packets 1 thru 5, the 9th and 15th packet, and packets 72 until the end of the file
- BPF filter. See the tcpdump(8) man page for syntax.
Override default of sending all packets stored in the capture file and only send packets which do not match the provided rule. Rules can be one of:
S:<CIDR1>,... - Source IP must not match specified CIDR(s)
D:<CIDR1>,... - Destination IP must not match specified CIDR(s)
B:<CIDR1>,... - Both source and destination IP must not match specified CIDR(s)
E:<CIDR1>,... - Either IP must not match specified CIDR(s)
P:<LIST> - Must not be one of the listed packets where the list corresponds to the packet number in the capture file.
--exclude=P:1-5,9,15,72-would drop packets 1 thru 5, the 9th and 15th packet, and packets 72 until the end of the file
When enabling verbose mode (-v) you may also specify one or more
additional arguments to pass to tcpdump to modify the way packets
are decoded. By default, -n and -l are used. Be sure to
quote the arguments like: --verbose="-axxx" so that they are not interpreted
by tcpbridge. The following arguments are vaild:
[ -aAeNqRStuvxX ]
[ -E spi@ipaddr algo:secret,... ]
[ -s snaplen ]
SIGUSR1 Suspend tcpbridge
Connecting both interfaces to the same subnet may create a broadcast storm and take down the network. Improper use of the packet editing functions may have other undefined and possible negative consequences.
Some operating systems by default do not allow for forging source MAC addresses. Please consult your operating system's documentation and the tcpreplay FAQ if you experiance this issue.
For support please use the email@example.com mailing list.
The latest version of this software is always available from: http://tcpreplay.synfin.net/
Released under the Free BSD License.
This manual page was AutoGen-erated from the tcpbridge option definitions.