trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From zw...@apache.org
Subject svn commit: r1042071 - /trafficserver/site/trunk/docs/v2/sdk/
Date Sat, 04 Dec 2010 00:39:46 GMT
Author: zwoop
Date: Sat Dec  4 00:39:46 2010
New Revision: 1042071

URL: http://svn.apache.org/viewvc?rev=1042071&view=rev
Log:
TS-581 Updates for the missing / wrong guarantees of no NULL terminated strings

Modified:
    trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html
    trafficserver/site/trunk/docs/v2/sdk/App_SampleSourceCode.html
    trafficserver/site/trunk/docs/v2/sdk/FunctionIndex.html
    trafficserver/site/trunk/docs/v2/sdk/HTTPAlternateSelection.html
    trafficserver/site/trunk/docs/v2/sdk/HTTPHeaderFunctions.html
    trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html
    trafficserver/site/trunk/docs/v2/sdk/RlsMarshalBufHandles.html
    trafficserver/site/trunk/docs/v2/sdk/SettingUpTransacHook.html
    trafficserver/site/trunk/docs/v2/sdk/URLFunctions.html
    trafficserver/site/trunk/docs/v2/sdk/WorkWHTTPHeaderFunc.html
    trafficserver/site/trunk/docs/v2/sdk/WorkWithHTTPHeaders.html
    trafficserver/site/trunk/docs/v2/sdk/ch18s09s04.html

Modified: trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/App_DeprecatedFunctions.html Sat Dec  4 00:39:46
2010
@@ -216,8 +216,6 @@
     <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>
 </dl>
 </div>
@@ -356,8 +354,6 @@
     <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>
 </dl>
 </div>
@@ -800,8 +796,7 @@
 </dd>
 <dt><span class="term"><b>Returns</b></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>
+</p></dd>
 </dl></div>
 </div>
 <div class="section" lang="en">
@@ -962,9 +957,7 @@ handle_string (INKHttpTxn txnp, INKCont 
        or make sure it's an unsigned integer (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>
+</pre></dd>
 </dl></div>
 </div>
 <div class="section" lang="en">

Modified: trafficserver/site/trunk/docs/v2/sdk/App_SampleSourceCode.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/App_SampleSourceCode.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/App_SampleSourceCode.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/App_SampleSourceCode.html Sat Dec  4 00:39:46 2010
@@ -99,7 +99,6 @@ handle_dns (INKHttpTxn txnp, INKCont con
             INKHttpTxnHookAdd (txnp,
                 INK_HTTP_SEND_RESPONSE_HDR_HOOK,
                 contp);
-            INKHandleStringRelease (bufp, url_loc, host);
             INKHandleMLocRelease (bufp, hdr_loc, url_loc);
             INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
             INKHttpTxnReenable (txnp, INK_EVENT_HTTP_ERROR);
@@ -109,7 +108,6 @@ handle_dns (INKHttpTxn txnp, INKCont con
     }
 
     INKMutexUnlock(sites_mutex);
-    INKHandleStringRelease (bufp, url_loc, host);
     INKHandleMLocRelease (bufp, hdr_loc, url_loc);
     INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
 

Modified: trafficserver/site/trunk/docs/v2/sdk/FunctionIndex.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/FunctionIndex.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/FunctionIndex.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/FunctionIndex.html Sat Dec  4 00:39:46 2010
@@ -48,7 +48,6 @@
 <li><a href="MemoryAllocationFunctions.html#INKfree" title="INKfree">INKfree</a></li>
 <li><a href="INKfwrite.html" title="INKfwrite">INKfwrite</a></li>
 <li><a href="ch18s09s04.html#INKHandleMLocRelease" title="INKHandleMLocRelease">INKHandleMLocRelease</a></li>
-<li><a href="ch18s09s04.html#INKHandleStringRelease" title="INKHandleStringRelease">INKHandleStringRelease</a></li>
 <li><a href="INKHostLookupResultIPGet.html" title="INKHostLookupResultIPGet">INKHostLookupResult</a></li>
 <li><a href="INKHostLookupResultIPGet.html" title="INKHostLookupResultIPGet">INKHostLookupResultIPGet</a></li>
 <li><a href="AlternateSelectionFunctions.html#INKHttpAltInfoCachedReqGet" title="INKHttpAltInfoCachedReqGet">INKHttpAltInfoCachedReqGet</a></li>

Modified: trafficserver/site/trunk/docs/v2/sdk/HTTPAlternateSelection.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/HTTPAlternateSelection.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/HTTPAlternateSelection.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/HTTPAlternateSelection.html Sat Dec  4 00:39:46 2010
@@ -116,17 +116,11 @@ content_transform_len) == 0));
    INKHttpAltInfoQualitySet(infop, quality)/
 
    /* cleanup */
