source: connect/dialup/wvdial.xml@ 9f12e36

<?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;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!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 role="required"><xref linkend="wvstreams"/> and
    <xref linkend="ppp"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/WvDial"/></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.</para>

      <!-- Commented out 20060401 as the link is broken
      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>