Ubuntu Manpage: cupsd.conf - Server-Konfigurationsdatei für CUPS

Provided by: cups-daemon_2.1.3-4ubuntu0.11_amd64

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 der Datei 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. Konfigurationsdirektiven bestehen typischerweise aus einem Namen und null
oder mehr durch Leerzeichen getrennten Werten. Die Groß- und Kleinschreibung der Namen und
Werte der Konfigurationsdirektiven ist nicht relevant. Kommentarzeilen beginnen mit dem
Zeichen »#«.

OBERSTE DIREKTIVEN
Die nachfolgenden obersten Direktiven werden von cupsd(8) verstanden:

AccessLogLevel config

AccessLogLevel actions

AccessLogLevel all
Spezifiziert die Protokollierstufe für die Datei AccessLog. Die Stufe »config«
protokolliert, wenn Drucker und Klassen hinzugefügt, gelöscht oder verändert werden
und wenn auf Konfigurationsdateien zugegriffen oder diese geändert werden. Die Stufe
»actions« protokolliert, wenn Druckaufträge hinzugefügt, gehalten, freigegeben,
verändert oder abgebrochen werden oder einer der Bedingungen für »config« zutrifft.
Die Stufe »all« protokolliert alle Anfragen. Die Vorgabestufe ist »actions«.

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. Die Vorgabe ist »No«.

BrowseLocalProtocols all

BrowseLocalProtocols dnssd

BrowseLocalProtocols none
Spezifziert, welches Protokoll für die lokale Druckerfreigabe verwandt wird. Die
Vorgabe ist »dnssd« auf Systemen, die Bonjour unterstützen und andernfalls »none«.

BrowseWebIF Yes

BrowseWebIF No
Spezifiziert, ob die CUPS-Web-Schnittstelle bekanntgemacht wird. Die Vorgabe ist
»No«.

Browsing Yes

Browsing No
Spezifiziert, ob freigegebene Drucker bekanntgemacht werden. Die Vorgabe ist »No«.

Classification Deckblatt
Spezifiziert die Sicherheitsklassifizierung des Servers. Jeder gültige Deckblattname
kann verwandt werden, darunter »classified«, »confidential«, »secret«, »topsecret«
und »unclassified«. Der Deckblattname kann auch entfallen, um die sicheren
Druckfunktionen zu deaktivieren. Standardmäßig gibt es kein Einstufungsdeckblatt.

ClassifyOverride Yes

ClassifyOverride No
Spezifiziert, ob es Benutzern erlaubt werden soll, die Einstufung (Titelseite)
individueller Druckaufträge mit der Option »job-sheets« zu ändern. Die Vorgabe ist
»No«.

DefaultAuthType Basic

DefaultAuthType Negotiate
Spezifiziert den standardmäßig zu verwendenden Authentifizierungstyp. Die Vorgabe ist
»Basic«.

DefaultEncryption Never

DefaultEncryption IfRequested

DefaultEncryption Required
Gibt an, ob Verschlüsselung für authentifizierte Anfragen benutzt werden soll. Die
Vorgabe ist »Required«.

DefaultLanguage Standorteinstellung
Spezifiziert die Standardsprache, die für Text und Webinhalte verwandt werden soll.
Die Vorgabe ist »en«.

DefaultPaperSize Auto

DefaultPaperSize None

DefaultPaperSize Größenname
Gibt die Standardpapiergröße für neue Druckerwarteschlangen an. »Auto« benutzt eine
standortabhängige Vorgabe, während »None« angibt, dass keine Papiergröße vorgegeben
ist. Bestimmte Größennamen sind typischerweise »Letter« oder »A4«. Die Vorgabe ist
»Auto«.

DefaultPolicy Richtlinienname
Spezifiziert die zu verwendende Standardzugriffsrichtlinie. Die
Standardzugriffsrichtlinie ist »Default«.

DefaultShared Yes

DefaultShared No
Spezifiziert, ob lokale Drucker standardmäßig freigegeben sind. Die Vorgabe ist
»Yes«.

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. Die Vorgabe ist
»30«.

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 gleichzeitig ausgeführter Filter. Damit können
Platten-, Arbeitsspeicher- und CPU-Ressourcenprobleme minimiert werden. Eine
Beschränkung von 0 deaktiviert die Beschränkung von Filtern. Ein durchschnittlicher
Ausdruck auf einen nicht PostScript-Drucker benötigt eine Filter-Beschränkung von
ungefähr 200. Ein PostScript-Drucker benötigt ungefähr die Hälfte (100) davon. Wird
die Beschränkung unterhalb dieser Schwellen gesetzt, wird der Auftragsplaner effektiv
darauf eingeschränkt, immer nur einen einzelnen Auftrag gleichzeitig zu drucken. Die
Vorgabe ist »0«.

