Using System V interface scripts with CUPS printing
CUPS is a powerful and flexible printing system, but sometimes all we need is the simplest things. For example, very often for application printing, all I want is a raw queue. I just want cups to pass my data untouched to some device. That's easy enough with cups:
lpadmin -p myprinter -E -v parallel:/dev/lp
is all that is needed. The "-v" could also go to a network port or a serial port.
But what if I wanted to add an automatic form feed to the end of that, or do some other special processing? I'd have to get into cups ppd files, add a filter - a lot of work for something so simple. You might want to do that if your printer will handle both simple text that you need to mess with, but let's take the simple, text only case first.
It doesn't have to be. Cups can use System V interfaces scripts. We'll create a simple script that just adds a form feed:
echo -e "\f\c"
Let's say we called that script "/tmp/myff". We add it to the raw printer like this:
lpadmin -p myprinter -E -i /tmp/myff -v parallel:/dev/lp
YOU CAN ONLY USE SYS V INTERFACES SCRIPTS WITH RAW PRINTERS. No PPD files will be used, no other filters will be processed. This script will be the ONLY thing your data passes through.
The /tmp/myff will be copied to /etc/cups/interfaces. If you now send a job:
date | lp -d myprinter
a form feed will be added.
By the way, that #!/bin/bash isn't optional here. Cups uses execve to run the script, so it needs a binary file or an interpreter line like that.
I threw away everything else here, but the variables passed to the script are the job number, the user, the source of the data (stdin), the number of copies, and finally the actual data file. So for the invocation above, the five variables I shifted away might have been
17 root (stdin) 1 /var/spool/cups/d00017-001
Obviously, there's much more that you can do at this level - emailing, data transformation, whatever you need. However, for complicated tasks, the cups filtering system does have advantages, so this method should be reserved for the simple cases.
You CAN do both - that is, let Cups handle the stuff it wants to handle
and have your script handle straight text. It's a bit more work, but the scripts themselves do not change,
To accomplish this, I created "/etc/cups/myfilters". Cups is security conscious (as it should be!) so make sure that directory has the same owner and group and perms as /etc/cups/ppd. Put your script in there, and again
make ownership and perms match (-rwxr-xr-x 1 root _lp on my OS X machine).
You then need to modify the ppd file for the printer. In my case, that was
"/etc/cups/ppd/hplaser" and I added a new "Filter" line:
*cupsFilter: "application/vnd.cups-raster 50 rastertohp"
*cupsFilter: "text/plain 0 /etc/cups/myfilters/TextToPrinter"
The first line was already there; I added the second.
Without that new line, text such as "date | lp -dhplaser" would have
been handled by Cups. With this, text jobs go through my filter. This
doesn't affect things like printing a web page from a browser or printing from
TextEdit, but it will grab things like that command "date | lp -dhplaser".
You'll need to do a "killall -HUP cupsd" (OS X, Linux) or otherwise restart Cups when you initiate these changes; if you need to modify the filter later you can dispense with that and just go ahead and edit it.
In documentation for shell script filters you will see code like this:
[ -n "$6" ] && exec <"$6"
That's because filters can be chained together - the first filter gets
passed the file to print in $6 and all others (except the last) are expected to read from stdin and write to stdout. The last filter is the "back-end" which
writes to the actual printer hardware (or network port).
See Using Your Own Filters to Print with CUPS for a chaining example.
See also foomatic,magicfilter
CUPS print to file - the hard way!
What are printer interface scripts?
If this page was useful to you, please help others find it:
More Articles by Anthony Lawrence
- Find me on Google+
Have you tried Searching this site?
Unix/Linux/Mac OS X support by phone, email or on-site:
This is a Unix/Linux resource website. It contains technical articles about Unix, Linux and general computing related subjects, opinion, news, help files, how-to's, tutorials and more. We appreciate comments and article submissions.
Publishing your articles here
Jump to Comments
Many of the products and books I review are things I purchased for my own use. Some were given to me specifically for the purpose of reviewing them. I resell or can earn commissions from the sale of some of these items. Links within these pages may be affiliate links that pay me for referring you to them. That's mostly insignificant amounts of money; whenever it is not I have made my relationship plain. I also may own stock in companies mentioned here. If you have any question, please do feel free to contact me.
I am a Kerio reseller. Articles here related to Kerio products reflect my honest opinion, but I do have an obvious interest in selling those products also.
Specific links that take you to pages that allow you to purchase the item I reviewed are very likely to pay me a commission. Many of the books I review were given to me by the publishers specifically for the purpose of writing a review. These gifts and referral fees do not affect my opinions; I often give bad reviews anyway.
We use Google third-party advertising companies to serve ads when you visit our website. These companies may use information (not including your name, address, email address, or telephone number) about your visits to this and other websites in order to provide advertisements about goods and services of interest to you. If you would like more information about this practice and to know your choices about not having this information used by these companies, click here.