From e36efedce7546518c99aa5da7538242f14c49aac Mon Sep 17 00:00:00 2001
From: rpe <>
Date: Wed, 21 Feb 2018 19:57:21 +0000
Subject: [PATCH] Tweak comments.

OK tb
---
 src/etc/netstart | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/etc/netstart b/src/etc/netstart
index 507c9e7e..1cfb651d 100644
--- a/src/etc/netstart
+++ b/src/etc/netstart
@@ -1,6 +1,6 @@
 #!/bin/sh -
 #
-#	$OpenBSD: netstart,v 1.194 2018/02/19 23:42:29 rpe Exp $
+#	$OpenBSD: netstart,v 1.195 2018/02/21 19:57:21 rpe Exp $
 
 # Turn off Strict Bourne shell mode.
 set +o sh
@@ -73,6 +73,7 @@ parse_hn_line() {
 }
 
 # Create interface $1 if it does not yet exist.
+# Usage: ifcreate if1
 ifcreate() {
 	local _if=$1
 
@@ -80,6 +81,7 @@ ifcreate() {
 }
 
 # Create interfaces for network pseudo-devices referred to by hostname.if files.
+# Usage: vifscreate
 vifscreate() {
 	local _vif _hn _if
 
@@ -166,7 +168,7 @@ ifmstart() {
 	done
 }
 
-# Parse /etc/mygate and add default routes for IPv4 and IPv6
+# Parse /etc/mygate and add default routes for IPv4 and IPv6.
 # Usage: defaultroute
 defaultroute() {
 	local _cmd;
@@ -216,6 +218,8 @@ if $PRINT_ONLY && (($# == 0)); then
 	exit 1
 fi
 
+# Load key material for the generation of IPv6 Semantically Opaque Interface
+# Identifiers (SOII) used for link local and SLAAC addresses.
 $PRINT_ONLY || [[ ! -f /etc/soii.key ]] ||
 	sysctl -q "net.inet6.ip6.soiikey=$(</etc/soii.key)"
 
@@ -236,8 +240,8 @@ fi
 # automatically invokes the IPv6 address ::1.
 ifconfig lo0 inet 127.0.0.1/8
 
+# IPv6 configuration.
 if ifconfig lo0 inet6 >/dev/null 2>&1; then
-	# IPv6 configurations.
 	ip6kernel=YES
 
 	# Disallow link-local unicast dest without outgoing scope identifiers.
@@ -282,7 +286,7 @@ else
 	ip6kernel=NO
 fi
 
-# Create all the pseudo interfaces up front
+# Create all the pseudo interfaces up front.
 vifscreate
 
 # Configure all the non-loopback interfaces which we know about, but
@@ -294,7 +298,7 @@ ifmstart "" "trunk svlan vlan carp pppoe tun tap gif etherip gre egre mobileip p
 # Configure all the carp interfaces which we know about before default route.
 ifmstart "trunk svlan vlan carp pppoe"
 
-# Look for default routes in /etc/mygate.
+# Set default routes for IPv4 and IPv6.
 defaultroute
 
 # Multicast routing.
@@ -310,7 +314,7 @@ route -qn add -net 127 127.0.0.1 -reject >/dev/null
 ifmstart "tun tap gif etherip gre egre mobileip pflow"
 
 if [[ $ip6kernel == YES ]]; then
-	# This is to make sure DAD is completed before going further.
+	# Ensure IPv6 Duplicate Address Detection (DAD) is completed.
 	count=0
 	while ((count++ < 10 && $(sysctl -n net.inet6.ip6.dad_pending) != 0)); do
 		sleep 1