FilterNice Nice-Wert
Spezifiziert die Planungspriorität (nice(8)-Wert) von Filtern, die laufen, um einen
Druckauftrag auszudrucken. Die »nice«-Werte liegen im Bereich von 0 (der höchsten
Priorität) bis zu 19, der niedrigsten Priorität. Die Vorgabe ist 0.

GSSServiceName Name
Spezifiziert den Dienstenamen, wenn Kerberos-Authentifizierung eingesetzt wird. Die
Vorgabedienstname ist »http«.

HostNameLookups On

HostNameLookups Off

HostNameLookups Double
Specifies whether to do reverse lookups on connecting clients. The "Double" setting
causes cupsd(8) to verify that the hostname resolved from the address matches one of
the addresses returned for that hostname. Double lookups also prevent clients with
unregistered addresses from connecting to your server. The default is "Off" to avoid
the potential server performance problems with hostname lookups. Only set this option
to "On" or "Double" if absolutely required.

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. Die Vorgabe ist »30«.

JobRetryInterval Sekunden
Spezifiziert das Intervall in Sekunden, in dem der Auftrag erneut versucht wird. Dies
wird typischerweise für Fax-Warteschlangen verwandt, kann aber auch mit normalen
Druckwarteschlangen verwendet werden, deren Fehlerrichtlinie »retry-job« oder
»retry-current-job« ist. Die Vorgabe ist »30«.

JobRetryLimit Anzahl
Spezifiziert die Anzahl der Wiederholungen für Aufträge. Dies wird typischerweise für
Fax-Warteschlangen verwandt, kann aber auch mit normalen Druckwarteschlangen
verwendet werden, deren Fehlerrichtlinie »retry-job« oder »retry-current-job« ist.
Die Vorgabe ist »5«.

KeepAlive Yes

KeepAlive No
Spezifiziert, ob HTTP-keep-alive-Verbindungen unterstützt werden. Die Vorgabe ist
»Yes«.

KeepAliveTimeout Sekunden
Spezifiziert, wie lange leer laufende Client-Verbindugnen offen bleiben sollen. Die
Vorgabe ist »30«.

<Limit Vorgang …> … </Limit>
Spezifiziert die IPP-Vorgänge, die innerhalb eines Richtlinienabschnitts begrenzt
werden. IPP-Vorgangsnamen sind weiter unten im Abschnitt »IPP-VORGÄNGE« beschrieben.

<LimitExcept Methode …> … </LimitExcept>
Spezifiziert die HTTP-Methoden, die innerhalb eines »Location«-Abschnittes begrenzt
werden. HTTP-Methodennamen sind weiter unten im Abschnitt »HTTP-METHODEN« aufgeführt.

LimitRequestBody Größe
Legt die maximale Größe von Druckdateien, IPP-Anfragen und HTML-Formulardaten fest.
Die Vorgabe ist »0«, womit die Überprüfung deaktiviert wird.

Listen IPv4-Adresse:Port

Listen [IPv6-Adresse]:Port

Listen *:Port

Listen /Pfad/zu/Domain/Socket
Wartet auf den angegebenen Adressen und Ports oder Domain-Socketpfaden auf Anfragen.
Mehrere »Listen«-Direktiven können angegeben werden, um auf mehreren Adressen auf
Anfragen zu warten. Die Direktive »Listen« ist ähnlich zu der Direktive »Port«,
erlaubt es Ihnen aber, den Zugriff auf bestimmte Schnittstellen oder Netze zu
beschränken.

ListenBackLog Anzahl
Spezifiziert die Anzahl von erlaubten unerledigten Verbindungen. Dies betrifft
normalerweise nur sehr beschäftigte Server, die die MaxClients-Beschränkung erreicht
haben, kann aber auch von einer großen Anzahl von gleichzeitigen Verbindungen
ausgelöst werden. Wenn die Beschränkung erreicht ist, wird das Betriebssystem
zusätzliche Verbindungen ablehnen, bis der Auftragsplaner wieder unerledigte
Verbindungen erlaubt. Die Vorgabe ist die betriebssystemabhängige Beschränkung,
typischerweise »5« auf älteren Betriebssystemen oder »128« auf neueren
Betriebssystemen.

