.\"
.\" cupsd.conf man page for CUPS.
.\"
.\" Copyright © 2020 by Michael R Sweet
.\" 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 "28 November 2020" "Apple Inc."
.SH NOM
cupsd.conf \- Fichier de configuration du serveur CUPS.
.SH DESCRIPTION
The \fIcupsd.conf\fP file configures the CUPS scheduler, \fBcupsd\fP(8). It is
normally located in the \fI/etc/cups\fP directory. Each line in the file can
be a configuration directive, a blank line, or a comment. Configuration
directives typically consist of a name and zero or more values separated by
whitespace. The configuration directive name and values are
case\-insensitive. Comment lines start with the # character.
.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
Specifies a list of Bonjour sub\-types to advertise for each shared printer.
For example, "BrowseDNSSDSubTypes _cups,_print" will tell network clients
that both CUPS sharing and IPP Everywhere are supported. The default is
"_cups" which is necessary for printer sharing to work between systems using
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 avertie. 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 averties. Par défaut «\ No\ ».
.TP 5
\fBDefaultAuthType\fP \fIBasic\fP
.TP 5
\fBDefaultAuthType\fP \fINegotiate\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\ ».
.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
Specifies the fully\-qualified domain name for the server that is used for
Bonjour sharing. The default is typically the server's ".local" hostname.
.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
Specifies that a failed print job should stop the printer unless otherwise
specified for the printer. The 'stop\-printer' error policy is the default.
.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
.\"#GSSServiceName
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
\fBGSSServiceName\fP \fInom\fP
Indiquer le nom de service lors de l'utilisation de l'authentification
Kerberos. Le nom du service par défaut est «\ http\ ».
.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
.\"#KeepAliveTimeout
Définir s'il faut prendre en charge les connections keep\-alive HTTP. Par
défaut, «\ Yes\ ».
.TP 5
\fBKeepAliveTimeout\fP \fIsecondes\fP
.\"#LimitIPP
Indiquer combien de temps une connexion inutilisée d’un client reste
ouverte. Par défaut, \fB30\fP.
.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
.\"#ListenBackLog
Listens to the specified address and port or domain socket path for
connections. Multiple Listen directives can be provided to listen on
multiple addresses. The Listen directive is similar to the Port directive
but allows you to restrict access to specific interfaces or networks. Note:
"Listen *:\fIport\fP" and "Port \fIport\fP" effectively listen on all IP
addresses, so you cannot combine them with Listen directives for explicit
IPv4 or IPv6 addresses on the same port.
.TP 5
\fBListenBackLog \fP\fInombre\fP
.\"#Location
Indiquer le nombre de connexions en attente autorisées. Cela ne concerne que
les serveurs très occupés qui ont atteint la limite maximale du nombre de
clients, mais peut aussi concerner un très grand nombre de connexions
simultanées. Quand la limite est atteinte, le système d’impression refusera
d’autres connexions tant que l’ordonnanceur ne pourra accepter celles en
attente. Par défaut, la limite est celle définie par défaut du système
d’exploitation, couramment soit \fB5\fP pour les plus anciens, ou \fB128\fP pour
les plus récents.
.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 maximum 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
.\"#MultipleOperationTimeout
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
\fBMultipleOperationTimeout\fP \fIsecondes\fP
.\"#Policy
Specifies the maximum amount of time to allow between files in a multiple
file print job. The default is "900" (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
.\"#ReloadTimeout
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
\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
Specifies what information is included in the Server header of HTTP
responses. "None" disables the Server header. "ProductOnly" reports
"CUPS". "Major" reports "CUPS/major IPP/2". "Minor" reports
"CUPS/major.minor IPP/2.1". "Minimal" reports "CUPS/major.minor.patch
IPP/2.1". "OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1".
"Full" reports "CUPS/major.minor.path (osname osversion; architecture)
IPP/2.1". The default is "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
Sets encryption options (only in /etc/cups/client.conf). By default, CUPS
only supports encryption using TLS v1.0 or higher using known secure cipher
suites. Security is reduced when \fIAllow\fP options are used. Security is
enhanced when \fIDeny\fP options are used. The \fIAllowDH\fP option enables
cipher suites using plain Diffie\-Hellman key negotiation (not supported on
systems using GNU TLS). The \fIAllowRC4\fP option enables the 128\-bit RC4
cipher suites, which are required for some older clients. The \fIAllowSSL3\fP
option enables SSL v3.0, which is required for some older clients that do
not support TLS v1.0. The \fIDenyCBC\fP option disables all CBC cipher
suites. The \fIDenyTLS1.0\fP option disables TLS v1.0 support \- this sets the
minimum protocol version to TLS v1.1. The \fIMinTLS\fP options set the minimum
TLS version to support. The \fIMaxTLS\fP options set the maximum TLS version
to support. Not all operating systems support TLS 1.3 at this time.
.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
Specifies the HTTP request timeout. The default is "900" (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
Allows access from the named hosts, domains, addresses, or interfaces. The
@IF(name) form uses the current subnets configured for the named interface.
The @LOCAL form uses the current subnets configured for all interfaces that
are not point\-to\-point, for example Ethernet and Wi\-Fi interfaces are used
but DSL and VPN interfaces are not. The Order directive controls whether
Allow lines are evaluated before or after Deny lines.
.TP 5
\fBAuthType\fP \fINone\fP
.TP 5
\fBAuthType\fP \fIBasic\fP
.TP 5
\fBAuthType\fP \fIDigest\fP
.TP 5
\fBAuthType\fP \fINegotiate\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
Denies access from the named hosts, domains, addresses, or interfaces. The
@IF(name) form uses the current subnets configured for the named interface.
The @LOCAL form uses the current subnets configured for all interfaces that
are not point\-to\-point, for example Ethernet and Wi\-Fi interfaces are used
but DSL and VPN interfaces are not. The Order directive controls whether
Deny lines are evaluated before or after Allow lines.
.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"
.\"#Classification
Les directives suivantes sont obsolètes et seront supprimées dans une future
version de CUPS\ :
.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
.\"#PageLogFormat
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
\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
.\"#RIPCache
The default is the empty string, which disables page logging. The string
"%p %u %j %T %P %C %{job\-billing} %{job\-originating\-host\-name} %{job\-name}
%{media} %{sides}" creates a page log with the standard items. Use
"%{job\-impressions\-completed}" to insert the number of pages (sides) that
were printed, or "%{job\-media\-sheets\-completed}" to insert the number of
sheets that were printed.
.TP 5
\fBRIPCache\fP \fItaille\fP
Définir la taille maximale de mémoire à utiliser lors de la conversion de
documents en fichiers bitmap pour une imprimante. Par défaut, \fB30\fP.
.SH NOTES
File, directory, and user configuration directives that used to be allowed
in the \fBcupsd.conf\fP file are now stored in the \fBcups\-files.conf\fP(5) file
instead in order to prevent certain types of privilege escalation attacks.
.PP
The scheduler MUST be restarted manually after making changes to the
\fBcupsd.conf\fP file. On Linux this is typically done using the
\fBsystemctl\fP(8) command, while on macOS the \fBlaunchctl\fP(8) command is
used instead.
.PP
The @LOCAL macro name can be confusing since the system running \fBcupsd\fP
often belongs to a different set of subnets from its 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 by Michael R Sweet
.br
Copyright 2007\-2019 par Apple Inc.