# cupsfilter

## NAME



           cupsfilter - convert a file to another format using cups filters
           (deprecated)
    


## SYNOPSIS



           **cupsfilter**[ **--list-all**] [ **--list-filters**] [ **-D**] [ **-U** _user_ ] [
           **-c** _config-file_ ] [ **-d** _printer_ ] [ **-e**] [ **-i** _mime/type_ ] [ **-j** _job-_
           _id[,N]_ ] [ **-m** _mime/type_ ] [ **-n** _copies_ ] [ **-o** _name=value_ ] [ **-p**
           _filename.ppd_ ] [ **-t** _title_ ] [ **-u**] _filename_
    


## DESCRIPTION



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


## OPTIONS



           **--list-all**
                Do not actually run the filters, just print all of the
                filters used with the source and destination MIME media types
                to stdout.
    
           **--list-filters**
                Do not actually run the filters, just print the filters used
                to stdout.
    
           **-D** Delete the input file after conversion.
    
           **-U** _user_
                Specifies the username passed to the filters. The default is
                the name of the current user.
    
           **-c** _config-file_
                Uses the named cups-files.conf configuration file.
    
           **-d** _printer_
                Uses information from the named printer.
    
           **-e** Use every filter from the PPD file.
    
           **-i** _mime/type_
                Specifies the source file type. The default file type is
                guessed using the filename and contents of the file.
    
           **-j** _job-id[,N]_
                Converts document N from the specified job. If N is omitted,
                document 1 is converted.
    
           **-m** _mime/type_
                Specifies the destination file type. The default file type is
                application/pdf. Use printer/foo to convert to the printer
                format defined by the filters in the PPD file.
    
           **-n** _copies_
                Specifies the number of copies to generate.
    
           **-o** _name=value_
                Specifies options to pass to the CUPS filters.
    
           **-p** _filename.ppd_
                Specifies the PPD file to use.
    
           **-t** _title_
                Specifies the document title.
    
           **-u** Delete the PPD file after conversion.
    


## EXIT STATUS



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


## ENVIRONMENT



           All of the standard cups(1) environment variables affect the
           operation of **cupsfilter**.
    


## FILES



           /etc/cups/cups-files.conf
           /etc/cups/*.convs
           /etc/cups/*.types
           /usr/share/cups/mime/*.convs
           /usr/share/cups/mime/*.types
    


## NOTES



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


## EXAMPLE



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


* * *