Package
-------

Original Documentation  by Kurt Fitzner, modified by Andrea Sciucca for 
www.slacky.eu tgz SlackWare Package.



Installation
------------

There are some manual steps that need to be performed after installing this
package:

1) Run 'faxsetup' as root.  This will ask you a series of questions about
your setup. Documentation on this process is included with the package, and on
the hylafax web site.  In general, though, if you don't know the answer to the
question, then simply hit ENTER to accept the default.
After faxsetup has finishes asking you questions, it will ask you if you want
to run 'faxaddmodem' to add a modem.  You might as well do this now. It will
ask you some more questions - again, hitting ENTER to accept the default reply
on questions you don't know the answer to usually works, but you /must/ know
the serial port to use.  It is best to refer to the port as ttySx (where x is
the number of the port - ttyS0 is com1, ttyS1 is com2, etc).
Close to the end it will ask you if you want to run "faxmodem".  It does this
because we haven't yet edited the inittab.  Say no to this question.

2) The startup script must be made executable and run.  The package installs the
script /etc/rc.d/rc.hylafax.  You will need to edit one of the existing scripts
in order to make the system run it at startup time.  Using rc.local for this is
probably best.  You can add the following lines to it:

# Start up Hylafax
if [ -x /etc/rc.d/rc.hylafax ]; then
  . /etc/rc.d/rc.hylafax start
fi

Then you will want to make rc.hylafax executable:

$ chmod +x /etc/rc.hylafax

Then, just like many of the startup scripts, any time you want to disable
hylafax you simple remove the executable permission from it.

3) You will need to edit /etc/inittab to add an entry for faxgetty.  In the
section for dialup lines, add the following:

# Dialup lines:
d1:12345:respawn:/usr/sbin/faxgetty /dev/modem

4) You will need to edit /var/spool/hylafax/etc/hosts.hfaxd to add an entry
for each host or user that will be authorized to connect to and use hylafax.
You can also/alternatively use the 'faxadduser' command to do this.  Check
the man pages for hosts.hfaxd and faxadduser for details.
