1.\" $OpenBSD: mpip.4,v 1.3 2021/03/18 14:22:04 kn Exp $ 2.\" 3.\" Copyright (C) 2019 David Gwynne <dlg@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: March 18 2021 $ 18.Dt MPIP 4 19.Os 20.Sh NAME 21.Nm mpip 22.Nd MPLS IP layer 2 pseudowire 23.Sh SYNOPSIS 24.Cd "pseudo-device mpip" 25.Sh DESCRIPTION 26The 27.Nm 28interface is used to create an MPLS IP layer 2 tunnel between two points. 29.Pp 30An 31.Nm 32interface can be created at runtime using the 33.Sy ifconfig Nm Ns Ar N Cm create 34command, or by setting up a 35.Xr hostname.if 5 36configuration file for 37.Xr netstart 8 . 38The interface itself can be configured with 39.Xr ifconfig 8 . 40.Pp 41The local MPLS label, the remote MPLS label and neighbor, use of 42pseudowire control words, or flow-aware transport are normally 43configured after negotiation with a remote system using 44.Xr ldpd 8 , 45but it is also possible to configure them manually using 46.Xr ifconfig 8 . 47.Sh EXAMPLES 48Create a pseudowire with local label 20 and remote label 21 on 49neighbor 10.254.0.1: 50.Bd -literal -offset indent 51# ifconfig mpip5 create 52# ifconfig mpip5 mplslabel 20 pweneighbor 21 10.254.0.1 53# ifconfig mpip5 up 54.Ed 55.Pp 56Disable the use of the Pseudowire Emulation Edge-to-Edge (PWE3) 57Control Word, and enable the use of a Flow label for Flow-Aware 58Transport of Pseudowires: 59.Bd -literal -offset indent 60# ifconfig mpip5 -pwecw pwefat 61.Ed 62.Sh SEE ALSO 63.Xr mpe 4 , 64.Xr mpw 4 , 65.Xr hostname.if 5 , 66.Xr ifconfig 8 , 67.Xr ldpd 8 , 68.Xr netstart 8 69.Sh STANDARDS 70.Rs 71.%A S. Bryant 72.%A P. Pate 73.%D March 2005 74.%R RFC 3985 75.%T Pseudo Wire Emulation Edge-to-Edge (PWE3) Architecture 76.Re 77.Pp 78.Rs 79.%A S. Bryant 80.%A G. Swallow 81.%A L. Martini 82.%D February 2005 83.%R RFC 4385 84.%T Pseudowire Emulation Edge-to-Edge (PWE3) Control Word \ 85for Use over an MPLS PSN 86.Re 87.Pp 88.Rs 89.%A S. Bryant 90.%A C. Filsfils 91.%A U. Drafz 92.%A V. Kompella 93.%A J. Regan 94.%A S. Amante 95.%D November 2011 96.%R RFC 6391 97.%T Flow-Aware Transport of Pseudowires over an MPLS Packet Switched Network 98.Re 99.Sh HISTORY 100The 101.Nm 102kernel interface first appeared in 103.Ox 6.5 . 104