wvdial/wvdial.conf.5

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