From 2f7ac6996c38888ce6be49a1c9ddfcd710471e4f Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Wed, 25 Feb 2026 14:48:54 +0100 Subject: [PATCH] Update manpages --- doc/snapraid-de.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-de.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-de.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-es.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-es.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-es.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-fr.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-fr.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-fr.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-it.1 | 45 ++++++++++++++++++++++++++++++++++++++++-- doc/snapraid-it.d | 46 +++++++++++++++++++++++++++++++++++++++++-- doc/snapraid-it.txt | 48 +++++++++++++++++++++++++++++++++++++++++++-- doc/snapraid-ja.1 | 41 +++++++++++++++++++++++++++++++++++++- doc/snapraid-ja.d | 42 ++++++++++++++++++++++++++++++++++++++- doc/snapraid-ja.txt | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-ko.1 | 39 +++++++++++++++++++++++++++++++++++- doc/snapraid-ko.d | 40 ++++++++++++++++++++++++++++++++++++- doc/snapraid-ko.txt | 42 ++++++++++++++++++++++++++++++++++++++- doc/snapraid-pl.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-pl.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-pl.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-pt.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-pt.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-pt.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-ro.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-ro.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-ro.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-ru.1 | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-ru.d | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-ru.txt | 46 ++++++++++++++++++++++++++++++++++++++++++- doc/snapraid-sv.1 | 41 +++++++++++++++++++++++++++++++++++++- doc/snapraid-sv.d | 42 ++++++++++++++++++++++++++++++++++++++- doc/snapraid-sv.txt | 44 ++++++++++++++++++++++++++++++++++++++++- doc/snapraid-uk.1 | 40 ++++++++++++++++++++++++++++++++++++- doc/snapraid-uk.d | 41 +++++++++++++++++++++++++++++++++++++- doc/snapraid-uk.txt | 43 +++++++++++++++++++++++++++++++++++++++- doc/snapraid-zh.1 | 32 +++++++++++++++++++++++++++++- doc/snapraid-zh.d | 33 ++++++++++++++++++++++++++++++- doc/snapraid-zh.txt | 35 ++++++++++++++++++++++++++++++++- doc/snapraid.1 | 10 ++++++++-- doc/snapraid.d | 14 +++++++++---- doc/snapraid.txt | 10 ++++++++-- 42 files changed, 1653 insertions(+), 50 deletions(-) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 04152faa..d650bb9d 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1076,6 +1076,18 @@ Sie können den Neu\-Hash\-Zustand mithilfe von \`status\` überprüfen. Während der Neu\-Hash\-Berechnung behält SnapRAID die volle Funktionalität bei, mit der einzigen Ausnahme, dass \`dup\` keine doppelten Dateien mit einem anderen Hash erkennen kann. +.SS locate +Lokalisiert Dateien, die auf den Paritätsfestplatten gespeichert sind. Für jede +übereinstimmende Datei wird deren Position innerhalb der Paritätsdatei und die Anzahl +der belegten Fragmente ausgegeben. +.PP +Sie können die Option \-t, \-\-tail verwenden, um den Vorgang auf Dateien zu beschränken, +die den angegebenen Endbereich (Tail) der Parität belegen. +.PP +Wenn Sie diese Dateien neu zuweisen möchten, können Sie die Option +\-W, \-\-force\-realloc\-tail verwenden. +Beachten Sie, dass solche Dateien während des Neuzuweisungsprozesses +nicht durch die Parität geschützt sind. .SH OPTIONS SnapRAID bietet die folgenden Optionen: .TP @@ -1194,6 +1206,13 @@ 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). .TP +.B \-t, \-\-tail GRÖSSE +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). +Diese Option ist nur in Verbindung mit dem Befehl +\`locate\` gültig. +.TP .B \-A, \-\-stats Aktiviert eine erweiterte Statusansicht, die zusätzliche Informationen anzeigt. Der Bildschirm zeigt zwei Diagramme an: @@ -1296,6 +1315,28 @@ 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 +Funktioniert wie \-R, \-\-force\-realloc, ist jedoch auf den angegebenen +Endbereich (die letzten GRÖSSE 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 +verfügbar ist (einschließlich vorhandener Lücken). +Der Hauptzweck dieser Option besteht darin, die Größe der Paritätsdatei +auf der Festplatte zu verringern. +Wenn die Neuzuweisung den gesamten Endabschnitt erfolgreich leert +(keine Blöcke verbleiben dort), wird die Paritätsdatei gekürzt, +wodurch der ungenutzte Endbereich freigegeben wird. +Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. +\-\-force\-realloc\-tail 1G). +Sie können locate \-t, \-\-tail verwenden, um die betroffenen Dateien +im Voraus zu ermitteln. +WARNUNG! +Diese Option ist nur für Experten gedacht und es wird dringend +empfohlen, sie nicht zu verwenden. +Während des \`sync\`\-Vorgangs besteht für die betroffenen Dateien +KEIN Datenschutz. +.TP .B \-l, \-\-log FILE Schreibt ein detailliertes Protokoll in die angegebene Datei. Wenn diese Option nicht angegeben ist, werden unerwartete Fehler diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index f40e388d..6d3d8fac 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -787,6 +787,19 @@ Commands Funktionalität bei, mit der einzigen Ausnahme, dass `dup` keine doppelten Dateien mit einem anderen Hash erkennen kann. + locate + Lokalisiert Dateien, die auf den Paritätsfestplatten gespeichert sind. Für jede + übereinstimmende Datei wird deren Position innerhalb der Paritätsdatei und die Anzahl + der belegten Fragmente ausgegeben. + + Sie können die Option -t, --tail verwenden, um den Vorgang auf Dateien zu beschränken, + die den angegebenen Endbereich (Tail) der Parität belegen. + + Wenn Sie diese Dateien neu zuweisen möchten, können Sie die Option + -W, --force-realloc-tail verwenden. + Beachten Sie, dass solche Dateien während des Neuzuweisungsprozesses + nicht durch die Parität geschützt sind. + Options SnapRAID bietet die folgenden Optionen: @@ -905,6 +918,13 @@ Options 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). + -t, --tail GRÖSSE + 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). + Diese Option ist nur in Verbindung mit dem Befehl + `locate` gültig. + -A, --stats Aktiviert eine erweiterte Statusansicht, die zusätzliche Informationen anzeigt. Der Bildschirm zeigt zwei Diagramme an: @@ -1007,6 +1027,28 @@ Options dringend empfohlen, sie nicht zu verwenden. Sie haben während der `sync`-Operation KEINEN Datenschutz. + -W, --force-realloc-tail GRÖSSE + Funktioniert wie -R, --force-realloc, ist jedoch auf den angegebenen + Endbereich (die letzten GRÖSSE 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 + verfügbar ist (einschließlich vorhandener Lücken). + Der Hauptzweck dieser Option besteht darin, die Größe der Paritätsdatei + auf der Festplatte zu verringern. + Wenn die Neuzuweisung den gesamten Endabschnitt erfolgreich leert + (keine Blöcke verbleiben dort), wird die Paritätsdatei gekürzt, + wodurch der ungenutzte Endbereich freigegeben wird. + Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. + --force-realloc-tail 1G). + Sie können locate -t, --tail verwenden, um die betroffenen Dateien + im Voraus zu ermitteln. + WARNUNG! + Diese Option ist nur für Experten gedacht und es wird dringend + empfohlen, sie nicht zu verwenden. + Während des `sync`-Vorgangs besteht für die betroffenen Dateien + KEIN Datenschutz. + -l, --log FILE Schreibt ein detailliertes Protokoll in die angegebene Datei. Wenn diese Option nicht angegeben ist, werden unerwartete Fehler diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index cd7308b5..4ced759b 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -843,6 +843,21 @@ Während der Neu-Hash-Berechnung behält SnapRAID die volle Funktionalität bei, mit der einzigen Ausnahme, dass `dup` keine doppelten Dateien mit einem anderen Hash erkennen kann. +5.17 locate +----------- + +Lokalisiert Dateien, die auf den Paritätsfestplatten gespeichert sind. Für jede +übereinstimmende Datei wird deren Position innerhalb der Paritätsdatei und die Anzahl +der belegten Fragmente ausgegeben. + +Sie können die Option -t, --tail verwenden, um den Vorgang auf Dateien zu beschränken, +die den angegebenen Endbereich (Tail) der Parität belegen. + +Wenn Sie diese Dateien neu zuweisen möchten, können Sie die Option +-W, --force-realloc-tail verwenden. +Beachten Sie, dass solche Dateien während des Neuzuweisungsprozesses +nicht durch die Parität geschützt sind. + 6 OPTIONS ========= @@ -964,6 +979,13 @@ SnapRAID bietet die folgenden Optionen: 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). + -t, --tail GRÖSSE + 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). + Diese Option ist nur in Verbindung mit dem Befehl + `locate` gültig. + -A, --stats Aktiviert eine erweiterte Statusansicht, die zusätzliche Informationen anzeigt. Der Bildschirm zeigt zwei Diagramme an: @@ -1066,6 +1088,28 @@ 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 + Funktioniert wie -R, --force-realloc, ist jedoch auf den angegebenen + Endbereich (die letzten GRÖSSE 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 + verfügbar ist (einschließlich vorhandener Lücken). + Der Hauptzweck dieser Option besteht darin, die Größe der Paritätsdatei + auf der Festplatte zu verringern. + Wenn die Neuzuweisung den gesamten Endabschnitt erfolgreich leert + (keine Blöcke verbleiben dort), wird die Paritätsdatei gekürzt, + wodurch der ungenutzte Endbereich freigegeben wird. + Sie können Multiplikatoren wie K, M, G oder T verwenden (z. B. + --force-realloc-tail 1G). + Sie können locate -t, --tail verwenden, um die betroffenen Dateien + im Voraus zu ermitteln. + WARNUNG! + Diese Option ist nur für Experten gedacht und es wird dringend + empfohlen, sie nicht zu verwenden. + Während des `sync`-Vorgangs besteht für die betroffenen Dateien + KEIN Datenschutz. + -l, --log FILE Schreibt ein detailliertes Protokoll in die angegebene Datei. Wenn diese Option nicht angegeben ist, werden unerwartete Fehler diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index deff5bf9..61a3fc92 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1025,6 +1025,18 @@ Puede verificar el estado del nuevo cálculo de hash usando \`status\`. Durante el nuevo cálculo de hash, SnapRAID mantiene la funcionalidad completa, con la única excepción de que \`dup\` no puede detectar archivos duplicados utilizando un hash diferente. +.SS locate +Localiza archivos almacenados en los discos de paridad. Para cada archivo coincidente, +imprime su ubicación dentro del archivo de paridad y el número de fragmentos +que ocupa. +.PP +Puede usar la opción \-t, \-\-tail para restringir la operación a los archivos +que ocupan la porción final especificada de la paridad. +.PP +Si desea reasignar estos archivos, puede usar la opción +\-W, \-\-force\-realloc\-tail. +Tenga en cuenta que dichos archivos no estarán protegidos por la paridad durante +el proceso de reasignación. .SH OPTIONS SnapRAID proporciona las siguientes opciones: .TP @@ -1150,6 +1162,13 @@ 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 +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). +Esta opción solo es válida cuando se usa junto con el comando +\`locate\`. +.TP .B \-A, \-\-stats Habilita una vista de estado extendida que muestra información adicional. La pantalla muestra dos gráficos: @@ -1251,6 +1270,28 @@ 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 +Funciona como \-R, \-\-force\-realloc, pero limitado a la porción final +especificada (últimos TAMAÑO 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 +disponible (incluyendo huecos existentes). +El propósito principal de esta opción es reducir el tamaño en disco +del archivo de paridad. +Si la reasignación vacía con éxito toda la sección final +(no quedan bloques usándola), el archivo de paridad se trunca, +recuperando el espacio final no utilizado. +Puede usar multiplicadores como K, M, G o T (por ejemplo, +\-\-force\-realloc\-tail 1G). +Puede usar locate \-t, \-\-tail para conocer de antemano +los archivos afectados. +¡ADVERTENCIA! +Esta opción es solo para expertos y se recomienda +encarecidamente no usarla. +Usted NO tiene protección de datos durante la operación \`sync\` +para los archivos afectados. +.TP .B \-l, \-\-log FILE Escribe un registro detallado en el archivo especificado. Si no se especifica esta opción, los errores inesperados se diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 70c27e88..c1c36504 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -747,6 +747,19 @@ Commands completa, con la única excepción de que `dup` no puede detectar archivos duplicados utilizando un hash diferente. + locate + Localiza archivos almacenados en los discos de paridad. Para cada archivo coincidente, + imprime su ubicación dentro del archivo de paridad y el número de fragmentos + que ocupa. + + Puede usar la opción -t, --tail para restringir la operación a los archivos + que ocupan la porción final especificada de la paridad. + + Si desea reasignar estos archivos, puede usar la opción + -W, --force-realloc-tail. + Tenga en cuenta que dichos archivos no estarán protegidos por la paridad durante + el proceso de reasignación. + Options SnapRAID proporciona las siguientes opciones: @@ -872,6 +885,13 @@ 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 + 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). + Esta opción solo es válida cuando se usa junto con el comando + `locate`. + -A, --stats Habilita una vista de estado extendida que muestra información adicional. La pantalla muestra dos gráficos: @@ -973,6 +993,28 @@ Options recomienda encarecidamente no usarla. NO tiene protección de datos durante la operación `sync`. + -W, --force-realloc-tail TAMAÑO + Funciona como -R, --force-realloc, pero limitado a la porción final + especificada (últimos TAMAÑO 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 + disponible (incluyendo huecos existentes). + El propósito principal de esta opción es reducir el tamaño en disco + del archivo de paridad. + Si la reasignación vacía con éxito toda la sección final + (no quedan bloques usándola), el archivo de paridad se trunca, + recuperando el espacio final no utilizado. + Puede usar multiplicadores como K, M, G o T (por ejemplo, + --force-realloc-tail 1G). + Puede usar locate -t, --tail para conocer de antemano + los archivos afectados. + ¡ADVERTENCIA! + Esta opción es solo para expertos y se recomienda + encarecidamente no usarla. + Usted NO tiene protección de datos durante la operación `sync` + para los archivos afectados. + -l, --log FILE Escribe un registro detallado en el archivo especificado. Si no se especifica esta opción, los errores inesperados se diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 05b26067..d9a37963 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -803,6 +803,21 @@ Durante el nuevo cálculo de hash, SnapRAID mantiene la funcionalidad completa, con la única excepción de que `dup` no puede detectar archivos duplicados utilizando un hash diferente. +5.17 locate +----------- + +Localiza archivos almacenados en los discos de paridad. Para cada archivo coincidente, +imprime su ubicación dentro del archivo de paridad y el número de fragmentos +que ocupa. + +Puede usar la opción -t, --tail para restringir la operación a los archivos +que ocupan la porción final especificada de la paridad. + +Si desea reasignar estos archivos, puede usar la opción +-W, --force-realloc-tail. +Tenga en cuenta que dichos archivos no estarán protegidos por la paridad durante +el proceso de reasignación. + 6 OPTIONS ========= @@ -931,6 +946,13 @@ 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 + 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). + Esta opción solo es válida cuando se usa junto con el comando + `locate`. + -A, --stats Habilita una vista de estado extendida que muestra información adicional. La pantalla muestra dos gráficos: @@ -1032,6 +1054,28 @@ 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 + Funciona como -R, --force-realloc, pero limitado a la porción final + especificada (últimos TAMAÑO 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 + disponible (incluyendo huecos existentes). + El propósito principal de esta opción es reducir el tamaño en disco + del archivo de paridad. + Si la reasignación vacía con éxito toda la sección final + (no quedan bloques usándola), el archivo de paridad se trunca, + recuperando el espacio final no utilizado. + Puede usar multiplicadores como K, M, G o T (por ejemplo, + --force-realloc-tail 1G). + Puede usar locate -t, --tail para conocer de antemano + los archivos afectados. + ¡ADVERTENCIA! + Esta opción es solo para expertos y se recomienda + encarecidamente no usarla. + Usted NO tiene protección de datos durante la operación `sync` + para los archivos afectados. + -l, --log FILE Escribe un registro detallado en el archivo especificado. Si no se especifica esta opción, los errores inesperados se diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 6b3b3624..893642a2 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1049,6 +1049,18 @@ Vous pouvez vérifier l\'état du nouveau hachage en utilisant \`status\`. Pendant le nouveau hachage, SnapRAID conserve toutes ses fonctionnalités, à la seule exception que \`dup\` ne peut pas détecter les fichiers en double utilisant un hachage différent. +.SS locate +Localise les fichiers stockés sur les disques de parité. Pour chaque fichier +correspondant, il affiche son emplacement dans le fichier de parité et le nombre +de fragments qu\'il occupe. +.PP +Vous pouvez utiliser l\'option \-t, \-\-tail pour restreindre l\'opération aux fichiers +occupant la partie terminale spécifiée de la parité. +.PP +Si vous souhaitez réallouer ces fichiers, vous pouvez alors utiliser l\'option +\-W, \-\-force\-realloc\-tail. +Sachez que ces fichiers ne seront pas protégés par la parité pendant le processus +de réallocation. .SH OPTIONS SnapRAID fournit les options suivantes : .TP @@ -1177,6 +1189,13 @@ 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). .TP +.B \-t, \-\-tail TAILLE +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). +Cette option n\'est valide que lorsqu\'elle est utilisée avec la +commande \`locate\`. +.TP .B \-A, \-\-stats Active une vue d\'état étendue qui affiche des informations supplémentaires. @@ -1283,6 +1302,28 @@ 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é. +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 +est disponible (y compris les trous existants). +Le but principal de cette option est de réduire la taille sur disque +du fichier de parité. +Si la réallocation réussit à vider toute la section terminale +(plus aucun bloc ne l\'utilise), le fichier de parité est tronqué, +récupérant l\'espace terminal inutilisé. +Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: +\-\-force\-realloc\-tail 1G). +Vous pouvez utiliser locate \-t, \-\-tail pour connaître à l\'avance +les fichiers affectés. +AVERTISSEMENT ! +Cette option est réservée aux experts et il est fortement +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 Écrit un journal détaillé dans le fichier spécifié. Si cette option n\'est pas spécifiée, les erreurs inattendues diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 2d9a3d22..e05e2038 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENU] @@ -771,6 +771,19 @@ Commandes fonctionnalités, à la seule exception que `dup` ne peut pas détecter les fichiers en double utilisant un hachage différent. + locate + Localise les fichiers stockés sur les disques de parité. Pour chaque fichier + correspondant, il affiche son emplacement dans le fichier de parité et le nombre + de fragments qu'il occupe. + + Vous pouvez utiliser l'option -t, --tail pour restreindre l'opération aux fichiers + occupant la partie terminale spécifiée de la parité. + + Si vous souhaitez réallouer ces fichiers, vous pouvez alors utiliser l'option + -W, --force-realloc-tail. + Sachez que ces fichiers ne seront pas protégés par la parité pendant le processus + de réallocation. + Options SnapRAID fournit les options suivantes : @@ -899,6 +912,13 @@ Options 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). + -t, --tail TAILLE + 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). + Cette option n'est valide que lorsqu'elle est utilisée avec la + commande `locate`. + -A, --stats Active une vue d'état étendue qui affiche des informations supplémentaires. @@ -1005,6 +1025,28 @@ 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é. + 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 + est disponible (y compris les trous existants). + Le but principal de cette option est de réduire la taille sur disque + du fichier de parité. + Si la réallocation réussit à vider toute la section terminale + (plus aucun bloc ne l'utilise), le fichier de parité est tronqué, + récupérant l'espace terminal inutilisé. + Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: + --force-realloc-tail 1G). + Vous pouvez utiliser locate -t, --tail pour connaître à l'avance + les fichiers affectés. + AVERTISSEMENT ! + Cette option est réservée aux experts et il est fortement + 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. + -l, --log FICHIER Écrit un journal détaillé dans le fichier spécifié. Si cette option n'est pas spécifiée, les erreurs inattendues diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index c621d5a9..456673a6 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENU] @@ -827,6 +827,21 @@ Pendant le nouveau hachage, SnapRAID conserve toutes ses fonctionnalités, à la seule exception que `dup` ne peut pas détecter les fichiers en double utilisant un hachage différent. +5.17 locate +----------- + +Localise les fichiers stockés sur les disques de parité. Pour chaque fichier +correspondant, il affiche son emplacement dans le fichier de parité et le nombre +de fragments qu'il occupe. + +Vous pouvez utiliser l'option -t, --tail pour restreindre l'opération aux fichiers +occupant la partie terminale spécifiée de la parité. + +Si vous souhaitez réallouer ces fichiers, vous pouvez alors utiliser l'option +-W, --force-realloc-tail. +Sachez que ces fichiers ne seront pas protégés par la parité pendant le processus +de réallocation. + 6 OPTIONS ========= @@ -958,6 +973,13 @@ SnapRAID fournit les options suivantes : 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). + -t, --tail TAILLE + 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). + Cette option n'est valide que lorsqu'elle est utilisée avec la + commande `locate`. + -A, --stats Active une vue d'état étendue qui affiche des informations supplémentaires. @@ -1064,6 +1086,28 @@ 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é. + 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 + est disponible (y compris les trous existants). + Le but principal de cette option est de réduire la taille sur disque + du fichier de parité. + Si la réallocation réussit à vider toute la section terminale + (plus aucun bloc ne l'utilise), le fichier de parité est tronqué, + récupérant l'espace terminal inutilisé. + Vous pouvez utiliser des multiplicateurs tels que K, M, G ou T (ex: + --force-realloc-tail 1G). + Vous pouvez utiliser locate -t, --tail pour connaître à l'avance + les fichiers affectés. + AVERTISSEMENT ! + Cette option est réservée aux experts et il est fortement + 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. + -l, --log FICHIER Écrit un journal détaillé dans le fichier spécifié. Si cette option n'est pas spécifiée, les erreurs inattendues diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index 4dacbcef..147be587 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1043,6 +1043,18 @@ progressivamente durante \`sync\` e \`scrub\`. Durante il rehash, SnapRAID mantiene la piena funzionalità, con l\'unica eccezione che \`dup\` non è in grado di rilevare file duplicati utilizzando un hash diverso. +.SS locate +Individua i file memorizzati nei dischi di parità. Per ogni file corrispondente, +stampa la sua posizione all\'interno del file di parità e il numero di frammenti +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. .SH OPZIONI SnapRAID fornisce le seguenti opzioni: .TP @@ -1166,7 +1178,14 @@ arrestati in modo sicuro anche in caso di errore di un comando. .B \-w, \-\-bw\-limit RATE 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 o G (ad esempio, \-\-bw\-limit 1G). +moltiplicatore come K, M, G o T (ad esempio, \-\-bw\-limit 1G). +.TP +.B \-t, \-\-tail DIMENSIONE +Limita l\'elenco dei file a quelli che non utilizzano più della +dimensione di coda 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\`. .TP .B \-A, \-\-stats Abilita una vista dello stato estesa che mostra informazioni @@ -1272,6 +1291,28 @@ 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 +Funziona come \-R, \-\-force\-realloc, ma limitatamente alla porzione +di coda specificata (ultimi DIMENSIONE 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 +(inclusi i buchi esistenti). +Lo scopo principale di questa opzione è ridurre la dimensione su disco +del file di parità. +Se la riallocazione svuota con successo l\'intera sezione di coda +(non rimangono blocchi che la utilizzano), il file di parità viene +troncato, recuperando lo spazio di coda inutilizzato. +È possibile utilizzare moltiplicatori come K, M, G o T (ad es. +\-\-force\-realloc\-tail 1G). +È possibile utilizzare locate \-t, \-\-tail per conoscere in anticipo +i file interessati. +ATTENZIONE! +Questa opzione è solo per esperti ed è caldamente +raccomandato di non usarla. +NON si ha protezione dei dati durante l\'operazione di \`sync\` +per i file interessati. +.TP .B \-l, \-\-log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 17d39d8a..afdda595 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -18,7 +18,7 @@ Sinossi : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -754,6 +754,19 @@ Comandi con l'unica eccezione che `dup` non è in grado di rilevare file duplicati utilizzando un hash diverso. + locate + Individua i file memorizzati nei dischi di parità. Per ogni file corrispondente, + stampa la sua posizione all'interno del file di parità e il numero di frammenti + 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. + Opzioni SnapRAID fornisce le seguenti opzioni: @@ -877,7 +890,14 @@ Opzioni -w, --bw-limit RATE 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 o G (ad esempio, --bw-limit 1G). + moltiplicatore come K, M, G o T (ad esempio, --bw-limit 1G). + + -t, --tail DIMENSIONE + Limita l'elenco dei file a quelli che non utilizzano più della + dimensione di coda 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`. -A, --stats Abilita una vista dello stato estesa che mostra informazioni @@ -983,6 +1003,28 @@ Opzioni sconsigliato utilizzarla. NON si ha protezione dei dati durante l'operazione `sync`. + -W, --force-realloc-tail DIMENSIONE + Funziona come -R, --force-realloc, ma limitatamente alla porzione + di coda specificata (ultimi DIMENSIONE 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 + (inclusi i buchi esistenti). + Lo scopo principale di questa opzione è ridurre la dimensione su disco + del file di parità. + Se la riallocazione svuota con successo l'intera sezione di coda + (non rimangono blocchi che la utilizzano), il file di parità viene + troncato, recuperando lo spazio di coda inutilizzato. + È possibile utilizzare moltiplicatori come K, M, G o T (ad es. + --force-realloc-tail 1G). + È possibile utilizzare locate -t, --tail per conoscere in anticipo + i file interessati. + ATTENZIONE! + Questa opzione è solo per esperti ed è caldamente + raccomandato di non usarla. + NON si ha protezione dei dati durante l'operazione di `sync` + per i file interessati. + -l, --log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index 17142d82..ff271429 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -810,6 +810,21 @@ Durante il rehash, SnapRAID mantiene la piena funzionalità, con l'unica eccezione che `dup` non è in grado di rilevare file duplicati utilizzando un hash diverso. +5.17 locate +----------- + +Individua i file memorizzati nei dischi di parità. Per ogni file corrispondente, +stampa la sua posizione all'interno del file di parità e il numero di frammenti +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. + 6 OPZIONI ========= @@ -936,7 +951,14 @@ SnapRAID fornisce le seguenti opzioni: -w, --bw-limit RATE 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 o G (ad esempio, --bw-limit 1G). + moltiplicatore come K, M, G o T (ad esempio, --bw-limit 1G). + + -t, --tail DIMENSIONE + Limita l'elenco dei file a quelli che non utilizzano più della + dimensione di coda 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`. -A, --stats Abilita una vista dello stato estesa che mostra informazioni @@ -1042,6 +1064,28 @@ SnapRAID fornisce le seguenti opzioni: sconsigliato utilizzarla. NON si ha protezione dei dati durante l'operazione `sync`. + -W, --force-realloc-tail DIMENSIONE + Funziona come -R, --force-realloc, ma limitatamente alla porzione + di coda specificata (ultimi DIMENSIONE 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 + (inclusi i buchi esistenti). + Lo scopo principale di questa opzione è ridurre la dimensione su disco + del file di parità. + Se la riallocazione svuota con successo l'intera sezione di coda + (non rimangono blocchi che la utilizzano), il file di parità viene + troncato, recuperando lo spazio di coda inutilizzato. + È possibile utilizzare moltiplicatori come K, M, G o T (ad es. + --force-realloc-tail 1G). + È possibile utilizzare locate -t, --tail per conoscere in anticipo + i file interessati. + ATTENZIONE! + Questa opzione è solo per esperti ed è caldamente + raccomandato di non usarla. + NON si ha protezione dei dati durante l'operazione di `sync` + per i file interessati. + -l, --log FILE Scrive un log dettagliato nel file specificato. Se questa opzione non è specificata, gli errori imprevisti vengono diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index 302d1790..68e4fb2c 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -958,6 +958,17 @@ SnapRAIDが移動およびコピーされたファイルを認識する能力が .PP リハッシュ中もSnapRAIDは完全な機能を維持しますが、唯一の例外として、 \`dup\` は異なるハッシュを使用している重複ファイルを検出できません。 +.SS locate +パリティディスクに保存されているファイルを検索します。一致する各ファイルについて、 +パリティファイル内での位置と、それが占有するフラグメントの数を出力します。 +.TP +.B \-t, \-\-tail オプションを使用すると、パリティの指定された末尾部分を占有する +ファイルに操作を制限できます。 +.PP +これらのファイルを再配置したい場合は、\-W, \-\-force\-realloc\-tail オプションを +使用できます。 +再配置プロセス中、これらのファイルはパリティによって保護されないことに +注意してください。 .SH OPTIONS SnapRAIDには、次のオプションがあります。 .TP @@ -1061,6 +1072,13 @@ DAYS は、ブロックがスクラブされるための最小経過日数であ 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：\-\-bw\-limit 1G)。 .TP +.B \-t, \-\-tail サイズ +ファイルリストを、パリティディスクの指定された末尾サイズ以下を +使用しているものに制限します。 +K、M、G、T などの倍数を使用できます（例：\-\-tail 1G）。 +このオプションは、\`locate\` コマンドと一緒に使用された場合にのみ +有効です。 +.TP .B \-A, \-\-stats 追加情報を表示する拡張ステータスビューを有効にします。 画面には2つのグラフが表示されます。 @@ -1139,6 +1157,27 @@ SnapRAIDが一部のディスクがUUIDを変更したことを検出した場 お勧めします。 \`sync\` 操作中にデータ保護はありません。 .TP +.B \-W, \-\-force\-realloc\-tail サイズ +\-R, \-\-force\-realloc と同様に動作しますが、各パリティファイルの +指定された末尾部分（最後の「サイズ」バイト）に制限されます。 +現在その末尾セクションに保存されているファイルフラグメント/ブロックの +再配置（移動）を強制し、空きスペースがあるパリティファイル内の +任意の場所（既存のホールを含む）に配置できるようにします。 +このオプションの主な目的は、パリティファイルのディスク上でのサイズを +縮小することです。 +再配置によって末尾セクション全体が正常にクリアされた場合 +（それを使用するブロックが残っていない場合）、パリティファイルは +切り詰められ、未使用の末尾スペースが回収されます。 +K、M、G、T などの倍数を使用できます（例： +\-\-force\-realloc\-tail 1G）。 +locate \-t, \-\-tail を使用して、影響を受けるファイルを事前に +知ることができます。 +警告！ +このオプションはエキスパート専用であり、使用しないことが +強く推奨されます。 +影響を受けるファイルについては、\`sync\` 操作中にデータ保護は +行われません。 +.TP .B \-l, \-\-log FILE 詳細なログを指定されたファイルに書き込みます。 このオプションが指定されていない場合、予期しないエラーが画面に出力され、 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 7d40b32f..151b4c02 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -680,6 +680,18 @@ Commands リハッシュ中もSnapRAIDは完全な機能を維持しますが、唯一の例外として、 `dup` は異なるハッシュを使用している重複ファイルを検出できません。 + locate + パリティディスクに保存されているファイルを検索します。一致する各ファイルについて、 + パリティファイル内での位置と、それが占有するフラグメントの数を出力します。 + + -t, --tail オプションを使用すると、パリティの指定された末尾部分を占有する + ファイルに操作を制限できます。 + + これらのファイルを再配置したい場合は、-W, --force-realloc-tail オプションを + 使用できます。 + 再配置プロセス中、これらのファイルはパリティによって保護されないことに + 注意してください。 + Options SnapRAIDには、次のオプションがあります。 @@ -783,6 +795,13 @@ Options 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：--bw-limit 1G)。 + -t, --tail サイズ + ファイルリストを、パリティディスクの指定された末尾サイズ以下を + 使用しているものに制限します。 + K、M、G、T などの倍数を使用できます（例：--tail 1G）。 + このオプションは、`locate` コマンドと一緒に使用された場合にのみ + 有効です。 + -A, --stats 追加情報を表示する拡張ステータスビューを有効にします。 画面には2つのグラフが表示されます。 @@ -861,6 +880,27 @@ Options お勧めします。 `sync` 操作中にデータ保護はありません。 + -W, --force-realloc-tail サイズ + -R, --force-realloc と同様に動作しますが、各パリティファイルの + 指定された末尾部分（最後の「サイズ」バイト）に制限されます。 + 現在その末尾セクションに保存されているファイルフラグメント/ブロックの + 再配置（移動）を強制し、空きスペースがあるパリティファイル内の + 任意の場所（既存のホールを含む）に配置できるようにします。 + このオプションの主な目的は、パリティファイルのディスク上でのサイズを + 縮小することです。 + 再配置によって末尾セクション全体が正常にクリアされた場合 + （それを使用するブロックが残っていない場合）、パリティファイルは + 切り詰められ、未使用の末尾スペースが回収されます。 + K、M、G、T などの倍数を使用できます（例： + --force-realloc-tail 1G）。 + locate -t, --tail を使用して、影響を受けるファイルを事前に + 知ることができます。 + 警告！ + このオプションはエキスパート専用であり、使用しないことが + 強く推奨されます。 + 影響を受けるファイルについては、`sync` 操作中にデータ保護は + 行われません。 + -l, --log FILE 詳細なログを指定されたファイルに書き込みます。 このオプションが指定されていない場合、予期しないエラーが画面に出力され、 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index cfca4529..1ceb56f0 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -736,6 +736,20 @@ SnapRAIDが移動およびコピーされたファイルを認識する能力が リハッシュ中もSnapRAIDは完全な機能を維持しますが、唯一の例外として、 `dup` は異なるハッシュを使用している重複ファイルを検出できません。 +5.17 locate +----------- + +パリティディスクに保存されているファイルを検索します。一致する各ファイルについて、 +パリティファイル内での位置と、それが占有するフラグメントの数を出力します。 + + -t, --tail オプションを使用すると、パリティの指定された末尾部分を占有する +ファイルに操作を制限できます。 + +これらのファイルを再配置したい場合は、-W, --force-realloc-tail オプションを +使用できます。 +再配置プロセス中、これらのファイルはパリティによって保護されないことに +注意してください。 + 6 OPTIONS ========= @@ -842,6 +856,13 @@ SnapRAIDには、次のオプションがあります。 1秒あたりのバイト数です。K、M、Gなどの乗数を指定できます (例：--bw-limit 1G)。 + -t, --tail サイズ + ファイルリストを、パリティディスクの指定された末尾サイズ以下を + 使用しているものに制限します。 + K、M、G、T などの倍数を使用できます（例：--tail 1G）。 + このオプションは、`locate` コマンドと一緒に使用された場合にのみ + 有効です。 + -A, --stats 追加情報を表示する拡張ステータスビューを有効にします。 画面には2つのグラフが表示されます。 @@ -920,6 +941,27 @@ SnapRAIDには、次のオプションがあります。 お勧めします。 `sync` 操作中にデータ保護はありません。 + -W, --force-realloc-tail サイズ + -R, --force-realloc と同様に動作しますが、各パリティファイルの + 指定された末尾部分（最後の「サイズ」バイト）に制限されます。 + 現在その末尾セクションに保存されているファイルフラグメント/ブロックの + 再配置（移動）を強制し、空きスペースがあるパリティファイル内の + 任意の場所（既存のホールを含む）に配置できるようにします。 + このオプションの主な目的は、パリティファイルのディスク上でのサイズを + 縮小することです。 + 再配置によって末尾セクション全体が正常にクリアされた場合 + （それを使用するブロックが残っていない場合）、パリティファイルは + 切り詰められ、未使用の末尾スペースが回収されます。 + K、M、G、T などの倍数を使用できます（例： + --force-realloc-tail 1G）。 + locate -t, --tail を使用して、影響を受けるファイルを事前に + 知ることができます。 + 警告！ + このオプションはエキスパート専用であり、使用しないことが + 強く推奨されます。 + 影響を受けるファイルについては、`sync` 操作中にデータ保護は + 行われません。 + -l, --log FILE 詳細なログを指定されたファイルに書き込みます。 このオプションが指定されていない場合、予期しないエラーが画面に出力され、 diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 52263d91..4cc6a68d 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -969,6 +969,18 @@ SnapRAID가 이동되거나 복사된 파일을 인식하는 능력을 향상시 .PP 재해시 중에도 SnapRAID는 전체 기능을 유지하며, 유일한 예외는 \`dup\`가 다른 해시를 사용하는 중복 파일을 감지할 수 없다는 것입니다. +.SS locate +패리티 디스크에 저장된 파일을 찾습니다. 일치하는 각 파일에 대해 +패리티 파일 내의 위치와 점유하고 있는 조각(fragment)의 수를 +출력합니다. +.TP +.B \-t, \-\-tail 옵션을 사용하여 패리티의 지정된 꼬리(tail) 부분을 점유하는 +파일로 작업을 제한할 수 있습니다. +.PP +이 파일들을 재할당하려면 \-W, \-\-force\-realloc\-tail 옵션을 +사용할 수 있습니다. +재할당 과정 동안 해당 파일들은 패리티에 의해 보호되지 않으므로 +주의하십시오. .SH OPTIONS SnapRAID는 다음 옵션을 제공합니다: .TP @@ -1074,6 +1086,12 @@ bad로 표시된 블록은 이 옵션에 관계없이 항상 스크럽됩니다. 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: \-\-bw\-limit 1G)를 지정할 수 있습니다. .TP +.B \-t, \-\-tail 크기 +패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 +목록을 제한합니다. +K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: \-\-tail 1G). +이 옵션은 \`locate\` 명령과 함께 사용할 때만 유효합니다. +.TP .B \-A, \-\-stats 추가 정보를 보여주는 확장된 상태 보기를 활성화합니다. 화면에는 두 개의 그래프가 표시됩니다: @@ -1167,6 +1185,25 @@ content 파일에 있는 해시를 재사용하여 데이터를 검증하고 강력히 권장됩니다. \`sync\` 작업 중에는 데이터 보호가 없습니다. .TP +.B \-W, \-\-force\-realloc\-tail 크기 +\-R, \-\-force\-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 +꼬리 부분(마지막 \'크기\' 바이트)으로 제한됩니다. +현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 +강제하여, 여유 공간이 있는 패리티 파일 내의 어느 곳이든(기존 +빈 공간 포함) 배치될 수 있도록 합니다. +이 옵션의 주요 목적은 패리티 파일의 디스크상 크기를 줄이는 것입니다. +재할당을 통해 전체 꼬리 섹션이 성공적으로 비워지면(남은 블록이 없음), +패리티 파일이 잘리고(truncated) 사용되지 않는 꼬리 공간을 회수합니다. +K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: +\-\-force\-realloc\-tail 1G). +locate \-t, \-\-tail을 사용하여 영향을 받는 파일을 사전에 +확인할 수 있습니다. +경고! +이 옵션은 전문가 전용이며, 사용하지 않을 것을 강력히 +권장합니다. +영향을 받는 파일에 대해서는 \`sync\` 작업 동안 데이터 보호를 +받을 수 없습니다. +.TP .B \-l, \-\-log FILE 지정된 파일에 자세한 로그를 기록합니다. 이 옵션을 지정하지 않으면 예상치 못한 오류가 화면에 출력되어, diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 60783652..790a0365 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -691,6 +691,19 @@ Commands 재해시 중에도 SnapRAID는 전체 기능을 유지하며, 유일한 예외는 `dup`가 다른 해시를 사용하는 중복 파일을 감지할 수 없다는 것입니다. + locate + 패리티 디스크에 저장된 파일을 찾습니다. 일치하는 각 파일에 대해 + 패리티 파일 내의 위치와 점유하고 있는 조각(fragment)의 수를 + 출력합니다. + + -t, --tail 옵션을 사용하여 패리티의 지정된 꼬리(tail) 부분을 점유하는 + 파일로 작업을 제한할 수 있습니다. + + 이 파일들을 재할당하려면 -W, --force-realloc-tail 옵션을 + 사용할 수 있습니다. + 재할당 과정 동안 해당 파일들은 패리티에 의해 보호되지 않으므로 + 주의하십시오. + Options SnapRAID는 다음 옵션을 제공합니다: @@ -796,6 +809,12 @@ Options 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: --bw-limit 1G)를 지정할 수 있습니다. + -t, --tail 크기 + 패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 + 목록을 제한합니다. + K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: --tail 1G). + 이 옵션은 `locate` 명령과 함께 사용할 때만 유효합니다. + -A, --stats 추가 정보를 보여주는 확장된 상태 보기를 활성화합니다. 화면에는 두 개의 그래프가 표시됩니다: @@ -889,6 +908,25 @@ Options 강력히 권장됩니다. `sync` 작업 중에는 데이터 보호가 없습니다. + -W, --force-realloc-tail 크기 + -R, --force-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 + 꼬리 부분(마지막 '크기' 바이트)으로 제한됩니다. + 현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 + 강제하여, 여유 공간이 있는 패리티 파일 내의 어느 곳이든(기존 + 빈 공간 포함) 배치될 수 있도록 합니다. + 이 옵션의 주요 목적은 패리티 파일의 디스크상 크기를 줄이는 것입니다. + 재할당을 통해 전체 꼬리 섹션이 성공적으로 비워지면(남은 블록이 없음), + 패리티 파일이 잘리고(truncated) 사용되지 않는 꼬리 공간을 회수합니다. + K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: + --force-realloc-tail 1G). + locate -t, --tail을 사용하여 영향을 받는 파일을 사전에 + 확인할 수 있습니다. + 경고! + 이 옵션은 전문가 전용이며, 사용하지 않을 것을 강력히 + 권장합니다. + 영향을 받는 파일에 대해서는 `sync` 작업 동안 데이터 보호를 + 받을 수 없습니다. + -l, --log FILE 지정된 파일에 자세한 로그를 기록합니다. 이 옵션을 지정하지 않으면 예상치 못한 오류가 화면에 출력되어, diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index b9b75c0f..604fe59b 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -747,6 +747,21 @@ SnapRAID가 이동되거나 복사된 파일을 인식하는 능력을 향상시 재해시 중에도 SnapRAID는 전체 기능을 유지하며, 유일한 예외는 `dup`가 다른 해시를 사용하는 중복 파일을 감지할 수 없다는 것입니다. +5.17 locate +----------- + +패리티 디스크에 저장된 파일을 찾습니다. 일치하는 각 파일에 대해 +패리티 파일 내의 위치와 점유하고 있는 조각(fragment)의 수를 +출력합니다. + + -t, --tail 옵션을 사용하여 패리티의 지정된 꼬리(tail) 부분을 점유하는 +파일로 작업을 제한할 수 있습니다. + +이 파일들을 재할당하려면 -W, --force-realloc-tail 옵션을 +사용할 수 있습니다. +재할당 과정 동안 해당 파일들은 패리티에 의해 보호되지 않으므로 +주의하십시오. + 6 OPTIONS ========= @@ -855,6 +870,12 @@ SnapRAID는 다음 옵션을 제공합니다: 초당 바이트 수입니다. K, M, 또는 G와 같은 승수(예: --bw-limit 1G)를 지정할 수 있습니다. + -t, --tail 크기 + 패리티 디스크의 지정된 꼬리 크기 이하를 사용하는 파일로 + 목록을 제한합니다. + K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: --tail 1G). + 이 옵션은 `locate` 명령과 함께 사용할 때만 유효합니다. + -A, --stats 추가 정보를 보여주는 확장된 상태 보기를 활성화합니다. 화면에는 두 개의 그래프가 표시됩니다: @@ -948,6 +969,25 @@ SnapRAID는 다음 옵션을 제공합니다: 강력히 권장됩니다. `sync` 작업 중에는 데이터 보호가 없습니다. + -W, --force-realloc-tail 크기 + -R, --force-realloc과 같이 작동하지만, 각 패리티 파일의 지정된 + 꼬리 부분(마지막 '크기' 바이트)으로 제한됩니다. + 현재 해당 꼬리 섹션에 저장된 모든 파일 조각/블록의 재할당(이동)을 + 강제하여, 여유 공간이 있는 패리티 파일 내의 어느 곳이든(기존 + 빈 공간 포함) 배치될 수 있도록 합니다. + 이 옵션의 주요 목적은 패리티 파일의 디스크상 크기를 줄이는 것입니다. + 재할당을 통해 전체 꼬리 섹션이 성공적으로 비워지면(남은 블록이 없음), + 패리티 파일이 잘리고(truncated) 사용되지 않는 꼬리 공간을 회수합니다. + K, M, G, T와 같은 배수를 사용할 수 있습니다 (예: + --force-realloc-tail 1G). + locate -t, --tail을 사용하여 영향을 받는 파일을 사전에 + 확인할 수 있습니다. + 경고! + 이 옵션은 전문가 전용이며, 사용하지 않을 것을 강력히 + 권장합니다. + 영향을 받는 파일에 대해서는 `sync` 작업 동안 데이터 보호를 + 받을 수 없습니다. + -l, --log FILE 지정된 파일에 자세한 로그를 기록합니다. 이 옵션을 지정하지 않으면 예상치 못한 오류가 화면에 출력되어, diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 3df1d974..7d376341 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -992,6 +992,18 @@ Możesz sprawdzić stan ponownego haszowania za pomocą \`status\`. Podczas ponownego haszowania SnapRAID zachowuje pełną funkcjonalność, z jedynym wyjątkiem, że \`dup\` nie może wykryć zduplikowanych plików używających innego hasza. +.SS locate +Lokalizuje pliki zapisane na dyskach parzystości. Dla każdego dopasowanego pliku +wypisuje jego lokalizację w pliku parzystości oraz liczbę zajmowanych przez +niego fragmentów. +.PP +Możesz użyć opcji \-t, \-\-tail, aby ograniczyć operację do plików zajmujących +określoną końcową część parzystości. +.PP +Jeśli chcesz dokonać realokacji tych plików, możesz użyć opcji +\-W, \-\-force\-realloc\-tail. +Pamiętaj, że takie pliki nie będą chronione przez parzystość podczas procesu +realokacji. .SH OPTIONS SnapRAID udostępnia następujące opcje: .TP @@ -1103,6 +1115,13 @@ 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. +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\`. +.TP .B \-A, \-\-stats Włącza rozszerzony widok statusu, który pokazuje dodatkowe informacje. Ekran wyświetla dwa wykresy: @@ -1196,6 +1215,28 @@ 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 +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. +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 +dostępne jest wolne miejsce (w tym w istniejących lukach). +Głównym celem tej opcji jest zmniejszenie rozmiaru pliku parzystości +na dysku. +Jeśli realokacja pomyślnie wyczyści całą sekcję końcową (nie pozostaną +żadne bloki korzystające z niej), plik parzystości zostanie przycięty, +odzyskując nieużywane miejsce na końcu. +Możesz użyć mnożników takich jak K, M, G lub T (np. +\-\-force\-realloc\-tail 1G). +Możesz użyć locate \-t, \-\-tail, aby wcześniej poznać pliki, których +będzie to dotyczyć. +OSTRZEŻENIE! +Ta opcja jest przeznaczona wyłącznie dla ekspertów i zdecydowanie +zaleca się jej nie używać. +Podczas operacji \`sync\` pliki, których to dotyczy, NIE mają ochrony +danych. +.TP .B \-l, \-\-log FILE Zapisuje szczegółowy log do określonego pliku. Jeśli ta opcja nie jest określona, nieoczekiwane błędy są drukowane diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 210484d2..34f2d847 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -714,6 +714,19 @@ Commands z jedynym wyjątkiem, że `dup` nie może wykryć zduplikowanych plików używających innego hasza. + locate + Lokalizuje pliki zapisane na dyskach parzystości. Dla każdego dopasowanego pliku + wypisuje jego lokalizację w pliku parzystości oraz liczbę zajmowanych przez + niego fragmentów. + + Możesz użyć opcji -t, --tail, aby ograniczyć operację do plików zajmujących + określoną końcową część parzystości. + + Jeśli chcesz dokonać realokacji tych plików, możesz użyć opcji + -W, --force-realloc-tail. + Pamiętaj, że takie pliki nie będą chronione przez parzystość podczas procesu + realokacji. + Options SnapRAID udostępnia następujące opcje: @@ -825,6 +838,13 @@ 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. + 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`. + -A, --stats Włącza rozszerzony widok statusu, który pokazuje dodatkowe informacje. Ekran wyświetla dwa wykresy: @@ -918,6 +938,28 @@ Options zalecane, aby jej nie używać. NIE MASZ ochrony danych podczas operacji `sync`. + -W, --force-realloc-tail ROZMIAR + 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. + 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 + dostępne jest wolne miejsce (w tym w istniejących lukach). + Głównym celem tej opcji jest zmniejszenie rozmiaru pliku parzystości + na dysku. + Jeśli realokacja pomyślnie wyczyści całą sekcję końcową (nie pozostaną + żadne bloki korzystające z niej), plik parzystości zostanie przycięty, + odzyskując nieużywane miejsce na końcu. + Możesz użyć mnożników takich jak K, M, G lub T (np. + --force-realloc-tail 1G). + Możesz użyć locate -t, --tail, aby wcześniej poznać pliki, których + będzie to dotyczyć. + OSTRZEŻENIE! + Ta opcja jest przeznaczona wyłącznie dla ekspertów i zdecydowanie + zaleca się jej nie używać. + Podczas operacji `sync` pliki, których to dotyczy, NIE mają ochrony + danych. + -l, --log FILE Zapisuje szczegółowy log do określonego pliku. Jeśli ta opcja nie jest określona, nieoczekiwane błędy są drukowane diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 3177ac13..a54e8e25 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -770,6 +770,21 @@ Podczas ponownego haszowania SnapRAID zachowuje pełną funkcjonalność, z jedynym wyjątkiem, że `dup` nie może wykryć zduplikowanych plików używających innego hasza. +5.17 locate +----------- + +Lokalizuje pliki zapisane na dyskach parzystości. Dla każdego dopasowanego pliku +wypisuje jego lokalizację w pliku parzystości oraz liczbę zajmowanych przez +niego fragmentów. + +Możesz użyć opcji -t, --tail, aby ograniczyć operację do plików zajmujących +określoną końcową część parzystości. + +Jeśli chcesz dokonać realokacji tych plików, możesz użyć opcji +-W, --force-realloc-tail. +Pamiętaj, że takie pliki nie będą chronione przez parzystość podczas procesu +realokacji. + 6 OPTIONS ========= @@ -884,6 +899,13 @@ 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. + 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`. + -A, --stats Włącza rozszerzony widok statusu, który pokazuje dodatkowe informacje. Ekran wyświetla dwa wykresy: @@ -977,6 +999,28 @@ 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 + 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. + 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 + dostępne jest wolne miejsce (w tym w istniejących lukach). + Głównym celem tej opcji jest zmniejszenie rozmiaru pliku parzystości + na dysku. + Jeśli realokacja pomyślnie wyczyści całą sekcję końcową (nie pozostaną + żadne bloki korzystające z niej), plik parzystości zostanie przycięty, + odzyskując nieużywane miejsce na końcu. + Możesz użyć mnożników takich jak K, M, G lub T (np. + --force-realloc-tail 1G). + Możesz użyć locate -t, --tail, aby wcześniej poznać pliki, których + będzie to dotyczyć. + OSTRZEŻENIE! + Ta opcja jest przeznaczona wyłącznie dla ekspertów i zdecydowanie + zaleca się jej nie używać. + Podczas operacji `sync` pliki, których to dotyczy, NIE mają ochrony + danych. + -l, --log FILE Zapisuje szczegółowy log do określonego pliku. Jeśli ta opcja nie jest określona, nieoczekiwane błędy są drukowane diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index 863cd260..b3194dc7 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1012,6 +1012,18 @@ Você pode verificar o estado do novo hash usando \`status\`. Durante o novo hash, o SnapRAID mantém a funcionalidade total, com a única exceção de que \`dup\` não pode detectar arquivos duplicados usando um hash diferente. +.SS locate +Localiza arquivos armazenados nos discos de paridade. Para cada arquivo +correspondente, imprime sua localização dentro do arquivo de paridade e o +número de fragmentos que ocupa. +.PP +Você pode usar a opção \-t, \-\-tail para restringir a operação aos arquivos +que ocupam a parte final especificada da paridade. +.PP +Se desejar realocar esses arquivos, você poderá usar a opção +\-W, \-\-force\-realloc\-tail. +Esteja ciente de que tais arquivos não estarão protegidos pela paridade durante +o processo de realocação. .SH OPçõES SnapRAID fornece as seguintes opções: .TP @@ -1126,6 +1138,13 @@ 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 +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). +Esta opção só é válida quando usada em conjunto com o comando +\`locate\`. +.TP .B \-A, \-\-stats Habilita uma visualização de status estendida que mostra informações adicionais. A tela exibe dois gráficos: @@ -1225,6 +1244,28 @@ 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 +Funciona como \-R, \-\-force\-realloc, mas limitado à parte final +especificada (últimos TAMANHO 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 +disponível (incluindo espaços vazios existentes). +O objetivo principal desta opção é diminuir o tamanho em disco +do arquivo de paridade. +Se a realocação limpar com sucesso toda a seção final (nenhum bloco +permanecer usando\-a), o arquivo de paridade será truncado, +recuperando o espaço final não utilizado. +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 +arquivos afetados. +.TP .B \-l, \-\-log FILE Escreve um log detalhado para o arquivo especificado. Se esta opção não for especificada, erros inesperados são diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index b3413448..1bad6a9c 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -18,7 +18,7 @@ Sinopse : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -734,6 +734,19 @@ Comandos com a única exceção de que `dup` não pode detectar arquivos duplicados usando um hash diferente. + locate + Localiza arquivos armazenados nos discos de paridade. Para cada arquivo + correspondente, imprime sua localização dentro do arquivo de paridade e o + número de fragmentos que ocupa. + + Você pode usar a opção -t, --tail para restringir a operação aos arquivos + que ocupam a parte final especificada da paridade. + + Se desejar realocar esses arquivos, você poderá usar a opção + -W, --force-realloc-tail. + Esteja ciente de que tais arquivos não estarão protegidos pela paridade durante + o processo de realocação. + Opções SnapRAID fornece as seguintes opções: @@ -848,6 +861,13 @@ 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 + 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). + Esta opção só é válida quando usada em conjunto com o comando + `locate`. + -A, --stats Habilita uma visualização de status estendida que mostra informações adicionais. A tela exibe dois gráficos: @@ -947,6 +967,28 @@ 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 + Funciona como -R, --force-realloc, mas limitado à parte final + especificada (últimos TAMANHO 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 + disponível (incluindo espaços vazios existentes). + O objetivo principal desta opção é diminuir o tamanho em disco + do arquivo de paridade. + Se a realocação limpar com sucesso toda a seção final (nenhum bloco + permanecer usando-a), o arquivo de paridade será truncado, + recuperando o espaço final não utilizado. + 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 + arquivos afetados. + -l, --log FILE Escreve um log detalhado para o arquivo especificado. Se esta opção não for especificada, erros inesperados são diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index b5b24aed..6a9d5050 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -790,6 +790,21 @@ Durante o novo hash, o SnapRAID mantém a funcionalidade total, com a única exceção de que `dup` não pode detectar arquivos duplicados usando um hash diferente. +5.17 locate +----------- + +Localiza arquivos armazenados nos discos de paridade. Para cada arquivo +correspondente, imprime sua localização dentro do arquivo de paridade e o +número de fragmentos que ocupa. + +Você pode usar a opção -t, --tail para restringir a operação aos arquivos +que ocupam a parte final especificada da paridade. + +Se desejar realocar esses arquivos, você poderá usar a opção +-W, --force-realloc-tail. +Esteja ciente de que tais arquivos não estarão protegidos pela paridade durante +o processo de realocação. + 6 OPçõES ======== @@ -907,6 +922,13 @@ 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 + 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). + Esta opção só é válida quando usada em conjunto com o comando + `locate`. + -A, --stats Habilita uma visualização de status estendida que mostra informações adicionais. A tela exibe dois gráficos: @@ -1006,6 +1028,28 @@ 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 + Funciona como -R, --force-realloc, mas limitado à parte final + especificada (últimos TAMANHO 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 + disponível (incluindo espaços vazios existentes). + O objetivo principal desta opção é diminuir o tamanho em disco + do arquivo de paridade. + Se a realocação limpar com sucesso toda a seção final (nenhum bloco + permanecer usando-a), o arquivo de paridade será truncado, + recuperando o espaço final não utilizado. + 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 + arquivos afetados. + -l, --log FILE Escreve um log detalhado para o arquivo especificado. Se esta opção não for especificada, erros inesperados são diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 10ee3f40..a487003b 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -988,6 +988,18 @@ Puteți verifica starea rehash\-ului utilizând \`status\`. În timpul rehash\-ului, SnapRAID își menține funcționalitatea completă, cu singura excepție că \`dup\` nu poate detecta fișierele duplicate folosind un hash diferit. +.SS locate +Localizează fișierele stocate pe discurile de paritate. Pentru fiecare fișier +potrivit, afișează locația acestuia în fișierul de paritate și numărul de +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. .SH OPțIUNI SnapRAID oferă următoarele opțiuni: .TP @@ -1099,6 +1111,13 @@ Aplică o limită globală de lățime de bandă pentru toate discurile. RATE es numărul de octeți pe secundă. Puteți specifica un multiplicator cum ar fi K, M sau G (de exemplu, \-\-bw\-limit 1G). .TP +.B \-t, \-\-tail DIMENSIUNE +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). +Această opțiune este valabilă numai atunci când este utilizată împreună +cu comanda \`locate\`. +.TP .B \-A, \-\-stats Activează o vizualizare de stare extinsă care arată informații suplimentare. Ecranul afișează două grafice: @@ -1196,6 +1215,28 @@ 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 +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 +în prezent în acea secțiune finală, permițându\-le să fie plasate oriunde +în fișierul/fișierele de paritate unde este disponibil spațiu liber +(inclusiv golurile existente). +Scopul principal al acestei opțiuni este de a reduce dimensiunea pe disc +a fișierului de paritate. +Dacă realocarea eliberează cu succes întreaga secțiune finală +(nu mai rămân blocuri care să o utilizeze), fișierul de paritate este +trunchiat, recuperând spațiul final neutilizat. +Puteți utiliza multiplicatori precum K, M, G sau T (ex. +\-\-force\-realloc\-tail 1G). +Puteți utiliza locate \-t, \-\-tail pentru a cunoaște în avans +fișierele afectate. +AVERTIZARE! +Această opțiune este doar pentru experți și se recomandă +insistent să nu fie utilizată. +NU beneficiați de protecție a datelor în timpul operațiunii \`sync\` +pentru fișierele afectate. +.TP .B \-l, \-\-log FILE Scrie un jurnal detaliat în fișierul specificat. Dacă această opțiune nu este specificată, erorile neașteptate sunt tipărite diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index c3ac6b8f..a8e6ad8a 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -18,7 +18,7 @@ Sintaxă : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -710,6 +710,19 @@ Comenzi cu singura excepție că `dup` nu poate detecta fișierele duplicate folosind un hash diferit. + locate + Localizează fișierele stocate pe discurile de paritate. Pentru fiecare fișier + potrivit, afișează locația acestuia în fișierul de paritate și numărul de + 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. + Opțiuni SnapRAID oferă următoarele opțiuni: @@ -821,6 +834,13 @@ Opțiuni numărul de octeți pe secundă. Puteți specifica un multiplicator cum ar fi K, M sau G (de exemplu, --bw-limit 1G). + -t, --tail DIMENSIUNE + 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). + Această opțiune este valabilă numai atunci când este utilizată împreună + cu comanda `locate`. + -A, --stats Activează o vizualizare de stare extinsă care arată informații suplimentare. Ecranul afișează două grafice: @@ -918,6 +938,28 @@ 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 + 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 + în prezent în acea secțiune finală, permițându-le să fie plasate oriunde + în fișierul/fișierele de paritate unde este disponibil spațiu liber + (inclusiv golurile existente). + Scopul principal al acestei opțiuni este de a reduce dimensiunea pe disc + a fișierului de paritate. + Dacă realocarea eliberează cu succes întreaga secțiune finală + (nu mai rămân blocuri care să o utilizeze), fișierul de paritate este + trunchiat, recuperând spațiul final neutilizat. + Puteți utiliza multiplicatori precum K, M, G sau T (ex. + --force-realloc-tail 1G). + Puteți utiliza locate -t, --tail pentru a cunoaște în avans + fișierele afectate. + AVERTIZARE! + Această opțiune este doar pentru experți și se recomandă + insistent să nu fie utilizată. + NU beneficiați de protecție a datelor în timpul operațiunii `sync` + pentru fișierele afectate. + -l, --log FILE Scrie un jurnal detaliat în fișierul specificat. Dacă această opțiune nu este specificată, erorile neașteptate sunt tipărite diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index b04db21e..f69a6e1f 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -766,6 +766,21 @@ Puteți verifica starea rehash-ului utilizând `status`. cu singura excepție că `dup` nu poate detecta fișierele duplicate folosind un hash diferit. +5.17 locate +----------- + +Localizează fișierele stocate pe discurile de paritate. Pentru fiecare fișier +potrivit, afișează locația acestuia în fișierul de paritate și numărul de +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. + 6 OPțIUNI ========= @@ -880,6 +895,13 @@ SnapRAID oferă următoarele opțiuni: numărul de octeți pe secundă. Puteți specifica un multiplicator cum ar fi K, M sau G (de exemplu, --bw-limit 1G). + -t, --tail DIMENSIUNE + 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). + Această opțiune este valabilă numai atunci când este utilizată împreună + cu comanda `locate`. + -A, --stats Activează o vizualizare de stare extinsă care arată informații suplimentare. Ecranul afișează două grafice: @@ -977,6 +999,28 @@ 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 + 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 + în prezent în acea secțiune finală, permițându-le să fie plasate oriunde + în fișierul/fișierele de paritate unde este disponibil spațiu liber + (inclusiv golurile existente). + Scopul principal al acestei opțiuni este de a reduce dimensiunea pe disc + a fișierului de paritate. + Dacă realocarea eliberează cu succes întreaga secțiune finală + (nu mai rămân blocuri care să o utilizeze), fișierul de paritate este + trunchiat, recuperând spațiul final neutilizat. + Puteți utiliza multiplicatori precum K, M, G sau T (ex. + --force-realloc-tail 1G). + Puteți utiliza locate -t, --tail pentru a cunoaște în avans + fișierele afectate. + AVERTIZARE! + Această opțiune este doar pentru experți și se recomandă + insistent să nu fie utilizată. + NU beneficiați de protecție a datelor în timpul operațiunii `sync` + pentru fișierele afectate. + -l, --log FILE Scrie un jurnal detaliat în fișierul specificat. Dacă această opțiune nu este specificată, erorile neașteptate sunt tipărite diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 7d5e86f8..fd2886e3 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -993,6 +993,18 @@ MurmurHash3 на более быстрый SpookyHash. Во время перехэширования SnapRAID сохраняет полную функциональность, за единственным исключением, что \`dup\` не может обнаружить дублирующиеся файлы, использующие другой хэш. +.SS locate +Находит файлы, хранящиеся на дисках четности. Для каждого найденного файла +выводится его расположение внутри файла четности и количество занимаемых +им фрагментов. +.PP +Вы можете использовать параметр \-t, \-\-tail, чтобы ограничить операцию файлами, +занимающими указанную хвостовую часть четности. +.PP +Если вы хотите перераспределить эти файлы, вы можете использовать параметр +\-W, \-\-force\-realloc\-tail. +Имейте в виду, что такие файлы не будут защищены четностью во время процесса +перераспределения. .SH OPTIONS SnapRAID предоставляет следующие опции: .TP @@ -1104,6 +1116,13 @@ DAYS — это минимальный возраст в днях для бло количество байтов в секунду. Вы можете указать множитель, например K, M или G (например, \-\-bw\-limit 1G). .TP +.B \-t, \-\-tail РАЗМЕР +Ограничивает список файлов теми, которые используют не более +указанного размера хвоста дисков четности. +Можно использовать множители, такие как K, M, G или T (например, \-\-tail 1G). +Этот параметр действителен только при использовании вместе с +командой \`locate\`. +.TP .B \-A, \-\-stats Включает расширенный вид статуса, который показывает дополнительную информацию. На экране отображаются два графика: @@ -1199,6 +1218,28 @@ DAYS — это минимальный возраст в днях для бло настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции \`sync\`. .TP +.B \-W, \-\-force\-realloc\-tail РАЗМЕР +Работает как \-R, \-\-force\-realloc, но ограничивается указанной хвостовой +частью (последние РАЗМЕР байт) каждого файла четности. +Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, +хранящиеся в данный момент в этой хвостовой части, позволяя разместить +их в любом месте файла(ов) четности, где есть свободное место +(включая существующие пустоты). +Основная цель этого параметра — уменьшить занимаемый на диске +размер файла четности. +Если перераспределение успешно очистит всю хвостовую часть +(в ней не останется блоков), файл четности будет обрезан, высвобождая +неиспользуемое хвостовое пространство. +Можно использовать множители, такие как K, M, G или T (например, +\-\-force\-realloc\-tail 1G). +Вы можете использовать locate \-t, \-\-tail, чтобы заранее узнать +затронутые файлы. +ВНИМАНИЕ! +Этот параметр предназначен только для экспертов, и его настоятельно +не рекомендуется использовать. +Во время операции \`sync\` защита данных для затронутых файлов +ОТСУТСТВУЕТ. +.TP .B \-l, \-\-log FILE Записывает подробный журнал в указанный файл. Если эта опция не указана, непредвиденные ошибки выводятся diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index b75b9bde..1bda842c 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -715,6 +715,19 @@ Commands за единственным исключением, что `dup` не может обнаружить дублирующиеся файлы, использующие другой хэш. + locate + Находит файлы, хранящиеся на дисках четности. Для каждого найденного файла + выводится его расположение внутри файла четности и количество занимаемых + им фрагментов. + + Вы можете использовать параметр -t, --tail, чтобы ограничить операцию файлами, + занимающими указанную хвостовую часть четности. + + Если вы хотите перераспределить эти файлы, вы можете использовать параметр + -W, --force-realloc-tail. + Имейте в виду, что такие файлы не будут защищены четностью во время процесса + перераспределения. + Options SnapRAID предоставляет следующие опции: @@ -826,6 +839,13 @@ Options количество байтов в секунду. Вы можете указать множитель, например K, M или G (например, --bw-limit 1G). + -t, --tail РАЗМЕР + Ограничивает список файлов теми, которые используют не более + указанного размера хвоста дисков четности. + Можно использовать множители, такие как K, M, G или T (например, --tail 1G). + Этот параметр действителен только при использовании вместе с + командой `locate`. + -A, --stats Включает расширенный вид статуса, который показывает дополнительную информацию. На экране отображаются два графика: @@ -921,6 +941,28 @@ Options настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции `sync`. + -W, --force-realloc-tail РАЗМЕР + Работает как -R, --force-realloc, но ограничивается указанной хвостовой + частью (последние РАЗМЕР байт) каждого файла четности. + Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, + хранящиеся в данный момент в этой хвостовой части, позволяя разместить + их в любом месте файла(ов) четности, где есть свободное место + (включая существующие пустоты). + Основная цель этого параметра — уменьшить занимаемый на диске + размер файла четности. + Если перераспределение успешно очистит всю хвостовую часть + (в ней не останется блоков), файл четности будет обрезан, высвобождая + неиспользуемое хвостовое пространство. + Можно использовать множители, такие как K, M, G или T (например, + --force-realloc-tail 1G). + Вы можете использовать locate -t, --tail, чтобы заранее узнать + затронутые файлы. + ВНИМАНИЕ! + Этот параметр предназначен только для экспертов, и его настоятельно + не рекомендуется использовать. + Во время операции `sync` защита данных для затронутых файлов + ОТСУТСТВУЕТ. + -l, --log FILE Записывает подробный журнал в указанный файл. Если эта опция не указана, непредвиденные ошибки выводятся diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index c09b8ac0..d4548a75 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -771,6 +771,21 @@ MurmurHash3 на более быстрый SpookyHash. за единственным исключением, что `dup` не может обнаружить дублирующиеся файлы, использующие другой хэш. +5.17 locate +----------- + +Находит файлы, хранящиеся на дисках четности. Для каждого найденного файла +выводится его расположение внутри файла четности и количество занимаемых +им фрагментов. + +Вы можете использовать параметр -t, --tail, чтобы ограничить операцию файлами, +занимающими указанную хвостовую часть четности. + +Если вы хотите перераспределить эти файлы, вы можете использовать параметр +-W, --force-realloc-tail. +Имейте в виду, что такие файлы не будут защищены четностью во время процесса +перераспределения. + 6 OPTIONS ========= @@ -885,6 +900,13 @@ SnapRAID предоставляет следующие опции: количество байтов в секунду. Вы можете указать множитель, например K, M или G (например, --bw-limit 1G). + -t, --tail РАЗМЕР + Ограничивает список файлов теми, которые используют не более + указанного размера хвоста дисков четности. + Можно использовать множители, такие как K, M, G или T (например, --tail 1G). + Этот параметр действителен только при использовании вместе с + командой `locate`. + -A, --stats Включает расширенный вид статуса, который показывает дополнительную информацию. На экране отображаются два графика: @@ -980,6 +1002,28 @@ SnapRAID предоставляет следующие опции: настоятельно не рекомендуется ее использовать. У вас НЕТ защиты данных во время операции `sync`. + -W, --force-realloc-tail РАЗМЕР + Работает как -R, --force-realloc, но ограничивается указанной хвостовой + частью (последние РАЗМЕР байт) каждого файла четности. + Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов, + хранящиеся в данный момент в этой хвостовой части, позволяя разместить + их в любом месте файла(ов) четности, где есть свободное место + (включая существующие пустоты). + Основная цель этого параметра — уменьшить занимаемый на диске + размер файла четности. + Если перераспределение успешно очистит всю хвостовую часть + (в ней не останется блоков), файл четности будет обрезан, высвобождая + неиспользуемое хвостовое пространство. + Можно использовать множители, такие как K, M, G или T (например, + --force-realloc-tail 1G). + Вы можете использовать locate -t, --tail, чтобы заранее узнать + затронутые файлы. + ВНИМАНИЕ! + Этот параметр предназначен только для экспертов, и его настоятельно + не рекомендуется использовать. + Во время операции `sync` защита данных для затронутых файлов + ОТСУТСТВУЕТ. + -l, --log FILE Записывает подробный журнал в указанный файл. Если эта опция не указана, непредвиденные ошибки выводятся diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 8e1821e7..bbf0342d 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -995,6 +995,17 @@ Du kan kontrollera omhashningstillståndet med hjälp av \`status\`. Under omhashningen bibehåller SnapRAID full funktionalitet, med det enda undantaget att \`dup\` inte kan upptäcka dubbletter med hjälp av en annan hash. +.SS locate +Lokaliserar filer som lagras på paritetsdiskarna. För varje matchande fil +skrivs dess plats i paritetsfilen och antalet fragment den upptar ut. +.PP +Du kan använda alternativet \-t, \-\-tail för att begränsa åtgärden till filer som +upptar den angivna slutdelen (tail) av pariteten. +.PP +Om du vill omallokera dessa filer kan du använda alternativet +\-W, \-\-force\-realloc\-tail. +Var medveten om att sådana filer inte skyddas av paritet under +omallokeringsprocessen. .SH ALTERNATIV SnapRAID tillhandahåller följande alternativ: .TP @@ -1107,6 +1118,13 @@ 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 +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). +Detta alternativ är endast giltigt när det används tillsammans med +kommandot \`locate\`. +.TP .B \-A, \-\-stats Aktiverar en utökad statusvy som visar ytterligare information. Skärmen visar två diagram: @@ -1201,6 +1219,27 @@ 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 +Fungerar som \-R, \-\-force\-realloc, men begränsat till den angivna +slutdelen (de sista STORLEK 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 +(inklusive befintliga hål). +Huvudsyftet med detta alternativ är att minska paritetsfilens storlek +på disken. +Om omallokeringen lyckas rensa hela slutsektionen (inga block är kvar +som använder den), trunkeras paritetsfilen och det oanvända +slututrymmet återtas. +Du kan använda multiplikatorer som K, M, G eller T (t.ex. +\-\-force\-realloc\-tail 1G). +Du kan använda locate \-t, \-\-tail för att i förväg veta vilka filer +som påverkas. +VARNING! +Detta alternativ är endast för experter, och det rekommenderas +starkt att inte använda det. +Du har INGET dataskydd under \`sync\`\-åtgärden för de berörda filerna. +.TP .B \-l, \-\-log FILE Skriver en detaljerad logg till den specificerade filen. Om detta alternativ inte specificeras, skrivs oväntade fel ut diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index 1b188864..a625b9e5 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -717,6 +717,18 @@ Kommandon med det enda undantaget att `dup` inte kan upptäcka dubbletter med hjälp av en annan hash. + locate + Lokaliserar filer som lagras på paritetsdiskarna. För varje matchande fil + skrivs dess plats i paritetsfilen och antalet fragment den upptar ut. + + Du kan använda alternativet -t, --tail för att begränsa åtgärden till filer som + upptar den angivna slutdelen (tail) av pariteten. + + Om du vill omallokera dessa filer kan du använda alternativet + -W, --force-realloc-tail. + Var medveten om att sådana filer inte skyddas av paritet under + omallokeringsprocessen. + Alternativ SnapRAID tillhandahåller följande alternativ: @@ -829,6 +841,13 @@ Alternativ antalet byte per sekund. Du kan specificera en multiplikator som K, M eller G (t.ex. --bw-limit 1G). + -t, --tail STORLEK + 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). + Detta alternativ är endast giltigt när det används tillsammans med + kommandot `locate`. + -A, --stats Aktiverar en utökad statusvy som visar ytterligare information. Skärmen visar två diagram: @@ -923,6 +942,27 @@ Alternativ starkt att inte använda det. Du HAR INGET dataskydd under `sync`-operationen. + -W, --force-realloc-tail STORLEK + Fungerar som -R, --force-realloc, men begränsat till den angivna + slutdelen (de sista STORLEK 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 + (inklusive befintliga hål). + Huvudsyftet med detta alternativ är att minska paritetsfilens storlek + på disken. + Om omallokeringen lyckas rensa hela slutsektionen (inga block är kvar + som använder den), trunkeras paritetsfilen och det oanvända + slututrymmet återtas. + Du kan använda multiplikatorer som K, M, G eller T (t.ex. + --force-realloc-tail 1G). + Du kan använda locate -t, --tail för att i förväg veta vilka filer + som påverkas. + VARNING! + Detta alternativ är endast för experter, och det rekommenderas + starkt att inte använda det. + Du har INGET dataskydd under `sync`-åtgärden för de berörda filerna. + -l, --log FILE Skriver en detaljerad logg till den specificerade filen. Om detta alternativ inte specificeras, skrivs oväntade fel ut diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index cff744ff..00d0724b 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -773,6 +773,20 @@ Under omhashningen bibehåller SnapRAID full funktionalitet, med det enda undantaget att `dup` inte kan upptäcka dubbletter med hjälp av en annan hash. +5.17 locate +----------- + +Lokaliserar filer som lagras på paritetsdiskarna. För varje matchande fil +skrivs dess plats i paritetsfilen och antalet fragment den upptar ut. + +Du kan använda alternativet -t, --tail för att begränsa åtgärden till filer som +upptar den angivna slutdelen (tail) av pariteten. + +Om du vill omallokera dessa filer kan du använda alternativet +-W, --force-realloc-tail. +Var medveten om att sådana filer inte skyddas av paritet under +omallokeringsprocessen. + 6 ALTERNATIV ============ @@ -888,6 +902,13 @@ 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 + 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). + Detta alternativ är endast giltigt när det används tillsammans med + kommandot `locate`. + -A, --stats Aktiverar en utökad statusvy som visar ytterligare information. Skärmen visar två diagram: @@ -982,6 +1003,27 @@ SnapRAID tillhandahåller följande alternativ: starkt att inte använda det. Du HAR INGET dataskydd under `sync`-operationen. + -W, --force-realloc-tail STORLEK + Fungerar som -R, --force-realloc, men begränsat till den angivna + slutdelen (de sista STORLEK 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 + (inklusive befintliga hål). + Huvudsyftet med detta alternativ är att minska paritetsfilens storlek + på disken. + Om omallokeringen lyckas rensa hela slutsektionen (inga block är kvar + som använder den), trunkeras paritetsfilen och det oanvända + slututrymmet återtas. + Du kan använda multiplikatorer som K, M, G eller T (t.ex. + --force-realloc-tail 1G). + Du kan använda locate -t, --tail för att i förväg veta vilka filer + som påverkas. + VARNING! + Detta alternativ är endast för experter, och det rekommenderas + starkt att inte använda det. + Du har INGET dataskydd under `sync`-åtgärden för de berörda filerna. + -l, --log FILE Skriver en detaljerad logg till den specificerade filen. Om detta alternativ inte specificeras, skrivs oväntade fel ut diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 840132e7..e7739220 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -1075,6 +1075,18 @@ SnapRAID перейменовує всі файли, які не можуть б Під час повторного хешування SnapRAID зберігає повну функціональність, за єдиним винятком, що \`dup\` не може виявити дублікати файлів, використовуючи інший хеш. +.SS locate +Знаходить файли, що зберігаються на дисках парності. Для кожного знайденого +файлу виводиться його розташування всередині файлу парності та кількість +фрагментів, які він займає. +.PP +Ви можете використовувати параметр \-t, \-\-tail, щоб обмежити операцію файлами, +що займають зазначену кінцеву частину (хвіст) парності. +.PP +Якщо ви хочете перерозподілити ці файли, ви можете скористатися параметром +\-W, \-\-force\-realloc\-tail. +Майте на увазі, що такі файли не будуть захищені парністю під час процесу +перерозподілу. .SH Опції SnapRAID надає наступні опції: .TP @@ -1202,6 +1214,12 @@ DAYS — це мінімальний вік у днях для блоку, як Ви можете вказати множник, такий як K, M або G (наприклад, \-\-bw\-limit 1G). .TP +.B \-t, \-\-tail РОЗМІР +Обмежує список файлів тими, що використовують не більше зазначеного +розміру хвоста дисків парності. +Можна використовувати множники, такі як K, M, G або T (наприклад, \-\-tail 1G). +Цей параметр дійсний лише при використанні разом із командою \`locate\`. +.TP .B \-A, \-\-stats Вмикає розширений перегляд стану, який показує додаткову інформацію. @@ -1312,6 +1330,26 @@ ext3/ext4. настійно не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції \`sync\`. .TP +.B \-W, \-\-force\-realloc\-tail РОЗМІР +Працює як \-R, \-\-force\-realloc, але обмежується вказаною кінцевою +частиною (останні РОЗМІР байт) кожного файлу парності. +Примусово перерозподіляє (переміщує) будь\-які фрагменти/блоки файлів, +що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити +їх будь\-де у файлі(ах) парності, де є вільне місце (включно з +наявними пустотами). +Основна мета цього параметра — зменшити розмір файлу парності на диску. +Якщо перерозподіл успішно очистить всю кінцеву секцію (у ній не +залишиться блоків), файл парності буде обрізаний, вивільняючи +невикористаний простір хвоста. +Можна використовувати множники, такі як K, M, G або T (наприклад, +\-\-force\-realloc\-tail 1G). +Ви можете використовувати locate \-t, \-\-tail, щоб заздалегідь дізнатися +про зачеплені файли. +УВАГА! +Цей параметр призначений лише для експертів, і його настійно +не рекомендується використовувати. +Під час операції \`sync\` захист даних для зачеплених файлів ВІДСУТНІЙ. +.TP .B \-l, \-\-log FILE Записує детальний журнал у вказаний файл. Якщо ця опція не вказана, несподівані помилки diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index fac64304..510a0e3c 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -18,7 +18,7 @@ Name{number} : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -786,6 +786,19 @@ Name{number} функціональність, за єдиним винятком, що `dup` не може виявити дублікати файлів, використовуючи інший хеш. + locate + Знаходить файли, що зберігаються на дисках парності. Для кожного знайденого + файлу виводиться його розташування всередині файлу парності та кількість + фрагментів, які він займає. + + Ви можете використовувати параметр -t, --tail, щоб обмежити операцію файлами, + що займають зазначену кінцеву частину (хвіст) парності. + + Якщо ви хочете перерозподілити ці файли, ви можете скористатися параметром + -W, --force-realloc-tail. + Майте на увазі, що такі файли не будуть захищені парністю під час процесу + перерозподілу. + Опції SnapRAID надає наступні опції: @@ -913,6 +926,12 @@ Name{number} Ви можете вказати множник, такий як K, M або G (наприклад, --bw-limit 1G). + -t, --tail РОЗМІР + Обмежує список файлів тими, що використовують не більше зазначеного + розміру хвоста дисків парності. + Можна використовувати множники, такі як K, M, G або T (наприклад, --tail 1G). + Цей параметр дійсний лише при використанні разом із командою `locate`. + -A, --stats Вмикає розширений перегляд стану, який показує додаткову інформацію. @@ -1023,6 +1042,26 @@ Name{number} настійно не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції `sync`. + -W, --force-realloc-tail РОЗМІР + Працює як -R, --force-realloc, але обмежується вказаною кінцевою + частиною (останні РОЗМІР байт) кожного файлу парності. + Примусово перерозподіляє (переміщує) будь-які фрагменти/блоки файлів, + що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити + їх будь-де у файлі(ах) парності, де є вільне місце (включно з + наявними пустотами). + Основна мета цього параметра — зменшити розмір файлу парності на диску. + Якщо перерозподіл успішно очистить всю кінцеву секцію (у ній не + залишиться блоків), файл парності буде обрізаний, вивільняючи + невикористаний простір хвоста. + Можна використовувати множники, такі як K, M, G або T (наприклад, + --force-realloc-tail 1G). + Ви можете використовувати locate -t, --tail, щоб заздалегідь дізнатися + про зачеплені файли. + УВАГА! + Цей параметр призначений лише для експертів, і його настійно + не рекомендується використовувати. + Під час операції `sync` захист даних для зачеплених файлів ВІДСУТНІЙ. + -l, --log FILE Записує детальний журнал у вказаний файл. Якщо ця опція не вказана, несподівані помилки diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index ebd32ea0..656f3316 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -842,6 +842,21 @@ SnapRAID перейменовує всі файли, які не можуть б функціональність, за єдиним винятком, що `dup` не може виявити дублікати файлів, використовуючи інший хеш. +5.17 locate +----------- + +Знаходить файли, що зберігаються на дисках парності. Для кожного знайденого +файлу виводиться його розташування всередині файлу парності та кількість +фрагментів, які він займає. + +Ви можете використовувати параметр -t, --tail, щоб обмежити операцію файлами, +що займають зазначену кінцеву частину (хвіст) парності. + +Якщо ви хочете перерозподілити ці файли, ви можете скористатися параметром +-W, --force-realloc-tail. +Майте на увазі, що такі файли не будуть захищені парністю під час процесу +перерозподілу. + 6 Опції ======= @@ -972,6 +987,12 @@ SnapRAID надає наступні опції: Ви можете вказати множник, такий як K, M або G (наприклад, --bw-limit 1G). + -t, --tail РОЗМІР + Обмежує список файлів тими, що використовують не більше зазначеного + розміру хвоста дисків парності. + Можна використовувати множники, такі як K, M, G або T (наприклад, --tail 1G). + Цей параметр дійсний лише при використанні разом із командою `locate`. + -A, --stats Вмикає розширений перегляд стану, який показує додаткову інформацію. @@ -1082,6 +1103,26 @@ SnapRAID надає наступні опції: настійно не рекомендується її використовувати. Ви НЕ маєте захисту даних під час операції `sync`. + -W, --force-realloc-tail РОЗМІР + Працює як -R, --force-realloc, але обмежується вказаною кінцевою + частиною (останні РОЗМІР байт) кожного файлу парності. + Примусово перерозподіляє (переміщує) будь-які фрагменти/блоки файлів, + що наразі зберігаються в цій кінцевій секції, дозволяючи розмістити + їх будь-де у файлі(ах) парності, де є вільне місце (включно з + наявними пустотами). + Основна мета цього параметра — зменшити розмір файлу парності на диску. + Якщо перерозподіл успішно очистить всю кінцеву секцію (у ній не + залишиться блоків), файл парності буде обрізаний, вивільняючи + невикористаний простір хвоста. + Можна використовувати множники, такі як K, M, G або T (наприклад, + --force-realloc-tail 1G). + Ви можете використовувати locate -t, --tail, щоб заздалегідь дізнатися + про зачеплені файли. + УВАГА! + Цей параметр призначений лише для експертів, і його настійно + не рекомендується використовувати. + Під час операції `sync` захист даних для зачеплених файлів ВІДСУТНІЙ. + -l, --log FILE Записує детальний журнал у вказаний файл. Якщо ця опція не вказана, несподівані помилки diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index 35c794db..32d2a816 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -66,7 +66,7 @@ snapraid [\-c, \-\-conf CONFIG] .PD 0 .PP .PD - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate .PD 0 .PD .PP @@ -913,6 +913,15 @@ SnapRAID 会重命名所有无法修复的文件，并添加 .PP 在重新散列期间，SnapRAID 保持完全功能， 唯一的例外是 \`dup\` 无法使用不同的散列检测重复的文件。 +.SS locate +查找存储在校验盘中的文件。对于每个匹配的文件，它会打印其在校验文件中的位置 +以及占用的分片数量。 +.PP +您可以使用 \-t, \-\-tail 选项将操作限制在占用校验盘指定尾部部分的 +文件上。 +.PP +如果您想重新分配这些文件，可以使用 \-W, \-\-force\-realloc\-tail 选项。 +请注意，在重新分配过程中，此类文件将不受校验保护。 .SH OPTIONS SnapRAID 提供以下选项： .TP @@ -1012,6 +1021,11 @@ DAYS 是块被 scrub 的最小天数；默认值为 10。 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，\-\-bw\-limit 1G）。 .TP +.B \-t, \-\-tail 大小 +将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 +您可以使用乘数，如 K、M、G 或 T（例如 \-\-tail 1G）。 +此选项仅在与 \`locate\` 命令配合使用时有效。 +.TP .B \-A, \-\-stats 启用扩展状态视图，显示附加信息。 屏幕显示两个图表： @@ -1090,6 +1104,22 @@ DAYS 是块被 scrub 的最小天数；默认值为 10。 **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 \`sync\` 操作期间，您**没有**数据保护。 .TP +.B \-W, \-\-force\-realloc\-tail 大小 +工作方式类似于 \-R, \-\-force\-realloc，但仅限于每个校验文件的 +指定尾部部分（最后“大小”字节）。 +它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， +允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 +空隙）。 +此选项的主要目的是缩小校验文件的磁盘占用大小。 +如果重新分配成功清空了整个尾部区域（没有块继续使用它）， +则校验文件将被截断，回收未使用的尾部空间。 +您可以使用乘数，如 K、M、G 或 T（例如 +\-\-force\-realloc\-tail 1G）。 +您可以使用 locate \-t, \-\-tail 提前了解受影响的文件。 +警告！ +此选项仅供专家使用，强烈建议不要使用。 +在执行 \`sync\` 操作期间，受影响的文件将没有数据保护。 +.TP .B \-l, \-\-log FILE 将详细日志写入指定文件。 如果未指定此选项，则会将意外错误打印到屏幕， diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 491b716a..b5586d93 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -18,7 +18,7 @@ Synopsis : [-A, --stats] : [-v, --verbose] [-q, --quiet] : status|smart|probe|up|down|diff|sync|scrub|fix|check - : |list|dup|pool|devices|touch|rehash + : |list|dup|pool|devices|touch|rehash|locate :snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -635,6 +635,16 @@ Commands 在重新散列期间，SnapRAID 保持完全功能， 唯一的例外是 `dup` 无法使用不同的散列检测重复的文件。 + locate + 查找存储在校验盘中的文件。对于每个匹配的文件，它会打印其在校验文件中的位置 + 以及占用的分片数量。 + + 您可以使用 -t, --tail 选项将操作限制在占用校验盘指定尾部部分的 + 文件上。 + + 如果您想重新分配这些文件，可以使用 -W, --force-realloc-tail 选项。 + 请注意，在重新分配过程中，此类文件将不受校验保护。 + Options SnapRAID 提供以下选项： @@ -734,6 +744,11 @@ Options 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，--bw-limit 1G）。 + -t, --tail 大小 + 将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 + 您可以使用乘数，如 K、M、G 或 T（例如 --tail 1G）。 + 此选项仅在与 `locate` 命令配合使用时有效。 + -A, --stats 启用扩展状态视图，显示附加信息。 屏幕显示两个图表： @@ -812,6 +827,22 @@ Options **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 `sync` 操作期间，您**没有**数据保护。 + -W, --force-realloc-tail 大小 + 工作方式类似于 -R, --force-realloc，但仅限于每个校验文件的 + 指定尾部部分（最后“大小”字节）。 + 它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， + 允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 + 空隙）。 + 此选项的主要目的是缩小校验文件的磁盘占用大小。 + 如果重新分配成功清空了整个尾部区域（没有块继续使用它）， + 则校验文件将被截断，回收未使用的尾部空间。 + 您可以使用乘数，如 K、M、G 或 T（例如 + --force-realloc-tail 1G）。 + 您可以使用 locate -t, --tail 提前了解受影响的文件。 + 警告！ + 此选项仅供专家使用，强烈建议不要使用。 + 在执行 `sync` 操作期间，受影响的文件将没有数据保护。 + -l, --log FILE 将详细日志写入指定文件。 如果未指定此选项，则会将意外错误打印到屏幕， diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 012409b8..d868fef8 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -22,7 +22,7 @@ snapraid [-c, --conf CONFIG] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check - |list|dup|pool|devices|touch|rehash + |list|dup|pool|devices|touch|rehash|locate snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT] @@ -691,6 +691,18 @@ SnapRAID 会重命名所有无法修复的文件，并添加 在重新散列期间，SnapRAID 保持完全功能， 唯一的例外是 `dup` 无法使用不同的散列检测重复的文件。 +5.17 locate +----------- + +查找存储在校验盘中的文件。对于每个匹配的文件，它会打印其在校验文件中的位置 +以及占用的分片数量。 + +您可以使用 -t, --tail 选项将操作限制在占用校验盘指定尾部部分的 +文件上。 + +如果您想重新分配这些文件，可以使用 -W, --force-realloc-tail 选项。 +请注意，在重新分配过程中，此类文件将不受校验保护。 + 6 OPTIONS ========= @@ -793,6 +805,11 @@ SnapRAID 提供以下选项： 每秒的字节数。您可以指定乘数，例如 K、M 或 G （例如，--bw-limit 1G）。 + -t, --tail 大小 + 将文件列表限制为那些使用校验盘指定尾部大小以内的文件。 + 您可以使用乘数，如 K、M、G 或 T（例如 --tail 1G）。 + 此选项仅在与 `locate` 命令配合使用时有效。 + -A, --stats 启用扩展状态视图，显示附加信息。 屏幕显示两个图表： @@ -871,6 +888,22 @@ SnapRAID 提供以下选项： **警告！** 此选项仅供专家使用，强烈建议不要使用它。 在 `sync` 操作期间，您**没有**数据保护。 + -W, --force-realloc-tail 大小 + 工作方式类似于 -R, --force-realloc，但仅限于每个校验文件的 + 指定尾部部分（最后“大小”字节）。 + 它会强制重新分配（移动）当前存储在该尾部部分的任何文件分片/块， + 允许它们被放置在校验文件中任何有可用空间的地方（包括现有的 + 空隙）。 + 此选项的主要目的是缩小校验文件的磁盘占用大小。 + 如果重新分配成功清空了整个尾部区域（没有块继续使用它）， + 则校验文件将被截断，回收未使用的尾部空间。 + 您可以使用乘数，如 K、M、G 或 T（例如 + --force-realloc-tail 1G）。 + 您可以使用 locate -t, --tail 提前了解受影响的文件。 + 警告！ + 此选项仅供专家使用，强烈建议不要使用。 + 在执行 `sync` 操作期间，受影响的文件将没有数据保护。 + -l, --log FILE 将详细日志写入指定文件。 如果未指定此选项，则会将意外错误打印到屏幕， diff --git a/doc/snapraid.1 b/doc/snapraid.1 index fab66b85..df77e638 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -1005,7 +1005,11 @@ prints its location within the parity file and the number of fragments it occupies. .PP You can use the \-t, \-\-tail option to restrict the operation to files -using only the specified tail portion of the parity. +occupying the specified tail portion of the parity. +.PP +If you want to reallocate these files, you can then use the +\-W, \-\-force\-realloc\-tail option. Be aware that such files will +not be protected by parity during the reallocation process. .SH OPTIONS SnapRAID provides the following options: .TP @@ -1225,7 +1229,7 @@ Works like \-R, \-\-force\-realloc, but limited to the specified tail portion (last SIZE bytes) of each parity file. It forces reallocation (movement) of any file fragments/blocks currently stored in that tail section, allowing them to be -placed anywhere in the parity file where free space is +placed anywhere in the parity file(s) where free space is available (including existing holes). The main purpose of this option is to shrink the on\-disk size of the parity file. If the reallocation successfully clears @@ -1233,6 +1237,8 @@ the entire tail section (no blocks remain using it), the parity file is truncated, reclaiming the unused tail space. You can use multipliers such as K, M, G, or T (e.g. \-\-force\-realloc\-tail 1G). +You can use locate \-t, \-\-tail to know in advance the affected +files. WARNING! This option is for experts only, and it is highly recommended not to use it. You DO NOT have data protection during the \`sync\` operation diff --git a/doc/snapraid.d b/doc/snapraid.d index fcfccc79..08d6fa09 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -720,11 +720,15 @@ Commands locate Locate files stored in the parity disks. For each matching file, it - prints its location within the parity file and the number of fragments - it occupies. + prints its location within the parity file and the number of fragments + it occupies. You can use the -t, --tail option to restrict the operation to files - using only the specified tail portion of the parity. + occupying the specified tail portion of the parity. + + If you want to reallocate these files, you can then use the + -W, --force-realloc-tail option. Be aware that such files will + not be protected by parity during the reallocation process. Options SnapRAID provides the following options: @@ -945,7 +949,7 @@ Options tail portion (last SIZE bytes) of each parity file. It forces reallocation (movement) of any file fragments/blocks currently stored in that tail section, allowing them to be - placed anywhere in the parity file where free space is + placed anywhere in the parity file(s) where free space is available (including existing holes). The main purpose of this option is to shrink the on-disk size of the parity file. If the reallocation successfully clears @@ -953,6 +957,8 @@ Options parity file is truncated, reclaiming the unused tail space. You can use multipliers such as K, M, G, or T (e.g. --force-realloc-tail 1G). + You can use locate -t, --tail to know in advance the affected + files. WARNING! This option is for experts only, and it is highly recommended not to use it. You DO NOT have data protection during the `sync` operation diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 04aa6e65..a82cb9d2 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -782,7 +782,11 @@ prints its location within the parity file and the number of fragments it occupies. You can use the -t, --tail option to restrict the operation to files -using only the specified tail portion of the parity. +occupying the specified tail portion of the parity. + +If you want to reallocate these files, you can then use the +-W, --force-realloc-tail option. Be aware that such files will +not be protected by parity during the reallocation process. 6 OPTIONS @@ -1006,7 +1010,7 @@ SnapRAID provides the following options: tail portion (last SIZE bytes) of each parity file. It forces reallocation (movement) of any file fragments/blocks currently stored in that tail section, allowing them to be - placed anywhere in the parity file where free space is + placed anywhere in the parity file(s) where free space is available (including existing holes). The main purpose of this option is to shrink the on-disk size of the parity file. If the reallocation successfully clears @@ -1014,6 +1018,8 @@ SnapRAID provides the following options: parity file is truncated, reclaiming the unused tail space. You can use multipliers such as K, M, G, or T (e.g. --force-realloc-tail 1G). + You can use locate -t, --tail to know in advance the affected + files. WARNING! This option is for experts only, and it is highly recommended not to use it. You DO NOT have data protection during the `sync` operation