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

<?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>
    <keywordset>
      <keyword role="package">wvdial-&wvdial-version;.tar</keyword>
      <keyword role="ftpdir">wvdial</keyword>
    </keywordset>
  </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>

  </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>