docs/103151: Some minor update for using gif(4)

[loader]

>Number:         103151
>Category:       docs
>Synopsis:       Some minor update for using gif(4)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 11 16:20:20 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     loader
>Release:        7.0-CURRENT
>Organization:
FreeBSD Mall
>Environment:
FreeBSD gnus.unknown.com 7.0-CURRENT FreeBSD 7.0-CURRENT #5: Thu Sep  7 15:34:40 CST 2006     root at gnus.unknown.com:/usr/obj/usr/src/sys/gnus  i386

>Description:
Some minor update:

o device gif0 need to be created by running "ifconfig gif0 create" first.
o the output of "ifconfig gif0" changed.
o gif_interfaces should be in /etc/rc.conf to make it take effect on booting.
>How-To-Repeat:

>Fix:
diff -ruN chapter.sgml.orig chapter.sgml
--- chapter.sgml.orig   Mon Sep 11 23:26:01 2006
+++ chapter.sgml        Tue Sep 12 00:09:55 2006
@@ -3410,18 +3410,20 @@
         configured using &man.ifconfig.8;.</para>
  
       <para>On the gateway machine on network #1 you would run the
-        following two commands to configure the tunnel.</para>
- 
-      <programlisting>ifconfig gif0 A.B.C.D W.X.Y.Z
-ifconfig gif0 inet 192.168.1.1 192.168.2.1 netmask 0xffffffff
-      </programlisting>
+        following commands to configure the tunnel.</para>
  
+      <screen>&prompt.root; <userinput>ifconfig <replaceable>gif0</replaceable> create</userinput>
+&prompt.root; <userinput>ifconfig tunnel <replaceable>gif0</replaceable> <replaceable>A.B.C.D</replaceable> <replaceable>W.X.Y.Z</replaceable></userinput>
+&prompt.root <userinput>ifconfig <replaceable>gif0</replaceable> inet <replaceable>192.168.1.1</replaceable> <replaceable>192.168.2.1</replaceable> netmask <replaceable>0xffffffff</replaceable></userinput>
+      </screen>
+
       <para>On the other gateway machine you run the same commands,
         but with the order of the IP addresses reversed.</para>
  
-      <programlisting>ifconfig gif0 W.X.Y.Z A.B.C.D
-ifconfig gif0 inet 192.168.2.1 192.168.1.1 netmask 0xffffffff
-      </programlisting>
+      <screen>&prompt.root; <userinput>ifconfig <replaceable>gif0</replaceable> create</userinput>
+&prompt.root; <userinput>ifconfig tunnel <replaceable>gif0</replaceable> <replaceable>W.X.Y.Z</replaceable> <replaceable>A.B.C.D</replaceable></userinput>
+&prompt.root; <userinput>ifconfig <replaceable>gif0</replaceable> inet <replaceable>192.168.2.1</replaceable> <replaceable>192.168.1.1</replaceable> netmask <replaceable>0xffffffff</replaceable></userinput>
+      </screen>
  
       <para>You can then run:</para>
  
@@ -3431,9 +3433,9 @@
         gateway, you would see this:</para>
  
       <screen>&prompt.root; <userinput>ifconfig gif0</userinput>
-gif0: flags=8011<UP,POINTTOPOINT,MULTICAST> mtu 1280
-inet 192.168.1.1 --> 192.168.2.1 netmask 0xffffffff
-physical address inet A.B.C.D --> W.X.Y.Z
+gif0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1280
+        tunnel inet A.B.C.D --> W.X.Y.Z
+        inet 192.168.1.1 --> 192.168.2.1 netmask 0xffffffff
       </screen>
  
       <para>As you can see, a tunnel has been created between the
@@ -3553,7 +3555,8 @@
           <para>Edit <filename>/etc/rc.conf</filename> on gateway host
             #1 and add the following lines (replacing IP addresses as
             necessary).</para>
-          <programlisting>gifconfig_gif0="A.B.C.D W.X.Y.Z"
+          <programlisting>gif_interfaces="gif0"
+gifconfig_gif0="A.B.C.D W.X.Y.Z"
 ifconfig_gif0="inet 192.168.1.1 192.168.2.1 netmask 0xffffffff"
 static_routes="vpn"
 route_vpn="192.168.2.0 192.168.2.1 netmask 0xffffff00"

>Release-Note:
>Audit-Trail:
>Unformatted: