Prosody installation guide: test programs: txfax

This is a program to send a fax. It dials the number and sends a fax from a specified file to the answering fax machine.

Go to directory $(TiNG)/faxtest.

You must have the call control driver initialised. This is documented separately in the call control documentation.

You must have these firmware modules loaded:

Run txfax with the appropriate options (the program is gen-LINUX/txfax, or gen-SOL_32/txfax, or gen-WINNT/txfax depending on which operating system you are using). For example:

	gen-SOL_32/txfax -Nv27ter -Nv17 -Ct1 -t48:0 0123456789 faxfile.tiff

where:

-Nv27ter disables V.27ter
-Nv17 disables V.17
-Ct1 selects timeslot 1 on the outbound trunk
-t48:0 selects the local stream and timeslot used to connect the fax channel to the call
0123456789 is the phone number to dial
faxfile.tiff is the file of page images to send

To use V.17, you must additionally have the firmware module v17tx loaded. Then when the '-Nv17' option is omitted, the fax negotiation with the remote machine will permit V.17 if the remote also supports it. Similarly you can download v27tx and omit '-Nv27ter' to permit the use of V.27ter.

There are very many more options which allow complete control of the call and of the fax channel. Currently the txfax.c source code which is provided in the $(TiNG)/faxtest directory, is the only documentation. Options starting with '-C' control the call setup, those starting with '-N' disable a fax feature, those starting with '-F' set a fax parameter, and those starting with '-D' control debugging.


This is one of the Prosody test programs .