MikroTik Router OS V3.0 User Manual

							0 35.35.35.1 udp send admin1 25.25.25.1 udp send admin2 36.36.36.1 udp send admin
[admin@MikroTik] tool>
 
	$

 

( 

 

 	


	


[admin@MikroTik] tool bandwidth-server> set enabled=yes authenticate=no[admin@MikroTik] tool bandwidth-server> printenabled: yesauthenticate: noallocate-udp-ports-from: 2000max-sessions: 10[admin@MikroTik] tool>
Client Configuration
Command name:/tool bandwidth-test
Property Description
(IP address) - IP address of destination host
assume-lost-time(time; default:0s) - assume that connection is lost if Bandwidth Server is not
responding for that time
direction(receive/transmit/both; default:receive) - the direction of the test
do(name|string; default:) - script source
duration(time; default:0s) - duration of the test
•0s- test duration is not limited
interval(time: 20ms..5s; default:1s) - delay between reports (in seconds)
local-tx-speed(integer; default:0) - transfer test maximum speed (bits per second)
•0- no speed limitations
local-udp-tx-size(integer: 40..64000) - local transmit packet size in bytes
password(text; default:) - password for the remote user
protocol(udp|tcp; default:udp) - protocol to use
random-data(yes|no; default:no) - if random-data is set to yes, the payload of the bandwidth test
packets will have incompressible random data stream so that links that use data compression will
not distort the results (this is CPU intensive and random-data should be set to no for low speed
CPUs)
remote-tx-speed(integer; default:0) - receive test maximum speed (bits per second)
•0- no speed limitations
remote-udp-tx-size(integer: 40..64000) - remote transmit packet size in bytes
user(name; default:) - remote user
Example
 
 /
						

							[admin@MikroTik] tool> bandwidth-test 10.0.0.211 duration=15s direction=both \\... size=1000 protocol=udp user=adminstatus: done testingduration: 15stx-current: 3.62Mbpstx-10-second-average: 3.87Mbpstx-total-average: 3.53Mbpsrx-current: 3.33Mbpsrx-10-second-average: 3.68Mbpsrx-total-average: 3.49Mbps
[admin@MikroTik] tool>
Page 451 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							ICMP Bandwidth Test
Document revision 1.3 (January 24, 2008, 15:28 GMT)
This document applies to MikroTik RouterOS V3.0
Table of Contents
TableofContents
Summary
Specifications
ICMPBandwidthTest
Description
PropertyDescription
Example
General Information
Summary
 *3$ )	

 
 &$
 ! 	
   
 		
 (		
 
 

 


 
 	
 
  
 ( 

 %


%
Specifications
Packages required:advanced-tools
License required:level1
Command name:/tool ping-speed
Standards and Technologies:ICMP(RFC792)
Hardware usage:Not significant
ICMP Bandwidth Test
Description
 *3$ 

  
 
	
	 78
  
  
 

 
 
 	
  	

$
 	
 2 (		

 	 
  
 		
 (		
 



 		
 	
  



 	
 2 !
	

  

  		
 
 
 2  
 *3$ 	
 
 

(	


 *3$ 78
 	
 7 	
 
 
 

 		
  
 
 	
 


 	
 9
 
	
 
 
 	
 

 
	
 
 	

 

 	
 	
 	
  


Property Description
(IP address) - IP address to ping
do(name) - assigned name of the script to start
first-ping-size(integer: 32..64000; default:32) - first ICMP packet size
Page 452 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							interval(time: 20ms..5s) - time interval between two ping repetitions
once- specifies that the ping will be performed only once
second-ping-size(integer: 32..64000; default:1500) - second ICMP packet size
time-between-pings(integer) - the time between the first and the second ICMP echo-requests in
seconds. A new ICMP-packet pair will never be sent before the previous pair is completely sent and
the algorithm itself will never send more than two requests in one second
Example
*
 
 
 	   

 
 	

 
 	 
 
 *$ 	!*%!1(%)+%&  

(	


 


  !

[admin@MikroTik] tool> ping-speed 159.148.60.2 interval=1scurrent: 2.23Mbpsaverage: 2.61Mbps
[admin@MikroTik] tool>
Page 453 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							Packet Sniffer
Document revision 1.6 (February 5, 2008, 15:52 GMT)
This document applies to MikroTik RouterOS V3.0
Table of Contents
TableofContents
GeneralInformation
Summary
Specifications
Description
PacketSnifferConfiguration
PropertyDescription
Notes
Example
RunningPacketSniffer
Description
Example
SniffedPackets
Description
PropertyDescription
Example
PacketSnifferProtocols
Description
PropertyDescription
Example
PacketSnifferHost
Description
PropertyDescription
Example
PacketSnifferConnections
Description
PropertyDescription
Example
SniffMACAddress
General Information
Summary
$	
 
  	 	
 
	
 	
 	 
 	
	 
	(
 ( 
 

 
	
 
  	 
 
 &


 
 

 	 
 	 	
 
 
 	
	 	 
 
   	 
 

Specifications
Packages required:system
License required:level1
Page 454 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							Home menu level:/tool sniffer
Standards and Technologies:none
Hardware usage:Not significant
Description
*
 	  
 H
H &

 	
  	
 
 
 
 
 &	
 	
 
 
	 
	
 


 
 
 
 
  
 

 
 
 

 	
 ( 
 
  
	
Packet Sniffer Configuration
Home menu level:/tool sniffer
Property Description
file-limit(integer; default:10) - the limit of the file in KB. Sniffer will stop after this limit is
reached
file-name(text; default:) - the name of the file where the sniffed packets will be saved to
filter-address1(IP addressnetmaskport; default:0.0.0.0/0:0-65535) - criterion of choosing the
packets to process
filter-address2(IP addressnetmaskport; default:0.0.0.0/0:0-65535) - criterion of choosing the
packets to process
filter-protocol(all-frames|ip-only|mac-only-no-ip; default:ip-only) - specific protocol group to
filter
•all-frames- sniff all packets
•ip-only- sniff IP packets only
•mac-only-no-ip- sniff non-IP packets only
filter-stream(yes|no; default:yes) - whether to ignore sniffed packets that are destined to the
stream server
interface(name|all; default:all) - the name of the interface that receives the packets
memory-limit(integer; default:10) - maximum amount of memory to use. Sniffer will stop after
this limit is reached
only-headers(yes|no; default:no) - whether to save in the memory packets headers only (not the
whole packet)
running(read-only: yes|no; default:no) - if the sniffer is started then the value is yes otherwise no
streaming-enabled(yes|no; default:no) - whether to send sniffed packets to a remote server
streaming-server(IP address; default:0.0.0.0) - Tazmen Sniffer Protocol (TZSP) stream receiver
Notes
	

!	
	

&	  
  
 
 	


 
 
	

 & 

 	
 
 
 
 	  
  
 	
 
  	 	
 
 
 
 	
 



	

 	  	 	
  
 	 
	
 
 	

 
 	




9
 
C
 &7F
	

11	 	
5
B
&

11	
2 	
 ( 
 
% 
	 
 	 % 	
	
Page 455 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							

11
1
	
 
	
 
 
 	
 *+:- A
 
 	
 	( ( 	


 	

Example
*
 
 
 	

  	 
	
   
		
  

test	
 	
 
   
	
 	
 
 	
  

[admin@MikroTik] tool sniffer>set streaming-server=10.0.0.241 \\... streaming-enabled=yes file-name=test[admin@MikroTik] tool sniffer> prininterface: allonly-headers: nomemory-limit: 10file-name: testfile-limit: 10streaming-enabled: yesstreaming-server: 10.0.0.241filter-stream: yesfilter-protocol: ip-onlyfilter-address1: 0.0.0.0/0:0-65535filter-address2: 0.0.0.0/0:0-65535running: no[admin@MikroTik] tool sniffer>start[admin@MikroTik] tool sniffer>stop
Running Packet Sniffer
Command name:/tool sniffer start, /tool sniffer stop, /tool sniffer save
Description
 	
 	  
 

 

 	

  
 	
 
 

	
   


	
1
 


7 
 

  	( 

 
 	
 
 	  
	
  
Example
*
 
 
 	 
 	
 
   
	
 	
 	
  
 7 

[admin@MikroTik] tool sniffer> start[admin@MikroTik] tool sniffer> stop
) 
 
 	
   	( 
 
  
	test
[admin@MikroTik] tool sniffer> save file-name=test[admin@MikroTik] tool sniffer> /file print# NAME TYPE SIZE CREATION-TIME0 test unknown 1350 apr/07/2003 16:01:52
[admin@MikroTik] tool sniffer>
Sniffed Packets
Home menu level:/tool sniffer packet
Description
Page 456 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							 
 	 
  
 
  
 	

Property Description
data(read-only: text) - specified data inclusion in packets
dst-address(read-only: IP address) - destination IP address
dst-mac-address(MAC address) - destination MAC address
fragment-offset(read-only: integer) - IP fragment offset
identification(read-only: integer) - IP identification
interface(read-only: name) - name of the interface the packet has been captured on
ip-header-size(read-only: integer) - the size of IP header
ip-packet-size(read-only: integer) - the size of IP packet
ip-protocol(ip|icmp|igmp|ggp|ipencap|st|tcp|egp|pup|udp|hmp|xns-idp|rdp|iso-tp4|
xtp|ddp|idrp-cmtp|gre|esp|ah|rspf|vmtp|ospf|ipip|encap) - the name/number of IP
protocol
•ip- Internet Protocol
•icmp- Internet Control Message Protocol
•igmp- Internet Group Management Protocol
•ggp- Gateway-Gateway Protocol
•ipencap- IP Encapsulated in IP
•st- st datagram mode
•tcp- Transmission Control Protocol
•egp- Exterior Gateway Protocol
•pup- Parc Universal packet Protocol
•udp- User Datagram Protocol
•hmp- Host Monitoring Protocol
•xns-idp- Xerox ns idp
•rdp- Reliable Datagram Protocol
•iso-tp4- ISO Transport Protocol class 4
•xtp- Xpress Transfer Protocol
•ddp- Datagram Delivery Protocol
•idpr-cmtp- idpr Control Message Transport
•gre- General Routing Encapsulation
•esp- IPsec ESP protocol
•ah- IPsec AH protocol
•rspf- Radio Shortest Path First
•vmtp- Versatile Message Transport Protocol
•ospf- Open Shortest Path First
•ipip- IP encapsulation (protocol 4)
•encap- IP encapsulation (protocol 98)
Page 457 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							protocol(read-only: ip|arp|rarp|ipx|ipv6) - the name/number of ethernet protocol
•ip- Internet Protocol
•arp- Address Resolution Protocol
•rarp- Reverse Address Resolution Protocol
•ipx- Internet Packet exchange protocol
•ipv6- Internet Protocol next generation
size(read-only: integer) - size of packet
src-address(IP address) - source address
src-mac-address(MAC address) - source MAC address
time(read-only: time) - time when packet arrived
tos(read-only: integer) - IP Type Of Service
ttl(read-only: integer) - IP Time To Live
Example
*
 
 	  
% 
  
 
 
 
  
 	

[admin@MikroTik] tool sniffer packet> print# TIME INTERFACE SRC-ADDRESS DST-ADDRESS IP-.. SIZE0 0.12 ether1 10.0.0.241:1839 10.0.0.181:23 (telnet) tcp 461 0.12 ether1 10.0.0.241:1839 10.0.0.181:23 (telnet) tcp 402 0.12 ether1 10.0.0.181:23 (telnet) 10.0.0.241:1839 tcp 783 0.292 ether1 10.0.0.181 10.0.0.4 gre 884 0.32 ether1 10.0.0.241:1839 10.0.0.181:23 (telnet) tcp 405 0.744 ether1 10.0.0.144:2265 10.0.0.181:22 (ssh) tcp 766 0.744 ether1 10.0.0.144:2265 10.0.0.181:22 (ssh) tcp 767 0.744 ether1 10.0.0.181:22 (ssh) 10.0.0.144:2265 tcp 408 0.744 ether1 10.0.0.181:22 (ssh) 10.0.0.144:2265 tcp 76[admin@MikroTik] tool sniffer packet>
Packet Sniffer Protocols
Home menu level:/tool sniffer protocol
Description
*
 
 
  	
  	 
  
 
	
 	( 
 

Property Description
bytes(integer) - total number of data bytes
ip-protocol(ip|icmp|igmp|ggp|ipencap|st|tcp|egp|pup|udp|hmp|xns-idp|rdp|iso-tp4|
xtp|ddp|idrp-cmtp|gre|esp|ah|rspf|vmtp|ospf|ipip|encap) - the name/number of IP
protocol
•ip- Internet Protocol
•icmp- Internet Control Message Protocol
•igmp- Internet Group Management Protocol
•ggp- Gateway-Gateway Protocol
Page 458 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							•ipencap- IP Encapsulated in IP
•st- st datagram mode
•tcp- Transmission Control Protocol
•egp- Exterior Gateway Protocol
•pup- Parc Universal packet Protocol
•udp- User Datagram Protocol
•hmp- Host Monitoring Protocol
•xns-idp- Xerox ns idp
•rdp- Reliable Datagram Protocol
•iso-tp4- ISO Transport Protocol class 4
•xtp- Xpress Transfer Protocol
•ddp- Datagram Delivery Protocol
•idpr-cmtp- idpr Control Message Transport
•gre- General Routing Encapsulation
•esp- IPsec ESP protocol
•ah- IPsec AH protocol
•rspf- Radio Shortest Path First
•vmtp- Versatile Message Transport Protocol
•ospf- Open Shortest Path First
•ipip- IP encapsulation
•encap- IP encapsulation
packets(integer) - the number of packets
port(name) - the port of TCP/UDP protocol
protocol(read-only: ip|arp|rarp|ipx|ipv6) - the name/number of ethernet protocol
•ip- Internet Protocol
•arp- Address Resolution Protocol
•rarp- Reverse Address Resolution Protocol
•ipx- Internet Packet exchange protocol
•ipv6- Internet Protocol next generation
share(integer) - specific type of traffic share compared to all traffic in bytes
Example
[admin@MikroTik] tool sniffer protocol> print# PROTOCOL IP-PR... PORT PACKETS BYTES SHARE0 ip 77 4592 100 %1 ip tcp 74 4328 94.25 %2 ip gre 3 264 5.74 %3 ip tcp 22 (ssh) 49 3220 70.12 %4 ip tcp 23 (telnet) 25 1108 24.12 %
[admin@MikroTik] tool sniffer protocol>
Page 459 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners.