X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fman%2Fmemcached_server_add_unix_socket.3;h=fd4be6ded1dc14954fcb17dd25fa352fdf21bc61;hb=bc9a024d4d2292b68be5d3a90063ea0193c7770f;hp=4d737b62cba60881d893b5c49955359c916880dc;hpb=9cd57ce737375540f6c3b5e2e3684160e5c4bfce;p=m6w6%2Flibmemcached diff --git a/docs/man/memcached_server_add_unix_socket.3 b/docs/man/memcached_server_add_unix_socket.3 index 4d737b62..fd4be6de 100644 --- a/docs/man/memcached_server_add_unix_socket.3 +++ b/docs/man/memcached_server_add_unix_socket.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ADD_UNIX_SOCKET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_ADD_UNIX_SOCKET" "3" "September 26, 2011" "0.53" "libmemcached" .SH NAME memcached_server_add_unix_socket \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions.