Penguin
Note: You are viewing an old revision of this page. View the current version.

Printing to PDF

If you have an application that can't output natively to PDF, you can create yourself a PDF printer.

  1. Get the backend for it - look for PDF Distiller Script from http://printing.kde.org/downloads/
  2. Install this as 'pdf' in /usr/lib/cups/backends, and set it world executable.
  3. You may need to restart CUPS (e.g. on RedHat systems run 'service cups restart')
  4. You probably need GhostScript installed (try looking for a package called gs-common) for ps2pdf(1).
  5. Add a printer, either using the web interface (http://localhost:631/), XimianDesktop's printer interface, or the command line:
lpadmin -p PDFcreator -v pdf:/home/chris/PDFfiles -E -P /path/to/distiller.ppd

You can use any "raw" ppd you want really - I used the Raw/Raw (en) option in the installer, and it worked fine. You can download a color postscript ppd file from the cups-pdf site.

Create the printer with the URI of pdf:/where/you/want/the/output.

Easy as that. Then you can set Samba up to print to this printer via CUPS.

There are some notes on how this can be used with Samba to email PDFs to you on the SambaPDFPrinter page (Which also has a PDF Printer setup for LPRng).

There is also a cups-pdf virtual backend which can be used to print to pdf from cups. Your distribution should distribute this - for example, Debian (Sarge or Sid) users can "apt-get install cups-pdf".


Cups and SAMBA

See the SambaPrinting page for more information


Auto-discovery of printers

CUPS can do broadcasts over a network to both advertise the availability of local printers as well as to find and "proxy" for remote printers. On a LAN this is probably what you want, but if you are on the MetaNet this may result in other people seeing your printers, and you seeing theirs. This can have unpleasant side-effects: for example, my cups found remote printers that were later firewalled/disconnected or removed. Later that day when starting a GNOME application, it would hang on start-up as the gnome printing backend tried contacting the remote printers which were now un-contactable.

Anyway, the lesson is to edit cupsd.conf to disable this. (This is in the /etc/cups/ directory in Debian and RedHat.) Either disable browsing completely by adding the line
Browsing off

Or set the network/address mask for the BrowseAllow/BrowseDeny variables (for incoming broadcasts) and BrowseAddress (for outgoing broadcasts). Debian Woody defaults to browsing on, accepting incoming information from anywhere and not sending out any information.


Using Netatalk2 with cups

With the release of sarge, debian are now using automatic cups stuff, rather than the old lpr support.

This means you cannot just use the old papd.conf and hope it works. You'll get such wonderful things as it simply disapearing, and not removing the pid file, without any errors. Lovely thing that.

So, you'll need to do a few things.

Cups broadcasting is great, however, it's not always as great as it would seem. It can (and will in our case) pick up other cups broadcasted printers. You need to disable the reception of these printers in your config otherwise pap can also die.

EG:

in /etc/cups/cupsd.conf find the browse section, and add in, something much like the following:

#Allows browsing from the local network
BrowseAllow 192.168.2.0/24
#Disables printer broadcast from backup server
BrowseDeny 192.168.6.10/255.255.255.255

Make sure you have:

BrowseOrder allow,deny

Set as well.

Once this is done, edit <tt>/etc/netatalk/papd.conf<tt>, and add:

cupsautoadd@yourzonehere:op=root:

This will automatically get the cups printers, and use the ppd that cups uses.

if pap is not running, either restart netatalk in the normal way, just type papd, which starts it, uses the config, and inserts a pid file.

The logs should show something like:

Jul 15 12:13:23 host papd[16668]: restart (2.0.2)
Jul 15 12:13:23 host papd[16668]: CUPS support enabled (1.1)
Jul 15 12:13:30 host papd[16668]: Authentication disabled: SharpC150
Jul 15 12:13:30 host papd[16668]: register SharpC150:LaserWriter@zone1
Jul 15 12:13:36 host papd[16668]: Authentication disabled: hplj4-letterhead
Jul 15 12:13:36 host papd[16668]: register hplj4-letterhead:LaserWriter@zone1
Jul 15 12:13:42 host papd[16668]: Authentication disabled: hplj4
Jul 15 12:13:42 host papd[16668]: register hplj4:LaserWriter@zone1
Jul 15 12:13:48 host papd[16668]: Authentication disabled: hp8100
Jul 15 12:13:48 host papd[16668]: register hp8100:LaserWriter@zone1
Jul 15 12:13:54 host papd[16668]: Authentication disabled: hp5000
Jul 15 12:13:54 host papd[16668]: register hp5000:LaserWriter@zone1

The only error I have so far encountered, is this:

can't register SharpC150@greed:LaserWriter@zone1
Jul 15 11:24:08 host papd[7929]: Deleting CUPS temp PPD file for SharpC150_greed (/var/spool/cups/tmp/42d6f4186a35b)

This was because it was a broadcast printer, and cups didn't have a local copy of its ppd. THis is why I recommend disabling cups broadcast receive (send is fine) using BrowseDeny.

It is also possible to setup netatalk to use the cups printers, but add your own settings. I won't go into much detail due to lack of time, however,

If for example, you wanted to add a cups printer, with a different zone, and maybe running as a different user, you would enter into papd.conf:

hp5000-test2@another zone:\                        - This is the printername that will be broadcast
       :pr=hp5000:\                                - This is the cups printer that will be used (opt)
       :pd=/usr/share/lib/ppd/anotherdriver.PPD:   -The ppd you want to use (opt)

opt= optional. space constraints.

Setting up a USB printer

These are just some observations of what I did to set up a Brother HL 1440 laser printer (using the USB port) on a machine that already had CUPS installed, and had an HP Deskjet installed. This was done on debian woody (or close enough to woody) remotely via an ssh connection. These instructions also worked perfectly for a Brother HL 1430 on a Redhat 9 system running XimianDesktop although I didn't use any of the graphic configuration tools. Hopefully these instructions are generic enough to work with any USB printer supported by cups.

Preparation

Make sure the kernel has USB Printer support. I created a kernel module (CONFIG_USB_PRINTER) and made sure it installed ok.

Make a device file. I assume people using devfs don't need to do this manually. I did:

  mkdir /dev/usb
  mknod /dev/usb/lp0  c 180 0

although some people use the name "/dev/usb/usblp" instead.

Config files

Foomatic is the cups package with all the printer description files (*.PPD) and setup stuff.

To determine which driver cups needs to use, you do

   # foomatic-configure -O | less

which lists all the supported printers, and search for your printer. If I search for "1440" I find an entry for the new printer that includes the line

<driver>hl1250</driver>

Now the magic line:

foomatic-configure -s cups -n Brother -c file:/dev/usb/lp0 \
    -p Brother-HL-1440 -d hl1250 -o PageSize=A4

(This should all be on one line, without the "\") This says to use the cups printing system, and name the new printer "Brother". The -p and -d options are the printer ID and driver I got from the previous step in the output. Also I used an option to set the default page size to A4.

Note that this can't be done until the printer is connected, as I got a "client-error-not-possible" error until someone at the remote end plugged the new printer into the USB port.

You can also access cups by going to http://localhost:631 and authenticating as any user in the "lpadmin" group (I used root). From here I printed a test page and made this the default printer.

You can also make it the default printer by editing /etc/cups/printers.conf or with the command "lpadmin -d Brother"

/etc/printcap

4) Edit /etc/printcap for "Legacy" applications. cups does make a printcap file, but in debian the default name is /etc/printcap.cups. Just copy that - it had empty entries for my two installed printers.

Gotchas

remove /.lpoptions (for all users) as that hard-coded the default printer to be the old one! I don't know what created that file, as only some users had it.

Check for a PRINTER environment variable and make sure that it's either unset or set correctly.


I'm using linux debian woody, with kernel 2.4.18 mknod /dev/usb/lp0 c 180 0 allowed cups to see the printer but not to work. The only solution seems to upgrade the kernel or to use a different printer.c that comes from hpoj.sourceforge.net, but I still have not tested it...

HP Office Jets need extra configuration files, which don't come with CUPS by default. Install the "hpoj" package (or the newer "hplip" package).


Useful Command-line tools

To see a list of all successful print jobs from the current machine (by all users)

lpstat -W completed -u

I've noticed that if my USB printer isn't turned on when cups is started, sometimes after turning the printer on, cups still thinks the printer isn't ready. You can manually re-enable the printer by:

cupsenable printername

For the example printer setup above, printername with be "Brother". Similarly, you can temporarily disable printing to a printer (although cups will still queue jobs for it) with

cupsdisable printername

You can check the status of a printer (ie whether cups is accepting jobs, and whether the printer is enabled or not) with

lpstat -a -p

Or if you want more info ("long listing"):

lpstat -a -l -p

Note that the order of these options matters.


See CupsAccounting

Part of CategoryPrinting