1cupsfilter(8)                    OpenPrinting                    cupsfilter(8)
2
3
4

NAME

6       cupsfilter  - convert a file to another format using cups filters (dep‐
7       recated)
8

SYNOPSIS

10       cupsfilter [ --list-filters ] [ -D ] [ -U user ] [ -c config-file  ]  [
11       -d printer ] [ -e ] [ -i mime/type ] [ -j job-id[,N] ] [ -m mime/type ]
12       [ -n copies ] [ -o name=value ] [ -p filename.ppd ] [ -t title ] [ -u ]
13       filename
14

DESCRIPTION

16       cupsfilter is a front-end to the CUPS filter subsystem which allows you
17       to convert a file to a specific format, just as if you had printed  the
18       file  through  CUPS.  By  default, cupsfilter generates a PDF file. The
19       converted file is sent to the standard output.
20

OPTIONS

22       --list-filters
23            Do not actually run the filters, just print the  filters  used  to
24            stdout.
25
26       -D   Delete the input file after conversion.
27
28       -U user
29            Specifies  the  username passed to the filters. The default is the
30            name of the current user.
31
32       -c config-file
33            Uses the named cups-files.conf configuration file.
34
35       -d printer
36            Uses information from the named printer.
37
38       -e   Use every filter from the PPD file.
39
40       -i mime/type
41            Specifies the source file type. The default file type  is  guessed
42            using the filename and contents of the file.
43
44       -j job-id[,N]
45            Converts document N from the specified job. If N is omitted, docu‐
46            ment 1 is converted.
47
48       -m mime/type
49            Specifies the destination file type. The default file type is  ap‐
50            plication/pdf.  Use  printer/foo  to convert to the printer format
51            defined by the filters in the PPD file.
52
53       -n copies
54            Specifies the number of copies to generate.
55
56       -o name=value
57            Specifies options to pass to the CUPS filters.
58
59       -p filename.ppd
60            Specifies the PPD file to use.
61
62       -t title
63            Specifies the document title.
64
65       -u   Delete the PPD file after conversion.
66

EXIT STATUS

68       cupsfilter returns a non-zero exit status on any error.
69

ENVIRONMENT

71       All of the standard cups(1) environment variables affect the  operation
72       of cupsfilter.
73

FILES

75       /etc/cups/cups-files.conf
76       /etc/cups/*.convs
77       /etc/cups/*.types
78       /usr/share/cups/mime/*.convs
79       /usr/share/cups/mime/*.types
80

NOTES

82       CUPS  printer drivers, filters, and backends are deprecated and will no
83       longer be supported in a future feature release of CUPS.  Printers that
84       do  not  support  IPP  can  be  supported  using  applications  such as
85       ippeveprinter(1).
86
87       Unlike when printing, filters run using the cupsfilter command use  the
88       current  user and security session. This may result in different output
89       or unexpected behavior.
90

EXAMPLE

92       The following command will generate a PDF  preview  of  job  42  for  a
93       printer named "myprinter" and save it to a file named "preview.pdf":
94
95           cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
96

SEE ALSO

98       cups(1),  cupsd.conf(5),  filter(7), mime.convs(7), mime.types(7), CUPS
99       Online Help (http://localhost:631/help)
100

102       Copyright © 2021-2023 by OpenPrinting.
103
104
105
1062021-02-28                           CUPS                        cupsfilter(8)
Impressum