[thirdparty/cups.git] / doc / help / man-cupsfilter.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cupsfilter(8)</title>
</head>
<body>
<h1 class="title">cupsfilter(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsfilter - convert a file to another format using cups filters
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsfilter
</b>[ -D ] [ -U
<i>user
</i>] [ -c
<i>config-file
</i>] [ -d
<i>printer
</i>] [ -e ] [ -i
<i>mime/type
</i>] [ -j
<i>job-id[,N]
</i>] [ -m
<i>mime/type
</i>] [ -n
<i>copies
</i>] [ -o
<i>name=value
</i>] [ -p
<i>filename.ppd
</i>] [ -t
<i>title
</i>] [ -u ]
<i>filename
</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsfilter</i> 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, <i>cupsfilter</i> generates a PDF file.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<dl>
<dt>-D
</dt>
<dd></dd>
<dd>Delete the input file after conversion.
</dd>
<dt>-U user
</dt>
<dd></dd>
<dd>Specifies the username passed to the filters. The default is the name of the current user.
</dd>
<dt>-c config-file
</dt>
<dd></dd>
<dd>Uses the named cupsd.conf configuration file.
</dd>
<dt>-d printer
</dt>
<dd>Uses information from the named printer.
</dd>
<dt>-e
</dt>
<dd></dd>
<dd>Use every filter from the PPD file.
</dd>
<dt>-i mime/type
</dt>
<dd></dd>
<dd>Specifies the source file type. The default file type is guessed using the
filename and contents of the file.
</dd>
<dt>-j job-id[,N]
</dt>
<dd></dd>
<dd>Converts document N from the specified job. If N is omitted, document 1 is
converted.
</dd>
<dt>-m mime/type
</dt>
<dd></dd>
<dd>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.
</dd>
<dt>-n copies
</dt>
<dd></dd>
<dd>Specifies the number of copies to generate.
</dd>
<dt>-o name=value
</dt>
<dd></dd>
<dd>Specifies options to pass to the CUPS filters.
</dd>
<dt>-p filename.ppd
</dt>
<dd></dd>
<dd>Specifies the PPD file to use.
</dd>
<dt>-t title
</dt>
<dd></dd>
<dd>Specifies the document title.
</dd>
<dt>-u
</dt>
<dd></dd>
<dd>Delete the PPD file after conversion.
</dd>
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.

</body>
</html>
Commit	Line	Data
94436c5a MS	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	2	<html>
	3	<!-- SECTION: Man Pages -->
	4	<head>
	5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	6	<title>cupsfilter(8)</title>
	7	</head>
	8	<body>
	9	<h1 class="title">cupsfilter(8)</h1>
	10	<h2 class="title"><a name="NAME">Name</a></h2>
	11	cupsfilter - convert a file to another format using cups filters
	12	<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
	13	<b>cupsfilter
	14	</b>[ -D ] [ -U
	15	<i>user
	16	</i>] [ -c
	17	<i>config-file
	18	</i>] [ -d
	19	<i>printer
	20	</i>] [ -e ] [ -i
	21	<i>mime/type
	22	</i>] [ -j
	23	<i>job-id[,N]
	24	</i>] [ -m
	25	<i>mime/type
	26	</i>] [ -n
	27	<i>copies
	28	</i>] [ -o
	29	<i>name=value
	30	</i>] [ -p
	31	<i>filename.ppd
	32	</i>] [ -t
	33	<i>title
	34	</i>] [ -u ]
	35	<i>filename
	36	</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
	37	<i>cupsfilter</i> is a front-end to the CUPS filter subsystem which allows you
	38	to convert a file to a specific format, just as if you had printed the file
	39	through CUPS. By default, <i>cupsfilter</i> generates a PDF file.
	40	<h2 class="title"><a name="OPTIONS">Options</a></h2>
	41	<dl>
	42	<dt>-D
	43	</dt>
	44	<dd></dd>
	45	<dd>Delete the input file after conversion.
	46	</dd>
	47	<dt>-U user
	48	</dt>
	49	<dd></dd>
	50	<dd>Specifies the username passed to the filters. The default is the name of the current user.
	51	</dd>
	52	<dt>-c config-file
	53	</dt>
	54	<dd></dd>
	55	<dd>Uses the named cupsd.conf configuration file.
	56	</dd>
	57	<dt>-d printer
	58	</dt>
	59	<dd>Uses information from the named printer.
	60	</dd>
	61	<dt>-e
	62	</dt>
	63	<dd></dd>
	64	<dd>Use every filter from the PPD file.
65	</dd>
66	<dt>-i mime/type
67	</dt>
68	<dd></dd>
69	<dd>Specifies the source file type. The default file type is guessed using the
70	filename and contents of the file.
71	</dd>
72	<dt>-j job-id[,N]
73	</dt>
74	<dd></dd>
75	<dd>Converts document N from the specified job. If N is omitted, document 1 is
76	converted.
77	</dd>
78	<dt>-m mime/type
79	</dt>
80	<dd></dd>
81	<dd>Specifies the destination file type. The default file type is application/pdf.
82	Use printer/foo to convert to the printer format defined by the filters in the
83	PPD file.
84	</dd>
85	<dt>-n copies
86	</dt>
87	<dd></dd>
88	<dd>Specifies the number of copies to generate.
89	</dd>
90	<dt>-o name=value
91	</dt>
92	<dd></dd>
93	<dd>Specifies options to pass to the CUPS filters.
94	</dd>
95	<dt>-p filename.ppd
96	</dt>
97	<dd></dd>
98	<dd>Specifies the PPD file to use.
99	</dd>
100	<dt>-t title
101	</dt>
102	<dd></dd>
103	<dd>Specifies the document title.
104	</dd>
105	<dt>-u
106	</dt>
107	<dd></dd>
108	<dd>Delete the PPD file after conversion.
109	</dd>
110	</dl>
111	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
112	<a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>
113	<br>
114	<a href='http://localhost:631/help'>http://localhost:631/help</a>
115	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
116	Copyright 2007-2013 by Apple Inc.
117
118	</body>
119	</html>