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

NAME
       memhog - Allocates memory with policy for testing

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

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
              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
              Only  allocate  memory  from  nodes. Allocation will fail when
              there is not enough memory available on these nodes. Multiple
              nodes  may be specified.

       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
              Memory will be allocated on the local node (the node the thread
              is running on)


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
       Andi Kleen (ak@suse.de)


LICENSE
       GPL v2


SEE ALSO
       mmap(2), memset(3), numactl(8), numastat(8)

SuSE Labs                          2003,2004                         MEMHOG(8)