Wvdial

From Wikipedia, the free encyclopedia

wvdial
Design by Dave Coombs / Avery Pennarun
Latest release 1.60 / July 20, 2007
OS Linux
Available in C++
Genre Internet
License GNU Lesser General Public License
Website alumnit.ca

wvdial (pronounced 'weave-dial' [1]) is a utility that helps in making modem-based connection to Internet that is included in some important Linux distributions. [2] wvdial is a Point-to-Point Protocol dialer: it dials a modem and starts pppd in order to connect to the Internet.

When wvdial starts, it first loads its configuration from /etc/wvdial.conf and ~/.wvdialrc, which contain basic information about the modem port, speed, and init string, along with information about your ISP, such as the phone number, your user name, and your password. [3]

Then it initializes your modem (strings are sent to the modem) and dials the server and waits for a connection (a CONNECT string from the modem). Any time after connecting, wvdial will start PPP if it sees a PPP sequence from the server or, alternatively, tries to start PPP. If this fails, If all of this fails, wvdial just runs pppd and hopes for the best. [4]

The connection started with wvdial can be dropped by switching back to the terminal from where it was started and pressing ctrl-C.

wvdial uses wvstreams library.[5]

Contents

[edit] wvdial and chat

It is something like the chat program, except that it uses heuristics to guess how to dial and log into your server rather than forcing you to write a login script. [6]

[edit] wvdialconf utility

If /etc/wvdial.conf is not present, the easiest way to create it is to use configuration utility wvdialconf .

It helps in generating the configuration file needed by wvdial. wvdialconf detects your modem, and fill in automatically the Modem, maximum Baud rate, and a good initialization string (Init options) and generates or updates the wvdial configuration file (/etc/wvdial.conf) based on this information.

It is safe to run wvdialconf if a configuration file already exists. In that case, only the Modem, Baud, Init, and Init2 options are changed in the [Dialer Defaults] section, and only if autodetection is successful.

wvdialconf is a non-interactive utility ( that means that you still need to edit /etc/wvdial.conf to specify the phone number, login name, and password of your internet account in order for wvdial to work).

Example:

wvdialconf /etc/wvdial.conf

Here, /etc/wvdial.conf is the path of the file that needs to be created or updated with the details that wvdialconf detects.

The configuration file built by wvdialconf still needs to be updated with the details like your phone number, username, password for your internet connection in order for wvdial to work.

[edit] Files

  • /etc/ppp/peers/wvdial : required for correct authentication in pppd version 2.3.0 or newer.
  • /etc/ppp/{pap,chap}-secrets : Contains a list of usernames and passwords used by pppd for authentication. wvdial maintains this list automatically.

[edit] wvdial.conf

When wvdial starts, it first loads its configuration from /etc/wvdial.conf. The configuration file /etc/wvdial.conf is the equivalent to the Windows "ini" file format, with sections named in square brackets and a number of variable = value pairs within each section.

Here is a sample configuration file:

[Dialer Defaults]
Modem = /dev/ttyS2
Baud = 57600
Init = ATZ
Init2 = AT S11=50
Phone = 555-4242
Username = apenwarr
Password = my-password 

[Dialer phone2]
Phone = 555-4243 

[Dialer shh]
Init3 = ATM0 

[Dialer pulse]
Dial Command = ATDP

This example that uses Init3 to turn the modem's speaker off. The default is "ATZ" for Init(1).

When wvdial is in Stupid Mode, it does not attempt to interpret any prompts from the terminal server. It starts pppd immediately after the modem connects. Apparently there are ISP's that actually give you a login prompt, but work only if you start PPP, rather than logging in.

[edit] Log

If wvdial fails to establish the communication, type the following commands:

script wvdial.log 
wvdial 
exit


[edit] Ready

After starting wvdial you can know if your session is ready with /sbin/ifconfig which if OK will show a pppd entry.

[edit] Graphical frontends

There are some GUI tools which allows using wvdial:

  • x-wvdial, that uses xmessage. [7]
  • gnome-ppp [8]
  • QtWvDialer
  • KWvDial

[edit] See also

[edit] External links

[edit] References

  1. ^ freshmeat.net: Project details for WvDial
  2. ^ Wv Dial - open.alumnit.ca
  3. ^ wvdial
  4. ^ wvdial
  5. ^ Wv Streams - open.alumnit.ca
  6. ^ chat(8) - Linux man page
  7. ^ http://osx.freshmeat.net/projects/x-wvdial/ , http://www.xfree86.org/4.4.0/xmessage.1.html
  8. ^ GNOME PPP at GnomeFiles
  This Unix-related article is a stub. You can help by expanding it.
Languages