Reference Guide

Syntax: memtool <option>
Show the Help-text:=
memtool --h
(or)
memtool -h
Display the configuration info of the device:=
memtool --info
(or)
memtool -i
List all of the memory regions in the config file:=
memtool --list
(or)
memtool -l
Test using the MEM test config file:=
memtool --test --region=<region/'ALL'> [--testlist=<test0>,<test1>...]
(or)
memtool -t -G <region/ALL> [-T <test0>,<test1>,...]
Read the specified physical address:=
memtool --read --addr=<address> --count=<bytes> [--width=<8/16/32>]
(or)
memtool -r -a <address> -C <bytes> [-W <#8,16,32>]
Write at the specified physical address:=
memtool --write --addr=<address> --val=<data0>,<data1>, ... ,<dataN> [--
width=<8/16/32>] (or)
memtool -w -a <address> -V <data0>,<data1>...,<dataN> [-W <8/16/32>]
Execute repeatedly command by count:=
memtool --iteration=max/<count> [option1] [option2]...
(or)
memtool -I max/<count> [option1] [option2]...
Usage:=
-h, --h Show the help text
-t, --test Test using the pre-programmed configuration or use supplied config
-i, --info Configuration information
-l, --list List the understood TLV codes and names
-G, --region Region
-T, --testlist List of tests
-I, --iteration= Iteration command execution
-C, --count= Count
-a, --addr= Address
-r, --read Read operation
-w, --write Write operation
-V, --val= Value to be set
-W, --width Width {8,16}
Available Tests are:
ALL_TESTS, ADDRESS_READ, ADDRESS_WRITE, ADDRESS_WALKING1, ADDRESS_WALKING0,
DATA_READ,
DATA_WRITE, DATA_WALKING1, DATA_WALKING0, DATA_SLIDING1, DATA_SLIDING0, DATA_PATTERN,
DATA_CACHE
e.g. ADDRESS_WALKING1,DATA_WALKING1
The memtool uses long options for the parameters that requires two hyphens in front of the options. Options are required,
optional, or none. You use a parameter, it is specified as such and must include an equal sign; if an option is optional, it is
enclosed with square brackets. However, do not type the brackets at the CLI. For example, the -region and -testlist
options are optional and you must enter them as -region=0 and -testlist=0.
● List—Lists the memory regions SDI knows. The tool queries SDI for the regions and prints a list of the regions with a
region number that you can use for the subsequent options requiring a region number.
● Info—Lists the SPD information for the specified regions. Specifying a region allows the tool to read SPD from different
DIMM modules, each specified in its own region. The output lists the actual data read and completes some parsing of the
parameters so you do not have to decode the values. Decoding is based on the SPD standard definition for DDR3 and DDR4
DIMM memory.
● Test—Runs tests that include: Address Read/Write, Address Walking 1/0, Data Read/Write, Data Walking 1/0, Data Sliding
1/0, and Data Patterns (that writes Hamming patterns that you can use to detect multiple bit errors and identify single bit
errors). These tests run during the normal memory tests. In extended memory tests, the data cache memory test runs. This
test is lengthy and causes multiple ejections of data from the cache and tests the caches.
In Verbosity 0, only the pass/fail message prints for all the tests. In Verbosity 1, each test prints its own pass/fail and other
information; for example, what failed in the test. Higher verbosities show where each pass of the test performs and has
verbose output. All output, regardless of verbosity, is in the log. You can see every level of detail by referring to the log.
58
Dell EMC DIAG OS tools