X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_stats.pod;h=33784cfd9c5cbaa0e01c60b845fab8f6a329066a;hb=9cddfe57d6b1f361abe48c7900627d4319458dca;hp=40bc183b31f468475d5befa3e45ccd1dd8a9ab65;hpb=a11143256264a00e7437fa23ec8ff5196c5a5c0b;p=awesomized%2Flibmemcached diff --git a/docs/memcached_stats.pod b/docs/memcached_stats.pod index 40bc183b..33784cfd 100755 --- a/docs/memcached_stats.pod +++ b/docs/memcached_stats.pod @@ -8,56 +8,69 @@ C Client Library for memcached (libmemcached, -lmemcached) =head1 SYNOPSIS -#include -memcached_stat_st *memcached_stat(memcached_st *ptr, char *args, memcached_return *error); -memcached_return memcached_stat_servername(memcached_stat_st *stat, char *args, - char *hostname, unsigned int port); -char *memcached_stat_get_value(memcached_st *ptr, memcached_stat_st *stat, - char *key, memcached_return *error); -char ** memcached_stat_get_keys(memcached_st *ptr, memcached_stat_st *stat, - memcached_return *error); + #include + + memcached_stat_st *memcached_stat (memcached_st *ptr, + char *args, + memcached_return *error); + + memcached_return memcached_stat_servername (memcached_stat_st *stat, + char *args, + char *hostname, + unsigned int port); + + char *memcached_stat_get_value (memcached_st *ptr, + memcached_stat_st *stat, + char *key, + memcached_return *error); + + char ** memcached_stat_get_keys (memcached_st *ptr, + memcached_stat_st *stat, + memcached_return *error); =head1 DESCRIPTION libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -memcached_stat_st structure. You are responsible for freeing this structure. +C structure. You are responsible for freeing this structure. While it is possible to access the structure directly it is not advisable. -memcached_stat_get_value(3) has been provided to query the structure. + structures containing the state of all available memcached servers. The return value must be freed by the calling application. -memcached_stat_servername() can be used standalone without a memcached_st to +memcached_stat_servername() can be used standalone without a C to obtain the state of a particular server. "args" is used to define a particular state object (a list of these are not provided for by either -the memcached_stat_get_keys call nor are they defined in the memcached -protocol). You must specify the hostname and port fo the server you want to -obtain information on +the memcached_stat_get_keys() call nor are they defined in the memcached +protocol). You must specify the hostname and port of the server you want to +obtain information on. memcached_stat_get_value() returns the value of a particular state key. You -specify the key you wish to obtain (this key must be null terminated). +specify the key you wish to obtain. The key must be null terminated. memcached_stat_get_keys() returns a list of keys that the server has state objects on. You are responsible for freeing this list. -A command line tool, memstat(1) is provided so that you do not have to write +A command line tool, memstat(1), is provided so that you do not have to write an application to do this. =head1 RETURN -memcached_stat() returns memcached_return. The value on success will be MEMCACHED_SUCCESS. For all errors check with memcached_strerror(). -Any method returning a memcached_stat_st expects you to free the memory -allocated for it. +Varies, see particular functions. + +Any method returning a C expects you to free the +memory allocated for it. =head1 HOME -To find out more information please check: http://tangent.org/552/libmemcached.html +To find out more information please check: +L =head1 AUTHOR -Brian Aker, brian@tangent.org +Brian Aker, Ebrian@tangent.orgE =head1 SEE ALSO