.\" .\" cups-files.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 cups\-files.conf 5 CUPS "6 mars 2021" OpenPrinting .SH NOM cups\-files.conf \- Fichier de configuration des fichiers et dossiers du serveur CUPS .SH DESCRIPTION Le fichier \fIcups\-files.conf\fP configure les emplacements des fichiers et dossiers utilisés par l'ordonnanceur CUPS, \fBcupsd\fP(8). Il est généralement situé dans le répertoire \fI/etc/cups\fP. .LP 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 .\"#AccessLog Les directives suivantes sont comprises par \fBcupsd\fP(8)\ : .TP 5 \fBAccessLog\fP .TP 5 \fBAccessLog\fP \fInom_fichier\fP .TP 5 \fBAccessLog stderr\fP .TP 5 \fBAccessLog syslog\fP Définir le fichier de journal d’accès. Indiquer un nom de fichier vide désactive la création du journal d’accès. La valeur«\ stderr\ » provoque l’envoi des entrées de journal dans le fichier d’erreur standard lorsque l’ordonnanceur est exécuté comme tâche d’avant\-plan ou vers le démon de journalisation du système lorsque exécuté en arrière\-plan. La valeur «\ syslog\ » provoque l’envoi des entrées de journal vers le démon du journal système. Le nom de serveur peut être inclus dans les noms de fichier en utilisant la chaîne «\ %s\ », par exemple\ : .nf AccessLog /var/log/cups/%s\-access_log .fi .\"#CacheDir Par défaut, \fI/var/log/cups/access_log\fP. .TP 5 \fBCacheDir\fP \fIrépertoire\fP .\"#ConfigFilePerm Indiquer le répertoire à utiliser pour les fichiers temporaires (cache) de longue durée. Par défaut, \fI/var/spool/cups/cache\fP ou \fI/var/cache/cups\fP en fonction de la plateforme. .TP 5 \fBConfigFilePerm\fP \fImode\fP Définir les permissions à utiliser pour les fichiers de configuration écrits par l'ordonnanceur. Par défaut, «\ 0644\ » pour macOS et «\ 0640\ » pour tous les autres systèmes. .LP .\"#CreateSelfSignedCerts \fBRemarque\ :\fP les permissions pour le fichier \fIprinters.conf\fP sont actuellement réduites pour permettre son accès uniquement par l’utilisateur de l’ordonnanceur (classiquement le superutilisateur). Cela est ainsi parce que les URI contiennent quelquefois des informations d’authentification sensibles qui ne doivent pas être divulguées dans le système. Cette fonction de sécurité ne peut être désactivée. .TP 5 \fBCreateSelfSignedCerts\fP \fIyes\fP .TP 5 \fBCreateSelfSignedCerts\fP \fIno\fP .\"#DataDir Indiquer si l'ordonnanceur crée automatiquement des certificats auto\-signés pour des connexions de clients utilisant TLS. La valeur par défaut est «\ Yes\ ». .TP 5 \fBDataDir\fP \fIchemin\fP .\"#DocumentRoot Définir le répertoire où se trouvent les fichiers de données. Par défaut, habituellement \fI/usr/share/cups\fP. .TP 5 \fBDocumentRoot\fP \fIrépertoire\fP .\"#ErrorLog Définir le répertoire racine des documents du serveur web interne. Par défaut, habituellement \fI/usr/share/doc/cups\fP. .TP 5 \fBErrorLog\fP .TP 5 \fBErrorLog\fP \fInom_fichier\fP .TP 5 \fBErrorLog stderr\fP .TP 5 \fBErrorLog syslog\fP Définir le fichier de journal d’erreurs. Indiquer un nom de fichier vide désactive la création du journal d’erreurs. La valeur«\ stderr\ » provoque l’envoi des entrées de journal dans le fichier d’erreur standard lorsque l’ordonnanceur est exécuté comme tâche d’avant\-plan ou vers le démon de journalisation du système lorsque exécuté en arrière\-plan. La valeur «\ syslog\ » provoque l’envoi des entrées de journal vers le démon du journal système. Le nom de serveur peut être inclus dans les noms de fichier en utilisant la chaîne «\ %s\ », par exemple\ : .nf ErrorLog /var/log/cups/%s\-error_log .fi .\"#FatalErrors Par défaut, \fI/var/log/cups/error_log\fP. .TP 5 \fBFatalErrors\fP \fInone\fP .TP 5 \fBFatalErrors all \fP\fI\-type\fP [... \fI\-type\fP] .TP 5 \fBFatalErrors\fP \fItype\fP [... \fItype\fP] Indiquer quelles erreurs sont fatales, entraînant l'arrêt de l'ordonnanceur. Par défaut, «\ config\ ». Les chaînes \fItype\fP sont les suivantes\ : .RS 5 .TP 5 \fBnone\fP Aucune erreur n’est fatale. .TP 5 \fBall\fP Toutes les erreurs ci\-dessous sont fatales. .TP 5 \fBbrowse\fP Les erreurs d’initialisation de navigation sont fatales, par exemple les échecs de connexion au démon DNS\-SD. .TP 5 \fBconfig\fP Les erreurs de syntaxe du fichier de configuration sont fatales. .TP 5 \fBlisten\fP Les erreurs de Listen ou Port sont fatales, excepté pour les erreurs IPv6 sur loopback ou les adresses «\ any\ ». .TP 5 \fBlog\fP Les erreurs de création ou d’écriture du fichier de journal sont fatales. .TP 5 \fBpermissions\fP De mauvaises permissions au démarrage sont fatales, par exemple des fichiers de certificats TLS et clefs partagés avec permission de lecture à tous. .RE .\"#Group .TP 5 \fBGroup\fP \fInom_groupe\fP\-ou\-\fIidentifiant_numérique\fP Définir le nom ou l'identifiant numérique du groupe qui sera utilisé lors de l'exécution de programmes externes. Le groupe par défaut dépend du système d’exploitation, mais est couramment «\ lp\ » ou «\ nobody\ ». .RE .\"#LogFileGroup .TP 5 \fBLogFileGroup\fP \fInom_groupe\fP\-ou\-\fIidentifiant_numérique\fP .\"#LogFilePerm Définir le nom ou l'identifiant numérique du groupe qui sera utilisé pour les fichiers de journal. Le groupe par défaut dépend du système d’exploitation, mais est couramment «\ lp\ » ou «\ nobody\ ». .TP 5 \fBLogFilePerm\fP \fImode\fP .\"#PageLog Définir les permissions de tous les fichiers journaux écrits par l'ordonnanceur. Par défaut, \fB0644\fP. .TP 5 \fBPageLog\fP [ \fInom_fichier\fP ] .TP 5 \fBPageLog stderr\fP .TP 5 \fBPageLog syslog\fP Définir le fichier de journal de pages. La valeur«\ stderr\ » provoque l’envoi des entrées de journal dans le fichier d’erreur standard lorsque l’ordonnanceur est exécuté comme tâche d’avant\-plan ou vers le démon de journalisation du système lorsque exécuté en arrière\-plan. La valeur «\ syslog\ » provoque l’envoi des entrées de journal vers le démon du journal système. Indiquer un nom de fichier vide désactive la création du journal de pages. Le nom de serveur peut être inclus dans les noms de fichier en utilisant la chaîne «\ %s\ », par exemple\ : .nf PageLog /var/log/cups/%s\-page_log .fi .\"#PassEnv Par défaut, \fI/var/log/cups/page_log\fP. .TP 5 \fBPassEnv\fP \fIvariable\fP [... \fIvariable\fP] .\"#RemoteRoot Passer les variables d’environnement indiquées aux processus enfant. Remarque\ : le filtre et les variables d’environnement dorsales standard de CUPS ne peuvent pas être écrasées par cette directive. .TP 5 \fBRemoteRoot\fP \fIidentifiant\fP .\"#RequestRoot Définir l'identifiant associé aux accès non identifiés par des clients certifiant être le superutilisateur. Par défaut, «\ remroot\ ». .TP 5 \fBRequestRoot\fP \fIrépertoire\fP .\"#Sandboxing Définir le répertoire où sont stockés les travaux et les données des requêtes HTTP. Par défaut, \fI/var/spool/cups\fP. .TP 5 \fBSandboxing\fP \fIrelaxed\fP .TP 5 \fBSandboxing\fP \fIstrict\fP .\"#ServerBin Indiquer le niveau de sécurité de bac à sable appliqué aux filtres d’impression, programmes de transmission et autres processus fils de l’ordonnanceur. Par défaut, «\ strict\ ». Cette directive est actuellement seulement utilisée et prise en charge par macOS. .TP 5 \fBServerBin\fP \fIrépertoire\fP .\"#ServerKeychain Indiquer le répertoire contenant les programmes de transmission, les programmes CGI, les filtres, les programmes d’assistance, les programmes de notification et de surveillance de port. Par défaut, \fI/usr/lib/cups\fP ou \fI/usr/libexec/cups\fP en fonction de la plateforme. .TP 5 \fBServerKeychain \fP\fIchemin\fP .\"#ServerRoot Indiquer l’emplacement des certificats et clefs privées TLS. Par défaut, \fI/Library/Keychains/System.keychain\fP pour macOS et \fI/etc/cups/ssl\fP sur les autres systèmes d’exploitation. macOS utilise sa base de données clef/valeur pour enregistrer les clefs et certificats tandis que les autres plateformes utilisent des fichiers séparés dans le répertoire précisé, \fI*.crt\fP pour les certificats PEM et \fI*.key\fP pour les clefs privées encodées PEM. .TP 5 \fBServerRoot\fP \fIrépertoire\fP .\"#SetEnv Définir le répertoire où les fichiers de configuration du serveur sont stockés. Par défaut, \fI/etc/cups/\fP. .TP 5 \fBSetEnv variable\fP \fIvaleur\fP .\"#StateDir Passer les variables d’environnement indiquées aux processus enfant. Remarque\ : le filtre et les variables d’environnement dorsales standard de CUPS ne peuvent pas être écrasées par cette directive. .TP 5 \fBStateDir\fP \fIrépertoire\fP .\"#SyncOnClose Indiquer le répertoire à utiliser pour les fichiers de PID et certificats locaux. Par défaut, \fI/var/run/cups\fP ou \fI/etc/cups\fP en fonction de la plateforme. .TP 5 \fBSyncOnClose\fP \fIYes\fP .TP 5 \fBSyncOnClose\fP \fINo\fP .\"#SystemGroup Indiquer si l'ordonnanceur appelle \fBfsync\fP(2) après écriture des fichiers d’état ou de configuration. .TP 5 \fBSystemGroup\fP \fIgroupe\fP [ ... \fIgroupe\fP] .\"#TempDir Indiquer le(s) groupe(s) à utiliser pour l’authentification des groupes \fI@SYSTEM\fP. Par défaut sont indiqués «\ admin\ », «\ lpadmin\ », «\ root\ », «\ sys\ », et/ou «\ system\ ». .TP 5 \fBTempDir\fP \fIrépertoire\fP .\"#User Définir le répertoire où les fichiers temporaires de court terme sont stockés. Par défaut, \fIvar/spool/cups/tmp\fP. .TP 5 \fB\-U\fP \fIidentifiant\fP Définir le nom ou l'identifiant de l'utilisateur utilisé lors du lancement de programmes externes. Par défaut, «\ lp\ ». .SS "DIRECTIVES OBSOLÈTES" .\"#FileDevice Les directives suivantes sont obsolètes et seront supprimées dans une future version de CUPS. .TP 5 \fBFileDevice\fP \fIYes\fP .TP 5 \fBFileDevice\fP \fINo\fP .\"#Printcap Définir que le fichier pseudo\-spécial peut être utilisé pour de nouvelles files d’attente d’imprimante. L’URI \fIfile:///dev/null\fP est toujours autorisé. Les fichiers spéciaux ne peuvent être utilisés avec les files d’attente «\ raw\ » —\ un fichier PPD est nécessaire. Le fichier indiqué est réécrit pour chaque travail d’impression. L’écriture dans des répertoires n’est pas gérée. .TP 5 \fBPrintcap\fP \fInom\-fichier\fP .\"#PrintcapFormat Définir le fichier rempli par une liste de files d’attente d’impression locales. .TP 5 \fBPrintcapFormat\fP \fIbsd\fP .TP 5 \fBPrintcapFormat\fP \fIplist\fP .TP 5 \fBPrintcapFormat\fP \fIsolaris\fP Définir le format à utiliser pour le fichier Printcap. «\ bsd\ » est le format historique de fichier printcap de LPD. «\ plist\ » est le format de fichier plist d’Apple. «\ solaris\ » est le format historique de fichier printcap de LPD de Solaris. .SH NOTES L’ordonnanceur DOIT à être redémarré après des modifications dans le fichier de \fBcups.files.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. .SH "VOIR AUSSI" \fBclasses.conf\fP(5), \fBcups\fP(1), \fBcupsd\fP(8), \fBcupsd.conf\fP(5), \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.