agiconf [-a] [-c] [-d] [-g Group] [-h] [-t] [-v]
Agiconf configures namelookup.agi.
It can be used to generate the files agi-namelookup.conf, agi-nameblock.db, numbers.db, areas.db and regions.db.
The software looks for source files in /usr/local/share/phonebook/. When debug (-d) is used, it looks in the default directory.
Exceptions are agi-nameblock.txt and numbers.tsv. The software always looks for these files in /etc/namelookup-agi/. If this fails it will look in the default directory. If this also fails it will look in your home directory.
Note: If you want to convert agi-nameblock.txt to agi-nameblock.db or numbers.tsv to numbers.db, start this program in the directory where agi-nameblock.txt and numbers.tsv are. Or put both files in /etc/namelookup-agi/ or your home directory.
Note: When running this program as root, the homedir is of course /root. Unless you use 'su -p' to become root, in which is case it's your homedir. If you prefer sudo to su, the sudo '-D' option can be used to set the directory.
Press 1, 2, 3, etc to select an item and then press the <Enter> key to execute. Press 'Q' or 'q', <Enter> to quit. Press 'W' or 'w', <Enter> to write to a file.
In scroll lists use cursor keys up, down, page-up page-down, home and end to
move up and down.
Use keys like 'q' and 'w' to move to the menu items below.
Keys 'a' to 'z' not listed in the menu below will move to the nearest item
in the scroll list which starts with that letter.
A mouse click on the horizontal line just below the scroll list, moves down. A mouse click on the blank line just above the scroll list, moves up.
Space and <Enter> toggle selection of an item in the scroll list.
<Tab> toggles between the scroll list and the menu below.
Note: In country selection you can only select ONE country.
Note: In area code list file selection you can only select ONE list file per country.
Note: You can't drag the scroll progress bar on the right up or down with your mouse.
The scroll list lists Country, Country code, International call prefix and
Trunk code prefix.
The international code prefix is usually '00'.
The trunk code prefix is usually '0'.
Agiconf uses this information to change numbers into values that are used in caller-IDs. E.G.: change 31 (Netherlands) to 0031 and 3170 (NL The Hague) to 003170 or 070 (or whatever the international code prefix and trunk code prefix may be).
Note: The first time you enter 'country selection', agiconf will try to guess your country based on the 'locale' and jump to that country in the scroll list. Make sure it guessed right.
These come in low, medium or high resolution or granularity.
English or other languages.
Default is English, medium resolution.
If you run the program before, Select-Country, Web-Lookups, Compact-Files and
Select-Regions display previous saved settings.
If you save agi-nameblock.db, numbers.db or areas.db (or their compact equivalents), the main menu will display 'Done' next to Convert-Blocklist, Convert-Phonebook or Select-Areas;
These display the result of your CURRENT actions, not a previous run!
The area selection does get saved to 'confagi.conf' though. It is displayed the next time you enter Select-Areas.
All file contents are UTF-8.
File names are US-ASCII.
Note: This program has limited functionality in an non UTF-8 environment.
The program returns 1 on error, 0 on success.