<!DOCTYPE HTML>
<html lang="en">
    <head>
        <meta charset='UTF-8'>
        <title>Harddisk.Tools Documentation</title>
        <link rel='shortcut icon' href='/ico/favicon.ico' type='image/x-icon'>
        <meta http-equiv='CACHE-CONTROL' content='no-cache'>
        <meta http-equiv='CONTENT-LANGUAGE' content='en'>
        <meta http-equiv='EXPIRES' content='Tue, 15 Sep 2026 19:25:46 GMT'>
        <meta http-equiv='LAST-MODIFIED' content='Thu, 17 Sep 2026 19:25:46 GMT'>
        <meta name='description' content='Concept documentation for scans, queries, deduplication, benchmarks and WebFarm pipes.'>
        <meta name='viewport' content='width=device-width, initial-scale=1.0'>
        <meta property='og:type' content='website'>
        <meta property='og:url' content='https://harddisk.tools/docs'>
        <meta property='og:title' content='Harddisk.Tools Documentation'>
        <meta property='og:description' content='Concept documentation for scans, queries, deduplication, benchmarks and WebFarm pipes.'>
        <meta property='og:image' content='https://harddisk.tools/svg/hero-drive-map.svg'>
        <link rel='stylesheet' href='/css/harddisk-tools.css'>

        <script defer src='/js/harddisk-tools.js'></script>

    </head>
    <body class="hdt-site">

<div id="page-91006" class="hdt-shell">


<div id="p91006-block-1" class="hdt-row-block">
<div class="hdt-nav-wrap"><div class="hdt-container hdt-nav"><a class="hdt-brand" href="/"><img src="/svg/logo-mark.svg" alt=""><span>Harddisk.Tools</span></a><button class="hdt-menu-btn" data-menu-toggle aria-label="Menu">☰</button><nav class="hdt-nav-links"><a href="/">Home</a><a href="/features">Features</a><a href="/technology">Technology</a><a href="/forensics">Forensics</a><a href="/benchmarks">Benchmarks</a><a href="/docs">Docs</a><a href="/about">About</a></nav><div class="hdt-nav-actions"><button class="hdt-icon-btn" data-theme-toggle title="Toggle theme">◐</button><a class="hdt-btn hdt-btn-primary" href="/docs">Try the engine</a></div></div></div>

</div>


<div id="p91006-block-2" class="hdt-row-block">
<section class="hdt-page-hero"><div class="hdt-container"><div class="hdt-breadcrumb"><a href="/">Home</a> / Docs</div><span class="hdt-eyebrow">Developer documentation</span><h1>A compact test manual for the future CLI and query layer.</h1><p>Searchable documentation, code blocks, copy buttons, anchored navigation and FAQ behavior all run through the same resource pipeline.</p></div></section>

</div>


