Auto update

This commit is contained in:
Andrea Mazzoleni 2026-03-30 10:01:17 +02:00
parent e7391dbbfe
commit f4679d3f6e
125 changed files with 17882 additions and 48238 deletions

View file

@ -1,17 +1,17 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="description" content="A backup program for disk arrays. It stores parity information of your data and it recovers from up to six disk failures">
<meta name="keywords" content="snapraid snapshot raid backup disk array redundancy parity">
<meta name="author" content="Andrea Mazzoleni">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/site.webmanifest">
<link rel="stylesheet" type="text/css" href="style.css">
<title>SnapRAID</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="A backup program for disk arrays. It stores parity information of your data and it recovers from up to six disk failures">
<meta name="keywords" content="snapraid snapshot raid backup disk array redundancy parity">
<title>SnapRAID Design</title>
<link rel="stylesheet" href="style.css">
<link rel="apple-touch-icon" sizes="180x180" href="/beta/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/beta/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/beta/favicon-16x16.png">
<link rel="manifest" href="/beta/site.webmanifest">
<script src="script.js"></script>
<!-- Google Analytics 4 -->
<!-- Google tag (gtag.js) -->
@ -36,108 +36,160 @@
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div id="header">
<img src="index.jpg" width="1200" height="150" alt="Title">
</div>
<div id="menu">
<a href="/">About</a>
<a href="download">Download</a>
<a href="design">Design</a>
<a href="compare">Compare</a>
<a href="faq">FAQ</a>
<a href="manual">Manual</a>
<a href="support">Support</a>
<a href="authors">Authors</a>
</div>
<div id="main">
<header>
<div class="container nav-container">
<a href="index" class="logo">
<img src="android-chrome-192x192.png" width="32" height="32"/>
SnapRAID
</a>
<nav>
<input type="checkbox" id="menu-toggle">
<label for="menu-toggle" class="menu-icon"><svg viewBox="0 0 24 24" width="24" height="24" fill="currentColor"><path d="M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z"/></svg></label>
<ul>
<li><a href="index" >Home</a></li>
<li><a href="ui" >UI & Daemon</a></li>
<li><a href="howitworks" >How it Works</a></li>
<li><a href="design" class="active">Design</a></li>
<li><a href="compare" >Compare</a></li>
<li><a href="manual" >Manual</a></li>
<li><a href="faq" >FAQ</a></li>
<li><a href="support" >Support</a></li>
<li><a href="download" class="nav-cta">Download</a></li>
<li>
<button class="theme-toggle" aria-label="Toggle theme">
<svg class="sun-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="5"></circle><line x1="12" y1="1" x2="12" y2="3"></line><line x1="12" y1="21" x2="12" y2="23"></line><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line><line x1="1" y1="12" x2="3" y2="12"></line><line x1="21" y1="12" x2="23" y2="12"></line><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line></svg>
<svg class="moon-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path></svg>
</button>
</li>
</ul>
</nav>
</div>
</header>
<div class="container" style="padding: 4rem 20px;">
<div style="text-align: center; margin-bottom: 4rem;">
<h1 style="margin-bottom: 1rem;">Design Philosophy</h1>
<blockquote style="font-size: 1.5rem; color: var(--text-accent); font-style: italic; margin: 0; padding: 0; border: none; font-family: serif;">
Simplicity is prerequisite for reliability
</blockquote>
<cite style="display: block; margin-top: 1rem; font-size: 1rem; color: var(--text-secondary); font-style: normal;">
<a href="http://en.wikipedia.org/wiki/Edsger_W._Dijkstra" style="color: var(--text-secondary); text-decoration: underline;">Edsger W. Dijkstra</a>
</cite>
</div>
<p>
<span class="bold">SnapRAID</span> was created following the <a href="http://en.wikipedia.org/wiki/Unix_philosophy">Unix philosophy</a>:
<em>Write programs that do one thing and do it well</em>.
</p>
<!-- Unix Philosophy & Reliability -->
<div style="max-width: 800px; margin: 0 auto 4rem auto;">
<p style="font-size: 1.1rem; color: var(--text-secondary); margin-bottom: 1.5rem;">
<strong style="color: var(--text-primary);">SnapRAID</strong> was created following the <a href="http://en.wikipedia.org/wiki/Unix_philosophy">Unix philosophy</a>:
<em>Write programs that do one thing and do it well</em>.
</p>
</div>
<p>
The first design principle was <span class="bold">reliability</span>.
The result is a simple architecture and an easy to understand implementation,
following the <a href="http://en.wikipedia.org/wiki/Edsger_W._Dijkstra">Dijkstra</a>
quote <i>Simplicity is prerequisite for reliability</i>.
</p>
<div class="grid grid-3-cols" style="margin-bottom: 4rem;">
<!-- Testing/Verification Card -->
<div class="card">
<h3>Reliability</h3>
<p>
The first design principle was <strong style="color: var(--text-primary);">reliability</strong>.
The result is a simple architecture and an easy to understand implementation.
</p>
<p>
Extensive and automated tests with the runtime checker <a href="http://valgrind.org/">Valgrind</a>
and with the <a href="https://github.com/google/sanitizers">Google Sanitizers</a>
are done to ensure the correctness of the final application.
The test has a <a href="/cov/">code coverage of over 90%</a>, measured with <a href="https://github.com/linux-test-project/lcov">lcov</a>.
</p>
<p>
SnapRAID is also verified with Coverity Scan for both the
<a href="https://scan.coverity.com/projects/snapraid">CLI</a> and the <a href="https://scan.coverity.com/projects/snapraid-daemon">Daemon</a>.
and <a href="http://clang-analyzer.llvm.org/">clang</a> static analyzers,
and with the <a href="http://lcamtuf.coredump.cx/afl/">American Fuzzy Lop</a> fuzzy tester.
</p>
</div>
<p>
Extensive and automated tests with the runtime checker <a href="http://valgrind.org/">Valgrind</a>
and with the <a href="https://github.com/google/sanitizers">Google Sanitizers</a>
are done to ensure the correctness of the final application.
The test has a <a href="cov/">code coverage of over 90%</a>, measured with <a href="http://ltp.sourceforge.net/coverage/lcov.php">lcov</a>.
</p>
<!-- Robustness Card -->
<div class="card">
<h3>Robustness</h3>
<p>
The second design principle was <strong style="color: var(--text-primary);">robustness</strong>.
It supports any kind of problem. Even on kernel panics, power-downs
or any other hard failure at runtime, your redundancy data is in safe hands.
</p>
<p>
It uses all the possible storage techniques to ensure to always keep consistent
redundancy even after critical interruptions.
</p>
</div>
<p>
SnapRAID is also verified with the
<a href="https://scan.coverity.com/projects/snapraid">Coverity Scan</a>
and <a href="http://clang-analyzer.llvm.org/">clang</a> static analyzers,
and with the <a href="http://lcamtuf.coredump.cx/afl/">American Fuzzy Lop</a> fuzzy tester.
</p>
<!-- Efficiency Card -->
<div class="card">
<h3>Efficiency</h3>
<p>
The third design principle was <strong style="color: var(--text-primary);">efficiency</strong>.
It's a native C application highly optimized to ensure maximum throughput of your disk array.
</p>
<p>
Integrity checks use the highly efficient <a href="https://github.com/aappleby/smhasher">murmur3</a>
and <a href="https://burtleburtle.net/bob/hash/spooky.html">SpookyHash</a> hashes at 128 bits.
</p>
<p>
Redundancy computations use a custom <a href="https://github.com/amadvance/snapraid/tree/master/raid">RAID library</a>
(based on Linux Kernel RAID) supporting up to six parity levels.
Internal structures use <a href="https://www.tommyds.it/">TommyDS</a>.
</p>
</div>
</div>
<div class="grid" style="margin-bottom: 4rem;">
<!-- AI -->
<div class="card">
<h3>Use of Artificial Intelligence</h3>
<p>
This project <strong style="color: var(--text-primary);">is not "vibe-coded"</strong>.
Artificial intelligence is used strictly as a
precision tool and a pair programmer, never as a substitute for engineering judgment. All architecture
decisions, core logic, and safety guarantees remain under direct human control and review.
</p>
<p>
AI was used selectively to accelerate front-end scaffolding, component layout, and alignment with modern UI
standards. All functional behavior, state management, API integration, and system logic were implemented and
<strong style="color: var(--text-primary);">manually validated</strong>.
</p>
<p>
Development follows a <strong style="color: var(--text-primary);">human-led</strong>, AI-assisted workflow. The developer defines the architecture and writes
the core implementations. AI contributes by exploring design alternatives, surfacing edge cases, suggesting
optimizations, and helping refine documentation. Any generated output is reviewed, revised where necessary,
and hardened before integration.
</p>
<p>
This approach improves development efficiency while preserving strict <strong style="color: var(--text-primary);">engineering oversight</strong> and reliability.
</p>
</div>
</div>
</div>
<p>
The second design principle was <span class="bold">robustness</span>.
It supports any kind of problem. Even on kernel panics, power-downs
or any other hard failure at runtime, your redundancy data is in safe hands.
<br>
It uses all the possible storage techniques to ensure to always keep consistent
redundancy even after critical interruptions.
</p>
<p>
The third design principle was <span class="bold">efficiency</span>.
It's a native C application highly optimized using all the
possible OS services to ensure the maximum throughput of your disk array.
</p>
<p>
For integrity checks is used the highly efficient <a href="http://code.google.com/p/smhasher/">murmur3</a>
and <a href="http://burtleburtle.net/bob/hash/spooky.html">SpookyHash</a> hashes at 128 bits.
For the redundancy computations we use a
<a href="https://github.com/amadvance/snapraid/tree/master/raid">RAID library</a>
written from scratch that supports up to six levels of parity delivering top-notch performance.
The library design is originally based, and also binary compatible,
with the <a href="http://lxr.linux.no/linux+*/lib/raid6">Linux Kernel RAID</a>
library made by H. Peter Anvin.
As internal data base it's used the <a href="http://www.tommyds.it/">TommyDS</a> library of data structures.
</p>
<p>
</p>
</div>
<div id="footer">
<div class="column">
<span class="bold">Donate with</span>
<br>
<!--
<a href="http://sourceforge.net/p/snapraid/donate/"><img src="paypal.png" width="160" height="60" alt="PayPal"></a>
-->
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=amadvance%40gmail%2ecom&lc=US&item_name=SnapRAID&no_note=0&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest"><img src="paypal.png" width="160" height="60" alt="PayPal"></a>
<!--
<a href="https://coinkite.com/u/amadvance/"><img src="bitcoin.png" width="160" height="60" alt="BitCoin"></a>
-->
</div>
<div class="column">
<span class="bold">Find other resources at</span>
<br>
<a href="https://github.com/amadvance/snapraid/"><img src="github.png" width="160" height="60" alt="GitHub"></a>
<a href="http://sourceforge.net/projects/snapraid/"><img src="sourceforge.png" width="115" height="60" alt="SourceForge"></a>
</div>
</div>
<!-- Footer -->
<footer>
<div class="container footer-content">
<div class="footer-col">
<div class="logo">
<img src="android-chrome-192x192.png" width="32" height="32"/>
SnapRAID
</div>
<p>Copyright &copy; 2026 Andrea Mazzoleni</p>
<p class="license">Distributed under GPL v3 License</p>
</div>
<div class="footer-col">
</div>
</div>
</footer>
</body>
</html>