tc-mpls(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | COLOPHON

MPLS manipulation action in tc(8) LinuxMPLS manipulation action in tc(8)

NAME         top

       mpls - mpls manipulation module

SYNOPSIS         top

       tc ... action mpls { POP | PUSH | MODIFY | dec_ttl } [ CONTROL ]

       POP := pop protocol MPLS_PROTO

       PUSH := { push | mac_push } [ protocol MPLS_PROTO ]  [ tc MPLS_TC
               ]  [ ttl MPLS_TTL ]  [ bos MPLS_BOS ] label MPLS_LABEL

       MODIFY := modify [ label MPLS_LABEL ]  [ tc MPLS_TC ]  [ ttl
               MPLS_TTL ]

       CONTROL := { reclassify | pipe | drop | continue | pass | goto
               chain CHAIN_INDEX }

DESCRIPTION         top

       The mpls action performs mpls encapsulation or decapsulation on a
       packet, reflected by the operation modes POP, PUSH, MODIFY and
       DEC_TTL.  The POP mode requires the ethertype of the header that
       follows the MPLS header (e.g.  IPv4 or another MPLS). It will
       remove the outer MPLS header and replace the ethertype in the MAC
       header with that passed. The PUSH and MODIFY modes update the
       current MPLS header information or add a new header.  PUSH
       requires at least an MPLS_LABEL.  DEC_TTL requires no arguments
       and simply subtracts 1 from the MPLS header TTL field.

OPTIONS         top

       pop    Decapsulation mode. Requires the protocol of the next
              header.

       push   Encapsulation mode. Adds the MPLS header between the MAC
              and the network headers. Requires at least the label
              option.

       mac_push
              Encapsulation mode. Adds the MPLS header before the MAC
              header. Requires at least the label option.

       modify Replace mode. Existing MPLS tag is replaced.  label, tc,
              and ttl are all optional.

       dec_ttl
              Decrement the TTL field on the outer most MPLS header.

       label MPLS_LABEL
              Specify the MPLS LABEL for the outer MPLS header.
              MPLS_LABEL is an unsigned 20bit integer, the format is
              detected automatically (e.g. prefix with '0x' for
              hexadecimal interpretation, etc.).

       protocol MPLS_PROTO
              Choose the protocol to use. For push actions this must be
              mpls_uc or mpls_mc (mpls_uc is the default). For pop
              actions it should be the protocol of the next header.
              This option cannot be used with modify.

       tc MPLS_TC
              Choose the TC value for the outer MPLS header. Decimal
              number in range of 0-7.  Defaults to 0.

       ttl MPLS_TTL
              Choose the TTL value for the outer MPLS header. Number in
              range of 0-255. A non-zero default value will be selected
              if this is not explicitly set.

       bos MPLS_BOS
              Manually configure the bottom of stack bit for an MPLS
              header push. The default is for TC to automatically set
              (or unset) the bit based on the next header of the packet.

       CONTROL
              How to continue after executing this action.

              reclassify
                     Restarts classification by jumping back to the
                     first filter attached to this action's parent.

              pipe   Continue with the next action, this is the default.

              drop   Packet will be dropped without running further
                     actions.

              continue
                     Continue classification with next filter in line.

              pass   Return to calling qdisc for packet processing. This
                     ends the classification process.

EXAMPLES         top

       The following example encapsulates incoming IP packets on eth0
       into MPLS with a label 123 and sends them out eth1:

              #tc qdisc add dev eth0 handle ffff: ingress
              #tc filter add dev eth0 protocol ip parent ffff: flower \
                   action mpls push protocol mpls_uc label 123  \
                   action mirred egress redirect dev eth1

       In this example, incoming MPLS unicast packets on eth0 are
       decapsulated and redirected to eth1:

              #tc qdisc add dev eth0 handle ffff: ingress
              #tc filter add dev eth0 protocol mpls_uc parent ffff: flower \
                   action mpls pop protocol ipv4  \
                   action mirred egress redirect dev eth1

       Here is another example, where incoming Ethernet frames are
       encapsulated into MPLS with label 123 and TTL 64. Then, an outer
       Ethernet header is added and the resulting frame is finally sent
       on eth1:

              #tc qdisc add dev eth0 ingress
              #tc filter add dev eth0 ingress matchall \
                   action mpls mac_push label 123 ttl 64 \
                   action vlan push_eth \
                        dst_mac 02:00:00:00:00:02 \
                        src_mac 02:00:00:00:00:01 \
                   action mirred egress redirect dev eth1

       The following example assumes that incoming MPLS packets with
       label 123 transport Ethernet frames. The outer Ethernet and the
       MPLS headers are stripped, then the inner Ethernet frame is sent
       on eth1:

              #tc qdisc add dev eth0 ingress
              #tc filter add dev eth0 ingress protocol mpls_uc \
                   flower mpls_label 123 mpls_bos 1 \
                   action vlan pop_eth \
                   action mpls pop protocol teb \
                   action mirred egress redirect dev eth1

SEE ALSO         top

       tc(8), tc-mirred(8), tc-vlan(8)

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling
       TCP/IP networking and traffic) project.  Information about the
       project can be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was
       obtained from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-12-20.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

iproute2                       22 May 20M1P9LS manipulation action in tc(8)

Pages that refer to this page: tc-vlan(8)