hylafax - приём-отправка факсов под FreeBSD

Автор: lissyara.

    Встала необходимость сделать машинку, для приёма факсов. Вернее, машинка была - но под 2000 виндой, и работала она уже второй год. К данному моменту её колбасило уже неслабо - по нескольку раз в день висла. Посему решил перенести факс с неё (на неё ещё навесили Interbase и по с ней работающее - там клиенты конторы хранились), ибо явно глюкала из-за факсов. Насчёт операционки вопрос тоже не стоял - FreeBSD :). Порывшись в закромах, нашёл первый пенёк 166MMX, пару винтов на 3 и на 4 гига, 128 памяти. Сойдёт. Модемы (причём обязательно железные! Как вариант - софтверные на чипах от lucent - под них в портах есть дрова) взял со старой, на неё стояли неплохие 3com`овские модемы.
   Итого имеем два модема:


/usr/home/lissyara/>dmesg | grep "sio[0-9]" sio0: <3COM PCI FaxModem> port 0x6c00-0x6c07 irq 9 at device 8.0 on pci0 sio0: moving to sio4 sio4: type 16550A sio0: <3COM PCI FaxModem> port 0x7000-0x7007 irq 10 at device 9.0 on pci0 sio0: moving to sio5 sio5: type 16550A /usr/home/lissyara/>

Ну и соответственно два COM-порта, которыми они представлены в FreeBSD. Следующим вопросом встал софт. В инете нахваливали mgetty+sendfax, но мне оно как-то невштырило... По ходу дела наткнулся в рассылке FreeBSD обсуждение другой программы - hylafax, вот она-то и вштырила :) Конкретно мне функционала огромного не надо было - из того, что надо было прямо сейчас (модемы-то я уже снял со старой машины :)) - это чтобы принимало факсы и хотя бы складывало куда-то в удобоваримом формате. Дальше разберусь. Всё это было, причём насчёт дальнейших действий (старая машина слала факсы почтой) в программе уже были возможности - она сама могла отсылать факс, после получения. Итак, ставим:


/usr/home/lissyara/>cd /usr/ports/ /usr/ports/>make search name='hylafax' Port: hylafax-4.2.5 Path: /usr/ports/comms/hylafax Info: Fax software Maint: W.J.Zwart@NescioLudens.nl B-deps: afm-1.0 gawk-3.1.1_1 gettext-0.14.5_2 jpeg-6b_4 libiconv-1.9.2_2 tiff-3.8.2 R-deps: gawk-3.1.1_1 gettext-0.14.5_2 jpeg-6b_4 libiconv-1.9.2_2 tiff-3.8.2 WWW: http://www.hylafax.org/ Port: p5-Fax-Hylafax-Client-1.02 Path: /usr/ports/comms/p5-Fax-Hylafax-Client Info: A simple Perl client for the HylaFAX fax server Maint: tshadwick@oss-solutions.com B-deps: p5-Authen-SASL-2.10_1 p5-Digest-1.15 p5-Digest-HMAC-1.01 p5-Digest-MD5-2.36 p5-Digest-SHA1-2.11 p5-GSSAPI-0.23 p5-MIME-Base64-3.07 p5-Net-1.19,1 perl-5.8.8 R-deps: p5-Authen-SASL-2.10_1 p5-Digest-1.15 p5-Digest-HMAC-1.01 p5-Digest-MD5-2.36 p5-Digest-SHA1-2.11 p5-GSSAPI-0.23 p5-MIME-Base64-3.07 p5-Net-1.19,1 perl-5.8.8 WWW: http://search.cpan.org/dist/Fax-Hylafax-Client/ Port: tkhylafax-3.2b Path: /usr/ports/comms/tkhylafax Info: A tcl/tk interface to Sam Leffler's fax package Maint: ports@FreeBSD.org B-deps: R-deps: Xaw3d-1.5E_1 expat-2.0.0_1 fontconfig-2.3.2_5,1 freetype2-2.1.10_3 gawk-3.1.1_1 gettext-0.14.5_2 ghostscript-gnu-7.07_15 gsfonts-8.11_2 gv-3.6.1 hylafax-4.2.5 jpeg-6b_4 libdrm-2.0.2 libiconv-1.9.2_2 pkg-config-0.20_2 png-1.2.12_1 tcl-8.2.3_6 tiff-3.8.2 tk-8.2.3_5 xorg-libraries-6.9.0 WWW: /usr/ports/> /usr/ports/>cd /usr/ports/comms/hylafax /usr/ports/comms/hylafax/>make && make install && make clean

В процессе установки, программы вылезло такое окно, с требованием нажать "Enter":


Selecting default HylaFAX configuration parameters. Using uid uucp and gid dialer for controlling access to fax stuff. Using uid bin and gid bin for installing programs. Using LSB2MSB bit order for your i386 cpu. Looks like you need BSD getty support. Looks like /usr/libexec/getty is the program to exec for a data call. WARNING, no vgetty program found to handle a voice call, using /bin/vgetty. WARNING, no egetty program found, using /bin/egetty. Looks like you use ascii-style UUCP lock files. Looks like UUCP lock files go in /var/spool/lock. Looks like the gs imager package should be used. Looks like is the PostScript RIP to use. WARNING, no PostScript imaging program. No suitable PostScript imaging program was located on your system. This may be due to your not having Ghostscript installed or not having Ghostscript configured with the tiffg3 device driver. A default pathname will be used for the moment. You must correct this situation for the fax software to operate correctly. See the WWW documentation for information on building Ghostscript with the necessary TIFF driver. Setting the Fontmap path to Looks like font metric information goes in /usr/local/lib/afm. Looks like manual pages go in /usr/local/man. Looks like manual pages should be installed with bsd-source-cat. Press Return to Continue

Нажал, чё-то ещё поставилось, и вылезло про конфигурацию:


Setting the Fontmap path to Looks like font metric information goes in /usr/local/lib/afm. Looks like manual pages go in /usr/local/man. Looks like manual pages should be installed with bsd-source-cat. Press Return to Continue HylaFAX configuration parameters (part 1 of 2) are: [ 1] Directory for applications: /usr/local/bin [ 2] Directory for lib data files: /usr/local/lib/fax [ 3] Directory for lib executables: /usr/local/sbin [ 4] Directory for system apps: /usr/local/sbin [ 5] Directory for manual pages: /usr/local/man [ 6] Directory for HTML documentation: /usr/local/share/doc/hylafax [ 7] Directory for spooling: /var/spool/hylafax [ 8] Directory for uucp lock files: /var/spool/lock [ 9] Uucp lock file scheme: ascii [10] PostScript imager package: gs [11] PostScript imager program: /usr/local/bin/gs [12] Manual page installation scheme: bsd-source-cat [13] Default page size: North American Letter [14] Default vertical res (lpi): 98 Are these ok [yes]? HylaFAX configuration parameters (part 2 of 2) are: [15] Location of getty program: /usr/libexec/getty [16] Location of voice getty program: /bin/vgetty [17] Location of sendmail program: /usr/sbin/sendmail [18] Location of TIFF tools: /usr/local/bin [19] Location of SysV init scripts: [20] Location of SysV start scripts: dir_sysvinitstart_set_to_non_null_string [21] Location of SysV stop scripts: dir_sysvinitstop_set_to_non_null_string [22] Name of SysV start script: [23] Name of SysV stop script: [24] Init script starts faxq: yes [25] Init script starts hfaxd yes [26] Start old protocol: no [27] Start paging protocol: no Are these ok [yes]?

Со всеми предложенными параметрами я согласился, рассудив, что если что - потом руками в конфигах поменяю. После чего установка завершилась:


Hylafax was installed. You'll need manual configurations to actually activate it. Setting up: (for impatients) Invoke /usr/local/sbin/faxsetup, and answer the questions. Mostly, accepting the defaults should work well. When you are asked to specify the name of tty device, use "cuaa1" instead of "ttyd1". Otherwise it does not work well. Consult /usr/local/etc/rc.d/hylafax.sh.sample for startups. For accepting incoming FAX/data calls, modify /etc/ttys as below and send SIGHUP to init process: >cuaa1 "/usr/local/sbin/faxgetty" dialup on secure Documentation: On Line Manuals: man hylafax-client man hylafax-server World Wide Web site: http://www.hylafax.org/ ===> Compressing manual pages for hylafax-4.2.5 ===> Registering installation for hylafax-4.2.5 ===> SECURITY REPORT: This port has installed the following binaries, which execute with increased privileges. /usr/local/sbin/faxq /usr/local/sbin/faxgetty /usr/local/bin/faxalter /usr/local/bin/faxrm This port has installed the following files, which may act as network servers and may therefore pose a remote security risk to the system. /usr/local/sbin/hfaxd /usr/local/bin/faxmail (USES POSSIBLY INSECURE FUNCTIONS: mktemp) /usr/local/sbin/faxwatch /usr/local/bin/sendfax (USES POSSIBLY INSECURE FUNCTIONS: mktemp) /usr/local/bin/faxstat /usr/local/bin/faxalter /usr/local/bin/faxrm This port has installed the following startup scripts, which may cause these network services to be started at boot time. /usr/local/etc/rc.d/hylafax.sh.sample If there are vulnerabilities in these programs there may be a security risk to the system. FreeBSD makes no guarantee about the security of ports included in the Ports Collection. Please type 'make deinstall' to deinstall the port if this is a concern. For more information, and contact details about the security status of this software, see the following webpage: http://www.hylafax.org/

   Смотрим, какие порты у нас есть в системе:


/usr/home/lissyara/>ll /dev | grep ttyd crw------- 1 uucp wheel 0, 27 25 авг 09:05 ttyd4 crw------- 1 root wheel 0, 28 25 авг 09:04 ttyd4.init crw------- 1 root wheel 0, 29 25 авг 09:04 ttyd4.lock crw------- 1 root wheel 0, 33 25 авг 09:04 ttyd5 crw------- 1 root wheel 0, 34 25 авг 09:04 ttyd5.init crw------- 1 root wheel 0, 35 25 авг 09:04 ttyd5.lock /usr/home/lissyara/>

   После чего, в сооствествии с выданной в конце инсталляции инструкцией, правим файл /etc/ttys:


# Serial terminals # The 'dialup' keyword identifies dialin lines to login, fingerd etc. ttyd0 "/usr/libexec/getty std.9600" dialup off secure ttyd1 "/usr/libexec/getty std.9600" dialup off secure ttyd2 "/usr/libexec/getty std.9600" dialup off secure ttyd3 "/usr/libexec/getty std.9600" dialup off secure ttyd4 "/usr/local/sbin/faxgetty" dialup on secure ttyd5 "/usr/local/sbin/faxgetty" dialup on secure

   Для запуска всего этого хозяйства я ребутнулся (можно и иначе, руками например всё запустить, - но так надёжней), после чего проверяем - взлетело ли:


/usr/home/lissyara/>ps -ax | grep fax 487 ?? S 0:00,13 /usr/local/sbin/faxgetty ttyd4 488 ?? S 0:00,11 /usr/local/sbin/faxgetty ttyd5 509 p0 S+ 0:00,02 grep fax /usr/home/lissyara/>

   Можно запускать скрипт-конфигуратор:


/usr/home/lissyara/>/usr/local/sbin/faxsetup Setup program for HylaFAX (tm) 4.2.5. Created for i386-unknown-freebsd6.1 on Thu Aug 17 09:51:13 MSD 2006. Checking system for proper client configuration. Checking system for proper server configuration. Warning: /bin/vgetty does not exist or is not an executable program! The file: /bin/vgetty does not exist or this file is not an executable program. The HylaFAX software optionally uses this program and the fact that it does not exist on the system is not a fatal error. If the program resides in a different location and you do not want to install a symbolic link for /bin/vgetty that points to your program then you must reconfigure and rebuild HylaFAX from source code. Warning: /bin/egetty does not exist or is not an executable program! The file: /bin/egetty does not exist or this file is not an executable program. The HylaFAX software optionally uses this program and the fact that it does not exist on the system is not a fatal error. If the program resides in a different location and you do not want to install a symbolic link for /bin/egetty that points to your program then you must reconfigure and rebuild HylaFAX from source code. FATAL ERROR: /usr/local/bin/gs does not exist or is not an executable program! The file: /usr/local/bin/gs does not exist or this file is not an executable program. The HylaFAX software expects this program to exist and be in this location. If the program resides in a different location then you must either reconfigure and rebuild HylaFAX or override the default pathnames in the distributed software through one of the HylaFAX configuration files (consult the HylaFAX documentation). /usr/home/lissyara/>

   Облом... Чё такое этот /usr/local/bin/gs разобрался - конвертер из одного графического формата в другой. В портах их оказалось куча -


/usr/home/lissyara/>cd /usr/ports/print /usr/ports/print/>ll | grep ghos drwxr-xr-x 4 root wheel 512B Aug 30 14:28 ghostscript-afpl drwxr-xr-x 2 root wheel 512B Aug 30 09:24 ghostscript-afpl-nox11 drwxr-xr-x 4 root wheel 512B Aug 30 14:28 ghostscript-gnu drwxr-xr-x 3 root wheel 512B Aug 30 14:28 ghostscript-gnu-commfont drwxr-xr-x 2 root wheel 512B Aug 30 09:24 ghostscript-gnu-nox11 drwxr-xr-x 4 root wheel 512B Aug 30 14:28 ghostscript-gpl drwxr-xr-x 2 root wheel 512B Aug 30 09:24 ghostscript-gpl-nox11 drwxr-xr-x 3 root wheel 512B Aug 30 09:24 ghostview /usr/ports/print/>

   Я выбрал gnu`тый:


