cupsfilter(8) Apple Inc. cupsfilter(8)
NAME
cupsfilter - convert a file to another format using cups filters
SYNOPSIS
cupsfilter [ --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-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
Unlike when printing, filters run using the cupsfilter command use the current user and security session. This may result in different out-
put 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
SEE ALSO
cups(1), cupsd.conf(5), filter(7), mime.convs(7), mime.types(7), CUPS Online Help (http://localhost:631/help)
COPYRIGHT
Copyright (C) 2007-2017 by Apple Inc.
11 June 2014 CUPS cupsfilter(8)