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)
11 septembre 2016

cups printer           Impression


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