Files
vystem/docs/kerneltools/vmemcheck.md
2026-03-31 22:15:00 +02:00

1.0 KiB

Virtual memory checker

Introduction

This file is responsible for checking that there is no overlapp between virtual pages range defined in shelter/lib/include/memory/vmem_layout.h. For the full documentation about this file, please see virtual memory layout documentation.

Usage

The script is located inside shelter/tools/checker/vmem_layout_checker.py.

It can be used like that:

python shelter/tools/checker/vmem_layout_checker.py <path to header file>

Detailled processus

  1. Open provided file, parse it and print the list of valid regions.
  2. Generate cfile.c to let the compiler do the hard work of parsing macro declaration
  3. Compile (the gcc compiler must be accessible inside the path) and run the generated C program
  4. Recover the output of the program, parse it to obtain start and size of each virtual region
  5. Check for overlaps and return an error if something went bad during the processus

The compiled program and the C file are deleted afterward.