projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| bc44d920 | 1 | .\" |
| b19ccc9e | 2 | .\" "$Id: cupsfilter.man 7936 2008-09-11 03:12:59Z mike $" |
| bc44d920 | 3 | .\" |
| ba55dc12 | 4 | .\" cupsfilter man page for CUPS. |
| bc44d920 | 5 | .\" |
| f3c17241 | 6 | .\" Copyright 2007-2012 by Apple Inc. |
| bc44d920 | 7 | .\" |
| 8 | .\" These coded instructions, statements, and computer programs are the | |
| 9 | .\" property of Apple Inc. and are protected by Federal copyright | |
| 10 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
| 11 | .\" which should have been included with this file. If this file is | |
| 12 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
| 13 | .\" | |
| ba55dc12 | 14 | .TH cupsfilter 8 "CUPS" "4 March 2010" "Apple Inc." |
| bc44d920 | 15 | .SH NAME |
| 16 | cupsfilter \- convert a file to another format using cups filters | |
| 17 | .SH SYNOPSIS | |
| 18 | .B cupsfilter | |
| 19 | [ -c | |
| 20 | .I config-file | |
| f3c17241 | 21 | ] [ -d |
| ba55dc12 | 22 | .I printer |
| 1340db2d | 23 | ] [ -e ] -j |
| 2e4ff8af | 24 | .I job-id[,N] |
| 2fb76298 | 25 | [ -m |
| bc44d920 | 26 | .I mime/type |
| 2fb76298 | 27 | ] [ -n |
| bc44d920 | 28 | .I copies |
| 29 | ] [ -o | |
| 30 | .I name=value | |
| 31 | ] [ -p | |
| 32 | .I filename.ppd | |
| 33 | ] [ -t | |
| 34 | .I title | |
| 35 | ] | |
| 36 | .I filename | |
| 37 | .SH DESCRIPTION | |
| 38 | \fIcupsfilter\fR is a front-end to the CUPS filter subsystem which allows you | |
| 39 | to convert a file to a specific format, just as if you had printed the file | |
| 2fb76298 | 40 | through CUPS. By default, \fIcupsfilter\fR generates a PDF file. |
| bc44d920 | 41 | .SH OPTIONS |
| 42 | .TP 5 | |
| 43 | -c config-file | |
| 44 | .br | |
| 45 | Uses the named cupsd.conf configuration file. | |
| 46 | .TP 5 | |
| ba55dc12 MS |
47 | -d printer |
| 48 | Uses information from the named printer. | |
| 49 | .TP 5 | |
| 1340db2d MS |
50 | -e |
| 51 | .br | |
| 52 | Use every filter from the PPD file. | |
| 53 | .TP 5 | |
| 2e4ff8af MS |
54 | -j job-id[,N] |
| 55 | .br | |
| 56 | Converts document N from the specified job. If N is omitted, document 1 is | |
| 57 | converted. | |
| 58 | .TP 5 | |
| bc44d920 | 59 | -m mime/type |
| 60 | .br | |
| 2fb76298 | 61 | Specifies the destination file type. The default file type is application/pdf. |
| b19ccc9e MS |
62 | Use printer/foo to convert to the printer format defined by the filters in the |
| 63 | PPD file. | |
| bc44d920 | 64 | .TP 5 |
| 65 | -n copies | |
| 66 | .br | |
| 67 | Specifies the number of copies to generate. | |
| 68 | .TP 5 | |
| 69 | -o name=value | |
| 70 | .br | |
| 71 | Specifies options to pass to the CUPS filters. | |
| 72 | .TP 5 | |
| 73 | -p filename.ppd | |
| 74 | .br | |
| 75 | Specifies the PPD file to use. | |
| 76 | .TP 5 | |
| 77 | -t title | |
| 78 | .br | |
| 79 | Specifies the document title. | |
| 2fb76298 MS |
80 | .SH KNOWN ISSUES |
| 81 | \fIcupsfilter\fR currently does not use the filters defined in the PPD file. | |
| 82 | This will be addressed in a future CUPS release. | |
| bc44d920 | 83 | .SH SEE ALSO |
| 84 | \fIcupsd.conf(5)\fR | |
| 85 | .br | |
| 86 | http://localhost:631/help | |
| 87 | .SH COPYRIGHT | |
| f3c17241 | 88 | Copyright 2007-2012 by Apple Inc. |
| bc44d920 | 89 | .\" |
| b19ccc9e | 90 | .\" End of "$Id: cupsfilter.man 7936 2008-09-11 03:12:59Z mike $". |
| bc44d920 | 91 | .\" |