Differences between revisions 2 and 3
Revision 2 as of 2018-10-06 22:29:32
Size: 16571
Editor: Brian Potkin
Comment: Added a few more entries and a page description.
Revision 3 as of 2018-10-11 18:58:04
Size: 21201
Editor: Brian Potkin
Comment: Additional entries.
Deletions are marked like this. Additions are marked like this.
Line 28: Line 28:
      A utility to browse for [[#dnssd|DNS-SD]] announced [[#printer|printers]] and [[#queue|queues]] on the local network using [[#avahi|Avahi daemon]].
Line 44: Line 48:
      Print without a local [[#cups|CUPS]] server.
Line 120: Line 128:
       A PDF and !PostScript file [[#viewers|viewer]].
Line 126: Line 138:
 '''[[DissectingandDebuggingtheCUPSPrintingSystem#capture2|file:/ device]]'''
      Print a [[#job|job]] to a file rather than to a [[#printer|printer]] or [[#queue|queue]]. Intended to be used for diagnostic testing.

      An option passed to [[#pdftopdf|pdftopdf]] to scale a file to fit on the page.
Line 132: Line 152:
       A PDF and !PostScript file [[#viewers|viewer]].
Line 144: Line 168:
 '''[[#lpadmingroup|group (lpadmin)]]'''
      See [[#lpadmingroup|lpadmin group]]
Line 180: Line 206:
      See [[#printjob|Print Job]]
Line 183: Line 213:

      A [[#cups|CUPS]] option (passed to [[#pdftopdf|pdftopdf]]) to rotate pages in a document.
Line 188: Line 222:
 '''[[PrintQueuesCUPS#lpadmin|lpadmin group]]'''
      Setting up a printer with a [[#drivers|driver]] and a [[#ppd|PPD]] is a superuser task; that is, the user has to have root privileges, unless they belong to the lpadmin group.
Line 190: Line 228:
      A [[#ppd|PPD]] option controlling page rotation. Acted on by [[#pdftopdf|pdftopdf]].

       A PDF file [[#viewers|viewer]].
Line 192: Line 238:
<<Anchor(lpadmin)>> <<Anchor(nonfree)>>
Line 197: Line 243:

       A PDF and !PostScript file [[#viewers|viewer]].

      An [[#ipp|IPP]] option (passed to [[#pdftopdf|pdftopdf]]) to rotate pages in a document.
Line 216: Line 270:
 '''[[SystemPrinting#pdfprinter|PDF Printer]]'''
      Convert a file to PDF using the printing system.

Line 236: Line 295:
      A [[#cupsfilters|cups-filters]] option for a [[#queue|queue]] or when printing. Convert PDF to !PostScript using a chosen renderer.
Line 240: Line 303:
      A [[#ppd|PPD]] option controlling page rotation. Acted on by [[#pdftopdf|pdftopdf]].
Line 252: Line 319:
 '''[[PrintQueuesCUPS#printqueue|Print Job]]'''
      A document or set of documents to be sent to a [[#queue|queue]].
Line 262: Line 333:
       A PDF and !PostScript file [[#viewers|viewer]].
Line 266: Line 341:
      See [[#usbquirk|USB quirk]].
Line 270: Line 348:
      A CUPS, [[#pwgraster|PWG]], and [[#appleraster|Apple]] raster file viewer.       A CUPS, [[#pwgraster|PWG]], and [[#appleraster|Apple]] raster file [[#viewers|viewer]].

 '''[[Tea4CUPS|Raw Queue]]'''
      A [[#queue|queue]] which is set up with `-m raw`; that is; no [[#ppd|PPD]] is used. The [[#job|job]] bypasses the filtering system and goes directly to the [[#deviceuri|device uri]] specified for the queue. Removal of support within [[#cups|CUPS]] for raw queues is [[https://github.com/apple/cups/issues/5271|planned for the future]].

      A [[#filter|filter]] to convert a file to [[#appleraster|Apple Raster]] or [[#pwgraster|PWG Raster]]
Line 311: Line 397:
 '''[[DissectingandDebuggingtheCUPSPrintingSystem#usb|USB Quirk]]'''
      A [[#cups|CUPS]] rule to deal with a [[#printer|printer's]] possible deviation from the USB standard.

      A [[#cups|CUPS]] option to deal with problematic [[#usb|USB]] [[#printer|printers]].

      A [[#cups|CUPS]] option to deal with problematic [[#usb|USB]] [[#printer|printers]].
Line 323: Line 421:
 '''[[DriverlessPrinting#misc|Wi-Fi Direct]]'''
      Connect over wireless directly with a [[#printer|printer]] without the need for a wireless access point.
Line 325: Line 427:
       A PDF file [[#viewers|viewer]].
Line 328: Line 434:

       A PDF and !PostScript file [[#viewers|viewer]].

An aid to locating items of interest on the Printing Portal pages.

Jump to: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z


  • Auto Discovery

    • Techniques which lead to automatic discovery of remote, shared queues and printers on the local network and making them available for printing to.

  • Avahi

    • A framework for Multicast DNS Service Discovery (DNS-SD). It allows programs to publish and discover services and hosts running on a local network with no specific configuration and is the equivalent of Bonjour.


  • Backend

    • Used for printer discovery and sending a document processed by CUPS and cups-filters to the device after it has been converted to a format understood by the printer.

  • Bonjour

    • An implementation of DNS-SD by Apple. Most recent network printers have it as facility.


  • CUPS

    • Manages all aspects of printing a document and is at the heart of Debian's default printing system. Subject to continual upstream development.

  • CUPS Error Log

    • A file for diagnosing issues and misbehaviours of the printing system. Logging to the file is done not only by CUPS but by other printing processes such as cups-filters and Tea4CUPS.

  • cups-browsed

    • A setup tool for print queues and printers. Comes as a package separate from cups-filters and is essential on Debian 8 (jessie) and 9 (stretch) for automatic discovery and setup of remote queues and printers. It also supports facilities (such as browsing the broadcasts of pre-1.6.x CUPS servers, servers on other network segments and queue clustering) which are no longer supported by CUPS.

  • cupsfilter

    • A diagnostic program included with CUPS. Convert a file to a specific format, just as if it had been printed through CUPS. Nothing is sent to the printer.


  • DNS-SD

    • This is a public service protocol used to advertise and discover printing services on a local network. The services are resolved to hostnames using standard DNS queries. Being a public service, no filtering of announcements is offered. A CUPS server automatically uses the protocol to publicise its queues and it is a feature of many recent printers which have AirPrint. Bonjour is Apple's implementation of DNS-SD and is handled on Debian by Avahi.

  • Device URI

    • A Uniform Resource Identifier (URI) is an addressing technology for identifying where to dispatch the file sent by a backend. USB and network printers are supported by CUPS with various schemes.


  • Embedded Web Server

    • An embedded web server resides on the printer in its firmware. It can be used to manipulate how the printer is presented on the network. It may also offer other facilities, such as scanning.

  • Everywhere Model

    • A queue which is set up with -m everywhere rather than with -m <PPD> or -P <PPD>. The remote queue or printer is queried to generate a PPD.



  • ?Google Cloud Print

    • An infrastructure to allow printing to a cloud-aware printer or a print queue on a remote CUPS server.

  • ?cloudprint

    • An application to make locally configured printers available to GCP.

  • ?google-cloud-print-connector

    • An application to make locally configured printers available to GCP.



    • Free software exclusively for Hewlett Packard (HP) printing, scanning and faxing devices.


  • IPP

    • The protocol used by CUPS for local and network communication between client devices (computers, mobile phones, tablets, laptops etc.) and printers and print servers.




  • lpadmin

    • The fundamental utility for setting up a print queue. Used by all other setup programs.

  • lpadmin group

    • Setting up a printer with a driver and a PPD is a superuser task; that is, the user has to have root privileges, unless they belong to the lpadmin group.



  • Non-free Drivers

    • Quite a few printers only provide vendor-specific non-free software, which is not allowed to be distributed with Debian. Recent printers from such manufacturers falling into this category should be capable of being used with driverless printing to avoid this restriction.



  • Page Description Language

    • A computer language that describes the appearance of a printed page. PDLs of particular importance to a modern printing system are PDF, Apple Raster and PWG Raster. The most well-known non-vendor-specific PDL is probably PostScript.

  • PCLm

    • A streaming, PDF-based raster protocol supported by the cups-filters rastertopclm filter but not by CUPS.

  • PDF/A

    • A PDF format aimed at reliable, long-time preservation of archived digital documents.

  • PDF-Centric Workflow

    • All files submitted to a queue are first converted to a PDF. After that, the PDF produced by the conversion is processed by pdftopdf before being sent for further processing and then on to the printer via a backend.

  • PDF Printer

    • Convert a file to PDF using the printing system.

  • pdffonts

    • A utilty to list the fonts and information about each font present in a PDF document.

  • pdfinfo

    • A utilty to extract information from a PDF document.

  • PPD

    • A PostScript Printer Description (PPD) file describes the capabilities of the printer. These capabilities are displayed in the dialogs of applications and with lpoptions and are sent to the queue when selected. A PPD file is often referred to as a driver. Removal of support within CUPS for PPDs is planned for the future.

  • Printer

    • A peripheral device which communicates with the output of a queue to put graphics or text on a medium such as paper.

  • Print Dialog

    • Different Graphical Use Interfaces (GUIs) obtain printing options from CUPS in different ways and differ in the way the application displays them in a user-selectable dialog. The hope is eventually to have a Common Print Dialog.

  • Print Queue

    • A file to be printed is submitted to a queue, which is managed by CUPS. cups-filters is involved in processing the file and the output is usually sent to a printer. A single printer can be associated with many queues.




  • Service Location Protocol

    • A discovery protocol that allows the finding of printers connected to a local area network (LAN). It is very likely replaced by DNS-SD on recent printers.


  • Tea4CUPS

    • Tea4CUPS is a CUPS backend. Besides transporting data to a printer it allows them to be modified and manipulated before reaching the printer. The modified data can then be sent to any number of outputs.

  • Temporary Print Queue

    • A feature of CUPS 2.2.4 and later when remote, shared queues and IPP printers are advertised on the network. The queue is only brought into existence when it is printed to.

  • texttopdf

    • A filter to convert text to PDF. The output is generally sent to the pdftopdf filter for the pages to be managed.


  • URF

    • A raster format devised by Apple for use with AirPrint-capable printers. The acronym appears to have originally stood for Universal Raster Format but it is now known as Apple Raster. CUPS converts files to Apple Raster with its rastertopwg filter.

  • USB

    • A USB interface is a very common way of setting up a printer, particularly when it has no ethernet or wireless interface. Consider using ippusbxd with a printer which is capable of interacting with a driverless printing system.


  • Viewers

    • The outputs of some filters are viewable with various utilities.


  • Wi-Fi Direct

    • Connect over wireless directly with a printer without the need for a wireless access point.




See Also