Index: connect/connect.xml
===================================================================
--- connect/connect.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/connect.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,2 +1,9 @@
+
+
+ %general-entities;
+]>
+
@@ -9,7 +16,7 @@
the most popular methods in this chapter.
-&connect-dialup;
-&connect-dhcp;
-&connect-other;
+
+
+
Index: connect/dhcp/dhcp-client.xml
===================================================================
--- connect/dhcp/dhcp-client.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dhcp/dhcp-client.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,2 +1,9 @@
+
+
+ %general-entities;
+]>
+
Index: connect/dhcp/dhcp.xml
===================================================================
--- connect/dhcp/dhcp.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dhcp/dhcp.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,2 +1,9 @@
+
+
+ %general-entities;
+]>
+
@@ -19,6 +26,6 @@
client of your choice.
-&connect-dhcp-client;
-&dhcpcd;
+
+
Index: connect/dhcp/dhcpcd.xml
===================================================================
--- connect/dhcp/dhcpcd.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dhcp/dhcpcd.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,11 +1,159 @@
+
+
+ %general-entities;
+
+
+
+
+
+
+]>
+
dhcpcd-&dhcpcd-version;
-&dhcpcd-intro;
-&dhcpcd-inst;
-&dhcpcd-exp;
-&dhcpcd-config;
-&dhcpcd-desc;
+
+Introduction to dhcpcd
+
+The dhcpcd package contains the
+dhcpcd client. This is useful for connecting your computer
+to a network which uses DHCP to assign network addresses.
+
+
+Package information
+
+Download (HTTP):
+Download (FTP):
+Download size: &dhcpcd-size;
+Estimated Disk space required:
+&dhcpcd-buildsize;
+Estimated build time:
+&dhcpcd-time;
+
+
+Additional downloads
+
+Required patch:
+
+
+
+
+
+
+
+
+Installation of dhcpcd
+
+Install dhcpcd by running the following
+commands:
+
+patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch &&
+./configure --prefix="" --sysconfdir=/var/lib \
+--mandir=/usr/share/man &&
+make &&
+make install
+
+
+
+
+
+Command explanations
+
+patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch
+: Dhcpcd unpatched puts all configuration
+and temporary files in /etc/dhcpc. This becomes very
+annoying when dhcpcd tells you it's running and it's
+not. You look in /var/run for
+the PID file, but it's not
+there, the PID file that needs deleting is in
+/etc/dhcpc.
+This patch brings this program into FHS compliance, but more
+importantly, puts files where you expect them to be.
+
+--prefix="": There may be a good reason for
+abandoning the normal BLFS convention of using
+--prefix=/usr here. If you are installing
+DHCP, it is likely that it is
+required during the boot process and
+/usr may be network
+mounted, in which case dhcpcd wouldn't be available due to
+being on the network! Therefore, depending on your situation, you may want it
+to be installed in /sbin or
+/usr/sbin. This command installs to
+/sbin.
+
+--sysconfdir=/var/lib: This command installs
+configuration files in the /var/lib
+directory.
+
+--mandir=/usr/share/man: This command
+installs the man pages to the /usr/share/man
+directory.
+
+
+
+
+Configuring dhcpcd
+
+Config files
+/var/lib/dhcpc/*
+
+Configuration Information
+
+To configure dhcpcd, you need to first install
+the network service script,
+/etc/sysconfig/network-devices/services/dhcpcd
+included in the package.
+
+make install-service-dhcpcd
+
+Now create the ifconfig.eth0 configuration
+file using the following commands. Adjust appropriately for additional
+interfaces.
+
+Note: This will overwrite any existing file.
+
+cat > /etc/sysconfig/network-devices/ifconfig.eth0 << "EOF"
+ONBOOT=yes
+DHCP_START="[insert appropriate start options here]"
+DHCP_STOP="-k [insert other stop options here]"
+SERVICE=dhcpcd
+EOF
+
+For more information on the appropriate
+DHCP_START and DHCP_STOP
+values, examine the man page for dhcpcd.
+
+Finally, if the DHCP configured interface is
+used as your default gateway, you should remove the GATEWAY and GATEWAY_IF
+variables from /etc/sysconfig/network:
+
+sed -i "s/GATEWAY/#&/" /etc/sysconfig/network
+
+
+
+
+
+
+Contents
+
+The dhcpcd package contains dhcpcd.
+
+
+
+Description
+
+dhcpcd
+dhcpcd is an implementation of the DHCP
+ client specified in RFC2131 and
+RFC1541 (depending on which options are specified).
+
+
+
Index: connect/dialup/dialup.xml
===================================================================
--- connect/dialup/dialup.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dialup/dialup.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,8 +1,15 @@
+
+
+ %general-entities;
+]>
+
Dial-up networking
-&ppp;
-&wvdial;
+
+
Index: connect/dialup/ppp.xml
===================================================================
--- connect/dialup/ppp.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dialup/ppp.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,10 +1,121 @@
+
+
+ %general-entities;
+
+
+
+
+
+
+]>
+
PPP-&ppp-version;
-&ppp-intro;
-&ppp-inst;
-&ppp-config;
-&ppp-desc;
+
+Introduction to PPP
+
+The PPP package contains
+the pppd daemon and the chat program.
+This is used for connecting to other machines; often for connecting to
+the Internet via a dial-up or PPPoE connection to an
+ISP.
+
+Package information
+
+Download (HTTP):
+Download (FTP):
+Download size: &ppp-size;
+Estimated Disk space required:
+&ppp-buildsize;
+Estimated build time:
+&ppp-time;
+
+
+Additional downloads
+
+Required patch:
+
+
+
+
+ppp dependencies
+Required
+
+
+
+
+
+
+Installation of PPP
+
+PPP support must be
+compiled into the kernel or available as a kernel module.
+
+Install PPP by running the
+following commands:
+
+patch -Np1 -i ../ppp-&ppp-version;-nobpf-3.patch &&
+./configure &&
+make ETCDIR=/etc/ppp &&
+make ETCDIR=/etc/ppp install
+
+
+
+
+Configuring PPP
+
+Config files
+/etc/ppp/*
+
+
+Configuration Information
+
+The PPP daemon
+requires very little configuration. The main trick is scripting the
+connection. This can be done either using the chat program which comes with
+this package or by using .
+
+
+
+
+
+Contents
+
+The PPP package contains
+the chat,
+pppd, pppdump and
+pppstats programs.
+
+
+
+Description
+
+chat
+The chat program defines a conversational exchange
+between the computer and the modem. Its primary purpose is to establish the
+connection between the Point-to-Point Protocol Daemon
+(PPPD) and the remote's pppd process.
+
+
+pppd
+pppd is the Point to Point Protocol daemon.
+
+pppdump
+pppdump is used to convert
+PPP record files
+to a readable format.
+
+pppstats
+pppstats is used to print
+PPP statistics.
+
+
Index: connect/dialup/wvdial.xml
===================================================================
--- connect/dialup/wvdial.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/dialup/wvdial.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,10 +1,97 @@
+
+
+ %general-entities;
+
+
+
+
+
+
+]>
+
WvDial-&wvdial-version;
-&wvdial-intro;
-&wvdial-inst;
-&wvdial-config;
-&wvdial-desc;
+
+Introduction to WvDial
+
+The WvDial package contains a no-nonsense,
+quick and easy to use alternative to chat and
+pppd scripts. If you simply want to dial a modem
+without the fuss and hassle of chat issues, then you'll
+want this.
+
+Package information
+
+Download (HTTP):
+Download (FTP):
+Download size: &wvdial-size;
+Estimated Disk space required: &wvdial-buildsize;
+Estimated build time: &wvdial-time;
+
+
+WvDial dependencies
+Required
+ and
+
+
+
+
+
+
+Installation of WvDial
+
+Install WvDial by running the following commands:
+
+make PREFIX=/usr &&
+make PREFIX=/usr install
+
+
+
+
+Configuring WvDial
+
+Config files
+/etc/wvdial.conf,
+/etc/ppp/peers/*
+
+Configuration Information
+
+touch /etc/wvdial.conf &&
+wvdialconf /etc/wvdial.conf
+wvdialconf will test that you have a working modem
+and try to determine its exact setup. You will then need to enter your
+ISP's phone number, login name and password into the
+/etc/wvdial.conf file.
+
+You then start wvdial with:
+wvdial
+
+For more information, examine the wvdialconf, wvdial.conf and wvdial man pages.
+
+
+
+
+
+
+Contents
+
+The WvDial package contains the
+wvdial and wvdialconf programs.
+
+
+
+Description
+
+wvdial
+Starts a PPP connection.
+
+wvdialconf
+Automates the configuration of wvdial.
+
+
Index: connect/other/other.xml
===================================================================
--- connect/other/other.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/other/other.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,2 +1,9 @@
+
+
+ %general-entities;
+]>
+
@@ -9,6 +16,5 @@
and will be included in future books, if available.
-
-&pppoe;
+
Index: connect/other/pppoe.xml
===================================================================
--- connect/other/pppoe.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ connect/other/pppoe.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -1,11 +1,176 @@
+
+
+ %general-entities;
+
+
+
+
+
+
+]>
+
RP-PPPoE-&pppoe-version;
-&pppoe-intro;
-&pppoe-inst;
-&pppoe-exp;
-&pppoe-config;
-&pppoe-desc;
+
+Introduction to RP-PPPoE
+
+The Roaring Penguin PPPoE
+package contains both a client and a server component that works with the
+client. The client allows you to connect to large networks that use the
+PPPoE protocol, common among ADSL
+providers. The server component runs alongside the client,
+allowing you to configure other clients that send out a configuration
+request.
+
+Package information
+
+Download (HTTP):
+Download (FTP):
+Download size: &pppoe-size;
+Estimated Disk space required:
+&pppoe-buildsize;
+Estimated build time:
+&pppoe-time;
+
+
+RP-PPPoE dependencies
+Required
+
+
+
+
+
+
+
+Installation of RP-PPPoE
+
+Note: If you plan on using kernel-mode PPPoE,
+this package is no longer explicitly needed. However, it is recomended
+for ease of configuration. Additional information about kernel mode
+PPPoE can be found in
+rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE.
+
+Install RP-PPPoE by running
+the following commands:
+
+cd src &&
+./configure &&
+make &&
+make install
+
+
+
+
+Command explanations
+
+These are the standard installation commands that will install into
+the /usr prefix. You can optionally use the
+go script in the root of the source tree, to
+run the same commands, which are then immediately followed by the
+adsl-setup script.
+
+
+
+
+Configuring RP-PPPoE
+
+Config files
+/etc/ppp/pppoe.conf,
+/etc/ppp/firewall-standalone,
+/etc/ppp/firewall-masq,
+/etc/ppp/pppoe-server-options,
+/etc/resolv.conf,
+/etc/ppp/pap-seecrets,
+/etc/ppp/chap-secrets
+
+Configuration Information
+
+To configure RP-PPPoE
+ after installation, you should run the adsl-setup
+ script.
+
+When configuring your connection, you will need to have your
+ISP's nameserver information available, as well as your
+username and password. You will also be asked whether to configure a
+dial-on-demand or a constant connection. If your service provider does not
+charge by the minute, it is usually good to have a bootscript handle the
+connection for you. You can, of course, choose not to install the
+following script, and start your connection manually with the
+adsl-start script.
+
+Optionally install the
+/etc/sysconfig/network-devices/services/pppoe service
+script included with the
+package.
+
+make install-service-pppoe
+
+Now create the config file for use with the pppoe
+service script:
+
+cat > /etc/sysconfig/network-devices/ifconfig.pppoe << "EOF"
+ONBOOT=yes
+SERVICE=pppoe
+EOF
+
+Also, if you had previously configured the network interface that will now
+use PPPoE, you should remove the interface configuration
+files for that interface:
+/etc/sysconfig/network-devices/ifconfig.eth<X>
+.
+
+
+
+
+
+
+Contents
+
+The RP-PPPoE package
+contains adsl-setup, adsl-start,
+adsl-status, adsl-stop,
+pppoe, pppoe-relay, pppoe-server
+ and pppoe-sniff.
+
+
+
+Description
+
+adsl-setup
+A script for configuring the client. Configuration is then stored
+in /etc/ppp/pppoe.conf.
+
+adsl-start
+adsl-start starts the client using the options
+specified in /etc/ppp/pppoe.conf.
+
+adsl-status
+adsl-status displays the status of the
+ADSL connection.
+
+adsl-stop
+adsl-stop stops the client.
+
+pppoe
+This is the client itself. Generally it should not be started on its
+own.
+
+pppoe-relay
+pppoe-relay starts the server relay agent.
+
+pppoe-server
+pppoe-server starts the server component.
+
+pppoe-sniff
+A small network sniffer designed to assist in setting PPPOE_EXTRA
+ settings.
+
+
Index: general.ent
===================================================================
--- general.ent (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ general.ent (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -49,4 +49,19 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: index.xml
===================================================================
--- index.xml (revision 8e14c82463b34d7f242800b2d619ebae4afc2bef)
+++ index.xml (revision 246c904b82dfea1a2752df2d957cb58ec6b352e6)
@@ -31,5 +31,5 @@
%postlfs; -->
%general;
-%connect;
+
%basicnet;
%server;
@@ -57,5 +57,6 @@
&general;
-&connect;
+
+
&basicnet;
&server;