Apparence
Uubu.fr

Les systèmes Linux, l’open source, les réseaux, l’interopérabilité, etc.
« Il vaut mieux viser la perfection et la manquer que viser l’imperfection et l’atteindre. » (Bertrand Arthur William RUSSEL)
19 septembre 2016




cupsd-helper

cupsd-helper, cups-deviced, cups-driverd, cups-exec

helper pour cupsd

   cupsd-helper effectue des opération à la demande du scheduler, cupsd.

   cups-deviced lance chaque backend CUPS sans argument pour découvrir les imprimantes disponibles.

   cups-exec lance les backends, filtres, et autres programmes.

Fichiers

cups-driverd recherche les fichiers PPS et de pilotes dans les répertoires suivants:
/Library/Printers
/opt/share/ppd
/System/Library/Printers
/usr/local/share/ppd
/usr/share/cups/drv
/usr/share/cups/model
/usr/share/ppd
^
19 septembre 2016




cups

cups

Système d'impression open-source

   CUPS est un logiciel pour imprimer depuis des applications. Il convertis les descriptions de page produites par les application en quelque chose qu'une imprimante peut comprendre.

Variables d'environnement

   Les commandes cups utilisent les variables d'environnement suivantes:

CUPS_ANYROOT Autorise ou non tous certificats X.509 (Y ou N)
CUPS_CACHEDIR Répertoire pour les fichiers en cache semi-persistant
CUPS_DATADIR répertoire où trouver les fichiers de données
CUPS_ENCRYPTION Niveau de chiffrement par défaut (Always, IfRequested, Never, Required)
CUPS_EXPIIREDCERTS Autoriser ou non les certificats expirés (Y ou N)
CUPS_GSSSERVICENAME Nom de service Kerberos pour l'authentification
CUPS_SERVER Hostname/IP et port du scheduler CUPS
CUPS_SERVERBIN Répertoire pour les programmes helper, filtres, backend
CUPS_SERVERROOT Répertoire racine du serveur
CUPS_STATEDIR Répertoire où trouver les fichiers statistiques
CUPS_USER Nom de l'utilisateur pour les requêtes d'impression
HOME Répertoire personnel de l'utilisateur
IPP_PORT Port par défaut pour les requêtes IPP
LOCALEDIR Emplacement des fichiers de localisation
LPDEST File d'impression par défaut (standard SystemV)
PRINTER File d'impression par défaut (standard Berkeley)
TMPDIR Spécifie un répertoire pour les fichiers temporaires

Fichiers

~/.cups/client.conf
~/.cups/lpoptions
^
19 septembre 2016




cups-config

cups-config

Obtenir des informations sur cups

   cups-config permet aux dévelloppeurs d'application de déterminer les options de ligne de commande nécessaire pour le compiler et le linker, ainsi que les répertoires d'installation pour les filtres, fichiers de configuration, et pilotes.

OPTIONS

--api-version Reporte la version API courante
--build Reporte le numéro de build spécifique au système
--cflags Reporte les options de compilation nécessaires
--datadir Reporte le répertoire de données CUPS par défaut
--image Avec --libs, ajoute la librairie d'imagerie CUPS à la liste des librairies
--ldflags Reporte les options de linker nécessaires
--libs Reporte les librairies nécessaires
--serverbin Reporte le répertoire de binaire cups par défaut, où les filtres et backends sont stockés
--serverroot Reporte le répertoire de configuration par défaut de cups
--static Avec --libs, reportes les librairies statiques au lieu les librairies partagées
--version Reporte le numéro de version complet de l'installation CUPS

Exemples

Afficher le version courante de cups
cups-config --version
Compiler un filtre cups simple
cc `cups-config --cflags --ldflags` -o filter filter.c `cups-config --libs`
^
19 septembre 2016




cupstestppd

cupstestppd

Test de conformité des fichiers ppd

   cupstestppd teste la conformité des fichiers ppd avec la spécification PostScript Printer Description version 4.3. Il peut également être utilisé pour lister les options supportées et les polices de caractères disponibles dans un fichier PPD. La première forme de cupstestppd teste un ou plusieurs fichiers ppd. La seconde forme teste le fichier ppd fournis sur l'entrée standard.

OPTIONS

-I filename Ignore toutes les alertes PCFileName
-I filters Ignore toutes les erreurs de filtre
-I profiles Ignore toutes les erreurs de profile
-R rootdir Répertoire root alternatif pour le fichiers de filtre, pre-filtre et autre fichier de vérification
-W constraints Reporte toutes les erreurs et alertes UIConstraint
-W defaults Excepté pour les options liées à la taille, reporte toutes les erreurs et alertes d'option par défaut
-W filters Reporte toutes les erreurs et alertes de filtre
-W profiles Reporte toutes les erreurs et alertes de profile
-W sizes Reporte toutes les erreurs et alertes de taille
-W translations Reporte toutes les erreurs et alertes de traduction
-W all Reporte toutes les erreurs comme alertes
-W none Reporte toutes les erreurs comme erreurs
-q N'affiche rien
-r Relâche les exigences de conformité PPD pour que les espaces blanc, caractères de contrôle, et problèmes de formatage ne soient pas traité comme erreurs
-v[v] Augmente le niveau de détails affichés

Codes de sortie

1 Erreur d'argument sur la ligne de commande ou fichie ppd manquant
2 Impossible d'ouvrir ou lire le PPD
3 Le fichier PPD contient des erreurs de format qui ne peuvent pas être ignorés
4 Le fichier PPD n'est pas conforme avec la spécification PPD

Exemples

Tester tous les fichiers PPD sous le répertoire courant et affiche les noms de chaque fichier non conforme
find . -name \*.ppd \! -exec cupstestppd -q '{}' \; -print
Tester tous les fichiers PPD sous le répertoire courant et affiche les résultat détaillés pour les fichiers non conformes
find . -name \*.ppd \! -exec cupstestppd -q '{}' \; -exec cupstestppd -v '{}' \;
^
19 septembre 2016




lpstat

lpstat

Afficher les informations de status cups

   lpstat affiche les informations de status sur les classes, jobs et imprimantes courantes. Sans argument, liste les jobs actifs de l'utilisateur courant.

OPTIONS

-E  Forcer le chiffrement lors de la connexion au serveur
-H Afficher le port et nom du serveur
-R Afficher le rang des jobs
-U username Spécifier un nom d'utilisateur alternatif
-W which-jobs Spécifie quels jobs afficher (completed, not-conpleted). Doit apparaître avant -o et/ou les noms des imprimantes.
-a [printer(s)] Affiche l'états des files d'impression
-c [class(es)] Affiche les classe d'imprimantes et leur imprimantes.
-d Affiche la destination par défaut
-h host[:port] Utiliser un autre serveur
-l Liste long d'imprimantes, classes, et jobs
-o [destination(s)] Affiche les files d'impression et leur destination
-p [printer(s)] Affiche les imprimantes et si elles sont autorisé à imprimer.
-r Affiche si le serveur CUPS fonctionne
-s Affiche un sommaire
-t Affiche toutes les informations (= -r -d -c -v -a -p -o)
-u [user(s)] Affiche une liste de jobs d'impression de l'utilisateur spécifié.
-v [printer(s)] Affiche les imprimantes et quels périphériques y sont attachés.
^
19 septembre 2016




lpoptions

lpoptions

Afficher ou définir les options par défaut et d'imprimantes

   lpoptions affiche ou définis les options d'impression et les options par défaut. Sans spécifier d'imprimante, l'imprimante par défaut est utilisée. Si les options -l, -o ou -r ne sont pas spécifiés, les options courantes sont affichés sur stdout. Lancé en root, lpoptions gère les options pour tous les utilisateurs dans le fichier /etc/cups/lpoptions, sinon les options sont gérées dans le fichier ~/.cups/lpoptions.

OPTIONS

-E  Forcer le chiffrement lors de la connexion au serveur
-U username Indiquer l'identifiant à utiliser pour les connexions au serveur
-d destination[/instance] Définis l'imprimante par défaut.
-h host[:port] Utiliser un autre serveur
-l Liste les options spécifiques à l'imprimante et leur paramètre actuels
-o option[=value] Spécifie une nouvelle option
-p destination[/instance] Définis la destination et l'instance.
-f option Supprime l'option spécifiée
-x destination[/instance] Supprime les options pour la destination

Fichiers

~/.cups/lpoptions Options et instances par utilisateur
/etc/cups/lpoptions Options et instances pour tous les utilisateurs
^
19 septembre 2016




lpr

lpr

Imprimer des fichiers

   lpr demande l'impression de fichiers. Les fichiers qui sont donnés dans la ligne de commande sont envoyé à la destination donnée

OPTIONS

-E  Forcer le chiffrement lors de la connexion au serveur
-h host[:port] Utiliser un autre serveur
-C nom, -J nom, T nom Définir le nom du travail
-P destination[/instance] Imprimer les fichiers sur l'imprimante donnée
-U utilisateur Indiquer l'identifiant à utiliser pour les connexions au serveur
-# copies Nombre de copies à effectuer ( de 1 à 100)
-h Désactiver l'impression de la bannière. Équivalent à -o job-sheets=none
-l Indiquer que le fichier est déjà formaté pour la destination et qu'aucun filtre n'a besoin d'être appliqué. Équivalent à -o raw
-m Envoyer un mail lorsque l'impression est terminée
-o option[=valeur] Définir une option d'impression
-p Indique qu chaque page doit avoir un en-tête ombré avec la date, l'heure, le nom du travail d'impression et le numéro de page. Équivalent à -o prettyprint
-q suspendre l'impression d'un travail
-r Indiquer que les fichiers nommés doivent être effacés après l'impression

Options de job communes

   En plus les options spécifiques à l'imprimante reporté par lpoptions, les options génériques suivantes sont disponible:

