trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From andrew...@apache.org
Subject svn commit: r831152 [9/37] - in /incubator/trafficserver/site/trunk/docs: ./ admin/ admin/images/ sdk/ sdk/css/ sdk/images/ sdk/images/docbook/ sdk/js/
Date Thu, 29 Oct 2009 23:23:36 GMT
Added: incubator/trafficserver/site/trunk/docs/sdk/App_DeprecatedFunctions.html
URL: http://svn.apache.org/viewvc/incubator/trafficserver/site/trunk/docs/sdk/App_DeprecatedFunctions.html?rev=831152&view=auto
==============================================================================
--- incubator/trafficserver/site/trunk/docs/sdk/App_DeprecatedFunctions.html (added)
+++ incubator/trafficserver/site/trunk/docs/sdk/App_DeprecatedFunctions.html Thu Oct 29 23:23:25 2009
@@ -0,0 +1,1436 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Appendix B. Deprecated Functions</title>
+<link rel="stylesheet" href="http://yui.yahooapis.com/2.2.2/build/reset/reset-min.css" type="text/css">
+<link rel="stylesheet" href="http://yui.yahooapis.com/2.2.2/build/fonts/fonts-min.css" type="text/css">
+<link rel="stylesheet" href="http://yui.yahooapis.com/2.2.2/build/treeview/assets/tree.css" type="text/css">
+<link rel="stylesheet" href="css/ydoc.css" type="text/css">
+<link rel="stylesheet" href="css/ydoc-chunk.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
+<link rel="start" href="index.html" title="Traffic Server Software Developers Kit">
+<link rel="up" href="index.html" title="Traffic Server Software Developers Kit">
+<link rel="prev" href="App_SampleSourceCode.html" title="Appendix A. Sample Source Code">
+<link rel="next" href="OtherDeprecatedFunctions.html" title="Other Deprecated Functions">
+<link rel="preface" href="Preface.html" title="Preface">
+<link rel="chapter" href="GetingStarted.html" title="Chapter 1. Getting Started">
+<link rel="chapter" href="CreatingTSPlugins.html" title="Chapter 2. How to Create Traffic Server Plugins">
+<link rel="index" href="CreatingTSPlugins.html#id372630" title="Index">
+<link rel="chapter" href="ch03.html" title="Chapter 3. Remap Plugin">
+<link rel="chapter" href="HeaderBasedPluginEx.html" title="Chapter 4. Header-Based Plugin Examples">
+<link rel="chapter" href="HTTPTransformationPlugins.html" title="Chapter 5. HTTP Transformation Plugins">
+<link rel="chapter" href="NewProtocolPlugins.html" title="Chapter 6. New Protocol Plugins">
+<link rel="chapter" href="ch07.html" title="Chapter 7. Cache Plugin">
+<link rel="chapter" href="HTTPHooksAndTransactions.html" title="Chapter 8. HTTP Hooks and Transactions">
+<link rel="chapter" href="MiscellaneousInterfaceGuide.html" title="Chapter 9. Miscellaneous Interface Guide">
+<link rel="chapter" href="HTTPHeaders.html" title="Chapter 10. HTTP Headers">
+<link rel="chapter" href="MutexGuide.html" title="Chapter 11. Mutex Guide">
+<link rel="chapter" href="Continuations.html" title="Chapter 12. Continuations">
+<link rel="chapter" href="PluginConfigurations.html" title="Chapter 13. Plugin Configurations">
+<link rel="chapter" href="ActionsGuide.html" title="Chapter 14. Actions Guide">
+<link rel="chapter" href="IOGuide.html" title="Chapter 15. IO Guide">
+<link rel="chapter" href="PluginManagement.html" title="Chapter 16. Plugin Management">
+<link rel="chapter" href="AddingStatistics.html" title="Chapter 17. Adding Statistics">
+<link rel="chapter" href="FunctionReference.html" title="Chapter 18. Function Reference">
+<link rel="appendix" href="App_SampleSourceCode.html" title="Appendix A. Sample Source Code">
+<link rel="appendix" href="App_DeprecatedFunctions.html" title="Appendix B. Deprecated Functions">
+<link rel="appendix" href="App_Troubleshooting.html" title="Appendix C. Troubleshooting Tips">
+<link rel="appendix" href="FunctionIndex.html" title="Appendix D. Function Index">
+<link rel="appendix" href="TypeIndex.html" title="Appendix E. Type Index">
+<link rel="index" href="ConceptIndex.html" title="Index">
+<link rel="section" href="App_DeprecatedFunctions.html#DepMimeHdrFunctions" title="Deprecated MIME Header Functions">
+<link rel="section" href="OtherDeprecatedFunctions.html" title="Other Deprecated Functions">
+<script type="text/javascript" src="http://yui.yahooapis.com/2.2.2/build/yahoo/yahoo-min.js"></script><script type="text/javascript" src="http://yui.yahooapis.com/2.2.2/build/event/event-min.js"></script><script type="text/javascript" src="http://yui.yahooapis.com/2.2.2/build/treeview/treeview-min.js"></script><script type="text/javascript" src="js/tocnodes.js"></script><script type="text/javascript" src="js/toc.js"></script><script type="text/javascript">
+    document.write("<style> div.toc {display: none} </style>"); 
+  </script>
+</head>
+<body>
+<div class="doctitle">
+<a href="index.html">Home</a>
+<img src="images/docbook/ts75.png"><h1 class="doctitle">Traffic Server Software Developers Kit</h1>
+</div>
+<div class="navheader">
+<div class="navprev">
+<a accesskey="p" href="App_SampleSourceCode.html">Prev</a> — Appendix A. Sample Source Code</div>
+<div class="navnext">Other Deprecated Functions — <a accesskey="n" href="OtherDeprecatedFunctions.html">Next</a>
+</div>
+</div>
+<div id="toc"></div>
+<div class="appendix" lang="en">
+<div class="titlepage"><div><div><h2 class="title">
+<a name="App_DeprecatedFunctions"></a>Appendix B. Deprecated Functions</h2></div></div></div>
+<div class="toc">
+<p><b>Table of Contents</b></p>
+<dl>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#DepMimeHdrFunctions">Deprecated MIME Header Functions</a></span></dt>
+<dd><dl>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldCopy">INKMimeFieldCopy</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldCopyValues">INKMimeFieldCopyValues</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldCreate">INKMimeFieldCreate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldDestroy">INKMimeFieldDestroy</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldLengthGet">INKMimeFieldLengthGet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldNameGet">INKMimeFieldNameGet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldNameSet">INKMimeFieldNameSet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldNext">INKMimeFieldNext</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueAppend">INKMimeFieldValueAppend</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueDelete">INKMimeFieldValueDelete</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueGet">INKMimeFieldValueGet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueGetDate">INKMimeFieldValueGetDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueGetInt">INKMimeFieldValueGetInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueGetUint">INKMimeFieldValueGetUint</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueInsertDate">INKMimeFieldValueInsertDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueInsertInt">INKMimeFieldValueInsertInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueInsertUint">INKMimeFieldValueInsertUint</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValuesClear">INKMimeFieldValuesClear</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValuesCount">INKMimeFieldValuesCount</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueSet">INKMimeFieldValueSet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueSetDate">INKMimeFieldValueSetDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueSetInt">INKMimeFieldValueSetInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeFieldValueSetUint">INKMimeFieldValueSetUint</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueGet">INKMimeHdrFieldValueGet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueGetDate">INKMimeHdrFieldValueGetDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueGetInt">INKMimeHdrFieldValueGetInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueGetUInt">INKMimeHdrFieldValueGetUInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueInsert">INKMimeHdrFieldValueInsert</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueInsertDate">INKMimeHdrFieldValueInsertDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueInsertInt">INKMimeHdrFieldValueInsertInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueInsertUInt">INKMimeHdrFieldValueInsertUInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueSet">INKMimeHdrFieldValueSet</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueSetDate">INKMimeHdrFieldValueSetDate</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueSetInt">INKMimeHdrFieldValueSetInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldValueSetUInt">INKMimeHdrFieldValueSetUInt</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldDelete">INKMimeHdrFieldDelete</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldInsert">INKMimeHdrFieldInsert</a></span></dt>
+<dt><span class="section"><a href="App_DeprecatedFunctions.html#INKMimeHdrFieldRetrieve">INKMimeHdrFieldRetrieve</a></span></dt>
+</dl></dd>
+<dt><span class="section"><a href="OtherDeprecatedFunctions.html">Other Deprecated Functions</a></span></dt>
+<dd><dl>
+<dt><span class="section"><a href="OtherDeprecatedFunctions.html#Dep_StatisticFunctions">Statistic Functions</a></span></dt>
+<dd><dl>
+<dt><span class="section"><a href="OtherDeprecatedFunctions.html#INKStatFloatRead">INKStatFloatRead</a></span></dt>
+<dt><span class="section"><a href="OtherDeprecatedFunctions.html#INKStatIntRead">INKStatIntRead</a></span></dt>
+</dl></dd>
+<dt><span class="section"><a href="Dep_IOBufferInterface.html">IO Buffer Interface</a></span></dt>
+<dd><dl>
+<dt><span class="section"><a href="Dep_IOBufferInterface.html#INKIOBufferAppend">INKIOBufferAppend</a></span></dt>
+<dt><span class="section"><a href="Dep_IOBufferInterface.html#INKIOBufferBlockCreate">INKIOBufferBlockCreate</a></span></dt>
+<dt><span class="section"><a href="Dep_IOBufferInterface.html#INKIOBufferDataCreate">INKIOBufferDataCreate</a></span></dt>
+</dl></dd>
+<dt><span class="section"><a href="Dep_MutexFunctions.html">Mutex Function</a></span></dt>
+<dd><dl><dt><span class="section"><a href="Dep_MutexFunctions.html#InkMutexTryLock">InkMutexTryLock</a></span></dt></dl></dd>
+</dl></dd>
+</dl>
+</div>
+<p>This appendix lists the functions that are deprecated in SDK 5.2 and
+    newer.</p>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="DepMimeHdrFunctions"></a>Deprecated MIME Header Functions</h2></div></div></div>
+<p>The following MIME field functions are deprecated in SDK
+      3.0.</p>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldCopy"></a>INKMimeFieldCopy</h3></div></div></div>
+<p>Copies a MIME field from one location to another.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldCopy (INKMBuffer
+              <em class="replaceable"><code>dest_bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>dest_offset</code></em>,INKMBuffer
+              <em class="replaceable"><code>src_bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>src_offset</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Copies the contents of the MIME field located at
+              <code class="code"><em class="replaceable"><code>src_offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>src_bufp</code></em></code>
+              to the MIME field located at
+              <code class="code"><em class="replaceable"><code>dest_offset</code></em></code> within the
+              marshal buffer
+              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
+              <code class="function">INKMimeFieldCopy</code> works correctly even if
+              <code class="code"><em class="replaceable"><code>src_bufp</code></em></code> and
+              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code> point to
+              different marshal buffers.</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>You must first create the destination MIME field before
+                copying into it.</p></td></tr>
+</table></div>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldCopyValues"></a>INKMimeFieldCopyValues</h3></div></div></div>
+<p>Copies MIME field values from one location to another.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldCopyValues (INKMBuffer
+              <em class="replaceable"><code>dest_bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>dest_offset</code></em>,INKMBuffer
+              <em class="replaceable"><code>src_bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>src_offset</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Copies the values contained within the MIME field located
+              at <code class="code"><em class="replaceable"><code>src_offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>src_bufp</code></em></code>
+              to the MIME field located at
+              <code class="code"><em class="replaceable"><code>dest_offset</code></em></code> within the
+              marshal buffer
+              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code>.
+              <code class="function">INKMimeFieldCopyValues</code> works correctly even
+              if <code class="code"><em class="replaceable"><code>src_bufp</code></em></code> and
+              <code class="code"><em class="replaceable"><code>dest_bufp</code></em></code> point to
+              different marshal buffers.
+              <code class="function">INKMIMEFieldCopyValues</code> does not copy the
+              field’s name.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldCreate"></a>INKMimeFieldCreate</h3></div></div></div>
+<p>Creates a new MIME field within a specified marshal
+        buffer.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldCreate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Creates a new MIME field with the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. Returns the offset
+              location of the new MIME field.</p>
+<p>Release the created <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldDestroy"></a>INKMimeFieldDestroy</h3></div></div></div>
+<p>Deletes a specified MIME field from a marshal buffer.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldDestroy (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Destroys the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
+<p>Release the handle with a call to
+              <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldLengthGet"></a>INKMimeFieldLengthGet</h3></div></div></div>
+<p>Calculates the length of a string representation of a specified
+        MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">int INKMimeFieldLengthGet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Calculates the length of the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> if
+              it were returned as a string. This is the length of the MIME
+              field in its unparsed form.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldNameGet"></a>INKMimeFieldNameGet</h3></div></div></div>
+<p>Gets the name and length of a specified MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">const char* INKMimeFieldNameGet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              *<em class="replaceable"><code>length</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Returns the name of the field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
+              <code class="function">INKMimeFieldNameGet</code> places the length of
+              the returned string in the
+              <code class="code"><em class="replaceable"><code>length</code></em></code> argument. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is
+              <code class="code">NULL</code> then no attempt is made to de-reference
+              it.</p>
+<p>Release the returned string with a call to
+              <code class="function">INKHandleStringRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldNameSet"></a>INKMimeFieldNameSet</h3></div></div></div>
+<p>Sets a specified MIME field’s name.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldNameSet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, const char
+              *<em class="replaceable"><code>name</code></em>, int
+              <em class="replaceable"><code>length</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets the name of the field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
+              the string <code class="code"><em class="replaceable"><code>name</code></em></code>. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is -1 then
+              <code class="function">INKMimeFieldNameSet</code> assumes that name is
+              null-terminated. Otherwise, the length of the string name is
+              taken to be <code class="code"><em class="replaceable"><code>length</code></em></code>.
+              <code class="function">INKMimeFieldNameSet</code> copies the string to
+              within <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it is
+              okay to modify or delete
+              <code class="code"><em class="replaceable"><code>name</code></em></code> after calling
+              <code class="function">INKMimeFieldNameSet</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldNext"></a>INKMimeFieldNext</h3></div></div></div>
+<p>Returns the next MIME field after a specified MIME field in a
+        MIME header.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldNext (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc offset) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Conceptually, there are a list of MIME fields in a MIME
+              header (see <a href="HTTPHeaders.html#AboutHTTPHeaders" title="About HTTP Headers">“About HTTP Headers”</a>).
+              <code class="function">INKMimeFieldNext</code> returns the location of
+              the next field in the list after the field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
+<p>Release the returned <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueAppend"></a>INKMimeFieldValueAppend</h3></div></div></div>
+<p>Appends a string to a specified value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldNext (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Conceptually, there are a list of MIME fields in a MIME
+              header (see <a href="HTTPHeaders.html#AboutHTTPHeaders" title="About HTTP Headers">“About HTTP Headers”</a>).
+              <code class="function">INKMimeFieldNext</code> returns the location of
+              the next field in the list after the field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
+<p>Release the returned <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueDelete"></a>INKMimeFieldValueDelete</h3></div></div></div>
+<p>Deletes a specified value from a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValueDelete (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Removes and deletes a value from the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value should be deleted. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeFieldValuesCount</code> (<em class="replaceable"><code>bufp,
+              offset</code></em>) - 1 then no operation will be
+              performed.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueGet"></a>INKMimeFieldValueGet</h3></div></div></div>
+<p>Gets a specified field value from a MIME header.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">const char* INKMimeFieldValueGet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, int
+              *<em class="replaceable"><code>length</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Retrieves a string value from within the MIME field
+              located at <code class="code"><em class="replaceable"><code>offset</code></em></code> within
+              the marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
+              The <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter
+              specifies which field to retrieve. The fields are numbered from
+              0 to <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie within
+              that range then <code class="code">NULL</code> will be returned. The length
+              of the returned string is placed in the
+              <code class="code"><em class="replaceable"><code>length</code></em></code> argument. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is
+              <code class="code">NULL</code> then no attempt is made to dereference
+              it.</p>
+<p>Release the returned string with a call to
+              <code class="function">INKHandleStringRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueGetDate"></a>INKMimeFieldValueGetDate</h3></div></div></div>
+<p>Gets date value from a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">time_t INKMimeFieldValueGetDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Retrieves a date value from within the MIME field located
+              at <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which field to retrieve. The fields are numbered from 0 to
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie within
+              that range, <code class="function">INKMimeFieldValueGetDate</code>
+              returns (<code class="code">time_t</code>) 0. All values are stored as
+              strings within the MIME field.
+              <code class="function">INKMimeFieldValueGetDate</code> parses the string
+              value to return an integer date representation.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueGetInt"></a>INKMimeFieldValueGetInt</h3></div></div></div>
+<p>Gets an integer field value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">int INKMimeFieldValueGetInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Retrieves an integer value from within the MIME field
+              located at <code class="code"><em class="replaceable"><code>offset</code></em></code> within
+              the marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
+              The <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter
+              specifies which value within the field to retrieve. The fields
+              are numbered from 0 to
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie within
+              that range, <code class="function">INKMimeFieldValueGetInt</code> returns
+              (<code class="code">int</code>) 0. All values are stored as strings within
+              the MIME field. <code class="function">INKMimeFieldValueGetInt</code>
+              parses the string value to return an integer.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueGetUint"></a>INKMimeFieldValueGetUint</h3></div></div></div>
+<p>Gets unsigned integer field value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">unsigned int INKMimeFieldValueGetUint (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Retrieves an unsigned integer value from within the MIME
+              field located at <code class="code"><em class="replaceable"><code>offset</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which field to retrieve. The fields are numbered from 0 to
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie within
+              that range, <code class="function">INKMimeFieldValueGetUnit</code>
+              returns (<code class="code">unsigned int</code>) 0. All values are stored as
+              strings within the MIME field.
+              <code class="function">INKMimeFieldValueGetUint</code> parses the string
+              value to return an unsigned integer.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueInsertDate"></a>INKMimeFieldValueInsertDate</h3></div></div></div>
+<p>Inserts a date value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldValueInsertDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, time_t
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the date
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>offset</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> places the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              appended to the list of values. Normal usage is to specify -1
+              for <code class="code"><em class="replaceable"><code>idx</code></em></code> so that the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
+              list of values. All values are stored as strings within the MIME
+              field. <code class="function">INKMimeFieldValueInsertDate</code> simply
+              formats the date into a string and then calls
+              <code class="function">INKMimeFieldValueInsert</code>.</p>
+<p>Release the returned <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueInsertInt"></a>INKMimeFieldValueInsertInt</h3></div></div></div>
+<p>Inserts an integer value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldValueInsertInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the integer
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>offset</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> places the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              appended to the list of values. Normal usage is to specify -1
+              for <code class="code"><em class="replaceable"><code>idx</code></em></code> so that the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
+              list of values. All values are stored as strings within the MIME
+              field. <code class="function">INKMimeFieldValueInsertInt</code> simply
+              formats the integer into a string and then calls
+              <code class="function">INKMimeFieldValueInsert</code>.</p>
+<p>Release the returned <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueInsertUint"></a>INKMimeFieldValueInsertUint</h3></div></div></div>
+<p>Inserts an unsigned integer value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeFieldValueInsertUint (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, unsigned int
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the unsigned integer
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>offset</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> will be
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> will place the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code>
+              will be appended to the list of values. Normal usage is to
+              specify -1 for <code class="code"><em class="replaceable"><code>idx</code></em></code> so
+              that the <code class="code"><em class="replaceable"><code>value</code></em></code> will be
+              appended to the list of values. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeFieldValueInsertUint</code> simply formats
+              the unsigned integer into a string and then calls
+              <code class="function">INKMimeFieldValueInsert</code>.</p>
+<p>Release the returned <code class="function">INKMLoc</code> with a
+              call to <code class="function">INKHandleMLocRelease</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValuesClear"></a>INKMimeFieldValuesClear</h3></div></div></div>
+<p>Clears all values in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValuesClear (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Removes and destroys all of the values within the MIME
+              field located at <code class="code"><em class="replaceable"><code>offset</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValuesCount"></a>INKMimeFieldValuesCount</h3></div></div></div>
+<p>Counts the values in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">int INKMimeFieldValuesCount (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Returns a count of the number of values in the MIME field
+              located at <code class="code"><em class="replaceable"><code>offset</code></em></code> within
+              the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueSet"></a>INKMimeFieldValueSet</h3></div></div></div>
+<p>Sets a value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValueSet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, const char
+              *<em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>length</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
+              the string <code class="code"><em class="replaceable"><code>value</code></em></code>. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is -1 then it is
+              assumed that <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              null-terminated. Otherwise, the length of the string
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is taken to be
+              <code class="code"><em class="replaceable"><code>length</code></em></code>. The string is
+              copied to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>,
+              so it is okay to modify or delete
+              <code class="code"><em class="replaceable"><code>value</code></em></code> after calling
+              <code class="function">INKMimeFieldValueSet</code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1 then
+              no operation will be performed.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueSetDate"></a>INKMimeFieldValueSetDate</h3></div></div></div>
+<p>Sets a date value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValueSetDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, time_t
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
+              the data <code class="code">value</code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1 then
+              no operation will be performed. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeFieldValueSetDate</code> simply formats the
+              date into a string and then calls
+              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueSetInt"></a>INKMimeFieldValueSetInt</h3></div></div></div>
+<p>Sets an integer value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValueSetInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, int
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
+              the integer <code class="code"><em class="replaceable"><code>value</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1 then
+              no operation will be performed. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeFieldValueSetInt</code> simply formats the
+              integer into a string and then calls
+              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeFieldValueSetUint"></a>INKMimeFieldValueSetUint</h3></div></div></div>
+<p>Sets an unsigned integer value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeFieldValueSetUint (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>,INKMLoc
+              <em class="replaceable"><code>offset</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, unsigned int
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>offset</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to
+              the unsigned integer
+              <code class="code"><em class="replaceable"><code>value</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, offset</code></em></code>) - 1 then
+              no operation will be performed. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeFieldValueSetUint</code> simply formats the
+              unsigned integer into a string and then calls
+              <code class="function">INKMimeFieldValueSet</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueGet"></a>INKMimeHdrFieldValueGet</h3></div></div></div>
+<p>Gets a specified field value from a MIME header.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">const char* INKMimeHdrFieldValueGet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr_loc</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, int
+              *<em class="replaceable"><code>value_len_ptr</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Retrieves a string value from within the MIME field
+              located at <code class="code"><em class="replaceable"><code>field</code></em></code> within
+              the marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
+              The <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter
+              specifies which field to retrieve. The fields are numbered from
+              0 to <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1.
+              If <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie
+              within that range then <code class="code">NULL</code> will be returned. The
+              length of the returned string is placed in the
+              <code class="code"><em class="replaceable"><code>value_len_ptr</code></em></code> argument.
+              If <code class="code"><em class="replaceable"><code>value_len_ptr</code></em></code> is
+              <code class="code">NULL</code> then no attempt is made to dereference
+              it.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueStringGet</code>.</p>
+</dd>
+<dt><span class="term">Returns</span></dt>
+<dd><p>A pointer to the specified field value in the MIME header.
+              Release with a call to
+              <code class="function">INKHandleStringRelease</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueGetDate"></a>INKMimeHdrFieldValueGetDate</h3></div></div></div>
+<p>Gets date value from a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">time_t INKMimeHdrFieldValueGetDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Retrieves a date value from within the MIME field located
+              at <code class="code"><em class="replaceable"><code>field</code></em></code> within the
+              marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which field to retrieve. The fields are numbered from 0 to
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) -1.
+              If <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie
+              within that range,
+              <code class="function">INKMimeHdrFieldValueGetDate</code> returns
+              (<code class="code">time_t</code>) 0. All values are stored as strings within
+              the MIME field. <code class="function">INKMimeHdrFieldValueGetDate</code>
+              parses the string value to return an integer date
+              representation.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueDateGet</code>.</p>
+</dd>
+<dt><span class="term">Returns</span></dt>
+<dd><p>The date value from the specified MIME header.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueGetInt"></a>INKMimeHdrFieldValueGetInt</h3></div></div></div>
+<p>Gets an integer field value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">int INKMimeHdrFieldValueGetInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, int
+              *<em class="replaceable"><code>value_len-ptr</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Retrieves an integer value from within the MIME field
+              located at <code class="code"><em class="replaceable"><code>field</code></em></code> within
+              the marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
+              The <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter
+              specifies which value within the field to retrieve. The fields
+              are numbered from 0 to
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1.
+              If <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie
+              within that range,
+              <code class="function">INKMimeHdrFieldValueGetInt</code> returns
+              (<code class="code">int</code>) 0. All values are stored as strings within
+              the MIME field. <code class="function">INKMimeHdrFieldValueGetInt</code>
+              parses the string value to return an integer.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueIntGet</code>.</p>
+</dd>
+<dt><span class="term">Returns</span></dt>
+<dd><p>The interger value from the specified MIME field.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueGetUInt"></a>INKMimeHdrFieldValueGetUInt</h3></div></div></div>
+<p>Gets unsigned integer field value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">unsigned int INKMimeHdrFieldValueGetUInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Retrieves an unsigned integer value from within the MIME
+              field located at <code class="code"><em class="replaceable"><code>field</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which field to retrieve. The fields are numbered from 0 to
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1.
+              If <code class="code"><em class="replaceable"><code>idx</code></em></code> does not lie
+              within that range,
+              <code class="function">INKMimeHdrFieldValueGetUnit</code> returns
+              (<code class="code">unsigned int</code>) 0. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeHdrFieldValueGetUInt</code> parses the
+              string value to return an unsigned integer.</p>
+<p>It is not possible to determine if
+              <code class="function">INKMimeHdrFieldValueGetUInt</code> is returning an
+              unsigned int value in error. If you need to check for errors in
+              MIME header field values, you can fetch the header as a string
+              and examine it. Here is some sample code that fetches MIME
+              headers from marshal buffers into strings using
+              <code class="function">INKMimeHdrFieldValueGet</code> instead. The
+              context of this example is that the plugin is processing an HTTP
+              transaction and has access to a transaction.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueUIntGet</code>.</p>
+</dd>
+<dt><span class="term">Returns</span></dt>
+<dd><p>The unsigned integer value from the specified MIME
+              field.</p></dd>
+<dt><span class="term">Example</span></dt>
+<dd><pre class="programlisting">static void
+handle_string (INKHttpTxn txnp, INKCont contp) {
+    INKMBuffer bufp;
+    INKMLoc hdr_loc;
+    INKMLoc field;
+    int len;
+    char* output_string;
+    const char* value;
+/* Fetch  the transaction's client request header into a marshal buffer. */
+    if (!INKHttpTxnClientReqGet (txnp, &amp;bufp, &amp;hdr_loc)) { 
+        INKError ("couldn't retrieve client request header\n"); 
+        goto done;
+    }
+    field=INKMimeHdrFieldRetrieve(bufp, hdr_loc, 
+                                  INK_MIME_FIELD_CONTENT_LENGTH);
+         
+    if (!field) { 
+        INKError ("Content-Length field not found.\n"); 
+        INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
+        goto done;
+    } 
+    /* Obtain the value of the content length (normally an 
+     * unsigned int) as a string. */
+    value=INKMimeHdrFieldValueGet (bufp, hdr_loc, field, 0, &amp;len); 
+ 
+    if ((!value) || (len&lt;=0))}
+        INKHandleMLocRelease (bufp, hdr_loc, field);
+        INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
+        goto done;
+    }
+    /* Allocate the string with an extra byte for the string terminator. */
+    output_string = (char*) INKmalloc(len + 1);
+         
+    /* Copy the value. */
+    strncpy (output_string, value, len);
+
+    /* Terminate the string */
+    output_string[len] = '\0';
+/* Now that you have the MIME fields as a string, you can do 
+       whatever you want to do with it, for example, print it, or 
+       make sure it's an unsigned integer: either by using the
+       atol C function or by scanning each ASCII character.  */ 
+    INKDebug("my-plugin", "%s", output_string);
+     
+    /* Release handles and allocated memory. */    
+    INKHandleStringRelease (bufp, field, value);</pre></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueInsert"></a>INKMimeHdrFieldValueInsert</h3></div></div></div>
+<p>Inserts a value into a specified location within a MIME
+        field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsert (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, const char
+              *<em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>length</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the string
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>field</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is -1 then
+              <code class="function">INKMimeHdrFieldValueInsert</code> assumes that
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              null-terminated. Otherwise, the length of the string
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is taken to be
+              <code class="code"><em class="replaceable"><code>length</code></em></code>.
+              INKMimeHdrFieldValueInsert copies the string to within
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>, so it is okay to
+              modify or delete <code class="code"><em class="replaceable"><code>value</code></em></code>
+              after calling <code class="function">INKMimeHdrFieldValueSet</code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then <code class="function">INKMimeHdrFieldValueInsert</code> prepends
+              the <code class="code"><em class="replaceable"><code>value</code></em></code> to the list of
+              values in the field. Increasing values of
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> place the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1, <code class="function">INKMimeHdrFieldValueInsert</code> appends
+              the <code class="code"><em class="replaceable"><code>value</code></em></code> to the list of
+              values. Normal usage is to specify -1 for
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> so that the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
+              list of values.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueStringInsert</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueInsertDate"></a>INKMimeHdrFieldValueInsertDate</h3></div></div></div>
+<p>Inserts a date value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, time_t
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the data
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>field</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> places the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              appended to the list of values. Normal usage is to specify -1
+              for <code class="code"><em class="replaceable"><code>idx</code></em></code> so that the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
+              list of values. All values are stored as strings within the MIME
+              field. <code class="function">INKMimeHdrFieldValueInsertDate</code>
+              simply formats the date into a string and then calls
+              <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/docbook/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>Do not use the return value
+                (<code class="function">INKMLoc</code>) of this function. Future
+                versions will be changed to void.</p></td></tr>
+</table></div>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueDateInsert</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueInsertInt"></a>INKMimeHdrFieldValueInsertInt</h3></div></div></div>
+<p>Inserts an integer value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the integer
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>field</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> places the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              appended to the list of values. Normal usage is to specify -1
+              for <code class="code"><em class="replaceable"><code>idx</code></em></code> so that the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is appended to the
+              list of values. All values are stored as strings within the MIME
+              field. <code class="function">INKMimeHdrFieldValueInsertInt</code> simply
+              formats the integer into a string and then calls
+              <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueIntInsert</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueInsertUInt"></a>INKMimeHdrFieldValueInsertUInt</h3></div></div></div>
+<p>Inserts an unsigned integer value into a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">INKMLoc INKMimeHdrFieldValueInsertUInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, unsigned int
+              <em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>idx</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Inserts the unsigned integer
+              <code class="code"><em class="replaceable"><code>value</code></em></code> into the MIME
+              field located at <code class="code"><em class="replaceable"><code>field</code></em></code>
+              within the marshal buffer
+              <code class="code"><em class="replaceable"><code>bufp</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              where the inserted <code class="code"><em class="replaceable"><code>value</code></em></code>
+              should be put with respect to the other values already in the
+              MIME field. If <code class="code"><em class="replaceable"><code>idx</code></em></code> is 0
+              then the <code class="code"><em class="replaceable"><code>value</code></em></code> will be
+              prepended to the list of values in the field. Increasing values
+              of <code class="code"><em class="replaceable"><code>idx</code></em></code> will place the
+              <code class="code"><em class="replaceable"><code>value</code></em></code> further down the
+              list of values. If <code class="code"><em class="replaceable"><code>idx</code></em></code>
+              is -1 then the <code class="code"><em class="replaceable"><code>value</code></em></code>
+              will be appended to the list of values. Normal usage is to
+              specify -1 for <code class="code"><em class="replaceable"><code>idx</code></em></code> so
+              that the <code class="code"><em class="replaceable"><code>value</code></em></code> will be
+              appended to the list of values. All values are stored as strings
+              within the MIME field.
+              <code class="function">INKMimeHdrFieldValueInsertUInt</code> simply
+              formats the unsigned integer into a string and then calls
+              <code class="function">INKMimeHdrFieldValueInsert</code>.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueUIntInsert</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueSet"></a>INKMimeHdrFieldValueSet</h3></div></div></div>
+<p>Sets a value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeHdrFieldValueSet (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, const char
+              *<em class="replaceable"><code>value</code></em>, int
+              <em class="replaceable"><code>length</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>field</code></em></code> within the marshal
+              buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to the
+              string <code class="code"><em class="replaceable"><code>value</code></em></code>. If
+              <code class="code"><em class="replaceable"><code>length</code></em></code> is -1 then it is
+              assumed that <code class="code"><em class="replaceable"><code>value</code></em></code> is
+              null-terminated. Otherwise, the length of the string
+              <code class="code"><em class="replaceable"><code>value</code></em></code> is taken to be
+              <code class="code"><em class="replaceable"><code>length</code></em></code>. The string is
+              copied to within <code class="code"><em class="replaceable"><code>bufp</code></em></code>,
+              so it is okay to modify or delete
+              <code class="code"><em class="replaceable"><code>value</code></em></code> after calling
+              <code class="function">INKMimeHdrFieldValueSet</code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1
+              then no operation will be performed.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueStringSet</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueSetDate"></a>INKMimeHdrFieldValueSetDate</h3></div></div></div>
+<p>Sets a date value in a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeHdrFieldValueSetDate (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, time_t
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd><p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>field</code></em></code> within the marshal
+              buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to the date
+              <code class="code"><em class="replaceable"><code>value</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If the
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) -1
+              then no operation will be performed. All values are stored as
+              strings within the MIME field.
+              <code class="function">INKMimeHdrFieldValueSetDate</code> simply formats
+              the date into a string and then calls
+              <code class="function">INKMimeHdrFieldValueSet</code>.</p></dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueSetInt"></a>INKMimeHdrFieldValueSetInt</h3></div></div></div>
+<p>Sets an integer value within a MIME field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeHdrFieldValueSetInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, int
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>field</code></em></code> within the marshal
+              buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to the
+              integer <code class="code"><em class="replaceable"><code>value</code></em></code>. The
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter specifies
+              which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1
+              then no operation will be performed. All values are stored as
+              strings within the MIME field.
+              <code class="function">INKMimeHdrFieldValueSetInt</code> simply formats
+              the integer into a string and then calls
+              <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueIntSet</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldValueSetUInt"></a>INKMimeHdrFieldValueSetUInt</h3></div></div></div>
+<p>Sets a value in a MIME field to a specified unsigned
+        integer.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeHdrFieldValueSetUInt (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>, int
+              <em class="replaceable"><code>idx</code></em>, unsigned int
+              <em class="replaceable"><code>value</code></em>) </code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Sets a value in the MIME field located at
+              <code class="code"><em class="replaceable"><code>field</code></em></code> within the marshal
+              buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code> to the
+              unsigned integer <code class="code"><em class="replaceable"><code>value</code></em></code>.
+              The <code class="code"><em class="replaceable"><code>idx</code></em></code> parameter
+              specifies which value in the field to change. If
+              <code class="code"><em class="replaceable"><code>idx</code></em></code> is not between 0 and
+              <code class="function">INKMimeHdrFieldValuesCount</code>
+              (<code class="code"><em class="replaceable"><code>bufp, hdr, field</code></em></code>) - 1
+              then no operation will be performed. All values are stored as
+              strings within the MIME field.
+              <code class="function">INKMimeHdrFieldValueSetUInt</code> simply formats
+              the unsigned integer into a string and then calls
+              <code class="function">INKMimeHdrFieldValueSet</code>.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldValueUIntSet</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.5</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldDelete"></a>INKMimeHdrFieldDelete</h3></div></div></div>
+<p>Destroys a MIME header field.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>
+<dd><p><code class="code">void INKMimeHdrFieldDelete (INKMBuffer
+              <em class="replaceable"><code>bufp</code></em>, INKMLoc
+              <em class="replaceable"><code>hdr_loc</code></em>, INKMLoc
+              <em class="replaceable"><code>field</code></em>)</code></p></dd>
+<dt><span class="term">Description</span></dt>
+<dd>
+<p>Deletes the MIME field located at
+              <code class="code"><em class="replaceable"><code>field</code></em></code> within the MIME
+              header located at
+              <code class="code"><em class="replaceable"><code>hdr_loc</code></em></code> in the marshal
+              buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
+<p>Make sure you release the <code class="function">INKMLoc</code>
+              handle field with a call to
+              <code class="function">INKHandleMLocRelease</code>.</p>
+<p>This API has been deprecated by
+              <code class="function">INKMimeHdrFieldDestroy</code>.</p>
+</dd>
+<dt><span class="term">First release</span></dt>
+<dd><p>Traffic Server 3.0</p></dd>
+</dl></div>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="INKMimeHdrFieldInsert"></a>INKMimeHdrFieldInsert</h3></div></div></div>
+<p>Appends a field in a MIME header.</p>
+<div class="variablelist"><dl>
+<dt><span class="term">Prototype</span></dt>

[... 63 lines stripped ...]


Mime
View raw message