1WVDIAL.CONF(5)                File Formats Manual               WVDIAL.CONF(5)
2
3
4

NAME

6       wvdial.conf - wvdial configuration file
7

DESCRIPTION

9       When   wvdial   starts,   it   first   loads   its  configuration  from
10       /etc/wvdial.conf, which contains  basic  information  about  the  modem
11       port,  speed, and init string, along with information about your Inter‐
12       net Service Provider (ISP), such as the phone  number,  your  username,
13       and your password.
14
15       The  configuration  file /etc/wvdial.conf is in Windows "ini" file for‐
16       mat, with sections named in square brackets and a number of variable  =
17       value pairs within each section.
18
19       Here is a sample configuration file:
20
21              [Dialer Defaults]
22              Modem = /dev/ttyS2
23              Baud = 57600
24              Init = ATZ
25              Init2 = AT S11=50
26              Phone = 555-4242
27              Username = apenwarr
28              Password = my-password
29
30              [Dialer phone2]
31              Phone = 555-4243
32
33              [Dialer shh]
34              Init3 = ATM0
35
36              [Dialer pulse]
37              Dial Command = ATDP
38
39       The  sample configuration file above contains all of the options neces‐
40       sary to run the two sample command lines given above.  Here is  a  com‐
41       plete list of settings that wvdial understands:
42
43       Modem  The location of the device that wvdial should use as your modem.
44              The default is /dev/modem.
45
46       Baud   The speed at which wvdial will communicate with your modem.  The
47              default is 57600 baud.
48
49       Init1 ... Init9
50              wvdial  can use up to nine initialization strings to set up your
51              modem.  Before dialing, these strings are sent to the  modem  in
52              numerical  order.  These are particularly useful when specifying
53              multiple sections.  See above for an example that uses Init3  to
54              turn the modem's speaker off.  The default is "ATZ" for Init1.
55
56       Phone  The  phone  number  you want wvdial to dial. You can add up to 9
57              other phone numbers that wvdial will dial in order, by adding:
58
59       Phone1
60
61       Phone2
62
63       Phone3
64
65       Phone4
66
67       Phone5
68
69       Phone6
70
71       Phone7
72
73       Phone8
74
75       Phone9
76
77       Dial Prefix
78              wvdial will insert this string after the dial command and before
79              the  phone  number.   For  example,  to disable call waiting (in
80              North America, anyway) set this to "*70,".
81
82       Dial Command
83              wvdial will use this string to tell  the  modem  to  dial.   The
84              default is "ATDT".
85
86       Username
87              You must set this to the username you use at your ISP.
88
89       Login Prompt
90              If your ISP has an unusual login procedure that wvdial is unable
91              to figure out, you can  use  this  option  to  specify  a  login
92              prompt.  When this prompt is received from your ISP, wvdial will
93              send the Login string.
94
95       Password
96              You must set this to the password you use at your ISP.
97
98       Ask Password
99              By setting this option wvdial will prompt for your  password  on
100              every  dialin.   Thus  you  don't  have to save your password in
101              /etc/wvdial.conf.  (Option added by SuSE.)
102
103       Password Prompt
104              If your ISP has an unusual login procedure that wvdial is unable
105              to  figure  out,  you  can use this option to specify a password
106              prompt.   When this prompt is received from you ISP, wvdial will
107              send the Password string.
108
109       PPPD Path
110              If your system has pppd somewhere other than /usr/sbin/pppd, you
111              will need to set this option.
112
113       Auto DNS
114              Try to get the Domain Nameserver (DNS) from the provider.   This
115              option is "on" by default.  (Option added by SuSE.)
116
117       Check DNS
118              Check  the Domain Nameserver (DNS) after the connection has been
119              set up.  This option is  "on"  by  default.   (Option  added  by
120              SuSE.)
121
122       DNS Test1
123              First DNS lookup for DNS check.  (Option added by SuSE.)
124
125       DNS Test2
126              Second DNS lookup for DNS check.  (Option added by SuSE.)
127
128       Check Def Route
129              Check  the  default  route after the connection has been set up.
130              This option is "on" by default.  (Option added by SuSE.)
131
132       Force Address
133              This option only applies if you have a static IP address at your
134              ISP, and even then you probably don't need it.  Some ISP's don't
135              send the IP address as part of the PPP negotiation.  This option
136              forces pppd to use the address you give it.
137
138       Remote Name
139              If  your  ISP uses PAP or CHAP authentication, you might need to
140              change this to your ISP's authentication name.  In  most  cases,
141              however, it's safe to use the default value, "*".
142
143       Carrier Check
144              wvdial checks your modem during the connection process to ensure
145              that it is actually online.  If you  have  a  weird  modem  that
146              insists  its  carrier  line  is always down, you can disable the
147              carrier check by setting this option to "no".
148
149       Stupid Mode
150              When wvdial is in Stupid Mode, it does not attempt to  interpret
151              any  prompts  from  the terminal server.  It starts pppd immedi‐
152              ately after the modem connects.  Apparently there are ISP's that
153              actually  give  you  a  login prompt, but work only if you start
154              PPP, rather than logging in.  Go figure.  Stupid Mode is  (natu‐
155              rally) disabled by default.
156
157       New PPPD
158              You need this option if you have pppd version 2.3.0 or newer, to
159              make wvdial create the file /etc/ppp/peers/wvdial.  This  option
160              is  enabled  by default, thus if you have older pppd you need to
161              set it to `no' (or upgrade pppd).
162
163       Default Reply
164              When wvdial detects a prompt, and it hasn't seen any clues  that
165              indicate  what  it  should  send as a response to the prompt, it
166              defaults to sending "ppp".  Sometimes this is  inadequate.   Use
167              this option to override wvdial's default prompt response.
168
169       Auto Reconnect
170              If  enabled,  wvdial will attempt to automatically reestablish a
171              connection if you are randomly disconnected by the  other  side.
172              This option is "on" by default.
173
174       Idle Seconds
175              Set  the  hangup timeout in seconds.  If there is inactivity for
176              the given time the connection is shut down.  A hangup timeout of
177              0 disables this feature.
178
179       Abort on Busy
180              If  enabled,  wvdial  will not retry the connection if the modem
181              says that the line is busy.  This option is "off" by default.
182
183       Abort on No Dialtone
184              If enabled, wvdial will not retry the connection  if  the  modem
185              says that there is no dialtone.  This option is "on" by default.
186
187       Dial Attempts
188              If  value is set, wvdial will quit after that many tries .If set
189              to 0, wvdial will happily keep dialling forever.
190
191       Dial Timeout
192              The maximum time in seconds that wvdial will wait for a  connec‐
193              tion to be made. Default value is 60 seconds.
194
195       The  wvdialconf(1) program can be used to detect your modem and fill in
196       the Modem, Baud, and Init/Init2 options automatically.
197

AUTHORS

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

SEE ALSO

204       wvdial(1), wvdialconf(1), pppd(8).
205
206
207
208WvDial                           December 2005                  WVDIAL.CONF(5)
Impressum