-o collate=true Imprime des copies assemblées
-o fit-to-page Adapte le contenu pour remplir la page
-o job-hold-until=when Maintient le job jusqu'au temps spécifié. when peut être indefinite, day-time (entre 6h et 18h), night (entre 18h et 6h), second-shift (entre 16h et 0h), third-shift (entre 0h et 8h), ou weekend (samedi et dimanche)
-o job-hold-until=hh:mm Maintient le job jusqu'à l'heure UTC spécifiée
-o job-priority=priority Priorité du job de 1 à 100. Défaut: 50
-o job-sheets=name Imprime une page de couverture (bannière) avec le document. Peut être "classified", "confidential", "secret", "standard", "topsecret", ou "unclassified"
-o job-sheets=start-name,end-name Imprime les pages de couverture (bannières) avec le document
-o mirror Mirroir chaque page
-o media=size Définis la taille de la page (a4, letter, legal, etc.)
-o orientation-requested=4|5|6 Imprime en paysage (4=90° anti-horaire, 5=90° horaire, 6=180°)
-o sides=one-sided Imprime sur un côté du papier
-o sides=two-sided-long-edge Imprime recto-verso
-o sides=two-sided-short-edge Imprime recto-verso au format paysage
-o number-up={2|4|6|9|16} Affiche 2, 4, 6, 9, ou 16 pages du document sur chaque page
-o number-up-layout=layout Spécifie le layout des pages avec l'option number-up. "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", ou "tbrl". Les 2 premières lettres déterminent l'ordre de colonne, les 2 dernières, l'ordre des lignes.
-o outputorder=reverse Imprime les page dans l'ordre inverse
-o page-border=border Imprime une bordure autour de chaque page. "double", "double-thick", "single", ou "single-thick"
-o page-ranges=page-list Spécifique quelles pages imprimer dans le document. La liste peut contenir des numéros et des plages (#-#) (ex: 1,3-5,16)

Exemples

Imprimer 2 copies d'un document sur l'imprimante par défaut
lpr -# 2 nom_fichier
Imprimer en recto-verso sur une page Legal avec l'imprimante toto
lpr -P foo -o media=legal -o sides=two-sided-long-edge nom_fichier
Imprimer une double composition avec l'imprimante toto
lpr -P foo -o number-up=2 nom_fichier
^
19 septembre 2016




lp

lp

Imprimer des fichiers

   lp demande l'impression d'un fichier ou modifie un travail d'impression en attente. Utiliser "-" pour forcer l'impression à partir de l'entrée standard. CUPS fournit plusieurs façons de spécifier la destination par défaut. Les variables d'environnement LPDEST et PRINTER sont lues en premier. Sinon, la commande lpoptions est utilisée, suivis par la valeur par défaut spécifiée en utilisant lpadmin.

OPTIONS

-- Fin des options
-E  Forcer le chiffrement lors de la connexion au serveur
-U username Indiquer l'identifiant à utiliser pour les connexions au serveur
-d destination Imprimer sur l'imprimante donnée
-h host[:port] Utiliser un autre serveur
-i id_travail Indiquer l'identifiant du travail d'impression à modifier
-m Envoyer un mail lorsque l'impression est terminée
copies Nombre de copies à effectuer (1 à 100)
-o nom=valeur [nom=valeur ...] Définir des options pour le travail d'impression
-q priorité Définir la priorité du travail d'impression (1 à 100), défaut: 50.
-s Ne pas afficher le numéro du travail
-t nom Définir le nom du travail
-H hh:mm Suspend l'impression jusqu'à l'heure définie
-H hold Suspend l'impression indéfiniment
-H immediate Imprime immédiatement
-H restart Relance un travail terminé
-H resume Lance une impression suspendu
-P liste-de-page Définis quelles sont les pages à imprimer

Options communes des travaux

-o collate=true Imprime des copies assemblées
-o fit-to-page Adapte le contenu pour remplir la page
-o job-hold-until=when Maintient le job jusqu'au temps spécifié. when peut être indefinite, day-time (entre 6h et 18h), night (entre 18h et 6h), second-shift (entre 16h et 0h), third-shift (entre 0h et 8h), ou weekend (samedi et dimanche)
-o job-hold-until=hh:mm Maintient le job jusqu'à l'heure UTC spécifiée
-o job-priority=priority Priorité du job de 1 à 100. Défaut: 50
-o job-sheets=name Imprime une page de couverture (bannière) avec le document. Peut être "classified", "confidential", "secret", "standard", "topsecret", ou "unclassified"
-o job-sheets=start-name,end-name Imprime les pages de couverture (bannières) avec le document
-o mirror Mirroir chaque page
-o media=size Définis la taille de la page (a4, letter, legal, etc.)
-o orientation-requested=4|5|6 Imprime en paysage (4=90° anti-horaire, 5=90° horaire, 6=180°)
-o sides=one-sided Imprime sur un côté du papier
-o sides=two-sided-long-edge Imprime recto-verso
-o sides=two-sided-short-edge Imprime recto-verso au format paysage
-o number-up={2|4|6|9|16} Affiche 2, 4, 6, 9, ou 16 pages du document sur chaque page
-o number-up-layout=layout Spécifie le layout des pages avec l'option number-up. "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", ou "tbrl". Les 2 premières lettres déterminent l'ordre de colonne, les 2 dernières, l'ordre des lignes.
-o outputorder=reverse Imprime les page dans l'ordre inverse
-o page-border=border Imprime une bordure autour de chaque page. "double", "double-thick", "single", ou "single-thick"
-o page-ranges=page-list Spécifique quelles pages imprimer dans le document. La liste peut contenir des numéros et des plages (#-#) (ex: 1,3-5,16)

Exemples

Imprime 2 copies d'un document sur l'imprimante par défaut
lp -n 2 filename
Affiche un document legal recto-verso sur l'imprimante foo:
lp -d foo -o media=legal -o sides=two-sided-long-edge filename
lp -d foo -o number-up=2 filename
Affiche une représentation 2 pages sur l'imprimante foo:
lp -d foo -o number-up=2 filename
^
18 septembre 2016




lpadmin

lpadmin

Configurer les imprimantes et classes d'imprimantes CUPS

   lpadmin configure les imprimantes et classes d'imprimantes CUPS. Il est également utilisé pour définir l'imprimante ou classe d'imprimante par défaut.

   Lorsque l'option -E est utilisée avant les options -d, -p ou -x, la communication avec le serveur est chiffré

   La première méthode d'utilisation de la commande (avec -d) définis l'imprimante ou la classe par défaut. Les impressions futures demandées par les commandes lp ou lpr utiliseront cette destination sauf avis contraire de l'utilisateur par l'utilisation de la commande lpoptions

   La seconde forme de la commande (avec -p) configure l'imprimante indiquée ou la classe.

   La troisième forme de la commande (avec -x) supprime l'imprimante ou classe destination. Tous les travaux d'impression en attente sur cette destination sont supprimés, et les travaux en cours d'impression sont arrêtés.

Options de configuration

   Les options suivantes sont reconnues pour la configuration d'une file d'impression

-c classe Ajouter l'imprimante donnée à la classe. Si la classe n'existe pas, elle est créée.
-i interface Crée un script d'interface System V pour l'imprimante. Ne peut pas être utilisée avec -P.
-m model Définis un script d'interface System V pour l'imprimante ou un fichier PPD pour l'imprimante du répertoire model ou en utilisant une des interfaces du pilote. ldinfo -m donne la liste des modèles pris en charge
-o cupsIPPSupplies=[true|false] Indique si le niveau de fournitures IPP doit être rapporté
-o cupsSNMPSupplies=[true|false] Indique si les valeurs SNMP du niveau de fourniture (rfc3805) doivent être rapportés
-o job-k-limit=valeur Définir les quotas par utilisateur en ko.
-o job-page-limit=valeur Définir les quotas par utilisateur en nombre de pages
-o job-quota-period=valeur Définir l'intervalle de temps pour les quotas par utilisateur, en seconde
-o job-sheets-default=bannière[,bannière] Fixer la ou les pages de bannière par défaut pour les travaux d'impression.
-o nom=valeur Définir une options PPD pour l'imprimante. lpoption -l donne la liste des options
-o name-default=valeu Définis au niveau du serveur une options par défaut pour la destination.
-o port-monitor=nom Fixer le programme à utiliser pour les communication binaires lors de l'impression (none, bcp, tbcp).
-o printer-error-policy=nom Stratégie à utiliser en cas d'erreur quand le programme de transmission n'arrive pas à envoyer le travail à l'imprimante. (abort-job, retry-job, retry-current-job, stop-printer).
-o printer-is-shared=true/false Place l'imprimante à l'état partagée ou non.
-o printer-op-policy=nom Stratégie des opérations IPP associées à l'imprimante.
-R nom-défaut Supprimer les options données pour l'imprimante
-r class Supprime l'imprimante de la classe. Si la classe devient vide, elle est supprimée
-u allow:{user|@group}{,user|,@group}*
-u deny:{user|@group}{,user|,@group}*
-u allow:all Définis les accès au niveau utilisateur sur une imprimante.
-v "device-uri" Définis l'attribut device-uri de la file d'impression. lpinfo -v pour la liste des URI
-D "info" Description textuelle de la destination
Active la destination et accepte les jobs, identique à lancer cupsaccept et cupsenable
-L "location" Emplacement textuelle de la destination
-P ppd-file Définir le fichier PPD (Postscript Printer Description) à utiliser avec cette imprimante. Annule -i

Exemples

Créer une file d'impression IPP Everywhere
lpadmin -p mon_imprimante -E -v ipp://mon_imprimante.local/ipp/print -m everywhere
^
18 septembre 2016




lpmove

lpmove

Déplacer un travail d'impression vers une nouvelle destination

   lpmove déplace le travail d'impression ou tous les travaux de source vers destination. Le travail peut être soit l'identifiant du travail d'impression, soit l'ancienne destination et l'identifiant du travail.

OPTIONS

 -E Chiffrer la connexion au serveur
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur

Exemples

Déplacer le travail 123 de old_printer vers new_printer
lpmove 123 new_printer
ou
lpmove old_printer-123 new_printer
Déplacer tous les travaux
lpmove old_printer new_printer
^
18 septembre 2016




lprm

lprm

Annuler des jobs

OPTIONS

 -E Chiffrer la connexion au serveur
-P destination[/instance] Spécifier l'imprimante ou nom de classe
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur
 - Annuler tous les jobs

Exemples

Annuler le job courant sur l'imprimante par défaut:
lprm
Annuler le job 1234
lprm 1234
Annuler tous les jobs
lprm -
^
18 septembre 2016




lpq

lpq

Afficher le status des files d'impression

OPTIONS

 -E Chiffrer la connexion au serveur
-P destination[/instance] Spécifier l'imprimante ou nom de classe
-U Spécifier un identifiant alternatif
-a Afficher les jobs de toutes les imprimantes
-h server[:port] Spécifier le serveur
-l Mode plus verbeux
+interval Spécifier un interval pour un reporting continue
^
18 septembre 2016




ippfind

ippfind

Trouver des imprimantes réseaux

   ippfind trouve les services enregistrés avec un serveur DNS ou disponibles via des périphériques locaux. Son principal but est de trouver les imprimantes IPP et d'afficher leurs URI, afficher leur status actuel, ou lancer des commandes.

Types d'enregistrement

_http._tcp HTTP, rfc2616
_https._tcp HTTPS, rfc2818
_ipp._tcp IPP, rfc2911
_ipps._tcp IPPS, draft
_printer._tcp LPD, rfc1179

Expressions

   ippfind supporte les expressions comme find(1). Cependant, à la différence de find, ippfind utilise les expressions régulières POSIX au lieu des motifs de correspondance shell. Si --exec, -l, --ls, -p, --print, --print-name, -q, --quiet, -s ou -x ne sont pas spécifiés, ippfind ajoute --print.

-d regex, --domain regex Vrai si le domaine correspond à l'expression régulière
--false Toujours faux
-h regex, --host regex Vrai si le nom d'hôte correspond à l'expression régulière
-l, --ls Liste les attributs retournés par Get-Printer-Attributes pour les imprimantes IPP et sort les URLs HTTP.
--local Vrai si le service est local à cette machine
 -n regex, --name regex Vrai si le nom de l'instance du service correspond à l'expression régulière
--path regex Vrai si le chemin de ressource URI correspond à l'expression régulière
-P number[-number], --port number[-number] Vrai si le port correspond à la plage de nombre donnée
-p, --print Imprime l'URI si le résultat des expressions précédentes sont vrai. Le résultat est toujours vrai
-q, --quiet Mode silencieux, retourne simplement les codes de sortie
-r, --remote Vrai si le service n'est pas local
-s, --print-name Imprime le nom de l'instance du service si le résultat de la précédente expression est vrai. Le résultat est toujours vrai
--true Toujours vrai
-t key, --txt key Vrai si l'enregistrement TXI contient la clé nommée
--txt-key regex Vrai si l'enregistrement TXT contient la clé nommé et correspond à l'expression régulière
-u regex, --uri regex Vrai si l'URI correspond à l'expression régulière
-x utility [ argument ... ], --exec utility [ argument ... ] ; Exécute le programme spécifié si le résultat courant est vrai. Les arguments "{foo}" sont remplacées avec la valeur correspondante (voir les substitutions)

   Les expressions peuvent également contenir les modifiers suivants:

( expression ) Groupe le résultat des expressions
! expression, --not expression Inverse le sens de l'expression
expression --and expression ET logique
expression --or expression OU logique

Substitutions

{service_domain} Nom de domaine
{service_hostname} Nom de l'instance du service
{service_port} Numéro de port pour le serveur
{service_regtype} Type d'enregistrement DNS-SD
{service_scheme} Schéma d'URI pour le type d'enregistrement DNS-SD
{service_uri} URI pour le service
{txt_key} Valeur de l'enregistrement TGT key (en minuscule)

OPTIONS

-4 Utilise IPv4
-6 Utilise IPv6
-T seconds Timeout en secondes. À 1 ou inférieur, ippfind stop dès qu'il pense avoir tout trouvé
-V version Version IPP.

Variables d'environnement

IPPFIND_SERVICE_DOMAIN Nom de domaine
IPPFIND_SERVICE_HOSTNAME FQDN
IPPFIND_SERVICE_NAME Nom de l'instance du service
IPPFIND_SERVICE_PORT Numéro de port pour le serveur
IPPFIND_SERVICE_REGTYPE Type d'enregistrement DNS-SD
IPPFIND_SERVICE_SCHEME Schéma d'URI pour le type d'enregistrement DNS-SD
IPPFIND_SERVICE_URI URI pour le service
IPPFIND_TXT_KEY Valeur de l'enregistrement TYT pour KEY (majuscule)

Exemples

Affiche le status de toutes les imprimantes IPP enregistrés sur le réseaux
ippfind --ls
Envoyer une page de test PostScript à toutes les imprimantes PostScript
ippfind --txt-pdl application/postscript --exec ipptool -f onepage-letter.ps '{}' print-job.test
^
18 septembre 2016




ipptool

ipptool

Effectuer des requêtes ipp

   ipptool envoie des requêtes IPP à l'uri spécifiée et test et/ou affiche le résultat. Chaque fichier de test spécifié définis une ou plusieurs requêtes, incluant le status de réponse attendu, attributs, et valeurs. La sortie est soit un texte, un texte formaté, un CSV, ou un rapport XML.

OPTIONS

--stop-after-include-error Stop si une erreur se produit dans un fichier inclus.
-4 Utilise IPv4
-6 Utilise IPv6
-C Spécifie que les requêtes devraient être envoyées en utilisant l'en-tête HTTP/1.1 "Transfer-Encoding: chunked", qui est requis pour être conforme avec toutes les versions IPP.
 -E Chiffrer la connexion au serveur en utilisant l'en-tête HTTP "Upgrade"
-I Continue même si des erreurs sont rencontrées
-L Spécifie que les requêtes devraient être envoyées en utilisant l'en-tête HTTP/1.0 "Content-Length:" qui est requis pour être conforme avec toutes les versions d'IPP.
-P filename.plist Spécifie que le résultat du test devrait être écrit dans e fichier XML nommé, en plus du rapport texte (-t). Incompatible avec -i et -n
-S Force le chiffrement TLS au serveur dédié.
-T seconds Spécifie un timeout pour les requêtes IPP en secondes
-V version Spécifie la version IPP par défaut. Défaut: 1.1
-X Spécifie que la sortie XML (plist) est souhaité au lieu d'un rapport texte. Incompatible avec -i et -n
-c Spécifie que la sortie CSV est souhaité au lieu d'un rapport texte.
-d name=value Définis une variable
-f filename Définis le fichier requête par défaut pour les tests
-l Spécifie que la sortie texte clair est souhaitée
-i seconds Spécifie que le dernier testfile devrait être répété à interval spécifié. Incompatible avec -X.
repeat-count Spécifie que le dernier testfile devrait être répété plusieurs fois. Incompatible avec -X
-q mode silencieux
-t Spécifie que le rapport de test est souhaité au lieu d'une sortie texte clair
-v Spécifie que tous les attributs de requête et réponse soient affichés en mode test.

Exemples

Obtenir une liste de jobs terminés pour myprinter
ipptool ipp://localhost/printers/myprinter get-completed-jobs.test
Envoyer des notifications par mail quand myprinter change
ipptool -d recipient=mailto:user@example.com ipp://localhost/printers/myprinter create-printer-subscription.test

Fichiers

Les fichiers standards suivants sont disponibles:
color.jpg
create-printer-subscription.test
document-a4.pdf
document-a4.ps
document-letter.pdf
document-letter.ps
get-completed-jobs.test
get-jobs.test
get-notifications.test
get-printer-attributes.test
get-subscriptions.test
gray.jpg
ipp-1.1.test
ipp-2.0.test
ipp-2.1.test
ipp-2.2.test
ipp-everywhere.test
onepage-a4.pdf
onepage-a4.ps
onepage-letter.pdf
onepage-letter.ps
print-job.test
print-job-deflate.test
print-job-gzip.test
testfile.jpg
testfile.pcl
testfile.pdf
testfile.ps
testfile.txt
validate-job.test
^
16 septembre 2016




cancel

cancel

Annules des jobs d'impression

   Si aucune destination ou id n'est spécifié, le job courant sur la destination par défaut est annulée

OPTIONS

-a Annule tous les jobs sur la destination
 -E Chiffrer la connexion au serveur
-h server[:port] Spécifier le serveur
-U Spécifier un identifiant alternatif
-u Annuler les jobs possédés par l'utilisateur spécifié
-x Supprimer les fichiers de données de job en plus de l'annulation

Exemples

Annuler le job courant:
cancel
Annuler le job "myprinter-42"
cancel myprinter-42
Annuler tous les jobs
cancel -a
^
16 septembre 2016




cupsfilter

cupsfilter

Convertir un fichier en un autre format en utilisant les filtres cups

cupsfilter est un frontend au sous-système de filtre cups qui permet de convertir un fichier dans un format spécifique, tout comme imprimer le fichier via CUPS. Par défaut, cupsfilter génère un fichier pdf. le fichier convertis est envoyé sur la sortie standard.

OPTIONS

--list-filters Affiche les filtres utilisés sur stdout
-D Supprime le fichier d'entrée après la conversion
-U user Spécifie le username passé au filtre
-c config-file Utilise le fichier de configuration cups-files.conf spécifié
-d printer Utilise l'imprimante nommé
 -e Utilise tout filtre depuis le fichier PPD
-i mime/type Spécifie le type de fichier de destination. Le type par défaut est application/pdf.
copies Nombre de copies à passer aux filtres CUPS
-p filename.ppd Spécifie le fichier ppd à utiliser
-t title Spécifie le titre du document
-u Supprime le fichier PPD après conversion

Fichiers

/etc/cups/cups-files.conf
/etc/cups/ .convs
/etc/cups/ .types
/usr/share/cups/mime/ .convs
/usr/share/cups/mime/ .types
^
16 septembre 2016




cups-snmp

cups-snmp

Backend snmp pour cups

   fournis la découverte et l'identification des imprimantes réseaux en utilisant snmpv1. Utilisé pour la découverte via le scheduler, le backend liste toutes les imprimantes qui répondent à un broadcast SNMPv1 avec la communauté public.

   Dans la première forme, le backend est lancé directement par l'utilisateur pour rechercher une URI et d'autres informations sur une IP ou hostname. Cela peut être utilisé pour les programmes qui doivent configurer les files d'impression quand l'utilisateur a fournis une adresse IP, mais rien d'autre.

   Dans la seconde forme, le backend est lancé indirectement en utilisant lpinfo. La sortie fournis toutes les imprimantes détectées via SNMP sur les adresses de broadcast configurés.

   Le backend SNMP lit /etc/cups/snmp.conf, si présent, pour définir l'adresse de broadcast par défaut, community name, et niveau de logging.

^
16 septembre 2016




cupsd-logs

cupsd-logs

Fichiers de log pour cupsd (acces_log, error_log, page_log)

cupsd maintient normalement 3 fichiers de log: access_log suit les requêtes envoyées au scheduler, error_log suit les progressions et erreurs, et page_log suit les pages imprimées. Les directives de configuration dans cupsd.conf et cups-files.conf contrôlent quelles informations sont loggées et où ils sont stockés

Format de access_log

access_log liste chaque ressource HTTP accedée par un navigateur web ou un client. Chaque ligne est en version étendue du format "Common Log Format" utilisé par de nombreux serveurs Web:
host group user date-time "method resource version" status bytes
    ipp-operation ipp-status

Par exemple:
10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
    CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
    200 0 - -
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
    200 157 CUPS-Get-Printers
    successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
    200 1411 CUPS-Get-Devices -
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
    200 6667 - -

Champs

host est normalement une adresse IP, sauf si HostNameLookups est activé.
group Contient toujours -
user Contient le username authentifié
date-time date de la demande au format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]"
method Méthode HTTP utilisée
resource Nom du fichier de la ressource demandée
version Version de la spécification HTTP utilisée par le client
status Résultat HTTP de la requêtes

        200 Opération réussie
        201 Fichier créé/modifié avec succès
        304 Le fichier demandé n'a pas changé
        400 mauvaise requête HTTP
        401 non autorisé, un authentification est requise
        403 Accès refusé
        404 Fichier ou ressource inexistante
        405 Méthode d'accès non permise
        413 Requête trop grande
        426 Upgrade vers une connexion TLS
        500 Erreur serveur
        501 Chiffrement demandé, mais non disponible
        505 Numéro de version HTTP non supporté

bytes Contient le nombre d'octets dans le requête
ipp-operation Contient soit '-' pour les requêtes non-IPP, ou le nom de l'opération IPP
ipp-dstatus Contient soit '-' pour les requêtes non-IPP ou le code de status IPP

bytes contient le nombre d'octets dans la requête. Pour les requêtes POST ce champ contient le nombre d'octets de données non-IPP qui sont reçus du client
ipp-operation Contient soit '-' pour les requêtes non-IPP ou l'opération IPP
ipp-status contient soit '-' pour les requêtes non-IPP ou le code de status IPP

Format de error_log

Le fichier error_log liste les messages du scheduler - erreurs, alertes, etc. La directive LogLevel contrôle les messages loggés:
I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'.
D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
na_letter_8.5x11in sides=one-sided"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
d000001-001"
I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'.
I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'.

Champs

level Contient le type de message:

        A alert
        C crit
        D debug
        d debug2
        E error
        I info
        N notice
        W warn
        X emerg

date-time contient la date et heure de l'impression de la page.
message contient un message textuel.

Format de page_log

Le fichier page_log liste chaque page ou groupe de pages envoyés à une imprimante. Par défaut, chaque ligne contient les informations suivantes (peut être changé avec la directive PageLogFormat):
printer user job-id date-time page-number num-copies job-billing
    job-originating-host-name job-name media sides
    
printer user job-id date-time total num-impressions job-billing
    job-originating-host-name job-name media sides

Exemple:
DeskJet root 1 [20/May/1999:19:21:05 +0000] 1 1 acme-123
    localhost myjob na_letter_8.5x11in one-sided
DeskJet root 1 [20/May/1999:19:21:05 +0000] 2 1 acme-123
    localhost myjob na_letter_8.5x11in one-sided
    
DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
    localhost myjob na_letter_8.5x11in one-sided

printer Contient le nom de l'imprimante
user username (IPP requesting-user-name)
job-id Numéro de job de la page imprimée
date-time Date et heure du démarrage de l'impression
page-number et num-copies contiennent le numéro de page et le nombre de copies imprimées
Les lignes contenant le mot clé "total" ont un champs num-impressions à la place qui fournis le nombre total d'impressions qui ont été imprimés pour ce job.
job-billing Contient une copie des attributs job-billing ou job-account-id fournis avec les requêtes IPP Create-Job ou Print-Job, ou '-'
job-originating-host-name Contient le hostname ou l'adresse IP du client
job-name Contient une copie de l'attribut job-name fournis avec Create-job ou Print-Job ou '-'
media Contient une copie du media ou media-col/media-size fournis avec Create-Job ou Print-Job ou '-'
sides Contient une copie de l'attribut sides fournis par Create-Job ou Print-Job ou '-'
^
16 septembre 2016




cupsenable

cupsenable, cupsdisable

Démarrer/arrêter les imprimantes et les classes

OPTIONS

 -E Chiffrer la connexion au serveur
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur
-r "reason" Définir une raison pour l'arrêt
-c Annule tous les jobs sur la destination
--hold Conserve les jobs dans l'imprimante. Utile pour permettre au job courant de se terminer avant d'effectuer une maintenace.
--release relance les jobs en attente. Utilisé après cupsdisable --hold.
^
16 septembre 2016




ppdcfile

ppdcfile

Format de fichier source du compiler ppd de cups

Le compileur PPD de cups lit les fichiers méta qui contiennent des descriptions d'un ou plusieurs fichiers PPD à générer avec ppdc. Le format de fichier source est un fichier texte ASCII. Les informations de pilote d'imprimante peuvent être groupés en utilisant { ... }; les directives peuvent être placées n'importe où dans une ligne et sont suivies par une ou plusieurs valeurs. La liste des directives et valeurs acceptées sont:

#define name value
#elif {name | value}
#else
#endif
#font name encoding "version" charset status
#if {name | value}
#include ‹filename›
#include "filename"
#media name width length
#media "name/text" width length
#po locale "filename"
Attribute name "" value
Attribute name keyword value
Attribute name "keyword/text" value
Choice name "code"
Choice "name/text" "code"
ColorDevice boolean-value
ColorModel name colorspace colororder compression
ColorModel "name/text" colorspace colororder compression
ColorProfile resolution/mediatype gamma density matrix
Copyright "text"
CustomMedia name width length left bottom right top "size-code" "region-code"
CustomMedia "name/text" width length left bottom right top "size-code" "region-code"
Cutter boolean-value
Darkness temperature name
Darkness temperature "name/text"
DriverType type
Duplex type
Filter mime-type cost program
Finishing name
Finishing "name/text"
Font *
Font name encoding "version" charset status
Group name
Group "name/text"
HWMargins left bottom right top
InputSlot position name
InputSlot position "name/text"
Installable name
Installable "name/text"
LocAttribute name "keyword/text" value
ManualCopies boolean-value
Manufacturer "name"
MaxSize width length
MediaSize name
MediaType type name
MediaType type "name/text"
MinSize width length
ModelName "name"
ModelNumber number
Option name type section order
Option "name/text" type section order
PCFileName "filename.ppd"
Resolution colorspace bits-per-color row-count row-feed row-step name
Resolution colorspace bits-per-color row-count row-feed row-step "name/text"
SimpleColorProfile resolution/mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust
Throughput pages-per-minute
UIConstraints "*Option1 *Option2"
UIConstraints "*Option1 Choice1 *Option2"
UIConstraints "*Option1 *Option2 Choice2"
UIConstraints "*Option1 Choice1 *Option2 Choice2"
VariablePaperSize boolean-value
Version number

^
16 septembre 2016




mime.types

mime.types

Fichier de description de type mime pour cups

Le fichier mime.types définis les types de fichiers reconnus. Des types de fichiers additionnels sont spécifiés dans les fichiers avec l'extension .types dans le répertoire de configuration cups. Chaque ligne commence avec le type mime et optionellement suivi pasr une série de règles de reconnaissance de fichier:
mime/type [ rule ... rule ]

   Les types sont sensibles à la casse et sont stockés dans l'ordre alphanumérique ascendant.

   Les règles peuvent être groupées en utilisant des parenthèses, jointes avec un '+' pour un ET logique, joint en utilisant ',' ou un espace blanc pour un OU logique, et inversé avec un '!'

Règles

   Les règles prennent 2 formes, une extension de fichier, et les fonction avec des valeurs de tests entre parenthèses

match("pattern") Vrai si le nom de fichier correspond au motif donné
ascii(offset,length) Vrai si length octets commençant à l'offset sont des ASCII valides (CR, NL, TAB, BS, 32-126)
printable(offset,length) Vrai si length octets commençant à l'offset sont des caractères 8-bits ASCII valides (CR, NL, TAB, BS, 32-126, 128-254)
priority(number) Spécifie la priorité relative du type mime. Défaut: 100.
string(offset,"string") Vrai si les octets à l'offset correspondent à la chaîne
istring(offset,"string") Vrai si les octets à l'offset correspondent à la chaîne (insensible à la casse)
char(offset,value) Vrai si l'octet à l'offset est identique à la valeur
short(offset,value) Vrai si l'entier 16-bits big-endian à l'offset est identique à la valeur
int(offset,value) Vrai si l'entier 32-bits big-endian à l'offset est identique à la valeur
locale("string") Vrai si la locale courante correspond à la chaîne
contains(offset,range,"string") Vrai si les octets à l'offset pour la plage d'octet contient la chaîne

Constantes chaînes

   Les constantes chaînes peuvent être spécifiées dans des guillemets double pour les chaînes contenant des espaces blanc et des ‹› pour les chaînes hexadécimales.

Correspondance et priorité

   Quand CUPS doit déterminer le type mime d'un fichier, il vérifie tous les types mimes définis dans les fichiers .types. Quand 2 ou plusieurs types correspondent au fichier, le type choisis dépend du nom du type et de la priorité. Si les types ont la même priorité, les noms sont stockés alphanumériquement dans l'ordre ascendant et le premier type est choisis.

Exemples

Définir 2 types mimes pour des données raster, dont un est un sous-jeu avec une priorité supérieur
application/vnd.cups-raster string(0,"RaSt") string(0,"tSaR") \
    string(0,"RaS2") string(0,"2SaR") \
    string(0,"RaS3") string(0,"3SaR")
    
image/pwg-raster string(0,"RaS2") + \
    string(4,PwgRaster㙌›) priority(150)
^
16 septembre 2016




mime.convs

mime.convs

Fichier de conversion de type mime pour cups

   Le fichier mime.convs définis les filtres disponibles pour convertir les fichiers d'un format à un autre. Les filtres standards supportent text, PDF, PostScript, et de nombreux types de fichiers image.

   Des fitres additionnels sont spécifiés dans le fichiers avec l'extension .convs dans le répertoire de configuration CUPS.

Chaque ligne spécifie les types mime source et de destination, avec un coût relatif associé avec le filtre et le filtre à lancer:
source/type destination/type cost filter
par exemple, pour convertir un PostScript au format cups raster:
application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster

source/type spécifie le type MIME source
destination/type Spécifie le type MIME de destination
cost Spécifie le coût relatif pour lancer le filtre. Une valeur de 100 signifie que le filtre utilise une grande quantité de ressources, et 0 signifie que le filtre utilise très peu de ressources
filter Spécifie le nom du programme.

^
14 septembre 2016




cups-lpd

cups-lpd

Recevoir des jobs et reporter le status d'imprimante aux clients lpd

   cups-lpd est le service CUPS Line Printer qui supporte les systèmes clients qui utilisent le protocole LDP. Il n'agit pas comme serveur autonome mais opère en utilisant inetd ou systemd.

OPTIONS

-h server[:port] Spécifier le serveur
 -n Désactiver la recherche inverse d'adresse.
-o name=value Insert des options pour toutes les files d'impression.
^
14 septembre 2016




cups-client.conf

cups-client.conf

Fichier de configuration client pour cups

   Le fichier client.conf configure le client CUPS et est normalement localisé dans /etc/cups et/ou ~/.cups.

Directives

AllowAnyRoot Yes|No Spécifie si TLS avec certificat non signés par un autorité de confiance est permis.
AllowExpiredCerts Yes|No Spécifie si TLS avec certificat expiré est permis.
Encryption IfRequested|Never|Required Spécifie le niveau de chiffrement à utiliser
GSSServiceName name Spécifie le nom de service kerberos utilisé pour l'authentification, généralement host, hppt, ou ipp.
ServerName /domain/socket
ServerName hostname-or-ip-address[:port]
ServerName hostname-or-ip-address[:port]/version=1.1 Spécifie l'adresse et optionnellement le port à utiliser pour se connecter au serveur
SSLOptions None|[AllowDH] [AllowRC4] [AllowSSL3] [DenyTLS1.0] Définis les options de chiffrement (uniquement dans /etc/cups/client.conf)
TrustOnFirstUse Yes|No Faire confiance aux nouveaux certificats TLS ou non
User name Username à utiliser pour les requêtes
ValidateCerts Yes|No Accepte ou non les certificats dont le nom commun correspond au nom d'hôte.
^
14 septembre 2016




ipptoolfile

ipptoolfile

Format de fichier ipptool

Le programme ipptool accepte les fichiers texte libre qui décrivent une ou plusieurs requêtes IPP. Par exemple:
# This is a comment
{
    # The name of the test
    NAME "Print PostScript File"
    
    # The request to send
    OPERATION Print-Job
    GROUP operation-attributes-tag
    ATTR charset attributes-charset utf-8
    ATTR language attributes-natural-language en
    ATTR uri printer-uri $uri
    ATTR name requesting-user-name $user
    FILE testfile.ps
    
    # The response to expect
    STATUS successful-ok
    EXPECT job-id OF-TYPE integer WITH-VALUE ؎
    EXPECT job-uri OF-TYPE uri
}
{
    # The name of the test
    NAME "Get Attributes of PostScript Job"
    
    # The request to send
    OPERATION Get-Job-Attributes
    GROUP operation-attributes-tag
    ATTR charset attributes-charset utf-8
    ATTR language attributes-natural-language en
    ATTR uri printer-uri $uri
    ATTR integer job-id $job-id
    ATTR name requesting-user-name $user
    
    # The response to expect
    STATUS successful-ok
    EXPECT job-id OF-TYPE integer WITH-VALUE $job-id
    EXPECT job-uri OF-TYPE uri
    EXPECT job-state OF-TYPE enum WITH-VALUE 3,4,5,6,7,8,9
    EXPECT job-originating-user-name OF-TYPE name WITH-VALUE "$user"
}

Directives top-level

{ test } Définis un test
DEFINE variable-name value Définise une variable. Équivalent à -d variable-name=value.
DEFINE-DEFAULT variable-name value Définis la variable si elle n'a pas de valeur
FILE-ID "identifier" Spécifie un identifiant pour le fichier courant
IGNORE-ERRORS yes|no Spécifie si ipptool ignore les erreurs et continue par défaut.
INCLUDE "filename"|‹filename› Inclure un autre fichier de test. La première forme est relative au fichier courant.
INCLUDE-IF-DEFINED name "filename"|‹filename› Inclure un autre fichier de test si la variable nommée est définie
INCLUDE-IF-NOT-DEFINED name "filename"|‹filename› Inclus un autre fichier de test si la variable nommée n'est pas définie
SKIP-IF-DEFINED variable-name
SKIP-IF-NOT-DEFINED variable-name Spécifie si le reste du fichier test devrait être sauté quand la variable est ou n'est pas définie
STOP-AFTER-INCLUDE-ERROR yes|no Spécifie si les tests sont stoppés après une erreur dans un fichier inclus
TRANSFER auto|chunked|length Spécifie que les tests, par défaut, utilisent "Transfer-Encoding: chunked", ou "Content-Length:". auto utilise le premier avec les fichiers attachés et le second pour les requêtes sans fichier attaché.
VERSION 1.0|1.1|2.0|2.1|2.2 Spécifie le numéro de version IPP par défaut pour les tests.

Directives de test

ATTR tag attribute-name value(s) Ajoute un attribut à la demande de test. les valeurs sont séparées par ','
ATTR collection attribute-name { MEMBER tag member-name value(s) ... } [ ... ,{ ... } ] Ajoute une collection d'attribut à la demande de test. Les attributs membres suivent la même syntaxe que les attributs réguliers et peuvent eux-même être des collections imbriquées. Plusieurs collections peuvent être fournis, séparées par ','
COMPRESSION deflate|gzip|none Compression à utiliser dans le données suivant les attributs dans une requêtes Print-Job ou Send-Document
DELAY seconds délais avant de lancer ce test
DISPLAY attribute-name Spécifique la valeur d'un attribut à sortir dans le rapport de test
EXPECT attribute-name [ predicate(s) ]
EXPECT ?attribute-name predicate(s)
EXPECT !attribute-name Spécifie que la réponse doit|peut|ne doit pas incluse l'attribut nommé. Des prédicats peuvent être ajoutés. Les noms d'attribut peuvent spécifier des attributs membre en les séparant avec un '/' (ex: "media-col/media-size/x-dimension")
EXPECT-ALL attribute-name [ predicate(s) ]
EXPECT-ALL ?attribute-name predicate(s) Spécifie que la réponse doit/peut inclure l'attribut nommé et que toutes les occurrences de cet attriut doivent correspondre au prédicat donné
FILE filename Spécifie un fichier à inclure à la fin de la requête. Généralement utilisé en envoyant un fichier de test d'impression
GROUP tag Spécifie le tag de groupe pour les attributs sous-jacents dans la requête
IGNORE-ERRORS yes|no Spécifie si les erreurs sont ignorées ou non
NAME "literal string" Nom "human-readable" du test
OPERATION operation-code Spécifie l'opération à effectuer
PAUSE "message" Affiche le message fournis et attends que l'utilisateur appuie sur une touche pour continuer
REQUEST-ID ‹number›|random Spécifie le request-id à utiliser dans la requête.
RESOURCE path Chemin de ressource alternatif pour la requête HTTP POST. Par défaut, est pris dans l'URI fournie à ipptool
SKIP-IF-DEFINED variable-name
SKIP-IF-NOT-DEFINED variable-name Spécifie que le test courant devrait sauter quand la variable et ou non définie
SKIP-PREVIOUS-ERROR yes|no Indique si ipptool saute le test courant si le test précédent a généré une erreur
STATUS status-code [ predicate ] Spécifie un valeur de code de status attendus. Un prédicat peut être ajouté
TEST-ID "identifier" Spécifie une chaîne identifiant pour le test courant
TRANSFER auto|chunked|length Spécifie que les tests, par défaut, utilisent "Transfer-Encoding: chunked", ou "Content-Length:". auto utilise le premier avec les fichiers attachés et le second pour les requêtes sans fichier attaché.
VERSION 1.0|1.1|2.0|2.1|2.2 Spécifie le numéro de version IPP par défaut pour ce test

Prédicats attendus

COUNT number Nécessite que l'attribut EXPECT ait le nombre spécifié de valeurs
DEFINE-MATCH variable-name Définis la valiable à 1 quand la condition EXPECT correspond
DEFINE-NO-MATCH variable-name Définis la valiable à 1 quand la condition EXPECT ne correspond pas
DEFINE-VALUE variable-name Définis la variable quand la condition EXPECT correspond
IF-DEFINED variable-name Les conditions EXPECT ne s'appliquent que si la variable spécifiée est définie
IF-NOT-DEFINED variable-name Les conditions EXPECT ne s'appliquent que si la variable spécifiée n'est pas définie
IN-GROUP tag Nécessite que l'attribut EXPECT soit dans le group tag spécifié
OF-TYPE tag[,tag,...] Nécessite l'attribut EXPECT pour utiliser un des tag spécifiés
REPEAT-LIMIT number Spécifie le nombre max de répétitions si le prédicat REPEAT-MATCH ou REPEAT-NO-MATCH est spécifié. Défaut: 1000
REPEAT-MATCH
REPEAT-NO-MATCH Spécifie que le test courant devrait être répété quand la condition EXPECT correspond ou non
SAME-COUNT-AS attribute-name Nécessite que l'attribut EXPECT ait le même nombre de valeurs que l'attribut parallèle spécifié
WITH-ALL-HOSTNAMES "literal string"|"/regular expression/" Nécessite que toutes les valeurs URI contiennent un hostname correspondant
WITH-ALL-RESOURCES "literal string"|"/regular expression/" Nécessite que toutes les valeurs URI contiennent une ressource correspondante (incluant le /)
WITH-ALL-SCHEMES "literal string"|"/regular expression/" Nécessite que toutes les valeurs URI contiennent le schéma correspondant
WITH-ALL-VALUES ‹number|=number|›number|number[.....number]|false|true|"/regular expression/" Nécessite que toutes les valeurs de l'attribut EXPECT corresponde à la chaîne littérale ou la valeur booléenne
WITH-HOSTNAME "literal string"|"/regular expression/" Nécessite qu'au moins une valeur URI contienne un nom d'hôte correspondant
WITH-RESOURCE "literal string"|"/regular expression/" Nécessite qu'au moins une valeur URI contienne une ressource correspondante (incluant le /)
WITH-SCHEME "literal string"|"/regular expression/" Nécessite qu'au moins une valeur URI contienne une schéma correspondant
WITH-VALUE "literal string"|‹number|=number|›number|number[.....number]|false|true|"/regular expression/" Nécessite qu'au moins une valeur de l'attribut EXPECT corresponde aux nombres spécifiés.
WITH-VALUE-FROM attribute-name Nécessite que les valeurs de l'attribut EXPECT correspondent aux valeurs dans l'attribut spécifié (ex: "EXPECT job-sheets WITH-VALUE-FROM job-sheets-supported" nécessite que la valeur job-sheets soit listé dans job-sheets-supported)

Prédicats de status

DEFINE-MATCH variable-name Définis la variable à 1 quand STATUS correspond
DEFINE-NO-MATCH variable-name Définis la variable à 1 quand STATUS ne correspond pas
IF-DEFINED variable-name STATUS s'applique seulement si la variable spécifiée est définie
IF-NOT-DEFINED variable-name STATUS s'applique seulement si la variable spécifiée n'est pas définie
REPEAT-LIMIT number Spécifie le nombre maximum de répetition du test courant. Défaut: 1000
REPEAT-MATCH
REPEAT-NO-MATCH Spécifie que le test courant devrait être répété quand le code de status de réponse correspond ou non à la valeur spécifiée par la directive STATUS

Codes d'opération

Les codes d'opération correspondent aux nombres hexadécimal (0xHHHH) et noms de la rfc2911 et d'autres spécifications d'extension IPP. Voici une liste complète de noms supportés par ipptool:
Activate-Printer
CUPS-Accept-Jobs
CUPS-Add-Modify-Class
CUPS-Add-Modify-Printer
CUPS-Authenticate-Job
CUPS-Delete-Class
CUPS-Delete-Printer
CUPS-Get-Classes
CUPS-Get-Default
CUPS-Get-Devices
CUPS-Get-Document
CUPS-Get-PPD
CUPS-Get-PPDs
CUPS-Get-Printers
CUPS-Move-Job
CUPS-Reject-Jobs
CUPS-Set-Default
Cancel-Current-Job
Cancel-Job
Cancel-Jobs
Cancel-My-Jobs
Cancel-Subscription
Close-Job
Create-Job
Create-Job-Subscriptions
Create-Printer-Subscriptions
Deactivate-Printer
Disable-Printer
Enable-Printer
Get-Job-Attributes
Get-Jobs
Get-Notifications
Get-Printer-Attributes
Get-Printer-Support-Files
Get-Printer-Supported-Values
Get-Subscription-Attributes
Get-Subscriptions
Hold-Job
Hold-New-Jobs
Identify-Printer
Pause-Printer
Pause-Printer-After-Current-Job
Print-Job
Print-URI
Promote-Job
Purge-Jobs
Release-Held-New-Jobs
Release-Job
Renew-Subscription
Reprocess-Job
Restart-Job
Restart-Printer
Resubmit-Job
Resume-Job
Resume-Printer
Schedule-Job-After
Send-Document
Send-Hardcopy-Document
Send-Notifications
Send-URI
Set-Job-Attributes
Set-Printer-Attributes
Shutdown-Printer
Startup-Printer
Suspend-Current-Job
Validate-Document
Validate-Job

Codes de status

Les codes de status correspondent aux nombres hexadécimal (0xHHHH) et noms de la rfc2911 et d'autres spécifications d'extension IPP. Voici une liste complète de noms supportés par ipptool:
client-error-account-authorization-failed
client-error-account-closed
client-error-account-info-needed
client-error-account-limit-reached
client-error-attributes-not-settable
client-error-attributes-or-values-not-supported
client-error-bad-request
client-error-charset-not-supported
client-error-compression-error
client-error-compression-not-supported
client-error-conflicting-attributes
client-error-document-access-error
client-error-document-format-error
client-error-document-format-not-supported
client-error-document-password-error
client-error-document-permission-error
client-error-document-security-error
client-error-document-unprintable-error
client-error-forbidden
client-error-gone
client-error-ignored-all-notifications
client-error-ignored-all-subscriptions
client-error-not-authenticated
client-error-not-authorized
client-error-not-found
client-error-not-possible
client-error-print-support-file-not-found
client-error-request-entity-too-large
client-error-request-value-too-long
client-error-timeout
client-error-too-many-subscriptions
client-error-uri-scheme-not-supported
cups-error-account-authorization-failed
cups-error-account-closed
cups-error-account-info-needed
cups-error-account-limit-reached
cups-see-other
redirection-other-site
server-error-busy
server-error-device-error
server-error-internal-error
server-error-job-canceled
server-error-multiple-document-jobs-not-supported
server-error-not-accepting-jobs
server-error-operation-not-supported
server-error-printer-is-deactivated
server-error-service-unavailable
server-error-temporary-error
server-error-version-not-supported
successful-ok
successful-ok-but-cancel-subscription
successful-ok-conflicting-attributes
successful-ok-events-complete
successful-ok-ignored-notifications
successful-ok-ignored-or-substituted-attributes
successful-ok-ignored-subscriptions
successful-ok-too-many-events

Tags

Les tags correspondent aux noms de la rfc2911 et autres spécifications d'extension IPP . Tags de groupe:
document-attributes-tag
event-notification-attributes-tag
job-attributes-tag
operation-attributes-tag
printer-attributes-tag
subscription-attributes-tag
unsupported-attributes-tag

Tags de valeurs:
admin-define
boolean
charset
collection
dateTime
default
delete-attribute
enum
integer
keyword
mimeMediaType
nameWithLanguage
nameWithoutLanguage
naturalLanguage
no-value
not-settable
octetString
rangeOfInteger
resolution
textWithLanguage
textWithoutLanguage
unknown
unsupported
uri
uriScheme

Variables

   ipptool maintient une liste de variables qui peuvent être utilisées dans les chaînes litérales ou les valeurs d'attribut.

$$ Le caractère $
$ENV[name] Insert la valeur de la variable d'environnement spécifiée
$filename Insert le fichier fournis à ipptool avec l'option -f
$filetype Insert le type mime pour le fichier fournis à ipptool
$hostname Insert le nom d'hôte depuis l'URI fournis à ipptool
$job-id Insert le dernier job-id retourné dans un test
$job-uri Insert le dernier job-uri retourné dans un test
$notify-subscription-id Insert le dernier notify-subscription-ip retourné dans un test
$port Insert le port depuis l'URI fournie à ipptool
$resource Insert le chemin de la ressource depuis l'URI fournie à ipptool
$scheme Insert le schéma depuis l'URI fournie à ipptool
$uri Insert l'URI fournie à ipptool
$uriuser Insert le username depuis l'URI fournie à ipptool
$user Insert l'utilisateur courant
^
14 septembre 2016




cups-files.conf

cups-files.conf

Fichier de configuration des fichiers et répertoires pour cups

   Le fichier cups-files.conf configure les fichiers et répertoires utilisés par le scheduler cupsd. Il est normalement dans /etc/cups

Directives

AccessLog filename|stderr|syslog Définis la destination des logs. défaut: /var/log/cups/access_log
ConfigFilePerm mode Spécifie les permissions pour tous les fichiers de configuration que le scheduler écris. Défaut: 0640.
DataDir path Répertoire où trouver les fichiers de données. Défaut: /usr/share/cups
DocumentRoot directory Spécifie le répertoire root pour l'interface web. Défaut: /usr/share/doc/cups
ErrorLog filename|stderr|syslog Destination des logs d'erreur. Défaut: /var/log/cups/error_log
FatalErrors none|all -kind [ ... -kind ]|kild [ ... -kind ] Spécifie quelles erreurs sont fatales, causant le scheduler à quitter. Défaut: config. peut être none, browse, config, listen, log, permissions ou all.
FileDevice Yes|No Spécifie si le fichier pseudo-device peut être utilisé pour de nouvelles files d'impression. l'URI file:///dev/null est toujours permis
Group group-name-or-number Spécifie le nom du groupe ou son ID qui est utilisé pour exécuter les programmes externes. Défaut est lp ou nobody
LogFilePerm mode Permission de tous les fichiers de log. Défaut: 0644
PageLog filename|stderr|syslog Définis la sortie des logs de page. Défaut: /var/log/cups/page_log
RemoteRoot username Spécifie le username associé avec les accès non-authentifiés par les client se proclamant root. Défaut: remroot
RequestRoot directory Spécifie le répertoire qui contient les jobs d'impression et autres données de requêtes HTTP. Défaut: /var/spool/cups
ServerBin directory Répertoire contenant les backends, programmes CGI, filtres, helpers, notifiers, et monitors. Défaut: /usr/lib/cups ou /usr/libexec/cups
ServerKeyChain path Emplacement des certificats TLS et clés privées. Défaut: /etc/cups/ssl
ServerRoot directory Spécifie le répertoire contenant les fichiers de configuration serveur. Défaut: /etc/cups
SyncOnClose Yes|No Spécifie si le scheduler appelle fsync(2) après avoir écris les fichiers d'état et de configuration. Défaut: No
SystemGroup group-name [ ... group-name ] Spécifie les groupes à utiliser pour @SYSTEM. Défaut contient "admin", "lpadmin", "root", "sys", et/ou "system"
TempDir directory Répertoire où les fichiers temporaires sont stockés. Défaut: /var/spool/cups/tmp
User username Utilisateur ou UID utilisé pour lancer les programmes externes. Défaut: lp
^
11 septembre 2016




cups-snmp.conf

cups-snmp.conf

Fichier de configuration snmp pour cups

   le fichier snmp.conf configure comment les backends réseau standard CUPS (http, https, ipp, ipps, lpd, snmp, et socket) accèdent aux informations des imprimantes en utilisant SNMPv1 et est normalement dans /etc/cups. Les directives Community et DebugLevel sont utilisés par tous les backends. Le reste s'applique seulement au backend SNMP

Directives

Address @IF(name)|@LOCAL|address Envoie les requêtes broadcast (pour la découverte) aux adresses spécifiées.
Community name Nom de communauté à utiliser. Défaut: public
DebugLevel number Niveau de log de 0 à 3. Défaut: 0
DeviceURI "regular expression" device-uri [... device-uri] Spécifie une ou plusieurs URI de périphériques qui devraient être utilisé pour un modèle donné. L'expression régulière est utilisée pour correspondre au model et make détecté, et l'URI doit être sous la forme "scheme://%s[:port]/[path]", où %s représente l'adresse ou le nom d'hôte détecté.
HostNameLookups on|off Spécifie si les adresses des imprimantes devraient être converties en nom d'hôte ou non.
MaxRunTime seconds Spécifie le nombre maximum de secondes que le backend SNMP scan le réseau pour les imprimantes. Défaut: 120 secondes
^
11 septembre 2016




cupsd.conf

cupsd.conf

Fichier de configuration pour cups

Directives top-level

AccessLogLevel config|actions|all Spécifie le niveau de log pour le fichier AccessLog. Le niveau "config" logs quand des imprimantes et classes sont ajoutées, supprimées, ou modifiée et quand les fichiers de configuration sont accédés ou mis à jours. 'actions' log les opérations sur les jobs d'impression.
AutoPurgeJobs Yes|No Spécifie si l'historique des jobs sont automatiquement purgés quand ils ne sont plus requis pour les quotas.
BrowseLocalProtocols all|dnssd|none Spécifie quels protocoles utiliser pour le partage d'impression. défaut: dnssd pour les systèmes supportant Bonjour.
BrowseWebIF Yes|No Spécifie si l'interface web CUPS est annoncée
Browsing Yes|No Spécifie si les imprimantes partagées sont annoncées.
Classification banner Spécifie la classification de sécurité du serveur. Toute bannière valide peut être utilisée, incluant "classified", "confidential", "secret", "topsecret", et "unclassified", ou omis pour désactiver l'impression sécuris
ClassifyOverride Yes|No Spécifie si les utilisateurs remplacent la classification (page de couverture) des jobs d'impression individuels en utilisant l'option job-sheets.
DefaultAuthType Basic|Negotiate Spécifie le type d'authentification à utiliser.
DefaultEncryption Never|IfRequested|Required Spécifie si le chiffrement est utilisé pour les demandes d'authentification.
DefaultLanguage locale Spécifie la langue par défaut à utiliser pour les textes et contenu web.
DefaultPaperSize Auto|None|sizename Spécifie la taille de papier par défaut pour les nouvelles files d'impression. Auto utilise le défaut local.
DefaultShared Yes|No Spécifie si les imprimantes locales sont partagées par défaut
DirtyCleanInterval seconds Délai de mise à jours des fichiers de configuration et d'état. 0 met à jours le plus vite possible. Défaut: 30
ErrorPolicy abort-job|retry-job|retry-this-job|stop-printer Spécifique si une tâche d'impression qui a échouée doit être annulé, retenté ultérieurement, retenté immédiatement, ou stoppe l'imprimante
FilterLimit limit Spécifie le coût maximum des filtres qui sont lancés en concurrence, qui peuvent être utilisés pour minimiser les problèmes de ressource disque, mémoire, et CPU. 0 désactive le filtre. Une impression vers une imprimante non-PostScript doit être à 200, et 100 pour une imprimante PostScript.
FilterNice nice-value valeur nice des filtres lancés pour imprimer un job. de 0 (haute priorité) à 19 (basse priorité)
GSSServiceName name Nom du service en utilisant l'authentification Kerberos. (défaut: http)
HostNameLookups On|Off|Double Spécifie la recherche inversé sur les clients.
IdleExitTimeout seconds Délai d'inactivité avant extinction. Défaut: 60. Uniquement quand cupsd est lancé à la demande.
JobKillDelay seconds Nombre de secondes d'attente avant de terminer les filtres et backends associés avec un job annulé ou en pause. Défaut: 30
JobRetryInterval seconds Spécifie l'interval entre les tentative des jobs. Généralement utilisé pour les files de fax, mais peut également être utilisé quand la stratégie est retry-job, retry-current-job. Défaut: 30
JobRetryLimit count Nombre de tentatives pour les jobs. Défaut: 5
KeepAlive Yes|No Spécifie le support de HTTP keep-alive.
KeepAliveTimeout seconds Spécifie la durée d'inactivité des connexions client
‹Limit operation|method ...› ... ‹/Limit› Spécifie les opérations IPP qui sont limitées dans une section Policy
‹LimitExcept method ...› ... ‹/LimitExcept› Spécifie les méthodes HTTP qui sont limitées dans une sectio Location
LimitRequestBody size Taille maximum des fichiers d'impression, requêtes IPP, et données HTML. Défaut: 0, désactive la limite
Lister ipv4|[ipv6]|*:port|/path/to/domain/socket Spécifie les adresses et port d'écoute du service
ListenBackLog number Nombre de connexions en attente permises. N'affecte que les serveur surchargés qui ont atteints la limite MaxClients.
‹Location /path› ... ‹/Location› Spécifie un contrôle d'accès pour l'emplacement nommé.
LogDebugHistory number Nombre de messages de debug retenus pour le logging si une erreur se produit dans un job.
LogLevel none|emerg|alert|crit|error|warn|notice|info|debug|debug2 Niveau de log pour le fichier ErrorLog
LogTimeFormat standard|usecs Format de la date dans les fichiers de log.
MaxClients number Nombre max de clients simultanné. Défaut: 100
MaxClientsPerHost number Nombre max de clients simultanné pour une seule adresse.
MaxCopies number Nombre max de copies qu'un utilisateur peut imprimer pour chaque job.
MaxHoldTime seconds Temps max qu'un job peut rester dans l'état indéfinis avant qu'il soit annulé. 0 désactive l'annulation
MaxJobs number Nombre max de jobs simultanné permis. 0 désactive la limite
MaxJobsPerPrinter number Nombre max de jobs simultanné par imprimante. 0 == MaxJobs
MaxJobsPerUser number Nombre max de jobs permis par utilisateur. 0 == MaxJobs
MaxJobTime seconds Temps max qu'un job prend à imprimer avant d'être annulé. 0 désactive.
MaxLogSize size Taille maximum des fichiers de log avant rotation. 0 désactive la rotation. Défaut 1048576
MultipleOperationTimeout seconds Délai max permis entre les fichiers dans une tâche d'impression à fichier multiple. Défaut: 300
PageLogFormat format-string Spécifie le format des lignes PageLog.

        %% Insert le caractère %
        %{name} Insert la valeur de l'attribut IPP spécifié
        %C Insert le nombre de copie de la page courante
        %P Insert le numéro de la page courante
        %T Insert la date
        %j Insert le job ID
        %p Insert le nom de l'imprimante
        %u Insert le username

PassEnv variable [ ... variable ] Passe les valiables d'environnement spécifiés aux processus enfant
‹Policy name› ... ‹/Policy› Spécifie un contrôle l'accès pour la stratégie nommée
Port number Port d'écoute
PreserveJobFiles Yes|no|seconds Spécifie si les fichiers sont préservés après impression, ou le délai avant suppression
PreserveJobHistory Yes|No|seconds Spécifie si l'historique d'un job est préservé apres impression.
ReloadTimeout seconds Délai d'attente pour la fin de job avant de redémarrer le scheduler. Défaut: 30
RIPCache size Quantité max de mémoire à utiliser en convertissant les documents en bitsmaps pour une imprimante. Défaut: 128m
ServerAdmin email-address email de l'administrateur du serveur.
ServerAlias hostname [ ... hostname ]|* Utilisé pour la validation d'en-tête HTTP Host quand les clients se connectent au scheduler depuis une interface externe. '*' expose le système à des attaques.
ServerName hostname fqdn du serveur
ServerTokens None|ProductOnly|Major|Minor|Minimal|OS|Full Spécifie quelles informations sont incluses dans l'en-tête Server des réponses HTTP.
SetEnv variable value Définie une variable d'environnement à passer aux processus enfant
SSLListen ipv4|[ipv6]|*:port Adresse d'écoute pour les connexions chiffrées
SSLOptions [AllowRC4] [AllowSSL3]|None Définis les options de chiffrement. CUPS ne supporte que TLSv1.0 et supérieur
SSLPort Port d'écoute pour les connexions chiffrées
StrictConformance Yes|No Spécifie si le scheduler exige que les client adhèrent strictement aux spécifications IPP
Timeout seconds Timeout des requêtes HTTP. Défaut: 300
WebInterface yes|No Active l'interface Web

Méthodes HTTP

GET Utilisé par un client pour télécharger des icônes, et autres ressources d'imprimante et l'accès à l'interface web CUPS
HEAD Utilisé par un client pour obtenir le type, taille, et date de modification des ressources
OPTIONS Utilisé par un client pour établir une connexion sécurisée
POST Utilisé par un client pour envoyer des requêtes IPP et des formulaires HTML depuis l'interface web
PUT Utilisé par un client pour uploader les fichiers de configuration

Opérations IPP

CUPS-Accept-Jobs Permet à une imprimante d'accepter des nouvelles tâches d'impression
CUPS-Add-Modify-Class Ajouter ou modifier une classe d'imprimante
CUPS-Add-Modify-Printer Ajouter ou modifier une imprimante
CUPS-Authenticate-Job Enlever un job en attente d'authentification
CUPS-Delete-Class Supprimer une classe d'imprimante
CUPS-Delete-Printer Supprimer une imprimante
CUPS-Get-Classes Obtenir une liste des classe d'imprimantes
CUPS-Get-Default Obtenir l'imprimante ou la classe d'imprimante par défaut du serveur
CUPS-Get-Devices Obtenir une liste de périphériques disponibles
CUPS-Get-Document Obtenir une file de document pour un job
CUPS-Get-PPD Obtenir un fichier PPD
CUPS-Get-PPDs Obtenir la liste des fichiers PPD installés
CUPS-Get-Printers Obtenir une liste d'imprimantes
CUPS-Move-Job Déplacer un job
CUPS-Reject-Jobs Empêcher une imprimante d'accepter un nouveau job
CUPS-Set-Default Définir l'imprimante ou la classe d'imprimante par défaut du serveur
Cancel-Job Annuler un job
Cancel-Jobs Annuler un ou plusieurs jobs
Cancel-My-Jobs Annuler un ou plusieurs jobs créé par l'utilisateur
Cancel-Subscription Annuler un abonnement
Close-Job Ferme un job qui est en attente pour d'autres documents
Create-Job Créer un nouveau job sans documents
Create-Job-Subscriptions Créer un abonnement pour des événements de job
Create-Printer-Subscriptions Créer un abonnement pour des événements d'imprimante
Get-Job-Attributes Obtenir des informations sur un job
Get-Jobs Obtenir une liste de jobs
Get-Notifications Obtenir une liste de notification d'événements pour un abonnement
Get-Printer-Attributes Obtenir des informations sur une imprimante ou une classe d'imprimante
Get-Subscription-Attributes Obtenir des informations sur des abonnements
Get-Subscriptions Obtenir une liste d'abonnements
Hold-Job retenir un job
Hold-New-Jobs Retenir tous les nouveaux jobs
Pause-Printer Stopper le traitement des jobs par une imprimante ou une classe d'imprimante
Pause-Printer-After-Current-Job Stopper le traitement des jobs par une imprimante ou une classe d'imprimante une fois le job courant terminé
Print-Job Créer un nouveau job avec un seul document
Purge-Jobs Annuler un ou plusieurs jobs et supprimer l'historique des jobs
Release-Held-New-Jobs Permettre aux jobs retenus d'être imprimés
Release-Job Permet d'imprimer un job
Renew-Subscription Renouveler un abonnement
Restart-Job Ré-imprimer un job, si possible
Send-Document Ajouter un document à un job
Set-Job-Attributes Changer les informations de job
Set-Printer-Attributes Changer les informations d'imprimante ou de classe d'imprimante
Validate-Job Valider les options pour un nouveau job

Chemins

/ Le chemin pour toutes les opérations get (get-prinetrs, get-jobs, etc.)
/admin Le chemin pour toutes les opérations d'administration (add-printer, delete-printer, start-printer, etc.)
/admin/conf Le chemin pour l'accès aux fichiers de configuration CUPS (cupsd.conf, client.conf, etc.)
/admin/log Le chemin pour accéder aux fichiers de log de CUPS (access_log, error_log, page_log)
/classes Le chemin pour toutes les classes d'imprimante
/classes/name La ressource pour la classe d'imprimante nommée
/jobs Le chemin pour tous les jobs (hold-job, release-job, etc.)
/jobs/id Le chemin pour le job spécifié
/printers Le chemin pour toutes les imprimantes
/printers/name Le chemin pour l'imprimante nommée
/printers/name.png Le fichier icône pour l'imprimante
/printers/name.ppd Le fichier ppd pour l'imprimante

Directives valides dans les sections Limit et Location

Allow all|none|host.domain.com|*.domain.com|ipv4‹/netmask›|[ipv6]‹/mm›|@IF(name)|@LOCAL Autorise l'accès depuis les hôtes, domaine, adresses, ou interfaces.
AuthType None|Basic|Default|Negotiate Spécifie le type d'authentification requis.
Deny all|none|host.domain.com|*.domain.com|ipv4‹/netmask›|[ipv6]‹/mm›|@IF(name)|@LOCAL Refuse l'accès
Encryption IfRequested|Never|Required spécifie le niveau de chiffrement requis pour un emplacement particulier
Order allow,deny|deny,allow Spécifie l'ordre de parsing des lignes Allow et Deny
Require group group-name [ group-name ... ]
Require user {username|@group-name} ... Spécifie qu'un utilisateur authentifié doit correspondre aux utilisateurs nommés ou membre d'un des groupes nommés. le groupe @SYSTEM correspond à la liste des groupes définis par la directive SystemGroup dans cups-files.conf. @OWNER correspond au propriétaire de la ressource
Require valid-user Spécifique que tout utilisateur authentifié est acceptable
Satisfy all|any Spécifie qu'un client peut acceder à une ressource si l'authentification (AuthType/Require) et/ou les conditions d'adresse (Allow/Deny/Order) sont satisfaits.

Directives valides dans les sections policy

JobPrivateAccess all|default
JobPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM} ... Spécifie une liste d'accès pour les valeurs privées d'un job. default liste vaut "@OWNER @SYSTEM", @ACL map les valeurs requesting-user-name-allowed ou requesting-user-name-denied de l'imprimante.
JobPrivateValues all|default|none|attribute-name[ ... attribute-name ] Spécifie la liste des valeurs de job à rendre privée. default vaut job-name, job-originating-host-name, job-originating-user-name, et phone.
SubscriptionPrivateAccess all|default
SubscriptionPrivateAccess {user|@group|@ACL|@OWNER|@SYSTEM} ... Spécifie une liste d'accès pour les valeurs privées d'un abonnement. default vaut "@OWNER @SYSTEM".
SubscriptionPrivateValues all|default|none|attribute-name [ ... attribute-name ] Spcéifie la liste des valeurs d'abonnement à rendre privée. default vaut notify-events, notify-pull-method, notify-recipient-uri, notify-subscriber-user-name, et notify-user-data
^
11 septembre 2016