<div id="p91006-block-3" class="hdt-row-block">
<section class="hdt-section"><div class="hdt-container"><input class="hdt-search" data-filter-input data-filter-scope="#docs-content" placeholder="Search documentation…"><div style="height:22px"></div><div class="hdt-doc-layout"><aside class="hdt-doc-nav"><strong>On this page</strong><a href="#quickstart">Quickstart</a><a href="#query">Query language</a><a href="#dedup">Dedup</a><a href="#benchmark">Benchmark</a><a href="#pipes">WebFarm pipes</a><a href="#faq">FAQ</a></aside><main class="hdt-doc-content" id="docs-content"><section id="quickstart" data-filter-item><h2>Quickstart</h2><p>Concept syntax for indexing one NTFS volume and opening an interactive query session.</p><div class="hdt-code-wrap"><button class="hdt-copy" data-copy-target="#code-quick">Copy</button><div class="hdt-terminal"><pre id="code-quick">hdt scan C: --mode mft --incremental
hdt catalog status
hdt query "ext:pdf size:&gt;50MB"</pre></div></div></section><section id="query" data-filter-item><h2>Query language</h2><p>Predicates are designed to remain readable while still mapping cleanly to indexes.</p><div class="hdt-table-wrap"><table class="hdt-table"><thead><tr><th>Predicate</th><th>Example</th><th>Meaning</th></tr></thead><tbody><tr><td>ext</td><td>ext:pdf</td><td>extension equals PDF</td></tr><tr><td>size</td><td>size:&gt;1GB</td><td>files larger than 1 GB</td></tr><tr><td>path</td><td>path:*archive*</td><td>path contains archive</td></tr><tr><td>volume</td><td>volume:disk21</td><td>specific catalog volume</td></tr><tr><td>offline</td><td>offline:true</td><td>currently detached sources</td></tr><tr><td>dupes</td><td>dupes:&gt;1</td><td>content has duplicates</td></tr></tbody></table></div></section><section id="dedup" data-filter-item><h2>Dedup pipeline</h2><div class="hdt-code-wrap"><button class="hdt-copy" data-copy-target="#code-dedup">Copy</button><div class="hdt-terminal"><pre id="code-dedup">hdt dedup --scope "path:V:\SharePoint"   --group size   --sample 1MB   --hash blake3   --verify exact</pre></div></div></section><section id="benchmark" data-filter-item><h2>Benchmark</h2><div class="hdt-terminal"><pre>hdt benchmark ingest --volume O: --threads 16 --json result.json
hdt benchmark query --suite large-catalog --iterations 1000</pre></div></section><section id="pipes" data-filter-item><h2>WebFarm named pipes</h2><p>The server can expose numbered listeners such as <code>WebApiServer001</code> and <code>WebApiServer002</code>, with multiple async instances behind each logical name.</p><div class="hdt-callout">The website you are viewing is intended to travel through that same request/response path in the Windows deployment.</div></section><section id="faq" data-filter-item><h2>FAQ</h2><div class="hdt-faq"><div class="hdt-faq-item"><button class="hdt-faq-q" data-faq-question>Does an offline disk remain searchable?<span>+</span></button><div class="hdt-faq-a">Yes, if its catalog snapshot is retained. Content-dependent operations should report that the source volume is offline.</div></div><div class="hdt-faq-item"><button class="hdt-faq-q" data-faq-question>Does this test change the database schema?<span>+</span></button><div class="hdt-faq-a">No. The included SQL only replaces harddisk.tools content rows and updates domain metadata.</div></div><div class="hdt-faq-item"><button class="hdt-faq-q" data-faq-question>Are benchmark numbers production claims?<span>+</span></button><div class="hdt-faq-a">No. They are illustrative UI data for this test site and should later be replaced by reproducible measurements.</div></div></div></section></main></div></div></section>

</div>


<div id="p91006-block-4" class="hdt-row-block">
<footer class="hdt-footer"><div class="hdt-container hdt-footer-grid"><div><a class="hdt-brand" href="/"><img src="/svg/logo-mark.svg" alt=""><span>Harddisk.Tools</span></a><p class="hdt-small">A database-driven concept site rendered by the Harddisk.Tools WebFarm runtime.</p></div><div><h4>Product</h4><a href="/features">Features</a><a href="/technology">Architecture</a><a href="/benchmarks">Benchmarks</a></div><div><h4>Research</h4><a href="/forensics">NTFS &amp; forensics</a><a href="/docs">Documentation</a><a href="/docs#query">Query language</a></div><div><h4>Company</h4><a href="/about">About</a><a href="/about#roadmap">Roadmap</a><a href="/404">404 test</a></div></div></footer>

</div>


<div id="p91006-block-5" class="hdt-row-block">
<div class="hdt-toast" aria-live="polite"></div>

</div>


<div id="p91006-db-actions" class="hdt-container hdt-section-tight">
<div class="hdt-small">DB row navigation test:</div>

<div id="p91006-action-920066" class="hdt-btn hdt-btn-secondary" onclick="location.href=&#39;/&#39;" style="display:inline-flex;cursor:pointer;">
Home row

</div>


<div id="p91006-action-920067" class="hdt-btn hdt-btn-secondary" onclick="location.href=&#39;/docs&#39;" style="display:inline-flex;cursor:pointer;">
Docs row

</div>


</div>


</div>

    </body>
</html>