<Location /Pfad> … </Location>
Spezifiziert die Zugriffssteuerung für den benannten Ort. Pfade werden weiter unten
im Abschnitt »ORTSPFADE« beschrieben.

LogDebugHistory Anzahl
Spezifiziert die Anzahl der Fehlersuchnachrichten, die zum Protokollieren
zurückgehalten werden, wenn ein Fehler in einem Druckauftrag auftritt.
Fehlersuchnachrichten werden unabhängig von der LogLevel-Einstellung protokolliert.

LogLevel none

LogLevel emerg

LogLevel alert

LogLevel crit

LogLevel error

LogLevel warn

LogLevel notice

LogLevel info

LogLevel debug

LogLevel debug2
Spezifiziert die Protokollierstufe in der Datei ErrorLog. Der Wert »none« beendet
alle Protokollierung, während »debug2« alles protokolliert. Die Vorgabe ist »warn«.

LogTimeFormat standard

LogTimeFormat usecs
Spezifiziert das Format von Datum und Uhrzeit in den Protokolldateien. Der Wert
»standard« ist die Vorgabe und protokolliert in ganzen Sekunden, während »usecs« in
Mikrosekunden protokolliert.

MaxClients Anzahl
Spezifiziert die maximale Anzahl an gleichzeitigen Clients, die vom Auftragsplaner
erlaubt werden. Die Vorgabe ist »100«.

MaxClientsPerHost Anzahl
Spezifiziert die maximale Anzahl an gleichzeitigen Clients, die von einer einzigen
Adresse erlaubt sind. Die Vorgabe ist der Wert MaxClients.

MaxCopies Anzahl
Spezifiziert die maximale Anzahl an Kopien, die ein Benutzer bei jedem Auftrag
drucken kann. Die Vorgabe ist »9999«.

MaxHoldTime Sekunden
Spezifiziert die maximale Zeit, die ein Auftrag für »unbestimmte« Zeit angehalten
bleiben darf, bevor er abgebrochen wird. Die Vorgabe ist »0«, womit gehaltene
Aufträge abgebrochen werden.

MaxJobs Anzahl
Spezifiziert die maximale Anzahl an gleichzeitigen Aufträgen, die erlaubt sind.
Setzen Sie dies auf »0«, um eine unbegrenzte Anzahl an Aufträgen zu erlauben. Die
Vorgabe ist »500«.

MaxJobsPerPrinter Anzahl
Spezifiziert die maximale Anzahl an Aufträgen, die gleichzeitig pro Drucker erlaubt
sind. Die Vorgabe ist »0«, womit bis zu MaxJobs Aufträge pro Drucker erlaubt sind.

MaxJobsPerUser Anzahl
Spezifiziert die maximale Anzahl an Aufträgen, die gleichzeitig pro Benutzer erlaubt
sind. Die Vorgabe ist »0«, womit bis zu MaxJobs Aufträge pro Benutzer erlaubt sind.

MaxJobTime Sekunden
Spezifiziert die maximale Zeit, die ein Auftrag zum Drucken verbrauchen darf, bevor
er abgebrochen wird. Falls auf 0 gesetzt, werden keine »hängenden« (stuck) Aufträge
abgebrochen. Die Vorgabe ist 10800 Sekunden (3 Stunden).

MaxLogSize Größe
Spezifiziert die maximale Größe der Protokolldateien, bevor sie rotiert werden. Der
Wert »0« deaktiviert die Rotation der Protokolldateien. Die Vorgabe ist »1048576« (1
MB).

MultipleOperationTimeout Sekunden
Spezifiziert die maximal erlaubte Zeit zwischen Dateien in einem Druckauftrag aus
mehreren Dateien. Die Vorgabe ist »300« (5 Minuten).

PageLogFormat Formatzeichenkette
Spezifiziert das Format der PageLog-Zeilen. Sequenzen beginnen mit einem
Prozentzeichen (%) und werden durch die entsprechende Information ersetzt, während
alle anderen Zeichen unverändert kopiert werden. Die folgenden Prozentsequenzen
werden erkannt:

