X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fman%2Fmemcached_get_memory_allocators.3;h=a40b0cd86635e8309603e89f7b20f53b51835a95;hb=bb79afb7484c21ee590a15399e2e8a39cca7b627;hp=98d892adf86f660721bf97a1af3d8d86580505b0;hpb=0ef2080bdbaafe7e3397530ac69ef4081f4f513e;p=m6w6%2Flibmemcached diff --git a/docs/man/memcached_get_memory_allocators.3 b/docs/man/memcached_get_memory_allocators.3 index 98d892ad..b20b1e7b 100644 --- a/docs/man/memcached_get_memory_allocators.3 +++ b/docs/man/memcached_get_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET_MEMORY_ALLOCATORS" "3" "April 12, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET_MEMORY_ALLOCATORS" "3" "April 21, 2012" "1.0.6" "libmemcached" .SH NAME memcached_get_memory_allocators \- libmemcached Documentation . @@ -32,47 +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 +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 @@ -84,12 +93,13 @@ 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 +\fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP