git.m6w6.name Git - awesomized/libmemcached/blob - docs/memcached_servers.pod

   1 =head1 NAME
   2
   3 memcached_server_count, memcached_server_list, memcached_server_add, memcached_server_push
   4
   5 =head1 LIBRARY
   6
   7 C Client Library for memcached (libmemcached, -lmemcached)
   8
   9 =head1 SYNOPSIS
  10
  11   #include <memcached.h>
  12
  13   unsigned int memcached_server_count (memcached_st *ptr);
  14
  15   memcached_server_st *
  16     memcached_server_list (memcached_st *ptr);
  17
  18   memcached_return
  19     memcached_server_add (memcached_st *ptr,
  20                           char *hostname,
  21                           unsigned int port);
  22
  23   memcached_return
  24     memcached_server_push (memcached_st *ptr,
  25                            memcached_server_st *list);
  26
  27 =head1 DESCRIPTION
  28
  29 libmemcached(3) performs operations on a list of hosts. The order of these
  30 hosts determine routing to keys. Functions are provided to add keys to
  31 memcached_st structures. To manipulate lists of servers see
  32 memcached_server_st(3).
  33
  34 memcached_server_count() provides you a count of the current number of
  35 servers being used by a C<memcached_st> structure.
  36
  37 memcached_server_list() is used to provide an array of all connected hosts.
  38 You are responsible for freeing this list (aka it is not a pointer to the
  39 currently used structure).
  40
  41 memcached_server_add() pushes a single server into the C<memcached_st>
  42 structure. This server will be placed at the end. Duplicate servers are
  43 allowed, so duplication is not checked.
  44
  45 memcached_server_push() pushes an array of C<memcached_server_st> into
  46 the C<memcached_st> structure. These servers will be placed at the
  47 end. Duplicate servers are allowed, so duplication is not checked. A
  48 copy is made of structure so the list provided (and any operations on
  49 the list) are not saved.
  50
  51 =head1 RETURN
  52
  53 Varies, see particular functions.
  54
  55 =head1 HOME
  56
  57 To find out more information please check:
  58 L<http://tangent.org/552/libmemcached.html>
  59
  60 =head1 AUTHOR
  61
  62 Brian Aker, E<lt>brian@tangent.orgE<gt>
  63
  64 =head1 SEE ALSO
  65
  66 memcached(1) libmemcached(3) memcached_strerror(3)
  67
  68 =cut
  69