NAME¶
cupsd.conf - Server-Konfigurationsdatei für CUPS
BESCHREIBUNG¶
Die Datei
cupsd.conf konfiguriert den CUPS-Auftragsplaner (Scheduler),
cupsd(8). Sie befindet sich normalerweise in dem Verzeichnis
/etc/cups.
Hinweis: Datei, Verzeichnis und
Benutzerkonfigurationsdirektiven, die früher in der Datei
cupsd.conf erlaubt wurden, werden jetzt stattdessen in
cups-files.conf(5) gespeichert, um bestimmte Arten von
Privilegien-Eskalationsangriffen zu vermeiden.
Jede Zeile in der Datei kann eine Konfigurationsdirektive, eine leere Zeile oder
ein Kommentar sein. Kommentarzeilen beginnen mit dem Zeichen
»#«. Die Konfigurationsdirektiven sind bewusst ähnlich zu
denen des beliebten Apache-Webservers gehalten und werden unten beschrieben.
DIREKTIVEN¶
Die folgenden Direktiven werden von
cupsd(8) verstanden. Schauen Sie in
die Online-Hilfe für eine detailliertere Beschreibung:
- AccessLogLevel config
- AccessLogLevel actions
- AccessLogLevel all
-
Spezifiziert die Protokollierungsstufe für die AccessLog-Datei.
- Allow all
- Allow none
- Allow host.domain.com
- Allow *.domain.com
- Allow IP-Adresse
- Allow IP-Adresse/Netzmaske
- Allow IP-Adresse/mm
- Allow @IF(Name)
- Allow @LOCAL
-
Erlaubt Zugriff von den benannten Rechnern oder Adressen.
- AuthType None
- AuthType Basic
- AuthType BasicDigest
- AuthType Digest
- AuthType Negotiate
-
Spezifiziert den Authentifizierungstyp (None, Basic, BasicDigest, Digest,
Negotiate)
- AutoPurgeJobs Yes
- AutoPurgeJobs No
-
Spezifiziert, ob die Verlaufsdaten des Auftrags automatisch bereinigt
(gelöscht) werden sollen, wenn sie nicht mehr für Quotas
benötigt werden.
- BrowseLocalProtocols [All] [DNSSD]
-
Spezifiziert die für das gemeinsame Benutzen der lokalen Drucker zu
verwendenden Protokolle.
- BrowseWebIF Yes
- BrowseWebIF No
-
Gibt an, ob die CUPS-Web-Schnittstelle über DNS-SD angekündigt
wird.
- Browsing Yes
- Browsing No
-
Spezifiziert, ob gemeinsam genutzte Drucker beworben werden sollen oder
nicht.
- Classification Deckblatt
-
Spezifiziert die Sicherheitseinstufung des Servers.
- ClassifyOverride Yes
- ClassifyOverride No
-
Spezifiziert, ob Benutzern erlaubt werden soll, die Einstufung individueller
Druckaufträge zu ändern.
- DefaultAuthType Basic
- DefaultAuthType BasicDigest
- DefaultAuthType Digest
- DefaultAuthType Negotiate
-
Spezifiziert den standardmäßig zu verwendenden
Authentifizierungstyp.
- DefaultEncryption Never
- DefaultEncryption IfRequested
- DefaultEncryption Required
-
Gibt den Typ der Verschlüsselung an, der für authentifizierte
Anfragen benutzt werden soll.
- DefaultLanguage Locale (Standorteinstellung)
-
Spezifiziert die Standardsprache, die für Text und Webinhalte
verwandt werden soll.
- DefaultPaperSize Auto
- DefaultPaperSize None
- DefaultPaperSize Größenname
-
Gibt die Standardpapiergröße für neue
Druckerwarteschlangen an. »Auto« benutzt eine
sprachabhängige Vorgabe, während »None«
angibt, dass keine Papiergröße vorgegeben ist.
- DefaultPolicy Richtlinienname
-
Spezifiziert die zu verwendende Standardzugriffsrichtlinie.
- DefaultShared Yes
- DefaultShared No
-
Spezifiziert, ob lokale Drucker standardmäßig freigegeben
sind.
- Deny all
- Deny none
- Deny Rechner.Domain.com
- Deny *.domain.com
- Deny IP-Adresse
- Deny IP-Adresse/Netzmaske
- Deny IP-Adresse/mm
- Deny @IF(Name)
- Deny @LOCAL
-
Verweigert Zugriff auf die benannten Rechner oder Adressen.
- DirtyCleanInterval Sekunden
-
Gibt die Verzögerungszeit für die Aktualisierung von
Konfigurations- und Statusdateien an. Ein Wert von 0 veranlasst, dass die
Aktualisierung so schnell wie möglich erfolgt, typischerweise
innerhalb von wenigen Millisekunden.
- Encryption IfRequested
- Encryption Never
- Encryption Required
-
Spezifiziert die Verschlüsselungsstufe, die für einen
bestimmten Ort benötigt wird.
- ErrorPolicy abort-job
- Spezifiziert, dass ein fehlgeschlagener Druckauftrag abgebrochen
(verworfen) werden soll, es sei denn, es wurde anders für den
Drucker spezifiziert.
- ErrorPolicy retry-job
- Spezifiziert, dass ein fehlgeschlagener Druckauftrag zu einem
späteren Zeitpunkt neu versucht werden soll, es sei denn, es wurde
anders für den Drucker spezifiziert.
- ErrorPolicy retry-this-job
- Spezifiziert, dass ein fehlgeschlagener Druckauftrag sofort neu versucht
werden soll, es sei denn, es wurde anders für den Drucker
spezifiziert.
- ErrorPolicy stop-printer
- Spezifiziert, dass ein fehlgeschlagener Druckauftrag den Drucker anhalten
soll, es sei denn, es wurde anders für den Drucker spezifiziert.
Die Fehler-Richtlinie »stop-printer« ist die Vorgabe.
- FilterLimit Beschränkung
-
Spezifiziert die maximale Belastung der Filter, die gleichzeitig
laufen.
- FilterNice Nice-Wert
-
Spezifiziert die Planungspriorität (»nice«-Wert) von
Filtern, die laufen, um einen Druckauftrag auszudrucken.
- GSSServiceName Name
-
Spezifiziert den Dienstenamen, wenn Kerberos-Authentifizierung eingesetzt
wird. Die Vorgabedienstname ist »http«.
- HostNameLookups On
- HostNameLookups Off
- HostNameLookups Double
-
Spezifiziert, ob inverse Client-Adressabfragen erfolgen sollen oder
nicht.
- IdleExitTimeout Sekunden
-
Spezifiziert die Anzahl von Sekunden zum Warten, bevor bei
Inkativität unter Systemd oder Upstart beendet wird.
- Include Dateiname
-
Schließt die genannte Datei ein.
- JobKillDelay Sekunden
-
Spezifiziert die Anzahl von Sekunden zum Warten, bevor die Filter und
Backends beendet werden, die mit einem abgebrochenen oder angehaltenen
Druckauftrag verbunden sind.
- JobPrivateAccess all
- JobPrivateAccess default
- JobPrivateAccess {Benutzer|@Gruppe|@ACL|@OWNER|@SYSTEM}+
-
Spezifiziert eine Zugriffsliste für die privaten Werte eines
Auftrags. Die »Standard«- (default) Zugriffsliste ist
»@OWNER @SYSTEM«. »@ACL« passt auf die Werte
requesting-user-name-allowed oder requesting-user-name-denied des
Druckers.
- JobPrivateValues all
- JobPrivateValues default
- JobPrivateValues none
- JobPrivateValues Attributname-1 [ … Attributname-N ]
- Spezifiziert die Liste der Auftragswerte, die privat werden sollen. Die
»Standard«- (default) Werte sind »job-name«,
»job-originating-host-name« und
»job-originating-user-name«.
- JobRetryInterval Sekunden
-
Spezifiziert das Intervall zwischen Neuversuchen von Aufträgen in
Sekunden.
- JobRetryLimit Anzahl
-
Spezifiziert die Anzahl der Neuversuche, die für Auträge
durchgeführt werden.
- KeepAlive Yes
- KeepAlive No
-
Spezifiziert, ob HTTP-keep-alive-Verbindungen unterstützt
werden.
- KeepAliveTimeout Sekunden
-
Spezifiziert die Zeit, die Verbindungen am Leben erhalten werden.
- <Limit operations> … </Limit>
-
Spezifiziert die IPP-Operationen, die innerhalb einer Richtlinie begrenzt
werden.
- <Limit methods> … </Limit>
- <LimitExcept methods> … </LimitExcept>
-
Spezifiziert die HTTP-Methoden, die innerhalb eines Ortes begrenzt
werden.
- LimitRequestBody
-
Spezifiziert die maximale Größe jedes Druckauftrags.
- Listen IP-Adresse:Port
- Listen *:Port
- Listen /pfad/zu/Domain/Socket
-
Warten auf der angegebenen Adresse und Port oder Domain Socket-Pfad auf
Anfragen.
- <Location /path> … </Location>
-
Spezifiziert die Zugriffssteuerung für den benannten Ort.
- LogDebugHistory #-messages
-
Spezifiziert die Anzahl der Fehlersuchnachrichten, die protokolliert werden,
wenn ein Fehler in einem Druckauftrag auftritt.
- LogLevel alert
- LogLevel crit
- LogLevel debug2
- LogLevel debug
- LogLevel emerg
- LogLevel error
- LogLevel info
- LogLevel none
- LogLevel notice
- LogLevel warn
-
Spezifiziert die Protokollierungsstufe für die ErrorLog-Datei.
- LogTimeFormat standard
- LogTimeFormat usecs
-
Spezifiziert das Format von Datum und Zeit in den Protokolldateien.
- MaxClients Anzahl
-
Spezifiziert die maximale Anzahl an simultan zu unterstützenden
Clients.
- MaxClientsPerHost Anzahl
-
Spezifiziert die maximale Anzahl an simulatan zu unterstützenden
Clients von einer einzelnen Adresse.
- MaxCopies Anzahl
-
Spezifiziert die maximale Anzahl an Kopien, die ein Benutzer bei jedem
Auftrag drucken kann.
- MaxHoldTime Sekunden
-
Spezifiziert die maximale Zeit, die ein Auftrag für
»unbestimmte« Zeit angehalten bleiben darf, bevor er
abgebrochen wird. Wird er auf 0 gesetzt, werden keine gehaltenen
Aufträge abgebrochen.
- MaxJobs Anzahl
-
Spezifiziert die maximale Anzahl an simultan zu unterstützenden
Aufträgen.
- MaxJobsPerPrinter Anzahl
-
Spezifiziert die maximale Anzahl an simultan zu unterstützenden
Aufträgen pro Drucker.
- MaxJobsPerUser Anzahl
-
Spezifiziert die maximale Anzahl an simultan zu unterstützenden
Aufträgen pro Benutzer.
- MaxJobTime Sekunden
-
Spezifiziert die maximale Zeit, die ein Auftrag zum Drucken verbrauchen
darf, bevor er abgebrochen wird. Die Vorgabe ist 10800 Sekunden (3
Stunden). Falls auf 0 gesetzt, werden keine
»hängenden« (stuck) Aufträge abgebrochen.
- MaxLogSize Byteanzahl
-
Spezifiziert die maximale Größe der Protokolldateien, bevor
sie rotiert werden (0 für keine Rotation).
- MaxRequestSize Byteanzahl
-
Spezifiziert die maximale Anfrage-/Dateigröße in Bytes (0
für keine Begrenzung)
- MultipleOperationTimeout Sekunden
-
Spezifiziert die maximal erlaubte Zeit zwischen Dateien in einem
Druckauftrag aus mehreren Dateien.
- Order allow,deny
- Order deny,allow
-
Spezifiziert die Reihenfolge der HTTP-Zugriffssteuerung (allow, deny oder
deny, allow)
- PageLogFormat Format Zeichenkette
-
Spezifiziert das Format der Seitenprotokollzeilen.
- PassEnv Variable [… Variable]
-
Gibt die angegebene(n) Umgebungsvariable(n) an Kindprozesse weiter.
- <Policy name> … </Policy>
-
Spezifiziert die Zugriffskontrolle für die genannte Richtlinie.
- Port Nummer
-
Spezifiziert eine Portnummer, an der auf HTTP-Anfragen gewartet werden
soll.
- PreserveJobFiles Yes
- PreserveJobFiles No
-
Spezifiziert, ob Druckauftragsdateien nach dem Druck aufgehoben werden
sollen.
- PreserveJobHistory Yes
- PreserveJobHistory No
-
Spezifiziert, ob der Verlauf des Druckauftrags nach dem Druck aufgehoben
werden soll.
- PrintcapFormat bsd
- PrintcapFormat plist
- PrintcapFormat solaris
-
Spezifiziert das Format der Printcap-Datei.
- ReloadTimeout Sekunden
-
Spezifiziert die Zeitspanne, während der auf die Beendigung von
Aufträgen gewartet werden soll, bevor der Auftragsplaner
(Scheduler) neu gestartet wird.
- Require group group-name-list
- Benötigt Benutzer user-name-list
- Benötigt valid-user
-
Spezifiziert, dass Benutzer- oder Gruppenauthentifizierung benötigt
wird.
- RIPCache Bytes
-
Spezifiziert die maximale Menge an zu verwendendem Speicher beim
Konvertieren von Bilder und PostScript-Dateien in Bitmaps für den
Drucker.
- Satisfy all
- Satisfy any
-
Spezifiziert, ob alle (alle) oder eine (any) Beschränkung für
einen Standort erfüllt sein muss, um Zugriff zu erlauben.
- ServerAdmin Benutzer@domain.com
-
Spezifiziert die E-Mail-Adresse des Server-Administrators.
- ServerAlias hostname [… hostname]
- ServerAlias *
-
Spezifiziert einen alternativen Namen, unter dem der Server bekannt ist. Der
besondere Name »*« erlaubt die Verwendung jedes Namens.
- ServerName Rechnername-oder-IP-Adresse
-
Spezifiziert den vollqualifizierten Rechnernamen des Servers.
- ServerTokens Full
- ServerTokens Major
- ServerTokens Minimal
- ServerTokens Minor
- ServerTokens None
- ServerTokens OS
- ServerTokens ProductOnly
-
Spezifiziert, welche Informationen im Server-Header von HTTP-Antworten
enthalten sein sollen.
- SetEnv Variable Wert
-
Setzt die angegebene Umgebungsvariable zur Weitergabe an Kindprozesse.
- SSLListen
-
Wartet auf der angegebenen Adresse und dem Port auf verschlüsselte
Verbindungen.
- SSLOptions None
- SSLOptions [NoEmptyFragments] [AllowRC4] [Allow
SSL3]
-
Sets SSL/TLS protocol options for encrypted connections. By default, CUPS
only supports encryption using TLS v1.0 or higher using known secure
cipher suites. The NoEmptyFragments option allows CUPS to work with
Microsoft Windows with the FIPS conformance mode enabled. The
AllowRC4 option enables the 128-bit RC4 cipher suites, which are
required for some older clients that do not implement newer ones. The
AllowSSL3 option enables SSL v3.0, which is required for some older
clients that do not support TLS v1.0.
- SSLPort
-
Wartet auf dem angegebenen Port auf verschlüsselte Verbindungen.
- StrictConformance Yes
- StrictConformance No
-
Spezifiziert, ob der Auftragsplaner von den Clients verlangt, dass sie
streng den IPP-Spezifikationen folgen. Standardmäßig
»No«.
- SubscriptionPrivateAccess all
- SubscriptionPrivateAccess default
- SubscriptionPrivateAccess {Benutzer|@Gruppe|@ACL|@OWNER|@SYSTEM}+
-
Spezifiziert eine Zugriffsliste für die privaten Werte eines
Abonnements. Die »Standard«- (default) Zugriffsliste ist
»@OWNER @SYSTEM«. »@ACL« passt auf die Werte
requesting-user-name-allowed oder requesting-user-name-denied des
Druckers.
- SubscriptionPrivateValues all
- SubscriptionPrivateValues default
- SubscriptionPrivateValues none
- SubscriptionPrivateValues Attributname-1 [ … Attributname-N ]
- Spezifiziert die Liste der Auftragswerte, die privat werden sollen. Die
»Standard«- (default) Werte sind
»notify-events«, »notify-pull-method«,
»notify-recipient-uri«,
»notify-subscriber-user-name« und
»notify-user-data«.
- SystemdIdleExit No
- SystemdIdleExit Yes
-
Spezifiziert, ob beim Start durch Systemd im Falle von Inaktivität
beendet werden soll.
- Timeout Sekunden
-
Spezifiziert die HTTP-Zeitüberschreitung in Sekunden.
- WebInterface yes
- WebInterface no
- Spezifiziert, ob die Webschnittstelle freigegeben ist.
SIEHE AUCH¶
classes.conf(5),
cups-files.conf(5),
cupsd(8),
mime.convs(5),
mime.types(5),
printers.conf(5),
subscriptions.conf(5),
http://localhost:631/help
COPYRIGHT¶
Copyright 2007-2013 by Apple Inc.