-   if (accept_transform_value)
-      INKHandleStringRelease(client_req_buf, accept_transform_field,
-   accept_transform_value);
       if (accept_transform_field)
          INKHandleMLocRelease(client_req_buf, client_req_hdr,
    accept_transform_field);
       INKHandleMLocRelease(client_req_buf, INK_NULL_MLOC, client_req_hdr);
 
-      if (content_transform_value)
-         INKHandleStringRelease(cache_resp_buf, content_transform_field,
-   content_transform_value);
       if (content_transform_field)
          INKHandleMLocRelease(cache_resp_buf, cache_resp_hdr,
    content_transform_field);

Modified: trafficserver/site/trunk/docs/v2/sdk/HTTPHeaderFunctions.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/HTTPHeaderFunctions.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/HTTPHeaderFunctions.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/HTTPHeaderFunctions.html Sat Dec  4 00:39:46 2010
@@ -235,14 +235,12 @@
                 <code class="code"><em class="replaceable"><code>hdr_loc
</code></em></code> within the
                 marshal buffer <code class="code"><em class="replaceable"><code>bufp</code></em></code>.
                 The length of the returned string is placed in the length
-                argument. If length is <code class="code">NULL</code>, then no
attempt is
-                made to dereference it.</p>
+                argument. The string returned is not guaranteed to be
+                NULL terminated.</p>
 <p>It is an error to try to retrieve the method from an
                 HTTP header that is not of type
                 <code class="code">INK_HTTP_TYPE_REQUEST</code>.</p>
 <p>If it is a transaction header, then call after <code class="code">READ_REQUEST_HDR_HOOK</code>.</p>
-<p>Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -342,8 +340,6 @@
 <tr><td align="left" valign="top"><p>The returned string is not guaranteed
to be
                   null-terminated.</p></td></tr>
 </table></div>
-<p>Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>

Modified: trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/MimeHeadersFunctions.html Sat Dec  4 00:39:46 2010
@@ -308,8 +308,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the name of the specified field within the
-                specified MIME header. Release the returned string with a call
-                to <code class="function">INKHandleStringRelease</code>.</p>
+                specified MIME header.</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -796,17 +795,15 @@
 </dd>
 <dd>
   <p>The
-    length of the returned string is placed in the <code class="code"><em class="replaceable"><code>value_len
</code></em></code> argument. If
-    <code class="code"><em class="replaceable"><code>value_len </code></em></code>
is
-    <code class="code">NULL</code>, then no attempt is made to dereference
-    it.</p>
+    length of the returned string is placed in
+    the <code class="code"><em class="replaceable"><code>value_len </code></em></code>
+    argument. The string returned is not guaranteed to be NULL terminated.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the specified field
                 <code class="code"><em class="replaceable"><code>value
</code></em></code> in the MIME
-                header. Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+                header.</p>
 <p><code class="code">INK_SUCCESS</code> if the API is called
                 successfully.</p>
 <p><code class="code">INK_ERROR</code> if an error occurs while calling
