9bbaee
From 8cf9b071c77f1f305f4bae795166da8e7daab179 Mon Sep 17 00:00:00 2001
9bbaee
From: Miroslav Lichvar <mlichvar@redhat.com>
9bbaee
Date: Tue, 2 Jul 2013 13:54:04 +0200
9bbaee
Subject: [PATCH 1/2] describe -b and -S options in man page
9bbaee
9bbaee
---
9bbaee
 doc/memcached.1 | 7 +++++++
9bbaee
 memcached.c     | 2 +-
9bbaee
 2 files changed, 8 insertions(+), 1 deletion(-)
9bbaee
9bbaee
diff --git a/doc/memcached.1 b/doc/memcached.1
9bbaee
index b6f633d..7e72e2e 100644
9bbaee
--- a/doc/memcached.1
9bbaee
+++ b/doc/memcached.1
9bbaee
@@ -119,6 +119,9 @@ could reduce the number of TLB misses and improve the performance. In order to
9bbaee
 get large pages from the OS, memcached will allocate the total item-cache in
9bbaee
 one large chunk. Only available if supported on your OS.
9bbaee
 .TP
9bbaee
+.B \-b <num>
9bbaee
+Set the backlog queue limit to <num> connections. The default is 1024.
9bbaee
+.TP
9bbaee
 .B \-B <proto>
9bbaee
 Specify the binding protocol to use.  By default, the server will
9bbaee
 autonegotiate client connections.  By using this option, you can
9bbaee
@@ -131,6 +134,10 @@ minimum is 1k, max is 128m. Adjusting this value changes the item size limit.
9bbaee
 Beware that this also increases the number of slabs (use -v to view), and the
9bbaee
 overal memory usage of memcached.
9bbaee
 .TP
9bbaee
+.B \-S
9bbaee
+Turn on SASL authentication. This option is only meaningful if memcached was
9bbaee
+compiled with SASL support enabled.
9bbaee
+.TP
9bbaee
 .B \-o <options>
9bbaee
 Comma separated list of extended or experimental options. See -h or wiki for
9bbaee
 up to date list.
9bbaee
diff --git a/memcached.c b/memcached.c
9bbaee
index 35f6f4d..dc8b770 100644
9bbaee
--- a/memcached.c
9bbaee
+++ b/memcached.c
9bbaee
@@ -4498,7 +4498,7 @@ static void usage(void) {
9bbaee
            "              requests process for a given connection to prevent \n"
9bbaee
            "              starvation (default: 20)\n");
9bbaee
     printf("-C            Disable use of CAS\n");
9bbaee
-    printf("-b            Set the backlog queue limit (default: 1024)\n");
9bbaee
+    printf("-b <num>      Set the backlog queue limit (default: 1024)\n");
9bbaee
     printf("-B            Binding protocol - one of ascii, binary, or auto (default)\n");
9bbaee
     printf("-I            Override the size of each slab page. Adjusts max item size\n"
9bbaee
            "              (default: 1mb, min: 1k, max: 128m)\n");
9bbaee
-- 
9bbaee
1.8.1.4
9bbaee
9bbaee
From 6f9f9fe20d4b591c5b392660460fdd0e9cf2ca58 Mon Sep 17 00:00:00 2001
9bbaee
From: Miroslav Lichvar <mlichvar@redhat.com>
9bbaee
Date: Tue, 2 Jul 2013 17:15:03 +0200
9bbaee
Subject: [PATCH 2/2] add man page for memcached-tool
9bbaee
9bbaee
---
9bbaee
 scripts/memcached-tool.1 | 71 ++++++++++++++++++++++++++++++++++++++++++++++++
9bbaee
 1 file changed, 71 insertions(+)
9bbaee
 create mode 100644 scripts/memcached-tool.1
9bbaee
9bbaee
diff --git a/scripts/memcached-tool.1 b/scripts/memcached-tool.1
9bbaee
new file mode 100644
9bbaee
index 0000000..6bb021b
9bbaee
--- /dev/null
9bbaee
+++ b/scripts/memcached-tool.1
9bbaee
@@ -0,0 +1,71 @@
9bbaee
+.TH MEMCACHED-TOOL 1 "Jul 2, 2013"
9bbaee
+.SH NAME
9bbaee
+memcached-tool \- stats and management tool for memcached
9bbaee
+
9bbaee
+.SH SYNOPSIS
9bbaee
+.B memcached-tool
9bbaee
+.RI < host [: port "] | " /path/to/socket "> ["  mode ]
9bbaee
+
9bbaee
+.SH DESCRIPTION
9bbaee
+.B memcached-tool
9bbaee
+is a Perl script used to print statistics from a running memcached instance.
9bbaee
+The first parameter specifies the address of the daemon either by a hostname,
9bbaee
+optionally followed by the port number (the default is 11211), or a path to
9bbaee
+UNIX domain socket. The second parameter specifies the mode in which the tool
9bbaee
+should run.
9bbaee
+
9bbaee
+.SH MODES
9bbaee
+.TP
9bbaee
+.B display
9bbaee
+Print slab class statistics. This is the default mode if no mode is specified.
9bbaee
+The printed columns are:
9bbaee
+.RS
9bbaee
+.TP
9bbaee
+.B #
9bbaee
+Number of the slab class.
9bbaee
+.TP
9bbaee
+.B Item_Size
9bbaee
+The amount of space each chunk uses. One item uses one chunk of the
9bbaee
+appropriate size.
9bbaee
+.TP
9bbaee
+.B Max_age
9bbaee
+Age of the oldest item in the LRU.
9bbaee
+.TP
9bbaee
+.B Pages
9bbaee
+Total number of pages allocated to the slab class.
9bbaee
+.TP
9bbaee
+.B Count
9bbaee
+Number of items presently stored in this class. Expired items are not
9bbaee
+automatically excluded.
9bbaee
+.TP
9bbaee
+.B Full?
9bbaee
+Yes if there are no free chunks at the end of the last allocated page.
9bbaee
+.TP
9bbaee
+.B Evicted
9bbaee
+Number of times an item had to be evicted from the LRU before it expired.
9bbaee
+.TP
9bbaee
+.B Evict_Time
9bbaee
+Seconds since the last access for the most recent item evicted from this
9bbaee
+class.
9bbaee
+.TP
9bbaee
+.B OOM
9bbaee
+Number of times the underlying slab class was unable to store a new item.
9bbaee
+.RE
9bbaee
+
9bbaee
+.TP
9bbaee
+.B stats
9bbaee
+Print general-purpose statistics of the daemon. Each line contains the name of
9bbaee
+the statistic and its value.
9bbaee
+.TP
9bbaee
+.B dump
9bbaee
+Make a partial dump of the cache written in the add statements of the
9bbaee
+memcached protocol.
9bbaee
+
9bbaee
+.SH SEE ALSO
9bbaee
+.BR memcached (1),
9bbaee
+.br
9bbaee
+.B http://www.memcached.org
9bbaee
+
9bbaee
+.SH AUTHOR
9bbaee
+The memcached-tool script was written by Brad Fitzpatrick
9bbaee
+.B <brad@danga.com>
9bbaee
-- 
9bbaee
1.8.1.4
9bbaee