1WVDIAL.CONF(5) WvDial 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:
19 [Dialer Defaults]
21 Modem = /dev/ttyS2
22 Baud = 57600
23 Init = ATZ
24 Init2 = AT S11=50
25 Phone = 555-4242
26 Username = apenwarr
27 Password = my-password
28 [Dialer phone2]
30 Phone = 555-4243
31 [Dialer shh]
33 Init3 = ATM0
34 [Dialer pulse]
36 Dial Command = ATDP
37 The sample configuration file above contains all of the options neces‐
39 sary to run the two sample command lines given above. Here is a com‐
40 plete list of settings that wvdial understands:
41 Modem The location of the device that wvdial should use as your modem.
43 The default is /dev/modem.
44 Baud The speed at which wvdial will communicate with your modem. The
46 default is 57600 baud.
47 Init1 ... Init9
49 wvdial can use up to nine initialization strings to set up your
50 modem. Before dialing, these strings are sent to the modem in
51 numerical order. These are particularly useful when specifying
52 multiple sections. See above for an example that uses Init3 to
53 turn the modem's speaker off. The default is "ATZ" for Init1.
54 Phone The phone number you want wvdial to dial. You can add up to 4
56 other phone numbers that wvdial will dial in order, by adding:
57 Phone1
59 Phone2
61 Phone3
63 Phone4
65 Dial Prefix
67 wvdial will insert this string after the dial command and before
68 the phone number. For example, to disable call waiting (in
69 North America, anyway) set this to "*70,".
70 Dial Command
72 wvdial will use this string to tell the modem to dial. The
73 default is "ATDT".
74 Login You must set this to the username you use at your ISP.
76 Login Prompt
78 If your ISP has an unusual login procedure that wvdial is unable
79 to figure out, you can use this option to specify a login
80 prompt. When this prompt is received from your ISP, wvdial will
81 send the Login string.
82 Password
84 You must set this to the password you use at your ISP.
85 Ask Password
87 By setting this option wvdial will prompt for your password on
88 every dialin. Thus you don't have to save your password in
89 /etc/wvdial.conf. (Option added by SuSE.)
90 Password Prompt
92 If your ISP has an unusual login procedure that wvdial is unable
93 to figure out, you can use this option to specify a password
94 prompt. When this prompt is received from you ISP, wvdial will
95 send the Password string.
96 PPPD Path
98 If your system has pppd somewhere other than /usr/sbin/pppd, you
99 will need to set this option.
100 Auto DNS
102 Try to get the Domain Nameserver (DNS) from the provider. This
103 option is "on" by default. (Option added by SuSE.)
104 Check DNS
106 Check the Domain Nameserver (DNS) after the connection has been
107 set up. This option is "on" by default. (Option added by
108 SuSE.)
109 DNS Test1
111 First DNS lookup for DNS check. (Option added by SuSE.)
112 DNS Test2
114 Second DNS lookup for DNS check. (Option added by SuSE.)
115 Check Def Route
117 Check the default route after the connection has been set up.
118 This option is "on" by default. (Option added by SuSE.)
119 Force Address
121 This option only applies if you have a static IP address at your
122 ISP, and even then you probably don't need it. Some ISP's don't
123 send the IP address as part of the PPP negotiation. This option
124 forces pppd to use the address you give it.
125 Remote Name
127 If your ISP uses PAP or CHAP authentication, you might need to
128 change this to your ISP's authentication name. In most cases,
129 however, it's safe to use the default value, "*".
130 Carrier Check
132 wvdial checks your modem during the connection process to ensure
133 that it is actually online. If you have a weird modem that
134 insists its carrier line is always down, you can disable the
135 carrier check by setting this option to "no".
136 Stupid Mode
138 When wvdial is in Stupid Mode, it does not attempt to interpret
139 any prompts from the terminal server. It starts pppd immedi‐
140 ately after the modem connects. Apparently there are ISP's that
141 actually give you a login prompt, but work only if you start
142 PPP, rather than logging in. Go figure. Stupid Mode is (natu‐
143 rally) disabled by default.
144 New PPPD
146 You need this option if you have pppd version 2.3.0 or newer, to
147 make wvdial create the file /etc/ppp/peers/wvdial. This option
148 is enabled by default, thus if you have older pppd you need to
149 set it to `no' (or upgrade pppd).
150 Default Reply
152 When wvdial detects a prompt, and it hasn't seen any clues that
153 indicate what it should send as a response to the prompt, it
154 defaults to sending "ppp". Sometimes this is inadequate. Use
155 this option to override wvdial's default prompt response.
156 Auto Reconnect
158 If enabled, wvdial will attempt to automatically reestablish a
159 connection if you are randomly disconnected by the other side.
160 This option is "on" by default.
161 Idle Seconds
163 Set the hangup timeout in seconds. If there is inactivity for
164 the given time the connection is shut down. A hangup timeout of
165 0 disables this feature.
166 Abort on Busy
168 If enabled, wvdial will not retry the connection if the modem
169 says that the line is busy. This option is "off" by default.
170 Abort on No Dialtone
172 If enabled, wvdial will not retry the connection if the modem
173 says that there is no dialtone. This option is "on" by default.
174 Dial Attempts
176 If value is set, wvdial will quit after that many tries .If set
177 to 0, wvdial will happily keep dialling forever.
178 The wvdialconf(1) program can be used to detect your modem and fill in
180 the Modem, Baud, and Init/Init2 options automatically.
181
183 wvdial(1), wvdialconf(1), pppd(8).
184
186 Dave Coombs and Avery Pennarun for Net Integration Technologies Inc.,
187 as part of the Worldvisions Weaver project. Greatful contributions have
188 been made by many people, including SuSE and RedHat. Thanks Guys!
189Debian Project December 1999 WVDIAL.CONF(5)