home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume24 / faxpax / part04 / Readme next >
Encoding:
Text File  |  1991-03-12  |  6.8 KB  |  140 lines
  1. This  is   faxpak   [Copyright   (C)   1991   klaus   schallhorn,
  2. klaus@cnix.uucp]
  3.  
  4. faxpak currently runs on Suns only - not because it uses any spe-
  5. cial  SunOs features, but because I don't have access to anything
  6. else. I developed faxpak mainly on a 4/60, then  moved  it  to  a
  7. 3/60 that does all our spooling.
  8.  
  9. Apart from [temporary] hardware and  typeface  restrictions  [see
  10. below]  faxpak is quite flexible. It allows faxes to be sent from
  11. any networked machine. It allows aliases and distribution  lists.
  12. Entries  in  such  lists needing a special "for the attention of"
  13. string are forked out as separate jobs.  If you have more than  1
  14. fax  modem,  faxpak  automatically  shares the load between these
  15. modems. This includes splitting of batches to distribution  lists
  16. into several queues.
  17.  
  18. faxpak enforces permissions. You can set faxpak up to send  local
  19. faxes  any  time, long distance ones and international ones to be
  20. sent at cheap rates only. You can enforce the sending of faxes to
  21. any  given  phone  number at fixed times. And you can permit some
  22. users to override these time restrictions.
  23.  
  24. faxpak was created when the post office  increased  our  contract
  25. postage rates to an almost insane level. We therefore decided [as
  26. a small publishing house] to  deliver  our  newsletter  by  other
  27. means.  We  now  deliver  by mail(1) to subscribers' mailboxes at
  28. various online and video text systems, we allow direct modem con-
  29. nection to mbox [our 3/60] and we fax our newsletter.
  30.  
  31. faxpak is used for oneoff faxes [and only if I can't email],  and
  32. has  been  used  three  times  [we  publish every other week] for
  33. batches of ~150 faxes @ five pages each to our  subscriber  list.
  34. Batches of this size take a good two nights to send out, although
  35. the pure transmission time is just under 12 hours  [the  rest  is
  36. engaged  phone lines, repeats because transmission errors, logins
  37. sneaking in on the faxmodems, etc].
  38.  
  39. faxpak currently supports touchbase's 2496 fax modem  and  others
  40. that  use  or emulate the sierra type fax chipset, such as zoom's
  41. mx 2400s. Early december I found someone willing  and  supposedly
  42. able  to ship a beta class2 modem. Unfortunately it seems to have
  43. been sent by bicycle.  It's supposed to be here "real soon now".
  44.  
  45. For this reason faxpak does [not yet] support other  modems,  nor
  46. does it allow incoming faxes.
  47.  
  48. Because of the peculiarities of the modems we use  faxpak  is  by
  49. far   not   what  I  wanted.  It  now  works,  but  incorporating
  50. postscript, TeX or other files has been delayed.
  51.  
  52. Porting  faxpak  to  other  platforms  should  be  easy.  Writing
  53. wiring.c  was  supposed  to  be  easy  as well. Provided you have
  54. hardware flow control, it will be easy, however. I have not  been
  55. able  to  use XON/XOFF flow ctl under SunOs, although initial and
  56. parallel development under msdos showed xonoff to work  there.  I
  57. don't  know  why it doesn't under SunOs. There's some interesting
  58. reference to a change to STREAMS and xon/xoff flow ctl  in  SunOs
  59. 4.1  in  the  user  manual for a CoALM Sbus card I just received.
  60. I've done printer drivers and a terminal emulator using xonoff in
  61. the  past  and  using SunOs, though, so I assume the modem has to
  62. take a large part of any blame.
  63.  
  64. Just to show you how "strange" the sierra type modems  are,  con-
  65. sider  incoming faxes: you have to check [for each incoming byte]
  66. whether carrier is high or low in order  to  distinguish  whether
  67. the  byte  received  is  fax data or some command or confirmation
  68. from the modem.
  69.  
  70. Similar problems were encountered with sending faxes.  You  first
  71. talk  to  the  fax modem @ 2400 baud, change to 19200, then dial,
  72. and wait either for an XON [if using xonoff] or  for  CTS  to  go
  73. high,  before  you  [in the case of xon/xoff enable flow ctl and]
  74. start squirting data. Between pages you turn  off  flow  control,
  75. only to re-enable it for the next page. Weird.
  76.  
  77. You could, of course, write a special  device  driver  to  handle
  78. this  [but  then you could have hardware dependencies in any pro-
  79. gram], or you could take a black box approach, as  some  vendors'
  80. tech  reps  seemed  to  slip: using a pc type mother board with a
  81. large buffer and a fax card built on top.
  82.  
  83. If you look at wiring.c you'll find that I  left  some  stubs  in
  84. there  for using xonoff. Please don't tell me "xonoff flow ctl is
  85. easy, it's done in such and such a way" unless you get it to work
  86. with a sierra type modem. I found that the modem dropped the line
  87. when I was using xonoff, or that the  remote  fax  machine  timed
  88. out. Both not very useful.
  89.  
  90.  
  91. As far as I know touchbase's 2496 does not yet come officially as
  92. a  sierra type modem, although I bought their programmer's kit in
  93. Nov '90.  This kit [about $100 on top of the  modem  price],  for
  94. which  you have to sign a non disclosure agreement, consists of a
  95. [ccitt implementing] t.30 prom, a document virtually identical to
  96. the    "writefax.man"   document   posted   by   Nick   Pemberton
  97. [nick@aimed.uucp] in message 8658@aimed.uucp on Dec  8th  '90  in
  98. alt.fax  and  other groups and a reprint of the t.4 file compres-
  99. sion specs. Nick told me that he  downloaded  the  document  from
  100. Zoom's  bulletin  board.  I enclose Nick's answer, in case you're
  101. interested in that bbs.
  102.  
  103. I decided to base faxpak on the publicly available  document.   I
  104. have  ignored  as  non existent features offered by the touchbase
  105. 2496 but not mentioned in the public document. If I  ever  wanted
  106. to be tied down, I wouldn't use a modem.
  107.  
  108. Apart from that, zooms fax modem is supposed to be selling at $99
  109. [Direct  Micro,  1-800-288-2887  or  614-771-8771],  which is, as
  110. mathemagical minded fellow administraters will observe,  somewhat
  111. less  than  the price for the touchbase upgrade alone. JDR Micro-
  112. devices sells a 4800 baud fax modem for about $120. You're  bound
  113. to find quite a few more by investing in a copy of Byte.
  114.  
  115. The difficulties in getting faxpak to work reliably are the  rea-
  116. son  why  faxpak's  output  is limited. Being more concerned with
  117. getting output at all the next stage  obviously  is  getting  the
  118. output  nicer.  faxpak  currently supports only its default fonts
  119. [they're enclosed compressed && uuencoded], and hp laserjet  type
  120. fonts  [max  30 points], which are scaled to size on the fly [and
  121. they're not pretty at low resolution].
  122.  
  123. Over the next few weeks I plan to improve on this, and I plan  to
  124. clean  up spool.fax.c, which has become somewhat incomprehensible
  125. by the last minute addition of the "ftao" string feature  [origi-
  126. nally  I  assumed  someone  claiming fax receive capability would
  127. have his own fax machine].
  128.  
  129. faxpak includes source, FaxConfig [which builds char  set  depen-
  130. dent   font  sets  for  high  and  low  resolution,  faxconfig.h,
  131. fax.config, Makefile, and fax.1].
  132.  
  133. Because cnix was down for 6 days I'm going to finish this off  by
  134. just  adding  a  file Howto.Install.  fax.8 pages will be done at
  135. some time in the future - but then, a lot of things will be.
  136.  
  137. Enjoy.
  138.  
  139. klaus
  140.