git.m6w6.name Git - awesomized/libmemcached/blob - issues.html

   1
   2
   3 <!DOCTYPE html>
   4 <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
   5 <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
   6 <head>
   7   <meta charset="utf-8">
   8
   9   <meta name="viewport" content="width=device-width, initial-scale=1.0">
  10
  11   <title>Bugs, Known Issues and Insufficiencies &mdash; libmemcached-awesome 1.1.4 documentation</title>
  12
  13
  14
  15
  16
  17
  18
  19
  20   <script type="text/javascript" src="_static/js/modernizr.min.js"></script>
  21
  22
  23       <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
  24         <script type="text/javascript" src="_static/jquery.js"></script>
  25         <script type="text/javascript" src="_static/underscore.js"></script>
  26         <script type="text/javascript" src="_static/doctools.js"></script>
  27         <script type="text/javascript" src="_static/language_data.js"></script>
  28
  29     <script type="text/javascript" src="_static/js/theme.js"></script>
  30
  31
  32
  33
  34   <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  35   <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  36     <link rel="index" title="Index" href="genindex.html" />
  37     <link rel="search" title="Search" href="search.html" />
  38     <link rel="copyright" title="Copyright" href="copyright.html" />
  39     <link rel="next" title="Copyright" href="copyright.html" />
  40     <link rel="prev" title="ChangeLog v0.x" href="ChangeLog-0.html" />
  41 </head>
  42
  43 <body class="wy-body-for-nav">
  44
  45
  46   <div class="wy-grid-for-nav">
  47
  48     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
  49       <div class="wy-side-scroll">
  50         <div class="wy-side-nav-search" >
  51
  52
  53
  54             <a href="index.html" class="icon icon-home"> libmemcached-awesome
  55
  56
  57
  58           </a>
  59
  60
  61
  62
  63               <div class="version">
  64                 1.1
  65               </div>
  66
  67
  68
  69
  70 <div role="search">
  71   <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
  72     <input type="text" name="q" placeholder="Search docs" />
  73     <input type="hidden" name="check_keywords" value="yes" />
  74     <input type="hidden" name="area" value="default" />
  75   </form>
  76 </div>
  77
  78
  79         </div>
  80
  81         <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  82
  83
  84
  85
  86
  87
  88               <ul>
  89 <li class="toctree-l1"><a class="reference internal" href="libmemcached.html">Introduction</a></li>
  90 <li class="toctree-l1"><a class="reference internal" href="libmemcached/index.html">libmemcached API</a></li>
  91 <li class="toctree-l1"><a class="reference internal" href="libmemcachedutil/index.html">libmemcachedutil API</a></li>
  92 <li class="toctree-l1"><a class="reference internal" href="libhashkit/index.html">libhashkit API</a></li>
  93 <li class="toctree-l1"><a class="reference internal" href="bin/index.html">Client Applications</a></li>
  94 <li class="toctree-l1"><a class="reference internal" href="libmemcached/index_misc.html">Miscellaneous</a></li>
  95 </ul>
  96 <ul class="current">
  97 <li class="toctree-l1"><a class="reference internal" href="changelogs.html">Change Logs</a></li>
  98 <li class="toctree-l1 current"><a class="current reference internal" href="#">Known issues</a><ul>
  99 <li class="toctree-l2"><a class="reference internal" href="#libhashkit">libhashkit</a><ul>
 100 <li class="toctree-l3"><a class="reference internal" href="#murmur">MurMur</a></li>
 101 <li class="toctree-l3"><a class="reference internal" href="#crc32">crc32</a></li>
 102 </ul>
 103 </li>
 104 <li class="toctree-l2"><a class="reference internal" href="#libmemcached">libmemcached</a><ul>
 105 <li class="toctree-l3"><a class="reference internal" href="#replication">Replication</a></li>
 106 <li class="toctree-l3"><a class="reference internal" href="#tls-ssl">TLS/SSL</a></li>
 107 <li class="toctree-l3"><a class="reference internal" href="#coroutines-and-event-loops">Coroutines and event loops</a></li>
 108 <li class="toctree-l3"><a class="reference internal" href="#meta-protocol">META protocol</a></li>
 109 </ul>
 110 </li>
 111 </ul>
 112 </li>
 113 <li class="toctree-l1"><a class="reference internal" href="copyright.html">Copyright</a></li>
 114 </ul>
 115
 116
 117
 118         </div>
 119       </div>
 120     </nav>
 121
 122     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 123
 124
 125       <nav class="wy-nav-top" aria-label="top navigation">
 126
 127           <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 128           <a href="index.html">libmemcached-awesome</a>
 129
 130       </nav>
 131
 132
 133       <div class="wy-nav-content">
 134
 135         <div class="rst-content">
 136
 137
 138
 139
 140
 141
 142
 143
 144
 145
 146
 147
 148
 149
 150
 151
 152
 153 <div role="navigation" aria-label="breadcrumbs navigation">
 154
 155   <ul class="wy-breadcrumbs">
 156
 157       <li><a href="index.html">Docs</a> &raquo;</li>
 158
 159       <li>Bugs, Known Issues and Insufficiencies</li>
 160
 161
 162       <li class="wy-breadcrumbs-aside">
 163
 164
 165
 166               <a href="https://github.com/awesomized/libmemcached/blob/v1.x/docs/source/issues.rst" class="fa fa-github"> Edit on GitHub</a>
 167
 168
 169
 170       </li>
 171
 172   </ul>
 173
 174
 175   <hr/>
 176 </div>
 177           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 178            <div itemprop="articleBody">
 179
 180   <div class="section" id="bugs-known-issues-and-insufficiencies">
 181 <h1>Bugs, Known Issues and Insufficiencies<a class="headerlink" href="#bugs-known-issues-and-insufficiencies" title="Permalink to this headline">¶</a></h1>
 182 <div class="section" id="libhashkit">
 183 <h2>libhashkit<a class="headerlink" href="#libhashkit" title="Permalink to this headline">¶</a></h2>
 184 <p>libhashkit is not usable for general purpose hashing, because it is geared to
 185 usage by libmemcached.</p>
 186 <div class="section" id="murmur">
 187 <h3>MurMur<a class="headerlink" href="#murmur" title="Permalink to this headline">¶</a></h3>
 188 <p>Hashkit's MurMur/MurMur3 are limited to the lower 32 bits.</p>
 189 </div>
 190 <div class="section" id="crc32">
 191 <h3>crc32<a class="headerlink" href="#crc32" title="Permalink to this headline">¶</a></h3>
 192 <p>Commit &quot;<a class="reference external" href="https://github.com/awesomized/libmemcached/commits/1207354f">More Hashing methods</a>&quot;
 193 from October 2007 first released in v0.8, which main intention seems to have
 194 been to add FNV1 hash algos, changed the result of the crc32 hash to only its
 195 upper 16 bits sans MSB, without any additional comment.</p>
 196 <p>The implementations referred to in the file header (Postgres and BSD)
 197 do not exhibit this behavior.</p>
 198 <p>A <a class="reference external" href="https://bugs.launchpad.net/libmemcached/+bug/604178">bug report</a> was
 199 filed three years later on launchpad, which was marked <code class="docutils literal notranslate"><span class="pre">Won't</span> <span class="pre">fix</span></code> with
 200 the comment that it was for compatibility with other &quot;drivers&quot;, which
 201 supposedly refers to other memcached client libraries.</p>
 202 </div>
 203 </div>
 204 <div class="section" id="libmemcached">
 205 <h2>libmemcached<a class="headerlink" href="#libmemcached" title="Permalink to this headline">¶</a></h2>
 206 <div class="section" id="replication">
 207 <h3>Replication<a class="headerlink" href="#replication" title="Permalink to this headline">¶</a></h3>
 208 <p>This is a somewhat badly named feature, because it <strong>does not</strong> provide
 209 any of the guaranties one would expect from a proper replication.</p>
 210 <p>One can set the intended number of additional servers where data should
 211 be stored with the behavior <code class="docutils literal notranslate"><span class="pre">MEMCACHED_BEHAVIOR_NUMBER_OF_REPLICAS</span></code> and
 212 specify whether <code class="docutils literal notranslate"><span class="pre">MGET</span></code>s/<code class="docutils literal notranslate"><span class="pre">GET</span></code>s should read from a random server with
 213 <code class="docutils literal notranslate"><span class="pre">MEMCACHED_BEHAVIOR_RANDOMIZE_REPLICA_READ</span></code>. <code class="docutils literal notranslate"><span class="pre">DELETE</span></code>s will try to
 214 delete the key from all replicas.</p>
 215 <p>The binary protocol is required and any other command is unaffected.</p>
 216 </div>
 217 <div class="section" id="tls-ssl">
 218 <h3>TLS/SSL<a class="headerlink" href="#tls-ssl" title="Permalink to this headline">¶</a></h3>
 219 <p>libmemcached does not support TLS/SSL, yet.
 220 See <a class="reference external" href="https://github.com/awesomized/libmemcached/issues/37">github issue #37</a>.</p>
 221 </div>
 222 <div class="section" id="coroutines-and-event-loops">
 223 <h3>Coroutines and event loops<a class="headerlink" href="#coroutines-and-event-loops" title="Permalink to this headline">¶</a></h3>
 224 <p>libmemcached does not support explicit asynchronous usage, yet.
 225 See <a class="reference external" href="https://github.com/awesomized/libmemcached/issues/54">github issue #54</a>.</p>
 226 </div>
 227 <div class="section" id="meta-protocol">
 228 <h3>META protocol<a class="headerlink" href="#meta-protocol" title="Permalink to this headline">¶</a></h3>
 229 <p>libmemcached deos not support memcached's META protocol, yet.
 230 See <a class="reference external" href="https://github.com/awesomized/libmemcached/issues/121">github issue #121</a>.</p>
 231 </div>
 232 </div>
 233 </div>
 234
 235
 236            </div>
 237
 238           </div>
 239           <footer>
 240
 241     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 242
 243         <a href="copyright.html" class="btn btn-neutral float-right" title="Copyright" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 244
 245
 246         <a href="ChangeLog-0.html" class="btn btn-neutral float-left" title="ChangeLog v0.x" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 247
 248     </div>
 249
 250
 251   <hr/>
 252
 253   <div role="contentinfo">
 254     <p>
 255         &copy; <a href="copyright.html">Copyright</a>
 256
 257     </p>
 258   </div>
 259   Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 260
 261 </footer>
 262
 263         </div>
 264       </div>
 265
 266     </section>
 267
 268   </div>
 269
 270
 271
 272   <script type="text/javascript">
 273       jQuery(function () {
 274           SphinxRtdTheme.Navigation.enable(true);
 275       });
 276   </script>
 277
 278
 279
 280
 281
 282
 283 </body>
 284 </html>