summaryrefslogtreecommitdiff
path: root/share/man/man5
diff options
context:
space:
mode:
authorTheo de Raadt <deraadt@cvs.openbsd.org>2003-03-10 09:16:07 +0000
committerTheo de Raadt <deraadt@cvs.openbsd.org>2003-03-10 09:16:07 +0000
commit5a769daf25c3cc1494c96fe9dbad1e91879f0357 (patch)
treeb97dec4abb3a7753d615a11e1033c8104120a1e6 /share/man/man5
parentdbe3b8536dba69e7d7247f30d5073dae27e22a50 (diff)
real pretty now
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/hostname.if.563
1 files changed, 38 insertions, 25 deletions
diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5
index 9be6c664634..d7c3508cd5d 100644
--- a/share/man/man5/hostname.if.5
+++ b/share/man/man5/hostname.if.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: hostname.if.5,v 1.29 2002/09/26 22:12:43 miod Exp $
+.\" $OpenBSD: hostname.if.5,v 1.30 2003/03/10 09:16:06 deraadt Exp $
.\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -60,19 +60,31 @@ The following three formats are valid for
files.
.Pp
Regular ipv4 network setup:
-.Bd -literal -offset xxxx
-.Va addr_family [ alias ] addr netmask broadcast_addr options
-.Li dest Va dest_addr
+.Bd -ragged -offset xxxx
+.Va addr_family
+.Op Va alias
+.Va addr
+.Va netmask
+.Va broadcast_addr
+.Va options
+.br
+.Li dest
+.Va dest_addr
.Ed
.Pp
Regular ipv6 network setup:
-.Bd -literal -offset xxxx
-.Va addr_family [ alias ] addr prefixlen options
+.Bd -ragged -offset xxxx
+.Va addr_family
+.Op Va alias
+.Va addr
+.Va prefixlen
+.Va options
.Ed
.Pp
Other network setup:
-.Bd -literal -offset xxxx
-.Va addr_family Va options
+.Bd -ragged -offset xxxx
+.Va addr_family
+.Va options
.Ed
.Pp
A typical file contains only one line, but more extensive files are possible,
@@ -101,8 +113,8 @@ The optional address that belongs to the interface, such as
190.191.192.1 or fe80:2::1 .
It is also feasible to use a hostname as specified in
.Pa /etc/hosts .
-It is recommended that an address be used instead of symbolic information
-which might activate
+It is recommended that an address be used instead of symbolic information,
+since the latter might activate
.Xr resolver 3
library routines.
.Pp
@@ -138,10 +150,10 @@ library routines.
.It Va prefixlen
The prefixlen number, or number of bits in the netmask, to be set on
the interface, such as 64.
-.It Va #
+.It Li #
Comments are allowed.
Anything following a comment character is treated as a comment.
-.It Va ! Ar command-line
+.It Li ! Ns Ar command-line
Arbitrary shell commands can be executed using this directive.
Useful for doing interface specific configuration using commands like
.Xr wicontrol 8 ,
@@ -155,9 +167,9 @@ in a command line will be replaced by the interface name.
.El
.Pp
A DHCP-configured network interface setup consists of
-.Pp
-.Bd -literal -offset xxxx
-.Li dhcp Va options
+.Bd -ragged -offset xxxx
+.Li dhcp
+.Va options
.Ed
.Pp
For example,
@@ -182,9 +194,9 @@ Optional miscellaneous options to set on the interface, i.e.,
.El
.Pp
IPv6 stateless address autoconfiguration:
-.Pp
-.Bd -literal -offset xxxx
-.Li rtsol Va options
+.Bd -ragged -offset xxxx
+.Li rtsol
+.Va options
.Ed
.Pp
The above format has the following field values:
@@ -202,8 +214,8 @@ router advertisement, and configured as a host (ie. non-router).
Add the following lines into
.Xr sysctl.conf 5 :
.Bd -literal -offset xxxx
-.Li net.inet6.ip6.forwarding=0
-.Li net.inet6.ip6.accept_rtadv=1
+net.inet6.ip6.forwarding=0
+net.inet6.ip6.accept_rtadv=1
.Ed
.It Va options
Optional miscellaneous options to set on the interface, e.g.,
@@ -215,9 +227,9 @@ An addressless network interface setup (useful for
member interfaces and interfaces to be used with
.Xr pppoe 8 )
consists of
-.Pp
-.Bd -literal -offset xxxx
-.Li up Va options
+.Bd -ragged -offset xxxx
+.Li up
+.Va options
.Ed
.Pp
The above format has the following field values:
@@ -235,10 +247,11 @@ The final file format only applies to
.Nm bridgename.bridge*
files.
A bridge interface setup consists of
-.Pp
-.Bd -literal -offset xxxx
+.Bd -ragged -offset xxxx
.Va brconfig-arguments
+.br
.Va brconfig-arguments
+.br
\&...
.Ed
.Pp