Files
hakmem/core/box/front_gate_box.c
Moe Charm (CI) 6859d589ea Add Box 3 (Pointer Conversion Layer) and fix POOL_TLS_PHASE1 default
## Major Changes

### 1. Box 3: Pointer Conversion Module (NEW)
- File: core/box/ptr_conversion_box.h
- Purpose: Unified BASE ↔ USER pointer conversion (single source of truth)
- API: PTR_BASE_TO_USER(), PTR_USER_TO_BASE()
- Features: Zero-overhead inline, debug mode, NULL-safe, class 7 headerless support
- Design: Header-only, fully modular, no external dependencies

### 2. POOL_TLS_PHASE1 Default OFF (CRITICAL FIX)
- File: build.sh
- Change: POOL_TLS_PHASE1 now defaults to 0 (was hardcoded to 1)
- Impact: Eliminates pthread_mutex overhead on every free() (was causing 3.3x slowdown)
- Usage: Set POOL_TLS_PHASE1=1 env var to enable if needed

### 3. Pointer Conversion Fixes (PARTIAL)
- Files: core/box/front_gate_box.c, core/tiny_alloc_fast.inc.h, etc.
- Status: Partial implementation using Box 3 API
- Note: Work in progress, some conversions still need review

### 4. Performance Investigation Report (NEW)
- File: HOTPATH_PERFORMANCE_INVESTIGATION.md
- Findings:
  - Hotpath works (+24% vs baseline) after POOL_TLS fix
  - Still 9.2x slower than system malloc due to:
    * Heavy initialization (23.85% of cycles)
    * Syscall overhead (2,382 syscalls per 100K ops)
    * Workload mismatch (C7 1KB is 49.8%, but only C5 256B has hotpath)
    * 9.4x more instructions than system malloc

### 5. Known Issues
- SEGV at 20K-30K iterations (pre-existing bug, not related to pointer conversions)
- Root cause: Likely active counter corruption or TLS-SLL chain issues
- Status: Under investigation

## Performance Results (100K iterations, 256B)
- Baseline (Hotpath OFF): 7.22M ops/s
- Hotpath ON: 8.98M ops/s (+24% improvement ✓)
- System malloc: 82.2M ops/s (still 9.2x faster)

## Next Steps
- P0: Fix 20K-30K SEGV bug (GDB investigation needed)
- P1: Lazy initialization (+20-25% expected)
- P1: C7 (1KB) hotpath (+30-40% expected, biggest win)
- P2: Reduce syscalls (+15-20% expected)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-12 01:01:23 +09:00

81 lines
2.8 KiB
C

// front_gate_box.c - Front Gate Box (SFC/SLL priority and helpers)
#include "front_gate_box.h"
#include "tiny_alloc_fast_sfc.inc.h"
#include "tls_sll_box.h" // Box TLS-SLL API
#include "ptr_conversion_box.h" // Box 3: Pointer conversions
// TLS SLL state (extern from hakmem_tiny.c)
extern __thread void* g_tls_sll_head[TINY_NUM_CLASSES];
extern __thread uint32_t g_tls_sll_count[TINY_NUM_CLASSES];
extern int g_tls_sll_enable; // set at init via HAKMEM_TINY_TLS_SLL
// Front breakdown counters (extern from hakmem_tiny.c)
extern unsigned long long g_front_sfc_hit[];
extern unsigned long long g_front_sll_hit[];
// SFC feature flag (extern from hakmem_tiny_sfc.c)
extern int g_sfc_enabled;
int front_gate_try_pop(int class_idx, void** out_ptr) {
if (!out_ptr) return 0;
// Layer 0: SFC
if (__builtin_expect(g_sfc_enabled, 1)) {
void* base = sfc_alloc(class_idx);
if (base != NULL) {
g_front_sfc_hit[class_idx]++;
/* BOX_BOUNDARY: Box 1 (SFC) → Box 3 → Box 4 (User) */
/* sfc_alloc returns BASE, must convert to USER for caller */
*out_ptr = PTR_BASE_TO_USER(base, class_idx);
return 1;
}
}
// Layer 1: TLS SLL
if (__builtin_expect(g_tls_sll_enable, 1)) {
void* base = NULL;
if (tls_sll_pop(class_idx, &base)) {
g_front_sll_hit[class_idx]++;
/* BOX_BOUNDARY: Box 1 (TLS SLL) → Box 3 → Box 4 (User) */
/* tls_sll_pop returns BASE, must convert to USER for caller */
*out_ptr = PTR_BASE_TO_USER(base, class_idx);
return 1;
}
}
return 0;
}
// Cascade some of refilled blocks into SFC (one-way, safe)
void front_gate_after_refill(int class_idx, int refilled_count) {
if (!g_sfc_enabled || refilled_count <= 0) return;
int to_move = refilled_count / 2;
if (to_move <= 0) return;
while (to_move-- > 0 && g_tls_sll_count[class_idx] > 0) {
// SLL pop
void* ptr = NULL;
if (!tls_sll_pop(class_idx, &ptr)) break;
// SFC push (capacity-guarded inside sfc_free_push)
if (!sfc_free_push(class_idx, ptr)) {
// If SFC refused (full), stop early to avoid spinning
break;
}
}
}
void front_gate_push_tls(int class_idx, void* ptr) {
// IMPORTANT: ptr is ALREADY a BASE pointer (callers from tiny_free_fast.inc.h
// convert USER→BASE before calling tiny_alloc_fast_push)
// Do NOT double-convert! Pass directly to TLS SLL which expects BASE.
// Use Box TLS-SLL API (C7-safe; expects base pointer)
if (!tls_sll_push(class_idx, ptr, UINT32_MAX)) {
// C7 rejected or capacity exceeded - should not happen in front gate
// but handle gracefully (silent discard)
return;
}
}