Blame SOURCES/libmemcached-memaslap-help.patch

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