4 <html class=
"writer-html5" lang=
"en" >
8 <meta name=
"viewport" content=
"width=device-width, initial-scale=1.0">
10 <title>memcp
— libmemcached
1.0.99 documentation
</title>
14 <link rel=
"stylesheet" href=
"../_static/css/theme.css" type=
"text/css" />
15 <link rel=
"stylesheet" href=
"../_static/pygments.css" type=
"text/css" />
24 <script src="../_static/js/html5shiv.min.js"></script>
28 <script type=
"text/javascript" id=
"documentation_options" data-url_root=
"../" src=
"../_static/documentation_options.js"></script>
29 <script src=
"../_static/jquery.js"></script>
30 <script src=
"../_static/underscore.js"></script>
31 <script src=
"../_static/doctools.js"></script>
32 <script src=
"../_static/language_data.js"></script>
34 <script type=
"text/javascript" src=
"../_static/js/theme.js"></script>
37 <link rel=
"index" title=
"Index" href=
"../genindex.html" />
38 <link rel=
"search" title=
"Search" href=
"../search.html" />
39 <link rel=
"copyright" title=
"Copyright" href=
"../copyright.html" />
40 <link rel=
"next" title=
"memtouch" href=
"memtouch.html" />
41 <link rel=
"prev" title=
"memcat" href=
"memcat.html" />
44 <body class=
"wy-body-for-nav">
47 <div class=
"wy-grid-for-nav">
49 <nav data-toggle=
"wy-nav-shift" class=
"wy-nav-side">
50 <div class=
"wy-side-scroll">
51 <div class=
"wy-side-nav-search" >
55 <a href=
"../index.html" class=
"icon icon-home" alt=
"Documentation Home"> libmemcached
72 <form id=
"rtd-search-form" class=
"wy-form" action=
"../search.html" method=
"get">
73 <input type=
"text" name=
"q" placeholder=
"Search docs" />
74 <input type=
"hidden" name=
"check_keywords" value=
"yes" />
75 <input type=
"hidden" name=
"area" value=
"default" />
83 <div class=
"wy-menu wy-menu-vertical" data-spy=
"affix" role=
"navigation" aria-label=
"main navigation">
90 <p class=
"caption"><span class=
"caption-text">libmemcached
</span></p>
92 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached.html">Introduction
</a></li>
93 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index.html">libmemcached API
</a></li>
94 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index_misc.html">Misc
</a></li>
96 <p class=
"caption"><span class=
"caption-text">libmemcachedutil
</span></p>
98 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil.html">Introduction
</a></li>
99 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil/index.html">libmemcachedutil API
</a></li>
101 <p class=
"caption"><span class=
"caption-text">libhashkit
</span></p>
103 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit.html">Introduction
</a></li>
104 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit/index.html">libhashkit API
</a></li>
106 <p class=
"caption"><span class=
"caption-text">Client Applications
</span></p>
108 <li class=
"toctree-l1 current"><a class=
"reference internal" href=
"index.html">Client Applications
</a><ul class=
"current">
109 <li class=
"toctree-l2 current"><a class=
"reference internal" href=
"index.html#data-manipulation">Data Manipulation
</a><ul class=
"current">
110 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memexist.html">memexist — Check for the existence of a key
</a></li>
111 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memcat.html">memcat —
"cat
" data from a server
</a></li>
112 <li class=
"toctree-l3 current"><a class=
"current reference internal" href=
"#">memcp —
"cp
" files to a server
</a><ul>
113 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#synopsis">SYNOPSIS
</a></li>
114 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#description">DESCRIPTION
</a></li>
115 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#options">OPTIONS
</a></li>
116 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#environment">ENVIRONMENT
</a></li>
117 <li class=
"toctree-l4"><a class=
"reference internal" href=
"#see-also">SEE ALSO
</a></li>
120 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memtouch.html">memtouch —
"touch
" a key
</a></li>
121 <li class=
"toctree-l3"><a class=
"reference internal" href=
"memrm.html">memrm –
"rm
" a key
</a></li>
124 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#tests-and-analysis">Tests and Analysis
</a></li>
125 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index.html#server-administration">Server Administration
</a></li>
129 <p class=
"caption"><span class=
"caption-text">Copyright
</span></p>
131 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
141 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
144 <nav class=
"wy-nav-top" aria-label=
"top navigation">
146 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
147 <a href=
"../index.html">libmemcached
</a>
152 <div class=
"wy-nav-content">
154 <div class=
"rst-content">
172 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
174 <ul class=
"wy-breadcrumbs">
176 <li><a href=
"../index.html" class=
"icon icon-home"></a> »</li>
178 <li><a href=
"index.html">Client Applications
</a> »</li>
183 <li class=
"wy-breadcrumbs-aside">
194 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
195 <div itemprop=
"articleBody">
197 <div class=
"section" id=
"memcp">
198 <h1>memcp
<a class=
"headerlink" href=
"#memcp" title=
"Permalink to this headline">¶
</a></h1>
199 <div class=
"section" id=
"synopsis">
200 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
201 <p>memcp [options] --servers
<hostname[:port]...
> <file...
></p>
202 <p>Copy files to a collection of memcached servers.
</p>
204 <div class=
"section" id=
"description">
205 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
206 <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.
207 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>
208 <p>The key names will be the names of the files, without any directory path.
</p>
210 <div class=
"section" id=
"options">
211 <h2>OPTIONS
<a class=
"headerlink" href=
"#options" title=
"Permalink to this headline">¶
</a></h2>
212 <dl class=
"std option">
213 <dt id=
"cmdoption-memcp-help">
214 <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>
215 <dd><p>Display help.
</p>
218 <dl class=
"std option">
219 <dt id=
"cmdoption-memcp-version">
220 <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>
221 <dd><p>Display version.
</p>
224 <dl class=
"std option">
225 <dt id=
"cmdoption-memcp-quiet">
226 <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>
227 <dd><p>Operate quietly.
</p>
230 <dl class=
"std option">
231 <dt id=
"cmdoption-memcp-verbose">
232 <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>
233 <dd><p>Operate more verbosely.
</p>
236 <dl class=
"std option">
237 <dt id=
"cmdoption-memcp-debug">
238 <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>
239 <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>
242 <dl class=
"std option">
243 <dt id=
"cmdoption-memcp-servers">
244 <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>
245 <dd><p>Specify the list of servers as
<em>hostname[:port][,hostname[:port]...]
</em>.
</p>
248 <dl class=
"std option">
249 <dt id=
"cmdoption-memcp-binary">
250 <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>
251 <dd><p>Enable binary protocol.
</p>
254 <dl class=
"std option">
255 <dt id=
"cmdoption-memcp-expire">
256 <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>
257 <dd><p>Use
<em>expiration
</em> seconds (or a UNIX timestamp).
</p>
260 <dl class=
"std option">
261 <dt id=
"cmdoption-memcp-flag">
262 <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>
263 <dd><p>Use
<em>number
</em> as flag.
</p>
266 <dl class=
"std option">
267 <dt id=
"cmdoption-memcp-hash">
268 <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>
269 <dd><p>Use
<em>algorithm
</em> as key hash algo.
270 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>
273 <dl class=
"std option">
274 <dt id=
"cmdoption-memcp-username">
275 <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>
276 <dd><p>Use
<em>username
</em> for SASL authentication.
</p>
279 <dl class=
"std option">
280 <dt id=
"cmdoption-memcp-password">
281 <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>
282 <dd><p>Use
<em>password
</em> for SASL authentication.
</p>
285 <dl class=
"std option">
286 <dt id=
"cmdoption-memcp-udp">
287 <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>
288 <dd><p>Enable UDP operation mode.
</p>
291 <dl class=
"std option">
292 <dt id=
"cmdoption-memcp-buffer">
293 <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>
294 <dd><p>Enable internal buffering of commands.
</p>
297 <dl class=
"std option">
298 <dt id=
"cmdoption-memcp-set">
299 <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>
300 <dd><p>Issue
<em>SET
</em> command(s). This is the default mode.
301 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>
304 <dl class=
"std option">
305 <dt id=
"cmdoption-memcp-add">
306 <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>
307 <dd><p>Issue
<em>ADD
</em> command(s).
</p>
310 <dl class=
"std option">
311 <dt id=
"cmdoption-memcp-replace">
312 <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>
313 <dd><p>Issue
<em>REPLACE
</em> command(s).
</p>
317 <div class=
"section" id=
"environment">
318 <h2>ENVIRONMENT
<a class=
"headerlink" href=
"#environment" title=
"Permalink to this headline">¶
</a></h2>
319 <dl class=
"std envvar">
320 <dt id=
"envvar-MEMCACHED_SERVERS">
321 <code class=
"sig-name descname">MEMCACHED_SERVERS
</code><a class=
"headerlink" href=
"#envvar-MEMCACHED_SERVERS" title=
"Permalink to this definition">¶
</a></dt>
322 <dd><p>Specify the list of servers.
</p>
326 <div class=
"section" id=
"see-also">
327 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
329 <li><p><a class=
"reference internal" href=
"../libmemcached.html"><span class=
"doc">C/C++ Client Library for memcached
</span></a></p></li>
330 <li><p><a class=
"reference internal" href=
"../libmemcached/configuration.html"><span class=
"doc">libmemcached Configuration
</span></a></p></li>
331 <li><p><a class=
"reference internal" href=
"../libmemcached/memcached_behavior.html"><span class=
"doc">Behaviors of the library
</span></a></p></li>
342 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
344 <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>
347 <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>
354 <div role=
"contentinfo">
358 © <a href=
"../copyright.html">Copyright
</a>
365 Built with
<a href=
"http://sphinx-doc.org/">Sphinx
</a> using a
367 <a href=
"https://github.com/rtfd/sphinx_rtd_theme">theme
</a>
369 provided by
<a href=
"https://readthedocs.org">Read the Docs
</a>.
381 <script type=
"text/javascript">
383 SphinxRtdTheme.Navigation.enable(true);