Provided by: wvdial_1.61-5_amd64 bug

NAME

       wvdial.conf - wvdial configuration file

DESCRIPTION

       When wvdial starts, it first loads its configuration from /etc/wvdial.conf, 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.

       The configuration file /etc/wvdial.conf is in 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

       The  sample  configuration file above contains all of the options necessary to run the two
       sample command lines given above.  Here  is  a  complete  list  of  settings  that  wvdial
       understands:

       Modem  The  location  of  the device that wvdial should use as your modem.  The default is
              /dev/modem.

       Baud   The speed at which wvdial will communicate with your modem.  The default  is  57600
              baud.

       Init1 ... Init9
              wvdial  can  use  up  to  nine initialization strings to set up your modem.  Before
              dialing, these strings are sent  to  the  modem  in  numerical  order.   These  are
              particularly  useful  when  specifying multiple sections.  See above for an example
              that uses Init3 to turn the modem's speaker off.  The default is "ATZ" for Init1.

       Phone  The phone number you want wvdial to dial. You can add up to 4 other  phone  numbers
              that wvdial will dial in order, by adding:

       Phone1

       Phone2

       Phone3

       Phone4

       Dial Prefix
              wvdial  will insert this string after the dial command and before the phone number.
              For example, to disable call waiting (in North America, anyway) set this to "*70,".

       Dial Command
              wvdial will use this string to tell the modem to dial.  The default is "ATDT".

       Login  You must set this to the username you use at your ISP.

       Login Prompt
              If your ISP has an unusual login procedure that wvdial is unable to figure out, you
              can  use  this option to specify a login prompt.  When this prompt is received from
              your ISP, wvdial will send the Login string.

       Password
              You must set this to the password you use at your ISP.

       Ask Password
              By setting this option wvdial will prompt for your password on every dialin.   Thus
              you don't have to save your password in /etc/wvdial.conf.  (Option added by SuSE.)

       Password Prompt
              If your ISP has an unusual login procedure that wvdial is unable to figure out, you
              can use this option to specify a password prompt.   When this  prompt  is  received
              from you ISP, wvdial will send the Password string.

       PPPD Path
              If  your  system has pppd somewhere other than /usr/sbin/pppd, you will need to set
              this option.

       Auto DNS
              Try to get the Domain Nameserver (DNS) from the provider.  This option is  "on"  by
              default.  (Option added by SuSE.)

       Check DNS
              Check  the  Domain  Nameserver  (DNS)  after  the connection has been set up.  This
              option is "on" by default.  (Option added by SuSE.)

       DNS Test1
              First DNS lookup for DNS check.  (Option added by SuSE.)

       DNS Test2
              Second DNS lookup for DNS check.  (Option added by SuSE.)

       Check Def Route
              Check the default route after the connection has been set up.  This option is  "on"
              by default.  (Option added by SuSE.)

       Force Address
              This option only applies if you have a static IP address at your ISP, and even then
              you probably don't need it.  Some ISP's don't send the IP address as  part  of  the
              PPP negotiation.  This option forces pppd to use the address you give it.

       Remote Name
              If  your ISP uses PAP or CHAP authentication, you might need to change this to your
              ISP's authentication name.  In most cases, however, it's safe to  use  the  default
              value, "*".

       Carrier Check
              wvdial  checks  your  modem  during  the  connection  process  to ensure that it is
              actually online.  If you have a weird modem that insists its carrier line is always
              down, you can disable the carrier check by setting this option to "no".

       Stupid Mode
              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.  Go  figure.   Stupid  Mode  is  (naturally)
              disabled by default.

       New PPPD
              You need this option if you have pppd version 2.3.0 or newer, to make wvdial create
              the file /etc/ppp/peers/wvdial.  This option is enabled by  default,  thus  if  you
              have older pppd you need to set it to `no' (or upgrade pppd).

       Default Reply
              When  wvdial  detects  a prompt, and it hasn't seen any clues that indicate what it
              should send as a response to the prompt, it defaults to sending  "ppp".   Sometimes
              this is inadequate.  Use this option to override wvdial's default prompt response.

       Auto Reconnect
              If  enabled,  wvdial  will attempt to automatically reestablish a connection if you
              are randomly disconnected by the other side.  This option is "on" by default.

       Idle Seconds
              Set the hangup timeout in seconds.  If there is inactivity for the given  time  the
              connection is shut down.  A hangup timeout of 0 disables this feature.

       Abort on Busy
              If enabled, wvdial will not retry the connection if the modem says that the line is
              busy.  This option is "off" by default.

       Abort on No Dialtone
              If enabled, wvdial will not retry the connection if the modem says that there is no
              dialtone.  This option is "on" by default.

       Dial Attempts
              If  value  is set, wvdial will quit after that many tries .If set to 0, wvdial will
              happily keep dialling forever.

       Dial Timeout
              The maximum time in seconds that wvdial will wait for  a  connection  to  be  made.
              Default value is 60 seconds.

       The  wvdialconf(1)  program  can be used to detect your modem and fill in the Modem, Baud,
       and Init/Init2 options automatically.

AUTHORS

       Dave Coombs and Avery Pennarun for Net Integration Technologies Inc.  Great  contributions
       have been made by many people, including SuSE and RedHat. Thanks guys!

SEE ALSO

       wvdial(1), wvdialconf(1), pppd(8).