WVDIAL.CONF(5)							File Formats Manual						    WVDIAL.CONF(5)

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 pass-
       word.

       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  com-
       plete 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,  how-
	      ever, 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.

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

WvDial								   December 2005						    WVDIAL.CONF(5)