summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--share/man/man4/Makefile8
-rw-r--r--share/man/man4/mpip.4101
2 files changed, 105 insertions, 4 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 6242b03f4a3..cff5be21dbb 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.701 2019/01/19 00:27:04 dlg Exp $
+# $OpenBSD: Makefile,v 1.702 2019/03/11 10:48:45 dlg Exp $
MAN= aac.4 abcrtc.4 ac97.4 acphy.4 acrtc.4 \
acpi.4 acpiac.4 acpials.4 acpiasus.4 acpibat.4 \
@@ -43,9 +43,9 @@ MAN= aac.4 abcrtc.4 ac97.4 acphy.4 acrtc.4 \
maestro.4 mainbus.4 malo.4 maxds.4 maxrtc.4 maxtmp.4 mbg.4 midi.4 \
mii.4 mfi.4 \
mfii.4 mlphy.4 mobileip.4 moscom.4 mos.4 mpe.4 mpath.4 mpi.4 mpii.4 \
- mpu.4 msk.4 mpw.4 msts.4 mtd.4 mtdphy.4 mtio.4 mue.4 multicast.4 \
- mvclock.4 mvgpio.4 mvicu.4 mvneta.4 mvpinctrl.4 mvrng.4 mvrtc.4 \
- mvtemp.4 myx.4 \
+ mpip.4 mpu.4 msk.4 mpw.4 msts.4 mtd.4 mtdphy.4 mtio.4 mue.4 \
+ multicast.4 mvclock.4 mvgpio.4 mvicu.4 mvneta.4 mvpinctrl.4 mvrng.4 \
+ mvrtc.4 mvtemp.4 myx.4 \
ne.4 neo.4 nep.4 netintro.4 nfe.4 nge.4 nmea.4 \
nsclpcsio.4 nsgphy.4 nsphy.4 nsphyter.4 null.4 nviic.4 nvme.4 nvt.4 \
oce.4 ohci.4 options.4 onewire.4 oosiop.4 osiop.4 otus.4 \
diff --git a/share/man/man4/mpip.4 b/share/man/man4/mpip.4
new file mode 100644
index 00000000000..6ac3ae2ec99
--- /dev/null
+++ b/share/man/man4/mpip.4
@@ -0,0 +1,101 @@
+.\" $OpenBSD: mpip.4,v 1.1 2019/03/11 10:48:45 dlg 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.
+.Pp
+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 .
+.Pp
+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.
+.Bd -literal -offset indent
+# ifconfig mpip5 create
+# ifconfig mpip5 mplslabel 20 pweneighbor 21 10.254.0.1
+# ifconfig mpip5 up
+.Ed
+.Pp
+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.
+.Bd -literal -offset indent
+# ifconfig mpip5 -pwecw pwefat
+.Ed
+.Sh SEE ALSO
+.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
+.Pp
+.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
+.Pp
+.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 .