source: connect/dialup/wvdial.xml@ 68dcb2dd

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY wvdial-download-http "http://open.nit.ca/download/wvdial-&wvdial-version;.tar.gz">
  <!ENTITY wvdial-download-ftp  "ftp://ftp.ing-steen.se/pub/unix/unsort/wvdial-&wvdial-version;.tar.gz">
  <!ENTITY wvdial-md5sum        "8648c044305fc66ee33ecc55d36f8c8b">
  <!ENTITY wvdial-size          "66 KB">
  <!ENTITY wvdial-buildsize     "2.7 MB">
  <!ENTITY wvdial-time          "0.06 SBU">
]>

<sect1 id="wvdial" xreflabel="WvDial-&wvdial-version;">
  <?dbhtml filename="wvdial.html"?>
  
  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>
  
  <title>WvDial-&wvdial-version;</title>
  
  <indexterm zone="wvdial">
    <primary sortas="a-WvDial">WvDial</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to WvDial</title>
    
    <para>The <application>WvDial</application> package contains a no-nonsense, 
    quick and easy to use alternative to <command>chat</command> and
    <command>pppd</command> scripts. If you simply want to dial a modem 
    without the fuss and hassle of <command>chat</command> issues, then you'll 
    want this.</para>
    
    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&wvdial-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&wvdial-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &wvdial-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &wvdial-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &wvdial-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &wvdial-time;</para>
      </listitem>
    </itemizedlist>
    
    <bridgehead renderas="sect3">WvDial Dependencies</bridgehead>
    
    <bridgehead renderas="sect4">Required</bridgehead>
    <para><xref linkend="wvstreams"/> and <xref linkend="ppp"/></para>
    
  </sect2>
  
  <sect2 role="installation">
    <title>Installation of WvDial</title>

    <para>Install <application>WvDial</application> by running the following 
    commands:</para>

<screen><userinput>make PREFIX=/usr</userinput></screen>
    
    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    
<screen role="root"><userinput>make PREFIX=/usr install</userinput></screen>
    
  </sect2>
  
  <sect2 role="configuration">
    <title>Configuring WvDial</title>

    <sect3 id="wvdial-config">
      <title>Config Files</title>
      
      <para><filename>/etc/wvdial.conf</filename> and 
      <filename>/etc/ppp/peers/*</filename></para>
      
      <indexterm zone="wvdial wvdial-config">
        <primary sortas="e-etc-wvdial.conf">/etc/wvdial.conf</primary>
      </indexterm>
      
      <indexterm zone="wvdial wvdial-config">
        <primary sortas="e-etc-ppp-peers">/etc/ppp/peers/*</primary>
      </indexterm>
    
    </sect3>
    
    <sect3>
      <title>Configuration Information</title>

      <para>Perform the following two commands as the 
      <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>touch /etc/wvdial.conf &amp;&amp;
wvdialconf /etc/wvdial.conf</userinput></screen>

      <para><command>wvdialconf</command> 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
      <filename>/etc/wvdial.conf</filename> file.</para>
      
      <para>You then start <command>wvdial</command> with:</para>

<screen><userinput>wvdial</userinput></screen>

      <para>For more information, examine the <command>wvdialconf</command>, 
      <filename>wvdial.conf</filename> and <command>wvdial</command> man 
      pages. Also, have a look at <ulink 
      url="http://www.electronicschat.org/nonroot-dialout/index.html">the
      Non-Root Dial Out HOWTO</ulink> if you want to give non-root users
      access to <command>wvdial</command>.</para>
      
    </sect3>
    
  </sect2>
  
  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>
      
      <seglistitem>
        <seg>wvdial and wvdialconf</seg>
        <seg>None</seg>
        <seg>/etc/ppp/peers</seg>
      </seglistitem>
    </segmentedlist>
    
    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>
      
      <varlistentry id="wvdial-prog">
        <term><command>wvdial</command></term>
        <listitem>
          <para>Starts a PPP connection.</para>
          <indexterm zone="wvdial wvdial-prog">
            <primary sortas="b-wvdial">wvdial</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      
      <varlistentry id="wvdialconf">
        <term><command>wvdialconf</command></term>
        <listitem>
          <para>automates the configuration of 
          <command>wvdial</command>.</para>
          <indexterm zone="wvdial wvdialconf">
            <primary sortas="b-wvdialconf">wvdialconf</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    
    </variablelist>

  </sect2>

</sect1>