.\" .\" cupsd.conf man page for CUPS. .\" .\" Copyright © 2020-2023 by OpenPrinting. .\" Copyright © 2007-2019 by Apple Inc. .\" Copyright © 1997-2006 by Easy Software Products. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH cupsd.conf 5 CUPS "1er octobre 2021" OpenPrinting .SH NOM cupsd.conf \- Fichier de configuration du serveur CUPS. .SH DESCRIPTION Le fichier \fIcupsd.conf\fP configure l’ordonnanceur de CUPS, \fBcupsd\fP(8). Il est habituellement situé dans le répertoire \fI/etc/cups\fP. Chaque ligne de ce fichier est soit une directive de configuration, une ligne vide ou un commentaire. Les directives de configuration consistent classiquement en un nom suivi de zéro ou plusieurs valeurs séparées par des espaces. Les noms des directives de configuration et les valeurs ne sont pas sensibles à la casse. Les lignes de commentaires débutent par le caractère «\ #\ ». .SS "DIRECTIVES PRINCIPALES" .\"#AccessLogLevel Les directives principales suivantes sont comprises par \fBcupsd\fP(8)\ : .TP 5 \fBAccessLogLevel\fP \fIconfig\fP .TP 5 \fBAccessLogLevel\fP \fIactions\fP .TP 5 \fBAccessLogLevel\fP \fIall\fP .\"#AutoPurgeJobs Indiquer le niveau de journalisation pour le fichier \fIAccessLog\fP. Le niveau «\ config\ » écrit dans le journal lorsque des imprimantes et des classes sont ajoutées, supprimées ou modifiées, et lors d’un accès ou mise à jour de fichiers de configuration. Le niveau «\ actions\ » écrit dans le journal lorsque des travaux d’impression sont demandés, mis en attente, terminés, modifiés ou annulés, et quelque soit l’état de «\ config\ ». Le niveau «\ all\ » écrit dans le journal toutes les requêtes. Le niveau de journalisation par défaut est «\ actions\ ». .TP 5 \fBAutoPurgeJobs\fP \fIYes\fP .TP 5 \fBAutoPurgeJobs\fP \fINo\fP .br .\"#BrowseDNSSDSubTypes Définir s'il faut purger automatiquement l'historique des travaux lorsque les données ne sont plus nécessaires pour l'application des quotas. Par défaut, «\ No\ » .TP 5 \fBBrowseDNSSDSubTypes\fP\fI_subtype[,...]\fP .\"#BrowseLocalProtocols Indiquer une liste de sous\-types à publier pour chaque imprimante partagée. Par exemple, «\ BrowseDNSSDSubTypes _cups,_print\ » indiquera aux clients réseau que le partage CUPS et IPP Everywhere seront gérés. La valeur par défaut est «\ _cups\ » qui est nécessaire pour que le partage d’imprimante fonctionne entre les systèmes utilisant CUPS. .TP 5 \fBBrowseLocalProtocols\fP \fIall\fP .TP 5 \fBBrowseLocalProtocols\fP \fIdnssd\fP .TP 5 \fBBrowseLocalProtocols\fP \fInone\fP .\"#BrowseWebIF Indiquer quels protocoles utiliser pour le partage des imprimantes locales. «\ dnssd\ » par défaut sur les systèmes qui prennent en charge «\ Bonjour\ » et «\ none\ » autrement. .TP 5 \fBBrowseWebIF\fP \fIYes\fP .TP 5 \fBBrowseWebIF\fP \fINo\fP .br .\"#Browsing Indiquer si l'interface web de CUPS est annoncée. Par défaut «\ No\ ». .TP 5 \fBBrowsing\fP \fIYes\fP .TP 5 \fBBrowsing\fP \fINo\fP .br .\"#DefaultAuthType Définir si les imprimantes partagées sont annoncées. Par défaut «\ No\ ». .TP 5 \fBDefaultAuthType\fP \fIBasic\fP .br .\"#DefaultEncryption Définir le type d'identification à utiliser par défaut. Par défaut «\ Basic\ ». .TP 5 \fBDefaultEncryption\fP \fINever\fP .TP 5 \fBDefaultEncryption\fP \fIIfRequested\fP .TP 5 \fBDefaultEncryption\fP \fIRequired\fP .\"#DefaultLanguage Indiquer si le chiffrement doit être utilisé pour les requêtes authentifiées.Par défaut, «\ Required\ ». .TP 5 \fBDefaultLanguage\fP \fIlocale\fP .\"#DefaultPaperSize Définir la langue par défaut à utiliser pour les textes et le site web. Par défaut, «\ en\ ». .TP 5 \fBDefaultPaperSize\fP \fIAuto\fP .TP 5 \fBDefaultPaperSize\fP \fINone\fP .TP 5 \fBDefaultPaperSize\fP \fInom_format\fP .\"#DefaultPolicy Indiquer la taille de papier par défaut pour les nouvelles files d'impression. «\ Auto\ » utilise une valeur par défaut selon la localisation, alors que «\ None\ » indique qu'il n'y a pas de taille de papier par défaut.Les noms de taille spécifiques sont couramment «\ Letter\ » ou «\ A4\ ». Par défaut «\ Auto\ ». Remarque\ : la taille par défaut doit être un nom de taille issue du fichier PPD et pas un nom de taille de média auto\-descriptif du Printer Working Group. .TP 5 \fBDefaultPolicy\fP \fInom_politique\fP .\"#DefaultShared Indiquer la politique d'accès par défaut. Par défaut, «\ default\ ». .TP 5 \fBDefaultShared\fP \fIYes\fP .TP 5 \fBDefaultShared\fP \fINo\fP .\"#DirtyCleanInterval Indiquer si les imprimantes locales sont partagées par défaut. Par défaut, «\ Yes\ » .TP 5 \fBDirtyCleanInterval\fP \fIsecondes\fP .\"#DNSSDHostName Indiquer le délai pour mettre à jour les fichiers de configuration et d'état. Une valeur de \fB0\fP fait que la mise à jour se fera dès que possible, généralement en quelques millisecondes. Par défaut, \fB30\fP. .TP 5 \fBDNSSDHostName\fP\fIhostname.example.com\fP .\"#ErrorPolicy Définir le nom de domaine pleinement qualifié du serveur qui est utilisé pour l’échange de Bonjour. Par défaut, c’est classiquement le nom d’hôte «\ .local\ » du serveur. .TP 5 \fBErrorPolicy\fP \fIabort\-job\fP Indiquer qu’une tâche d’impression ayant échoué sera supprimée à moins d’indication contraire pour l’imprimante. .TP 5 \fBErrorPolicy retry\-current\-job\fP Indiquer qu’une tâche d’impression ayant échoué sera recommencée immédiatement à moins d’indication contraire pour l’imprimante. .TP 5 \fBErrorPolicy\fP \fIretry\-job\fP Indiquer qu’une tâche d’impression ayant échoué sera recommencée plus tard à moins d’indication contraire pour l’imprimante. .TP 5 \fBErrorPolicy\fP \fIstop\-printer\fP .\"#FilterLimit Indiquer qu’une tâche d’impression ayant échouée stoppera l’imprimante à moins d’une indication contraire pour l’imprimante. Par défaut, c’est la politique d’erreur «\ stop\-printer\ ». .TP 5 \fBFilterLimit \fP\fIlimite\fP .\"#FilterNice Indiquer le coût maximal des filtres exécutés simultanément, qui peuvent être utilisés pour minimiser les problèmes de ressources disque, mémoire et CPU. Une limite de \fB0\fP désactive la limitation de filtres. Une impression moyenne avec une imprimante non PostScript nécessite une limite de filtres d’environ \fB200\fP. Une imprimante PostScript en nécessite à peu près la moitié\ (100). Régler la limite sous ces seuils limitera la faculté de l’ordonnanceur d’imprimer un travail unique à tout instant. Par défaut, la limite vaut \fB0\fP. .TP 5 \fBFilterNice\fP \fIpriorité\fP Définir la priorité d’ordonnancement (voir \fBnice\fP(8)) des filtres exécutés pour une impression. La valeur «\ nice\ » varie de \fB0\fP, la priorité la plus haute, à \fB19\fP, la priorité la plus basse. Par défaut \fB0\fP. .TP 5 .\"#HostNameLookups \fBHostNameLookups\fP \fIOn\fP .TP 5 \fBHostNameLookups\fP \fIOff\fP .TP 5 \fBHostNameLookups\fP \fIDouble\fP .\"#IdleExitTimeout Effectuer des recherches inverses sur les clients connectés. Le réglage «\ Double\ » oblige \fBcupsd\fP(8) à vérifier que le nom d’hôte obtenu à partir de l’adresse corresponde à une des adresses renvoyées pour ce nom d’hôte. Les recherches doubles évitent que les clients avec des adresses non enregistrées ne se connectent au serveur. Par défaut, «\ Off\ » pour éviter des problèmes de performance de serveur lors de recherche doubles. Ne réglez cette option à «\ On\ » ou «\ Double\ » qu’en cas d’absolue nécessité. .TP 5 \fBIdleExitTimeout\fP \fIsecondes\fP .\"#JobKillDelay Indiquer la durée d’attente avant l’extinction suite à l’inactivité. La valeur par défaut est \fB60\fP\ secondes. REMARQUE\ : uniquement applicable si \fBcupsd\fP(8) est exécuté à la demande (par exemple, avec \fB\-l\fP). .TP 5 \fBJobKillDelay\fP \fIsecondes\fP .\"#JobRetryInterval Indiquer le nombre de secondes à attendre avant de tuer les filtres et les processus d'arrière\-plan associés à une tâche suspendue ou annulée. Par défaut \fB30\fP. .TP 5 \fBJobRetryInterval\fP \fIsecondes\fP .\"#JobRetryLimit Indiquer le délai en seconde avant une nouvelle tentative pour effectuer les travaux. Cela est habituellement utilisé dans les files d’attente de fax, mais peut être utilisé pour les files d’impression normales dont la politique d’erreur est «\ retry\-job\ » ou «\ retry\-current\-job\ ». Par défaut, \fB30\fP. .TP 5 \fBJobRetryLimit\fP \fInombre\fP .\"#KeepAlive Indiquer le nombre d’essais faits pour les travaux. Cela est habituellement utilisé dans les files d’attente de fax, mais peut être utilisé pour les files d’impression normales dont la politique d’erreur est «\ retry\-job\ » ou «\ retry\-current\-job\ ». Par défaut, \fB5\fP. .TP 5 \fBKeepAlive\fP \fIYes\fP .TP 5 \fBKeepAlive\fP \fINo\fP .\"#LimitIPP Définir s'il faut prendre en charge les connexions keep\-alive HTTP. Par défaut, «\ Yes\ ». .TP 5 \fB \fP... \fB\fP .\"#Limit Indiquer les opérations IPP limitées dans une section Politique. Les noms d’opération sont listés ci\-dessous dans la section «\ NOMS OPÉRATIONS\ IPP\ ». .TP 5 \fB \fP... \fB\fP .\"#LimitExcept .TP 5 \fB \fP... \fB\fP .\"#LimitRequestBody Indiquer les méthodes HTTP limitées dans une section Location. Les noms de méthode sont listés ci\-dessous dans la section «\ NOMS MÉTHODES\ HTTP\ ». .TP 5 \fBLimitRequestBody \fP\fItaille\fP .\"#Listen Indiquer la taille maximale des fichiers d’impression, des requêtes IPP et des données de type HTML. Par défaut, \fB0\fP qui supprime la vérification de limite. .TP 5 \fBListen\fP \fIadresse_ipv4\fP\fB:\fP\fIport\fP .TP 5 \fBListen\fP [\fIadresse_ipv6\fP]\fB:\fP\fIport\fP .TP 5 \fBListen *:\fP\fIport\fP .TP 5 \fBListen\fP \fI/chemin/vers/socket/domaine\fP .\"#Location Écouter les adresse et port indiqués, ou le chemin vers le socket de domaine pour des connexions. Plusieurs directives Listen peuvent être fournies pour écouter plusieurs adresses. La directive Listen est similaire à la directive Port, mais permet de limiter l’accès à des interfaces ou réseaux particuliers. Remarque\ : «\ Listen *:\fIport\fP\ » et «\ Port \fIport\fP\ » écoutent effectivement toutes les adresses IP, aussi il n’est pas possible de les combiner avec des directives Listen pour des adresses explicites IPv4 ou IPv6 sur le même port. .TP 5 \fB \fP... \fB\fP .\"#LogDebugHistory Définir les contrôles d'accès pour un emplacement donné. Les chemins sont documentés dans la section «\ CHEMINS D’ACCÈS\ » .TP 5 \fBLogDebugHistory \fP\fInombre\fP .\"#LogLevel Indiquer le nombre de messages de débogage retenus pour être journalisés lorsqu'une erreur se produit lors d'une tâche d'impression. Les messages de débogage sont journalisés en fonction du réglage LogLevel. .TP 5 \fBLogLevel\fP \fInone\fP .TP 5 \fBLogLevel\fP \fIemerg\fP .TP 5 \fBLogLevel\fP \fIalert\fP .TP 5 \fBLogLevel\fP \fIcrit\fP .TP 5 \fBLogLevel\fP \fIerror\fP .TP 5 \fBLogLevel\fP \fIwarn\fP .TP 5 \fBLogLevel\fP \fInotice\fP .TP 5 \fBLogLevel\fP \fIinfo\fP .TP 5 \fBLogLevel\fP \fIdebug\fP .TP 5 \fBLogLevel\fP \fIdebug2\fP .\"#LogTimeFormat Indiquer le niveau de journalisation pour le fichier \fIErrorLog\fP. La valeur «\ none\ » arrête toute journalisation, tandis que «\ debug\ » journalise tout. Par défaut, «\ warn\ ». .TP 5 \fBLogTimeFormat\fP \fIstandard\fP .TP 5 \fBLogTimeFormat\fP \fIusecs\fP .\"#MaxClients Indiquer le format de date et heure dans les fichiers de journalisation. Par défaut, la valeur est «\ standard\ » et les secondes complètes sont notées, tandis que si égale à «\ usecs\ » les microsecondes sont notées. .TP 5 \fBMaxClients\fP \fInombre\fP .\"#MaxClientPerHost Définir le nombre maximal de clients simultanés autorisés par l’ordonnanceur. Par défaut, \fB100\fP .TP 5 \fBMaxClientsPerHost\fP \fInombre\fP .\"#MaxCopies Définir le nombre maximal de clients simultanés autorisés provenant de la même adresse. Par défaut c’est la valeur de MaxClients. .TP 5 \fBMaxCopies\fP \fInombre\fP .\"#MaxHoldTime Définir le nombre maximal de copies qu'un utilisateur peut effectuer pour un travail d'impression. Par défaut, \fB9999\fP. .TP 5 \fBMaxHoldTime\fP \fIsecondes\fP .\"#MaxJobs Indiquer la durée maximale pendant laquelle une tâche peut rester en état «\ indéfini\ » avant d'être annulée. Par défaut \fB0\fP, qui désactive l'annulation des tâches suspendues. .TP 5 \fBMaxJobs\fP \fInombre\fP .\"#MaxJobsPerPrinter Indiquer le nombre maximal de travaux simultanés autorisés. Définir à \fB0\fP pour un nombre illimité de travaux. Par défaut, \fB500\fP. .TP 5 \fBMaxJobsPerPrinter\fP \fInombre\fP .\"#MaxJobsPerUser Définir le nombre maximal de travaux simultanés autorisés par imprimante. Par défaut, \fB0\fP, qui autorise MaxJobs par imprimante. .TP 5 \fBMaxJobsPerUser\fP \fInombre\fP .\"#MaxJobTime Définir le nombre maximal de travaux simultanés autorisés par utilisateur. Par défaut, \fB0\fP, qui autorise MaxJobs par utilisateur. .TP 5 \fBMaxJobTime\fP \fIsecondes\fP .\"#MaxLogSize Indiquer le temps maximal qu'une tâche peut prendre pour imprimer avant d'être annulée. Indiquer \fB0\fP pour désactiver l'annulation de tâches bloquées. La valeur par défaut est de 10\ 800\ secondes (3\ heures). .TP 5 \fBMaxLogSize \fP\fItaille\fP .\"#MaxSubscriptions Définir la taille maximale des fichiers de journaux avant archivage. La valeur \fB0\fP désactive cet archivage. Par défaut, \fB1048576\fP (1MB). .TP 5 \fBMaxSubscriptions \fP\fInombre\fP .\"#MaxSubscriptionsPerJob Indiquer le nombre maximal d’abonnements à des évènements simultanés. Définir à \fB0\fP pour un nombre illimité d’abonnements. Par défaut, \fB500\fP. .TP 5 \fBMaxSubscriptionsPerJob \fP\fInombre\fP .\"#MaxSubscriptionsPerPrinter Définir le nombre maximal d’abonnements d’évènements simultanés autorisés par tâche. Par défaut, \fB0\fP, qui autorise MaxSubscriptions abonnements par tâche. .TP 5 \fBMaxSubscriptionsPerPrinter \fP\fInombre\fP .\"#MaxSubscriptionsPerUser Définir le nombre maximal d’abonnements à des évènements simultanés autorisés par imprimante. Par défaut, \fB0\fP, qui autorise MaxSubscriptions abonnements par imprimante. .TP 5 \fBMaxSubscriptionsPerUser \fP\fInombre\fP .\"#MultipleOperationTimeout Définir le nombre maximal d’abonnements à des évènements simultanés autorisés par utilisateur. Par défaut, \fB0\fP, qui autorise MaxSubscriptions abonnements par utilisateur. .TP 5 \fBMultipleOperationTimeout\fP \fIsecondes\fP .\"#Policy Indiquer le temps maximal à allouer entre les fichiers dans une tâche d'impression de fichiers multiples. Par défaut, \fB900\fP (15\ minutes). .TP 5 \fB \fP... \fB\fP .\"#Port Définir les contrôles d'accès pour la politique donnée. .TP 5 \fBPort\fP \fInombre\fP .\"#PreserveJobFiles Écouter sur le numéro de port indiqué pour des connexions. .TP 5 \fBPreserveJobFiles\fP \fIYes\fP .TP 5 \fBPreserveJobFiles\fP \fINo\fP .TP 5 \fBPreserveJobFiles\fP \fIsecondes\fP .\"#PreserveJobHistory Indiquer si les fichiers des travaux (documents) doivent être préservés après l’impression. Si une valeur numérique est indiquée, les fichiers des travaux seront conservés durant le nombre de secondes indiqué après l’impression. Par défaut, \fB86400\fP (conservation durant un jour). .TP 5 \fBPreserveJobHistory\fP \fIYes\fP .TP 5 \fBPreserveJobHistory\fP \fINo\fP .TP 5 \fBPreserveJobHistory\fP \fIsecondes\fP .\"#ReadyPaperSizes Indiquer si l’historique des travaux est conservé après l’exécution d’un travail. Si une valeur numérique est indiquée, les fichiers des travaux seront conservés durant le nombre de secondes indiqué après l’impression. Si «\ Yes\ », l’historique est conservé jusqu’à atteindre la limite MaxJobs. Par défaut, «\ Yes\ ». .TP 5 \fBReadyPaperSizes \fP\fInom_format[,...]\fP .\"#ReloadTimeout Indiquer une liste de tailles possibles de papier qui sont signalées comme «\ ready\ » (chargées). La liste réelle ne contient que les tailles que chaque imprimante accepte. Par défaut, cela est «\ Letter,Legal,Tabloid,4x6,Env10\ » quand la taille par défaut est «\ Letter\ » et «\ A3,A4,A5,A6,EnvDL\ » autrement. Remarque\ : ces tailles doivent utiliser des noms de tailles issus du fichier PPD et non les noms auto\-descriptifs du PWG. .TP 5 \fBReloadTimeout\fP \fIsecondes\fP .\"#ServerAdmin Définir le temps maximal à attendre pour la fin d'un travail avant de redémarrer l'ordonnanceur. Par défaut, \fB30\fP. .TP 5 \fBServerAdmin \fP\fIadresse_courriel\fP .\"#ServerAlias Définir l'adresse électronique de l'administrateur du serveur. Par défaut, «\ root@ServerName\ ». .TP 5 \fBServerAlias\fP \fInom_hôte\fP [... \fInom_hôte\fP] .TP 5 \fBServerAlias *\fP .\"#ServerName La directive ServerAlias est utilisée pour la validation des en\-têtes HTTP de l’hôte lorsque les clients se connectent à l’ordonnanceur à partir d’interfaces externes. L’utilisation du caractère spécial «\ *\ » peut conduire à des attaques par rebouclage, même derrière un pare\-feu. Si la recherche automatique de nom alternatif ne fonctionne pas, l’établissement d’une liste de chaque nom alternatif avec une directive ServerAlias est recommandée de préférence à l’utilisation de «\ *\ ». .TP 5 \fBServerName\fP \fInom_hôte\fP .\"#ServerTokens Définir le nom d’hôte complet du serveur. Par défaut, la valeur indiquée par la commande \fBhostname\fP(1) est utilisée. .TP 5 \fBServerTokens\fP \fINone\fP .TP 5 \fBServerTokens\fP \fIProductOnly\fP .TP 5 \fBServerTokens\fP \fIMajor\fP .TP 5 \fBServerTokens\fP \fIMinor\fP .TP 5 \fBServerTokens\fP \fIMinimal\fP .TP 5 \fBServerTokens\fP \fIOS\fP .TP 5 \fBServerTokens\fP \fIFull\fP .\"#SSLListen Indiquer l’information à inclure dans l’en\-tête du serveur pour les réponses HTTP. «\ None\ » désactive l’en\-tête, «\ ProductOnly\ » renvoie «\ CUPS\ », «\ Major\ » renvoie «\ CUPS/major IPP/2», «\ Minor\ » renvoie «\ CUPS/major.minor IPP/2.1\ », «\ Minimal\ » renvoie «\ CUPS/major.minor.patch IPP/2.1\ », «\ OS\ » renvoie «\ CUPS/major.minor.path (nom et version du système d’exploitation) IPP/2.1\ », «\ Full\ » renvoie «\ CUPS/major.minor.path (nom et version du système d’exploitation; architecture) IPP/2.1\ ». Par défaut, «\ Minimal\ ». .TP 5 \fBSSLListen\fP \fIadresse_ipv4\fP\fB:\fP\fIport\fP .TP 5 \fBSSListen\fP \fIadresse_ipv6\fP\fB:\fP\fIport\fP .TP 5 \fBSSListen *:\fP\fIport\fP .\"#SSLOptions Écouter à l'adresse et au port indiqués pour les connexions sécurisées. .TP 5 .TP 5 \fBSSLOptions \fP[\fIAllowDH\fP] [\fIAllowRC4\fP] [\fIAllowSSL3\fP] [\fIDenyCBC\fP] [\fIDenyTLS1.0\fP] [\fIMaxTLS1.0\fP] [\fIMaxTLS1.1\fP] [\fIMaxTLS1.2\fP] [\fIMaxTLS1.3\fP] [\fIMinTLS1.0\fP] [\fIMinTLS1.1\fP] [\fIMinTLS1.2\fP] [\fIMinTLS1.3\fP] .TP 5 \fBSSLOptions\fP \fINone\fP .\"#SSLPort Définir les options de chiffrement (seulement dans \fI/etc/cups/client.conf\fP). Par défaut, CUPS prend en charge le chiffrement avec TLS versions\ 1.0 ou postérieures en utilisant les suites de chiffrement fiables. La sécurité est diminuée lorsque des options \fIAllow\fP sont utilisées. La sécurité est améliorée lorsque des options \fIDeny\fP sont utilisées. L’option \fIAllowDH\fP autorise les suites de chiffrement utilisant la négociation de clefs stricte Diffie\-Hellman (non prise en charge sur les systèmes utilisant GNU\ TLS). L’option \fIAllowRC4\fP autorise les suites de chiffrement RC4 128\ bits qui sont nécessaires pour quelques clients anciens. L’option \fIAllowSSL3\fP autorise SSL version\ 3.0 nécessaire pour certains anciens clients qui ne prennent pas en charge TLS version\ 1.0. L’option \fIDenyCBC\fP désactive toutes les suites de chiffrement CBC. L’option \fIDenyTLS1.0\fP désactive la prise en charge de TLS version\ 1.0 —\ cela oblige la version minimale du protocole à TLS version\ 1.1. Les options \fIMinTLS\fP définissent la version minimale de TLS à prendre en charge. Les options \fIMaxTLS\fP définissent la version maximale de TLS à prendre en charge. Tous les systèmes d’exploitation ne gèrent pas TLS version\ 1.3 actuellement. .TP 5 \fBSSLPort \fP\fIport\fP .\"#StrictConformance Écouter sur le port indiqué pour les connexions sécurisées. .TP 5 \fBStrictConformance\fP \fIYes\fP .TP 5 \fBStrictConformance\fP \fINo\fP .\"#Timeout Indiquer si l'ordonnanceur exige que les clients adhèrent strictement aux spécifications IPP. La valeur par défaut est «\ Non\ ». .TP 5 \fBTimeout\fP \fIsecondes\fP .\"#WebInterface Définir le délai d'attente des requêtes HTTP. Par défaut, \fB900\fP (15\ minutes). .TP 5 \fBWebInterface\fP \fIyes\fP .TP 5 \fBWebInterface\fP \fIno\fP Indiquer si l'interface web est activée. Par défaut, «\ No\ ». .SS "NOMS DES MÉTHODES HTTP" Les méthodes suivantes sont reconnues par \fBcupsd\fP(8)\ : .TP 5 GET Téléchargement par un client d’icônes ou d’autres ressources de l’imprimante et accession à l’interface web de CUPS. .TP 5 HEAD Obtention par un client du type, taille et modifications de la date des ressources. .TP 5 OPTIONS Établissement par un client d’une connexion sécurisée (SSL ou TLS). .TP 5 POST Soumission par un client d’une requête IPP et d’un formulaire HTML à partir de l’interface web de CUPS. .TP 5 PUT Téléversement par un client de fichiers de configuration. .SS "NOMS D’OPÉRATIONS IPP" Les opérations IPP suivantes sont reconnues par \fBcupsd\fP(8)\ : .TP 5 CUPS\-Accept\-Jobs Permettre à l'imprimante d’accepter de nouveaux travaux d'impression. .TP 5 CUPS\-Add\-Modify\-Class Ajouter ou modifier une classe d'imprimantes. .TP 5 CUPS\-Add\-Modify\-Printer Ajouter ou modifier une imprimante. .TP 5 CUPS\-Authenticate\-Job Valider un travail mis en attente pour authentification. .TP 5 CUPS\-Delete\-Class Supprimer une classe d'imprimantes. .TP 5 CUPS\-Delete\-Printer Supprimer une imprimante. .TP 5 CUPS\-Get\-Classes Obtenir une liste de classes d'imprimantes. .TP 5 CUPS\-Get\-Default Obtenir l’imprimante ou la classe d’imprimantes par défaut du serveur. .TP 5 CUPS\-Get\-Devices Obtenir la liste des périphériques disponibles à ce moment. .TP 5 CUPS\-Get\-Document Obtenir un fichier de document à imprimer. .TP 5 CUPS\-Get\-PPD Obtenir un fichier PPD. .TP 5 CUPS\-Get\-PPDs Obtenir la liste des fichiers installés. .TP 5 CUPS\-Get\-Printers Obtenir la liste des imprimantes. .TP 5 CUPS\-Move\-Job Déplacer un travail. .TP 5 CUPS\-Reject\-Jobs Empêcher une imprimante d’accepter de nouveaux travaux. .TP 5 CUPS\-Set\-Default Définir l’imprimante ou la classe d’imprimantes par défaut du serveur. .TP 5 Cancel\-Job Annuler un travail. .TP 5 Cancel\-Jobs Annuler un ou plusieurs travaux. .TP 5 Cancel\-My\-Jobs Annuler un ou plusieurs travaux d’un utilisateur. .TP 5 Cancel\-Subscription Annuler un abonnement. .TP 5 Close\-Job Arrêter un travail attendant plus de documents. .TP 5 Create\-Job Créer un nouveau travail sans document. .TP 5 Create\-Job\-Subscriptions Créer un abonnement pour les évènements concernant les travaux. .TP 5 Create\-Printer\-Subscriptions Créer un abonnement pour les évènements concernant les imprimantes. .TP 5 Get\-Job\-Attributes Obtenir des informations concernant un travail. .TP 5 Get\-Jobs Obtenir la liste des travaux. .TP 5 Get\-Notifications Obtenir la liste des notifications d’évènement pour un abonnement. .TP 5 Get\-Printer\-Attributes Obtenir des informations sur une imprimante ou une classe. .TP 5 Get\-Subscription\-Attributes Obtenir des informations à propos d’un abonnement. .TP 5 Get\-Subscriptions Obtenir une liste d’abonnements. .TP 5 Hold\-Job Suspendre l'impression d'un travail. .TP 5 Hold\-New\-Jobs Suspendre l'impression de tous les nouveaux travaux. .TP 5 Pause\-Printer Arrêter le déroulement des travaux pour une imprimante ou une classe. .TP 5 Pause\-Printer\-After\-Current\-Job Arrêter le déroulement des travaux pour une imprimante ou une classe après le travail en cours. .TP 5 Print\-Job Créer un nouveau travail avec un document unique. .TP 5 Purge\-Jobs Annuler un ou plusieurs travaux et supprimer l’historique des travaux. .TP 5 Release\-Held\-New\-Jobs Autoriser des travaux précédemment suspendus. .TP 5 Release\-Job Autoriser l’impression d’un travail. .TP 5 Renew\-Subscription Renouveler un abonnement. .TP 5 Restart\-Job Réimprimer un travail si possible. .TP 5 Send\-Document Ajouter un document au travail. .TP 5 Set\-Job\-Attributes Modifier l’information sur le travail. .TP 5 Set\-Printer\-Attributes Modifier l’information sur une imprimante ou une classe d’imprimantes. .TP 5 Validate\-Job Valider les options pour un nouveau travail. .SS "CHEMINS D’ACCÈS" Les chemins suivants sont couramment utilisés lors de la configuration de \fBcupsd\fP(8)\ : .TP 5 / Chemin pour toutes les opérations «\ get\ » (get\-printers, get\-jobs,\ etc.) .TP 5 /admin Chemin pour toutes les opérations d’administration (add\-printer, delete\-printer, start\-printer,\ etc.) .TP 5 /admin/conf Chemin pour accéder aux fichiers de configuration de CUPS (cupsd.conf, client.conf,\ etc.) .TP 5 /admin/log Chemin pour accéder aux fichiers de journal de CUPS (access_log, error_log, page_log). .TP 5 /classes Chemin pour toutes les classes d’imprimantes. .TP 5 /classes/nom Ressource pour la classe d’imprimantes nommée. .TP 5 /jobs Chemin pour tous les travaux (hold\-job, release\-job,\ etc.) .TP 5 /jobs/id Chemin pour le travail indiqué. .TP 5 /printers Chemin pour toutes les imprimantes. .TP 5 /printers/nom Chemin pour l'imprimante nommée. .TP 5 /printers/nom.png Chemin du fichier de l’icône pour l'imprimante donnée. .TP 5 /printers/nom.ppd Chemin du fichier PPD pour l'imprimante donnée. .SS "DIRECTIVES VALABLES DANS LES SECTIONS CHEMINS ET LIMITES " Les directives suivantes peuvent être utilisées dans les sections Chemins et Limites dans le fichier \fIcupsd.conf\fP\ : .TP 5 \fBAllow\fP \fIall\fP .TP 5 \fBAllow\fP \fInone\fP .TP 5 \fBAllow\fP \fIhôte.domaine.com\fP .TP 5 \fBAllow *.\fP\fIdomaine.com\fP .TP 5 \fBAllow\fP \fIadresse_ipv4\fP .TP 5 \fBAllow\fP \fIadresse_ipv4\fP\fB/\fP\fImasque_sous_réseau\fP .TP 5 \fBAllow\fP \fIadresse_ipv4\fP\fB/\fP\fImm\fP .TP 5 \fBAllow [\fP\fIadresse_ipv6\fP\fB]\fP .TP 5 \fBAllow [\fP\fIaddress_ipv6\fP\fB]/\fP\fImm\fP .TP 5 \fBAllow @IF(\fP\fInom\fP\fB)\fP .TP 5 \fBAllow @LOCAL\fP Autoriser l’accès à partir des hôtes, domaines, adresses ou interfaces cités. La forme @IF(nom) utilise les sous\-réseaux en cours configurés pour l’interface citée. La forme @LOCAL utilise les sous\-réseaux en cours configurés pour toutes les interfaces qui ne sont pas «\ point\-to\-point\ », par exemple, les interfaces Ethernet et Wi\-Fi sont utilisées, mais pas les interfaces DSL et VPN. La directive Order contrôle si les lignes Allow sont évaluées avant ou après les lignes Deny. .TP 5 \fBAuthType\fP \fINone\fP .TP 5 \fBAuthType\fP \fIBasic\fP .TP 5 \fBAuthType\fP \fIDigest\fP Indiquer le type d’authentification demandé. La valeur «\ Default\ » correspond à la valeur DefaultAuthType. .TP 5 \fBDeny\fP \fIall\fP .TP 5 \fBDeny\fP \fInone\fP .TP 5 \fBDeny\fP \fIhôte.domaine.com\fP .TP 5 \fBDeny *.\fP\fIdomaine.com\fP .TP 5 \fBDeny\fP \fIadresse_ipv4\fP .TP 5 \fBDeny\fP \fIadresse_ipv4\fP\fB/\fP\fImasque_réseau\fP .TP 5 \fBDeny\fP \fIadresse_ipv4\fP\fB/\fP\fImm\fP .TP 5 \fBDeny [\fP\fIadresse_ipv6\fP\fB]\fP .TP 5 \fBDeny\fP [\fIadresse_ipv6\fP]\fB/\fP\fImm\fP .TP 5 \fBDeny @IF(\fP\fInom\fP\fB)\fP .TP 5 \fBDeny @LOCAL\fP Interdire l’accès à partir des hôtes, domaines, adresses ou interfaces cités. La forme @IF(nom) utilise les sous\-réseaux en cours configurés pour l’interface citée. La forme @LOCAL utilise les sous\-réseaux en cours configurés pour toutes les interfaces qui ne sont pas «\ point\-to\-point\ », par exemple, les interfaces Ethernet et Wi\-Fi sont utilisées, mais pas les interfaces DSL et VPN. La directive Order contrôle si les lignes Deny sont évaluées avant ou après les lignes Allow. .TP 5 \fBEncryption\fP \fIIfRequested\fP .TP 5 \fBEncryption\fP \fINever\fP .TP 5 \fBEncryption\fP \fIRequired\fP Définir le niveau de chiffrement nécessaire pour un emplacement donné. Par défaut, «\ IfRequested\ ». .TP 5 \fBOrder\fP \fIallow,deny\fP Indiquer que l’accès est refusé par défaut. Les lignes Allow sont d’abord examinées, suivies par celles «\ Deny\ » pour savoir si un client peut accéder à une ressource particulière. .TP 5 \fBOrder\fP \fIdeny,allow\fP Indiquer que l’accès est autorisé par défaut. Les lignes Deny sont d’abord examinées, suivies par celles Allow pour savoir si un client peut accéder à une ressource particulière. .TP 5 \fBRequire group\fP \fIgroupe\fP [\fIgroupe\fP ...] Indiquer qu’un utilisateur authentifié doit être membre d’un des groupes indiqués. .TP 5 \fBRequire user {\fP\fIidentifiant\fP|\fB@\fP\fIgroupe\fP} ... Indiquer qu’un utilisateur authentifié doit correspondre à un des utilisateurs ou être membre d’un des groupes. Le nom de groupe «\ @SYSTEM\ » correspond à la liste des groupes définis dans la directive «\ SystemGroup\ » du fichier \fIcups\-files.conf\fP. Le nom de groupe «\ @OWNER\ » correspond au propriétaire de la ressource, par exemple la personne demandant un travail. REMARQUE\ : le superutilisateur n’est nullement spécial et les mêmes droits doivent lui être accordés comme pour n’importe quel autre compte d’utilisateur. .TP 5 \fBRequire valid\-user\fP Indiquer que tout utilisateur authentifié est autorisé. .TP 5 \fBSatisfy\fP \fIall\fP Indiquer que toutes les conditions Allow, AuthType, Deny, Order, et Require doivent être satisfaites pour permettre l'accès. .TP 5 \fBSatisfy\fP \fIany\fP Indiquer que tout client peut accéder à une ressource si les conditions d’authentification (AuthType/Require) ou d’adresse (Allow/Deny/Order) sont satisfaites. Par exemple, cela peut être utilisé pour demander l’authentification seulement pour les accès distants. .SS "DIRECTIVES VALABLES À L’INTÉRIEUR DES SECTIONS DE POLITIQUE" Les directives suivantes peuvent être utilisées dans les sections Politique dans le fichier \fIcupsd.conf\fP\ : .TP 5 \fBJobPrivateAccess\fP \fIall\fP .TP 5 \fBJobPrivateAccess\fP \fIdéfault\fP .TP 5 \fBJobPrivateAccess \fP{\fIidentifiant\fP|\fB@\fP\fIgroupe\fP|\fB@ACL\fP|\fB@OWNER\fP|\fB@SYSTEM\fP} ... Indiquer une liste d'accès pour les valeurs privées d'une tâche. La liste d'accès par défaut est «\ @OWNER @SYSTEM\ ». «\ @ACL\ » est défini selon les valeurs \fIrequesting\-user\-allowed\fP ou \fIrequesting\-user\-denied\fP de l'imprimante. «\ @OWNER\ » désigne le propriétaire du travail. «\ @SYSTEM\ » désigne les groupes listés dans la directive SystemGroup dans le fichier \fIcups\-files.conf\fP. .TP 5 \fBJobPrivateValues\fP \fIall\fP .TP 5 \fBJobPrivateValues\fP \fIdéfault\fP .TP 5 \fBJobPrivateValues\fP \fInone\fP .TP 5 \fBJobPrivateValues\fP \fInom_attribut\fP [ ... \fInom_attribut\fP ] Indiquer la liste des valeurs des tâches à rendre privées. Les valeurs par défaut sont «\ nom de la tâche\ », «\ nom d'hôte de la machine ayant créé la tâche\ », et «\ nom d'utilisateur ayant créé la tâche\ » et «\ téléphone\ ». .TP 5 \fBSubscriptionPrivateAccess\fP \fIall\fP .TP 5 \fBSubscriptionPrivateAccess\fP \fIdefault\fP .TP 5 \fBSubscriptionPrivateAccess \fP{\fIidentifiant\fP|\fB@\fP\fIgroupe\fP|\fB@ACL\fP|\fB@OWNER\fP|\fB@SYSTEM\fP} ... Indiquer une liste d'accès pour les valeurs privées d'un abonnement. La liste d'accès «\ par défaut\ » est «\ @OWNER @SYSTEM\ ». «\ @ACL\ » désigne les valeurs \fIrequesting\-user\-allowed\fP ou \fIrequesting\-user\-denied\fP de l'imprimante. «\ @OWNER\ » désigne le propriétaire du travail. «\ @SYSTEM\ » désigne les groupes listés dans la directive SystemGroup dans le fichier \fIcups\-files.conf\fP. .TP 5 \fBSubscriptionPrivateValues\fP \fIall\fP .TP 5 \fBSubscriptionPrivateValues\fP \fIdefault\fP .TP 5 \fBSubscriptionPrivateValues\fP \fInone\fP .TP 5 \fBSubscriptionPrivateValues\fP \fInom_attribut\fP [ ... \fInom_attribut\fP ] Indiquer la liste des valeurs des abonnements à rendre privés. Les valeurs par défaut sont «\ notify\-events\ », «\ notify\-pull\-method\ », «\ notify\-recipient\-uri\ », «\ notify\-subscriber\-user\-name\ » et «\ notify\-user\-data\ ». .SS "DIRECTIVES OBSOLÈTES" Les directives suivantes sont obsolètes et seront supprimées dans une future version de CUPS\ : .TP 5 \fBAuthType\fP \fINegotiate\fP .\"#Classification Indiquer qu'une identification Kerberos est nécessaire. .TP 5 \fBClassification\fP \fIbannière\fP .br .\"#ClassifyOverride Indiquer la classification de sécurité du serveur. Tout nom de bannière valable peut être utilisé, y compris «\ classified\ », «\ confidential\ », «\ secret\ », «\ topsecret\ » et «\ unclassified\ », ou la bannière peut être omise pour désactiver les fonctions de sécurité d’impression. Par défaut, aucune bannière de classification. .TP 5 \fBClassifyOverride\fP \fIYes\fP .TP 5 \fBClassifyOverride\fP \fINo\fP .br Définir si les utilisateurs sont autorisés à modifier la classification (page de couverture) de leurs travaux d'impression personnels en utilisant l’option «\ job\-sheets\ ». Par défaut «\ No\ ». .TP 5 \fBDefaultAuthType\fP \fINegotiate\fP .\"#GSSServiceName Indiquer qu'une identification Kerberos est nécessaire par défaut. .TP 5 \fBGSSServiceName\fP \fInom\fP .\"#PageLogFormat Indiquer le nom de service lors de l'utilisation de l'authentification Kerberos. Le nom du service par défaut est «\ http\ ». .TP 5 \fBPageLogFormat\fP \fIformat_chaîne\fP Indiquer le format des lignes de PageLog. Les suites commençant par le caractère pour\ cent\ (%) sont remplacées par l’information correspondante, tandis que tous les autres caractères sont copiés littéralement. Les suites avec pour\ cent suivantes sont reconnues\ : .nf « %% » insère un seul caractère pour cent. « %{name} » insère la valeur indiquée de l’attribut IPP. « %C » insère le nombre de copies pour la page en cours. « %P » insère le numéro de page en cours. « %T » insère les date et heure du moment dans le format de journal habituel. « %j » insère l’identifiant du travail. « %p » insère le nom de l’imprimante. « %u » insère l’identifiant. .fi Par défaut, c’est une chaîne vide désactivant la journalisation. La chaîne «\ %p %u %j %T %P %C %{job\-billing} %{job\-originating\-host\-name} %{job\-name} %{media} %{sides}\ » crée une journalisation de page avec les champs standards. Utilisez «\ %{job\-impressions\-completed}\ » pour insérer le nombre de pages (faces) imprimées ou «\ %{job\-media\-sheets\-completed}\ » pour insérer le nombre de feuilles imprimées. .SH NOTES Les directives de configuration des fichiers, des répertoires et des utilisateurs, qui étaient jusqu'alors autorisées dans le fichier \fIcupsd.conf\fP, sont maintenant stockées dans le fichier de \fBcups\-files.conf\fP(5) afin de prévenir certains types d'attaque visant une augmentation de privilèges. .PP L’ordonnanceur DOIT être redémarré après des modifications dans le fichier de \fBcupsd.conf\fP. Avec Linux cela est fait typiquement en utilisant la commande \fBsystemctl\fP(8) tandis qu’avec macOS la commande \fBlaunchctl\fP(8) est utilisée. .PP Le nom de la macro @LOCAL peut porter à confusion puisque le système exécutant \fBcupsd\fP appartient souvent à un ensemble différent de sous\-réseaux de celui de ses clients. .SH CONFORMITÉ Le format de fichier \fIcupsd.conf\fP est basé sur celui du fichier de configuration du serveur HTTP Apache. .SH EXEMPLES Tout journaliser dans un fichier de taille maximale de 32\ Mo\ : .nf AccessLogLevel all LogLevel debug2 MaxLogSize 32m .fi Demander l’authentification pour accéder au réseau\ 10… depuis l'extérieur\ : .nf Order allow,deny Allow from 10./8 AuthType Basic Require valid\-user Satisfy any .fi .SH "VOIR AUSSI" \fBclasses.conf\fP(5), \fBcups\-files.conf\fP(5), \fBcupsd\fP(8), \fBmime.convs\fP(5), \fBmime.types\fP(5), \fBprinters.conf\fP(5), \fBsubscriptions.conf\fP(5), aide en ligne de CUPS .SH COPYRIGHT Copyright \[co] 2020\-2023 by OpenPrinting.