Changeset 246c904
- Timestamp:
- 06/12/2004 01:11:39 AM (20 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- a2d8572
- Parents:
- 8e14c824
- Files:
-
- 11 edited
Legend:
- Unmodified
- Added
- Removed
-
connect/connect.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../general.ent"> 5 %general-entities; 6 ]> 7 1 8 <part id="connect" xreflabel="Connecting to a Network"> 2 9 <?dbhtml filename="connect.html" dir="connect"?> … … 9 16 the most popular methods in this chapter.</para></partintro> 10 17 11 &connect-dialup; 12 &connect-dhcp; 13 &connect-other; 18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dialup/dialup.xml"/> 19 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp/dhcp.xml"/> 20 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/> 14 21 15 22 </part> -
connect/dhcp/dhcp-client.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 ]> 7 1 8 <sect1 id="connect-dhcp-client"> 2 9 <?dbhtml filename="dhcpclient.html"?> -
connect/dhcp/dhcp.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 ]> 7 1 8 <chapter id="connect-dhcp"> 2 9 <?dbhtml filename="dhcp.html"?> … … 19 26 client of your choice.</para> 20 27 21 &connect-dhcp-client; 22 &dhcpcd; 28 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp-client.xml"/> 29 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcpcd.xml"/> 23 30 24 31 </chapter> -
connect/dhcp/dhcpcd.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 7 <!ENTITY dhcpcd-download-http "http://www.phystech.com/ftp/dhcpcd-&dhcpcd-version;.tar.gz"> 8 <!ENTITY dhcpcd-download-ftp "ftp://ftp.phystech.com/pub/dhcpcd-&dhcpcd-version;.tar.gz"> 9 <!ENTITY dhcpcd-size "145 KB"> 10 <!ENTITY dhcpcd-buildsize "868 KB"> 11 <!ENTITY dhcpcd-time "0.04 SBU"> 12 ]> 13 1 14 <sect1 id="dhcpcd" xreflabel="dhcpcd-&dhcpcd-version;"> 2 15 <?dbhtml filename="dhcpcd.html"?> 3 16 <title>dhcpcd-&dhcpcd-version;</title> 4 17 5 &dhcpcd-intro; 6 &dhcpcd-inst; 7 &dhcpcd-exp; 8 &dhcpcd-config; 9 &dhcpcd-desc; 18 <sect2> 19 <title>Introduction to <application>dhcpcd</application></title> 20 21 <para>The <application>dhcpcd</application> package contains the 22 <command>dhcpcd</command> client. This is useful for connecting your computer 23 to a network which uses <acronym>DHCP</acronym> to assign network addresses. 24 </para> 25 26 <sect3><title>Package information</title> 27 <itemizedlist spacing='compact'> 28 <listitem><para>Download (HTTP): <ulink 29 url="&dhcpcd-download-http;"/></para></listitem> 30 <listitem><para>Download (FTP): <ulink 31 url="&dhcpcd-download-ftp;"/></para></listitem> 32 <listitem><para>Download size: &dhcpcd-size;</para></listitem> 33 <listitem><para>Estimated Disk space required: 34 &dhcpcd-buildsize;</para></listitem> 35 <listitem><para>Estimated build time: 36 &dhcpcd-time;</para></listitem></itemizedlist> 37 </sect3> 38 39 <sect3><title>Additional downloads</title> 40 <itemizedlist spacing='compact'> 41 <listitem><para>Required patch: 42 <ulink url="&patch-root;/dhcpcd-1.3.22-pl4-fhs-1.patch"/></para></listitem> 43 </itemizedlist> 44 </sect3> 45 46 47 </sect2> 48 49 <sect2> 50 <title>Installation of <application>dhcpcd</application></title> 51 52 <para>Install <application>dhcpcd</application> by running the following 53 commands:</para> 54 55 <screen><userinput><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch && 56 ./configure --prefix="" --sysconfdir=/var/lib \ 57 --mandir=/usr/share/man && 58 make && 59 make install</command></userinput></screen> 60 61 62 </sect2> 63 64 <sect2> 65 <title>Command explanations</title> 66 67 <para><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch 68 </command>: <application>Dhcpcd</application> unpatched puts all configuration 69 and temporary files in <filename>/etc/dhcpc</filename>. This becomes very 70 annoying when <application>dhcpcd</application> tells you it's running and it's 71 not. You look in <filename class="directory">/var/run</filename> for 72 the <filename>PID</filename> file, but it's not 73 there, the <filename>PID</filename> file that needs deleting is in 74 <filename class="directory">/etc/dhcpc</filename>. 75 This patch brings this program into <acronym>FHS</acronym> compliance, but more 76 importantly, puts files where you expect them to be.</para> 77 78 <para><parameter>--prefix=""</parameter>: There may be a good reason for 79 abandoning the normal <acronym>BLFS</acronym> convention of using 80 <parameter>--prefix=/usr</parameter> here. If you are installing 81 <acronym>DHCP</acronym>, it is likely that it is 82 required during the boot process and 83 <filename class="directory">/usr</filename> may be network 84 mounted, in which case <command>dhcpcd</command> wouldn't be available due to 85 being on the network! Therefore, depending on your situation, you may want it 86 to be installed in <filename class="directory">/sbin</filename> or 87 <filename class="directory">/usr/sbin</filename>. This command installs to 88 <filename class="directory">/sbin</filename>.</para> 89 90 <para><parameter>--sysconfdir=/var/lib</parameter>: This command installs 91 configuration files in the <filename class="directory">/var/lib</filename> 92 directory.</para> 93 94 <para><parameter>--mandir=/usr/share/man</parameter>: This command 95 installs the man pages to the <filename class="directory">/usr/share/man</filename> 96 directory.</para> 97 98 </sect2> 99 100 <sect2> 101 <title>Configuring <application>dhcpcd</application></title> 102 103 <sect3><title>Config files</title> 104 <para><filename>/var/lib/dhcpc/*</filename></para></sect3> 105 106 <sect3><title>Configuration Information</title> 107 108 <para>To configure <command>dhcpcd</command>, you need to first install 109 the network service script, 110 <filename>/etc/sysconfig/network-devices/services/dhcpcd</filename> 111 included in the <xref linkend="intro-important-bootscripts"/> package.</para> 112 113 <screen><userinput><command>make install-service-dhcpcd</command></userinput></screen> 114 115 <para>Now create the <filename>ifconfig.eth0</filename> configuration 116 file using the following commands. Adjust appropriately for additional 117 interfaces.</para> 118 119 <para><emphasis>Note:</emphasis> This will overwrite any existing file.</para> 120 121 <screen><userinput><command>cat > /etc/sysconfig/network-devices/ifconfig.eth0 << "EOF"</command> 122 ONBOOT=yes 123 DHCP_START="<replaceable>[insert appropriate start options here]</replaceable>" 124 DHCP_STOP="-k <replaceable>[insert other stop options here]</replaceable>" 125 SERVICE=dhcpcd 126 <command>EOF</command></userinput></screen> 127 128 <para>For more information on the appropriate 129 <envar>DHCP_START</envar> and <envar>DHCP_STOP</envar> 130 values, examine the man page for <command>dhcpcd</command>.</para> 131 132 <para>Finally, if the <acronym>DHCP</acronym> configured interface is 133 used as your default gateway, you should remove the GATEWAY and GATEWAY_IF 134 variables from <filename>/etc/sysconfig/network</filename>: </para> 135 136 <screen><userinput><command>sed -i "s/GATEWAY/#&/" /etc/sysconfig/network</command></userinput></screen> 137 138 </sect3> 139 140 </sect2> 141 142 <sect2> 143 <title>Contents</title> 144 145 <para>The <application>dhcpcd</application> package contains <command>dhcpcd</command>.</para> 146 147 </sect2> 148 149 <sect2><title>Description</title> 150 151 <sect3><title>dhcpcd</title> 152 <para><command>dhcpcd</command> is an implementation of the <acronym>DHCP 153 </acronym> client specified in <acronym>RFC</acronym>2131 and 154 <acronym>RFC</acronym>1541 (depending on which options are specified).</para> 155 </sect3> 156 157 </sect2> 10 158 11 159 </sect1> -
connect/dialup/dialup.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 ]> 7 1 8 <chapter id="connect-dialup"> 2 9 <?dbhtml filename="dialup.html"?> 3 10 <title>Dial-up networking</title> 4 11 5 &ppp; 6 &wvdial; 12 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/> 13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvdial.xml"/> 7 14 8 15 </chapter> -
connect/dialup/ppp.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 7 <!ENTITY ppp-download-http "http://ccache.samba.org/ftp/ppp/ppp-&ppp-version;.tar.gz"> 8 <!ENTITY ppp-download-ftp "ftp://ftp.samba.org/pub/ppp/ppp-&ppp-version;.tar.gz"> 9 <!ENTITY ppp-size "757 KB"> 10 <!ENTITY ppp-buildsize "7.4 MB"> 11 <!ENTITY ppp-time "0.13 SBU"> 12 ]> 13 1 14 <sect1 id="ppp" xreflabel="PPP-&ppp-version;"> 2 15 <?dbhtml filename="ppp.html"?> 3 16 <title>PPP-&ppp-version;</title> 4 17 5 &ppp-intro; 6 &ppp-inst; 7 &ppp-config; 8 &ppp-desc; 18 <sect2> 19 <title>Introduction to <application><acronym>PPP</acronym></application></title> 20 21 <para>The <application><acronym>PPP</acronym></application> package contains 22 the <command>pppd</command> daemon and the <command>chat</command> program. 23 This is used for connecting to other machines; often for connecting to 24 the Internet via a dial-up or <acronym>PPPoE</acronym> connection to an 25 <acronym>ISP</acronym>.</para> 26 27 <sect3><title>Package information</title> 28 <itemizedlist spacing='compact'> 29 <listitem><para>Download (HTTP): <ulink 30 url="&ppp-download-http;"/></para></listitem> 31 <listitem><para>Download (FTP): <ulink 32 url="&ppp-download-ftp;"/></para></listitem> 33 <listitem><para>Download size: &ppp-size;</para></listitem> 34 <listitem><para>Estimated Disk space required: 35 &ppp-buildsize;</para></listitem> 36 <listitem><para>Estimated build time: 37 &ppp-time;</para></listitem></itemizedlist> 38 </sect3> 39 40 <sect3><title>Additional downloads</title> 41 <itemizedlist spacing='compact'> 42 <listitem><para>Required patch: 43 <ulink 44 url="&patch-root;/ppp-&ppp-version;-nobpf-3.patch"/></para></listitem> 45 </itemizedlist> 46 </sect3> 47 48 <sect3><title><application>ppp</application> dependencies</title> 49 <sect4><title>Required</title> 50 <para><xref linkend="libpcap"/></para></sect4> 51 </sect3> 52 53 </sect2> 54 55 <sect2> 56 <title>Installation of <application><acronym>PPP</acronym></application></title> 57 58 <note><para><application><acronym>PPP</acronym></application> support must be 59 compiled into the kernel or available as a kernel module.</para></note> 60 61 <para>Install <application><acronym>PPP</acronym></application> by running the 62 following commands:</para> 63 64 <screen><userinput><command>patch -Np1 -i ../ppp-&ppp-version;-nobpf-3.patch && 65 ./configure && 66 make ETCDIR=/etc/ppp && 67 make ETCDIR=/etc/ppp install</command></userinput></screen> 68 69 </sect2> 70 71 <sect2> 72 <title>Configuring <application><acronym>PPP</acronym></application></title> 73 74 <sect3><title>Config files</title> 75 <para><filename>/etc/ppp/*</filename></para> 76 </sect3> 77 78 <sect3><title>Configuration Information</title> 79 80 <para>The <application><acronym>PPP</acronym></application> daemon 81 requires very little configuration. The main trick is scripting the 82 connection. This can be done either using the chat program which comes with 83 this package or by using <xref linkend="wvdial"/>.</para> 84 </sect3> 85 86 </sect2> 87 88 <sect2> 89 <title>Contents</title> 90 91 <para>The <application><acronym>PPP</acronym></application> package contains 92 the <command>chat</command>, 93 <command>pppd</command>, <command>pppdump</command> and 94 <command>pppstats</command> programs.</para> 95 96 </sect2> 97 98 <sect2><title>Description</title> 99 100 <sect3><title>chat</title> 101 <para>The <command>chat</command> program defines a conversational exchange 102 between the computer and the modem. Its primary purpose is to establish the 103 connection between the Point-to-Point Protocol Daemon 104 (<acronym>PPPD</acronym>) and the remote's <command>pppd</command> process. 105 </para></sect3> 106 107 <sect3><title>pppd</title> 108 <para><command>pppd</command> is the Point to Point Protocol daemon.</para></sect3> 109 110 <sect3><title>pppdump</title> 111 <para><command>pppdump</command> is used to convert 112 <application><acronym>PPP</acronym></application> record files 113 to a readable format.</para></sect3> 114 115 <sect3><title>pppstats</title> 116 <para><command>pppstats</command> is used to print 117 <application><acronym>PPP</acronym></application> statistics.</para></sect3> 118 119 </sect2> 9 120 10 121 </sect1> -
connect/dialup/wvdial.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 7 <!ENTITY wvdial-download-http "http://open.nit.ca/download/wvdial-&wvdial-version;.tar.gz"> 8 <!ENTITY wvdial-download-ftp "ftp://ftp.ing-steen.se/pub/unix/unsort/wvdial-&wvdial-version;.tar.gz"> 9 <!ENTITY wvdial-size "66 KB"> 10 <!ENTITY wvdial-buildsize "2.3 MB"> 11 <!ENTITY wvdial-time "0.06 SBU"> 12 ]> 13 1 14 <sect1 id="wvdial" xreflabel="WvDial-&wvdial-version;"> 2 15 <?dbhtml filename="wvdial.html"?> 3 16 <title>WvDial-&wvdial-version;</title> 4 17 5 &wvdial-intro; 6 &wvdial-inst; 7 &wvdial-config; 8 &wvdial-desc; 18 <sect2> 19 <title>Introduction to <application>WvDial</application></title> 20 21 <para>The <application>WvDial</application> package contains a no-nonsense, 22 quick and easy to use alternative to <command>chat</command> and 23 <command>pppd</command> scripts. If you simply want to dial a modem 24 without the fuss and hassle of <command>chat</command> issues, then you'll 25 want this.</para> 26 27 <sect3><title>Package information</title> 28 <itemizedlist spacing='compact'> 29 <listitem><para>Download (HTTP): <ulink url="&wvdial-download-http;"/></para></listitem> 30 <listitem><para>Download (FTP): <ulink url="&wvdial-download-ftp;"/></para></listitem> 31 <listitem><para>Download size: &wvdial-size;</para></listitem> 32 <listitem><para>Estimated Disk space required: &wvdial-buildsize;</para></listitem> 33 <listitem><para>Estimated build time: &wvdial-time;</para></listitem></itemizedlist> 34 </sect3> 35 36 <sect3><title><application>WvDial</application> dependencies</title> 37 <sect4><title>Required</title> 38 <para><xref linkend="wvstreams"/> and <xref linkend="ppp"/> 39 </para></sect4> 40 </sect3> 41 42 </sect2> 43 44 <sect2> 45 <title>Installation of <application>WvDial</application></title> 46 47 <para>Install <application>WvDial</application> by running the following commands:</para> 48 49 <screen><userinput><command>make PREFIX=/usr && 50 make PREFIX=/usr install</command></userinput></screen> 51 52 </sect2> 53 54 <sect2> 55 <title>Configuring <application>WvDial</application></title> 56 57 <sect3><title>Config files</title> 58 <para><filename>/etc/wvdial.conf</filename>, 59 <filename>/etc/ppp/peers/*</filename></para></sect3> 60 61 <sect3><title>Configuration Information</title> 62 63 <screen><userinput><command>touch /etc/wvdial.conf && 64 wvdialconf /etc/wvdial.conf</command></userinput></screen> 65 <para><command>wvdialconf</command> will test that you have a working modem 66 and try to determine its exact setup. You will then need to enter your 67 <acronym>ISP</acronym>'s phone number, login name and password into the 68 <filename>/etc/wvdial.conf</filename> file.</para> 69 70 <para>You then start wvdial with:</para> 71 <screen><userinput><command>wvdial</command></userinput></screen> 72 73 <para>For more information, examine the wvdialconf, wvdial.conf and wvdial man pages.</para> 74 75 </sect3> 76 77 </sect2> 78 79 <sect2> 80 <title>Contents</title> 81 82 <para>The <application>WvDial</application> package contains the <command> 83 wvdial</command> and <command>wvdialconf</command> programs.</para> 84 85 </sect2> 86 87 <sect2><title>Description</title> 88 89 <sect3><title>wvdial</title> 90 <para>Starts a <acronym>PPP</acronym> connection.</para></sect3> 91 92 <sect3><title>wvdialconf</title> 93 <para>Automates the configuration of <command>wvdial</command>.</para></sect3> 94 95 </sect2> 9 96 10 97 </sect1> -
connect/other/other.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 ]> 7 1 8 <chapter id="connect-other"> 2 9 <?dbhtml filename="other.html"?> … … 9 16 and will be included in future books, if available.</para> 10 17 11 <!--&connect-other-isdn;--> 12 &pppoe; 18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pppoe.xml"/> 13 19 14 20 </chapter> -
connect/other/pppoe.xml
r8e14c824 r246c904 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ 4 <!ENTITY % general-entities SYSTEM "../../general.ent"> 5 %general-entities; 6 7 <!ENTITY pppoe-download-http "http://www.roaringpenguin.com/products/rp-pppoe/rp-pppoe-&pppoe-version;.tar.gz"> 8 <!ENTITY pppoe-download-ftp "ftp://ftp.rutgers.edu/pub/slackware/slackware_source/n/rp-pppoe/rp-pppoe-&pppoe-version;.tar.gz"> 9 <!ENTITY pppoe-size "185 KB"> 10 <!ENTITY pppoe-buildsize "2.2 MB"> 11 <!ENTITY pppoe-time "0.05 SBU"> 12 ]> 13 1 14 <sect1 id="pppoe" xreflabel="RP-PPPoE-&pppoe-version;"> 2 15 <?dbhtml filename="pppoe.html"?> 3 16 <title>RP-PPPoE-&pppoe-version;</title> 4 17 5 &pppoe-intro; 6 &pppoe-inst; 7 &pppoe-exp; 8 &pppoe-config; 9 &pppoe-desc; 18 <sect2> 19 <title>Introduction to <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title> 20 21 <para>The Roaring Penguin <application><acronym>PPPoE</acronym></application> 22 package contains both a client and a server component that works with the 23 client. The client allows you to connect to large networks that use the 24 <acronym>PPPoE</acronym> protocol, common among <acronym>ADSL</acronym> 25 providers. The server component runs alongside the client, 26 allowing you to configure other clients that send out a configuration 27 request.</para> 28 29 <sect3><title>Package information</title> 30 <itemizedlist spacing='compact'> 31 <listitem><para>Download (HTTP): <ulink 32 url="&pppoe-download-http;"/></para></listitem> 33 <listitem><para>Download (FTP): <ulink 34 url="&pppoe-download-ftp;"/></para></listitem> 35 <listitem><para>Download size: &pppoe-size;</para></listitem> 36 <listitem><para>Estimated Disk space required: 37 &pppoe-buildsize;</para></listitem> 38 <listitem><para>Estimated build time: 39 &pppoe-time;</para></listitem></itemizedlist> 40 </sect3> 41 42 <sect3><title><application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> dependencies</title> 43 <sect4><title>Required</title> 44 <para><xref linkend="ppp"/></para></sect4> 45 </sect3> 46 47 48 </sect2> 49 50 <sect2> 51 <title>Installation of <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title> 52 53 <para><emphasis>Note: </emphasis> If you plan on using kernel-mode PPPoE, 54 this package is no longer explicitly needed. However, it is recomended 55 for ease of configuration. Additional information about kernel mode 56 <acronym>PPPoE</acronym> can be found in 57 <filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para> 58 59 <para>Install <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> by running 60 the following commands:</para> 61 62 <screen><userinput><command>cd src && 63 ./configure && 64 make && 65 make install</command></userinput></screen> 66 67 </sect2> 68 69 <sect2> 70 <title>Command explanations</title> 71 72 <para>These are the standard installation commands that will install into 73 the <filename>/usr</filename> prefix. You can optionally use the 74 <command>go</command> script in the root of the source tree, to 75 run the same commands, which are then immediately followed by the 76 <command>adsl-setup</command> script.</para> 77 78 </sect2> 79 80 <sect2> 81 <title>Configuring <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title> 82 83 <sect3><title>Config files</title> 84 <para><filename>/etc/ppp/pppoe.conf</filename>, 85 <filename>/etc/ppp/firewall-standalone</filename>, 86 <filename>/etc/ppp/firewall-masq</filename>, 87 <filename>/etc/ppp/pppoe-server-options</filename>, 88 <filename>/etc/resolv.conf</filename>, 89 <filename>/etc/ppp/pap-seecrets</filename>, 90 <filename>/etc/ppp/chap-secrets</filename></para></sect3> 91 92 <sect3><title>Configuration Information</title> 93 94 <para>To configure <application><acronym>RP</acronym>-<acronym>PPPoE</acronym> 95 </application> after installation, you should run the <command>adsl-setup 96 </command> script.</para> 97 98 <para>When configuring your connection, you will need to have your 99 <acronym>ISP</acronym>'s nameserver information available, as well as your 100 username and password. You will also be asked whether to configure a 101 dial-on-demand or a constant connection. If your service provider does not 102 charge by the minute, it is usually good to have a bootscript handle the 103 connection for you. You can, of course, choose not to install the 104 following script, and start your connection manually with the 105 <command>adsl-start</command> script.</para> 106 107 <para><emphasis>Optionally</emphasis> install the 108 <filename>/etc/sysconfig/network-devices/services/pppoe</filename> service 109 script included with the <xref linkend="intro-important-bootscripts"/> 110 package.</para> 111 112 <screen><userinput><command>make install-service-pppoe</command></userinput></screen> 113 114 <para>Now create the config file for use with the <filename>pppoe</filename> 115 service script:</para> 116 117 <screen><userinput><command>cat > /etc/sysconfig/network-devices/ifconfig.pppoe << "EOF"</command> 118 ONBOOT=yes 119 SERVICE=pppoe 120 <command>EOF</command></userinput></screen> 121 122 <para>Also, if you had previously configured the network interface that will now 123 use <acronym>PPPoE</acronym>, you should remove the interface configuration 124 files for that interface: 125 <filename>/etc/sysconfig/network-devices/ifconfig.eth<X> 126 </filename>.</para> 127 128 </sect3> 129 130 </sect2> 131 132 <sect2> 133 <title>Contents</title> 134 135 <para>The <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> package 136 contains <command>adsl-setup</command>, <command>adsl-start</command>, 137 <command>adsl-status</command>, <command>adsl-stop</command>, <command> 138 pppoe</command>, <command>pppoe-relay</command>, <command>pppoe-server 139 </command> and <command>pppoe-sniff</command>.</para> 140 141 </sect2> 142 143 <sect2><title>Description</title> 144 145 <sect3><title>adsl-setup</title> 146 <para>A script for configuring the client. Configuration is then stored 147 in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3> 148 149 <sect3><title>adsl-start</title> 150 <para><command>adsl-start</command> starts the client using the options 151 specified in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3> 152 153 <sect3><title>adsl-status</title> 154 <para><command>adsl-status</command> displays the status of the 155 <acronym>ADSL</acronym> connection.</para></sect3> 156 157 <sect3><title>adsl-stop</title> 158 <para><command>adsl-stop</command> stops the client.</para></sect3> 159 160 <sect3><title>pppoe</title> 161 <para>This is the client itself. Generally it should not be started on its 162 own.</para></sect3> 163 164 <sect3><title>pppoe-relay</title> 165 <para><command>pppoe-relay</command> starts the server relay agent.</para></sect3> 166 167 <sect3><title>pppoe-server</title> 168 <para><command>pppoe-server</command> starts the server component.</para></sect3> 169 170 <sect3><title>pppoe-sniff</title> 171 <para>A small network sniffer designed to assist in setting <envar>PPPOE_EXTRA 172 </envar> settings.</para></sect3> 173 174 </sect2> 10 175 11 176 </sect1> -
general.ent
r8e14c824 r246c904 49 49 <!-- Part III --> 50 50 51 <!-- Part IV --> 52 53 <!-- Chapter 13 --> 54 <!ENTITY ppp-version "2.4.2"> 55 <!ENTITY wvdial-version "1.53"> 56 57 <!-- Chapter 14 --> 58 <!ENTITY dhcp-version "3.0pl2"> 59 <!ENTITY dhcpcd-version "1.3.22-pl4"> 60 61 <!-- Chapter 15 --> 62 <!ENTITY pppoe-version "3.5"> 63 64 65 51 66 52 67 <!ENTITY gnome-version "2.6"> -
index.xml
r8e14c824 r246c904 31 31 %postlfs; --> 32 32 %general; 33 %connect; 33 <!-- %connect; --> 34 34 %basicnet; 35 35 %server; … … 57 57 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/postlfs.xml"/> 58 58 &general; 59 &connect; 59 60 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="connect/connect.xml"/> 60 61 &basicnet; 61 62 &server;
Note:
See TracChangeset
for help on using the changeset viewer.