summaryrefslogtreecommitdiffstats
path: root/QuickInst
blob: 2ede0f7bfc80329ff0ff6718b0750d6d4e2f32b6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
Quick installation instructions:

* Run "configure".  If you want to put the files in any other directory
  tree than /usr/local (i.e. /usr/local/bin, /usr/local/man) then call
  it with the option --prefix=<directory-prefix>, for example:

	./configure --prefix=/usr

  See the file INSTALL for more information.

* Run "make".

* Run "make install".

* If you want to install all the sample printer filters (there are 40
  of them in the 1.1 release) then do "make install_filters".
  Otherwise pick the one(s) you want from the "filters" directory and
  put them in the appropriate location.  Make sure they are executable
  (they can be considered "scripts", with magicfilter being the interpreter.)

-----------------------------------------------------------------------------

The following instructions apply only to systems using the BSD
printing system.  Linux and BSD-derived OSes all use the BSD printing
system, some System V-based systems such as IRIX do as an option
whereas others, such as Solaris, do not.

If in doubt, check for the existence of the file /etc/printcap.

NOTE: The standard BSD print daemon does *not* support filters for
remote printers, hence the instructions below apply only to systems
which have the printers physically attached.  A version of lpd which
does not have this problem is available as a part of the LPRng package
from ftp://dickory.sdsu.edu/pub/LPRng/.  To use filters with remote
printers for LPRng, specify the "bqfilter" flag in /etc/printcap, for
example:

  # Remote HP LaserJet 4 (possibly connected via built-in Ethernet)
  remoteprinter:\
	:lp=:rm=printserver:rp=remoteprinter:\
	:sd=/var/spool/lpd/remoteprinter:\
	:bqfilter:mx#0:\
	if=/usr/local/bin/ljet4-filter:

-----------------------------------------------------------------------------

* Edit your /etc/printcap file to contain a call to the appropriate
  printer filter in the "if" entry of each local printer.  This will
  typically look something like this:

  pencil|lp|PostScript|ljet4|HP LaserJet 4:\
	:lp=/dev/lp1:sd=/var/spool/lpd/pencil:sh:mx#0:\
	:if=/usr/local/bin/ljet4-filter:

  crayon|dj550c|color|HP DeskJet 550C:\
	:lp=/dev/lp2:sd=/var/spool/lpd/crayon:sh:mx#0:\
	:if=/usr/local/bin/dj550c-filter:

  Note the alias "lp" for the default (text) printer, and "PostScript"
  for the preferred PostScript printer.

  IMPORTANT: If you're on a really old version of UNIX which doesn't
  support the so-called "#!-hack" for selecting an interpreter for
  your filters, this form of installation does not work.  Instead, you
  need to make your /etc/printcap file look something like this:

  pencil|lp|PostScript|ljet4|HP LaserJet 4:\
	:lp=/dev/lp1:sd=/var/spool/lpd/pencil:sh:mx#0:\
	:if=/usr/local/bin/magicfilter:\
	:af=/usr/local/bin/ljet4-filter:

  To test if your OS supports the #!-hack, type at the command line:

	/usr/local/bin/XXXX-filter < /dev/null

  ... where XXXX-filter is any installed magic filter.  If you get an
  error message, your OS does *not* support the #!-hack.

  Linux, all BSD-derived OSes and System V R3 and later all support
  the #!-hack.

* Kill and restart lpd.  Your printer filter should now be working.