[mirror_iproute2.git] / man / man8 / tc-skbedit.8

.TH "SKB editing action in tc" 8 "12 Jan 2015" "iproute2" "Linux"

.SH NAME
skbedit - SKB editing action
.SH SYNOPSIS
.in +8
.ti -8
.BR tc " ... " "action skbedit " [ " queue_mapping
.IR QUEUE_MAPPING " ] ["
.B priority
.IR PRIORITY " ] ["
.B mark
.IR MARK " ]"
.B ptype
.IR PTYPE " ]"
.SH DESCRIPTION
The
.B skbedit
action allows to change a packet's associated meta data. It complements the
.B pedit
action, which in turn allows to change parts of the packet data itself.

The most unique feature of
.B skbedit
is it's ability to decide over which queue of an interface with multiple
transmit queues the packet is to be sent out. The number of available transmit
queues is reflected by sysfs entries within
.I /sys/class/net/<interface>/queues
with name
.I tx-N
(where
.I N
is the actual queue number).
.SH OPTIONS
.TP
.BI queue_mapping " QUEUE_MAPPING"
Override the packet's transmit queue. Useful when applied to packets transmitted
over MQ-capable network interfaces.
.I QUEUE_MAPPING
is an unsigned 16bit value in decimal format.
.TP
.BI priority " PRIORITY"
Override the packet classification decision.
.I PRIORITY
is either
.BR root ", " none
or a hexadecimal major class ID optionally followed by a colon
.RB ( : )
and a hexadecimal minor class ID.
.TP
.BI mark " MARK"
Change the packet's firewall mark value.
.I MARK
is an unsigned 32bit value in automatically detected format (i.e., prefix with
.RB ' 0x '
for hexadecimal interpretation, etc.).
.TP
.BI ptype " PTYPE"
Override the packet's type. Useful for setting packet type to host when
needing to allow ingressing packets with the wrong MAC address but
correct IP address.
.I PTYPE
is one of: host, otherhost, broadcast, multicast
.SH SEE ALSO
.BR tc (8),
.BR tc-pedit (8)
Commit	Line	Data
ae6cf29b PS	1	.TH "SKB editing action in tc" 8 "12 Jan 2015" "iproute2" "Linux"
	2
	3	.SH NAME
	4	skbedit - SKB editing action
	5	.SH SYNOPSIS
	6	.in +8
	7	.ti -8
	8	.BR tc " ... " "action skbedit " [ " queue_mapping
	9	.IR QUEUE_MAPPING " ] ["
	10	.B priority
	11	.IR PRIORITY " ] ["
	12	.B mark
	13	.IR MARK " ]"
1d1e0fd2 JHS	14	.B ptype
1d1e0fd2 JHS	15	.IR PTYPE " ]"
ae6cf29b PS	16	.SH DESCRIPTION
	17	The
	18	.B skbedit
	19	action allows to change a packet's associated meta data. It complements the
	20	.B pedit
	21	action, which in turn allows to change parts of the packet data itself.
c73b621c PS	22
	23	The most unique feature of
	24	.B skbedit
	25	is it's ability to decide over which queue of an interface with multiple
	26	transmit queues the packet is to be sent out. The number of available transmit
	27	queues is reflected by sysfs entries within
	28	.I /sys/class/net/<interface>/queues
	29	with name
	30	.I tx-N
	31	(where
	32	.I N
	33	is the actual queue number).
ae6cf29b PS	34	.SH OPTIONS
	35	.TP
	36	.BI queue_mapping " QUEUE_MAPPING"
	37	Override the packet's transmit queue. Useful when applied to packets transmitted
	38	over MQ-capable network interfaces.
	39	.I QUEUE_MAPPING
	40	is an unsigned 16bit value in decimal format.
	41	.TP
	42	.BI priority " PRIORITY"
	43	Override the packet classification decision.
	44	.I PRIORITY
	45	is either
	46	.BR root ", " none
	47	or a hexadecimal major class ID optionally followed by a colon
	48	.RB ( : )
	49	and a hexadecimal minor class ID.
	50	.TP
	51	.BI mark " MARK"
	52	Change the packet's firewall mark value.
	53	.I MARK
	54	is an unsigned 32bit value in automatically detected format (i.e., prefix with
	55	.RB ' 0x '
	56	for hexadecimal interpretation, etc.).
1d1e0fd2 JHS	57	.TP
	58	.BI ptype " PTYPE"
	59	Override the packet's type. Useful for setting packet type to host when
	60	needing to allow ingressing packets with the wrong MAC address but
	61	correct IP address.
	62	.I PTYPE
	63	is one of: host, otherhost, broadcast, multicast
ae6cf29b PS	64	.SH SEE ALSO
	65	.BR tc (8),
	66	.BR tc-pedit (8)