To quit dial enter ctrl-c or send it the signal SIGTERM.

Topics:
	* Configuration
	* Non-interactive (scripting)
	* See also
	
Configuration
-------------

See dial -h for a list of command-line options.

dial [-p PORT] [-s ADDRESS] [-u USERNAME] [-k NUM] [-v] [-h]

There is also an optional dialrc file containing data in the following format:

keyword argument

If a keyword and its argument cannot fit all on one line you should allow it to
flow to the next line without breaking. Blank lines or those beginning with # 
are ignored.

There is a system-wide configuration file /etc/dialrc which will be used if it 
exists. Settings here are over-ridden by a user's dialrc 
(normally $HOME/.dialrc) which is then over-riden by command-line options.

keyword, -command-line option
	description

port, -p
	connect to this port. 5540 by default.

server, -b
	connect to this hostname / IP address. 127.0.0.1 by default.

user, -u
	use this username. $USER from the environment by default.

pass
	use this password. If this keyword is used, dialrc must be a
	regular file with mode 0600 or 0400. By default the user will
	be prompted for a password.

keepalive, -k
	every this number of seconds, the dwun server expects a keepalive.
	60 seconds by default. (For dwun server versions less than 0.6, you
	should set this to 20 seconds).

-r
	read configuration data from this file. /etc/dialrc and/or
	$HOME/.dialrc (if they exist) by default.

-c
	run /bin/sh -c 'argument' when we receive the ``#Connected'' message 
	(i.e. we are properly connected to the ISP). This is useful when 
	running dial non-interactively from scripts (See below). The
	environment variable $DIAL_PID will contain the pid of dial, for easy
	termination. (e.g. kill "$DIAL_PID"). No command by default.

-v
	display version information.

-h
	display version information and help on command-line arguments.


Non-interactive (scripting)
---------------------------

Dial can be run non-interactively. This is useful for scripts. The password 
must be setup in the dial rcfile so that dial won't try to read the password 
from the terminal. Remember that it doesn't matter if the connection is already
up when you run dial so it is okay to do a ``dial, do something then 
disconnect'' without worrying about  checking if the connection is already up.

For example, to download a file, connecting if necessary, then disconnecting
afterwards if no-one else wants the connection up
	connect.sh run 'wget http://foo.invalid/foo.tar.gz'

See the connect.sh manpage for more information.

Note that cron may not set $USER, so if you run scripts from there you will
need to add the "user" option to your dial rcfile.


See also
--------

man 1 dial
man 1 connect.sh
man 8 dwun
