1.\" $OpenBSD: mpip.4,v 1.2 2019/03/11 18:55:29 jmc 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 11 2019 $ 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 hostname.if 5 , 64.Xr ifconfig 8 , 65.Xr ldpd 8 , 66.Xr netstart 8 67.Sh STANDARDS 68.Rs 69.%A S. Bryant 70.%A P. Pate 71.%D March 2005 72.%R RFC 3985 73.%T Pseudo Wire Emulation Edge-to-Edge (PWE3) Architecture 74.Re 75.Pp 76.Rs 77.%A S. Bryant 78.%A G. Swallow 79.%A L. Martini 80.%D February 2005 81.%R RFC 4385 82.%T Pseudowire Emulation Edge-to-Edge (PWE3) Control Word \ 83for Use over an MPLS PSN 84.Re 85.Pp 86.Rs 87.%A S. Bryant 88.%A C. Filsfils 89.%A U. Drafz 90.%A V. Kompella 91.%A J. Regan 92.%A S. Amante 93.%D November 2011 94.%R RFC 6391 95.%T Flow-Aware Transport of Pseudowires over an MPLS Packet Switched Network 96.Re 97.Sh HISTORY 98The 99.Nm 100kernel interface first appeared in 101.Ox 6.5 . 102