Scroll to navigation

cupsd.conf(5) Apple Inc. cupsd.conf(5)

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.
CUPS 28. Juli 2014