diff options
Diffstat (limited to 'share/man')
| -rw-r--r-- | share/man/man4/bridge.4 | 13 | ||||
| -rw-r--r-- | share/man/man4/carp.4 | 15 | ||||
| -rw-r--r-- | share/man/man4/faith.4 | 11 | ||||
| -rw-r--r-- | share/man/man4/gif.4 | 11 | ||||
| -rw-r--r-- | share/man/man4/gre.4 | 15 | ||||
| -rw-r--r-- | share/man/man4/lo.4 | 31 | ||||
| -rw-r--r-- | share/man/man4/ppp.4 | 15 | ||||
| -rw-r--r-- | share/man/man4/sl.4 | 15 | ||||
| -rw-r--r-- | share/man/man4/tun.4 | 16 | ||||
| -rw-r--r-- | share/man/man4/vlan.4 | 13 |
10 files changed, 127 insertions, 28 deletions
diff --git a/share/man/man4/bridge.4 b/share/man/man4/bridge.4 index d0cd039b0d2..9877b601d03 100644 --- a/share/man/man4/bridge.4 +++ b/share/man/man4/bridge.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bridge.4,v 1.54 2003/11/09 16:06:07 jmc Exp $ +.\" $OpenBSD: bridge.4,v 1.55 2003/12/08 10:03:43 markus Exp $ .\" .\" Copyright (c) 1999-2001 Jason L. Wright (jason@thought.net) .\" All rights reserved. @@ -31,7 +31,7 @@ .Nm bridge .Nd Ethernet bridge interface .Sh SYNOPSIS -.Cd "pseudo-device bridge 2" +.Cd "pseudo-device bridge" Op Ar count .Sh DESCRIPTION The .Nm @@ -47,6 +47,15 @@ a transparent filter for .Xr ip 4 datagrams. .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig bridgeN create +command or by setting up a +.Xr bridgename.if 5 +configuration file for +.Xr netstart 8 . +.Pp The bridges provided by this interface are learning bridges with filtering, see .Xr pf 4 . diff --git a/share/man/man4/carp.4 b/share/man/man4/carp.4 index b9f3e3079e8..a1cff5d1650 100644 --- a/share/man/man4/carp.4 +++ b/share/man/man4/carp.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: carp.4,v 1.4 2003/10/19 03:57:25 david Exp $ +.\" $OpenBSD: carp.4,v 1.5 2003/12/08 10:03:43 markus Exp $ .\" .\" Copyright (c) 2003, Ryan McBride. All rights reserved. .\" @@ -43,6 +43,15 @@ addresses are always available, but in some configurations .Nm can also provide load balancing functionality. .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig carpN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp To use .Nm , the administrator needs to configure at minimum a common virtual host ID and @@ -79,14 +88,18 @@ The of 100 on the second virtual host means that it's advertisements will be sent out slightly less frequently. .Bd -literal -offset indent +# ifconfig carp0 create # ifconfig carp0 vhid 1 pass mekmitasdigoat 192.168.1.10 +# ifconfig carp1 create # ifconfig carp1 vhid 2 advskew 100 pass mekmitasdigoat 192.168.1.10 .Ed .Pp Now we configure Host B. The configuration is identical, except we skew virtual host 1 instead. .Bd -literal -offset indent +# ifconfig carp0 create # ifconfig carp0 vhid 1 advskew 100 pass mekmitasdigoat 192.168.1.10 +# ifconfig carp1 create # ifconfig carp1 vhid 2 pass mekmitasdigoat 192.168.1.10 .Ed .Pp diff --git a/share/man/man4/faith.4 b/share/man/man4/faith.4 index b46d2a4910a..2480d89b13c 100644 --- a/share/man/man4/faith.4 +++ b/share/man/man4/faith.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: faith.4,v 1.13 2003/08/08 09:51:53 jmc Exp $ +.\" $OpenBSD: faith.4,v 1.14 2003/12/08 10:03:43 markus Exp $ .\" $KAME: faith.4,v 1.10 2001/06/30 00:42:48 itojun Exp $ .\" .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. @@ -44,6 +44,15 @@ for implementing userland IPv6-to-IPv4 TCP relay similar to .Xr faithd 8 . .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig faithN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp Special action will be taken when IPv6 TCP traffic is seen on a router, and the routing table suggests routing it to the .Nm diff --git a/share/man/man4/gif.4 b/share/man/man4/gif.4 index 7466047bb8a..f2a4b722e83 100644 --- a/share/man/man4/gif.4 +++ b/share/man/man4/gif.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gif.4,v 1.12 2003/08/08 09:51:53 jmc Exp $ +.\" $OpenBSD: gif.4,v 1.13 2003/12/08 10:03:43 markus Exp $ .\" $KAME: gif.4,v 1.15 2000/04/19 09:39:42 itojun Exp $ .\" .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. @@ -46,6 +46,15 @@ The behavior of .Nm is mainly based on RFC 1933 IPv6-over-IPv4 configured tunnel. .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig gifN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp To use .Nm gif , the administrator needs to configure the addresses used for the outer header. diff --git a/share/man/man4/gre.4 b/share/man/man4/gre.4 index 90a946592e2..48e13f54b62 100644 --- a/share/man/man4/gre.4 +++ b/share/man/man4/gre.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: gre.4,v 1.21 2003/11/21 09:26:54 jmc Exp $ +.\" $OpenBSD: gre.4,v 1.22 2003/12/08 10:03:43 markus Exp $ .\" $NetBSD: gre.4,v 1.10 1999/12/22 14:55:49 kleink Exp $ .\" .\" Copyright 1998 (c) The NetBSD Foundation, Inc. @@ -42,7 +42,7 @@ .Nm gre .Nd encapsulating network device .Sh SYNOPSIS -.Cd pseudo-device gre Op Ar count +.Cd "pseudo-device gre" Op Ar count .Sh NOTE .Tn GRE , .Tn WCCPv1 , @@ -66,6 +66,15 @@ The network interface allows tunnel construction using the Cisco GRE or the Mobile-IP (RFC 2004) encapsulation protocols. .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig greN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp This driver currently supports the following modes of operation: .Bl -tag -width abc .It GRE encapsulation (IP protocol number 47). @@ -136,6 +145,7 @@ Host X-- Host A ----------------tunnel---------- Cisco D------Host E On Host A (OpenBSD): .Bd -literal -offset indent # route add default B +# ifconfig greN create # ifconfig greN A D netmask 0xffffffff linkX up # ifconfig greN tunnel A D # route add E D @@ -157,6 +167,7 @@ OR On Host D (OpenBSD): .Bd -literal -offset indent # route add default C +# ifconfig greN create # ifconfig greN D A # ifconfig greN tunnel D A .Ed diff --git a/share/man/man4/lo.4 b/share/man/man4/lo.4 index 3c3c1476565..796e21c969c 100644 --- a/share/man/man4/lo.4 +++ b/share/man/man4/lo.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: lo.4,v 1.18 2003/07/02 20:45:18 avsm Exp $ +.\" $OpenBSD: lo.4,v 1.19 2003/12/08 10:03:43 markus Exp $ .\" $NetBSD: lo.4,v 1.3 1994/11/30 16:22:23 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -37,13 +37,27 @@ .Nm lo .Nd software loopback network interface .Sh SYNOPSIS -.Sy pseudo-device Nm loop Em <number> +.Cd "pseudo-device Nm loop" Op Ar count .Sh DESCRIPTION The .Nm loop interface is a software loopback mechanism which may be used for performance analysis, software testing, and/or local communication. +.Pp +A +.Nm loop +interface can be created at runtime using the +.Ic ifconfig loN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +The +.Nm lo0 +interface will always exist and cannot be destroyed using +.Xr ifconfig 8 . +.Pp As with other network interfaces, the loopback interface must have network addresses assigned for each address family with which it is to be used. These addresses @@ -71,12 +85,19 @@ flag on interface but instead use another interface like .Nm lo1 . .Sh EXAMPLES -ifconfig lo1 inet 192.168.1.1 netmask 255.255.255.0 link1 +.Bd -literal +# ifconfig lo1 create +# ifconfig lo1 inet 192.168.1.1 netmask 255.255.255.0 link1 +.Ed .Pp is equivalent to: .Pp -awk 'BEGIN {for(i=1;i<255;i++) \ -print "ifconfig lo1 inet 192.168.1."i" netmask 255.255.255.255 alias"}'|sh +.Bd -literal +# ifconfig lo1 create +# awk 'BEGIN {for(i=1;i<255;i++) \e + print "ifconfig lo1 inet 192.168.1."i" netmask 255.255.255.255 alias"}'| \e + sh +.Ed .Sh DIAGNOSTICS .Bl -diag .It lo%d: can't handle af%d. diff --git a/share/man/man4/ppp.4 b/share/man/man4/ppp.4 index 79208dc5933..182587395fa 100644 --- a/share/man/man4/ppp.4 +++ b/share/man/man4/ppp.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ppp.4,v 1.5 2003/08/08 09:51:53 jmc Exp $ +.\" $OpenBSD: ppp.4,v 1.6 2003/12/08 10:03:43 markus Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -36,14 +36,23 @@ .Nm ppp .Nd point to point protocol network interface .Sh SYNOPSIS -.Nm pseudo-device ppp -.Op Ar count +.Cd "pseudo-device ppp" Op Ar count .Sh DESCRIPTION The .Nm interface allows serial lines to be used as network interfaces using the .Em Point-to-Point Protocol (PPP). +.Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig pppN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp The .Nm interface can use various types of compression and has many features diff --git a/share/man/man4/sl.4 b/share/man/man4/sl.4 index 09645eda3b8..41be44a26e7 100644 --- a/share/man/man4/sl.4 +++ b/share/man/man4/sl.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sl.4,v 1.8 2003/06/02 23:30:12 millert Exp $ +.\" $OpenBSD: sl.4,v 1.9 2003/12/08 10:03:43 markus Exp $ .\" $NetBSD: sl.4,v 1.1 1996/08/10 21:26:14 explorer Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -37,14 +37,23 @@ .Nm sl .Nd slip network interface .Sh SYNOPSIS -.Nm pseudo-device sl -.Op Ar count +.Cd "pseudo-device sl" Op Ar count .Sh DESCRIPTION The .Nm interface allows serial lines to be used as network interfaces using the .Em slip protocol. +.Pp +An +.Nm +interface can be created at runtime using the +.Ic ifconfig slN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp The .Nm sl interface can use Van Jacobson TCP header compression and ICMP filtering. diff --git a/share/man/man4/tun.4 b/share/man/man4/tun.4 index b656b5b78c6..e2955ec3e65 100644 --- a/share/man/man4/tun.4 +++ b/share/man/man4/tun.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tun.4,v 1.26 2003/06/06 10:29:41 jmc Exp $ +.\" $OpenBSD: tun.4,v 1.27 2003/12/08 10:03:43 markus Exp $ .\" .\" Copyright (c) 2003 Marcus D. Watts All rights reserved. .\" @@ -33,7 +33,7 @@ .Nm tun .Nd network tunnel pseudo-device .Sh SYNOPSIS -.Cd pseudo-device tun Op Ar count +.Cd "pseudo-device tun" Op Ar count .Pp .Fd #include <sys/types.h> .Fd #include <net/if_tun.h> @@ -45,14 +45,14 @@ Packets sent to this interface can be read by a userland process and processed as desired. Packets written by the userland process are injected back into the kernel networking subsystem. -By default 2 such interfaces are provided. .Pp -The +A .Nm -driver normally appears as a character special device, -.Pa /dev/tun0 , -.Pa /dev/tun1 , -etc. +interface can be created at runtime using the +.Ic ifconfig tunN create +command or by opening the character special device +.Pa /dev/tunN . +.Pp Each device has the exclusive open property; it cannot be opened if it is already open and in use by another process. Each read returns at most one packet; if insufficient diff --git a/share/man/man4/vlan.4 b/share/man/man4/vlan.4 index ac0fc778536..27febe3c8c4 100644 --- a/share/man/man4/vlan.4 +++ b/share/man/man4/vlan.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: vlan.4,v 1.19 2003/06/06 10:29:41 jmc Exp $ +.\" $OpenBSD: vlan.4,v 1.20 2003/12/08 10:03:43 markus Exp $ .\" .\" Copyright (c) 2000 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -41,13 +41,22 @@ .Nm vlan .Nd "IEEE 802.1Q encapsulation/decapsulation pseudo-device" .Sh SYNOPSIS -.Cd pseudo-device vlan Op Ar count +.Cd "pseudo-device vlan" Op Ar count .Sh DESCRIPTION The .Nm Ethernet interface allows construction of virtual LANs when used in conjunction with IEEE 802.1Q-compliant Ethernet devices. .Pp +A +.Nm +interface can be created at runtime using the +.Ic ifconfig vlanN create +command or by setting up a +.Xr hostname.if 5 +configuration file for +.Xr netstart 8 . +.Pp This driver currently supports the following modes of operation: .Bl -tag -width abc .It 802.1Q encapsulation over Ethernet (Ethernet protocol 0x8100) |