Blame SOURCES/libmemcached-memaslap-help.patch

feb4ee
commit 567105e2f3007783cd155846118ad47068110565
feb4ee
Author: Tomas Korbar <tkorbar@redhat.com>
feb4ee
Date:   Mon Oct 11 12:26:45 2021 +0200
feb4ee
feb4ee
    Fix typo in memaslap manpage and help
feb4ee
feb4ee
diff --git a/clients/memaslap.c b/clients/memaslap.c
feb4ee
index 0290794..d599cc4 100644
feb4ee
--- a/clients/memaslap.c
feb4ee
+++ b/clients/memaslap.c
feb4ee
@@ -32,7 +32,7 @@
feb4ee
 #include "ms_setting.h"
feb4ee
 #include "ms_thread.h"
feb4ee
 
feb4ee
-#define PROGRAM_NAME    "memslap"
feb4ee
+#define PROGRAM_NAME    "memaslap"
feb4ee
 #define PROGRAM_DESCRIPTION \
feb4ee
                         "Generates workload against memcached servers."
feb4ee
 
feb4ee
@@ -130,7 +130,7 @@ static __attribute__((noreturn)) void ms_help_command(const char *command_name,
feb4ee
   printf("    %s\n\n", description);
feb4ee
   printf(
feb4ee
     "Usage:\n"
feb4ee
-    "    memslap -hV | -s servers [-F config_file] [-t time | -x exe_num] [...]\n\n"
feb4ee
+    "    memaslap -hV | -s servers [-F config_file] [-t time | -x exe_num] [...]\n\n"
feb4ee
     "Options:\n");
feb4ee
 
feb4ee
   for (int x= 0; long_options[x].name; x++)
feb4ee
@@ -146,13 +146,13 @@ static __attribute__((noreturn)) void ms_help_command(const char *command_name,
feb4ee
 
feb4ee
   printf(
feb4ee
     "\nExamples:\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211 -S 5s\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211 -t 2m -v 0.2 -e 0.05 -b\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211 -F config -t 2m -w 40k -S 20s -o 0.2\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211 -F config -t 2m -T 4 -c 128 -d 20 -P 40k\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211 -F config -t 2m -d 50 -a -n 40\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m\n"
feb4ee
-    "    memslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m -p 2\n\n");
feb4ee
+    "    memaslap -s 127.0.0.1:11211 -S 5s\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211 -t 2m -v 0.2 -e 0.05 -b\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211 -F config -t 2m -w 40k -S 20s -o 0.2\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211 -F config -t 2m -T 4 -c 128 -d 20 -P 40k\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211 -F config -t 2m -d 50 -a -n 40\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m\n"
feb4ee
+    "    memaslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m -p 2\n\n");
feb4ee
 
feb4ee
   exit(0);
feb4ee
 } /* ms_help_command */
feb4ee
@@ -286,7 +286,7 @@ static const char *ms_lookup_help(ms_options_t option)
feb4ee
 
feb4ee
   case OPT_UDP:
feb4ee
     return
feb4ee
-      "UDP support, default memslap uses TCP, TCP port and UDP port of\n"
feb4ee
+      "UDP support, default memaslap uses TCP, TCP port and UDP port of\n"
feb4ee
       "        server must be same.";
feb4ee
 
feb4ee
   case OPT_EXPIRE:
