mirror of
https://git.FreeBSD.org/ports.git
synced 2024-10-24 21:01:20 +00:00
5915f2992d
A new import based on Sam Leffler's Hylafax V3.0pl0. Flexfax is now obsolete. Import includes & applies the base patch Sam posted on the flexfax mail list (mail list is still called flexfax, though the package is called Hylafax). Sam declared our ports/comms/flexfax to be obsolete (over a year old). Sometime after the CD release, I will post a proposal to remove ports/comms/flexfax. I will maintain ports/comms/hylafax as I need fax capability. Thanks to Asami Satoshi for suggested improvements, I leave him to `bless' this port by adding the final comms/Makefile: SUBDIR += hylafax Until he does that, any mistakes I may have made shouldnt break any makes :-) I've undoubtedly screwed something up, somewhere, its a big port (30M inc bins),please test, Oh... and "Share & Enjoy" :-) --- Julian Stacey <jhs@freebsd.org> Tel. +49 89 268616. Fax Modem: 2608126 http://www.regent.e-technik.tu-muenchen.de/people/jhs.html
226 lines
9.0 KiB
Plaintext
226 lines
9.0 KiB
Plaintext
NOTES ON HYLAFAX IN FREEBSD (/usr/ports/comms/hylafax)
|
|
By Julian Stacey <jhs@freebsd.org> May 1995
|
|
|
|
This port replaces flexfax (which is over a year old).
|
|
Thanks to Sam Leffler of SGI for writing & releasing Hylafax :-)
|
|
I <jhs@freebsd.org> wrote the FreeBSD ports/comm/hylafax/* files,
|
|
|
|
Copyright Julian Stacey 1995:
|
|
Please preserve & comply with Sam Leffler's & SGI's legal stuff
|
|
I hereby release my work in this area for public use, & disclaim
|
|
all liability !
|
|
Leave my name intact please, I'm a freelance, publicity can be useful.
|
|
|
|
Documentation:
|
|
- On Line Manuals: man hylafax.
|
|
- World Wide Web site: (http://www.vix.com/flexfax/
|
|
- Source tree: Local copies of web in html & html/FAQ etc.
|
|
|
|
Mailing List for Support, Development etc:
|
|
Don't mail me your fax or modem problems, nor post Hylafax
|
|
software bugs & fax modem problems to a Freebsd mail list.
|
|
The correct mail list: flexfax@sgi.com
|
|
|
|
Patches:
|
|
Bug reports, accompanied by diff -c patches, will be reviewed &
|
|
commited to FreeBSD/ports).
|
|
|
|
Examples:
|
|
Syntax etc examples are in: config.jhs config.ttyd1.jhs etc.ttys.jhs
|
|
|
|
My Test Environment:
|
|
SupraFax V32bis + FreeBSD-2-current (May 1995)
|
|
|
|
Outstanding:
|
|
I'm not sure if the lock file scheme is OK
|
|
(It may be, I just used the default).
|
|
Some of the permissions are not right,
|
|
(sometimes I get many email acknowledgements for each fax
|
|
sent (but fax is only sent once, no horrendous phone bill
|
|
... yet ;-)
|
|
My faxgetty will not answer as a normal modem (maybe its the modem,
|
|
or maybe my config file is wrong).
|
|
|
|
---
|
|
Julian Stacey <jhs@freebsd.org> Tel. +49 89 268616. Fax Modem: 2608126
|
|
http://www.regent.e-technik.tu-muenchen.de/people/jhs.html
|
|
Vector Systems Ltd: an Internet, Unix & C consultancy in Munich Germany
|
|
|
|
Appended are some example Config files:
|
|
|
|
etc.ttys
|
|
{-------
|
|
ttyd1 "/usr/local/sbin/faxgetty" vt100 on unsecure
|
|
-------}
|
|
|
|
config
|
|
{-------
|
|
LogFacility: daemon
|
|
CountryCode: 49
|
|
AreaCode: 89
|
|
LongDistancePrefix: 0
|
|
InternationalPrefix: 00
|
|
DialStringRules: etc/dialrules.europe
|
|
ServerTracing: 1
|
|
MaxSendPages: 20
|
|
-------}
|
|
|
|
config.ttyd1
|
|
{-------
|
|
# /var/spool/fax/etc/config.ttyd1 by jhs@freebsd.org
|
|
# from $Header: /usr/people/sam/fax/config/RCS/rockwell,v 1.25 1995/03/10 23:36:02 sam Exp $
|
|
# this file documented in man config
|
|
|
|
# Sam says:
|
|
# {
|
|
# If you stop faxq then faxd.recv will remove the job itself;
|
|
# otherwise if it sees faxq is running it passes the remove request on and
|
|
# assumes the task was completed (there is no acknowledgement).
|
|
|
|
# ServerTracing so that tracing messages are not sent out (listed in the
|
|
# TODO file, a fix is welcome). If you think this might be happening, try
|
|
# echo "CServerTracing: 0x201">/var/spool/fax/FIFO
|
|
# to force faxq to reset the current value for ServerTracing.
|
|
# }
|
|
|
|
# Configuration for a Rockwell-based Class 2 modem.
|
|
# Boca M1440E firmware V1.270 or newer
|
|
# Dallas Fax (throw it away!)
|
|
# Hayes Optima 24+Fax96 firmware TR00-J260-001 XXX or newer
|
|
# SupraFAX v.32bis firmware V1.200-C or newer
|
|
# Twincom 144/DF firmware revision V1.200 or newer
|
|
# Dynalink 1414VE
|
|
# (and others)
|
|
|
|
# This configuration file sets up the modem to run at 19.2 for
|
|
# sending and for receiving. XON/XOFF flow control is used on
|
|
# the tty port. RTS/CTS can be used by switching the flow control
|
|
# setup, but beware of modems that do not support it during
|
|
# facsimile operations. Also beware that the adaptive-answer
|
|
# facility, when supported, is usually unreliable.
|
|
|
|
# AdaptiveAnswer boolean No enable adaptive answer of inbound calls
|
|
AdaptiveAnswer Yes
|
|
# AnswerRotary string Any alternatives for answering calls
|
|
# AnswerRotary "fax data"
|
|
# DestControls jhs set later see man destctrls
|
|
|
|
MaxDials 3 # max calls to transmit a job (presumably doing succesive pages)
|
|
# Wrong numbers cost me 23pf per fail, & earache to whoever answers the phone !
|
|
# MaxTries 3 # max attempts to transmit a job (3 default)
|
|
NoCarrierRetrys 0 # default 1 # number of times to retry dialing on ``NO CARRIER''
|
|
|
|
# JobReqBusy integer 300 requeue interval for BUSY dial result
|
|
|
|
MaxSendPages 20 # max pages to permit in a send
|
|
|
|
# jhs later QualifyTSI file of TSI patterns for qualifying senders
|
|
CountryCode: 49
|
|
AreaCode: 89
|
|
FAXNumber: +49.89.2608126 # also used to name session log file
|
|
LocalIdentifier: "+49 89 2608126"
|
|
LongDistancePrefix: 0
|
|
InternationalPrefix: 00
|
|
DialStringRules: etc/dialrules.europe
|
|
ServerTracing: 1
|
|
SessionTracing: 11
|
|
RecvFileMode: 0644 # if you have nosey users, consider 0600
|
|
LogFileMode: 0644 # make it 0600 if calling card access codes are logged
|
|
DeviceMode: 0600
|
|
RingsBeforeAnswer: 2
|
|
SpeakerVolume: medium
|
|
|
|
# Any appearance of ``%l'' is replaced with the tty name and any
|
|
# appearance of ``%s'' is replaced with the serial port speed (in decimal).
|
|
GettyArgs: "std.%s -" # "std.%s ttyd1" # default is "-h %l dx_%s"
|
|
# FreeBSD man getty says: getty [type [tty]]
|
|
# FreeBSD man login says: -h specifies host from which the connection received.
|
|
# kew@timesink.spk.wa.us (FreeBSD 2.1.0) uses "std.%s -".
|
|
|
|
TagLineFont: etc/lutRS18.pcf
|
|
# pre jhs default was TagLineFormat: "From %%l|%c|Page %%p of %%t"
|
|
# %c gives American-only date format, which is confusing in Britain or Germany
|
|
# so I use international accountancy date format: (19)95 08 01 (ie 1st Aug)
|
|
# I use no words in my tag line, as fax may be in German or English.
|
|
#---
|
|
# allow at least 4 spaces before VSL as PCS fax chops left margin
|
|
# dont actually use space char, as entabbing this file will lose it all
|
|
# dont put too much in any one field or will overprint
|
|
# %%l takes LocalIdentifier
|
|
# %%n sender fax ie +49.89.2608126
|
|
# %%d target fax ie +498968004525, from sendfax -d gary@68004.525
|
|
# %%p page number inc. cover sheet
|
|
# %%t total pages inc. cover sheet
|
|
# jhs created `pages' symbol (\241 dec161 xa1) in lutRS18.pcf
|
|
# jhs created `phone' symbol (\244 dec164 xa4) in lutRS18.pcf
|
|
# `phone' & `pages' are inspired by symbols that pcs fax machine prints
|
|
# PCS FAX is "Canon Fax 280" Model H11232, + H11 2325 + HA2 1324, REN=3
|
|
TagLineFormat: "Fax %%n|Tel \244 +49 89 268616|\241 %%p/%%t %Y:%m:%d %H:%M"
|
|
|
|
# MaxRecvPages: unlimited
|
|
|
|
# Modem-related stuff: should reflect modem command interface
|
|
# and hardware connection/cabling (e.g. flow control).
|
|
|
|
ModemType: Class2 # use class 2 interface
|
|
ModemRate: 19200 # fax send&recv is locked at 19.2
|
|
ModemFlowControl: xonxoff # default
|
|
|
|
ModemResetCmds: AT&F2 # what you want for a Supra # JJ I have not checked operation since enabling this
|
|
ModemNoFlowCmd: AT&K # disable flow control cmd
|
|
ModemHardFlowCmd: AT&K3 # hardware flow control cmd
|
|
ModemSoftFlowCmd: AT&K4 # software flow control cmd
|
|
ModemSetupDTRCmd: AT&D3 # DTR off causes modem to reset
|
|
#ModemSetupDTRCmd: AT&D2S25=1S38=0 # Dynalink 1414VE needs this
|
|
ModemSetupDCDCmd: AT&C1 # DCD follows carrier
|
|
ModemSetupAACmd: AT+FAA=1+FCLASS=0 # enable in current class
|
|
# FAQ says: AT+FAA=1 Auto answer as facsimile or data depending on call
|
|
|
|
ModemSendFillOrder: LSB2MSB # as expected
|
|
ModemRecvFillOrder: MSB2LSB # opposite of what makes sense
|
|
|
|
ModemDialCmd: ATDT%s@ # T for tone dialing, @ for silence
|
|
|
|
# Caller ID configuration setup for Supra.
|
|
|
|
# QualifyCID: etc/cid (off by default) CID access control list file
|
|
CIDNumber: "NMBR = " # pattern string for phone number info # JJ I have not checked operation since enabling this
|
|
CIDName: "NAME = " # pattern string for identity info # JJ I have not checked operation since enabling this
|
|
|
|
# DEFAULTS FOR REFERENCE
|
|
# ModemAnswerFaxCmd string ATA command for answering fax call
|
|
# ModemAnswerDataCmd string ATA command for answering data call
|
|
|
|
# Class1RecvIdentTimer
|
|
# The time, in milliseconds, to wait for an initial
|
|
# DCS when receiving a facsimile. CCITT recommenda-
|
|
# tion T.30 specifies this as the value of the T1
|
|
# timer. However, adaptive answering schemes such as
|
|
# that described above under the AdaptiveAnswer
|
|
# parameter may require that this timer be shortened.
|
|
# Class1RecvIdentTimer 35000 Class 1: max wait (ms) for initial ident frame
|
|
Class1RecvIdentTimer 12000
|
|
|
|
# Supra default wait for carrier is 50/10th sec, change with ats7=255
|
|
# Datatronic default wait for carrier is 45/10th sec.
|
|
# matthias says: config.ttyd1
|
|
#
|
|
# FaxT1Timer
|
|
# should not be changed without full understanding of the ... server.
|
|
# The value of the T1 timer in milliseconds. This
|
|
# timer is used to time out the initial session con-
|
|
# tact; i.e. receipt of DIS/DCS.
|
|
# FaxT1Timer 35000 CCITT T.30 T1 timer (ms)
|
|
#
|
|
# AdaptiveAnswer:
|
|
# Class1RecvIdentTimer should be set to a value that
|
|
# is shorter than FaxT1Timer.
|
|
# yet defaults for both are exactly the same: 35000 / 1000 sec.
|
|
|
|
UUCPLockDir /var/spool/lock # jhs added this after seeing where kermit created a lock.
|
|
UUCPLockType ascii # jhs added this after seeing what kermit created
|
|
# Note kermit -l /dev/supra created /var/spool/lock/LCK..supra
|
|
# (supra is a link to cua01, so the lock wont really work, as I'm running
|
|
# gettyfax on ttyd1.
|
|
-------}
|