Merge in local trunk
[awesomized/libmemcached] / docs / memcached_flush.rst
1 =====================================
2 Wiping clean the contents of a server
3 =====================================
4
5 .. index:: object: memcached_st
6
7 Wipe contents of memcached servers
8
9
10 --------
11 SYNOPSIS
12 --------
13
14
15 #include <libmemcached/memcached.h>
16
17 .. c:function:: memcached_return_t memcached_flush (memcached_st *ptr, time_t expiration);
18
19 Compile and link with -lmemcached
20
21
22 -----------
23 DESCRIPTION
24 -----------
25
26
27 memcached_flush() is used to wipe clean the contents of memcached(1) servers.
28 It will either do this immediately or expire the content based on the
29 expiration time passed to the method (a value of zero causes an immediate
30 flush). The operation is not atomic to multiple servers, just atomic to a
31 single server. That is, it will flush the servers in the order that they were
32 added.
33
34
35 ------
36 RETURN
37 ------
38
39
40 A value of type \ ``memcached_return_t``\ is returned
41 On success that value will be \ ``MEMCACHED_SUCCESS``\ .
42 Use memcached_strerror() to translate this value to a printable string.
43
44
45 ----
46 HOME
47 ----
48
49
50 To find out more information please check:
51 `http://libmemcached.org/ <http://libmemcached.org/>`_
52
53
54 ------
55 AUTHOR
56 ------
57
58
59 Brian Aker, <brian@tangent.org>
60
61
62 --------
63 SEE ALSO
64 --------
65
66 :manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`