feb4ee
diff --git a/man/memaslap.1 b/man/memaslap.1
feb4ee
index 1f41484..e884381 100644
feb4ee
--- a/man/memaslap.1
feb4ee
+++ b/man/memaslap.1
feb4ee
@@ -83,11 +83,11 @@ the threads don\(aqt communicate with each other, and there are several socket
feb4ee
 connections in each thread. Each connection keeps key size distribution,
feb4ee
 value size distribution, and command distribution by itself.
feb4ee
 .sp
feb4ee
-You can specify servers via the \fImemslap \-\-servers\fP option or via the
feb4ee
+You can specify servers via the \fImemaslap \-\-servers\fP option or via the
feb4ee
 environment variable \fI\%MEMCACHED_SERVERS\fP\&.
feb4ee
 .SH FEATURES
feb4ee
 .sp
feb4ee
-Memslap is developed to for the following purposes:
feb4ee
+Memaslap is developed to for the following purposes:
feb4ee
 .sp
feb4ee
 Manages network connections with libevent asynchronously.
feb4ee
 .sp
feb4ee
@@ -121,8 +121,8 @@ of memaslap is similar to memcached. Libevent can ensure
feb4ee
 memaslap can handle network very efficiently.
feb4ee
 .SS Effective implementation of multi\-threads and concurrency
feb4ee
 .sp
feb4ee
-Memslap has the similar implementation of multi\-threads to
feb4ee
-memcached. Memslap creates one or more self\-governed threads;
feb4ee
+Memaslap has the similar implementation of multi\-threads to
feb4ee
+memcached. Memaslap creates one or more self\-governed threads;
feb4ee
 each thread is bound with one CPU core if the system testss setting CPU
feb4ee
 core affinity.
feb4ee
 .sp
feb4ee
@@ -131,7 +131,7 @@ each thread has one or more self\-governed concurrencies; and each
feb4ee
 concurrency has one or more socket connections. All the concurrencies don’t
feb4ee
 communicate with each other even though they are in the same thread.
feb4ee
 .sp
feb4ee
-Memslap can create thousands of socket connections, and each
feb4ee
+Memaslap can create thousands of socket connections, and each
feb4ee
 concurrency has tens of socket connections. Each concurrency randomly or
feb4ee
 sequentially selects one socket connection from its socket connection pool
feb4ee
 to run, so memaslap can ensure each concurrency handles one
feb4ee
@@ -144,7 +144,7 @@ In order to improve time efficiency and space efficiency,
feb4ee
 memaslap creates a random characters table with 10M characters. All the
feb4ee
 suffixes of keys and values are generated from this random characters table.
feb4ee
 .sp
feb4ee
-Memslap uses the offset in the character table and the length
feb4ee
+Memaslap uses the offset in the character table and the length
feb4ee
 of the string to identify a string. It can save much memory.
feb4ee
 Each key contains two parts, a prefix and a suffix. The prefix is an
feb4ee
 uint64_t, 8 bytes. In order to verify the data set before,
feb4ee
@@ -152,7 +152,7 @@ memaslap need to ensure each key is unique, so it uses the prefix to identify
feb4ee
 a key. The prefix cannot include illegal characters, such as ‘r’, ‘n’,
feb4ee
 ‘0’ and ‘ ‘. And memaslap has an algorithm to ensure that.
feb4ee
 .sp
feb4ee
-Memslap doesn’t generate all the objects (key\-value pairs) at
feb4ee
+Memaslap doesn’t generate all the objects (key\-value pairs) at
feb4ee
 the beginning. It only generates enough objects to fill the task window
feb4ee
 (default 10K objects) of each concurrency. Each object has the following
feb4ee
 basic information, key prefix, key suffix offset in the character table, key
feb4ee
@@ -164,16 +164,16 @@ time, each concurrency kicks objects out of its window and adds new object
feb4ee
 into it.
feb4ee
 .SS Simple but useful task scheduling
feb4ee
 .sp
feb4ee
-Memslap uses libevent to schedule all the concurrencies of
feb4ee
+Memaslap uses libevent to schedule all the concurrencies of
feb4ee
 threads, and each concurrency schedules tasks based on the local task
feb4ee
-window. Memslap assumes that if each concurrency keeps the same
feb4ee
+window. Memaslap assumes that if each concurrency keeps the same
feb4ee
 key distribution, value distribution and commands distribution, from
feb4ee
 outside, memaslap keeps all the distribution as a whole.
feb4ee
 Each task window includes a lot of objects, each object stores its basic
feb4ee
 information, such as key, value, expire time, and so on. At any time, all
feb4ee
 the objects in the window keep the same and fixed key and value
feb4ee
 distribution. If an object is overwritten, the value of the object will be
feb4ee
-updated. Memslap verifies the data or expire\-time according to
feb4ee
+updated. Memaslap verifies the data or expire\-time according to
feb4ee
 the object information stored in the task window.
feb4ee
 .sp
feb4ee
 Libevent selects which concurrency to handle based on a specific network
feb4ee
@@ -201,16 +201,16 @@ test. Each concurrency has one socket connection to each memcached server.
feb4ee
 For the implementation, memaslap can set some objects to one
feb4ee
 memcached server, and get these objects from the other servers.
feb4ee
 .sp
feb4ee
-By default, Memslap does single get. If the user specifies
feb4ee
+By default, Memaslap does single get. If the user specifies
feb4ee
 multi\-get option, memaslap will collect enough get commands and
feb4ee
 pack and send the commands together.
feb4ee
 .sp
feb4ee
-Memslap testss both the ASCII protocol and binary protocol,
feb4ee
+Memaslap testss both the ASCII protocol and binary protocol,
feb4ee
 but it runs on the ASCII protocol by default.
feb4ee
-Memslap by default runs on the TCP protocol, but it also
feb4ee
+Memaslap by default runs on the TCP protocol, but it also
feb4ee
 tests UDP. Because UDP is unreliable, dropped packages and out\-of\-order
feb4ee
-packages may occur. Memslap creates a memory buffer to handle
feb4ee
-these problems. Memslap tries to read all the response data of
feb4ee
+packages may occur. Memaslap creates a memory buffer to handle
feb4ee
+these problems. Memaslap tries to read all the response data of
feb4ee
 one command from the server and reorders the response data. If some packages
feb4ee
 get lost, the waiting timeout mechanism can ensure half\-baked packages will
feb4ee
 be discarded and the next command will be sent.
feb4ee
@@ -343,7 +343,7 @@ throughput using “\-\-tps” option.
feb4ee
 Most of the time, the user does not need to specify the window size. The
feb4ee
 default window size is 10k. For Schooner Memcached, the user can specify
feb4ee
 different window sizes to get different cache miss rates based on the test
feb4ee
-case. Memslap testss cache miss rate between 0% and 100%.
feb4ee
+case. Memaslap testss cache miss rate between 0% and 100%.
feb4ee
 If you use this utility to test the performance of Schooner Memcached, you
feb4ee
 can specify a proper window size to get the expected cache miss rate. The
feb4ee
 formula for calculating window size is as follows:
feb4ee
@@ -389,7 +389,7 @@ The formula for calculating window size for cache miss rate 5%:
feb4ee
 cache_size / concurrency / (key_size + value_size) * 0.7
feb4ee
 .SS Verification
feb4ee
 .sp
feb4ee
-Memslap testss both data verification and expire\-time
feb4ee
+Memaslap testss both data verification and expire\-time
feb4ee
 verification. The user can use "\-\-verify=" or "\-v" to specify the proportion
feb4ee
 of data verification. In theory, it testss 100% data verification. The
feb4ee
 user can use "\-\-exp_verify=" or "\-e" to specify the proportion of
feb4ee
@@ -403,9 +403,9 @@ objects are gotten, memaslap will verify the expire\-time and
feb4ee
 value.
feb4ee
 .SS multi\-servers and multi\-config
feb4ee
 .sp
feb4ee
-Memslap testss multi\-servers based on self\-governed thread.
feb4ee
+Memaslap testss multi\-servers based on self\-governed thread.
feb4ee
 There is a limitation that the number of servers cannot be greater than the
feb4ee
-number of threads. Memslap assigns one thread to handle one
feb4ee
+number of threads. Memaslap assigns one thread to handle one
feb4ee
 server at least. The user can use the "\-\-servers=" or "\-s" option to specify
feb4ee
 multi\-servers.
feb4ee
 .sp
feb4ee
@@ -445,17 +445,17 @@ For example:
feb4ee
 .sp
feb4ee
 \-\-stat_freq=20s
feb4ee
 .sp
feb4ee
-Memslap will dump the statistics of the commands (get and set) at the frequency of every 20
feb4ee
+Memaslap will dump the statistics of the commands (get and set) at the frequency of every 20
feb4ee
 seconds.
feb4ee
 .sp
feb4ee
 For more information on the format of dumping statistic information, refer to “Format of Output” section.
feb4ee
 .SS Multi\-get
feb4ee
 .sp
feb4ee
 The user can use "\-\-division=" or "\-d" to specify multi\-get keys count.
feb4ee
-Memslap by default does single get with TCP. Memslap also testss data
feb4ee
+Memaslap by default does single get with TCP. Memaslap also testss data
feb4ee
 verification and expire\-time verification for multi\-get.
feb4ee
 .sp
feb4ee
-Memslap testss multi\-get with both TCP and UDP. Because of
feb4ee
+Memaslap testss multi\-get with both TCP and UDP. Because of
feb4ee
 the different implementation of the ASCII protocol and binary protocol,
feb4ee
 there are some differences between the two. For the ASCII protocol,
feb4ee
 memaslap sends one “multi\-get” to the server once. For the
feb4ee
@@ -463,7 +463,7 @@ binary protocol, memaslap sends several single get commands
feb4ee
 together as “multi\-get” to the server.
feb4ee
 .SS UDP and TCP
feb4ee
 .sp
feb4ee
-Memslap testss both UDP and TCP. For TCP,
feb4ee
+Memaslap testss both UDP and TCP. For TCP,
feb4ee
 memaslap does not reconnect the memcached server if socket connections are
feb4ee
 lost. If all the socket connections are lost or memcached server crashes,
feb4ee
 memaslap will exit. If the user specifies the “\-\-reconnect”
feb4ee
@@ -493,7 +493,7 @@ For example: \-\-facebook \-\-division=50 \-\-conn_sock=200
feb4ee
 The above command means that memaslap will do facebook test,
feb4ee
 each concurrency has 200 socket TCP connections and one UDP socket.
feb4ee
 .sp
feb4ee
-Memslap sets objects with the TCP socket, and multi\-gets 50
feb4ee
+Memaslap sets objects with the TCP socket, and multi\-gets 50
feb4ee
 objects once with the UDP socket.
feb4ee
 .sp
feb4ee
 If you specify "\-\-division=50", the key size must be less that 25 bytes