Printing/fr

Ce document Article description::couvre la mise en place et la maintenance des imprimantes en utilisant CUPS et Samba. Il permet une installation locale ainsi qu'une installation en réseau. Il permet aussi d'utiliser des imprimantes partagées depuis d'autres systèmes d'exploitation. Pour des informations à propos de l'utilisation des commandes ou  pour l'impression de documents, utilisez l'excellente documentation fournie par CUPS.

Utilisez les bons outils
Linux offre un bon support des imprimantes. Le meilleur outil pour réaliser des impression est appelé CUPS (Common Unix Printing System). Les procédures d'installation et de maintenance de CUPS se sont grandement facilitées depuis sa création, en 1999.

Ce document explique la mise en place de CUPS pour mettre en place une imprimante locale ou en réseau. Il ne rentrera pas dans les détails car le projet dispose d'une bonne documentation disponible pour une utilisation avancée.

Noyau
La première chose à connaître lorsqu'on veut installer une imprimante est de savoir comment elle va communiquer avec le système. On peut utiliser un port local comme le LTP ou l'USB ou le réseau. Si on choisit d'utiliser le réseau, il faut savoir si on doit utiliser le Protocole d'Impression depuis Internet (Internet Printing Protocol, IPP) ou le protocole CIFS mis en place par Microsoft Windows (Microsoft Windows Sharing).

Les prochaines parties vont détailler les configurations minimales qui doivent être faites au niveau du noyau pour connecter l'imprimante à Gentoo.

Rendez vous dans et lancez la commande  pour configurer le noyau. On doit effectuer ces étapes même si le noyau a été compilé grâce à afin d'être sûr que rien n'a été oublié. Ne comptez pas sur genkernel pour configurer votre noyau en fonction de votre matériel. L'impression est un domaine dans lequel il est très dur d'automatiser la configuration.

Dans les prochains exemples de configuration, le support va être ajouté "dans" le noyau, pas en tant que modules. Il n'est pas nécessaire d'utiliser cette méthode : on peut aisément mettre en place un support modulaire, il faut juste être sûr de charger les modules nécessaires.

Naviguez dans les sections appropriées pour configurer (ou vérifier la configuration) du noyau.

Imprimante connectée localement (LTP)
Le port parallèle est généralement utilisé comme port LTP. Vous devez d'abord activer le support du port parallèle, puis le support du port parallèle "à la manière des PC" (à moins que la machine soit d'architecture SPARC), après cela on peut activer le support du port parallèle pour les imprimantes.

Et voilà ! Quittez le programme de configuration du noyau et recompilez le noyau.

Nous allons maintenant configurer CUPS.

Imprimante connectée localement (USB)
L'impression par port USB est supportée par CUPS avec l'USB USE flag activé. Le logiciel utilisera alors la bibliothèque libusb pour le support de l'impression par USB.

Le matériel plus ancien pourrait avoir besoin d'un support USB du noyau. Si ce support est compilé en tant que module, il devrait s'appeler :

Pourtant, le support d'imprimantes USB du noyau est considéré comme obsolète. Ne l'activez que si il est nécessaire.

Imprimante fonctionnant à distance (IPP et LPD)
Pour pouvoir se connecter à une imprimante en réseau en utilisant le protocole d'impression internet (Internet Printing Protocol) ou le Line Printer Daemon Protocol, le noyau doit supporter la mise en réseau. Si le noyau supporte déjà cette option, continuez avec CUPS.

Imprimante fonctionnant à distance (CIFS)
Le noyau doit supporter le CIFS :

Après avoir configuré le CIFS, quittez le programme de configuration et recompilez le noyau. N'oubliez pas de copier le nouveau noyau dans (il faudra peut-être le monter) et de mettre à jour le chargeur d'amorçage avant de redémarrer le système. Vous utiliserez les commandes de la section Configuration de l'imprimante en LTP pour imprimer des fichiers.

Passez à l'étape suivante afin d'installer CUPS.

USE flags
CUPS dispose de fonctionnalités qui pourraient être intéressantes. Pour activer ou désactiver ces fonctionnalités, utilisez les USE flags qui y sont associés.

Pour configurer les USE flags de CUPS sans modifier ceux définis pour les autres logiciels, ajoutez les dans le fichier.

Installation
Lorsque la configuration vous satisfait, installez CUPS avec la commande suivante :

Samba
Pour activer le support de SAMBA, il faut installer avec le support de CUPS. Complétez le fichier pour activez l'USE flag   :

Il faut ensuite (ré)installer Samba :

