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>memcp
— 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 src=
"../_static/jquery.js"></script>
25 <script src=
"../_static/underscore.js"></script>
26 <script src=
"../_static/doctools.js"></script>
27 <script 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=
"memtouch" href=
"memtouch.html" />
40 <link rel=
"prev" title=
"memcat" href=
"memcat.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 current"><a class=
"reference internal" href=
"index.html#data-manipulation">Data Manipulation
</a><ul class=
"current">
108 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memexist.html">memexist — Check for the existence of a key
</a></li>
109 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memcat.html">memcat —
"cat
" data from a server
</a></li>
110 <li class=
"toctree-l3 current"><a class=
"current reference internal" href=
"#">memcp —
"cp
" files to a server
</a><ul>
111 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#synopsis">SYNOPSIS
</a></li>
112 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#description">DESCRIPTION
</a></li>
113 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#options">OPTIONS
</a></li>
114 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#environment">ENVIRONMENT
</a></li>
115 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#see-also">SEE ALSO
</a></li>
118 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memtouch.html">memtouch —
"touch
" a key
</a></li>
119 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memrm.html">memrm –
"rm
" a key
</a></li>
122 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#tests-and-analysis">Tests and Analysis
</a></li>
123 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#server-administration">Server Administration
</a></li>
127 <p class=
"caption"><span class=
"caption-text">Copyright
</span></p>
129 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
138 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
141 <nav class=
"wy-nav-top" aria-label=
"top navigation">
143 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
144 <a href=
"../index.html">libmemcached
</a>
149 <div class=
"wy-nav-content">
151 <div class=
"rst-content">
169 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
171 <ul class=
"wy-breadcrumbs">
173 <li><a href=
"../index.html">Docs
</a> »</li>
175 <li><a href=
"index.html">Client Applications
</a> »</li>
180 <li class=
"wy-breadcrumbs-aside">
191 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
192 <div itemprop=
"articleBody">
194 <div class=
"section" id=
"memcp">
195 <h1>memcp
<a class=
"headerlink" href=
"#memcp" title=
"Permalink to this headline">¶
</a></h1>
196 <div class=
"section" id=
"synopsis">
197 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
198 <p>memcp [options] --servers
<hostname[:port]...
> <file...
></p>
199 <p>Copy files to a collection of memcached servers.
</p>
201 <div class=
"section" id=
"description">
202 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
203 <p><strong class=
"program">memcp
</strong> copies one or more files into
<em class=
"manpage"><a class=
"manpage reference external" href=
"https://linux.die.net/man/1/memcached">memcached(
1)
</a></em> servers.
204 It is similar to the standard UNIX
<em class=
"manpage"><a class=
"manpage reference external" href=
"https://linux.die.net/man/1/cp">cp(
1)
</a></em> command.
</p>
205 <p>The key names will be the names of the files, without any directory path.
</p>
207 <div class=
"section" id=
"options">
208 <h2>OPTIONS
<a class=
"headerlink" href=
"#options" title=
"Permalink to this headline">¶
</a></h2>
209 <dl class=
"std option">
210 <dt id=
"cmdoption-memcp-help">
211 <code class=
"sig-name descname">--help
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-help" title=
"Permalink to this definition">¶
</a></dt>
212 <dd><p>Display help.
</p>
215 <dl class=
"std option">
216 <dt id=
"cmdoption-memcp-version">
217 <code class=
"sig-name descname">--version
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-version" title=
"Permalink to this definition">¶
</a></dt>
218 <dd><p>Display version.
</p>
221 <dl class=
"std option">
222 <dt id=
"cmdoption-memcp-quiet">
223 <code class=
"sig-name descname">--quiet
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-quiet" title=
"Permalink to this definition">¶
</a></dt>
224 <dd><p>Operate quietly.
</p>
227 <dl class=
"std option">
228 <dt id=
"cmdoption-memcp-verbose">
229 <code class=
"sig-name descname">--verbose
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-verbose" title=
"Permalink to this definition">¶
</a></dt>
230 <dd><p>Operate more verbosely.
</p>
233 <dl class=
"std option">
234 <dt id=
"cmdoption-memcp-debug">
235 <code class=
"sig-name descname">--debug
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-debug" title=
"Permalink to this definition">¶
</a></dt>
236 <dd><p>See
<a class=
"reference internal" href=
"#cmdoption-memcp-verbose"><code class=
"xref std std-option docutils literal notranslate"><span class=
"pre">--verbose
</span></code></a>.
</p>
239 <dl class=
"std option">
240 <dt id=
"cmdoption-memcp-servers">
241 <code class=
"sig-name descname">--servers
</code><code class=
"sig-prename descclassname"> <list of servers
></code><a class=
"headerlink" href=
"#cmdoption-memcp-servers" title=
"Permalink to this definition">¶
</a></dt>
242 <dd><p>Specify the list of servers as
<em>hostname[:port][,hostname[:port]...]
</em>.
</p>
245 <dl class=
"std option">
246 <dt id=
"cmdoption-memcp-binary">
247 <code class=
"sig-name descname">--binary
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-binary" title=
"Permalink to this definition">¶
</a></dt>
248 <dd><p>Enable binary protocol.
</p>
251 <dl class=
"std option">
252 <dt id=
"cmdoption-memcp-expire">
253 <code class=
"sig-name descname">--expire
</code><code class=
"sig-prename descclassname"> <expiration
></code><a class=
"headerlink" href=
"#cmdoption-memcp-expire" title=
"Permalink to this definition">¶
</a></dt>
254 <dd><p>Use
<em>expiration
</em> seconds (or a UNIX timestamp).
</p>
257 <dl class=
"std option">
258 <dt id=
"cmdoption-memcp-flag">
259 <code class=
"sig-name descname">--flag
</code><code class=
"sig-prename descclassname"> <number
></code><a class=
"headerlink" href=
"#cmdoption-memcp-flag" title=
"Permalink to this definition">¶
</a></dt>
260 <dd><p>Use
<em>number
</em> as flag.
</p>
263 <dl class=
"std option">
264 <dt id=
"cmdoption-memcp-hash">
265 <code class=
"sig-name descname">--hash
</code><code class=
"sig-prename descclassname"> <algorithm
></code><a class=
"headerlink" href=
"#cmdoption-memcp-hash" title=
"Permalink to this definition">¶
</a></dt>
266 <dd><p>Use
<em>algorithm
</em> as key hash algo.
267 See
<a class=
"reference internal" href=
"../libmemcached/memcached_behavior.html#_CPPv4N20memcached_behavior_t23MEMCACHED_BEHAVIOR_HASHE" title=
"memcached_behavior_t::MEMCACHED_BEHAVIOR_HASH"><code class=
"xref cpp cpp-enumerator docutils literal notranslate"><span class=
"pre">memcached_behavior_t::MEMCACHED_BEHAVIOR_HASH
</span></code></a>.
</p>
270 <dl class=
"std option">
271 <dt id=
"cmdoption-memcp-username">
272 <code class=
"sig-name descname">--username
</code><code class=
"sig-prename descclassname"> <username
></code><a class=
"headerlink" href=
"#cmdoption-memcp-username" title=
"Permalink to this definition">¶
</a></dt>
273 <dd><p>Use
<em>username
</em> for SASL authentication.
</p>
276 <dl class=
"std option">
277 <dt id=
"cmdoption-memcp-password">
278 <code class=
"sig-name descname">--password
</code><code class=
"sig-prename descclassname"> <password
></code><a class=
"headerlink" href=
"#cmdoption-memcp-password" title=
"Permalink to this definition">¶
</a></dt>
279 <dd><p>Use
<em>password
</em> for SASL authentication.
</p>
282 <dl class=
"std option">
283 <dt id=
"cmdoption-memcp-udp">
284 <code class=
"sig-name descname">--udp
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-udp" title=
"Permalink to this definition">¶
</a></dt>
285 <dd><p>Enable UDP operation mode.
</p>
288 <dl class=
"std option">
289 <dt id=
"cmdoption-memcp-buffer">
290 <code class=
"sig-name descname">--buffer
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-buffer" title=
"Permalink to this definition">¶
</a></dt>
291 <dd><p>Enable internal buffering of commands.
</p>
294 <dl class=
"std option">
295 <dt id=
"cmdoption-memcp-set">
296 <code class=
"sig-name descname">--set
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-set" title=
"Permalink to this definition">¶
</a></dt>
297 <dd><p>Issue
<em>SET
</em> command(s). This is the default mode.
298 See also
<a class=
"reference internal" href=
"#cmdoption-memcp-add"><code class=
"xref std std-option docutils literal notranslate"><span class=
"pre">--add
</span></code></a> and
<a class=
"reference internal" href=
"#cmdoption-memcp-replace"><code class=
"xref std std-option docutils literal notranslate"><span class=
"pre">--replace
</span></code></a>.
</p>
301 <dl class=
"std option">
302 <dt id=
"cmdoption-memcp-add">
303 <code class=
"sig-name descname">--add
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-add" title=
"Permalink to this definition">¶
</a></dt>
304 <dd><p>Issue
<em>ADD
</em> command(s).
</p>
307 <dl class=
"std option">
308 <dt id=
"cmdoption-memcp-replace">
309 <code class=
"sig-name descname">--replace
</code><code class=
"sig-prename descclassname"></code><a class=
"headerlink" href=
"#cmdoption-memcp-replace" title=
"Permalink to this definition">¶
</a></dt>
310 <dd><p>Issue
<em>REPLACE
</em> command(s).
</p>
314 <div class=
"section" id=
"environment">
315 <h2>ENVIRONMENT
<a class=
"headerlink" href=
"#environment" title=
"Permalink to this headline">¶
</a></h2>
316 <dl class=
"std envvar">
317 <dt id=
"envvar-MEMCACHED_SERVERS">
318 <code class=
"sig-name descname">MEMCACHED_SERVERS
</code><a class=
"headerlink" href=
"#envvar-MEMCACHED_SERVERS" title=
"Permalink to this definition">¶
</a></dt>
319 <dd><p>Specify the list of servers.
</p>
323 <div class=
"section" id=
"see-also">
324 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
326 <li><p><a class=
"reference internal" href=
"../libmemcached.html"><span class=
"doc">C/C++ Client Library for memcached
</span></a></p></li>
327 <li><p><a class=
"reference internal" href=
"../libmemcached/configuration.html"><span class=
"doc">libmemcached Configuration
</span></a></p></li>
328 <li><p><a class=
"reference internal" href=
"../libmemcached/memcached_behavior.html"><span class=
"doc">Behaviors of the library
</span></a></p></li>
339 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
341 <a href=
"memtouch.html" class=
"btn btn-neutral float-right" title=
"memtouch" accesskey=
"n" rel=
"next">Next
<span class=
"fa fa-arrow-circle-right"></span></a>
344 <a href=
"memcat.html" class=
"btn btn-neutral float-left" title=
"memcat" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
351 <div role=
"contentinfo">
353 © <a href=
"../copyright.html">Copyright
</a>
357 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>.
370 <script type=
"text/javascript">
372 SphinxRtdTheme.Navigation.enable(true);