$OpenBSD: mpip.4,v 1.3 2021/03/18 14:22:04 kn Exp $

Copyright (C) 2019 David Gwynne <dlg@openbsd.org>

Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

.Dd $Mdocdate: March 11 2019 $ .Dt MPIP 4 .Os .Sh NAME .Nm mpip .Nd MPLS IP layer 2 pseudowire .Sh SYNOPSIS .Cd "pseudo-device mpip" .Sh DESCRIPTION The .Nm interface is used to create an MPLS IP layer 2 tunnel between two points.

p An .Nm interface can be created at runtime using the .Sy ifconfig Nm Ns Ar N Cm create command, or by setting up a .Xr hostname.if 5 configuration file for .Xr netstart 8 . The interface itself can be configured with .Xr ifconfig 8 .

p The local MPLS label, the remote MPLS label and neighbor, use of pseudowire control words, or flow-aware transport are normally configured after negotiation with a remote system using .Xr ldpd 8 , but it is also possible to configure them manually using .Xr ifconfig 8 . .Sh EXAMPLES Create a pseudowire with local label 20 and remote label 21 on neighbor 10.254.0.1: d -literal -offset indent # ifconfig mpip5 create # ifconfig mpip5 mplslabel 20 pweneighbor 21 10.254.0.1 # ifconfig mpip5 up .Ed

p Disable the use of the Pseudowire Emulation Edge-to-Edge (PWE3) Control Word, and enable the use of a Flow label for Flow-Aware Transport of Pseudowires: d -literal -offset indent # ifconfig mpip5 -pwecw pwefat .Ed .Sh SEE ALSO .Xr mpe 4 , .Xr mpw 4 , .Xr hostname.if 5 , .Xr ifconfig 8 , .Xr ldpd 8 , .Xr netstart 8 .Sh STANDARDS .Rs .%A S. Bryant .%A P. Pate .%D March 2005 .%R RFC 3985 .%T Pseudo Wire Emulation Edge-to-Edge (PWE3) Architecture .Re

p .Rs .%A S. Bryant .%A G. Swallow .%A L. Martini .%D February 2005 .%R RFC 4385 .%T Pseudowire Emulation Edge-to-Edge (PWE3) Control Word \ for Use over an MPLS PSN .Re

p .Rs .%A S. Bryant .%A C. Filsfils .%A U. Drafz .%A V. Kompella .%A J. Regan .%A S. Amante .%D November 2011 .%R RFC 6391 .%T Flow-Aware Transport of Pseudowires over an MPLS Packet Switched Network .Re .Sh HISTORY The .Nm kernel interface first appeared in .Ox 6.5 .