printers.conf

printers.conf

Fichier de configuration d'imprimante pour cups

   Le fichier printers.conf définis les imprimantes locales disponible. Il est normalement dans /etc/cups et est maintenu par cupsd. Ce fichier n'est pas prévu pour être édité ou géré manuellement.

^
11 septembre 2016




classes.conf

classes.conf

Fichier de configuration de classe pour cups

   Le fichier classes.conf définis les classes d'imprimantes locales disponibles. Il est normalement dans /etc/cups et est maintenu par cupsd. Ce fichier n'est pas prévu pour être édité ou géré manuellement.

^
11 septembre 2016




subscriptions.conf

subscriptions.conf

Fichier de configuration des abonnements pour cups

   Le fichier subscriptions.conf définis les abonnements aux notifications d'événements locaux qui sont actifs. Il est normalement dans /etc/cups et est maitenu par cupsd. Ce fichier n'est pas prévu pour être édité ou géré manuellement..

^
11 septembre 2016




mailto.conf

mailto.conf

Fichier de configuration pour le notificateur email de cups

   Le fichier mailto.conf définis le serveur de mail local et les préférences de notification par mail pour CUPS

Directives

Cc cc-address@domain.com Spécifie un destinataire additionnel
From from-address@domain.com Émetteur des notifications
Sendmail sendmail command and options Commande sendmail à utiliser pour envoyer les mails.
SMTPServer servername Serveur SMTP pour envoyer les mail.
Subject subject-prefix Spécifie une chaîne préfixe pour la ligne sujet.
^
06 septembre 2016




