1WVDIAL.CONF(5) File Formats Manual WVDIAL.CONF(5)
2
6 wvdial.conf - wvdial configuration file
7
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 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 Here is a sample configuration file:
20 [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 [Dialer phone2]
31 Phone = 555-4243
32 [Dialer shh]
34 Init3 = ATM0
35 [Dialer pulse]
37 Dial Command = ATDP
38 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 Modem The location of the device that wvdial should use as your modem.
44 The default is /dev/modem.
45 Baud The speed at which wvdial will communicate with your modem. The
47 default is 57600 baud.
48 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 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 Phone1
60 Phone2
62 Phone3
64 Phone4
66 Phone5
68 Phone6
70 Phone7
72 Phone8
74 Phone9
76 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 Dial Command
83 wvdial will use this string to tell the modem to dial. The
84 default is "ATDT".
85 Username
87 You must set this to the username you use at your ISP.
88 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 Password
96 You must set this to the password you use at your ISP.
97 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 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 PPPD Path
110 If your system has pppd somewhere other than /usr/sbin/pppd, you
111 will need to set this option.
112 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 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 DNS Test1
123 First DNS lookup for DNS check. (Option added by SuSE.)
124 DNS Test2
126 Second DNS lookup for DNS check. (Option added by SuSE.)
127 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 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 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 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 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 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 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 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 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 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 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 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 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 The wvdialconf(1) program can be used to detect your modem and fill in
196 the Modem, Baud, and Init/Init2 options automatically.
197
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
204 wvdial(1), wvdialconf(1), pppd(8).
205WvDial December 2005 WVDIAL.CONF(5)