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 | .\" |
| 4 | .\" cupsfilter man page for the Common UNIX Printing System (CUPS). | |
| 5 | .\" | |
| b19ccc9e | 6 | .\" Copyright 2007-2008 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 | .\" | |
| b19ccc9e | 14 | .TH cupsfilter 8 "Common UNIX Printing System" "10 September 2008" "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 | |
| 2e4ff8af MS |
21 | ] -j |
| 22 | .I job-id[,N] | |
| 2fb76298 | 23 | [ -m |
| bc44d920 | 24 | .I mime/type |
| 2fb76298 | 25 | ] [ -n |
| bc44d920 | 26 | .I copies |
| 27 | ] [ -o | |
| 28 | .I name=value | |
| 29 | ] [ -p | |
| 30 | .I filename.ppd | |
| 31 | ] [ -t | |
| 32 | .I title | |
| 33 | ] | |
| 34 | .I filename | |
| 35 | .SH DESCRIPTION | |
| 36 | \fIcupsfilter\fR is a front-end to the CUPS filter subsystem which allows you | |
| 37 | to convert a file to a specific format, just as if you had printed the file | |
| 2fb76298 | 38 | through CUPS. By default, \fIcupsfilter\fR generates a PDF file. |
| bc44d920 | 39 | .SH OPTIONS |
| 40 | .TP 5 | |
| 41 | -c config-file | |
| 42 | .br | |
| 43 | Uses the named cupsd.conf configuration file. | |
| 44 | .TP 5 | |
| 2e4ff8af MS |
45 | -j job-id[,N] |
| 46 | .br | |
| 47 | Converts document N from the specified job. If N is omitted, document 1 is | |
| 48 | converted. | |
| 49 | .TP 5 | |
| bc44d920 | 50 | -m mime/type |
| 51 | .br | |
| 2fb76298 | 52 | Specifies the destination file type. The default file type is application/pdf. |
| b19ccc9e MS |
53 | Use printer/foo to convert to the printer format defined by the filters in the |
| 54 | PPD file. | |
| bc44d920 | 55 | .TP 5 |
| 56 | -n copies | |
| 57 | .br | |
| 58 | Specifies the number of copies to generate. | |
| 59 | .TP 5 | |
| 60 | -o name=value | |
| 61 | .br | |
| 62 | Specifies options to pass to the CUPS filters. | |
| 63 | .TP 5 | |
| 64 | -p filename.ppd | |
| 65 | .br | |
| 66 | Specifies the PPD file to use. | |
| 67 | .TP 5 | |
| 68 | -t title | |
| 69 | .br | |
| 70 | Specifies the document title. | |
| 2fb76298 MS |
71 | .SH KNOWN ISSUES |
| 72 | \fIcupsfilter\fR currently does not use the filters defined in the PPD file. | |
| 73 | This will be addressed in a future CUPS release. | |
| bc44d920 | 74 | .SH SEE ALSO |
| 75 | \fIcupsd.conf(5)\fR | |
| 76 | .br | |
| 77 | http://localhost:631/help | |
| 78 | .SH COPYRIGHT | |
| b19ccc9e | 79 | Copyright 2007-2008 by Apple Inc. |
| bc44d920 | 80 | .\" |
| b19ccc9e | 81 | .\" End of "$Id: cupsfilter.man 7936 2008-09-11 03:12:59Z mike $". |
| bc44d920 | 82 | .\" |