Provided by: wvdial_1.61-4.1_amd64 bug

NAME

       wvdial - PPP dialer with built-in intelligence.

SYNOPSIS

       wvdial [ OPTIONS ] [ SECTION ] ...

DESCRIPTION

       wvdial  is  an intelligent PPP dialer, which means that it dials a modem and starts PPP in
       order to connect to the Internet.  It is something like the chat(8) 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.

       When wvdial starts, it first loads its configuration from /etc/wvdial.conf and ~/.wvdialrc
       which  contains basic information about the modem port, speed, and init string, along with
       information about your Internet Service Provider (ISP), such as  the  phone  number,  your
       username, and your password.

       Then  it initializes your modem and dials the server and waits for a connection (a CONNECT
       string from the modem).  It understands and responds to typical connection problems  (like
       BUSY and NO DIALTONE).

       Any  time  after  connecting,  wvdial  will  start  PPP if it sees a PPP sequence from the
       server.  Otherwise, it tries to convince the server to start PPP by doing the following:

       •   responding to any login/password prompts it sees;

       •   interpreting “choose one of the following”-style menus;

       •   eventually, sending the word “ppp” (a common terminal server command).

       If all of this fails, wvdial just runs pppd(8) and hopes for the best. It  will  bring  up
       the connection, and then wait patiently for you to drop the link by pressing CTRL-C.

OPTIONS

       Several options are recognized by wvdial.

       -c, --chat
              Run  wvdial  as  a  chat  replacement  from within pppd, instead of the more normal
              method of having wvdial negotiate the connection and then call pppd.

       -C, --config=CONFIGFILE
              Run wvdial with CONFIGFILE as the configuration file, instead of  /etc/wvdial.conf.
              This is mainly useful only if you want to have per-user configurations, or you want
              to avoid having dial-up information (usernames, passwords,  calling  card  numbers,
              etc.) in a system wide configuration file.

       -n, --no-syslog
              Don't  output  debug  information  to  the syslog daemon (only useful together with
              --chat).

       wvdial is normally  run  without  command  line  options,  in  which  case  it  reads  its
       configuration  from the [Dialer Defaults] section of /etc/wvdial.conf.  (The configuration
       file is described in more detail in wvdial.conf(5) manual page.)

       One or more SECTIONs of /etc/wvdial.conf may be specified on the command  line.   Settings
       in these sections will override settings in [Dialer Defaults].

       For example, the command:
              wvdial phone2
       will  read default options from the [Dialer Defaults] section, then override any or all of
       the options with those found in the [Dialer phone2] section.

       If more than one section is specified, they are processed in the  order  they  are  given.
       Each section will override all the sections that came before it.

       For example, the command:
              wvdial phone2 pulse shh
       will  read default options from the [Dialer Defaults] section, then override any or all of
       the options with those found in the [Dialer  phone2]  section,  followed  by  the  [Dialer
       pulse] section, and lastly the [Dialer shh] section.

       Using  this  method, it is possible to easily configure wvdial to switch between different
       internet providers, modem init strings, account names, and so on  without  specifying  the
       same configuration information over and over.

BUGS

       “Intelligent” programs are frustrating when they don't work right.  This version of wvdial
       has only minimal support for disabling or overriding its “intelligence”, with the  “Stupid
       Mode”,  “Login  Prompt”, and “Password Prompt” options.  So, in general if you have a nice
       ISP, it will probably work, and if you have a weird ISP, it might not.

       Still, it's not much good if it doesn't work for you, right?  Don't be fooled by the  fact
       that  wvdial  finally  made  it  to  version  1.00;  it  could  well contain many bugs and
       misfeatures.    Let   us   know   if   you   have   problems   by   sending   e-mail    to
       <wvdial-list@lists.nit.ca>.

       You   may   encounter   some   error   messages   if   you  don't  have  write  access  to
       /etc/ppp/pap-secrets and /etc/ppp/chap-secrets.  Unfortunately, there's really no nice way
       around this yet.

FILES

       /etc/wvdial.conf
              Configuration  file  which  contains  modem,  dialing,  and  login information. See
              wvdial.conf(5).

       /dev/ttyS*
              Serial port devices.

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

AUTHORS

       Dave  Coombs  and  Avery Pennarun for Net Integration Technologies.  We would also like to
       thank SuSE and RedHat for adding a number of various  cool  features  to  wvdial.   Thanks
       guys!

SEE ALSO

       wvdial.conf(5), wvdialconf(1), pppd(8), chat(8).