/usr/home/lissyara/>cd /usr/ports/print/ghostscript-gnu /usr/ports/print/ghostscript-gnu/>make && make install && make clean

   В процессе установки, вылезет такое окно с таким заголовком:


GNU Ghostscript driver configuration

   Я выбрал всё, кроме того что касается иксов и SVGA. GJ завершении установки снова запускаем конфигуратор, его листинг я не привожу, ибо практически всё по дефолту, тока спикер у модема включил (что кстати неподействовал - он почему-то в конфиг его записал как выключенный - пришлось руками поправить). Собственно, после этого факсы уже принимаются, и складываются в виде tif`ов. Надо заметить, что программа все свои данные и настройки хранит в директории /var/spool/hylafax/. Это, конечно всё хорошо, но требовалось чуть болей функционала, а конкретно - чтобы факсы отпралялись на почту. Для этого, кладём файлик с таким содержимым:
/var/spool/hylafax/etc/FaxDispatch


FILETYPE=tif; SENDTO=fax@my-domain-name.su;

после чего немного подправим файл альясов (я оставил дефолтовый sendmail на машине, ибо у неё только функционал факса и навешивать что-то иное не вижу смысла) до такого состояния (это последние строки):


/usr/home/lissyara/>tail -3 /etc/mail/aliases FaxMaster: fax@my-domain-name.su root: admin@lissyara.su /usr/home/lissyara/>

   Всё. Факсы приходят на почту, и всем щассье :)).


P.S. Я пробовал играться с форматами - остановился именно на дефолтовом tif - наилучшее качество. Также, планирую расширить функционал - нужен релей - почта->факс, но это попозже, когда время будет.

P.S.2 Счастливым обладателям винмодемов (/usr/ports/comms/ltmdm/) посвящается :)
Огрёб и я такую штутку - вернее попросили настроить. 2 часа плясок с бубном над этой железкой:


ltmdm0: <Lucent Winmodem> port 0x9000-0x9007,0x9400-0x94ff mem 0xe4000000-0xe40000ff irq 18 at device 0.0 on pci1 ltmdm0: [GIANT-LOCKED] ltmdm0: type Virtual 16550A

ltmdm0@pci1:0:0: class=0x078000 card=0x044011c1 chip=0x044011c1 rev=0x01 hdr=0x00 vendor = 'Lucent/Agere Systems (Was: AT&T MicroElectronics)' device = 'LT Winmodem 56k Data+Fax+Voice+DSVD' class = simple comms

   Устройство будет называться не ttyd0 а cual0...


размещено: 2006-09-01,
последнее обновление: 2007-07-17,
автор: lissyara

  Этот информационный блок появился по той простой причине, что многие считают нормальным, брать чужую информацию не уведомляя автора (что не так страшно), и не оставляя линк на оригинал и автора — что более существенно. Я не против распространения информации — только за. Только условие простое — извольте подписывать автора, и оставлять линк на оригинальную страницу в виде прямой, активной, нескриптовой, незакрытой от индексирования, и не запрещенной для следования роботов ссылки.
  Если соизволите поставить автора в известность — то вообще почёт вам и уважение.

© lissyara 2006-10-24 08:47 MSK