mirror of
				https://git.proxmox.com/git/mirror_iproute2
				synced 2025-10-31 04:58:17 +00:00 
			
		
		
		
	 5caba410c2
			
		
	
	
		5caba410c2
		
	
	
	
	
		
			
			While generating PDFs from the man pages, I saw the warning below from
several files. Compared the tc-matchall.8 with bridge.8 and used .RI
instead of .R. It should have no effect on the man page rendering.
    `R' is a string (producing the registered sign), not a macro.
Signed-off-by: Alexander Alemayhu <alexander@alemayhu.com>
		
	
			
		
			
				
	
	
		
			88 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			88 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
| .TH "Match-all classifier in tc" 8 "21 Oct 2015" "iproute2" "Linux"
 | |
| 
 | |
| .SH NAME
 | |
| matchall \- traffic control filter that matches every packet
 | |
| .SH SYNOPSIS
 | |
| .in +8
 | |
| .ti -8
 | |
| .BR tc " " filter " ... " matchall " [ "
 | |
| .BR skip_sw " | " skip_hw
 | |
| .RI " ] [ "
 | |
| .B action
 | |
| .IR ACTION_SPEC " ] [ "
 | |
| .B classid
 | |
| .IR CLASSID " ]"
 | |
| .SH DESCRIPTION
 | |
| The
 | |
| .B matchall
 | |
| filter allows to classify every packet that flows on the port and run a
 | |
| action on it.
 | |
| .SH OPTIONS
 | |
| .TP
 | |
| .BI action " ACTION_SPEC"
 | |
| Apply an action from the generic actions framework on matching packets.
 | |
| .TP
 | |
| .BI classid " CLASSID"
 | |
| Push matching packets into the class identified by
 | |
| .IR CLASSID .
 | |
| .TP
 | |
| .BI skip_sw
 | |
| Do not process filter by software. If hardware has no offload support for this
 | |
| filter, or TC offload is not enabled for the interface, operation will fail.
 | |
| .TP
 | |
| .BI skip_hw
 | |
| Do not process filter by hardware.
 | |
| .SH EXAMPLES
 | |
| To create ingress mirroring from port eth1 to port eth2:
 | |
| .RS
 | |
| .EX
 | |
| 
 | |
| tc qdisc  add dev eth1 handle ffff: ingress
 | |
| tc filter add dev eth1 parent ffff:           \\
 | |
|         matchall skip_sw                      \\
 | |
|         action mirred egress mirror           \\
 | |
|         dev eth2
 | |
| .EE
 | |
| .RE
 | |
| 
 | |
| The first command creats an ingress qdisc with handle
 | |
| .BR ffff:
 | |
| on device
 | |
| .BR eth1
 | |
| where the second command attaches a matchall filters on it that mirrors the
 | |
| packets to device eth2.
 | |
| 
 | |
| To create egress mirroring from port eth1 to port eth2:
 | |
| .RS
 | |
| .EX
 | |
| 
 | |
| tc qdisc add dev eth1 handle 1: root prio
 | |
| tc filter add dev eth1 parent 1:               \\
 | |
|         matchall skip_sw                       \\
 | |
|         action mirred egress mirror            \\
 | |
|         dev eth2
 | |
| .EE
 | |
| .RE
 | |
| 
 | |
| The first command creats an egress qdisc with handle
 | |
| .BR 1:
 | |
| that replaces the root qdisc on device
 | |
| .BR eth1
 | |
| where the second command attaches a matchall filters on it that mirrors the
 | |
| packets to device eth2.
 | |
| 
 | |
| To sample one of every 100 packets flowing into interface eth0 to psample group
 | |
| 12:
 | |
| .RS
 | |
| .EX
 | |
| 
 | |
| tc qdisc add dev eth0 handle ffff: ingress
 | |
| tc filter add dev eth0 parent ffff: matchall \\
 | |
|      action sample rate 100 group 12
 | |
| .EE
 | |
| .RE
 | |
| 
 | |
| .EE
 | |
| .SH SEE ALSO
 | |
| .BR tc (8),
 |