memcached_create - libmemcached Documentation
#include <libmemcached/memcached.h> memcached_st memcached_st* memcached_create(memcached_st *ptr) void memcached_free(memcached_st *ptr) memcached_st* memcached_clone(memcached_st *destination, memcached_st *source) void memcached_servers_reset(memcached_st) Compile and link with -lmemcached
libmemcached MEMCACHED_CREATE(3libmemcached)
NAME
memcached_create - libmemcached Documentation
SYNOPSIS
#include <libmemcached/memcached.h>
memcached_st
memcached_st* memcached_create(memcached_st *ptr)
void memcached_free(memcached_st *ptr)
memcached_st* memcached_clone(memcached_st *destination,
memcached_st *source)
void memcached_servers_reset(memcached_st)
Compile and link with -lmemcached
DESCRIPTION
memcached_create() is used to create a memcached_st structure that will
then be used by other libmemcached(3) functions to communicate with the
server. You should either pass a statically declared memcached_st to
memcached_create() or a NULL. If a NULL passed in then a structure is
allocated for you.
Please note, when you write new application use memcached() over
memcached_create().
memcached_clone() is similar to memcached_create() but it copies the
defaults and list of servers from the source memcached_st. If you pass
a null as the argument for the source to clone, it is the same as a
call to memcached_create(). If the destination argument is NULL a
memcached_st will be allocated for you.
memcached_servers_reset() allows you to zero out the list of servers
that the memcached_st has.
To clean up memory associated with a memcached_st structure you should
pass it to memcached_free() when you are finished using it.
memcached_free() is the only way to make sure all memory is deallocated
when you finish using the structure.
You may wish to avoid using memcached_create(3) or memcached_clone(3)
with a stack based allocation. The most common issues related to ABI
safety involve heap allocated structures.
RETURN
memcached_create() returns a pointer to the memcached_st that was cre-
ated (or initialized). On an allocation failure, it returns NULL.
memcached_clone() returns a pointer to the memcached_st that was cre-
ated (or initialized). On an allocation failure, it returns NULL.
HOME
To find out more information please check: http://libmemcached.org/
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | library/libmemcached |
+---------------+----------------------+
|Stability | Uncommitted |
+---------------+----------------------+
SEE ALSO
memcached(1) libmemcached(3) memcached_strerror(3)
AUTHOR
Brian Aker
COPYRIGHT
2011-2013, Brian Aker DataDifferential, http://datadifferential.com/
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://launchpad.net/libmem-
cached/1.0/1.0.18/+download/libmemcached-1.0.18.tar.gz.
Further information about this software can be found on the open source
community website at http://libmemcached.org/libMemcached.html.
1.0.18 February 09, 2014
MEMCACHED_CREATE(3libmemcached)