Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

cupsfilter (8)

Name

cupsfilter - convert a file to another format using cups filters

Synopsis

cupsfilter  [  -c config-file ] [ -e ] -j job-id[,N] [ -m mime/type ] [
-n copies ] [ -o name=value ] [ -p filename.ppd ] [ -t title ] filename

Description

cupsfilter(8)                     Apple Inc.                     cupsfilter(8)



NAME
       cupsfilter - convert a file to another format using cups filters

SYNOPSIS
       cupsfilter  [  -c config-file ] [ -e ] -j job-id[,N] [ -m mime/type ] [
       -n copies ] [ -o name=value ] [ -p filename.ppd ] [ -t title ] 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.

OPTIONS
       -c config-file
            Uses the named cupsd.conf configuration file.

       -e
            Use every filter from the PPD file.

       -j job-id[,N]
            Converts document N from the specified job. If N is omitted, docu-
            ment 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.

KNOWN ISSUES
       cupsfilter  currently does not use the filters defined in the PPD file.
       This will be addressed in a future CUPS release.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | print/cups       |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+
SEE ALSO
       cupsd.conf(5)
       http://localhost:631/help

COPYRIGHT
       Copyright 2007-2009 by Apple Inc.



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       http://ftp.easysw.com/pub/cups/1.4.5/cups-1.4.5-source.tar.bz2

       Further information about this software can be found on the open source
       community website at http://www.cups.org/.



26 February 2009                     CUPS                        cupsfilter(8)