MEMHOG(8) Linux Administrator's Manual MEMHOG(8)

# [NAME](#NAME)

memhog - Allocates memory with policy for testing

# [SYNOPSIS](#SYNOPSIS)

**memhog** \[ **-r<NUM>** ] \[ **size kmg** ] \[ **policy nodeset** ] \[ **-f<filename>** ]

# [DESCRIPTION](#DESCRIPTION)

**memhog** mmaps a memory region for a given size and sets the numa policy (if specified). It then updates the memory region for the given number of iterations using memset.

-r<num> Repeat memset NUM times -f<file> Open file for mmap backing -H Disable transparent hugepages -size Allocation size in bytes, may have case-insensitive order suffix (G=gigabyte, M=megabyte, K=kilobyte)

Supported numa-policies:

[**interleave**](#interleave)

Memory will be allocated using round robin on nodes. When memory cannot be allocated on the current interleave, target fall back to other nodes. Multiple nodes may be specified.

[**membind**](#membind)

Only allocate memory from nodes. Allocation will fail when there is not enough memory available on these nodes. Multiple nodes may be specified.

[**preferred**](#preferred)

Preferably allocate memory on node, but if memory cannot be allocated there fall back to other nodes. This option takes only a single node number.

[**default**](#default)

Memory will be allocated on the local node (the node the thread is running on)

# [EXAMPLES](#EXAMPLES)

\# Allocate a 1G region, mmap backed by memhog.mmap file, membind to node 0, repeat test 6 times

memhog -r6 1G --membind 0 -fmemhog.mmap

\# Allocate a 1G region, interleave across nodes 0,1,2,3, repeat test 4 times

memhog -r4 1G --interleave 0-3

\# Allocate a 1G region, (implicit) default policy, repeat test 8 times

memhog -r8 1G

# [AUTHORS](#AUTHORS)

Andi Kleen (ak@suse.de)

# [LICENSE](#LICENSE)

GPL v2

# [SEE ALSO](#SEE_ALSO)

*[mmap(2)](/man/os/numactl/mmap.2), [memset(3)](/man/os/numactl/memset.3), [numactl(8)](/man/os/numactl/numactl.8), [numastat(8)](/man/os/numactl/numastat.8)*

2003,2004 SuSE Labs

---

Document: memhog(8) from numactl 2.0.19-r5 (Chainguard OS)
Source: https://github.com/numactl/numactl