lpinfo

lpinfo

Afficher les périphériques et pilotes disponibles

OPTIONS

 -E Chiffrer la connexion au serveur
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur
-l Afficher un liste longue.
--device-id id Indiquer l'ID des périphériques IEEE-1284 à faire correspondre lors du parcours de la liste des pilotes avec -m
--exclude-schemes list liste séparée par des virgules de périphériques ou de schémas PPD à exclure du résultat
--include-schemes list liste séparée par des virgules de périphériques ou de schémas PPD à inclure dans le résultat
--language locale Spécifie la langue lors de la création de la liste des pilotes avec -m
--make-and-model name marque et modèle correspondant lors de la création de la liste des pilotes avec -m
--product name Nom du produit à sélectionner lors de la création de la liste des pilotes avec -m
--timeout secondes Délais d'attente lors de la création de la liste des périphériques avec -m

Exemples

Lister tous les périphériques
lpinfo -v
Lister tous les pilotes
lpinfo -m
Lister tous les pilotes correspondants à HP LaserJet
lpinfo --make-and-model "HP LaserJet" -m
^
06 septembre 2016




lpc

lpc

Contrôle d'imprimantes en ligne de commande

   lpc permet de contrôler partiellement les files d’impression des imprimantes et classes d'imprimantes de CUPS et de récupéré l'état des files d'impression. lpc est spécifique au système d'impression de Berkeley, et ne permet pas de configurer les files d'attente de CUPS, utiliser lpadmin pour cela.