"%%" fügt ein einzelnes Prozentzeichen ein.
"%{name}" fügt den Wert des angegebenen IPP-Attributs ein.
"%C" fügt die Anzahl der Kopien für die aktuelle Seite ein.
"%P" fügt die aktuelle Seitenzahl ein.
"%T" fügt das aktuelle Datum und die aktuelle Zeit im »common log format« ein.
"%j" fügt die Auftrags-ID ein.
"%p" fügt den Druckernamen ein.
"%u" fügt den Benutzernamen ein.

Die Vorgabe ist die leere Zeichenkette, womit das Protokollieren der Seiten
deaktiviert wird. Die Zeichenkette »%p %u %j %T %P %C %{job-billing}
%{job-originating-host-name} %{job-name} %{media} %{sides}« erstellt ein
Seitenprotokoll mit den Standardeinträgen.

<Policy Name> … </Policy>
Spezifiziert die Zugriffskontrolle für die genannte Richtlinie.

Port Nummer
Wartet auf der angegebenen Portnummer auf Verbindungen.

PreserveJobFiles Yes

PreserveJobFiles No

PreserveJobFiles Sekunden
Spezifiziert, ob Auftragsdateien (Dokumente) erhalten bleiben, nachdem ein Auftrag
gedruckt wurde. Falls ein numerischer Wert angegeben wird, werden die Auftragsdateien
für die angegebene Anzahl an Sekunden nach dem Druck erhalten. Die Vorgabe ist
»86400« (einen Tag erhalten).

PreserveJobHistory Yes

PreserveJobHistory No

PreserveJobHistory Sekunden
Spezifiziert, ob die Auftragschronik nach dem Druck behalten wird. Falls ein
numerischer Wert angegeben ist, wird die Auftragschronik für die angegebene Anzahl
von Sekunden nach dem Druck behalten. Falls »Yes« wird die Auftragschronik behalten,
bis die Begrenzung MaxJobs erreicht ist. Die Vorgabe ist »Yes«.

ReloadTimeout Sekunden
Spezifiziert die Zeitspanne, während der auf die Beendigung von Aufträgen gewartet
werden soll, bevor der Auftragsplaner (Scheduler) neu gestartet wird. Die Vorgabe ist
»30«.

RIPCache Größe
Spezifiziert die maximale Menge an zu verwendendem Speicher beim Konvertieren von
Dokumenten in Bitmaps für den Drucker. Die Vorgabe ist »128m«.

ServerAdmin E-Mail-Adresse
Spezifiziert die E-Mail-Adresse des Server-Administrators. Die Vorgabe ist
»root@ServerName«.

ServerAlias Rechnername [ … Rechnername ]

ServerAlias *
Die Direktive ServerAlias wird für die Überprüfung von HTTP-Host-Kopfzeilen bei der
Verbindungsaufnahme von Clients zum Auftragsplaner über externe Schnittstellen
verwandt. Wenn Sie den besondere Name »*« verwenden, kann Ihr System für
Browser-basierte DNS-Rebinding-Angriffe verwundbar werden, selbst falls die Zugriffe
über eine Firewall erfolgen. Falls die automatische Erkennung von alternativen Namen
nicht funktioniert, empfehlen wir, jeden alternativen Namen mit der Direktive
ServerAlias aufzuführen, statt »*« zu verwenden.

ServerName Rechnername
Spezifiziert den vollqualifizierten Rechnernamen des Servers. Die Vorgabe ist der
Wert, der von dem Befehl hostname(1) berichtet wird.

ServerTokens None

ServerTokens ProductOnly

ServerTokens Major

ServerTokens Minor

ServerTokens Minimal

ServerTokens OS

ServerTokens Full
Spezifiziert, welche Informationen in die Server-Kopfzeilen von HTTP-Antworten
aufgenommen werden. »None« deaktiviert die Server-Kopfzeilen. »ProductOnly« meldet
»CUPS«. »Major« berichtet »CUPS 2.0«. »Minimal« berichtet »CUPS 2.0.0«. »OS«
berichtet »CUPS 2.0.0 (UNAME)«, wobei UNAME die Ausgabe des Befehls uname(1) ist.
»Full« berichtet »CUPS 2.0.0 (UNAME) IPP/2.0«. Die Vorgabe ist »Minimal«.

SSLListen IPv4-Adresse:Port

SSLListen [IPv6-Adresse]:Port

