CHANGES IN CUPS V1.4.7
- Documentation changes (STR #3710, STR #3720, STR #3745, STR #3750,
- STR #3757, STR #3758, STR #3782, STR #3826, STR #3829)
+ STR #3757, STR #3758, STR #3782, STR #3826, STR #3829, STR #3837)
- Web interface fixes (STR #3412, STR #3345, STR #3455, STR #3707,
STR #3755, STR #3769, STR #3783)
- Configure script fixes (STR #3659, STR #3691)
<!--
"$Id$"
- Array API introduction for the Common UNIX Printing System (CUPS).
+ Array API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<!--
"$Id$"
- CUPS API introduction for the Common UNIX Printing System (CUPS).
+ API introduction for CUPS.
- Copyright 2007-2010 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
int num_dests = <a href='#cupsGetDests'>cupsGetDests</a>(&dests);
<a href='#cups_dest_t'>cups_dest_t</a> *dest = <a href='#cupsGetDest'>cupsGetDest</a>("name", NULL, num_dests, dests);
-/* do something wiith dest */
+/* do something with dest */
<a href='#cupsFreeDests'>cupsFreeDests</a>(num_dests, dests);
</pre>
<!--
"$Id$"
- File and directory API introduction for the Common UNIX Printing System (CUPS).
+ File and directory API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2005 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<h3><a name="SECURITY">Security Considerations</a></h3>
<p>It is always important to use security programming practices. Filters and
-most backends are run as a non-priviledged user, so the major security
+most backends are run as a non-privileged user, so the major security
consideration is resource utilization - filters should not depend on unlimited
amounts of CPU, memory, or disk space, and should protect against conditions
that could lead to excess usage of any resource like infinite loops and
<!--
"$Id$"
- HTTP and IPP API introduction for the Common UNIX Printing System (CUPS).
+ HTTP and IPP API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<!--
"$Id: api-cups.header 7279 2008-01-31 01:50:44Z mike $"
- Introduction to CUPS programming content for the Common UNIX Printing System
- (CUPS).
+ Introduction to CUPS programming content for CUPS.
- Copyright 2008 by Apple Inc.
+ Copyright 2008-2011 by Apple Inc.
These coded instructions, statements, and computer programs are the
property of Apple Inc. and are protected by Federal copyright
<!--
"$Id$"
- PPD API introduction for the Common UNIX Printing System (CUPS).
+ PPD API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<html>
<!-- SECTION: Programming -->
<head>
- <title>Array API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Array API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a><ul class="subcontents">
-
<li><a href="#MANAGING_ARRAYS">Managing Arrays</a></li>
-
<li><a href="#FINDING_AND_ENUMERATING">Finding and Enumerating Elements</a></li>
+<li><a href="#MANAGING_ARRAYS">Managing Arrays</a></li>
+<li><a href="#FINDING_AND_ENUMERATING">Finding and Enumerating Elements</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsArrayAdd" title="Add an element to the array.">cupsArrayAdd</a></li>
-
<li><a href="#cupsArrayClear" title="Clear the array.">cupsArrayClear</a></li>
-
<li><a href="#cupsArrayCount" title="Get the number of elements in the array.">cupsArrayCount</a></li>
-
<li><a href="#cupsArrayCurrent" title="Return the current element in the array.">cupsArrayCurrent</a></li>
-
<li><a href="#cupsArrayDelete" title="Free all memory used by the array.">cupsArrayDelete</a></li>
-
<li><a href="#cupsArrayDup" title="Duplicate the array.">cupsArrayDup</a></li>
-
<li><a href="#cupsArrayFind" title="Find an element in the array.">cupsArrayFind</a></li>
-
<li><a href="#cupsArrayFirst" title="Get the first element in the array.">cupsArrayFirst</a></li>
-
<li><a href="#cupsArrayGetIndex" title="Get the index of the current element.">cupsArrayGetIndex</a></li>
-
<li><a href="#cupsArrayGetInsert" title="Get the index of the last inserted element.">cupsArrayGetInsert</a></li>
-
<li><a href="#cupsArrayIndex" title="Get the N-th element in the array.">cupsArrayIndex</a></li>
-
<li><a href="#cupsArrayInsert" title="Insert an element in the array.">cupsArrayInsert</a></li>
-
<li><a href="#cupsArrayLast" title="Get the last element in the array.">cupsArrayLast</a></li>
-
<li><a href="#cupsArrayNew" title="Create a new array.">cupsArrayNew</a></li>
-
<li><a href="#cupsArrayNew2" title="Create a new array with hash.">cupsArrayNew2</a></li>
-
<li><a href="#cupsArrayNew3" title="Create a new array with hash and/or free function.">cupsArrayNew3</a></li>
-
<li><a href="#cupsArrayNext" title="Get the next element in the array.">cupsArrayNext</a></li>
-
<li><a href="#cupsArrayPrev" title="Get the previous element in the array.">cupsArrayPrev</a></li>
-
<li><a href="#cupsArrayRemove" title="Remove an element from the array.">cupsArrayRemove</a></li>
-
<li><a href="#cupsArrayRestore" title="Reset the current element to the last cupsArraySave.">cupsArrayRestore</a></li>
-
<li><a href="#cupsArraySave" title="Mark the current element for a later cupsArrayRestore.">cupsArraySave</a></li>
-
<li><a href="#cupsArrayUserData" title="Return the user data for an array.">cupsArrayUserData</a></li>
+<li><a href="#cupsArrayAdd" title="Add an element to the array.">cupsArrayAdd</a></li>
+<li><a href="#cupsArrayClear" title="Clear the array.">cupsArrayClear</a></li>
+<li><a href="#cupsArrayCount" title="Get the number of elements in the array.">cupsArrayCount</a></li>
+<li><a href="#cupsArrayCurrent" title="Return the current element in the array.">cupsArrayCurrent</a></li>
+<li><a href="#cupsArrayDelete" title="Free all memory used by the array.">cupsArrayDelete</a></li>
+<li><a href="#cupsArrayDup" title="Duplicate the array.">cupsArrayDup</a></li>
+<li><a href="#cupsArrayFind" title="Find an element in the array.">cupsArrayFind</a></li>
+<li><a href="#cupsArrayFirst" title="Get the first element in the array.">cupsArrayFirst</a></li>
+<li><a href="#cupsArrayGetIndex" title="Get the index of the current element.">cupsArrayGetIndex</a></li>
+<li><a href="#cupsArrayGetInsert" title="Get the index of the last inserted element.">cupsArrayGetInsert</a></li>
+<li><a href="#cupsArrayIndex" title="Get the N-th element in the array.">cupsArrayIndex</a></li>
+<li><a href="#cupsArrayInsert" title="Insert an element in the array.">cupsArrayInsert</a></li>
+<li><a href="#cupsArrayLast" title="Get the last element in the array.">cupsArrayLast</a></li>
+<li><a href="#cupsArrayNew" title="Create a new array.">cupsArrayNew</a></li>
+<li><a href="#cupsArrayNew2" title="Create a new array with hash.">cupsArrayNew2</a></li>
+<li><a href="#cupsArrayNew3" title="Create a new array with hash and/or free function.">cupsArrayNew3</a></li>
+<li><a href="#cupsArrayNext" title="Get the next element in the array.">cupsArrayNext</a></li>
+<li><a href="#cupsArrayPrev" title="Get the previous element in the array.">cupsArrayPrev</a></li>
+<li><a href="#cupsArrayRemove" title="Remove an element from the array.">cupsArrayRemove</a></li>
+<li><a href="#cupsArrayRestore" title="Reset the current element to the last cupsArraySave.">cupsArrayRestore</a></li>
+<li><a href="#cupsArraySave" title="Mark the current element for a later cupsArrayRestore.">cupsArraySave</a></li>
+<li><a href="#cupsArrayUserData" title="Return the user data for an array.">cupsArrayUserData</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_acopy_func_t" title="Array element copy function">cups_acopy_func_t</a></li>
<li><a href="#cups_array_func_t" title="Array comparison function">cups_array_func_t</a></li>
<li><a href="#cups_array_t" title="CUPS array type">cups_array_t</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- Array API introduction for the Common UNIX Printing System (CUPS).
+ Array API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<html>
<!-- SECTION: Programming -->
<head>
- <title>CGI API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>CGI API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cgiCheckVariables" title="Check for the presence of "required" variables.">cgiCheckVariables</a></li>
-
<li><a href="#cgiClearVariables" title="Clear all form variables.">cgiClearVariables</a></li>
-
<li><a href="#cgiCompileSearch" title="Compile a search string.">cgiCompileSearch</a></li>
-
<li><a href="#cgiCopyTemplateFile" title="Copy a template file and replace all the
+<li><a href="#cgiCheckVariables" title="Check for the presence of "required" variables.">cgiCheckVariables</a></li>
+<li><a href="#cgiClearVariables" title="Clear all form variables.">cgiClearVariables</a></li>
+<li><a href="#cgiCompileSearch" title="Compile a search string.">cgiCompileSearch</a></li>
+<li><a href="#cgiCopyTemplateFile" title="Copy a template file and replace all the
'{variable}' strings with the variable value.">cgiCopyTemplateFile</a></li>
-
<li><a href="#cgiCopyTemplateLang" title="Copy a template file using a language...">cgiCopyTemplateLang</a></li>
-
<li><a href="#cgiDoSearch" title="Do a search of some text.">cgiDoSearch</a></li>
-
<li><a href="#cgiEndHTML" title="End a HTML page.">cgiEndHTML</a></li>
-
<li><a href="#cgiEndMultipart" title="End the delivery of a multipart web page.">cgiEndMultipart</a></li>
-
<li><a href="#cgiFormEncode" title="Encode a string as a form variable.">cgiFormEncode</a></li>
-
<li><a href="#cgiFreeSearch" title="Free a compiled search context.">cgiFreeSearch</a></li>
-
<li><a href="#cgiGetArray" title="Get an element from a form array.">cgiGetArray</a></li>
-
<li><a href="#cgiGetAttributes" title="Get the list of attributes that are needed
+<li><a href="#cgiCopyTemplateLang" title="Copy a template file using a language...">cgiCopyTemplateLang</a></li>
+<li><a href="#cgiDoSearch" title="Do a search of some text.">cgiDoSearch</a></li>
+<li><a href="#cgiEndHTML" title="End a HTML page.">cgiEndHTML</a></li>
+<li><a href="#cgiEndMultipart" title="End the delivery of a multipart web page.">cgiEndMultipart</a></li>
+<li><a href="#cgiFormEncode" title="Encode a string as a form variable.">cgiFormEncode</a></li>
+<li><a href="#cgiFreeSearch" title="Free a compiled search context.">cgiFreeSearch</a></li>
+<li><a href="#cgiGetArray" title="Get an element from a form array.">cgiGetArray</a></li>
+<li><a href="#cgiGetAttributes" title="Get the list of attributes that are needed
by the template file.">cgiGetAttributes</a></li>
-
<li><a href="#cgiGetCookie" title="Get a cookie value.">cgiGetCookie</a></li>
-
<li><a href="#cgiGetFile" title="Get the file (if any) that was submitted in the form.">cgiGetFile</a></li>
-
<li><a href="#cgiGetIPPObjects" title="Get the objects in an IPP response.">cgiGetIPPObjects</a></li>
-
<li><a href="#cgiGetSize" title="Get the size of a form array value.">cgiGetSize</a></li>
-
<li><a href="#cgiGetTemplateDir" title="Get the templates directory...">cgiGetTemplateDir</a></li>
-
<li><a href="#cgiGetVariable" title="Get a CGI variable from the database.">cgiGetVariable</a></li>
-
<li><a href="#cgiInitialize" title="Initialize the CGI variable "database".">cgiInitialize</a></li>
-
<li><a href="#cgiIsPOST" title="Determine whether this page was POSTed.">cgiIsPOST</a></li>
-
<li><a href="#cgiMoveJobs" title="Move one or more jobs.">cgiMoveJobs</a></li>
-
<li><a href="#cgiPrintCommand" title="Print a CUPS command job.">cgiPrintCommand</a></li>
-
<li><a href="#cgiPrintTestPage" title="Print a test page.">cgiPrintTestPage</a></li>
-
<li><a href="#cgiRewriteURL" title="Rewrite a printer URI into a web browser URL...">cgiRewriteURL</a></li>
-
<li><a href="#cgiSetArray" title="Set array element N to the specified string.">cgiSetArray</a></li>
-
<li><a href="#cgiSetCookie" title="Set a cookie value.">cgiSetCookie</a></li>
-
<li><a href="#cgiSetIPPObjectVars" title="Set CGI variables from an IPP object.">cgiSetIPPObjectVars</a></li>
-
<li><a href="#cgiSetIPPVars" title="Set CGI variables from an IPP response.">cgiSetIPPVars</a></li>
-
<li><a href="#cgiSetServerVersion" title="Set the server name and CUPS version...">cgiSetServerVersion</a></li>
-
<li><a href="#cgiSetSize" title="Set the array size.">cgiSetSize</a></li>
-
<li><a href="#cgiSetVariable" title="Set a CGI variable in the database.">cgiSetVariable</a></li>
-
<li><a href="#cgiShowIPPError" title="Show the last IPP error message.">cgiShowIPPError</a></li>
-
<li><a href="#cgiShowJobs" title="Show print jobs.">cgiShowJobs</a></li>
-
<li><a href="#cgiStartHTML" title="Start a HTML page.">cgiStartHTML</a></li>
-
<li><a href="#cgiStartMultipart" title="Start a multipart delivery of a web page.">cgiStartMultipart</a></li>
-
<li><a href="#cgiSupportsMultipart" title="Does the browser support multi-part documents?">cgiSupportsMultipart</a></li>
-
<li><a href="#cgiText" title="Return localized text.">cgiText</a></li>
-
<li><a href="#helpDeleteIndex" title="Delete an index, freeing all memory used.">helpDeleteIndex</a></li>
-
<li><a href="#helpFindNode" title="Find a node in an index.">helpFindNode</a></li>
-
<li><a href="#helpLoadIndex" title="Load a help index from disk.">helpLoadIndex</a></li>
-
<li><a href="#helpSaveIndex" title="Save a help index to disk.">helpSaveIndex</a></li>
-
<li><a href="#helpSearchIndex" title="Search an index.">helpSearchIndex</a></li>
+<li><a href="#cgiGetCookie" title="Get a cookie value.">cgiGetCookie</a></li>
+<li><a href="#cgiGetFile" title="Get the file (if any) that was submitted in the form.">cgiGetFile</a></li>
+<li><a href="#cgiGetIPPObjects" title="Get the objects in an IPP response.">cgiGetIPPObjects</a></li>
+<li><a href="#cgiGetSize" title="Get the size of a form array value.">cgiGetSize</a></li>
+<li><a href="#cgiGetTemplateDir" title="Get the templates directory...">cgiGetTemplateDir</a></li>
+<li><a href="#cgiGetVariable" title="Get a CGI variable from the database.">cgiGetVariable</a></li>
+<li><a href="#cgiInitialize" title="Initialize the CGI variable "database".">cgiInitialize</a></li>
+<li><a href="#cgiIsPOST" title="Determine whether this page was POSTed.">cgiIsPOST</a></li>
+<li><a href="#cgiMoveJobs" title="Move one or more jobs.">cgiMoveJobs</a></li>
+<li><a href="#cgiPrintCommand" title="Print a CUPS command job.">cgiPrintCommand</a></li>
+<li><a href="#cgiPrintTestPage" title="Print a test page.">cgiPrintTestPage</a></li>
+<li><a href="#cgiRewriteURL" title="Rewrite a printer URI into a web browser URL...">cgiRewriteURL</a></li>
+<li><a href="#cgiSetArray" title="Set array element N to the specified string.">cgiSetArray</a></li>
+<li><a href="#cgiSetCookie" title="Set a cookie value.">cgiSetCookie</a></li>
+<li><a href="#cgiSetIPPObjectVars" title="Set CGI variables from an IPP object.">cgiSetIPPObjectVars</a></li>
+<li><a href="#cgiSetIPPVars" title="Set CGI variables from an IPP response.">cgiSetIPPVars</a></li>
+<li><a href="#cgiSetServerVersion" title="Set the server name and CUPS version...">cgiSetServerVersion</a></li>
+<li><a href="#cgiSetSize" title="Set the array size.">cgiSetSize</a></li>
+<li><a href="#cgiSetVariable" title="Set a CGI variable in the database.">cgiSetVariable</a></li>
+<li><a href="#cgiShowIPPError" title="Show the last IPP error message.">cgiShowIPPError</a></li>
+<li><a href="#cgiShowJobs" title="Show print jobs.">cgiShowJobs</a></li>
+<li><a href="#cgiStartHTML" title="Start a HTML page.">cgiStartHTML</a></li>
+<li><a href="#cgiStartMultipart" title="Start a multipart delivery of a web page.">cgiStartMultipart</a></li>
+<li><a href="#cgiSupportsMultipart" title="Does the browser support multi-part documents?">cgiSupportsMultipart</a></li>
+<li><a href="#cgiText" title="Return localized text.">cgiText</a></li>
+<li><a href="#helpDeleteIndex" title="Delete an index, freeing all memory used.">helpDeleteIndex</a></li>
+<li><a href="#helpFindNode" title="Find a node in an index.">helpFindNode</a></li>
+<li><a href="#helpLoadIndex" title="Load a help index from disk.">helpLoadIndex</a></li>
+<li><a href="#helpSaveIndex" title="Save a help index to disk.">helpSaveIndex</a></li>
+<li><a href="#helpSearchIndex" title="Search an index.">helpSearchIndex</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cgi_file_t" title="Uploaded file data">cgi_file_t</a></li>
<li><a href="#help_node_s" title="Help node structure...">help_node_s</a></li>
<li><a href="#help_word_s" title="Help word structure...">help_word_s</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
<html>
<!-- SECTION: Programming -->
<head>
- <title>CUPS API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>CUPS API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a><ul class="subcontents">
-
<li><a href="#CLIENTS_AND_SERVERS">Clients and Servers</a></li>
-
<li><a href="#PRINTERS_AND_CLASSES">Printers and Classes</a></li>
-
<li><a href="#OPTIONS">Options</a></li>
-
<li><a href="#PRINT_JOBS">Print Jobs</a></li>
-
<li><a href="#ERROR_HANDLING">Error Handling</a></li>
-
<li><a href="#PASSWORDS_AND_AUTHENTICATION">Passwords and Authentication</a></li>
+<li><a href="#CLIENTS_AND_SERVERS">Clients and Servers</a></li>
+<li><a href="#PRINTERS_AND_CLASSES">Printers and Classes</a></li>
+<li><a href="#OPTIONS">Options</a></li>
+<li><a href="#PRINT_JOBS">Print Jobs</a></li>
+<li><a href="#ERROR_HANDLING">Error Handling</a></li>
+<li><a href="#PASSWORDS_AND_AUTHENTICATION">Passwords and Authentication</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#appleGetPaperSize" title="Get the default paper size.">appleGetPaperSize</a></li>
-
<li><a href="#cupsAddDest" title="Add a destination to the list of destinations.">cupsAddDest</a></li>
-
<li><a href="#cupsAddOption" title="Add an option to an option array.">cupsAddOption</a></li>
-
<li><a href="#cupsAdminCreateWindowsPPD" title="Create the Windows PPD file for a printer.">cupsAdminCreateWindowsPPD</a></li>
-
<li><a href="#cupsAdminExportSamba" title="Export a printer to Samba.">cupsAdminExportSamba</a></li>
-
<li><a href="#cupsAdminGetServerSettings" title="Get settings from the server.">cupsAdminGetServerSettings</a></li>
-
<li><a href="#cupsAdminSetServerSettings" title="Set settings on the server.">cupsAdminSetServerSettings</a></li>
-
<li><a href="#cupsCancelJob" title="Cancel a print job on the default server.">cupsCancelJob</a></li>
-
<li><a href="#cupsCancelJob2" title="Cancel or purge a print job.">cupsCancelJob2</a></li>
-
<li><a href="#cupsCreateJob" title="Create an empty job for streaming.">cupsCreateJob</a></li>
-
<li><a href="#cupsEncryption" title="Get the current encryption settings.">cupsEncryption</a></li>
-
<li><a href="#cupsFinishDocument" title="Finish sending a document.">cupsFinishDocument</a></li>
-
<li><a href="#cupsFreeDests" title="Free the memory used by the list of destinations.">cupsFreeDests</a></li>
-
<li><a href="#cupsFreeJobs" title="Free memory used by job data.">cupsFreeJobs</a></li>
-
<li><a href="#cupsFreeOptions" title="Free all memory used by options.">cupsFreeOptions</a></li>
-
<li><a href="#cupsGetClasses" title="Get a list of printer classes from the default server.">cupsGetClasses</a></li>
-
<li><a href="#cupsGetDefault" title="Get the default printer or class for the default server.">cupsGetDefault</a></li>
-
<li><a href="#cupsGetDefault2" title="Get the default printer or class for the specified server.">cupsGetDefault2</a></li>
-
<li><a href="#cupsGetDest" title="Get the named destination from the list.">cupsGetDest</a></li>
-
<li><a href="#cupsGetDests" title="Get the list of destinations from the default server.">cupsGetDests</a></li>
-
<li><a href="#cupsGetDests2" title="Get the list of destinations from the specified server.">cupsGetDests2</a></li>
-
<li><a href="#cupsGetJobs" title="Get the jobs from the default server.">cupsGetJobs</a></li>
-
<li><a href="#cupsGetJobs2" title="Get the jobs from the specified server.">cupsGetJobs2</a></li>
-
<li><a href="#cupsGetNamedDest" title="Get options for the named destination.">cupsGetNamedDest</a></li>
-
<li><a href="#cupsGetOption" title="Get an option value.">cupsGetOption</a></li>
-
<li><a href="#cupsGetPPD" title="Get the PPD file for a printer on the default server.">cupsGetPPD</a></li>
-
<li><a href="#cupsGetPPD2" title="Get the PPD file for a printer from the specified server.">cupsGetPPD2</a></li>
-
<li><a href="#cupsGetPPD3" title="Get the PPD file for a printer on the specified
+<li><a href="#appleGetPaperSize" title="Get the default paper size.">appleGetPaperSize</a></li>
+<li><a href="#cupsAddDest" title="Add a destination to the list of destinations.">cupsAddDest</a></li>
+<li><a href="#cupsAddOption" title="Add an option to an option array.">cupsAddOption</a></li>
+<li><a href="#cupsAdminCreateWindowsPPD" title="Create the Windows PPD file for a printer.">cupsAdminCreateWindowsPPD</a></li>
+<li><a href="#cupsAdminExportSamba" title="Export a printer to Samba.">cupsAdminExportSamba</a></li>
+<li><a href="#cupsAdminGetServerSettings" title="Get settings from the server.">cupsAdminGetServerSettings</a></li>
+<li><a href="#cupsAdminSetServerSettings" title="Set settings on the server.">cupsAdminSetServerSettings</a></li>
+<li><a href="#cupsCancelJob" title="Cancel a print job on the default server.">cupsCancelJob</a></li>
+<li><a href="#cupsCancelJob2" title="Cancel or purge a print job.">cupsCancelJob2</a></li>
+<li><a href="#cupsCreateJob" title="Create an empty job for streaming.">cupsCreateJob</a></li>
+<li><a href="#cupsEncryption" title="Get the current encryption settings.">cupsEncryption</a></li>
+<li><a href="#cupsFinishDocument" title="Finish sending a document.">cupsFinishDocument</a></li>
+<li><a href="#cupsFreeDests" title="Free the memory used by the list of destinations.">cupsFreeDests</a></li>
+<li><a href="#cupsFreeJobs" title="Free memory used by job data.">cupsFreeJobs</a></li>
+<li><a href="#cupsFreeOptions" title="Free all memory used by options.">cupsFreeOptions</a></li>
+<li><a href="#cupsGetClasses" title="Get a list of printer classes from the default server.">cupsGetClasses</a></li>
+<li><a href="#cupsGetDefault" title="Get the default printer or class for the default server.">cupsGetDefault</a></li>
+<li><a href="#cupsGetDefault2" title="Get the default printer or class for the specified server.">cupsGetDefault2</a></li>
+<li><a href="#cupsGetDest" title="Get the named destination from the list.">cupsGetDest</a></li>
+<li><a href="#cupsGetDests" title="Get the list of destinations from the default server.">cupsGetDests</a></li>
+<li><a href="#cupsGetDests2" title="Get the list of destinations from the specified server.">cupsGetDests2</a></li>
+<li><a href="#cupsGetJobs" title="Get the jobs from the default server.">cupsGetJobs</a></li>
+<li><a href="#cupsGetJobs2" title="Get the jobs from the specified server.">cupsGetJobs2</a></li>
+<li><a href="#cupsGetNamedDest" title="Get options for the named destination.">cupsGetNamedDest</a></li>
+<li><a href="#cupsGetOption" title="Get an option value.">cupsGetOption</a></li>
+<li><a href="#cupsGetPPD" title="Get the PPD file for a printer on the default server.">cupsGetPPD</a></li>
+<li><a href="#cupsGetPPD2" title="Get the PPD file for a printer from the specified server.">cupsGetPPD2</a></li>
+<li><a href="#cupsGetPPD3" title="Get the PPD file for a printer on the specified
server if it has changed.">cupsGetPPD3</a></li>
-
<li><a href="#cupsGetPassword" title="Get a password from the user.">cupsGetPassword</a></li>
-
<li><a href="#cupsGetPassword2" title="Get a password from the user using the advanced
+<li><a href="#cupsGetPassword" title="Get a password from the user.">cupsGetPassword</a></li>
+<li><a href="#cupsGetPassword2" title="Get a password from the user using the advanced
password callback.">cupsGetPassword2</a></li>
-
<li><a href="#cupsGetPrinters" title="Get a list of printers from the default server.">cupsGetPrinters</a></li>
-
<li><a href="#cupsGetServerPPD" title="Get an available PPD file from the server.">cupsGetServerPPD</a></li>
-
<li><a href="#cupsLangDefault" title="Return the default language.">cupsLangDefault</a></li>
-
<li><a href="#cupsLangEncoding" title="Return the character encoding (us-ascii, etc.)
+<li><a href="#cupsGetPrinters" title="Get a list of printers from the default server.">cupsGetPrinters</a></li>
+<li><a href="#cupsGetServerPPD" title="Get an available PPD file from the server.">cupsGetServerPPD</a></li>
+<li><a href="#cupsLangDefault" title="Return the default language.">cupsLangDefault</a></li>
+<li><a href="#cupsLangEncoding" title="Return the character encoding (us-ascii, etc.)
for the given language.">cupsLangEncoding</a></li>
-
<li><a href="#cupsLangFlush" title="Flush all language data out of the cache.">cupsLangFlush</a></li>
-
<li><a href="#cupsLangFree" title="Free language data.">cupsLangFree</a></li>
-
<li><a href="#cupsLangGet" title="Get a language.">cupsLangGet</a></li>
-
<li><a href="#cupsNotifySubject" title="Return the subject for the given notification message.">cupsNotifySubject</a></li>
-
<li><a href="#cupsNotifyText" title="Return the text for the given notification message.">cupsNotifyText</a></li>
-
<li><a href="#cupsParseOptions" title="Parse options from a command-line argument.">cupsParseOptions</a></li>
-
<li><a href="#cupsPrintFile" title="Print a file to a printer or class on the default server.">cupsPrintFile</a></li>
-
<li><a href="#cupsPrintFile2" title="Print a file to a printer or class on the specified
+<li><a href="#cupsLangFlush" title="Flush all language data out of the cache.">cupsLangFlush</a></li>
+<li><a href="#cupsLangFree" title="Free language data.">cupsLangFree</a></li>
+<li><a href="#cupsLangGet" title="Get a language.">cupsLangGet</a></li>
+<li><a href="#cupsNotifySubject" title="Return the subject for the given notification message.">cupsNotifySubject</a></li>
+<li><a href="#cupsNotifyText" title="Return the text for the given notification message.">cupsNotifyText</a></li>
+<li><a href="#cupsParseOptions" title="Parse options from a command-line argument.">cupsParseOptions</a></li>
+<li><a href="#cupsPrintFile" title="Print a file to a printer or class on the default server.">cupsPrintFile</a></li>
+<li><a href="#cupsPrintFile2" title="Print a file to a printer or class on the specified
server.">cupsPrintFile2</a></li>
-
<li><a href="#cupsPrintFiles" title="Print one or more files to a printer or class on the
+<li><a href="#cupsPrintFiles" title="Print one or more files to a printer or class on the
default server.">cupsPrintFiles</a></li>
-
<li><a href="#cupsPrintFiles2" title="Print one or more files to a printer or class on the
+<li><a href="#cupsPrintFiles2" title="Print one or more files to a printer or class on the
specified server.">cupsPrintFiles2</a></li>
-
<li><a href="#cupsRemoveDest" title="Remove a destination from the destination list.">cupsRemoveDest</a></li>
-
<li><a href="#cupsRemoveOption" title="Remove an option from an option array.">cupsRemoveOption</a></li>
-
<li><a href="#cupsServer" title="Return the hostname/address of the current server.">cupsServer</a></li>
-
<li><a href="#cupsSetClientCertCB" title="Set the client certificate callback.">cupsSetClientCertCB</a></li>
-
<li><a href="#cupsSetCredentials" title="Set the default credentials to be used for SSL/TLS
+<li><a href="#cupsRemoveDest" title="Remove a destination from the destination list.">cupsRemoveDest</a></li>
+<li><a href="#cupsRemoveOption" title="Remove an option from an option array.">cupsRemoveOption</a></li>
+<li><a href="#cupsServer" title="Return the hostname/address of the current server.">cupsServer</a></li>
+<li><a href="#cupsSetClientCertCB" title="Set the client certificate callback.">cupsSetClientCertCB</a></li>
+<li><a href="#cupsSetCredentials" title="Set the default credentials to be used for SSL/TLS
connections.">cupsSetCredentials</a></li>
-
<li><a href="#cupsSetDefaultDest" title="Set the default destination.">cupsSetDefaultDest</a></li>
-
<li><a href="#cupsSetDests" title="Save the list of destinations for the default server.">cupsSetDests</a></li>
-
<li><a href="#cupsSetDests2" title="Save the list of destinations for the specified server.">cupsSetDests2</a></li>
-
<li><a href="#cupsSetEncryption" title="Set the encryption preference.">cupsSetEncryption</a></li>
-
<li><a href="#cupsSetPasswordCB" title="Set the password callback for CUPS.">cupsSetPasswordCB</a></li>
-
<li><a href="#cupsSetPasswordCB2" title="Set the advanced password callback for CUPS.">cupsSetPasswordCB2</a></li>
-
<li><a href="#cupsSetServer" title="Set the default server name and port.">cupsSetServer</a></li>
-
<li><a href="#cupsSetServerCertCB" title="Set the server certificate callback.">cupsSetServerCertCB</a></li>
-
<li><a href="#cupsSetUser" title="Set the default user name.">cupsSetUser</a></li>
-
<li><a href="#cupsStartDocument" title="Add a document to a job created with cupsCreateJob().">cupsStartDocument</a></li>
-
<li><a href="#cupsTempFd" title="Creates a temporary file.">cupsTempFd</a></li>
-
<li><a href="#cupsTempFile" title="Generates a temporary filename.">cupsTempFile</a></li>
-
<li><a href="#cupsTempFile2" title="Creates a temporary CUPS file.">cupsTempFile2</a></li>
-
<li><a href="#cupsUser" title="Return the current user's name.">cupsUser</a></li>
+<li><a href="#cupsSetDefaultDest" title="Set the default destination.">cupsSetDefaultDest</a></li>
+<li><a href="#cupsSetDests" title="Save the list of destinations for the default server.">cupsSetDests</a></li>
+<li><a href="#cupsSetDests2" title="Save the list of destinations for the specified server.">cupsSetDests2</a></li>
+<li><a href="#cupsSetEncryption" title="Set the encryption preference.">cupsSetEncryption</a></li>
+<li><a href="#cupsSetPasswordCB" title="Set the password callback for CUPS.">cupsSetPasswordCB</a></li>
+<li><a href="#cupsSetPasswordCB2" title="Set the advanced password callback for CUPS.">cupsSetPasswordCB2</a></li>
+<li><a href="#cupsSetServer" title="Set the default server name and port.">cupsSetServer</a></li>
+<li><a href="#cupsSetServerCertCB" title="Set the server certificate callback.">cupsSetServerCertCB</a></li>
+<li><a href="#cupsSetUser" title="Set the default user name.">cupsSetUser</a></li>
+<li><a href="#cupsStartDocument" title="Add a document to a job created with cupsCreateJob().">cupsStartDocument</a></li>
+<li><a href="#cupsTempFd" title="Creates a temporary file.">cupsTempFd</a></li>
+<li><a href="#cupsTempFile" title="Generates a temporary filename.">cupsTempFile</a></li>
+<li><a href="#cupsTempFile2" title="Creates a temporary CUPS file.">cupsTempFile2</a></li>
+<li><a href="#cupsUser" title="Return the current user's name.">cupsUser</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_client_cert_cb_t" title="Client credentials callback ">cups_client_cert_cb_t</a></li>
<li><a href="#ENUMERATIONS">Constants</a><ul class="code">
<li><a href="#cups_ptype_e" title="Printer type/capability bit constants">cups_ptype_e</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- CUPS API introduction for the Common UNIX Printing System (CUPS).
+ API introduction for CUPS.
- Copyright 2007-2010 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
int num_dests = <a href='#cupsGetDests'>cupsGetDests</a>(&dests);
<a href='#cups_dest_t'>cups_dest_t</a> *dest = <a href='#cupsGetDest'>cupsGetDest</a>("name", NULL, num_dests, dests);
-/* do something wiith dest */
+/* do something with dest */
<a href='#cupsFreeDests'>cupsFreeDests</a>(num_dests, dests);
</pre>
<html>
<!-- SECTION: Programming -->
<head>
- <title>Printer Driver API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Printer Driver API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsCMYKDelete" title="Delete a color separation.">cupsCMYKDelete</a></li>
-
<li><a href="#cupsCMYKDoBlack" title="Do a black separation...">cupsCMYKDoBlack</a></li>
-
<li><a href="#cupsCMYKDoCMYK" title="Do a CMYK separation...">cupsCMYKDoCMYK</a></li>
-
<li><a href="#cupsCMYKDoGray" title="Do a grayscale separation...">cupsCMYKDoGray</a></li>
-
<li><a href="#cupsCMYKDoRGB" title="Do an sRGB separation...">cupsCMYKDoRGB</a></li>
-
<li><a href="#cupsCMYKLoad" title="Load a CMYK color profile from PPD attributes.">cupsCMYKLoad</a></li>
-
<li><a href="#cupsCMYKNew" title="Create a new CMYK color separation.">cupsCMYKNew</a></li>
-
<li><a href="#cupsCMYKSetBlack" title="Set the transition range for CMY to black.">cupsCMYKSetBlack</a></li>
-
<li><a href="#cupsCMYKSetCurve" title="Set a color transform curve using points.">cupsCMYKSetCurve</a></li>
-
<li><a href="#cupsCMYKSetGamma" title="Set a color transform curve using gamma and density.">cupsCMYKSetGamma</a></li>
-
<li><a href="#cupsCMYKSetInkLimit" title="Set the limit on the amount of ink.">cupsCMYKSetInkLimit</a></li>
-
<li><a href="#cupsCMYKSetLtDk" title="Set light/dark ink transforms.">cupsCMYKSetLtDk</a></li>
-
<li><a href="#cupsCheckBytes" title="Check to see if all bytes are zero.">cupsCheckBytes</a></li>
-
<li><a href="#cupsCheckValue" title="Check to see if all bytes match the given value.">cupsCheckValue</a></li>
-
<li><a href="#cupsDitherDelete" title="Free a dithering buffer.">cupsDitherDelete</a></li>
-
<li><a href="#cupsDitherLine" title="Dither a line of pixels...">cupsDitherLine</a></li>
-
<li><a href="#cupsDitherNew" title="Create an error-diffusion dithering buffer.">cupsDitherNew</a></li>
-
<li><a href="#cupsFindAttr" title="Find a PPD attribute based on the colormodel,
+<li><a href="#cupsCMYKDelete" title="Delete a color separation.">cupsCMYKDelete</a></li>
+<li><a href="#cupsCMYKDoBlack" title="Do a black separation...">cupsCMYKDoBlack</a></li>
+<li><a href="#cupsCMYKDoCMYK" title="Do a CMYK separation...">cupsCMYKDoCMYK</a></li>
+<li><a href="#cupsCMYKDoGray" title="Do a grayscale separation...">cupsCMYKDoGray</a></li>
+<li><a href="#cupsCMYKDoRGB" title="Do an sRGB separation...">cupsCMYKDoRGB</a></li>
+<li><a href="#cupsCMYKLoad" title="Load a CMYK color profile from PPD attributes.">cupsCMYKLoad</a></li>
+<li><a href="#cupsCMYKNew" title="Create a new CMYK color separation.">cupsCMYKNew</a></li>
+<li><a href="#cupsCMYKSetBlack" title="Set the transition range for CMY to black.">cupsCMYKSetBlack</a></li>
+<li><a href="#cupsCMYKSetCurve" title="Set a color transform curve using points.">cupsCMYKSetCurve</a></li>
+<li><a href="#cupsCMYKSetGamma" title="Set a color transform curve using gamma and density.">cupsCMYKSetGamma</a></li>
+<li><a href="#cupsCMYKSetInkLimit" title="Set the limit on the amount of ink.">cupsCMYKSetInkLimit</a></li>
+<li><a href="#cupsCMYKSetLtDk" title="Set light/dark ink transforms.">cupsCMYKSetLtDk</a></li>
+<li><a href="#cupsCheckBytes" title="Check to see if all bytes are zero.">cupsCheckBytes</a></li>
+<li><a href="#cupsCheckValue" title="Check to see if all bytes match the given value.">cupsCheckValue</a></li>
+<li><a href="#cupsDitherDelete" title="Free a dithering buffer.">cupsDitherDelete</a></li>
+<li><a href="#cupsDitherLine" title="Dither a line of pixels...">cupsDitherLine</a></li>
+<li><a href="#cupsDitherNew" title="Create an error-diffusion dithering buffer.">cupsDitherNew</a></li>
+<li><a href="#cupsFindAttr" title="Find a PPD attribute based on the colormodel,
media, and resolution.">cupsFindAttr</a></li>
-
<li><a href="#cupsLutDelete" title="Free the memory used by a lookup table.">cupsLutDelete</a></li>
-
<li><a href="#cupsLutLoad" title="Load a LUT from a PPD file.">cupsLutLoad</a></li>
-
<li><a href="#cupsLutNew" title="Make a lookup table from a list of pixel values.">cupsLutNew</a></li>
-
<li><a href="#cupsPackHorizontal" title="Pack pixels horizontally...">cupsPackHorizontal</a></li>
-
<li><a href="#cupsPackHorizontal2" title="Pack 2-bit pixels horizontally...">cupsPackHorizontal2</a></li>
-
<li><a href="#cupsPackHorizontalBit" title="Pack pixels horizontally by bit...">cupsPackHorizontalBit</a></li>
-
<li><a href="#cupsPackVertical" title="Pack pixels vertically...">cupsPackVertical</a></li>
-
<li><a href="#cupsRGBDelete" title="Delete a color separation.">cupsRGBDelete</a></li>
-
<li><a href="#cupsRGBDoGray" title="Do a grayscale separation...">cupsRGBDoGray</a></li>
-
<li><a href="#cupsRGBDoRGB" title="Do a RGB separation...">cupsRGBDoRGB</a></li>
-
<li><a href="#cupsRGBLoad" title="Load a RGB color profile from a PPD file.">cupsRGBLoad</a></li>
-
<li><a href="#cupsRGBNew" title="Create a new RGB color separation.">cupsRGBNew</a></li>
+<li><a href="#cupsLutDelete" title="Free the memory used by a lookup table.">cupsLutDelete</a></li>
+<li><a href="#cupsLutLoad" title="Load a LUT from a PPD file.">cupsLutLoad</a></li>
+<li><a href="#cupsLutNew" title="Make a lookup table from a list of pixel values.">cupsLutNew</a></li>
+<li><a href="#cupsPackHorizontal" title="Pack pixels horizontally...">cupsPackHorizontal</a></li>
+<li><a href="#cupsPackHorizontal2" title="Pack 2-bit pixels horizontally...">cupsPackHorizontal2</a></li>
+<li><a href="#cupsPackHorizontalBit" title="Pack pixels horizontally by bit...">cupsPackHorizontalBit</a></li>
+<li><a href="#cupsPackVertical" title="Pack pixels vertically...">cupsPackVertical</a></li>
+<li><a href="#cupsRGBDelete" title="Delete a color separation.">cupsRGBDelete</a></li>
+<li><a href="#cupsRGBDoGray" title="Do a grayscale separation...">cupsRGBDoGray</a></li>
+<li><a href="#cupsRGBDoRGB" title="Do a RGB separation...">cupsRGBDoRGB</a></li>
+<li><a href="#cupsRGBLoad" title="Load a RGB color profile from a PPD file.">cupsRGBLoad</a></li>
+<li><a href="#cupsRGBNew" title="Create a new RGB color separation.">cupsRGBNew</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_cmyk_t" title="Simple CMYK lookup table">cups_cmyk_t</a></li>
<li><a href="#cups_scmy_lut[256]" title="sRGB gamma lookup table (inverted)">cups_scmy_lut[256]</a></li>
<li><a href="#cups_srgb_lut[256]" title="sRGB gamma lookup table">cups_srgb_lut[256]</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
<html>
<!-- SECTION: Programming -->
<head>
- <title>File and Directory APIs </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>File and Directory APIs</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsDirClose" title="Close a directory.">cupsDirClose</a></li>
-
<li><a href="#cupsDirOpen" title="Open a directory.">cupsDirOpen</a></li>
-
<li><a href="#cupsDirRead" title="Read the next directory entry.">cupsDirRead</a></li>
-
<li><a href="#cupsDirRewind" title="Rewind to the start of the directory.">cupsDirRewind</a></li>
-
<li><a href="#cupsFileClose" title="Close a CUPS file.">cupsFileClose</a></li>
-
<li><a href="#cupsFileCompression" title="Return whether a file is compressed.">cupsFileCompression</a></li>
-
<li><a href="#cupsFileEOF" title="Return the end-of-file status.">cupsFileEOF</a></li>
-
<li><a href="#cupsFileFind" title="Find a file using the specified path.">cupsFileFind</a></li>
-
<li><a href="#cupsFileFlush" title="Flush pending output.">cupsFileFlush</a></li>
-
<li><a href="#cupsFileGetChar" title="Get a single character from a file.">cupsFileGetChar</a></li>
-
<li><a href="#cupsFileGetConf" title="Get a line from a configuration file.">cupsFileGetConf</a></li>
-
<li><a href="#cupsFileGetLine" title="Get a CR and/or LF-terminated line that may
+<li><a href="#cupsDirClose" title="Close a directory.">cupsDirClose</a></li>
+<li><a href="#cupsDirOpen" title="Open a directory.">cupsDirOpen</a></li>
+<li><a href="#cupsDirRead" title="Read the next directory entry.">cupsDirRead</a></li>
+<li><a href="#cupsDirRewind" title="Rewind to the start of the directory.">cupsDirRewind</a></li>
+<li><a href="#cupsFileClose" title="Close a CUPS file.">cupsFileClose</a></li>
+<li><a href="#cupsFileCompression" title="Return whether a file is compressed.">cupsFileCompression</a></li>
+<li><a href="#cupsFileEOF" title="Return the end-of-file status.">cupsFileEOF</a></li>
+<li><a href="#cupsFileFind" title="Find a file using the specified path.">cupsFileFind</a></li>
+<li><a href="#cupsFileFlush" title="Flush pending output.">cupsFileFlush</a></li>
+<li><a href="#cupsFileGetChar" title="Get a single character from a file.">cupsFileGetChar</a></li>
+<li><a href="#cupsFileGetConf" title="Get a line from a configuration file.">cupsFileGetConf</a></li>
+<li><a href="#cupsFileGetLine" title="Get a CR and/or LF-terminated line that may
contain binary data.">cupsFileGetLine</a></li>
-
<li><a href="#cupsFileGets" title="Get a CR and/or LF-terminated line.">cupsFileGets</a></li>
-
<li><a href="#cupsFileLock" title="Temporarily lock access to a file.">cupsFileLock</a></li>
-
<li><a href="#cupsFileNumber" title="Return the file descriptor associated with a CUPS file.">cupsFileNumber</a></li>
-
<li><a href="#cupsFileOpen" title="Open a CUPS file.">cupsFileOpen</a></li>
-
<li><a href="#cupsFileOpenFd" title="Open a CUPS file using a file descriptor.">cupsFileOpenFd</a></li>
-
<li><a href="#cupsFilePeekChar" title="Peek at the next character from a file.">cupsFilePeekChar</a></li>
-
<li><a href="#cupsFilePrintf" title="Write a formatted string.">cupsFilePrintf</a></li>
-
<li><a href="#cupsFilePutChar" title="Write a character.">cupsFilePutChar</a></li>
-
<li><a href="#cupsFilePutConf" title="Write a configuration line.">cupsFilePutConf</a></li>
-
<li><a href="#cupsFilePuts" title="Write a string.">cupsFilePuts</a></li>
-
<li><a href="#cupsFileRead" title="Read from a file.">cupsFileRead</a></li>
-
<li><a href="#cupsFileRewind" title="Set the current file position to the beginning of the
+<li><a href="#cupsFileGets" title="Get a CR and/or LF-terminated line.">cupsFileGets</a></li>
+<li><a href="#cupsFileLock" title="Temporarily lock access to a file.">cupsFileLock</a></li>
+<li><a href="#cupsFileNumber" title="Return the file descriptor associated with a CUPS file.">cupsFileNumber</a></li>
+<li><a href="#cupsFileOpen" title="Open a CUPS file.">cupsFileOpen</a></li>
+<li><a href="#cupsFileOpenFd" title="Open a CUPS file using a file descriptor.">cupsFileOpenFd</a></li>
+<li><a href="#cupsFilePeekChar" title="Peek at the next character from a file.">cupsFilePeekChar</a></li>
+<li><a href="#cupsFilePrintf" title="Write a formatted string.">cupsFilePrintf</a></li>
+<li><a href="#cupsFilePutChar" title="Write a character.">cupsFilePutChar</a></li>
+<li><a href="#cupsFilePutConf" title="Write a configuration line.">cupsFilePutConf</a></li>
+<li><a href="#cupsFilePuts" title="Write a string.">cupsFilePuts</a></li>
+<li><a href="#cupsFileRead" title="Read from a file.">cupsFileRead</a></li>
+<li><a href="#cupsFileRewind" title="Set the current file position to the beginning of the
file.">cupsFileRewind</a></li>
-
<li><a href="#cupsFileSeek" title="Seek in a file.">cupsFileSeek</a></li>
-
<li><a href="#cupsFileStderr" title="Return a CUPS file associated with stderr.">cupsFileStderr</a></li>
-
<li><a href="#cupsFileStdin" title="Return a CUPS file associated with stdin.">cupsFileStdin</a></li>
-
<li><a href="#cupsFileStdout" title="Return a CUPS file associated with stdout.">cupsFileStdout</a></li>
-
<li><a href="#cupsFileTell" title="Return the current file position.">cupsFileTell</a></li>
-
<li><a href="#cupsFileUnlock" title="Unlock access to a file.">cupsFileUnlock</a></li>
-
<li><a href="#cupsFileWrite" title="Write to a file.">cupsFileWrite</a></li>
+<li><a href="#cupsFileSeek" title="Seek in a file.">cupsFileSeek</a></li>
+<li><a href="#cupsFileStderr" title="Return a CUPS file associated with stderr.">cupsFileStderr</a></li>
+<li><a href="#cupsFileStdin" title="Return a CUPS file associated with stdin.">cupsFileStdin</a></li>
+<li><a href="#cupsFileStdout" title="Return a CUPS file associated with stdout.">cupsFileStdout</a></li>
+<li><a href="#cupsFileTell" title="Return the current file position.">cupsFileTell</a></li>
+<li><a href="#cupsFileUnlock" title="Unlock access to a file.">cupsFileUnlock</a></li>
+<li><a href="#cupsFileWrite" title="Write to a file.">cupsFileWrite</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_dentry_t" title="Directory entry type">cups_dentry_t</a></li>
<li><a href="#STRUCTURES">Structures</a><ul class="code">
<li><a href="#cups_dentry_s" title="Directory entry type">cups_dentry_s</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- File and directory API introduction for the Common UNIX Printing System (CUPS).
+ File and directory API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2005 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<html>
<!-- SECTION: Programming -->
<head>
- <title>Filter and Backend Programming </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Filter and Backend Programming</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a><ul class="subcontents">
-
<li><a href="#SECURITY">Security Considerations</a></li>
-
<li><a href="#SIGNALS">Signal Handling</a></li>
-
<li><a href="#TEMPFILES">Temporary Files</a></li>
-
<li><a href="#COPIES">Copy Generation</a></li>
-
<li><a href="#EXITCODES">Exit Codes</a></li>
-
<li><a href="#ENVIRONMENT">Environment Variables</a></li>
-
<li><a href="#MESSAGES">Communicating with the Scheduler</a></li>
-
<li><a href="#COMMUNICATING_BACKEND">Communicating with the Backend</a></li>
-
<li><a href="#COMMUNICATING_FILTER">Communicating with Filters</a></li>
-
<li><a href="#SNMP">Doing SNMP Queries with Network Printers</a></li>
+<li><a href="#SECURITY">Security Considerations</a></li>
+<li><a href="#SIGNALS">Signal Handling</a></li>
+<li><a href="#TEMPFILES">Temporary Files</a></li>
+<li><a href="#COPIES">Copy Generation</a></li>
+<li><a href="#EXITCODES">Exit Codes</a></li>
+<li><a href="#ENVIRONMENT">Environment Variables</a></li>
+<li><a href="#MESSAGES">Communicating with the Scheduler</a></li>
+<li><a href="#COMMUNICATING_BACKEND">Communicating with the Backend</a></li>
+<li><a href="#COMMUNICATING_FILTER">Communicating with Filters</a></li>
+<li><a href="#SNMP">Doing SNMP Queries with Network Printers</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsBackChannelRead" title="Read data from the backchannel.">cupsBackChannelRead</a></li>
-
<li><a href="#cupsBackChannelWrite" title="Write data to the backchannel.">cupsBackChannelWrite</a></li>
-
<li><a href="#cupsBackendDeviceURI" title="Get the device URI for a backend.">cupsBackendDeviceURI</a></li>
-
<li><a href="#cupsBackendReport" title="Write a device line from a backend.">cupsBackendReport</a></li>
-
<li><a href="#cupsSideChannelDoRequest" title="Send a side-channel command to a backend and wait for a response.">cupsSideChannelDoRequest</a></li>
-
<li><a href="#cupsSideChannelRead" title="Read a side-channel message.">cupsSideChannelRead</a></li>
-
<li><a href="#cupsSideChannelSNMPGet" title="Query a SNMP OID's value.">cupsSideChannelSNMPGet</a></li>
-
<li><a href="#cupsSideChannelSNMPWalk" title="Query multiple SNMP OID values.">cupsSideChannelSNMPWalk</a></li>
-
<li><a href="#cupsSideChannelWrite" title="Write a side-channel message.">cupsSideChannelWrite</a></li>
+<li><a href="#cupsBackChannelRead" title="Read data from the backchannel.">cupsBackChannelRead</a></li>
+<li><a href="#cupsBackChannelWrite" title="Write data to the backchannel.">cupsBackChannelWrite</a></li>
+<li><a href="#cupsBackendDeviceURI" title="Get the device URI for a backend.">cupsBackendDeviceURI</a></li>
+<li><a href="#cupsBackendReport" title="Write a device line from a backend.">cupsBackendReport</a></li>
+<li><a href="#cupsSideChannelDoRequest" title="Send a side-channel command to a backend and wait for a response.">cupsSideChannelDoRequest</a></li>
+<li><a href="#cupsSideChannelRead" title="Read a side-channel message.">cupsSideChannelRead</a></li>
+<li><a href="#cupsSideChannelSNMPGet" title="Query a SNMP OID's value.">cupsSideChannelSNMPGet</a></li>
+<li><a href="#cupsSideChannelSNMPWalk" title="Query multiple SNMP OID values.">cupsSideChannelSNMPWalk</a></li>
+<li><a href="#cupsSideChannelWrite" title="Write a side-channel message.">cupsSideChannelWrite</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_backend_t" title="Backend exit codes">cups_backend_t</a></li>
<li><a href="#cups_sc_state_e" title="Printer state bits">cups_sc_state_e</a></li>
<li><a href="#cups_sc_status_e" title="Response status codes">cups_sc_status_e</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
<h3><a name="SECURITY">Security Considerations</a></h3>
<p>It is always important to use security programming practices. Filters and
-most backends are run as a non-priviledged user, so the major security
+most backends are run as a non-privileged user, so the major security
consideration is resource utilization - filters should not depend on unlimited
amounts of CPU, memory, or disk space, and should protect against conditions
that could lead to excess usage of any resource like infinite loops and
<html>
<!-- SECTION: Programming -->
<head>
- <title>HTTP and IPP APIs </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>HTTP and IPP APIs</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a><ul class="subcontents">
-
<li><a href="#CREATING_URI_STRINGS">Creating URI Strings</a></li>
-
<li><a href="#SENDING_REQUESTS_WITH_FILES">Sending Requests with Files</a></li>
-
<li><a href="#ASYNCHRONOUS_REQUEST_PROCESSING">Asynchronous Request Processing</a></li>
+<li><a href="#CREATING_URI_STRINGS">Creating URI Strings</a></li>
+<li><a href="#SENDING_REQUESTS_WITH_FILES">Sending Requests with Files</a></li>
+<li><a href="#ASYNCHRONOUS_REQUEST_PROCESSING">Asynchronous Request Processing</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsDoAuthentication" title="Authenticate a request.">cupsDoAuthentication</a></li>
-
<li><a href="#cupsDoFileRequest" title="Do an IPP request with a file.">cupsDoFileRequest</a></li>
-
<li><a href="#cupsDoIORequest" title="Do an IPP request with file descriptors.">cupsDoIORequest</a></li>
-
<li><a href="#cupsDoRequest" title="Do an IPP request.">cupsDoRequest</a></li>
-
<li><a href="#cupsEncodeOptions" title="Encode printer options into IPP attributes.">cupsEncodeOptions</a></li>
-
<li><a href="#cupsEncodeOptions2" title="Encode printer options into IPP attributes for a group.">cupsEncodeOptions2</a></li>
-
<li><a href="#cupsGetDevices" title="Get available printer devices.">cupsGetDevices</a></li>
-
<li><a href="#cupsGetFd" title="Get a file from the server.">cupsGetFd</a></li>
-
<li><a href="#cupsGetFile" title="Get a file from the server.">cupsGetFile</a></li>
-
<li><a href="#cupsGetResponse" title="Get a response to an IPP request.">cupsGetResponse</a></li>
-
<li><a href="#cupsLastError" title="Return the last IPP status code.">cupsLastError</a></li>
-
<li><a href="#cupsLastErrorString" title="Return the last IPP status-message.">cupsLastErrorString</a></li>
-
<li><a href="#cupsPutFd" title="Put a file on the server.">cupsPutFd</a></li>
-
<li><a href="#cupsPutFile" title="Put a file on the server.">cupsPutFile</a></li>
-
<li><a href="#cupsReadResponseData" title="Read additional data after the IPP response.">cupsReadResponseData</a></li>
-
<li><a href="#cupsSendRequest" title="Send an IPP request.">cupsSendRequest</a></li>
-
<li><a href="#cupsWriteRequestData" title="Write additional data after an IPP request.">cupsWriteRequestData</a></li>
-
<li><a href="#httpAddCredential" title="Allocates and adds a single credential to an array.">httpAddCredential</a></li>
-
<li><a href="#httpAddrAny" title="Check for the "any" address.">httpAddrAny</a></li>
-
<li><a href="#httpAddrEqual" title="Compare two addresses.">httpAddrEqual</a></li>
-
<li><a href="#httpAddrLength" title="Return the length of the address in bytes.">httpAddrLength</a></li>
-
<li><a href="#httpAddrLocalhost" title="Check for the local loopback address.">httpAddrLocalhost</a></li>
-
<li><a href="#httpAddrLookup" title="Lookup the hostname associated with the address.">httpAddrLookup</a></li>
-
<li><a href="#httpAddrString" title="Convert an address to a numeric string.">httpAddrString</a></li>
-
<li><a href="#httpAssembleURI" title="Assemble a uniform resource identifier from its
+<li><a href="#cupsDoAuthentication" title="Authenticate a request.">cupsDoAuthentication</a></li>
+<li><a href="#cupsDoFileRequest" title="Do an IPP request with a file.">cupsDoFileRequest</a></li>
+<li><a href="#cupsDoIORequest" title="Do an IPP request with file descriptors.">cupsDoIORequest</a></li>
+<li><a href="#cupsDoRequest" title="Do an IPP request.">cupsDoRequest</a></li>
+<li><a href="#cupsEncodeOptions" title="Encode printer options into IPP attributes.">cupsEncodeOptions</a></li>
+<li><a href="#cupsEncodeOptions2" title="Encode printer options into IPP attributes for a group.">cupsEncodeOptions2</a></li>
+<li><a href="#cupsGetDevices" title="Get available printer devices.">cupsGetDevices</a></li>
+<li><a href="#cupsGetFd" title="Get a file from the server.">cupsGetFd</a></li>
+<li><a href="#cupsGetFile" title="Get a file from the server.">cupsGetFile</a></li>
+<li><a href="#cupsGetResponse" title="Get a response to an IPP request.">cupsGetResponse</a></li>
+<li><a href="#cupsLastError" title="Return the last IPP status code.">cupsLastError</a></li>
+<li><a href="#cupsLastErrorString" title="Return the last IPP status-message.">cupsLastErrorString</a></li>
+<li><a href="#cupsPutFd" title="Put a file on the server.">cupsPutFd</a></li>
+<li><a href="#cupsPutFile" title="Put a file on the server.">cupsPutFile</a></li>
+<li><a href="#cupsReadResponseData" title="Read additional data after the IPP response.">cupsReadResponseData</a></li>
+<li><a href="#cupsSendRequest" title="Send an IPP request.">cupsSendRequest</a></li>
+<li><a href="#cupsWriteRequestData" title="Write additional data after an IPP request.">cupsWriteRequestData</a></li>
+<li><a href="#httpAddCredential" title="Allocates and adds a single credential to an array.">httpAddCredential</a></li>
+<li><a href="#httpAddrAny" title="Check for the "any" address.">httpAddrAny</a></li>
+<li><a href="#httpAddrEqual" title="Compare two addresses.">httpAddrEqual</a></li>
+<li><a href="#httpAddrLength" title="Return the length of the address in bytes.">httpAddrLength</a></li>
+<li><a href="#httpAddrLocalhost" title="Check for the local loopback address.">httpAddrLocalhost</a></li>
+<li><a href="#httpAddrLookup" title="Lookup the hostname associated with the address.">httpAddrLookup</a></li>
+<li><a href="#httpAddrString" title="Convert an address to a numeric string.">httpAddrString</a></li>
+<li><a href="#httpAssembleURI" title="Assemble a uniform resource identifier from its
components.">httpAssembleURI</a></li>
-
<li><a href="#httpAssembleURIf" title="Assemble a uniform resource identifier from its
+<li><a href="#httpAssembleURIf" title="Assemble a uniform resource identifier from its
components with a formatted resource.">httpAssembleURIf</a></li>
-
<li><a href="#httpBlocking" title="Set blocking/non-blocking behavior on a connection.">httpBlocking</a></li>
-
<li><a href="#httpCheck" title="Check to see if there is a pending response from the server.">httpCheck</a></li>
-
<li><a href="#httpClearCookie" title="Clear the cookie value(s).">httpClearCookie</a></li>
-
<li><a href="#httpClearFields" title="Clear HTTP request fields.">httpClearFields</a></li>
-
<li><a href="#httpClose" title="Close an HTTP connection.">httpClose</a></li>
-
<li><a href="#httpConnect" title="Connect to a HTTP server.">httpConnect</a></li>
-
<li><a href="#httpConnectEncrypt" title="Connect to a HTTP server using encryption.">httpConnectEncrypt</a></li>
-
<li><a href="#httpCopyCredentials" title="Copy the credentials associated with an encrypted
+<li><a href="#httpBlocking" title="Set blocking/non-blocking behavior on a connection.">httpBlocking</a></li>
+<li><a href="#httpCheck" title="Check to see if there is a pending response from the server.">httpCheck</a></li>
+<li><a href="#httpClearCookie" title="Clear the cookie value(s).">httpClearCookie</a></li>
+<li><a href="#httpClearFields" title="Clear HTTP request fields.">httpClearFields</a></li>
+<li><a href="#httpClose" title="Close an HTTP connection.">httpClose</a></li>
+<li><a href="#httpConnect" title="Connect to a HTTP server.">httpConnect</a></li>
+<li><a href="#httpConnectEncrypt" title="Connect to a HTTP server using encryption.">httpConnectEncrypt</a></li>
+<li><a href="#httpCopyCredentials" title="Copy the credentials associated with an encrypted
connection.">httpCopyCredentials</a></li>
-
<li><a href="#httpDecode64" title="Base64-decode a string.">httpDecode64</a></li>
-
<li><a href="#httpDecode64_2" title="Base64-decode a string.">httpDecode64_2</a></li>
-
<li><a href="#httpDelete" title="Send a DELETE request to the server.">httpDelete</a></li>
-
<li><a href="#httpEncode64" title="Base64-encode a string.">httpEncode64</a></li>
-
<li><a href="#httpEncode64_2" title="Base64-encode a string.">httpEncode64_2</a></li>
-
<li><a href="#httpEncryption" title="Set the required encryption on the link.">httpEncryption</a></li>
-
<li><a href="#httpError" title="Get the last error on a connection.">httpError</a></li>
-
<li><a href="#httpFlush" title="Flush data from a HTTP connection.">httpFlush</a></li>
-
<li><a href="#httpFlushWrite" title="Flush data in write buffer.">httpFlushWrite</a></li>
-
<li><a href="#httpFreeCredentials" title="Free an array of credentials.">httpFreeCredentials</a></li>
-
<li><a href="#httpGet" title="Send a GET request to the server.">httpGet</a></li>
-
<li><a href="#httpGetAuthString" title="Get the current authorization string.">httpGetAuthString</a></li>
-
<li><a href="#httpGetBlocking" title="Get the blocking/non-block state of a connection.">httpGetBlocking</a></li>
-
<li><a href="#httpGetCookie" title="Get any cookie data from the response.">httpGetCookie</a></li>
-
<li><a href="#httpGetDateString" title="Get a formatted date/time string from a time value.">httpGetDateString</a></li>
-
<li><a href="#httpGetDateString2" title="Get a formatted date/time string from a time value.">httpGetDateString2</a></li>
-
<li><a href="#httpGetDateTime" title="Get a time value from a formatted date/time string.">httpGetDateTime</a></li>
-
<li><a href="#httpGetFd" title="Get the file descriptor associated with a connection.">httpGetFd</a></li>
-
<li><a href="#httpGetField" title="Get a field value from a request/response.">httpGetField</a></li>
-
<li><a href="#httpGetHostByName" title="Lookup a hostname or IPv4 address, and return
+<li><a href="#httpDecode64" title="Base64-decode a string.">httpDecode64</a></li>
+<li><a href="#httpDecode64_2" title="Base64-decode a string.">httpDecode64_2</a></li>
+<li><a href="#httpDelete" title="Send a DELETE request to the server.">httpDelete</a></li>
+<li><a href="#httpEncode64" title="Base64-encode a string.">httpEncode64</a></li>
+<li><a href="#httpEncode64_2" title="Base64-encode a string.">httpEncode64_2</a></li>
+<li><a href="#httpEncryption" title="Set the required encryption on the link.">httpEncryption</a></li>
+<li><a href="#httpError" title="Get the last error on a connection.">httpError</a></li>
+<li><a href="#httpFlush" title="Flush data from a HTTP connection.">httpFlush</a></li>
+<li><a href="#httpFlushWrite" title="Flush data in write buffer.">httpFlushWrite</a></li>
+<li><a href="#httpFreeCredentials" title="Free an array of credentials.">httpFreeCredentials</a></li>
+<li><a href="#httpGet" title="Send a GET request to the server.">httpGet</a></li>
+<li><a href="#httpGetAuthString" title="Get the current authorization string.">httpGetAuthString</a></li>
+<li><a href="#httpGetBlocking" title="Get the blocking/non-block state of a connection.">httpGetBlocking</a></li>
+<li><a href="#httpGetCookie" title="Get any cookie data from the response.">httpGetCookie</a></li>
+<li><a href="#httpGetDateString" title="Get a formatted date/time string from a time value.">httpGetDateString</a></li>
+<li><a href="#httpGetDateString2" title="Get a formatted date/time string from a time value.">httpGetDateString2</a></li>
+<li><a href="#httpGetDateTime" title="Get a time value from a formatted date/time string.">httpGetDateTime</a></li>
+<li><a href="#httpGetFd" title="Get the file descriptor associated with a connection.">httpGetFd</a></li>
+<li><a href="#httpGetField" title="Get a field value from a request/response.">httpGetField</a></li>
+<li><a href="#httpGetHostByName" title="Lookup a hostname or IPv4 address, and return
address records for the specified name.">httpGetHostByName</a></li>
-
<li><a href="#httpGetHostname" title="Get the FQDN for the connection or local system.">httpGetHostname</a></li>
-
<li><a href="#httpGetLength" title="Get the amount of data remaining from the
+<li><a href="#httpGetHostname" title="Get the FQDN for the connection or local system.">httpGetHostname</a></li>
+<li><a href="#httpGetLength" title="Get the amount of data remaining from the
content-length or transfer-encoding fields.">httpGetLength</a></li>
-
<li><a href="#httpGetLength2" title="Get the amount of data remaining from the
+<li><a href="#httpGetLength2" title="Get the amount of data remaining from the
content-length or transfer-encoding fields.">httpGetLength2</a></li>
-
<li><a href="#httpGetStatus" title="Get the status of the last HTTP request.">httpGetStatus</a></li>
-
<li><a href="#httpGetSubField" title="Get a sub-field value.">httpGetSubField</a></li>
-
<li><a href="#httpGetSubField2" title="Get a sub-field value.">httpGetSubField2</a></li>
-
<li><a href="#httpGets" title="Get a line of text from a HTTP connection.">httpGets</a></li>
-
<li><a href="#httpHead" title="Send a HEAD request to the server.">httpHead</a></li>
-
<li><a href="#httpInitialize" title="Initialize the HTTP interface library and set the
+<li><a href="#httpGetStatus" title="Get the status of the last HTTP request.">httpGetStatus</a></li>
+<li><a href="#httpGetSubField" title="Get a sub-field value.">httpGetSubField</a></li>
+<li><a href="#httpGetSubField2" title="Get a sub-field value.">httpGetSubField2</a></li>
+<li><a href="#httpGets" title="Get a line of text from a HTTP connection.">httpGets</a></li>
+<li><a href="#httpHead" title="Send a HEAD request to the server.">httpHead</a></li>
+<li><a href="#httpInitialize" title="Initialize the HTTP interface library and set the
default HTTP proxy (if any).">httpInitialize</a></li>
-
<li><a href="#httpMD5" title="Compute the MD5 sum of the username:group:password.">httpMD5</a></li>
-
<li><a href="#httpMD5Final" title="Combine the MD5 sum of the username, group, and password
+<li><a href="#httpMD5" title="Compute the MD5 sum of the username:group:password.">httpMD5</a></li>
+<li><a href="#httpMD5Final" title="Combine the MD5 sum of the username, group, and password
with the server-supplied nonce value, method, and
request-uri.">httpMD5Final</a></li>
-
<li><a href="#httpMD5String" title="Convert an MD5 sum to a character string.">httpMD5String</a></li>
-
<li><a href="#httpOptions" title="Send an OPTIONS request to the server.">httpOptions</a></li>
-
<li><a href="#httpPost" title="Send a POST request to the server.">httpPost</a></li>
-
<li><a href="#httpPut" title="Send a PUT request to the server.">httpPut</a></li>
-
<li><a href="#httpRead" title="Read data from a HTTP connection.">httpRead</a></li>
-
<li><a href="#httpRead2" title="Read data from a HTTP connection.">httpRead2</a></li>
-
<li><a href="#httpReconnect" title="Reconnect to a HTTP server.">httpReconnect</a></li>
-
<li><a href="#httpSeparate" title="Separate a Universal Resource Identifier into its
+<li><a href="#httpMD5String" title="Convert an MD5 sum to a character string.">httpMD5String</a></li>
+<li><a href="#httpOptions" title="Send an OPTIONS request to the server.">httpOptions</a></li>
+<li><a href="#httpPost" title="Send a POST request to the server.">httpPost</a></li>
+<li><a href="#httpPut" title="Send a PUT request to the server.">httpPut</a></li>
+<li><a href="#httpRead" title="Read data from a HTTP connection.">httpRead</a></li>
+<li><a href="#httpRead2" title="Read data from a HTTP connection.">httpRead2</a></li>
+<li><a href="#httpReconnect" title="Reconnect to a HTTP server.">httpReconnect</a></li>
+<li><a href="#httpSeparate" title="Separate a Universal Resource Identifier into its
components.">httpSeparate</a></li>
-
<li><a href="#httpSeparate2" title="Separate a Universal Resource Identifier into its
+<li><a href="#httpSeparate2" title="Separate a Universal Resource Identifier into its
components.">httpSeparate2</a></li>
-
<li><a href="#httpSeparateURI" title="Separate a Universal Resource Identifier into its
+<li><a href="#httpSeparateURI" title="Separate a Universal Resource Identifier into its
components.">httpSeparateURI</a></li>
-
<li><a href="#httpSetAuthString" title="Set the current authorization string.">httpSetAuthString</a></li>
-
<li><a href="#httpSetCookie" title="Set the cookie value(s).">httpSetCookie</a></li>
-
<li><a href="#httpSetCredentials" title="Set the credentials associated with an encrypted
+<li><a href="#httpSetAuthString" title="Set the current authorization string.">httpSetAuthString</a></li>
+<li><a href="#httpSetCookie" title="Set the cookie value(s).">httpSetCookie</a></li>
+<li><a href="#httpSetCredentials" title="Set the credentials associated with an encrypted
connection.">httpSetCredentials</a></li>
-
<li><a href="#httpSetExpect" title="Set the Expect: header in a request.">httpSetExpect</a></li>
-
<li><a href="#httpSetField" title="Set the value of an HTTP header.">httpSetField</a></li>
-
<li><a href="#httpSetLength" title="Set the content-length and content-encoding.">httpSetLength</a></li>
-
<li><a href="#httpStatus" title="Return a short string describing a HTTP status code.">httpStatus</a></li>
-
<li><a href="#httpTrace" title="Send an TRACE request to the server.">httpTrace</a></li>
-
<li><a href="#httpUpdate" title="Update the current HTTP state for incoming data.">httpUpdate</a></li>
-
<li><a href="#httpWait" title="Wait for data available on a connection.">httpWait</a></li>
-
<li><a href="#httpWrite" title="Write data to a HTTP connection.">httpWrite</a></li>
-
<li><a href="#httpWrite2" title="Write data to a HTTP connection.">httpWrite2</a></li>
-
<li><a href="#ippAddBoolean" title="Add a boolean attribute to an IPP message.">ippAddBoolean</a></li>
-
<li><a href="#ippAddBooleans" title="Add an array of boolean values.">ippAddBooleans</a></li>
-
<li><a href="#ippAddCollection" title="Add a collection value.">ippAddCollection</a></li>
-
<li><a href="#ippAddCollections" title="Add an array of collection values.">ippAddCollections</a></li>
-
<li><a href="#ippAddDate" title="Add a date attribute to an IPP message.">ippAddDate</a></li>
-
<li><a href="#ippAddInteger" title="Add a integer attribute to an IPP message.">ippAddInteger</a></li>
-
<li><a href="#ippAddIntegers" title="Add an array of integer values.">ippAddIntegers</a></li>
-
<li><a href="#ippAddOctetString" title="Add an octetString value to an IPP message.">ippAddOctetString</a></li>
-
<li><a href="#ippAddRange" title="Add a range of values to an IPP message.">ippAddRange</a></li>
-
<li><a href="#ippAddRanges" title="Add ranges of values to an IPP message.">ippAddRanges</a></li>
-
<li><a href="#ippAddResolution" title="Add a resolution value to an IPP message.">ippAddResolution</a></li>
-
<li><a href="#ippAddResolutions" title="Add resolution values to an IPP message.">ippAddResolutions</a></li>
-
<li><a href="#ippAddSeparator" title="Add a group separator to an IPP message.">ippAddSeparator</a></li>
-
<li><a href="#ippAddString" title="Add a language-encoded string to an IPP message.">ippAddString</a></li>
-
<li><a href="#ippAddStrings" title="Add language-encoded strings to an IPP message.">ippAddStrings</a></li>
-
<li><a href="#ippDateToTime" title="Convert from RFC 1903 Date/Time format to UNIX time
+<li><a href="#httpSetExpect" title="Set the Expect: header in a request.">httpSetExpect</a></li>
+<li><a href="#httpSetField" title="Set the value of an HTTP header.">httpSetField</a></li>
+<li><a href="#httpSetLength" title="Set the content-length and content-encoding.">httpSetLength</a></li>
+<li><a href="#httpStatus" title="Return a short string describing a HTTP status code.">httpStatus</a></li>
+<li><a href="#httpTrace" title="Send an TRACE request to the server.">httpTrace</a></li>
+<li><a href="#httpUpdate" title="Update the current HTTP state for incoming data.">httpUpdate</a></li>
+<li><a href="#httpWait" title="Wait for data available on a connection.">httpWait</a></li>
+<li><a href="#httpWrite" title="Write data to a HTTP connection.">httpWrite</a></li>
+<li><a href="#httpWrite2" title="Write data to a HTTP connection.">httpWrite2</a></li>
+<li><a href="#ippAddBoolean" title="Add a boolean attribute to an IPP message.">ippAddBoolean</a></li>
+<li><a href="#ippAddBooleans" title="Add an array of boolean values.">ippAddBooleans</a></li>
+<li><a href="#ippAddCollection" title="Add a collection value.">ippAddCollection</a></li>
+<li><a href="#ippAddCollections" title="Add an array of collection values.">ippAddCollections</a></li>
+<li><a href="#ippAddDate" title="Add a date attribute to an IPP message.">ippAddDate</a></li>
+<li><a href="#ippAddInteger" title="Add a integer attribute to an IPP message.">ippAddInteger</a></li>
+<li><a href="#ippAddIntegers" title="Add an array of integer values.">ippAddIntegers</a></li>
+<li><a href="#ippAddOctetString" title="Add an octetString value to an IPP message.">ippAddOctetString</a></li>
+<li><a href="#ippAddRange" title="Add a range of values to an IPP message.">ippAddRange</a></li>
+<li><a href="#ippAddRanges" title="Add ranges of values to an IPP message.">ippAddRanges</a></li>
+<li><a href="#ippAddResolution" title="Add a resolution value to an IPP message.">ippAddResolution</a></li>
+<li><a href="#ippAddResolutions" title="Add resolution values to an IPP message.">ippAddResolutions</a></li>
+<li><a href="#ippAddSeparator" title="Add a group separator to an IPP message.">ippAddSeparator</a></li>
+<li><a href="#ippAddString" title="Add a language-encoded string to an IPP message.">ippAddString</a></li>
+<li><a href="#ippAddStrings" title="Add language-encoded strings to an IPP message.">ippAddStrings</a></li>
+<li><a href="#ippDateToTime" title="Convert from RFC 1903 Date/Time format to UNIX time
in seconds.">ippDateToTime</a></li>
-
<li><a href="#ippDelete" title="Delete an IPP message.">ippDelete</a></li>
-
<li><a href="#ippDeleteAttribute" title="Delete a single attribute in an IPP message.">ippDeleteAttribute</a></li>
-
<li><a href="#ippErrorString" title="Return a name for the given status code.">ippErrorString</a></li>
-
<li><a href="#ippErrorValue" title="Return a status code for the given name.">ippErrorValue</a></li>
-
<li><a href="#ippFindAttribute" title="Find a named attribute in a request...">ippFindAttribute</a></li>
-
<li><a href="#ippFindNextAttribute" title="Find the next named attribute in a request...">ippFindNextAttribute</a></li>
-
<li><a href="#ippLength" title="Compute the length of an IPP message.">ippLength</a></li>
-
<li><a href="#ippNew" title="Allocate a new IPP message.">ippNew</a></li>
-
<li><a href="#ippNewRequest" title="Allocate a new IPP request message.">ippNewRequest</a></li>
-
<li><a href="#ippOpString" title="Return a name for the given operation id.">ippOpString</a></li>
-
<li><a href="#ippOpValue" title="Return an operation id for the given name.">ippOpValue</a></li>
-
<li><a href="#ippPort" title="Return the default IPP port number.">ippPort</a></li>
-
<li><a href="#ippRead" title="Read data for an IPP message from a HTTP connection.">ippRead</a></li>
-
<li><a href="#ippReadFile" title="Read data for an IPP message from a file.">ippReadFile</a></li>
-
<li><a href="#ippReadIO" title="Read data for an IPP message.">ippReadIO</a></li>
-
<li><a href="#ippSetPort" title="Set the default port number.">ippSetPort</a></li>
-
<li><a href="#ippTagString" title="Return the tag name corresponding to a tag value.">ippTagString</a></li>
-
<li><a href="#ippTagValue" title="Return the tag value corresponding to a tag name.">ippTagValue</a></li>
-
<li><a href="#ippTimeToDate" title="Convert from UNIX time to RFC 1903 format.">ippTimeToDate</a></li>
-
<li><a href="#ippWrite" title="Write data for an IPP message to a HTTP connection.">ippWrite</a></li>
-
<li><a href="#ippWriteFile" title="Write data for an IPP message to a file.">ippWriteFile</a></li>
-
<li><a href="#ippWriteIO" title="Write data for an IPP message.">ippWriteIO</a></li>
+<li><a href="#ippDelete" title="Delete an IPP message.">ippDelete</a></li>
+<li><a href="#ippDeleteAttribute" title="Delete a single attribute in an IPP message.">ippDeleteAttribute</a></li>
+<li><a href="#ippErrorString" title="Return a name for the given status code.">ippErrorString</a></li>
+<li><a href="#ippErrorValue" title="Return a status code for the given name.">ippErrorValue</a></li>
+<li><a href="#ippFindAttribute" title="Find a named attribute in a request...">ippFindAttribute</a></li>
+<li><a href="#ippFindNextAttribute" title="Find the next named attribute in a request...">ippFindNextAttribute</a></li>
+<li><a href="#ippLength" title="Compute the length of an IPP message.">ippLength</a></li>
+<li><a href="#ippNew" title="Allocate a new IPP message.">ippNew</a></li>
+<li><a href="#ippNewRequest" title="Allocate a new IPP request message.">ippNewRequest</a></li>
+<li><a href="#ippOpString" title="Return a name for the given operation id.">ippOpString</a></li>
+<li><a href="#ippOpValue" title="Return an operation id for the given name.">ippOpValue</a></li>
+<li><a href="#ippPort" title="Return the default IPP port number.">ippPort</a></li>
+<li><a href="#ippRead" title="Read data for an IPP message from a HTTP connection.">ippRead</a></li>
+<li><a href="#ippReadFile" title="Read data for an IPP message from a file.">ippReadFile</a></li>
+<li><a href="#ippReadIO" title="Read data for an IPP message.">ippReadIO</a></li>
+<li><a href="#ippSetPort" title="Set the default port number.">ippSetPort</a></li>
+<li><a href="#ippTagString" title="Return the tag name corresponding to a tag value.">ippTagString</a></li>
+<li><a href="#ippTagValue" title="Return the tag value corresponding to a tag name.">ippTagValue</a></li>
+<li><a href="#ippTimeToDate" title="Convert from UNIX time to RFC 1903 format.">ippTimeToDate</a></li>
+<li><a href="#ippWrite" title="Write data for an IPP message to a HTTP connection.">ippWrite</a></li>
+<li><a href="#ippWriteFile" title="Write data for an IPP message to a file.">ippWriteFile</a></li>
+<li><a href="#ippWriteIO" title="Write data for an IPP message.">ippWriteIO</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#http_addr_t" title="Socket address union, which
<li><a href="#ipp_status_e" title="IPP status codes">ipp_status_e</a></li>
<li><a href="#ipp_tag_e" title="Format tags for attributes">ipp_tag_e</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- HTTP and IPP API introduction for the Common UNIX Printing System (CUPS).
+ HTTP and IPP API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<html>
<!-- SECTION: Programming -->
<head>
- <title>MIME API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>MIME API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#mimeAddFilter" title="Add a filter to the current MIME database.">mimeAddFilter</a></li>
-
<li><a href="#mimeAddType" title="Add a MIME type to a database.">mimeAddType</a></li>
-
<li><a href="#mimeAddTypeRule" title="Add a detection rule for a file type.">mimeAddTypeRule</a></li>
-
<li><a href="#mimeDelete" title="Delete (free) a MIME database.">mimeDelete</a></li>
-
<li><a href="#mimeDeleteFilter" title="Delete a filter from the MIME database.">mimeDeleteFilter</a></li>
-
<li><a href="#mimeDeleteType" title="Delete a type from the MIME database.">mimeDeleteType</a></li>
-
<li><a href="#mimeFileType" title="Determine the type of a file.">mimeFileType</a></li>
-
<li><a href="#mimeFilter" title="Find the fastest way to convert from one type to another.">mimeFilter</a></li>
-
<li><a href="#mimeFilter2" title="Find the fastest way to convert from one type to another,
+<li><a href="#mimeAddFilter" title="Add a filter to the current MIME database.">mimeAddFilter</a></li>
+<li><a href="#mimeAddType" title="Add a MIME type to a database.">mimeAddType</a></li>
+<li><a href="#mimeAddTypeRule" title="Add a detection rule for a file type.">mimeAddTypeRule</a></li>
+<li><a href="#mimeDelete" title="Delete (free) a MIME database.">mimeDelete</a></li>
+<li><a href="#mimeDeleteFilter" title="Delete a filter from the MIME database.">mimeDeleteFilter</a></li>
+<li><a href="#mimeDeleteType" title="Delete a type from the MIME database.">mimeDeleteType</a></li>
+<li><a href="#mimeFileType" title="Determine the type of a file.">mimeFileType</a></li>
+<li><a href="#mimeFilter" title="Find the fastest way to convert from one type to another.">mimeFilter</a></li>
+<li><a href="#mimeFilter2" title="Find the fastest way to convert from one type to another,
including file size.">mimeFilter2</a></li>
-
<li><a href="#mimeFilterLookup" title="Lookup a filter.">mimeFilterLookup</a></li>
-
<li><a href="#mimeFirstFilter" title="Get the first filter in the MIME database.">mimeFirstFilter</a></li>
-
<li><a href="#mimeFirstType" title="Get the first type in the MIME database.">mimeFirstType</a></li>
-
<li><a href="#mimeLoad" title="Create a new MIME database from disk.">mimeLoad</a></li>
-
<li><a href="#mimeLoadFilters" title="Load filter definitions from disk.">mimeLoadFilters</a></li>
-
<li><a href="#mimeLoadTypes" title="Load type definitions from disk.">mimeLoadTypes</a></li>
-
<li><a href="#mimeNextFilter" title="Get the next filter in the MIME database.">mimeNextFilter</a></li>
-
<li><a href="#mimeNextType" title="Get the next type in the MIME database.">mimeNextType</a></li>
-
<li><a href="#mimeNumFilters" title="Next type">mimeNumFilters</a></li>
-
<li><a href="#mimeNumTypes" title="MIME database">mimeNumTypes</a></li>
-
<li><a href="#mimeType" title="Lookup a file type.">mimeType</a></li>
+<li><a href="#mimeFilterLookup" title="Lookup a filter.">mimeFilterLookup</a></li>
+<li><a href="#mimeFirstFilter" title="Get the first filter in the MIME database.">mimeFirstFilter</a></li>
+<li><a href="#mimeFirstType" title="Get the first type in the MIME database.">mimeFirstType</a></li>
+<li><a href="#mimeLoad" title="Create a new MIME database from disk.">mimeLoad</a></li>
+<li><a href="#mimeLoadFilters" title="Load filter definitions from disk.">mimeLoadFilters</a></li>
+<li><a href="#mimeLoadTypes" title="Load type definitions from disk.">mimeLoadTypes</a></li>
+<li><a href="#mimeNextFilter" title="Get the next filter in the MIME database.">mimeNextFilter</a></li>
+<li><a href="#mimeNextType" title="Get the next type in the MIME database.">mimeNextType</a></li>
+<li><a href="#mimeNumFilters" title="Next type">mimeNumFilters</a></li>
+<li><a href="#mimeNumTypes" title="MIME database">mimeNumTypes</a></li>
+<li><a href="#mimeType" title="Lookup a file type.">mimeType</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#mime_filter_t" title="MIME Conversion Filter Data">mime_filter_t</a></li>
<li><a href="#mime_t" title="MIME Database">mime_t</a></li>
<li><a href="#mime_type_t" title="MIME Type Data">mime_type_t</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
<html>
<!-- SECTION: Programming -->
<head>
- <title>Introduction to CUPS Programming </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Introduction to CUPS Programming</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#COMPILING">Compiling Programs</a><ul class="subcontents">
-
<li><a href="#XCODE">Compiling with Xcode</a></li>
-
<li><a href="#COMMANDLINE">Compiling with GCC</a></li>
+<li><a href="#XCODE">Compiling with Xcode</a></li>
+<li><a href="#COMMANDLINE">Compiling with GCC</a></li>
</ul></li>
<li><a href="#WHERETOGO">Where to Go Next</a></li>
-</ul>
<!--
"$Id$"
- Introduction to CUPS programming content for the Common UNIX Printing System
- (CUPS).
+ Introduction to CUPS programming content for CUPS.
- Copyright 2008 by Apple Inc.
+ Copyright 2008-2011 by Apple Inc.
These coded instructions, statements, and computer programs are the
property of Apple Inc. and are protected by Federal copyright
<html>
<!-- SECTION: Programming -->
<head>
- <title>PPD API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>PPD API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a><ul class="subcontents">
-
<li><a href="#LOADING">Loading a PPD File</a></li>
-
<li><a href="#OPTIONS_AND_GROUPS">Options and Groups</a></li>
-
<li><a href="#CONSTRAINTS">Constraints</a></li>
-
<li><a href="#PAGE_SIZES">Page Sizes</a></li>
-
<li><a href="#ATTRIBUTES">Attributes</a></li>
+<li><a href="#LOADING">Loading a PPD File</a></li>
+<li><a href="#OPTIONS_AND_GROUPS">Options and Groups</a></li>
+<li><a href="#CONSTRAINTS">Constraints</a></li>
+<li><a href="#PAGE_SIZES">Page Sizes</a></li>
+<li><a href="#ATTRIBUTES">Attributes</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsGetConflicts" title="Get a list of conflicting options in a marked PPD.">cupsGetConflicts</a></li>
-
<li><a href="#cupsMarkOptions" title="Mark command-line options in a PPD file.">cupsMarkOptions</a></li>
-
<li><a href="#cupsResolveConflicts" title="Resolve conflicts in a marked PPD.">cupsResolveConflicts</a></li>
-
<li><a href="#ppdClose" title="Free all memory used by the PPD file.">ppdClose</a></li>
-
<li><a href="#ppdCollect" title="Collect all marked options that reside in the specified
+<li><a href="#cupsGetConflicts" title="Get a list of conflicting options in a marked PPD.">cupsGetConflicts</a></li>
+<li><a href="#cupsMarkOptions" title="Mark command-line options in a PPD file.">cupsMarkOptions</a></li>
+<li><a href="#cupsResolveConflicts" title="Resolve conflicts in a marked PPD.">cupsResolveConflicts</a></li>
+<li><a href="#ppdClose" title="Free all memory used by the PPD file.">ppdClose</a></li>
+<li><a href="#ppdCollect" title="Collect all marked options that reside in the specified
section.">ppdCollect</a></li>
-
<li><a href="#ppdCollect2" title="Collect all marked options that reside in the
+<li><a href="#ppdCollect2" title="Collect all marked options that reside in the
specified section and minimum order.">ppdCollect2</a></li>
-
<li><a href="#ppdConflicts" title="Check to see if there are any conflicts among the
+<li><a href="#ppdConflicts" title="Check to see if there are any conflicts among the
marked option choices.">ppdConflicts</a></li>
-
<li><a href="#ppdEmit" title="Emit code for marked options to a file.">ppdEmit</a></li>
-
<li><a href="#ppdEmitAfterOrder" title="Emit a subset of the code for marked options to a file.">ppdEmitAfterOrder</a></li>
-
<li><a href="#ppdEmitFd" title="Emit code for marked options to a file.">ppdEmitFd</a></li>
-
<li><a href="#ppdEmitJCL" title="Emit code for JCL options to a file.">ppdEmitJCL</a></li>
-
<li><a href="#ppdEmitJCLEnd" title="Emit JCLEnd code to a file.">ppdEmitJCLEnd</a></li>
-
<li><a href="#ppdEmitString" title="Get a string containing the code for marked options.">ppdEmitString</a></li>
-
<li><a href="#ppdErrorString" title="Returns the text assocated with a status.">ppdErrorString</a></li>
-
<li><a href="#ppdFindAttr" title="Find the first matching attribute.">ppdFindAttr</a></li>
-
<li><a href="#ppdFindChoice" title="Return a pointer to an option choice.">ppdFindChoice</a></li>
-
<li><a href="#ppdFindCustomOption" title="Find a custom option.">ppdFindCustomOption</a></li>
-
<li><a href="#ppdFindCustomParam" title="Find a parameter for a custom option.">ppdFindCustomParam</a></li>
-
<li><a href="#ppdFindMarkedChoice" title="Return the marked choice for the specified option.">ppdFindMarkedChoice</a></li>
-
<li><a href="#ppdFindNextAttr" title="Find the next matching attribute.">ppdFindNextAttr</a></li>
-
<li><a href="#ppdFindOption" title="Return a pointer to the specified option.">ppdFindOption</a></li>
-
<li><a href="#ppdFirstCustomParam" title="Return the first parameter for a custom option.">ppdFirstCustomParam</a></li>
-
<li><a href="#ppdFirstOption" title="Return the first option in the PPD file.">ppdFirstOption</a></li>
-
<li><a href="#ppdInstallableConflict" title="Test whether an option choice conflicts with
+<li><a href="#ppdEmit" title="Emit code for marked options to a file.">ppdEmit</a></li>
+<li><a href="#ppdEmitAfterOrder" title="Emit a subset of the code for marked options to a file.">ppdEmitAfterOrder</a></li>
+<li><a href="#ppdEmitFd" title="Emit code for marked options to a file.">ppdEmitFd</a></li>
+<li><a href="#ppdEmitJCL" title="Emit code for JCL options to a file.">ppdEmitJCL</a></li>
+<li><a href="#ppdEmitJCLEnd" title="Emit JCLEnd code to a file.">ppdEmitJCLEnd</a></li>
+<li><a href="#ppdEmitString" title="Get a string containing the code for marked options.">ppdEmitString</a></li>
+<li><a href="#ppdErrorString" title="Returns the text assocated with a status.">ppdErrorString</a></li>
+<li><a href="#ppdFindAttr" title="Find the first matching attribute.">ppdFindAttr</a></li>
+<li><a href="#ppdFindChoice" title="Return a pointer to an option choice.">ppdFindChoice</a></li>
+<li><a href="#ppdFindCustomOption" title="Find a custom option.">ppdFindCustomOption</a></li>
+<li><a href="#ppdFindCustomParam" title="Find a parameter for a custom option.">ppdFindCustomParam</a></li>
+<li><a href="#ppdFindMarkedChoice" title="Return the marked choice for the specified option.">ppdFindMarkedChoice</a></li>
+<li><a href="#ppdFindNextAttr" title="Find the next matching attribute.">ppdFindNextAttr</a></li>
+<li><a href="#ppdFindOption" title="Return a pointer to the specified option.">ppdFindOption</a></li>
+<li><a href="#ppdFirstCustomParam" title="Return the first parameter for a custom option.">ppdFirstCustomParam</a></li>
+<li><a href="#ppdFirstOption" title="Return the first option in the PPD file.">ppdFirstOption</a></li>
+<li><a href="#ppdInstallableConflict" title="Test whether an option choice conflicts with
an installable option.">ppdInstallableConflict</a></li>
-
<li><a href="#ppdIsMarked" title="Check to see if an option is marked.">ppdIsMarked</a></li>
-
<li><a href="#ppdLastError" title="Return the status from the last ppdOpen*().">ppdLastError</a></li>
-
<li><a href="#ppdLocalize" title="Localize the PPD file to the current locale.">ppdLocalize</a></li>
-
<li><a href="#ppdLocalizeAttr" title="Localize an attribute.">ppdLocalizeAttr</a></li>
-
<li><a href="#ppdLocalizeIPPReason" title="Get the localized version of a cupsIPPReason
+<li><a href="#ppdIsMarked" title="Check to see if an option is marked.">ppdIsMarked</a></li>
+<li><a href="#ppdLastError" title="Return the status from the last ppdOpen*().">ppdLastError</a></li>
+<li><a href="#ppdLocalize" title="Localize the PPD file to the current locale.">ppdLocalize</a></li>
+<li><a href="#ppdLocalizeAttr" title="Localize an attribute.">ppdLocalizeAttr</a></li>
+<li><a href="#ppdLocalizeIPPReason" title="Get the localized version of a cupsIPPReason
attribute.">ppdLocalizeIPPReason</a></li>
-
<li><a href="#ppdLocalizeMarkerName" title="Get the localized version of a marker-names
+<li><a href="#ppdLocalizeMarkerName" title="Get the localized version of a marker-names
attribute value.">ppdLocalizeMarkerName</a></li>
-
<li><a href="#ppdMarkDefaults" title="Mark all default options in the PPD file.">ppdMarkDefaults</a></li>
-
<li><a href="#ppdMarkOption" title="Mark an option in a PPD file and return the number of
+<li><a href="#ppdMarkDefaults" title="Mark all default options in the PPD file.">ppdMarkDefaults</a></li>
+<li><a href="#ppdMarkOption" title="Mark an option in a PPD file and return the number of
conflicts.">ppdMarkOption</a></li>
-
<li><a href="#ppdNextCustomParam" title="Return the next parameter for a custom option.">ppdNextCustomParam</a></li>
-
<li><a href="#ppdNextOption" title="Return the next option in the PPD file.">ppdNextOption</a></li>
-
<li><a href="#ppdOpen" title="Read a PPD file into memory.">ppdOpen</a></li>
-
<li><a href="#ppdOpen2" title="Read a PPD file into memory.">ppdOpen2</a></li>
-
<li><a href="#ppdOpenFd" title="Read a PPD file into memory.">ppdOpenFd</a></li>
-
<li><a href="#ppdOpenFile" title="Read a PPD file into memory.">ppdOpenFile</a></li>
-
<li><a href="#ppdPageLength" title="Get the page length for the given size.">ppdPageLength</a></li>
-
<li><a href="#ppdPageSize" title="Get the page size record for the given size.">ppdPageSize</a></li>
-
<li><a href="#ppdPageSizeLimits" title="Return the custom page size limits.">ppdPageSizeLimits</a></li>
-
<li><a href="#ppdPageWidth" title="Get the page width for the given size.">ppdPageWidth</a></li>
-
<li><a href="#ppdSetConformance" title="Set the conformance level for PPD files.">ppdSetConformance</a></li>
+<li><a href="#ppdNextCustomParam" title="Return the next parameter for a custom option.">ppdNextCustomParam</a></li>
+<li><a href="#ppdNextOption" title="Return the next option in the PPD file.">ppdNextOption</a></li>
+<li><a href="#ppdOpen" title="Read a PPD file into memory.">ppdOpen</a></li>
+<li><a href="#ppdOpen2" title="Read a PPD file into memory.">ppdOpen2</a></li>
+<li><a href="#ppdOpenFd" title="Read a PPD file into memory.">ppdOpenFd</a></li>
+<li><a href="#ppdOpenFile" title="Read a PPD file into memory.">ppdOpenFile</a></li>
+<li><a href="#ppdPageLength" title="Get the page length for the given size.">ppdPageLength</a></li>
+<li><a href="#ppdPageSize" title="Get the page size record for the given size.">ppdPageSize</a></li>
+<li><a href="#ppdPageSizeLimits" title="Return the custom page size limits.">ppdPageSizeLimits</a></li>
+<li><a href="#ppdPageWidth" title="Get the page width for the given size.">ppdPageWidth</a></li>
+<li><a href="#ppdSetConformance" title="Set the conformance level for PPD files.">ppdSetConformance</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#ppd_attr_t" title="PPD Attribute Structure ">ppd_attr_t</a></li>
<li><a href="#ppd_status_e" title="Status Codes ">ppd_status_e</a></li>
<li><a href="#ppd_ui_e" title="UI Types">ppd_ui_e</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- PPD API introduction for the Common UNIX Printing System (CUPS).
+ PPD API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<html>
<!-- SECTION: Programming -->
<head>
- <title>PPD Compiler API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>PPD Compiler API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#CLASSES">Classes</a><ul class="code">
-
<li><a href="#ppdcArray" title="// Shared Array">ppdcArray</a></li>
-
<li><a href="#ppdcAttr" title="// Attribute">ppdcAttr</a></li>
-
<li><a href="#ppdcCatalog" title="// Translation catalog">ppdcCatalog</a></li>
-
<li><a href="#ppdcChoice" title="// Option Choice">ppdcChoice</a></li>
-
<li><a href="#ppdcConstraint" title="// Constraint">ppdcConstraint</a></li>
-
<li><a href="#ppdcDriver" title="// Printer Driver Data">ppdcDriver</a></li>
-
<li><a href="#ppdcFile" title="// File">ppdcFile</a></li>
-
<li><a href="#ppdcFilter" title="// Filter Program">ppdcFilter</a></li>
-
<li><a href="#ppdcFont" title="// Shared Font">ppdcFont</a></li>
-
<li><a href="#ppdcGroup" title="// Group of Options">ppdcGroup</a></li>
-
<li><a href="#ppdcInteger" title="// Shared integer">ppdcInteger</a></li>
-
<li><a href="#ppdcMediaSize" title="// Media Size">ppdcMediaSize</a></li>
-
<li><a href="#ppdcMessage" title="// Translation message">ppdcMessage</a></li>
-
<li><a href="#ppdcOption" title="// Option">ppdcOption</a></li>
-
<li><a href="#ppdcProfile" title="// Color Profile">ppdcProfile</a></li>
-
<li><a href="#ppdcShared" title="// Shared Data Value">ppdcShared</a></li>
-
<li><a href="#ppdcSource" title="// Source File">ppdcSource</a></li>
-
<li><a href="#ppdcString" title="// Shared String">ppdcString</a></li>
-
<li><a href="#ppdcVariable" title="// Variable Definition">ppdcVariable</a></li>
+<li><a href="#ppdcArray" title="// Shared Array">ppdcArray</a></li>
+<li><a href="#ppdcAttr" title="// Attribute">ppdcAttr</a></li>
+<li><a href="#ppdcCatalog" title="// Translation catalog">ppdcCatalog</a></li>
+<li><a href="#ppdcChoice" title="// Option Choice">ppdcChoice</a></li>
+<li><a href="#ppdcConstraint" title="// Constraint">ppdcConstraint</a></li>
+<li><a href="#ppdcDriver" title="// Printer Driver Data">ppdcDriver</a></li>
+<li><a href="#ppdcFile" title="// File">ppdcFile</a></li>
+<li><a href="#ppdcFilter" title="// Filter Program">ppdcFilter</a></li>
+<li><a href="#ppdcFont" title="// Shared Font">ppdcFont</a></li>
+<li><a href="#ppdcGroup" title="// Group of Options">ppdcGroup</a></li>
+<li><a href="#ppdcInteger" title="// Shared integer">ppdcInteger</a></li>
+<li><a href="#ppdcMediaSize" title="// Media Size">ppdcMediaSize</a></li>
+<li><a href="#ppdcMessage" title="// Translation message">ppdcMessage</a></li>
+<li><a href="#ppdcOption" title="// Option">ppdcOption</a></li>
+<li><a href="#ppdcProfile" title="// Color Profile">ppdcProfile</a></li>
+<li><a href="#ppdcShared" title="// Shared Data Value">ppdcShared</a></li>
+<li><a href="#ppdcSource" title="// Source File">ppdcSource</a></li>
+<li><a href="#ppdcString" title="// Shared String">ppdcString</a></li>
+<li><a href="#ppdcVariable" title="// Variable Definition">ppdcVariable</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#ppdc_cs_t" title="">ppdc_cs_t</a></li>
<li><a href="#ppdcOptSection" title="// Option section">ppdcOptSection</a></li>
<li><a href="#ppdcOptType" title="// Option type">ppdcOptType</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
<html>
<!-- SECTION: Programming -->
<head>
- <title>Raster API </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Raster API</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#OVERVIEW">Overview</a></li>
<li><a href="#TASKS">Functions by Task</a><ul class="subcontents">
-
<li><a href="#OPENCLOSE">Opening and Closing Raster Streams</a></li>
-
<li><a href="#READING">Reading Raster Streams</a></li>
-
<li><a href="#WRITING">Writing Raster Streams</a></li>
+<li><a href="#OPENCLOSE">Opening and Closing Raster Streams</a></li>
+<li><a href="#READING">Reading Raster Streams</a></li>
+<li><a href="#WRITING">Writing Raster Streams</a></li>
</ul></li>
<li><a href="#FUNCTIONS">Functions</a><ul class="code">
-
<li><a href="#cupsRasterClose" title="Close a raster stream.">cupsRasterClose</a></li>
-
<li><a href="#cupsRasterInterpretPPD" title="Interpret PPD commands to create a page header.">cupsRasterInterpretPPD</a></li>
-
<li><a href="#cupsRasterOpen" title="Open a raster stream using a file descriptor.">cupsRasterOpen</a></li>
-
<li><a href="#cupsRasterOpenIO" title="Open a raster stream using a callback function.">cupsRasterOpenIO</a></li>
-
<li><a href="#cupsRasterReadHeader" title="Read a raster page header and store it in a
+<li><a href="#cupsRasterClose" title="Close a raster stream.">cupsRasterClose</a></li>
+<li><a href="#cupsRasterInterpretPPD" title="Interpret PPD commands to create a page header.">cupsRasterInterpretPPD</a></li>
+<li><a href="#cupsRasterOpen" title="Open a raster stream using a file descriptor.">cupsRasterOpen</a></li>
+<li><a href="#cupsRasterOpenIO" title="Open a raster stream using a callback function.">cupsRasterOpenIO</a></li>
+<li><a href="#cupsRasterReadHeader" title="Read a raster page header and store it in a
version 1 page header structure.">cupsRasterReadHeader</a></li>
-
<li><a href="#cupsRasterReadHeader2" title="Read a raster page header and store it in a
+<li><a href="#cupsRasterReadHeader2" title="Read a raster page header and store it in a
version 2 page header structure.">cupsRasterReadHeader2</a></li>
-
<li><a href="#cupsRasterReadPixels" title="Read raster pixels.">cupsRasterReadPixels</a></li>
-
<li><a href="#cupsRasterWriteHeader" title="Write a raster page header from a version 1 page
+<li><a href="#cupsRasterReadPixels" title="Read raster pixels.">cupsRasterReadPixels</a></li>
+<li><a href="#cupsRasterWriteHeader" title="Write a raster page header from a version 1 page
header structure.">cupsRasterWriteHeader</a></li>
-
<li><a href="#cupsRasterWriteHeader2" title="Write a raster page header from a version 2
+<li><a href="#cupsRasterWriteHeader2" title="Write a raster page header from a version 2
page header structure.">cupsRasterWriteHeader2</a></li>
-
<li><a href="#cupsRasterWritePixels" title="Write raster pixels.">cupsRasterWritePixels</a></li>
+<li><a href="#cupsRasterWritePixels" title="Write raster pixels.">cupsRasterWritePixels</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="code">
<li><a href="#cups_adv_t" title="AdvanceMedia attribute values">cups_adv_t</a></li>
<li><a href="#cups_order_e" title="cupsColorOrder attribute values">cups_order_e</a></li>
<li><a href="#cups_orient_e" title="Orientation attribute values">cups_orient_e</a></li>
</ul></li>
-</ul>
<!--
"$Id$"
- Raster API introduction for the Common UNIX Printing System (CUPS).
+ Raster API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
Kerberos on your system and setup a system as a KDC. Because this
configuration is highly system and site-specific, please consult
the following on-line resources provided by the creators of Kerberos
-at the Massachussetts Institute of Technology (MIT):</P>
+at the Massachusetts Institute of Technology (MIT):</P>
<UL>
<H3><A NAME="JOBSHEETS">Selecting the Banner Page(s)</A></H3>
-<P>The <CODE>-o jobsheets=start,end</CODE> option sets the banner
+<P>The <CODE>-o job-sheets=start,end</CODE> option sets the banner
page(s) to use for a job:</P>
<PRE CLASS="command">
<html>
<!-- SECTION: Programming -->
<head>
- <title>Developing PostScript Printer Drivers </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Developing PostScript Printer Drivers</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#BASICS">Printer Driver Basics</a></li>
<li><a href="#CREATING">Creating New PPD Files</a><ul class="subcontents">
-
<li><a href="#IMPORT">Importing Existing PPD Files</a></li>
+<li><a href="#IMPORT">Importing Existing PPD Files</a></li>
</ul></li>
<li><a href="#FILTERS">Using Custom Filters</a></li>
<li><a href="#COLOR">Implementing Color Management</a></li>
<li><a href="#MACOSX">Adding Mac OS X Features</a></li>
-</ul>
<h2 class='title'><a name='BASICS'>Printer Driver Basics</a></h2>
<p>A CUPS PostScript printer driver consists of a PostScript Printer Description (PPD) file that describes the features and capabilities of the device, zero or more <em>filter</em> programs that prepare print data for the device, and zero or more support files for color management, online help, and so forth. The PPD file includes references to all of the filters and support files used by the driver.</p>
<html>
<!-- SECTION: Programming -->
<head>
- <title>Introduction to the PPD Compiler </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Introduction to the PPD Compiler</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#BASICS">The Basics</a></li>
<li><a href="#DRV">Driver Information Files</a><ul class="subcontents">
-
<li><a href="#SIMPLE">A Simple Example</a></li>
-
<li><a href="#GROUPING">Grouping and Inheritance</a></li>
-
<li><a href="#COLOR">Color Support</a></li>
-
<li><a href="#OPTIONS">Defining Custom Options and Option Groups</a></li>
-
<li><a href="#DEFINE">Defining Constants</a></li>
-
<li><a href="#CONDITIONAL">Conditional Statements</a></li>
-
<li><a href="#CONSTRAINTS">Defining Constraints</a></li>
+<li><a href="#SIMPLE">A Simple Example</a></li>
+<li><a href="#GROUPING">Grouping and Inheritance</a></li>
+<li><a href="#COLOR">Color Support</a></li>
+<li><a href="#OPTIONS">Defining Custom Options and Option Groups</a></li>
+<li><a href="#DEFINE">Defining Constants</a></li>
+<li><a href="#CONDITIONAL">Conditional Statements</a></li>
+<li><a href="#CONSTRAINTS">Defining Constraints</a></li>
</ul></li>
<li><a href="#LOCALIZATION">Localization</a><ul class="subcontents">
-
<li><a href="#PPDPO">The ppdpo Utility</a></li>
-
<li><a href="#PPDC_CATALOG">Using Message Catalogs with the PPD Compiler</a></li>
+<li><a href="#PPDPO">The ppdpo Utility</a></li>
+<li><a href="#PPDC_CATALOG">Using Message Catalogs with the PPD Compiler</a></li>
</ul></li>
-</ul>
<h2 class='title'><a name='BASICS'>The Basics</a></h2>
<P>The PPD compiler, <a href='man-ppdc.html'><code>ppdc(1)</code></a>, is a
<html>
<!-- SECTION: Programming -->
<head>
- <title>Developing Raster Printer Drivers </title>
- <meta name="keywords" content="Programming">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>Developing Raster Printer Drivers</title>
+<meta name="keywords" content="Programming">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#BASICS">Printer Driver Basics</a></li>
<li><a href="#CREATING">Creating New PPD Files</a></li>
<li><a href="#FILTERS">Using Filters</a></li>
<li><a href="#COLOR">Implementing Color Management</a></li>
<li><a href="#MACOSX">Adding Mac OS X Features</a></li>
-</ul>
<h2 class='title'><a name='BASICS'>Printer Driver Basics</a></h2>
<p>A CUPS raster printer driver consists of a PostScript Printer Description (PPD) file that describes the features and capabilities of the device, one or more <em>filter</em> programs that prepare print data for the device, and zero or more support files for color management, online help, and so forth. The PPD file includes references to all of the filters and support files used by the driver.</p>
...
Allow from All
Allow from None
- Allow from *.domain.com
- Allow from .domain.com
- Allow from host.domain.com
+ Allow from *.example.com
+ Allow from .example.com
+ Allow from host.example.com
Allow from nnn.*
Allow from nnn.nnn.*
Allow from nnn.nnn.nnn.*
<P>The <CODE>Allow</CODE> directive specifies a hostname, IP
address, or network that is allowed access to the server.
-<CODE>Allow</CODE> directives are cummulative, so multiple
+<CODE>Allow</CODE> directives are cumulative, so multiple
<CODE>Allow</CODE> directives can be used to allow access for
multiple hosts or networks.</P>
<PRE CLASS="command">
BrowseAddress 255.255.255.255:631
BrowseAddress 192.0.2.255:631
-BrowseAddress host.domain.com:631
+BrowseAddress host.example.com:631
BrowseAddress @LOCAL
BrowseAddress @IF(name)
</PRE>
BrowseAllow from 192.0.2
BrowseAllow from 192.0.2.0/24
BrowseAllow from 192.0.2.0/255.255.255.0
-BrowseAllow from *.domain.com
+BrowseAllow from *.example.com
BrowseAllow from @LOCAL
BrowseAllow from @IF(name)
</PRE>
BrowseDeny from 192.0.2
BrowseDeny from 192.0.2.0/24
BrowseDeny from 192.0.2.0/255.255.255.0
-BrowseDeny from *.domain.com
+BrowseDeny from *.example.com
BrowseDeny from @LOCAL
BrowseDeny from @IF(name)
</PRE>
<PRE CLASS="command">
BrowsePoll 192.0.2.2:631
-BrowsePoll host.domain.com:631
+BrowsePoll host.example.com:631
</PRE>
<H3>Description</H3>
BrowseRelay 193.0.2.1 192.0.2.255
BrowseRelay 193.0.2.0/255.255.255.0 192.0.2.255
BrowseRelay 193.0.2.0/24 192.0.2.255
-BrowseRelay *.domain.com 192.0.2.255
-BrowseRelay host.domain.com 192.0.2.255
+BrowseRelay *.example.com 192.0.2.255
+BrowseRelay host.example.com 192.0.2.255
</PRE>
<H3>Description</H3>
..
Deny from All
Deny from None
- Deny from *.domain.com
- Deny from .domain.com
- Deny from host.domain.com
+ Deny from *.example.com
+ Deny from .example.com
+ Deny from host.example.com
Deny from nnn.*
Deny from nnn.nnn.*
Deny from nnn.nnn.nnn.*
<P>The <CODE>Deny</CODE> directive specifies a hostname, IP
address, or network that is denied access to the server.
-<CODE>Deny</CODE> directives are cummulative, so multiple
+<CODE>Deny</CODE> directives are cumulative, so multiple
<CODE>Deny</CODE> directives can be used to deny access for
multiple hosts or networks.</P>
</TR>
<TR>
<TD>Get-Printer-Attributes</TD>
- <TD>Gets informaion about a printer or class</TD>
+ <TD>Gets information about a printer or class</TD>
</TR>
<TR>
<TD>Get-Subscription-Attributes</TD>
- <TD>Gets informaion about a notification subscription</TD>
+ <TD>Gets information about a notification subscription</TD>
</TR>
<TR>
<TD>Get-Subscriptions</TD>
</TR>
<TR>
<TD>Resume-Printer</TD>
- <TD>Sets the printer-stae value for a printer to idle/processing</TD>
+ <TD>Sets the printer-state value for a printer to idle/processing</TD>
</TR>
<TR>
<TD>Send-Document</TD>
<P>The <CODE>Satisfy</CODE> directive specifies whether all
conditions must be satisfied to allow access to the resource. If
set to <CODE>all</CODE>, then all authentication and access
-control conditions must be satified to allow access.</P>
+control conditions must be satisfied to allow access.</P>
<P>Setting <CODE>Satisfy</CODE> to <CODE>any</CODE> allows a user
to gain access if the authentication or access control
<PRE CLASS="command">
ServerAlias althost
-ServerAlias althost.foo.com
-ServerAlias althost.bar.com
+ServerAlias foo.example.com
+ServerAlias bar.example.com
ServerAlias *
</PRE>
<H3>Description</H3>
-<P>The <CODE>ServerAlias</CODE> directive specifies alternate names that the
-server is known by. By default it contains a list of all aliases associated
-with the <A HREF="#ServerName"><CODE>ServerName</CODE></A>. The special name
-"*" can be used to allow any hostname when accessing CUPS via an external
-network interfaces.</P>
+<P>The <CODE>ServerAlias</CODE> directive specifies alternate names that the server is known by. By default it contains a list of all aliases associated with the <A HREF="#ServerName"><CODE>ServerName</CODE></A>. The special name "*" can be used to allow any hostname when accessing CUPS via an external network interfaces.</P>
<BLOCKQUOTE><B>Note</B>
<H3>Examples</H3>
<PRE CLASS="command">
-ServerName foo.domain.com
-ServerName myserver.domain.com
+ServerName foo.example.com
+ServerName myserver.example.com
</PRE>
<H3>Description</H3>
<H3>Examples</H3>
<PRE CLASS="command">
-Cc bigbrother@domain.com
-Cc John Doe <jd@domain.com>
+Cc bigbrother@example.com
+Cc John Doe <jd@example.com>
</PRE>
<H3>Description</H3>
<H3>Examples</H3>
<PRE CLASS="command">
-From printserver@domain.com
-From Your Happy Printer <printserver@domain.com>
+From printserver@example.com
+From Your Happy Printer <printserver@example.com>
</PRE>
<H3>Description</H3>
<H3>Examples</H3>
<PRE CLASS="command">
-SMTPServer mail.domain.com
+SMTPServer mail.example.com
SMTPServer 192.168.2.1
</PRE>
<dd>Evaluates to the specified integer; the number can be preceded by
a leading sign (+/-) followed by a decimal number (1234), octal number
- (01234), or hexidecimal number (0x1234) using the same rules as C and
+ (01234), or hexadecimal number (0x1234) using the same rules as C and
C++.</dd>
<dt>(NAME NAME ... number number ...)</dt>
</dl>
<p>Printer driver information can be grouped and shared using
-curley braces ({ ... }); PPD files are written when a close
+curly braces ({ ... }); PPD files are written when a close
brace or end-of-file is seen and a <a href="#PCFileName">PCFileName</a>
directive has been defined.</p>
<h3>Description</h3>
<p>The <code>SimpleColorProfile</code> directive creates a
-matrix-based <a href="#ColorProfile"><code>ColorProfile</code></a>
-using values chosen with the <code>cupsprofile(1)</code> utility.
+matrix-based <a href="#ColorProfile"><code>ColorProfile</code></a>.
The resolution and mediatype arguments specify the
<code>Resolution</code> and <code>MediaType</code> choices which use the
profile; the hyphen (<code>-</code>) is used to specify that any
<h3>Description</h3>
-<p>The <code>Througput</code> directive sets the <code>Troughput</code>
+<p>The <code>Throughput</code> directive sets the <code>Throughput</code>
attribute for the current printer driver. The pages-per-minute
argument is a positive integer representing the peak number of
pages per minute that the printer is capable of producing. Use a
<H3>Description</H3>
-<P>The <CODE>MaxRunTime</CODE> directive specifies the maxium
+<P>The <CODE>MaxRunTime</CODE> directive specifies the maximum
number of seconds that the SNMP backend will spend looking for
printer devices on the network.</P>
potential security risks - the CUPS server does not accept remote
connections, and only accepts shared printer information from the
local subnet. When you share printers and/or enable remote
-adminstration, you expose your system to potential unauthorized
+administration, you expose your system to potential unauthorized
access. This help page provides an analysis of possible CUPS
security concerns and describes how to better secure your
server.</P>
<H2 CLASS="title"><A NAME="AUTHENTICATION">Authentication Issues</A></H2>
<P>When you enable remote administration, the server will use
-Basic authentication for adminstration tasks. The current CUPS
+Basic authentication for administration tasks. The current CUPS
server supports Basic, Digest, Kerberos, and local certificate
authentication:</P>
<!--
"$Id$"
- Banner file format specification for the Common UNIX Printing System (CUPS).
+ Banner file format specification for CUPS.
- Copyright 2008-2009 by Apple Inc.
+ Copyright 2008-2011 by Apple Inc.
These coded instructions, statements, and computer programs are the
property of Apple Inc. and are protected by Federal copyright
<!--
"$Id$"
- CUPS Browse Protocol specification for the Common UNIX Printing System (CUPS).
+ CUPS Browse Protocol specification for CUPS.
- Copyright 2008 by Apple Inc.
+ Copyright 2008-2011 by Apple Inc.
Copyright 1997-2005 by Easy Software Products.
These coded instructions, statements, and computer programs are the
file is missing or damaged, see the license at "http://www.cups.org/".
-->
+<BLOCKQUOTE><B>Note:</B>
+
+<P>The CUPS Browse Protocol is deprecated and will no longer be used in a future release of CUPS.</P>
+
+</BLOCKQUOTE>
+
<H1 CLASS="title">CUPS Browse Protocol</H1>
<h2><a name='INTRO'>Introduction</a></h2>
<P>Primary development occurs on the <var>trunk</var> branch,
with changes merged back to release branches as needed. Table 2
-shows the URLs developers use for the various CUPS subprojects
+shows the URLs developers use for the various CUPS sub-projects
and branches:</P>
<DIV CLASS="table"><TABLE SUMMARY="CUPS Subversion URLs">
<TD><A HREF="http://svn.easysw.com/public/cups/tags/">https://svn.easysw.com/public/cups/tags/</A></TD>
<TD>CUPS release tags (read-only)</TD>
</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/cupsddk/trunk/">https://svn.easysw.com/public/cupsddk/trunk/</A></TD>
- <TD>Primary CUPS DDK development branch</TD>
-</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/cupsddk/branches/">https://svn.easysw.com/public/cupsddk/branches/</A></TD>
- <TD>CUPS DDK maintenance branches (merge-only)</TD>
-</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/cupsddk/tags/">https://svn.easysw.com/public/cupsddk/tags/</A></TD>
- <TD>CUPS DDK release tags (read-only)</TD>
-</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/espgs/trunk/">https://svn.easysw.com/public/espgs/trunk/</A></TD>
- <TD>Primary ESP Ghostscript development branch</TD>
-</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/espgs/branches/">https://svn.easysw.com/public/espgs/branches/</A></TD>
- <TD>ESP Ghostscript maintenance branches (merge-only)</TD>
-</TR>
-<TR>
- <TD><A HREF="http://svn.easysw.com/public/espgs/tags/">https://svn.easysw.com/public/espgs/tags/</A></TD>
- <TD>ESP Ghostscript release tags (read-only)</TD>
-</TR>
<TR>
<TD><A HREF="http://svn.easysw.com/public/windows/trunk/">https://svn.easysw.com/public/windows/trunk/</A></TD>
<TD>Primary CUPS Windows Driver development branch</TD>
<H3>Files and Directories</H3>
<P>File and directory names may not exceed 16 characters in
-length to ensure compability with older UNIX filesystems. In
+length to ensure compatibility with older UNIX filesystems. In
addition, to avoid problems with case-insensitive filesystems,
you may not use names which differ only by case, for example
"ReadMe" and "README" are not allowed in the same directory.</P>
<!--
"$Id$"
- CUPS command file format specification for the Common UNIX Printing
- System (CUPS).
+ CUPS command file format specification for CUPS.
- Copyright 2007-2009 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products.
These coded instructions, statements, and computer programs are the
<!--
"$Id$"
- CUPS IPP specification for the Common UNIX Printing System (CUPS).
+ CUPS IPP specification for CUPS.
- Copyright 2007-2009 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2007 by Easy Software Products.
These coded instructions, statements, and computer programs are the
<!--
"$Id$"
- CUPS PostScript file specification for the Common UNIX Printing System (CUPS).
+ CUPS PostScript file specification for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 2006 by Easy Software Products.
These coded instructions, statements, and computer programs are the
output will work reliably.</p>
<blockquote><b>Note:</b> While PostScript is currently the
-defacto-standard print job file format/language for UNIX-based
+de-facto standard print job file format/language for UNIX-based
applications, it is slowly being phased out in favor of Adobe's
Portable Document Format ("PDF") which offers many advantages
over PostScript. Mac OS X uses PDF as the primary print job file
<html>
<!-- SECTION: Specifications -->
<head>
- <title>CUPS PPD Extensions </title>
- <meta name="keywords" content="Specifications">
- <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.7">
+<title>CUPS PPD Extensions</title>
+<meta name="keywords" content="Specifications">
+<meta name="creator" content="Mini-XML v2.7">
<style type="text/css"><!--
BODY {
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
</table></div>
<h2 class="title">Contents</h2>
<ul class="contents">
+<ul class="subcontents">
<li><a href="#SYNTAX">PPD File Syntax</a></li>
<li><a href="#AUTOCONFIG">Auto-Configuration</a><ul class="subcontents">
-
<li><a href="#APAutoSetupTool">APAutoSetupTool</a></li>
-
<li><a href="#QUERYKEYWORD">?MainKeyword</a></li>
-
<li><a href="#OID">OIDMainKeyword</a></li>
+<li><a href="#APAutoSetupTool">APAutoSetupTool</a></li>
+<li><a href="#QUERYKEYWORD">?MainKeyword</a></li>
+<li><a href="#OID">OIDMainKeyword</a></li>
</ul></li>
<li><a href="#PROFILES">Color Profiles</a><ul class="subcontents">
-
<li><a href="#cupsColorProfile">cupsColorProfile</a></li>
-
<li><a href="#cupsICCProfile">cupsICCProfile</a></li>
-
<li><a href="#APCustom">Custom Color Matching Support</a></li>
+<li><a href="#cupsColorProfile">cupsColorProfile</a></li>
+<li><a href="#cupsICCProfile">cupsICCProfile</a></li>
+<li><a href="#APCustom">Custom Color Matching Support</a></li>
</ul></li>
<li><a href="#CONSTRAINTS">Constraints</a><ul class="subcontents">
-
<li><a href="#cupsUIConstraints">cupsUIConstraints</a></li>
-
<li><a href="#cupsUIResolver">cupsUIResolver</a></li>
+<li><a href="#cupsUIConstraints">cupsUIConstraints</a></li>
+<li><a href="#cupsUIResolver">cupsUIResolver</a></li>
</ul></li>
<li><a href="#I18N">Globalized PPD Support</a></li>
<li><a href="#OPTIONS">CUPS 1.3/Mac OS X 10.6Custom Options</a></li>
<li><a href="#RASTERPS">Writing PostScript Option Commands for Raster Drivers</a></li>
<li><a href="#MEDIA">Media Keywords</a><ul class="subcontents">
-
<li><a href="#cupsMediaQualifier2">cupsMediaQualifier2</a></li>
-
<li><a href="#cupsMediaQualifier3">cupsMediaQualifier3</a></li>
-
<li><a href="#cupsMinSize">cupsMinSize</a></li>
-
<li><a href="#cupsMaxSize">cupsMaxSize</a></li>
+<li><a href="#cupsMediaQualifier2">cupsMediaQualifier2</a></li>
+<li><a href="#cupsMediaQualifier3">cupsMediaQualifier3</a></li>
+<li><a href="#cupsMinSize">cupsMinSize</a></li>
+<li><a href="#cupsMaxSize">cupsMaxSize</a></li>
</ul></li>
<li><a href="#ATTRIBUTES">General Attributes</a><ul class="subcontents">
-
<li><a href="#cupsBackSide">cupsBackSide</a></li>
-
<li><a href="#cupsCommands">cupsCommands</a></li>
-
<li><a href="#cupsEvenDuplex">cupsEvenDuplex</a></li>
-
<li><a href="#cupsFax">cupsFax</a></li>
-
<li><a href="#cupsFilter">cupsFilter</a></li>
-
<li><a href="#cupsFilter2">cupsFilter2</a></li>
-
<li><a href="#cupsFlipDuplex">cupsFlipDuplex</a></li>
-
<li><a href="#cupsIPPFinishings">cupsIPPFinishings</a></li>
-
<li><a href="#cupsIPPReason">cupsIPPReason</a></li>
-
<li><a href="#cupsIPPSupplies">cupsIPPSupplies</a></li>
-
<li><a href="#cupsLanguages">cupsLanguages</a></li>
-
<li><a href="#cupsManualCopies">cupsManualCopies</a></li>
-
<li><a href="#cupsMarkerName">cupsMarkerName</a></li>
-
<li><a href="#cupsMarkerNotice">cupsMarkerNotice</a></li>
-
<li><a href="#cupsModelNumber">cupsModelNumber</a></li>
-
<li><a href="#cupsPJLCharset">cupsPJLCharset</a></li>
-
<li><a href="#cupsPJLDisplay">cupsPJLDisplay</a></li>
-
<li><a href="#cupsPortMonitor">cupsPortMonitor</a></li>
-
<li><a href="#cupsPreFilter">cupsPreFilter</a></li>
-
<li><a href="#cupsPrintQuality">cupsPrintQuality</a></li>
-
<li><a href="#cupsSingleFile">cupsSingleFile</a></li>
-
<li><a href="#cupsSNMPSupplies">cupsSNMPSupplies</a></li>
-
<li><a href="#cupsVersion">cupsVersion</a></li>
+<li><a href="#cupsBackSide">cupsBackSide</a></li>
+<li><a href="#cupsCommands">cupsCommands</a></li>
+<li><a href="#cupsEvenDuplex">cupsEvenDuplex</a></li>
+<li><a href="#cupsFax">cupsFax</a></li>
+<li><a href="#cupsFilter">cupsFilter</a></li>
+<li><a href="#cupsFilter2">cupsFilter2</a></li>
+<li><a href="#cupsFlipDuplex">cupsFlipDuplex</a></li>
+<li><a href="#cupsIPPFinishings">cupsIPPFinishings</a></li>
+<li><a href="#cupsIPPReason">cupsIPPReason</a></li>
+<li><a href="#cupsIPPSupplies">cupsIPPSupplies</a></li>
+<li><a href="#cupsLanguages">cupsLanguages</a></li>
+<li><a href="#cupsManualCopies">cupsManualCopies</a></li>
+<li><a href="#cupsMarkerName">cupsMarkerName</a></li>
+<li><a href="#cupsMarkerNotice">cupsMarkerNotice</a></li>
+<li><a href="#cupsModelNumber">cupsModelNumber</a></li>
+<li><a href="#cupsPJLCharset">cupsPJLCharset</a></li>
+<li><a href="#cupsPJLDisplay">cupsPJLDisplay</a></li>
+<li><a href="#cupsPortMonitor">cupsPortMonitor</a></li>
+<li><a href="#cupsPreFilter">cupsPreFilter</a></li>
+<li><a href="#cupsPrintQuality">cupsPrintQuality</a></li>
+<li><a href="#cupsSingleFile">cupsSingleFile</a></li>
+<li><a href="#cupsSNMPSupplies">cupsSNMPSupplies</a></li>
+<li><a href="#cupsVersion">cupsVersion</a></li>
</ul></li>
<li><a href="#MACOSX">Mac OS X Attributes</a><ul class="subcontents">
-
<li><a href="#APDialogExtension">APDialogExtension</a></li>
-
<li><a href="#APDuplexRequiresFlippedMargin">APDuplexRequiresFlippedMargin</a></li>
-
<li><a href="#APHelpBook">APHelpBook</a></li>
-
<li><a href="#APICADriver">APICADriver</a></li>
-
<li><a href="#APPrinterIconPath">APPrinterIconPath</a></li>
-
<li><a href="#APPrinterLowInkTool">APPrinterLowInkTool</a></li>
-
<li><a href="#APPrinterPreset">APPrinterPreset</a></li>
-
<li><a href="#APPrinterUtilityPath">APPrinterUtilityPath</a></li>
-
<li><a href="#APScannerOnly">APScannerOnly</a></li>
-
<li><a href="#APScanAppBundleID">APScanAppBundleID</a></li>
+<li><a href="#APDialogExtension">APDialogExtension</a></li>
+<li><a href="#APDuplexRequiresFlippedMargin">APDuplexRequiresFlippedMargin</a></li>
+<li><a href="#APHelpBook">APHelpBook</a></li>
+<li><a href="#APICADriver">APICADriver</a></li>
+<li><a href="#APPrinterIconPath">APPrinterIconPath</a></li>
+<li><a href="#APPrinterLowInkTool">APPrinterLowInkTool</a></li>
+<li><a href="#APPrinterPreset">APPrinterPreset</a></li>
+<li><a href="#APPrinterUtilityPath">APPrinterUtilityPath</a></li>
+<li><a href="#APScannerOnly">APScannerOnly</a></li>
+<li><a href="#APScanAppBundleID">APScanAppBundleID</a></li>
</ul></li>
<li><a href="#HISTORY">Change History</a></li>
-</ul>
<h2 class='title'><a name='SYNTAX'>PPD File Syntax</a></h2>
<p>The PPD format is text-based and uses lines of up to 255 characters terminated by a carriage return, linefeed, or combination of carriage return and line feed. The following ABNF definition [<a href="http://tools.ietf.org/html/rfc5234" target="_blank">RFC5234</a>] defines the general format of lines in a PPD file:</p>
<p>Example:</p>
<pre class='command'>
-<em>*% Specify Canadian, UK, and US English, and Candian and French French</em>
+<em>*% Specify Canadian, UK, and US English, and Canadian and French French</em>
*cupsLanguages: "en_CA en_UK en_US fr_CA fr_FR"
</pre>
<H3>CUPS_CSPACE_RGBW</H3>
-<P>This color space provides a dedicated black text channel and uses the sRGB color space definition and whitepoint for the RGB color channels. The white channel is 0 for text (or "true") black, otherwise it must contain the maximum color value: 1 for 1-bit, 3 for 2-bit, 15 for 4-bit, 255 for 8-bit, or 65535 for 16-bit.</P>
+<P>This color space provides a dedicated black text channel and uses the sRGB color space definition and white point for the RGB color channels. The white channel is 0 for text (or "true") black, otherwise it must contain the maximum color value: 1 for 1-bit, 3 for 2-bit, 15 for 4-bit, 255 for 8-bit, or 65535 for 16-bit.</P>
<H3>CUPS_CSPACE_KCMYcm</H3>
<H3>CUPS_CSPACE_CIELab and CUPS_CSPACE_ICCn</H3>
-<P>These color spaces map a CIE Lab color value with a D65 whitepoint to either a 8- or 16-bit per color chunked (<CODE>CUPS_ORDER_CHUNKED</CODE>) format; the banded (<CODE>CUPS_ORDER_BANDED</CODE>) and planar (<CODE>CUPS_ORDER_PLANAR</CODE>) color orders are not supported.</P>
+<P>These color spaces map a CIE Lab color value with a D65 white point to either a 8- or 16-bit per color chunked (<CODE>CUPS_ORDER_CHUNKED</CODE>) format; the banded (<CODE>CUPS_ORDER_BANDED</CODE>) and planar (<CODE>CUPS_ORDER_PLANAR</CODE>) color orders are not supported.</P>
<P>The values are encoded and decoded using the following formulas:</P>
<H3>CUPS_CSPACE_CIEXYZ</H3>
-<P>These color spaces map a CIE XYZ color value with a D65 whitepoint to either a 8- or 16-bit per color chunked (<CODE>CUPS_ORDER_CHUNKED</CODE>) format; the banded (<CODE>CUPS_ORDER_BANDED</CODE>) and planar (<CODE>CUPS_ORDER_PLANAR</CODE>) color orders are not supported.</P>
+<P>These color spaces map a CIE XYZ color value with a D65 white point to either a 8- or 16-bit per color chunked (<CODE>CUPS_ORDER_CHUNKED</CODE>) format; the banded (<CODE>CUPS_ORDER_BANDED</CODE>) and planar (<CODE>CUPS_ORDER_PLANAR</CODE>) color orders are not supported.</P>
<P>The values are encoded and decoded using the following formulas:</P>
<P>The test software and data files are located in the
<VAR>test</VAR> subdirectory of the source distribution. A script
-is provided to compile the <CODE>ipptest</CODE> program and run
+is provided to compile the <CODE>ipptool</CODE> program and run
all of the tests that follow, producing a success/fail
report.</P>
German, "fr_ca" for French in Canada, and so forth.</P>
<P>Template files are HTML files with special formatting
-characters in them that allow substition of variables and arrays.
+characters in them that allow substitution of variables and arrays.
The CUPS CGI programs (<CODE>admin.cgi</CODE>,
<CODE>classes.cgi</CODE>, <CODE>help.cgi</CODE>,
<CODE>jobs.cgi</CODE>, and <CODE>printers.cgi</CODE>) use these
</TR>
<TR>
<TD>subscription-added.tmpl</TD>
- <TD>This template shows "subscription xyz added".</TD>
+ <TD>This template shows "subscription ... added".</TD>
</TR>
<TR>
<TD>subscription-canceled.tmpl</TD>
<H3><A NAME="VARIABLE">Inserting Attributes and Values</A></H3>
<P>Template files consist of HTML with variable substitutions for
-named inside curley braces "{name}". Variable names are generally
+named inside curly braces "{name}". Variable names are generally
the IPP attribute names with the hyphen ("-") replaced by the
underscore ("_") character. For example, the
<TT>job-printer-uri</TT> attribute is renamed to
</TABLE>
</PRE>
-<P>Arrays can be nested, however all elements within the curley
+<P>Arrays can be nested, however all elements within the curly
braces ("{" and "}") are indexed using the innermost array.</P>
<H3>Conditional Tests</H3>
<!--
"$Id$"
- Raster API introduction for the Common UNIX Printing System (CUPS).
+ Raster API introduction for CUPS.
- Copyright 2007-2008 by Apple Inc.
+ Copyright 2007-2011 by Apple Inc.
Copyright 1997-2006 by Easy Software Products, all rights reserved.
These coded instructions, statements, and computer programs are the
<p>Example:</p>
<pre class='command'>
-<em>*% Specify Canadian, UK, and US English, and Candian and French French</em>
+<em>*% Specify Canadian, UK, and US English, and Canadian and French French</em>
*cupsLanguages: "en_CA en_UK en_US fr_CA fr_FR"
</pre>
projects / thirdparty / cups.git / commitdiff
