- new faxing doc from Gerhard Zuber <zuber@berlin.snafu.de
[kai/samba.git] / 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