mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
b627b8d8e1
This commit is based on the s390-tools-1.39.0 version. Changes on top of s390-tools-1.39.0: - Add MIT license to all source files - Add LICENSE file - Transform REAMDE to README.md (markdown) - Add AUTHORS.md file - Add CONTRIBUTING.md file - Move changelog from README to CHANGELOG.md file Reviewed-by: Stefan Haberland <sth@linux.vnet.ibm.com> Signed-off-by: Michael Holzheu <holzheu@linux.vnet.ibm.com>
76 lines
2.0 KiB
Groff
76 lines
2.0 KiB
Groff
.\" Copyright 2017 IBM Corp.
|
|
.\" s390-tools is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the MIT license. See LICENSE for details.
|
|
.\"
|
|
.TH CHMEM 8 "Apr 2010" "s390-tools"
|
|
.
|
|
.
|
|
.SH NAME
|
|
chmem \- set memory online or offline.
|
|
.
|
|
.SH SYNOPSIS
|
|
.B chmem
|
|
.RB OPTIONS
|
|
.RB [SIZE|RANGE]
|
|
.
|
|
.
|
|
.SH DESCRIPTION
|
|
The chmem command sets a particular size or range of memory online or offline.
|
|
.
|
|
.IP "\(hy" 2
|
|
Specify SIZE as <size>[m|M|g|G]. With m or M, <size> specifies the memory
|
|
size in MB (1024 x 1024 bytes). With g or G, <size> specifies the memory size
|
|
in GB (1024 x 1024 x 1024 bytes). The default unit is MB.
|
|
.
|
|
.IP "\(hy" 2
|
|
Specify RANGE in the form 0x<start>-0x<end> as shown in the output of the
|
|
lsmem command. <start> is the hexadecimal address of the first byte and <end>
|
|
is the hexadecimal address of the last byte in the memory range.
|
|
.
|
|
.PP
|
|
SIZE and RANGE must be aligned to the Linux memory block size, as shown in
|
|
the output of the lsmem command.
|
|
|
|
Setting memory online can fail if the hypervisor does not have enough memory
|
|
left, for example because memory was overcommitted. Setting memory offline can
|
|
fail if Linux cannot free the memory. If only part of the requested memory can
|
|
be set online or offline, a message tells you how much memory was set online
|
|
or offline instead of the requested amount.
|
|
.
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Print a short help text, then exit.
|
|
.
|
|
.TP
|
|
.BR \-v ", " \-\-version
|
|
Print the version number, then exit.
|
|
.
|
|
.TP
|
|
.BR \-e ", " \-\-enable
|
|
Set the given RANGE or SIZE of memory online.
|
|
.
|
|
.TP
|
|
.BR \-d ", " \-\-disable
|
|
Set the given RANGE or SIZE of memory offline.
|
|
.
|
|
.
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B chmem --enable 1024
|
|
This command requests 1024 MB of memory to be set online.
|
|
.
|
|
.TP
|
|
.B chmem -e 2g
|
|
This command requests 2 GB of memory to be set online.
|
|
.
|
|
.TP
|
|
.B chmem --disable 0x00000000e4000000-0x00000000f3ffffff
|
|
This command requests the memory range starting with 0x00000000e4000000
|
|
and ending with 0x00000000f3ffffff to be set offline.
|
|
.
|
|
.
|
|
.SH SEE ALSO
|
|
.BR lsmem (8)
|