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)