aboutsummaryrefslogtreecommitdiff
path: root/src/kernels.h
diff options
context:
space:
mode:
authorOnur Gündüz <ogunduz@gmail.com>2026-06-20 20:10:56 +0200
committerOnur Gündüz <ogunduz@gmail.com>2026-06-21 05:57:19 +0200
commit6b969d25ce136eaf695222bd1a10bff1ecac0220 (patch)
treec23afb50c28b9deaddae5c6526a74ee11cf2d865 /src/kernels.h
parentd4bdb8dae753462f621507d5fc3582e0e53da35c (diff)
downloadffwd-6b969d25ce136eaf695222bd1a10bff1ecac0220.tar.gz
ffwd-6b969d25ce136eaf695222bd1a10bff1ecac0220.zip
all: split Makefile and reorg library/tools
Diffstat (limited to 'src/kernels.h')
-rw-r--r--src/kernels.h216
1 files changed, 0 insertions, 216 deletions
diff --git a/src/kernels.h b/src/kernels.h
deleted file mode 100644
index 17c45c0..0000000
--- a/src/kernels.h
+++ /dev/null
@@ -1,216 +0,0 @@
-/*
- * embed_kernels.h - Math kernels for Qwen3-architecture inference
- *
- * Low-level math operations. All operate on float32 tensors in row-major order.
- */
-
-#ifndef EMBED_KERNELS_H
-#define EMBED_KERNELS_H
-
-/* Public-API export annotation. The libraries are built with
- * -fvisibility=hidden, so only declarations carrying EMBED_API are exported
- * from the shared library; everything else stays internal. */
-#ifndef EMBED_API
-#if defined(__GNUC__)
-#define EMBED_API __attribute__((visibility("default")))
-#else
-#define EMBED_API
-#endif
-#endif
-
-#include <stddef.h>
-#include <stdint.h>
-
-/* ========================================================================
- * Basic Operations
- * ======================================================================== */
-
-void embed_add_inplace(float *a, const float *b, int n);
-
-/* ========================================================================
- * Matrix Operations
- * ======================================================================== */
-
-/* C = A @ B^T: A[M,K], B[N,K], C[M,N] */
-void embed_matmul_t(float *C, const float *A, const float *B, int M, int K, int N);
-
-/* y = x @ W^T + b: x[seq,in], W[out,in], b[out], y[seq,out] */
-void embed_linear(
- float *y, const float *x, const float *W, const float *b, int seq_len, int in_dim, int out_dim);
-
-void embed_linear_nobias(
- float *y, const float *x, const float *W, int seq_len, int in_dim, int out_dim);
-
-/* bf16 weight variants */
-
-void embed_bf16_to_f32_buf(float *dst, const uint16_t *src, size_t n);
-void embed_linear_nobias_bf16(
- float *y, const float *x, const uint16_t *W_bf16, int seq_len, int in_dim, int out_dim);
-
-/* Small-sequence BF16 path: compute two projections with one threaded dispatch. */
-void embed_linear_nobias_bf16_pair(float *a,
- float *b,
- const float *x,
- const uint16_t *Wa_bf16,
- const uint16_t *Wb_bf16,
- int seq_len,
- int in_dim,
- int a_dim,
- int b_dim);
-
-/* Small-sequence BF16 path: compute Q/K/V matvecs with one threaded dispatch. */
-void embed_linear_nobias_bf16_qkv(float *q,
- float *k,
- float *v,
- const float *x,
- const uint16_t *Wq_bf16,
- const uint16_t *Wk_bf16,
- const uint16_t *Wv_bf16,
- int seq_len,
- int in_dim,
- int q_dim,
- int kv_dim);
-
-/* Dot product using the best available local SIMD implementation. */
-float embed_dot_f32(const float *a, const float *b, int n);
-
-/* ========================================================================
- * Normalization
- * ======================================================================== */
-
-/* RMS Normalization: out = x / rms(x) * weight */
-void embed_rms_norm(
- float *out, const float *x, const float *weight, int seq_len, int hidden, float eps);
-
-/* Per-head RMS Normalization for Q/K norms in decoder
- * x: [seq, n_heads, head_dim], weight: [head_dim]
- * Normalizes each head independently */
-void embed_rms_norm_per_head(
- float *x, const float *weight, int seq_len, int n_heads, int head_dim, float eps);
-
-/* Layer Normalization (BERT family): out = gamma * (x - mean) / sqrt(var + eps)
- * + beta, with mean and biased (population) variance over the hidden axis per
- * row. Unlike RMSNorm this subtracts the mean and adds a bias. */
-void embed_layer_norm(float *out,
- const float *x,
- const float *gamma,
- const float *beta,
- int seq_len,
- int hidden,
- float eps);
-
-/* ========================================================================
- * Activation Functions
- * ======================================================================== */
-
-void embed_softmax(float *x, int rows, int cols);
-/* gate = SiLU(gate) * up */
-void embed_silu_mul_inplace(float *gate, const float *up, int n);
-
-/* Exact (erf) GeLU in place: x = 0.5 * x * (1 + erf(x / sqrt(2))). This is the
- * "gelu" activation HF BERT/BGE/MiniLM use, not the tanh approximation. */
-void embed_gelu_inplace(float *x, int n);
-
-/* Tanh-approximation GeLU in place (HF gelu_new / gelu_pytorch_tanh):
- * x = 0.5 * x * (1 + tanh(sqrt(2/pi) * (x + 0.044715 * x^3))). */
-void embed_gelu_tanh_inplace(float *x, int n);
-
-/* ========================================================================
- * Attention Operations
- * ======================================================================== */
-
-/*
- * Bidirectional GQA attention over a packed/ragged batch.
- *
- * Q: [total_seq, n_heads * head_dim]
- * K,V: [total_seq, n_kv_heads * head_dim]
- * offsets: [batch + 1], token spans for each sequence.
- *
- * Attention is block-diagonal: tokens only attend within their own
- * offsets[b]..offsets[b+1] span.
- */
-void embed_bidirectional_gqa_attention_packed(float *out,
- const float *Q,
- const float *K,
- const float *V,
- const int *offsets,
- int batch,
- int n_heads,
- int n_kv_heads,
- int head_dim,
- float scale);
-
-/* Optional reusable scratch for the BLAS-tiled packed attention path. */
-size_t embed_bidirectional_gqa_attention_packed_scratch_bytes(const int *offsets, int batch);
-void embed_bidirectional_gqa_attention_packed_with_scratch(float *out,
- const float *Q,
- const float *K,
- const float *V,
- const int *offsets,
- int batch,
- int n_heads,
- int n_kv_heads,
- int head_dim,
- float scale,
- float *scratch,
- size_t scratch_bytes);
-
-/*
- * Causal GQA attention over a packed/ragged batch. Query position i attends
- * only to positions at or before i within its sequence.
- */
-void embed_causal_gqa_attention_packed(float *out,
- const float *Q,
- const float *K,
- const float *V,
- const int *offsets,
- int batch,
- int n_heads,
- int n_kv_heads,
- int head_dim,
- float scale);
-void embed_causal_gqa_attention_packed_with_scratch(float *out,
- const float *Q,
- const float *K,
- const float *V,
- const int *offsets,
- int batch,
- int n_heads,
- int n_kv_heads,
- int head_dim,
- float scale,
- float *scratch,
- size_t scratch_bytes);
-
-/* ========================================================================
- * Position Embeddings
- * ======================================================================== */
-
-/*
- * NeoX-style RoPE: compute cos/sin for positions.
- * cos_out, sin_out: [seq, head_dim]
- * cos[d] and cos[half+d] are the same (duplicated for full head_dim).
- */
-void embed_compute_rope_neox(
- float *cos_out, float *sin_out, const int *positions, int seq, int head_dim, float theta);
-
-/*
- * Apply NeoX-style RoPE to Q or K.
- * x: [seq, n_heads * head_dim] (in-place)
- * cos_vals, sin_vals: [seq, head_dim]
- */
-void embed_apply_rope_neox(
- float *x, const float *cos_vals, const float *sin_vals, int seq, int n_heads, int head_dim);
-
-/* ========================================================================
- * Threading
- * ======================================================================== */
-
-/* The persistent worker pool lives in threadpool.{c,h}; included here so kernel
- * callers keep getting embed_set_threads / embed_get_num_cpus from one header. */
-#include "threadpool.h"
-
-/* Global verbose flag */
-EMBED_API extern int embed_verbose;
-
-#endif /* EMBED_KERNELS_H */