centaurifax - A KDE Network proxy/stub for capisuitefax
centaurifax [--client] host[:port] key name dial subject postscriptfile
centaurifax --server options
centaurifax --setup [--client] [host[:port] [key]]
centaurifax --setup --server options
These bash scripts work as proxy/stub to allow KDE clients to send faxes to a server via the standard KDE print dialog (using the kdeprintfax application)
The server uses a list of keys for minimalistic authorization: if the list of keys is not empty a client must present one of the keys to get access (as key parameter).
Usually xinetd will be used to start the server. The client uses the host and the optional port parameters to contact xinetd. When port as not given the hylafax port number is used (4559).
The following parameters are usually obtained from kdeprintfax: name is the name of the fax destinee, dial is the fax number to be dialed, subject is a short description and postscriptfile denotes the file to be transmitted.
As a conveniency the --setup action can be used to create a KDE configuration file for kdeprintfax on the client side and to create a config file for xinetd on the server side.
All actions and options can be abbreviated to 3 letters.
Indicates that a client side action is to be taken (the default).
Indicates that a server side action is to be taken. This option is required when centaurifax is lauched at the server side (via xinetd) or when it is used to create a xinetd config file (see --setup).
The client users can call this script to configure KDE with their normal user rights. If no arguments are given the program prompts for input.
The --server option requires root access as it creates a file in /etc/xinet.d and reloads the xinetd configuration.
list is a space separated list of passwords that the clients can use to get authorized. If this parameter is empty or the option is not given no authorization takes place.
+ replacement, example: 00
national prefix, example: 0
country code, example: 49 (Germany)
region prefix, example: 69 (Frankfurt)
For the given examples in the description of the --server options, the following reformatting of outgoing numbers would take place:
(--int) +49 30 12345678 0049 30 12345678 # replace + with 00 (--nat) # watch for 0049 prefix (--cou) 0049 30 12345678 030 12345678 # replace 0049 with 0 (--reg) 069 12345678 12345678 # remove 069 region code all: 0041 (22) 123-456 004122123456 # remove any [ ()-]
capisuite(1) kprinter(1) xinetd(1)
centaurifax (C) 2004-2006 Dr. Juergen Pfennig
This software is published under a BSD style license and has been written for educational purposes only, no warranties! Try it at your own risk.