[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. The converted
file is sent to the standard output.
<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 cups-files.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-cups-files.conf.html?TOPIC=Man+Pages'>cups-files.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-2014 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
71f63681 MS	39	through CUPS. By default, <i>cupsfilter</i> generates a PDF file. The converted
71f63681 MS	40	file is sent to the standard output.
94436c5a MS	41	<h2 class="title"><a name="OPTIONS">Options</a></h2>
	42	<dl>
	43	<dt>-D
	44	</dt>
	45	<dd></dd>
	46	<dd>Delete the input file after conversion.
	47	</dd>
	48	<dt>-U user
	49	</dt>
	50	<dd></dd>
	51	<dd>Specifies the username passed to the filters. The default is the name of the current user.
	52	</dd>
	53	<dt>-c config-file
	54	</dt>
	55	<dd></dd>
71f63681	56	<dd>Uses the named cups-files.conf configuration file.
94436c5a MS	57	</dd>
	58	<dt>-d printer
	59	</dt>
	60	<dd>Uses information from the named printer.
	61	</dd>
	62	<dt>-e
	63	</dt>
	64	<dd></dd>
	65	<dd>Use every filter from the PPD file.
	66	</dd>
	67	<dt>-i mime/type
	68	</dt>
	69	<dd></dd>
	70	<dd>Specifies the source file type. The default file type is guessed using the
	71	filename and contents of the file.
	72	</dd>
	73	<dt>-j job-id[,N]
	74	</dt>
	75	<dd></dd>
	76	<dd>Converts document N from the specified job. If N is omitted, document 1 is
	77	converted.
	78	</dd>
	79	<dt>-m mime/type
	80	</dt>
	81	<dd></dd>
	82	<dd>Specifies the destination file type. The default file type is application/pdf.
	83	Use printer/foo to convert to the printer format defined by the filters in the
	84	PPD file.
	85	</dd>
	86	<dt>-n copies
	87	</dt>
	88	<dd></dd>
	89	<dd>Specifies the number of copies to generate.
	90	</dd>
	91	<dt>-o name=value
	92	</dt>
	93	<dd></dd>
	94	<dd>Specifies options to pass to the CUPS filters.
	95	</dd>
	96	<dt>-p filename.ppd
	97	</dt>
	98	<dd></dd>
	99	<dd>Specifies the PPD file to use.
	100	</dd>
	101	<dt>-t title
	102	</dt>
	103	<dd></dd>
	104	<dd>Specifies the document title.
	105	</dd>
	106	<dt>-u
	107	</dt>
	108	<dd></dd>
	109	<dd>Delete the PPD file after conversion.
	110	</dd>
	111	</dl>
	112	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
71f63681	113	<a href='man-cups-files.conf.html?TOPIC=Man+Pages'>cups-files.conf(5)</a>
94436c5a MS	114	<br>
	115	<a href='http://localhost:631/help'>http://localhost:631/help</a>
	116	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
71f63681	117	Copyright 2007-2014 by Apple Inc.
94436c5a MS	118
	119	</body>
	120	</html>