Commandes

exit
quit Quitter
Status Affiche l'état des files d'impression
^
05 septembre 2016




cupsctl

cupsctl

Configurer les options cupsd.conf

   cupsctl met à jours ou requête le fichier cupsd.conf.

OPTIONS

 -E Chiffrer la connexion au serveur
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur
--[no-]debug-logging Active/désactive le logging de debuggage dans le fichier error_log
--[no-]remote-admin Active/désactive l'administration à distance
--[no-]remote-any Active/désactive l'impression depuis n'importe quelle adresse
--[no-]share-printers Active/désactive le partage des imprimantes locales avec d'autres machines
--[no-]user-cancel-any Autorise ou non les utilisateurs à annuler des jobs possédés par d'autres.

Exemples

Afficher les paramètres courants
cupsctl
activer le debug
cupsctl --debug-logging
désactiver le partage d'imprimantes
cupsctl --no-share-printers
^
05 septembre 2016




cupsd

cupsd

Planification cups

   cupsd est le planificateur pour CUPS. Il implémente un système d'impression basé sur le protocole d'impression Internet, version 2.1. Par défaut il lit sa configuration dans /etc/cups/cupsd.conf

OPTIONS

-c Fichier de configuration (défaut: /etc/cups/cupsd.conf)
-F Ne lance pas en tâche de fond
-F ne lance pas en tâche de fond et détache le processus du terminal
-l Passé à cupsd quand il est lancé par systemd
-t Test la validité du fichier de configuration.
^
05 septembre 2016




