Notes for mgetty+sendfax use  (Denis Havlik, Nov. 1999)
----------------------------

I USER NOTES
-------------

1) Sending a fax
-------------

Faxes can be sent with "faxsend NUMBER FILE" command, or using some graphical 
font-end, like "ksendfax". "FILE" can be in plain-ASCII, postscript, and
various graphical formates (for instance jpg). 

StarOffice can be used to send faxes, if the "fax-printer" has been set up.

2) checking a fax-queue / removing a job 
-------------------------------------
Commands used to check a queue / ramove a queued job are "faxq" and "faxrm".
They are described in their man-pages. Most of the graphical font-ends for
faxing can also show/remove jobs. 

3) receiving a fax
------------------

Your fax will be received per e-mail by "fax-administrator" and printed on
the "linus" printer, unless you have a special arrangement with the
administrator.

II NOTES FOR ADMINISTRATORS
---------------------------
  
1) Network faxing
--------------
In order to send faxes from another (Unix) machine, install mgetty+sendfax 
package and add following lines to your fstab:

FAXSERVER:/var/spool/fax     /var/spool/fax          nfs     defaults   0 0
FAXSERVER:/etc/mgetty+sendfax /etc/mgetty+sendfax    nfs     defaults	0 0

("FAXSERVER" is the name of the machine which actually sends faxes. In our
case it is "lucy".)

Then mount these directories, or reboot the machine if you want to get an
idea what would the life be like if you would be running M$ Windows.
Obviously, you will only be able to mount these directories if they are
nfs-exported to your machine. 

(At the moment, these directories are exported from "lucy"
only to "thrusted-hosts" netgroup, as defined on NIS-server , i.e. lisa.)

In order to fax from Windows machines, one must set-up a "smb fax printer". 
Programs which do this are available, but I have not installed them, since I
have no Windows machines to fax from.

Other possible modes of using a fax-server in the network are for instance
fax2lpr and fax2email gateways. I have not succeeded to install the fax2lpr
gateway, because of the problems with new security related changes in lpd 
package - it worked localy, buit not over the network. 
Fax2email would be nice, but i have no time to configure it.

2) receiving a fax
-------------------

When a fax is received, It is first spooled to /var/spool/fax/incomming.
If a "/etc/mgetty+sendfax/new_fax" program exist, incomming faxes will be
handed to it. I am using a "new_fax" ksh script written by Darko Krizic.
This script can do just about anything with incoming faxes, in particular:
notify one or more people that the fax has arrived, transform the incomming
fax in some friendly formate (gif, jpg, ps...) and send it per e-mail, send
the fax to printer and erase the fax from the "incomming" directory. 

It is currently configured to send e-mail to "fischer@ap.univie.ac.at",
print the fax on "linus" printer and erase the files.The Configurations file 
for "new-fax" script is "/etc/mgetty+sendfax/faxlist".

3) files in /etc/mgetty+sendfax

dialin.config -  Here you can allow/deny dial-in, i.e. sending faxes to us 
		Currently, everyone is allowed to send us faxes.
fax.allow     - if this file exists, only users listed in it are allowed to
		send faxes
fax.deny      -	If this file exists (and fax.allow does not exist), only
		users not listed in it are allowed to send faxes. If you
		want to allow everyone to send faxes, leave this file empty.
faxaliases    - this file contains "aliases" for fax-numbers. a line of the
		form: "name NUMBER comment" enables sending faxes to number
		"NUMBER" using the alias "name".
faxheader     -	Contents of this file will be pasted as header on every 
		fax-page that we send.
faxlist       -	config. file for "new-fax"
faxrunq.config- config. file for "faqrunq" and "faxrunqd".
faxrunq.policy- additional configurationsfile for faxrunq and faxrunqd. In
		this file, different policies for sending faxes based on
		destination can be defined. In particular, one can add or
		remove part of the telephone number, in order to send it
		cheaper, or define which modem should be used.
login.config   - login configurations file for mgetty. I THINK you do not
		 need this if you only want a fax server.
mgetty.config  - configurationsfile for mgetty. This is where you set-up the 
		 most of the modem-related things, including debugging
		 level, speed, modem-device, fax-id, ownership and mode of
		 incoming faxes, modem type etc.
new-fax        - this rogram is called by mgetty when it receives a fax.
sendfax.config - I am afraid this file duplicates part of the mgetty.config.
		 However, this one is used by "sendfax".

All the files in this directory, and their options are described in mgetty+sendfax
documentation.
