Reorder and recomment vnet.c and vnet.h on the basis that they are no longer

solely about the virtual network stack memory allocator.

Approved by:	re (vimage blanket)

1 files changed, 14 insertions, 5 deletions

diff --git a/sys/net/vnet.c b/sys/net/vnet.c
index cd5b2b3..eed353e 100644
--- a/sys/net/vnet.c
+++ b/sys/net/vnet.c
@@ -43,11 +43,20 @@ __FBSDID("$FreeBSD$");
 #include <net/vnet.h>
 
 /*-
- * This is the virtual network stack allocator, which provides storage for
- * virtualized global variables.  These variables are defined/declared using
- * the VNET_DEFINE()/VNET_DECLARE() macros, which place them in the
- * 'set_vnet' linker set.  The details of the implementation are somewhat
- * subtle, but allow the majority of most network subsystems to maintain
+ * This file implements core functions for virtual network stacks:
+ *
+ * - Virtual network stack memory allocator, which virtualized global
+ *   variables in the network stack
+ *
+ * - Virtualized SYSINIT's/SYSUNINIT's, which allow network stack subsystems
+ *   to register startup/shutdown events to be run for each virtual network
+ *   stack instance.
+ *
+ * The virtual network stack allocator provides storage for virtualized
+ * global variables.  These variables are defined/declared using the
+ * VNET_DEFINE()/VNET_DECLARE() macros, which place them in the 'set_vnet'
+ * linker set.  The details of the implementation are somewhat subtle, but
+ * allow the majority of most network subsystems to maintain
  * virtualization-agnostic.
  *
  * The virtual network stack allocator handles variables in the base kernel