SSLListen *:Port
Wartet auf der angegebenen Adresse und dem Port auf verschlüsselte Verbindungen.

SSLOptions [AllowRC4] [AllowSSL3]

SSLOptions None
Setzt Verschlüsselungsoptionen. Standardmäßig unterstützt CUPS nur Verschlüsselung
mit TLS v1.0 oder höher mit bekanntermaßen sicheren Verschlüsselungsverfahren. Die
Option AllowRC4 aktiviert die 128-Bit RC4-Chiffre, die für einige ältere Clients
benötigt wird, die keine neuere Chiffre implementiert haben. Die Option AllowSSL3
aktiviert SSL v3.0, die für einige ältere Clients benötigt wird, die TLS v1.0 nicht
unterstützen.

SSLPort Port
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. Die Vorgabe ist »No«.

Timeout Sekunden
Spezifiziert die HTTP-Zeitüberschreitung. Die Vorgabe ist »300« (5 Minuten).

WebInterface yes

WebInterface no
Spezifiziert, ob die Webschnittstelle freigegeben ist. Die Vorgabe ist »No«.

HTTP-METHODENNAMEN
Die folgenden HTTP-Methoden werden von cupsd(8) unterstützt:

GET Wird von einem Client zum Herunterladen von Icons und anderen Druckresourcen und zum
Zugriff auf die CUPS-Webschnittstelle verwandt.

HEAD Wird von einem Client verwandt, um den Typ, die Größe und das Änderungsdatum von
Ressourcen zu erhalten.

OPTIONEN
Wird vom Client verwandt, um eine sichere (SSL/TLS)-Verbindung zu etablieren.

POST Wird von einem Client zum Einreichen von IPP-Anfragen und HTML-Formularen aus der
CUPS-Webschnittstelle verwandt.

PUT Wird von einem Client zum Hochladen von Konfigurationsdateien verwandt.

IPP-VORGANGSNAMEN
Die folgenden IPP-Vorgänge werden von cupsd(8) unterstützt:

CUPS-Accept-Jobs
Erlaubt es einem Drucker, neue Aufträge zu akzeptieren.

CUPS-Add-Modify-Class
Fügt eine Druckerklasse hinzu oder ändert sie.

CUPS-Add-Modify-Printer
Fügt einen Drucker hinzu oder ändert ihn.

CUPS-Authenticate-Job
Gibt einen Auftrag frei, der für Authentifizierung gehalten ist.

CUPS-Delete-Class
Löscht eine Druckerklasse.

CUPS-Delete-Printer
Löscht einen Drucker.

CUPS-Get-Classes
Ermittelt eine Liste von Druckerklassen.

CUPS-Get-Default
Ermittelt die Servervorgabe für den Drucker oder die Druckerklasse.

CUPS-Get-Devices
Ermittelt eine Liste von derzeit verfügbaren Geräten.

CUPS-Get-Document
Ermittelt eine Dokumentendatei für einen Auftrag.

CUPS-Get-PPD
Ermittelt eine PPD-Datei.

CUPS-Get-PPDs
Ermittelt eine Liste von installierten PPD-Dateien.

CUPS-Get-Printers
Eermittelt eine Liste von Druckern.

CUPS-Move-Job
Verschiebt einen Auftrag.

CUPS-Reject-Jobs
Verhindert, dass ein Drucker neue Aufträge akzeptiert.

CUPS-Set-Default
Setzt die Server-Vorgabe für einen Drucker oder eine Druckerklasse.

Cancel-Job
Bricht einen Auftrag ab.

Cancel-Jobs
Bricht einen oder mehrere Aufträge ab.

Cancel-My-Jobs
Bricht einen oder mehrere von einem Benutzer erstellte Aufträge ab.

Cancel-Subscription
Beendet ein Abonnement.

Close-Job
Schließt einen Auftrag, der auf weitere Dokumente wartet.

Create-Job
Erstellt einen neuen Auftrag ohne Dokumente.

Create-Job-Subscriptions
Erstellt ein Abonnement für Auftragsereignisse.

Create-Printer-Subscriptions
Erstellt ein Abonnement für Druckerereignisse.

Get-Job-Attributes
Ermittelt Informationen über einen Auftrag.

Get-Jobs
Ermittelt eine Liste von Aufträgen.

Get-Notifications
Ermittelt eine Liste von Ereignisbenachrichtigungen für ein Abonnement.

