1MEMHOG(8)                Linux Administrator's Manual                MEMHOG(8)
2
3
4

NAME

6       memhog - Allocates memory with policy for testing
7

SYNOPSIS

9       memhog [ -r<NUM> ] [ size kmg ] [ policy nodeset ] [ -f<filename> ]
10

DESCRIPTION

12       memhog  mmaps a memory region for a given size and sets the numa policy
13       (if specified).  It then updates the memory region for the given number
14       of iterations using memset.
15
16       -r<num>    Repeat memset NUM times
17       -f<file>   Open file for mmap backing
18       -H         Disable transparent hugepages
19       -size      Allocation size in bytes, may have case-insensitive order
20                  suffix (G=gigabyte, M=megabyte, K=kilobyte)
21
22       Supported numa-policies:
23
24       interleave
25              Memory will be allocated using round robin on nodes. When memory
26              cannot be allocated on the current interleave, target fall  back
27              to other nodes.  Multiple nodes may be specified.
28
29       membind
30              Only   allocate   memory  from  nodes. Allocation will fail when
31              there is not enough memory available on  these  nodes.  Multiple
32              nodes  may be specified.
33
34       preferred
35              Preferably  allocate  memory  on  node,  but if memory cannot be
36              allocated  there  fall  back  to other nodes.  This option takes
37              only a single node number.
38
39       default
40              Memory  will be allocated on the local node (the node the thread
41              is running on)
42
43

EXAMPLES

45       # Allocate a 1G region, mmap backed by  memhog.mmap  file,  membind  to
46       node 0, repeat test 6 times
47              memhog -r6 1G --membind 0 -fmemhog.mmap
48
49       #  Allocate  a 1G region, iterleave across nodes 0,1,2,3, repeat test 4
50       times
51              memhog -r4 1G --interleave 0-3
52
53       # Allocate a 1G region, (implicit) default policy, repeat test 8 times
54              memhog -r8 1G
55
56

AUTHORS

58       Andi Kleen (ak@suse.de)
59
60

LICENSE

62       GPL v2
63
64

SEE ALSO

66       mmap(2), memset(3), numactl(8), numastat(8)
67
68
69
70SuSE Labs                          2003,2004                         MEMHOG(8)