cups-files.conf

cups-files.conf(5) OpenPrinting cups-files.conf(5)

NOM

   cups-files.conf - Fichier de configuration des fichiers et dossiers du serveur CUPS

DESCRIPTION

   Le  fichier cups-files.conf configure les emplacements des fichiers et dossiers utilisés par l'ordonnanceur CUPS, cupsd(8). Il est généralement situé dans le
   répertoire /etc/cups.

   Chaque ligne de ce fichier est soit une directive de configuration, une ligne vide ou un commentaire. Les directives de configuration  consistent  classique
   ment  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 « # ».

DIRECTIVES

   Les directives suivantes sont comprises par cupsd(8) :

   AccessLog

   AccessLog nom_fichier

   AccessLog stderr

   AccessLog syslog
        Définir le fichier de journal daccès. Indiquer un nom de fichier vide désactive la création du journal daccès. La  valeur« stderr »  provoque  lenvoi
        des  entrées de journal dans le fichier derreur standard lorsque lordonnanceur est exécuté comme tâche davant-plan ou vers le démon de journalisation
        du système lorsque exécuté en arrière-plan. La valeur « syslog » provoque lenvoi 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 :

            AccessLog /var/log/cups/%s-access_log

        Par défaut, /var/log/cups/access_log.

   CacheDir répertoire
        Indiquer  le  répertoire à utiliser pour les fichiers temporaires (cache) de longue durée. Par défaut, /var/spool/cups/cache ou /var/cache/cups en fonc
        tion de la plateforme.

   ConfigFilePerm mode
        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.

   Remarque :  les  permissions pour le fichier printers.conf 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.

   CreateSelfSignedCerts yes

   CreateSelfSignedCerts no
        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 ».

   DataDir chemin
        Définir le répertoire  se trouvent les fichiers de données. Par défaut, habituellement /usr/share/cups.

   DocumentRoot répertoire
        Définir le répertoire racine des documents du serveur web interne. Par défaut, habituellement /usr/share/doc/cups.

   ErrorLog

   ErrorLog nom_fichier

   ErrorLog stderr

   ErrorLog syslog
        Définir le fichier de journal derreurs. Indiquer un nom de fichier vide désactive la création du journal derreurs. La valeur« stderr » provoque  len
        voi des entrées de journal dans le fichier derreur standard lorsque lordonnanceur est exécuté comme tâche davant-plan ou vers le démon de journalisa
        tion du système lorsque exécuté en arrière-plan. La valeur « syslog » provoque lenvoi 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 :

            ErrorLog /var/log/cups/%s-error_log

        Par défaut, /var/log/cups/error_log.

   FatalErrors none

   FatalErrors all -type [... -type]

   FatalErrors type [... type]
        Indiquer quelles erreurs sont fatales, entraînant l'arrêt de l'ordonnanceur. Par défaut, « config ». Les chaînes type sont les suivantes :

        none Aucune erreur nest fatale.

        all  Toutes les erreurs ci-dessous sont fatales.

        browse
             Les erreurs dinitialisation de navigation sont fatales, par exemple les échecs de connexion au démon DNS-SD.

        config
             Les erreurs de syntaxe du fichier de configuration sont fatales.

        listen
             Les erreurs de Listen ou Port sont fatales, excepté pour les erreurs IPv6 sur loopback ou les adresses « any ».

        log  Les erreurs de création ou décriture du fichier de journal sont fatales.

        permissions
             De  mauvaises  permissions  au  démarrage  sont fatales, par exemple des fichiers de certificats TLS et clefs partagés avec permission de lecture à
             tous.

   Group nom_groupe-ou-identifiant_numérique
        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
        dexploitation, mais est couramment « lp » ou « nobody ».

   LogFileGroup nom_groupe-ou-identifiant_numérique
        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’exploita‐
        tion, mais est couramment « lp » ou « nobody ».

   LogFilePerm mode
        Définir les permissions de tous les fichiers journaux écrits par l'ordonnanceur. Par défaut, 0644.

   PageLog [ nom_fichier ]

   PageLog stderr

   PageLog syslog
        Définir le fichier de journal de pages. La valeur« stderr » provoque lenvoi des entrées de journal dans le fichier derreur standard  lorsque  lordon
        nanceur  est  exécuté  comme tâche davant-plan ou vers le démon de journalisation du système lorsque exécuté en arrière-plan. La valeur « syslog » pro
        voque lenvoi 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 :

            PageLog /var/log/cups/%s-page_log

        Par défaut, /var/log/cups/page_log.

   PassEnv variable [... variable]
        Passer  les variables denvironnement indiquées aux processus enfant. Remarque : le filtre et les variables denvironnement dorsales standard de CUPS ne
        peuvent pas être écrasées par cette directive.

   RemoteRoot identifiant
        Définir l'identifiant associé aux accès non identifiés par des clients certifiant être le superutilisateur. Par défaut, « remroot ».

   RequestRoot répertoire
        Définir le répertoire où sont stockés les travaux et les données des requêtes HTTP. Par défaut, /var/spool/cups.

   Sandboxing relaxed

   Sandboxing strict
        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.

   ServerBin répertoire
        Indiquer le répertoire contenant les programmes de transmission, les programmes CGI, les filtres, les programmes d’assistance, les programmes de notifi‐
        cation et de surveillance de port. Par défaut, /usr/lib/cups ou /usr/libexec/cups en fonction de la plateforme.

   ServerKeychain chemin
        Indiquer l’emplacement des certificats et clefs privées TLS. Par défaut, /Library/Keychains/System.keychain pour macOS et /etc/cups/ssl 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 uti‐
        lisent des fichiers séparés dans le répertoire précisé, *.crt pour les certificats PEM et *.key pour les clefs privées encodées PEM.

   ServerRoot répertoire
        Définir le répertoire où les fichiers de configuration du serveur sont stockés. Par défaut, /etc/cups/.

   SetEnv variable valeur
        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.

   StateDir répertoire
        Indiquer le répertoire à utiliser pour les fichiers de PID et certificats locaux. Par défaut, /var/run/cups ou /etc/cups en fonction de la plateforme.

   SyncOnClose Yes

   SyncOnClose No
        Indiquer si l'ordonnanceur appelle fsync(2) après écriture des fichiers détat ou de configuration.

   SystemGroup groupe [ ... groupe]
        Indiquer  le(s)  groupe(s)  à  utiliser pour lauthentification des groupes @SYSTEM. Par défaut sont indiqués « admin », « lpadmin », « root », « sys »,
        et/ou « system ».

   TempDir répertoire
        Définir le répertoire  les fichiers temporaires de court terme sont stockés. Par défaut, var/spool/cups/tmp.

   -U identifiant
        Définir le nom ou l'identifiant de l'utilisateur utilisé lors du lancement de programmes externes. Par défaut, « lp ».

DIRECTIVES OBSOLÈTES

   Les directives suivantes sont obsolètes et seront supprimées dans une future version de CUPS.

   FileDevice Yes

   FileDevice No
        Définir que le fichier pseudo-spécial peut être utilisé pour de nouvelles files dattente dimprimante. LURI file:///dev/null  est  toujours  autorisé.
        Les  fichiers  spéciaux  ne  peuvent être utilisés avec les files dattente « raw »  un fichier PPD est nécessaire. Le fichier indiqué est réécrit pour
        chaque travail dimpression. Lécriture dans des répertoires nest pas gérée.

   Printcap nom-fichier
        Définir le fichier rempli par une liste de files dattente dimpression locales.

   PrintcapFormat bsd

   PrintcapFormat plist

   PrintcapFormat solaris
        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 dApple. « solaris » est le format historique de fichier printcap de LPD de Solaris.

NOTES

   Lordonnanceur  DOIT  à  être redémarré après des modifications dans le fichier de cups.files.conf. Avec Linux cela est fait typiquement en utilisant la com
   mande systemctl(8) tandis quavec macOS la commande launchctl(8) est utilisée.

VOIR AUSSI

   classes.conf(5),  cups(1),  cupsd(8),  cupsd.conf(5),  mime.convs(5),  mime.types(5),  printers.conf(5),  subscriptions.conf(5),  aide  en  ligne   de   CUPS
   <URL:http://localhost:631/help>

COPYRIGHT

   Copyright © 2020-2022 par OpenPrinting.

6 mars 2021 CUPS cups-files.conf(5)