{"id":3327,"date":"2022-12-20T17:02:21","date_gmt":"2022-12-20T20:02:21","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/actions-in-tc-man8\/"},"modified":"2022-12-20T17:02:21","modified_gmt":"2022-12-20T20:02:21","slug":"actions-in-tc-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/actions-in-tc-man8\/","title":{"rendered":"actions in tc (man8)"},"content":{"rendered":"

actions in tc<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
OPERATIONS<\/a>
ACTION OPTIONS<\/a>
SEE ALSO<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

actions \u2212 independently defined actions in tc<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

tc<\/b> [ TC_OPTIONS<\/i> ] actions add<\/b> | change<\/b> | replace<\/b> ACTSPEC<\/i><\/p>\n

tc<\/b> [ TC_OPTIONS<\/i> ] actions get<\/b> | delete<\/b> ACTISPEC<\/i><\/p>\n

tc<\/b> [ TC_OPTIONS<\/i> ] actions flush<\/b> ACTNAMESPEC<\/i><\/p>\n

tc<\/b> [ TC_OPTIONS<\/i> ] actions ls<\/b> | list<\/b> ACTNAMESPEC<\/i> [ ACTFILTER<\/i> ]<\/p>\n

ACTSPEC<\/i> := action<\/b> ACTDETAIL<\/i> [ INDEXSPEC<\/i> ] [ COOKIESPEC<\/i> ] [ FLAGS<\/i> ] [ HWSTATSSPEC<\/i> ] [ CONTROL<\/i> ]<\/p>\n

ACTISPEC<\/i> := ACTNAMESPEC INDEXSPEC<\/i><\/p>\n

ACTNAMESPEC<\/i> := action<\/b> ACTNAME<\/p>\n

INDEXSPEC<\/i> := index<\/b> INDEX<\/i><\/p>\n

ACTFILTER<\/i> := since<\/b> MSTIME<\/i><\/p>\n

COOKIESPEC<\/i> := cookie<\/b> COOKIE<\/i><\/p>\n

FLAGS<\/i> := no_percpu<\/i><\/p>\n

HWSTATSSPEC<\/i> := hw_stats<\/b> { immediate<\/i> | delayed<\/i> | disabled<\/i> }<\/p>\n

ACTDETAIL<\/i> := ACTNAME ACTPARAMS<\/i><\/p>\n

ACTNAME<\/i> may be any valid action type: gact, mirred, bpf, connmark, csum, police, etc.<\/p>\n

MSTIME<\/i> Time since last update.<\/p>\n

CONTROL<\/i> := { reclassify<\/i> | pipe<\/i> | drop<\/i> | continue<\/i> | ok<\/i> }<\/p>\n

TC_OPTIONS<\/i> These are the options that are specific to tc<\/b> and not only the options. Refer to tc(8)<\/b> for more information.<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

The actions<\/b> object in tc<\/b> allows a user to define actions independently of a classifier (filter). These actions can then be assigned to one or more filters, with any packets matching the classifier\u2019s criteria having that action performed on them.<\/p>\n

Each action type (mirred, police, etc.) will have its own table to store all created actions.<\/p>\n

OPERATIONS <\/a> <\/h2>\n\n\n\n
<\/td>\n\n

add<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Create a new action in that action\u2019s table.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

change<\/b><\/p>\n<\/td>\n

<\/td>\n<\/td>\n <\/td>\n<\/tr>\n<\/table>\n

replace<\/b><\/p>\n

Make modifications to an existing action.<\/p>\n\n\n\n\n\n\n
<\/td>\n\n

get<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Display the action with the specified index value. When combined with the -s<\/b> option for tc<\/b>, display the statistics for that action.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

delete<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Delete the action with the specified index value. If the action is already associated with a classifier, it does not delete the classifier.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ls<\/b><\/p>\n<\/td>\n

<\/td>\n <\/td>\n<\/tr>\n
<\/td>\n\n

list<\/b><\/p>\n<\/td>\n

<\/td>\n\n

List all the actions in the specified table. When combined with the -s<\/b> option for tc<\/b>, display the statistics for all actions in the specified table. When combined with the option since<\/b> allows doing a millisecond time-filter since the last time an action was used in the datapath.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

flush<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Delete all actions stored in the specified table.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

ACTION OPTIONS <\/a> <\/h2>\n

Note that these options are available to all action types.
index<\/b> INDEX<\/i><\/p>\n

Specify the table index value of an action. INDEX<\/i> is a 32-bit value that is unique to the specific type of action referenced.<\/p>\n

For add<\/b>, change<\/b>, and replace<\/b> operations, the index is optional.<\/b> When adding a new action, specifying an index value will assign the action to that index unless that index value has already been assigned. Omitting the index value for an add operation will cause the kernel to assign a value to the new action.<\/p>\n

For get<\/b> and delete<\/b> operations, the index is required<\/b> to identify the specific action to be displayed or deleted.<\/p>\n

cookie<\/b> COOKIE<\/i><\/p>\n

In addition to the specific action, mark the matching packet with the value specified by COOKIE<\/i>. The COOKIE<\/i> is a 128-bit value that will not be interpreted by the kernel whatsoever. As such, it can be used as a correlating value for maintaining user state. The value to be stored is completely arbitrary and does not require a specific format. It is stored inside the action structure itself.<\/p>\n\n\n
<\/td>\n\n

FLAGS<\/i><\/p>\n<\/td>\n

<\/td>\n\n

Action-specific flags. Currently, the only supported flag is no_percpu<\/i> which indicates that action is expected to have minimal software data-path traffic and doesn\u2019t need to allocate stat counters with percpu allocator. This option is intended to be used by hardware-offloaded actions.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

hw_stats<\/b> HW_STATS<\/i><\/p>\n

Specifies the type of HW stats of new action. If omitted, any stats counter type is going to be used, according to driver and its resources. The HW_STATS<\/i> indicates the type. Any of the following are valid:
immediate<\/b><\/p>\n

Means that in dump, user gets the current HW stats state from the device queried at the dump time.<\/p>\n

delayed<\/b><\/p>\n

Means that in dump, user gets HW stats that might be out of date for some time, maybe couple of seconds. This is the case when driver polls stats updates periodically or when it gets async stats update from the device.<\/p>\n

disabled<\/b><\/p>\n

No HW stats are going to be available in dump.<\/p>\n

since<\/b> MSTIME<\/i><\/p>\n

When dumping large number of actions, a millisecond time-filter can be specified MSTIME<\/i>. The MSTIME<\/i> is a millisecond count since last time a packet hit the action. As an example specifying “since 20000” implies to dump all actions that have seen packets in the last 20 seconds. This option is useful when the kernel has a large number of actions and you are only interested in recently used actions.<\/p>\n

CONTROL<\/i><\/p>\n

The CONTROL<\/i> indicates how tc<\/b> should proceed after executing the action. Any of the following are valid:
reclassify<\/b><\/p>\n

Restart the classifiction by jumping back to the first filter attached to the action\u2019s parent.<\/p>\n\n\n\n
<\/td>\n\n

pipe<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Continue with the next action. This is the default control.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

drop<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Drop the packed without running any further actions.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

continue<\/b><\/p>\n

Continue the classification with the next filter.<\/p>\n\n\n
<\/td>\n\n

pass<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Return to the calling qdisc for packet processing, and end classification of this packet.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

SEE ALSO <\/a> <\/h2>\n

tc<\/b>(8), tc-bpf<\/b>(8), tc-connmark<\/b>(8), tc-csum<\/b>(8), tc-ife<\/b>(8), tc-mirred<\/b>(8), tc-nat<\/b>(8), tc-pedit<\/b>(8), tc-police<\/b>(8), tc-simple<\/b>(8), tc-skbedit<\/b>(8), tc-skbmod<\/b>(8), tc-tunnel_key<\/b>(8), tc-vlan<\/b>(8), tc-xt<\/b>(8)<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

actions \u2212 independently defined actions in tc <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,457],"class_list":["post-3327","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-tc-actions"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3327","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3327"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3327\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3327"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3327"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3327"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}