
+-----------------------------------------------------------------------------+
| OPT_IR4L for fli4l, version 0.1b                      english documentation |
+-----------------------------------------------------------------------------+

The fees taken by cellular phone operators are still quite high. But typically
you are allowed to specify a single number that you are allowed to call for a 
much cheaper rate. If you need to call someone else, it would be great if you 
could always route your mobile call though this cheap number finally ending at 
the desired destination. This is exactly what ir4l does. 
You will find a calculation on how much you may probably be able to save under 
http://www.veith-system.de/mcdialer/html/sparen.html (german). Note that 
McDialer is Shareware, while ir4l is completly free :)


Configuration
-------------

OPT_IR4L='yes|no'
Do you want OPT_IR4L (this package) to be activated? 
Default value: 'yes'

IR4L_INCOMING_MSN='number'
On which MSN do you want the ir4l to listen for incoming calls?
Default value: N/A

IR4L_OUTGOING_MSN='number'
On which MSN do you want the ir4l to take the outgoing call?
Default value: N/A

IR4L_INCOMING_NUMBERS_N='number'
Number of incoming numbers that you want to be able to use the ir4l without
the need of a pin. You may also supply 0 as value, but you will have to supply 
at least one pin then or the ir4l will become unusable as it just rejects every 
call!
Default value: 0

IR4L_INCOMING_NUMBERS_%='number'
The %'th Number that is always allowed the use the ir4l. You have to supply 
exactly a number of IR4L_INCOMING_NUMBERS_N IR4L_INCOMING_NUMBERS_%-Variables.
If IR4L_INCOMING_NUMBERS_N is 2 e.g., you need to supply 
IR4L_INCOMING_NUMBERS_1 and IR4L_INCOMING_NUMBERS_2.
Notice that you have to specify the number without the leading 0!
Default value: N/A

IR4L_PINS_N='number'
Number of PIN-codes that you want to be used with the ir4l. If this variable is 
0, only numbers listed under IR4L_INCOMING_NUMBERS (see above) are allowed to 
use the ir4l.
Default value: 0

IR4L_PINS_%='number'
The %'th PIN that is enables to use the ir4l. You have to supply 
exactly a number of IR4L_PINS_N IR4L_PINS_%-Variables (see 
IR4L_INCOMING_NUMBERS_%).
Default value: N/A


Example Configuration
---------------------

OPT_IR4L='yes'
IR4L_INCOMING_MSN='2345'
IR4L_OUTGOING_MSN='2346'
IR4L_INCOMING_NUMBERS_N='2'
IR4L_INCOMING_NUMBERS_1='172555666'
IR4L_INCOMING_NUMBERS_2='160123456'
IR4L_PINS_N='0'
IR4L_PINS_1=''

What does this configuration do? Calls from 0172555666 and 0160123456 are 
accepted, PIN-authentification is not provided. Thus, one of these number
calls 2345, enters the number he wants to reach (see below) and ir4l then calls 
out using the 2346!


Usage
-----

Just call the ir4l under the number IR4L_INCOMING_MSN. You will then be asked to
enter the PIN, terminated by hash (#) (in german - sorry for that) if you're 
number is not listed under IR4L_INCOMING_NUMBERS_ and you enabled the PIN 
option. If you're number is listed or you entered the correct pin you will be 
asked for the number to call. Enter it and finish with hash (#). You will be 
connected with this number. Note that you will hear nothing until your dialog 
partner accepts the call.



LICENSE
-------

This software is distributed under the GPL.


Credits
-------

ir4l is Copyright by Christof Warlich <cwarlich@gmx.de>

Important parts of the program have been taken from ivcall, provided by Lennart 
Poettering <mz697663616c6c@poettering.de>. Thus, he deserves a substantial part 
of appreciation.

Contributions by Felix Eckhofer <felix@tribut.de>




Have Fun!
felix <felix@tribut.de>
