1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
|
HylaFAX for Debian
==================
Welcome to Debian's HylaFAX distribution.
This document contains some notes specific to Debian's HylaFAX packages.
For general HylaFAX information, please see http://www.hylafax.org.
HylaFAX on Debian is split into three packages:
* hylafax-server: the tools necessary to run a HylaFAX server that can send
and receive facsimiles. Please note, that you will need hylafax-client as
well.
* hylafax-client: the tools necessary to operate a local or remote HylaFAX
server. Install this package on networked clients.
* hylafax-doc: HTML documentation on HylaFAX. Please note, that
hylafax-server and hylafax-client come with manpages for the programs they
contain, whereas this is a more extensive manual.
1. Quick Start
--------------
To get started, run "faxsetup" to enter your basic configuration and then
"faxaddmodem" to set up one or more modems (both as root). If you have a
send-only environment, you will need to run "faxmodem" on the appropriate
device. Alternatively, you should run "faxgetty" which handles incoming fax
calls. Have a look at the included QuickStart document in the same
directory.
The hylafax-server(5) manpage provides a nice overview of the various
HylaFAX components and how they interact with each other. For further
guidance, please refer to the contents of the hylafax-doc package.
2. /etc/inittab & faxgetty --------------------------
If you want your system to accept incoming fax calls via one or more modems,
you will need to run faxgetty on their respective ports. The postinst script
of hylafax-server does not modify /etc/inittab anymore. This is what it used
to put there, just as an example of how to use faxgetty:
#-- hylafax begin
# The following is example on how to use faxgetty for your modem lines.
# Please leave the lines with "hylafax begin" "hylafax end" in this file. If
# you decide to remove hylafax from this system then the parts between those
# comments will be erased and your inittab cleaned up.
#S0:23:respawn:/usr/sbin/faxgetty ttyS0
#S1:23:respawn:/usr/sbin/faxgetty ttyS1
#-- hylafax end
It is fairly straightforward. If you modify /etc/inittab, make sure you do
"init q" in order to make init(8) reload it.
3. Logging
----------
Default syslog facility: local5
Please also note, that hylafax-server doesn't modify /etc/syslog.conf either
now. In order to create a separate log for HylaFAX messages add the
following line to your /etc/syslog.conf:
local5.* -/var/log/hylafax/hylafax.log
and issue an /etc/init.d/syslog reload command to activate the changes. If
you are using syslog-ng please consult the appropriate documentation.
4. Faxmaster
------------
Previous versions of hylafax-server used to create alias for faxmaster
pointing to root. Since sending email to root is insecure, modifying a file
belonging to another package is a policy violation and having in mind that
at least one popular MTA doesn't support /etc/aliases, that behaviour is
changed and hylafax-server now creates a separate account for the faxmaster.
By default, this user is disabled, i.e. nobody can login as faxmaster.
Please create an appropriate alias manually if you want to have
administrative messages sent to another user. Alternatively, you can set
that user's password and have the mail messages retrieved somehow.
5. Other notes
--------------
Default allow users: localhost
hylafax can't use AdaptiveAnswer without these links:
/etc/hylafax/getty-link -> /sbin/mgetty
/etc/hylafax/vgetty-link -> /usr/sbin/vgetty
/etc/hylafax/egetty-link -> /sbin/mgetty
6. Feedback
-----------
Please use Debian's bug(1) utility to report problems.
--
Pavel Tcholakov <pavel@debian.org>
|