Get-Printer-Attributes
Ermittelt Informationen über einen Drucker oder eine Druckerklasse.

Get-Subscription-Attributes
Ermittelt Informationen über ein Abonnement.

Get-Subscriptions
Ermittelt eine Liste von Abonnements.

Hold-Job
Hält einen Auftrag vom Druck zurück.

Hold-New-Jobs
Hält alle neuen Aufträge vom Druck zurück.

Pause-Printer
Beendet die Verarbeitung von Aufträgen von einem Drucker oder einer Druckerklasse.

Pause-Printer-After-Current-Job
Beendet die Verarbeitung von Aufträgen durch einen Drucker oder eine Druckerklasse,
nachdem der aktuelle Auftrag beendet wurde.

Print-Job
Erstellt einen neuen Auftrag mit einem einzelnen Dokument.

Purge-Jobs
Bricht einen oder mehrere Aufträge ab und löscht die Auftragschronik.

Release-Held-New-Jobs
Erlaubt, vorher angehaltenen Aufträgen zu drucken.

Release-Job
Erlaubt einem Auftrag, zu drucken.

Renew-Subscription
Erneuert ein Abonnement.

Restart-Job
Druckt falls möglich einen Auftrag erneut.

Send-Document
Fügt ein Dokument zu einem Auftrag hinzu.

Set-Job-Attributes
Ändert Auftragsinformationen.

Set-Printer-Attributes
Ändert Drucker- oder Druckerklasseninformationen.

Validate-Job
Validiert Optionen für einen neuen Auftrag.

ORTSPFADE
Die folgenden Pfade werden bei der Konfiguration von cupsd(8) häufig verwandt:

/ Der Pfad für alle »get«-Vorgänge (get-printers, get-jobs, usw.)

/admin
Der Pfad für alle Administrationsvorgänge (add-printer, delete-printer,
start-printer, usw.)

/admin/conf
Der Pfad, um auf die CUPS-Konfigurationsdateien (cupsd.conf, client.conf, usw.)
zuzugreifen

/admin/log
Der Pfad, um auf die CUPS-Protokolldateien (access_log, error_log, page_log)
zuzugreifen

/classes
Der Pfad für alle Druckerklassen

/classes/name
Die Ressourcen für die benannte Druckerklasse

/jobs
Der Pfad für alle Aufträge (hold-job, release-job, usw.)

/jobs/id
Der Pfad für den angegebenen Auftrag

/printers
Der Pfad für alle Drucker

/printers/name
Der Pfad für den benannten Drucker

/printers/name.png
Der Icon-Dateipfad für den benannten Drucker

/printers/name.ppd
Der PPD-Dateipfad für den benannten Drucker

DIREKTIVEN, DIE INNERHALB VON ORTS- UND EINSCHRÄNKUNGS-ABSCHNITTEN GÜLTIG SIND
Die folgenden Direktiven können innerhalb von Orts- und Einschränkungsabschnitten in der
Datei cupsd.conf eingetragen werden:

Allow all

Allow none

Allow Rechner.domain.com

Allow *.domain.com

Allow IPv4-Adresse

Allow IPv4-Adresse/Netzmaske

Allow IPv4-Adresse/mm

Allow [IPv6-Adresse]

Allow [IPv6-Adresse]/mm

Allow @IF(Name)

Allow @LOCAL
Erlaubt Zugriffe von den benannten Rechnern, Domains, Adressen oder Schnittstellen.
Die Direktive »Order« steuert, ob »Allow«-Zeilen vor oder nach »Deny«-Zeilen
ausgewertet werden.

AuthType None

AuthType Basic

AuthType Default

AuthType Negotiate
Legt die Art der benötigten Authentifizierung fest. Der Wert »Default« entspricht dem
Wert »DefaultAuthType«.

Deny all

Deny none

Deny Rechner.domain.com

Deny *.domain.com

Deny IPv4-Adresse

Deny IPv4-Adresse/Netzmaske

Deny IPv4-Adresse/mm

Deny [IPv6-Adresse]

Deny [IPv6-Adresse]/mm

Deny @IF(Name)

Deny @LOCAL
Verweigert Zugriffe von den benannten Rechnern, Domains, Adressen oder
Schnittstellen. Die Direktive »Order« steuert, ob »Deny«-Zeilen vor oder nach
»Allow«-Zeilen ausgewertet werden.

