1LSMEM(1) User Commands LSMEM(1)
2
6 lsmem - list the ranges of available memory with their online status
7
9 lsmem [options]
10
12 The lsmem command lists the ranges of available memory with their
13 online status. The listed memory blocks correspond to the memory block
14 representation in sysfs. The command also shows the memory block size
15 and the amount of memory in online and offline state.
16 The default output compatible with original implementation from
18 s390-tools, but it's strongly recommended to avoid using default out‐
19 puts in your scripts. Always explicitly define expected columns by
20 using the --output option together with a columns list in environments
21 where a stable output is required.
22 The lsmem command lists a new memory range always when the current mem‐
24 ory block distinguish from the previous block by some output column.
25 This default behavior is possible to override by the --split option
26 (e.g., lsmem --split=ZONES). The special word "none" may be used to
27 ignore all differences between memory blocks and to create as large as
28 possible continuous ranges. The opposite semantic is --all to list
29 individual memory blocks.
30 Note that some output columns may provide inaccurate information if a
32 split policy forces lsmem to ignore differences in some attributes. For
33 example if you merge removable and non-removable memory blocks to the
34 one range than all the range will be marked as non-removable on lsmem
35 output.
36 Not all columns are supported on all systems. If an unsupported column
38 is specified, lsmem prints the column but does not provide any data for
39 it.
40 Use the --help option to see the columns description.
42
45 -a, --all
46 List each individual memory block, instead of combining memory
47 blocks with similar attributes.
48 -b, --bytes
50 Print the SIZE column in bytes rather than in a human-readable
51 format.
52 -h, --help
54 Display help text and exit.
55 -J, --json
57 Use JSON output format.
58 -n, --noheadings
60 Do not print a header line.
61 -o, --output list
63 Specify which output columns to print. Use --help to get a list
64 of all supported columns. The default list of columns may be
65 extended if list is specified in the format +list (e.g., lsmem
66 -o +NODE).
67 --output-all
69 Output all available columns.
70 -P, --pairs
72 Produce output in the form of key="value" pairs. All poten‐
73 tially unsafe characters are hex-escaped (\x<code>).
74 -r, --raw
76 Produce output in raw format. All potentially unsafe characters
77 are hex-escaped (\x<code>).
78 -S, --split list
80 Specify which columns (attributes) use to split memory blocks to
81 ranges. The supported columns are STATE, REMOVABLE, NODE and
82 ZONES, or "none". The other columns are silently ignored. For
83 more details see DESCRIPTION above.
84 -s, --sysroot directory
86 Gather memory data for a Linux instance other than the instance
87 from which the lsmem command is issued. The specified directory
88 is the system root of the Linux instance to be inspected.
89 -V, --version
91 Display version information and exit.
92 --summary[=when]
94 This option controls summary lines output. The optional argu‐
95 ment when can be never, always or only. If the when argument is
96 omitted, it defaults to "only". The summary output is suppressed
97 for --raw, --pairs and --json.
98
100 lsmem was originally written by Gerald Schaefer for s390-tools in Perl.
101 The C version for util-linux was written by Clemens von Mann, Heiko
102 Carstens and Karel Zak.
103
105 chmem(8)
106
108 The lsmem command is part of the util-linux package and is available
109 from Linux Kernel Archive ⟨https://www.kernel.org/pub/linux/utils/util-
110 linux/⟩.
111util-linux October 2016 LSMEM(1)