@@ -1033,8 +1030,7 @@ handle_string (INKHttpTxn txnp, INKCont 
        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>
+</pre></dd>
 </dl></div>
 </div>
 <div class="section" lang="en">
@@ -1141,9 +1137,8 @@ handle_string (INKHttpTxn txnp, INKCont 
                 within the marshal buffer
                 <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
 <p>Make sure you release any corresponding
-                <code class="function">INKMLoc</code> or string handles via 
-                <code class="function">INKHandleMLocRelease</code> or
-                <code class="function">INKHandleStringRelease</code>.</p>
+                <code class="function">INKMLoc</code> via 
+                <code class="function">INKHandleMLocRelease</code>.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
@@ -1446,9 +1441,8 @@ copyResponseMimeHdr (INKCont pCont, INKH
                 marshal buffer
                 <code class="code"><em class="replaceable"><code>bufp</code></em></code>.</p>
 <p>Make sure that you release any corresponding
-                <code class="function">INKMLoc</code> or string handles using
-                <code class="function">INKHandleMLocRelease</code> or
-                <code class="function">INKHandleStringRelease</code>.</p>
+                <code class="function">INKMLoc</code> using
+                <code class="function">INKHandleMLocRelease</code>.</p>
 </dd>
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>

Modified: trafficserver/site/trunk/docs/v2/sdk/RlsMarshalBufHandles.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/RlsMarshalBufHandles.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/RlsMarshalBufHandles.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/RlsMarshalBufHandles.html Sat Dec  4 00:39:46 2010
@@ -33,8 +33,7 @@
 <pre class="programlisting">url_loc = INKHttpHdrUrlGet (bufp, hdr_loc);
 host_string = INKUrlHostGet (bufp, url_loc, &amp;host_length);</pre>
 <p>then your plugin would have to call:</p>
-<pre class="programlisting">INKHandleStringRelease (bufp, url_loc, host_string);
-INKHandleMLocRelease (bufp, hdr_loc, url_loc);</pre>
+<pre class="programlisting">INKHandleMLocRelease (bufp, hdr_loc, url_loc);</pre>
 <p>If an <code class="function">INKMLoc</code> is obtained from a
         transaction, then it does not have a parent <code class="function">INKMLoc</code>.
         Use the null <code class="function">INKMLoc</code> constant
@@ -59,8 +58,8 @@ INKHandleMLocRelease ( resp_bufp, INK_NU
 <th align="left">Tip</th>
 </tr>
 <tr><td align="left" valign="top"><p>You should release handles before
reenabling the HTTP transaction. In
-          other words, call <code class="function">INKHandleMLocRelease</code>
or
-          <code class="function">INKHandleStringRelease</code> before
+          other words, call <code class="function">INKHandleMLocRelease</code>
+           before
           <code class="function">INKHttpTxnReenable</code>. </p></td></tr>
 </table></div>
 </div>

Modified: trafficserver/site/trunk/docs/v2/sdk/SettingUpTransacHook.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/SettingUpTransacHook.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/SettingUpTransacHook.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/SettingUpTransacHook.html Sat Dec  4 00:39:46 2010
@@ -26,7 +26,6 @@ for (i = 0; i &lt; nsites; i++) {
           INKHttpTxnHookAdd (txnp,
                INK_HTTP_SEND_RESPONSE_HDR_HOOK,
                contp);
-          INKHandleStringRelease (bufp, url_loc, host);
           INKHandleMLocRelease (bufp, hdr_loc, url_loc);
           INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
           INKHttpTxnReenable (txnp, INK_EVENT_HTTP_ERROR);
@@ -63,7 +62,6 @@ for (i = 0; i &lt; nsites; i++) {
 <li>
   <p>The string and <code class="function">INKMLoc</code> data stored in
             the marshal buffer <code class="code">bufp</code> is released by
-            <code class="function">INKHandleStringRelease</code> and
             <code class="code">INKHandleMLocRelease</code> (see <a href="RlsMarshalBufHandles.html"
title="Release Marshal Buffer Handles">Release Marshal Buffer Handles</a>). Release
these handles before
       reenabling the transaction.</p></li>
 </ol></div>

Modified: trafficserver/site/trunk/docs/v2/sdk/URLFunctions.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/URLFunctions.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/URLFunctions.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/URLFunctions.html Sat Dec  4 00:39:46 2010
@@ -296,8 +296,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the host portion of the specified URL.
-                Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -374,8 +373,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the HTTP fragment portion of the specified
-                URL. Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+                URL.</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -452,8 +450,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the HTTP params portion of the specified
-                URL. Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+                URL.</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -529,8 +526,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the HTTP query portion of the specified
-                URL. Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+                URL.</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -672,8 +668,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the password portion of the specified URL.
-                Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -750,8 +745,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the path portion of the specified URL.
-                Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -877,8 +871,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the scheme portion of the specified URL.
-                Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>
@@ -992,8 +985,7 @@
 <dt><span class="term"><b>Returns</b></span></dt>
 <dd>
 <p>A pointer to the user portion of the specified URL.
-                Release with a call to
-                <code class="function">INKHandleStringRelease</code>.</p>
+</p>
 <p><code class="code">INK_ERROR_PTR</code> if an error occurs.</p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0"
summary="Note">
 <tr>

Modified: trafficserver/site/trunk/docs/v2/sdk/WorkWHTTPHeaderFunc.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/WorkWHTTPHeaderFunc.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/WorkWHTTPHeaderFunc.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/WorkWHTTPHeaderFunc.html Sat Dec  4 00:39:46 2010
@@ -50,8 +50,7 @@ handle_dns (INKHttpTxn txnp, INKCont con
         client request,  retrieve the URL portion, and then obtain the
         host header. See <a href="HTTPHeaders.html" title="Chapter 10. HTTP Headers">HTTP
Headers</a> for more information
         about these calls. See <a href="RlsMarshalBufHandles.html" title="Release Marshal
Buffer Handles">Release Marshal Buffer Handles</a> for guidelines on
-        using <code class="code">INKHandleMLocRelease</code> and
-        <code class="code">INKHandleStringRelease</code>.</p>
+        using <code class="code">INKHandleMLocRelease</code>.</p>
 </div>
 </body>
 </html>

Modified: trafficserver/site/trunk/docs/v2/sdk/WorkWithHTTPHeaders.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/WorkWithHTTPHeaders.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/WorkWithHTTPHeaders.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/WorkWithHTTPHeaders.html Sat Dec  4 00:39:46 2010
@@ -48,7 +48,6 @@ if (!val) {
 
      if (strncmp (val, "Basic", 5) != 0) {
           INKError ("no Basic auth type in Proxy-Authorization\n");
-          INKHandleStringRelease (bufp, field_loc, val);
           INKHandleMLocRelease (bufp, hdr_loc, field_loc);
           INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
           goto done;
@@ -64,7 +63,6 @@ if (!val) {
      if (!password) {
           INKError ("no password in authorization information\n");
           INKfree (user);
-          INKHandleStringRelease (bufp, field_loc, val);
           INKHandleMLocRelease (bufp, hdr_loc, field_loc);
           INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
           goto done;
@@ -75,14 +73,12 @@ if (!val) {
      if (!authorized (user, password)) {
           INKError ("%s:%s not authorized\n", user, password);
           INKfree (user);
-          INKHandleStringRelease (bufp, field_loc, val);
           INKHandleMLocRelease (bufp, hdr_loc, field_loc);
           INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
           goto done;
      }
 
      INKfree (user);
-     INKHandleStringRelease (bufp, field_loc, val);
      INKHandleMLocRelease (bufp, hdr_loc, field_loc);
      INKHandleMLocRelease (bufp, INK_NULL_MLOC, hdr_loc);
      INKHttpTxnReenable (txnp, INK_EVENT_HTTP_CONTINUE);

Modified: trafficserver/site/trunk/docs/v2/sdk/ch18s09s04.html
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/sdk/ch18s09s04.html?rev=1042071&r1=1042070&r2=1042071&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/sdk/ch18s09s04.html (original)
+++ trafficserver/site/trunk/docs/v2/sdk/ch18s09s04.html Sat Dec  4 00:39:46 2010
@@ -17,7 +17,6 @@
 
 <ul><b>
 <li><a href="ch18s09s04.html#INKHandleMLocRelease">INKHandleMLocRelease</a></li>
-<li><a href="ch18s09s04.html#INKHandleStringRelease">INKHandleStringRelease</a></li>
 
 </b></ul>
 
@@ -58,42 +57,6 @@
 </dd>
 </dl></div>
 </div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="INKHandleStringRelease"></a>INKHandleStringRelease</h4></div></div></div>
-<p>Releases string handles.</p>
-<div class="variablelist"><dl>
-<dt><span class="term"><b>Prototype</b></span></dt>
-<dd><p><code class="code">InkReturnCode INKHandleStringRelease (INKMBuffer
-                <em class="replaceable"><code>bufp</code></em>, INKMLoc
-                <em class="replaceable"><code>parent</code></em>,
const char
-                *<em class="replaceable"><code>str</code></em>)</code></p></dd>
-<dt><span class="term"><b>Arguments</b></span></dt>
-<dd>
-<p><code class="code"><em class="replaceable"><code>bufp </code></em></code>
is the
-                marshal buffer containing the string to be released.</p>
-<p><code class="code"><em class="replaceable"><code>parent </code></em></code>
is the
-                location of the parent object from which the handle was
-                created.</p>
-<p><code class="code"><em class="replaceable"><code>str </code></em></code>
is the
-                string to be released.</p>
-</dd>
-<dt><span class="term"><b>Description</b></span></dt>
-<dd>
-  <p>Releases the string
-                <code class="code"><em class="replaceable"><code>str </code></em></code>
created from the
-                <code class="function">INKMLoc</code> parent. Do not use
-                <code class="function">INKHandleStringRelease</code> for strings
-                created by <code class="function">INKUrlStringGet</code> (in
that
-                special case, use <code class="function">INKfree</code>).</p></dd>
-<dt><span class="term"><b>Returns</b></span></dt>
-<dd>
-<p><code class="code">INK_SUCCESS</code> if the string handle is
-                successfully released.</p>
-<p><code class="code">INK_ERROR</code> if the hook is not added.</p>
-</dd>
-</dl></div>
-</div>
 </div>
 </body>
 </html>



Mime
View raw message