Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

memcached_server_list_free (3libmemcached)

Name

memcached_server_list_free - libmemcached Documentation

Synopsis

#include <libmemcached/memcached.h>

const memcached_instance_st *

memcached_server_list_st

memcached_server_st

const    const   memcached_instance_st   *   memcached_server_list(mem-
cached_st *ptr)

void memcached_server_list_free(memcached_server_list_st list)

memcached_server_list_st                 memcached_server_list_append(-
memcached_server_list_st list,  const  char *hostname,  in_port_t port,
memcached_return_t *error)

uint32_t memcached_server_list_count(memcached_server_list_st list)

const    char    *memcached_server_error(const    memcached_instance_st
* instance)

void memcached_server_error_reset(const memcached_instance_st * list)

Deprecated since version 0.39.

void memcached_servers_parse()

Deprecated since version 0.39.

Compile and link with -lmemcached

Description

libmemcached                         MEMCACHED_SERVER_LIST_FREE(3libmemcached)



NAME
       memcached_server_list_free - libmemcached Documentation

SYNOPSIS
       #include <libmemcached/memcached.h>

       const memcached_instance_st *

       memcached_server_list_st

       memcached_server_st

       const    const   memcached_instance_st   *   memcached_server_list(mem-
       cached_st *ptr)

       void memcached_server_list_free(memcached_server_list_st list)

       memcached_server_list_st                 memcached_server_list_append(-
       memcached_server_list_st list,  const  char *hostname,  in_port_t port,
       memcached_return_t *error)

       uint32_t memcached_server_list_count(memcached_server_list_st list)

       const    char    *memcached_server_error(const    memcached_instance_st
       * instance)

       void memcached_server_error_reset(const memcached_instance_st * list)

       Deprecated since version 0.39.

       void memcached_servers_parse()

       Deprecated since version 0.39.

       Compile and link with -lmemcached

DESCRIPTION
       libmemcached(3)  operates  on  a  list  of  hosts  which  are stored in
       memcached_server_st structures. You should not modify these  structures
       directly.  Functions  are provided to modify these structures (and more
       can be added, just ask!).

       memcached_server_list() is used to provide  an  array  of  all  defined
       hosts. This was incorrectly documented as "requiring free" up till ver-
       sion 0.39.

       memcached_server_list_free() deallocates all memory associated with the
       array of memcached_server_st that you passed to it.

       memcached_server_list_append()   adds   a   server  to  the  end  of  a
       memcached_server_st array. On error null will be returned and the  mem-
       cached_return_t  pointer  you passed into the function will be set with
       the appropriate error. If the value of port is zero, it is set  to  the
       default port of a memcached server.

       DEPRECATED memcached_servers_parse(), please see memcached()

       memcached_server_error()  can  be  used to look at the text of the last
       error message sent by the server to to the client.

       Before version 0.39 theses functions used a  memcache_server_st  *.  In
       0.39  memcached_server_st  *  was  aliased to memcached_server_list_st.
       This was done for a style reason to help clean up some concepts in  the
       code.

RETURN
       Varies, see particular functions.

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_SERVER_LIST_FREE(3libmemcached)