.\"
.\" cupsfilter man page for CUPS.
.\"
.\" Copyright 2007-2014 by Apple Inc.
.\"
.\" These coded instructions, statements, and computer programs are the
.\" property of Apple Inc. and are protected by Federal copyright
.\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\" which should have been included with this file.  If this file is
.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH cupsfilter 8 CUPS "11. Juni 2014" "Apple Inc."
.SH NAME
cupsfilter \- konvertiere eine Datei in ein anderes Format mittels
CUPS\-Filter
.SH SYNOPSIS
\fBcupsfilter\fP [ \fB\-\-list\-filters\fP ] [ \fB\-D\fP ] [ \fB\-U\fP \fIBenutzer\fP ] [ \fB\-c\fP
\fIKonfig\-Datei\fP ] [ \fB\-d\fP \fIDrucker\fP ] [ \fB\-e\fP ] [ \fB\-i\fP \fIMIME/typ\fP ] [
\fB\-j\fP \fIAuftrags\-ID[,N]\fP ] [ \fB\-m\fP \fIMIME/typ\fP ] [ \fB\-n\fP \fIKopien\fP ] [ \fB\-o\fP
\fIName=Wert\fP ] [ \fB\-p\fP \fIDateiname.ppd\fP ] [ \fB\-t\fP \fITitel\fP ] [ \fB\-u\fP ]
\fIDateiname\fP
.SH BESCHREIBUNG
\fBcupsfilter\fP ist eine Oberfläche für das CUPS\-Filter\-Subsystem, das es
erlaubt, eine Datei in ein spezielles Format umzuwandeln, als ob Sie diese
Datei mittels CUPS gedruckt hätten. Standardmäßig erzeugt \fBcupsfilter\fP eine
PDF\-Datei. Die konvertierte Datei wird zur Standardausgabe geschickt.
.SH OPTIONEN
.TP  5
\fB\-\-list\-filters\fP
Führt die Filter nicht wirklich aus, sondern gibt den verwandten Filter nach
Stdout aus.
.TP  5
\fB\-D\fP
Löscht die Eingabedatei nach der Umwandlung.
.TP  5
\fB\-U \fP\fIBenutzername\fP
Legt den Benutzernamen, der an die Filter weitergegeben wird,
fest. Standardmäßig ist dies der Name des aktuellen Benutzers.
.TP  5
\fB\-c \fP\fIKonfig\-Datei\fP
Verwendet die benannte cups\-files.conf\-Konfigurationsdatei.
.TP  5
\fB\-d \fP\fIDrucker\fP
Verwendet Informationen von dem benannten Drucker.
.TP  5
\fB\-e\fP
Verwendet jeden Filter aus der PPD\-Datei.
.TP  5
\fB\-i \fP\fIMIME/Typ\fP
Legt den Quelldateityp fest. Der Vorgabedateityp wird anhand des Dateinamens
und des Inhalts der Datei geraten.
.TP  5
\fB\-j \fP\fIAuftrags\-ID[,N]\fP
Konvertiert Dokument N aus dem festgelegten Druckauftrag. Falls N
ausgelassen wird, wird Dokument 1 konvertiert.
.TP  5
\fB\-m \fP\fIMIME/Typ\fP
Legt den Zieldateityp fest. Standardmäßig ist dies
application/pdf. Verwenden Sie Drucker/foo, um zu dem Druckerformat, wie es
von den Filtern in der PPD\-Datei definiert ist, zu konvertieren.
.TP  5
\fB\-n \fP\fIKopien\fP
Legt die Anzahl der zu erstellenden Kopien fest.
.TP  5
\fB\-o \fP\fIName=Wert\fP
Legt die an die CUPS\-Filter zu übergebenden Optionen fest.
.TP  5
\fB\-p \fP\fIDateiname.ppd\fP
Legt die zu verwendende PPD\-Datei fest.
.TP  5
\fB\-t \fP\fITitel\fP
Legt den Dokumententitel fest.
.TP  5
\fB\-u\fP
Löscht die PPD\-Datei nach der Umwandlung.
.SH EXIT\-STATUS
Im Fehlerfall liefert \fBcupsfilter\fP einen von Null verschiedenen Exit\-Status
zurück.
.SH UMGEBUNG
Alle Standard\-\fBcups\fP(1)\-Umgebungsvariablen beeinflussen den Ablauf von
\fBcupsfilter\fP.
.SH DATEIEN
.nf
/etc/cups/cups\-files.conf
/etc/cups/*.convs
/etc/cups/*.types
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
.SH HINWEISE
Anders als beim Drucken verwenden Filter, die mit dem Befehl \fBcupsfilter\fP
ausgeführt werden, die aktuelle Benutzer\- und Sicherheitssitzung. Dies kann
zu anderer Ausgabe oder unerwartetem Verhalten führen.
.SH BEISPIEL
Der folgende Befehl erzeugt eine PDF\-Vorschau des Auftrags 42 für einen
Drucker namens »meinDrucker« und speichert sie in einer Datei namens
»Vorschau.pdf«:
.nf

    cupsfilter \-m application/pdf \-d meinDrucker \-j 42 >Vorschau.pdf
.fi
.SH "SIEHE AUCH"
\fBcups\fP(1), \fBcupsd.conf\fP(5), \fBfilter(7),\fP \fBmime.convs\fP(7),
\fBmime.types\fP(7), CUPS\-Online\-Hilfe (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2007\-2016 by Apple Inc.