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]-->
9 <meta name=
"viewport" content=
"width=device-width, initial-scale=1.0">
11 <title>memflush
— libmemcached
1.0.99 documentation
</title>
20 <script type=
"text/javascript" src=
"../_static/js/modernizr.min.js"></script>
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>
29 <script type=
"text/javascript" src=
"../_static/js/theme.js"></script>
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=
"memdump" href=
"memdump.html" />
43 <body class=
"wy-body-for-nav">
46 <div class=
"wy-grid-for-nav">
48 <nav data-toggle=
"wy-nav-shift" class=
"wy-nav-side">
49 <div class=
"wy-side-scroll">
50 <div class=
"wy-side-nav-search" >
54 <a href=
"../index.html" class=
"icon icon-home"> libmemcached
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" />
81 <div class=
"wy-menu wy-menu-vertical" data-spy=
"affix" role=
"navigation" aria-label=
"main navigation">
88 <p class=
"caption"><span class=
"caption-text">libmemcached
</span></p>
90 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached.html">Introduction
</a></li>
91 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index.html">libmemcached API
</a></li>
92 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index_misc.html">Misc
</a></li>
94 <p class=
"caption"><span class=
"caption-text">libmemcachedutil
</span></p>
96 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil.html">Introduction
</a></li>
97 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil/index.html">libmemcachedutil API
</a></li>
99 <p class=
"caption"><span class=
"caption-text">libhashkit
</span></p>
101 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit.html">Introduction
</a></li>
102 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit/index.html">libhashkit API
</a></li>
104 <p class=
"caption"><span class=
"caption-text">Client Applications
</span></p>
106 <li class=
"toctree-l1 current"><a class=
"reference internal" href=
"index.html">Client Applications
</a><ul class=
"current">
107 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#data-manipulation">Data Manipulation
</a></li>
108 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#tests-and-analysis">Tests and Analysis
</a></li>
109 <li class=
"toctree-l2 current"><a class=
"reference internal" href=
"index.html#server-administration">Server Administration
</a><ul class=
"current">
110 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memdump.html">memdump — Dump a server's data
</a></li>
111 <li class=
"toctree-l3 current"><a class=
"current reference internal" href=
"#">memflush — Flush a server (erase all cached data)
</a><ul>
112 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#synopsis">SYNOPSIS
</a></li>
113 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#description">DESCRIPTION
</a></li>
114 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#options">OPTIONS
</a></li>
115 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#environment">ENVIRONMENT
</a></li>
116 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#see-also">SEE ALSO
</a></li>
124 <p class=
"caption"><span class=
"caption-text">Copyright
</span></p>
126 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
135 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
138 <nav class=
"wy-nav-top" aria-label=
"top navigation">
140 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
141 <a href=
"../index.html">libmemcached
</a>
146 <div class=
"wy-nav-content">
148 <div class=
"rst-content">
166 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
168 <ul class=
"wy-breadcrumbs">
170 <li><a href=
"../index.html">Docs
</a> »</li>
172 <li><a href=
"index.html">Client Applications
</a> »</li>
177 <li class=
"wy-breadcrumbs-aside">
188 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
189 <div itemprop=
"articleBody">
191 <div class=
"section" id=
"memflush">
192 <h1>memflush
<a class=
"headerlink" href=
"#memflush" title=
"Permalink to this headline">¶
</a></h1>
193 <div class=
"section" id=
"synopsis">
194 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
195 <p>memflush [options]
</p>
196 <p>Reset a server or list of servers
</p>
198 <div class=
"section" id=
"description">
199 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
200 <p><strong class=
"program">memflush
</strong> resets the contents of
<em class=
"manpage"><a class=
"manpage reference external" href=
"https://linux.die.net/man/1/memcached">memcached(
1)
</a></em> servers.
</p>
201 <div class=
"admonition warning">
202 <p class=
"first admonition-title">Warning
</p>
203 <p class=
"last">This means that all data in the specified servers will be deleted.
</p>
206 <div class=
"section" id=
"options">
207 <h2>OPTIONS
<a class=
"headerlink" href=
"#options" title=
"Permalink to this headline">¶
</a></h2>
209 <dt id=
"cmdoption-memflush-help">
210 <code class=
"descname">--help
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-help" title=
"Permalink to this definition">¶
</a></dt>
211 <dd><p>Display help.
</p>
215 <dt id=
"cmdoption-memflush-version">
216 <code class=
"descname">--version
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-version" title=
"Permalink to this definition">¶
</a></dt>
217 <dd><p>Display version.
</p>
221 <dt id=
"cmdoption-memflush-quiet">
222 <code class=
"descname">--quiet
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-quiet" title=
"Permalink to this definition">¶
</a></dt>
223 <dd><p>Operate quietly.
</p>
227 <dt id=
"cmdoption-memflush-verbose">
228 <code class=
"descname">--verbose
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-verbose" title=
"Permalink to this definition">¶
</a></dt>
229 <dd><p>Operate more verbosely.
</p>
233 <dt id=
"cmdoption-memflush-debug">
234 <code class=
"descname">--debug
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-debug" title=
"Permalink to this definition">¶
</a></dt>
235 <dd><p>See
<a class=
"reference internal" href=
"#cmdoption-memflush-verbose"><code class=
"xref std std-option docutils literal notranslate"><span class=
"pre">--verbose
</span></code></a>.
</p>
239 <dt id=
"cmdoption-memflush-servers">
240 <code class=
"descname">--servers
</code><code class=
"descclassname"> <list of servers
></code><a class=
"headerlink" href=
"#cmdoption-memflush-servers" title=
"Permalink to this definition">¶
</a></dt>
241 <dd><p>Specify the list of servers as
<em>hostname[:port][,hostname[:port]...]
</em>.
</p>
245 <dt id=
"cmdoption-memflush-binary">
246 <code class=
"descname">--binary
</code><code class=
"descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memflush-binary" title=
"Permalink to this definition">¶
</a></dt>
247 <dd><p>Enable binary protocol.
</p>
251 <dt id=
"cmdoption-memflush-username">
252 <code class=
"descname">--username
</code><code class=
"descclassname"> <username
></code><a class=
"headerlink" href=
"#cmdoption-memflush-username" title=
"Permalink to this definition">¶
</a></dt>
253 <dd><p>Use
<em>username
</em> for SASL authentication.
</p>
257 <dt id=
"cmdoption-memflush-password">
258 <code class=
"descname">--password
</code><code class=
"descclassname"> <password
></code><a class=
"headerlink" href=
"#cmdoption-memflush-password" title=
"Permalink to this definition">¶
</a></dt>
259 <dd><p>Use
<em>password
</em> for SASL authentication.
</p>
263 <dt id=
"cmdoption-memflush-expire">
264 <code class=
"descname">--expire
</code><code class=
"descclassname"> <expiration
></code><a class=
"headerlink" href=
"#cmdoption-memflush-expire" title=
"Permalink to this definition">¶
</a></dt>
265 <dd><p>Use
<em>expiration
</em> seconds (or a UNIX timestamp).
</p>
268 <div class=
"admonition note">
269 <p class=
"first admonition-title">Note
</p>
270 <p>Using an expiration time (period), all keys, which have not bean updated until expiration will cease to exist.
</p>
271 <p>Quoting the
<a class=
"reference external" href=
"https://github.com/memcached/memcached/blob/master/doc/protocol.txt">memcached protocol documentation
</a>, it states:
</p>
272 <blockquote class=
"last">
273 <div><p>Its effect is to invalidate all
274 existing items immediately (by default) or after the expiration
275 specified. After invalidation none of the items will be returned in
276 response to a retrieval command (unless it's stored again under the
277 same key
<em>after
</em> flush_all has invalidated the items).
</p>
279 definition of what flush_all does is the following: it causes all
280 items whose update time is earlier than the time at which flush_all
281 was set to be executed to be ignored for retrieval purposes.
</p>
282 <p>The intent of flush_all with a delay, was that in a setting where you
283 have a pool of memcached servers, and you need to flush all content,
284 you have the option of not resetting all memcached servers at the
285 same time (which could e.g. cause a spike in database load with all
286 clients suddenly needing to recreate content that would otherwise
287 have been found in the memcached daemon).
</p>
291 <div class=
"section" id=
"environment">
292 <h2>ENVIRONMENT
<a class=
"headerlink" href=
"#environment" title=
"Permalink to this headline">¶
</a></h2>
294 <dt id=
"envvar-MEMCACHED_SERVERS">
295 <code class=
"descname">MEMCACHED_SERVERS
</code><a class=
"headerlink" href=
"#envvar-MEMCACHED_SERVERS" title=
"Permalink to this definition">¶
</a></dt>
296 <dd><p>Specify the list of servers.
</p>
300 <div class=
"section" id=
"see-also">
301 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
303 <li><a class=
"reference internal" href=
"../libmemcached.html"><span class=
"doc">C/C++ Client Library for memcached
</span></a></li>
304 <li><a class=
"reference internal" href=
"../libmemcached/memcached_flush.html"><span class=
"doc">Wiping clean the contents of a server
</span></a></li>
315 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
317 <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>
320 <a href=
"memdump.html" class=
"btn btn-neutral float-left" title=
"memdump" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
327 <div role=
"contentinfo">
329 © <a href=
"../copyright.html">Copyright
</a>
333 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>.
346 <script type=
"text/javascript">
348 SphinxRtdTheme.Navigation.enable(true);