hakmem/core/hakmem_tiny_superslab_constants.h

// hakmem_tiny_superslab_constants.h - SuperSlab Layout Constants
// Purpose: Centralize all SuperSlab layout magic numbers
// Phase 6-2.5: Created to fix sizeof(SuperSlab) vs hardcoded offset mismatch

#ifndef HAKMEM_TINY_SUPERSLAB_CONSTANTS_H
#define HAKMEM_TINY_SUPERSLAB_CONSTANTS_H

// ============================================================================
// SuperSlab Layout Constants
// ============================================================================

// Log2 range for SuperSlab sizes (in MB):
//  - MIN:  1MB (2^20)
//  - MAX:  2MB (2^21)
//  - DEFAULT: 2MB unless constrained by ACE/env
#ifndef SUPERSLAB_LG_MIN
#define SUPERSLAB_LG_MIN 20
#endif
#ifndef SUPERSLAB_LG_MAX
#define SUPERSLAB_LG_MAX 21
#endif
#ifndef SUPERSLAB_LG_DEFAULT
#define SUPERSLAB_LG_DEFAULT 21
#endif

// Size of each slab within SuperSlab (fixed, never changes)
#define SLAB_SIZE (64 * 1024)  // 64KB per slab

// SuperSlab struct size (as of Phase 6-2.5)
// Actual value: sizeof(SuperSlab) = 1088 bytes
// This includes: magic, lg_size, size_class, total_active_blocks,
//                remote_heads[], slabs[], slab_listed[], etc.
#define SUPERSLAB_HEADER_SIZE 1088

// Slab 0 data offset (CRITICAL: Must be aligned to largest block size)
// Phase 6-2.5 FIX: Changed from 1024 to 2048
//
// Why 2048?
// - sizeof(SuperSlab) = 1088 bytes
// - Largest block size = 1024 bytes (class 7)
// - Must round up to next 1024-byte boundary: (1088 + 1023) & ~1023 = 2048
//
// Layout:
//   [0..1087]     SuperSlab header (1088 bytes)
//   [1088..2047]  Padding (960 bytes, unused)
//   [2048..65535] Slab 0 data (63488 bytes = 64KB - 2048)
//
// Previous value (1024) caused:
// - 64-byte overlap with SuperSlab metadata (corruption)
// - Misalignment for class 7 allocations (1024 % 1024 != 0)
#define SUPERSLAB_SLAB0_DATA_OFFSET 2048

// Slab 0 usable size (for capacity calculation)
#define SUPERSLAB_SLAB0_USABLE_SIZE (SLAB_SIZE - SUPERSLAB_SLAB0_DATA_OFFSET)  // 63488 bytes

// Regular slab (i > 0) usable size
#define SUPERSLAB_SLAB_USABLE_SIZE SLAB_SIZE  // 65536 bytes

// ============================================================================
// Validation (compile-time check)
// ============================================================================

// Ensure SLAB0_DATA_OFFSET is aligned to largest block size (1024)
#if (SUPERSLAB_SLAB0_DATA_OFFSET % 1024) != 0
#error "SUPERSLAB_SLAB0_DATA_OFFSET must be 1024-byte aligned for class 7"
#endif

// Ensure SLAB0_DATA_OFFSET is large enough to contain SuperSlab header
#if SUPERSLAB_SLAB0_DATA_OFFSET < SUPERSLAB_HEADER_SIZE
#error "SUPERSLAB_SLAB0_DATA_OFFSET must be >= sizeof(SuperSlab)"
#endif

#endif // HAKMEM_TINY_SUPERSLAB_CONSTANTS_H