Bug 20107

Summary:	Documention of setup of user ppp does not apply to 4.0 as it did to 3.x
Product:	Documentation	Reporter:	george.russell <george.russell>
Component:	Books & Articles	Assignee:	ben <ben>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description george.russell 2000-07-22 14:50:01 UTC

The documentatin sstates that ifconfig -a will show if you have tun drivers
compiled into the kernel for use by user ppp.

It does not show in the output if they are there in 4.0, as the tun behaviour
has changed.

Fix: 

Mention in 4.0 that it will not appear in the output, and it is included
in the GENRRIC kernel anyway, so should work anyway.

Comment 1 ben freebsd_committer

2000-07-22 15:32:32 UTC

george.russell@clara.net wrote:

> The documentatin sstates that ifconfig -a will show if you have tun drivers
> compiled into the kernel for use by user ppp.
> 
> It does not show in the output if they are there in 4.0, as the tun behaviour
> has changed.
>> How-To-Repeat:
> 
>> Fix:
> Mention in 4.0 that it will not appear in the output, and it is included
> in the GENRRIC kernel anyway, so should work anyway.

Does something like this look ok?

--- chapter.sgml        2000/07/16 16:43:40     1.26
+++ chapter.sgml        2000/07/18 17:44:57
@@ -156,6 +156,15 @@
         inet 203.10.100.1 --&gt; 203.10.100.20 netmask 0xffffffff
 tun3: flags=8010&lt;POINTOPOINT,MULTICAST&gt; mtu 1500</screen>
 
+       <note>
+         <para>In FreeBSD 4.0 and later releases, you will only see any
+           <devicename>tun</devicename> devices which have already been
+           used.  This means you might not see <emphasis>any</emphasis>
+           <devicename>tun</devicename> devices.  If this is the case, do
+           not worry; the device should be created dynamically when
+           <command>ppp</command> attempts to use it.</para>
+       </note>
+
        <para>This case shows four tunnel devices, two of which are
          currently configured and being used.  It should be noted that
          the <literal>RUNNING</literal> flag above indicates that the
@@ -209,6 +218,10 @@
 
        <screen>&prompt.root; <userinput>ifconfig tun0</userinput>
 tun0: flags=8010&lt;POINTOPOINT,MULTICAST&gt; mtu 1500</screen>
+
+       <para>Remember from earlier that you might not see the device if it
+         has not been used yet, as <devicename>tun</devicename> devices are
+         created on demand in FreeBSD 4.0 and later releases.</para>
       </sect3>
 
       <sect3>

-- 
Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
FreeBSD Documentation Project /

Comment 2 ben freebsd_committer

2000-07-23 20:50:48 UTC

State Changed
From-To: open->closed

Doesn't compile with GTK 1.2

Comment 3 ben freebsd_committer

2000-07-23 20:53:09 UTC

Responsible Changed
From-To: freebsd-doc->ben

Hmm, the reason for closing this PR was bogus.  I'm not sure what 
happened, but the file was marked 'readonly' in vi so I couldn't do much else. 
:-( 

The real reason was "text updated, thanks!" :-)