cupsaddsmb

cupsaddsmb

Exporte les imprimante vers samba pour les clients Windows

   Exporte les imprimantes vers samba. En fonction de la configuration de samba, un mot de passe peut être nécessaire. Ce programme nécessite les pilotes d'impression Windows.

Configuration Samba

cupsaddsmb utilise le support d'impression basé sur RPC dans samba pour fournir les pilotes d'impression et les fichiers PPD aux clients Windows. Pour utiliser cette fonctionnalité, samba doit être configuré pour le supporte de l'impression via CUPS et fournir un partage pour le téléchargement des pilotes:
[global]
load printers = yes
printing = cups
printcap name = cups
    
[printers]
comment = All Printers
path = /var/spool/samba
browseable = no
public = yes
guest ok = yes
writable = no
printable = yes
    
[print$]
comment = Printer Drivers
path = /etc/samba/drivers
browseable = yes
guest ok = no
read only = yes
write list = root

Le pilote de base pour Windows 2000 et supérieur et le pilote Microsoft PostScript, qui est disponible dans tous les systèmes Windows dans %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 et %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3. Copier les pilotes 32bits dans /usr/share/cups/drivers/ et les pilotes 64bits dans /usr/share/cups/drivers/x64/:
ps5ui.dll
pscript.hlp
pscript.ntf
pscript5.dll

   Note: La casse est importante

OPTIONS

-H samba-server Spécifie le serveur samba par défaut
-U samba-user[%samba-password] admin/password d'impression samba
-a Exporte toutes les imprimantes connues
-h cups-server[:port] Spécifie un serveur CUPS alternatif à utiliser
-v mode verbeux
^
05 septembre 2016




cupsaccept

cupsaccept, cupsreject, accept, reject

Accepter/rejeter les jobs envoyés à une destination

   cupsaccept autorise les jobs d'impression vers les destinations. cupsreject les refuse.

OPTIONS

 -E Chiffrer la connexion au serveur
-U Spécifier un identifiant alternatif
-h server[:port] Spécifier le serveur
-r "reason" Définir une raison pour le rejet du job.