libmemcached_examples(3) [centos man page]

LIBMEMCACHED_EXAMPLES(3)					   libmemcached 					  LIBMEMCACHED_EXAMPLES(3)

NAME

       libmemcached_examples - libmemcached Documentation

       Examples for libmemcached

DESCRIPTION

       For  full examples, test cases are found in tests/*.c in the main distribution. These are always up to date, and are used for each test run
       of the library.

CONNECTING TO SERVERS

	  const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com"
	  memcached_st *memc= memcached(config_string, strlen(config_string);
	  {
	  ...
	  }
	   memcached_free(memc);

       In the above code you create a memcached_st object with three server by making use of memcached_create().

CREATING A POOL OF SERVERS

       Creating a pool of Servers:

	  const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com";

	  memcached_pool_st* pool= memcached_pool(config_string, strlen(config_string));

	  memcached_return_t rc;

	  memcached_st *memc= memcached_pool_pop(pool, false, &rc);

	  .... do work

	  /*
	    Release the memc_ptr that was pulled from the pool
	  */
	  memcached_pool_push(pool, memc);

	  /*
	    Destroy the pool.
	  */
	  memcached_pool_destroy(pool);

       In the above code you create a memcached_pool_st object with three server by making use of memcached_pool().

       When memcached_pool_destroy() all memory will be released that is associated with the pool.

ADDING A VALUE TO THE SERVER

       Adding a value to the Server:

	  char *key= "foo";
	  char *value= "value";

	  memcached_return_t rc= memcached_set(memc, key, strlen(key), value, value_length, (time_t)0, (uint32_t)0);

	  if (rc != MEMCACHED_SUCCESS)
	  {
	  ... // handle failure
	  }

       It is best practice to always look at the return value of any operation.

FETCHING MULTIPLE VALUES

	  memcached_return_t rc;
	  char *keys[]= {"fudge", "son", "food"};
	  size_t key_length[]= {5, 3, 4};
	  unsigned int x;
	  uint32_t flags;

	  char return_key[MEMCACHED_MAX_KEY];
	  size_t return_key_length;
	  char *return_value;
	  size_t return_value_length;

	  rc= memcached_mget(memc, keys, key_length, 3);

	  x= 0;
	  while ((return_value= memcached_fetch(memc, return_key, &return_key_length,
						&return_value_length, &flags, &rc)))
	  {
	    free(return_value);
	    x++;
	  }

       Notice that you freed values returned from memcached_fetch(). The define MEMCACHED_MAX_KEY is provided for usage.

HOME

       To find out more information please check: http://libmemcached.org/

SEE ALSO

       memcached(1)

AUTHOR

       Brian Aker

COPYRIGHT

       2011-2013, Brian Aker DataDifferential, http://datadifferential.com/

1.0.16								 January 31, 2013					  LIBMEMCACHED_EXAMPLES(3)

MEMCACHED(3)							   libmemcached 						      MEMCACHED(3)

NAME

       memcached - libmemcached Documentation

SYNOPSIS

       #include <libmemcached-1.0/memcached.h>

       LIBMEMCACHED

       memcached_st *memcached(const char *string, size_t string_length)

       memcached_return_t libmemcached_check_configuration(const char *option_string, size_t length, char *error_buffer, size_t error_buffer_size)

       Compile and link with -lmemcached

DESCRIPTION

       Libmemcached  implements  a  custom  language for configuring and modifying servers. By passing in an option string you can generate a mem-
       cached_st object that you can use in your application directly.

       --SERVER=<servername>:<optional_port>/?<optional_weight>

       Provide a servername to be used by the client. Providing a weight will cause weighting to occur with all hosts with each server	getting  a
       default weight of 1.

       --SOCKET="<filepath>/?<optional_weight>"

       Provide	a  filepath  to  a  UNIX  socket  file. Providing a weight will cause weighting to occur with all hosts with each server getting a
       default weight of 1.

       --VERIFY-KEY

       Verify that keys that are being used fit within the design of the protocol being used.

       --REMOVE_FAILED_SERVERS

       Enable the behavior MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS.

       --BINARY-PROTOCOL

       Force all connections to use the binary protocol.

       --BUFFER-REQUESTS

       Please see MEMCACHED_BEHAVIOR_BUFFER_REQUESTS.

       --CONFIGURE-FILE=

       Provide a configuration file to be used to load requests. Beware that by using a configuration file libmemcached  will  reset  memcached_st
       based on information only contained in the file.

       --CONNECT-TIMEOUT=

       Please see MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT.

       --DISTRIBUTION=

       Set the distribution model used by the client.  See :manpage:`` for more details.

       --HASH=

       Set the hashing alogrthm used for placing keys on servers.

       --HASH-WITH-NAMESPACE

       When enabled the prefix key will be added to the key when determining which server to store the data in.

       --NOREPLY

       Enable "no reply" for all calls that support this. It is highly recommended that you use this option with the binary protocol only.

       --NUMBER-OF-REPLICAS=

       Set the nummber of servers that keys will be replicated to.

       --RANDOMIZE-REPLICA-READ

       Select randomly the server within the replication pool to read from.

       --SORT-HOSTS

       When adding new servers always calculate their distribution based on sorted naming order.

       --SUPPORT-CAS

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_SUPPORT_CAS

       --USE-UDP

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_USE_UDP

       --NAMESPACE=

       A  namespace  is  a  container that provides context for keys, only other requests that know the namespace can access these values. This is
       accomplished by prepending the namespace value to all keys.

   Mecached Pool Options:
       --POOL-MIN

       Initial size of pool.

       --POOL-MAX

       Maximize size of the pool.

   I/O Options:
       --TCP-NODELAY

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_TCP_NODELAY

       --TCP-KEEPALIVE

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_TCP_KEEPALIVE

       --RETRY-TIMEOUT=

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_RETRY_TIMEOUT

       --SERVER-FAILURE-LIMIT=

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT

       --SND-TIMEOUT=

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_SND_TIMEOUT

       --SOCKET-RECV-SIZE=

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE

       --SOCKET-SEND-SIZE=

       See memcached_behavior_set(3) for MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE

       --POLL-TIMEOUT=

       That sets the value of the timeout used by :manpage: poll().

       --IO-BYTES-WATERMARK=

       --IO-KEY-PREFETCH=

       --IO-MSG-WATERMARK=

       --TCP-KEEPIDLE

       --RCV-TIMEOUT=

   Other:
       INCLUDE

       Include a file in configuration. Unlike --CONFIGURE-FILE= this will not reset memcached_st

       RESET

       Reset memcached_st and continue to process.

       END

       End configutation processing.

       ERROR

       End configutation processing and throw an error.

RETURN

       memcached() returns a pointer to the memcached_st that was created (or initialized).  On an allocation failure, it returns NULL.

EXAMPLE

	  const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com"
	  memcached_st *memc= memcached(config_string, strlen(config_string);
	  {
	   ...
	  }
	  memcached_free(memc);

HOME

       To find out more information please check: http://libmemcached.org/

SEE ALSO

       memcached(1) libmemcached(3) memcached_strerror(3)

AUTHOR

       Brian Aker

COPYRIGHT

       2011-2013, Brian Aker DataDifferential, http://datadifferential.com/

1.0.16								 January 31, 2013						      MEMCACHED(3)