projects
/
m6w6
/
libmemcached
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
|
github
raw
|
inline
| side by side
jenkins-promote-staging-trunk-libmemcached-17
[m6w6/libmemcached]
/
docs
/
man
/
memaslap.1
diff --git
a/docs/man/memaslap.1
b/docs/man/memaslap.1
index 2fabe477d4e092adceda78aa179978b62ddfb96b..64692a27b2b5a4f0eedd8b0e417b2fb3f21dfd81 100644
(file)
--- a/
docs/man/memaslap.1
+++ b/
docs/man/memaslap.1
@@
-1,4
+1,4
@@
-.TH "MEMASLAP" "1" "
October 18, 2011" "1.01
" "libmemcached"
+.TH "MEMASLAP" "1" "
May 03, 2012" "1.0.7
" "libmemcached"
.SH NAME
memaslap \- libmemcached Documentation
.
.SH NAME
memaslap \- libmemcached Documentation
.
@@
-37,6
+37,10
@@
memaslap [options]
.TP
.B \-\-help
.UNINDENT
.TP
.B \-\-help
.UNINDENT
+.INDENT 0.0
+.TP
+.B MEMCACHED_SERVERS
+.UNINDENT
.SH DESCRIPTION
.sp
\fBmemaslap\fP is a load generation and benchmark tool for memcached
.SH DESCRIPTION
.sp
\fBmemaslap\fP is a load generation and benchmark tool for memcached
@@
-52,8
+56,8
@@
the threads don\(aqt communicate with each other, and there are several socket
connections in each thread. Each connection keeps key size distribution,
value size distribution, and command distribution by itself.
.sp
connections in each thread. Each connection keeps key size distribution,
value size distribution, and command distribution by itself.
.sp
-You can specify servers via the \fI\-\-servers\fP option or via the
-environment variable \f
B
MEMCACHED_SERVERS\fP.
+You can specify servers via the \fI
memslap
\-\-servers\fP option or via the
+environment variable \f
I\%
MEMCACHED_SERVERS\fP.
.SH FEATURES
.sp
Memslap is developed to for the following purposes:
.SH FEATURES
.sp
Memslap is developed to for the following purposes:
@@
-265,7
+269,6
@@
of the limitation of implementation, the number of concurrencies could be
the multiple of the number of threads.
.INDENT 0.0
.IP 1. 3
the multiple of the number of threads.
.INDENT 0.0
.IP 1. 3
-.
For 8 CPU cores system
.UNINDENT
.sp
For 8 CPU cores system
.UNINDENT
.sp
@@
-280,7
+283,6
@@
For example:
\-\-threads=12 \-\-concurrency=144
.INDENT 0.0
.IP 2. 3
\-\-threads=12 \-\-concurrency=144
.INDENT 0.0
.IP 2. 3
-.
For 16 CPU cores system
.UNINDENT
.sp
For 16 CPU cores system
.UNINDENT
.sp
@@
-326,7
+328,6
@@
concurrency=128.
win_size=10k
.INDENT 0.0
.IP 2. 3
win_size=10k
.INDENT 0.0
.IP 2. 3
-.
cache_size=4G
.UNINDENT
.sp
cache_size=4G
.UNINDENT
.sp
@@
-339,7
+340,6
@@
win_size=8k
win_size=11k
.INDENT 0.0
.IP 3. 3
win_size=11k
.INDENT 0.0
.IP 3. 3
-.
cache_size=16G
.UNINDENT
.sp
cache_size=16G
.UNINDENT
.sp
@@
-621,7
+621,6
@@
get proportion: get_prop=0.90
servers : "servers"
.INDENT 0.0
.INDENT 3.5
servers : "servers"
.INDENT 0.0
.INDENT 3.5
-.sp
The servers used by memaslap.
.UNINDENT
.UNINDENT
The servers used by memaslap.
.UNINDENT
.UNINDENT
@@
-629,7
+628,6
@@
The servers used by memaslap.
threads count
.INDENT 0.0
.INDENT 3.5
threads count
.INDENT 0.0
.INDENT 3.5
-.sp
The number of threads memaslap runs with.
.UNINDENT
.UNINDENT
The number of threads memaslap runs with.
.UNINDENT
.UNINDENT
@@
-637,7
+635,6
@@
The number of threads memaslap runs with.
concurrency
.INDENT 0.0
.INDENT 3.5
concurrency
.INDENT 0.0
.INDENT 3.5
-.sp
The number of concurrencies memaslap runs with.
.UNINDENT
.UNINDENT
The number of concurrencies memaslap runs with.
.UNINDENT
.UNINDENT
@@
-645,7
+642,6
@@
The number of concurrencies memaslap runs with.
run time
.INDENT 0.0
.INDENT 3.5
run time
.INDENT 0.0
.INDENT 3.5
-.sp
How long to run memaslap.
.UNINDENT
.UNINDENT
How long to run memaslap.
.UNINDENT
.UNINDENT
@@
-653,7
+649,6
@@
How long to run memaslap.
windows size
.INDENT 0.0
.INDENT 3.5
windows size
.INDENT 0.0
.INDENT 3.5
-.sp
The task window size of each concurrency.
.UNINDENT
.UNINDENT
The task window size of each concurrency.
.UNINDENT
.UNINDENT
@@
-661,7
+656,6
@@
The task window size of each concurrency.
set proportion
.INDENT 0.0
.INDENT 3.5
set proportion
.INDENT 0.0
.INDENT 3.5
-.sp
The proportion of set command.
.UNINDENT
.UNINDENT
The proportion of set command.
.UNINDENT
.UNINDENT
@@
-669,7
+663,6
@@
The proportion of set command.
get proportion
.INDENT 0.0
.INDENT 3.5
get proportion
.INDENT 0.0
.INDENT 3.5
-.sp
The proportion of get command.
.UNINDENT
.UNINDENT
The proportion of get command.
.UNINDENT
.UNINDENT
@@
-712,7
+705,6
@@
Global 20 1397720 69886 79.7 0 26 3791 227
Get Statistics
.INDENT 0.0
.INDENT 3.5
Get Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Statistics information of get command
.UNINDENT
.UNINDENT
Statistics information of get command
.UNINDENT
.UNINDENT
@@
-720,7
+712,6
@@
Statistics information of get command
Set Statistics
.INDENT 0.0
.INDENT 3.5
Set Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Statistics information of set command
.UNINDENT
.UNINDENT
Statistics information of set command
.UNINDENT
.UNINDENT
@@
-728,7
+719,6
@@
Statistics information of set command
Total Statistics
.INDENT 0.0
.INDENT 3.5
Total Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Statistics information of both get and set command
.UNINDENT
.UNINDENT
Statistics information of both get and set command
.UNINDENT
.UNINDENT
@@
-736,7
+726,6
@@
Statistics information of both get and set command
Period
.INDENT 0.0
.INDENT 3.5
Period
.INDENT 0.0
.INDENT 3.5
-.sp
Result within a period
.UNINDENT
.UNINDENT
Result within a period
.UNINDENT
.UNINDENT
@@
-744,7
+733,6
@@
Result within a period
Global
.INDENT 0.0
.INDENT 3.5
Global
.INDENT 0.0
.INDENT 3.5
-.sp
Accumulated results
.UNINDENT
.UNINDENT
Accumulated results
.UNINDENT
.UNINDENT
@@
-752,7
+740,6
@@
Accumulated results
Ops
.INDENT 0.0
.INDENT 3.5
Ops
.INDENT 0.0
.INDENT 3.5
-.sp
Total operations
.UNINDENT
.UNINDENT
Total operations
.UNINDENT
.UNINDENT
@@
-760,7
+747,6
@@
Total operations
TPS
.INDENT 0.0
.INDENT 3.5
TPS
.INDENT 0.0
.INDENT 3.5
-.sp
Throughput, operations/second
.UNINDENT
.UNINDENT
Throughput, operations/second
.UNINDENT
.UNINDENT
@@
-768,7
+754,6
@@
Throughput, operations/second
Net
.INDENT 0.0
.INDENT 3.5
Net
.INDENT 0.0
.INDENT 3.5
-.sp
The rate of network
.UNINDENT
.UNINDENT
The rate of network
.UNINDENT
.UNINDENT
@@
-776,7
+761,6
@@
The rate of network
Get_miss
.INDENT 0.0
.INDENT 3.5
Get_miss
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects can’t be gotten
.UNINDENT
.UNINDENT
How many objects can’t be gotten
.UNINDENT
.UNINDENT
@@
-784,7
+768,6
@@
How many objects can’t be gotten
Min
.INDENT 0.0
.INDENT 3.5
Min
.INDENT 0.0
.INDENT 3.5
-.sp
The minimum response time
.UNINDENT
.UNINDENT
The minimum response time
.UNINDENT
.UNINDENT
@@
-792,7
+775,6
@@
The minimum response time
Max
.INDENT 0.0
.INDENT 3.5
Max
.INDENT 0.0
.INDENT 3.5
-.sp
The maximum response time
.UNINDENT
.UNINDENT
The maximum response time
.UNINDENT
.UNINDENT
@@
-800,7
+782,6
@@
The maximum response time
Avg:
.INDENT 0.0
.INDENT 3.5
Avg:
.INDENT 0.0
.INDENT 3.5
-.sp
The average response time
.UNINDENT
.UNINDENT
The average response time
.UNINDENT
.UNINDENT
@@
-808,7
+789,6
@@
The average response time
Std_dev
.INDENT 0.0
.INDENT 3.5
Std_dev
.INDENT 0.0
.INDENT 3.5
-.sp
Standard deviation of response time
.UNINDENT
.UNINDENT
Standard deviation of response time
.UNINDENT
.UNINDENT
@@
-816,7
+796,6
@@
Standard deviation of response time
Geo_dist
.INDENT 0.0
.INDENT 3.5
Geo_dist
.INDENT 0.0
.INDENT 3.5
-.sp
Geometric distribution based on natural exponential function
.UNINDENT
.UNINDENT
Geometric distribution based on natural exponential function
.UNINDENT
.UNINDENT
@@
-882,7
+861,6
@@
Run time: 20.0s Ops: 1397754 TPS: 69817 Net_rate: 59.4M/s
Get Statistics
.INDENT 0.0
.INDENT 3.5
Get Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Get statistics of response time
.UNINDENT
.UNINDENT
Get statistics of response time
.UNINDENT
.UNINDENT
@@
-890,7
+868,6
@@
Get statistics of response time
Set Statistics
.INDENT 0.0
.INDENT 3.5
Set Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Set statistics of response time
.UNINDENT
.UNINDENT
Set statistics of response time
.UNINDENT
.UNINDENT
@@
-898,7
+875,6
@@
Set statistics of response time
Total Statistics
.INDENT 0.0
.INDENT 3.5
Total Statistics
.INDENT 0.0
.INDENT 3.5
-.sp
Both get and set statistics of response time
.UNINDENT
.UNINDENT
Both get and set statistics of response time
.UNINDENT
.UNINDENT
@@
-906,7
+882,6
@@
Both get and set statistics of response time
Min
.INDENT 0.0
.INDENT 3.5
Min
.INDENT 0.0
.INDENT 3.5
-.sp
The accumulated and minimum response time
.UNINDENT
.UNINDENT
The accumulated and minimum response time
.UNINDENT
.UNINDENT
@@
-914,7
+889,6
@@
The accumulated and minimum response time
Max
.INDENT 0.0
.INDENT 3.5
Max
.INDENT 0.0
.INDENT 3.5
-.sp
The accumulated and maximum response time
.UNINDENT
.UNINDENT
The accumulated and maximum response time
.UNINDENT
.UNINDENT
@@
-922,7
+896,6
@@
The accumulated and maximum response time
Avg
.INDENT 0.0
.INDENT 3.5
Avg
.INDENT 0.0
.INDENT 3.5
-.sp
The accumulated and average response time
.UNINDENT
.UNINDENT
The accumulated and average response time
.UNINDENT
.UNINDENT
@@
-930,7
+903,6
@@
The accumulated and average response time
Std
.INDENT 0.0
.INDENT 3.5
Std
.INDENT 0.0
.INDENT 3.5
-.sp
Standard deviation of response time
.UNINDENT
.UNINDENT
Standard deviation of response time
.UNINDENT
.UNINDENT
@@
-938,7
+910,6
@@
Standard deviation of response time
Log2 Dist
.INDENT 0.0
.INDENT 3.5
Log2 Dist
.INDENT 0.0
.INDENT 3.5
-.sp
Geometric distribution based on logarithm 2
.UNINDENT
.UNINDENT
Geometric distribution based on logarithm 2
.UNINDENT
.UNINDENT
@@
-946,7
+917,6
@@
Geometric distribution based on logarithm 2
cmd_get
.INDENT 0.0
.INDENT 3.5
cmd_get
.INDENT 0.0
.INDENT 3.5
-.sp
Total get commands done
.UNINDENT
.UNINDENT
Total get commands done
.UNINDENT
.UNINDENT
@@
-954,7
+924,6
@@
Total get commands done
cmd_set
.INDENT 0.0
.INDENT 3.5
cmd_set
.INDENT 0.0
.INDENT 3.5
-.sp
Total set commands done
.UNINDENT
.UNINDENT
Total set commands done
.UNINDENT
.UNINDENT
@@
-962,7
+931,6
@@
Total set commands done
get_misses
.INDENT 0.0
.INDENT 3.5
get_misses
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects can’t be gotten from server
.UNINDENT
.UNINDENT
How many objects can’t be gotten from server
.UNINDENT
.UNINDENT
@@
-970,7
+938,6
@@
How many objects can’t be gotten from server
verify_misses
.INDENT 0.0
.INDENT 3.5
verify_misses
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects need to verify but can’t get them
.UNINDENT
.UNINDENT
How many objects need to verify but can’t get them
.UNINDENT
.UNINDENT
@@
-978,7
+945,6
@@
How many objects need to verify but can’t get them
verify_failed
.INDENT 0.0
.INDENT 3.5
verify_failed
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects with insistent value
.UNINDENT
.UNINDENT
How many objects with insistent value
.UNINDENT
.UNINDENT
@@
-986,7
+952,6
@@
How many objects with insistent value
expired_get
.INDENT 0.0
.INDENT 3.5
expired_get
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects are expired but we get them
.UNINDENT
.UNINDENT
How many objects are expired but we get them
.UNINDENT
.UNINDENT
@@
-994,7
+959,6
@@
How many objects are expired but we get them
unexpired_unget
.INDENT 0.0
.INDENT 3.5
unexpired_unget
.INDENT 0.0
.INDENT 3.5
-.sp
How many objects are unexpired but we can’t get them
.UNINDENT
.UNINDENT
How many objects are unexpired but we can’t get them
.UNINDENT
.UNINDENT
@@
-1002,7
+966,6
@@
How many objects are unexpired but we can’t get them
written_bytes
.INDENT 0.0
.INDENT 3.5
written_bytes
.INDENT 0.0
.INDENT 3.5
-.sp
Total written bytes
.UNINDENT
.UNINDENT
Total written bytes
.UNINDENT
.UNINDENT
@@
-1010,7
+973,6
@@
Total written bytes
read_bytes
.INDENT 0.0
.INDENT 3.5
read_bytes
.INDENT 0.0
.INDENT 3.5
-.sp
Total read bytes
.UNINDENT
.UNINDENT
Total read bytes
.UNINDENT
.UNINDENT
@@
-1018,7
+980,6
@@
Total read bytes
object_bytes
.INDENT 0.0
.INDENT 3.5
object_bytes
.INDENT 0.0
.INDENT 3.5
-.sp
Total object bytes
.UNINDENT
.UNINDENT
Total object bytes
.UNINDENT
.UNINDENT
@@
-1026,7
+987,6
@@
Total object bytes
packet_disorder
.INDENT 0.0
.INDENT 3.5
packet_disorder
.INDENT 0.0
.INDENT 3.5
-.sp
How many UDP packages are disorder
.UNINDENT
.UNINDENT
How many UDP packages are disorder
.UNINDENT
.UNINDENT
@@
-1034,7
+994,6
@@
How many UDP packages are disorder
packet_drop
.INDENT 0.0
.INDENT 3.5
packet_drop
.INDENT 0.0
.INDENT 3.5
-.sp
How many UDP packages are lost
.UNINDENT
.UNINDENT
How many UDP packages are lost
.UNINDENT
.UNINDENT
@@
-1042,7
+1001,6
@@
How many UDP packages are lost
udp_timeout
.INDENT 0.0
.INDENT 3.5
udp_timeout
.INDENT 0.0
.INDENT 3.5
-.sp
How many times UDP time out happen
.UNINDENT
.UNINDENT
How many times UDP time out happen
.UNINDENT
.UNINDENT
@@
-1050,7
+1008,6
@@
How many times UDP time out happen
Run time
.INDENT 0.0
.INDENT 3.5
Run time
.INDENT 0.0
.INDENT 3.5
-.sp
Total run time
.UNINDENT
.UNINDENT
Total run time
.UNINDENT
.UNINDENT
@@
-1058,7
+1015,6
@@
Total run time
Ops
.INDENT 0.0
.INDENT 3.5
Ops
.INDENT 0.0
.INDENT 3.5
-.sp
Total operations
.UNINDENT
.UNINDENT
Total operations
.UNINDENT
.UNINDENT
@@
-1066,7
+1022,6
@@
Total operations
TPS
.INDENT 0.0
.INDENT 3.5
TPS
.INDENT 0.0
.INDENT 3.5
-.sp
Throughput, operations/second
.UNINDENT
.UNINDENT
Throughput, operations/second
.UNINDENT
.UNINDENT
@@
-1074,7
+1029,6
@@
Throughput, operations/second
Net_rate
.INDENT 0.0
.INDENT 3.5
Net_rate
.INDENT 0.0
.INDENT 3.5
-.sp
The average rate of network
.UNINDENT
.UNINDENT
The average rate of network
.UNINDENT
.UNINDENT
@@
-1082,109
+1036,86
@@
The average rate of network
.INDENT 0.0
.TP
.B \-s, \-\-servers=
.INDENT 0.0
.TP
.B \-s, \-\-servers=
-.
List one or more servers to connect. Servers count must be less than
threads count. e.g.: \-\-servers=localhost:1234,localhost:11211
.TP
.B \-T, \-\-threads=
List one or more servers to connect. Servers count must be less than
threads count. e.g.: \-\-servers=localhost:1234,localhost:11211
.TP
.B \-T, \-\-threads=
-.
Number of threads to startup, better equal to CPU numbers. Default 8.
.TP
.B \-c, \-\-concurrency=
Number of threads to startup, better equal to CPU numbers. Default 8.
.TP
.B \-c, \-\-concurrency=
-.
Number of concurrency to simulate with load. Default 128.
.TP
.B \-n, \-\-conn_sock=
Number of concurrency to simulate with load. Default 128.
.TP
.B \-n, \-\-conn_sock=
-.
Number of TCP socks per concurrency. Default 1.
.TP
.B \-x, \-\-execute_number=
Number of TCP socks per concurrency. Default 1.
.TP
.B \-x, \-\-execute_number=
-.
Number of operations(get and set) to execute for the
given test. Default 1000000.
.TP
.B \-t, \-\-time=
Number of operations(get and set) to execute for the
given test. Default 1000000.
.TP
.B \-t, \-\-time=
-.
How long the test to run, suffix: s\-seconds, m\-minutes, h\-hours,
d\-days e.g.: \-\-time=2h.
.TP
.B \-F, \-\-cfg_cmd=
How long the test to run, suffix: s\-seconds, m\-minutes, h\-hours,
d\-days e.g.: \-\-time=2h.
.TP
.B \-F, \-\-cfg_cmd=
-.
Load the configure file to get command,key and value distribution list.
.TP
.B \-w, \-\-win_size=
Load the configure file to get command,key and value distribution list.
.TP
.B \-w, \-\-win_size=
-.
Task window size of each concurrency, suffix: K, M e.g.: \-\-win_size=10k.
Default 10k.
.TP
.B \-X, \-\-fixed_size=
Task window size of each concurrency, suffix: K, M e.g.: \-\-win_size=10k.
Default 10k.
.TP
.B \-X, \-\-fixed_size=
-.
Fixed length of value.
.TP
.B \-v, \-\-verify=
Fixed length of value.
.TP
.B \-v, \-\-verify=
-.
The proportion of date verification, e.g.: \-\-verify=0.01
.TP
.B \-d, \-\-division=
The proportion of date verification, e.g.: \-\-verify=0.01
.TP
.B \-d, \-\-division=
-.
Number of keys to multi\-get once. Default 1, means single get.
.TP
.B \-S, \-\-stat_freq=
Number of keys to multi\-get once. Default 1, means single get.
.TP
.B \-S, \-\-stat_freq=
-.
Frequency of dumping statistic information. suffix: s\-seconds,
m\-minutes, e.g.: \-\-resp_freq=10s.
.TP
.B \-e, \-\-exp_verify=
Frequency of dumping statistic information. suffix: s\-seconds,
m\-minutes, e.g.: \-\-resp_freq=10s.
.TP
.B \-e, \-\-exp_verify=
-.
The proportion of objects with expire time, e.g.: \-\-exp_verify=0.01.
Default no object with expire time
.TP
.B \-o, \-\-overwrite=
The proportion of objects with expire time, e.g.: \-\-exp_verify=0.01.
Default no object with expire time
.TP
.B \-o, \-\-overwrite=
-.
The proportion of objects need overwrite, e.g.: \-\-overwrite=0.01.
Default never overwrite object.
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-reconnect
The proportion of objects need overwrite, e.g.: \-\-overwrite=0.01.
Default never overwrite object.
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-reconnect
-.
Reconnect tests, when connection is closed it will be reconnected.
.TP
.B \-U, \-\-udp
Reconnect tests, when connection is closed it will be reconnected.
.TP
.B \-U, \-\-udp
-.
UDP tests, default memaslap uses TCP, TCP port and UDP port of
server must be same.
.TP
.B \-a, \-\-facebook
UDP tests, default memaslap uses TCP, TCP port and UDP port of
server must be same.
.TP
.B \-a, \-\-facebook
-.
Whether it enables facebook test feature, set with TCP and multi\-get with UDP.
.TP
.B \-B, \-\-binary
Whether it enables facebook test feature, set with TCP and multi\-get with UDP.
.TP
.B \-B, \-\-binary
-.
Whether it enables binary protocol. Default with ASCII protocol.
.UNINDENT
.INDENT 0.0
.TP
.B \-P, \-\-tps=
Whether it enables binary protocol. Default with ASCII protocol.
.UNINDENT
.INDENT 0.0
.TP
.B \-P, \-\-tps=
-.
Expected throughput, suffix: K, e.g.: \-\-tps=10k.
.TP
.B \-p, \-\-rep_write=
Expected throughput, suffix: K, e.g.: \-\-tps=10k.
.TP
.B \-p, \-\-rep_write=
-.
The first nth servers can write data, e.g.: \-\-rep_write=2.
.UNINDENT
.INDENT 0.0
.TP
.B \-b, \-\-verbose
The first nth servers can write data, e.g.: \-\-rep_write=2.
.UNINDENT
.INDENT 0.0
.TP
.B \-b, \-\-verbose
-.
Whether it outputs detailed information when verification fails.
.TP
.B \-h, \-\-help
Whether it outputs detailed information when verification fails.
.TP
.B \-h, \-\-help
-.
Display this message and then exit.
.TP
.B \-V, \-\-version
Display this message and then exit.
.TP
.B \-V, \-\-version
-.
Display the version of the application and then exit.
.UNINDENT
.SH EXAMPLES
Display the version of the application and then exit.
.UNINDENT
.SH EXAMPLES