diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 07cfa73a..e034b2ea 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -107,7 +107,7 @@ SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. .IP \(bu Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte -drehen (spinnen), was Strom spart und Geräusche reduziert. +anlaufen (drehen), was Strom spart und Geräusche reduziert. .PD .PP Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID\-Website: @@ -152,7 +152,7 @@ Weitere Einschränkungen von SnapRAID sind: Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. .IP \(bu -SnapRAID streift (stripes) keine Daten. +SnapRAID verwendet kein Data\-Striping (Verteilen von Datenblöcken). Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. .IP \(bu SnapRAID unterstützt keine Echtzeit\-Wiederherstellung. @@ -160,7 +160,7 @@ Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine Festplatte ausfällt. .IP \(bu SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen -wiederherstellen. Mit einer Sicherung können Sie von einem +wiederherstellen. Mit einer Sicherung können Sie Daten nach einem vollständigen Ausfall des gesamten Festplatten\-Arrays wiederherstellen. .IP \(bu Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und @@ -170,10 +170,10 @@ und erweiterte Attribute werden nicht gespeichert. .SH ERSTE SCHRITTE (GETTING STARTED) Um SnapRAID zu verwenden, müssen Sie zuerst eine Festplatte in Ihrem Festplatten\-Array auswählen, die für \`parity\`\-Informationen -reserviert wird. Mit einer Festplatte für Parität können Sie von -einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. +reserviert wird. Mit einer Festplatte für Parität können Sie Daten +nach einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. .PP -Wenn Sie von mehr Festplattenausfällen wiederherstellen möchten, +Wenn Sie mehr Festplattenausfälle ausgleichen möchten, ähnlich wie bei RAID6, müssen Sie zusätzliche Festplatten für Parität reservieren. Jede zusätzliche Paritätsfestplatte ermöglicht die Wiederherstellung von einem weiteren Festplattenausfall. @@ -384,7 +384,7 @@ markiert. .SS Zusammenführen (Pooling) Hinweis: Die unten beschriebene Pooling\-Funktion wurde durch das Tool mergerfs ersetzt, das jetzt die empfohlene Option für Linux\-Benutzer -in der SnapRAID\-Community ist. Mergefs bietet eine flexiblere +in der SnapRAID\-Community ist. Mergerfs bietet eine flexiblere und effizientere Möglichkeit, mehrere Laufwerke zu einem einzigen, vereinheitlichten Einhängepunkt (Mount Point) zusammenzufassen, was einen nahtlosen Zugriff auf Dateien über Ihr gesamtes Array @@ -692,7 +692,7 @@ snapraid sync .PP Wenn alles wiederhergestellt ist, ist dieser Befehl sofort. .SH BEFEHLE (COMMANDS) -SnapRAID bietet ein paar einfache Befehle, mit denen Sie: +SnapRAID bietet ein paar einfache Befehle, mit denen Sie folgende Aktionen ausführen können: .PD 0 .IP \(bu Den Status des Arrays ausgeben \-> \`status\` @@ -723,7 +723,7 @@ aufgelistet. Um sie zu beheben, können Sie den Befehl \`fix \-e\` verwenden. .PP Es zeigt auch ein Diagramm an, das den letzten Zeitpunkt darstellt, -zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbed +zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbte Blöcke werden mit \`*\`, Blöcke, die synchronisiert, aber noch nicht gescrubbed wurden, mit \`o\` angezeigt. .PP @@ -732,7 +732,7 @@ Es wird nichts geändert. Gibt einen SMART\-Bericht aller Festplatten im System aus. .PP Es enthält eine Schätzung der Ausfallwahrscheinlichkeit im nächsten -Jahr, sodass Sie die Wartungsersetzung von Festplatten planen können, +Jahr, sodass Sie den vorsorglichen Austausch von Festplatten planen können, die verdächtige Attribute aufweisen. .PP Diese Wahrscheinlichkeitsschätzung wird durch Korrelation der SMART\-Attribute @@ -1227,9 +1227,9 @@ Befehlsfehler sicher gestoppt werden. .B \-w, \-\-bw\-limit RATE Wendet eine globale Bandbreitenbegrenzung für alle Festplatten an. RATE ist die Anzahl der Bytes pro Sekunde. Sie können -einen Multiplikator wie K, M oder G angeben (z.B. \-\-bw\-limit 1G). +einen Multiplikator wie K, M, G oder T angeben (z.B. \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail GRÖSSE +.B \-t, \-\-tail SIZE Beschränkt die Dateiliste auf diejenigen, die nicht mehr als die angegebene Tail\-Größe der Paritätsfestplatten belegen. Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. \-\-tail 1G). @@ -1259,7 +1259,7 @@ Erzwingt den unsicheren Vorgang der Synchronisierung einer Datei mit Nullgröße, die zuvor nicht Null war. Wenn SnapRAID eine solche Bedingung erkennt, stoppt es den Vorgang, es sei denn, Sie geben diese Option an. Dies ermöglicht es Ihnen, leicht zu -erkennen, wann nach einem Systemabsturz einige zugegriffene Dateien +erkennen, wann nach einem Systemabsturz einige Dateien, auf die zugegriffen wurde, abgeschnitten (truncated) wurden. Dies ist eine mögliche Bedingung unter Linux mit den ext3/ext4\-Dateisystemen. Diese Option kann nur mit \`sync\` verwendet werden. @@ -1294,7 +1294,7 @@ Festplatten oder mit Festplatten auf demselben physischen Gerät. Wenn Sie beispielsweise zwei Datenfestplatten verloren haben und eine Ersatzfestplatte haben, um nur die erste wiederherzustellen, können Sie die zweite unzugängliche Festplatte ignorieren. -Oder wenn Sie eine Festplatte in dem auf einer bereits +Oder wenn Sie eine Festplatte auf dem auf einer bereits verwendeten Festplatte verbleibenden freien Speicherplatz wiederherstellen möchten, wobei sie dasselbe physische Gerät gemeinsam nutzen. @@ -1338,9 +1338,9 @@ WARNUNG! Diese Option ist nur für Experten gedacht, und es wird dringend empfohlen, sie nicht zu verwenden. Sie haben während der \`sync\`\-Operation KEINEN Datenschutz. .TP -.B \-W, \-\-force\-realloc\-tail GRÖSSE +.B \-W, \-\-force\-realloc\-tail SIZE Funktioniert wie \-R, \-\-force\-realloc, ist jedoch auf den angegebenen -Endbereich (die letzten GRÖSSE Bytes) jeder Paritätsdatei beschränkt. +Endbereich (die letzten SIZE Bytes) jeder Paritätsdatei beschränkt. Erzwingt die Neuzuweisung (Verschiebung) aller Dateifragmente/\-blöcke, die derzeit in diesem Endabschnitt gespeichert sind, sodass sie an beliebiger Stelle in den Paritätsdateien platziert werden können, wo freier Speicherplatz @@ -1401,7 +1401,7 @@ Diese Option ist hauptsächlich für die erweiterte manuelle Wiederherstellung gedacht. .TP .B \-C, \-\-gen\-conf CONTENT -Generiert eine Dummy\-Konfigurationsdatei aus einer vorhandenen +Generiert eine Dummy\-Konfigurationsdatei aus einer bestehenden Content\-Datei. Die Konfigurationsdatei wird in die Standardausgabe geschrieben und überschreibt keine vorhandene. Diese Konfigurationsdatei enthält auch die Informationen, @@ -1440,9 +1440,8 @@ Verzeichnis wie \`snapraid.exe\` verwendet. Sie muss die folgenden Optionen (Groß\- und Kleinschreibung beachten) enthalten: .SS parity FILE [,FILE] ... -Definiert die Dateien, die zum Speichern der Paritätsinformationen -verwendet werden sollen. Die Parität ermöglicht den Schutz -vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. +Definiert die Dateien, die zum Speichern der Paritätsinformationen verwendet werden. +Die Parität ermöglicht den Schutz vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. .PP Sie können mehrere Dateien angeben, die sich auf unterschiedlichen Festplatten befinden müssen. Wenn eine Datei nicht mehr wachsen @@ -1461,8 +1460,7 @@ um die Warnung vor vollen Festplatten zu vermeiden. .PP Diese Option ist obligatorisch und kann nur einmal verwendet werden. .SS (2,3,4,5,6)\-parity FILE [,FILE] ... -Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen -verwendet werden sollen. +Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen verwendet werden. .PP Für jede angegebene Paritätsstufe wird eine zusätzliche Schutzstufe aktiviert: @@ -1504,8 +1502,8 @@ Es ist möglich, von einem Format in ein anderes zu konvertieren, indem die Konfigurationsdatei mit der gewünschten z\-parity\- oder 3\-parity\-Datei angepasst und \`fix\` zur Neuerstellung verwendet wird. .SS content FILE -Definiert die Datei, die zum Speichern der Liste und Prüfsummen -aller im Festplatten\-Array vorhandenen Dateien verwendet werden soll. +Definiert die Datei, die zum Speichern der Liste und der Prüfsummen aller +im Festplatten\-Array vorhandenen Dateien verwendet wird. .PP Sie kann auf einer für Daten, Parität oder einer anderen verfügbaren Festplatte platziert werden. @@ -1518,10 +1516,9 @@ um mehrere Kopien derselben Datei zu speichern. Sie müssen mindestens eine Kopie für jede verwendete Paritätsfestplatte plus eine speichern. Die Verwendung zusätzlicher Kopien schadet nicht. .SS data NAME DIR -Definiert den Namen und den Einhängepunkt (Mount Point) der -Datenfestplatten im Array. NAME wird zur Identifizierung der -Festplatte verwendet und muss eindeutig sein. DIR ist der -Einhängepunkt der Festplatte im Dateisystem. +Definiert den Namen und Einhängepunkt der Datenfestplatten im Array. NAME +wird zur Identifizierung der Festplatte verwendet und muss eindeutig sein. +DIR ist der Einhängepunkt der Festplatte im Dateisystem. .PP Sie können den Einhängepunkt nach Bedarf ändern, solange Sie den NAME unverändert lassen. @@ -1546,14 +1543,14 @@ betroffen sind, da von ihnen erwartet wird, dass sie sich immer drehen. Aktiviert die Verwendung von Dateisystem\-Snapshots für die Befehle \`sync\`, \`scrub\`, \`check\` und \`fix\`. .PP -Wenn aktiviert, erstellt SnapRAID zu Beginn eines \'sync\' einen schreibgeschützten Snapshot Ihrer Daten. -Dies gewährleistet eine konsistente Point\-in\-Time\-Ansicht Ihrer Dateien und verhindert -Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. +Wenn aktiviert, erstellt SnapRAID zu Beginn eines \'sync\' einen schreibgeschützten +Snapshot Ihrer Daten. Dies gewährleistet eine konsistente Point\-in\-Time\-Ansicht +Ihrer Dateien und verhindert Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. .PP -Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live\-Dateisystem gelöscht wird, -bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block -\[dq]beschädigt\[dq] wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können, -wenn eine andere Festplatte ausfällt. +Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem +Live\-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, +dass die Parität für diesen Block \[dq]beschädigt\[dq] wird, sodass Sie Daten immer noch +erfolgreich wiederherstellen können, wenn eine andere Festplatte ausfällt. .PP Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind. @@ -1561,8 +1558,8 @@ Paritätsfestplatten oder Datenträger mit anderen Dateisystemen verwenden immer die Live\-Version des Dateisystems. .PP Das Erstellen und Löschen von Snapshots erfordert Administratorrechte. -Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn -diese Option aktiviert ist. +Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) +ausgeführt wird, wenn diese Option aktiviert ist. .PP Eine detaillierte Erklärung des Snapshot\-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS. .SS nohidden @@ -1826,7 +1823,7 @@ smartignore parity 197 5 .PD 0 .PD .RE -.SS Examples +.SS Beispiele (Examples) Ein Beispiel für eine typische Konfiguration für Unix ist: .PP .RS 4 @@ -1990,7 +1987,7 @@ direkt auf dem Live\-Dateisystem arbeiten. Das Erstellen und Löschen von Snapshots erfordert Administratorrechte. Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn Snapshots aktiviert sind. -.SS Befehlsverhalten mit Snapshots +.SS Befehlsverhalten mit Snapshots (Command Behavior with Snapshots) Die Befehle \`sync\` und \`scrub\` arbeiten beide ausschließlich auf Snapshots, um sicherzustellen, dass alle Datenoperationen auf einem konsistenten, eingefrorenen Zustand ausgeführt werden. Durch die Nutzung dieser Snapshots verhindert SnapRAID Paritätskonflikte, @@ -2333,10 +2330,25 @@ eine TrueType\-Schriftart wie \`Lucida Console\` als Konsolenschriftart verwenden. Dies betrifft nur die gedruckten Dateinamen; wenn Sie die Konsolenausgabe in eine Datei umleiten, ist die resultierende Datei immer im UTF\-8\-Format. +.SH EXIT\-CODE (EXIT CODE) +SnapRAID endet mit den folgenden Fehlercodes: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Alles OK. +.HP 4 +.I 1 +Der Befehl ist auf Fehler gestoßen. +.HP 4 +.I 2 +Der Befehl \`diff\` hat festgestellt, dass alles OK ist, aber ein \`sync\` erforderlich ist. +.PD +.RE .SH ÜBERSETZUNG (TRANSLATION) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. .SH COPYRIGHT -Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni +Diese Datei ist Copyright (C) 2026 Andrea Mazzoleni .SH SIEHE AUCH (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index e05a4a35..24a5416f 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -45,7 +45,7 @@ Beschreibung (Description) * SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. * Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte - drehen (spinnen), was Strom spart und Geräusche reduziert. + anlaufen (drehen), was Strom spart und Geräusche reduziert. Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID-Website: @@ -80,13 +80,13 @@ Einschränkungen (Limitations) * Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. - * SnapRAID streift (stripes) keine Daten. + * SnapRAID verwendet kein Data-Striping (Verteilen von Datenblöcken). Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. * SnapRAID unterstützt keine Echtzeit-Wiederherstellung. Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine Festplatte ausfällt. * SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen - wiederherstellen. Mit einer Sicherung können Sie von einem + wiederherstellen. Mit einer Sicherung können Sie Daten nach einem vollständigen Ausfall des gesamten Festplatten-Arrays wiederherstellen. * Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und Hardlinks werden gespeichert. Berechtigungen, Eigentümerschaft @@ -95,10 +95,10 @@ Einschränkungen (Limitations) Erste Schritte (Getting Started) Um SnapRAID zu verwenden, müssen Sie zuerst eine Festplatte in Ihrem Festplatten-Array auswählen, die für `parity`-Informationen - reserviert wird. Mit einer Festplatte für Parität können Sie von - einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. + reserviert wird. Mit einer Festplatte für Parität können Sie Daten + nach einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. - Wenn Sie von mehr Festplattenausfällen wiederherstellen möchten, + Wenn Sie mehr Festplattenausfälle ausgleichen möchten, ähnlich wie bei RAID6, müssen Sie zusätzliche Festplatten für Parität reservieren. Jede zusätzliche Paritätsfestplatte ermöglicht die Wiederherstellung von einem weiteren Festplattenausfall. @@ -226,7 +226,7 @@ Erste Schritte (Getting Started) Zusammenführen (Pooling) Hinweis: Die unten beschriebene Pooling-Funktion wurde durch das Tool mergerfs ersetzt, das jetzt die empfohlene Option für Linux-Benutzer - in der SnapRAID-Community ist. Mergefs bietet eine flexiblere + in der SnapRAID-Community ist. Mergerfs bietet eine flexiblere und effizientere Möglichkeit, mehrere Laufwerke zu einem einzigen, vereinheitlichten Einhängepunkt (Mount Point) zusammenzufassen, was einen nahtlosen Zugriff auf Dateien über Ihr gesamtes Array @@ -428,7 +428,7 @@ Erste Schritte (Getting Started) Wenn alles wiederhergestellt ist, ist dieser Befehl sofort. Befehle (Commands) - SnapRAID bietet ein paar einfache Befehle, mit denen Sie: + SnapRAID bietet ein paar einfache Befehle, mit denen Sie folgende Aktionen ausführen können: * Den Status des Arrays ausgeben -> `status` * Die Festplatten steuern -> `smart`, `probe`, `up`, `down` @@ -454,7 +454,7 @@ Befehle (Commands) verwenden. Es zeigt auch ein Diagramm an, das den letzten Zeitpunkt darstellt, - zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbed + zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbte Blöcke werden mit `*`, Blöcke, die synchronisiert, aber noch nicht gescrubbed wurden, mit `o` angezeigt. @@ -464,7 +464,7 @@ Befehle (Commands) Gibt einen SMART-Bericht aller Festplatten im System aus. Es enthält eine Schätzung der Ausfallwahrscheinlichkeit im nächsten - Jahr, sodass Sie die Wartungsersetzung von Festplatten planen können, + Jahr, sodass Sie den vorsorglichen Austausch von Festplatten planen können, die verdächtige Attribute aufweisen. Diese Wahrscheinlichkeitsschätzung wird durch Korrelation der SMART-Attribute @@ -930,9 +930,9 @@ Optionen (Options) -w, --bw-limit RATE Wendet eine globale Bandbreitenbegrenzung für alle Festplatten an. RATE ist die Anzahl der Bytes pro Sekunde. Sie können - einen Multiplikator wie K, M oder G angeben (z.B. --bw-limit 1G). + einen Multiplikator wie K, M, G oder T angeben (z.B. --bw-limit 1G). - -t, --tail GRÖSSE + -t, --tail SIZE Beschränkt die Dateiliste auf diejenigen, die nicht mehr als die angegebene Tail-Größe der Paritätsfestplatten belegen. Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. --tail 1G). @@ -962,7 +962,7 @@ Optionen (Options) mit Nullgröße, die zuvor nicht Null war. Wenn SnapRAID eine solche Bedingung erkennt, stoppt es den Vorgang, es sei denn, Sie geben diese Option an. Dies ermöglicht es Ihnen, leicht zu - erkennen, wann nach einem Systemabsturz einige zugegriffene Dateien + erkennen, wann nach einem Systemabsturz einige Dateien, auf die zugegriffen wurde, abgeschnitten (truncated) wurden. Dies ist eine mögliche Bedingung unter Linux mit den ext3/ext4-Dateisystemen. Diese Option kann nur mit `sync` verwendet werden. @@ -997,7 +997,7 @@ Optionen (Options) Wenn Sie beispielsweise zwei Datenfestplatten verloren haben und eine Ersatzfestplatte haben, um nur die erste wiederherzustellen, können Sie die zweite unzugängliche Festplatte ignorieren. - Oder wenn Sie eine Festplatte in dem auf einer bereits + Oder wenn Sie eine Festplatte auf dem auf einer bereits verwendeten Festplatte verbleibenden freien Speicherplatz wiederherstellen möchten, wobei sie dasselbe physische Gerät gemeinsam nutzen. @@ -1041,9 +1041,9 @@ Optionen (Options) dringend empfohlen, sie nicht zu verwenden. Sie haben während der `sync`-Operation KEINEN Datenschutz. - -W, --force-realloc-tail GRÖSSE + -W, --force-realloc-tail SIZE Funktioniert wie -R, --force-realloc, ist jedoch auf den angegebenen - Endbereich (die letzten GRÖSSE Bytes) jeder Paritätsdatei beschränkt. + Endbereich (die letzten SIZE Bytes) jeder Paritätsdatei beschränkt. Erzwingt die Neuzuweisung (Verschiebung) aller Dateifragmente/-blöcke, die derzeit in diesem Endabschnitt gespeichert sind, sodass sie an beliebiger Stelle in den Paritätsdateien platziert werden können, wo freier Speicherplatz @@ -1104,7 +1104,7 @@ Optionen (Options) Wiederherstellung gedacht. -C, --gen-conf CONTENT - Generiert eine Dummy-Konfigurationsdatei aus einer vorhandenen + Generiert eine Dummy-Konfigurationsdatei aus einer bestehenden Content-Datei. Die Konfigurationsdatei wird in die Standardausgabe geschrieben und überschreibt keine vorhandene. Diese Konfigurationsdatei enthält auch die Informationen, @@ -1145,9 +1145,8 @@ Konfiguration (Configuration) enthalten: parity FILE [,FILE] ... - Definiert die Dateien, die zum Speichern der Paritätsinformationen - verwendet werden sollen. Die Parität ermöglicht den Schutz - vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. + Definiert die Dateien, die zum Speichern der Paritätsinformationen verwendet werden. + Die Parität ermöglicht den Schutz vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. Sie können mehrere Dateien angeben, die sich auf unterschiedlichen Festplatten befinden müssen. Wenn eine Datei nicht mehr wachsen @@ -1167,8 +1166,7 @@ Konfiguration (Configuration) Diese Option ist obligatorisch und kann nur einmal verwendet werden. (2,3,4,5,6)-parity FILE [,FILE] ... - Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen - verwendet werden sollen. + Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen verwendet werden. Für jede angegebene Paritätsstufe wird eine zusätzliche Schutzstufe aktiviert: @@ -1206,8 +1204,8 @@ Konfiguration (Configuration) 3-parity-Datei angepasst und `fix` zur Neuerstellung verwendet wird. content FILE - Definiert die Datei, die zum Speichern der Liste und Prüfsummen - aller im Festplatten-Array vorhandenen Dateien verwendet werden soll. + Definiert die Datei, die zum Speichern der Liste und der Prüfsummen aller + im Festplatten-Array vorhandenen Dateien verwendet wird. Sie kann auf einer für Daten, Parität oder einer anderen verfügbaren Festplatte platziert werden. @@ -1221,10 +1219,9 @@ Konfiguration (Configuration) plus eine speichern. Die Verwendung zusätzlicher Kopien schadet nicht. data NAME DIR - Definiert den Namen und den Einhängepunkt (Mount Point) der - Datenfestplatten im Array. NAME wird zur Identifizierung der - Festplatte verwendet und muss eindeutig sein. DIR ist der - Einhängepunkt der Festplatte im Dateisystem. + Definiert den Namen und Einhängepunkt der Datenfestplatten im Array. NAME + wird zur Identifizierung der Festplatte verwendet und muss eindeutig sein. + DIR ist der Einhängepunkt der Festplatte im Dateisystem. Sie können den Einhängepunkt nach Bedarf ändern, solange Sie den NAME unverändert lassen. @@ -1251,14 +1248,14 @@ Konfiguration (Configuration) Aktiviert die Verwendung von Dateisystem-Snapshots für die Befehle `sync`, `scrub`, `check` und `fix`. - Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten Snapshot Ihrer Daten. - Dies gewährleistet eine konsistente Point-in-Time-Ansicht Ihrer Dateien und verhindert - Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. + Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten + Snapshot Ihrer Daten. Dies gewährleistet eine konsistente Point-in-Time-Ansicht + Ihrer Dateien und verhindert Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. - Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird, - bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block - "beschädigt" wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können, - wenn eine andere Festplatte ausfällt. + Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem + Live-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, + dass die Parität für diesen Block "beschädigt" wird, sodass Sie Daten immer noch + erfolgreich wiederherstellen können, wenn eine andere Festplatte ausfällt. Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind. @@ -1266,8 +1263,8 @@ Konfiguration (Configuration) die Live-Version des Dateisystems. Das Erstellen und Löschen von Snapshots erfordert Administratorrechte. - Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn - diese Option aktiviert ist. + Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) + ausgeführt wird, wenn diese Option aktiviert ist. Eine detaillierte Erklärung des Snapshot-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS. @@ -1506,7 +1503,7 @@ Konfiguration (Configuration) :smartignore parity 197 5 - Examples + Beispiele (Examples) Ein Beispiel für eine typische Konfiguration für Unix ist: :parity /mnt/diskp/snapraid.parity @@ -1582,7 +1579,7 @@ Snapshots Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn Snapshots aktiviert sind. - Befehlsverhalten mit Snapshots + Befehlsverhalten mit Snapshots (Command Behavior with Snapshots) Die Befehle `sync` und `scrub` arbeiten beide ausschließlich auf Snapshots, um sicherzustellen, dass alle Datenoperationen auf einem konsistenten, eingefrorenen Zustand ausgeführt werden. Durch die Nutzung dieser Snapshots verhindert SnapRAID Paritätskonflikte, @@ -1846,12 +1843,19 @@ Kodierung (Encoding) die Konsolenausgabe in eine Datei umleiten, ist die resultierende Datei immer im UTF-8-Format. +Exit-Code (Exit Code) + SnapRAID endet mit den folgenden Fehlercodes: + + 0 - Alles OK. + 1 - Der Befehl ist auf Fehler gestoßen. + 2 - Der Befehl `diff` hat festgestellt, dass alles OK ist, aber ein `sync` erforderlich ist. + Übersetzung (Translation) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. Copyright - Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni + Diese Datei ist Copyright (C) 2026 Andrea Mazzoleni Siehe auch (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 2242e28e..930490d4 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -52,7 +52,7 @@ selten geänderten Dateien konzipiert und bietet folgende Funktionen: * SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. * Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte - drehen (spinnen), was Strom spart und Geräusche reduziert. + anlaufen (drehen), was Strom spart und Geräusche reduziert. Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID-Website: @@ -90,13 +90,13 @@ Weitere Einschränkungen von SnapRAID sind: * Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. -* SnapRAID streift (stripes) keine Daten. +* SnapRAID verwendet kein Data-Striping (Verteilen von Datenblöcken). Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. * SnapRAID unterstützt keine Echtzeit-Wiederherstellung. Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine Festplatte ausfällt. * SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen - wiederherstellen. Mit einer Sicherung können Sie von einem + wiederherstellen. Mit einer Sicherung können Sie Daten nach einem vollständigen Ausfall des gesamten Festplatten-Arrays wiederherstellen. * Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und Hardlinks werden gespeichert. Berechtigungen, Eigentümerschaft @@ -108,10 +108,10 @@ Weitere Einschränkungen von SnapRAID sind: Um SnapRAID zu verwenden, müssen Sie zuerst eine Festplatte in Ihrem Festplatten-Array auswählen, die für `parity`-Informationen -reserviert wird. Mit einer Festplatte für Parität können Sie von -einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. +reserviert wird. Mit einer Festplatte für Parität können Sie Daten +nach einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. -Wenn Sie von mehr Festplattenausfällen wiederherstellen möchten, +Wenn Sie mehr Festplattenausfälle ausgleichen möchten, ähnlich wie bei RAID6, müssen Sie zusätzliche Festplatten für Parität reservieren. Jede zusätzliche Paritätsfestplatte ermöglicht die Wiederherstellung von einem weiteren Festplattenausfall. @@ -243,7 +243,7 @@ markiert. Hinweis: Die unten beschriebene Pooling-Funktion wurde durch das Tool mergerfs ersetzt, das jetzt die empfohlene Option für Linux-Benutzer -in der SnapRAID-Community ist. Mergefs bietet eine flexiblere +in der SnapRAID-Community ist. Mergerfs bietet eine flexiblere und effizientere Möglichkeit, mehrere Laufwerke zu einem einzigen, vereinheitlichten Einhängepunkt (Mount Point) zusammenzufassen, was einen nahtlosen Zugriff auf Dateien über Ihr gesamtes Array @@ -452,7 +452,7 @@ Wenn alles wiederhergestellt ist, ist dieser Befehl sofort. 5 BEFEHLE (COMMANDS) ==================== -SnapRAID bietet ein paar einfache Befehle, mit denen Sie: +SnapRAID bietet ein paar einfache Befehle, mit denen Sie folgende Aktionen ausführen können: * Den Status des Arrays ausgeben -> `status` * Die Festplatten steuern -> `smart`, `probe`, `up`, `down` @@ -480,7 +480,7 @@ aufgelistet. Um sie zu beheben, können Sie den Befehl `fix -e` verwenden. Es zeigt auch ein Diagramm an, das den letzten Zeitpunkt darstellt, -zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbed +zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbte Blöcke werden mit `*`, Blöcke, die synchronisiert, aber noch nicht gescrubbed wurden, mit `o` angezeigt. @@ -492,7 +492,7 @@ Es wird nichts geändert. Gibt einen SMART-Bericht aller Festplatten im System aus. Es enthält eine Schätzung der Ausfallwahrscheinlichkeit im nächsten -Jahr, sodass Sie die Wartungsersetzung von Festplatten planen können, +Jahr, sodass Sie den vorsorglichen Austausch von Festplatten planen können, die verdächtige Attribute aufweisen. Diese Wahrscheinlichkeitsschätzung wird durch Korrelation der SMART-Attribute @@ -991,9 +991,9 @@ SnapRAID bietet die folgenden Optionen: -w, --bw-limit RATE Wendet eine globale Bandbreitenbegrenzung für alle Festplatten an. RATE ist die Anzahl der Bytes pro Sekunde. Sie können - einen Multiplikator wie K, M oder G angeben (z.B. --bw-limit 1G). + einen Multiplikator wie K, M, G oder T angeben (z.B. --bw-limit 1G). - -t, --tail GRÖSSE + -t, --tail SIZE Beschränkt die Dateiliste auf diejenigen, die nicht mehr als die angegebene Tail-Größe der Paritätsfestplatten belegen. Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. --tail 1G). @@ -1023,7 +1023,7 @@ SnapRAID bietet die folgenden Optionen: mit Nullgröße, die zuvor nicht Null war. Wenn SnapRAID eine solche Bedingung erkennt, stoppt es den Vorgang, es sei denn, Sie geben diese Option an. Dies ermöglicht es Ihnen, leicht zu - erkennen, wann nach einem Systemabsturz einige zugegriffene Dateien + erkennen, wann nach einem Systemabsturz einige Dateien, auf die zugegriffen wurde, abgeschnitten (truncated) wurden. Dies ist eine mögliche Bedingung unter Linux mit den ext3/ext4-Dateisystemen. Diese Option kann nur mit `sync` verwendet werden. @@ -1058,7 +1058,7 @@ SnapRAID bietet die folgenden Optionen: Wenn Sie beispielsweise zwei Datenfestplatten verloren haben und eine Ersatzfestplatte haben, um nur die erste wiederherzustellen, können Sie die zweite unzugängliche Festplatte ignorieren. - Oder wenn Sie eine Festplatte in dem auf einer bereits + Oder wenn Sie eine Festplatte auf dem auf einer bereits verwendeten Festplatte verbleibenden freien Speicherplatz wiederherstellen möchten, wobei sie dasselbe physische Gerät gemeinsam nutzen. @@ -1102,9 +1102,9 @@ SnapRAID bietet die folgenden Optionen: dringend empfohlen, sie nicht zu verwenden. Sie haben während der `sync`-Operation KEINEN Datenschutz. - -W, --force-realloc-tail GRÖSSE + -W, --force-realloc-tail SIZE Funktioniert wie -R, --force-realloc, ist jedoch auf den angegebenen - Endbereich (die letzten GRÖSSE Bytes) jeder Paritätsdatei beschränkt. + Endbereich (die letzten SIZE Bytes) jeder Paritätsdatei beschränkt. Erzwingt die Neuzuweisung (Verschiebung) aller Dateifragmente/-blöcke, die derzeit in diesem Endabschnitt gespeichert sind, sodass sie an beliebiger Stelle in den Paritätsdateien platziert werden können, wo freier Speicherplatz @@ -1165,7 +1165,7 @@ SnapRAID bietet die folgenden Optionen: Wiederherstellung gedacht. -C, --gen-conf CONTENT - Generiert eine Dummy-Konfigurationsdatei aus einer vorhandenen + Generiert eine Dummy-Konfigurationsdatei aus einer bestehenden Content-Datei. Die Konfigurationsdatei wird in die Standardausgabe geschrieben und überschreibt keine vorhandene. Diese Konfigurationsdatei enthält auch die Informationen, @@ -1211,9 +1211,8 @@ enthalten: 7.1 parity FILE [,FILE] ... --------------------------- -Definiert die Dateien, die zum Speichern der Paritätsinformationen -verwendet werden sollen. Die Parität ermöglicht den Schutz -vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. +Definiert die Dateien, die zum Speichern der Paritätsinformationen verwendet werden. +Die Parität ermöglicht den Schutz vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. Sie können mehrere Dateien angeben, die sich auf unterschiedlichen Festplatten befinden müssen. Wenn eine Datei nicht mehr wachsen @@ -1235,8 +1234,7 @@ Diese Option ist obligatorisch und kann nur einmal verwendet werden. 7.2 (2,3,4,5,6)-parity FILE [,FILE] ... --------------------------------------- -Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen -verwendet werden sollen. +Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen verwendet werden. Für jede angegebene Paritätsstufe wird eine zusätzliche Schutzstufe aktiviert: @@ -1278,8 +1276,8 @@ indem die Konfigurationsdatei mit der gewünschten z-parity- oder 7.4 content FILE ---------------- -Definiert die Datei, die zum Speichern der Liste und Prüfsummen -aller im Festplatten-Array vorhandenen Dateien verwendet werden soll. +Definiert die Datei, die zum Speichern der Liste und der Prüfsummen aller +im Festplatten-Array vorhandenen Dateien verwendet wird. Sie kann auf einer für Daten, Parität oder einer anderen verfügbaren Festplatte platziert werden. @@ -1295,10 +1293,9 @@ plus eine speichern. Die Verwendung zusätzlicher Kopien schadet nicht. 7.5 data NAME DIR ----------------- -Definiert den Namen und den Einhängepunkt (Mount Point) der -Datenfestplatten im Array. NAME wird zur Identifizierung der -Festplatte verwendet und muss eindeutig sein. DIR ist der -Einhängepunkt der Festplatte im Dateisystem. +Definiert den Namen und Einhängepunkt der Datenfestplatten im Array. NAME +wird zur Identifizierung der Festplatte verwendet und muss eindeutig sein. +DIR ist der Einhängepunkt der Festplatte im Dateisystem. Sie können den Einhängepunkt nach Bedarf ändern, solange Sie den NAME unverändert lassen. @@ -1329,14 +1326,14 @@ betroffen sind, da von ihnen erwartet wird, dass sie sich immer drehen. Aktiviert die Verwendung von Dateisystem-Snapshots für die Befehle `sync`, `scrub`, `check` und `fix`. -Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten Snapshot Ihrer Daten. -Dies gewährleistet eine konsistente Point-in-Time-Ansicht Ihrer Dateien und verhindert -Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. +Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten +Snapshot Ihrer Daten. Dies gewährleistet eine konsistente Point-in-Time-Ansicht +Ihrer Dateien und verhindert Fehler, die durch gleichzeitige Dateiänderungen verursacht werden. -Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird, -bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block -"beschädigt" wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können, -wenn eine andere Festplatte ausfällt. +Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem +Live-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, +dass die Parität für diesen Block "beschädigt" wird, sodass Sie Daten immer noch +erfolgreich wiederherstellen können, wenn eine andere Festplatte ausfällt. Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind. @@ -1344,8 +1341,8 @@ Paritätsfestplatten oder Datenträger mit anderen Dateisystemen verwenden immer die Live-Version des Dateisystems. Das Erstellen und Löschen von Snapshots erfordert Administratorrechte. -Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn -diese Option aktiviert ist. +Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) +ausgeführt wird, wenn diese Option aktiviert ist. Eine detaillierte Erklärung des Snapshot-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS. @@ -1606,8 +1603,8 @@ Um sie nur auf der ersten Paritätsfestplatte zu ignorieren: smartignore parity 197 5 -7.19 Examples -------------- +7.19 Beispiele (Examples) +------------------------- Ein Beispiel für eine typische Konfiguration für Unix ist: @@ -1687,8 +1684,8 @@ Das Erstellen und Löschen von Snapshots erfordert Administratorrechte. Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn Snapshots aktiviert sind. -8.1 Befehlsverhalten mit Snapshots ----------------------------------- +8.1 Befehlsverhalten mit Snapshots (Command Behavior with Snapshots) +-------------------------------------------------------------------- Die Befehle `sync` und `scrub` arbeiten beide ausschließlich auf Snapshots, um sicherzustellen, dass alle Datenoperationen auf einem konsistenten, @@ -1972,20 +1969,30 @@ die Konsolenausgabe in eine Datei umleiten, ist die resultierende Datei immer im UTF-8-Format. -15 ÜBERSETZUNG (TRANSLATION) +15 EXIT-CODE (EXIT CODE) +======================== + +SnapRAID endet mit den folgenden Fehlercodes: + +0 - Alles OK. +1 - Der Befehl ist auf Fehler gestoßen. +2 - Der Befehl `diff` hat festgestellt, dass alles OK ist, aber ein `sync` erforderlich ist. + + +16 ÜBERSETZUNG (TRANSLATION) ============================ Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. -16 COPYRIGHT +17 COPYRIGHT ============ -Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni +Diese Datei ist Copyright (C) 2026 Andrea Mazzoleni -17 SIEHE AUCH (SEE ALSO) +18 SIEHE AUCH (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index d66b4707..a72b4e33 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -90,7 +90,7 @@ características: Puede utilizar discos ya llenos de archivos sin la necesidad de reformatearlos, accediendo a ellos como de costumbre. .IP \(bu -Todos sus datos son hasheados para asegurar la integridad de los datos +Todos sus datos son procesados con hash para asegurar la integridad de los datos y prevenir la corrupción silenciosa. .IP \(bu Cuando el número de discos fallidos excede el recuento de paridad, @@ -119,7 +119,7 @@ https://www.snapraid.it/ .PD .RE .SH LIMITACIONES (LIMITATIONS) -SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar +SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo de combinar los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería considerar antes de usarlo. .PP @@ -164,7 +164,7 @@ Con una copia de seguridad, puede recuperarse de un fallo completo de todo el array de discos. .IP \(bu Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos -y enlaces duros. Los permisos, la propiedad y los atributos +y enlaces físicos. Los permisos, la propiedad y los atributos extendidos no se guardan. .PD .SH PRIMEROS PASOS (GETTING STARTED) @@ -316,7 +316,7 @@ Ahora puede comenzar a usar su array como desee y periódicamente actualizar la información de paridad ejecutando el comando \`sync\`. .SS Limpieza (Scrubbing) Para verificar periódicamente los datos y la paridad en busca de -errores, puede ejecutar el comando \`scrub\` (fregar/limpiar). +errores, puede ejecutar el comando \`scrub\` (depurar/limpiar). .PP .RS 4 snapraid scrub @@ -328,7 +328,7 @@ Este comando compara los datos de su array con el hash calculado durante el comando \`sync\` para verificar la integridad. .PP Cada ejecución del comando verifica aproximadamente el 8% del array, -excluyendo los datos ya fregados en los 10 días anteriores. +excluyendo los datos ya depurados en los 10 días anteriores. Puede usar la opción \-p, \-\-plan para especificar una cantidad diferente y la opción \-o, \-\-older\-than para especificar una edad diferente en días. Por ejemplo, para verificar el 5% del array en @@ -359,9 +359,9 @@ snapraid \-e fix .PD .RE .PP -En el siguiente \`scrub\`, los errores desaparecerán del informe de +En la siguiente depuración (\`scrub\`), los errores desaparecerán del informe de \`status\` si realmente se han corregido. Para hacerlo más rápido, -puede usar \-p bad para fregar solo los bloques marcados como defectuosos. +puede usar \-p bad para depurar solo los bloques marcados como defectuosos. .PP .RS 4 snapraid \-p bad scrub @@ -377,7 +377,7 @@ se marcan como defectuosos. Nota: La función de pooling descrita a continuación ha sido sustituida por la herramienta mergerfs, que ahora es la opción recomendada para los usuarios de Linux en la comunidad SnapRAID. -Mergefs proporciona una forma más flexible y eficiente de agrupar +Mergerfs proporciona una forma más flexible y eficiente de agrupar múltiples unidades en un único punto de montaje unificado, permitiendo un acceso sin problemas a los archivos en todo su array sin depender de enlaces simbólicos. Se integra bien con SnapRAID @@ -571,8 +571,8 @@ Ha sucedido lo peor, ¡y ha perdido uno o más discos! .PP Lo primero que debe hacer es evitar más cambios en su array de discos. Deshabilite cualquier conexión remota a él y cualquier proceso -programado, incluida cualquier sincronización o fregado nocturno -programado de SnapRAID. +programado, incluida cualquier sincronización o depuración nocturna +programada de SnapRAID. .PP Luego, proceda con los siguientes pasos. .SS STEP 1 \-> Reconfigure @@ -675,7 +675,7 @@ Si todo se recupera, este comando es inmediato. SnapRAID proporciona unos pocos comandos simples que le permiten: .PD 0 .IP \(bu -Mostrar el estado de la matriz \-> \`status\` +Mostrar el estado del array \-> \`status\` .IP \(bu Controlar los discos \-> \`smart\`, \`probe\`, \`up\`, \`down\` .IP \(bu @@ -692,7 +692,7 @@ Imprime un resumen del estado del array de discos. .PP Incluye información sobre la fragmentación de la paridad, la antigüedad de los bloques sin verificar y todos los errores silenciosos -registrados encontrados durante el fregado. +registrados encontrados durante la depuración. .PP La información presentada se refiere a la última vez que ejecutó \`sync\`. Las modificaciones posteriores no se tienen en cuenta. @@ -701,8 +701,8 @@ Si se detectaron bloques defectuosos, se enumeran sus números de bloque. Para corregirlos, puede usar el comando \`fix \-e\`. .PP También muestra un gráfico que representa la última vez que cada -bloque fue fregado o sincronizado. Los bloques fregados se muestran -con \`*\`, los bloques sincronizados pero aún no fregados con \`o\`. +bloque fue depurado o sincronizado. Los bloques depurados se muestran +con \`*\`, los bloques sincronizados pero aún no depurados con \`o\`. .PP Nada se modifica. .SS smart @@ -878,38 +878,38 @@ pero la información de hash calculada previamente se mantiene. Los archivos \`content\` y \`parity\` se modifican si es necesario. Los archivos en el array NO se modifican. .SS scrub -Frota (scrubs) el array, buscando errores silenciosos o de +Depura (scrubs) el array, buscando errores silenciosos o de entrada/salida en los discos de datos y paridad. .PP Cada invocación verifica aproximadamente el 8% del array, excluyendo -los datos ya fregados en los últimos 10 días. -Esto significa que fregar una vez a la semana asegura que cada bit de +los datos ya depurados en los últimos 10 días. +Esto significa que depurar una vez a la semana asegura que cada bit de datos se verifique al menos una vez cada tres meses. .PP -Puede definir un plan de fregado o una cantidad diferente utilizando +Puede definir un plan de depuración o una cantidad diferente utilizando la opción \-p, \-\-plan, que acepta: -bad \- Fregar bloques marcados como defectuosos. -new \- Fregar bloques recién sincronizados que aún no han sido fregados. -full \- Fregar todo. -0\-100 \- Fregar el porcentaje especificado de bloques. +bad \- Depurar bloques marcados como defectuosos. +new \- Depurar bloques recién sincronizados que aún no han sido depurados. +full \- Depurar todo. +0\-100 \- Depurar el porcentaje especificado de bloques. .PP Si especifica un valor de porcentaje, también puede usar la opción \-o, \-\-older\-than para definir la antigüedad del bloque. -Los bloques más antiguos se friegan primero, asegurando una verificación +Los bloques más antiguos se depuran primero, asegurando una verificación óptima. -Si desea fregar solo los bloques recién sincronizados que aún no han -sido fregados, use la opción \`\-p new\`. +Si desea depurar solo los bloques recién sincronizados que aún no han +sido depurados, use la opción \`\-p new\`. .PP -Para obtener detalles del estado del fregado, use el comando \`status\`. +Para obtener detalles del estado de la depuración, use el comando \`status\`. .PP Para cualquier error silencioso o de entrada/salida encontrado, los bloques correspondientes se marcan como defectuosos en el archivo \`content\`. Estos bloques defectuosos se enumeran en \`status\` y se pueden corregir con \`fix \-e\`. -Después de la corrección, en el siguiente fregado, se volverán a +Después de la corrección, en la siguiente depuración, se volverán a verificar y, si se encuentran corregidos, se eliminará la marca de defectuoso. -Para fregar solo los bloques defectuosos, puede usar el comando +Para depurar solo los bloques defectuosos, puede usar el comando \`scrub \-p bad\`. .PP Se recomienda ejecutar \`scrub\` solo en un array sincronizado para evitar @@ -1118,19 +1118,19 @@ según se enumeran en \`status\`. Esta opción solo se puede usar con \`check\` y \`fix\`. .TP .B \-p, \-\-plan PERC|bad|new|full -Selecciona el plan de fregado (scrub). Si PERC es un valor +Selecciona el plan de depuración (scrub). Si PERC es un valor numérico de 0 a 100, se interpreta como el porcentaje de -bloques a fregar. +bloques a depurar. En lugar de un porcentaje, puede especificar un plan: -\`bad\` friega bloques defectuosos, \`new\` friega bloques aún -no fregados, y \`full\` friega todo. +\`bad\` depura bloques defectuosos, \`new\` depura bloques aún +no depurados, y \`full\` depura todo. Esta opción solo se puede usar con \`scrub\`. .TP .B \-o, \-\-older\-than DAYS Selecciona la parte más antigua del array para procesar en \`scrub\`. -DAYS es la edad mínima en días para que un bloque sea fregado; +DAYS es la edad mínima en días para que un bloque sea depurado; el valor predeterminado es 10. -Los bloques marcados como defectuosos siempre se friegan +Los bloques marcados como defectuosos siempre se depuran independientemente de esta opción. Esta opción solo se puede usar con \`scrub\`. .TP @@ -1186,7 +1186,7 @@ Aplica un límite de ancho de banda global para todos los discos. RATE es el número de bytes por segundo. Puede especificar un multiplicador como K, M o G (por ejemplo, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail TAMAÑO +.B \-t, \-\-tail SIZE Limita la lista de archivos a aquellos que no usan más del tamaño de cola especificado de los discos de paridad. Puede usar multiplicadores como K, M, G o T (por ejemplo, \-\-tail 1G). @@ -1294,9 +1294,9 @@ Esta opción solo se puede usar con \`sync\`. recomienda encarecidamente no usarla. NO tiene protección de datos durante la operación \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail TAMAÑO +.B \-W, \-\-force\-realloc\-tail SIZE Funciona como \-R, \-\-force\-realloc, pero limitado a la porción final -especificada (últimos TAMAÑO bytes) de cada archivo de paridad. +especificada (últimos SIZE bytes) de cada archivo de paridad. Fuerza la reasignación (movimiento) de cualquier fragmento/bloque de archivo actualmente almacenado en esa sección final, permitiendo que se coloquen en cualquier lugar de los archivos de paridad donde haya espacio libre @@ -1487,8 +1487,8 @@ realiza utilizando el UUID almacenado de los discos. Define el nombre y el punto de montaje de discos adicionales para monitorear con los comandos \`smart\` y \`probe\`. .PP -Esto es útil para monitorear discos que no forman parte de la -matriz pero que son necesarios para que el sistema funcione, como +Esto es útil para monitorear discos que no forman parte del +array pero que son necesarios para que el sistema funcione, como el disco de arranque. .PP Tenga en cuenta que dichos discos no se ven afectados por los comandos \`up\` y \`down\` @@ -1503,7 +1503,7 @@ archivos, evitando errores causados por modificaciones concurrentes de archivos. .PP Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo, permanece preservado en la instantánea. Esto evita que la paridad se \[dq]rompa\[dq] -para ese bloque, asegurando che aún pueda recuperar los datos con éxito +para ese bloque, asegurando que aún pueda recuperar los datos con éxito si falla otro disco. .PP Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de @@ -1636,7 +1636,7 @@ RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB .PD 0 .PD .SS autosave SIZE_IN_GIGABYTES -Guarda automáticamente el estado al sincronizar o fregar después de +Guarda automáticamente el estado al sincronizar o depurar después de la cantidad especificada de GB procesados. Esta opción es útil para evitar reiniciar comandos \`sync\` largos desde cero si son interrumpidos por un fallo de la máquina o @@ -1970,7 +1970,7 @@ en sus discos sanos mientras se realiza una recuperación, SnapRAID tenga una referencia estable y congelada para resolver las ecuaciones de paridad. .PP Si no se proporciona la opción \-d, SnapRAID asume que la operación se aplica -a toda la matriz, en cuyo caso, \`check\` y \`fix\` usarán los sistemas +a todo el array, en cuyo caso, \`check\` y \`fix\` usarán los sistemas de archivos activos exclusivamente. .PP Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. @@ -2288,10 +2288,25 @@ configurar la consola de Windows en modo UTF\-8 con el comando como fuente de la consola. Esto afecta solo a los nombres de archivo impresos; si redirige la salida de la consola a un archivo, el archivo resultante siempre está en formato UTF\-8. +.SH CóDIGO DE SALIDA (EXIT CODE) +SnapRAID termina con los siguientes códigos de error: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Todo bien. +.HP 4 +.I 1 +El comando encontró algunos errores. +.HP 4 +.I 2 +El comando \`diff\` determinó que todo está bien, pero se necesita un \`sync\`. +.PD +.RE .SH TRADUCCIóN (TRANSLATION) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. .SH COPYRIGHT -Este archivo es Copyright (C) 2025 Andrea Mazzoleni +Este archivo es Copyright (C) 2026 Andrea Mazzoleni .SH VéASE TAMBIéN (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 96a4c243..eaf7a167 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -34,7 +34,7 @@ Descripción (Description) * Puede utilizar discos ya llenos de archivos sin la necesidad de reformatearlos, accediendo a ellos como de costumbre. - * Todos sus datos son hasheados para asegurar la integridad de los datos + * Todos sus datos son procesados con hash para asegurar la integridad de los datos y prevenir la corrupción silenciosa. * Cuando el número de discos fallidos excede el recuento de paridad, la pérdida de datos se limita a los discos afectados; los datos en @@ -53,7 +53,7 @@ Descripción (Description) :https://www.snapraid.it/ Limitaciones (Limitations) - SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar + SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo de combinar los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería considerar antes de usarlo. @@ -89,7 +89,7 @@ Limitaciones (Limitations) Con una copia de seguridad, puede recuperarse de un fallo completo de todo el array de discos. * Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos - y enlaces duros. Los permisos, la propiedad y los atributos + y enlaces físicos. Los permisos, la propiedad y los atributos extendidos no se guardan. Primeros pasos (Getting Started) @@ -177,7 +177,7 @@ Primeros pasos (Getting Started) Limpieza (Scrubbing) Para verificar periódicamente los datos y la paridad en busca de - errores, puede ejecutar el comando `scrub` (fregar/limpiar). + errores, puede ejecutar el comando `scrub` (depurar/limpiar). :snapraid scrub @@ -185,7 +185,7 @@ Primeros pasos (Getting Started) durante el comando `sync` para verificar la integridad. Cada ejecución del comando verifica aproximadamente el 8% del array, - excluyendo los datos ya fregados en los 10 días anteriores. + excluyendo los datos ya depurados en los 10 días anteriores. Puede usar la opción -p, --plan para especificar una cantidad diferente y la opción -o, --older-than para especificar una edad diferente en días. Por ejemplo, para verificar el 5% del array en @@ -204,9 +204,9 @@ Primeros pasos (Getting Started) :snapraid -e fix - En el siguiente `scrub`, los errores desaparecerán del informe de + En la siguiente depuración (`scrub`), los errores desaparecerán del informe de `status` si realmente se han corregido. Para hacerlo más rápido, - puede usar -p bad para fregar solo los bloques marcados como defectuosos. + puede usar -p bad para depurar solo los bloques marcados como defectuosos. :snapraid -p bad scrub @@ -219,7 +219,7 @@ Primeros pasos (Getting Started) Nota: La función de pooling descrita a continuación ha sido sustituida por la herramienta mergerfs, que ahora es la opción recomendada para los usuarios de Linux en la comunidad SnapRAID. - Mergefs proporciona una forma más flexible y eficiente de agrupar + Mergerfs proporciona una forma más flexible y eficiente de agrupar múltiples unidades en un único punto de montaje unificado, permitiendo un acceso sin problemas a los archivos en todo su array sin depender de enlaces simbólicos. Se integra bien con SnapRAID @@ -322,8 +322,8 @@ Primeros pasos (Getting Started) Lo primero que debe hacer es evitar más cambios en su array de discos. Deshabilite cualquier conexión remota a él y cualquier proceso - programado, incluida cualquier sincronización o fregado nocturno - programado de SnapRAID. + programado, incluida cualquier sincronización o depuración nocturna + programada de SnapRAID. Luego, proceda con los siguientes pasos. @@ -410,7 +410,7 @@ Primeros pasos (Getting Started) Comandos (Commands) SnapRAID proporciona unos pocos comandos simples que le permiten: - * Mostrar el estado de la matriz -> `status` + * Mostrar el estado del array -> `status` * Controlar los discos -> `smart`, `probe`, `up`, `down` * Crear un punto de copia de seguridad/recuperación -> `sync` * Comprobar periódicamente los datos -> `scrub` @@ -423,7 +423,7 @@ Comandos (Commands) Incluye información sobre la fragmentación de la paridad, la antigüedad de los bloques sin verificar y todos los errores silenciosos - registrados encontrados durante el fregado. + registrados encontrados durante la depuración. La información presentada se refiere a la última vez que ejecutó `sync`. Las modificaciones posteriores no se tienen en cuenta. @@ -432,8 +432,8 @@ Comandos (Commands) Para corregirlos, puede usar el comando `fix -e`. También muestra un gráfico que representa la última vez que cada - bloque fue fregado o sincronizado. Los bloques fregados se muestran - con `*`, los bloques sincronizados pero aún no fregados con `o`. + bloque fue depurado o sincronizado. Los bloques depurados se muestran + con `*`, los bloques sincronizados pero aún no depurados con `o`. Nada se modifica. @@ -582,38 +582,38 @@ Comandos (Commands) Los archivos en el array NO se modifican. scrub - Frota (scrubs) el array, buscando errores silenciosos o de + Depura (scrubs) el array, buscando errores silenciosos o de entrada/salida en los discos de datos y paridad. Cada invocación verifica aproximadamente el 8% del array, excluyendo - los datos ya fregados en los últimos 10 días. - Esto significa que fregar una vez a la semana asegura que cada bit de + los datos ya depurados en los últimos 10 días. + Esto significa que depurar una vez a la semana asegura que cada bit de datos se verifique al menos una vez cada tres meses. - Puede definir un plan de fregado o una cantidad diferente utilizando + Puede definir un plan de depuración o una cantidad diferente utilizando la opción -p, --plan, que acepta: - bad - Fregar bloques marcados como defectuosos. - new - Fregar bloques recién sincronizados que aún no han sido fregados. - full - Fregar todo. - 0-100 - Fregar el porcentaje especificado de bloques. + bad - Depurar bloques marcados como defectuosos. + new - Depurar bloques recién sincronizados que aún no han sido depurados. + full - Depurar todo. + 0-100 - Depurar el porcentaje especificado de bloques. Si especifica un valor de porcentaje, también puede usar la opción -o, --older-than para definir la antigüedad del bloque. - Los bloques más antiguos se friegan primero, asegurando una verificación + Los bloques más antiguos se depuran primero, asegurando una verificación óptima. - Si desea fregar solo los bloques recién sincronizados que aún no han - sido fregados, use la opción `-p new`. + Si desea depurar solo los bloques recién sincronizados que aún no han + sido depurados, use la opción `-p new`. - Para obtener detalles del estado del fregado, use el comando `status`. + Para obtener detalles del estado de la depuración, use el comando `status`. Para cualquier error silencioso o de entrada/salida encontrado, los bloques correspondientes se marcan como defectuosos en el archivo `content`. Estos bloques defectuosos se enumeran en `status` y se pueden corregir con `fix -e`. - Después de la corrección, en el siguiente fregado, se volverán a + Después de la corrección, en la siguiente depuración, se volverán a verificar y, si se encuentran corregidos, se eliminará la marca de defectuoso. - Para fregar solo los bloques defectuosos, puede usar el comando + Para depurar solo los bloques defectuosos, puede usar el comando `scrub -p bad`. Se recomienda ejecutar `scrub` solo en un array sincronizado para evitar @@ -832,19 +832,19 @@ Opciones (Options) Esta opción solo se puede usar con `check` y `fix`. -p, --plan PERC|bad|new|full - Selecciona el plan de fregado (scrub). Si PERC es un valor + Selecciona el plan de depuración (scrub). Si PERC es un valor numérico de 0 a 100, se interpreta como el porcentaje de - bloques a fregar. + bloques a depurar. En lugar de un porcentaje, puede especificar un plan: - `bad` friega bloques defectuosos, `new` friega bloques aún - no fregados, y `full` friega todo. + `bad` depura bloques defectuosos, `new` depura bloques aún + no depurados, y `full` depura todo. Esta opción solo se puede usar con `scrub`. -o, --older-than DAYS Selecciona la parte más antigua del array para procesar en `scrub`. - DAYS es la edad mínima en días para que un bloque sea fregado; + DAYS es la edad mínima en días para que un bloque sea depurado; el valor predeterminado es 10. - Los bloques marcados como defectuosos siempre se friegan + Los bloques marcados como defectuosos siempre se depuran independientemente de esta opción. Esta opción solo se puede usar con `scrub`. @@ -900,7 +900,7 @@ Opciones (Options) RATE es el número de bytes por segundo. Puede especificar un multiplicador como K, M o G (por ejemplo, --bw-limit 1G). - -t, --tail TAMAÑO + -t, --tail SIZE Limita la lista de archivos a aquellos que no usan más del tamaño de cola especificado de los discos de paridad. Puede usar multiplicadores como K, M, G o T (por ejemplo, --tail 1G). @@ -1008,9 +1008,9 @@ Opciones (Options) recomienda encarecidamente no usarla. NO tiene protección de datos durante la operación `sync`. - -W, --force-realloc-tail TAMAÑO + -W, --force-realloc-tail SIZE Funciona como -R, --force-realloc, pero limitado a la porción final - especificada (últimos TAMAÑO bytes) de cada archivo de paridad. + especificada (últimos SIZE bytes) de cada archivo de paridad. Fuerza la reasignación (movimiento) de cualquier fragmento/bloque de archivo actualmente almacenado en esa sección final, permitiendo que se coloquen en cualquier lugar de los archivos de paridad donde haya espacio libre @@ -1202,8 +1202,8 @@ Configuración (Configuration) Define el nombre y el punto de montaje de discos adicionales para monitorear con los comandos `smart` y `probe`. - Esto es útil para monitorear discos que no forman parte de la - matriz pero que son necesarios para que el sistema funcione, como + Esto es útil para monitorear discos que no forman parte del + array pero que son necesarios para que el sistema funcione, como el disco de arranque. Tenga en cuenta que dichos discos no se ven afectados por los comandos `up` y `down` @@ -1219,7 +1219,7 @@ Configuración (Configuration) Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo, permanece preservado en la instantánea. Esto evita que la paridad se "rompa" - para ese bloque, asegurando che aún pueda recuperar los datos con éxito + para ese bloque, asegurando que aún pueda recuperar los datos con éxito si falla otro disco. Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de @@ -1345,7 +1345,7 @@ Configuración (Configuration) :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB autosave SIZE_IN_GIGABYTES - Guarda automáticamente el estado al sincronizar o fregar después de + Guarda automáticamente el estado al sincronizar o depurar después de la cantidad especificada de GB procesados. Esta opción es útil para evitar reiniciar comandos `sync` largos desde cero si son interrumpidos por un fallo de la máquina o @@ -1573,7 +1573,7 @@ Instantáneas (Snapshots) tenga una referencia estable y congelada para resolver las ecuaciones de paridad. Si no se proporciona la opción -d, SnapRAID asume que la operación se aplica - a toda la matriz, en cuyo caso, `check` y `fix` usarán los sistemas + a todo el array, en cuyo caso, `check` y `fix` usarán los sistemas de archivos activos exclusivamente. Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. @@ -1812,12 +1812,19 @@ Codificación (Encoding) archivo impresos; si redirige la salida de la consola a un archivo, el archivo resultante siempre está en formato UTF-8. +Código de salida (Exit Code) + SnapRAID termina con los siguientes códigos de error: + + 0 - Todo bien. + 1 - El comando encontró algunos errores. + 2 - El comando `diff` determinó que todo está bien, pero se necesita un `sync`. + Traducción (Translation) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. Copyright - Este archivo es Copyright (C) 2025 Andrea Mazzoleni + Este archivo es Copyright (C) 2026 Andrea Mazzoleni Véase también (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index b142f720..0f06e902 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -41,7 +41,7 @@ características: * Puede utilizar discos ya llenos de archivos sin la necesidad de reformatearlos, accediendo a ellos como de costumbre. -* Todos sus datos son hasheados para asegurar la integridad de los datos +* Todos sus datos son procesados con hash para asegurar la integridad de los datos y prevenir la corrupción silenciosa. * Cuando el número de discos fallidos excede el recuento de paridad, la pérdida de datos se limita a los discos afectados; los datos en @@ -63,7 +63,7 @@ Para más información, visite el sitio oficial de SnapRAID: 3 LIMITACIONES (LIMITATIONS) ============================ -SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar +SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo de combinar los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería considerar antes de usarlo. @@ -99,7 +99,7 @@ Otras limitaciones de SnapRAID son: Con una copia de seguridad, puede recuperarse de un fallo completo de todo el array de discos. * Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos - y enlaces duros. Los permisos, la propiedad y los atributos + y enlaces físicos. Los permisos, la propiedad y los atributos extendidos no se guardan. @@ -192,7 +192,7 @@ actualizar la información de paridad ejecutando el comando `sync`. ------------------------ Para verificar periódicamente los datos y la paridad en busca de -errores, puede ejecutar el comando `scrub` (fregar/limpiar). +errores, puede ejecutar el comando `scrub` (depurar/limpiar). snapraid scrub @@ -200,7 +200,7 @@ Este comando compara los datos de su array con el hash calculado durante el comando `sync` para verificar la integridad. Cada ejecución del comando verifica aproximadamente el 8% del array, -excluyendo los datos ya fregados en los 10 días anteriores. +excluyendo los datos ya depurados en los 10 días anteriores. Puede usar la opción -p, --plan para especificar una cantidad diferente y la opción -o, --older-than para especificar una edad diferente en días. Por ejemplo, para verificar el 5% del array en @@ -219,9 +219,9 @@ por bloques defectuosos con la opción -e, --filter-error: snapraid -e fix -En el siguiente `scrub`, los errores desaparecerán del informe de +En la siguiente depuración (`scrub`), los errores desaparecerán del informe de `status` si realmente se han corregido. Para hacerlo más rápido, -puede usar -p bad para fregar solo los bloques marcados como defectuosos. +puede usar -p bad para depurar solo los bloques marcados como defectuosos. snapraid -p bad scrub @@ -236,7 +236,7 @@ se marcan como defectuosos. Nota: La función de pooling descrita a continuación ha sido sustituida por la herramienta mergerfs, que ahora es la opción recomendada para los usuarios de Linux en la comunidad SnapRAID. -Mergefs proporciona una forma más flexible y eficiente de agrupar +Mergerfs proporciona una forma más flexible y eficiente de agrupar múltiples unidades en un único punto de montaje unificado, permitiendo un acceso sin problemas a los archivos en todo su array sin depender de enlaces simbólicos. Se integra bien con SnapRAID @@ -343,8 +343,8 @@ Ha sucedido lo peor, ¡y ha perdido uno o más discos! Lo primero que debe hacer es evitar más cambios en su array de discos. Deshabilite cualquier conexión remota a él y cualquier proceso -programado, incluida cualquier sincronización o fregado nocturno -programado de SnapRAID. +programado, incluida cualquier sincronización o depuración nocturna +programada de SnapRAID. Luego, proceda con los siguientes pasos. @@ -434,7 +434,7 @@ Si todo se recupera, este comando es inmediato. SnapRAID proporciona unos pocos comandos simples que le permiten: -* Mostrar el estado de la matriz -> `status` +* Mostrar el estado del array -> `status` * Controlar los discos -> `smart`, `probe`, `up`, `down` * Crear un punto de copia de seguridad/recuperación -> `sync` * Comprobar periódicamente los datos -> `scrub` @@ -449,7 +449,7 @@ Imprime un resumen del estado del array de discos. Incluye información sobre la fragmentación de la paridad, la antigüedad de los bloques sin verificar y todos los errores silenciosos -registrados encontrados durante el fregado. +registrados encontrados durante la depuración. La información presentada se refiere a la última vez que ejecutó `sync`. Las modificaciones posteriores no se tienen en cuenta. @@ -458,8 +458,8 @@ Si se detectaron bloques defectuosos, se enumeran sus números de bloque. Para corregirlos, puede usar el comando `fix -e`. También muestra un gráfico que representa la última vez que cada -bloque fue fregado o sincronizado. Los bloques fregados se muestran -con `*`, los bloques sincronizados pero aún no fregados con `o`. +bloque fue depurado o sincronizado. Los bloques depurados se muestran +con `*`, los bloques sincronizados pero aún no depurados con `o`. Nada se modifica. @@ -622,38 +622,38 @@ Los archivos en el array NO se modifican. 5.8 scrub --------- -Frota (scrubs) el array, buscando errores silenciosos o de +Depura (scrubs) el array, buscando errores silenciosos o de entrada/salida en los discos de datos y paridad. Cada invocación verifica aproximadamente el 8% del array, excluyendo -los datos ya fregados en los últimos 10 días. -Esto significa que fregar una vez a la semana asegura que cada bit de +los datos ya depurados en los últimos 10 días. +Esto significa que depurar una vez a la semana asegura que cada bit de datos se verifique al menos una vez cada tres meses. -Puede definir un plan de fregado o una cantidad diferente utilizando +Puede definir un plan de depuración o una cantidad diferente utilizando la opción -p, --plan, que acepta: -bad - Fregar bloques marcados como defectuosos. -new - Fregar bloques recién sincronizados que aún no han sido fregados. -full - Fregar todo. -0-100 - Fregar el porcentaje especificado de bloques. +bad - Depurar bloques marcados como defectuosos. +new - Depurar bloques recién sincronizados que aún no han sido depurados. +full - Depurar todo. +0-100 - Depurar el porcentaje especificado de bloques. Si especifica un valor de porcentaje, también puede usar la opción -o, --older-than para definir la antigüedad del bloque. -Los bloques más antiguos se friegan primero, asegurando una verificación +Los bloques más antiguos se depuran primero, asegurando una verificación óptima. -Si desea fregar solo los bloques recién sincronizados que aún no han -sido fregados, use la opción `-p new`. +Si desea depurar solo los bloques recién sincronizados que aún no han +sido depurados, use la opción `-p new`. -Para obtener detalles del estado del fregado, use el comando `status`. +Para obtener detalles del estado de la depuración, use el comando `status`. Para cualquier error silencioso o de entrada/salida encontrado, los bloques correspondientes se marcan como defectuosos en el archivo `content`. Estos bloques defectuosos se enumeran en `status` y se pueden corregir con `fix -e`. -Después de la corrección, en el siguiente fregado, se volverán a +Después de la corrección, en la siguiente depuración, se volverán a verificar y, si se encuentran corregidos, se eliminará la marca de defectuoso. -Para fregar solo los bloques defectuosos, puede usar el comando +Para depurar solo los bloques defectuosos, puede usar el comando `scrub -p bad`. Se recomienda ejecutar `scrub` solo en un array sincronizado para evitar @@ -893,19 +893,19 @@ SnapRAID proporciona las siguientes opciones: Esta opción solo se puede usar con `check` y `fix`. -p, --plan PERC|bad|new|full - Selecciona el plan de fregado (scrub). Si PERC es un valor + Selecciona el plan de depuración (scrub). Si PERC es un valor numérico de 0 a 100, se interpreta como el porcentaje de - bloques a fregar. + bloques a depurar. En lugar de un porcentaje, puede especificar un plan: - `bad` friega bloques defectuosos, `new` friega bloques aún - no fregados, y `full` friega todo. + `bad` depura bloques defectuosos, `new` depura bloques aún + no depurados, y `full` depura todo. Esta opción solo se puede usar con `scrub`. -o, --older-than DAYS Selecciona la parte más antigua del array para procesar en `scrub`. - DAYS es la edad mínima en días para que un bloque sea fregado; + DAYS es la edad mínima en días para que un bloque sea depurado; el valor predeterminado es 10. - Los bloques marcados como defectuosos siempre se friegan + Los bloques marcados como defectuosos siempre se depuran independientemente de esta opción. Esta opción solo se puede usar con `scrub`. @@ -961,7 +961,7 @@ SnapRAID proporciona las siguientes opciones: RATE es el número de bytes por segundo. Puede especificar un multiplicador como K, M o G (por ejemplo, --bw-limit 1G). - -t, --tail TAMAÑO + -t, --tail SIZE Limita la lista de archivos a aquellos que no usan más del tamaño de cola especificado de los discos de paridad. Puede usar multiplicadores como K, M, G o T (por ejemplo, --tail 1G). @@ -1069,9 +1069,9 @@ SnapRAID proporciona las siguientes opciones: recomienda encarecidamente no usarla. NO tiene protección de datos durante la operación `sync`. - -W, --force-realloc-tail TAMAÑO + -W, --force-realloc-tail SIZE Funciona como -R, --force-realloc, pero limitado a la porción final - especificada (últimos TAMAÑO bytes) de cada archivo de paridad. + especificada (últimos SIZE bytes) de cada archivo de paridad. Fuerza la reasignación (movimiento) de cualquier fragmento/bloque de archivo actualmente almacenado en esa sección final, permitiendo que se coloquen en cualquier lugar de los archivos de paridad donde haya espacio libre @@ -1278,8 +1278,8 @@ realiza utilizando el UUID almacenado de los discos. Define el nombre y el punto de montaje de discos adicionales para monitorear con los comandos `smart` y `probe`. -Esto es útil para monitorear discos que no forman parte de la -matriz pero que son necesarios para que el sistema funcione, como +Esto es útil para monitorear discos que no forman parte del +array pero que son necesarios para que el sistema funcione, como el disco de arranque. Tenga en cuenta que dichos discos no se ven afectados por los comandos `up` y `down` @@ -1297,7 +1297,7 @@ archivos, evitando errores causados por modificaciones concurrentes de archivos. Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo, permanece preservado en la instantánea. Esto evita que la paridad se "rompa" -para ese bloque, asegurando che aún pueda recuperar los datos con éxito +para ese bloque, asegurando que aún pueda recuperar los datos con éxito si falla otro disco. Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de @@ -1433,7 +1433,7 @@ RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB 7.12 autosave SIZE_IN_GIGABYTES ------------------------------- -Guarda automáticamente el estado al sincronizar o fregar después de +Guarda automáticamente el estado al sincronizar o depurar después de la cantidad especificada de GB procesados. Esta opción es útil para evitar reiniciar comandos `sync` largos desde cero si son interrumpidos por un fallo de la máquina o @@ -1680,7 +1680,7 @@ en sus discos sanos mientras se realiza una recuperación, SnapRAID tenga una referencia estable y congelada para resolver las ecuaciones de paridad. Si no se proporciona la opción -d, SnapRAID asume que la operación se aplica -a toda la matriz, en cuyo caso, `check` y `fix` usarán los sistemas +a todo el array, en cuyo caso, `check` y `fix` usarán los sistemas de archivos activos exclusivamente. Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. @@ -1938,20 +1938,30 @@ archivo impresos; si redirige la salida de la consola a un archivo, el archivo resultante siempre está en formato UTF-8. -15 TRADUCCIóN (TRANSLATION) +15 CóDIGO DE SALIDA (EXIT CODE) +=============================== + +SnapRAID termina con los siguientes códigos de error: + +0 - Todo bien. +1 - El comando encontró algunos errores. +2 - El comando `diff` determinó que todo está bien, pero se necesita un `sync`. + + +16 TRADUCCIóN (TRANSLATION) =========================== Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. -16 COPYRIGHT +17 COPYRIGHT ============ -Este archivo es Copyright (C) 2025 Andrea Mazzoleni +Este archivo es Copyright (C) 2026 Andrea Mazzoleni -17 VéASE TAMBIéN (SEE ALSO) +18 VéASE TAMBIéN (SEE ALSO) =========================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 84f6f5e3..8d91a8c4 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -6,7 +6,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - [\-f, \-\-filter MOTIF] [\-d, \-\-filter\-disk NOM] + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] .PD 0 .PP .PD @@ -14,19 +14,23 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DOSSIER] + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] .PD 0 .PP .PD - [\-p, \-\-plan PERC|mauvais|nouveau|complet] + [\-p, \-\-plan PERC|bad|new|full] .PD 0 .PP .PD - [\-o, \-\-older\-than JOURS] [\-l, \-\-log FICHIER] + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] .PD 0 .PP .PD - [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit DÉBIT] + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-t, \-\-tail] .PD 0 .PP .PD @@ -50,7 +54,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - [\-L, \-\-error\-limit NOMBRE] + [\-L, \-\-error\-limit NUMBER] .PD 0 .PP .PD @@ -70,7 +74,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PD .PP -snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENU] +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] .PD 0 .PD .SH DESCRIPTION @@ -161,7 +165,7 @@ de défaillances de disques. Avec une sauvegarde, vous pouvez récupérer d\'une défaillance complète de toute la baie de disques. .IP \(bu Seuls les noms de fichiers, les horodatages, les liens symboliques -et les liens matériels sont sauvegardés. Les permissions, la +et les liens physiques sont sauvegardés. Les permissions, la propriété et les attributs étendus ne sont pas sauvegardés. .PD .SH DéMARRER (GETTING STARTED) @@ -361,7 +365,7 @@ snapraid \-e fix .PP Lors du prochain \`scrub\`, les erreurs disparaîtront du rapport \`status\` si elles sont réellement corrigées. Pour accélérer, -vous pouvez utiliser \-p mauvais pour nettoyer uniquement les blocs +vous pouvez utiliser \-p bad pour nettoyer uniquement les blocs marqués comme mauvais. .PP .RS 4 @@ -377,7 +381,7 @@ ne sont pas marqués comme mauvais. .SS Mise en commun (Pooling) Note : La fonctionnalité de mise en commun décrite ci\-dessous a été remplacée par l\'outil mergerfs, qui est désormais l\'option recommandée -pour les utilisateurs Linux de la communauté SnapRAID. Mergefs offre +pour les utilisateurs Linux de la communauté SnapRAID. Mergerfs offre un moyen plus flexible et efficace de regrouper plusieurs disques dans un seul point de montage unifié, permettant un accès transparent aux fichiers sur toute votre baie sans dépendre de liens symboliques. @@ -539,7 +543,7 @@ ou récupérer des fichiers dans leur état précédent à l\'aide de l\'option \-f, \-\-filter : .PP .RS 4 -snapraid fix \-f FICHIER +snapraid fix \-f FILE .PD 0 .PD .RE @@ -547,7 +551,7 @@ snapraid fix \-f FICHIER ou pour un répertoire : .PP .RS 4 -snapraid fix \-f DOSSIER/ +snapraid fix \-f DIR/ .PD 0 .PD .RE @@ -559,7 +563,7 @@ qui ne restaure que les fichiers manquants, laissant tous les autres intacts. .PP .RS 4 -snapraid fix \-m \-f DOSSIER/ +snapraid fix \-m \-f DIR/ .PD 0 .PD .RE @@ -617,12 +621,12 @@ Exécutez la commande fix, en stockant le journal dans un fichier externe avec : .PP .RS 4 -snapraid \-d NOM \-l fix.log fix +snapraid \-d NAME \-l fix.log fix .PD 0 .PD .RE .PP -Où NOM est le nom du disque, tel que \`d1\` dans notre exemple précédent. +Où NAME est le nom du disque, tel que \`d1\` dans notre exemple précédent. Si le disque à récupérer est un disque de parité, utilisez les noms \`parity\`, \`2\-parity\`, etc. Si vous avez plusieurs disques défaillants, utilisez plusieurs @@ -658,12 +662,12 @@ Par précaution, vous pouvez maintenant exécuter une commande \`check\` pour vous assurer que tout est correct sur le disque récupéré. .PP .RS 4 -snapraid \-d NOM \-a check +snapraid \-d NAME \-a check .PD 0 .PD .RE .PP -Où NOM est le nom du disque, tel que \`d1\` dans notre exemple précédent. +Où NAME est le nom du disque, tel que \`d1\` dans notre exemple précédent. .PP Les options \-d et \-a indiquent à SnapRAID de vérifier uniquement le disque spécifié et d\'ignorer toutes les données de parité. @@ -752,7 +756,7 @@ Le journal d\'auto\-test du périphérique contient des erreurs. .PD .RE .PP -Si l\'option \-v, \-\-verbose est spécifiée, une analyse statistique +Si l\'option \`\-v, \-\-verbose\` est spécifiée, une analyse statistique plus approfondie est fournie. Cette analyse peut vous aider à décider si vous avez besoin de plus ou moins de parité. .PP @@ -1091,11 +1095,11 @@ s\'il existe, sinon \`/etc/snapraid.conf\`. Sous Windows, il utilise le fichier \`snapraid.conf\` dans le même répertoire que \`snapraid.exe\`. .TP -.B \-f, \-\-filter MOTIF +.B \-f, \-\-filter PATTERN Filtre les fichiers à traiter dans \`check\` et \`fix\`. Seuls les fichiers correspondant au motif spécifié sont traités. Cette option peut être utilisée plusieurs fois. -Voir la section MOTIF pour plus de détails sur les +Voir la section PATTERN pour plus de détails sur les spécifications de motifs. Sous Unix, assurez\-vous que les caractères de globbing sont entre guillemets s\'ils sont utilisés. @@ -1103,7 +1107,7 @@ Cette option ne peut être utilisée qu\'avec \`check\` et \`fix\`. Elle ne peut pas être utilisée avec \`sync\` et \`scrub\`, car ils traitent toujours l\'intégralité de la baie. .TP -.B \-d, \-\-filter\-disk NOM +.B \-d, \-\-filter\-disk NAME Filtre les disques à traiter dans \`check\`, \`fix\`, \`up\` et \`down\`. Vous devez spécifier un nom de disque tel que défini dans le fichier de configuration. @@ -1147,9 +1151,9 @@ Au lieu d\'un pourcentage, vous pouvez spécifier un plan : qui n\'ont pas encore été nettoyés, et \`full\` nettoie tout. Cette option ne peut être utilisée qu\'avec \`scrub\`. .TP -.B \-o, \-\-older\-than JOURS +.B \-o, \-\-older\-than DAYS Sélectionne la partie la plus ancienne de la baie à traiter dans \`scrub\`. -JOURS est l\'âge minimum en jours pour qu\'un bloc soit nettoyé ; +DAYS est l\'âge minimum en jours pour qu\'un bloc soit nettoyé ; la valeur par défaut est 10. Les blocs marqués comme mauvais sont toujours nettoyés, quelle que soit cette option. @@ -1186,7 +1190,7 @@ réussi et, si nécessaire, vous permet d\'exécuter une opération fix avant de continuer. Cette option ne peut être utilisée qu\'avec \`sync\`. .TP -.B \-i, \-\-import DOSSIER +.B \-i, \-\-import DIR Importe à partir du répertoire spécifié tous les fichiers supprimés de la baie après le dernier \`sync\`. Si vous avez toujours de tels fichiers, ils peuvent être utilisés @@ -1204,12 +1208,12 @@ et une consommation d\'énergie. Utilisez cette option pour vous assurer que les disques sont arrêtés en toute sécurité même lorsqu\'une commande échoue. .TP -.B \-w, \-\-bw\-limit DÉBIT +.B \-w, \-\-bw\-limit RATE Applique une limite de bande passante globale pour tous les disques. -Le DÉBIT est le nombre d\'octets par seconde. Vous pouvez spécifier -un multiplicateur tel que K, M ou G (par exemple, \-\-bw\-limit 1G). +Le RATE est le nombre d\'octets par seconde. Vous pouvez spécifier +un multiplicateur tel que K, M, G ou T (par exemple, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail TAILLE +.B \-t, \-\-tail SIZE Limite la liste des fichiers à ceux n\'utilisant pas plus que la taille de queue spécifiée des disques de parité. Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: \-\-tail 1G). @@ -1322,9 +1326,9 @@ AVERTISSEMENT ! Cette option est réservée aux experts, et il est fortement recommandé de ne pas l\'utiliser. Vous N\'AVEZ AUCUNE protection des données pendant l\'opération \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail TAILLE -Fonctionne comme \-R, \-\-force\-realloc, maar limité à la partie terminale -spécifiée (les derniers TAILLE octets) de chaque fichier de parité. +.B \-W, \-\-force\-realloc\-tail SIZE +Fonctionne comme \-R, \-\-force\-realloc, mais limité à la partie terminale +spécifiée (les derniers SIZE octets) de chaque fichier de parité. Force la réallocation (déplacement) de tout fragment/bloc de fichier actuellement stocké dans cette section terminale, leur permettant d\'être placés n\'importe où dans le(s) fichier(s) de parité où de l\'espace libre @@ -1344,7 +1348,7 @@ recommandé de ne pas l\'utiliser. Vous n\'avez PAS de protection des données pendant l\'opération \`sync\` pour les fichiers affectés. .TP -.B \-l, \-\-log FICHIER +.B \-l, \-\-log FILE Écrit un journal détaillé dans le fichier spécifié. Si cette option n\'est pas spécifiée, les erreurs inattendues sont imprimées à l\'écran, ce qui peut entraîner une sortie @@ -1364,7 +1368,7 @@ respectivement. Consultez le fichier ou la page de manuel snapraid_log.txt pour les descriptions des balises de journal. .TP -.B \-L, \-\-error\-limit NOMBRE +.B \-L, \-\-error\-limit NUMBER Définit une nouvelle limite d\'erreurs avant d\'arrêter l\'exécution. Par défaut, SnapRAID s\'arrête s\'il rencontre plus de 100 erreurs d\'entrée/sortie, indiquant qu\'un disque est @@ -1384,7 +1388,7 @@ Cette option est principalement destinée à la récupération manuelle avancée Ne traite que le nombre de blocs spécifié. Cette option est principalement destinée à la récupération manuelle avancée. .TP -.B \-C, \-\-gen\-conf CONTENU +.B \-C, \-\-gen\-conf CONTENT Génère un fichier de configuration factice à partir d\'un fichier de contenu existant. Le fichier de configuration est écrit sur la sortie standard @@ -1422,7 +1426,7 @@ Sous Windows, il utilise le fichier \`snapraid.conf\` dans le même répertoire que \`snapraid.exe\`. .PP Il doit contenir les options suivantes (sensibles à la casse) : -.SS parity FICHIER [,FICHIER] ... +.SS parity FILE [,FILE] ... Définit les fichiers à utiliser pour stocker les informations de parité. La parité permet une protection contre une seule défaillance de disque, similaire au RAID5. @@ -1443,7 +1447,7 @@ Sous Windows, 256 Mo sont laissés inutilisés sur chaque disque pour éviter l\'avertissement concernant les disques pleins. .PP Cette option est obligatoire et ne peut être utilisée qu\'une seule fois. -.SS (2,3,4,5,6)\-parity FICHIER [,FICHIER] ... +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... Définit les fichiers à utiliser pour stocker les informations de parité supplémentaires. .PP @@ -1468,7 +1472,7 @@ de parité précédents. Les mêmes considérations que pour l\'option \`parity\` s\'appliquent. .PP Ces options sont facultatives et ne peuvent être utilisées qu\'une seule fois. -.SS z\-parity FICHIER [,FICHIER] ... +.SS z\-parity FILE [,FILE] ... Définit un fichier et un format alternatifs pour stocker la triple parité. .PP Cette option est une alternative à \`3\-parity\`, principalement destinée @@ -1486,7 +1490,7 @@ performances. Il est possible de convertir d\'un format à l\'autre en ajustant le fichier de configuration avec le fichier z\-parity ou 3\-parity souhaité et en utilisant \`fix\` pour le recréer. -.SS content FICHIER +.SS content FILE Définit le fichier à utiliser pour stocker la liste et les sommes de contrôle de tous les fichiers présents dans votre baie de disques. .PP @@ -1500,19 +1504,19 @@ enregistrer plusieurs copies du même fichier. .PP Vous devez stocker au moins une copie pour chaque disque de parité utilisé plus un. L\'utilisation de copies supplémentaires ne nuit pas. -.SS data NOM DOSSIER +.SS data NAME DIR Définit le nom et le point de montage des disques de données dans -la baie. NOM est utilisé pour identifier le disque et doit -être unique. DOSSIER est le point de montage du disque dans le +la baie. NAME est utilisé pour identifier le disque et doit +être unique. DIR est le point de montage du disque dans le système de fichiers. .PP Vous pouvez modifier le point de montage au besoin, tant que -vous gardez le NOM fixe. +vous gardez le NAME fixe. .PP Vous devriez utiliser une option pour chaque disque de données de la baie. .PP -Vous pouvez renommer un disque plus tard en changeant le NOM directement +Vous pouvez renommer un disque plus tard en changeant le NAME directement dans le fichier de configuration, puis en exécutant une commande \`sync\`. Dans le cas d\'un renommage, l\'association est faite en utilisant l\'UUID stocké des disques. @@ -1554,7 +1558,7 @@ des instantanés. Exclut tous les fichiers et répertoires cachés. Sous Unix, les fichiers cachés sont ceux commençant par \`.\`. Sous Windows, ce sont ceux avec l\'attribut caché. -.SS exclude/include MOTIF +.SS exclude/include PATTERN Définit les motifs de fichiers ou de répertoires à exclure ou à inclure dans le processus de synchronisation. Tous les motifs sont traités dans l\'ordre spécifié. @@ -1565,11 +1569,11 @@ Si aucun motif ne correspond, le fichier est exclu si le dernier motif spécifié est un \`include\`, ou inclus si le dernier motif spécifié est un \`exclude\`. .PP -Voir la section MOTIF pour plus de détails sur les +Voir la section PATTERN pour plus de détails sur les spécifications de motifs. .PP Cette option peut être utilisée plusieurs fois. -.SS blocksize TAILLE_EN_KIBIOCTETS +.SS blocksize SIZE_IN_KIBIBYTES Définit la taille de bloc de base en kibioctets pour la parité. Un kibioctet est de 1024 octets. .PP @@ -1625,7 +1629,7 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE Cela se traduit par environ 1,5 % d\'espace supplémentaire, environ 60 Go pour un disque de 4 To, ce qui permet environ 460 000 fichiers sur chaque disque de données sans aucun espace gaspillé. -.SS hashsize TAILLE_EN_OCTETS +.SS hashsize SIZE_IN_BYTES Définit la taille du hachage en octets pour les blocs enregistrés. .PP La taille de hachage par défaut est de 16 octets (128 bits), @@ -1637,7 +1641,7 @@ cette valeur à l\'avenir, vous devrez recréer l\'intégralité de la parité ! .PP Une raison d\'utiliser une taille de hachage différente est si votre système a une mémoire limitée. En règle générale, SnapRAID nécessite -généralement 1 Gio de RAM pour chaque 16 To de données dans la baie. +1 Gio de RAM pour chaque 16 To de données dans la baie. .PP Plus précisément, pour stocker les hachages des données, SnapRAID nécessite environ TS*(1+HS)/BS octets de RAM, @@ -1669,13 +1673,13 @@ bloc de 512, vous obtenez : RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio .PD 0 .PD -.SS autosave TAILLE_EN_GIGAOCTETS +.SS autosave SIZE_IN_GIGABYTES Enregistre automatiquement l\'état lors de la synchronisation ou du nettoyage après la quantité spécifiée de Go traités. Cette option est utile pour éviter de redémarrer de longues commandes \`sync\` à partir de zéro si elles sont interrompues par un plantage de la machine ou tout autre événement. -.SS temp_limit TEMPÉRATURE_CELSIUS +.SS temp_limit TEMPERATURE_CELSIUS Définit la température maximale autorisée du disque en Celsius. Lorsqu\'elle est spécifiée, SnapRAID vérifie périodiquement la température de tous les disques à l\'aide de l\'outil smartctl. @@ -1707,17 +1711,17 @@ au début de l\'exécution comme référence de secours. .PP Normalement, SnapRAID n\'affiche que la température du disque le plus chaud. Pour afficher la température de tous les disques, utilisez l\'option -\-A ou \-\-stats. -.SS temp_sleep TEMPS_EN_MINUTES +\`\-A, \-\-stats\`. +.SS temp_sleep TIME_IN_MINUTES Définit le temps de veille, en minutes, lorsque la limite de température est atteinte. Pendant cette période, les disques restent arrêtés. La valeur par défaut est de 5 minutes. -.SS pool DOSSIER +.SS pool DIR Définit le répertoire de mise en commun où la vue virtuelle de la baie de disques est créée à l\'aide de la commande \`pool\`. .PP Le répertoire doit déjà exister. -.SS share CHEMIN_UNC +.SS share UNC_DIR Définit le chemin UNC Windows requis pour accéder aux disques à distance. .PP Si cette option est spécifiée, les liens symboliques créés dans le @@ -1731,7 +1735,7 @@ en ajoutant le nom du disque tel que spécifié dans l\'option \`data\`, et en ajoutant enfin le répertoire et le nom du fichier. .PP Cette option est requise uniquement pour Windows. -.SS smartctl DISQUE/PARITÉ OPTIONS... +.SS smartctl DISK/PARITY OPTIONS... Définit les options smartctl personnalisées pour obtenir les attributs SMART de chaque disque. Cela peut être nécessaire pour les contrôleurs RAID et certains disques USB qui ne peuvent pas être détectés @@ -1739,8 +1743,8 @@ automatiquement. Le placeholder %s est remplacé par le nom du périphérique, mais il est facultatif pour les périphériques fixes comme les contrôleurs RAID. .PP -DISQUE est le même nom de disque spécifié dans l\'option \`data\`. -PARITÉ est l\'un des noms de parité : \`parity\`, \`2\-parity\`, \`3\-parity\`, +DISK est le même nom de disque spécifié dans l\'option \`data\`. +PARITY est l\'un des noms de parité : \`parity\`, \`2\-parity\`, \`3\-parity\`, \`4\-parity\`, \`5\-parity\`, \`6\-parity\` ou \`z\-parity\`. .PP Dans les OPTIONS spécifiées, la chaîne \`%s\` est remplacée par le @@ -1774,13 +1778,13 @@ smartctl parity \-d sat %s .PD 0 .PD .RE -.SS smartignore DISQUE/PARITÉ ATTR [ATTR...] +.SS smartignore DISK/PARITY ATTR [ATTR...] Ignore l\'attribut SMART spécifié lors du calcul de la probabilité de défaillance du disque. Cette option est utile si un disque signale des valeurs inhabituelles ou trompeuses pour un attribut particulier. .PP -DISQUE est le même nom de disque spécifié dans l\'option \`data\`. -PARITÉ est l\'un des noms de parité : \`parity\`, \`2\-parity\`, \`3\-parity\`, +DISK est le même nom de disque spécifié dans l\'option \`data\`. +PARITY est l\'un des noms de parité : \`parity\`, \`2\-parity\`, \`3\-parity\`, \`4\-parity\`, \`5\-parity\`, \`6\-parity\` ou \`z\-parity\`. La valeur spéciale * peut être utilisée pour ignorer l\'attribut sur tous les disques. @@ -1809,7 +1813,7 @@ smartignore parity 197 5 .PD 0 .PD .RE -.SS Exemples +.SS Exemples (Examples) Un exemple de configuration typique pour Unix est : .PP .RS 4 @@ -1976,7 +1980,7 @@ prennent en charge les instantanés les utiliseront, tandis que les autres disqu La création et la suppression d\'instantanés nécessitent des privilèges d\'administration. Assurez\-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque les instantanés sont activés. -.SS Comportement des commandes avec les instantanés +.SS Comportement des commandes avec les instantanés (Command Behavior with Snapshots) Les commandes \`sync\` et \`scrub\` fonctionnent toutes deux exclusivement sur les instantanés pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent et figé. En utilisant ces instantanés, SnapRAID empêche les écarts de parité @@ -2328,10 +2332,25 @@ de console. Cela n\'affecte que les noms de fichiers imprimés ; si vous redirigez la sortie de la console vers un fichier, le fichier résultant est toujours au format UTF\-8. +.SH CODE DE SORTIE (EXIT CODE) +SnapRAID se termine avec les codes d\'erreur suivants : +.RS 0 +.PD 0 +.HP 4 +.I 0 +Tout est OK. +.HP 4 +.I 1 +La commande a rencontré des erreurs. +.HP 4 +.I 2 +La commande \`diff\` a trouvé que tout est OK, mais un \`sync\` est requis. +.PD +.RE .SH TRADUCTION (TRANSLATION) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. .SH DROITS D\'AUTEUR (COPYRIGHT) -Ce fichier est Copyright (C) 2025 Andrea Mazzoleni +Ce fichier est Copyright (C) 2026 Andrea Mazzoleni .SH VOIR AUSSI (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index dc81a6ef..25fcf135 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -3,24 +3,25 @@ Name{number} Synopsis :snapraid [-c, --conf CONFIG] - : [-f, --filter MOTIF] [-d, --filter-disk NOM] + : [-f, --filter PATTERN] [-d, --filter-disk NAME] : [-m, --filter-missing] [-e, --filter-error] - : [-a, --audit-only] [-h, --pre-hash] [-i, --import DOSSIER] - : [-p, --plan PERC|mauvais|nouveau|complet] - : [-o, --older-than JOURS] [-l, --log FICHIER] - : [-s, --spin-down-on-error] [-w, --bw-limit DÉBIT] + : [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR] + : [-p, --plan PERC|bad|new|full] + : [-o, --older-than DAYS] [-l, --log FILE] + : [-s, --spin-down-on-error] [-w, --bw-limit RATE] + : [-t, --tail] : [-Z, --force-zero] [-E, --force-empty] : [-U, --force-uuid] [-D, --force-device] : [-N, --force-nocopy] [-F, --force-full] : [-R, --force-realloc] [-W, --force-realloc-tail] : [-S, --start BLKSTART] [-B, --count BLKCOUNT] - : [-L, --error-limit NOMBRE] + : [-L, --error-limit NUMBER] : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check : |list|dup|pool|devices|touch|rehash|locate - :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENU] + :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] Description SnapRAID est un programme de sauvegarde conçu pour les baies de disques, @@ -89,7 +90,7 @@ Limitations de défaillances de disques. Avec une sauvegarde, vous pouvez récupérer d'une défaillance complète de toute la baie de disques. * Seuls les noms de fichiers, les horodatages, les liens symboliques - et les liens matériels sont sauvegardés. Les permissions, la + et les liens physiques sont sauvegardés. Les permissions, la propriété et les attributs étendus ne sont pas sauvegardés. Démarrer (Getting Started) @@ -209,7 +210,7 @@ Démarrer (Getting Started) Lors du prochain `scrub`, les erreurs disparaîtront du rapport `status` si elles sont réellement corrigées. Pour accélérer, - vous pouvez utiliser -p mauvais pour nettoyer uniquement les blocs + vous pouvez utiliser -p bad pour nettoyer uniquement les blocs marqués comme mauvais. :snapraid -p bad scrub @@ -222,7 +223,7 @@ Démarrer (Getting Started) Mise en commun (Pooling) Note : La fonctionnalité de mise en commun décrite ci-dessous a été remplacée par l'outil mergerfs, qui est désormais l'option recommandée - pour les utilisateurs Linux de la communauté SnapRAID. Mergefs offre + pour les utilisateurs Linux de la communauté SnapRAID. Mergerfs offre un moyen plus flexible et efficace de regrouper plusieurs disques dans un seul point de montage unifié, permettant un accès transparent aux fichiers sur toute votre baie sans dépendre de liens symboliques. @@ -307,11 +308,11 @@ Démarrer (Getting Started) ou récupérer des fichiers dans leur état précédent à l'aide de l'option -f, --filter : - :snapraid fix -f FICHIER + :snapraid fix -f FILE ou pour un répertoire : - :snapraid fix -f DOSSIER/ + :snapraid fix -f DIR/ Vous pouvez également l'utiliser pour récupérer uniquement les fichiers accidentellement supprimés à l'intérieur d'un @@ -319,7 +320,7 @@ Démarrer (Getting Started) qui ne restaure que les fichiers manquants, laissant tous les autres intacts. - :snapraid fix -m -f DOSSIER/ + :snapraid fix -m -f DIR/ Ou pour récupérer tous les fichiers supprimés sur tous les lecteurs avec : @@ -364,9 +365,9 @@ Démarrer (Getting Started) Exécutez la commande fix, en stockant le journal dans un fichier externe avec : - :snapraid -d NOM -l fix.log fix + :snapraid -d NAME -l fix.log fix - Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. + Où NAME est le nom du disque, tel que `d1` dans notre exemple précédent. Si le disque à récupérer est un disque de parité, utilisez les noms `parity`, `2-parity`, etc. Si vous avez plusieurs disques défaillants, utilisez plusieurs @@ -402,9 +403,9 @@ Démarrer (Getting Started) Par précaution, vous pouvez maintenant exécuter une commande `check` pour vous assurer que tout est correct sur le disque récupéré. - :snapraid -d NOM -a check + :snapraid -d NAME -a check - Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. + Où NAME est le nom du disque, tel que `d1` dans notre exemple précédent. Les options -d et -a indiquent à SnapRAID de vérifier uniquement le disque spécifié et d'ignorer toutes les données de parité. @@ -473,7 +474,7 @@ Commandes (Commands) logerr - Le journal d'erreurs du périphérique contient des erreurs. selferr - Le journal d'auto-test du périphérique contient des erreurs. - Si l'option -v, --verbose est spécifiée, une analyse statistique + Si l'option `-v, --verbose` est spécifiée, une analyse statistique plus approfondie est fournie. Cette analyse peut vous aider à décider si vous avez besoin de plus ou moins de parité. @@ -808,11 +809,11 @@ Options Sous Windows, il utilise le fichier `snapraid.conf` dans le même répertoire que `snapraid.exe`. - -f, --filter MOTIF + -f, --filter PATTERN Filtre les fichiers à traiter dans `check` et `fix`. Seuls les fichiers correspondant au motif spécifié sont traités. Cette option peut être utilisée plusieurs fois. - Voir la section MOTIF pour plus de détails sur les + Voir la section PATTERN pour plus de détails sur les spécifications de motifs. Sous Unix, assurez-vous que les caractères de globbing sont entre guillemets s'ils sont utilisés. @@ -820,7 +821,7 @@ Options Elle ne peut pas être utilisée avec `sync` et `scrub`, car ils traitent toujours l'intégralité de la baie. - -d, --filter-disk NOM + -d, --filter-disk NAME Filtre les disques à traiter dans `check`, `fix`, `up` et `down`. Vous devez spécifier un nom de disque tel que défini dans le fichier de configuration. @@ -864,9 +865,9 @@ Options qui n'ont pas encore été nettoyés, et `full` nettoie tout. Cette option ne peut être utilisée qu'avec `scrub`. - -o, --older-than JOURS + -o, --older-than DAYS Sélectionne la partie la plus ancienne de la baie à traiter dans `scrub`. - JOURS est l'âge minimum en jours pour qu'un bloc soit nettoyé ; + DAYS est l'âge minimum en jours pour qu'un bloc soit nettoyé ; la valeur par défaut est 10. Les blocs marqués comme mauvais sont toujours nettoyés, quelle que soit cette option. @@ -903,7 +904,7 @@ Options opération fix avant de continuer. Cette option ne peut être utilisée qu'avec `sync`. - -i, --import DOSSIER + -i, --import DIR Importe à partir du répertoire spécifié tous les fichiers supprimés de la baie après le dernier `sync`. Si vous avez toujours de tels fichiers, ils peuvent être utilisés @@ -921,12 +922,12 @@ Options assurer que les disques sont arrêtés en toute sécurité même lorsqu'une commande échoue. - -w, --bw-limit DÉBIT + -w, --bw-limit RATE Applique une limite de bande passante globale pour tous les disques. - Le DÉBIT est le nombre d'octets par seconde. Vous pouvez spécifier - un multiplicateur tel que K, M ou G (par exemple, --bw-limit 1G). + Le RATE est le nombre d'octets par seconde. Vous pouvez spécifier + un multiplicateur tel que K, M, G ou T (par exemple, --bw-limit 1G). - -t, --tail TAILLE + -t, --tail SIZE Limite la liste des fichiers à ceux n'utilisant pas plus que la taille de queue spécifiée des disques de parité. Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: --tail 1G). @@ -1039,9 +1040,9 @@ Options fortement recommandé de ne pas l'utiliser. Vous N'AVEZ AUCUNE protection des données pendant l'opération `sync`. - -W, --force-realloc-tail TAILLE - Fonctionne comme -R, --force-realloc, maar limité à la partie terminale - spécifiée (les derniers TAILLE octets) de chaque fichier de parité. + -W, --force-realloc-tail SIZE + Fonctionne comme -R, --force-realloc, mais limité à la partie terminale + spécifiée (les derniers SIZE octets) de chaque fichier de parité. Force la réallocation (déplacement) de tout fragment/bloc de fichier actuellement stocké dans cette section terminale, leur permettant d'être placés n'importe où dans le(s) fichier(s) de parité où de l'espace libre @@ -1061,7 +1062,7 @@ Options Vous n'avez PAS de protection des données pendant l'opération `sync` pour les fichiers affectés. - -l, --log FICHIER + -l, --log FILE Écrit un journal détaillé dans le fichier spécifié. Si cette option n'est pas spécifiée, les erreurs inattendues sont imprimées à l'écran, ce qui peut entraîner une sortie @@ -1081,7 +1082,7 @@ Options Consultez le fichier ou la page de manuel snapraid_log.txt pour les descriptions des balises de journal. - -L, --error-limit NOMBRE + -L, --error-limit NUMBER Définit une nouvelle limite d'erreurs avant d'arrêter l'exécution. Par défaut, SnapRAID s'arrête s'il rencontre plus de 100 erreurs d'entrée/sortie, indiquant qu'un disque est @@ -1101,7 +1102,7 @@ Options Ne traite que le nombre de blocs spécifié. Cette option est principalement destinée à la récupération manuelle avancée. - -C, --gen-conf CONTENU + -C, --gen-conf CONTENT Génère un fichier de configuration factice à partir d'un fichier de contenu existant. Le fichier de configuration est écrit sur la sortie standard @@ -1141,7 +1142,7 @@ Configuration Il doit contenir les options suivantes (sensibles à la casse) : - parity FICHIER [,FICHIER] ... + parity FILE [,FILE] ... Définit les fichiers à utiliser pour stocker les informations de parité. La parité permet une protection contre une seule défaillance de disque, similaire au RAID5. @@ -1163,7 +1164,7 @@ Configuration Cette option est obligatoire et ne peut être utilisée qu'une seule fois. - (2,3,4,5,6)-parity FICHIER [,FICHIER] ... + (2,3,4,5,6)-parity FILE [,FILE] ... Définit les fichiers à utiliser pour stocker les informations de parité supplémentaires. @@ -1183,7 +1184,7 @@ Configuration Ces options sont facultatives et ne peuvent être utilisées qu'une seule fois. - z-parity FICHIER [,FICHIER] ... + z-parity FILE [,FILE] ... Définit un fichier et un format alternatifs pour stocker la triple parité. Cette option est une alternative à `3-parity`, principalement destinée @@ -1202,7 +1203,7 @@ Configuration le fichier de configuration avec le fichier z-parity ou 3-parity souhaité et en utilisant `fix` pour le recréer. - content FICHIER + content FILE Définit le fichier à utiliser pour stocker la liste et les sommes de contrôle de tous les fichiers présents dans votre baie de disques. @@ -1217,19 +1218,19 @@ Configuration Vous devez stocker au moins une copie pour chaque disque de parité utilisé plus un. L'utilisation de copies supplémentaires ne nuit pas. - data NOM DOSSIER + data NAME DIR Définit le nom et le point de montage des disques de données dans - la baie. NOM est utilisé pour identifier le disque et doit - être unique. DOSSIER est le point de montage du disque dans le + la baie. NAME est utilisé pour identifier le disque et doit + être unique. DIR est le point de montage du disque dans le système de fichiers. Vous pouvez modifier le point de montage au besoin, tant que - vous gardez le NOM fixe. + vous gardez le NAME fixe. Vous devriez utiliser une option pour chaque disque de données de la baie. - Vous pouvez renommer un disque plus tard en changeant le NOM directement + Vous pouvez renommer un disque plus tard en changeant le NAME directement dans le fichier de configuration, puis en exécutant une commande `sync`. Dans le cas d'un renommage, l'association est faite en utilisant l'UUID stocké des disques. @@ -1275,7 +1276,7 @@ Configuration Sous Unix, les fichiers cachés sont ceux commençant par `.`. Sous Windows, ce sont ceux avec l'attribut caché. - exclude/include MOTIF + exclude/include PATTERN Définit les motifs de fichiers ou de répertoires à exclure ou à inclure dans le processus de synchronisation. Tous les motifs sont traités dans l'ordre spécifié. @@ -1286,12 +1287,12 @@ Configuration spécifié est un `include`, ou inclus si le dernier motif spécifié est un `exclude`. - Voir la section MOTIF pour plus de détails sur les + Voir la section PATTERN pour plus de détails sur les spécifications de motifs. Cette option peut être utilisée plusieurs fois. - blocksize TAILLE_EN_KIBIOCTETS + blocksize SIZE_IN_KIBIBYTES Définit la taille de bloc de base en kibioctets pour la parité. Un kibioctet est de 1024 octets. @@ -1344,7 +1345,7 @@ Configuration pour un disque de 4 To, ce qui permet environ 460 000 fichiers sur chaque disque de données sans aucun espace gaspillé. - hashsize TAILLE_EN_OCTETS + hashsize SIZE_IN_BYTES Définit la taille du hachage en octets pour les blocs enregistrés. La taille de hachage par défaut est de 16 octets (128 bits), @@ -1356,7 +1357,7 @@ Configuration Une raison d'utiliser une taille de hachage différente est si votre système a une mémoire limitée. En règle générale, SnapRAID nécessite - généralement 1 Gio de RAM pour chaque 16 To de données dans la baie. + 1 Gio de RAM pour chaque 16 To de données dans la baie. Plus précisément, pour stocker les hachages des données, SnapRAID nécessite environ TS*(1+HS)/BS octets de RAM, @@ -1381,14 +1382,14 @@ Configuration :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio - autosave TAILLE_EN_GIGAOCTETS + autosave SIZE_IN_GIGABYTES Enregistre automatiquement l'état lors de la synchronisation ou du nettoyage après la quantité spécifiée de Go traités. Cette option est utile pour éviter de redémarrer de longues commandes `sync` à partir de zéro si elles sont interrompues par un plantage de la machine ou tout autre événement. - temp_limit TEMPÉRATURE_CELSIUS + temp_limit TEMPERATURE_CELSIUS Définit la température maximale autorisée du disque en Celsius. Lorsqu'elle est spécifiée, SnapRAID vérifie périodiquement la température de tous les disques à l'aide de l'outil smartctl. @@ -1420,20 +1421,20 @@ Configuration Normalement, SnapRAID n'affiche que la température du disque le plus chaud. Pour afficher la température de tous les disques, utilisez l'option - -A ou --stats. + `-A, --stats`. - temp_sleep TEMPS_EN_MINUTES + temp_sleep TIME_IN_MINUTES Définit le temps de veille, en minutes, lorsque la limite de température est atteinte. Pendant cette période, les disques restent arrêtés. La valeur par défaut est de 5 minutes. - pool DOSSIER + pool DIR Définit le répertoire de mise en commun où la vue virtuelle de la baie de disques est créée à l'aide de la commande `pool`. Le répertoire doit déjà exister. - share CHEMIN_UNC + share UNC_DIR Définit le chemin UNC Windows requis pour accéder aux disques à distance. Si cette option est spécifiée, les liens symboliques créés dans le @@ -1448,7 +1449,7 @@ Configuration Cette option est requise uniquement pour Windows. - smartctl DISQUE/PARITÉ OPTIONS... + smartctl DISK/PARITY OPTIONS... Définit les options smartctl personnalisées pour obtenir les attributs SMART de chaque disque. Cela peut être nécessaire pour les contrôleurs RAID et certains disques USB qui ne peuvent pas être détectés @@ -1456,8 +1457,8 @@ Configuration périphérique, mais il est facultatif pour les périphériques fixes comme les contrôleurs RAID. - DISQUE est le même nom de disque spécifié dans l'option `data`. - PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, + DISK est le même nom de disque spécifié dans l'option `data`. + PARITY est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, `4-parity`, `5-parity`, `6-parity` ou `z-parity`. Dans les OPTIONS spécifiées, la chaîne `%s` est remplacée par le @@ -1478,13 +1479,13 @@ Configuration :smartctl d1 [info: -H -i -c -A] -d sat %s :smartctl parity -d sat %s - smartignore DISQUE/PARITÉ ATTR [ATTR...] + smartignore DISK/PARITY ATTR [ATTR...] Ignore l'attribut SMART spécifié lors du calcul de la probabilité de défaillance du disque. Cette option est utile si un disque signale des valeurs inhabituelles ou trompeuses pour un attribut particulier. - DISQUE est le même nom de disque spécifié dans l'option `data`. - PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, + DISK est le même nom de disque spécifié dans l'option `data`. + PARITY est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, `4-parity`, `5-parity`, `6-parity` ou `z-parity`. La valeur spéciale * peut être utilisée pour ignorer l'attribut sur tous les disques. @@ -1503,7 +1504,7 @@ Configuration :smartignore parity 197 5 - Exemples + Exemples (Examples) Un exemple de configuration typique pour Unix est : :parity /mnt/diskp/snapraid.parity @@ -1582,7 +1583,7 @@ Snapshots Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque les instantanés sont activés. - Comportement des commandes avec les instantanés + Comportement des commandes avec les instantanés (Command Behavior with Snapshots) Les commandes `sync` et `scrub` fonctionnent toutes deux exclusivement sur les instantanés pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent et figé. En utilisant ces instantanés, SnapRAID empêche les écarts de parité @@ -1852,12 +1853,19 @@ Encodage (Encoding) redirigez la sortie de la console vers un fichier, le fichier résultant est toujours au format UTF-8. +Code de sortie (Exit Code) + SnapRAID se termine avec les codes d'erreur suivants : + + 0 - Tout est OK. + 1 - La commande a rencontré des erreurs. + 2 - La commande `diff` a trouvé que tout est OK, mais un `sync` est requis. + Traduction (Translation) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. Droits d'auteur (Copyright) - Ce fichier est Copyright (C) 2025 Andrea Mazzoleni + Ce fichier est Copyright (C) 2026 Andrea Mazzoleni Voir aussi (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index e5ab151f..5232cc98 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -7,24 +7,25 @@ ========== snapraid [-c, --conf CONFIG] - [-f, --filter MOTIF] [-d, --filter-disk NOM] + [-f, --filter PATTERN] [-d, --filter-disk NAME] [-m, --filter-missing] [-e, --filter-error] - [-a, --audit-only] [-h, --pre-hash] [-i, --import DOSSIER] - [-p, --plan PERC|mauvais|nouveau|complet] - [-o, --older-than JOURS] [-l, --log FICHIER] - [-s, --spin-down-on-error] [-w, --bw-limit DÉBIT] + [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR] + [-p, --plan PERC|bad|new|full] + [-o, --older-than DAYS] [-l, --log FILE] + [-s, --spin-down-on-error] [-w, --bw-limit RATE] + [-t, --tail] [-Z, --force-zero] [-E, --force-empty] [-U, --force-uuid] [-D, --force-device] [-N, --force-nocopy] [-F, --force-full] [-R, --force-realloc] [-W, --force-realloc-tail] [-S, --start BLKSTART] [-B, --count BLKCOUNT] - [-L, --error-limit NOMBRE] + [-L, --error-limit NUMBER] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check |list|dup|pool|devices|touch|rehash|locate -snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENU] +snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] 2 DESCRIPTION @@ -99,7 +100,7 @@ Les autres limitations de SnapRAID sont : de défaillances de disques. Avec une sauvegarde, vous pouvez récupérer d'une défaillance complète de toute la baie de disques. * Seuls les noms de fichiers, les horodatages, les liens symboliques - et les liens matériels sont sauvegardés. Les permissions, la + et les liens physiques sont sauvegardés. Les permissions, la propriété et les attributs étendus ne sont pas sauvegardés. @@ -224,7 +225,7 @@ les mauvais blocs avec l'option -e, --filter-error : Lors du prochain `scrub`, les erreurs disparaîtront du rapport `status` si elles sont réellement corrigées. Pour accélérer, -vous pouvez utiliser -p mauvais pour nettoyer uniquement les blocs +vous pouvez utiliser -p bad pour nettoyer uniquement les blocs marqués comme mauvais. snapraid -p bad scrub @@ -239,7 +240,7 @@ ne sont pas marqués comme mauvais. Note : La fonctionnalité de mise en commun décrite ci-dessous a été remplacée par l'outil mergerfs, qui est désormais l'option recommandée -pour les utilisateurs Linux de la communauté SnapRAID. Mergefs offre +pour les utilisateurs Linux de la communauté SnapRAID. Mergerfs offre un moyen plus flexible et efficace de regrouper plusieurs disques dans un seul point de montage unifié, permettant un accès transparent aux fichiers sur toute votre baie sans dépendre de liens symboliques. @@ -326,11 +327,11 @@ qu'un système RAID, et il peut être utilisé pour restaurer ou récupérer des fichiers dans leur état précédent à l'aide de l'option -f, --filter : - snapraid fix -f FICHIER + snapraid fix -f FILE ou pour un répertoire : - snapraid fix -f DOSSIER/ + snapraid fix -f DIR/ Vous pouvez également l'utiliser pour récupérer uniquement les fichiers accidentellement supprimés à l'intérieur d'un @@ -338,7 +339,7 @@ répertoire en utilisant l'option -m, --filter-missing, qui ne restaure que les fichiers manquants, laissant tous les autres intacts. - snapraid fix -m -f DOSSIER/ + snapraid fix -m -f DIR/ Ou pour récupérer tous les fichiers supprimés sur tous les lecteurs avec : @@ -385,9 +386,9 @@ leurs options de configuration. Exécutez la commande fix, en stockant le journal dans un fichier externe avec : - snapraid -d NOM -l fix.log fix + snapraid -d NAME -l fix.log fix -Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. +Où NAME est le nom du disque, tel que `d1` dans notre exemple précédent. Si le disque à récupérer est un disque de parité, utilisez les noms `parity`, `2-parity`, etc. Si vous avez plusieurs disques défaillants, utilisez plusieurs @@ -423,9 +424,9 @@ la commande `fix` ! Par précaution, vous pouvez maintenant exécuter une commande `check` pour vous assurer que tout est correct sur le disque récupéré. - snapraid -d NOM -a check + snapraid -d NAME -a check -Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. +Où NAME est le nom du disque, tel que `d1` dans notre exemple précédent. Les options -d et -a indiquent à SnapRAID de vérifier uniquement le disque spécifié et d'ignorer toutes les données de parité. @@ -501,7 +502,7 @@ Les autres chaînes d'état possibles sont : logerr - Le journal d'erreurs du périphérique contient des erreurs. selferr - Le journal d'auto-test du périphérique contient des erreurs. -Si l'option -v, --verbose est spécifiée, une analyse statistique +Si l'option `-v, --verbose` est spécifiée, une analyse statistique plus approfondie est fournie. Cette analyse peut vous aider à décider si vous avez besoin de plus ou moins de parité. @@ -869,11 +870,11 @@ SnapRAID fournit les options suivantes : Sous Windows, il utilise le fichier `snapraid.conf` dans le même répertoire que `snapraid.exe`. - -f, --filter MOTIF + -f, --filter PATTERN Filtre les fichiers à traiter dans `check` et `fix`. Seuls les fichiers correspondant au motif spécifié sont traités. Cette option peut être utilisée plusieurs fois. - Voir la section MOTIF pour plus de détails sur les + Voir la section PATTERN pour plus de détails sur les spécifications de motifs. Sous Unix, assurez-vous que les caractères de globbing sont entre guillemets s'ils sont utilisés. @@ -881,7 +882,7 @@ SnapRAID fournit les options suivantes : Elle ne peut pas être utilisée avec `sync` et `scrub`, car ils traitent toujours l'intégralité de la baie. - -d, --filter-disk NOM + -d, --filter-disk NAME Filtre les disques à traiter dans `check`, `fix`, `up` et `down`. Vous devez spécifier un nom de disque tel que défini dans le fichier de configuration. @@ -925,9 +926,9 @@ SnapRAID fournit les options suivantes : qui n'ont pas encore été nettoyés, et `full` nettoie tout. Cette option ne peut être utilisée qu'avec `scrub`. - -o, --older-than JOURS + -o, --older-than DAYS Sélectionne la partie la plus ancienne de la baie à traiter dans `scrub`. - JOURS est l'âge minimum en jours pour qu'un bloc soit nettoyé ; + DAYS est l'âge minimum en jours pour qu'un bloc soit nettoyé ; la valeur par défaut est 10. Les blocs marqués comme mauvais sont toujours nettoyés, quelle que soit cette option. @@ -964,7 +965,7 @@ SnapRAID fournit les options suivantes : opération fix avant de continuer. Cette option ne peut être utilisée qu'avec `sync`. - -i, --import DOSSIER + -i, --import DIR Importe à partir du répertoire spécifié tous les fichiers supprimés de la baie après le dernier `sync`. Si vous avez toujours de tels fichiers, ils peuvent être utilisés @@ -982,12 +983,12 @@ SnapRAID fournit les options suivantes : assurer que les disques sont arrêtés en toute sécurité même lorsqu'une commande échoue. - -w, --bw-limit DÉBIT + -w, --bw-limit RATE Applique une limite de bande passante globale pour tous les disques. - Le DÉBIT est le nombre d'octets par seconde. Vous pouvez spécifier - un multiplicateur tel que K, M ou G (par exemple, --bw-limit 1G). + Le RATE est le nombre d'octets par seconde. Vous pouvez spécifier + un multiplicateur tel que K, M, G ou T (par exemple, --bw-limit 1G). - -t, --tail TAILLE + -t, --tail SIZE Limite la liste des fichiers à ceux n'utilisant pas plus que la taille de queue spécifiée des disques de parité. Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: --tail 1G). @@ -1100,9 +1101,9 @@ SnapRAID fournit les options suivantes : fortement recommandé de ne pas l'utiliser. Vous N'AVEZ AUCUNE protection des données pendant l'opération `sync`. - -W, --force-realloc-tail TAILLE - Fonctionne comme -R, --force-realloc, maar limité à la partie terminale - spécifiée (les derniers TAILLE octets) de chaque fichier de parité. + -W, --force-realloc-tail SIZE + Fonctionne comme -R, --force-realloc, mais limité à la partie terminale + spécifiée (les derniers SIZE octets) de chaque fichier de parité. Force la réallocation (déplacement) de tout fragment/bloc de fichier actuellement stocké dans cette section terminale, leur permettant d'être placés n'importe où dans le(s) fichier(s) de parité où de l'espace libre @@ -1122,7 +1123,7 @@ SnapRAID fournit les options suivantes : Vous n'avez PAS de protection des données pendant l'opération `sync` pour les fichiers affectés. - -l, --log FICHIER + -l, --log FILE Écrit un journal détaillé dans le fichier spécifié. Si cette option n'est pas spécifiée, les erreurs inattendues sont imprimées à l'écran, ce qui peut entraîner une sortie @@ -1142,7 +1143,7 @@ SnapRAID fournit les options suivantes : Consultez le fichier ou la page de manuel snapraid_log.txt pour les descriptions des balises de journal. - -L, --error-limit NOMBRE + -L, --error-limit NUMBER Définit une nouvelle limite d'erreurs avant d'arrêter l'exécution. Par défaut, SnapRAID s'arrête s'il rencontre plus de 100 erreurs d'entrée/sortie, indiquant qu'un disque est @@ -1162,7 +1163,7 @@ SnapRAID fournit les options suivantes : Ne traite que le nombre de blocs spécifié. Cette option est principalement destinée à la récupération manuelle avancée. - -C, --gen-conf CONTENU + -C, --gen-conf CONTENT Génère un fichier de configuration factice à partir d'un fichier de contenu existant. Le fichier de configuration est écrit sur la sortie standard @@ -1205,8 +1206,8 @@ répertoire que `snapraid.exe`. Il doit contenir les options suivantes (sensibles à la casse) : -7.1 parity FICHIER [,FICHIER] ... ---------------------------------- +7.1 parity FILE [,FILE] ... +--------------------------- Définit les fichiers à utiliser pour stocker les informations de parité. La parité permet une protection contre une seule défaillance @@ -1229,8 +1230,8 @@ Sous Windows, 256 Mo sont laissés inutilisés sur chaque disque pour Cette option est obligatoire et ne peut être utilisée qu'une seule fois. -7.2 (2,3,4,5,6)-parity FICHIER [,FICHIER] ... ---------------------------------------------- +7.2 (2,3,4,5,6)-parity FILE [,FILE] ... +--------------------------------------- Définit les fichiers à utiliser pour stocker les informations de parité supplémentaires. @@ -1251,8 +1252,8 @@ Les mêmes considérations que pour l'option `parity` s'appliquent. Ces options sont facultatives et ne peuvent être utilisées qu'une seule fois. -7.3 z-parity FICHIER [,FICHIER] ... ------------------------------------ +7.3 z-parity FILE [,FILE] ... +----------------------------- Définit un fichier et un format alternatifs pour stocker la triple parité. @@ -1272,8 +1273,8 @@ Il est possible de convertir d'un format à l'autre en ajustant le fichier de configuration avec le fichier z-parity ou 3-parity souhaité et en utilisant `fix` pour le recréer. -7.4 content FICHIER -------------------- +7.4 content FILE +---------------- Définit le fichier à utiliser pour stocker la liste et les sommes de contrôle de tous les fichiers présents dans votre baie de disques. @@ -1289,21 +1290,21 @@ enregistrer plusieurs copies du même fichier. Vous devez stocker au moins une copie pour chaque disque de parité utilisé plus un. L'utilisation de copies supplémentaires ne nuit pas. -7.5 data NOM DOSSIER --------------------- +7.5 data NAME DIR +----------------- Définit le nom et le point de montage des disques de données dans -la baie. NOM est utilisé pour identifier le disque et doit -être unique. DOSSIER est le point de montage du disque dans le +la baie. NAME est utilisé pour identifier le disque et doit +être unique. DIR est le point de montage du disque dans le système de fichiers. Vous pouvez modifier le point de montage au besoin, tant que -vous gardez le NOM fixe. +vous gardez le NAME fixe. Vous devriez utiliser une option pour chaque disque de données de la baie. -Vous pouvez renommer un disque plus tard en changeant le NOM directement +Vous pouvez renommer un disque plus tard en changeant le NAME directement dans le fichier de configuration, puis en exécutant une commande `sync`. Dans le cas d'un renommage, l'association est faite en utilisant l'UUID stocké des disques. @@ -1355,8 +1356,8 @@ Exclut tous les fichiers et répertoires cachés. Sous Unix, les fichiers cachés sont ceux commençant par `.`. Sous Windows, ce sont ceux avec l'attribut caché. -7.9 exclude/include MOTIF -------------------------- +7.9 exclude/include PATTERN +--------------------------- Définit les motifs de fichiers ou de répertoires à exclure ou à inclure dans le processus de synchronisation. @@ -1368,13 +1369,13 @@ Si aucun motif ne correspond, le fichier est exclu si le dernier motif spécifié est un `include`, ou inclus si le dernier motif spécifié est un `exclude`. -Voir la section MOTIF pour plus de détails sur les +Voir la section PATTERN pour plus de détails sur les spécifications de motifs. Cette option peut être utilisée plusieurs fois. -7.10 blocksize TAILLE_EN_KIBIOCTETS ------------------------------------ +7.10 blocksize SIZE_IN_KIBIBYTES +-------------------------------- Définit la taille de bloc de base en kibioctets pour la parité. Un kibioctet est de 1024 octets. @@ -1428,8 +1429,8 @@ Cela se traduit par environ 1,5 % d'espace supplémentaire, environ 60 Go pour un disque de 4 To, ce qui permet environ 460 000 fichiers sur chaque disque de données sans aucun espace gaspillé. -7.11 hashsize TAILLE_EN_OCTETS ------------------------------- +7.11 hashsize SIZE_IN_BYTES +--------------------------- Définit la taille du hachage en octets pour les blocs enregistrés. @@ -1442,7 +1443,7 @@ cette valeur à l'avenir, vous devrez recréer l'intégralité de la parité ! Une raison d'utiliser une taille de hachage différente est si votre système a une mémoire limitée. En règle générale, SnapRAID nécessite -généralement 1 Gio de RAM pour chaque 16 To de données dans la baie. +1 Gio de RAM pour chaque 16 To de données dans la baie. Plus précisément, pour stocker les hachages des données, SnapRAID nécessite environ TS*(1+HS)/BS octets de RAM, @@ -1467,8 +1468,8 @@ bloc de 512, vous obtenez : RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio -7.12 autosave TAILLE_EN_GIGAOCTETS ----------------------------------- +7.12 autosave SIZE_IN_GIGABYTES +------------------------------- Enregistre automatiquement l'état lors de la synchronisation ou du nettoyage après la quantité spécifiée de Go traités. @@ -1476,7 +1477,7 @@ Cette option est utile pour éviter de redémarrer de longues commandes `sync` à partir de zéro si elles sont interrompues par un plantage de la machine ou tout autre événement. -7.13 temp_limit TEMPÉRATURE_CELSIUS +7.13 temp_limit TEMPERATURE_CELSIUS ----------------------------------- Définit la température maximale autorisée du disque en Celsius. @@ -1510,25 +1511,25 @@ au début de l'exécution comme référence de secours. Normalement, SnapRAID n'affiche que la température du disque le plus chaud. Pour afficher la température de tous les disques, utilisez l'option --A ou --stats. +`-A, --stats`. -7.14 temp_sleep TEMPS_EN_MINUTES --------------------------------- +7.14 temp_sleep TIME_IN_MINUTES +------------------------------- Définit le temps de veille, en minutes, lorsque la limite de température est atteinte. Pendant cette période, les disques restent arrêtés. La valeur par défaut est de 5 minutes. -7.15 pool DOSSIER ------------------ +7.15 pool DIR +------------- Définit le répertoire de mise en commun où la vue virtuelle de la baie de disques est créée à l'aide de la commande `pool`. Le répertoire doit déjà exister. -7.16 share CHEMIN_UNC ---------------------- +7.16 share UNC_DIR +------------------ Définit le chemin UNC Windows requis pour accéder aux disques à distance. @@ -1544,8 +1545,8 @@ et en ajoutant enfin le répertoire et le nom du fichier. Cette option est requise uniquement pour Windows. -7.17 smartctl DISQUE/PARITÉ OPTIONS... --------------------------------------- +7.17 smartctl DISK/PARITY OPTIONS... +------------------------------------ Définit les options smartctl personnalisées pour obtenir les attributs SMART de chaque disque. Cela peut être nécessaire pour les contrôleurs @@ -1554,8 +1555,8 @@ automatiquement. Le placeholder %s est remplacé par le nom du périphérique, mais il est facultatif pour les périphériques fixes comme les contrôleurs RAID. -DISQUE est le même nom de disque spécifié dans l'option `data`. -PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, +DISK est le même nom de disque spécifié dans l'option `data`. +PARITY est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, `4-parity`, `5-parity`, `6-parity` ou `z-parity`. Dans les OPTIONS spécifiées, la chaîne `%s` est remplacée par le @@ -1576,15 +1577,15 @@ Par exemple : smartctl d1 [info: -H -i -c -A] -d sat %s smartctl parity -d sat %s -7.18 smartignore DISQUE/PARITÉ ATTR [ATTR...] ---------------------------------------------- +7.18 smartignore DISK/PARITY ATTR [ATTR...] +------------------------------------------- Ignore l'attribut SMART spécifié lors du calcul de la probabilité de défaillance du disque. Cette option est utile si un disque signale des valeurs inhabituelles ou trompeuses pour un attribut particulier. -DISQUE est le même nom de disque spécifié dans l'option `data`. -PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, +DISK est le même nom de disque spécifié dans l'option `data`. +PARITY est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, `4-parity`, `5-parity`, `6-parity` ou `z-parity`. La valeur spéciale * peut être utilisée pour ignorer l'attribut sur tous les disques. @@ -1603,8 +1604,8 @@ Pour les ignorer uniquement sur le premier disque de parité : smartignore parity 197 5 -7.19 Exemples -------------- +7.19 Exemples (Examples) +------------------------ Un exemple de configuration typique pour Unix est : @@ -1687,8 +1688,8 @@ La création et la suppression d'instantanés nécessitent des privilèges d'adm Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque les instantanés sont activés. -8.1 Comportement des commandes avec les instantanés ---------------------------------------------------- +8.1 Comportement des commandes avec les instantanés (Command Behavior with Snapshots) +------------------------------------------------------------------------------------- Les commandes `sync` et `scrub` fonctionnent toutes deux exclusivement sur les instantanés pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent @@ -1978,20 +1979,30 @@ redirigez la sortie de la console vers un fichier, le fichier résultant est toujours au format UTF-8. -15 TRADUCTION (TRANSLATION) +15 CODE DE SORTIE (EXIT CODE) +============================= + +SnapRAID se termine avec les codes d'erreur suivants : + +0 - Tout est OK. +1 - La commande a rencontré des erreurs. +2 - La commande `diff` a trouvé que tout est OK, mais un `sync` est requis. + + +16 TRADUCTION (TRANSLATION) =========================== Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. -16 DROITS D'AUTEUR (COPYRIGHT) +17 DROITS D'AUTEUR (COPYRIGHT) ============================== -Ce fichier est Copyright (C) 2025 Andrea Mazzoleni +Ce fichier est Copyright (C) 2026 Andrea Mazzoleni -17 VOIR AUSSI (SEE ALSO) +18 VOIR AUSSI (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index 4e1a01a2..a134763b 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -106,7 +106,7 @@ I dischi possono avere dimensioni diverse. SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi momento senza riformattare o spostare i dati. .IP \(bu -Per accedere a un file, è necessario far girare solo un singolo disco, +Per accedere a un file, è necessario avviare la rotazione di solo un singolo disco, risparmiando energia e riducendo il rumore. .PD .PP @@ -124,7 +124,7 @@ considerare prima di usarlo. .PP La limitazione principale è che se un disco si guasta, puoi recuperare i dati solo fino allo stato dell\'ultima operazione di \`sync\`. Qualsiasi dato aggiunto o modifica apportata -dall\'ultimo sync che si trova sul disco guasto andrà perso. +dopo l\'ultimo sync sul disco guasto andrà perso. .PP Di conseguenza, SnapRAID è adatto principalmente per dati che cambiano raramente. .PP @@ -133,7 +133,7 @@ dall\'uso o meno dell\'opzione \`snapshot\`: .PD 0 .IP \(bu Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), -SnapRAID può mantenere automaticamente un riferimento congelato dei dischi dati. +SnapRAID può mantenere automaticamente un\'immagine congelata dei dischi dati. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. .PD @@ -166,7 +166,7 @@ dell\'intero array di dischi. Vengono salvati solo nomi di file, timestamp, symlink e hardlink. Permessi, proprietà e attributi estesi non vengono salvati. .PD -.SH INIZIARE (GETTING STARTED) +.SH PRIMI PASSI (GETTING STARTED) Per usare SnapRAID, è necessario prima selezionare un disco nell\'array di dischi da dedicare alle informazioni di \`parity\` (parità). Con un disco per la parità, si sarà in grado di recuperare da un singolo guasto @@ -180,7 +180,7 @@ Come dischi di parità, è necessario scegliere i dischi più grandi dell\'array, poiché le informazioni di parità possono crescere fino alle dimensioni del più grande disco dati nell\'array. .PP -Questi dischi saranno dedicati alla memorizzazione dei file di \`parity\`. +Questi dischi saranno dedicati alla memorizzazione dei file di parità. Non si dovrebbero memorizzare i propri dati su di essi. .PP Quindi, è necessario definire i dischi \`data\` (dati) che si desidera @@ -195,7 +195,7 @@ Questo file contiene i dettagli del backup, inclusi tutti i checksum per verificarne l\'integrità. Il file \`content\` viene memorizzato in più copie e ogni copia deve essere su un disco diverso per garantire che, anche in caso di guasti -multipli del disco, sia disponibile almeno una copia. +multipli ai dischi, sia disponibile almeno una copia. .PP Ad esempio, supponiamo di essere interessati a un solo livello di protezione con parità e che i dischi si trovino in: @@ -328,8 +328,8 @@ durante il comando \`sync\` per verificarne l\'integrità. .PP Ogni esecuzione del comando controlla circa l\'8% dell\'array, escludendo i dati già sottoposti a scrub nei 10 giorni precedenti. -È possibile utilizzare l\'opzione \-p, \-\-plan per specificare un importo -diverso e l\'opzione \-o, \-\-older\-than per specificare un\'età diversa +È possibile utilizzare l\'opzione \-p, \-\-plan per specificare una quantità +diversa e l\'opzione \-o, \-\-older\-than per specificare un\'età diversa in giorni. Ad esempio, per controllare il 5% dell\'array per blocchi più vecchi di 20 giorni, usare: @@ -341,7 +341,7 @@ snapraid \-p 5 \-o 20 scrub .RE .PP Se vengono trovati errori silenti o di input/output durante il processo, -i blocchi corrispondenti vengono contrassegnati come bad (cattivi) nel +i blocchi corrispondenti vengono contrassegnati come \`bad\` (danneggiati) nel file \`content\` ed elencati nel comando \`status\`. .PP .RS 4 @@ -351,7 +351,7 @@ snapraid status .RE .PP Per correggerli, è possibile utilizzare il comando \`fix\`, filtrando -i blocchi bad con l\'opzione \-e, \-\-filter\-error: +i blocchi danneggiati con l\'opzione \-e, \-\-filter\-error: .PP .RS 4 snapraid \-e fix @@ -362,7 +362,7 @@ snapraid \-e fix Al prossimo \`scrub\`, gli errori scompariranno dal report \`status\` se sono stati veramente corretti. Per renderlo più veloce, è possibile utilizzare \-p bad per eseguire lo scrub solo dei blocchi contrassegnati -come bad. +come \`bad\`. .PP .RS 4 snapraid \-p bad scrub @@ -373,11 +373,11 @@ snapraid \-p bad scrub L\'esecuzione di \`scrub\` su un array non sincronizzato può riportare errori causati da file rimossi o modificati. Questi errori sono riportati nell\'output di \`scrub\`, ma i blocchi correlati non sono contrassegnati -come bad. +come \`bad\`. .SS Pooling (Pooling) Nota: La funzionalità di pooling descritta di seguito è stata sostituita dallo strumento mergerfs, che è ora l\'opzione consigliata -per gli utenti Linux nella comunità SnapRAID. Mergefs fornisce un modo +per gli utenti Linux nella comunità SnapRAID. Mergerfs fornisce un modo più flessibile ed efficiente per raggruppare più unità in un singolo punto di montaggio unificato, consentendo un accesso trasparente ai file attraverso l\'array senza fare affidamento sui collegamenti @@ -531,8 +531,8 @@ fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 .RE .SS Annullamento eliminazione (Undeleting) SnapRAID funziona più come un programma di backup che come un sistema RAID -e può essere utilizzato per ripristinare o annullare l\'eliminazione dei -file al loro stato precedente utilizzando l\'opzione \-f, \-\-filter: +e può essere utilizzato per ripristinare i file al loro stato precedente +o annullarne l\'eliminazione utilizzando l\'opzione \-f, \-\-filter: .PP .RS 4 snapraid fix \-f FILE @@ -567,7 +567,7 @@ snapraid fix \-m .PD .RE .SS Recupero (Recovering) -È successo il peggio e si è perso uno o più dischi! +È successo il peggio e si sono persi uno o più dischi! .PP NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli! .PP @@ -576,7 +576,7 @@ Disabilitare qualsiasi connessione remota ad esso e qualsiasi processo pianificato, incluso qualsiasi sync o scrub notturno pianificato di SnapRAID. .PP Quindi procedere con i seguenti passaggi. -.SS PASSO 1 \-> Riconfigurazione +.SS PASSO 1 \-> Riconfigurazione (Reconfigure) È necessario un po\' di spazio per recuperare, idealmente su dischi di riserva aggiuntivi, ma un disco USB esterno o un disco remoto saranno sufficienti. @@ -698,7 +698,7 @@ Le informazioni presentate si riferiscono all\'ultima volta che si è eseguito \`sync\`. Le modifiche successive non vengono prese in considerazione. .PP -Se sono stati rilevati blocchi bad, vengono elencati i loro numeri +Se sono stati rilevati blocchi danneggiati, vengono elencati i loro numeri di blocco. Per correggerli, è possibile utilizzare il comando \`fix \-e\`. .PP Mostra anche un grafico che rappresenta l\'ultima volta che ogni blocco @@ -759,8 +759,8 @@ Nulla viene modificato. .SS probe Stampa lo stato POWER di tutti i dischi nel sistema. .PP -\`Standby\` significa che il disco non sta girando. \`Active\` significa -che il disco sta girando. +\`Standby\` significa che il disco non è in rotazione. \`Active\` significa +che il disco è in rotazione. .PP Questo comando utilizza lo strumento \`smartctl\` ed è equivalente all\'esecuzione di \`smartctl \-n standby \-i\` su tutti i dispositivi. @@ -771,12 +771,12 @@ possibile specificare un comando personalizzato utilizzando l\'opzione .PP Nulla viene modificato. .SS up -Fa girare tutti i dischi dell\'array. +Avvia la rotazione di tutti i dischi dell\'array. .PP -È possibile far girare solo dischi specifici utilizzando l\'opzione \-d, +È possibile avviare la rotazione di soli dischi specifici utilizzando l\'opzione \-d, \-\-filter\-disk. .PP -Far girare tutti i dischi contemporaneamente richiede molta energia. +Avviare la rotazione di tutti i dischi contemporaneamente richiede molta energia. Assicurarsi che l\'alimentatore possa sostenerlo. .PP Nulla viene modificato. @@ -835,13 +835,13 @@ identificato, non solo il nome. .HP 4 .I relocated File spostati sullo stesso disco o su un disco -diverso dove l\'originale è scomparso. -Sono identificati dall\' avere lo stesso nome, dimensione +diverso dove l\'originale è scomparso. +Sono identificati dall\'avere lo stesso nome, dimensione e timestamp. Se il timestamp al sottomultiplo del secondo è zero, il percorso completo deve corrispondere per essere identificato. -A differenza dei file \`moved\` sullo stesso disco, +A differenza dei file \'moved\' sullo stesso disco, i file ricollocati hanno un inode diverso. .HP 4 .I restored @@ -868,7 +868,7 @@ Alla prossima esecuzione, il processo \`sync\` riprenderà da dove è stato interrotto. .PP Se vengono trovati errori silenti o di input/output durante il processo, -i blocchi corrispondenti vengono contrassegnati come bad. +i blocchi corrispondenti vengono contrassegnati come \`bad\` (danneggiati). .PP I file sono identificati dal percorso e/o dall\'inode e controllati per dimensione e timestamp. @@ -893,7 +893,7 @@ ogni tre mesi. .PP È possibile definire un piano o una quantità di scrub diversa utilizzando l\'opzione \-p, \-\-plan, che accetta: -bad \- Esegue lo scrub dei blocchi contrassegnati come bad. +bad \- Esegue lo scrub dei blocchi contrassegnati come \`bad\`. new \- Esegue lo scrub dei blocchi appena sincronizzati non ancora .PP .RS 4 @@ -922,22 +922,22 @@ Per ottenere i dettagli dello stato dello scrub, utilizzare il comando \`status\`. .PP Per qualsiasi errore silente o di input/output trovato, i blocchi -corrispondenti vengono contrassegnati come bad nel file \`content\`. -Questi blocchi bad sono elencati in \`status\` e possono essere corretti +corrispondenti vengono contrassegnati come \`bad\` nel file \`content\`. +Questi blocchi danneggiati sono elencati in \`status\` e possono essere corretti con \`fix \-e\`. Dopo la correzione, al prossimo scrub, verranno ricontrollati e, se -trovati corretti, il contrassegno bad verrà rimosso. -Per eseguire lo scrub solo dei blocchi bad, è possibile utilizzare +trovati corretti, il contrassegno \`bad\` verrà rimosso. +Per eseguire lo scrub solo dei blocchi danneggiati, è possibile utilizzare il comando \`scrub \-p bad\`. .PP Si consiglia di eseguire \`scrub\` solo su un array sincronizzato per evitare errori segnalati causati da dati non sincronizzati. Questi errori sono riconosciuti come non essendo errori silenti e i blocchi non -vengono contrassegnati come bad, ma tali errori sono riportati +vengono contrassegnati come \`bad\`, ma tali errori sono riportati nell\'output del comando. .PP Il file \`content\` viene modificato per aggiornare l\'ora dell\'ultimo -controllo per ogni blocco e per contrassegnare i blocchi bad. +controllo per ogni blocco e per contrassegnare i blocchi danneggiati. I file \`parity\` NON vengono modificati. I file nell\'array NON vengono modificati. .SS fix @@ -954,7 +954,7 @@ Se non viene specificata nessun\'altra opzione, l\'intero array viene elaborato. Utilizzare le opzioni di filtro per selezionare un sottoinsieme di file o dischi su cui operare. .PP -Per correggere solo i blocchi contrassegnati come bad durante \`sync\` +Per correggere solo i blocchi contrassegnati come \`bad\` (danneggiati) durante \`sync\` e \`scrub\`, utilizzare l\'opzione \-e, \-\-filter\-error. A differenza di altre opzioni di filtro, questa applica correzioni solo ai file che sono invariati dall\'ultimo \`sync\`. @@ -986,8 +986,8 @@ Questo comando è destinato principalmente alla verifica manuale, ad esempio dopo un processo di recupero o in altre condizioni speciali. Per i controlli periodici e pianificati, utilizzare \`scrub\`. .PP -Se si utilizza l\'opzione \-a, \-\-audit\-only, viene controllato solo -l\'hash dei file e i dati di parità vengono ignorati per un\'esecuzione +Se si utilizza l\'opzione \-a, \-\-audit\-only, vengono controllati solo +i dati dei file e i dati di parità vengono ignorati per un\'esecuzione più veloce. .PP I file sono identificati solo dal percorso, non dall\'inode. @@ -1075,11 +1075,10 @@ che occupa. .PP È possibile utilizzare l\'opzione \-t, \-\-tail per limitare l\'operazione ai file che occupano la porzione di coda specificata della parità. -Se si desidera riallocare questi file, è possibile utilizzare l\'opzione -\-W, \-\-force\-realloc\-tail. .PP -Si tenga presente che tali file non saranno protetti dalla parità durante -il processo di riallocazione. +Se si desidera riallocare questi file, è possibile utilizzare l\'opzione +\-W, \-\-force\-realloc\-tail. Si tenga presente che tali file non saranno +protetti dalla parità durante il processo di riallocazione. .SH OPZIONI (OPTIONS) SnapRAID fornisce le seguenti opzioni: .TP @@ -1092,11 +1091,11 @@ directory di \`snapraid.exe\`. .TP .B \-f, \-\-filter PATTERN Filtra i file da elaborare in \`check\` e \`fix\`. -Vengono elaborati solo i file che corrispondono al modello +Vengono elaborati solo i file che corrispondono al pattern specificato. Questa opzione può essere utilizzata più volte. Vedere la sezione PATTERN per maggiori dettagli sulle -specifiche del modello. +specifiche del pattern. In Unix, assicurarsi che i caratteri di globbing siano citati se usati. Questa opzione può essere utilizzata solo con \`check\` e \`fix\`. @@ -1143,7 +1142,7 @@ Seleziona il piano di scrub. Se PERC è un valore numerico da 0 a 100, viene interpretato come la percentuale di blocchi da sottoporre a scrub. Invece di una percentuale, è possibile specificare un piano: -\`bad\` esegue lo scrub dei blocchi bad, \`new\` esegue lo scrub +\`bad\` esegue lo scrub dei blocchi danneggiati, \`new\` esegue lo scrub dei blocchi non ancora sottoposti a scrub, e \`full\` esegue lo scrub di tutto. Questa opzione può essere utilizzata solo con \`scrub\`. @@ -1152,7 +1151,7 @@ Questa opzione può essere utilizzata solo con \`scrub\`. Seleziona la parte più vecchia dell\'array da elaborare in \`scrub\`. DAYS è l\'età minima in giorni per un blocco da sottoporre a scrub; il valore predefinito è 10. -I blocchi contrassegnati come bad vengono sempre sottoposti a scrub +I blocchi contrassegnati come \`bad\` vengono sempre sottoposti a scrub indipendentemente da questa opzione. Questa opzione può essere utilizzata solo con \`scrub\`. .TP @@ -1205,9 +1204,9 @@ Applica un limite di larghezza di banda globale per tutti i dischi. RATE è il numero di byte al secondo. È possibile specificare un moltiplicatore come K, M, G o T (ad esempio, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail DIMENSIONE +.B \-t, \-\-tail SIZE Limita l\'elenco dei file a quelli che non utilizzano più della -dimensione di coda specificata dei dischi di parità. +porzione finale specificata dei dischi di parità. È possibile utilizzare moltiplicatori come K, M, G o T (ad es. \-\-tail 1G). Questa opzione è valida solo se utilizzata insieme al comando \`locate\`. @@ -1316,9 +1315,9 @@ ATTENZIONE! Questa opzione è solo per esperti ed è vivamente sconsigliato utilizzarla. NON si ha protezione dei dati durante l\'operazione \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail DIMENSIONE +.B \-W, \-\-force\-realloc\-tail SIZE Funziona come \-R, \-\-force\-realloc, ma limitatamente alla porzione -di coda specificata (ultimi DIMENSIONE byte) di ogni file di parità. +di coda specificata (ultimi SIZE byte) di ogni file di parità. Forza la riallocazione (spostamento) di qualsiasi frammento/blocco di file attualmente memorizzato in quella sezione di coda, consentendo loro di essere posizionati ovunque nei file di parità dove sia disponibile spazio libero @@ -1341,7 +1340,7 @@ per i file interessati. .B \-l, \-\-log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono -stampati sullo schermo, potenzialmente resulting in un output +stampati sullo schermo, potenzialmente producendo un output eccessivo in caso di molti errori. Quando \-l, \-\-log è specificato, vengono stampati sullo schermo solo gli errori fatali che causano l\'arresto di SnapRAID. @@ -1500,7 +1499,7 @@ essere unico. DIR è il punto di montaggio del disco nel file system. È possibile cambiare il punto di montaggio secondo necessità, purché si mantenga fisso NAME. .PP -È necessario utilizzare un\'opzione per ogni disco dati nell\'array. +Si dovrebbe utilizzare un\'opzione per ogni disco dati nell\'array. .PP È possibile rinominare un disco in seguito modificando NAME direttamente nel file di configurazione e quindi eseguendo un @@ -1546,18 +1545,18 @@ Esclude tutti i file e le directory nascosti. In Unix, i file nascosti sono quelli che iniziano con \`.\`. In Windows, sono quelli con l\'attributo nascosto. .SS exclude/include PATTERN -Definisce i modelli di file o directory da escludere o includere +Definisce i pattern di file o directory da escludere o includere nel processo di sync. -Tutti i modelli vengono elaborati nell\'ordine specificato. +Tutti i pattern vengono elaborati nell\'ordine specificato. .PP -Se il primo modello che corrisponde è un \`exclude\`, il file +Se il primo pattern che corrisponde è un \`exclude\`, il file viene escluso. Se è un \`include\`, il file viene incluso. -Se nessun modello corrisponde, il file viene escluso se l\'ultimo -modello specificato è un \`include\`, o incluso se l\'ultimo modello +Se nessun pattern corrisponde, il file viene escluso se l\'ultimo +pattern specificato è un \`include\`, o incluso se l\'ultimo pattern specificato è un \`exclude\`. .PP Vedere la sezione PATTERN per maggiori dettagli sulle specifiche -del modello. +del pattern. .PP Questa opzione può essere utilizzata più volte. .SS blocksize SIZE_IN_KIBIBYTES @@ -1630,33 +1629,33 @@ sistema ha memoria limitata. Come regola generale, SnapRAID tipicamente richiede 1 GiB di RAM per ogni 16 TB di dati nell\'array. .PP Nello specifico, per memorizzare gli hash dei dati, SnapRAID richiede -circa $TS*(1+HS)/BS$ byte di RAM, -dove $TS$ è la dimensione totale in byte dell\'array di dischi, $BS$ è la -dimensione del blocco in byte e $HS$ è la dimensione dell\'hash in byte. +circa TS*(1+HS)/BS byte di RAM, +dove TS è la dimensione totale in byte dell\'array di dischi, BS è la +dimensione del blocco in byte e HS è la dimensione dell\'hash in byte. .PP Ad esempio, con 8 dischi da 4 TB, una dimensione di blocco di 256 KiB -($1 \\text{ KiB} = 1024 \\text{ byte}$) e una dimensione di hash di 16, si ottiene: +(1 KiB = 1024 byte) e una dimensione di hash di 16, si ottiene: .PP -RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB .PD 0 .PD .PP Passando a una dimensione di hash di 8, si ottiene: .PP -RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB .PD 0 .PD .PP Passando a una dimensione di blocco di 512, si ottiene: .PP -RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB .PD 0 .PD .PP -Passando sia a una dimensione di hash di 8 che a una dimensione di +Passando sia a una dimensione di hash di 8 sia a una dimensione di blocco di 512, si ottiene: .PP -RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB .PD 0 .PD .SS autosave SIZE_IN_GIGABYTES @@ -1800,7 +1799,7 @@ smartignore parity 197 5 .PD 0 .PD .RE -.SS Esempi +.SS Esempi (Examples) Un esempio di configurazione tipica per Unix è: .PP .RS 4 @@ -1908,7 +1907,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD 0 .PD .RE -.SH SNAPSHOTS +.SH SNAPSHOT (SNAPSHOTS) Se l\'opzione snapshot è abilitata nella configurazione, SnapRAID utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche e coerenti. @@ -1967,7 +1966,7 @@ a operare direttamente sul file system live. La creazione e l\'eliminazione degli snapshot richiedono privilegi amministrativi. Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando gli snapshot sono abilitati. -.SS Comportamento dei comandi con gli snapshot +.SS Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) I comandi \`sync\` e \`scrub\` operano entrambi esclusivamente sugli snapshot per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente e congelato. Utilizzando questi snapshot, SnapRAID previene le discrepanze di parità @@ -2233,7 +2232,7 @@ configurazione globale. In pratica, se una regola locale corrisponde, il file vi escluso indipendentemente dalle impostazioni di inclusione globali. .PP La logica dei pattern in \`.snapraidignore\` rispecchia la configurazione globale -ma ancora i pattern alla directory in cui si trova il file: +ma vincola i pattern alla directory in cui si trova il file: .TP .B FILE Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa. @@ -2314,10 +2313,25 @@ della console. Questo influisce solo sui nomi dei file stampati; se si reindirizza l\'output della console a un file, il file risultante è sempre in formato UTF\-8. +.SH CODICE DI USCITA (EXIT CODE) +SnapRAID termina con i seguenti codici di errore: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Tutto OK. +.HP 4 +.I 1 +Il comando ha riscontrato alcuni errori. +.HP 4 +.I 2 +Il comando \`diff\` ha rilevato che tutto è OK, ma è necessario un \`sync\`. +.PD +.RE .SH TRADUZIONE (TRANSLATION) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. .SH COPYRIGHT -Questo file è Copyright (C) 2025 Andrea Mazzoleni +Questo file è Copyright (C) 2026 Andrea Mazzoleni .SH VEDI ANCHE (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 1c83919c..859e4cbb 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -44,7 +44,7 @@ Descrizione (Description) * È possibile aggiungere dischi in qualsiasi momento. * SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi momento senza riformattare o spostare i dati. - * Per accedere a un file, è necessario far girare solo un singolo disco, + * Per accedere a un file, è necessario avviare la rotazione di solo un singolo disco, risparmiando energia e riducendo il rumore. Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: @@ -58,7 +58,7 @@ Limitazioni (Limitations) La limitazione principale è che se un disco si guasta, puoi recuperare i dati solo fino allo stato dell'ultima operazione di `sync`. Qualsiasi dato aggiunto o modifica apportata - dall'ultimo sync che si trova sul disco guasto andrà perso. + dopo l'ultimo sync sul disco guasto andrà perso. Di conseguenza, SnapRAID è adatto principalmente per dati che cambiano raramente. @@ -66,7 +66,7 @@ Limitazioni (Limitations) dall'uso o meno dell'opzione `snapshot`: * Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), - SnapRAID può mantenere automaticamente un riferimento congelato dei dischi dati. + SnapRAID può mantenere automaticamente un'immagine congelata dei dischi dati. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. @@ -91,7 +91,7 @@ Limitazioni (Limitations) * Vengono salvati solo nomi di file, timestamp, symlink e hardlink. Permessi, proprietà e attributi estesi non vengono salvati. -Iniziare (Getting Started) +Primi passi (Getting Started) Per usare SnapRAID, è necessario prima selezionare un disco nell'array di dischi da dedicare alle informazioni di `parity` (parità). Con un disco per la parità, si sarà in grado di recuperare da un singolo guasto @@ -105,7 +105,7 @@ Iniziare (Getting Started) dell'array, poiché le informazioni di parità possono crescere fino alle dimensioni del più grande disco dati nell'array. - Questi dischi saranno dedicati alla memorizzazione dei file di `parity`. + Questi dischi saranno dedicati alla memorizzazione dei file di parità. Non si dovrebbero memorizzare i propri dati su di essi. Quindi, è necessario definire i dischi `data` (dati) che si desidera @@ -120,7 +120,7 @@ Iniziare (Getting Started) per verificarne l'integrità. Il file `content` viene memorizzato in più copie e ogni copia deve essere su un disco diverso per garantire che, anche in caso di guasti - multipli del disco, sia disponibile almeno una copia. + multipli ai dischi, sia disponibile almeno una copia. Ad esempio, supponiamo di essere interessati a un solo livello di protezione con parità e che i dischi si trovino in: @@ -185,8 +185,8 @@ Iniziare (Getting Started) Ogni esecuzione del comando controlla circa l'8% dell'array, escludendo i dati già sottoposti a scrub nei 10 giorni precedenti. - È possibile utilizzare l'opzione -p, --plan per specificare un importo - diverso e l'opzione -o, --older-than per specificare un'età diversa + È possibile utilizzare l'opzione -p, --plan per specificare una quantità + diversa e l'opzione -o, --older-than per specificare un'età diversa in giorni. Ad esempio, per controllare il 5% dell'array per blocchi più vecchi di 20 giorni, usare: @@ -194,32 +194,32 @@ Iniziare (Getting Started) :snapraid -p 5 -o 20 scrub Se vengono trovati errori silenti o di input/output durante il processo, - i blocchi corrispondenti vengono contrassegnati come bad (cattivi) nel + i blocchi corrispondenti vengono contrassegnati come `bad` (danneggiati) nel file `content` ed elencati nel comando `status`. :snapraid status Per correggerli, è possibile utilizzare il comando `fix`, filtrando - i blocchi bad con l'opzione -e, --filter-error: + i blocchi danneggiati con l'opzione -e, --filter-error: :snapraid -e fix Al prossimo `scrub`, gli errori scompariranno dal report `status` se sono stati veramente corretti. Per renderlo più veloce, è possibile utilizzare -p bad per eseguire lo scrub solo dei blocchi contrassegnati - come bad. + come `bad`. :snapraid -p bad scrub L'esecuzione di `scrub` su un array non sincronizzato può riportare errori causati da file rimossi o modificati. Questi errori sono riportati nell'output di `scrub`, ma i blocchi correlati non sono contrassegnati - come bad. + come `bad`. Pooling (Pooling) Nota: La funzionalità di pooling descritta di seguito è stata sostituita dallo strumento mergerfs, che è ora l'opzione consigliata - per gli utenti Linux nella comunità SnapRAID. Mergefs fornisce un modo + per gli utenti Linux nella comunità SnapRAID. Mergerfs fornisce un modo più flessibile ed efficiente per raggruppare più unità in un singolo punto di montaggio unificato, consentendo un accesso trasparente ai file attraverso l'array senza fare affidamento sui collegamenti @@ -297,8 +297,8 @@ Iniziare (Getting Started) Annullamento eliminazione (Undeleting) SnapRAID funziona più come un programma di backup che come un sistema RAID - e può essere utilizzato per ripristinare o annullare l'eliminazione dei - file al loro stato precedente utilizzando l'opzione -f, --filter: + e può essere utilizzato per ripristinare i file al loro stato precedente + o annullarne l'eliminazione utilizzando l'opzione -f, --filter: :snapraid fix -f FILE @@ -318,7 +318,7 @@ Iniziare (Getting Started) :snapraid fix -m Recupero (Recovering) - È successo il peggio e si è perso uno o più dischi! + È successo il peggio e si sono persi uno o più dischi! NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli! @@ -328,7 +328,7 @@ Iniziare (Getting Started) Quindi procedere con i seguenti passaggi. - PASSO 1 -> Riconfigurazione + PASSO 1 -> Riconfigurazione (Reconfigure) È necessario un po' di spazio per recuperare, idealmente su dischi di riserva aggiuntivi, ma un disco USB esterno o un disco remoto saranno sufficienti. @@ -429,7 +429,7 @@ Comandi (Commands) eseguito `sync`. Le modifiche successive non vengono prese in considerazione. - Se sono stati rilevati blocchi bad, vengono elencati i loro numeri + Se sono stati rilevati blocchi danneggiati, vengono elencati i loro numeri di blocco. Per correggerli, è possibile utilizzare il comando `fix -e`. Mostra anche un grafico che rappresenta l'ultima volta che ogni blocco @@ -478,8 +478,8 @@ Comandi (Commands) probe Stampa lo stato POWER di tutti i dischi nel sistema. - `Standby` significa che il disco non sta girando. `Active` significa - che il disco sta girando. + `Standby` significa che il disco non è in rotazione. `Active` significa + che il disco è in rotazione. Questo comando utilizza lo strumento `smartctl` ed è equivalente all'esecuzione di `smartctl -n standby -i` su tutti i dispositivi. @@ -491,12 +491,12 @@ Comandi (Commands) Nulla viene modificato. up - Fa girare tutti i dischi dell'array. + Avvia la rotazione di tutti i dischi dell'array. - È possibile far girare solo dischi specifici utilizzando l'opzione -d, + È possibile avviare la rotazione di soli dischi specifici utilizzando l'opzione -d, --filter-disk. - Far girare tutti i dischi contemporaneamente richiede molta energia. + Avviare la rotazione di tutti i dischi contemporaneamente richiede molta energia. Assicurarsi che l'alimentatore possa sostenerlo. Nulla viene modificato. @@ -541,13 +541,13 @@ Comandi (Commands) il percorso completo deve corrispondere per essere identificato, non solo il nome. relocated - File spostati sullo stesso disco o su un disco - diverso dove l'originale è scomparso. - Sono identificati dall' avere lo stesso nome, dimensione + diverso dove l'originale è scomparso. + Sono identificati dall'avere lo stesso nome, dimensione e timestamp. Se il timestamp al sottomultiplo del secondo è zero, il percorso completo deve corrispondere per essere identificato. - A differenza dei file `moved` sullo stesso disco, + A differenza dei file 'moved' sullo stesso disco, i file ricollocati hanno un inode diverso. restored - File con un inode diverso ma directory, nome, dimensione e timestamp corrispondenti. @@ -571,7 +571,7 @@ Comandi (Commands) è stato interrotto. Se vengono trovati errori silenti o di input/output durante il processo, - i blocchi corrispondenti vengono contrassegnati come bad. + i blocchi corrispondenti vengono contrassegnati come `bad` (danneggiati). I file sono identificati dal percorso e/o dall'inode e controllati per dimensione e timestamp. @@ -597,7 +597,7 @@ Comandi (Commands) È possibile definire un piano o una quantità di scrub diversa utilizzando l'opzione -p, --plan, che accetta: - bad - Esegue lo scrub dei blocchi contrassegnati come bad. + bad - Esegue lo scrub dei blocchi contrassegnati come `bad`. new - Esegue lo scrub dei blocchi appena sincronizzati non ancora sottoposti a scrub. full - Esegue lo scrub di tutto. @@ -615,22 +615,22 @@ Comandi (Commands) `status`. Per qualsiasi errore silente o di input/output trovato, i blocchi - corrispondenti vengono contrassegnati come bad nel file `content`. - Questi blocchi bad sono elencati in `status` e possono essere corretti + corrispondenti vengono contrassegnati come `bad` nel file `content`. + Questi blocchi danneggiati sono elencati in `status` e possono essere corretti con `fix -e`. Dopo la correzione, al prossimo scrub, verranno ricontrollati e, se - trovati corretti, il contrassegno bad verrà rimosso. - Per eseguire lo scrub solo dei blocchi bad, è possibile utilizzare + trovati corretti, il contrassegno `bad` verrà rimosso. + Per eseguire lo scrub solo dei blocchi danneggiati, è possibile utilizzare il comando `scrub -p bad`. Si consiglia di eseguire `scrub` solo su un array sincronizzato per evitare errori segnalati causati da dati non sincronizzati. Questi errori sono riconosciuti come non essendo errori silenti e i blocchi non - vengono contrassegnati come bad, ma tali errori sono riportati + vengono contrassegnati come `bad`, ma tali errori sono riportati nell'output del comando. Il file `content` viene modificato per aggiornare l'ora dell'ultimo - controllo per ogni blocco e per contrassegnare i blocchi bad. + controllo per ogni blocco e per contrassegnare i blocchi danneggiati. I file `parity` NON vengono modificati. I file nell'array NON vengono modificati. @@ -648,7 +648,7 @@ Comandi (Commands) elaborato. Utilizzare le opzioni di filtro per selezionare un sottoinsieme di file o dischi su cui operare. - Per correggere solo i blocchi contrassegnati come bad durante `sync` + Per correggere solo i blocchi contrassegnati come `bad` (danneggiati) durante `sync` e `scrub`, utilizzare l'opzione -e, --filter-error. A differenza di altre opzioni di filtro, questa applica correzioni solo ai file che sono invariati dall'ultimo `sync`. @@ -681,8 +681,8 @@ Comandi (Commands) ad esempio dopo un processo di recupero o in altre condizioni speciali. Per i controlli periodici e pianificati, utilizzare `scrub`. - Se si utilizza l'opzione -a, --audit-only, viene controllato solo - l'hash dei file e i dati di parità vengono ignorati per un'esecuzione + Se si utilizza l'opzione -a, --audit-only, vengono controllati solo + i dati dei file e i dati di parità vengono ignorati per un'esecuzione più veloce. I file sono identificati solo dal percorso, non dall'inode. @@ -777,11 +777,10 @@ Comandi (Commands) È possibile utilizzare l'opzione -t, --tail per limitare l'operazione ai file che occupano la porzione di coda specificata della parità. - Se si desidera riallocare questi file, è possibile utilizzare l'opzione - -W, --force-realloc-tail. - Si tenga presente che tali file non saranno protetti dalla parità durante - il processo di riallocazione. + Se si desidera riallocare questi file, è possibile utilizzare l'opzione + -W, --force-realloc-tail. Si tenga presente che tali file non saranno + protetti dalla parità durante il processo di riallocazione. Opzioni (Options) SnapRAID fornisce le seguenti opzioni: @@ -795,11 +794,11 @@ Opzioni (Options) -f, --filter PATTERN Filtra i file da elaborare in `check` e `fix`. - Vengono elaborati solo i file che corrispondono al modello + Vengono elaborati solo i file che corrispondono al pattern specificato. Questa opzione può essere utilizzata più volte. Vedere la sezione PATTERN per maggiori dettagli sulle - specifiche del modello. + specifiche del pattern. In Unix, assicurarsi che i caratteri di globbing siano citati se usati. Questa opzione può essere utilizzata solo con `check` e `fix`. @@ -846,7 +845,7 @@ Opzioni (Options) 100, viene interpretato come la percentuale di blocchi da sottoporre a scrub. Invece di una percentuale, è possibile specificare un piano: - `bad` esegue lo scrub dei blocchi bad, `new` esegue lo scrub + `bad` esegue lo scrub dei blocchi danneggiati, `new` esegue lo scrub dei blocchi non ancora sottoposti a scrub, e `full` esegue lo scrub di tutto. Questa opzione può essere utilizzata solo con `scrub`. @@ -855,7 +854,7 @@ Opzioni (Options) Seleziona la parte più vecchia dell'array da elaborare in `scrub`. DAYS è l'età minima in giorni per un blocco da sottoporre a scrub; il valore predefinito è 10. - I blocchi contrassegnati come bad vengono sempre sottoposti a scrub + I blocchi contrassegnati come `bad` vengono sempre sottoposti a scrub indipendentemente da questa opzione. Questa opzione può essere utilizzata solo con `scrub`. @@ -908,9 +907,9 @@ Opzioni (Options) RATE è il numero di byte al secondo. È possibile specificare un moltiplicatore come K, M, G o T (ad esempio, --bw-limit 1G). - -t, --tail DIMENSIONE + -t, --tail SIZE Limita l'elenco dei file a quelli che non utilizzano più della - dimensione di coda specificata dei dischi di parità. + porzione finale specificata dei dischi di parità. È possibile utilizzare moltiplicatori come K, M, G o T (ad es. --tail 1G). Questa opzione è valida solo se utilizzata insieme al comando `locate`. @@ -1019,9 +1018,9 @@ Opzioni (Options) sconsigliato utilizzarla. NON si ha protezione dei dati durante l'operazione `sync`. - -W, --force-realloc-tail DIMENSIONE + -W, --force-realloc-tail SIZE Funziona come -R, --force-realloc, ma limitatamente alla porzione - di coda specificata (ultimi DIMENSIONE byte) di ogni file di parità. + di coda specificata (ultimi SIZE byte) di ogni file di parità. Forza la riallocazione (spostamento) di qualsiasi frammento/blocco di file attualmente memorizzato in quella sezione di coda, consentendo loro di essere posizionati ovunque nei file di parità dove sia disponibile spazio libero @@ -1044,7 +1043,7 @@ Opzioni (Options) -l, --log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono - stampati sullo schermo, potenzialmente resulting in un output + stampati sullo schermo, potenzialmente producendo un output eccessivo in caso di molti errori. Quando -l, --log è specificato, vengono stampati sullo schermo solo gli errori fatali che causano l'arresto di SnapRAID. @@ -1203,7 +1202,7 @@ Configurazione (Configuration) È possibile cambiare il punto di montaggio secondo necessità, purché si mantenga fisso NAME. - È necessario utilizzare un'opzione per ogni disco dati nell'array. + Si dovrebbe utilizzare un'opzione per ogni disco dati nell'array. È possibile rinominare un disco in seguito modificando NAME direttamente nel file di configurazione e quindi eseguendo un @@ -1253,18 +1252,18 @@ Configurazione (Configuration) In Windows, sono quelli con l'attributo nascosto. exclude/include PATTERN - Definisce i modelli di file o directory da escludere o includere + Definisce i pattern di file o directory da escludere o includere nel processo di sync. - Tutti i modelli vengono elaborati nell'ordine specificato. + Tutti i pattern vengono elaborati nell'ordine specificato. - Se il primo modello che corrisponde è un `exclude`, il file + Se il primo pattern che corrisponde è un `exclude`, il file viene escluso. Se è un `include`, il file viene incluso. - Se nessun modello corrisponde, il file viene escluso se l'ultimo - modello specificato è un `include`, o incluso se l'ultimo modello + Se nessun pattern corrisponde, il file viene escluso se l'ultimo + pattern specificato è un `include`, o incluso se l'ultimo pattern specificato è un `exclude`. Vedere la sezione PATTERN per maggiori dettagli sulle specifiche - del modello. + del pattern. Questa opzione può essere utilizzata più volte. @@ -1335,27 +1334,27 @@ Configurazione (Configuration) tipicamente richiede 1 GiB di RAM per ogni 16 TB di dati nell'array. Nello specifico, per memorizzare gli hash dei dati, SnapRAID richiede - circa $TS*(1+HS)/BS$ byte di RAM, - dove $TS$ è la dimensione totale in byte dell'array di dischi, $BS$ è la - dimensione del blocco in byte e $HS$ è la dimensione dell'hash in byte. + circa TS*(1+HS)/BS byte di RAM, + dove TS è la dimensione totale in byte dell'array di dischi, BS è la + dimensione del blocco in byte e HS è la dimensione dell'hash in byte. Ad esempio, con 8 dischi da 4 TB, una dimensione di blocco di 256 KiB - ($1 \text{ KiB} = 1024 \text{ byte}$) e una dimensione di hash di 16, si ottiene: + (1 KiB = 1024 byte) e una dimensione di hash di 16, si ottiene: - :RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB Passando a una dimensione di hash di 8, si ottiene: - :RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB Passando a una dimensione di blocco di 512, si ottiene: - :RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB - Passando sia a una dimensione di hash di 8 che a una dimensione di + Passando sia a una dimensione di hash di 8 sia a una dimensione di blocco di 512, si ottiene: - :RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB autosave SIZE_IN_GIGABYTES Salva automaticamente lo stato durante la sincronizzazione o lo scrubbing @@ -1480,7 +1479,7 @@ Configurazione (Configuration) :smartignore parity 197 5 - Esempi + Esempi (Examples) Un esempio di configurazione tipica per Unix è: :parity /mnt/diskp/snapraid.parity @@ -1512,7 +1511,7 @@ Configurazione (Configuration) :smartctl parity -d areca,1/1 /dev/arcmsr0 :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 -Snapshots +Snapshot (Snapshots) Se l'opzione snapshot è abilitata nella configurazione, SnapRAID utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche e coerenti. @@ -1559,7 +1558,7 @@ Snapshots Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando gli snapshot sono abilitati. - Comportamento dei comandi con gli snapshot + Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) I comandi `sync` e `scrub` operano entrambi esclusivamente sugli snapshot per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente e congelato. Utilizzando questi snapshot, SnapRAID previene le discrepanze di parità @@ -1758,7 +1757,7 @@ File da ignorare (Ignore File) escluso indipendentemente dalle impostazioni di inclusione globali. La logica dei pattern in `.snapraidignore` rispecchia la configurazione globale - ma ancora i pattern alla directory in cui si trova il file: + ma vincola i pattern alla directory in cui si trova il file: =FILE Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa. @@ -1824,12 +1823,19 @@ Codifica (Encoding) reindirizza l'output della console a un file, il file risultante è sempre in formato UTF-8. +Codice di uscita (Exit Code) + SnapRAID termina con i seguenti codici di errore: + + 0 - Tutto OK. + 1 - Il comando ha riscontrato alcuni errori. + 2 - Il comando `diff` ha rilevato che tutto è OK, ma è necessario un `sync`. + Traduzione (Translation) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. Copyright - Questo file è Copyright (C) 2025 Andrea Mazzoleni + Questo file è Copyright (C) 2026 Andrea Mazzoleni Vedi anche (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index 98d84ff2..ec59da23 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -51,7 +51,7 @@ e che cambiano raramente, SnapRAID offre diverse funzionalità: * È possibile aggiungere dischi in qualsiasi momento. * SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi momento senza riformattare o spostare i dati. -* Per accedere a un file, è necessario far girare solo un singolo disco, +* Per accedere a un file, è necessario avviare la rotazione di solo un singolo disco, risparmiando energia e riducendo il rumore. Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: @@ -68,7 +68,7 @@ considerare prima di usarlo. La limitazione principale è che se un disco si guasta, puoi recuperare i dati solo fino allo stato dell'ultima operazione di `sync`. Qualsiasi dato aggiunto o modifica apportata -dall'ultimo sync che si trova sul disco guasto andrà perso. +dopo l'ultimo sync sul disco guasto andrà perso. Di conseguenza, SnapRAID è adatto principalmente per dati che cambiano raramente. @@ -76,7 +76,7 @@ Per i dati che esistevano già all'ultimo sync, l'affidabilità del recupero dip dall'uso o meno dell'opzione `snapshot`: * Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), - SnapRAID può mantenere automaticamente un riferimento congelato dei dischi dati. + SnapRAID può mantenere automaticamente un'immagine congelata dei dischi dati. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. @@ -102,8 +102,8 @@ Altre limitazioni di SnapRAID sono: Permessi, proprietà e attributi estesi non vengono salvati. -4 INIZIARE (GETTING STARTED) -============================ +4 PRIMI PASSI (GETTING STARTED) +=============================== Per usare SnapRAID, è necessario prima selezionare un disco nell'array di dischi da dedicare alle informazioni di `parity` (parità). Con un @@ -118,7 +118,7 @@ Come dischi di parità, è necessario scegliere i dischi più grandi dell'array, poiché le informazioni di parità possono crescere fino alle dimensioni del più grande disco dati nell'array. -Questi dischi saranno dedicati alla memorizzazione dei file di `parity`. +Questi dischi saranno dedicati alla memorizzazione dei file di parità. Non si dovrebbero memorizzare i propri dati su di essi. Quindi, è necessario definire i dischi `data` (dati) che si desidera @@ -133,7 +133,7 @@ Questo file contiene i dettagli del backup, inclusi tutti i checksum per verificarne l'integrità. Il file `content` viene memorizzato in più copie e ogni copia deve essere su un disco diverso per garantire che, anche in caso di guasti -multipli del disco, sia disponibile almeno una copia. +multipli ai dischi, sia disponibile almeno una copia. Ad esempio, supponiamo di essere interessati a un solo livello di protezione con parità e che i dischi si trovino in: @@ -200,8 +200,8 @@ durante il comando `sync` per verificarne l'integrità. Ogni esecuzione del comando controlla circa l'8% dell'array, escludendo i dati già sottoposti a scrub nei 10 giorni precedenti. -È possibile utilizzare l'opzione -p, --plan per specificare un importo -diverso e l'opzione -o, --older-than per specificare un'età diversa +È possibile utilizzare l'opzione -p, --plan per specificare una quantità +diversa e l'opzione -o, --older-than per specificare un'età diversa in giorni. Ad esempio, per controllare il 5% dell'array per blocchi più vecchi di 20 giorni, usare: @@ -209,34 +209,34 @@ Ad esempio, per controllare il 5% dell'array per blocchi più vecchi di snapraid -p 5 -o 20 scrub Se vengono trovati errori silenti o di input/output durante il processo, -i blocchi corrispondenti vengono contrassegnati come bad (cattivi) nel +i blocchi corrispondenti vengono contrassegnati come `bad` (danneggiati) nel file `content` ed elencati nel comando `status`. snapraid status Per correggerli, è possibile utilizzare il comando `fix`, filtrando -i blocchi bad con l'opzione -e, --filter-error: +i blocchi danneggiati con l'opzione -e, --filter-error: snapraid -e fix Al prossimo `scrub`, gli errori scompariranno dal report `status` se sono stati veramente corretti. Per renderlo più veloce, è possibile utilizzare -p bad per eseguire lo scrub solo dei blocchi contrassegnati -come bad. +come `bad`. snapraid -p bad scrub L'esecuzione di `scrub` su un array non sincronizzato può riportare errori causati da file rimossi o modificati. Questi errori sono riportati nell'output di `scrub`, ma i blocchi correlati non sono contrassegnati -come bad. +come `bad`. 4.2 Pooling (Pooling) --------------------- Nota: La funzionalità di pooling descritta di seguito è stata sostituita dallo strumento mergerfs, che è ora l'opzione consigliata -per gli utenti Linux nella comunità SnapRAID. Mergefs fornisce un modo +per gli utenti Linux nella comunità SnapRAID. Mergerfs fornisce un modo più flessibile ed efficiente per raggruppare più unità in un singolo punto di montaggio unificato, consentendo un accesso trasparente ai file attraverso l'array senza fare affidamento sui collegamenti @@ -316,8 +316,8 @@ abilitare l'accesso ai symlink remoti con il comando: ------------------------------------------ SnapRAID funziona più come un programma di backup che come un sistema RAID -e può essere utilizzato per ripristinare o annullare l'eliminazione dei -file al loro stato precedente utilizzando l'opzione -f, --filter: +e può essere utilizzato per ripristinare i file al loro stato precedente +o annullarne l'eliminazione utilizzando l'opzione -f, --filter: snapraid fix -f FILE @@ -339,7 +339,7 @@ O per recuperare tutti i file eliminati su tutte le unità con: 4.4 Recupero (Recovering) ------------------------- -È successo il peggio e si è perso uno o più dischi! +È successo il peggio e si sono persi uno o più dischi! NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli! @@ -349,7 +349,7 @@ pianificato, incluso qualsiasi sync o scrub notturno pianificato di SnapRAID. Quindi procedere con i seguenti passaggi. ----- 4.4.1 PASSO 1 -> Riconfigurazione ---- +---- 4.4.1 PASSO 1 -> Riconfigurazione (Reconfigure) ---- È necessario un po' di spazio per recuperare, idealmente su dischi di riserva aggiuntivi, ma un disco USB esterno o un disco remoto saranno sufficienti. @@ -455,7 +455,7 @@ Le informazioni presentate si riferiscono all'ultima volta che si è eseguito `sync`. Le modifiche successive non vengono prese in considerazione. -Se sono stati rilevati blocchi bad, vengono elencati i loro numeri +Se sono stati rilevati blocchi danneggiati, vengono elencati i loro numeri di blocco. Per correggerli, è possibile utilizzare il comando `fix -e`. Mostra anche un grafico che rappresenta l'ultima volta che ogni blocco @@ -508,8 +508,8 @@ Nulla viene modificato. Stampa lo stato POWER di tutti i dischi nel sistema. -`Standby` significa che il disco non sta girando. `Active` significa -che il disco sta girando. +`Standby` significa che il disco non è in rotazione. `Active` significa +che il disco è in rotazione. Questo comando utilizza lo strumento `smartctl` ed è equivalente all'esecuzione di `smartctl -n standby -i` su tutti i dispositivi. @@ -523,12 +523,12 @@ Nulla viene modificato. 5.4 up ------ -Fa girare tutti i dischi dell'array. +Avvia la rotazione di tutti i dischi dell'array. -È possibile far girare solo dischi specifici utilizzando l'opzione -d, +È possibile avviare la rotazione di soli dischi specifici utilizzando l'opzione -d, --filter-disk. -Far girare tutti i dischi contemporaneamente richiede molta energia. +Avviare la rotazione di tutti i dischi contemporaneamente richiede molta energia. Assicurarsi che l'alimentatore possa sostenerlo. Nulla viene modificato. @@ -577,13 +577,13 @@ riepilogo delle modifiche, raggruppate per: il percorso completo deve corrispondere per essere identificato, non solo il nome. relocated - File spostati sullo stesso disco o su un disco - diverso dove l'originale è scomparso. - Sono identificati dall' avere lo stesso nome, dimensione + diverso dove l'originale è scomparso. + Sono identificati dall'avere lo stesso nome, dimensione e timestamp. Se il timestamp al sottomultiplo del secondo è zero, il percorso completo deve corrispondere per essere identificato. - A differenza dei file `moved` sullo stesso disco, + A differenza dei file 'moved' sullo stesso disco, i file ricollocati hanno un inode diverso. restored - File con un inode diverso ma directory, nome, dimensione e timestamp corrispondenti. @@ -609,7 +609,7 @@ Alla prossima esecuzione, il processo `sync` riprenderà da dove è stato interrotto. Se vengono trovati errori silenti o di input/output durante il processo, -i blocchi corrispondenti vengono contrassegnati come bad. +i blocchi corrispondenti vengono contrassegnati come `bad` (danneggiati). I file sono identificati dal percorso e/o dall'inode e controllati per dimensione e timestamp. @@ -637,7 +637,7 @@ ogni tre mesi. È possibile definire un piano o una quantità di scrub diversa utilizzando l'opzione -p, --plan, che accetta: -bad - Esegue lo scrub dei blocchi contrassegnati come bad. +bad - Esegue lo scrub dei blocchi contrassegnati come `bad`. new - Esegue lo scrub dei blocchi appena sincronizzati non ancora sottoposti a scrub. full - Esegue lo scrub di tutto. @@ -655,22 +655,22 @@ Per ottenere i dettagli dello stato dello scrub, utilizzare il comando `status`. Per qualsiasi errore silente o di input/output trovato, i blocchi -corrispondenti vengono contrassegnati come bad nel file `content`. -Questi blocchi bad sono elencati in `status` e possono essere corretti +corrispondenti vengono contrassegnati come `bad` nel file `content`. +Questi blocchi danneggiati sono elencati in `status` e possono essere corretti con `fix -e`. Dopo la correzione, al prossimo scrub, verranno ricontrollati e, se -trovati corretti, il contrassegno bad verrà rimosso. -Per eseguire lo scrub solo dei blocchi bad, è possibile utilizzare +trovati corretti, il contrassegno `bad` verrà rimosso. +Per eseguire lo scrub solo dei blocchi danneggiati, è possibile utilizzare il comando `scrub -p bad`. Si consiglia di eseguire `scrub` solo su un array sincronizzato per evitare errori segnalati causati da dati non sincronizzati. Questi errori sono riconosciuti come non essendo errori silenti e i blocchi non -vengono contrassegnati come bad, ma tali errori sono riportati +vengono contrassegnati come `bad`, ma tali errori sono riportati nell'output del comando. Il file `content` viene modificato per aggiornare l'ora dell'ultimo -controllo per ogni blocco e per contrassegnare i blocchi bad. +controllo per ogni blocco e per contrassegnare i blocchi danneggiati. I file `parity` NON vengono modificati. I file nell'array NON vengono modificati. @@ -690,7 +690,7 @@ Se non viene specificata nessun'altra opzione, l'intero array viene elaborato. Utilizzare le opzioni di filtro per selezionare un sottoinsieme di file o dischi su cui operare. -Per correggere solo i blocchi contrassegnati come bad durante `sync` +Per correggere solo i blocchi contrassegnati come `bad` (danneggiati) durante `sync` e `scrub`, utilizzare l'opzione -e, --filter-error. A differenza di altre opzioni di filtro, questa applica correzioni solo ai file che sono invariati dall'ultimo `sync`. @@ -725,8 +725,8 @@ Questo comando è destinato principalmente alla verifica manuale, ad esempio dopo un processo di recupero o in altre condizioni speciali. Per i controlli periodici e pianificati, utilizzare `scrub`. -Se si utilizza l'opzione -a, --audit-only, viene controllato solo -l'hash dei file e i dati di parità vengono ignorati per un'esecuzione +Se si utilizza l'opzione -a, --audit-only, vengono controllati solo +i dati dei file e i dati di parità vengono ignorati per un'esecuzione più veloce. I file sono identificati solo dal percorso, non dall'inode. @@ -835,11 +835,10 @@ che occupa. È possibile utilizzare l'opzione -t, --tail per limitare l'operazione ai file che occupano la porzione di coda specificata della parità. -Se si desidera riallocare questi file, è possibile utilizzare l'opzione --W, --force-realloc-tail. -Si tenga presente che tali file non saranno protetti dalla parità durante -il processo di riallocazione. +Se si desidera riallocare questi file, è possibile utilizzare l'opzione +-W, --force-realloc-tail. Si tenga presente che tali file non saranno +protetti dalla parità durante il processo di riallocazione. 6 OPZIONI (OPTIONS) @@ -856,11 +855,11 @@ SnapRAID fornisce le seguenti opzioni: -f, --filter PATTERN Filtra i file da elaborare in `check` e `fix`. - Vengono elaborati solo i file che corrispondono al modello + Vengono elaborati solo i file che corrispondono al pattern specificato. Questa opzione può essere utilizzata più volte. Vedere la sezione PATTERN per maggiori dettagli sulle - specifiche del modello. + specifiche del pattern. In Unix, assicurarsi che i caratteri di globbing siano citati se usati. Questa opzione può essere utilizzata solo con `check` e `fix`. @@ -907,7 +906,7 @@ SnapRAID fornisce le seguenti opzioni: 100, viene interpretato come la percentuale di blocchi da sottoporre a scrub. Invece di una percentuale, è possibile specificare un piano: - `bad` esegue lo scrub dei blocchi bad, `new` esegue lo scrub + `bad` esegue lo scrub dei blocchi danneggiati, `new` esegue lo scrub dei blocchi non ancora sottoposti a scrub, e `full` esegue lo scrub di tutto. Questa opzione può essere utilizzata solo con `scrub`. @@ -916,7 +915,7 @@ SnapRAID fornisce le seguenti opzioni: Seleziona la parte più vecchia dell'array da elaborare in `scrub`. DAYS è l'età minima in giorni per un blocco da sottoporre a scrub; il valore predefinito è 10. - I blocchi contrassegnati come bad vengono sempre sottoposti a scrub + I blocchi contrassegnati come `bad` vengono sempre sottoposti a scrub indipendentemente da questa opzione. Questa opzione può essere utilizzata solo con `scrub`. @@ -969,9 +968,9 @@ SnapRAID fornisce le seguenti opzioni: RATE è il numero di byte al secondo. È possibile specificare un moltiplicatore come K, M, G o T (ad esempio, --bw-limit 1G). - -t, --tail DIMENSIONE + -t, --tail SIZE Limita l'elenco dei file a quelli che non utilizzano più della - dimensione di coda specificata dei dischi di parità. + porzione finale specificata dei dischi di parità. È possibile utilizzare moltiplicatori come K, M, G o T (ad es. --tail 1G). Questa opzione è valida solo se utilizzata insieme al comando `locate`. @@ -1080,9 +1079,9 @@ SnapRAID fornisce le seguenti opzioni: sconsigliato utilizzarla. NON si ha protezione dei dati durante l'operazione `sync`. - -W, --force-realloc-tail DIMENSIONE + -W, --force-realloc-tail SIZE Funziona come -R, --force-realloc, ma limitatamente alla porzione - di coda specificata (ultimi DIMENSIONE byte) di ogni file di parità. + di coda specificata (ultimi SIZE byte) di ogni file di parità. Forza la riallocazione (spostamento) di qualsiasi frammento/blocco di file attualmente memorizzato in quella sezione di coda, consentendo loro di essere posizionati ovunque nei file di parità dove sia disponibile spazio libero @@ -1105,7 +1104,7 @@ SnapRAID fornisce le seguenti opzioni: -l, --log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono - stampati sullo schermo, potenzialmente resulting in un output + stampati sullo schermo, potenzialmente producendo un output eccessivo in caso di molti errori. Quando -l, --log è specificato, vengono stampati sullo schermo solo gli errori fatali che causano l'arresto di SnapRAID. @@ -1277,7 +1276,7 @@ essere unico. DIR è il punto di montaggio del disco nel file system. È possibile cambiare il punto di montaggio secondo necessità, purché si mantenga fisso NAME. -È necessario utilizzare un'opzione per ogni disco dati nell'array. +Si dovrebbe utilizzare un'opzione per ogni disco dati nell'array. È possibile rinominare un disco in seguito modificando NAME direttamente nel file di configurazione e quindi eseguendo un @@ -1335,18 +1334,18 @@ In Windows, sono quelli con l'attributo nascosto. 7.9 exclude/include PATTERN --------------------------- -Definisce i modelli di file o directory da escludere o includere +Definisce i pattern di file o directory da escludere o includere nel processo di sync. -Tutti i modelli vengono elaborati nell'ordine specificato. +Tutti i pattern vengono elaborati nell'ordine specificato. -Se il primo modello che corrisponde è un `exclude`, il file +Se il primo pattern che corrisponde è un `exclude`, il file viene escluso. Se è un `include`, il file viene incluso. -Se nessun modello corrisponde, il file viene escluso se l'ultimo -modello specificato è un `include`, o incluso se l'ultimo modello +Se nessun pattern corrisponde, il file viene escluso se l'ultimo +pattern specificato è un `include`, o incluso se l'ultimo pattern specificato è un `exclude`. Vedere la sezione PATTERN per maggiori dettagli sulle specifiche -del modello. +del pattern. Questa opzione può essere utilizzata più volte. @@ -1421,27 +1420,27 @@ sistema ha memoria limitata. Come regola generale, SnapRAID tipicamente richiede 1 GiB di RAM per ogni 16 TB di dati nell'array. Nello specifico, per memorizzare gli hash dei dati, SnapRAID richiede -circa $TS*(1+HS)/BS$ byte di RAM, -dove $TS$ è la dimensione totale in byte dell'array di dischi, $BS$ è la -dimensione del blocco in byte e $HS$ è la dimensione dell'hash in byte. +circa TS*(1+HS)/BS byte di RAM, +dove TS è la dimensione totale in byte dell'array di dischi, BS è la +dimensione del blocco in byte e HS è la dimensione dell'hash in byte. Ad esempio, con 8 dischi da 4 TB, una dimensione di blocco di 256 KiB -($1 \text{ KiB} = 1024 \text{ byte}$) e una dimensione di hash di 16, si ottiene: +(1 KiB = 1024 byte) e una dimensione di hash di 16, si ottiene: -RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB Passando a una dimensione di hash di 8, si ottiene: -RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB Passando a una dimensione di blocco di 512, si ottiene: -RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB -Passando sia a una dimensione di hash di 8 che a una dimensione di +Passando sia a una dimensione di hash di 8 sia a una dimensione di blocco di 512, si ottiene: -RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB 7.12 autosave SIZE_IN_GIGABYTES ------------------------------- @@ -1580,8 +1579,8 @@ Per ignorarli solo sul primo disco di parità: smartignore parity 197 5 -7.19 Esempi ------------ +7.19 Esempi (Examples) +---------------------- Un esempio di configurazione tipica per Unix è: @@ -1615,8 +1614,8 @@ Un esempio di configurazione tipica per Windows è: smartctl 2-parity -d areca,2/1 /dev/arcmsr0 -8 SNAPSHOTS -=========== +8 SNAPSHOT (SNAPSHOTS) +====================== Se l'opzione snapshot è abilitata nella configurazione, SnapRAID utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche @@ -1664,8 +1663,8 @@ La creazione e l'eliminazione degli snapshot richiedono privilegi amministrativi Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando gli snapshot sono abilitati. -8.1 Comportamento dei comandi con gli snapshot ----------------------------------------------- +8.1 Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) +-------------------------------------------------------------------------------- I comandi `sync` e `scrub` operano entrambi esclusivamente sugli snapshot per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente @@ -1874,7 +1873,7 @@ configurazione globale. In pratica, se una regola locale corrisponde, il file vi escluso indipendentemente dalle impostazioni di inclusione globali. La logica dei pattern in `.snapraidignore` rispecchia la configurazione globale -ma ancora i pattern alla directory in cui si trova il file: +ma vincola i pattern alla directory in cui si trova il file: FILE Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa. @@ -1950,20 +1949,30 @@ reindirizza l'output della console a un file, il file risultante è sempre in formato UTF-8. -15 TRADUZIONE (TRANSLATION) +15 CODICE DI USCITA (EXIT CODE) +=============================== + +SnapRAID termina con i seguenti codici di errore: + +0 - Tutto OK. +1 - Il comando ha riscontrato alcuni errori. +2 - Il comando `diff` ha rilevato che tutto è OK, ma è necessario un `sync`. + + +16 TRADUZIONE (TRANSLATION) =========================== Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. -16 COPYRIGHT +17 COPYRIGHT ============ -Questo file è Copyright (C) 2025 Andrea Mazzoleni +Questo file è Copyright (C) 2026 Andrea Mazzoleni -17 VEDI ANCHE (SEE ALSO) +18 VEDI ANCHE (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index eeb5767a..af893ffd 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -358,7 +358,7 @@ snapraid \-p bad scrub .SS プーリング (Pooling) 注: ここで説明するプーリング機能は、**mergerfs** ツールに取って代わられました。 mergerfs は、SnapRAIDコミュニティのLinuxユーザーに推奨されるオプションです。 -Mergefs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 +Mergerfs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 より柔軟で効率的な方法を提供し、シンボリックリンクに頼ることなくアレイ全体の ファイルにシームレスにアクセスできます。これは、パリティ保護のためにSnapRAIDと うまく統合されており、OpenMediaVault (OMV) やカスタムNAS構成などのセットアップで @@ -1101,7 +1101,7 @@ DAYS は、ブロックがスクラブされるための最小経過日数であ 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：\-\-bw\-limit 1G)。 .TP -.B \-t, \-\-tail サイズ +.B \-t, \-\-tail SIZE ファイルリストを、パリティディスクの指定された末尾サイズ以下を 使用しているものに制限します。 K、M、G、T などの倍数を使用できます（例：\-\-tail 1G）。 @@ -1186,7 +1186,7 @@ SnapRAIDが一部のディスクがUUIDを変更したことを検出した場 お勧めします。 \`sync\` 操作中にデータ保護はありません。 .TP -.B \-W, \-\-force\-realloc\-tail サイズ +.B \-W, \-\-force\-realloc\-tail SIZE \-R, \-\-force\-realloc と同様に動作しますが、各パリティファイルの 指定された末尾部分（最後の「サイズ」バイト）に制限されます。 現在その末尾セクションに保存されているファイルフラグメント/ブロックの @@ -1456,31 +1456,31 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE 経験則として、SnapRAIDは通常、アレイ内のデータ16 TBごとに1 GiBのRAMを必要とします。 .PP 具体的には、データのハッシュを保存するために、SnapRAIDは -約 $TS \\cdot (1 + HS) / BS$ バイトのRAMを必要とします。 +約 TS*(1+HS)/BS バイトのRAMを必要とします。 ここで、TSはディスクアレイの合計サイズ（バイト）、BSはブロックサイズ（バイト）、HSはハッシュサイズ（バイト）です。 .PP たとえば、4 TBのディスク8台、ブロックサイズ256 KiB（1 KiB = 1024バイト）、 ハッシュサイズ16の場合： .PP -RAM = $(8 \\cdot 4 \\cdot 10^{12}) \\cdot (1 + 16) / (256 \\cdot 2^{10}) = 1.93 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB .PD 0 .PD .PP ハッシュサイズを8に切り替えると： .PP -RAM = $(8 \\cdot 4 \\cdot 10^{12}) \\cdot (1 + 8) / (256 \\cdot 2^{10}) = 1.02 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB .PD 0 .PD .PP ブロックサイズを512に切り替えると： .PP -RAM = $(8 \\cdot 4 \\cdot 10^{12}) \\cdot (1 + 16) / (512 \\cdot 2^{10}) = 0.96 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB .PD 0 .PD .PP ハッシュサイズを8、ブロックサイズを512の両方に切り替えると： .PP -RAM = $(8 \\cdot 4 \\cdot 10^{12}) \\cdot (1 + 8) / (512 \\cdot 2^{10}) = 0.51 \\text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB .PD 0 .PD .SS autosave SIZE_IN_GIGABYTES @@ -1606,7 +1606,7 @@ smartignore parity 197 5 .PD 0 .PD .RE -.SS Examples +.SS 例 (Examples) Unixの一般的な構成の例は次のとおりです。 .PP .RS 4 @@ -1761,7 +1761,7 @@ SnapRAIDは凍結された時点のイメージを参照するため、パリテ .PP スナップショットの作成と削除には管理者権限が必要です。 スナップショットが有効な場合は、SnapRAIDが必要な権限（例：sudo）で実行されていることを確認してください。 -.SS スナップショット使用時のコマンドの挙動 +.SS スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) \`sync\` と \`scrub\` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを 保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。 @@ -1990,7 +1990,7 @@ Unixでは、コマンドラインでグロブ文字を使用する場合、シ 防ぐために引用符で囲む必要があります。 .SH 除外ファイル (IGNORE FILE) 設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに -.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。 +\`.snapraidignore\` ファイルを配置して、分散型の除外ルールを定義できます。 .PP \`.snapraidignore\` で定義されたルールは、設定ファイルのルールの後に 適用されます。これは、それらがより高い優先度を持ち、グローバル設定で @@ -2074,13 +2074,28 @@ Windowsでは、ファイルシステムから読み取られたすべての名 処理されます。 .PP ファイル名を正しく出力するには、\`chcp 65001\` コマンドでWindowsコンソールをUTF\-8モードに設定し、 -コンソールフォントとして \`Lucida Console\` などのTrueTypeフォントを**使用する**必要があります。 +コンソールフォントとして \`Lucida Console\` などのTrueTypeフォントを使用する必要があります。 これは出力されるファイル名にのみ影響します。コンソール出力をファイルにリダイレクトする場合、 結果のファイルは常にUTF\-8形式になります。 +.SH 終了コード (EXIT CODE) +SnapRAIDは以下のエラーコードで終了します： +.RS 0 +.PD 0 +.HP 4 +.I 0 +すべて正常。 +.HP 4 +.I 1 +コマンドでエラーが発生しました。 +.HP 4 +.I 2 +\`diff\` コマンドはすべて正常であると判定しましたが、 \`sync\` が必要です。 +.PD +.RE .SH 翻訳 (TRANSLATION) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 .SH 著作権 (COPYRIGHT) -This file is Copyright (C) 2025 Andrea Mazzoleni +This file is Copyright (C) 2026 Andrea Mazzoleni .SH 関連項目 (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 7a411056..30289db9 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -200,7 +200,7 @@ Name{number} プーリング (Pooling) 注: ここで説明するプーリング機能は、**mergerfs** ツールに取って代わられました。 mergerfs は、SnapRAIDコミュニティのLinuxユーザーに推奨されるオプションです。 - Mergefs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 + Mergerfs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 より柔軟で効率的な方法を提供し、シンボリックリンクに頼ることなくアレイ全体の ファイルにシームレスにアクセスできます。これは、パリティ保護のためにSnapRAIDと うまく統合されており、OpenMediaVault (OMV) やカスタムNAS構成などのセットアップで @@ -815,7 +815,7 @@ Name{number} 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：--bw-limit 1G)。 - -t, --tail サイズ + -t, --tail SIZE ファイルリストを、パリティディスクの指定された末尾サイズ以下を 使用しているものに制限します。 K、M、G、T などの倍数を使用できます（例：--tail 1G）。 @@ -900,7 +900,7 @@ Name{number} お勧めします。 `sync` 操作中にデータ保護はありません。 - -W, --force-realloc-tail サイズ + -W, --force-realloc-tail SIZE -R, --force-realloc と同様に動作しますが、各パリティファイルの 指定された末尾部分（最後の「サイズ」バイト）に制限されます。 現在その末尾セクションに保存されているファイルフラグメント/ブロックの @@ -1172,25 +1172,25 @@ Name{number} 経験則として、SnapRAIDは通常、アレイ内のデータ16 TBごとに1 GiBのRAMを必要とします。 具体的には、データのハッシュを保存するために、SnapRAIDは - 約 $TS \cdot (1 + HS) / BS$ バイトのRAMを必要とします。 + 約 TS*(1+HS)/BS バイトのRAMを必要とします。 ここで、TSはディスクアレイの合計サイズ（バイト）、BSはブロックサイズ（バイト）、HSはハッシュサイズ（バイト）です。 たとえば、4 TBのディスク8台、ブロックサイズ256 KiB（1 KiB = 1024バイト）、 ハッシュサイズ16の場合： - :RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (256 \cdot 2^{10}) = 1.93 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB ハッシュサイズを8に切り替えると： - :RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (256 \cdot 2^{10}) = 1.02 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB ブロックサイズを512に切り替えると： - :RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (512 \cdot 2^{10}) = 0.96 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB ハッシュサイズを8、ブロックサイズを512の両方に切り替えると： - :RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (512 \cdot 2^{10}) = 0.51 \text{ GiB}$ + :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB autosave SIZE_IN_GIGABYTES 処理された指定されたGB量後に、同期またはスクラビング時に状態を自動的に保存します。 @@ -1297,7 +1297,7 @@ Name{number} :smartignore parity 197 5 - Examples + 例 (Examples) Unixの一般的な構成の例は次のとおりです。 :parity /mnt/diskp/snapraid.parity @@ -1364,7 +1364,7 @@ Name{number} スナップショットの作成と削除には管理者権限が必要です。 スナップショットが有効な場合は、SnapRAIDが必要な権限（例：sudo）で実行されていることを確認してください。 - スナップショット使用時のコマンドの挙動 + スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) `sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを 保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。 @@ -1529,7 +1529,7 @@ Name{number} 除外ファイル (Ignore File) 設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに - .snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。 + `.snapraidignore` ファイルを配置して、分散型の除外ルールを定義できます。 `.snapraidignore` で定義されたルールは、設定ファイルのルールの後に 適用されます。これは、それらがより高い優先度を持ち、グローバル設定で @@ -1597,16 +1597,23 @@ Name{number} 処理されます。 ファイル名を正しく出力するには、`chcp 65001` コマンドでWindowsコンソールをUTF-8モードに設定し、 - コンソールフォントとして `Lucida Console` などのTrueTypeフォントを**使用する**必要があります。 + コンソールフォントとして `Lucida Console` などのTrueTypeフォントを使用する必要があります。 これは出力されるファイル名にのみ影響します。コンソール出力をファイルにリダイレクトする場合、 結果のファイルは常にUTF-8形式になります。 +終了コード (Exit Code) + SnapRAIDは以下のエラーコードで終了します： + + 0 - すべて正常。 + 1 - コマンドでエラーが発生しました。 + 2 - `diff` コマンドはすべて正常であると判定しましたが、 `sync` が必要です。 + 翻訳 (Translation) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 著作権 (Copyright) - This file is Copyright (C) 2025 Andrea Mazzoleni + This file is Copyright (C) 2026 Andrea Mazzoleni 関連項目 (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index af61c906..0390845d 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -217,7 +217,7 @@ Ctrl+Cを押すことでいつでも停止でき、次回の実行時には中 注: ここで説明するプーリング機能は、**mergerfs** ツールに取って代わられました。 mergerfs は、SnapRAIDコミュニティのLinuxユーザーに推奨されるオプションです。 -Mergefs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 +Mergerfs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 より柔軟で効率的な方法を提供し、シンボリックリンクに頼ることなくアレイ全体の ファイルにシームレスにアクセスできます。これは、パリティ保護のためにSnapRAIDと うまく統合されており、OpenMediaVault (OMV) やカスタムNAS構成などのセットアップで @@ -876,7 +876,7 @@ SnapRAIDには、次のオプションがあります。 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：--bw-limit 1G)。 - -t, --tail サイズ + -t, --tail SIZE ファイルリストを、パリティディスクの指定された末尾サイズ以下を 使用しているものに制限します。 K、M、G、T などの倍数を使用できます（例：--tail 1G）。 @@ -961,7 +961,7 @@ SnapRAIDには、次のオプションがあります。 お勧めします。 `sync` 操作中にデータ保護はありません。 - -W, --force-realloc-tail サイズ + -W, --force-realloc-tail SIZE -R, --force-realloc と同様に動作しますが、各パリティファイルの 指定された末尾部分（最後の「サイズ」バイト）に制限されます。 現在その末尾セクションに保存されているファイルフラグメント/ブロックの @@ -1258,25 +1258,25 @@ Linuxでより大きなパリティパーティションを取得するトリッ 経験則として、SnapRAIDは通常、アレイ内のデータ16 TBごとに1 GiBのRAMを必要とします。 具体的には、データのハッシュを保存するために、SnapRAIDは -約 $TS \cdot (1 + HS) / BS$ バイトのRAMを必要とします。 +約 TS*(1+HS)/BS バイトのRAMを必要とします。 ここで、TSはディスクアレイの合計サイズ（バイト）、BSはブロックサイズ（バイト）、HSはハッシュサイズ（バイト）です。 たとえば、4 TBのディスク8台、ブロックサイズ256 KiB（1 KiB = 1024バイト）、 ハッシュサイズ16の場合： -RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (256 \cdot 2^{10}) = 1.93 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB ハッシュサイズを8に切り替えると： -RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (256 \cdot 2^{10}) = 1.02 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB ブロックサイズを512に切り替えると： -RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (512 \cdot 2^{10}) = 0.96 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB ハッシュサイズを8、ブロックサイズを512の両方に切り替えると： -RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (512 \cdot 2^{10}) = 0.51 \text{ GiB}$ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB 7.12 autosave SIZE_IN_GIGABYTES ------------------------------- @@ -1397,8 +1397,8 @@ PARITY はパリティ名のいずれかです：`parity`、`2-parity`、`3-pari smartignore parity 197 5 -7.19 Examples -------------- +7.19 例 (Examples) +----------------- Unixの一般的な構成の例は次のとおりです。 @@ -1469,8 +1469,8 @@ Windowsの一般的な構成の例は次のとおりです。 スナップショットの作成と削除には管理者権限が必要です。 スナップショットが有効な場合は、SnapRAIDが必要な権限（例：sudo）で実行されていることを確認してください。 -8.1 スナップショット使用時のコマンドの挙動 ------------------------ +8.1 スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) +--------------------------------------------------------- `sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを 保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 @@ -1645,7 +1645,7 @@ Unixでは、コマンドラインでグロブ文字を使用する場合、シ ======================= 設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに -.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。 +`.snapraidignore` ファイルを配置して、分散型の除外ルールを定義できます。 `.snapraidignore` で定義されたルールは、設定ファイルのルールの後に 適用されます。これは、それらがより高い優先度を持ち、グローバル設定で @@ -1722,25 +1722,35 @@ Windowsでは、ファイルシステムから読み取られたすべての名 処理されます。 ファイル名を正しく出力するには、`chcp 65001` コマンドでWindowsコンソールをUTF-8モードに設定し、 -コンソールフォントとして `Lucida Console` などのTrueTypeフォントを**使用する**必要があります。 +コンソールフォントとして `Lucida Console` などのTrueTypeフォントを使用する必要があります。 これは出力されるファイル名にのみ影響します。コンソール出力をファイルにリダイレクトする場合、 結果のファイルは常にUTF-8形式になります。 -15 翻訳 (TRANSLATION) +15 終了コード (EXIT CODE) +==================== + +SnapRAIDは以下のエラーコードで終了します： + +0 - すべて正常。 +1 - コマンドでエラーが発生しました。 +2 - `diff` コマンドはすべて正常であると判定しましたが、 `sync` が必要です。 + + +16 翻訳 (TRANSLATION) =================== この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 -16 著作権 (COPYRIGHT) +17 著作権 (COPYRIGHT) ================== -This file is Copyright (C) 2025 Andrea Mazzoleni +This file is Copyright (C) 2026 Andrea Mazzoleni -17 関連項目 (SEE ALSO) +18 関連項目 (SEE ALSO) ================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index cf91323c..56425914 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -89,7 +89,7 @@ SnapRAID는 디스크 어레이를 위해 설계된 백업 프로그램으로, 파일을 다시 포맷할 필요 없이 이미 파일로 채워진 디스크를 활용할 수 있으며, 평소처럼 액세스할 수 있습니다. .IP \(bu -데이터 무결성을 보장하고 무단 손상을 방지하기 위해 모든 데이터가 +데이터 무결성을 보장하고 조용한 데이터 손상을 방지하기 위해 모든 데이터가 해시됩니다. .IP \(bu 실패한 디스크의 수가 패리티 수를 초과하는 경우, 데이터 손실은 @@ -139,7 +139,7 @@ SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 .IP \(bu 스냅샷 지원이 없는 경우: \`sync\` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수 -있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과 +있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 패리티가 수정된 파일과 더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다. .PD @@ -303,7 +303,7 @@ snapraid sync Ctrl+C를 눌러 언제든지 중지할 수 있으며, 다음 실행 시 중단된 곳에서 재개됩니다. .PP -이 명령이 완료되면 데이터는 **SAFE**합니다. +이 명령이 완료되면 데이터는 안전합니다. .PP 이제 어레이를 원하는 대로 사용하고 주기적으로 \`sync\` 명령을 실행하여 패리티 정보를 업데이트할 수 있습니다. @@ -333,7 +333,7 @@ snapraid \-p 5 \-o 20 scrub .PD .RE .PP -이 프로세스 중에 무단 또는 입출력 오류가 발견되면, 해당 블록은 +이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 \`content\` 파일에 bad로 표시되며 \`status\` 명령에 나열됩니다. .PP .RS 4 @@ -551,7 +551,7 @@ snapraid fix \-m .SS 복구 (Recovering) 최악의 상황이 발생하여 하나 이상의 디스크를 잃었습니다! .PP -**패닉하지 마십시오!** 복구할 수 있습니다! +**당황하지 마십시오!** 복구할 수 있습니다! .PP 가장 먼저 해야 할 일은 디스크 어레이에 대한 추가 변경을 피하는 것입니다. 모든 원격 연결과 SnapRAID 야간 동기화 또는 스크럽을 포함한 모든 예약된 @@ -669,7 +669,7 @@ SnapRAID는 다음과 같은 작업을 수행할 수 있는 몇 가지 간단한 디스크 어레이의 상태 요약을 출력합니다. .PP 패리티 단편화, 확인 없이 블록이 얼마나 오래되었는지, 그리고 -스크럽 중에 발생한 모든 기록된 무단 오류에 대한 정보를 포함합니다. +스크럽 중에 발생한 모든 기록된 조용한 오류에 대한 정보를 포함합니다. .PP 제시된 정보는 마지막으로 \`sync\`를 실행했을 때를 나타냅니다. 나중에 수정된 내용은 고려되지 않습니다. @@ -827,7 +827,7 @@ inode는 다르지만 디렉토리, 이름, 크기 및 타임스탬 중지할 수 있습니다. 다음 실행 시 \`sync\` 프로세스는 중단된 곳에서 재개됩니다. .PP -이 프로세스 중에 무단 또는 입출력 오류가 발견되면, +이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 bad로 표시됩니다. .PP 파일은 경로 및/또는 아이노드로 식별되며 크기와 타임스탬프로 @@ -842,7 +842,7 @@ inode는 다르지만 디렉토리, 이름, 크기 및 타임스탬 \`content\` 및 \`parity\` 파일은 필요한 경우 수정됩니다. 어레이의 파일은 수정되지 않습니다. .SS scrub -어레이를 스크럽하여 데이터 및 패리티 디스크의 무단 또는 입출력 오류를 +어레이를 스크럽하여 데이터 및 패리티 디스크의 조용한 오류 또는 입출력 오류를 확인합니다. .PP 각 호출은 이전에 10일 이내에 스크럽된 데이터를 제외하고 어레이의 @@ -865,7 +865,7 @@ full \- 모든 것 스크럽. .PP 스크럽 상태의 세부 정보를 얻으려면 \`status\` 명령을 사용하십시오. .PP -발견된 모든 무단 또는 입출력 오류에 대해, 해당 블록은 \`content\` 파일에 +발견된 모든 조용한 오류 또는 입출력 오류에 대해, 해당 블록은 \`content\` 파일에 bad로 표시됩니다. 이러한 bad 블록은 \`status\`에 나열되며 \`fix \-e\`로 수정할 수 있습니다. 수정 후, 다음 스크럽 시에 다시 확인되며, 수정된 것으로 발견되면 bad @@ -873,7 +873,7 @@ bad로 표시됩니다. bad 블록만 스크럽하려면 \`scrub \-p bad\` 명령을 사용할 수 있습니다. .PP 동기화되지 않은 데이터로 인한 보고된 오류를 피하기 위해 동기화된 -어레이에서만 \`scrub\`을 실행하는 것이 좋습니다. 이러한 오류는 무단 +어레이에서만 \`scrub\`을 실행하는 것이 좋습니다. 이러한 오류는 조용한 오류가 아닌 것으로 인식되며, 블록은 bad로 표시되지 않지만, 이러한 오류는 명령의 출력에 보고됩니다. .PP @@ -882,9 +882,9 @@ bad 블록만 스크럽하려면 \`scrub \-p bad\` 명령을 사용할 수 있 \`parity\` 파일은 수정되지 않습니다. 어레이의 파일은 수정되지 않습니다. .SS fix -모든 파일과 파리티 데이터를 복구(수정)합니다. +모든 파일과 패리티 데이터를 복구(수정)합니다. .PP -모든 파일과 파리티 데이터는 마지막 \`sync\`에 저장된 상태와 비교됩니다. +모든 파일과 패리티 데이터는 마지막 \`sync\`에 저장된 상태와 비교됩니다. 차이점이 발견되면 저장된 상태로 되돌립니다. .PP 경고! @@ -1051,7 +1051,7 @@ Unix에서는 글로빙 문자가 사용되는 경우 따옴표로 묶어야 합 .TP .B \-e, \-\-filter\-error \`check\` 및 \`fix\`에서 오류가 있는 파일을 처리합니다. -\`status\`에 나열된 대로 \`sync\` 및 \`scrub\` 중에 무단 또는 입출력 오류가 +\`status\`에 나열된 대로 \`sync\` 및 \`scrub\` 중에 조용한 오류 또는 입출력 오류가 표시된 블록을 가진 파일만 처리합니다. 이 옵션은 \`check\` 및 \`fix\`에서만 사용할 수 있습니다. .TP @@ -1065,7 +1065,7 @@ Unix에서는 글로빙 문자가 사용되는 경우 따옴표로 묶어야 합 .TP .B \-o, \-\-older\-than DAYS \`scrub\`에서 처리할 어레이의 가장 오래된 부분을 선택합니다. -DAYS는 블록이 스크럽되어야 하는 최소 일령(days)이며, +DAYS는 블록이 스크럽되어야 하는 최소 경과 일수(days)이며, 기본값은 10입니다. bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 이 옵션은 \`scrub\`에서만 사용할 수 있습니다. @@ -1085,7 +1085,7 @@ bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 이 프로세스는 모든 디스크가 회전하고 CPU가 바쁜, 시스템이 과부하 상태일 때 발생합니다. 이는 기계의 극한 조건이며, 잠재된 하드웨어 문제가 있는 경우 -데이터가 아직 해시되지 않았기 때문에 무단 오류가 감지되지 않고 +데이터가 아직 해시되지 않았기 때문에 조용한 오류가 감지되지 않고 지나갈 수 있습니다. 이러한 위험을 피하려면, \`pre\-hash\` 모드를 활성화하여 모든 데이터를 두 번 읽어 무결성을 보장할 수 있습니다. @@ -1115,7 +1115,7 @@ bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: \-\-bw\-limit 1G)를 지정할 수 있습니다. .TP -.B \-t, \-\-tail 크기 +.B \-t, \-\-tail SIZE 패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 목록을 제한합니다. K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: \-\-tail 1G). @@ -1187,7 +1187,7 @@ SnapRAID가 일부 디스크의 UUID가 변경되었음을 감지하면, 동일한 속성을 가진 파일이 동일한 데이터를 가진 복사본이라고 가정합니다. 이는 한 디스크에서 다른 디스크로 복사되거나 이동된 파일을 -식별하고, 이미 계산된 해시 정보를 재사용하여 무단 오류를 +식별하고, 이미 계산된 해시 정보를 재사용하여 조용한 오류를 감지하거나 누락된 파일을 복구할 수 있도록 합니다. 일부 드문 경우에 이 동작은 오탐(false positives) 또는 많은 해시 확인으로 인한 느린 프로세스를 초래할 수 있으며, 이 옵션을 @@ -1214,7 +1214,7 @@ content 파일에 있는 해시를 재사용하여 데이터를 검증하고 강력히 권장됩니다. \`sync\` 작업 중에는 데이터 보호가 없습니다. .TP -.B \-W, \-\-force\-realloc\-tail 크기 +.B \-W, \-\-force\-realloc\-tail SIZE \-R, \-\-force\-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 꼬리 부분(마지막 \'크기\' 바이트)으로 제한됩니다. 현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 @@ -1309,8 +1309,8 @@ Windows에서는 \`snapraid.exe\`와 같은 디렉토리에 있는 여러 파일을 지정할 수 있으며, 이들은 서로 다른 디스크에 있어야 합니다. 하나의 파일이 더 이상 커질 수 없을 때 다음 파일이 사용됩니다. -총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크보다 -적어도 커야 합니다. +총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크의 크기 +이상이어야 합니다. .PP 나중에 추가 패리티 파일을 추가할 수 있지만, 순서를 바꾸거나 제거할 수는 없습니다. @@ -1406,13 +1406,13 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점 이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 오류를 방지합니다. .PP -이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 -스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 \[dq]깨지는\[dq] 것을 방지하여, +이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 +스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 \[dq]깨지는\[dq] 것을 방지하여, 다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다. .PP 이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된 데이터 디스크에만 독점적으로 적용됩니다. -파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 +패리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 라이브 버전을 사용합니다. .PP 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. @@ -1541,11 +1541,11 @@ SnapRAID가 작동하는 동안 현재 디스크 온도가 표시됩니다. 다시 일시 중지될 수 있습니다. .PP 작동 중에 SnapRAID는 각 디스크의 가열 곡선을 분석하고 활동이 계속되면 -도달할 것으로 예상되는 장기 정상 온도를 추정합니다. +도달할 것으로 예상되는 장기 평형 온도를 추정합니다. 추정은 디스크 온도가 네 번 증가한 후에만 수행되어, 신뢰할 수 있는 추세를 설정하기에 충분한 데이터 포인트가 확보되도록 합니다. -이 예측된 정상 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 -냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 온도는 정보 제공 +이 예측된 평형 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 +냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 평형 온도는 정보 제공 목적일 뿐이며 SnapRAID의 동작에는 영향을 미치지 않습니다. 프로그램의 동작은 오로지 실제 측정된 디스크 온도에 기반합니다. .PP @@ -1773,7 +1773,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .HP 4 .I 일관성 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 -SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을 +SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 유발하지 않습니다. .HP 4 .I 복구 @@ -1785,8 +1785,8 @@ SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일 .RS 4 .PD 0 활성 sync 프로세스 중에 디스크 고장이 발생하는 경우, -SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. -이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데 +SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. +이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 패리티 방정식을 푸는 데 필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다. .PD .PP @@ -1798,7 +1798,7 @@ SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에 .RE .PP 스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만 -생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다. +생성됩니다. 패리티 디스크는 항상 라이브 파일시스템을 사용합니다. .PP 현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다. .PP @@ -1807,13 +1807,13 @@ SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에 .PP 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. 스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오. -.SS 스냅샷 사용 시 명령어 동작 +.SS 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) \`sync\` 와 \`scrub\` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 -라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다. -\`sync\` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한 +라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. +\`sync\` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 현재 상태를 캡처합니다. -반면에 \`scrub\` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 +반면에 \`scrub\` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. .PP \`check\` 및 \`fix\` 명령어의 경우, 마지막 스냅샷의 사용 여부는 @@ -1825,7 +1825,7 @@ SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에 .PP 다른 모든 데이터 디스크(\[dq]참조\[dq] 디스크)는 해당 스냅샷을 통해 액세스됩니다. 이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가 -파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. +패리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. .TP .B \-d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우 \`check\` 와 \`fix\` 는 라이브 파일시스템만을 독점적으로 사용합니다. @@ -1838,16 +1838,16 @@ Btrfs, Bcachefs 및 NTFS에서는 \`.snapraid/\` 디렉터리가 사용되며, ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. .PP \`stable\` 스냅샷은 성공적으로 완료된 마지막 \`sync\` 상태를 나타내며, -현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 +현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 \`scrub\`, \`check\` 및 \`fix\` 명령어의 기본 데이터 소스 역할을 합니다. .PP -\`pending\` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 +\`pending\` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 생성되는 임시 이미지입니다. 작업이 성공적으로 완료되면 이전의 \`stable\` 스냅샷은 삭제되고, \`pending\` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. .PP \`sync\` 가 중단되면 \`pending\` 스냅샷은 보존됩니다. -파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 +패리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 이후의 \`scrub\`, \`check\` 및 \`fix\` 명령어는 이 보류 중인 스냅샷을 사용합니다. .PP \`sync\` 가 중단된 경우, \`check\` 및 \`fix\` 명령어는 \`stable\` 스냅샷에서도 읽어와 @@ -2125,10 +2125,25 @@ Windows 콘솔을 UTF\-8 모드로 설정하고 콘솔 글꼴로 \`Lucida Consol 같은 TrueType 글꼴을 사용해야 합니다. 이는 출력되는 파일 이름에만 영향을 미치며, 콘솔 출력을 파일로 리디렉션하는 경우 결과 파일은 항상 UTF\-8 형식입니다. +.SH 종료 코드 (EXIT CODE) +SnapRAID는 다음과 같은 오류 코드로 종료됩니다: +.RS 0 +.PD 0 +.HP 4 +.I 0 +모두 정상. +.HP 4 +.I 1 +명령 실행 중 오류가 발생했습니다. +.HP 4 +.I 2 +\`diff\` 명령으로 모두 정상임을 확인했으나 \`sync\`가 필요합니다. +.PD +.RE .SH 번역 (TRANSLATION) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. .SH 저작권 (COPYRIGHT) -This file is Copyright (C) 2025 Andrea Mazzoleni +This file is Copyright (C) 2026 Andrea Mazzoleni .SH 참고 (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index f5153988..21e5ab25 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -33,7 +33,7 @@ Name{number} * 파일을 다시 포맷할 필요 없이 이미 파일로 채워진 디스크를 활용할 수 있으며, 평소처럼 액세스할 수 있습니다. - * 데이터 무결성을 보장하고 무단 손상을 방지하기 위해 모든 데이터가 + * 데이터 무결성을 보장하고 조용한 데이터 손상을 방지하기 위해 모든 데이터가 해시됩니다. * 실패한 디스크의 수가 패리티 수를 초과하는 경우, 데이터 손실은 영향을 받은 디스크로 제한되며, 다른 디스크의 데이터는 @@ -70,7 +70,7 @@ Name{number} * 스냅샷 지원이 없는 경우: `sync` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수 - 있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과 + 있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 패리티가 수정된 파일과 더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다. @@ -163,7 +163,7 @@ Name{number} Ctrl+C를 눌러 언제든지 중지할 수 있으며, 다음 실행 시 중단된 곳에서 재개됩니다. - 이 명령이 완료되면 데이터는 **SAFE**합니다. + 이 명령이 완료되면 데이터는 안전합니다. 이제 어레이를 원하는 대로 사용하고 주기적으로 `sync` 명령을 실행하여 패리티 정보를 업데이트할 수 있습니다. @@ -186,7 +186,7 @@ Name{number} :snapraid -p 5 -o 20 scrub - 이 프로세스 중에 무단 또는 입출력 오류가 발견되면, 해당 블록은 + 이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 `content` 파일에 bad로 표시되며 `status` 명령에 나열됩니다. :snapraid status @@ -302,7 +302,7 @@ Name{number} 복구 (Recovering) 최악의 상황이 발생하여 하나 이상의 디스크를 잃었습니다! - **패닉하지 마십시오!** 복구할 수 있습니다! + **당황하지 마십시오!** 복구할 수 있습니다! 가장 먼저 해야 할 일은 디스크 어레이에 대한 추가 변경을 피하는 것입니다. 모든 원격 연결과 SnapRAID 야간 동기화 또는 스크럽을 포함한 모든 예약된 @@ -400,7 +400,7 @@ Name{number} 디스크 어레이의 상태 요약을 출력합니다. 패리티 단편화, 확인 없이 블록이 얼마나 오래되었는지, 그리고 - 스크럽 중에 발생한 모든 기록된 무단 오류에 대한 정보를 포함합니다. + 스크럽 중에 발생한 모든 기록된 조용한 오류에 대한 정보를 포함합니다. 제시된 정보는 마지막으로 `sync`를 실행했을 때를 나타냅니다. 나중에 수정된 내용은 고려되지 않습니다. @@ -530,7 +530,7 @@ Name{number} 중지할 수 있습니다. 다음 실행 시 `sync` 프로세스는 중단된 곳에서 재개됩니다. - 이 프로세스 중에 무단 또는 입출력 오류가 발견되면, + 이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 bad로 표시됩니다. 파일은 경로 및/또는 아이노드로 식별되며 크기와 타임스탬프로 @@ -546,7 +546,7 @@ Name{number} 어레이의 파일은 수정되지 않습니다. scrub - 어레이를 스크럽하여 데이터 및 패리티 디스크의 무단 또는 입출력 오류를 + 어레이를 스크럽하여 데이터 및 패리티 디스크의 조용한 오류 또는 입출력 오류를 확인합니다. 각 호출은 이전에 10일 이내에 스크럽된 데이터를 제외하고 어레이의 @@ -569,7 +569,7 @@ Name{number} 스크럽 상태의 세부 정보를 얻으려면 `status` 명령을 사용하십시오. - 발견된 모든 무단 또는 입출력 오류에 대해, 해당 블록은 `content` 파일에 + 발견된 모든 조용한 오류 또는 입출력 오류에 대해, 해당 블록은 `content` 파일에 bad로 표시됩니다. 이러한 bad 블록은 `status`에 나열되며 `fix -e`로 수정할 수 있습니다. 수정 후, 다음 스크럽 시에 다시 확인되며, 수정된 것으로 발견되면 bad @@ -577,7 +577,7 @@ Name{number} bad 블록만 스크럽하려면 `scrub -p bad` 명령을 사용할 수 있습니다. 동기화되지 않은 데이터로 인한 보고된 오류를 피하기 위해 동기화된 - 어레이에서만 `scrub`을 실행하는 것이 좋습니다. 이러한 오류는 무단 + 어레이에서만 `scrub`을 실행하는 것이 좋습니다. 이러한 오류는 조용한 오류가 아닌 것으로 인식되며, 블록은 bad로 표시되지 않지만, 이러한 오류는 명령의 출력에 보고됩니다. @@ -587,9 +587,9 @@ Name{number} 어레이의 파일은 수정되지 않습니다. fix - 모든 파일과 파리티 데이터를 복구(수정)합니다. + 모든 파일과 패리티 데이터를 복구(수정)합니다. - 모든 파일과 파리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다. + 모든 파일과 패리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다. 차이점이 발견되면 저장된 상태로 되돌립니다. 경고! @@ -765,7 +765,7 @@ Name{number} -e, --filter-error `check` 및 `fix`에서 오류가 있는 파일을 처리합니다. - `status`에 나열된 대로 `sync` 및 `scrub` 중에 무단 또는 입출력 오류가 + `status`에 나열된 대로 `sync` 및 `scrub` 중에 조용한 오류 또는 입출력 오류가 표시된 블록을 가진 파일만 처리합니다. 이 옵션은 `check` 및 `fix`에서만 사용할 수 있습니다. @@ -779,7 +779,7 @@ Name{number} -o, --older-than DAYS `scrub`에서 처리할 어레이의 가장 오래된 부분을 선택합니다. - DAYS는 블록이 스크럽되어야 하는 최소 일령(days)이며, + DAYS는 블록이 스크럽되어야 하는 최소 경과 일수(days)이며, 기본값은 10입니다. bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 이 옵션은 `scrub`에서만 사용할 수 있습니다. @@ -799,7 +799,7 @@ Name{number} 이 프로세스는 모든 디스크가 회전하고 CPU가 바쁜, 시스템이 과부하 상태일 때 발생합니다. 이는 기계의 극한 조건이며, 잠재된 하드웨어 문제가 있는 경우 - 데이터가 아직 해시되지 않았기 때문에 무단 오류가 감지되지 않고 + 데이터가 아직 해시되지 않았기 때문에 조용한 오류가 감지되지 않고 지나갈 수 있습니다. 이러한 위험을 피하려면, `pre-hash` 모드를 활성화하여 모든 데이터를 두 번 읽어 무결성을 보장할 수 있습니다. @@ -829,7 +829,7 @@ Name{number} 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: --bw-limit 1G)를 지정할 수 있습니다. - -t, --tail 크기 + -t, --tail SIZE 패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 목록을 제한합니다. K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: --tail 1G). @@ -901,7 +901,7 @@ Name{number} 동일한 속성을 가진 파일이 동일한 데이터를 가진 복사본이라고 가정합니다. 이는 한 디스크에서 다른 디스크로 복사되거나 이동된 파일을 - 식별하고, 이미 계산된 해시 정보를 재사용하여 무단 오류를 + 식별하고, 이미 계산된 해시 정보를 재사용하여 조용한 오류를 감지하거나 누락된 파일을 복구할 수 있도록 합니다. 일부 드문 경우에 이 동작은 오탐(false positives) 또는 많은 해시 확인으로 인한 느린 프로세스를 초래할 수 있으며, 이 옵션을 @@ -928,7 +928,7 @@ Name{number} 강력히 권장됩니다. `sync` 작업 중에는 데이터 보호가 없습니다. - -W, --force-realloc-tail 크기 + -W, --force-realloc-tail SIZE -R, --force-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 꼬리 부분(마지막 '크기' 바이트)으로 제한됩니다. 현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 @@ -1025,8 +1025,8 @@ Name{number} 여러 파일을 지정할 수 있으며, 이들은 서로 다른 디스크에 있어야 합니다. 하나의 파일이 더 이상 커질 수 없을 때 다음 파일이 사용됩니다. - 총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크보다 - 적어도 커야 합니다. + 총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크의 크기 + 이상이어야 합니다. 나중에 추가 패리티 파일을 추가할 수 있지만, 순서를 바꾸거나 제거할 수는 없습니다. @@ -1122,13 +1122,13 @@ Name{number} 이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 오류를 방지합니다. - 이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 - 스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 "깨지는" 것을 방지하여, + 이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 + 스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 "깨지는" 것을 방지하여, 다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다. 이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된 데이터 디스크에만 독점적으로 적용됩니다. - 파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 + 패리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 라이브 버전을 사용합니다. 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. @@ -1251,11 +1251,11 @@ Name{number} 다시 일시 중지될 수 있습니다. 작동 중에 SnapRAID는 각 디스크의 가열 곡선을 분석하고 활동이 계속되면 - 도달할 것으로 예상되는 장기 정상 온도를 추정합니다. + 도달할 것으로 예상되는 장기 평형 온도를 추정합니다. 추정은 디스크 온도가 네 번 증가한 후에만 수행되어, 신뢰할 수 있는 추세를 설정하기에 충분한 데이터 포인트가 확보되도록 합니다. - 이 예측된 정상 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 - 냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 온도는 정보 제공 + 이 예측된 평형 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 + 냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 평형 온도는 정보 제공 목적일 뿐이며 SnapRAID의 동작에는 영향을 미치지 않습니다. 프로그램의 동작은 오로지 실제 측정된 디스크 온도에 기반합니다. @@ -1385,22 +1385,22 @@ Name{number} 이것은 두 가지 주요 이점을 제공합니다. 일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 - SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을 + SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 유발하지 않습니다. 복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다. 다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된 데이터를 사용하여 고장 난 디스크를 재구성합니다. 활성 sync 프로세스 중에 디스크 고장이 발생하는 경우, - SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. - 이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데 + SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. + 이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 패리티 방정식을 푸는 데 필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다. 스냅샷이 없으면 정상 디스크에서 업데이트되거나 삭제된 파일로 인해 데이터 블록이 누락되며, 이는 다른 고장 난 디스크를 복구하는 데 필요할 수 있습니다. 스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만 - 생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다. + 생성됩니다. 패리티 디스크는 항상 라이브 파일시스템을 사용합니다. 현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다. @@ -1410,13 +1410,13 @@ Name{number} 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. 스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오. - 스냅샷 사용 시 명령어 동작 + 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) `sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 - 라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다. - `sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한 + 라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. + `sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 현재 상태를 캡처합니다. - 반면에 `scrub` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 + 반면에 `scrub` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. `check` 및 `fix` 명령어의 경우, 마지막 스냅샷의 사용 여부는 @@ -1428,7 +1428,7 @@ Name{number} 다른 모든 데이터 디스크("참조" 디스크)는 해당 스냅샷을 통해 액세스됩니다. 이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가 - 파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. + 패리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. -d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우 `check` 와 `fix` 는 라이브 파일시스템만을 독점적으로 사용합니다. @@ -1442,16 +1442,16 @@ Name{number} ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. `stable` 스냅샷은 성공적으로 완료된 마지막 `sync` 상태를 나타내며, - 현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 + 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. - `pending` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 + `pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. `sync` 가 중단되면 `pending` 스냅샷은 보존됩니다. - 파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 + 패리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 이후의 `scrub`, `check` 및 `fix` 명령어는 이 보류 중인 스냅샷을 사용합니다. `sync` 가 중단된 경우, `check` 및 `fix` 명령어는 `stable` 스냅샷에서도 읽어와 @@ -1649,12 +1649,19 @@ Name{number} 이는 출력되는 파일 이름에만 영향을 미치며, 콘솔 출력을 파일로 리디렉션하는 경우 결과 파일은 항상 UTF-8 형식입니다. +종료 코드 (Exit Code) + SnapRAID는 다음과 같은 오류 코드로 종료됩니다: + + 0 - 모두 정상. + 1 - 명령 실행 중 오류가 발생했습니다. + 2 - `diff` 명령으로 모두 정상임을 확인했으나 `sync`가 필요합니다. + 번역 (Translation) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. 저작권 (Copyright) - This file is Copyright (C) 2025 Andrea Mazzoleni + This file is Copyright (C) 2026 Andrea Mazzoleni 참고 (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index 08d23066..81c375b6 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -40,7 +40,7 @@ SnapRAID는 디스크 어레이를 위해 설계된 백업 프로그램으로, * 파일을 다시 포맷할 필요 없이 이미 파일로 채워진 디스크를 활용할 수 있으며, 평소처럼 액세스할 수 있습니다. -* 데이터 무결성을 보장하고 무단 손상을 방지하기 위해 모든 데이터가 +* 데이터 무결성을 보장하고 조용한 데이터 손상을 방지하기 위해 모든 데이터가 해시됩니다. * 실패한 디스크의 수가 패리티 수를 초과하는 경우, 데이터 손실은 영향을 받은 디스크로 제한되며, 다른 디스크의 데이터는 @@ -80,7 +80,7 @@ SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장 * 스냅샷 지원이 없는 경우: `sync` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수 - 있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과 + 있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 패리티가 수정된 파일과 더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다. @@ -176,7 +176,7 @@ Windows 경로 형식을 사용해야 합니다. Ctrl+C를 눌러 언제든지 중지할 수 있으며, 다음 실행 시 중단된 곳에서 재개됩니다. -이 명령이 완료되면 데이터는 **SAFE**합니다. +이 명령이 완료되면 데이터는 안전합니다. 이제 어레이를 원하는 대로 사용하고 주기적으로 `sync` 명령을 실행하여 패리티 정보를 업데이트할 수 있습니다. @@ -201,7 +201,7 @@ Ctrl+C를 눌러 언제든지 중지할 수 있으며, 다음 실행 시 중단 snapraid -p 5 -o 20 scrub -이 프로세스 중에 무단 또는 입출력 오류가 발견되면, 해당 블록은 +이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 `content` 파일에 bad로 표시되며 `status` 명령에 나열됩니다. snapraid status @@ -323,7 +323,7 @@ SnapRAID는 RAID 시스템보다는 백업 프로그램처럼 작동하며, 최악의 상황이 발생하여 하나 이상의 디스크를 잃었습니다! -**패닉하지 마십시오!** 복구할 수 있습니다! +**당황하지 마십시오!** 복구할 수 있습니다! 가장 먼저 해야 할 일은 디스크 어레이에 대한 추가 변경을 피하는 것입니다. 모든 원격 연결과 SnapRAID 야간 동기화 또는 스크럽을 포함한 모든 예약된 @@ -426,7 +426,7 @@ SnapRAID는 다음과 같은 작업을 수행할 수 있는 몇 가지 간단한 디스크 어레이의 상태 요약을 출력합니다. 패리티 단편화, 확인 없이 블록이 얼마나 오래되었는지, 그리고 -스크럽 중에 발생한 모든 기록된 무단 오류에 대한 정보를 포함합니다. +스크럽 중에 발생한 모든 기록된 조용한 오류에 대한 정보를 포함합니다. 제시된 정보는 마지막으로 `sync`를 실행했을 때를 나타냅니다. 나중에 수정된 내용은 고려되지 않습니다. @@ -568,7 +568,7 @@ SMART가 디스크가 실패하고 있다고 보고하면, 해당 디스크에 중지할 수 있습니다. 다음 실행 시 `sync` 프로세스는 중단된 곳에서 재개됩니다. -이 프로세스 중에 무단 또는 입출력 오류가 발견되면, +이 프로세스 중에 조용한 오류 또는 입출력 오류가 발견되면, 해당 블록은 bad로 표시됩니다. 파일은 경로 및/또는 아이노드로 식별되며 크기와 타임스탬프로 @@ -586,7 +586,7 @@ SMART가 디스크가 실패하고 있다고 보고하면, 해당 디스크에 5.8 scrub --------- -어레이를 스크럽하여 데이터 및 패리티 디스크의 무단 또는 입출력 오류를 +어레이를 스크럽하여 데이터 및 패리티 디스크의 조용한 오류 또는 입출력 오류를 확인합니다. 각 호출은 이전에 10일 이내에 스크럽된 데이터를 제외하고 어레이의 @@ -609,7 +609,7 @@ full - 모든 것 스크럽. 스크럽 상태의 세부 정보를 얻으려면 `status` 명령을 사용하십시오. -발견된 모든 무단 또는 입출력 오류에 대해, 해당 블록은 `content` 파일에 +발견된 모든 조용한 오류 또는 입출력 오류에 대해, 해당 블록은 `content` 파일에 bad로 표시됩니다. 이러한 bad 블록은 `status`에 나열되며 `fix -e`로 수정할 수 있습니다. 수정 후, 다음 스크럽 시에 다시 확인되며, 수정된 것으로 발견되면 bad @@ -617,7 +617,7 @@ bad로 표시됩니다. bad 블록만 스크럽하려면 `scrub -p bad` 명령을 사용할 수 있습니다. 동기화되지 않은 데이터로 인한 보고된 오류를 피하기 위해 동기화된 -어레이에서만 `scrub`을 실행하는 것이 좋습니다. 이러한 오류는 무단 +어레이에서만 `scrub`을 실행하는 것이 좋습니다. 이러한 오류는 조용한 오류가 아닌 것으로 인식되며, 블록은 bad로 표시되지 않지만, 이러한 오류는 명령의 출력에 보고됩니다. @@ -629,9 +629,9 @@ bad 블록만 스크럽하려면 `scrub -p bad` 명령을 사용할 수 있습 5.9 fix ------- -모든 파일과 파리티 데이터를 복구(수정)합니다. +모든 파일과 패리티 데이터를 복구(수정)합니다. -모든 파일과 파리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다. +모든 파일과 패리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다. 차이점이 발견되면 저장된 상태로 되돌립니다. 경고! @@ -826,7 +826,7 @@ SnapRAID는 다음 옵션을 제공합니다: -e, --filter-error `check` 및 `fix`에서 오류가 있는 파일을 처리합니다. - `status`에 나열된 대로 `sync` 및 `scrub` 중에 무단 또는 입출력 오류가 + `status`에 나열된 대로 `sync` 및 `scrub` 중에 조용한 오류 또는 입출력 오류가 표시된 블록을 가진 파일만 처리합니다. 이 옵션은 `check` 및 `fix`에서만 사용할 수 있습니다. @@ -840,7 +840,7 @@ SnapRAID는 다음 옵션을 제공합니다: -o, --older-than DAYS `scrub`에서 처리할 어레이의 가장 오래된 부분을 선택합니다. - DAYS는 블록이 스크럽되어야 하는 최소 일령(days)이며, + DAYS는 블록이 스크럽되어야 하는 최소 경과 일수(days)이며, 기본값은 10입니다. bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 이 옵션은 `scrub`에서만 사용할 수 있습니다. @@ -860,7 +860,7 @@ SnapRAID는 다음 옵션을 제공합니다: 이 프로세스는 모든 디스크가 회전하고 CPU가 바쁜, 시스템이 과부하 상태일 때 발생합니다. 이는 기계의 극한 조건이며, 잠재된 하드웨어 문제가 있는 경우 - 데이터가 아직 해시되지 않았기 때문에 무단 오류가 감지되지 않고 + 데이터가 아직 해시되지 않았기 때문에 조용한 오류가 감지되지 않고 지나갈 수 있습니다. 이러한 위험을 피하려면, `pre-hash` 모드를 활성화하여 모든 데이터를 두 번 읽어 무결성을 보장할 수 있습니다. @@ -890,7 +890,7 @@ SnapRAID는 다음 옵션을 제공합니다: 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: --bw-limit 1G)를 지정할 수 있습니다. - -t, --tail 크기 + -t, --tail SIZE 패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 목록을 제한합니다. K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: --tail 1G). @@ -962,7 +962,7 @@ SnapRAID는 다음 옵션을 제공합니다: 동일한 속성을 가진 파일이 동일한 데이터를 가진 복사본이라고 가정합니다. 이는 한 디스크에서 다른 디스크로 복사되거나 이동된 파일을 - 식별하고, 이미 계산된 해시 정보를 재사용하여 무단 오류를 + 식별하고, 이미 계산된 해시 정보를 재사용하여 조용한 오류를 감지하거나 누락된 파일을 복구할 수 있도록 합니다. 일부 드문 경우에 이 동작은 오탐(false positives) 또는 많은 해시 확인으로 인한 느린 프로세스를 초래할 수 있으며, 이 옵션을 @@ -989,7 +989,7 @@ SnapRAID는 다음 옵션을 제공합니다: 강력히 권장됩니다. `sync` 작업 중에는 데이터 보호가 없습니다. - -W, --force-realloc-tail 크기 + -W, --force-realloc-tail SIZE -R, --force-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 꼬리 부분(마지막 '크기' 바이트)으로 제한됩니다. 현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 @@ -1091,8 +1091,8 @@ Windows에서는 `snapraid.exe`와 같은 디렉토리에 있는 여러 파일을 지정할 수 있으며, 이들은 서로 다른 디스크에 있어야 합니다. 하나의 파일이 더 이상 커질 수 없을 때 다음 파일이 사용됩니다. -총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크보다 -적어도 커야 합니다. +총 사용 가능한 공간은 어레이에서 가장 큰 데이터 디스크의 크기 +이상이어야 합니다. 나중에 추가 패리티 파일을 추가할 수 있지만, 순서를 바꾸거나 제거할 수는 없습니다. @@ -1200,13 +1200,13 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점 이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 오류를 방지합니다. -이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 -스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 "깨지는" 것을 방지하여, +이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 +스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 "깨지는" 것을 방지하여, 다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다. 이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된 데이터 디스크에만 독점적으로 적용됩니다. -파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 +패리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의 라이브 버전을 사용합니다. 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. @@ -1341,11 +1341,11 @@ SnapRAID가 작동하는 동안 현재 디스크 온도가 표시됩니다. 다시 일시 중지될 수 있습니다. 작동 중에 SnapRAID는 각 디스크의 가열 곡선을 분석하고 활동이 계속되면 -도달할 것으로 예상되는 장기 정상 온도를 추정합니다. +도달할 것으로 예상되는 장기 평형 온도를 추정합니다. 추정은 디스크 온도가 네 번 증가한 후에만 수행되어, 신뢰할 수 있는 추세를 설정하기에 충분한 데이터 포인트가 확보되도록 합니다. -이 예측된 정상 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 -냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 온도는 정보 제공 +이 예측된 평형 온도는 현재 값 옆에 괄호 안에 표시되며, 시스템의 +냉각이 적절한지 평가하는 데 도움이 됩니다. 이 추정 평형 온도는 정보 제공 목적일 뿐이며 SnapRAID의 동작에는 영향을 미치지 않습니다. 프로그램의 동작은 오로지 실제 측정된 디스크 온도에 기반합니다. @@ -1490,22 +1490,22 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 이것은 두 가지 주요 이점을 제공합니다. 일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 - SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을 + SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 유발하지 않습니다. 복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다. 다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된 데이터를 사용하여 고장 난 디스크를 재구성합니다. 활성 sync 프로세스 중에 디스크 고장이 발생하는 경우, - SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. - 이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데 + SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다. + 이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 패리티 방정식을 푸는 데 필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다. 스냅샷이 없으면 정상 디스크에서 업데이트되거나 삭제된 파일로 인해 데이터 블록이 누락되며, 이는 다른 고장 난 디스크를 복구하는 데 필요할 수 있습니다. 스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만 -생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다. +생성됩니다. 패리티 디스크는 항상 라이브 파일시스템을 사용합니다. 현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다. @@ -1515,15 +1515,15 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. 스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오. -8.1 스냅샷 사용 시 명령어 동작 -------------------- +8.1 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) +----------------------------------------------------- `sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 -라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다. -`sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한 +라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. +`sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 현재 상태를 캡처합니다. -반면에 `scrub` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 +반면에 `scrub` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. `check` 및 `fix` 명령어의 경우, 마지막 스냅샷의 사용 여부는 @@ -1535,7 +1535,7 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 다른 모든 데이터 디스크("참조" 디스크)는 해당 스냅샷을 통해 액세스됩니다. 이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가 -파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. +패리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다. -d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우 `check` 와 `fix` 는 라이브 파일시스템만을 독점적으로 사용합니다. @@ -1552,16 +1552,16 @@ Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며, ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. `stable` 스냅샷은 성공적으로 완료된 마지막 `sync` 상태를 나타내며, -현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 +현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. -`pending` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 +`pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. `sync` 가 중단되면 `pending` 스냅샷은 보존됩니다. -파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 +패리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로 이후의 `scrub`, `check` 및 `fix` 명령어는 이 보류 중인 스냅샷을 사용합니다. `sync` 가 중단된 경우, `check` 및 `fix` 명령어는 `stable` 스냅샷에서도 읽어와 @@ -1775,20 +1775,30 @@ Windows 콘솔을 UTF-8 모드로 설정하고 콘솔 글꼴로 `Lucida Console` 리디렉션하는 경우 결과 파일은 항상 UTF-8 형식입니다. -15 번역 (TRANSLATION) +15 종료 코드 (EXIT CODE) +==================== + +SnapRAID는 다음과 같은 오류 코드로 종료됩니다: + +0 - 모두 정상. +1 - 명령 실행 중 오류가 발생했습니다. +2 - `diff` 명령으로 모두 정상임을 확인했으나 `sync`가 필요합니다. + + +16 번역 (TRANSLATION) =================== 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. -16 저작권 (COPYRIGHT) +17 저작권 (COPYRIGHT) ================== -This file is Copyright (C) 2025 Andrea Mazzoleni +This file is Copyright (C) 2026 Andrea Mazzoleni -17 참고 (SEE ALSO) +18 참고 (SEE ALSO) ================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 738fc535..1afcfda4 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -1,6 +1,6 @@ -.TH "Kopia zapasowa SnapRAID dla macierzy dyskowych" 1 +.TH "Program do tworzenia kopii zapasowych SnapRAID dla macierzy dyskowych" 1 .SH NAME -snapraid \- Kopia zapasowa SnapRAID dla macierzy dyskowych +snapraid \- Program do tworzenia kopii zapasowych SnapRAID dla macierzy dyskowych .SH SKłADNIA (SYNOPSIS) snapraid [\-c, \-\-conf CONFIG] .PD 0 @@ -163,7 +163,7 @@ awarii całej macierzy dysków. .IP \(bu Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne i dowiązania twarde. -Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. +Uprawnienia, właściciel (własność) i rozszerzone atrybuty nie są zapisywane. .PD .SH PIERWSZE KROKI (GETTING STARTED) Aby użyć SnapRAID, musisz najpierw wybrać jeden dysk w swojej macierzy @@ -369,10 +369,10 @@ snapraid \-p bad scrub Uruchomienie \`scrub\` na niezsynchronizowanej macierzy może zgłosić błędy spowodowane usuniętymi lub zmodyfikowanymi plikami. Błędy te są zgłaszane w wyniku \`scrub\`, ale powiązane bloki nie są oznaczane jako złe. -.SS Pooling (Pooling) +.SS Łączenie w pulę (Pooling) Uwaga: Funkcja łączenia w pulę opisana poniżej została zastąpiona przez narzędzie mergerfs, które jest obecnie zalecaną opcją dla użytkowników Linuksa -w społeczności SnapRAID. Mergefs zapewnia bardziej elastyczny i wydajny +w społeczności SnapRAID. Mergerfs zapewnia bardziej elastyczny i wydajny sposób łączenia wielu dysków w jeden ujednolicony punkt montowania, umożliwiając bezproblemowy dostęp do plików w całej macierzy bez polegania na dowiązaniach symbolicznych. Dobrze integruje się z SnapRAID w celu ochrony @@ -614,7 +614,7 @@ Teraz odzyskałeś wszystko, co jest możliwe do odzyskania. Jeśli niektóre pl są częściowo lub całkowicie nie do odzyskania, zostaną one przemianowane poprzez dodanie rozszerzenia \`.unrecoverable\`. .PP -Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log, +Szczegółową listę wszystkich bloków nie do odzyskania znajdziesz w pliku fix.log, sprawdzając wszystkie linie zaczynające się od \`unrecoverable:\`. .PP Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie @@ -661,7 +661,7 @@ SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: .IP \(bu Wyświetlenie stanu macierzy \-> \`status\` .IP \(bu -Kontrolę dysków \-> \`smart\`, \`probe\`, \`up\`, \`down\` +Kontrola dysków \-> \`smart\`, \`probe\`, \`up\`, \`down\` .IP \(bu Utworzenie punktu kopii zapasowej/przywracania \-> \`sync\` .IP \(bu @@ -817,11 +817,11 @@ Są one identyfikowane przez posiadanie tej samej nazwy, rozmiaru i znacznika czasu. Jeśli podsekundowy znacznik czasu wynosi zero, pełna ścieżka musi być zgodna, aby plik został zidentyfikowany. -W przeciwieństwie do plików \'moved\' na tym samym dysku, pliki -relokowane mają inny i\-węzeł. +W przeciwieństwie do plików przeniesionych (\'moved\') na tym samym dysku, pliki +relokowane mają inny inode. .HP 4 .I restored -Pliki o innym i\-węźle, ale pasującym katalogu, +Pliki o innym inode, ale pasującym katalogu, nazwie, rozmiarze i znaczniku czasu. Są to zazwyczaj pliki przywrócone po ich usunięciu. .PD @@ -888,7 +888,7 @@ Aby sprawdzić tylko złe bloki, możesz użyć polecenia \`scrub \-p bad\`. .PP Zaleca się uruchamianie \`scrub\` tylko na zsynchronizowanej macierzy, aby uniknąć zgłaszania błędów spowodowanych przez niezsynchronizowane dane. Błędy te są rozpoznawane -jako nie będące cichymi błędami, a bloki nie są oznaczane jako złe, +jako niebędące cichymi błędami, a bloki nie są oznaczane jako złe, ale takie błędy są zgłaszane w wyniku polecenia. .PP Plik \`content\` jest modyfikowany w celu zaktualizowania czasu ostatniego sprawdzenia @@ -1142,9 +1142,9 @@ Stosuje globalne ograniczenie przepustowości dla wszystkich dysków. RATE to liczba bajtów na sekundę. Możesz określić mnożnik, taki jak K, M lub G (np. \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail ROZMIAR -Ogranicza listę plików do tych, które nie używają więcej niż określony -końcowy rozmiar dysków parzystości. +.B \-t, \-\-tail SIZE +Ogranicza listę plików do tych, które nie wykraczają poza określoną +sekcję końcową (ogon) plików parzystości. Możesz użyć mnożników takich jak K, M, G lub T (np. \-\-tail 1G). Opcja ta jest ważna tylko wtedy, gdy jest używana wraz z poleceniem \`locate\`. @@ -1242,9 +1242,9 @@ OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce zalecane, aby jej nie używać. NIE MASZ ochrony danych podczas operacji \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail ROZMIAR +.B \-W, \-\-force\-realloc\-tail SIZE Działa jak \-R, \-\-force\-realloc, ale ogranicza się do określonej części -końcowej (ostatnie ROZMIAR bajtów) każdego pliku parzystości. +końcowej (ostatnie SIZE bajtów) każdego pliku parzystości. Wymusza realokację (przeniesienie) wszelkich fragmentów/bloków plików obecnie przechowywanych w tej sekcji końcowej, pozwalając na ich umieszczenie w dowolnym miejscu w pliku (plikach) parzystości, gdzie @@ -1276,7 +1276,7 @@ w trybie dołączania. Wystąpienia \`%D\` i \`%T\` w nazwie są zastępowane datą i czasem w formacie RRRRMMDD i GGMMSS. W plikach wsadowych Windows musisz podwoić znak \`%\`, np. result\-%%D.log. Aby użyć \`>>\`, musisz -ujęć nazwę w cudzysłów, np. \`\[dq]>>result.log\[dq]\`. +ująć nazwę w cudzysłów, np. \`\[dq]>>result.log\[dq]\`. Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu, możesz użyć odpowiednio \`\[dq]>&1\[dq]\` i \`\[dq]>&2\[dq]\`. Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika. @@ -1506,7 +1506,7 @@ zmarnujesz 12,8 GB parzystości, co może skutkować .PP Możesz sprawdzić ilość zmarnowanego miejsca na każdym dysku za pomocą \`status\`. Jest to ilość miejsca, którą musisz pozostawić wolną na dyskach danych -lub użyć dla plików nie włączonych do macierzy. +lub użyć dla plików niewłączonych do macierzy. Jeśli ta wartość jest ujemna, oznacza to, że jesteś blisko wypełnienia parzystości i reprezentuje to przestrzeń, którą nadal możesz zmarnować. .PP @@ -1580,7 +1580,7 @@ Ustawia maksymalną dozwoloną temperaturę dysku w stopniach Celsjusza. Po okre SnapRAID okresowo sprawdza temperaturę wszystkich dysków za pomocą narzędzia smartctl. Aktualne temperatury dysków są wyświetlane podczas działania SnapRAID. Jeśli którykolwiek dysk przekroczy ten limit, wszystkie operacje -zostają zatrzymane, a dyski są zatrzymywane (przechodzą w stan gotowości) na czas +zostają zatrzymane, a dyski są wyłączane (przechodzą w stan czuwania / uśpienia) na czas zdefiniowany przez opcję \`temp_sleep\`. Po okresie uśpienia, operacje są wznawiane, potencjalnie ponownie zatrzymując się, jeśli limit temperatury zostanie ponownie osiągnięty. @@ -1588,7 +1588,7 @@ zostanie ponownie osiągnięty. Podczas działania SnapRAID analizuje również krzywą nagrzewania każdego dysku i szacuje długoterminową stałą temperaturę, którą mają osiągnąć, jeśli aktywność będzie kontynuowana. Oszacowanie jest wykonywane tylko po -czterokrotnym wzroście temperatury dysku, co zapewnia, że +czterokrotnym zarejestrowaniu wzrostu temperatury dysku, co zapewnia, że dostępnych jest wystarczająco dużo punktów danych do ustalenia wiarygodnego trendu. Ta przewidywana stała temperatura jest pokazywana w nawiasach obok aktualnej wartości i pomaga ocenić, czy chłodzenie systemu jest @@ -1604,7 +1604,7 @@ wykorzystuje najniższą temperaturę dysku zmierzoną na początku uruchomienia Normalnie SnapRAID pokazuje tylko temperaturę najgorętszego dysku. Aby wyświetlić temperaturę wszystkich dysków, użyj opcji \-A lub \-\-stats. .SS temp_sleep TIME_IN_MINUTES -Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury. +Ustawia czas wstrzymania (czuwania), w minutach, po osiągnięciu limitu temperatury. W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut. .SS pool DIR Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy @@ -1994,7 +1994,7 @@ specjalne katalogi Windows są traktowane jako pliki, co oznacza, że aby je wykluczyć, musisz użyć reguły pliku, a nie katalogu. .PP Jeśli nazwa pliku zawiera znak \`*\`, \`?\`, \`[\`, -lub \`]\`, musisz go uciec, aby uniknąć interpretacji jako +lub \`]\`, musisz go zamaskować (poprzedzić znakiem ucieczki), aby uniknąć interpretacji jako znaku globbing. W systemie Unix znakiem ucieczki jest \`\\\`; w systemie Windows jest to \`^\`. Gdy wzorzec znajduje się w wierszu poleceń, musisz podwoić znak ucieczki, aby uniknąć interpretacji przez powłokę poleceń. @@ -2203,10 +2203,25 @@ czcionki TrueType, takiej jak \`Lucida Console\`, jako czcionki konsoli. Dotyczy to tylko drukowanych nazw plików; jeśli przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze w formacie UTF\-8. +.SH KOD WYJśCIA (EXIT CODE) +SnapRAID kończy działanie z następującymi kodami błędów: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Wszystko w porządku. +.HP 4 +.I 1 +Polecenie napotkało błędy. +.HP 4 +.I 2 +Polecenie \`diff\` wykazało, że wszystko jest w porządku, ale wymagane jest \`sync\`. +.PD +.RE .SH TłUMACZENIE (TRANSLATION) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. .SH PRAWA AUTORSKIE (COPYRIGHT) -Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni +Ten plik jest chroniony prawem autorskim (C) 2026 Andrea Mazzoleni .SH ZOBACZ RóWNIEż (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 1e8bc00f..94185e0f 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1,5 +1,5 @@ Name{number} - snapraid - Kopia zapasowa SnapRAID dla macierzy dyskowych + snapraid - Program do tworzenia kopii zapasowych SnapRAID dla macierzy dyskowych Składnia (Synopsis) :snapraid [-c, --conf CONFIG] @@ -88,7 +88,7 @@ Ograniczenia (Limitations) awarii całej macierzy dysków. * Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne i dowiązania twarde. - Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. + Uprawnienia, właściciel (własność) i rozszerzone atrybuty nie są zapisywane. Pierwsze kroki (Getting Started) Aby użyć SnapRAID, musisz najpierw wybrać jeden dysk w swojej macierzy @@ -211,10 +211,10 @@ Pierwsze kroki (Getting Started) spowodowane usuniętymi lub zmodyfikowanymi plikami. Błędy te są zgłaszane w wyniku `scrub`, ale powiązane bloki nie są oznaczane jako złe. - Pooling (Pooling) + Łączenie w pulę (Pooling) Uwaga: Funkcja łączenia w pulę opisana poniżej została zastąpiona przez narzędzie mergerfs, które jest obecnie zalecaną opcją dla użytkowników Linuksa - w społeczności SnapRAID. Mergefs zapewnia bardziej elastyczny i wydajny + w społeczności SnapRAID. Mergerfs zapewnia bardziej elastyczny i wydajny sposób łączenia wielu dysków w jeden ujednolicony punkt montowania, umożliwiając bezproblemowy dostęp do plików w całej macierzy bez polegania na dowiązaniach symbolicznych. Dobrze integruje się z SnapRAID w celu ochrony @@ -355,7 +355,7 @@ Pierwsze kroki (Getting Started) są częściowo lub całkowicie nie do odzyskania, zostaną one przemianowane poprzez dodanie rozszerzenia `.unrecoverable`. - Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log, + Szczegółową listę wszystkich bloków nie do odzyskania znajdziesz w pliku fix.log, sprawdzając wszystkie linie zaczynające się od `unrecoverable:`. Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie @@ -395,7 +395,7 @@ Polecenia (Commands) SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: * Wyświetlenie stanu macierzy -> `status` - * Kontrolę dysków -> `smart`, `probe`, `up`, `down` + * Kontrola dysków -> `smart`, `probe`, `up`, `down` * Utworzenie punktu kopii zapasowej/przywracania -> `sync` * Okresowe sprawdzanie danych -> `scrub` * Przywrócenie ostatniego punktu kopii zapasowej/przywracania -> `fix`. @@ -523,9 +523,9 @@ Polecenia (Commands) i znacznika czasu. Jeśli podsekundowy znacznik czasu wynosi zero, pełna ścieżka musi być zgodna, aby plik został zidentyfikowany. - W przeciwieństwie do plików 'moved' na tym samym dysku, pliki - relokowane mają inny i-węzeł. - restored - Pliki o innym i-węźle, ale pasującym katalogu, + W przeciwieństwie do plików przeniesionych ('moved') na tym samym dysku, pliki + relokowane mają inny inode. + restored - Pliki o innym inode, ale pasującym katalogu, nazwie, rozmiarze i znaczniku czasu. Są to zazwyczaj pliki przywrócone po ich usunięciu. @@ -592,7 +592,7 @@ Polecenia (Commands) Zaleca się uruchamianie `scrub` tylko na zsynchronizowanej macierzy, aby uniknąć zgłaszania błędów spowodowanych przez niezsynchronizowane dane. Błędy te są rozpoznawane - jako nie będące cichymi błędami, a bloki nie są oznaczane jako złe, + jako niebędące cichymi błędami, a bloki nie są oznaczane jako złe, ale takie błędy są zgłaszane w wyniku polecenia. Plik `content` jest modyfikowany w celu zaktualizowania czasu ostatniego sprawdzenia @@ -856,9 +856,9 @@ Opcje (Options) liczba bajtów na sekundę. Możesz określić mnożnik, taki jak K, M lub G (np. --bw-limit 1G). - -t, --tail ROZMIAR - Ogranicza listę plików do tych, które nie używają więcej niż określony - końcowy rozmiar dysków parzystości. + -t, --tail SIZE + Ogranicza listę plików do tych, które nie wykraczają poza określoną + sekcję końcową (ogon) plików parzystości. Możesz użyć mnożników takich jak K, M, G lub T (np. --tail 1G). Opcja ta jest ważna tylko wtedy, gdy jest używana wraz z poleceniem `locate`. @@ -956,9 +956,9 @@ Opcje (Options) zalecane, aby jej nie używać. NIE MASZ ochrony danych podczas operacji `sync`. - -W, --force-realloc-tail ROZMIAR + -W, --force-realloc-tail SIZE Działa jak -R, --force-realloc, ale ogranicza się do określonej części - końcowej (ostatnie ROZMIAR bajtów) każdego pliku parzystości. + końcowej (ostatnie SIZE bajtów) każdego pliku parzystości. Wymusza realokację (przeniesienie) wszelkich fragmentów/bloków plików obecnie przechowywanych w tej sekcji końcowej, pozwalając na ich umieszczenie w dowolnym miejscu w pliku (plikach) parzystości, gdzie @@ -990,7 +990,7 @@ Opcje (Options) zastępowane datą i czasem w formacie RRRRMMDD i GGMMSS. W plikach wsadowych Windows musisz podwoić znak `%`, np. result-%%D.log. Aby użyć `>>`, musisz - ujęć nazwę w cudzysłów, np. `">>result.log"`. + ująć nazwę w cudzysłów, np. `">>result.log"`. Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu, możesz użyć odpowiednio `">&1"` i `">&2"`. Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika. @@ -1225,7 +1225,7 @@ Konfiguracja (Configuration) Możesz sprawdzić ilość zmarnowanego miejsca na każdym dysku za pomocą `status`. Jest to ilość miejsca, którą musisz pozostawić wolną na dyskach danych - lub użyć dla plików nie włączonych do macierzy. + lub użyć dla plików niewłączonych do macierzy. Jeśli ta wartość jest ujemna, oznacza to, że jesteś blisko wypełnienia parzystości i reprezentuje to przestrzeń, którą nadal możesz zmarnować. @@ -1290,7 +1290,7 @@ Konfiguracja (Configuration) SnapRAID okresowo sprawdza temperaturę wszystkich dysków za pomocą narzędzia smartctl. Aktualne temperatury dysków są wyświetlane podczas działania SnapRAID. Jeśli którykolwiek dysk przekroczy ten limit, wszystkie operacje - zostają zatrzymane, a dyski są zatrzymywane (przechodzą w stan gotowości) na czas + zostają zatrzymane, a dyski są wyłączane (przechodzą w stan czuwania / uśpienia) na czas zdefiniowany przez opcję `temp_sleep`. Po okresie uśpienia, operacje są wznawiane, potencjalnie ponownie zatrzymując się, jeśli limit temperatury zostanie ponownie osiągnięty. @@ -1298,7 +1298,7 @@ Konfiguracja (Configuration) Podczas działania SnapRAID analizuje również krzywą nagrzewania każdego dysku i szacuje długoterminową stałą temperaturę, którą mają osiągnąć, jeśli aktywność będzie kontynuowana. Oszacowanie jest wykonywane tylko po - czterokrotnym wzroście temperatury dysku, co zapewnia, że + czterokrotnym zarejestrowaniu wzrostu temperatury dysku, co zapewnia, że dostępnych jest wystarczająco dużo punktów danych do ustalenia wiarygodnego trendu. Ta przewidywana stała temperatura jest pokazywana w nawiasach obok aktualnej wartości i pomaga ocenić, czy chłodzenie systemu jest @@ -1315,7 +1315,7 @@ Konfiguracja (Configuration) Aby wyświetlić temperaturę wszystkich dysków, użyj opcji -A lub --stats. temp_sleep TIME_IN_MINUTES - Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury. + Ustawia czas wstrzymania (czuwania), w minutach, po osiągnięciu limitu temperatury. W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut. pool DIR @@ -1599,7 +1599,7 @@ Wzorce (Pattern) wykluczyć, musisz użyć reguły pliku, a nie katalogu. Jeśli nazwa pliku zawiera znak `*`, `?`, `[`, - lub `]`, musisz go uciec, aby uniknąć interpretacji jako + lub `]`, musisz go zamaskować (poprzedzić znakiem ucieczki), aby uniknąć interpretacji jako znaku globbing. W systemie Unix znakiem ucieczki jest `\`; w systemie Windows jest to `^`. Gdy wzorzec znajduje się w wierszu poleceń, musisz podwoić znak ucieczki, aby uniknąć interpretacji przez powłokę poleceń. @@ -1727,12 +1727,19 @@ Kodowanie (Encoding) przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze w formacie UTF-8. +Kod wyjścia (Exit Code) + SnapRAID kończy działanie z następującymi kodami błędów: + + 0 - Wszystko w porządku. + 1 - Polecenie napotkało błędy. + 2 - Polecenie `diff` wykazało, że wszystko jest w porządku, ale wymagane jest `sync`. + Tłumaczenie (Translation) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. Prawa autorskie (Copyright) - Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni + Ten plik jest chroniony prawem autorskim (C) 2026 Andrea Mazzoleni Zobacz również (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 61d53b5e..6b705df4 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1,6 +1,6 @@ - ============================================== - Kopia zapasowa SnapRAID dla macierzy dyskowych - ============================================== + ===================================================================== + Program do tworzenia kopii zapasowych SnapRAID dla macierzy dyskowych + ===================================================================== 1 SKłADNIA (SYNOPSIS) @@ -98,7 +98,7 @@ Inne ograniczenia SnapRAID to: awarii całej macierzy dysków. * Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne i dowiązania twarde. - Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. + Uprawnienia, właściciel (własność) i rozszerzone atrybuty nie są zapisywane. 4 PIERWSZE KROKI (GETTING STARTED) @@ -226,12 +226,12 @@ Uruchomienie `scrub` na niezsynchronizowanej macierzy może zgłosić błędy spowodowane usuniętymi lub zmodyfikowanymi plikami. Błędy te są zgłaszane w wyniku `scrub`, ale powiązane bloki nie są oznaczane jako złe. -4.2 Pooling (Pooling) ---------------------- +4.2 Łączenie w pulę (Pooling) +----------------------------- Uwaga: Funkcja łączenia w pulę opisana poniżej została zastąpiona przez narzędzie mergerfs, które jest obecnie zalecaną opcją dla użytkowników Linuksa -w społeczności SnapRAID. Mergefs zapewnia bardziej elastyczny i wydajny +w społeczności SnapRAID. Mergerfs zapewnia bardziej elastyczny i wydajny sposób łączenia wielu dysków w jeden ujednolicony punkt montowania, umożliwiając bezproblemowy dostęp do plików w całej macierzy bez polegania na dowiązaniach symbolicznych. Dobrze integruje się z SnapRAID w celu ochrony @@ -376,7 +376,7 @@ Teraz odzyskałeś wszystko, co jest możliwe do odzyskania. Jeśli niektóre pl są częściowo lub całkowicie nie do odzyskania, zostaną one przemianowane poprzez dodanie rozszerzenia `.unrecoverable`. -Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log, +Szczegółową listę wszystkich bloków nie do odzyskania znajdziesz w pliku fix.log, sprawdzając wszystkie linie zaczynające się od `unrecoverable:`. Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie @@ -419,7 +419,7 @@ Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe. SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: * Wyświetlenie stanu macierzy -> `status` -* Kontrolę dysków -> `smart`, `probe`, `up`, `down` +* Kontrola dysków -> `smart`, `probe`, `up`, `down` * Utworzenie punktu kopii zapasowej/przywracania -> `sync` * Okresowe sprawdzanie danych -> `scrub` * Przywrócenie ostatniego punktu kopii zapasowej/przywracania -> `fix`. @@ -559,9 +559,9 @@ podsumowanie zmian, pogrupowane według: i znacznika czasu. Jeśli podsekundowy znacznik czasu wynosi zero, pełna ścieżka musi być zgodna, aby plik został zidentyfikowany. - W przeciwieństwie do plików 'moved' na tym samym dysku, pliki - relokowane mają inny i-węzeł. - restored - Pliki o innym i-węźle, ale pasującym katalogu, + W przeciwieństwie do plików przeniesionych ('moved') na tym samym dysku, pliki + relokowane mają inny inode. + restored - Pliki o innym inode, ale pasującym katalogu, nazwie, rozmiarze i znaczniku czasu. Są to zazwyczaj pliki przywrócone po ich usunięciu. @@ -632,7 +632,7 @@ Aby sprawdzić tylko złe bloki, możesz użyć polecenia `scrub -p bad`. Zaleca się uruchamianie `scrub` tylko na zsynchronizowanej macierzy, aby uniknąć zgłaszania błędów spowodowanych przez niezsynchronizowane dane. Błędy te są rozpoznawane -jako nie będące cichymi błędami, a bloki nie są oznaczane jako złe, +jako niebędące cichymi błędami, a bloki nie są oznaczane jako złe, ale takie błędy są zgłaszane w wyniku polecenia. Plik `content` jest modyfikowany w celu zaktualizowania czasu ostatniego sprawdzenia @@ -917,9 +917,9 @@ SnapRAID udostępnia następujące opcje: liczba bajtów na sekundę. Możesz określić mnożnik, taki jak K, M lub G (np. --bw-limit 1G). - -t, --tail ROZMIAR - Ogranicza listę plików do tych, które nie używają więcej niż określony - końcowy rozmiar dysków parzystości. + -t, --tail SIZE + Ogranicza listę plików do tych, które nie wykraczają poza określoną + sekcję końcową (ogon) plików parzystości. Możesz użyć mnożników takich jak K, M, G lub T (np. --tail 1G). Opcja ta jest ważna tylko wtedy, gdy jest używana wraz z poleceniem `locate`. @@ -1017,9 +1017,9 @@ SnapRAID udostępnia następujące opcje: zalecane, aby jej nie używać. NIE MASZ ochrony danych podczas operacji `sync`. - -W, --force-realloc-tail ROZMIAR + -W, --force-realloc-tail SIZE Działa jak -R, --force-realloc, ale ogranicza się do określonej części - końcowej (ostatnie ROZMIAR bajtów) każdego pliku parzystości. + końcowej (ostatnie SIZE bajtów) każdego pliku parzystości. Wymusza realokację (przeniesienie) wszelkich fragmentów/bloków plików obecnie przechowywanych w tej sekcji końcowej, pozwalając na ich umieszczenie w dowolnym miejscu w pliku (plikach) parzystości, gdzie @@ -1051,7 +1051,7 @@ SnapRAID udostępnia następujące opcje: zastępowane datą i czasem w formacie RRRRMMDD i GGMMSS. W plikach wsadowych Windows musisz podwoić znak `%`, np. result-%%D.log. Aby użyć `>>`, musisz - ujęć nazwę w cudzysłów, np. `">>result.log"`. + ująć nazwę w cudzysłów, np. `">>result.log"`. Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu, możesz użyć odpowiednio `">&1"` i `">&2"`. Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika. @@ -1309,7 +1309,7 @@ zmarnujesz 12,8 GB parzystości, co może skutkować Możesz sprawdzić ilość zmarnowanego miejsca na każdym dysku za pomocą `status`. Jest to ilość miejsca, którą musisz pozostawić wolną na dyskach danych -lub użyć dla plików nie włączonych do macierzy. +lub użyć dla plików niewłączonych do macierzy. Jeśli ta wartość jest ujemna, oznacza to, że jesteś blisko wypełnienia parzystości i reprezentuje to przestrzeń, którą nadal możesz zmarnować. @@ -1380,7 +1380,7 @@ Ustawia maksymalną dozwoloną temperaturę dysku w stopniach Celsjusza. Po okre SnapRAID okresowo sprawdza temperaturę wszystkich dysków za pomocą narzędzia smartctl. Aktualne temperatury dysków są wyświetlane podczas działania SnapRAID. Jeśli którykolwiek dysk przekroczy ten limit, wszystkie operacje -zostają zatrzymane, a dyski są zatrzymywane (przechodzą w stan gotowości) na czas +zostają zatrzymane, a dyski są wyłączane (przechodzą w stan czuwania / uśpienia) na czas zdefiniowany przez opcję `temp_sleep`. Po okresie uśpienia, operacje są wznawiane, potencjalnie ponownie zatrzymując się, jeśli limit temperatury zostanie ponownie osiągnięty. @@ -1388,7 +1388,7 @@ zostanie ponownie osiągnięty. Podczas działania SnapRAID analizuje również krzywą nagrzewania każdego dysku i szacuje długoterminową stałą temperaturę, którą mają osiągnąć, jeśli aktywność będzie kontynuowana. Oszacowanie jest wykonywane tylko po -czterokrotnym wzroście temperatury dysku, co zapewnia, że +czterokrotnym zarejestrowaniu wzrostu temperatury dysku, co zapewnia, że dostępnych jest wystarczająco dużo punktów danych do ustalenia wiarygodnego trendu. Ta przewidywana stała temperatura jest pokazywana w nawiasach obok aktualnej wartości i pomaga ocenić, czy chłodzenie systemu jest @@ -1407,7 +1407,7 @@ Aby wyświetlić temperaturę wszystkich dysków, użyj opcji -A lub --stats. 7.14 temp_sleep TIME_IN_MINUTES ------------------------------- -Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury. +Ustawia czas wstrzymania (czuwania), w minutach, po osiągnięciu limitu temperatury. W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut. 7.15 pool DIR @@ -1712,7 +1712,7 @@ specjalne katalogi Windows są traktowane jako pliki, co oznacza, że aby je wykluczyć, musisz użyć reguły pliku, a nie katalogu. Jeśli nazwa pliku zawiera znak `*`, `?`, `[`, -lub `]`, musisz go uciec, aby uniknąć interpretacji jako +lub `]`, musisz go zamaskować (poprzedzić znakiem ucieczki), aby uniknąć interpretacji jako znaku globbing. W systemie Unix znakiem ucieczki jest `\`; w systemie Windows jest to `^`. Gdy wzorzec znajduje się w wierszu poleceń, musisz podwoić znak ucieczki, aby uniknąć interpretacji przez powłokę poleceń. @@ -1853,20 +1853,30 @@ przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze w formacie UTF-8. -15 TłUMACZENIE (TRANSLATION) +15 KOD WYJśCIA (EXIT CODE) +========================== + +SnapRAID kończy działanie z następującymi kodami błędów: + +0 - Wszystko w porządku. +1 - Polecenie napotkało błędy. +2 - Polecenie `diff` wykazało, że wszystko jest w porządku, ale wymagane jest `sync`. + + +16 TłUMACZENIE (TRANSLATION) ============================ Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. -16 PRAWA AUTORSKIE (COPYRIGHT) +17 PRAWA AUTORSKIE (COPYRIGHT) ============================== -Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni +Ten plik jest chroniony prawem autorskim (C) 2026 Andrea Mazzoleni -17 ZOBACZ RóWNIEż (SEE ALSO) +18 ZOBACZ RóWNIEż (SEE ALSO) ============================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index b2fcf41d..a86d2c26 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -118,7 +118,7 @@ https://www.snapraid.it/ .PD .RE .SH LIMITAçõES (LIMITATIONS) -O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar +O SnapRAID é um híbrido entre um RAID e um programa de backup, com o objetivo de combinar os melhores benefícios de ambos. No entanto, possui algumas limitações que deve considerar antes de o utilizar. .PP @@ -134,16 +134,16 @@ de a opção \`snapshot\` ser ou não utilizada: .IP \(bu Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS), o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados. -Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo -durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável. +Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo +durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. .PD .PD 0 .IP \(bu -Sem suporte a instantâneos, eliminar ou alterar ficheiros após um \`sync\` -pode impedir a recuperação total de outros discos com falha. Isto ocorre -porque a paridade já não corresponde aos ficheiros modificados, mesmo que -esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente -não impedem a recuperação de ficheiros já existentes. +Sem suporte a instantâneos, excluir ou alterar arquivos após um \`sync\` +pode impedir a recuperação total de outros discos com falha. Isso ocorre +porque a paridade já não corresponde aos arquivos modificados, mesmo que +esses arquivos não estejam no disco com falha. Por outro lado, arquivos adicionados recentemente +não impedem a recuperação de arquivos já existentes. .PD .PP Outras limitações do SnapRAID são: @@ -373,7 +373,7 @@ mas os blocos relacionados não são marcados como ruins. .SS Pooling (Pooling) Nota: O recurso de pooling descrito abaixo foi substituído pela ferramenta mergerfs, que agora é a opção recomendada para usuários Linux na comunidade -SnapRAID. Mergefs oferece uma maneira mais flexível e eficiente de agrupar +SnapRAID. Mergerfs oferece uma maneira mais flexível e eficiente de agrupar várias unidades em um único ponto de montagem unificado, permitindo acesso perfeito a arquivos em todo o seu array sem depender de links simbólicos. Ele se integra bem ao SnapRAID para proteção de paridade e é comumente usado @@ -626,7 +626,7 @@ no arquivo fix.log, verificando todas as linhas que começam com \`unrecoverable Se você não estiver satisfeito com a recuperação, pode tentar novamente quantas vezes quiser. .PP -Por exemplo, se você removeu arquivos do array após a última +Por exemplo, se você removeu arquivos do array após o último \`sync\`, isso pode resultar em alguns arquivos não sendo recuperados. Neste caso, você pode tentar novamente o \`fix\` usando a opção \-i, \-\-import, especificando onde esses arquivos estão agora para incluí\-los novamente @@ -666,7 +666,7 @@ Se tudo for recuperado, este comando é imediato. O SnapRAID fornece alguns comandos simples que lhe permitem: .PD 0 .IP \(bu -Imprimir o estado da matriz \-> \`status\` +Imprimir o estado do array \-> \`status\` .IP \(bu Controlar os discos \-> \`smart\`, \`probe\`, \`up\`, \`down\` .IP \(bu @@ -828,7 +828,7 @@ carimbo de data/hora. Se o carimbo de data/hora de subsegundos for zero, o caminho completo deve corresponder para ser identificado. Ao contrário dos arquivos \'moved\' no mesmo disco, os arquivos -realocados têm um inode diferente. +relocados têm um inode diferente. .HP 4 .I restored Arquivos com um inode diferente, mas com diretório, @@ -837,7 +837,7 @@ Geralmente são arquivos restaurados após serem excluídos. .PD .RE .PP -Se uma \`sync\` for necessária, o código de retorno do processo é 2, +Se um \`sync\` for necessário, o código de retorno do processo é 2, em vez do padrão 0. O código de retorno 1 é usado para uma condição de erro genérica. .PP @@ -911,14 +911,14 @@ para cada bloco e para marcar blocos ruins. Os arquivos \`parity\` NÃO são modificados. Os arquivos no array NÃO são modificados. .SS fix -Corrige todos os ficheiros e os dados de paridade. +Corrige todos os arquivos e os dados de paridade. .PP -Todos os ficheiros e dados de paridade são comparados com o estado guardado no +Todos os arquivos e dados de paridade são comparados com o estado salvo no último \`sync\`. Se for encontrada uma diferença, esta é revertida para o estado armazenado. .PP AVISO! O comando \`fix\` não diferencia erros de modificações intencionais. -Reverte incondicionalmente o estado do ficheiro para o do último \`sync\`. +Reverte incondicionalmente o estado do arquivo para o do último \`sync\`. .PP Se nenhuma outra opção for especificada, todo o array é processado. Use as opções de filtro para selecionar um subconjunto de arquivos ou @@ -927,13 +927,13 @@ discos para operar. Para corrigir apenas os blocos marcados como ruins durante \`sync\` e \`scrub\`, use a opção \-e, \-\-filter\-error. Ao contrário de outras opções de filtro, esta aplica correções apenas a -arquivos que não foram alterados desde a última \`sync\`. +arquivos que não foram alterados desde o último \`sync\`. .PP O SnapRAID renomeia todos os arquivos que não podem ser corrigidos adicionando a extensão \`.unrecoverable\`. .PP Antes de corrigir, todo o array é escaneado para encontrar quaisquer -arquivos movidos desde a última operação \`sync\`. +arquivos movidos desde a última operação de \`sync\`. Esses arquivos são identificados por seu carimbo de data/hora, ignorando seu nome e diretório, e são usados no processo de recuperação, se necessário. @@ -1124,9 +1124,9 @@ esta opção pode acelerar significativamente o processo de verificação. Esta opção pode ser usada apenas com \`check\`. .TP .B \-h, \-\-pre\-hash -Em \`sync\`, executa uma fase de hash preliminar de todos os novos dados +Em \`sync\`, executa uma fase de hash prexcluir de todos os novos dados para verificação adicional antes do cálculo da paridade. -Normalmente, em \`sync\`, nenhum hash preliminar é feito, e os novos +Normalmente, em \`sync\`, nenhum hash prexcluir é feito, e os novos dados são hashados logo antes do cálculo da paridade, quando são lidos pela primeira vez. Este processo ocorre quando o sistema está sob @@ -1163,7 +1163,7 @@ Aplica um limite de largura de banda global para todos os discos. A RATE é o número de bytes por segundo. Você pode especificar um multiplicador como K, M ou G (por exemplo, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail TAMANHO +.B \-t, \-\-tail SIZE Limita a listagem de arquivos àqueles que não usam mais do que o tamanho final especificado dos discos de paridade. Você pode usar multiplicadores como K, M, G ou T (ex: \-\-tail 1G). @@ -1269,9 +1269,9 @@ ATENÇÃO! Esta opção é apenas para especialistas e é altamente recomendado não usá\-la. Você NÃO tem proteção de dados durante a operação \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail TAMANHO +.B \-W, \-\-force\-realloc\-tail SIZE Funciona como \-R, \-\-force\-realloc, mas limitado à parte final -especificada (últimos TAMANHO bytes) de cada arquivo de paridade. +especificada (últimos SIZE bytes) de cada arquivo de paridade. Força a realocação (movimentação) de quaisquer fragmentos/blocos de arquivos atualmente armazenados nessa seção final, permitindo que sejam colocados em qualquer lugar no(s) arquivo(s) de paridade onde houver espaço livre @@ -1285,10 +1285,9 @@ Você pode usar multiplicadores como K, M, G ou T (ex: \-\-force\-realloc\-tail 1G). Você pode usar locate \-t, \-\-tail para saber antecipadamente os arquivos afetados. -AVISO! -Esta opção é apenas para especialistas e é altamente recomendado -não utilizá\-la. -Você NÃO terá proteção de datos durante a operação \`sync\` para os +ATENÇÃO! Esta opção é apenas para especialistas e é altamente +recomendado não usá\-la. +Você NÃO tem proteção de dados durante a operação \`sync\` para os arquivos afetados. .TP .B \-l, \-\-log FILE @@ -1461,35 +1460,35 @@ armazenado dos discos. Define o nome e o ponto de montagem de discos adicionais para monitorar com os comandos \`smart\` e \`probe\`. .PP -Isso é útil para monitorar discos que não fazem parte da matriz, +Isso é útil para monitorar discos que não fazem parte do array, mas que são necessários para o funcionamento do sistema, como o disco de inicialização. .PP Observe que tais discos não são afetados pelos comandos \`up\` e \`down\` porque se espera que estejam sempre girando. .SS snapshot -Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos \`sync\`, \`scrub\`, +Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos \`sync\`, \`scrub\`, \`check\` e \`fix\`. .PP -Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no -início de um \'sync\'. Isto garante uma visão consistente e num ponto específico no tempo dos seus -ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros. +Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no +início de um \'sync\'. Isso garante uma visão consistente e num ponto específico no tempo dos seus +arquivos, prevenindo erros causados por modificações concorrentes de arquivos. .PP -Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo, -ele permanece preservado no instantâneo. Isto evita que a paridade fique \[dq]corrompida\[dq] +Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, +ele permanece preservado no instantâneo. Isso evita que a paridade fique \[dq]corrompida\[dq] para esse bloco, garantindo que ainda pode recuperar os dados com sucesso se outro disco falhar. .PP Esta opção aplica\-se exclusivamente a discos de dados formatados com os sistemas de -ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. -Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre -a versão ativa do sistema de ficheiros. +arquivos Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. +Discos de paridade, ou discos de dados que utilizem outros sistemas de arquivos, usarão sempre +a versão ativa do sistema de arquivos. .PP -A criação e eliminação de instantâneos requerem privilégios administrativos. +A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando esta opção estiver ativada. .PP -Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida +Consulte a seção SNAPSHOTS para uma explicação detalhada do ciclo de vida dos instantâneos. .SS nohidden Exclui todos os arquivos e diretórios ocultos. @@ -1622,7 +1621,7 @@ temperatura for atingido mais uma vez. Durante a operação, o SnapRAID também analisa a curva de aquecimento de cada disco e estima a temperatura estável de longo prazo que eles devem atingir se a atividade continuar. A estimativa é realizada apenas -depois que a temperatura do disco aumentou quatro vezes, garantindo +depois que a temperatura do disco tiver subido quatro vezes, garantindo que pontos de dados suficientes estejam disponíveis para estabelecer uma tendência confiável. Esta temperatura estável prevista é mostrada entre parênteses ao lado @@ -1846,7 +1845,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH INSTANTâNEOS (SNAPSHOTS) Se a opção de instantâneo estiver ativada na configuração, o SnapRAID -utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas +utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas e consistentes. .PP A gestão de instantâneos é completamente automática e transparente. @@ -1854,17 +1853,17 @@ Pode continuar a utilizar o SnapRAID exatamente como antes, com a proteção adicional fornecida por instantâneos geridos inteiramente em segundo plano. .PP -Isto proporciona dois benefícios principais: +Isso proporciona dois benefícios principais: .RS 0 .PD 0 .HP 4 .I Consistência -Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de +Arquivos modificados no sistema de arquivos ativo durante um sync ou scrub de longa duração não causarão divergências de paridade ou operações abortadas, pois o SnapRAID vê uma imagem congelada no tempo. .HP 4 .I Recuperação -Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo, +Se um arquivo for atualizado ou excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Se ocorrer uma falha de disco antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados no instantâneo para reconstruir o disco com falha. @@ -1875,39 +1874,39 @@ no instantâneo para reconstruir o disco com falha. Em caso de falha de um disco durante um processo de sync ativo, o SnapRAID também é capaz de ler automaticamente tanto do instantâneo da computação de paridade anterior quanto da atual. -Isto maximiza a probabilidade de uma recuperação completa ao +Isso maximiza a probabilidade de uma recuperação completa ao fornecer acesso aos blocos de dados exatos necessários para resolver as equações de paridade, mesmo que esses blocos tenham sido modificados -ou eliminados entre os syncs. +ou excluídos entre os syncs. .PD .PP .PD 0 -Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável +Sem instantâneos, um arquivo atualizado ou excluído num disco saudável resulta na falta de blocos de dados que podem ser necessários para reparar outros discos com falha. .PD .RE .RE .PP -Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros +Os instantâneos são criados apenas para discos de dados e apenas se o sistema de arquivos subjacente suportar esta funcionalidade. Os discos de paridade usam sempre -o sistema de ficheiros ativo. +o sistema de arquivos ativo. .PP -Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux +Atualmente, isso é suportado em Btrfs, Bcachefs e ZFS em Linux e em NTFS em Windows. .PP -Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que +Pode misturar discos de dados com sistemas de arquivos diferentes. Apenas aqueles que suportam instantâneos os utilizarão, enquanto os outros discos continuarão -a operar diretamente no sistema de ficheiros ativo. +a operar diretamente no sistema de arquivos ativo. .PP -A criação e eliminação de instantâneos requerem privilégios administrativos. +A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando os instantâneos estão ativados. .SS Comportamento dos Comandos com Instantâneos Os comandos \`sync\` e \`scrub\` operam ambos exclusivamente em instantâneos para garantir que todas as operações de dados sejam realizadas contra um estado consistente -e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade -que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo. +e congelado. Ao utilizar esses instantâneos, o SnapRAID previne divergências de paridade +que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos ativo. Durante um \`sync\`, o comando usa um novo instantâneo criado no início do processo para capturar o estado atual para a computação da paridade. Em contraste, o comando \`scrub\` utiliza o último instantâneo, aquele @@ -1919,22 +1918,22 @@ depende de discos específicos serem ou não alvo da operação utilizando a op \-d, \-\-filter\-disk. .PP Um disco explicitamente selecionado via \-d (o \[dq]alvo\[dq] da operação) -usa sempre o sistema de ficheiros ativo. Para \`fix\`, isto permite restaurar +usa sempre o sistema de arquivos ativo. Para \`fix\`, isso permite restaurar dados para a substituição do disco ativo. Para \`check\`, permite simular a operação \`fix\` sob as mesmas condições. .PP -Todos os outros discos de dados (os discos de \[dq]referência\[dq]) serão acedidos através dos -seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros +Todos os outros discos de dados (os discos de \[dq]referência\[dq]) serão acessados através dos +seus instantâneos. Isso garante que, mesmo que esteja modificando arquivos nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID tem uma referência estável e congelada para resolver as equações de paridade. .PP Se nenhuma opção \-d for fornecida, o SnapRAID assume que a operação se aplica -a toda a matriz, neste caso, \`check\` e \`fix\` usarão os sistemas -de ficheiros ativos exclusivamente. +a todo o array, neste caso, \`check\` e \`fix\` usarão os sistemas +de arquivos ativos exclusivamente. .PP -Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo. +Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. .SH CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) -O SnapRAID gere dois instantâneos específicos, \`stable\` (estável) e \`pending\` (pendente), +O SnapRAID gerencia dois instantâneos específicos, \`stable\` (estável) e \`pending\` (pendente), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório \`.snapraid/\`, em ZFS o padrão \`.zfs/snapshot/\`. @@ -1947,25 +1946,25 @@ para os comandos \`scrub\`, \`check\` e \`fix\`. O instantâneo \`pending\` é uma imagem temporária criada ao início de um \`sync\` para fornecer um estado congelado para a computação da paridade. Após a conclusão bem\-sucedida da operação, o instantâneo \`stable\` anterior -é eliminado, e o instantâneo \`pending\` é promovido para +é excluído, e o instantâneo \`pending\` é promovido para tomar o seu lugar como a nova referência estável. .PP Se um \`sync\` for interrompido, o instantâneo \`pending\` é preservado. Os comandos subsequentes \`scrub\`, \`check\` e \`fix\` utilizarão este -instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no -ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada. +instantâneo pendente, pois ele corresponde ao estado do sistema de arquivos registrado no +arquivo .content, mesmo que a paridade esteja apenas parcialmente sincronizada. .PP No caso de uma interrupção do \`sync\`, os comandos \`check\` e \`fix\` também leem do instantâneo \`stable\` para recuperar blocos de dados -de ficheiros que foram atualizados ou eliminados durante o sync. -Isto é possível porque o ficheiro .content retém metadados para -todos os ficheiros modificados ou eliminados ao longo do processo de sync. +de arquivos que foram atualizados ou excluídos durante o sync. +Isso é possível porque o arquivo .content retém metadados para +todos os arquivos modificados ou excluídos ao longo do processo de sync. Esta informação histórica só é limpa quando um sync termina -com sucesso e a versão final do ficheiro .content é guardada. +com sucesso e a versão final do arquivo .content é salva. .PP Se um \`sync\` for reiniciado após uma interrupção, o instantâneo pending existente -é eliminado e um novo é criado para -capturar o estado atual do sistema de ficheiros ativo. +é excluído e um novo é criado para +capturar o estado atual do sistema de arquivos ativo. .SH PADRãO (PATTERN) Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou exclusão. Ao usar caracteres de globbing, você pode definir regras que @@ -2147,7 +2146,7 @@ snapraid \-f \[dq]*.mp3\[dq] check .RE .PP No Unix, ao usar caracteres globbing na linha de comando, você deve -citá\-los para evitar que o shell os expanda. +colocá\-los entre aspas para evitar que o shell os expanda. .SH IGNORAR ARQUIVOS (IGNORE FILE) Além das regras globais no arquivo de configuração, você pode colocar arquivos \`.snapraidignore\` em qualquer diretório dentro do array para definir @@ -2239,10 +2238,25 @@ e usar uma fonte TrueType como \`Lucida Console\` como fonte do console. Isso afeta apenas os nomes de arquivo impressos; se você redirecionar a saída do console para um arquivo, o arquivo resultante estará sempre no formato UTF\-8. +.SH CóDIGO DE SAíDA (EXIT CODE) +O SnapRAID termina com os seguintes códigos de erro: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Tudo OK. +.HP 4 +.I 1 +O comando encontrou alguns erros. +.HP 4 +.I 2 +O comando \`diff\` determinou que tudo está OK, mas é necessário um \`sync\`. +.PD +.RE .SH TRADUçãO (TRANSLATION) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. .SH DIREITOS AUTORAIS (COPYRIGHT) -Este arquivo é Copyright (C) 2025 Andrea Mazzoleni +Este arquivo é Copyright (C) 2026 Andrea Mazzoleni .SH VEJA TAMBéM (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index c675c67a..1714badc 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -52,7 +52,7 @@ Descrição (Description) :https://www.snapraid.it/ Limitações (Limitations) - O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar + O SnapRAID é um híbrido entre um RAID e um programa de backup, com o objetivo de combinar os melhores benefícios de ambos. No entanto, possui algumas limitações que deve considerar antes de o utilizar. @@ -67,14 +67,14 @@ Limitações (Limitations) * Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS), o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados. - Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo - durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável. + Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo + durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. - * Sem suporte a instantâneos, eliminar ou alterar ficheiros após um `sync` - pode impedir a recuperação total de outros discos com falha. Isto ocorre - porque a paridade já não corresponde aos ficheiros modificados, mesmo que - esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente - não impedem a recuperação de ficheiros já existentes. + * Sem suporte a instantâneos, excluir ou alterar arquivos após um `sync` + pode impedir a recuperação total de outros discos com falha. Isso ocorre + porque a paridade já não corresponde aos arquivos modificados, mesmo que + esses arquivos não estejam no disco com falha. Por outro lado, arquivos adicionados recentemente + não impedem a recuperação de arquivos já existentes. Outras limitações do SnapRAID são: @@ -215,7 +215,7 @@ Primeiros Passos (Getting Started) Pooling (Pooling) Nota: O recurso de pooling descrito abaixo foi substituído pela ferramenta mergerfs, que agora é a opção recomendada para usuários Linux na comunidade - SnapRAID. Mergefs oferece uma maneira mais flexível e eficiente de agrupar + SnapRAID. Mergerfs oferece uma maneira mais flexível e eficiente de agrupar várias unidades em um único ponto de montagem unificado, permitindo acesso perfeito a arquivos em todo o seu array sem depender de links simbólicos. Ele se integra bem ao SnapRAID para proteção de paridade e é comumente usado @@ -367,7 +367,7 @@ Primeiros Passos (Getting Started) Se você não estiver satisfeito com a recuperação, pode tentar novamente quantas vezes quiser. - Por exemplo, se você removeu arquivos do array após a última + Por exemplo, se você removeu arquivos do array após o último `sync`, isso pode resultar em alguns arquivos não sendo recuperados. Neste caso, você pode tentar novamente o `fix` usando a opção -i, --import, especificando onde esses arquivos estão agora para incluí-los novamente @@ -401,7 +401,7 @@ Primeiros Passos (Getting Started) Comandos (Commands) O SnapRAID fornece alguns comandos simples que lhe permitem: - * Imprimir o estado da matriz -> `status` + * Imprimir o estado do array -> `status` * Controlar os discos -> `smart`, `probe`, `up`, `down` * Criar um ponto de backup/recuperação -> `sync` * Verificar periodicamente os dados -> `scrub` @@ -534,12 +534,12 @@ Comandos (Commands) Se o carimbo de data/hora de subsegundos for zero, o caminho completo deve corresponder para ser identificado. Ao contrário dos arquivos 'moved' no mesmo disco, os arquivos - realocados têm um inode diferente. + relocados têm um inode diferente. restored - Arquivos com um inode diferente, mas com diretório, nome, tamanho e carimbo de data/hora correspondentes. Geralmente são arquivos restaurados após serem excluídos. - Se uma `sync` for necessária, o código de retorno do processo é 2, + Se um `sync` for necessário, o código de retorno do processo é 2, em vez do padrão 0. O código de retorno 1 é usado para uma condição de erro genérica. @@ -616,14 +616,14 @@ Comandos (Commands) Os arquivos no array NÃO são modificados. fix - Corrige todos os ficheiros e os dados de paridade. + Corrige todos os arquivos e os dados de paridade. - Todos os ficheiros e dados de paridade são comparados com o estado guardado no + Todos os arquivos e dados de paridade são comparados com o estado salvo no último `sync`. Se for encontrada uma diferença, esta é revertida para o estado armazenado. AVISO! O comando `fix` não diferencia erros de modificações intencionais. - Reverte incondicionalmente o estado do ficheiro para o do último `sync`. + Reverte incondicionalmente o estado do arquivo para o do último `sync`. Se nenhuma outra opção for especificada, todo o array é processado. Use as opções de filtro para selecionar um subconjunto de arquivos ou @@ -632,13 +632,13 @@ Comandos (Commands) Para corrigir apenas os blocos marcados como ruins durante `sync` e `scrub`, use a opção -e, --filter-error. Ao contrário de outras opções de filtro, esta aplica correções apenas a - arquivos que não foram alterados desde a última `sync`. + arquivos que não foram alterados desde o último `sync`. O SnapRAID renomeia todos os arquivos que não podem ser corrigidos adicionando a extensão `.unrecoverable`. Antes de corrigir, todo o array é escaneado para encontrar quaisquer - arquivos movidos desde a última operação `sync`. + arquivos movidos desde a última operação de `sync`. Esses arquivos são identificados por seu carimbo de data/hora, ignorando seu nome e diretório, e são usados no processo de recuperação, se necessário. @@ -838,9 +838,9 @@ Opções (Options) Esta opção pode ser usada apenas com `check`. -h, --pre-hash - Em `sync`, executa uma fase de hash preliminar de todos os novos dados + Em `sync`, executa uma fase de hash prexcluir de todos os novos dados para verificação adicional antes do cálculo da paridade. - Normalmente, em `sync`, nenhum hash preliminar é feito, e os novos + Normalmente, em `sync`, nenhum hash prexcluir é feito, e os novos dados são hashados logo antes do cálculo da paridade, quando são lidos pela primeira vez. Este processo ocorre quando o sistema está sob @@ -877,7 +877,7 @@ Opções (Options) RATE é o número de bytes por segundo. Você pode especificar um multiplicador como K, M ou G (por exemplo, --bw-limit 1G). - -t, --tail TAMANHO + -t, --tail SIZE Limita a listagem de arquivos àqueles que não usam mais do que o tamanho final especificado dos discos de paridade. Você pode usar multiplicadores como K, M, G ou T (ex: --tail 1G). @@ -983,9 +983,9 @@ Opções (Options) recomendado não usá-la. Você NÃO tem proteção de dados durante a operação `sync`. - -W, --force-realloc-tail TAMANHO + -W, --force-realloc-tail SIZE Funciona como -R, --force-realloc, mas limitado à parte final - especificada (últimos TAMANHO bytes) de cada arquivo de paridade. + especificada (últimos SIZE bytes) de cada arquivo de paridade. Força a realocação (movimentação) de quaisquer fragmentos/blocos de arquivos atualmente armazenados nessa seção final, permitindo que sejam colocados em qualquer lugar no(s) arquivo(s) de paridade onde houver espaço livre @@ -999,10 +999,9 @@ Opções (Options) --force-realloc-tail 1G). Você pode usar locate -t, --tail para saber antecipadamente os arquivos afetados. - AVISO! - Esta opção é apenas para especialistas e é altamente recomendado - não utilizá-la. - Você NÃO terá proteção de datos durante a operação `sync` para os + ATENÇÃO! Esta opção é apenas para especialistas e é altamente + recomendado não usá-la. + Você NÃO tem proteção de dados durante a operação `sync` para os arquivos afetados. -l, --log FILE @@ -1176,7 +1175,7 @@ Configuração (Configuration) Define o nome e o ponto de montagem de discos adicionais para monitorar com os comandos `smart` e `probe`. - Isso é útil para monitorar discos que não fazem parte da matriz, + Isso é útil para monitorar discos que não fazem parte do array, mas que são necessários para o funcionamento do sistema, como o disco de inicialização. @@ -1184,28 +1183,28 @@ Configuração (Configuration) porque se espera que estejam sempre girando. snapshot - Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos `sync`, `scrub`, + Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos `sync`, `scrub`, `check` e `fix`. - Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no - início de um 'sync'. Isto garante uma visão consistente e num ponto específico no tempo dos seus - ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros. + Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no + início de um 'sync'. Isso garante uma visão consistente e num ponto específico no tempo dos seus + arquivos, prevenindo erros causados por modificações concorrentes de arquivos. - Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo, - ele permanece preservado no instantâneo. Isto evita que a paridade fique "corrompida" + Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, + ele permanece preservado no instantâneo. Isso evita que a paridade fique "corrompida" para esse bloco, garantindo que ainda pode recuperar os dados com sucesso se outro disco falhar. Esta opção aplica-se exclusivamente a discos de dados formatados com os sistemas de - ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. - Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre - a versão ativa do sistema de ficheiros. + arquivos Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. + Discos de paridade, ou discos de dados que utilizem outros sistemas de arquivos, usarão sempre + a versão ativa do sistema de arquivos. - A criação e eliminação de instantâneos requerem privilégios administrativos. + A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando esta opção estiver ativada. - Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida + Consulte a seção SNAPSHOTS para uma explicação detalhada do ciclo de vida dos instantâneos. nohidden @@ -1332,7 +1331,7 @@ Configuração (Configuration) Durante a operação, o SnapRAID também analisa a curva de aquecimento de cada disco e estima a temperatura estável de longo prazo que eles devem atingir se a atividade continuar. A estimativa é realizada apenas - depois que a temperatura do disco aumentou quatro vezes, garantindo + depois que a temperatura do disco tiver subido quatro vezes, garantindo que pontos de dados suficientes estejam disponíveis para estabelecer uma tendência confiável. Esta temperatura estável prevista é mostrada entre parênteses ao lado @@ -1461,7 +1460,7 @@ Configuração (Configuration) Instantâneos (Snapshots) Se a opção de instantâneo estiver ativada na configuração, o SnapRAID - utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas + utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas e consistentes. A gestão de instantâneos é completamente automática e transparente. @@ -1469,12 +1468,12 @@ Instantâneos (Snapshots) proteção adicional fornecida por instantâneos geridos inteiramente em segundo plano. - Isto proporciona dois benefícios principais: + Isso proporciona dois benefícios principais: - Consistência - Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de + Consistência - Arquivos modificados no sistema de arquivos ativo durante um sync ou scrub de longa duração não causarão divergências de paridade ou operações abortadas, pois o SnapRAID vê uma imagem congelada no tempo. - Recuperação - Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo, + Recuperação - Se um arquivo for atualizado ou excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Se ocorrer uma falha de disco antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados no instantâneo para reconstruir o disco com falha. @@ -1482,35 +1481,35 @@ Instantâneos (Snapshots) Em caso de falha de um disco durante um processo de sync ativo, o SnapRAID também é capaz de ler automaticamente tanto do instantâneo da computação de paridade anterior quanto da atual. - Isto maximiza a probabilidade de uma recuperação completa ao + Isso maximiza a probabilidade de uma recuperação completa ao fornecer acesso aos blocos de dados exatos necessários para resolver as equações de paridade, mesmo que esses blocos tenham sido modificados - ou eliminados entre os syncs. + ou excluídos entre os syncs. - Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável + Sem instantâneos, um arquivo atualizado ou excluído num disco saudável resulta na falta de blocos de dados que podem ser necessários para reparar outros discos com falha. - Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros + Os instantâneos são criados apenas para discos de dados e apenas se o sistema de arquivos subjacente suportar esta funcionalidade. Os discos de paridade usam sempre - o sistema de ficheiros ativo. + o sistema de arquivos ativo. - Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux + Atualmente, isso é suportado em Btrfs, Bcachefs e ZFS em Linux e em NTFS em Windows. - Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que + Pode misturar discos de dados com sistemas de arquivos diferentes. Apenas aqueles que suportam instantâneos os utilizarão, enquanto os outros discos continuarão - a operar diretamente no sistema de ficheiros ativo. + a operar diretamente no sistema de arquivos ativo. - A criação e eliminação de instantâneos requerem privilégios administrativos. + A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando os instantâneos estão ativados. Comportamento dos Comandos com Instantâneos Os comandos `sync` e `scrub` operam ambos exclusivamente em instantâneos para garantir que todas as operações de dados sejam realizadas contra um estado consistente - e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade - que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo. + e congelado. Ao utilizar esses instantâneos, o SnapRAID previne divergências de paridade + que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos ativo. Durante um `sync`, o comando usa um novo instantâneo criado no início do processo para capturar o estado atual para a computação da paridade. Em contraste, o comando `scrub` utiliza o último instantâneo, aquele @@ -1522,23 +1521,23 @@ Instantâneos (Snapshots) -d, --filter-disk. Um disco explicitamente selecionado via -d (o "alvo" da operação) - usa sempre o sistema de ficheiros ativo. Para `fix`, isto permite restaurar + usa sempre o sistema de arquivos ativo. Para `fix`, isso permite restaurar dados para a substituição do disco ativo. Para `check`, permite simular a operação `fix` sob as mesmas condições. - Todos os outros discos de dados (os discos de "referência") serão acedidos através dos - seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros + Todos os outros discos de dados (os discos de "referência") serão acessados através dos + seus instantâneos. Isso garante que, mesmo que esteja modificando arquivos nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID tem uma referência estável e congelada para resolver as equações de paridade. Se nenhuma opção -d for fornecida, o SnapRAID assume que a operação se aplica - a toda a matriz, neste caso, `check` e `fix` usarão os sistemas - de ficheiros ativos exclusivamente. + a todo o array, neste caso, `check` e `fix` usarão os sistemas + de arquivos ativos exclusivamente. - Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo. + Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) - O SnapRAID gere dois instantâneos específicos, `stable` (estável) e `pending` (pendente), + O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`, em ZFS o padrão `.zfs/snapshot/`. @@ -1551,25 +1550,25 @@ Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) O instantâneo `pending` é uma imagem temporária criada ao início de um `sync` para fornecer um estado congelado para a computação da paridade. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior - é eliminado, e o instantâneo `pending` é promovido para + é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. Se um `sync` for interrompido, o instantâneo `pending` é preservado. Os comandos subsequentes `scrub`, `check` e `fix` utilizarão este - instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no - ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada. + instantâneo pendente, pois ele corresponde ao estado do sistema de arquivos registrado no + arquivo .content, mesmo que a paridade esteja apenas parcialmente sincronizada. No caso de uma interrupção do `sync`, os comandos `check` e `fix` também leem do instantâneo `stable` para recuperar blocos de dados - de ficheiros que foram atualizados ou eliminados durante o sync. - Isto é possível porque o ficheiro .content retém metadados para - todos os ficheiros modificados ou eliminados ao longo do processo de sync. + de arquivos que foram atualizados ou excluídos durante o sync. + Isso é possível porque o arquivo .content retém metadados para + todos os arquivos modificados ou excluídos ao longo do processo de sync. Esta informação histórica só é limpa quando um sync termina - com sucesso e a versão final do ficheiro .content é guardada. + com sucesso e a versão final do arquivo .content é salva. Se um `sync` for reiniciado após uma interrupção, o instantâneo pending existente - é eliminado e um novo é criado para - capturar o estado atual do sistema de ficheiros ativo. + é excluído e um novo é criado para + capturar o estado atual do sistema de arquivos ativo. Padrão (Pattern) Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou @@ -1685,7 +1684,7 @@ Padrão (Pattern) :snapraid -f "*.mp3" check No Unix, ao usar caracteres globbing na linha de comando, você deve - citá-los para evitar que o shell os expanda. + colocá-los entre aspas para evitar que o shell os expanda. Ignorar Arquivos (Ignore File) Além das regras globais no arquivo de configuração, você pode colocar @@ -1763,12 +1762,19 @@ Codificação (Encoding) redirecionar a saída do console para um arquivo, o arquivo resultante estará sempre no formato UTF-8. +Código de Saída (Exit Code) + O SnapRAID termina com os seguintes códigos de erro: + + 0 - Tudo OK. + 1 - O comando encontrou alguns erros. + 2 - O comando `diff` determinou que tudo está OK, mas é necessário um `sync`. + Tradução (Translation) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. Direitos Autorais (Copyright) - Este arquivo é Copyright (C) 2025 Andrea Mazzoleni + Este arquivo é Copyright (C) 2026 Andrea Mazzoleni Veja Também (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index ac1d5bb6..eaf8a557 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -62,7 +62,7 @@ Para mais informações, visite o site oficial do SnapRAID: 3 LIMITAçõES (LIMITATIONS) ========================== -O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar +O SnapRAID é um híbrido entre um RAID e um programa de backup, com o objetivo de combinar os melhores benefícios de ambos. No entanto, possui algumas limitações que deve considerar antes de o utilizar. @@ -77,14 +77,14 @@ de a opção `snapshot` ser ou não utilizada: * Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS), o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados. - Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo - durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável. + Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo + durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. -* Sem suporte a instantâneos, eliminar ou alterar ficheiros após um `sync` - pode impedir a recuperação total de outros discos com falha. Isto ocorre - porque a paridade já não corresponde aos ficheiros modificados, mesmo que - esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente - não impedem a recuperação de ficheiros já existentes. +* Sem suporte a instantâneos, excluir ou alterar arquivos após um `sync` + pode impedir a recuperação total de outros discos com falha. Isso ocorre + porque a paridade já não corresponde aos arquivos modificados, mesmo que + esses arquivos não estejam no disco com falha. Por outro lado, arquivos adicionados recentemente + não impedem a recuperação de arquivos já existentes. Outras limitações do SnapRAID são: @@ -232,7 +232,7 @@ mas os blocos relacionados não são marcados como ruins. Nota: O recurso de pooling descrito abaixo foi substituído pela ferramenta mergerfs, que agora é a opção recomendada para usuários Linux na comunidade -SnapRAID. Mergefs oferece uma maneira mais flexível e eficiente de agrupar +SnapRAID. Mergerfs oferece uma maneira mais flexível e eficiente de agrupar várias unidades em um único ponto de montagem unificado, permitindo acesso perfeito a arquivos em todo o seu array sem depender de links simbólicos. Ele se integra bem ao SnapRAID para proteção de paridade e é comumente usado @@ -388,7 +388,7 @@ no arquivo fix.log, verificando todas as linhas que começam com `unrecoverable: Se você não estiver satisfeito com a recuperação, pode tentar novamente quantas vezes quiser. -Por exemplo, se você removeu arquivos do array após a última +Por exemplo, se você removeu arquivos do array após o último `sync`, isso pode resultar em alguns arquivos não sendo recuperados. Neste caso, você pode tentar novamente o `fix` usando a opção -i, --import, especificando onde esses arquivos estão agora para incluí-los novamente @@ -425,7 +425,7 @@ Se tudo for recuperado, este comando é imediato. O SnapRAID fornece alguns comandos simples que lhe permitem: -* Imprimir o estado da matriz -> `status` +* Imprimir o estado do array -> `status` * Controlar os discos -> `smart`, `probe`, `up`, `down` * Criar um ponto de backup/recuperação -> `sync` * Verificar periodicamente os dados -> `scrub` @@ -570,12 +570,12 @@ apresentado, agrupado por: Se o carimbo de data/hora de subsegundos for zero, o caminho completo deve corresponder para ser identificado. Ao contrário dos arquivos 'moved' no mesmo disco, os arquivos - realocados têm um inode diferente. + relocados têm um inode diferente. restored - Arquivos com um inode diferente, mas com diretório, nome, tamanho e carimbo de data/hora correspondentes. Geralmente são arquivos restaurados após serem excluídos. -Se uma `sync` for necessária, o código de retorno do processo é 2, +Se um `sync` for necessário, o código de retorno do processo é 2, em vez do padrão 0. O código de retorno 1 é usado para uma condição de erro genérica. @@ -658,14 +658,14 @@ Os arquivos no array NÃO são modificados. 5.9 fix ------- -Corrige todos os ficheiros e os dados de paridade. +Corrige todos os arquivos e os dados de paridade. -Todos os ficheiros e dados de paridade são comparados com o estado guardado no +Todos os arquivos e dados de paridade são comparados com o estado salvo no último `sync`. Se for encontrada uma diferença, esta é revertida para o estado armazenado. AVISO! O comando `fix` não diferencia erros de modificações intencionais. -Reverte incondicionalmente o estado do ficheiro para o do último `sync`. +Reverte incondicionalmente o estado do arquivo para o do último `sync`. Se nenhuma outra opção for especificada, todo o array é processado. Use as opções de filtro para selecionar um subconjunto de arquivos ou @@ -674,13 +674,13 @@ discos para operar. Para corrigir apenas os blocos marcados como ruins durante `sync` e `scrub`, use a opção -e, --filter-error. Ao contrário de outras opções de filtro, esta aplica correções apenas a -arquivos que não foram alterados desde a última `sync`. +arquivos que não foram alterados desde o último `sync`. O SnapRAID renomeia todos os arquivos que não podem ser corrigidos adicionando a extensão `.unrecoverable`. Antes de corrigir, todo o array é escaneado para encontrar quaisquer -arquivos movidos desde a última operação `sync`. +arquivos movidos desde a última operação de `sync`. Esses arquivos são identificados por seu carimbo de data/hora, ignorando seu nome e diretório, e são usados no processo de recuperação, se necessário. @@ -899,9 +899,9 @@ SnapRAID fornece as seguintes opções: Esta opção pode ser usada apenas com `check`. -h, --pre-hash - Em `sync`, executa uma fase de hash preliminar de todos os novos dados + Em `sync`, executa uma fase de hash prexcluir de todos os novos dados para verificação adicional antes do cálculo da paridade. - Normalmente, em `sync`, nenhum hash preliminar é feito, e os novos + Normalmente, em `sync`, nenhum hash prexcluir é feito, e os novos dados são hashados logo antes do cálculo da paridade, quando são lidos pela primeira vez. Este processo ocorre quando o sistema está sob @@ -938,7 +938,7 @@ SnapRAID fornece as seguintes opções: RATE é o número de bytes por segundo. Você pode especificar um multiplicador como K, M ou G (por exemplo, --bw-limit 1G). - -t, --tail TAMANHO + -t, --tail SIZE Limita a listagem de arquivos àqueles que não usam mais do que o tamanho final especificado dos discos de paridade. Você pode usar multiplicadores como K, M, G ou T (ex: --tail 1G). @@ -1044,9 +1044,9 @@ SnapRAID fornece as seguintes opções: recomendado não usá-la. Você NÃO tem proteção de dados durante a operação `sync`. - -W, --force-realloc-tail TAMANHO + -W, --force-realloc-tail SIZE Funciona como -R, --force-realloc, mas limitado à parte final - especificada (últimos TAMANHO bytes) de cada arquivo de paridade. + especificada (últimos SIZE bytes) de cada arquivo de paridade. Força a realocação (movimentação) de quaisquer fragmentos/blocos de arquivos atualmente armazenados nessa seção final, permitindo que sejam colocados em qualquer lugar no(s) arquivo(s) de paridade onde houver espaço livre @@ -1060,10 +1060,9 @@ SnapRAID fornece as seguintes opções: --force-realloc-tail 1G). Você pode usar locate -t, --tail para saber antecipadamente os arquivos afetados. - AVISO! - Esta opção é apenas para especialistas e é altamente recomendado - não utilizá-la. - Você NÃO terá proteção de datos durante a operação `sync` para os + ATENÇÃO! Esta opção é apenas para especialistas e é altamente + recomendado não usá-la. + Você NÃO tem proteção de dados durante a operação `sync` para os arquivos afetados. -l, --log FILE @@ -1252,7 +1251,7 @@ armazenado dos discos. Define o nome e o ponto de montagem de discos adicionais para monitorar com os comandos `smart` e `probe`. -Isso é útil para monitorar discos que não fazem parte da matriz, +Isso é útil para monitorar discos que não fazem parte do array, mas que são necessários para o funcionamento do sistema, como o disco de inicialização. @@ -1262,28 +1261,28 @@ porque se espera que estejam sempre girando. 7.7 snapshot ------------ -Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos `sync`, `scrub`, +Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos `sync`, `scrub`, `check` e `fix`. -Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no -início de um 'sync'. Isto garante uma visão consistente e num ponto específico no tempo dos seus -ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros. +Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no +início de um 'sync'. Isso garante uma visão consistente e num ponto específico no tempo dos seus +arquivos, prevenindo erros causados por modificações concorrentes de arquivos. -Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo, -ele permanece preservado no instantâneo. Isto evita que a paridade fique "corrompida" +Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, +ele permanece preservado no instantâneo. Isso evita que a paridade fique "corrompida" para esse bloco, garantindo que ainda pode recuperar os dados com sucesso se outro disco falhar. Esta opção aplica-se exclusivamente a discos de dados formatados com os sistemas de -ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. -Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre -a versão ativa do sistema de ficheiros. +arquivos Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows. +Discos de paridade, ou discos de dados que utilizem outros sistemas de arquivos, usarão sempre +a versão ativa do sistema de arquivos. -A criação e eliminação de instantâneos requerem privilégios administrativos. +A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando esta opção estiver ativada. -Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida +Consulte a seção SNAPSHOTS para uma explicação detalhada do ciclo de vida dos instantâneos. 7.8 nohidden @@ -1422,7 +1421,7 @@ temperatura for atingido mais uma vez. Durante a operação, o SnapRAID também analisa a curva de aquecimento de cada disco e estima a temperatura estável de longo prazo que eles devem atingir se a atividade continuar. A estimativa é realizada apenas -depois que a temperatura do disco aumentou quatro vezes, garantindo +depois que a temperatura do disco tiver subido quatro vezes, garantindo que pontos de dados suficientes estejam disponíveis para estabelecer uma tendência confiável. Esta temperatura estável prevista é mostrada entre parênteses ao lado @@ -1566,7 +1565,7 @@ Um exemplo de uma configuração típica para Windows é: ========================== Se a opção de instantâneo estiver ativada na configuração, o SnapRAID -utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas +utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas e consistentes. A gestão de instantâneos é completamente automática e transparente. @@ -1574,12 +1573,12 @@ Pode continuar a utilizar o SnapRAID exatamente como antes, com a proteção adicional fornecida por instantâneos geridos inteiramente em segundo plano. -Isto proporciona dois benefícios principais: +Isso proporciona dois benefícios principais: -Consistência - Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de +Consistência - Arquivos modificados no sistema de arquivos ativo durante um sync ou scrub de longa duração não causarão divergências de paridade ou operações abortadas, pois o SnapRAID vê uma imagem congelada no tempo. -Recuperação - Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo, +Recuperação - Se um arquivo for atualizado ou excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Se ocorrer uma falha de disco antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados no instantâneo para reconstruir o disco com falha. @@ -1587,27 +1586,27 @@ Recuperação - Se um ficheiro for atualizado ou eliminado do sistema de ficheir Em caso de falha de um disco durante um processo de sync ativo, o SnapRAID também é capaz de ler automaticamente tanto do instantâneo da computação de paridade anterior quanto da atual. - Isto maximiza a probabilidade de uma recuperação completa ao + Isso maximiza a probabilidade de uma recuperação completa ao fornecer acesso aos blocos de dados exatos necessários para resolver as equações de paridade, mesmo que esses blocos tenham sido modificados - ou eliminados entre os syncs. + ou excluídos entre os syncs. - Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável + Sem instantâneos, um arquivo atualizado ou excluído num disco saudável resulta na falta de blocos de dados que podem ser necessários para reparar outros discos com falha. -Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros +Os instantâneos são criados apenas para discos de dados e apenas se o sistema de arquivos subjacente suportar esta funcionalidade. Os discos de paridade usam sempre -o sistema de ficheiros ativo. +o sistema de arquivos ativo. -Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux +Atualmente, isso é suportado em Btrfs, Bcachefs e ZFS em Linux e em NTFS em Windows. -Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que +Pode misturar discos de dados com sistemas de arquivos diferentes. Apenas aqueles que suportam instantâneos os utilizarão, enquanto os outros discos continuarão -a operar diretamente no sistema de ficheiros ativo. +a operar diretamente no sistema de arquivos ativo. -A criação e eliminação de instantâneos requerem privilégios administrativos. +A criação e exclusão de instantâneos requerem privilégios administrativos. Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando os instantâneos estão ativados. @@ -1616,8 +1615,8 @@ quando os instantâneos estão ativados. Os comandos `sync` e `scrub` operam ambos exclusivamente em instantâneos para garantir que todas as operações de dados sejam realizadas contra um estado consistente -e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade -que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo. +e congelado. Ao utilizar esses instantâneos, o SnapRAID previne divergências de paridade +que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos ativo. Durante um `sync`, o comando usa um novo instantâneo criado no início do processo para capturar o estado atual para a computação da paridade. Em contraste, o comando `scrub` utiliza o último instantâneo, aquele @@ -1629,26 +1628,26 @@ depende de discos específicos serem ou não alvo da operação utilizando a op -d, --filter-disk. Um disco explicitamente selecionado via -d (o "alvo" da operação) -usa sempre o sistema de ficheiros ativo. Para `fix`, isto permite restaurar +usa sempre o sistema de arquivos ativo. Para `fix`, isso permite restaurar dados para a substituição do disco ativo. Para `check`, permite simular a operação `fix` sob as mesmas condições. -Todos os outros discos de dados (os discos de "referência") serão acedidos através dos -seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros +Todos os outros discos de dados (os discos de "referência") serão acessados através dos +seus instantâneos. Isso garante que, mesmo que esteja modificando arquivos nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID tem uma referência estável e congelada para resolver as equações de paridade. Se nenhuma opção -d for fornecida, o SnapRAID assume que a operação se aplica -a toda a matriz, neste caso, `check` e `fix` usarão os sistemas -de ficheiros ativos exclusivamente. +a todo o array, neste caso, `check` e `fix` usarão os sistemas +de arquivos ativos exclusivamente. -Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo. +Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. 9 CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) ====================================================== -O SnapRAID gere dois instantâneos específicos, `stable` (estável) e `pending` (pendente), +O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`, em ZFS o padrão `.zfs/snapshot/`. @@ -1661,25 +1660,25 @@ para os comandos `scrub`, `check` e `fix`. O instantâneo `pending` é uma imagem temporária criada ao início de um `sync` para fornecer um estado congelado para a computação da paridade. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior -é eliminado, e o instantâneo `pending` é promovido para +é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. Se um `sync` for interrompido, o instantâneo `pending` é preservado. Os comandos subsequentes `scrub`, `check` e `fix` utilizarão este -instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no -ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada. +instantâneo pendente, pois ele corresponde ao estado do sistema de arquivos registrado no +arquivo .content, mesmo que a paridade esteja apenas parcialmente sincronizada. No caso de uma interrupção do `sync`, os comandos `check` e `fix` também leem do instantâneo `stable` para recuperar blocos de dados -de ficheiros que foram atualizados ou eliminados durante o sync. -Isto é possível porque o ficheiro .content retém metadados para -todos os ficheiros modificados ou eliminados ao longo do processo de sync. +de arquivos que foram atualizados ou excluídos durante o sync. +Isso é possível porque o arquivo .content retém metadados para +todos os arquivos modificados ou excluídos ao longo do processo de sync. Esta informação histórica só é limpa quando um sync termina -com sucesso e a versão final do ficheiro .content é guardada. +com sucesso e a versão final do arquivo .content é salva. Se um `sync` for reiniciado após uma interrupção, o instantâneo pending existente -é eliminado e um novo é criado para -capturar o estado atual do sistema de ficheiros ativo. +é excluído e um novo é criado para +capturar o estado atual do sistema de arquivos ativo. 10 PADRãO (PATTERN) @@ -1798,7 +1797,7 @@ Por exemplo: snapraid -f "*.mp3" check No Unix, ao usar caracteres globbing na linha de comando, você deve -citá-los para evitar que o shell os expanda. +colocá-los entre aspas para evitar que o shell os expanda. 11 IGNORAR ARQUIVOS (IGNORE FILE) @@ -1889,20 +1888,30 @@ redirecionar a saída do console para um arquivo, o arquivo resultante estará sempre no formato UTF-8. -15 TRADUçãO (TRANSLATION) +15 CóDIGO DE SAíDA (EXIT CODE) +============================== + +O SnapRAID termina com os seguintes códigos de erro: + +0 - Tudo OK. +1 - O comando encontrou alguns erros. +2 - O comando `diff` determinou que tudo está OK, mas é necessário um `sync`. + + +16 TRADUçãO (TRANSLATION) ========================= Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. -16 DIREITOS AUTORAIS (COPYRIGHT) +17 DIREITOS AUTORAIS (COPYRIGHT) ================================ -Este arquivo é Copyright (C) 2025 Andrea Mazzoleni +Este arquivo é Copyright (C) 2026 Andrea Mazzoleni -17 VEJA TAMBéM (SEE ALSO) +18 VEJA TAMBéM (SEE ALSO) ========================= snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 0f9c5aa3..f7d6e61a 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -87,7 +87,7 @@ care se schimbă rar, SnapRAID oferă câteva caracteristici: .PD 0 .IP \(bu Puteți utiliza discuri deja pline cu fișiere fără -nevoia de a le reformat, accesându\-le ca de obicei. +nevoia de a le reformata, accesându\-le ca de obicei. .IP \(bu Toate datele dvs. sunt hash\-uite pentru a asigura integritatea datelor și a preveni corupția silențioasă. @@ -104,7 +104,7 @@ Discurile pot avea dimensiuni diferite. Puteți adăuga discuri în orice moment. .IP \(bu SnapRAID nu vă blochează datele; puteți înceta să\-l utilizați -oricând fără a reforma sau muta date. +oricând fără a reformata sau muta date. .IP \(bu Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind energie și reducând zgomotul. @@ -370,7 +370,7 @@ dar blocurile aferente nu sunt marcate ca defecte. .SS Agregare (Pooling) Notă: Funcționalitatea de pooling descrisă mai jos a fost înlocuită de instrumentul mergerfs, care este acum opțiunea recomandată pentru utilizatorii Linux în -comunitatea SnapRAID. Mergefs oferă o modalitate mai flexibilă și eficientă +comunitatea SnapRAID. Mergerfs oferă o modalitate mai flexibilă și eficientă de a agrega mai multe discuri într\-un singur punct de montare unificat, permițând accesul neîntrerupt la fișiere pe toată matricea dvs. fără a se baza pe link\-uri simbolice. Se integrează bine cu SnapRAID pentru protecția parității @@ -379,7 +379,7 @@ sau configurații NAS personalizate. .PP Pentru a avea toate fișierele din matricea dvs. afișate în același arbore de directoare, puteți activa funcționalitatea de \`pooling\`. Aceasta creează o vizualizare virtuală -doar în citire a tuturor fișierelor din matricea dvs. folosind link\-uri simbolice. +read\-only a tuturor fișierelor din matricea dvs. folosind link\-uri simbolice. .PP Puteți configura directorul de \`pooling\` în fișierul de configurare cu: .PP @@ -568,7 +568,7 @@ Modificați fișierul de configurare SnapRAID pentru a face ca opțiunea \`data\ a discului defect să indice o locație cu suficient spațiu gol pentru a recupera fișierele. .PP -De exemplu, dacă discul \`d1\` a eșuat, schimbați de la: +De exemplu, dacă discul \`d1\` s\-a defectat, schimbați de la: .PP .RS 4 data d1 /mnt/disk1/ @@ -615,7 +615,7 @@ verificând toate liniile care încep cu \`unrecoverable:\`. Dacă nu sunteți mulțumit de recuperare, o puteți reîncerca de câte ori doriți. .PP -De exemplu, dacă ați eliminat fișiere din matrice după ultima +De exemplu, dacă ați eliminat fișiere din matrice după ultimul \`sync\`, acest lucru poate duce la nerecuperarea unor fișiere. În acest caz, puteți reîncerca \`fix\`\-ul utilizând opțiunea \-i, \-\-import, specificând unde se află acum aceste fișiere pentru a le include din nou în @@ -689,7 +689,7 @@ Nimic nu este modificat. Tipărește un raport SMART al tuturor discurilor din sistem. .PP Include o estimare a probabilității de eșec în anul următor, -permițându\-vă să planificați înlocuiri de întreținere a discurilor care prezintă +permițându\-vă să planificați înlocuiri de întreținere ale discurilor care prezintă atribute suspecte. .PP Această estimare a probabilității este obținută prin corelarea atributelor SMART @@ -701,7 +701,7 @@ https://www.backblaze.com/hard\-drive\-test\-data.html .PD .RE .PP -Dacă SMART raportează că un disc este pe cale să eșueze, \`FAIL\` sau \`PREFAIL\` este tipărit +Dacă SMART raportează că un disc este pe cale să se defecteze, \`FAIL\` sau \`PREFAIL\` este tipărit pentru acel disc, iar SnapRAID returnează o eroare. În acest caz, înlocuirea imediată a discului este puternic recomandată. .PP @@ -746,7 +746,7 @@ o comandă personalizată utilizând opțiunea \`smartctl\` în fișierul de con .PP Nimic nu este modificat. .SS up -Pornirea tuturor discurilor din matrice. +Pornește toate discurile din matrice. .PP Puteți porni doar discuri specifice utilizând opțiunea \-d, \-\-filter\-disk. .PP @@ -755,7 +755,7 @@ Asigurați\-vă că sursa dvs. de alimentare o poate susține. .PP Nimic nu este modificat. .SS down -Oprirea (spin down) tuturor discurilor din matrice. +Oprește (spin down) toate discurile din matrice. .PP Această comandă utilizează instrumentul \`smartctl\` și este echivalentă cu rularea \`smartctl \-s standby,now\` pe toate dispozitivele. @@ -768,7 +768,7 @@ atunci când apare o eroare. .PP Nimic nu este modificat. .SS diff -Listează toate fișierele modificate de la ultima \`sync\` care trebuie +Listează toate fișierele modificate de la ultimul \`sync\` care trebuie să li se recalculeze datele de paritate. .PP Această comandă nu verifică datele fișierului, ci doar marca temporală, @@ -801,8 +801,8 @@ Sunt identificate având același nume, dimensiune, marcă temporală Fișiere copiate pe același disc sau pe un disc diferit unde fișierul original încă există. Acestea sunt identificate prin faptul că au același nume, -dimensiune și amprentă temporală. -Dacă amprenta temporală sub\-secundă este zero, calea completă +dimensiune și marcă temporală. +Dacă marca temporală sub\-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate, nu doar numele. .HP 4 @@ -810,20 +810,20 @@ numele. Fișiere mutate pe același disc sau pe un disc diferit unde originalul a dispărut. Acestea sunt identificate prin faptul că au același nume, -dimensiune și amprentă temporală. -Dacă amprenta temporală sub\-secundă este zero, calea completă +dimensiune și marcă temporală. +Dacă marca temporală sub\-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate. Spre deosebire de fișierele \'moved\' de pe același disc, fișierele relocate au un inod diferit. .HP 4 .I restored Fișiere cu un inod diferit, dar care se potrivesc ca -director, nume, dimensiune și amprentă temporală. +director, nume, dimensiune și marcă temporală. Acestea sunt de obicei fișiere restaurate după ce au fost șterse. .PD .RE .PP -Dacă este necesară o \`sync\`, codul de retur al procesului este 2, în loc de +Dacă este necesară o sincronizare, codul de retur al procesului este 2, în loc de cel implicit 0. Codul de retur 1 este utilizat pentru o condiție de eroare generică. .PP Nimic nu este modificat. @@ -907,7 +907,7 @@ Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau dis Pentru a repara doar blocurile marcate ca defecte în timpul \`sync\` și \`scrub\`, utilizați opțiunea \-e, \-\-filter\-error. Spre deosebire de alte opțiuni de filtrare, aceasta aplică reparații doar fișierelor care sunt -neschimbate de la ultima \`sync\`. +neschimbate de la ultimul \`sync\`. .PP SnapRAID redenumește toate fișierele care nu pot fi reparate adăugând extensia \`.unrecoverable\`. @@ -943,7 +943,7 @@ Fișierele sunt identificate doar prin cale, nu prin inod. Nimic nu este modificat. .SS list Listează toate fișierele conținute în matrice la momentul -ultimei \`sync\`. +ultimului \`sync\`. .PP Cu \-v sau \-\-verbose, este afișat și timpul sub\-secundă. .PP @@ -1022,11 +1022,10 @@ fragmente pe care le ocupă. .PP Puteți utiliza opțiunea \-t, \-\-tail pentru a restricționa operațiunea la fișierele care ocupă porțiunea finală specificată a parității. -Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea -\-W, \-\-force\-realloc\-tail. .PP -Rețineți că astfel de fișiere nu vor fi protejate de paritate în timpul procesului -de realocare. +Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea +\-W, \-\-force\-realloc\-tail. Rețineți că astfel de fișiere nu vor +fi protejate de paritate în timpul procesului de realocare. .SH OPțIUNI (OPTIONS) SnapRAID oferă următoarele opțiuni: .TP @@ -1118,7 +1117,7 @@ Această opțiune poate fi utilizată doar cu \`sync\`. .TP .B \-i, \-\-import DIR Importă din directorul specificat orice fișiere șterse -din matrice după ultima \`sync\`. +din matrice după ultimul \`sync\`. Dacă mai aveți astfel de fișiere, ele pot fi utilizate de \`check\` și \`fix\` pentru a îmbunătăți procesul de recuperare. Fișierele sunt citite, inclusiv în subdirectoare, și sunt @@ -1136,9 +1135,9 @@ chiar și atunci când o comandă eșuează. .B \-w, \-\-bw\-limit RATE Aplică o limită globală de lățime de bandă pentru toate discurile. RATE este numărul de octeți pe secundă. Puteți specifica un multiplicator -cum ar fi K, M sau G (de exemplu, \-\-bw\-limit 1G). +cum ar fi K, M, G sau T (de exemplu, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail DIMENSIUNE +.B \-t, \-\-tail SIZE Limitează listarea fișierelor la cele care nu utilizează mai mult de dimensiunea finală specificată a discurilor de paritate. Puteți utiliza multiplicatori precum K, M, G sau T (ex. \-\-tail 1G). @@ -1181,11 +1180,7 @@ pe disc lipsesc sau au fost rescrise, se oprește din a continua dacă nu specificați această opțiune. Acest lucru vă permite să detectați cu ușurință când un sistem de fișiere de date nu este montat. -Este permis, totuși, să aveți o singură schimbare de UUID cu -paritate simplă și mai multe cu paritate multiplă, deoarece acesta este -cazul normal la înlocuirea discurilor după o recuperare. -Această opțiune poate fi utilizată doar cu \`sync\`, \`check\` sau -\`fix\`. +Această opțiune poate fi utilizată doar cu \`sync\`. .TP .B \-U, \-\-force\-uuid Forțează operațiunea nesigură de sincronizare, verificare și reparare @@ -1242,7 +1237,7 @@ ATENȚIE! Această opțiune este doar pentru experți și este puternic recomandat să nu o utilizați. NU aveți protecție a datelor în timpul operațiunii \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail DIMENSIUNE +.B \-W, \-\-force\-realloc\-tail SIZE Funcționează ca \-R, \-\-force\-realloc, dar limitat la porțiunea finală specificată (ultimii DIMENSIUNE octeți) ai fiecărui fișier de paritate. Forțează realocarea (mutarea) oricăror fragmente/blocuri de fișiere stocate @@ -1284,7 +1279,7 @@ Vedeți fișierul snapraid_log.txt sau pagina de manual pentru descrieri ale eti .B \-L, \-\-error\-limit NUMBER Setează o nouă limită de erori înainte de a opri execuția. În mod implicit, SnapRAID se oprește dacă întâlnește mai mult de 100 -de erori de intrare/ieșire, indicând că un disc probabil eșuează. +de erori de intrare/ieșire, indicând că un disc probabil se defectează. Această opțiune afectează \`sync\` și \`scrub\`, cărora li se permite să continue după primul set de erori de disc pentru a încerca să își finalizeze operațiunile. @@ -1368,7 +1363,7 @@ Pentru fiecare nivel de paritate specificat, este activat un nivel suplimentar d .IP \(bu 3\-parity activează paritatea triplă. .IP \(bu -4\-parity activează paritatea quad (patru). +4\-parity activează paritatea cvadruplă (patru). .IP \(bu 5\-parity activează paritatea penta (cinci). .IP \(bu @@ -1389,7 +1384,7 @@ CPU\-urilor low\-end precum ARM sau AMD Phenom, Athlon și Opteron care nu suportă setul de instrucțiuni SSSE3. În astfel de cazuri, oferă o performanță mai bună. .PP -Acest format este similar, dar mai rapid decât cel utilizat de ZFS RAIDZ3. +Acest format este similar cu cel utilizat de ZFS RAIDZ3, dar mai rapid decât acesta. Ca și ZFS, nu funcționează dincolo de paritatea triplă. .PP Când utilizați \`3\-parity\`, veți fi avertizați dacă este recomandat să utilizați @@ -1399,7 +1394,7 @@ Este posibil să convertiți de la un format la altul ajustând fișierul de configurare cu fișierul z\-parity sau 3\-parity dorit și utilizând \`fix\` pentru a\-l recrea. .SS content FILE -Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) a tuturor +Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) ale tuturor fișierelor prezente în matricea dvs. de discuri. .PP Poate fi plasat pe un disc utilizat pentru date, paritate sau @@ -1576,7 +1571,7 @@ RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB Salvează automat starea la sincronizare sau verificare după cantitatea specificată de GB procesați. Această opțiune este utilă pentru a evita repornirea comenzilor \`sync\` lungi -de la zero dacă sunt întrerupte de o cădere a mașinii sau de orice alt eveniment. +de la zero dacă sunt întrerupte de o pană de sistem sau de orice alt eveniment. .SS temp_limit TEMPERATURE_CELSIUS Setează temperatura maximă permisă a discului în Celsius. Când este specificată, SnapRAID verifică periodic temperatura tuturor discurilor utilizând @@ -1584,13 +1579,13 @@ instrumentul smartctl. Temperaturile curente ale discurilor sunt afișate în ti SnapRAID funcționează. Dacă un disc depășește această limită, toate operațiunile se opresc, iar discurile sunt oprite (puse în standby) pentru durata definită de opțiunea \`temp_sleep\`. După perioada de așteptare, operațiunile -reiau, putând întrerupe din nou dacă limita de temperatură este atinsă +se reiau, putând fi întrerupte din nou dacă limita de temperatură este atinsă încă o dată. .PP În timpul funcționării, SnapRAID analizează și curba de încălzire a fiecărui disc și estimează temperatura constantă pe termen lung pe care se așteaptă să o atingă dacă activitatea continuă. Estimarea este efectuată numai după -ce temperatura discului a crescut de patru ori, asigurându\-se că sunt disponibile +ce temperatura discului a înregistrat patru creșteri, asigurându\-se că sunt disponibile suficiente puncte de date pentru a stabili o tendință fiabilă. Această temperatură constantă prezisă este afișată între paranteze lângă valoarea curentă și ajută la evaluarea dacă răcirea sistemului este @@ -1669,7 +1664,7 @@ smartctl parity \-d sat %s .RE .SS smartignore DISK/PARITY ATTR [ATTR...] Ignoră atributul SMART specificat la calcularea probabilității -de eșec a discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau +de eșec al discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau înșelătoare pentru un anumit atribut. .PP DISK este același nume de disc specificat în opțiunea \`data\`. @@ -1809,7 +1804,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD 0 .PD .RE -.SH SNAPSHOTS +.SH SNAPSHOT\-URI (SNAPSHOTS) Dacă opțiunea snapshot este activată în configurație, SnapRAID utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice și consistente. @@ -1943,7 +1938,7 @@ caractere variabile, păstrând în același timp modelul limitat la un singur n .PP Asteriscul simplu \`*\` se potrivește cu orice secvență de caractere, dar, la fel ca semnul întrebării, nu trece niciodată de limitele directoarelor. Se oprește la -slash\-ul înainte, ceea ce îl face potrivit pentru potrivirea în cadrul unei singure +bara oblică (/), ceea ce îl face potrivit pentru potrivirea în cadrul unei singure componente a căii. Acesta este comportamentul standard al metacaracterelor, familiar din shell globbing. .PP @@ -2204,10 +2199,25 @@ un font TrueType precum \`Lucida Console\` ca font al consolei. Acest lucru afectează doar numele de fișiere tipărite; dacă redirecționați ieșirea consolei către un fișier, fișierul rezultat este întotdeauna în format UTF\-8. +.SH COD DE IEșIRE (EXIT CODE) +SnapRAID se termină cu următoarele coduri de eroare: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Totul este OK. +.HP 4 +.I 1 +Comanda a întâmpinat unele erori. +.HP 4 +.I 2 +Comanda \`diff\` a constatat că totul este OK, dar este necesar un \`sync\`. +.PD +.RE .SH TRADUCERE (TRANSLATION) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. .SH DREPT DE AUTOR (COPYRIGHT) -Acest fișier este Copyright (C) 2025 Andrea Mazzoleni +Acest fișier este Copyright (C) 2026 Andrea Mazzoleni .SH VEZI șI (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index 4ee3c113..a9247729 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -32,7 +32,7 @@ Descriere (Description) care se schimbă rar, SnapRAID oferă câteva caracteristici: * Puteți utiliza discuri deja pline cu fișiere fără - nevoia de a le reformat, accesându-le ca de obicei. + nevoia de a le reformata, accesându-le ca de obicei. * Toate datele dvs. sunt hash-uite pentru a asigura integritatea datelor și a preveni corupția silențioasă. * Când numărul de discuri defecte depășește numărul de parități, @@ -43,7 +43,7 @@ Descriere (Description) * Discurile pot avea dimensiuni diferite. * Puteți adăuga discuri în orice moment. * SnapRAID nu vă blochează datele; puteți înceta să-l utilizați - oricând fără a reforma sau muta date. + oricând fără a reformata sau muta date. * Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind energie și reducând zgomotul. @@ -212,7 +212,7 @@ Noțiuni de Bază (Getting Started) Agregare (Pooling) Notă: Funcționalitatea de pooling descrisă mai jos a fost înlocuită de instrumentul mergerfs, care este acum opțiunea recomandată pentru utilizatorii Linux în - comunitatea SnapRAID. Mergefs oferă o modalitate mai flexibilă și eficientă + comunitatea SnapRAID. Mergerfs oferă o modalitate mai flexibilă și eficientă de a agrega mai multe discuri într-un singur punct de montare unificat, permițând accesul neîntrerupt la fișiere pe toată matricea dvs. fără a se baza pe link-uri simbolice. Se integrează bine cu SnapRAID pentru protecția parității @@ -221,7 +221,7 @@ Noțiuni de Bază (Getting Started) Pentru a avea toate fișierele din matricea dvs. afișate în același arbore de directoare, puteți activa funcționalitatea de `pooling`. Aceasta creează o vizualizare virtuală - doar în citire a tuturor fișierelor din matricea dvs. folosind link-uri simbolice. + read-only a tuturor fișierelor din matricea dvs. folosind link-uri simbolice. Puteți configura directorul de `pooling` în fișierul de configurare cu: @@ -320,7 +320,7 @@ Noțiuni de Bază (Getting Started) a discului defect să indice o locație cu suficient spațiu gol pentru a recupera fișierele. - De exemplu, dacă discul `d1` a eșuat, schimbați de la: + De exemplu, dacă discul `d1` s-a defectat, schimbați de la: :data d1 /mnt/disk1/ @@ -356,7 +356,7 @@ Noțiuni de Bază (Getting Started) Dacă nu sunteți mulțumit de recuperare, o puteți reîncerca de câte ori doriți. - De exemplu, dacă ați eliminat fișiere din matrice după ultima + De exemplu, dacă ați eliminat fișiere din matrice după ultimul `sync`, acest lucru poate duce la nerecuperarea unor fișiere. În acest caz, puteți reîncerca `fix`-ul utilizând opțiunea -i, --import, specificând unde se află acum aceste fișiere pentru a le include din nou în @@ -421,7 +421,7 @@ Comenzi (Commands) Tipărește un raport SMART al tuturor discurilor din sistem. Include o estimare a probabilității de eșec în anul următor, - permițându-vă să planificați înlocuiri de întreținere a discurilor care prezintă + permițându-vă să planificați înlocuiri de întreținere ale discurilor care prezintă atribute suspecte. Această estimare a probabilității este obținută prin corelarea atributelor SMART @@ -429,7 +429,7 @@ Comenzi (Commands) :https://www.backblaze.com/hard-drive-test-data.html - Dacă SMART raportează că un disc este pe cale să eșueze, `FAIL` sau `PREFAIL` este tipărit + Dacă SMART raportează că un disc este pe cale să se defecteze, `FAIL` sau `PREFAIL` este tipărit pentru acel disc, iar SnapRAID returnează o eroare. În acest caz, înlocuirea imediată a discului este puternic recomandată. @@ -466,7 +466,7 @@ Comenzi (Commands) Nimic nu este modificat. up - Pornirea tuturor discurilor din matrice. + Pornește toate discurile din matrice. Puteți porni doar discuri specifice utilizând opțiunea -d, --filter-disk. @@ -476,7 +476,7 @@ Comenzi (Commands) Nimic nu este modificat. down - Oprirea (spin down) tuturor discurilor din matrice. + Oprește (spin down) toate discurile din matrice. Această comandă utilizează instrumentul `smartctl` și este echivalentă cu rularea `smartctl -s standby,now` pe toate dispozitivele. @@ -490,7 +490,7 @@ Comenzi (Commands) Nimic nu este modificat. diff - Listează toate fișierele modificate de la ultima `sync` care trebuie + Listează toate fișierele modificate de la ultimul `sync` care trebuie să li se recalculeze datele de paritate. Această comandă nu verifică datele fișierului, ci doar marca temporală, @@ -509,23 +509,23 @@ Comenzi (Commands) copied - Fișiere copiate pe același disc sau pe un disc diferit unde fișierul original încă există. Acestea sunt identificate prin faptul că au același nume, - dimensiune și amprentă temporală. - Dacă amprenta temporală sub-secundă este zero, calea completă + dimensiune și marcă temporală. + Dacă marca temporală sub-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate, nu doar numele. relocated - Fișiere mutate pe același disc sau pe un disc diferit unde originalul a dispărut. Acestea sunt identificate prin faptul că au același nume, - dimensiune și amprentă temporală. - Dacă amprenta temporală sub-secundă este zero, calea completă + dimensiune și marcă temporală. + Dacă marca temporală sub-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate. Spre deosebire de fișierele 'moved' de pe același disc, fișierele relocate au un inod diferit. restored - Fișiere cu un inod diferit, dar care se potrivesc ca - director, nume, dimensiune și amprentă temporală. + director, nume, dimensiune și marcă temporală. Acestea sunt de obicei fișiere restaurate după ce au fost șterse. - Dacă este necesară o `sync`, codul de retur al procesului este 2, în loc de + Dacă este necesară o sincronizare, codul de retur al procesului este 2, în loc de cel implicit 0. Codul de retur 1 este utilizat pentru o condiție de eroare generică. Nimic nu este modificat. @@ -612,7 +612,7 @@ Comenzi (Commands) Pentru a repara doar blocurile marcate ca defecte în timpul `sync` și `scrub`, utilizați opțiunea -e, --filter-error. Spre deosebire de alte opțiuni de filtrare, aceasta aplică reparații doar fișierelor care sunt - neschimbate de la ultima `sync`. + neschimbate de la ultimul `sync`. SnapRAID redenumește toate fișierele care nu pot fi reparate adăugând extensia `.unrecoverable`. @@ -650,7 +650,7 @@ Comenzi (Commands) list Listează toate fișierele conținute în matrice la momentul - ultimei `sync`. + ultimului `sync`. Cu -v sau --verbose, este afișat și timpul sub-secundă. @@ -735,11 +735,10 @@ Comenzi (Commands) Puteți utiliza opțiunea -t, --tail pentru a restricționa operațiunea la fișierele care ocupă porțiunea finală specificată a parității. - Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea - -W, --force-realloc-tail. - Rețineți că astfel de fișiere nu vor fi protejate de paritate în timpul procesului - de realocare. + Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea + -W, --force-realloc-tail. Rețineți că astfel de fișiere nu vor + fi protejate de paritate în timpul procesului de realocare. Opțiuni (Options) SnapRAID oferă următoarele opțiuni: @@ -832,7 +831,7 @@ Opțiuni (Options) -i, --import DIR Importă din directorul specificat orice fișiere șterse - din matrice după ultima `sync`. + din matrice după ultimul `sync`. Dacă mai aveți astfel de fișiere, ele pot fi utilizate de `check` și `fix` pentru a îmbunătăți procesul de recuperare. Fișierele sunt citite, inclusiv în subdirectoare, și sunt @@ -850,9 +849,9 @@ Opțiuni (Options) -w, --bw-limit RATE Aplică o limită globală de lățime de bandă pentru toate discurile. RATE este numărul de octeți pe secundă. Puteți specifica un multiplicator - cum ar fi K, M sau G (de exemplu, --bw-limit 1G). + cum ar fi K, M, G sau T (de exemplu, --bw-limit 1G). - -t, --tail DIMENSIUNE + -t, --tail SIZE Limitează listarea fișierelor la cele care nu utilizează mai mult de dimensiunea finală specificată a discurilor de paritate. Puteți utiliza multiplicatori precum K, M, G sau T (ex. --tail 1G). @@ -895,11 +894,7 @@ Opțiuni (Options) dacă nu specificați această opțiune. Acest lucru vă permite să detectați cu ușurință când un sistem de fișiere de date nu este montat. - Este permis, totuși, să aveți o singură schimbare de UUID cu - paritate simplă și mai multe cu paritate multiplă, deoarece acesta este - cazul normal la înlocuirea discurilor după o recuperare. - Această opțiune poate fi utilizată doar cu `sync`, `check` sau - `fix`. + Această opțiune poate fi utilizată doar cu `sync`. -U, --force-uuid Forțează operațiunea nesigură de sincronizare, verificare și reparare @@ -956,7 +951,7 @@ Opțiuni (Options) recomandat să nu o utilizați. NU aveți protecție a datelor în timpul operațiunii `sync`. - -W, --force-realloc-tail DIMENSIUNE + -W, --force-realloc-tail SIZE Funcționează ca -R, --force-realloc, dar limitat la porțiunea finală specificată (ultimii DIMENSIUNE octeți) ai fiecărui fișier de paritate. Forțează realocarea (mutarea) oricăror fragmente/blocuri de fișiere stocate @@ -998,7 +993,7 @@ Opțiuni (Options) -L, --error-limit NUMBER Setează o nouă limită de erori înainte de a opri execuția. În mod implicit, SnapRAID se oprește dacă întâlnește mai mult de 100 - de erori de intrare/ieșire, indicând că un disc probabil eșuează. + de erori de intrare/ieșire, indicând că un disc probabil se defectează. Această opțiune afectează `sync` și `scrub`, cărora li se permite să continue după primul set de erori de disc pentru a încerca să își finalizeze operațiunile. @@ -1082,7 +1077,7 @@ Configurare (Configuration) * 2-parity activează paritatea dublă RAID6. * 3-parity activează paritatea triplă. - * 4-parity activează paritatea quad (patru). + * 4-parity activează paritatea cvadruplă (patru). * 5-parity activează paritatea penta (cinci). * 6-parity activează paritatea hexa (șase). @@ -1101,7 +1096,7 @@ Configurare (Configuration) suportă setul de instrucțiuni SSSE3. În astfel de cazuri, oferă o performanță mai bună. - Acest format este similar, dar mai rapid decât cel utilizat de ZFS RAIDZ3. + Acest format este similar cu cel utilizat de ZFS RAIDZ3, dar mai rapid decât acesta. Ca și ZFS, nu funcționează dincolo de paritatea triplă. Când utilizați `3-parity`, veți fi avertizați dacă este recomandat să utilizați @@ -1112,7 +1107,7 @@ Configurare (Configuration) și utilizând `fix` pentru a-l recrea. content FILE - Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) a tuturor + Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) ale tuturor fișierelor prezente în matricea dvs. de discuri. Poate fi plasat pe un disc utilizat pentru date, paritate sau @@ -1285,7 +1280,7 @@ Configurare (Configuration) Salvează automat starea la sincronizare sau verificare după cantitatea specificată de GB procesați. Această opțiune este utilă pentru a evita repornirea comenzilor `sync` lungi - de la zero dacă sunt întrerupte de o cădere a mașinii sau de orice alt eveniment. + de la zero dacă sunt întrerupte de o pană de sistem sau de orice alt eveniment. temp_limit TEMPERATURE_CELSIUS Setează temperatura maximă permisă a discului în Celsius. Când este specificată, @@ -1294,13 +1289,13 @@ Configurare (Configuration) SnapRAID funcționează. Dacă un disc depășește această limită, toate operațiunile se opresc, iar discurile sunt oprite (puse în standby) pentru durata definită de opțiunea `temp_sleep`. După perioada de așteptare, operațiunile - reiau, putând întrerupe din nou dacă limita de temperatură este atinsă + se reiau, putând fi întrerupte din nou dacă limita de temperatură este atinsă încă o dată. În timpul funcționării, SnapRAID analizează și curba de încălzire a fiecărui disc și estimează temperatura constantă pe termen lung pe care se așteaptă să o atingă dacă activitatea continuă. Estimarea este efectuată numai după - ce temperatura discului a crescut de patru ori, asigurându-se că sunt disponibile + ce temperatura discului a înregistrat patru creșteri, asigurându-se că sunt disponibile suficiente puncte de date pentru a stabili o tendință fiabilă. Această temperatură constantă prezisă este afișată între paranteze lângă valoarea curentă și ajută la evaluarea dacă răcirea sistemului este @@ -1370,7 +1365,7 @@ Configurare (Configuration) smartignore DISK/PARITY ATTR [ATTR...] Ignoră atributul SMART specificat la calcularea probabilității - de eșec a discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau + de eșec al discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau înșelătoare pentru un anumit atribut. DISK este același nume de disc specificat în opțiunea `data`. @@ -1424,7 +1419,7 @@ Configurare (Configuration) :smartctl parity -d areca,1/1 /dev/arcmsr0 :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 -Snapshots +Snapshot-uri (Snapshots) Dacă opțiunea snapshot este activată în configurație, SnapRAID utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice și consistente. @@ -1548,7 +1543,7 @@ Model (Pattern) Asteriscul simplu `*` se potrivește cu orice secvență de caractere, dar, la fel ca semnul întrebării, nu trece niciodată de limitele directoarelor. Se oprește la - slash-ul înainte, ceea ce îl face potrivit pentru potrivirea în cadrul unei singure + bara oblică (/), ceea ce îl face potrivit pentru potrivirea în cadrul unei singure componente a căii. Acesta este comportamentul standard al metacaracterelor, familiar din shell globbing. @@ -1728,12 +1723,19 @@ Codare (Encoding) redirecționați ieșirea consolei către un fișier, fișierul rezultat este întotdeauna în format UTF-8. +Cod de ieșire (Exit Code) + SnapRAID se termină cu următoarele coduri de eroare: + + 0 - Totul este OK. + 1 - Comanda a întâmpinat unele erori. + 2 - Comanda `diff` a constatat că totul este OK, dar este necesar un `sync`. + Traducere (Translation) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. Drept de Autor (Copyright) - Acest fișier este Copyright (C) 2025 Andrea Mazzoleni + Acest fișier este Copyright (C) 2026 Andrea Mazzoleni Vezi și (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 4bb10491..8ea6f639 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -39,7 +39,7 @@ Destinat în principal centrelor media de acasă cu fișiere mari, care se schimbă rar, SnapRAID oferă câteva caracteristici: * Puteți utiliza discuri deja pline cu fișiere fără - nevoia de a le reformat, accesându-le ca de obicei. + nevoia de a le reformata, accesându-le ca de obicei. * Toate datele dvs. sunt hash-uite pentru a asigura integritatea datelor și a preveni corupția silențioasă. * Când numărul de discuri defecte depășește numărul de parități, @@ -50,7 +50,7 @@ care se schimbă rar, SnapRAID oferă câteva caracteristici: * Discurile pot avea dimensiuni diferite. * Puteți adăuga discuri în orice moment. * SnapRAID nu vă blochează datele; puteți înceta să-l utilizați - oricând fără a reforma sau muta date. + oricând fără a reformata sau muta date. * Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind energie și reducând zgomotul. @@ -229,7 +229,7 @@ dar blocurile aferente nu sunt marcate ca defecte. Notă: Funcționalitatea de pooling descrisă mai jos a fost înlocuită de instrumentul mergerfs, care este acum opțiunea recomandată pentru utilizatorii Linux în -comunitatea SnapRAID. Mergefs oferă o modalitate mai flexibilă și eficientă +comunitatea SnapRAID. Mergerfs oferă o modalitate mai flexibilă și eficientă de a agrega mai multe discuri într-un singur punct de montare unificat, permițând accesul neîntrerupt la fișiere pe toată matricea dvs. fără a se baza pe link-uri simbolice. Se integrează bine cu SnapRAID pentru protecția parității @@ -238,7 +238,7 @@ sau configurații NAS personalizate. Pentru a avea toate fișierele din matricea dvs. afișate în același arbore de directoare, puteți activa funcționalitatea de `pooling`. Aceasta creează o vizualizare virtuală -doar în citire a tuturor fișierelor din matricea dvs. folosind link-uri simbolice. +read-only a tuturor fișierelor din matricea dvs. folosind link-uri simbolice. Puteți configura directorul de `pooling` în fișierul de configurare cu: @@ -341,7 +341,7 @@ Modificați fișierul de configurare SnapRAID pentru a face ca opțiunea `data` a discului defect să indice o locație cu suficient spațiu gol pentru a recupera fișierele. -De exemplu, dacă discul `d1` a eșuat, schimbați de la: +De exemplu, dacă discul `d1` s-a defectat, schimbați de la: data d1 /mnt/disk1/ @@ -377,7 +377,7 @@ verificând toate liniile care încep cu `unrecoverable:`. Dacă nu sunteți mulțumit de recuperare, o puteți reîncerca de câte ori doriți. -De exemplu, dacă ați eliminat fișiere din matrice după ultima +De exemplu, dacă ați eliminat fișiere din matrice după ultimul `sync`, acest lucru poate duce la nerecuperarea unor fișiere. În acest caz, puteți reîncerca `fix`-ul utilizând opțiunea -i, --import, specificând unde se află acum aceste fișiere pentru a le include din nou în @@ -449,7 +449,7 @@ Nimic nu este modificat. Tipărește un raport SMART al tuturor discurilor din sistem. Include o estimare a probabilității de eșec în anul următor, -permițându-vă să planificați înlocuiri de întreținere a discurilor care prezintă +permițându-vă să planificați înlocuiri de întreținere ale discurilor care prezintă atribute suspecte. Această estimare a probabilității este obținută prin corelarea atributelor SMART @@ -457,7 +457,7 @@ ale discurilor cu datele Backblaze disponibile la: https://www.backblaze.com/hard-drive-test-data.html -Dacă SMART raportează că un disc este pe cale să eșueze, `FAIL` sau `PREFAIL` este tipărit +Dacă SMART raportează că un disc este pe cale să se defecteze, `FAIL` sau `PREFAIL` este tipărit pentru acel disc, iar SnapRAID returnează o eroare. În acest caz, înlocuirea imediată a discului este puternic recomandată. @@ -498,7 +498,7 @@ Nimic nu este modificat. 5.4 up ------ -Pornirea tuturor discurilor din matrice. +Pornește toate discurile din matrice. Puteți porni doar discuri specifice utilizând opțiunea -d, --filter-disk. @@ -510,7 +510,7 @@ Nimic nu este modificat. 5.5 down -------- -Oprirea (spin down) tuturor discurilor din matrice. +Oprește (spin down) toate discurile din matrice. Această comandă utilizează instrumentul `smartctl` și este echivalentă cu rularea `smartctl -s standby,now` pe toate dispozitivele. @@ -526,7 +526,7 @@ Nimic nu este modificat. 5.6 diff -------- -Listează toate fișierele modificate de la ultima `sync` care trebuie +Listează toate fișierele modificate de la ultimul `sync` care trebuie să li se recalculeze datele de paritate. Această comandă nu verifică datele fișierului, ci doar marca temporală, @@ -545,23 +545,23 @@ grupate după: copied - Fișiere copiate pe același disc sau pe un disc diferit unde fișierul original încă există. Acestea sunt identificate prin faptul că au același nume, - dimensiune și amprentă temporală. - Dacă amprenta temporală sub-secundă este zero, calea completă + dimensiune și marcă temporală. + Dacă marca temporală sub-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate, nu doar numele. relocated - Fișiere mutate pe același disc sau pe un disc diferit unde originalul a dispărut. Acestea sunt identificate prin faptul că au același nume, - dimensiune și amprentă temporală. - Dacă amprenta temporală sub-secundă este zero, calea completă + dimensiune și marcă temporală. + Dacă marca temporală sub-secundă este zero, calea completă trebuie să se potrivească pentru a fi identificate. Spre deosebire de fișierele 'moved' de pe același disc, fișierele relocate au un inod diferit. restored - Fișiere cu un inod diferit, dar care se potrivesc ca - director, nume, dimensiune și amprentă temporală. + director, nume, dimensiune și marcă temporală. Acestea sunt de obicei fișiere restaurate după ce au fost șterse. -Dacă este necesară o `sync`, codul de retur al procesului este 2, în loc de +Dacă este necesară o sincronizare, codul de retur al procesului este 2, în loc de cel implicit 0. Codul de retur 1 este utilizat pentru o condiție de eroare generică. Nimic nu este modificat. @@ -654,7 +654,7 @@ Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau dis Pentru a repara doar blocurile marcate ca defecte în timpul `sync` și `scrub`, utilizați opțiunea -e, --filter-error. Spre deosebire de alte opțiuni de filtrare, aceasta aplică reparații doar fișierelor care sunt -neschimbate de la ultima `sync`. +neschimbate de la ultimul `sync`. SnapRAID redenumește toate fișierele care nu pot fi reparate adăugând extensia `.unrecoverable`. @@ -696,7 +696,7 @@ Nimic nu este modificat. --------- Listează toate fișierele conținute în matrice la momentul -ultimei `sync`. +ultimului `sync`. Cu -v sau --verbose, este afișat și timpul sub-secundă. @@ -793,11 +793,10 @@ fragmente pe care le ocupă. Puteți utiliza opțiunea -t, --tail pentru a restricționa operațiunea la fișierele care ocupă porțiunea finală specificată a parității. -Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea --W, --force-realloc-tail. -Rețineți că astfel de fișiere nu vor fi protejate de paritate în timpul procesului -de realocare. +Dacă doriți să realocați aceste fișiere, puteți utiliza apoi opțiunea +-W, --force-realloc-tail. Rețineți că astfel de fișiere nu vor +fi protejate de paritate în timpul procesului de realocare. 6 OPțIUNI (OPTIONS) @@ -893,7 +892,7 @@ SnapRAID oferă următoarele opțiuni: -i, --import DIR Importă din directorul specificat orice fișiere șterse - din matrice după ultima `sync`. + din matrice după ultimul `sync`. Dacă mai aveți astfel de fișiere, ele pot fi utilizate de `check` și `fix` pentru a îmbunătăți procesul de recuperare. Fișierele sunt citite, inclusiv în subdirectoare, și sunt @@ -911,9 +910,9 @@ SnapRAID oferă următoarele opțiuni: -w, --bw-limit RATE Aplică o limită globală de lățime de bandă pentru toate discurile. RATE este numărul de octeți pe secundă. Puteți specifica un multiplicator - cum ar fi K, M sau G (de exemplu, --bw-limit 1G). + cum ar fi K, M, G sau T (de exemplu, --bw-limit 1G). - -t, --tail DIMENSIUNE + -t, --tail SIZE Limitează listarea fișierelor la cele care nu utilizează mai mult de dimensiunea finală specificată a discurilor de paritate. Puteți utiliza multiplicatori precum K, M, G sau T (ex. --tail 1G). @@ -956,11 +955,7 @@ SnapRAID oferă următoarele opțiuni: dacă nu specificați această opțiune. Acest lucru vă permite să detectați cu ușurință când un sistem de fișiere de date nu este montat. - Este permis, totuși, să aveți o singură schimbare de UUID cu - paritate simplă și mai multe cu paritate multiplă, deoarece acesta este - cazul normal la înlocuirea discurilor după o recuperare. - Această opțiune poate fi utilizată doar cu `sync`, `check` sau - `fix`. + Această opțiune poate fi utilizată doar cu `sync`. -U, --force-uuid Forțează operațiunea nesigură de sincronizare, verificare și reparare @@ -1017,7 +1012,7 @@ SnapRAID oferă următoarele opțiuni: recomandat să nu o utilizați. NU aveți protecție a datelor în timpul operațiunii `sync`. - -W, --force-realloc-tail DIMENSIUNE + -W, --force-realloc-tail SIZE Funcționează ca -R, --force-realloc, dar limitat la porțiunea finală specificată (ultimii DIMENSIUNE octeți) ai fiecărui fișier de paritate. Forțează realocarea (mutarea) oricăror fragmente/blocuri de fișiere stocate @@ -1059,7 +1054,7 @@ SnapRAID oferă următoarele opțiuni: -L, --error-limit NUMBER Setează o nouă limită de erori înainte de a opri execuția. În mod implicit, SnapRAID se oprește dacă întâlnește mai mult de 100 - de erori de intrare/ieșire, indicând că un disc probabil eșuează. + de erori de intrare/ieșire, indicând că un disc probabil se defectează. Această opțiune afectează `sync` și `scrub`, cărora li se permite să continue după primul set de erori de disc pentru a încerca să își finalizeze operațiunile. @@ -1150,7 +1145,7 @@ Pentru fiecare nivel de paritate specificat, este activat un nivel suplimentar d * 2-parity activează paritatea dublă RAID6. * 3-parity activează paritatea triplă. -* 4-parity activează paritatea quad (patru). +* 4-parity activează paritatea cvadruplă (patru). * 5-parity activează paritatea penta (cinci). * 6-parity activează paritatea hexa (șase). @@ -1171,7 +1166,7 @@ CPU-urilor low-end precum ARM sau AMD Phenom, Athlon și Opteron care nu suportă setul de instrucțiuni SSSE3. În astfel de cazuri, oferă o performanță mai bună. -Acest format este similar, dar mai rapid decât cel utilizat de ZFS RAIDZ3. +Acest format este similar cu cel utilizat de ZFS RAIDZ3, dar mai rapid decât acesta. Ca și ZFS, nu funcționează dincolo de paritatea triplă. Când utilizați `3-parity`, veți fi avertizați dacă este recomandat să utilizați @@ -1184,7 +1179,7 @@ fișierul de configurare cu fișierul z-parity sau 3-parity dorit 7.4 content FILE ---------------- -Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) a tuturor +Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) ale tuturor fișierelor prezente în matricea dvs. de discuri. Poate fi plasat pe un disc utilizat pentru date, paritate sau @@ -1373,7 +1368,7 @@ RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB Salvează automat starea la sincronizare sau verificare după cantitatea specificată de GB procesați. Această opțiune este utilă pentru a evita repornirea comenzilor `sync` lungi -de la zero dacă sunt întrerupte de o cădere a mașinii sau de orice alt eveniment. +de la zero dacă sunt întrerupte de o pană de sistem sau de orice alt eveniment. 7.13 temp_limit TEMPERATURE_CELSIUS ----------------------------------- @@ -1384,13 +1379,13 @@ instrumentul smartctl. Temperaturile curente ale discurilor sunt afișate în ti SnapRAID funcționează. Dacă un disc depășește această limită, toate operațiunile se opresc, iar discurile sunt oprite (puse în standby) pentru durata definită de opțiunea `temp_sleep`. După perioada de așteptare, operațiunile -reiau, putând întrerupe din nou dacă limita de temperatură este atinsă +se reiau, putând fi întrerupte din nou dacă limita de temperatură este atinsă încă o dată. În timpul funcționării, SnapRAID analizează și curba de încălzire a fiecărui disc și estimează temperatura constantă pe termen lung pe care se așteaptă să o atingă dacă activitatea continuă. Estimarea este efectuată numai după -ce temperatura discului a crescut de patru ori, asigurându-se că sunt disponibile +ce temperatura discului a înregistrat patru creșteri, asigurându-se că sunt disponibile suficiente puncte de date pentru a stabili o tendință fiabilă. Această temperatură constantă prezisă este afișată între paranteze lângă valoarea curentă și ajută la evaluarea dacă răcirea sistemului este @@ -1470,7 +1465,7 @@ De exemplu: ------------------------------------------- Ignoră atributul SMART specificat la calcularea probabilității -de eșec a discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau +de eșec al discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau înșelătoare pentru un anumit atribut. DISK este același nume de disc specificat în opțiunea `data`. @@ -1527,8 +1522,8 @@ Un exemplu de configurare tipică pentru Windows este: smartctl 2-parity -d areca,2/1 /dev/arcmsr0 -8 SNAPSHOTS -=========== +8 SNAPSHOT-URI (SNAPSHOTS) +========================== Dacă opțiunea snapshot este activată în configurație, SnapRAID utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice @@ -1661,7 +1656,7 @@ caractere variabile, păstrând în același timp modelul limitat la un singur n Asteriscul simplu `*` se potrivește cu orice secvență de caractere, dar, la fel ca semnul întrebării, nu trece niciodată de limitele directoarelor. Se oprește la -slash-ul înainte, ceea ce îl face potrivit pentru potrivirea în cadrul unei singure +bara oblică (/), ceea ce îl face potrivit pentru potrivirea în cadrul unei singure componente a căii. Acesta este comportamentul standard al metacaracterelor, familiar din shell globbing. @@ -1854,20 +1849,30 @@ redirecționați ieșirea consolei către un fișier, fișierul rezultat este î în format UTF-8. -15 TRADUCERE (TRANSLATION) +15 COD DE IEșIRE (EXIT CODE) +============================ + +SnapRAID se termină cu următoarele coduri de eroare: + +0 - Totul este OK. +1 - Comanda a întâmpinat unele erori. +2 - Comanda `diff` a constatat că totul este OK, dar este necesar un `sync`. + + +16 TRADUCERE (TRANSLATION) ========================== Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. -16 DREPT DE AUTOR (COPYRIGHT) +17 DREPT DE AUTOR (COPYRIGHT) ============================= -Acest fișier este Copyright (C) 2025 Andrea Mazzoleni +Acest fișier este Copyright (C) 2026 Andrea Mazzoleni -17 VEZI șI (SEE ALSO) +18 VEZI șI (SEE ALSO) ===================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 0f7a2a64..8eec30ff 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -123,7 +123,7 @@ SnapRAID — это гибрид между RAID и программой рез .PP Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до состояния последней операции синхронизации (\`sync\`). Любые данные, добавленные или измененные -с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны. +с момента последней синхронизации и находящиеся на отказавшем диске, будут потеряны. .PP Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются. .PP @@ -139,9 +139,9 @@ SnapRAID может автоматически поддерживать замо .PD 0 .IP \(bu Без поддержки снимков удаление или изменение файлов после \`sync\` -может предотвратить полное восстановление других дисков, давших сбой. Это происходит +может предотвратить полное восстановление других отказавших дисков. Это происходит потому, что четность больше не соответствует измененным файлам, даже если -эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные +эти файлы находятся не на отказавшем диске. С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже существующих файлов. .PD .PP @@ -369,7 +369,7 @@ snapraid \-p bad scrub .SS Объединение (Pooling) Примечание: Функция объединения (pooling), описанная ниже, была заменена инструментом mergerfs, который теперь является рекомендуемым вариантом для пользователей Linux -в сообществе SnapRAID. Mergefs предоставляет более гибкий и эффективный +в сообществе SnapRAID. Mergerfs предоставляет более гибкий и эффективный способ объединения нескольких дисков в единую точку монтирования, обеспечивая беспрепятственный доступ к файлам по всему массиву без опоры на символические ссылки. Он хорошо интегрируется со SnapRAID для @@ -1140,9 +1140,9 @@ DAYS — это минимальный возраст в днях для бло .B \-w, \-\-bw\-limit RATE Применяет глобальное ограничение пропускной способности для всех дисков. RATE — это количество байтов в секунду. Вы можете указать множитель, -например K, M или G (например, \-\-bw\-limit 1G). +например K, M, G или T (например, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail РАЗМЕР +.B \-t, \-\-tail SIZE Ограничивает список файлов теми, которые используют не более указанного размера хвоста дисков четности. Можно использовать множители, такие как K, M, G или T (например, \-\-tail 1G). @@ -1244,9 +1244,9 @@ DAYS — это минимальный возраст в днях для бло настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail РАЗМЕР +.B \-W, \-\-force\-realloc\-tail SIZE Работает как \-R, \-\-force\-realloc, но ограничивается указанной хвостовой -частью (последние РАЗМЕР байт) каждого файла четности. +частью (последние SIZE байт) каждого файла четности. Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, хранящиеся в данный момент в этой хвостовой части, позволяя разместить их в любом месте файла(ов) четности, где есть свободное место @@ -1703,7 +1703,7 @@ smartignore parity 197 5 .PD 0 .PD .RE -.SS Examples +.SS Примеры (Examples) Пример типичной конфигурации для Unix: .PP .RS 4 @@ -1835,7 +1835,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RS 4 он остается сохраненным в снимке. Если сбой диска произойдет до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные -в снимке, для реконструкции давшего сбой диска. +в снимке, для реконструкции отказавшего диска. .RE .PP .RS 4 @@ -1850,7 +1850,7 @@ SnapRAID также может автоматически читать как и .RS 4 Без снимков обновленный или удаленный файл на исправном диске приводит к отсутствию блоков данных, которые могут потребоваться для -восстановления других дисков, давших сбой. +восстановления других отказавших дисков. .RE .PP Снимки создаются только для дисков с данными и только в том случае, если базовая @@ -2203,10 +2203,25 @@ SnapRAID в Unix игнорирует любое кодирование. Он с Это влияет только на печатаемые имена файлов; если вы перенаправляете вывод консоли в файл, результирующий файл всегда в формате UTF\-8. +.SH Код возврата (EXIT CODE) +SnapRAID завершает работу со следующими кодами ошибок: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Все в порядке. +.HP 4 +.I 1 +Команда обнаружила ошибки. +.HP 4 +.I 2 +Команда \`diff\` определила, что все в порядке, но требуется \`sync\`. +.PD +.RE .SH Перевод (TRANSLATION) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. .SH Авторские права (COPYRIGHT) -Этот файл защищен авторским правом (C) 2025 Andrea Mazzoleni +Этот файл защищен авторским правом (C) 2026 Andrea Mazzoleni .SH См. также (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index 9144c684..e08681a4 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -57,7 +57,7 @@ Name{number} Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до состояния последней операции синхронизации (`sync`). Любые данные, добавленные или измененные - с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны. + с момента последней синхронизации и находящиеся на отказавшем диске, будут потеряны. Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются. @@ -70,9 +70,9 @@ Name{number} во время или после синхронизации, процесс восстановления останется согласованным и надежным. * Без поддержки снимков удаление или изменение файлов после `sync` - может предотвратить полное восстановление других дисков, давших сбой. Это происходит + может предотвратить полное восстановление других отказавших дисков. Это происходит потому, что четность больше не соответствует измененным файлам, даже если - эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные + эти файлы находятся не на отказавшем диске. С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже существующих файлов. Другие ограничения SnapRAID: @@ -211,7 +211,7 @@ Name{number} Объединение (Pooling) Примечание: Функция объединения (pooling), описанная ниже, была заменена инструментом mergerfs, который теперь является рекомендуемым вариантом для пользователей Linux - в сообществе SnapRAID. Mergefs предоставляет более гибкий и эффективный + в сообществе SnapRAID. Mergerfs предоставляет более гибкий и эффективный способ объединения нескольких дисков в единую точку монтирования, обеспечивая беспрепятственный доступ к файлам по всему массиву без опоры на символические ссылки. Он хорошо интегрируется со SnapRAID для @@ -854,9 +854,9 @@ Name{number} -w, --bw-limit RATE Применяет глобальное ограничение пропускной способности для всех дисков. RATE — это количество байтов в секунду. Вы можете указать множитель, - например K, M или G (например, --bw-limit 1G). + например K, M, G или T (например, --bw-limit 1G). - -t, --tail РАЗМЕР + -t, --tail SIZE Ограничивает список файлов теми, которые используют не более указанного размера хвоста дисков четности. Можно использовать множители, такие как K, M, G или T (например, --tail 1G). @@ -958,9 +958,9 @@ Name{number} настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции `sync`. - -W, --force-realloc-tail РАЗМЕР + -W, --force-realloc-tail SIZE Работает как -R, --force-realloc, но ограничивается указанной хвостовой - частью (последние РАЗМЕР байт) каждого файла четности. + частью (последние SIZE байт) каждого файла четности. Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, хранящиеся в данный момент в этой хвостовой части, позволяя разместить их в любом месте файла(ов) четности, где есть свободное место @@ -1394,7 +1394,7 @@ Name{number} :smartignore parity 197 5 - Examples + Примеры (Examples) Пример типичной конфигурации для Unix: :parity /mnt/diskp/snapraid.parity @@ -1444,7 +1444,7 @@ Name{number} Восстановление — Если файл обновляется или удаляется из живой файловой системы, он остается сохраненным в снимке. Если сбой диска произойдет до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные - в снимке, для реконструкции давшего сбой диска. + в снимке, для реконструкции отказавшего диска. В случае сбоя диска во время активного процесса sync, SnapRAID также может автоматически читать как из снимка предыдущего @@ -1455,7 +1455,7 @@ Name{number} Без снимков обновленный или удаленный файл на исправном диске приводит к отсутствию блоков данных, которые могут потребоваться для - восстановления других дисков, давших сбой. + восстановления других отказавших дисков. Снимки создаются только для дисков с данными и только в том случае, если базовая файловая система поддерживает эту функциональность. Диски четности всегда используют @@ -1729,12 +1729,19 @@ Name{number} перенаправляете вывод консоли в файл, результирующий файл всегда в формате UTF-8. +Код возврата (Exit Code) + SnapRAID завершает работу со следующими кодами ошибок: + + 0 - Все в порядке. + 1 - Команда обнаружила ошибки. + 2 - Команда `diff` определила, что все в порядке, но требуется `sync`. + Перевод (Translation) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. Авторские права (Copyright) - Этот файл защищен авторским правом (C) 2025 Andrea Mazzoleni + Этот файл защищен авторским правом (C) 2026 Andrea Mazzoleni См. также (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index c211820b..c08f7f63 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -67,7 +67,7 @@ SnapRAID — это гибрид между RAID и программой рез Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до состояния последней операции синхронизации (`sync`). Любые данные, добавленные или измененные -с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны. +с момента последней синхронизации и находящиеся на отказавшем диске, будут потеряны. Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются. @@ -80,9 +80,9 @@ SnapRAID — это гибрид между RAID и программой рез во время или после синхронизации, процесс восстановления останется согласованным и надежным. * Без поддержки снимков удаление или изменение файлов после `sync` - может предотвратить полное восстановление других дисков, давших сбой. Это происходит + может предотвратить полное восстановление других отказавших дисков. Это происходит потому, что четность больше не соответствует измененным файлам, даже если - эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные + эти файлы находятся не на отказавшем диске. С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже существующих файлов. Другие ограничения SnapRAID: @@ -228,7 +228,7 @@ SnapRAID — это гибрид между RAID и программой рез Примечание: Функция объединения (pooling), описанная ниже, была заменена инструментом mergerfs, который теперь является рекомендуемым вариантом для пользователей Linux -в сообществе SnapRAID. Mergefs предоставляет более гибкий и эффективный +в сообществе SnapRAID. Mergerfs предоставляет более гибкий и эффективный способ объединения нескольких дисков в единую точку монтирования, обеспечивая беспрепятственный доступ к файлам по всему массиву без опоры на символические ссылки. Он хорошо интегрируется со SnapRAID для @@ -915,9 +915,9 @@ SnapRAID предоставляет следующие опции: -w, --bw-limit RATE Применяет глобальное ограничение пропускной способности для всех дисков. RATE — это количество байтов в секунду. Вы можете указать множитель, - например K, M или G (например, --bw-limit 1G). + например K, M, G или T (например, --bw-limit 1G). - -t, --tail РАЗМЕР + -t, --tail SIZE Ограничивает список файлов теми, которые используют не более указанного размера хвоста дисков четности. Можно использовать множители, такие как K, M, G или T (например, --tail 1G). @@ -1019,9 +1019,9 @@ SnapRAID предоставляет следующие опции: настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции `sync`. - -W, --force-realloc-tail РАЗМЕР + -W, --force-realloc-tail SIZE Работает как -R, --force-realloc, но ограничивается указанной хвостовой - частью (последние РАЗМЕР байт) каждого файла четности. + частью (последние SIZE байт) каждого файла четности. Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, хранящиеся в данный момент в этой хвостовой части, позволяя разместить их в любом месте файла(ов) четности, где есть свободное место @@ -1494,8 +1494,8 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, smartignore parity 197 5 -7.19 Examples -------------- +7.19 Примеры (Examples) +----------------------- Пример типичной конфигурации для Unix: @@ -1549,7 +1549,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, Восстановление — Если файл обновляется или удаляется из живой файловой системы, он остается сохраненным в снимке. Если сбой диска произойдет до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные - в снимке, для реконструкции давшего сбой диска. + в снимке, для реконструкции отказавшего диска. В случае сбоя диска во время активного процесса sync, SnapRAID также может автоматически читать как из снимка предыдущего @@ -1560,7 +1560,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, Без снимков обновленный или удаленный файл на исправном диске приводит к отсутствию блоков данных, которые могут потребоваться для - восстановления других дисков, давших сбой. + восстановления других отказавших дисков. Снимки создаются только для дисков с данными и только в том случае, если базовая файловая система поддерживает эту функциональность. Диски четности всегда используют @@ -1855,20 +1855,30 @@ SnapRAID в Unix игнорирует любое кодирование. Он с в формате UTF-8. -15 Перевод (TRANSLATION) +15 Код возврата (EXIT CODE) +=========================== + +SnapRAID завершает работу со следующими кодами ошибок: + +0 - Все в порядке. +1 - Команда обнаружила ошибки. +2 - Команда `diff` определила, что все в порядке, но требуется `sync`. + + +16 Перевод (TRANSLATION) ======================== Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. -16 Авторские права (COPYRIGHT) +17 Авторские права (COPYRIGHT) ============================== -Этот файл защищен авторским правом (C) 2025 Andrea Mazzoleni +Этот файл защищен авторским правом (C) 2026 Andrea Mazzoleni -17 См. также (SEE ALSO) +18 См. также (SEE ALSO) ======================= snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 0951b19f..640bc7d1 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -123,7 +123,7 @@ de bästa fördelarna med båda. Det har dock vissa begränsningar som du bör överväga innan du använder det. .PP Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till -tillståndet för den senaste \`sync\`\-iseringen. Data som lagts till eller modifieringar som gjorts +tillståndet för den senaste \`sync\`\-operationen. Data som lagts till eller modifieringar som gjorts sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade. .PP Följaktligen är SnapRAID främst lämpat för data som sällan ändras. @@ -371,7 +371,7 @@ utdata, men de relaterade blocken markeras inte som dåliga. .SS Poolning (Pooling) Obs: Poolningsfunktionen som beskrivs nedan har ersatts av verktyget mergerfs, som nu är det rekommenderade alternativet för Linux\-användare i -SnapRAID\-communityt. Mergefs ger ett mer flexibelt och effektivt +SnapRAID\-communityt. Mergerfs ger ett mer flexibelt och effektivt sätt att poola flera enheter till en enda enhetlig monteringspunkt, vilket möjliggör sömlös åtkomst till filer över din array utan att förlita sig på symboliska länkar. Det integreras väl med SnapRAID för paritetsskydd @@ -522,7 +522,7 @@ kan användas för att återställa eller ångra radering av filer till deras ti med hjälp av alternativet \-f, \-\-filter: .PP .RS 4 -snapraid fix \-f FIL +snapraid fix \-f FILE .PD 0 .PD .RE @@ -530,7 +530,7 @@ snapraid fix \-f FIL eller för en katalog: .PP .RS 4 -snapraid fix \-f KATALOG/ +snapraid fix \-f DIR/ .PD 0 .PD .RE @@ -540,7 +540,7 @@ en katalog med hjälp av alternativet \-m, \-\-filter\-missing, som återställe endast saknade filer, och lämnar alla andra orörda. .PP .RS 4 -snapraid fix \-m \-f KATALOG/ +snapraid fix \-m \-f DIR/ .PD 0 .PD .RE @@ -593,12 +593,12 @@ Om du har flera felaktiga diskar, uppdatera alla deras konfigurationsalternativ. Kör kommandot fix och lagra loggen i en extern fil med: .PP .RS 4 -snapraid \-d NAMN \-l fix.log fix +snapraid \-d NAME \-l fix.log fix .PD 0 .PD .RE .PP -Där NAMN är namnet på disken, till exempel \`d1\` i vårt tidigare exempel. +Där NAME är namnet på disken, till exempel \`d1\` i vårt tidigare exempel. Om disken som ska återställas är en paritetsdisk, använd namnen \`parity\`, \`2\-parity\`, etc. Om du har flera felaktiga diskar, använd flera \-d\-alternativ för att specificera alla @@ -621,24 +621,24 @@ gånger du vill. .PP Om du till exempel har tagit bort filer från arrayen efter den senaste \`sync\`, kan detta leda till att vissa filer inte återställs. -I detta fall kan du försöka igen \`fix\` med alternativet \-i, \-\-import, +I detta fall kan du köra \`fix\` igen med alternativet \-i, \-\-import, specificera var dessa filer nu finns för att inkludera dem igen i återställningsprocessen. .PP Om du är nöjd med återställningen kan du fortsätta, -men notera att efter synkronisering kan du inte försöka igen kommandot \`fix\` +men notera att efter synkronisering kan du inte köra \`fix\`\-kommandot igen längre! .SS STEG 3 \-> Kontrollera Som en försiktighetsåtgärd kan du nu köra ett \`check\`\-kommando för att säkerställa att allt är korrekt på den återställda disken. .PP .RS 4 -snapraid \-d NAMN \-a check +snapraid \-d NAME \-a check .PD 0 .PD .RE .PP -Där NAMN är namnet på disken, till exempel \`d1\` i vårt tidigare exempel. +Där NAME är namnet på disken, till exempel \`d1\` i vårt tidigare exempel. .PP Alternativen \-d och \-a talar om för SnapRAID att endast kontrollera den specificerade disken och ignorera all paritetsdata. @@ -901,11 +901,11 @@ Filerna i arrayen modifieras INTE. Lagar alla filer och paritetsdata. .PP Alla filer och paritetsdata jämförs med det tillstånd som sparades i -den senaste \`sync\`\-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet. +den senaste \`sync\`\-operationen. Om en skillnad hittas återställs den till det sparade tillståndet. .PP VARNING! Kommandot \`fix\` skiljer inte mellan fel och avsiktliga modifieringar. -Det återställer villkorslöst filtillståndet till den senaste \`sync\`\-iseringen. +Det återställer villkorslöst filtillståndet till den senaste \`sync\`\-operationen. .PP Om inget annat alternativ specificeras, behandlas hela arrayen. Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med. @@ -920,7 +920,7 @@ SnapRAID döper om alla filer som inte kan fixas genom att lägga till tillägge .PP Innan fixningen skannas hela arrayen för att hitta alla filer som flyttats sedan den senaste \`sync\`\-operationen. -Dessa filer identifieras av deras tidsstämpel, ignorera deras namn +Dessa filer identifieras av deras tidsstämpel, oavsett namn och katalog, och används i återställningsprocessen vid behov. Om du flyttade några av dem utanför arrayen kan du använda alternativet \-i, \-\-import för att specificera ytterligare kataloger att skanna. @@ -951,7 +951,7 @@ Inget ändras. Listar alla filer som finns i arrayen vid tidpunkten för den senaste \`sync\`. .PP -Med \-v eller \-\-verbose visas även undertiden. +Med \-v eller \-\-verbose visas även subsekundprecisionen. .PP Inget ändras. .SS dup @@ -988,16 +988,16 @@ lågnivåenheter som används av en enda disk i arrayen. .PP Inget ändras. .SS touch -Anger en godtycklig undertidsstämpel för alla filer +Anger en godtycklig tidsstämpel för undersekunder för alla filer som har den satt till noll. .PP Detta förbättrar SnapRAIDs förmåga att känna igen flyttade och kopierade filer, eftersom det gör tidsstämpeln nästan unik, vilket minskar möjliga dubbletter. .PP -Mer specifikt, om undertidsstämpeln inte är noll, +Mer specifikt, om tidsstämpeln för undersekunder inte är noll, identifieras en flyttad eller kopierad fil som sådan om den matchar -namn, storlek och tidsstämpel. Om undertidsstämpeln +namn, storlek och tidsstämpel. Om tidsstämpeln för undersekunder är noll, betraktas den som en kopia endast om hela sökvägen, storlek och tidsstämpel alla matchar. .PP @@ -1046,7 +1046,7 @@ katalog som \`snapraid.exe\`. Filtrerar filerna att behandla i \`check\` och \`fix\`. Endast filerna som matchar det specificerade mönstret behandlas. Detta alternativ kan användas flera gånger. -Se avsnittet MÖNSTER för mer information om +Se avsnittet PATTERN för mer information om mönsterspecifikationer. I Unix, se till att globbing\-tecken citeras om de används. Detta alternativ kan endast användas med \`check\` och \`fix\`. @@ -1144,7 +1144,7 @@ Tillämpar en global bandbreddsbegränsning för alla diskar. RATE är antalet byte per sekund. Du kan specificera en multiplikator som K, M eller G (t.ex. \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail STORLEK +.B \-t, \-\-tail SIZE Begränsa fillistan till de som inte använder mer än den angivna slutstorleken på paritetsdiskarna. Du kan använda multiplikatorer som K, M, G eller T (t.ex. \-\-tail 1G). @@ -1206,7 +1206,7 @@ Detta alternativ kan endast användas med \`sync\`, \`check\` eller .B \-D, \-\-force\-device Tvingar den osäkra operationen att fixa med otillgängliga diskar eller med diskar på samma fysiska enhet. -Till exempel, om du förlorade två datadisker och har en reservdisk för att återställa +Till exempel, om du förlorade två datadiskar och har en reservdisk för att återställa endast den första, kan du ignorera den andra otillgängliga disken. Eller, om du vill återställa en disk i det lediga utrymme som finns kvar på en redan använd disk, dela samma fysiska enhet. @@ -1245,9 +1245,9 @@ VARNING! Detta alternativ är endast för experter, och det rekommenderas starkt att inte använda det. Du HAR INGET dataskydd under \`sync\`\-operationen. .TP -.B \-W, \-\-force\-realloc\-tail STORLEK +.B \-W, \-\-force\-realloc\-tail SIZE Fungerar som \-R, \-\-force\-realloc, men begränsat till den angivna -slutdelen (de sista STORLEK byten) av varje paritetsfil. +slutdelen (de sista SIZE byten) av varje paritetsfil. Den tvingar omallokering (flytt) av alla filfragment/block som för närvarande lagras i den slutsektionen, vilket gör att de kan placeras var som helst i paritetsfilen/filerna där ledigt utrymme finns @@ -1294,7 +1294,7 @@ Däremot stoppar \`check\` och \`fix\` alltid vid det första felet. .TP .B \-S, \-\-start BLKSTART Börjar behandlingen från det specificerade -blocknumret. Detta kan vara användbart för att försöka igen att kontrollera +blocknumret. Detta kan vara användbart för att på nytt försöka kontrollera eller fixa specifika block i händelse av en skadad disk. Detta alternativ är främst för avancerad manuell återställning. .TP @@ -1340,7 +1340,7 @@ I Windows används filen \`snapraid.conf\` i samma katalog som \`snapraid.exe\`. .PP Den måste innehålla följande alternativ (skiftlägeskänsligt): -.SS parity FIL [,FIL] ... +.SS parity FILE [,FILE] ... Definierar de filer som ska användas för att lagra paritetsinformationen. Pariteten möjliggör skydd från ett enda disk\- fel, liknande RAID5. @@ -1360,7 +1360,7 @@ I Windows lämnas 256 MB oanvänt på varje disk för att undvika varningen om fulla diskar. .PP Detta alternativ är obligatoriskt och kan endast användas en gång. -.SS (2,3,4,5,6)\-parity FIL [,FIL] ... +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... Definierar de filer som ska användas för att lagra extra paritetsinformation. .PP För varje paritetsnivå som specificeras aktiveras en ytterligare skyddsnivå: @@ -1383,7 +1383,7 @@ nivåer. Samma överväganden som för alternativet \`parity\` gäller. .PP Dessa alternativ är valfria och kan endast användas en gång. -.SS z\-parity FIL [,FIL] ... +.SS z\-parity FILE [,FILE] ... Definierar en alternativ fil och ett format för att lagra trippel paritet. .PP Detta alternativ är ett alternativ till \`3\-parity\`, främst avsett för @@ -1400,7 +1400,7 @@ formatet \`z\-parity\` för prestandaförbättring. Det är möjligt att konvertera från ett format till ett annat genom att justera konfigurationsfilen med önskad z\-parity eller 3\-parity fil och använda \`fix\` för att återskapa den. -.SS content FIL +.SS content FILE Definierar den fil som ska användas för att lagra listan och checksummorna för alla filer som finns i din disk\-array. .PP @@ -1414,18 +1414,18 @@ flera kopior av samma fil. .PP Du måste lagra minst en kopia för varje paritetsdisk som används plus en. Att använda ytterligare kopior skadar inte. -.SS data NAMN KATALOG +.SS data NAME DIR Definierar namnet och monteringspunkten för datadiskarna i -arrayen. NAMN används för att identifiera disken och måste -vara unikt. KATALOG är monteringspunkten för disken i +arrayen. NAME används för att identifiera disken och måste +vara unikt. DIR är monteringspunkten för disken i filsystemet. .PP Du kan ändra monteringspunkten vid behov, så länge -du behåller NAMN fixerat. +du behåller NAME fixerat. .PP Du bör använda ett alternativ för varje datadisk i arrayen. .PP -Du kan byta namn på en disk senare genom att ändra NAMN direkt +Du kan byta namn på en disk senare genom att ändra NAME direkt i konfigurationsfilen och sedan köra ett \`sync\`\-kommando. I händelse av namnbyte görs associationen med hjälp av den lagrade UUID:n för diskarna. @@ -1466,7 +1466,7 @@ Se avsnittet SNAPSHOTS för en detaljerad förklaring av ögonblicksbildens livs Exkluderar alla dolda filer och kataloger. I Unix är dolda filer de som börjar med \`.\`. I Windows är de de med det dolda attributet. -.SS exclude/include MÖNSTER +.SS exclude/include PATTERN Definierar fil\- eller katalogmönstren att exkludera eller inkludera i sync\-processen. Alla mönster behandlas i den specificerade ordningen. @@ -1477,11 +1477,11 @@ Om inget mönster matchar, exkluderas filen om det sista mönstret som specificerats är ett \`include\`\-mönster, eller inkluderas om det sista mönstret som specificerats är ett \`exclude\`\-mönster. .PP -Se avsnittet MÖNSTER för mer information om mönster\- +Se avsnittet PATTERN för mer information om mönster\- specifikationer. .PP Detta alternativ kan användas flera gånger. -.SS blocksize STORLEK_I_KIBIBYTES +.SS blocksize SIZE_IN_KIBIBYTES Definierar den grundläggande blockstorleken i kibibytes för pariteten. En kibibyte är 1024 byte. .PP @@ -1530,7 +1530,7 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE Detta resulterar i cirka 1,5% extra utrymme, ungefär 60 GB för en 4 TB\-disk, vilket möjliggör cirka 460 000 filer på varje datadisk utan något bortkastat utrymme. -.SS hashsize STORLEK_I_BYTE +.SS hashsize SIZE_IN_BYTES Definierar hash\-storleken i byte för de sparade blocken. .PP Standard hash\-storlek är 16 byte (128 bitar), vilket bör fungera @@ -1573,12 +1573,12 @@ Om du byter till både en hash\-storlek på 8 och en blockstorlek på 512 får d RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB .PD 0 .PD -.SS autosave STORLEK_I_GIGABYTES +.SS autosave SIZE_IN_GIGABYTES Sparar automatiskt tillståndet vid synkronisering eller skrubbning efter att den specificerade mängden GB har behandlats. Detta alternativ är användbart för att undvika att starta om långa \`sync\`\- kommandon från början om de avbryts av en maskinkrasch eller någon annan händelse. -.SS temp_limit TEMPERATUR_CELSIUS +.SS temp_limit TEMPERATURE_CELSIUS Anger den maximalt tillåtna disk\-temperaturen i Celsius. När den specificeras, kontrollerar SnapRAID periodiskt temperaturen på alla diskar med hjälp av verktyget smartctl. De aktuella disk\-temperaturerna visas medan @@ -1593,29 +1593,29 @@ disk och uppskattar den långsiktiga stabila temperaturen de förväntas nå om aktiviteten fortsätter. Uppskattningen utförs först efter att disk\-temperaturen har ökat fyra gånger, vilket säkerställer att tillräckligt med datapoäng finns tillgängliga för att fastställa en pålitlig trend. -Denna förutsagda stabila temperatur visas inom parentes bredvid den +Denna förutsagda stabila temperatur visas inom parentes bredvid det aktuella värdet och hjälper till att bedöma om systemets kylning är tillräcklig. Denna uppskattade temperatur är endast för informationssyfte -och har ingen effekt på SnapRAIDs beteende. Programmens +och har ingen effekt på SnapRAIDs beteende. Programmets åtgärder baseras enbart på de faktiska uppmätta disk\-temperaturerna. .PP -För att utföra denna analys behöver SnapRAID en referens för system\- -temperaturen. Det försöker först läsa den från tillgängliga hårdvaru\- -sensorer. Om ingen system\-sensor kan nås, används den lägsta disk\- -temperaturen som mättes vid start av körningen som en reservreferens. +För att utföra denna analys behöver SnapRAID en referens för systemtemperaturen. +Det försöker först läsa den från tillgängliga hårdvarusensorer. +Om ingen systemsensor kan nås, används den lägsta disk\- +temperaturen som mättes i början av körningen som en reservreferens. .PP Normalt visar SnapRAID endast temperaturen på den hetaste disken. För att visa temperaturen på alla diskar, använd alternativet \-A eller \-\-stats. -.SS temp_sleep TID_I_MINUTER +.SS temp_sleep TIME_IN_MINUTES Anger standby\-tiden, i minuter, när temperaturgränsen har nåtts. Under denna period förblir diskarna nedsnurrade. Standard är 5 minuter. -.SS pool KATALOG +.SS pool DIR Definierar poolningskatalogen där den virtuella vyn av disk\- arrayen skapas med hjälp av kommandot \`pool\`. .PP Katalogen måste redan existera. -.SS share UNC_KATALOG +.SS share UNC_DIR Definierar Windows UNC\-sökvägen som krävs för att få åtkomst till diskarna på distans. .PP Om detta alternativ specificeras, använder de symboliska länkarna som skapats i pool\- @@ -1628,7 +1628,7 @@ disk\-namnet som specificeras i \`data\`\-alternativet, och lägger slutligen ti katalog och namn. .PP Detta alternativ krävs endast för Windows. -.SS smartctl DISK/PARITY ALTERNATIV... +.SS smartctl DISK/PARITY OPTIONS... Definierar anpassade smartctl\-alternativ för att få SMART\-attributen för varje disk. Detta kan krävas för RAID\-kontroller och vissa USB\- diskar som inte kan upptäckas automatiskt. Platsinnehavaren %s ersätts av @@ -1683,7 +1683,7 @@ Varje attribut kan specificeras som ett nummer från 1 till 255, eller som ett skiftlägesokänsligt namn (t.ex. \`Current_Pending_Sector\`). .PP Till exempel, för att ignorera attributen \`Current Pending Sector Count\` och -\`Reallocated Sectors Count\` på alla diskar med deras nummer oder namn: +\`Reallocated Sectors Count\` på alla diskar med deras nummer eller namn: .PP .RS 4 smartignore * 197 5 @@ -2204,10 +2204,25 @@ ett TrueType\-typsnitt som \`Lucida Console\` som konsoltypsnitt. Detta påverkar endast de utskrivna filnamnen; om du omdirigerar konsolutdata till en fil, är den resulterande filen alltid i UTF\-8\-format. +.SH SLUTKOD (EXIT CODE) +SnapRAID avslutas med följande statuskoder: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Allt OK. +.HP 4 +.I 1 +Kommandot stötte på fel. +.HP 4 +.I 2 +Kommandot \`diff\` fann att allt är OK, men en \`sync\` behövs. +.PD +.RE .SH ÖVERSäTTNING (TRANSLATION) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. .SH UPPHOVSRäTT (COPYRIGHT) -Denna fil är Copyright (C) 2025 Andrea Mazzoleni +Denna fil är Copyright (C) 2026 Andrea Mazzoleni .SH SE äVEN (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index 1225ec64..cd74c84e 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -57,7 +57,7 @@ Begränsningar (Limitations) överväga innan du använder det. Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till - tillståndet för den senaste `sync`-iseringen. Data som lagts till eller modifieringar som gjorts + tillståndet för den senaste `sync`-operationen. Data som lagts till eller modifieringar som gjorts sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade. Följaktligen är SnapRAID främst lämpat för data som sällan ändras. @@ -213,7 +213,7 @@ Kom igång (Getting Started) Poolning (Pooling) Obs: Poolningsfunktionen som beskrivs nedan har ersatts av verktyget mergerfs, som nu är det rekommenderade alternativet för Linux-användare i - SnapRAID-communityt. Mergefs ger ett mer flexibelt och effektivt + SnapRAID-communityt. Mergerfs ger ett mer flexibelt och effektivt sätt att poola flera enheter till en enda enhetlig monteringspunkt, vilket möjliggör sömlös åtkomst till filer över din array utan att förlita sig på symboliska länkar. Det integreras väl med SnapRAID för paritetsskydd @@ -287,17 +287,17 @@ Kom igång (Getting Started) kan användas för att återställa eller ångra radering av filer till deras tidigare tillstånd med hjälp av alternativet -f, --filter: - :snapraid fix -f FIL + :snapraid fix -f FILE eller för en katalog: - :snapraid fix -f KATALOG/ + :snapraid fix -f DIR/ Du kan också använda det för att återställa endast oavsiktligt raderade filer inuti en katalog med hjälp av alternativet -m, --filter-missing, som återställer endast saknade filer, och lämnar alla andra orörda. - :snapraid fix -m -f KATALOG/ + :snapraid fix -m -f DIR/ Eller för att återställa alla raderade filer på alla enheter med: @@ -337,9 +337,9 @@ Kom igång (Getting Started) STEG 2 -> Fixa Kör kommandot fix och lagra loggen i en extern fil med: - :snapraid -d NAMN -l fix.log fix + :snapraid -d NAME -l fix.log fix - Där NAMN är namnet på disken, till exempel `d1` i vårt tidigare exempel. + Där NAME är namnet på disken, till exempel `d1` i vårt tidigare exempel. Om disken som ska återställas är en paritetsdisk, använd namnen `parity`, `2-parity`, etc. Om du har flera felaktiga diskar, använd flera -d-alternativ för att specificera alla @@ -362,21 +362,21 @@ Kom igång (Getting Started) Om du till exempel har tagit bort filer från arrayen efter den senaste `sync`, kan detta leda till att vissa filer inte återställs. - I detta fall kan du försöka igen `fix` med alternativet -i, --import, + I detta fall kan du köra `fix` igen med alternativet -i, --import, specificera var dessa filer nu finns för att inkludera dem igen i återställningsprocessen. Om du är nöjd med återställningen kan du fortsätta, - men notera att efter synkronisering kan du inte försöka igen kommandot `fix` + men notera att efter synkronisering kan du inte köra `fix`-kommandot igen längre! STEG 3 -> Kontrollera Som en försiktighetsåtgärd kan du nu köra ett `check`-kommando för att säkerställa att allt är korrekt på den återställda disken. - :snapraid -d NAMN -a check + :snapraid -d NAME -a check - Där NAMN är namnet på disken, till exempel `d1` i vårt tidigare exempel. + Där NAME är namnet på disken, till exempel `d1` i vårt tidigare exempel. Alternativen -d och -a talar om för SnapRAID att endast kontrollera den specificerade disken och ignorera all paritetsdata. @@ -606,11 +606,11 @@ Kommandon (Commands) Lagar alla filer och paritetsdata. Alla filer och paritetsdata jämförs med det tillstånd som sparades i - den senaste `sync`-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet. + den senaste `sync`-operationen. Om en skillnad hittas återställs den till det sparade tillståndet. VARNING! Kommandot `fix` skiljer inte mellan fel och avsiktliga modifieringar. - Det återställer villkorslöst filtillståndet till den senaste `sync`-iseringen. + Det återställer villkorslöst filtillståndet till den senaste `sync`-operationen. Om inget annat alternativ specificeras, behandlas hela arrayen. Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med. @@ -625,7 +625,7 @@ Kommandon (Commands) Innan fixningen skannas hela arrayen för att hitta alla filer som flyttats sedan den senaste `sync`-operationen. - Dessa filer identifieras av deras tidsstämpel, ignorera deras namn + Dessa filer identifieras av deras tidsstämpel, oavsett namn och katalog, och används i återställningsprocessen vid behov. Om du flyttade några av dem utanför arrayen kan du använda alternativet -i, --import för att specificera ytterligare kataloger att skanna. @@ -658,7 +658,7 @@ Kommandon (Commands) Listar alla filer som finns i arrayen vid tidpunkten för den senaste `sync`. - Med -v eller --verbose visas även undertiden. + Med -v eller --verbose visas även subsekundprecisionen. Inget ändras. @@ -699,16 +699,16 @@ Kommandon (Commands) Inget ändras. touch - Anger en godtycklig undertidsstämpel för alla filer + Anger en godtycklig tidsstämpel för undersekunder för alla filer som har den satt till noll. Detta förbättrar SnapRAIDs förmåga att känna igen flyttade och kopierade filer, eftersom det gör tidsstämpeln nästan unik, vilket minskar möjliga dubbletter. - Mer specifikt, om undertidsstämpeln inte är noll, + Mer specifikt, om tidsstämpeln för undersekunder inte är noll, identifieras en flyttad eller kopierad fil som sådan om den matchar - namn, storlek och tidsstämpel. Om undertidsstämpeln + namn, storlek och tidsstämpel. Om tidsstämpeln för undersekunder är noll, betraktas den som en kopia endast om hela sökvägen, storlek och tidsstämpel alla matchar. @@ -760,7 +760,7 @@ Alternativ (Options) Filtrerar filerna att behandla i `check` och `fix`. Endast filerna som matchar det specificerade mönstret behandlas. Detta alternativ kan användas flera gånger. - Se avsnittet MÖNSTER för mer information om + Se avsnittet PATTERN för mer information om mönsterspecifikationer. I Unix, se till att globbing-tecken citeras om de används. Detta alternativ kan endast användas med `check` och `fix`. @@ -858,7 +858,7 @@ Alternativ (Options) antalet byte per sekund. Du kan specificera en multiplikator som K, M eller G (t.ex. --bw-limit 1G). - -t, --tail STORLEK + -t, --tail SIZE Begränsa fillistan till de som inte använder mer än den angivna slutstorleken på paritetsdiskarna. Du kan använda multiplikatorer som K, M, G eller T (t.ex. --tail 1G). @@ -920,7 +920,7 @@ Alternativ (Options) -D, --force-device Tvingar den osäkra operationen att fixa med otillgängliga diskar eller med diskar på samma fysiska enhet. - Till exempel, om du förlorade två datadisker och har en reservdisk för att återställa + Till exempel, om du förlorade två datadiskar och har en reservdisk för att återställa endast den första, kan du ignorera den andra otillgängliga disken. Eller, om du vill återställa en disk i det lediga utrymme som finns kvar på en redan använd disk, dela samma fysiska enhet. @@ -959,9 +959,9 @@ Alternativ (Options) starkt att inte använda det. Du HAR INGET dataskydd under `sync`-operationen. - -W, --force-realloc-tail STORLEK + -W, --force-realloc-tail SIZE Fungerar som -R, --force-realloc, men begränsat till den angivna - slutdelen (de sista STORLEK byten) av varje paritetsfil. + slutdelen (de sista SIZE byten) av varje paritetsfil. Den tvingar omallokering (flytt) av alla filfragment/block som för närvarande lagras i den slutsektionen, vilket gör att de kan placeras var som helst i paritetsfilen/filerna där ledigt utrymme finns @@ -1008,7 +1008,7 @@ Alternativ (Options) -S, --start BLKSTART Börjar behandlingen från det specificerade - blocknumret. Detta kan vara användbart för att försöka igen att kontrollera + blocknumret. Detta kan vara användbart för att på nytt försöka kontrollera eller fixa specifika block i händelse av en skadad disk. Detta alternativ är främst för avancerad manuell återställning. @@ -1056,7 +1056,7 @@ Konfiguration (Configuration) Den måste innehålla följande alternativ (skiftlägeskänsligt): - parity FIL [,FIL] ... + parity FILE [,FILE] ... Definierar de filer som ska användas för att lagra paritetsinformationen. Pariteten möjliggör skydd från ett enda disk- fel, liknande RAID5. @@ -1077,7 +1077,7 @@ Konfiguration (Configuration) Detta alternativ är obligatoriskt och kan endast användas en gång. - (2,3,4,5,6)-parity FIL [,FIL] ... + (2,3,4,5,6)-parity FILE [,FILE] ... Definierar de filer som ska användas för att lagra extra paritetsinformation. För varje paritetsnivå som specificeras aktiveras en ytterligare skyddsnivå: @@ -1095,7 +1095,7 @@ Konfiguration (Configuration) Dessa alternativ är valfria och kan endast användas en gång. - z-parity FIL [,FIL] ... + z-parity FILE [,FILE] ... Definierar en alternativ fil och ett format för att lagra trippel paritet. Detta alternativ är ett alternativ till `3-parity`, främst avsett för @@ -1113,7 +1113,7 @@ Konfiguration (Configuration) konfigurationsfilen med önskad z-parity eller 3-parity fil och använda `fix` för att återskapa den. - content FIL + content FILE Definierar den fil som ska användas för att lagra listan och checksummorna för alla filer som finns i din disk-array. @@ -1128,18 +1128,18 @@ Konfiguration (Configuration) Du måste lagra minst en kopia för varje paritetsdisk som används plus en. Att använda ytterligare kopior skadar inte. - data NAMN KATALOG + data NAME DIR Definierar namnet och monteringspunkten för datadiskarna i - arrayen. NAMN används för att identifiera disken och måste - vara unikt. KATALOG är monteringspunkten för disken i + arrayen. NAME används för att identifiera disken och måste + vara unikt. DIR är monteringspunkten för disken i filsystemet. Du kan ändra monteringspunkten vid behov, så länge - du behåller NAMN fixerat. + du behåller NAME fixerat. Du bör använda ett alternativ för varje datadisk i arrayen. - Du kan byta namn på en disk senare genom att ändra NAMN direkt + Du kan byta namn på en disk senare genom att ändra NAME direkt i konfigurationsfilen och sedan köra ett `sync`-kommando. I händelse av namnbyte görs associationen med hjälp av den lagrade UUID:n för diskarna. @@ -1184,7 +1184,7 @@ Konfiguration (Configuration) I Unix är dolda filer de som börjar med `.`. I Windows är de de med det dolda attributet. - exclude/include MÖNSTER + exclude/include PATTERN Definierar fil- eller katalogmönstren att exkludera eller inkludera i sync-processen. Alla mönster behandlas i den specificerade ordningen. @@ -1195,12 +1195,12 @@ Konfiguration (Configuration) som specificerats är ett `include`-mönster, eller inkluderas om det sista mönstret som specificerats är ett `exclude`-mönster. - Se avsnittet MÖNSTER för mer information om mönster- + Se avsnittet PATTERN för mer information om mönster- specifikationer. Detta alternativ kan användas flera gånger. - blocksize STORLEK_I_KIBIBYTES + blocksize SIZE_IN_KIBIBYTES Definierar den grundläggande blockstorleken i kibibytes för pariteten. En kibibyte är 1024 byte. @@ -1246,7 +1246,7 @@ Konfiguration (Configuration) en 4 TB-disk, vilket möjliggör cirka 460 000 filer på varje datadisk utan något bortkastat utrymme. - hashsize STORLEK_I_BYTE + hashsize SIZE_IN_BYTES Definierar hash-storleken i byte för de sparade blocken. Standard hash-storlek är 16 byte (128 bitar), vilket bör fungera @@ -1282,13 +1282,13 @@ Konfiguration (Configuration) :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB - autosave STORLEK_I_GIGABYTES + autosave SIZE_IN_GIGABYTES Sparar automatiskt tillståndet vid synkronisering eller skrubbning efter att den specificerade mängden GB har behandlats. Detta alternativ är användbart för att undvika att starta om långa `sync`- kommandon från början om de avbryts av en maskinkrasch eller någon annan händelse. - temp_limit TEMPERATUR_CELSIUS + temp_limit TEMPERATURE_CELSIUS Anger den maximalt tillåtna disk-temperaturen i Celsius. När den specificeras, kontrollerar SnapRAID periodiskt temperaturen på alla diskar med hjälp av verktyget smartctl. De aktuella disk-temperaturerna visas medan @@ -1303,32 +1303,32 @@ Konfiguration (Configuration) nå om aktiviteten fortsätter. Uppskattningen utförs först efter att disk-temperaturen har ökat fyra gånger, vilket säkerställer att tillräckligt med datapoäng finns tillgängliga för att fastställa en pålitlig trend. - Denna förutsagda stabila temperatur visas inom parentes bredvid den + Denna förutsagda stabila temperatur visas inom parentes bredvid det aktuella värdet och hjälper till att bedöma om systemets kylning är tillräcklig. Denna uppskattade temperatur är endast för informationssyfte - och har ingen effekt på SnapRAIDs beteende. Programmens + och har ingen effekt på SnapRAIDs beteende. Programmets åtgärder baseras enbart på de faktiska uppmätta disk-temperaturerna. - För att utföra denna analys behöver SnapRAID en referens för system- - temperaturen. Det försöker först läsa den från tillgängliga hårdvaru- - sensorer. Om ingen system-sensor kan nås, används den lägsta disk- - temperaturen som mättes vid start av körningen som en reservreferens. + För att utföra denna analys behöver SnapRAID en referens för systemtemperaturen. + Det försöker först läsa den från tillgängliga hårdvarusensorer. + Om ingen systemsensor kan nås, används den lägsta disk- + temperaturen som mättes i början av körningen som en reservreferens. Normalt visar SnapRAID endast temperaturen på den hetaste disken. För att visa temperaturen på alla diskar, använd alternativet -A eller --stats. - temp_sleep TID_I_MINUTER + temp_sleep TIME_IN_MINUTES Anger standby-tiden, i minuter, när temperaturgränsen har nåtts. Under denna period förblir diskarna nedsnurrade. Standard är 5 minuter. - pool KATALOG + pool DIR Definierar poolningskatalogen där den virtuella vyn av disk- arrayen skapas med hjälp av kommandot `pool`. Katalogen måste redan existera. - share UNC_KATALOG + share UNC_DIR Definierar Windows UNC-sökvägen som krävs för att få åtkomst till diskarna på distans. Om detta alternativ specificeras, använder de symboliska länkarna som skapats i pool- @@ -1342,7 +1342,7 @@ Konfiguration (Configuration) Detta alternativ krävs endast för Windows. - smartctl DISK/PARITY ALTERNATIV... + smartctl DISK/PARITY OPTIONS... Definierar anpassade smartctl-alternativ för att få SMART-attributen för varje disk. Detta kan krävas för RAID-kontroller och vissa USB- diskar som inte kan upptäckas automatiskt. Platsinnehavaren %s ersätts av @@ -1384,7 +1384,7 @@ Konfiguration (Configuration) skiftlägesokänsligt namn (t.ex. `Current_Pending_Sector`). Till exempel, för att ignorera attributen `Current Pending Sector Count` och - `Reallocated Sectors Count` på alla diskar med deras nummer oder namn: + `Reallocated Sectors Count` på alla diskar med deras nummer eller namn: :smartignore * 197 5 :smartignore * Current_Pending_Sector Reallocated_Sector_Ct @@ -1728,12 +1728,19 @@ Kodning (Encoding) omdirigerar konsolutdata till en fil, är den resulterande filen alltid i UTF-8-format. +Slutkod (Exit Code) + SnapRAID avslutas med följande statuskoder: + + 0 - Allt OK. + 1 - Kommandot stötte på fel. + 2 - Kommandot `diff` fann att allt är OK, men en `sync` behövs. + Översättning (Translation) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. Upphovsrätt (Copyright) - Denna fil är Copyright (C) 2025 Andrea Mazzoleni + Denna fil är Copyright (C) 2026 Andrea Mazzoleni Se även (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 10e6651e..010151d5 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -67,7 +67,7 @@ de bästa fördelarna med båda. Det har dock vissa begränsningar som du bör överväga innan du använder det. Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till -tillståndet för den senaste `sync`-iseringen. Data som lagts till eller modifieringar som gjorts +tillståndet för den senaste `sync`-operationen. Data som lagts till eller modifieringar som gjorts sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade. Följaktligen är SnapRAID främst lämpat för data som sällan ändras. @@ -230,7 +230,7 @@ utdata, men de relaterade blocken markeras inte som dåliga. Obs: Poolningsfunktionen som beskrivs nedan har ersatts av verktyget mergerfs, som nu är det rekommenderade alternativet för Linux-användare i -SnapRAID-communityt. Mergefs ger ett mer flexibelt och effektivt +SnapRAID-communityt. Mergerfs ger ett mer flexibelt och effektivt sätt att poola flera enheter till en enda enhetlig monteringspunkt, vilket möjliggör sömlös åtkomst till filer över din array utan att förlita sig på symboliska länkar. Det integreras väl med SnapRAID för paritetsskydd @@ -306,17 +306,17 @@ SnapRAID fungerar mer som ett säkerhetskopieringsprogram än ett RAID-system, o kan användas för att återställa eller ångra radering av filer till deras tidigare tillstånd med hjälp av alternativet -f, --filter: - snapraid fix -f FIL + snapraid fix -f FILE eller för en katalog: - snapraid fix -f KATALOG/ + snapraid fix -f DIR/ Du kan också använda det för att återställa endast oavsiktligt raderade filer inuti en katalog med hjälp av alternativet -m, --filter-missing, som återställer endast saknade filer, och lämnar alla andra orörda. - snapraid fix -m -f KATALOG/ + snapraid fix -m -f DIR/ Eller för att återställa alla raderade filer på alla enheter med: @@ -358,9 +358,9 @@ Om du har flera felaktiga diskar, uppdatera alla deras konfigurationsalternativ. ---- 4.4.2 STEG 2 -> Fixa ---- Kör kommandot fix och lagra loggen i en extern fil med: - snapraid -d NAMN -l fix.log fix + snapraid -d NAME -l fix.log fix -Där NAMN är namnet på disken, till exempel `d1` i vårt tidigare exempel. +Där NAME är namnet på disken, till exempel `d1` i vårt tidigare exempel. Om disken som ska återställas är en paritetsdisk, använd namnen `parity`, `2-parity`, etc. Om du har flera felaktiga diskar, använd flera -d-alternativ för att specificera alla @@ -383,21 +383,21 @@ gånger du vill. Om du till exempel har tagit bort filer från arrayen efter den senaste `sync`, kan detta leda till att vissa filer inte återställs. -I detta fall kan du försöka igen `fix` med alternativet -i, --import, +I detta fall kan du köra `fix` igen med alternativet -i, --import, specificera var dessa filer nu finns för att inkludera dem igen i återställningsprocessen. Om du är nöjd med återställningen kan du fortsätta, -men notera att efter synkronisering kan du inte försöka igen kommandot `fix` +men notera att efter synkronisering kan du inte köra `fix`-kommandot igen längre! ---- 4.4.3 STEG 3 -> Kontrollera ---- Som en försiktighetsåtgärd kan du nu köra ett `check`-kommando för att säkerställa att allt är korrekt på den återställda disken. - snapraid -d NAMN -a check + snapraid -d NAME -a check -Där NAMN är namnet på disken, till exempel `d1` i vårt tidigare exempel. +Där NAME är namnet på disken, till exempel `d1` i vårt tidigare exempel. Alternativen -d och -a talar om för SnapRAID att endast kontrollera den specificerade disken och ignorera all paritetsdata. @@ -648,11 +648,11 @@ Filerna i arrayen modifieras INTE. Lagar alla filer och paritetsdata. Alla filer och paritetsdata jämförs med det tillstånd som sparades i -den senaste `sync`-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet. +den senaste `sync`-operationen. Om en skillnad hittas återställs den till det sparade tillståndet. VARNING! Kommandot `fix` skiljer inte mellan fel och avsiktliga modifieringar. -Det återställer villkorslöst filtillståndet till den senaste `sync`-iseringen. +Det återställer villkorslöst filtillståndet till den senaste `sync`-operationen. Om inget annat alternativ specificeras, behandlas hela arrayen. Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med. @@ -667,7 +667,7 @@ SnapRAID döper om alla filer som inte kan fixas genom att lägga till tillägge Innan fixningen skannas hela arrayen för att hitta alla filer som flyttats sedan den senaste `sync`-operationen. -Dessa filer identifieras av deras tidsstämpel, ignorera deras namn +Dessa filer identifieras av deras tidsstämpel, oavsett namn och katalog, och används i återställningsprocessen vid behov. Om du flyttade några av dem utanför arrayen kan du använda alternativet -i, --import för att specificera ytterligare kataloger att skanna. @@ -704,7 +704,7 @@ Inget ändras. Listar alla filer som finns i arrayen vid tidpunkten för den senaste `sync`. -Med -v eller --verbose visas även undertiden. +Med -v eller --verbose visas även subsekundprecisionen. Inget ändras. @@ -753,16 +753,16 @@ Inget ändras. 5.15 touch ---------- -Anger en godtycklig undertidsstämpel för alla filer +Anger en godtycklig tidsstämpel för undersekunder för alla filer som har den satt till noll. Detta förbättrar SnapRAIDs förmåga att känna igen flyttade och kopierade filer, eftersom det gör tidsstämpeln nästan unik, vilket minskar möjliga dubbletter. -Mer specifikt, om undertidsstämpeln inte är noll, +Mer specifikt, om tidsstämpeln för undersekunder inte är noll, identifieras en flyttad eller kopierad fil som sådan om den matchar -namn, storlek och tidsstämpel. Om undertidsstämpeln +namn, storlek och tidsstämpel. Om tidsstämpeln för undersekunder är noll, betraktas den som en kopia endast om hela sökvägen, storlek och tidsstämpel alla matchar. @@ -821,7 +821,7 @@ SnapRAID tillhandahåller följande alternativ: Filtrerar filerna att behandla i `check` och `fix`. Endast filerna som matchar det specificerade mönstret behandlas. Detta alternativ kan användas flera gånger. - Se avsnittet MÖNSTER för mer information om + Se avsnittet PATTERN för mer information om mönsterspecifikationer. I Unix, se till att globbing-tecken citeras om de används. Detta alternativ kan endast användas med `check` och `fix`. @@ -919,7 +919,7 @@ SnapRAID tillhandahåller följande alternativ: antalet byte per sekund. Du kan specificera en multiplikator som K, M eller G (t.ex. --bw-limit 1G). - -t, --tail STORLEK + -t, --tail SIZE Begränsa fillistan till de som inte använder mer än den angivna slutstorleken på paritetsdiskarna. Du kan använda multiplikatorer som K, M, G eller T (t.ex. --tail 1G). @@ -981,7 +981,7 @@ SnapRAID tillhandahåller följande alternativ: -D, --force-device Tvingar den osäkra operationen att fixa med otillgängliga diskar eller med diskar på samma fysiska enhet. - Till exempel, om du förlorade två datadisker och har en reservdisk för att återställa + Till exempel, om du förlorade två datadiskar och har en reservdisk för att återställa endast den första, kan du ignorera den andra otillgängliga disken. Eller, om du vill återställa en disk i det lediga utrymme som finns kvar på en redan använd disk, dela samma fysiska enhet. @@ -1020,9 +1020,9 @@ SnapRAID tillhandahåller följande alternativ: starkt att inte använda det. Du HAR INGET dataskydd under `sync`-operationen. - -W, --force-realloc-tail STORLEK + -W, --force-realloc-tail SIZE Fungerar som -R, --force-realloc, men begränsat till den angivna - slutdelen (de sista STORLEK byten) av varje paritetsfil. + slutdelen (de sista SIZE byten) av varje paritetsfil. Den tvingar omallokering (flytt) av alla filfragment/block som för närvarande lagras i den slutsektionen, vilket gör att de kan placeras var som helst i paritetsfilen/filerna där ledigt utrymme finns @@ -1069,7 +1069,7 @@ SnapRAID tillhandahåller följande alternativ: -S, --start BLKSTART Börjar behandlingen från det specificerade - blocknumret. Detta kan vara användbart för att försöka igen att kontrollera + blocknumret. Detta kan vara användbart för att på nytt försöka kontrollera eller fixa specifika block i händelse av en skadad disk. Detta alternativ är främst för avancerad manuell återställning. @@ -1120,8 +1120,8 @@ katalog som `snapraid.exe`. Den måste innehålla följande alternativ (skiftlägeskänsligt): -7.1 parity FIL [,FIL] ... -------------------------- +7.1 parity FILE [,FILE] ... +--------------------------- Definierar de filer som ska användas för att lagra paritetsinformationen. Pariteten möjliggör skydd från ett enda disk- @@ -1143,8 +1143,8 @@ varningen om fulla diskar. Detta alternativ är obligatoriskt och kan endast användas en gång. -7.2 (2,3,4,5,6)-parity FIL [,FIL] ... -------------------------------------- +7.2 (2,3,4,5,6)-parity FILE [,FILE] ... +--------------------------------------- Definierar de filer som ska användas för att lagra extra paritetsinformation. @@ -1163,8 +1163,8 @@ Samma överväganden som för alternativet `parity` gäller. Dessa alternativ är valfria och kan endast användas en gång. -7.3 z-parity FIL [,FIL] ... ---------------------------- +7.3 z-parity FILE [,FILE] ... +----------------------------- Definierar en alternativ fil och ett format för att lagra trippel paritet. @@ -1183,8 +1183,8 @@ Det är möjligt att konvertera från ett format till ett annat genom att juster konfigurationsfilen med önskad z-parity eller 3-parity fil och använda `fix` för att återskapa den. -7.4 content FIL ---------------- +7.4 content FILE +---------------- Definierar den fil som ska användas för att lagra listan och checksummorna för alla filer som finns i din disk-array. @@ -1200,20 +1200,20 @@ flera kopior av samma fil. Du måste lagra minst en kopia för varje paritetsdisk som används plus en. Att använda ytterligare kopior skadar inte. -7.5 data NAMN KATALOG ---------------------- +7.5 data NAME DIR +----------------- Definierar namnet och monteringspunkten för datadiskarna i -arrayen. NAMN används för att identifiera disken och måste -vara unikt. KATALOG är monteringspunkten för disken i +arrayen. NAME används för att identifiera disken och måste +vara unikt. DIR är monteringspunkten för disken i filsystemet. Du kan ändra monteringspunkten vid behov, så länge -du behåller NAMN fixerat. +du behåller NAME fixerat. Du bör använda ett alternativ för varje datadisk i arrayen. -Du kan byta namn på en disk senare genom att ändra NAMN direkt +Du kan byta namn på en disk senare genom att ändra NAME direkt i konfigurationsfilen och sedan köra ett `sync`-kommando. I händelse av namnbyte görs associationen med hjälp av den lagrade UUID:n för diskarna. @@ -1264,7 +1264,7 @@ Exkluderar alla dolda filer och kataloger. I Unix är dolda filer de som börjar med `.`. I Windows är de de med det dolda attributet. -7.9 exclude/include MÖNSTER +7.9 exclude/include PATTERN --------------------------- Definierar fil- eller katalogmönstren att exkludera eller inkludera @@ -1277,13 +1277,13 @@ Om inget mönster matchar, exkluderas filen om det sista mönstret som specificerats är ett `include`-mönster, eller inkluderas om det sista mönstret som specificerats är ett `exclude`-mönster. -Se avsnittet MÖNSTER för mer information om mönster- +Se avsnittet PATTERN för mer information om mönster- specifikationer. Detta alternativ kan användas flera gånger. -7.10 blocksize STORLEK_I_KIBIBYTES ----------------------------------- +7.10 blocksize SIZE_IN_KIBIBYTES +-------------------------------- Definierar den grundläggande blockstorleken i kibibytes för pariteten. En kibibyte är 1024 byte. @@ -1330,8 +1330,8 @@ Detta resulterar i cirka 1,5% extra utrymme, ungefär 60 GB för en 4 TB-disk, vilket möjliggör cirka 460 000 filer på varje datadisk utan något bortkastat utrymme. -7.11 hashsize STORLEK_I_BYTE ----------------------------- +7.11 hashsize SIZE_IN_BYTES +--------------------------- Definierar hash-storleken i byte för de sparade blocken. @@ -1368,16 +1368,16 @@ Om du byter till både en hash-storlek på 8 och en blockstorlek på 512 får du RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB -7.12 autosave STORLEK_I_GIGABYTES ---------------------------------- +7.12 autosave SIZE_IN_GIGABYTES +------------------------------- Sparar automatiskt tillståndet vid synkronisering eller skrubbning efter att den specificerade mängden GB har behandlats. Detta alternativ är användbart för att undvika att starta om långa `sync`- kommandon från början om de avbryts av en maskinkrasch eller någon annan händelse. -7.13 temp_limit TEMPERATUR_CELSIUS ----------------------------------- +7.13 temp_limit TEMPERATURE_CELSIUS +----------------------------------- Anger den maximalt tillåtna disk-temperaturen i Celsius. När den specificeras, kontrollerar SnapRAID periodiskt temperaturen på alla diskar med hjälp av @@ -1393,37 +1393,37 @@ disk och uppskattar den långsiktiga stabila temperaturen de förväntas nå om aktiviteten fortsätter. Uppskattningen utförs först efter att disk-temperaturen har ökat fyra gånger, vilket säkerställer att tillräckligt med datapoäng finns tillgängliga för att fastställa en pålitlig trend. -Denna förutsagda stabila temperatur visas inom parentes bredvid den +Denna förutsagda stabila temperatur visas inom parentes bredvid det aktuella värdet och hjälper till att bedöma om systemets kylning är tillräcklig. Denna uppskattade temperatur är endast för informationssyfte -och har ingen effekt på SnapRAIDs beteende. Programmens +och har ingen effekt på SnapRAIDs beteende. Programmets åtgärder baseras enbart på de faktiska uppmätta disk-temperaturerna. -För att utföra denna analys behöver SnapRAID en referens för system- -temperaturen. Det försöker först läsa den från tillgängliga hårdvaru- -sensorer. Om ingen system-sensor kan nås, används den lägsta disk- -temperaturen som mättes vid start av körningen som en reservreferens. +För att utföra denna analys behöver SnapRAID en referens för systemtemperaturen. +Det försöker först läsa den från tillgängliga hårdvarusensorer. +Om ingen systemsensor kan nås, används den lägsta disk- +temperaturen som mättes i början av körningen som en reservreferens. Normalt visar SnapRAID endast temperaturen på den hetaste disken. För att visa temperaturen på alla diskar, använd alternativet -A eller --stats. -7.14 temp_sleep TID_I_MINUTER ------------------------------ +7.14 temp_sleep TIME_IN_MINUTES +------------------------------- Anger standby-tiden, i minuter, när temperaturgränsen har nåtts. Under denna period förblir diskarna nedsnurrade. Standard är 5 minuter. -7.15 pool KATALOG ------------------ +7.15 pool DIR +------------- Definierar poolningskatalogen där den virtuella vyn av disk- arrayen skapas med hjälp av kommandot `pool`. Katalogen måste redan existera. -7.16 share UNC_KATALOG ----------------------- +7.16 share UNC_DIR +------------------ Definierar Windows UNC-sökvägen som krävs för att få åtkomst till diskarna på distans. @@ -1438,8 +1438,8 @@ katalog och namn. Detta alternativ krävs endast för Windows. -7.17 smartctl DISK/PARITY ALTERNATIV... ---------------------------------------- +7.17 smartctl DISK/PARITY OPTIONS... +------------------------------------ Definierar anpassade smartctl-alternativ för att få SMART-attributen för varje disk. Detta kan krävas för RAID-kontroller och vissa USB- @@ -1484,7 +1484,7 @@ Varje attribut kan specificeras som ett nummer från 1 till 255, eller som ett skiftlägesokänsligt namn (t.ex. `Current_Pending_Sector`). Till exempel, för att ignorera attributen `Current Pending Sector Count` och -`Reallocated Sectors Count` på alla diskar med deras nummer oder namn: +`Reallocated Sectors Count` på alla diskar med deras nummer eller namn: smartignore * 197 5 smartignore * Current_Pending_Sector Reallocated_Sector_Ct @@ -1854,20 +1854,30 @@ omdirigerar konsolutdata till en fil, är den resulterande filen alltid i UTF-8-format. -15 ÖVERSäTTNING (TRANSLATION) +15 SLUTKOD (EXIT CODE) +====================== + +SnapRAID avslutas med följande statuskoder: + +0 - Allt OK. +1 - Kommandot stötte på fel. +2 - Kommandot `diff` fann att allt är OK, men en `sync` behövs. + + +16 ÖVERSäTTNING (TRANSLATION) ============================= Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. -16 UPPHOVSRäTT (COPYRIGHT) +17 UPPHOVSRäTT (COPYRIGHT) ========================== -Denna fil är Copyright (C) 2025 Andrea Mazzoleni +Denna fil är Copyright (C) 2026 Andrea Mazzoleni -17 SE äVEN (SEE ALSO) +18 SE äVEN (SEE ALSO) ===================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 89568a49..5ea6921b 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -82,8 +82,8 @@ SnapRAID — це програма резервного копіювання, р дискових масивів, яка зберігає інформацію парності для відновлення даних у випадку відмови до шести дисків. .PP -В першу чергу призначена для домашніх медіацентрів з великими -файлами, що рідко змінюються, SnapRAID пропонує кілька функцій: +Насамперед призначений для домашніх медіацентрів з великими +файлами, які рідко змінюються, SnapRAID пропонує кілька функцій: .PD 0 .IP \(bu Ви можете використовувати диски, вже заповнені файлами, без @@ -169,7 +169,7 @@ SnapRAID може відновлювати дані лише з обмежено всього дискового масиву. .IP \(bu Зберігаються лише імена файлів, часові мітки, символічні -та жорсткі посилання. Права доступу, власність та +та жорсткі посилання. Права доступу, власники та розширені атрибути не зберігаються. .PD .SH Початок роботи (GETTING STARTED) @@ -387,7 +387,7 @@ snapraid \-p bad scrub .SS Об\'єднання (Pooling) Примітка: Функція об\'єднання, описана нижче, була замінена інструментом mergerfs, який тепер є рекомендованою опцією для -користувачів Linux у спільноті SnapRAID. Mergefs забезпечує +користувачів Linux у спільноті SnapRAID. Mergerfs забезпечує більш гнучкий та ефективний спосіб об\'єднання кількох дисків в єдину уніфіковану точку монтування, дозволяючи безперешкодний доступ до файлів у вашому масиві без використання символічних @@ -733,7 +733,7 @@ SnapRAID надає кілька простих команд, які дозво Виводить звіт SMART усіх дисків у системі. .PP Включає оцінку ймовірності відмови протягом наступного року, -дозволяючи вам планувати планову заміну дисків, які +дозволяючи вам планувати своєчасну заміну дисків, які виявляють підозрілі атрибути. .PP Ця оцінка ймовірності отримана шляхом кореляції атрибутів @@ -747,7 +747,7 @@ https://www.backblaze.com/hard\-drive\-test\-data.html .PP Якщо SMART повідомляє, що диск виходить з ладу, для цього диска виводиться \`FAIL\` або \`PREFAIL\`, і SnapRAID повертає -помилку. У цьому випадку настійно рекомендується негайна +помилку. У цьому випадку наполегливо рекомендується негайна заміна диска. .PP Інші можливі рядки стану: @@ -848,16 +848,16 @@ https://www.backblaze.com/hard\-drive\-test\-data.html іменем, розміром, часовою міткою та inode, але іншим каталогом. .HP 4 -.I copied -файли, скопійовані на той самий або інший диск, де +.I copied (скопійовані) +Файли, скопійовані на той самий або інший диск, де оригінальний файл все ще існує. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. Якщо мітка часу з точністю до часток секунди дорівнює нулю, для ідентифікації має збігатися повний шлях, а не лише назва. .HP 4 -.I relocated -файли, переміщені на той самий або інший диск, де +.I relocated (перерозміщені) +Файли, переміщені на той самий або інший диск, де оригінал зник. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. @@ -866,8 +866,8 @@ https://www.backblaze.com/hard\-drive\-test\-data.html На відміну від файлів \'moved\' на тому ж диску, переміщені файли мають інший inode. .HP 4 -.I restored -файли з іншим inode, але зі збігом каталогу, назви, +.I restored (відновлені) +Файли з іншим inode, але зі збігом каталогу, назви, розміру та мітки часу. Зазвичай це файли, відновлені після видалення. .PD @@ -1003,7 +1003,7 @@ SnapRAID перейменовує всі файли, які не можуть б Працює як \`fix\`, але лише імітує відновлення, і жодні зміни не записуються в масив. .PP -Ця команда в першу чергу призначена для ручної перевірки, +Ця команда насамперед призначена для ручної перевірки, наприклад, після процесу відновлення або в інших особливих умовах. Для періодичних та запланованих перевірок використовуйте \`scrub\`. @@ -1020,7 +1020,7 @@ SnapRAID перейменовує всі файли, які не можуть б останньої \`sync\`. .PP З \-v або \-\-verbose також показується час з точністю до -долі секунди. +часток секунди. .PP Нічого не змінюється. .SS dup @@ -1061,17 +1061,17 @@ SnapRAID перейменовує всі файли, які не можуть б .PP Нічого не змінюється. .SS touch -Встановлює довільну часову мітку з точністю до долі секунди +Встановлює довільну часову мітку з точністю до часток секунди для всіх файлів, у яких вона встановлена на нуль. .PP Це покращує здатність SnapRAID розпізнавати переміщені та скопійовані файли, оскільки робить часову мітку майже унікальною, зменшуючи можливі дублікати. .PP -Зокрема, якщо часова мітка з точністю до долі секунди не +Зокрема, якщо часова мітка з точністю до часток секунди не дорівнює нулю, переміщений або скопійований файл ідентифікується як такий, якщо він збігається з іменем, розміром та часовою -міткою. Якщо часова мітка з точністю до долі секунди дорівнює +міткою. Якщо часова мітка з точністю до часток секунди дорівнює нулю, він вважається копією, лише якщо повний шлях, розмір та часова мітка збігаються. .PP @@ -1124,7 +1124,7 @@ SnapRAID надає наступні опції: шаблону. Цю опцію можна використовувати кілька разів. Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. -В Unix переконайтеся, що символи глоббінгу взяті +В Unix переконайтеся, що символи глобінгу взяті в лапки, якщо вони використовуються. Цю опцію можна використовувати лише з \`check\` та \`fix\`. Її не можна використовувати з \`sync\` та \`scrub\`, оскільки @@ -1235,7 +1235,7 @@ DAYS — це мінімальний вік у днях для блоку, як Ви можете вказати множник, такий як K, M або G (наприклад, \-\-bw\-limit 1G). .TP -.B \-t, \-\-tail РОЗМІР +.B \-t, \-\-tail SIZE Обмежує список файлів тими, що використовують не більше зазначеного розміру хвоста дисків парності. Можна використовувати множники, такі як K, M, G або T (наприклад, \-\-tail 1G). @@ -1348,12 +1348,12 @@ ext3/ext4. вмісту, для перевірки даних. Цю опцію можна використовувати лише з \`sync\`. УВАГА! Ця опція лише для експертів, і -настійно не рекомендується її використовувати. +наполегливо не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції \`sync\`. .TP -.B \-W, \-\-force\-realloc\-tail РОЗМІР +.B \-W, \-\-force\-realloc\-tail SIZE Працює як \-R, \-\-force\-realloc, але обмежується вказаною кінцевою -частиною (останні РОЗМІР байт) кожного файлу парності. +частиною (останні SIZE\-байт) кожного файлу парності. Примусово перерозподіляє (переміщує) будь\-які фрагменти/блоки файлів, що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити їх будь\-де у файлі(ах) парності, де є вільне місце (включно з @@ -1367,7 +1367,7 @@ ext3/ext4. Ви можете використовувати locate \-t, \-\-tail, щоб заздалегідь дізнатися про зачеплені файли. УВАГА! -Цей параметр призначений лише для експертів, і його настійно +Цей параметр призначений лише для експертів, і його наполегливо не рекомендується використовувати. Під час операції \`sync\` захист даних для зачеплених файлів ВІДСУТНІЙ. .TP @@ -1506,8 +1506,8 @@ SnapRAID вимагає конфігураційний файл, щоб знат Визначає альтернативний файл та формат для зберігання потрійної парності. .PP -Ця опція є альтернативою \`3\-parity\`, в першу чергу -призначена для ЦП низького класу, таких як ARM або +Ця опція є альтернативою \`3\-parity\`, насамперед +призначена для малопотужних ЦП, таких як ARM або AMD Phenom, Athlon та Opteron, які не підтримують набір інструкцій SSSE3. У таких випадках вона забезпечує кращу продуктивність. @@ -1586,7 +1586,7 @@ UUID дисків. .PP Створення та видалення знімків вимагають прав адміністратора. Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли -включено цю опцію. +увімкнено цю опцію. .PP Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS. .SS nohidden @@ -1616,7 +1616,7 @@ UUID дисків. Розмір блоку за замовчуванням становить 256, що має працювати для більшості випадків. .PP -УВАГА! Ця опція лише для експертів, і настійно +УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! @@ -1630,15 +1630,15 @@ UUID дисків. це може призвести до значного невикористаного місця парності. Коли ви повністю заповнюєте диск парності, вам не дозволяється додавати більше файлів на диски -даних. Однак, витрачена парність не накопичується -між дисками даних. Витрачене місце внаслідок великої +даних. Однак, втрачена парність не накопичується +між дисками даних. Марно втрачений простір внаслідок великої кількості файлів на диску даних обмежує лише кількість даних на цьому диску даних, а не на інших. .PP Як наближення, ви можете припустити, що половина -розміру блоку витрачається для кожного файлу. +розміру блоку втрачається марно для кожного файлу. Наприклад, зі 100 000 файлами та розміром блоку 256 КіБ -ви витратите 12,8 ГБ парності, що може призвести до +ви втратите 12,8 ГБ парності, що може призвести до того, що на диску даних буде на 12,8 ГБ менше місця. .PP Ви можете перевірити кількість витраченого місця на @@ -1676,18 +1676,18 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE Розмір хешу за замовчуванням становить 16 байтів (128 біт), що має працювати для більшості випадків. .PP -УВАГА! Ця опція лише для експертів, і настійно +УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! .PP -Причина використовувати інший розмір хешу полягає -в тому, якщо ваша система має обмежену пам\'ять. -Як правило, SnapRAID зазвичай вимагає 1 ГіБ ОЗП -на кожні 16 ТБ даних у масиві. +Інший розмір хешу варто використовувати, якщо ваша +система має обмежену пам\'ять. +Зазвичай SnapRAID потребує 1 ГіБ ОЗП на кожні 16 ТБ +даних у масиві. .PP Зокрема, для зберігання хешів даних SnapRAID -вимагає приблизно $TS \\times (1+HS) / BS$ байтів +вимагає приблизно TS*(1+HS)/BS байтів ОЗП, де TS — загальний розмір вашого дискового масиву у байтах, BS — розмір блоку у байтах, а HS — розмір хешу у байтах. @@ -1695,25 +1695,25 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE Наприклад, з 8 дисками по 4 ТБ, розміром блоку 256 КіБ (1 КіБ = 1024 байта) та розміром хешу 16, ви отримуєте: .PP -RAM = $(8 \\times 4 \\times 10^{12}) \\times (1+16) / (256 \\times 2^{10}) = 1.93$ ГіБ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 ГіБ .PD 0 .PD .PP Перехід до розміру хешу 8, ви отримуєте: .PP -RAM = $(8 \\times 4 \\times 10^{12}) \\times (1+8) / (256 \\times 2^{10}) = 1.02$ ГіБ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 ГіБ .PD 0 .PD .PP Перехід до розміру блоку 512, ви отримуєте: .PP -RAM = $(8 \\times 4 \\times 10^{12}) \\times (1+16) / (512 \\times 2^{10}) = 0.96$ ГіБ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 ГіБ .PD 0 .PD .PP Перехід до розміру хешу 8 та розміру блоку 512, ви отримуєте: .PP -RAM = $(8 \\times 4 \\times 10^{12}) \\times (1+8) / (512 \\times 2^{10}) = 0.51$ ГіБ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 ГіБ .PD 0 .PD .SS autosave SIZE_IN_GIGABYTES @@ -1751,13 +1751,13 @@ smartctl. Поточні температури дисків відобража виключно на фактично виміряних температурах дисків. .PP -Для виконання цього аналізу SnapRAID потрібна -довідкова інформація про температуру системи. +Для виконання цього аналізу SnapRAID потрібне +опорне значення температури системи. Спочатку він намагається зчитати її з доступних апаратних датчиків. Якщо до системного датчика неможливо отримати доступ, він використовує найнижчу температуру диска, виміряну на початку -запуску, як резервну довідкову інформацію. +запуску, як резервне опорне значення. .PP Зазвичай SnapRAID показує лише температуру найгарячішого диска. Щоб відобразити температуру @@ -2134,7 +2134,7 @@ SnapRAID керує двома конкретними знімками, \`stable Класи символів із використанням квадратних дужок \`[]\` відповідають одному символу з визначеного набору або діапазону. Як і інші односимвольні шаблони, вони не відповідають роздільникам каталогів. Класи підтримують діапазони та заперечення за допомогою -знаку оклику. +знака оклику. .PP Фундаментальна відмінність, яку слід пам\'ятати, полягає в тому, що \`*\`, \`?\` та класи символів усі дотримуються меж каталогів і відповідають лише в межах одного компонента @@ -2145,19 +2145,19 @@ SnapRAID керує двома конкретними знімками, \`stable .TP .B FILE Вибирає будь\-який файл з ім\'ям FILE. -Цей шаблон застосовується тільки до файлів, а не до директорій. +Цей шаблон застосовується тільки до файлів, а не до каталогів. .TP .B DIR/ -Вибирає будь\-яку директорію з ім\'ям DIR і все, що знаходиться всередині. -Цей шаблон застосовується тільки до директорій, а не до файлів. +Вибирає будь\-який каталог з ім\'ям DIR і все, що знаходиться всередині. +Цей шаблон застосовується тільки до каталогів, а не до файлів. .TP .B /PATH/FILE Вибирає точно вказаний шлях до файлу. Цей шаблон застосовується -тільки до файлів, а не до директорій. +тільки до файлів, а не до каталогів. .TP .B /PATH/DIR/ -Вибирає точно вказаний шлях до директорії і все, що знаходиться -всередині. Цей шаблон застосовується тільки до директорій, а не до файлів. +Вибирає точно вказаний шлях до каталогу і все, що знаходиться +всередині. Цей шаблон застосовується тільки до каталогів, а не до файлів. .PP Коли ви вказуєте абсолютний шлях, що починається з /, він застосовується до кореневого каталогу @@ -2174,7 +2174,7 @@ SnapRAID керує двома конкретними знімками, \`stable .PP Якщо ім\'я файлу містить символи \`*\`, \`?\`, \`[\`, або \`]\`, ви повинні екранувати їх, щоб уникнути -їх інтерпретації як символу глоббінгу. +їх інтерпретації як символу глобінгу. В Unix символом екранування є \`\\\`; у Windows — \`^\`. Коли шаблон знаходиться в командному рядку, ви повинні подвоїти символ екранування, щоб @@ -2291,7 +2291,7 @@ include /pictures/ .PD 0 .PP .PD -# розширення глоббінгу оболонкою. +# розширення глобінгу оболонкою. .PD 0 .PP .PD @@ -2300,7 +2300,7 @@ snapraid \-f \[dq]*.mp3\[dq] check .PD .RE .PP -В Unix, при використанні символів глоббінгу в +В Unix, при використанні символів глобінгу в командному рядку, ви повинні взяти їх у лапки, щоб запобігти їх розширенню оболонкою. .SH Ігнорування файлів (IGNORE FILE) @@ -2407,10 +2407,25 @@ TrueType, такий як \`Lucida Console\`, як файлів; якщо ви перенаправляєте вивід консолі у файл, отриманий файл завжди буде у форматі UTF\-8. +.SH Код завершення (EXIT CODE) +SnapRAID завершує роботу з такими кодами помилок: +.RS 0 +.PD 0 +.HP 4 +.I 0 +Все в порядку. +.HP 4 +.I 1 +Команда виявила помилки. +.HP 4 +.I 2 +Команда \`diff\` визначила, що все в порядку, але потрібен \`sync\`. +.PD +.RE .SH Переклад (TRANSLATION) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. .SH Авторське право (COPYRIGHT) -Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni +Цей файл захищений авторським правом (C) 2026 Andrea Mazzoleni .SH Див. також (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index a93bbe21..ac0f5a71 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -28,8 +28,8 @@ Name{number} дискових масивів, яка зберігає інформацію парності для відновлення даних у випадку відмови до шести дисків. - В першу чергу призначена для домашніх медіацентрів з великими - файлами, що рідко змінюються, SnapRAID пропонує кілька функцій: + Насамперед призначений для домашніх медіацентрів з великими + файлами, які рідко змінюються, SnapRAID пропонує кілька функцій: * Ви можете використовувати диски, вже заповнені файлами, без необхідності їх переформатування, отримуючи доступ до них @@ -94,7 +94,7 @@ Name{number} можете відновити дані навіть після повної відмови всього дискового масиву. * Зберігаються лише імена файлів, часові мітки, символічні - та жорсткі посилання. Права доступу, власність та + та жорсткі посилання. Права доступу, власники та розширені атрибути не зберігаються. Початок роботи (Getting Started) @@ -229,7 +229,7 @@ Name{number} Об'єднання (Pooling) Примітка: Функція об'єднання, описана нижче, була замінена інструментом mergerfs, який тепер є рекомендованою опцією для - користувачів Linux у спільноті SnapRAID. Mergefs забезпечує + користувачів Linux у спільноті SnapRAID. Mergerfs забезпечує більш гнучкий та ефективний спосіб об'єднання кількох дисків в єдину уніфіковану точку монтування, дозволяючи безперешкодний доступ до файлів у вашому масиві без використання символічних @@ -465,7 +465,7 @@ Name{number} Виводить звіт SMART усіх дисків у системі. Включає оцінку ймовірності відмови протягом наступного року, - дозволяючи вам планувати планову заміну дисків, які + дозволяючи вам планувати своєчасну заміну дисків, які виявляють підозрілі атрибути. Ця оцінка ймовірності отримана шляхом кореляції атрибутів @@ -475,7 +475,7 @@ Name{number} Якщо SMART повідомляє, що диск виходить з ладу, для цього диска виводиться `FAIL` або `PREFAIL`, і SnapRAID повертає - помилку. У цьому випадку настійно рекомендується негайна + помилку. У цьому випадку наполегливо рекомендується негайна заміна диска. Інші можливі рядки стану: @@ -557,13 +557,13 @@ Name{number} на тому ж диску. Вони ідентифікуються за тим же іменем, розміром, часовою міткою та inode, але іншим каталогом. - copied - файли, скопійовані на той самий або інший диск, де + copied (скопійовані) - Файли, скопійовані на той самий або інший диск, де оригінальний файл все ще існує. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. Якщо мітка часу з точністю до часток секунди дорівнює нулю, для ідентифікації має збігатися повний шлях, а не лише назва. - relocated - файли, переміщені на той самий або інший диск, де + relocated (перерозміщені) - Файли, переміщені на той самий або інший диск, де оригінал зник. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. @@ -571,7 +571,7 @@ Name{number} ідентифікації має збігатися повний шлях. На відміну від файлів 'moved' на тому ж диску, переміщені файли мають інший inode. - restored - файли з іншим inode, але зі збігом каталогу, назви, + restored (відновлені) - Файли з іншим inode, але зі збігом каталогу, назви, розміру та мітки часу. Зазвичай це файли, відновлені після видалення. @@ -698,7 +698,7 @@ Name{number} Працює як `fix`, але лише імітує відновлення, і жодні зміни не записуються в масив. - Ця команда в першу чергу призначена для ручної перевірки, + Ця команда насамперед призначена для ручної перевірки, наприклад, після процесу відновлення або в інших особливих умовах. Для періодичних та запланованих перевірок використовуйте `scrub`. @@ -716,7 +716,7 @@ Name{number} останньої `sync`. З -v або --verbose також показується час з точністю до - долі секунди. + часток секунди. Нічого не змінюється. @@ -761,17 +761,17 @@ Name{number} Нічого не змінюється. touch - Встановлює довільну часову мітку з точністю до долі секунди + Встановлює довільну часову мітку з точністю до часток секунди для всіх файлів, у яких вона встановлена на нуль. Це покращує здатність SnapRAID розпізнавати переміщені та скопійовані файли, оскільки робить часову мітку майже унікальною, зменшуючи можливі дублікати. - Зокрема, якщо часова мітка з точністю до долі секунди не + Зокрема, якщо часова мітка з точністю до часток секунди не дорівнює нулю, переміщений або скопійований файл ідентифікується як такий, якщо він збігається з іменем, розміром та часовою - міткою. Якщо часова мітка з точністю до долі секунди дорівнює + міткою. Якщо часова мітка з точністю до часток секунди дорівнює нулю, він вважається копією, лише якщо повний шлях, розмір та часова мітка збігаються. @@ -827,7 +827,7 @@ Name{number} шаблону. Цю опцію можна використовувати кілька разів. Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. - В Unix переконайтеся, що символи глоббінгу взяті + В Unix переконайтеся, що символи глобінгу взяті в лапки, якщо вони використовуються. Цю опцію можна використовувати лише з `check` та `fix`. Її не можна використовувати з `sync` та `scrub`, оскільки @@ -938,7 +938,7 @@ Name{number} Ви можете вказати множник, такий як K, M або G (наприклад, --bw-limit 1G). - -t, --tail РОЗМІР + -t, --tail SIZE Обмежує список файлів тими, що використовують не більше зазначеного розміру хвоста дисків парності. Можна використовувати множники, такі як K, M, G або T (наприклад, --tail 1G). @@ -1051,12 +1051,12 @@ Name{number} вмісту, для перевірки даних. Цю опцію можна використовувати лише з `sync`. УВАГА! Ця опція лише для експертів, і - настійно не рекомендується її використовувати. + наполегливо не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції `sync`. - -W, --force-realloc-tail РОЗМІР + -W, --force-realloc-tail SIZE Працює як -R, --force-realloc, але обмежується вказаною кінцевою - частиною (останні РОЗМІР байт) кожного файлу парності. + частиною (останні SIZE-байт) кожного файлу парності. Примусово перерозподіляє (переміщує) будь-які фрагменти/блоки файлів, що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити їх будь-де у файлі(ах) парності, де є вільне місце (включно з @@ -1070,7 +1070,7 @@ Name{number} Ви можете використовувати locate -t, --tail, щоб заздалегідь дізнатися про зачеплені файли. УВАГА! - Цей параметр призначений лише для експертів, і його настійно + Цей параметр призначений лише для експертів, і його наполегливо не рекомендується використовувати. Під час операції `sync` захист даних для зачеплених файлів ВІДСУТНІЙ. @@ -1207,8 +1207,8 @@ Name{number} Визначає альтернативний файл та формат для зберігання потрійної парності. - Ця опція є альтернативою `3-parity`, в першу чергу - призначена для ЦП низького класу, таких як ARM або + Ця опція є альтернативою `3-parity`, насамперед + призначена для малопотужних ЦП, таких як ARM або AMD Phenom, Athlon та Opteron, які не підтримують набір інструкцій SSSE3. У таких випадках вона забезпечує кращу продуктивність. @@ -1291,7 +1291,7 @@ Name{number} Створення та видалення знімків вимагають прав адміністратора. Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли - включено цю опцію. + увімкнено цю опцію. Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS. @@ -1324,7 +1324,7 @@ Name{number} Розмір блоку за замовчуванням становить 256, що має працювати для більшості випадків. - УВАГА! Ця опція лише для експертів, і настійно + УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! @@ -1338,15 +1338,15 @@ Name{number} це може призвести до значного невикористаного місця парності. Коли ви повністю заповнюєте диск парності, вам не дозволяється додавати більше файлів на диски - даних. Однак, витрачена парність не накопичується - між дисками даних. Витрачене місце внаслідок великої + даних. Однак, втрачена парність не накопичується + між дисками даних. Марно втрачений простір внаслідок великої кількості файлів на диску даних обмежує лише кількість даних на цьому диску даних, а не на інших. Як наближення, ви можете припустити, що половина - розміру блоку витрачається для кожного файлу. + розміру блоку втрачається марно для кожного файлу. Наприклад, зі 100 000 файлами та розміром блоку 256 КіБ - ви витратите 12,8 ГБ парності, що може призвести до + ви втратите 12,8 ГБ парності, що може призвести до того, що на диску даних буде на 12,8 ГБ менше місця. Ви можете перевірити кількість витраченого місця на @@ -1381,18 +1381,18 @@ Name{number} Розмір хешу за замовчуванням становить 16 байтів (128 біт), що має працювати для більшості випадків. - УВАГА! Ця опція лише для експертів, і настійно + УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! - Причина використовувати інший розмір хешу полягає - в тому, якщо ваша система має обмежену пам'ять. - Як правило, SnapRAID зазвичай вимагає 1 ГіБ ОЗП - на кожні 16 ТБ даних у масиві. + Інший розмір хешу варто використовувати, якщо ваша + система має обмежену пам'ять. + Зазвичай SnapRAID потребує 1 ГіБ ОЗП на кожні 16 ТБ + даних у масиві. Зокрема, для зберігання хешів даних SnapRAID - вимагає приблизно $TS \times (1+HS) / BS$ байтів + вимагає приблизно TS*(1+HS)/BS байтів ОЗП, де TS — загальний розмір вашого дискового масиву у байтах, BS — розмір блоку у байтах, а HS — розмір хешу у байтах. @@ -1400,19 +1400,19 @@ Name{number} Наприклад, з 8 дисками по 4 ТБ, розміром блоку 256 КіБ (1 КіБ = 1024 байта) та розміром хешу 16, ви отримуєте: - :RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (256 \times 2^{10}) = 1.93$ ГіБ + :RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 ГіБ Перехід до розміру хешу 8, ви отримуєте: - :RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (256 \times 2^{10}) = 1.02$ ГіБ + :RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 ГіБ Перехід до розміру блоку 512, ви отримуєте: - :RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (512 \times 2^{10}) = 0.96$ ГіБ + :RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 ГіБ Перехід до розміру хешу 8 та розміру блоку 512, ви отримуєте: - :RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (512 \times 2^{10}) = 0.51$ ГіБ + :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 ГіБ autosave SIZE_IN_GIGABYTES Автоматично зберігає стан під час синхронізації або @@ -1450,13 +1450,13 @@ Name{number} виключно на фактично виміряних температурах дисків. - Для виконання цього аналізу SnapRAID потрібна - довідкова інформація про температуру системи. + Для виконання цього аналізу SnapRAID потрібне + опорне значення температури системи. Спочатку він намагається зчитати її з доступних апаратних датчиків. Якщо до системного датчика неможливо отримати доступ, він використовує найнижчу температуру диска, виміряну на початку - запуску, як резервну довідкову інформацію. + запуску, як резервне опорне значення. Зазвичай SnapRAID показує лише температуру найгарячішого диска. Щоб відобразити температуру @@ -1730,7 +1730,7 @@ Name{number} Класи символів із використанням квадратних дужок `[]` відповідають одному символу з визначеного набору або діапазону. Як і інші односимвольні шаблони, вони не відповідають роздільникам каталогів. Класи підтримують діапазони та заперечення за допомогою - знаку оклику. + знака оклику. Фундаментальна відмінність, яку слід пам'ятати, полягає в тому, що `*`, `?` та класи символів усі дотримуються меж каталогів і відповідають лише в межах одного компонента @@ -1741,19 +1741,19 @@ Name{number} =FILE Вибирає будь-який файл з ім'ям FILE. - Цей шаблон застосовується тільки до файлів, а не до директорій. + Цей шаблон застосовується тільки до файлів, а не до каталогів. =DIR/ - Вибирає будь-яку директорію з ім'ям DIR і все, що знаходиться всередині. - Цей шаблон застосовується тільки до директорій, а не до файлів. + Вибирає будь-який каталог з ім'ям DIR і все, що знаходиться всередині. + Цей шаблон застосовується тільки до каталогів, а не до файлів. =/PATH/FILE Вибирає точно вказаний шлях до файлу. Цей шаблон застосовується - тільки до файлів, а не до директорій. + тільки до файлів, а не до каталогів. =/PATH/DIR/ - Вибирає точно вказаний шлях до директорії і все, що знаходиться - всередині. Цей шаблон застосовується тільки до директорій, а не до файлів. + Вибирає точно вказаний шлях до каталогу і все, що знаходиться + всередині. Цей шаблон застосовується тільки до каталогів, а не до файлів. Коли ви вказуєте абсолютний шлях, що починається з /, він застосовується до кореневого каталогу @@ -1770,7 +1770,7 @@ Name{number} Якщо ім'я файлу містить символи `*`, `?`, `[`, або `]`, ви повинні екранувати їх, щоб уникнути - їх інтерпретації як символу глоббінгу. + їх інтерпретації як символу глобінгу. В Unix символом екранування є `\`; у Windows — `^`. Коли шаблон знаходиться в командному рядку, ви повинні подвоїти символ екранування, щоб @@ -1823,10 +1823,10 @@ Name{number} :# Перевіряє лише файли .mp3. :# В Unix використовуйте лапки, щоб уникнути - :# розширення глоббінгу оболонкою. + :# розширення глобінгу оболонкою. :snapraid -f "*.mp3" check - В Unix, при використанні символів глоббінгу в + В Unix, при використанні символів глобінгу в командному рядку, ви повинні взяти їх у лапки, щоб запобігти їх розширенню оболонкою. @@ -1919,12 +1919,19 @@ Name{number} консолі у файл, отриманий файл завжди буде у форматі UTF-8. +Код завершення (Exit Code) + SnapRAID завершує роботу з такими кодами помилок: + + 0 - Все в порядку. + 1 - Команда виявила помилки. + 2 - Команда `diff` визначила, що все в порядку, але потрібен `sync`. + Переклад (Translation) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. Авторське право (Copyright) - Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni + Цей файл захищений авторським правом (C) 2026 Andrea Mazzoleni Див. також (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 9b8033f9..605aab47 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -35,8 +35,8 @@ SnapRAID — це програма резервного копіювання, р дискових масивів, яка зберігає інформацію парності для відновлення даних у випадку відмови до шести дисків. -В першу чергу призначена для домашніх медіацентрів з великими -файлами, що рідко змінюються, SnapRAID пропонує кілька функцій: +Насамперед призначений для домашніх медіацентрів з великими +файлами, які рідко змінюються, SnapRAID пропонує кілька функцій: * Ви можете використовувати диски, вже заповнені файлами, без необхідності їх переформатування, отримуючи доступ до них @@ -104,7 +104,7 @@ SnapRAID є гібридом між RAID і програмою резервно можете відновити дані навіть після повної відмови всього дискового масиву. * Зберігаються лише імена файлів, часові мітки, символічні - та жорсткі посилання. Права доступу, власність та + та жорсткі посилання. Права доступу, власники та розширені атрибути не зберігаються. @@ -246,7 +246,7 @@ SnapRAID є гібридом між RAID і програмою резервно Примітка: Функція об'єднання, описана нижче, була замінена інструментом mergerfs, який тепер є рекомендованою опцією для -користувачів Linux у спільноті SnapRAID. Mergefs забезпечує +користувачів Linux у спільноті SnapRAID. Mergerfs забезпечує більш гнучкий та ефективний спосіб об'єднання кількох дисків в єдину уніфіковану точку монтування, дозволяючи безперешкодний доступ до файлів у вашому масиві без використання символічних @@ -493,7 +493,7 @@ SnapRAID надає кілька простих команд, які дозво Виводить звіт SMART усіх дисків у системі. Включає оцінку ймовірності відмови протягом наступного року, -дозволяючи вам планувати планову заміну дисків, які +дозволяючи вам планувати своєчасну заміну дисків, які виявляють підозрілі атрибути. Ця оцінка ймовірності отримана шляхом кореляції атрибутів @@ -503,7 +503,7 @@ SMART дисків з даними Backblaze, доступними за адре Якщо SMART повідомляє, що диск виходить з ладу, для цього диска виводиться `FAIL` або `PREFAIL`, і SnapRAID повертає -помилку. У цьому випадку настійно рекомендується негайна +помилку. У цьому випадку наполегливо рекомендується негайна заміна диска. Інші можливі рядки стану: @@ -593,13 +593,13 @@ SMART дисків з даними Backblaze, доступними за адре на тому ж диску. Вони ідентифікуються за тим же іменем, розміром, часовою міткою та inode, але іншим каталогом. - copied - файли, скопійовані на той самий або інший диск, де + copied (скопійовані) - Файли, скопійовані на той самий або інший диск, де оригінальний файл все ще існує. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. Якщо мітка часу з точністю до часток секунди дорівнює нулю, для ідентифікації має збігатися повний шлях, а не лише назва. - relocated - файли, переміщені на той самий або інший диск, де + relocated (перерозміщені) - Файли, переміщені на той самий або інший диск, де оригінал зник. Вони ідентифікуються за однаковою назвою, розміром та міткою часу. @@ -607,7 +607,7 @@ SMART дисків з даними Backblaze, доступними за адре ідентифікації має збігатися повний шлях. На відміну від файлів 'moved' на тому ж диску, переміщені файли мають інший inode. - restored - файли з іншим inode, але зі збігом каталогу, назви, + restored (відновлені) - Файли з іншим inode, але зі збігом каталогу, назви, розміру та мітки часу. Зазвичай це файли, відновлені після видалення. @@ -742,7 +742,7 @@ SnapRAID перейменовує всі файли, які не можуть б Працює як `fix`, але лише імітує відновлення, і жодні зміни не записуються в масив. -Ця команда в першу чергу призначена для ручної перевірки, +Ця команда насамперед призначена для ручної перевірки, наприклад, після процесу відновлення або в інших особливих умовах. Для періодичних та запланованих перевірок використовуйте `scrub`. @@ -762,7 +762,7 @@ SnapRAID перейменовує всі файли, які не можуть б останньої `sync`. З -v або --verbose також показується час з точністю до -долі секунди. +часток секунди. Нічого не змінюється. @@ -815,17 +815,17 @@ SnapRAID перейменовує всі файли, які не можуть б 5.15 touch ---------- -Встановлює довільну часову мітку з точністю до долі секунди +Встановлює довільну часову мітку з точністю до часток секунди для всіх файлів, у яких вона встановлена на нуль. Це покращує здатність SnapRAID розпізнавати переміщені та скопійовані файли, оскільки робить часову мітку майже унікальною, зменшуючи можливі дублікати. -Зокрема, якщо часова мітка з точністю до долі секунди не +Зокрема, якщо часова мітка з точністю до часток секунди не дорівнює нулю, переміщений або скопійований файл ідентифікується як такий, якщо він збігається з іменем, розміром та часовою -міткою. Якщо часова мітка з точністю до долі секунди дорівнює +міткою. Якщо часова мітка з точністю до часток секунди дорівнює нулю, він вважається копією, лише якщо повний шлях, розмір та часова мітка збігаються. @@ -888,7 +888,7 @@ SnapRAID надає наступні опції: шаблону. Цю опцію можна використовувати кілька разів. Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. - В Unix переконайтеся, що символи глоббінгу взяті + В Unix переконайтеся, що символи глобінгу взяті в лапки, якщо вони використовуються. Цю опцію можна використовувати лише з `check` та `fix`. Її не можна використовувати з `sync` та `scrub`, оскільки @@ -999,7 +999,7 @@ SnapRAID надає наступні опції: Ви можете вказати множник, такий як K, M або G (наприклад, --bw-limit 1G). - -t, --tail РОЗМІР + -t, --tail SIZE Обмежує список файлів тими, що використовують не більше зазначеного розміру хвоста дисків парності. Можна використовувати множники, такі як K, M, G або T (наприклад, --tail 1G). @@ -1112,12 +1112,12 @@ SnapRAID надає наступні опції: вмісту, для перевірки даних. Цю опцію можна використовувати лише з `sync`. УВАГА! Ця опція лише для експертів, і - настійно не рекомендується її використовувати. + наполегливо не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції `sync`. - -W, --force-realloc-tail РОЗМІР + -W, --force-realloc-tail SIZE Працює як -R, --force-realloc, але обмежується вказаною кінцевою - частиною (останні РОЗМІР байт) кожного файлу парності. + частиною (останні SIZE-байт) кожного файлу парності. Примусово перерозподіляє (переміщує) будь-які фрагменти/блоки файлів, що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити їх будь-де у файлі(ах) парності, де є вільне місце (включно з @@ -1131,7 +1131,7 @@ SnapRAID надає наступні опції: Ви можете використовувати locate -t, --tail, щоб заздалегідь дізнатися про зачеплені файли. УВАГА! - Цей параметр призначений лише для експертів, і його настійно + Цей параметр призначений лише для експертів, і його наполегливо не рекомендується використовувати. Під час операції `sync` захист даних для зачеплених файлів ВІДСУТНІЙ. @@ -1277,8 +1277,8 @@ SnapRAID вимагає конфігураційний файл, щоб знат Визначає альтернативний файл та формат для зберігання потрійної парності. -Ця опція є альтернативою `3-parity`, в першу чергу -призначена для ЦП низького класу, таких як ARM або +Ця опція є альтернативою `3-parity`, насамперед +призначена для малопотужних ЦП, таких як ARM або AMD Phenom, Athlon та Opteron, які не підтримують набір інструкцій SSSE3. У таких випадках вона забезпечує кращу продуктивність. @@ -1369,7 +1369,7 @@ UUID дисків. Створення та видалення знімків вимагають прав адміністратора. Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли -включено цю опцію. +увімкнено цю опцію. Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS. @@ -1408,7 +1408,7 @@ UUID дисків. Розмір блоку за замовчуванням становить 256, що має працювати для більшості випадків. -УВАГА! Ця опція лише для експертів, і настійно +УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! @@ -1422,15 +1422,15 @@ UUID дисків. це може призвести до значного невикористаного місця парності. Коли ви повністю заповнюєте диск парності, вам не дозволяється додавати більше файлів на диски -даних. Однак, витрачена парність не накопичується -між дисками даних. Витрачене місце внаслідок великої +даних. Однак, втрачена парність не накопичується +між дисками даних. Марно втрачений простір внаслідок великої кількості файлів на диску даних обмежує лише кількість даних на цьому диску даних, а не на інших. Як наближення, ви можете припустити, що половина -розміру блоку витрачається для кожного файлу. +розміру блоку втрачається марно для кожного файлу. Наприклад, зі 100 000 файлами та розміром блоку 256 КіБ -ви витратите 12,8 ГБ парності, що може призвести до +ви втратите 12,8 ГБ парності, що може призвести до того, що на диску даних буде на 12,8 ГБ менше місця. Ви можете перевірити кількість витраченого місця на @@ -1467,18 +1467,18 @@ Linux, полягає в тому, щоб відформатувати його Розмір хешу за замовчуванням становить 16 байтів (128 біт), що має працювати для більшості випадків. -УВАГА! Ця опція лише для експертів, і настійно +УВАГА! Ця опція лише для експертів, і наполегливо не рекомендується змінювати це значення. Щоб змінити це значення в майбутньому, вам потрібно буде перестворити всю парність! -Причина використовувати інший розмір хешу полягає -в тому, якщо ваша система має обмежену пам'ять. -Як правило, SnapRAID зазвичай вимагає 1 ГіБ ОЗП -на кожні 16 ТБ даних у масиві. +Інший розмір хешу варто використовувати, якщо ваша +система має обмежену пам'ять. +Зазвичай SnapRAID потребує 1 ГіБ ОЗП на кожні 16 ТБ +даних у масиві. Зокрема, для зберігання хешів даних SnapRAID -вимагає приблизно $TS \times (1+HS) / BS$ байтів +вимагає приблизно TS*(1+HS)/BS байтів ОЗП, де TS — загальний розмір вашого дискового масиву у байтах, BS — розмір блоку у байтах, а HS — розмір хешу у байтах. @@ -1486,19 +1486,19 @@ Linux, полягає в тому, щоб відформатувати його Наприклад, з 8 дисками по 4 ТБ, розміром блоку 256 КіБ (1 КіБ = 1024 байта) та розміром хешу 16, ви отримуєте: -RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (256 \times 2^{10}) = 1.93$ ГіБ +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 ГіБ Перехід до розміру хешу 8, ви отримуєте: -RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (256 \times 2^{10}) = 1.02$ ГіБ +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 ГіБ Перехід до розміру блоку 512, ви отримуєте: -RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (512 \times 2^{10}) = 0.96$ ГіБ +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 ГіБ Перехід до розміру хешу 8 та розміру блоку 512, ви отримуєте: -RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (512 \times 2^{10}) = 0.51$ ГіБ +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 ГіБ 7.12 autosave SIZE_IN_GIGABYTES ------------------------------- @@ -1540,13 +1540,13 @@ smartctl. Поточні температури дисків відобража виключно на фактично виміряних температурах дисків. -Для виконання цього аналізу SnapRAID потрібна -довідкова інформація про температуру системи. +Для виконання цього аналізу SnapRAID потрібне +опорне значення температури системи. Спочатку він намагається зчитати її з доступних апаратних датчиків. Якщо до системного датчика неможливо отримати доступ, він використовує найнижчу температуру диска, виміряну на початку -запуску, як резервну довідкову інформацію. +запуску, як резервне опорне значення. Зазвичай SnapRAID показує лише температуру найгарячішого диска. Щоб відобразити температуру @@ -1843,7 +1843,7 @@ SnapRAID керує двома конкретними знімками, `stable` Класи символів із використанням квадратних дужок `[]` відповідають одному символу з визначеного набору або діапазону. Як і інші односимвольні шаблони, вони не відповідають роздільникам каталогів. Класи підтримують діапазони та заперечення за допомогою -знаку оклику. +знака оклику. Фундаментальна відмінність, яку слід пам'ятати, полягає в тому, що `*`, `?` та класи символів усі дотримуються меж каталогів і відповідають лише в межах одного компонента @@ -1854,19 +1854,19 @@ SnapRAID керує двома конкретними знімками, `stable` FILE Вибирає будь-який файл з ім'ям FILE. - Цей шаблон застосовується тільки до файлів, а не до директорій. + Цей шаблон застосовується тільки до файлів, а не до каталогів. DIR/ - Вибирає будь-яку директорію з ім'ям DIR і все, що знаходиться всередині. - Цей шаблон застосовується тільки до директорій, а не до файлів. + Вибирає будь-який каталог з ім'ям DIR і все, що знаходиться всередині. + Цей шаблон застосовується тільки до каталогів, а не до файлів. /PATH/FILE Вибирає точно вказаний шлях до файлу. Цей шаблон застосовується - тільки до файлів, а не до директорій. + тільки до файлів, а не до каталогів. /PATH/DIR/ - Вибирає точно вказаний шлях до директорії і все, що знаходиться - всередині. Цей шаблон застосовується тільки до директорій, а не до файлів. + Вибирає точно вказаний шлях до каталогу і все, що знаходиться + всередині. Цей шаблон застосовується тільки до каталогів, а не до файлів. Коли ви вказуєте абсолютний шлях, що починається з /, він застосовується до кореневого каталогу @@ -1883,7 +1883,7 @@ SnapRAID керує двома конкретними знімками, `stable` Якщо ім'я файлу містить символи `*`, `?`, `[`, або `]`, ви повинні екранувати їх, щоб уникнути -їх інтерпретації як символу глоббінгу. +їх інтерпретації як символу глобінгу. В Unix символом екранування є `\`; у Windows — `^`. Коли шаблон знаходиться в командному рядку, ви повинні подвоїти символ екранування, щоб @@ -1936,10 +1936,10 @@ SnapRAID керує двома конкретними знімками, `stable` # Перевіряє лише файли .mp3. # В Unix використовуйте лапки, щоб уникнути - # розширення глоббінгу оболонкою. + # розширення глобінгу оболонкою. snapraid -f "*.mp3" check -В Unix, при використанні символів глоббінгу в +В Unix, при використанні символів глобінгу в командному рядку, ви повинні взяти їх у лапки, щоб запобігти їх розширенню оболонкою. @@ -2045,20 +2045,30 @@ TrueType, такий як `Lucida Console`, як буде у форматі UTF-8. -15 Переклад (TRANSLATION) +15 Код завершення (EXIT CODE) +============================= + +SnapRAID завершує роботу з такими кодами помилок: + +0 - Все в порядку. +1 - Команда виявила помилки. +2 - Команда `diff` визначила, що все в порядку, але потрібен `sync`. + + +16 Переклад (TRANSLATION) ========================= Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. -16 Авторське право (COPYRIGHT) +17 Авторське право (COPYRIGHT) ============================== -Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni +Цей файл захищений авторським правом (C) 2026 Andrea Mazzoleni -17 Див. також (SEE ALSO) +18 Див. також (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index 0627acec..aee9cd07 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -129,7 +129,7 @@ SnapRAID 可以自动维护数据磁盘的冻结引用。 .PD 0 .IP \(bu 在没有快照支持的情况下，在 \`sync\` 之后删除或更改文件 -可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况 +可能会阻止其他损坏磁盘的完全恢复。发生这种情况 是因为校验数据不再与修改后的文件匹配，即使 这些文件不在损坏的磁盘上。另一方面，新添加的文件 不会阻止已存在文件的恢复。 @@ -287,7 +287,7 @@ snapraid sync 当此命令完成时，您的数据是**安全的**。 .PP 现在您可以开始随意使用您的阵列，并定期运行 \`sync\` 命令更新奇偶校验信息。 -.SS 数据洗刷 (Scrubbing) +.SS 数据擦洗 (Scrubbing) 要定期检查数据和奇偶校验的错误，您可以运行 \`scrub\` 命令。 .PP .RS 4 @@ -342,7 +342,7 @@ snapraid \-p bad scrub .SS 合并池 (Pooling) 注意：下面描述的 pooling 功能已被 mergerfs 工具取代， mergerfs 现在是 SnapRAID 社区推荐的 Linux 用户选项。 -Mergefs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 +Mergerfs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 统一的挂载点中，允许跨阵列无缝访问文件，而无需依赖符号链接。 它与 SnapRAID 很好地集成以提供奇偶校验保护，常用于 OpenMediaVault (OMV) 或自定义 NAS 配置等设置中。 @@ -627,7 +627,7 @@ SnapRAID 提供了几个简单的命令，允许您： .SS status 打印磁盘阵列状态的摘要。 .PP -它包括有关奇偶校验碎片、块未经检查有多久，以及在 scrubbing +它包括有关奇偶校验碎片、块未经检查有多久，以及在数据擦洗 (scrubbing) 期间遇到的所有记录的静默错误的信息。 .PP 所提供的信息指的是您上次运行 \`sync\` 的时间。 @@ -1043,7 +1043,7 @@ DAYS 是块被 scrub 的最小天数；默认值为 10。 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，\-\-bw\-limit 1G）。 .TP -.B \-t, \-\-tail 大小 +.B \-t, \-\-tail SIZE 将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 您可以使用乘数，如 K、M、G 或 T（例如 \-\-tail 1G）。 此选项仅在与 \`locate\` 命令配合使用时有效。 @@ -1126,9 +1126,9 @@ DAYS 是块被 scrub 的最小天数；默认值为 10。 **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 \`sync\` 操作期间，您**没有**数据保护。 .TP -.B \-W, \-\-force\-realloc\-tail 大小 +.B \-W, \-\-force\-realloc\-tail SIZE 工作方式类似于 \-R, \-\-force\-realloc，但仅限于每个校验文件的 -指定尾部部分（最后“大小”字节）。 +指定尾部部分（最后 SIZE 字节）。 它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， 允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 空隙）。 @@ -1385,36 +1385,36 @@ mkfs.ext4 \-m 0 \-T largefile4 DEVICE 根据经验，SnapRAID 通常每 16 TB 的阵列数据需要 1 GiB 的 RAM。 .PP 具体来说，为了存储数据的散列，SnapRAID 大约需要 -$TS*(1+HS)/BS$ 字节的 RAM， -其中 $TS$ 是您的磁盘阵列的总大小（以字节为单位），$BS$ 是块大小（以字节为单位）， -$HS$ 是散列大小（以字节为单位）。 +TS*(1+HS)/BS 字节的 RAM， +其中 TS 是您的磁盘阵列的总大小（以字节为单位），BS 是块大小（以字节为单位）， +HS 是散列大小（以字节为单位）。 .PP 例如，对于 8 个 4 TB 磁盘，块大小为 256 KiB （1 KiB = 1024 字节），散列大小为 16，您将获得： .PP -RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93$ GiB +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB .PD 0 .PD .PP 切换到散列大小为 8，您将获得： .PP -RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02$ GiB +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB .PD 0 .PD .PP 切换到块大小为 512，您将获得： .PP -RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96$ GiB +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB .PD 0 .PD .PP 切换到散列大小为 8 和块大小为 512，您将获得： .PP -RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51$ GiB +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB .PD 0 .PD .SS autosave SIZE_IN_GIGABYTES -在同步或 scrub 之后，处理指定数量的 GB 后，自动保存状态。 +在同步或 scrub 期间，每处理指定数量的 GB 后就自动保存状态。 此选项有助于避免在机器崩溃或任何其他事件中断时， 从头开始重新启动长时间的 \`sync\` 命令。 .SS temp_limit TEMPERATURE_CELSIUS @@ -1435,10 +1435,10 @@ SnapRAID 运行时会显示当前磁盘温度。 此估计温度仅供参考，对 SnapRAID 的行为没有影响。 程序的动作仅基于实际测量的磁盘温度。 .PP -要执行此分析，SnapRAID 需要一个系统温度的参考。 +要执行此分析，SnapRAID 需要一个系统温度的参考基准值。 它首先尝试从可用的硬件传感器读取。 如果无法访问系统传感器，它会使用运行时测量的最低磁盘温度 -作为备用参考。 +作为备用基准值。 .PP 通常，SnapRAID 只显示最热磁盘的温度。 要显示所有磁盘的温度，请使用 \-A 或 \-\-stats 选项。 @@ -1656,7 +1656,7 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .HP 4 .I 一致性 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 -不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点图像。 +不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 .HP 4 .I 恢复 如果从实时文件系统中更新或删除了一个文件， @@ -1722,7 +1722,7 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 \`scrub\`、\`check\` 和 \`fix\` 命令的主要数据源。 .PP -\`pending\` 快照是在 \`sync\` 开始时创建的临时图像， +\`pending\` 快照是在 \`sync\` 开始时创建的临时镜像， 用于为校验计算提供冻结状态。在操作成功完成后， 以前的 \`stable\` 快照将被删除，并且 \`pending\` 快照将被提升 以接替其作为新的稳定参考。 @@ -1993,10 +1993,25 @@ SnapRAID 在 Unix 中忽略任何编码。它读取并存储 作为控制台字体。这仅影响打印的文件名；如果 您将控制台输出重定向到文件，则生成的文件始终 采用 UTF\-8 格式。 +.SH 退出码 (EXIT CODE) +SnapRAID 终止并返回以下错误代码： +.RS 0 +.PD 0 +.HP 4 +.I 0 +一切正常。 +.HP 4 +.I 1 +命令遇到一些错误。 +.HP 4 +.I 2 +\`diff\` 命令发现一切正常，但需要进行 \`sync\`。 +.PD +.RE .SH 翻译 (TRANSLATION) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 .SH 版权 (COPYRIGHT) -此文件版权所有 (C) 2025 Andrea Mazzoleni +此文件版权所有 (C) 2026 Andrea Mazzoleni .SH 参见 (SEE ALSO) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index cc84e359..b072f983 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -60,7 +60,7 @@ Name{number} 恢复过程仍保持一致且可靠。 * 在没有快照支持的情况下，在 `sync` 之后删除或更改文件 - 可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况 + 可能会阻止其他损坏磁盘的完全恢复。发生这种情况 是因为校验数据不再与修改后的文件匹配，即使 这些文件不在损坏的磁盘上。另一方面，新添加的文件 不会阻止已存在文件的恢复。 @@ -148,7 +148,7 @@ Name{number} 现在您可以开始随意使用您的阵列，并定期运行 `sync` 命令更新奇偶校验信息。 - 数据洗刷 (Scrubbing) + 数据擦洗 (Scrubbing) 要定期检查数据和奇偶校验的错误，您可以运行 `scrub` 命令。 :snapraid scrub @@ -184,7 +184,7 @@ Name{number} 合并池 (Pooling) 注意：下面描述的 pooling 功能已被 mergerfs 工具取代， mergerfs 现在是 SnapRAID 社区推荐的 Linux 用户选项。 - Mergefs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 + Mergerfs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 统一的挂载点中，允许跨阵列无缝访问文件，而无需依赖符号链接。 它与 SnapRAID 很好地集成以提供奇偶校验保护，常用于 OpenMediaVault (OMV) 或自定义 NAS 配置等设置中。 @@ -358,7 +358,7 @@ Name{number} status 打印磁盘阵列状态的摘要。 - 它包括有关奇偶校验碎片、块未经检查有多久，以及在 scrubbing + 它包括有关奇偶校验碎片、块未经检查有多久，以及在数据擦洗 (scrubbing) 期间遇到的所有记录的静默错误的信息。 所提供的信息指的是您上次运行 `sync` 的时间。 @@ -757,7 +757,7 @@ Name{number} 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，--bw-limit 1G）。 - -t, --tail 大小 + -t, --tail SIZE 将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 您可以使用乘数，如 K、M、G 或 T（例如 --tail 1G）。 此选项仅在与 `locate` 命令配合使用时有效。 @@ -840,9 +840,9 @@ Name{number} **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 `sync` 操作期间，您**没有**数据保护。 - -W, --force-realloc-tail 大小 + -W, --force-realloc-tail SIZE 工作方式类似于 -R, --force-realloc，但仅限于每个校验文件的 - 指定尾部部分（最后“大小”字节）。 + 指定尾部部分（最后 SIZE 字节）。 它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， 允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 空隙）。 @@ -1101,29 +1101,29 @@ Name{number} 根据经验，SnapRAID 通常每 16 TB 的阵列数据需要 1 GiB 的 RAM。 具体来说，为了存储数据的散列，SnapRAID 大约需要 - $TS*(1+HS)/BS$ 字节的 RAM， - 其中 $TS$ 是您的磁盘阵列的总大小（以字节为单位），$BS$ 是块大小（以字节为单位）， - $HS$ 是散列大小（以字节为单位）。 + TS*(1+HS)/BS 字节的 RAM， + 其中 TS 是您的磁盘阵列的总大小（以字节为单位），BS 是块大小（以字节为单位）， + HS 是散列大小（以字节为单位）。 例如，对于 8 个 4 TB 磁盘，块大小为 256 KiB （1 KiB = 1024 字节），散列大小为 16，您将获得： - :RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93$ GiB + :RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB 切换到散列大小为 8，您将获得： - :RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02$ GiB + :RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB 切换到块大小为 512，您将获得： - :RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96$ GiB + :RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB 切换到散列大小为 8 和块大小为 512，您将获得： - :RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51$ GiB + :RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB autosave SIZE_IN_GIGABYTES - 在同步或 scrub 之后，处理指定数量的 GB 后，自动保存状态。 + 在同步或 scrub 期间，每处理指定数量的 GB 后就自动保存状态。 此选项有助于避免在机器崩溃或任何其他事件中断时， 从头开始重新启动长时间的 `sync` 命令。 @@ -1145,10 +1145,10 @@ Name{number} 此估计温度仅供参考，对 SnapRAID 的行为没有影响。 程序的动作仅基于实际测量的磁盘温度。 - 要执行此分析，SnapRAID 需要一个系统温度的参考。 + 要执行此分析，SnapRAID 需要一个系统温度的参考基准值。 它首先尝试从可用的硬件传感器读取。 如果无法访问系统传感器，它会使用运行时测量的最低磁盘温度 - 作为备用参考。 + 作为备用基准值。 通常，SnapRAID 只显示最热磁盘的温度。 要显示所有磁盘的温度，请使用 -A 或 --stats 选项。 @@ -1268,7 +1268,7 @@ Name{number} 这提供了两个主要好处： 一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 - 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点图像。 + 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 恢复 - 如果从实时文件系统中更新或删除了一个文件， 它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障， SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。 @@ -1326,7 +1326,7 @@ Name{number} 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 - `pending` 快照是在 `sync` 开始时创建的临时图像， + `pending` 快照是在 `sync` 开始时创建的临时镜像， 用于为校验计算提供冻结状态。在操作成功完成后， 以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 以接替其作为新的稳定参考。 @@ -1517,12 +1517,19 @@ Name{number} 您将控制台输出重定向到文件，则生成的文件始终 采用 UTF-8 格式。 +退出码 (Exit Code) + SnapRAID 终止并返回以下错误代码： + + 0 - 一切正常。 + 1 - 命令遇到一些错误。 + 2 - `diff` 命令发现一切正常，但需要进行 `sync`。 + 翻译 (Translation) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 版权 (Copyright) - 此文件版权所有 (C) 2025 Andrea Mazzoleni + 此文件版权所有 (C) 2026 Andrea Mazzoleni 参见 (See Also) snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 0f758871..b90ef351 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -70,7 +70,7 @@ SnapRAID 是 RAID 和备份程序之间的混合体，旨在结合两者的最 恢复过程仍保持一致且可靠。 * 在没有快照支持的情况下，在 `sync` 之后删除或更改文件 - 可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况 + 可能会阻止其他损坏磁盘的完全恢复。发生这种情况 是因为校验数据不再与修改后的文件匹配，即使 这些文件不在损坏的磁盘上。另一方面，新添加的文件 不会阻止已存在文件的恢复。 @@ -161,7 +161,7 @@ SnapRAID 的其他限制包括： 现在您可以开始随意使用您的阵列，并定期运行 `sync` 命令更新奇偶校验信息。 -4.1 数据洗刷 (Scrubbing) +4.1 数据擦洗 (Scrubbing) -------------------- 要定期检查数据和奇偶校验的错误，您可以运行 `scrub` 命令。 @@ -201,7 +201,7 @@ SnapRAID 的其他限制包括： 注意：下面描述的 pooling 功能已被 mergerfs 工具取代， mergerfs 现在是 SnapRAID 社区推荐的 Linux 用户选项。 -Mergefs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 +Mergerfs 提供了一种更灵活、更高效的方式，将多个驱动器汇集到一个 统一的挂载点中，允许跨阵列无缝访问文件，而无需依赖符号链接。 它与 SnapRAID 很好地集成以提供奇偶校验保护，常用于 OpenMediaVault (OMV) 或自定义 NAS 配置等设置中。 @@ -384,7 +384,7 @@ SnapRAID 提供了几个简单的命令，允许您： 打印磁盘阵列状态的摘要。 -它包括有关奇偶校验碎片、块未经检查有多久，以及在 scrubbing +它包括有关奇偶校验碎片、块未经检查有多久，以及在数据擦洗 (scrubbing) 期间遇到的所有记录的静默错误的信息。 所提供的信息指的是您上次运行 `sync` 的时间。 @@ -818,7 +818,7 @@ SnapRAID 提供以下选项： 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，--bw-limit 1G）。 - -t, --tail 大小 + -t, --tail SIZE 将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 您可以使用乘数，如 K、M、G 或 T（例如 --tail 1G）。 此选项仅在与 `locate` 命令配合使用时有效。 @@ -901,9 +901,9 @@ SnapRAID 提供以下选项： **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 `sync` 操作期间，您**没有**数据保护。 - -W, --force-realloc-tail 大小 + -W, --force-realloc-tail SIZE 工作方式类似于 -R, --force-realloc，但仅限于每个校验文件的 - 指定尾部部分（最后“大小”字节）。 + 指定尾部部分（最后 SIZE 字节）。 它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， 允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 空隙）。 @@ -1187,31 +1187,31 @@ DIR 是磁盘在文件系统中的挂载点。 根据经验，SnapRAID 通常每 16 TB 的阵列数据需要 1 GiB 的 RAM。 具体来说，为了存储数据的散列，SnapRAID 大约需要 -$TS*(1+HS)/BS$ 字节的 RAM， -其中 $TS$ 是您的磁盘阵列的总大小（以字节为单位），$BS$ 是块大小（以字节为单位）， -$HS$ 是散列大小（以字节为单位）。 +TS*(1+HS)/BS 字节的 RAM， +其中 TS 是您的磁盘阵列的总大小（以字节为单位），BS 是块大小（以字节为单位）， +HS 是散列大小（以字节为单位）。 例如，对于 8 个 4 TB 磁盘，块大小为 256 KiB （1 KiB = 1024 字节），散列大小为 16，您将获得： -RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93$ GiB +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB 切换到散列大小为 8，您将获得： -RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02$ GiB +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB 切换到块大小为 512，您将获得： -RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96$ GiB +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB 切换到散列大小为 8 和块大小为 512，您将获得： -RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51$ GiB +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB 7.12 autosave SIZE_IN_GIGABYTES ------------------------------- -在同步或 scrub 之后，处理指定数量的 GB 后，自动保存状态。 +在同步或 scrub 期间，每处理指定数量的 GB 后就自动保存状态。 此选项有助于避免在机器崩溃或任何其他事件中断时， 从头开始重新启动长时间的 `sync` 命令。 @@ -1235,10 +1235,10 @@ SnapRAID 运行时会显示当前磁盘温度。 此估计温度仅供参考，对 SnapRAID 的行为没有影响。 程序的动作仅基于实际测量的磁盘温度。 -要执行此分析，SnapRAID 需要一个系统温度的参考。 +要执行此分析，SnapRAID 需要一个系统温度的参考基准值。 它首先尝试从可用的硬件传感器读取。 如果无法访问系统传感器，它会使用运行时测量的最低磁盘温度 -作为备用参考。 +作为备用基准值。 通常，SnapRAID 只显示最热磁盘的温度。 要显示所有磁盘的温度，请使用 -A 或 --stats 选项。 @@ -1373,7 +1373,7 @@ Windows 的典型配置示例如下： 这提供了两个主要好处： 一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 - 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点图像。 + 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 恢复 - 如果从实时文件系统中更新或删除了一个文件， 它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障， SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。 @@ -1436,7 +1436,7 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 -`pending` 快照是在 `sync` 开始时创建的临时图像， +`pending` 快照是在 `sync` 开始时创建的临时镜像， 用于为校验计算提供冻结状态。在操作成功完成后， 以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 以接替其作为新的稳定参考。 @@ -1643,20 +1643,30 @@ SnapRAID 在 Unix 中忽略任何编码。它读取并存储 采用 UTF-8 格式。 -15 翻译 (TRANSLATION) +15 退出码 (EXIT CODE) +================== + +SnapRAID 终止并返回以下错误代码： + +0 - 一切正常。 +1 - 命令遇到一些错误。 +2 - `diff` 命令发现一切正常，但需要进行 `sync`。 + + +16 翻译 (TRANSLATION) =================== 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 -16 版权 (COPYRIGHT) +17 版权 (COPYRIGHT) ================= -此文件版权所有 (C) 2025 Andrea Mazzoleni +此文件版权所有 (C) 2026 Andrea Mazzoleni -17 参见 (SEE ALSO) +18 参见 (SEE ALSO) ================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid.1 b/doc/snapraid.1 index 8caed035..a306f52b 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -372,7 +372,7 @@ output, but the related blocks are not marked as bad. .SS Pooling Note: The pooling feature described below has been superseded by the mergerfs tool, which is now the recommended option for Linux users in -the SnapRAID community. Mergefs provides a more flexible and efficient +the SnapRAID community. Mergerfs provides a more flexible and efficient way to pool multiple drives into a single unified mount point, allowing seamless access to files across your array without relying on symbolic links. It integrates well with SnapRAID for parity diff --git a/doc/snapraid.d b/doc/snapraid.d index 2c633097..3970ddd5 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -214,7 +214,7 @@ Getting Started Pooling Note: The pooling feature described below has been superseded by the mergerfs tool, which is now the recommended option for Linux users in - the SnapRAID community. Mergefs provides a more flexible and efficient + the SnapRAID community. Mergerfs provides a more flexible and efficient way to pool multiple drives into a single unified mount point, allowing seamless access to files across your array without relying on symbolic links. It integrates well with SnapRAID for parity diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 981cbf3b..72646941 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -231,7 +231,7 @@ output, but the related blocks are not marked as bad. Note: The pooling feature described below has been superseded by the mergerfs tool, which is now the recommended option for Linux users in -the SnapRAID community. Mergefs provides a more flexible and efficient +the SnapRAID community. Mergerfs provides a more flexible and efficient way to pool multiple drives into a single unified mount point, allowing seamless access to files across your array without relying on symbolic links. It integrates well with SnapRAID for parity