Avahi
CUPS uses Avahi internally when built with the  USE flag to scan for printers on the local network. To use Avahi hostnames to connect to networked printers, set up .local hostname resolution and restart the CUPS service. CUPS and cups-filters need to be built with the  USE flag as well. Use the command for listing available printers.

Groupe utilisateur d'impression
Pour pouvoir imprimer, les utilisateurs doivent faire partie du groupe  :

Pour pouvoir ajouter des imprimantes et modifier leurs configurations à l'aide de l'interface web de CUPS, l'utilisateur doit être ajouté dans le groupe  :

OpenRC
Si l'imprimante est connectée localement et que l'imprimante doit être disponible à chaque démarrage, il faut démarrer le daemon de CUPS lors du démarrage du système. Vérifiez que l'imprimante est connectée et allumée avant de démarrer le daemon.

systemd
La commande suivante permet de démarrer le daemon de CUPS au démarrage.

Contrôle par HTTP
Une fois le service démarré, les utilisateurs autorisés peuvent ajouter des imprimantes. L'utilisateur root peut le faire par défaut ainsi que les membres du groupe. L'interface de configuration est accessible à l'adresse URL suivante :

http://localhost:631/

Fichiers
Le fichier de configuration par défaut de CUPS se trouvent dans. Ils devraient être suffisants pour la plupart des utilisateurs. Certaines personnes pourraient néanmoins avoir besoin de faire des changements dans la configuration de CUPS.

La section suivante couvre des changements qui sont souvent nécessaires :


 * Permettre aux autres systèmes d'utiliser l'imprimante connectée à cette station de travail.
 * Autoriser l'administration de CUPS depuis un autre système.
 * Configurer CUPS pour activer le support du pilote Windows PCL. Cela est conseillé pour les ordinateurs utilisant Windows car il permet d'utiliser une imprimante partagée par SAMBA. En effet, la plupart des pilotes d'imprimantes Windows sont des pilotes PCL.
 * Permettre à ce système d'utiliser une imprimante connectée à un autre système (sans passer par le partage Windows).

Imprimante à accès distant
Pour permettre aux autres systèmes d'utiliser l'imprimante via IPP, il faut l'indiquer dans le fichier. Ce changement n'est pas nécessaire si on veut utiliser SAMBA.

Ouvrez le fichier dans vôtre éditeur de texte préféré et ajoutez-y la ligne   pour le(s) système(s) qui doivent être autorisés à utiliser l'imprimante. Dans l'exemple suivant, l'accès est permis pour l'ordinateur (localhost) et pour les adresses IP qui commencent par.

Cette ligne permet de diffuser l'information aux clients du réseau : cela permet aux utilisateurs de savoir quand cette imprimante est disponible :

Le port d'écoute de CUPS doit aussi être spécifié pour permettre de répondre aux requêtes d'impression envoyées par les autres machines du réseau :

The CUPS server reject a hostname or server alias in the HTTP request with "Bad request" message. It works with IP-addresses by default. So if you want to print or browse CUPS interface by using a hostname or domain, add the ServerAlias parameter:

Gestion à distance de CUPS
Pour permettre la configuration à distance de CUPS, il faut autoriser d'autres systèmes y accéder. Il faut pour cela éditer le fichier et autoriser explicitement l'accès aux autres systèmes. Par exemple, pour autoriser l'accès au un ordinateur ayant pour adresse IP 192.168.0.3 :

Il ne faut pas oublier de redémarrer le daemon CUPS après avoir changé la configuration. On peut faire cela en exécutant la commande.

Activer le support pour le pilote Windows PCL
Le pilote PCL permet d'envoyer des données à l'état brut au serveur d'impression. Pour activer le support de PCL sur CUPS, il faut éditer le fichier et décommenter la ligne   si elle n'est pas déjà décommentée. Il faut ensuite faire de même avec le fichier.

Il ne faut pas oublier de redémarrer le daemon de CUPS après la modification des fichiers de configurations afin que celle-ci soit prise en compte.

Installer une imprimante distante
Si les imprimantes sont connectées à un serveur utilisant CUPS, le système peut être facilement configuré en modifiant le fichier.

En supposant que l'imprimante est connectée à un système appelé, il faut modifier le fichier  pour y inclure la directive   :

Le système distant utilisera de base une imprimante par défaut. Pour changer l'imprimante par défaut, il faut utiliser la commande.

Pour lister les imprimantes disponibles :

Pour définir l'imprimante "HP LaserJet 5P" comme imprimante par défaut :

Introduction
Si l'accés à l'imprimante qui doit être configurée est possible grâce à un autre serveur d'impression (utilisant CUPS), alors les instructions suivantes sont inutiles. Il faut à la place suivre Mise en place d'une imprimante distante.

