X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fman%2Fmemcached_set_memory_allocators.3;h=34be814e0b950efb130d246df2e79346a4ae9714;hb=9f3c2098e91293e4d69b1d691fbf352e440309ff;hp=f56caa4af66accf5f7c8dd994128c47777fd4964;hpb=f285e1b3821f56a8983b5ce9fb1a0070e7bb0a1c;p=m6w6%2Flibmemcached diff --git a/docs/man/memcached_set_memory_allocators.3 b/docs/man/memcached_set_memory_allocators.3 index f56caa4a..6e84e8c4 100644 --- a/docs/man/memcached_set_memory_allocators.3 +++ b/docs/man/memcached_set_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_MEMORY_ALLOCATORS" "3" "April 07, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_MEMORY_ALLOCATORS" "3" "April 08, 2012" "1.0.6" "libmemcached" .SH NAME memcached_set_memory_allocators \- libmemcached Documentation . @@ -32,70 +32,56 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .sp Manage memory allocator functions -.SH LIBRARY -.sp -C Client Library for memcached (libmemcached, \-lmemcached) .SH SYNOPSIS .sp -.nf -.ft C #include - -memcached_return_t - memcached_set_memory_allocators (memcached_st *ptr, - memcached_malloc_fn mem_malloc, - memcached_free_fn mem_free, - memcached_realloc_fn mem_realloc, - memcached_calloc_fn mem_calloc, - void *context); - -void - memcached_get_memory_allocators (memcached_st *ptr, - memcached_malloc_fn *mem_malloc, - memcached_free_fn *mem_free, - memcached_realloc_fn *mem_realloc, - memcached_calloc_fn *mem_calloc); - -void * - memcached_get_memory_allocators_context(const memcached_st *ptr); - -void * - (*memcached_malloc_fn) (memcached_st *ptr, const size_t size, - void *context); - -void * - (*memcached_realloc_fn) (memcached_st *ptr, void *mem, - const size_t size, - void *context); - -void - (*memcached_free_fn) (memcached_st *ptr, void *mem, - void *context); - -void * -(*memcached_calloc_fn) (memcached_st *ptr, - size_t nelem, - const size_t elsize, - void *context); -.ft P -.fi +.INDENT 0.0 +.TP +.B memcached_return_t memcached_set_memory_allocators(memcached_st\fI\ *ptr\fP, \fI\%memcached_malloc_fn\fP\fI\ mem_malloc\fP, \fI\%memcached_free_fn\fP\fI\ mem_free\fP, \fI\%memcached_realloc_fn\fP\fI\ mem_realloc\fP, \fI\%memcached_calloc_fn\fP\fI\ mem_calloc\fP, void\fI\ *context\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void memcached_get_memory_allocators(memcached_st\fI\ *ptr\fP, \fI\%memcached_malloc_fn\fP\fI\ *mem_malloc\fP, \fI\%memcached_free_fn\fP\fI\ *mem_free\fP, \fI\%memcached_realloc_fn\fP\fI\ *mem_realloc\fP, \fI\%memcached_calloc_fn\fP\fI\ *mem_calloc\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void * memcached_get_memory_allocators_context(const memcached_st\fI\ *ptr\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void * (*memcached_malloc_fn)(memcached_st\fI\ *ptr\fP, const size_t\fI\ size\fP, void\fI\ *context\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void * (*memcached_realloc_fn)(memcached_st\fI\ *ptr\fP, void\fI\ *mem\fP, const size_t\fI\ size\fP, void\fI\ *context\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void (*memcached_free_fn)(memcached_st\fI\ *ptr\fP, void\fI\ *mem\fP, void\fI\ *context\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void * (*memcached_calloc_fn)(memcached_st\fI\ *ptr\fP, size_t\fI\ nelem\fP, const size_t\fI\ elsize\fP, void\fI\ *context\fP) +.UNINDENT +.sp +Compile and link with \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) allows you to specify your own memory allocators optimized -for your application. +libmemcached(3) allows you to specify your own memory allocators, optimized +for your application. This enables libmemcached to be used inside of applications that have their own malloc implementation. .sp -memcached_set_memory_allocators() is used to set the memory allocators used -by the memcached instance specified by ptr. Please note that you cannot -override only one of the memory allocators, you have to specify a complete -new set if you want to override one of them. All of the memory allocation -functions should behave as specified in the C99 standard. Specify NULL as -all functions to reset them to the default values. +\fI\%memcached_set_memory_allocators()\fP is used to set the memory +allocators used by the memcached instance specified by ptr. Please note that +you cannot override only one of the memory allocators, you have to specify a +complete new set if you want to override one of them. All of the memory +allocation functions should behave as specified in the C99 standard. Specify +NULL as all functions to reset them to the default values. .sp -memcached_get_memory_allocators() is used to get the currently used memory -allocators by a mamcached handle. +\fI\%memcached_get_memory_allocators()\fP is used to get the currently used +memory allocators by a mamcached handle. .sp -memcached_get_memory_allocators_context() returns the void * that was -passed in during the call to memcached_set_memory_allocators(). +\fI\%memcached_get_memory_allocators_context()\fP returns the void * that +was passed in during the call to \fI\%memcached_set_memory_allocators()\fP. .sp The first argument to the memory allocator functions is a pointer to a memcached structure, the is passed as const and you will need to clone @@ -107,23 +93,20 @@ passed to them. This was so that customer allocators could have their own space for memory. .SH RETURN .sp -memcached_set_memory_allocators() return MEMCACHED_SUCCESS upon success, -and MEMCACHED_FAILURE if you don\(aqt pass a complete set of function pointers. +\fI\%memcached_set_memory_allocators()\fP return \fBMEMCACHED_SUCCESS\fP +upon success, and \fBMEMCACHED_FAILURE\fP if you don\(aqt pass a complete set +of function pointers. .SH HOME .sp To find out more information please check: -\fI\%https://launchpad.net/libmemcached\fP -.SH AUTHOR -.sp -Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> -Brian Aker, <\fI\%brian@tangent\fP.orf +\fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_get_user_data(3) memcached_set_user_data(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT -2011, Brian Aker +2011, Brian Aker DataDifferential, http://datadifferential.com/ .\" Generated by docutils manpage writer. .\" .