Skip site navigation (1)Skip section navigation (2) 
Date:      Sat, 13 Apr 2002 18:15:35 +0100 (BST)
From:      Dominic Marks <dominic_marks@btinternet.com>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/37042: Further additions to PPPoA section of the Handbook
Message-ID:  <20020413171535.0F52760E@host213-123-130-182.in-addr.btopenworld.com>
next in thread | raw e-mail | index | archive | help 

>Number:         37042
>Category:       docs
>Synopsis:       Further additions to PPPoA section of the Handbook
>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:   Sat Apr 13 10:20:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Dominic Marks
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
Student
>Environment:
System: FreeBSD gallium 4.5-STABLE FreeBSD 4.5-STABLE #2: Mon Apr 8
21:19:28 BST 2002 dom@gallium:/usr/obj/usr/src/sys/GALLIUM i386

	
>Description:
	Added:
	1. <userinput> tags where appropriate
	2. <warning> section regarding passwords in ppp.conf
	3. several manual page references
	4. callouts in the ppp.conf example section

	
>How-To-Repeat:
	NA.
	
>Fix:

Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.71
diff -u -r1.71 chapter.sgml
--- chapter.sgml	2002/04/13 00:40:12	1.71
+++ chapter.sgml	2002/04/13 17:10:31
@@ -2134,17 +2134,40 @@
 	<filename>/etc/ppp/ppp.conf</filename>. You will need to be
 	<username>root</username> to perform both of these operations. An
 	example section of <filename>ppp.conf</filename> is given
-	below.</para>
+	below. For further information on <filename>ppp.conf</filename>
+	options consult the <application>ppp</application> manual page,
+	&man.ppp.8;.</para>
 
       <programlisting>adsl:
  set log phase chat lcp ipcp ccp tun command
  set timeout 0
  enable dns
- set authname <replaceable>username</replaceable>
- set authkey <replaceable>password</replaceable>
+ set authname <replaceable>username</replaceable> <co id="co-ex-user">
+ set authkey <replaceable>password</replaceable> <co id="co-ex-pass">
  set ifaddr 0 0
  add default HISADDR</programlisting>
 
+   <calloutlist>
+     <callout arearefs="co-ex-user">
+	   <para>The username of your account with the DSL provider.</para>
+	 </callout>
+	 <callout arearefs="co-ex-pass">
+	   <para>The password for your account.</para>
+	 </callout>
+   </calloutlist>
+
+   <warning>
+     <para>Because you must put your account's password in the
+	 <filename>ppp.conf</filename> file in plain text form you should
+	 make sure than nobody can read the contents of this file. The
+	 following series of commands will make sure the file is only
+	 readable by the <username>root</username> account. Refer to the
+	 manuals pages for &man.chmod.1; and &man.chown.8; for further
+	 information.</para>
+	 <screen>&prompt.root; <userinput>chown root:wheel /etc/ppp/ppp.conf</userinput>
+&prompt.root; <userinput>chmod 600 /etc/ppp/ppp.conf</userinput></screen>
+   </warning>
+
       <para>This will open a tunnel for a PPP session to your DSL router.
 	Ethernet DSL modems have a preconfigured LAN IP address which you
 	connect to. In the case of the Alcatel Speedtouch Home this address is
@@ -2153,7 +2176,7 @@
 	start a <application>ppp</application> session execute the following
 	command.</para>
 
-      <screen>&prompt.root; pptp <replaceable>address</replaceable> <replaceable>isp</replaceable></screen>
+      <screen>&prompt.root; <userinput>pptp <replaceable>address</replaceable> <replaceable>isp</replaceable></userinput></screen>
 
       <tip>
 	<para>You may wish to add an ampersand (<quote>&amp;</quote>) to the
@@ -2168,7 +2191,7 @@
 	process has confirmed a connection you can examine the tunnel like
 	so.</para>
 
-      <screen>&prompt.user; ifconfig <replaceable>tun0</replaceable>
+      <screen>&prompt.user; <userinput>ifconfig <replaceable>tun0</replaceable></userinput>
 tun0: flags=8051&lt;UP,POINTOPOINT,RUNNING,MULTICAST&gt; mtu 1500
         inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00 
         Opened by PID 918</screen>

	


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

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020413171535.0F52760E>