Détection de l'imprimante
Si une imprimante USB ou par port parallèle était allumée lors du démarrage du système, il devrait être possible d'accéder aux informations fournies par le noyau si ce dernier a détecté l'imprimante. Cette étape permet d'avoir une indication à propos de la détection de l'imprimante, elle n'est pas obligatoire.

Pour une imprimante connectée par USB :

Listing available drivers
Pour lister les pilotes disponibles, il faut exécuter la commande suivante :

La commande fournit peu d'informations et peut être difficile à utiliser. En cas de problèmes, utiliser pour plus d'informations.

Installation de l'imprimante
Pour installer l'imprimante sur le système, utilisez un navigateur internet et rendez vous à l'adresse http://localhost:631. L'interface web de CUPS devrait s'afficher pour permettre l'administration des imprimantes.

Il faut aller dans la section et entrer le nom de l'utilisateur root ainsi que son mot de passe. Lorsque la page d'administration est affichée, il faut cliquer sur. L'écran suivant permet d'ajouter les informations sur l'imprimante :


 * Le "spooler name" (nom du spouler), un nom cours utilisé par le système pour identifier l'imprimante. Ce nom ne devrait pas contenir de caractères spéciaux. Par exemple, une imprimante HP laserJet 5P devrait s'appeler.
 * La "location" (emplacement), l'endroit auquel l'imprimante se situe (par exemple "chambre", ou "dans la salle à manget juste à droite du lave vaisselle", etc.). Cela permet d'administrer plus facilement un grand nombre d'imprimantes.
 * La "description" (description), une description complète de l'imprimante. C'est souvent le nom entier du modèle de l'imprimante (par exemple "HP LaserJet 5P").

L'écran suivant permet de renseigner quelle imprimante doit être utilisée. De nombreuses imprimantes seront listées. Le tableau suivant couvre quelques imprimantes possibles, mais la liste n'est pas exhaustive.

Dans le cas de l'installation d'une imprimante distante, l'URL de l'imprimante sera demandée :


 * Un serveur d'impression LPD requiert une syntaxe du type.
 * Un serveur d'impression HP JetDirect requiert une syntaxe du type.
 * Un serveur d'impression IPP requiert une syntaxe du type   ou.

Next, select the printer manufacturer in the adjoining screen along with the model type and number in the subsequent screen. For many printers multiple drivers will be available. Select one now or search on OpenPrinting Printer List for a good driver. Drivers are easily able to be changed later.

Once the driver is selected, CUPS will inform that the printer has been added successfully to the system. Navigate to the printer management page on the administration interface and select to change the printer's settings (resolution, page format, ...).

Testing and reconfiguring the printer
To verify if the printer is working correctly, go to the printer administration page, select the printer and click on.

If the printer does not seem to work correctly, click on to reconfigure the printer. The same screens as during the first installation will appear but the defaults will now be the current configuration.

If the printer does not function, clues may be found by looking at the CUPS error log located at. In the next example a permission error is discovered, probably due to a wrong setting in the  file.

Installing the best driver
Many printer drivers exist; to find out which one has the best performance the job, visit the OpenPrinting Printer List. Select the brand and type/model of the printer to find out what driver the site recommends. For instance, for the HP LaserJet 5P, the site recommends the  driver.

Download the PPD file from the site and place it in then run  (for OpenRC users) or  (for systemd users) as root. This will make the driver available through the CUPS web interface. Now reconfigure the printer as described above.

Enabling job accounting in for Xerox printers
High-end Xerox printers (often a gray, cabinet sized device) use XCPT PDL, and XML based, and poorly documented XPIF ticketing instruction format.

XCPT filter in Cups never made it to a release grade, and the work on it was eventually dropped and all XPIF must be input into a PPD manually. Luckily, it's largely a direct copy of IPP, using XML syntax. After peeking into docs available online, we can craft an arbitrary XPIF command using corresponding IPP attributes.

To configure XPIF solely for ticketing/accounting, drop the following into any PPD:

It will draw a dropdown box in any printing ui compliant with CUPS PPD extensions to enter the id.

The long term solution would still be for Xerox to fully publish XPIF, and XCPT specifications, to allow for a proper XPIF cups filter to be developed.

Introduction
Some printers require specific drivers or provide additional features that are not enabled through the regular configuration process (described above). This chapter will discuss a selection of printers and how they are made to work with Gentoo Linux.

