CTPH

Category: Hashing

Status: Registered and callable in the CyberChef 11.3.0 compatibility inventory.

Input / output: string → string

Background: https://forensics.wiki/context_triggered_piecewise_hashing/

What it does

Context Triggered Piecewise Hashing, also called Fuzzy Hashing, can match inputs that have homologies. Such inputs have sequences of identical bytes in the same order, although bytes in between these sequences may be different in both content and length. CTPH was originally based on the work of Dr. Andrew Tridgell and a spam email detector called SpamSum. This method was adapted by Jesse Kornblum and published at the DFRWS conference in 2006 in a paper ‘Identifying Almost Identical Files Using Context Triggered Piecewise Hashing’.

Note

Status here means the operation name is implemented and callable. It does not by itself promise byte-for-byte parity for every upstream option. See Compatibility and current status for the verified scope and known boundaries.

Arguments and options

This operation takes no positional recipe arguments.

Recipe template

Important

This is a call template built from the documented defaults. Replace placeholder values such as empty keys, paths, patterns, or lookup data before running it.

from pychef import bake

input_value = "example"
args = []
result = bake(input_value, ['CTPH'])
print(result)

Pipeline example

from pychef import Pipeline

args = []
transform = Pipeline().then('CTPH')
result = transform("example")

Dedicated operation module

The registered entry point lives in pychef.operations.by_operation.ctph. Direct calls receive the input value and a positional argument tuple:

from pychef.operations.by_operation.ctph import run

result = run("example", tuple([]))
pychef.operations.by_operation.ctph.run(value, args)

Run this operation using its shared internal implementation.

Parameters:
  • value (str | bytes)

  • args (Sequence[Any])

Return type:

str | bytes