docs/textdocs/Faxing.txt

   1                 F A X I N G   with  S A M B A
   2
   3 This text describes how to turn your SAMBA-server into a fax-server
   4 for any environment, especially for Windows.
   5    Author: Gerhard Zuber <zuber@berlin.snafu.de>
   6
   7 Requirements:
   8    UNIX box (Linux preferred) with SAMBA
   9    ghostscript package
  10    mgetty+sendfax package
  11    pbm package (portable bitmap tools)
  12
  13 FTP sites:
  14    mgetty099-May31.tar.gz
  15    I got it from: ftp://ftp.gwdg.de/pub/linux/misc/mgetty/mgetty099-May31.tar.gz
  16
  17
  18 making mgetty+sendfax running:
  19 ==============================
  20
  21    go to source tree: /usr/src/mgetty+sendfax
  22    cp policy.h-dist policy.h
  23
  24    change your settings: valid tty ports, modem initstring, Station-Id
  25
  26 #define MODEM_INIT_STRING       "AT &F S0=0 &D3 &K3 &C1\\\\N2"
  27
  28 #define FAX_STATION_ID  "49 30 12345678"
  29
  30 #define FAX_MODEM_TTYS  "ttyS1:ttyS2:ttyS3"
  31
  32    Modem initstring is for rockwell based modems
  33    if you want to use mgetty+sendfax as PPP-dialin-server,
  34    define AUTO_PPP in Makefile:
  35
  36 CFLAGS=-O2 -Wall -pipe -DAUTO_PPP
  37
  38    compile it and install the package.
  39    edit your /etc/inittab and let mgetty running on your preferred
  40    ports:
  41
  42 s3:45:respawn:/usr/local/sbin/mgetty ttyS2 vt100
  43
  44    now issue a
  45       kill -HUP 1
  46    and enjoy with the lightning LEDs on your modem
  47    your now are ready to receive faxes !
  48
  49
  50    if you want a PPP dialin-server, edit
  51       /usr/local/etc/mgetty+sendfax/login.config
  52
  53 /AutoPPP/ -     ppp     /usr/sbin/pppd auth debug passive modem
  54
  55
  56
  57 Tools for printing faxes:
  58 =========================
  59
  60    your incomed faxes are in:
  61     /var/spool/fax/incoming
  62
  63    print it with:
  64
  65      for i in *
  66      do
  67      g3cat $i | g3tolj | lpr -P hp
  68      done
  69
  70    g3cat is in the tools-section, g3tolj is in the contrib-section
  71    for printing to HP lasers.
  72
  73
  74
  75 Now making the fax-server:
  76 ===========================
  77
  78     fetch the file
  79        mgetty+sendfax/frontends/winword/faxfilter
  80
  81     and place it in
  82
  83       /usr/local/etc/mgetty+sendfax/
  84
  85     prepare your faxspool file as mentioned in this file
  86       /usr/local/bin/faxspool
  87
  88             if [ "$user" = "root" -o "$user" = "fax" -o \
  89                  "$user" = "lp" -o "$user" = "daemon" -o "$user" = "bin" ]
  90
  91     make sure you have pbmtext (from the pbm-package). This is
  92     needed for creaating the small header line on each page.
  93
  94     make sure your ghostscript is functional. You need fonts !
  95     I prefer these from the OS/2 disks
  96
  97
  98     prepare your faxheader
  99       /usr/local/etc/mgetty+sendfax/faxheader
 100
 101
 102     edit your /etc/printcap file:
 103
 104 # FAX
 105 lp3|fax:\
 106         :lp=/dev/null:\
 107         :sd=/usr/spool/lp3:\
 108         :if=/usr/local/etc/mgetty+sendfax/faxfilter:sh:sf:mx#0:\
 109         :lf=/usr/spool/lp3/fax-log:
 110
 111
 112
 113
 114     edit your /usr/local/samba/lib/smb.conf
 115
 116     so you have a smb based printer named "fax"
 117
 118
 119
 120 The final step:
 121 ===============
 122
 123     Now you have a printer called "fax" which can be used via
 124     TCP/IP-printing (lpd-system) or via SAMBA (windows printing).
 125
 126     On every system you are able to produce postscript-files you
 127     are ready to fax.
 128
 129     On Windows 3.1 95 and NT:
 130
 131     Install a printer wich produces postscript output,
 132        e.g.  apple laserwriter
 133
 134     connect the "fax" to your printer
 135
 136
 137     Now write your first fax. Use your favourite wordprocessor,
 138     write, winword, notepad or whatever you want, and start
 139     with the headerpage.
 140
 141     Usually each fax has a header page. It carries your name,
 142     your address, your phone/fax-number.
 143
 144     It carries also the recipient, his address and his *** fax
 145     number ***. Now here is the trick:
 146
 147     Use the text:
 148        Fax-Nr: 123456789
 149     as the recipients fax-number. Make sure this text does not
 150     occur in regular text ! Make sure this text is not broken
 151     by formatting information, e.g. format it as a single entity.
 152
 153     The trick is that postscript output is human readable and
 154     the faxfilter program scans the text for this pattern and
 155     uses the found number as the fax-destination-number.
 156
 157     Now print your fax through the fax-printer and it will be
 158     queued for later transmission. Use faxrunq for sending the
 159     queue out.
 160