Gutenprint driver
The Gutenprint drivers are high-quality, open source printer drivers for various Canon, Epson, HP, Lexmark, Sony, Olympus and PCL printers supporting CUPS. They also support ghostscript, The Gimp, and other applications.

Gentoo's Portage tree contains an ebuild for the gutenprint drivers. Run to install them. Note the ebuild requests to quite a few USE flags. At minimum  and   must enabled for gutenprint drivers to work properly.

When the emerge process has finished, the gutenprint drivers will be available through the CUPS web interface.

HPLIP driver
See HPLIP Driver.

Lexmark driver
Most Lexmark printers are handled by their "Universal Printer Driver":

Once this is installed, there is a single Lexmark driver available in the CUPS setup wizard that should work with most printers and MFDs.

PNM2PPA driver
PPA is an HP technology that focuses on sending low-level processing to the system instead of the printer which makes the printer cheaper but more resource consuming.

If the OpenPrinting site informs the pnm2ppa driver is the best option, then the filter will need to be installed on the system:

Once installed, download the PPD file for the printer OpenPrinting and put it in the folder. Then configure the printer using the steps explained above.

SpliX driver
SpliX is a set of CUPS printer drivers for SPL (Samsung Printer Language) printers. While SpliX drivers are available through OpenPrinting as well, the package allows for quick portage-managed installation of these drivers. To install, run:

and restart.

Brother printer drivers
See Brother networked printer.

Canon printer drivers
See the specific pages:
 * Canon CAPT drivers
 * Canon Pixma drivers

Configuring a Windows client for IPP
Microsoft Windows supports IPP. To install a printer on Windows that is attached to a Linux box, fire up the wizard and select. When asked for the URI, use the  syntax.

Configuring a Windows client for a Samba shared printer
To share the printer on the CIFS network SAMBA must be installed and configured correctly. Doing this is beyond the scope of this article, however a quick configuration of SAMBA for shared printers will be covered.

Open with a favorite text editor and add a   section to it:

Navigate to the top of the file until inside the   section. Locate the  and   settings and set each of them to   (see the example below):

Make sure to enable Windows PCL support in CUPS. Then, restart the smb service to have the changes take effect.

Configuring a Linux client for a Windows print server
First make sure the printer is shared on Windows systems and that has been emerged with the   USE flag enabled (as instructed above).

To find the desired printer's URI, run the following command, substituting  with the computer that is to probe for samba-shared printers:

In the CUPS web interface, configure the printer as previously described. Notice CUPS has added another driver called. Select it and use the  or   syntax for the URI.

Introduction
Many tools exist to help configure a printer, use additional printing filters, add features to printing capabilities, etc. This chapter will list a few of them. Be aware the list is not exhaustive and not meant to discuss each tool in great detail.

Gtk-LP - A GTK-powered printer configuration tool
With, the installation, modification and configuration of a printer can be performed from a stand-alone GTK application. It uses CUPS and provides all standard CUPS capabilities. It is definitely worth checking out if the CUPS Web interface is disliked or if a stand-alone application for day-to-day printing routines is desired.

Install via:

Printer configuration tool for KDE Plasma
KDE Plasma also has a printer config tool called. It works with CUPS and provides a user-friendly interface to configure printers. Install it as follows:

USE flags
Packages that are currently installed with the  USE flag must be modified. Search through to see if any packages explicitly have the   flag and remove it.

Next, it may be necessary to remove the  value from 's USE variable if it had been previously set.

Unmerge
Finally, clean the system of any packages that are no longer needed as a result of CUPS being removed.

Debugging
See archlinux wiki

Error: Unable to convert file 0 to printable format
While having printing troubles and shows this message:

Re-emerge with the   USE flag. You can either add  to the system USE flags in  or enable it only for ghostscript-gpl as shown:

Then run. When it has finished compiling, be sure to restart afterward.

When using OpenRC:

When using systemd:

USB Printer is not detected
Assuming that cups is built with the  USE flag, verify that the printer's character device has the correct permissions. For example:

There should be a character device for this printer at.

In this example, over-zealously modified the permissions. This is. Lets try fixing them:

Now we should see:

The printer likely is detected now. You should be able to add it, configure it (provided that you have a working driver) and print a test page. This implies a permissions problem. Assuming that your system uses udev/eudev for managing its /dev directory, you can make this change permanent by making a udev file:

Our device is "ID 04e8:3297" according to the earlier lsusb output. We split that into idVendor and idProduct as demonstrated in the example. Now udev should ensure that the correct permissions are set at every boot and at every hotplug.

External resources

 * Using Network Printers - Documentation at CUPS.org.
 * Command-Line Printing and Options - Documentation at CUPS.org.