mgetty.txt

   1 AUTHOR:                 Dr. Edgar Alwers  <edgaralwers@gmx.de>
   2
   3 DATE:                   2010-04-12
   4
   5 LICENSE:                GNU Free Documentation License  Version 1.2
   6
   7 SYNOPSIS:               How to install mgetty+sendfax from sources
   8
   9 DESCRIPTION:
  10
  11 Compilation and Installation of mgetty+sendfax from the sources.
  12 Faxes may be send direct from the PC by running  first "faxspool" and then
  13 "faxrunq".  Documents may be queed  from the editor (e.g. StarOffice ) to the
  14 fax-queue  and then sent with "faxrunq"
  15
  16 PREREQUISITES:
  17
  18 Basic knowledge in compiling programs. Should run on all LFS versions. This update was tested with LFS 6.5 and BLFS Version svn-20100411.
  19
  20 HINT:
  21
  22 Download:
  23
  24         mgetty1.1.36-Jun15.tar.gz
  25         ftp://alpha.greenie.net/pub/mgetty/source/1.1
  26
  27         Netpbm (image manipulation/conversion graphics utilities ) netpbm-10.35.74.tgz
  28         March 24, 2010, super stable.
  29         http://sourceforge.net/projects/netpbm
  30
  31         GPL ghostscript-8.71.tar.gz
  32         ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/GPL/gs871/ghostscript-8.71.tar.gz
  33
  34
  35 Installing GPL Ghostscript:
  36
  37 ( see also BLFS Book version svn-20100411 chapter 39, printing )
  38
  39 Untar
  40         tar xvjf ghostscript-8.71.tar.gz
  41 and change to the ghostscript-8.71 directory
  42         cd ghostscript-8.71
  43 Run configure:
  44         ./configure --prefix=/usr --enable-dynamic
  45 Then run
  46         make
  47         make install docdir=/usr/share/doc/ghostscript-8.71
  48 You  may also need to download the ghostscript fonts. Get them from
  49         http://downloads.sourceforge.net/gs-fonts/
  50 Download "ghostscript-fonts-std-8.11.tar.gz" to the directory
  51         /usr/X11R6/lib/X11/fonts/ghostscript. GPL looks in /usr/share/ghostscript for the fonts. So you will need in /usr/share/ghostscript a link:
  52         ln -s /usr/X11R6/lib/X11/fonts/ghostscript/fonts fonts
  53 Untar
  54         tar xvzf ghostscript-fonts-std-8.11tar.gz
  55
  56 Installing netpbm's utility \x1cpbmtext\x1d:
  57
  58 Faxspool will only need the text of the pixel converter \x1cpbmtext\x1d:
  59
  60 Untar the file with
  61         tar xvzf netpbm-10.35.74.tgz
  62 and change to the netpbm-10.35.74 directory
  63         cd netpbm-10.35.74
  64
  65 run the configure file:
  66         ./configure
  67 and answer the questions as follows:
  68         platform:                                       gnu
  69         regular or merge build                  regular
  70         libnetpbm                                       static
  71         headerfile that defines wint32_t etc            </inttypes.h>
  72         JPEG library                                    none
  73         TIFF library                                    none
  74         Z library                                       none
  75         X11 library                                     /lib/X11R6/lib/libX11.so
  76         X11 interface headers                           default
  77         Svgalib library                                 libvga.so
  78         Svgalib header directory                        default
  79         Documentation URL                               http://netpbm.sourceforge.net/doc
  80
  81 You may change the resulting Makefile.config, if necessary. Change to the directory \x1cgenerator\x1d:
  82         cd generator
  83         make pbmtext
  84 and finally copy the executable to the bin directory:
  85         cp pbmtext /usr/local/bin
  86
  87 Installing mgetty:
  88
  89 Untar
  90         tar xvzf mgetty1.1.36-Jun15.tar.gz
  91 and change to the directory  mgetty-1.1.36:
  92         cd mgetty-1.1.36
  93 Copy the file "policy.h-dist" to "policy.h":
  94         cp policy.h.dist policy.h
  95 Edit the Makefile and change line 167 from
  96         INSTALL=install -c -o bin -g bin
  97 to
  98         INSTALL=install -c -o root -g root
  99 Change line 176 to "prefix=/usr"
 100 edit the next lines according to your needs or accept the suggestions in the Makefile.
 101
 102 mgetty needs a user "fax". So, if "fax" does not exist, create it with
 103         useradd -D
 104 Run make and make install.
 105
 106 Change to the directory  /usr/etc/mgetty+sendfax:
 107         cd /usr/etc/mgetty+sendfax
 108 and edit the file sendfax.config. Change the line \x1cwhich devices to use for
 109 outgoing faxes\x1d from
 110 \x1cfax-devices tty4c:tty4d\x1d to
 111 \x1cfax-devices ttyS0:ttyS2\x1d
 112 and the line \x1cwhich fax number to transmit to the receiving station\x1d from
 113 \x1cfax-id 49 115 xxxxxxxx\x1d into your own fax line number. Edit the dial-prefix
 114 line  e.g. in
 115         dial-prefix ATDT.
 116
 117 Uncomment the line \x1cport ttyS0\x1d, if this is the port of your modem.
 118 You might need also a modem initialisation string. I inserted
 119         modem-init ATS7=255
 120 You might edit the file "faxheader" in the same directory.
 121 Finally, you should create and edit a file "fax.allow" or "fax.deny" in the same
 122 directory, to define access control for users other than root.
 123
 124 Testing faxspool:
 125
 126 You are now ready to run a first test with faxspool. With your prefered
 127 editor    ( vi ? ), create  a file \x1ctest.txt\x1d and then run ( as user )
 128
 129         faxspool    123456 /your/directory/test.txt
 130 where "123456" stands for the telefon number of a fax receiver.
 131 You can have a look at the fax file in the converted g3 format with Okular
 132  The fax image is stored in /var/spool/fax/outgoing
 133
 134 Fax spooling from StarOffice7:
 135
 136 Open \x1cspadmin\x1d in StarOffice7's directory, choose \x1cnew printer\x1d -> \x1cconnect a fax device\x1d -> \x1cdefault driver\x1d and enter the command \x1cfaxspool (PHONE) (TMP)\x1d in the corresponding window.
 137
 138 If you are using a recent version of gcc, e.g. 4.4.2, you may get an error \x1c...staroffice/program/libgcc_s.so.1: version 'GCC_4.2.0' not found ( required by /usr/lib/libstdc++.so.6 ) \x1c when testing to send a fax. In this case, you should exchange the old libgcc_s.so.1 library in /home/user/staroffice7/program/ by the new one in  /usr/lib.
 139
 140 Print a job to the fax printer, and a window will pop up, asking for the fax number. That's all.
 141
 142 Sending Faxes:
 143
 144 run -as root - "faxrunq"
 145
 146 LITERATURE      :
 147
 148 Gert Doering: mgetty+sendfax manual
 149
 150 ACKNOWLEDGEMENTS:
 151
 152 This hint is now much simpler thanks to advises given by Akira F. Urushibata,  "Prophet of the Way", long time contributor of \x1cNetpbm\x1d. Also the executable of Netpbm is now much smaller.
 153
 154 CHANGELOG:
 155
 156 [2003-10-13]
 157
 158 Changed hint to new format. Some minor adjustments. Changed versions of mgetty, netpbm and ESPG Ghostscript
 159 [2004-08-24]
 160
 161 Changed versions of mgetty and ESPG Ghostscript. Programs placed under /usr and not under /usr/local. Changed download-URL's.Changed configuration commands.
 162 [2005-04-16]
 163
 164 Changed versions of mgetty and netpbm. New LFS and BLFS books for kernel 2.6.8 architecture
 165 [2007-01-20]
 166
 167 Changed versions of mgetty and netpbm. New LFS and BLFS books for kernel 2.6.18 architecture. Changed procedures for the build of Netpbm.
 168 [2010-04-12]
 169
 170 Changed versions of mgetty and netpbm. New LFS and BLFS books. Kernel 2.6.33.1. New ghostscript package. Runs under KDE-4.4.1