Professional Documents
Culture Documents
CONTENTS:
1.
2.
3.
4.
5.
building CUPS-PDF
setting up the PDF queue with CUPS
advanced configuration and multiple instances
note for MacOSX
contact
1. building CUPS-PDF
-------------------Edit src/cups-pdf.h if you do not like /etc/cups as location for your
configuration files.
To compile CUPS-PDF, invoke gcc in the src/ directory:
gcc -O9 -s -lcups -o cups-pdf cups-pdf.c
Note: you will have to have the deveopment package for CUPS installed
in order to build CUPS-PDF
To install the binary, simply copy cups-pdf to the backend directory
of CUPS (usually /usr/lib/cups/backend or /usr/lib64/...).
Now copy extra/cups-pdf.conf to /etc/cups (or whatever location you
selected in cups-pdf.h above). Here you can set all properties of
CUPS-PDF at runtime without the need for restarting any services.
(The defaults should work fine on most systems.)
If you want to use the color PostScript driver that comes with
CUPS-PDF go to the extra/ subdirectory and copy CUPS-PDF_opt.ppd to
your CUPS model directory (usually /usr/share/cups/model [ /Generic ] ).
If you do not want to set any options via PPD (see section 3), use
CUPS-PDF_noopt.ppd instead.
2. setting up the PDF queue with CUPS
------------------------------------Important notes:
================
* CUPS-PDF requires root privileges since it has to modify file ownerships.
In order to ensure CUPS-PDF is running with the required root privileges
you have to make 'root' the owner of the cups-pdf backend and set the
file permissions of the backend to 0700 (root only).
NOTE: in older versions of CUPS (<1.2.0) you have to set the "RunAsUser"
option in cupsd.conf to "No" in order to grant full privileges.
* CUPS-PDF needs a fully featured UNIX-filesystem to work. Make sure if any
of CUPS-PDF's working directories (e.g. output) are located on an NFS
mounted volume they are mounted without root_squash! Other filesystems
(e.g. NetWare or Windows shares as well as NFSv4 with kerberos) are _not_
supported!
* CUPS-PDF is known to fail if the gs (GhostScript) binary on a system is
compressed by upx (Ultimate Packer for eXecutables).
* If you are using SELinux, AppArmour or similar tools, make sure these do
not interfere with CUPS-PDF.
(You can disable SELinux for CUPS by "setsebool -P cupsd_disable_trans 1"