.. _benchmark-perf-mem:

perf/mem
========

perf bench mem benchmarks measuring demand-fault and memset throughput.

Benchmark Profile
-----------------

- Type: Micro
- Kernel subsystem: Memory management, page faults, page clearing, hugetlb
- Coverage: Directly measured
- Topology: Single role: executer

Overview
--------

Runs demand-faulted 32 GB mappings backed by 4 KB and 1 GB pages, plus a
16 GB memset using 1 GB chunks. The runner temporarily reserves the 32
required 1 GB huge pages at runtime and restores the original pool size
after the 1 GB mmap variant. Sensitive to page allocation, fault handling,
page clearing, hugetlb and memset changes.

Fastpath Parameters
-------------------

==========  ===========================================================================
Name        Description
==========  ===========================================================================
collection  perf bench collection to run. Set to 'mem'.
benchmark   Comma-separated list of perf bench mem commands, including their arguments.
==========  ===========================================================================

Result Classes
--------------

Result class names contain the complete command, so the mmap page-size
variants and the memset control remain separate.

Fastpath Metadata
-----------------

==================  =======================================================================
Field               Value
==================  =======================================================================
Suite               perf
Name                mem
Type                micro
Container Image     registry.gitlab.arm.com/tooling/fastpath/containers/microbench:v2.4
Documentation Path  documentation/user-guide/benchmarkcatalog/perf-mem.rst
Documentation URL   https://fastpath.docs.arm.com/user-guide/benchmarkcatalog/perf-mem.html
==================  =======================================================================