mirror of
https://github.com/amadvance/snapraid.git
synced 2026-11-21 15:36:33 -05:00
Auto update
This commit is contained in:
parent
e7391dbbfe
commit
f4679d3f6e
125 changed files with 17882 additions and 48238 deletions
258
design.html
258
design.html
|
|
@ -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¤cy_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 © 2026 Andrea Mazzoleni</p>
|
||||
<p class="license">Distributed under GPL v3 License</p>
|
||||
</div>
|
||||
<div class="footer-col">
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue