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 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 « # ».

DIRECTIVES

Les directives suivantes sont comprises par cupsd(8) :

AccessLog

AccessLog nom_fichier

AccessLog stderr

AccessLog syslog

Defines the access log filename. Specifying a blank filename disables access log generation. The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value "syslog" causes log entries to be sent to the system log daemon. The server name may be included in filenames using the string "%s", for example:

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

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

ConfigFilePerm mode

Définir les permissions à utiliser pour les fichiers de configuration écrits par l'ordonnanceur. Par défaut, « 0644 » pour OS X 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.

DataDir chemin

Définir le répertoire où 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

Defines the error log filename. Specifying a blank filename disables error log generation. The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value "syslog" causes log entries to be sent to the system log daemon. The server name may be included in filenames using the string "%s", for example:

    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 n’est fatale.

all

Toutes les erreurs ci-dessous sont fatales.

browse

Les erreurs d’initialisation 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.

FileDevice Yes

FileDevice No

Indiquer si un pseudo-périphérique de fichier peut être utilisé pour les nouvelles files d’attente d’imprimante. L’URI file:///dev/null est toujours autorisé.

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 d’exploitation, 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

Defines the page log filename. The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value "syslog" causes log entries to be sent to the system log daemon. Specifying a blank filename disables page log generation. The server name may be included in filenames using the string "%s", for example:

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

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

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 ou prise en charge par OS X.

ServerBin répertoire

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, /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 OS X et /etc/cups/ssl sur les autres systèmes d’exploitation. OS X 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é, *.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/.

SyncOnClose Yes

SyncOnClose No

Specifies whether the scheduler calls fsync(2) after writing configuration or state files. The default is "Yes".

SystemGroup groupe [ ... groupe]

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

TempDir répertoire

Définir le répertoire où les fichiers temporaires 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 ».

COPYRIGHT

Copyright 2007-2015 par Apple Inc.