1*dd674b1aSjmc.\" $OpenBSD: rport.4,v 1.2 2024/08/31 13:39:36 jmc Exp $ 2d201cf92Sdlg.\" 3d201cf92Sdlg.\" Copyright (c) 2024 David Gwynne <dlg@openbsd.org> 4d201cf92Sdlg.\" 5d201cf92Sdlg.\" Permission to use, copy, modify, and distribute this software for any 6d201cf92Sdlg.\" purpose with or without fee is hereby granted, provided that the above 7d201cf92Sdlg.\" copyright notice and this permission notice appear in all copies. 8d201cf92Sdlg.\" 9d201cf92Sdlg.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10d201cf92Sdlg.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11d201cf92Sdlg.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12d201cf92Sdlg.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13d201cf92Sdlg.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14d201cf92Sdlg.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15d201cf92Sdlg.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16d201cf92Sdlg.\" 17d201cf92Sdlg.Dd $Mdocdate: August 31 2024 $ 18d201cf92Sdlg.Dt RPORT 4 19d201cf92Sdlg.Os 20d201cf92Sdlg.Sh NAME 21d201cf92Sdlg.Nm rport 22d201cf92Sdlg.Nd rdomain port interface pseudo-device 23d201cf92Sdlg.Sh SYNOPSIS 24d201cf92Sdlg.Cd "pseudo-device rport" 25d201cf92Sdlg.Sh DESCRIPTION 26d201cf92SdlgThe 27d201cf92Sdlg.Nm 28d201cf92Sdlgdriver provides point-to-point interfaces for layer 3 connectivity 29d201cf92Sdlgbetween 30d201cf92Sdlg.Xr rdomain 4 31d201cf92Sdlginstances. 32d201cf92Sdlg.Pp 33d201cf92SdlgLayer 3 connectivity between a pair of rdomains can be established 34*dd674b1aSjmcby creating an 35d201cf92Sdlg.Nm 36d201cf92Sdlginterface in each rdomain, and connecting them together by configuring 37d201cf92Sdlgone of these interfaces as the parent of the other. 38d201cf92Sdlg.Pp 39d201cf92Sdlg.Nm 40d201cf92Sdlginterfaces can be created at runtime using the 41d201cf92Sdlg.Ic ifconfig rport Ns Ar N Ic create 42d201cf92Sdlgcommand or by setting up a 43d201cf92Sdlg.Xr hostname.if 5 44d201cf92Sdlgconfiguration file for 45d201cf92Sdlg.Xr netstart 8 . 46d201cf92SdlgThe interface itself can be configured with 47d201cf92Sdlg.Xr ifconfig 8 ; 48d201cf92Sdlgsee its manual page for more information. 49d201cf92Sdlg.Sh EXAMPLES 50d201cf92SdlgCreate two 51d201cf92Sdlg.Nm 52d201cf92Sdlginterfaces in separate 53*dd674b1aSjmc.Xr rdomain 4 54*dd674b1aSjmcinstances and connect them together: 55d201cf92Sdlg.Bd -literal -offset indent 56d201cf92Sdlg# ifconfig rport0 create rdomain 0 up 57d201cf92Sdlg# ifconfig rport1 create rdomain 1 parent rport0 up 58d201cf92Sdlg# ifconfig rport0 inet 192.168.0.0/32 192.168.0.1 59d201cf92Sdlg# ifconfig rport1 inet 192.168.0.1/32 192.168.0.0 60d201cf92Sdlg.Ed 61d201cf92Sdlg.Sh SEE ALSO 62d201cf92Sdlg.Xr netintro 4 , 63d201cf92Sdlg.Xr veb 4 , 64d201cf92Sdlg.Xr hostname.if 5 , 65d201cf92Sdlg.Xr pf.conf 5 , 66d201cf92Sdlg.Xr ifconfig 8 , 67d201cf92Sdlg.Xr netstart 8 68d201cf92Sdlg.Sh HISTORY 69d201cf92SdlgThe 70d201cf92Sdlg.Nm 71d201cf92Sdlgdriver first appeared in 72d201cf92Sdlg.Ox 7.6 . 73d201cf92Sdlg.Sh AUTHORS 74d201cf92Sdlg.An David Gwynne Aq Mt dlg@openbsd.org . 75d201cf92Sdlg.Sh CAVEATS 76d201cf92SdlgA pair of 77d201cf92Sdlg.Nm 78d201cf92Sdlginterfaces must be created for each connection between a pair of rdomains. 79d201cf92SdlgAlternatively, if peering between multiple 80d201cf92Sdlg.Xr rdomain 4 81d201cf92Sdlginstances is required, a single 82d201cf92Sdlg.Xr veb 4 83d201cf92Sdlginterface with a 84d201cf92Sdlg.Xr vport 4 85d201cf92Sdlginterface for each rdomain can be used instead. 86