summaryrefslogtreecommitdiff
path: root/comms/hylafax/files/README
blob: a979996b61d8d41833f7c09a58ae02df546cd6e7 (plain) (blame)
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
	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.
-------}