docs/textdocs/Faxing.txt

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