Encryption IfRequested

Encryption Never

Encryption Required
Spezifiziert die Verschlüsselungsstufe, die für einen bestimmten Ort benötigt wird.
Der Vorgabewert ist »IfRequested«.

Order allow,deny
Legt fest, dass der Zugriff standardmäßig verweigert wird. »Allow«-Zeilen werden dann
nach »Deny«-Zeilen verarbeitet, um zu bestimmen, ob ein Client auf eine bestimmte
Ressource zugreifen darf.

Order deny,allow
Legt fest, dass der Zugriff standardmäßig erlaubt wird. »Deny«-Zeilen werden dann
nach »Allow«-Zeilen verarbeitet, um zu bestimmen, ob ein Client auf eine bestimmte
Ressource zugreifen darf.

Require group Gruppenname [ Gruppenname … ]
Legt fest, dass ein authentifizierter Benutzer ein Mitglied einer der benannten
Gruppen sein muss.

Require user {Benutzername|@Gruppenname} …
Legt fest, dass ein authentifizierter Benutzer auf eine der benannten Benutzer passen
oder ein Mitglied einer der benannten Gruppen sein muss. Der Gruppenname »@SYSTEM«
entspricht der in der Direktive SystemGroup in der Datei cups-files.conf(5)
definierten Liste von Gruppen. Der Gruppenname »@OWNER« entspricht dem Eigentümer der
Ressource, beispielsweise der Person, die den Auftrag eingereicht hat.

Require valid-user
Legt fest, dass jeder authentifizierte Benutzer akzeptiert wird.

Satisfy all
Legt fest, dass alle »Allow«-, »AuthType«-, »Deny«-, »Order«- und
»Require«-Bedingungen erfüllt sein müssen, damit der Zugriff erlaubt wird.

Satisfy any
Legt fest, dass jeder Client auf eine Ressource zugreifen darf, falls entweder die
Authentifizierungs- (AuthType/Require) oder die Adress- (Allow/Deny/Order) Bedingung
erfüllt ist. Beispielsweise kann dies dazu verwandt werden, Authentifizierung nur bei
Zugriff aus der Ferne zu verlangen.

DIREKTIVEN, DIE INNERHALB VON POLICY-ABSCHNITTEN GÜLTIG SIND
Die folgenden Direktiven dürfen innerhalb von Policy-Abschnitten in der Datei cupsd.conf
gesetzt werden.

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. »@OWNER«
passt auf den Eingentümer des Auftrags. »@SYSTEM« passt auf die in der Direktive
SystemGroup in der Datei cups-files.conf(5) aufgeführten Gruppen.

JobPrivateValues all

JobPrivateValues default

JobPrivateValues none

JobPrivateValues Attributename [ … Attributname ]
Spezifiziert die Liste der Auftragswerte, die privat werden sollen. Die »Standard«-
(default) Werte sind »job-name«, »job-originating-host-name«,
»job-originating-user-name« und »phone«.

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. »@OWNER«
passt auf den Eingentümer des Auftrags. »@SYSTEM« passt auf die in der Direktive
SystemGroup in der Datei cups-files.conf(5) aufgeführten Gruppen.

SubscriptionPrivateValues all

SubscriptionPrivateValues default

SubscriptionPrivateValues none

SubscriptionPrivateValues Attributname [ … Attributname ]
Spezifiziert die Liste der Abonnementswerte, 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«.

KONFORMITÄT

       Das        Dateiformat        der        cupsd.conf        basiert         auf         dem
       Apache-HTTP-Server-Konfigurationsdateiformat.

BEISPIELE

       Alles protokollieren, mit einer maximalen Protokolldateigröße von 32 Megabytes:

           AccessLogLevel all
           LogLevel debug2
           MaxLogSize 32m

       Authentifizierung für Zugriffe außerhalb des 10er-Netzes verlangen:

           <Location />
           Order allow,deny
           Allow from 10./8
           AuthType Basic
           Require valid-user
           Satisfy any
           </Location>

SIEHE AUCH

       classes.conf(5),     cups-files.conf(5),     cupsd(8),    mime.convs(5),    mime.types(5),
       printers.conf(5), subscriptions.conf(5), CUPS-Online-Hilfe (http://localhost:631/help)

COPYRIGHT

       Copyright © 2007-2015 by Apple Inc.