Discussion:CUPS

Déboguer le fonctionnement de CUPS sous Debian 12 (perplexity)

Pour diagnostiquer et corriger les problèmes liés à CUPS (Common UNIX Printing System) sur Debian 12, suivez les étapes ci-dessous.

1. Consulter le fichier de log principal de CUPS

Le fichier principal de log se trouve ici : /var/log/cups/error_log

Ce fichier enregistre toutes les opérations, erreurs et avertissements de CUPS, y compris les problèmes de filtres et de communication avec l’imprimante.

2. Activer le mode debug pour plus d’informations

Par défaut, le niveau de log est souvent réglé sur warn. Pour obtenir plus de détails, activez le mode debug :

• Pour activer le debug logging :

 sudo cupsctl --debug-logging
 

• Pour un niveau de détail maximal :

 sudo cupsctl LogLevel=debug2
 

• Pour revenir au niveau par défaut :

 sudo cupsctl --no-debug-logging
 

CUPS redémarre automatiquement après ces commandes.

3. Modifier manuellement le niveau de log dans cupsd.conf

Vous pouvez aussi éditer le fichier /etc/cups/cupsd.conf et modifier la ligne :

 LogLevel warn

par

 LogLevel debug

ou

 LogLevel debug2

Après modification, redémarrez CUPS :

 sudo systemctl restart cups
 sudo systemctl restart cups-browsed

4. Analyser le fichier error_log

Ouvrez et analysez /var/log/cups/error_log. Recherchez les mots-clés tels que : error, failed, filter, JobCompleted, JobProgress.

Tester la communication avec l’imprimante

Pour vérifier si le problème vient du backend ou de la connexion, envoyez un fichier prêt à être imprimé directement à l’imprimante :

 lp -d  -o raw 

Cela permet de contourner la chaîne de filtres et d’isoler le problème.

6. Vérifier la détection des périphériques

Pour lister les périphériques détectés par CUPS :

/usr/sbin/lpinfo -v

Cela permet de vérifier si l’imprimante est bien détectée par le système et par CUPS.

7. Problèmes de permissions ou de drivers

Si l’imprimante n’apparaît pas ou ne fonctionne pas, vérifiez les permissions sur les périphériques USB et le choix du driver (PPD). Pour certains modèles HP, privilégiez le driver hpcups plutôt que hpijs.

Résumé des commandes utiles

Action	Commande
Activer debug logging	sudo cupsctl --debug-logging
Activer debug2 logging	sudo cupsctl LogLevel=debug2
Désactiver debug logging	sudo cupsctl --no-debug-logging
Redémarrer CUPS	sudo systemctl restart cups
Voir les logs	sudo less /var/log/cups/error_log
Lister les périphériques	sudo /usr/sbin/lpinfo -v
Tester impression brute	lp -d <queue> -o raw <fichier_prêt_impression>

Bonnes pratiques

• Toujours reproduire le problème après avoir activé le mode debug pour obtenir des logs pertinents.
• Désactiver le mode debug après le diagnostic pour éviter des fichiers logs trop volumineux.
• Si le log ne donne pas d’indication claire, vérifier la configuration réseau, les permissions, et la compatibilité du driver utilisé.