OS Manuals

/usr/bin/memaslap

Client library and command line tools for memcached server (resurrected)

From libmemcached 1.1.4-r8 (os), captured 2026-11-05 by running memaslap --help (exit 0). permalink

memaslap v1.0
    Generates workload against memcached servers.

Usage:
    memaslap -hV | -s servers [-F config_file] [-t time | -x exe_num] [...]

Options:
    -s, --servers=
        List one or more servers to connect. Servers count must be less than
        threads count. e.g.: --servers=localhost:1234,localhost:11211
    -T, --threads=
        Number of threads to startup, better equal to CPU numbers. Default 8.
    -c, --concurrency=
        Number of concurrency to simulate with load. Default 128.
    -n, --conn_sock=
        Number of TCP socks per concurrency. Default 1.
    -x, --execute_number=
        Number of operations(get and set) to execute for the
        given test. Default 1000000.
    -t, --time=
        How long the test to run, suffix: s-seconds, m-minutes, h-hours,
        d-days e.g.: --time=2h.
    -F, --cfg_cmd=
        Load the configure file to get command,key and value distribution list.
    -w, --win_size=
        Task window size of each concurrency, suffix: K, M e.g.: --win_size=10k.
        Default 10k.
    -X, --fixed_size=
        Fixed length of value.
    -v, --verify=
        The proportion of date verification, e.g.: --verify=0.01
    -d, --division=
        Number of keys to multi-get once. Default 1, means single get.
    -S, --stat_freq=
        Frequency of dumping statistic information. suffix: s-seconds,
        m-minutes, e.g.: --resp_freq=10s.
    -e, --exp_verify=
        The proportion of objects with expire time, e.g.: --exp_verify=0.01.
        Default no object with expire time
    -o, --overwrite=
        The proportion of objects need overwrite, e.g.: --overwrite=0.01.
        Default never overwrite object.
    -R, --reconnect
        Reconnect support, when connection is closed it will be reconnected.
    -U, --udp
        UDP support, by default memaslap uses TCP; TCP port and UDP port of
        server must be same.
    -a, --facebook
        Whether it enables facebook test feature, set with TCP and multi-get with UDP.
    -B, --binary
        Whether it enables binary protocol. Default with ASCII protocol.
    -P, --tps=
        Expected throughput, suffix: K, e.g.: --tps=10k.
    -p, --rep_write=
        The first nth servers can write data, e.g.: --rep_write=2.
    -b, --verbose
        Whether it outputs detailed information when verification fails.
    -h, --help
        Display this message and then exit.
    -V, --version
        Display the version of the application and then exit.

Examples:
    memaslap -s 127.0.0.1:11211 -S 5s
    memaslap -s 127.0.0.1:11211 -t 2m -v 0.2 -e 0.05 -b
    memaslap -s 127.0.0.1:11211 -F config -t 2m -w 40k -S 20s -o 0.2
    memaslap -s 127.0.0.1:11211 -F config -t 2m -T 4 -c 128 -d 20 -P 40k
    memaslap -s 127.0.0.1:11211 -F config -t 2m -d 50 -a -n 40
    memaslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m
    memaslap -s 127.0.0.1:11211,127.0.0.1:11212 -F config -t 2m -p 2
Options (23)
OptionDescriptionSource
-s, --serversList one or more servers to connect.help
-T, --threadsNumber of threads to startup, better equal to CPU numbers.help
-c, --concurrencyNumber of concurrency to simulate with load.help
-n, --conn_sockNumber of TCP socks per concurrency.help
-x, --execute_numberNumber of operations(get and set) to execute for the given test.help
-t, --timeHow long the test to run, suffix: s-seconds, m-minutes, h-hours, d-days e.g.: --time=2h.help
-F, --cfg_cmdLoad the configure file to get command,key and value distribution list.help
-w, --win_sizeTask window size of each concurrency, suffix: K, M e.g.: --win_size=10k.help
-X, --fixed_sizeFixed length of value.help
-v, --verifyThe proportion of date verification, e.g.: --verify=0.01help
-d, --divisionNumber of keys to multi-get once.help
-S, --stat_freqFrequency of dumping statistic information.help
-e, --exp_verifyThe proportion of objects with expire time, e.g.: --exp_verify=0.01.help
-o, --overwriteThe proportion of objects need overwrite, e.g.: --overwrite=0.01.help
-R, --reconnectReconnect support, when connection is closed it will be reconnected.help
-U, --udpUDP support, by default memaslap uses TCP;help
-a, --facebookWhether it enables facebook test feature, set with TCP and multi-get with UDP.help
-B, --binaryWhether it enables binary protocol.help
-P, --tpsExpected throughput, suffix: K, e.g.: --tps=10k.help
-p, --rep_writeThe first nth servers can write data, e.g.: --rep_write=2.help
-b, --verboseWhether it outputs detailed information when verification fails.help
-h, --helpDisplay this message and then exit.help
-V, --versionDisplay the version of the application and then exit.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.