diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 805d03f2..30c5da61 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -2367,6 +2367,54 @@ Der Befehl ist auf Fehler gestoßen. Der Befehl \`diff\` hat festgestellt, dass alles OK ist, aber ein \`sync\` erforderlich ist. .PD .RE +.SH BEKANNTE PROBLEME (KNOWN ISSUES) +.SS Dateisystemgrenzen +SnapRAID überschreitet beim Scannen einer Datenfestplatte keine Dateisystem\-, +Mount\- oder Subvolume\-Grenzen. Wenn eine solche Grenze erkannt wird, gibt +SnapRAID eine WARNUNG aus und scannt nicht darüber hinaus. +.PP +Dateien, die sich jenseits solcher Grenzen befinden, sind nicht in der +Datenfestplatte enthalten und müssen separat konfiguriert werden, wenn sie +geschützt werden sollen. +.SS Mount\-Punkte mit Dateisystem\-Snapshots +Wenn Dateisystem\-Snapshots aktiviert sind, werden verschachtelte Mount\-Punkte +und Bind\-Mounts innerhalb einer Datenfestplatte nicht unterstützt. +.PP +Mount\-Punkte sind Teil des Mount\-Namespace des laufenden Systems und werden +in Dateisystem\-Snapshots nicht beibehalten. Folglich kann beim Scannen eines +Snapshots ein Verzeichnis sichtbar werden, das im Live\-Dateisystem durch +einen Mount\-Punkt verdeckt war. +.PP +Platzieren Sie keine verschachtelten Mount\-Punkte oder Bind\-Mounts innerhalb +von Datenfestplatten, wenn Dateisystem\-Snapshots aktiviert sind. +.SS Hardlinks +SnapRAID identifiziert einen Hardlink als Originaldatei und stellt die +anderen Hardlinks als Verweise darauf dar. Welcher Link als Originaldatei +ausgewählt wird, hängt von der Reihenfolge ab, in der Verzeichniseinträge +gescannt werden. +.PP +Wenn sich diese Reihenfolge ändert, beispielsweise nach dem Umbenennen, +Wiederherstellen von Dateien oder Neuerstellen von Verzeichnissen, meldet +\[dq]diff\[dq] möglicherweise scheinbare Verschiebungen, Aktualisierungen, +Hinzufügungen oder Entfernungen, selbst wenn die fest verknüpften Dateien +immer noch dieselben Daten darstellen. +.PP +Dies deutet nicht auf eine Datenbeschädigung hin, aber die gemeldeten +Unterschiede können verwirrend sein und stimmen möglicherweise nicht direkt +mit den ausgeführten Dateisystemoperationen überein. +.SS In\-Place\-Dateimodifikationen ohne Zeitstempeländerungen +SnapRAID erkennt Dateimodifikationen durch den Vergleich von Dateigrößen +und Änderungszeitstempeln (mtime). +.PP +Wenn eine Anwendung eine Datei in\-place ändert, ohne deren Größe zu verändern +oder ihren Änderungszeitstempel zu aktualisieren, erkennen \[dq]diff\[dq] und \[dq]sync\[dq] +nicht, dass sich die Datei geändert hat, und ihre Parität wird nicht +aktualisiert. +.PP +Um sicherzustellen, dass SnapRAID solche Änderungen erkennt, aktualisieren +Sie den Änderungszeitstempel der Datei (z. B. mit dem Dienstprogramm \[dq]touch\[dq]). +Andernfalls wird der Unterschied erst bei einem nachfolgenden \[dq]scrub\[dq] oder +\[dq]check\[dq] als Hash\-Fehlübereinstimmung erkannt. .SH ÜBERSETZUNG (TRANSLATION) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index aa80d226..2fd96cc9 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -1872,6 +1872,58 @@ Exit-Code (Exit Code) 1 - Der Befehl ist auf Fehler gestoßen. 2 - Der Befehl `diff` hat festgestellt, dass alles OK ist, aber ein `sync` erforderlich ist. +Bekannte Probleme (Known Issues) + Dateisystemgrenzen + SnapRAID überschreitet beim Scannen einer Datenfestplatte keine Dateisystem-, + Mount- oder Subvolume-Grenzen. Wenn eine solche Grenze erkannt wird, gibt + SnapRAID eine WARNUNG aus und scannt nicht darüber hinaus. + + Dateien, die sich jenseits solcher Grenzen befinden, sind nicht in der + Datenfestplatte enthalten und müssen separat konfiguriert werden, wenn sie + geschützt werden sollen. + + Mount-Punkte mit Dateisystem-Snapshots + Wenn Dateisystem-Snapshots aktiviert sind, werden verschachtelte Mount-Punkte + und Bind-Mounts innerhalb einer Datenfestplatte nicht unterstützt. + + Mount-Punkte sind Teil des Mount-Namespace des laufenden Systems und werden + in Dateisystem-Snapshots nicht beibehalten. Folglich kann beim Scannen eines + Snapshots ein Verzeichnis sichtbar werden, das im Live-Dateisystem durch + einen Mount-Punkt verdeckt war. + + Platzieren Sie keine verschachtelten Mount-Punkte oder Bind-Mounts innerhalb + von Datenfestplatten, wenn Dateisystem-Snapshots aktiviert sind. + + Hardlinks + SnapRAID identifiziert einen Hardlink als Originaldatei und stellt die + anderen Hardlinks als Verweise darauf dar. Welcher Link als Originaldatei + ausgewählt wird, hängt von der Reihenfolge ab, in der Verzeichniseinträge + gescannt werden. + + Wenn sich diese Reihenfolge ändert, beispielsweise nach dem Umbenennen, + Wiederherstellen von Dateien oder Neuerstellen von Verzeichnissen, meldet + "diff" möglicherweise scheinbare Verschiebungen, Aktualisierungen, + Hinzufügungen oder Entfernungen, selbst wenn die fest verknüpften Dateien + immer noch dieselben Daten darstellen. + + Dies deutet nicht auf eine Datenbeschädigung hin, aber die gemeldeten + Unterschiede können verwirrend sein und stimmen möglicherweise nicht direkt + mit den ausgeführten Dateisystemoperationen überein. + + In-Place-Dateimodifikationen ohne Zeitstempeländerungen + SnapRAID erkennt Dateimodifikationen durch den Vergleich von Dateigrößen + und Änderungszeitstempeln (mtime). + + Wenn eine Anwendung eine Datei in-place ändert, ohne deren Größe zu verändern + oder ihren Änderungszeitstempel zu aktualisieren, erkennen "diff" und "sync" + nicht, dass sich die Datei geändert hat, und ihre Parität wird nicht + aktualisiert. + + Um sicherzustellen, dass SnapRAID solche Änderungen erkennt, aktualisieren + Sie den Änderungszeitstempel der Datei (z. B. mit dem Dienstprogramm "touch"). + Andernfalls wird der Unterschied erst bei einem nachfolgenden "scrub" oder + "check" als Hash-Fehlübereinstimmung erkannt. + Übersetzung (Translation) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 371f2334..a0fa191f 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -2001,20 +2001,83 @@ SnapRAID endet mit den folgenden Fehlercodes: 2 - Der Befehl `diff` hat festgestellt, dass alles OK ist, aber ein `sync` erforderlich ist. -16 ÜBERSETZUNG (TRANSLATION) +16 BEKANNTE PROBLEME (KNOWN ISSUES) +=================================== + +16.1 Dateisystemgrenzen +----------------------- + +SnapRAID überschreitet beim Scannen einer Datenfestplatte keine Dateisystem-, +Mount- oder Subvolume-Grenzen. Wenn eine solche Grenze erkannt wird, gibt +SnapRAID eine WARNUNG aus und scannt nicht darüber hinaus. + +Dateien, die sich jenseits solcher Grenzen befinden, sind nicht in der +Datenfestplatte enthalten und müssen separat konfiguriert werden, wenn sie +geschützt werden sollen. + +16.2 Mount-Punkte mit Dateisystem-Snapshots +------------------------------------------- + +Wenn Dateisystem-Snapshots aktiviert sind, werden verschachtelte Mount-Punkte +und Bind-Mounts innerhalb einer Datenfestplatte nicht unterstützt. + +Mount-Punkte sind Teil des Mount-Namespace des laufenden Systems und werden +in Dateisystem-Snapshots nicht beibehalten. Folglich kann beim Scannen eines +Snapshots ein Verzeichnis sichtbar werden, das im Live-Dateisystem durch +einen Mount-Punkt verdeckt war. + +Platzieren Sie keine verschachtelten Mount-Punkte oder Bind-Mounts innerhalb +von Datenfestplatten, wenn Dateisystem-Snapshots aktiviert sind. + +16.3 Hardlinks +-------------- + +SnapRAID identifiziert einen Hardlink als Originaldatei und stellt die +anderen Hardlinks als Verweise darauf dar. Welcher Link als Originaldatei +ausgewählt wird, hängt von der Reihenfolge ab, in der Verzeichniseinträge +gescannt werden. + +Wenn sich diese Reihenfolge ändert, beispielsweise nach dem Umbenennen, +Wiederherstellen von Dateien oder Neuerstellen von Verzeichnissen, meldet +"diff" möglicherweise scheinbare Verschiebungen, Aktualisierungen, +Hinzufügungen oder Entfernungen, selbst wenn die fest verknüpften Dateien +immer noch dieselben Daten darstellen. + +Dies deutet nicht auf eine Datenbeschädigung hin, aber die gemeldeten +Unterschiede können verwirrend sein und stimmen möglicherweise nicht direkt +mit den ausgeführten Dateisystemoperationen überein. + +16.4 In-Place-Dateimodifikationen ohne Zeitstempeländerungen +------------------------------------------------------------ + +SnapRAID erkennt Dateimodifikationen durch den Vergleich von Dateigrößen +und Änderungszeitstempeln (mtime). + +Wenn eine Anwendung eine Datei in-place ändert, ohne deren Größe zu verändern +oder ihren Änderungszeitstempel zu aktualisieren, erkennen "diff" und "sync" +nicht, dass sich die Datei geändert hat, und ihre Parität wird nicht +aktualisiert. + +Um sicherzustellen, dass SnapRAID solche Änderungen erkennt, aktualisieren +Sie den Änderungszeitstempel der Datei (z. B. mit dem Dienstprogramm "touch"). +Andernfalls wird der Unterschied erst bei einem nachfolgenden "scrub" oder +"check" als Hash-Fehlübereinstimmung erkannt. + + +17 ÜBERSETZUNG (TRANSLATION) ============================ Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. -17 COPYRIGHT +18 COPYRIGHT ============ Diese Datei ist Copyright (C) 2026 Andrea Mazzoleni -18 SIEHE AUCH (SEE ALSO) +19 SIEHE AUCH (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index 3b55c0a6..78d60bf2 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -2325,6 +2325,53 @@ El comando encontró algunos errores. El comando \`diff\` determinó que todo está bien, pero se necesita un \`sync\`. .PD .RE +.SH PROBLEMAS CONOCIDOS (KNOWN ISSUES) +.SS Límites del sistema de archivos +SnapRAID no cruza los límites del sistema de archivos, puntos de montaje o +subvolúmenes al escanear un disco de datos. Cuando se detecta dicho límite, +SnapRAID emite una ADVERTENCIA y no escanea más allá de él. +.PP +Los archivos ubicados más allá de dichos límites no se incluyen en el disco +de datos y deben configurarse por separado si se desea protegerlos. +.SS Puntos de montaje con instantáneas del sistema de archivos +Cuando las instantáneas del sistema de archivos están habilitadas, no se +admiten puntos de montaje anidados ni montajes bind dentro de un disco de +datos. +.PP +Los puntos de montaje forman parte del espacio de nombres de montaje del +sistema en vivo y no se conservan en las instantáneas del sistema de +archivos. En consecuencia, al escanear una instantánea, un directorio +oculto por un punto de montaje en el sistema de archivos en vivo puede +hacerse visible. +.PP +No coloque puntos de montaje anidados ni montajes bind dentro de los discos +de datos cuando las instantáneas del sistema de archivos estén habilitadas. +.SS Enlaces duros +SnapRAID identifica un enlace duro como el archivo original y representa +los demás enlaces duros como referencias a él. El enlace que se selecciona +como archivo original depende del orden en que se escanean las entradas del +directorio. +.PP +Si este orden cambia, por ejemplo después de renombrar, restaurar archivos o +recrear directorios, \[dq]diff\[dq] puede informar movimientos, actualizaciones, +adiciones o eliminaciones aparentes incluso cuando los archivos vinculados +siguen representando los mismos datos. +.PP +Esto no indica corrupción de datos, pero las diferencias informadas pueden +resultar confusas y no corresponder directamente con las operaciones +realizadas en el sistema de archivos. +.SS Modificaciones de archivos in situ sin cambios de marca de tiempo +SnapRAID detecta modificaciones de archivos comparando tamaños de archivo y +marcas de tiempo de modificación (mtime). +.PP +Si una aplicación modifica un archivo in situ sin alterar su tamaño ni +actualizar su marca de tiempo de modificación, \[dq]diff\[dq] y \[dq]sync\[dq] no detectarán +que el archivo ha cambiado y su paridad no se actualizará. +.PP +Para asegurarse de que SnapRAID reconozca dichos cambios, actualice la marca +de tiempo de modificación del archivo (por ejemplo, con la utilidad \[dq]touch\[dq]). +De lo contrario, la diferencia solo se detectará como una falta de +coincidencia de hash durante un \[dq]scrub\[dq] o \[dq]check\[dq] posterior. .SH TRADUCCIóN (TRANSLATION) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 5d00889f..0f6a67e6 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -1841,6 +1841,57 @@ Código de salida (Exit Code) 1 - El comando encontró algunos errores. 2 - El comando `diff` determinó que todo está bien, pero se necesita un `sync`. +Problemas conocidos (Known Issues) + Límites del sistema de archivos + SnapRAID no cruza los límites del sistema de archivos, puntos de montaje o + subvolúmenes al escanear un disco de datos. Cuando se detecta dicho límite, + SnapRAID emite una ADVERTENCIA y no escanea más allá de él. + + Los archivos ubicados más allá de dichos límites no se incluyen en el disco + de datos y deben configurarse por separado si se desea protegerlos. + + Puntos de montaje con instantáneas del sistema de archivos + Cuando las instantáneas del sistema de archivos están habilitadas, no se + admiten puntos de montaje anidados ni montajes bind dentro de un disco de + datos. + + Los puntos de montaje forman parte del espacio de nombres de montaje del + sistema en vivo y no se conservan en las instantáneas del sistema de + archivos. En consecuencia, al escanear una instantánea, un directorio + oculto por un punto de montaje en el sistema de archivos en vivo puede + hacerse visible. + + No coloque puntos de montaje anidados ni montajes bind dentro de los discos + de datos cuando las instantáneas del sistema de archivos estén habilitadas. + + Enlaces duros + SnapRAID identifica un enlace duro como el archivo original y representa + los demás enlaces duros como referencias a él. El enlace que se selecciona + como archivo original depende del orden en que se escanean las entradas del + directorio. + + Si este orden cambia, por ejemplo después de renombrar, restaurar archivos o + recrear directorios, "diff" puede informar movimientos, actualizaciones, + adiciones o eliminaciones aparentes incluso cuando los archivos vinculados + siguen representando los mismos datos. + + Esto no indica corrupción de datos, pero las diferencias informadas pueden + resultar confusas y no corresponder directamente con las operaciones + realizadas en el sistema de archivos. + + Modificaciones de archivos in situ sin cambios de marca de tiempo + SnapRAID detecta modificaciones de archivos comparando tamaños de archivo y + marcas de tiempo de modificación (mtime). + + Si una aplicación modifica un archivo in situ sin alterar su tamaño ni + actualizar su marca de tiempo de modificación, "diff" y "sync" no detectarán + que el archivo ha cambiado y su paridad no se actualizará. + + Para asegurarse de que SnapRAID reconozca dichos cambios, actualice la marca + de tiempo de modificación del archivo (por ejemplo, con la utilidad "touch"). + De lo contrario, la diferencia solo se detectará como una falta de + coincidencia de hash durante un "scrub" o "check" posterior. + Traducción (Translation) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 88f468ac..73a8e7c0 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -1970,20 +1970,82 @@ SnapRAID termina con los siguientes códigos de error: 2 - El comando `diff` determinó que todo está bien, pero se necesita un `sync`. -16 TRADUCCIóN (TRANSLATION) +16 PROBLEMAS CONOCIDOS (KNOWN ISSUES) +===================================== + +16.1 Límites del sistema de archivos +------------------------------------ + +SnapRAID no cruza los límites del sistema de archivos, puntos de montaje o +subvolúmenes al escanear un disco de datos. Cuando se detecta dicho límite, +SnapRAID emite una ADVERTENCIA y no escanea más allá de él. + +Los archivos ubicados más allá de dichos límites no se incluyen en el disco +de datos y deben configurarse por separado si se desea protegerlos. + +16.2 Puntos de montaje con instantáneas del sistema de archivos +--------------------------------------------------------------- + +Cuando las instantáneas del sistema de archivos están habilitadas, no se +admiten puntos de montaje anidados ni montajes bind dentro de un disco de +datos. + +Los puntos de montaje forman parte del espacio de nombres de montaje del +sistema en vivo y no se conservan en las instantáneas del sistema de +archivos. En consecuencia, al escanear una instantánea, un directorio +oculto por un punto de montaje en el sistema de archivos en vivo puede +hacerse visible. + +No coloque puntos de montaje anidados ni montajes bind dentro de los discos +de datos cuando las instantáneas del sistema de archivos estén habilitadas. + +16.3 Enlaces duros +------------------ + +SnapRAID identifica un enlace duro como el archivo original y representa +los demás enlaces duros como referencias a él. El enlace que se selecciona +como archivo original depende del orden en que se escanean las entradas del +directorio. + +Si este orden cambia, por ejemplo después de renombrar, restaurar archivos o +recrear directorios, "diff" puede informar movimientos, actualizaciones, +adiciones o eliminaciones aparentes incluso cuando los archivos vinculados +siguen representando los mismos datos. + +Esto no indica corrupción de datos, pero las diferencias informadas pueden +resultar confusas y no corresponder directamente con las operaciones +realizadas en el sistema de archivos. + +16.4 Modificaciones de archivos in situ sin cambios de marca de tiempo +---------------------------------------------------------------------- + +SnapRAID detecta modificaciones de archivos comparando tamaños de archivo y +marcas de tiempo de modificación (mtime). + +Si una aplicación modifica un archivo in situ sin alterar su tamaño ni +actualizar su marca de tiempo de modificación, "diff" y "sync" no detectarán +que el archivo ha cambiado y su paridad no se actualizará. + +Para asegurarse de que SnapRAID reconozca dichos cambios, actualice la marca +de tiempo de modificación del archivo (por ejemplo, con la utilidad "touch"). +De lo contrario, la diferencia solo se detectará como una falta de +coincidencia de hash durante un "scrub" o "check" posterior. + + +17 TRADUCCIóN (TRANSLATION) =========================== Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. -17 COPYRIGHT +18 COPYRIGHT ============ Este archivo es Copyright (C) 2026 Andrea Mazzoleni -18 VéASE TAMBIéN (SEE ALSO) +19 VéASE TAMBIéN (SEE ALSO) =========================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 8d410505..c30ea6f4 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -2370,6 +2370,55 @@ La commande a rencontré des erreurs. La commande \`diff\` a trouvé que tout est OK, mais un \`sync\` est requis. .PD .RE +.SH PROBLèMES CONNUS (KNOWN ISSUES) +.SS Limites du système de fichiers +SnapRAID ne franchit pas les limites de système de fichiers, de point de +montage ou de sous\-volume lors de l\'analyse d\'un disque de données. +Lorsqu\'une telle limite est détectée, SnapRAID signale un AVERTISSEMENT +et n\'analyse pas au\-delà. +.PP +Les fichiers situés au\-delà de ces limites ne sont pas inclus dans le disque +de données et doivent être configurés séparément s\'ils doivent être protégés. +.SS Points de montage avec instantanés du système de fichiers +Lorsque les instantanés du système de fichiers sont activés, les points de +montage imbriqués et les montages bind à l\'intérieur d\'un disque de données +ne sont pas pris en charge. +.PP +Les points de montage font partie de l\'espace de noms de montage du système +en direct et ne sont pas conservés dans les instantanés du système de +fichiers. Par conséquent, lors de l\'analyse d\'un instantané, un répertoire +masqué par un point de montage dans le système de fichiers en direct peut +devenir visible. +.PP +Ne placez pas de points de montage imbriqués ou de montages bind dans les +disques de données lorsque les instantanés du système de fichiers sont +activés. +.SS Liens matériels +SnapRAID identifie un lien matériel comme le fichier d\'origine et représente +les autres liens matériels comme des références à celui\-ci. Le lien sélectionné +comme fichier d\'origine dépend de l\'ordre dans lequel les entrées de +répertoire sont analysées. +.PP +Si cet ordre change, par exemple après le renommage, la restauration de +fichiers ou la recréation de répertoires, \[dq]diff\[dq] peut signaler des +déplacements, mises à jour, ajouts ou suppressions apparents même lorsque +les fichiers liés représentent toujours les mêmes données. +.PP +Cela n\'indique pas une corruption des données, mais les différences +signalées peuvent prêter à confusion et ne pas correspondre directement aux +opérations effectuées sur le système de fichiers. +.SS Modifications de fichiers sur place sans changement d\'horodatage +SnapRAID détecte les modifications de fichiers en comparant la taille des +fichiers et les horodatages de modification (mtime). +.PP +Si une application modifie un fichier sur place sans modifier sa taille ni +mettre à jour son horodatage de modification, \[dq]diff\[dq] et \[dq]sync\[dq] ne détecteront +pas que le fichier a changé et sa parité ne sera pas mise à jour. +.PP +Pour vous assurer que SnapRAID reconnaît ces modifications, mettez à jour +l\'horodatage de modification du fichier (par exemple avec l\'utilitaire +\[dq]touch\[dq]). Sinon, la différence ne sera détectée que sous la forme d\'une +non\-concordance de hachage lors d\'un \[dq]scrub\[dq] ou \[dq]check\[dq] ultérieur. .SH TRADUCTION (TRANSLATION) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 3a70cab4..ea5f5a8b 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -1883,6 +1883,59 @@ Code de sortie (Exit Code) 1 - La commande a rencontré des erreurs. 2 - La commande `diff` a trouvé que tout est OK, mais un `sync` est requis. +Problèmes connus (Known Issues) + Limites du système de fichiers + SnapRAID ne franchit pas les limites de système de fichiers, de point de + montage ou de sous-volume lors de l'analyse d'un disque de données. + Lorsqu'une telle limite est détectée, SnapRAID signale un AVERTISSEMENT + et n'analyse pas au-delà. + + Les fichiers situés au-delà de ces limites ne sont pas inclus dans le disque + de données et doivent être configurés séparément s'ils doivent être protégés. + + Points de montage avec instantanés du système de fichiers + Lorsque les instantanés du système de fichiers sont activés, les points de + montage imbriqués et les montages bind à l'intérieur d'un disque de données + ne sont pas pris en charge. + + Les points de montage font partie de l'espace de noms de montage du système + en direct et ne sont pas conservés dans les instantanés du système de + fichiers. Par conséquent, lors de l'analyse d'un instantané, un répertoire + masqué par un point de montage dans le système de fichiers en direct peut + devenir visible. + + Ne placez pas de points de montage imbriqués ou de montages bind dans les + disques de données lorsque les instantanés du système de fichiers sont + activés. + + Liens matériels + SnapRAID identifie un lien matériel comme le fichier d'origine et représente + les autres liens matériels comme des références à celui-ci. Le lien sélectionné + comme fichier d'origine dépend de l'ordre dans lequel les entrées de + répertoire sont analysées. + + Si cet ordre change, par exemple après le renommage, la restauration de + fichiers ou la recréation de répertoires, "diff" peut signaler des + déplacements, mises à jour, ajouts ou suppressions apparents même lorsque + les fichiers liés représentent toujours les mêmes données. + + Cela n'indique pas une corruption des données, mais les différences + signalées peuvent prêter à confusion et ne pas correspondre directement aux + opérations effectuées sur le système de fichiers. + + Modifications de fichiers sur place sans changement d'horodatage + SnapRAID détecte les modifications de fichiers en comparant la taille des + fichiers et les horodatages de modification (mtime). + + Si une application modifie un fichier sur place sans modifier sa taille ni + mettre à jour son horodatage de modification, "diff" et "sync" ne détecteront + pas que le fichier a changé et sa parité ne sera pas mise à jour. + + Pour vous assurer que SnapRAID reconnaît ces modifications, mettez à jour + l'horodatage de modification du fichier (par exemple avec l'utilitaire + "touch"). Sinon, la différence ne sera détectée que sous la forme d'une + non-concordance de hachage lors d'un "scrub" ou "check" ultérieur. + Traduction (Translation) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 2b2c28b7..3f804bd2 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -2012,20 +2012,84 @@ SnapRAID se termine avec les codes d'erreur suivants : 2 - La commande `diff` a trouvé que tout est OK, mais un `sync` est requis. -16 TRADUCTION (TRANSLATION) +16 PROBLèMES CONNUS (KNOWN ISSUES) +================================== + +16.1 Limites du système de fichiers +----------------------------------- + +SnapRAID ne franchit pas les limites de système de fichiers, de point de +montage ou de sous-volume lors de l'analyse d'un disque de données. +Lorsqu'une telle limite est détectée, SnapRAID signale un AVERTISSEMENT +et n'analyse pas au-delà. + +Les fichiers situés au-delà de ces limites ne sont pas inclus dans le disque +de données et doivent être configurés séparément s'ils doivent être protégés. + +16.2 Points de montage avec instantanés du système de fichiers +-------------------------------------------------------------- + +Lorsque les instantanés du système de fichiers sont activés, les points de +montage imbriqués et les montages bind à l'intérieur d'un disque de données +ne sont pas pris en charge. + +Les points de montage font partie de l'espace de noms de montage du système +en direct et ne sont pas conservés dans les instantanés du système de +fichiers. Par conséquent, lors de l'analyse d'un instantané, un répertoire +masqué par un point de montage dans le système de fichiers en direct peut +devenir visible. + +Ne placez pas de points de montage imbriqués ou de montages bind dans les +disques de données lorsque les instantanés du système de fichiers sont +activés. + +16.3 Liens matériels +-------------------- + +SnapRAID identifie un lien matériel comme le fichier d'origine et représente +les autres liens matériels comme des références à celui-ci. Le lien sélectionné +comme fichier d'origine dépend de l'ordre dans lequel les entrées de +répertoire sont analysées. + +Si cet ordre change, par exemple après le renommage, la restauration de +fichiers ou la recréation de répertoires, "diff" peut signaler des +déplacements, mises à jour, ajouts ou suppressions apparents même lorsque +les fichiers liés représentent toujours les mêmes données. + +Cela n'indique pas une corruption des données, mais les différences +signalées peuvent prêter à confusion et ne pas correspondre directement aux +opérations effectuées sur le système de fichiers. + +16.4 Modifications de fichiers sur place sans changement d'horodatage +--------------------------------------------------------------------- + +SnapRAID détecte les modifications de fichiers en comparant la taille des +fichiers et les horodatages de modification (mtime). + +Si une application modifie un fichier sur place sans modifier sa taille ni +mettre à jour son horodatage de modification, "diff" et "sync" ne détecteront +pas que le fichier a changé et sa parité ne sera pas mise à jour. + +Pour vous assurer que SnapRAID reconnaît ces modifications, mettez à jour +l'horodatage de modification du fichier (par exemple avec l'utilitaire +"touch"). Sinon, la différence ne sera détectée que sous la forme d'une +non-concordance de hachage lors d'un "scrub" ou "check" ultérieur. + + +17 TRADUCTION (TRANSLATION) =========================== Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. -17 DROITS D'AUTEUR (COPYRIGHT) +18 DROITS D'AUTEUR (COPYRIGHT) ============================== Ce fichier est Copyright (C) 2026 Andrea Mazzoleni -18 VOIR AUSSI (SEE ALSO) +19 VOIR AUSSI (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index 4046ff45..e2f8cb58 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -2350,6 +2350,50 @@ Il comando ha riscontrato alcuni errori. Il comando \`diff\` ha rilevato che tutto è OK, ma è necessario un \`sync\`. .PD .RE +.SH PROBLEMI NOTI (KNOWN ISSUES) +.SS Limiti del filesystem +SnapRAID non attraversa i confini di filesystem, punti di mount o subvolume +durante la scansione di un disco dati. Quando viene rilevato un tale confine, +SnapRAID segnala un WARNING e non prosegue la scansione al suo interno. +.PP +I file che si trovano oltre tali confini non sono inclusi nel disco dati e +devono essere configurati separatamente se devono essere protetti. +.SS Punti di mount con snapshot del filesystem +Quando le snapshot del filesystem sono abilitate, i punti di mount annidati +e i bind mount all\'interno di un disco dati non sono supportati. +.PP +I punti di mount fanno parte del namespace di mount del sistema in esecuzione +e non vengono preservati nelle snapshot del filesystem. Di conseguenza, +durante la scansione di una snapshot, una directory nascosta da un punto di +mount nel filesystem live potrebbe diventare visibile. +.PP +Non inserire punti di mount annidati o bind mount all\'interno dei dischi dati +quando le snapshot del filesystem sono abilitate. +.SS Hard link +SnapRAID identifica un hard link come file originale e rappresenta gli altri +hard link come riferimenti ad esso. Quale link viene selezionato come file +originale dipende dall\'ordine in cui vengono scansionate le voci di directory. +.PP +Se questo ordine cambia, ad esempio dopo che i file vengono rinominati, +ripristinati o le directory vengono ricreate, \[dq]diff\[dq] può segnalare apparenti +spostamenti, aggiornamenti, aggiunte o rimozioni anche quando i file collegati +rappresentano ancora gli stessi dati. +.PP +Ciò non indica corruzione dei dati, ma le differenze segnalate possono +generare confusione e potrebbero non corrispondere direttamente alle +operazioni eseguite sul filesystem. +.SS Modifiche ai file sul posto senza variazione di data/ora +SnapRAID rileva le modifiche ai file confrontando le dimensioni dei file e +i timestamp di modifica (mtime). +.PP +Se un\'applicazione modifica un file in\-place senza alterarne la dimensione +o aggiornarne il timestamp di modifica, \[dq]diff\[dq] e \[dq]sync\[dq] non rileveranno che +il file è cambiato e la sua parità non verrà aggiornata. +.PP +Per garantire che SnapRAID riconosca tali modifiche, aggiornare il timestamp +di modifica del file (ad esempio con l\'utilità \[dq]touch\[dq]). Altrimenti, la +differenza verrà rilevata solo come mancata corrispondenza dell\'hash durante +un successivo \[dq]scrub\[dq] o \[dq]check\[dq]. .SH TRADUZIONE (TRANSLATION) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index a7b3e1da..ab89d879 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -1852,6 +1852,54 @@ Codice di uscita (Exit Code) 1 - Il comando ha riscontrato alcuni errori. 2 - Il comando `diff` ha rilevato che tutto è OK, ma è necessario un `sync`. +Problemi noti (Known Issues) + Limiti del filesystem + SnapRAID non attraversa i confini di filesystem, punti di mount o subvolume + durante la scansione di un disco dati. Quando viene rilevato un tale confine, + SnapRAID segnala un WARNING e non prosegue la scansione al suo interno. + + I file che si trovano oltre tali confini non sono inclusi nel disco dati e + devono essere configurati separatamente se devono essere protetti. + + Punti di mount con snapshot del filesystem + Quando le snapshot del filesystem sono abilitate, i punti di mount annidati + e i bind mount all'interno di un disco dati non sono supportati. + + I punti di mount fanno parte del namespace di mount del sistema in esecuzione + e non vengono preservati nelle snapshot del filesystem. Di conseguenza, + durante la scansione di una snapshot, una directory nascosta da un punto di + mount nel filesystem live potrebbe diventare visibile. + + Non inserire punti di mount annidati o bind mount all'interno dei dischi dati + quando le snapshot del filesystem sono abilitate. + + Hard link + SnapRAID identifica un hard link come file originale e rappresenta gli altri + hard link come riferimenti ad esso. Quale link viene selezionato come file + originale dipende dall'ordine in cui vengono scansionate le voci di directory. + + Se questo ordine cambia, ad esempio dopo che i file vengono rinominati, + ripristinati o le directory vengono ricreate, "diff" può segnalare apparenti + spostamenti, aggiornamenti, aggiunte o rimozioni anche quando i file collegati + rappresentano ancora gli stessi dati. + + Ciò non indica corruzione dei dati, ma le differenze segnalate possono + generare confusione e potrebbero non corrispondere direttamente alle + operazioni eseguite sul filesystem. + + Modifiche ai file sul posto senza variazione di data/ora + SnapRAID rileva le modifiche ai file confrontando le dimensioni dei file e + i timestamp di modifica (mtime). + + Se un'applicazione modifica un file in-place senza alterarne la dimensione + o aggiornarne il timestamp di modifica, "diff" e "sync" non rileveranno che + il file è cambiato e la sua parità non verrà aggiornata. + + Per garantire che SnapRAID riconosca tali modifiche, aggiornare il timestamp + di modifica del file (ad esempio con l'utilità "touch"). Altrimenti, la + differenza verrà rilevata solo come mancata corrispondenza dell'hash durante + un successivo "scrub" o "check". + Traduzione (Translation) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index 6ff30578..6f5da6ff 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -1981,20 +1981,79 @@ SnapRAID termina con i seguenti codici di errore: 2 - Il comando `diff` ha rilevato che tutto è OK, ma è necessario un `sync`. -16 TRADUZIONE (TRANSLATION) +16 PROBLEMI NOTI (KNOWN ISSUES) +=============================== + +16.1 Limiti del filesystem +-------------------------- + +SnapRAID non attraversa i confini di filesystem, punti di mount o subvolume +durante la scansione di un disco dati. Quando viene rilevato un tale confine, +SnapRAID segnala un WARNING e non prosegue la scansione al suo interno. + +I file che si trovano oltre tali confini non sono inclusi nel disco dati e +devono essere configurati separatamente se devono essere protetti. + +16.2 Punti di mount con snapshot del filesystem +----------------------------------------------- + +Quando le snapshot del filesystem sono abilitate, i punti di mount annidati +e i bind mount all'interno di un disco dati non sono supportati. + +I punti di mount fanno parte del namespace di mount del sistema in esecuzione +e non vengono preservati nelle snapshot del filesystem. Di conseguenza, +durante la scansione di una snapshot, una directory nascosta da un punto di +mount nel filesystem live potrebbe diventare visibile. + +Non inserire punti di mount annidati o bind mount all'interno dei dischi dati +quando le snapshot del filesystem sono abilitate. + +16.3 Hard link +-------------- + +SnapRAID identifica un hard link come file originale e rappresenta gli altri +hard link come riferimenti ad esso. Quale link viene selezionato come file +originale dipende dall'ordine in cui vengono scansionate le voci di directory. + +Se questo ordine cambia, ad esempio dopo che i file vengono rinominati, +ripristinati o le directory vengono ricreate, "diff" può segnalare apparenti +spostamenti, aggiornamenti, aggiunte o rimozioni anche quando i file collegati +rappresentano ancora gli stessi dati. + +Ciò non indica corruzione dei dati, ma le differenze segnalate possono +generare confusione e potrebbero non corrispondere direttamente alle +operazioni eseguite sul filesystem. + +16.4 Modifiche ai file sul posto senza variazione di data/ora +------------------------------------------------------------- + +SnapRAID rileva le modifiche ai file confrontando le dimensioni dei file e +i timestamp di modifica (mtime). + +Se un'applicazione modifica un file in-place senza alterarne la dimensione +o aggiornarne il timestamp di modifica, "diff" e "sync" non rileveranno che +il file è cambiato e la sua parità non verrà aggiornata. + +Per garantire che SnapRAID riconosca tali modifiche, aggiornare il timestamp +di modifica del file (ad esempio con l'utilità "touch"). Altrimenti, la +differenza verrà rilevata solo come mancata corrispondenza dell'hash durante +un successivo "scrub" o "check". + + +17 TRADUZIONE (TRANSLATION) =========================== Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. -17 COPYRIGHT +18 COPYRIGHT ============ Questo file è Copyright (C) 2026 Andrea Mazzoleni -18 VEDI ANCHE (SEE ALSO) +19 VEDI ANCHE (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index 0eee14c2..22e4e7e5 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -2110,6 +2110,48 @@ SnapRAIDは以下のエラーコードで終了します： \`diff\` コマンドはすべて正常であると判定しましたが、 \`sync\` が必要です。 .PD .RE +.SH 既知の問題 (KNOWN ISSUES) +.SS ファイルシステムの境界 +SnapRAIDは、データディスクのスキャン中にファイルシステム、マウントポイント、 +またはサブボリュームの境界を越えません。そのような境界が検出された場合、 +SnapRAIDは警告（WARNING）を報告し、その先をスキャンしません。 +.PP +そのような境界の先にあるファイルはデータディスクに含まれないため、保護する +必要がある場合は個別に設定する必要があります。 +.SS ファイルシステムスナップショット使用時のマウントポイント +ファイルシステムスナップショットが有効になっている場合、データディスク内の +ネストされたマウントポイントおよびバインドマウントはサポートされません。 +.PP +マウントポイントは稼働中システムのマウント名前空間の一部であり、ファイルシステムの +スナップショットには保持されません。その結果、スナップショットをスキャンする際、 +稼働中ファイルシステムでマウントポイントによって隠されていたディレクトリが +見えるようになる場合があります。 +.PP +ファイルシステムスナップショットが有効な場合は、データディスク内にネストされた +マウントポイントやバインドマウントを配置しないでください。 +.SS ハードリンク +SnapRAIDは、1つのハードリンクを元のファイルとして識別し、他のハードリンクを +それへの参照として表します。どのリンクが元のファイルとして選択されるかは、 +ディレクトリエントリがスキャンされる順序によって決まります。 +.PP +ファイルの名前変更、復元、またはディレクトリの再作成などによってこの順序が +変化した場合、リンクされたファイルが依然として同じデータを表していても、 +\[dq]diff\[dq] が見かけ上の移動、更新、追加、または削除を報告することがあります。 +.PP +これはデータの破損を示すものではありませんが、報告される差分は混乱を招く +可能性があり、実行されたファイルシステム操作と直接一致しない場合があります。 +.SS タイムスタンプの変更を伴わないインプレースファイル変更 +SnapRAIDは、ファイルサイズと変更タイムスタンプ（mtime）を比較することによって +ファイルの変更を検出します。 +.PP +アプリケーションがファイルサイズを変更せず、変更タイムスタンプも更新せずに +インプレースでファイルを変更した場合、\[dq]diff\[dq] および \[dq]sync\[dq] はファイルが +変更されたことを検出できず、そのパリティは更新されません。 +.PP +SnapRAIDにそのような変更を確実に認識させるには、ファイルの変更タイムスタンプ +を更新してください（たとえば、\[dq]touch\[dq] ユーティリティなどを使用）。そうしない +場合、その差分は後続の \[dq]scrub\[dq] または \[dq]check\[dq] 中のハッシュ不一致としてのみ +検出されます。 .SH 翻訳 (TRANSLATION) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index f3c86d40..756de00e 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1626,6 +1626,52 @@ Name{number} 1 - コマンドでエラーが発生しました。 2 - `diff` コマンドはすべて正常であると判定しましたが、 `sync` が必要です。 +既知の問題 (Known Issues) + ファイルシステムの境界 + SnapRAIDは、データディスクのスキャン中にファイルシステム、マウントポイント、 + またはサブボリュームの境界を越えません。そのような境界が検出された場合、 + SnapRAIDは警告（WARNING）を報告し、その先をスキャンしません。 + + そのような境界の先にあるファイルはデータディスクに含まれないため、保護する + 必要がある場合は個別に設定する必要があります。 + + ファイルシステムスナップショット使用時のマウントポイント + ファイルシステムスナップショットが有効になっている場合、データディスク内の + ネストされたマウントポイントおよびバインドマウントはサポートされません。 + + マウントポイントは稼働中システムのマウント名前空間の一部であり、ファイルシステムの + スナップショットには保持されません。その結果、スナップショットをスキャンする際、 + 稼働中ファイルシステムでマウントポイントによって隠されていたディレクトリが + 見えるようになる場合があります。 + + ファイルシステムスナップショットが有効な場合は、データディスク内にネストされた + マウントポイントやバインドマウントを配置しないでください。 + + ハードリンク + SnapRAIDは、1つのハードリンクを元のファイルとして識別し、他のハードリンクを + それへの参照として表します。どのリンクが元のファイルとして選択されるかは、 + ディレクトリエントリがスキャンされる順序によって決まります。 + + ファイルの名前変更、復元、またはディレクトリの再作成などによってこの順序が + 変化した場合、リンクされたファイルが依然として同じデータを表していても、 + "diff" が見かけ上の移動、更新、追加、または削除を報告することがあります。 + + これはデータの破損を示すものではありませんが、報告される差分は混乱を招く + 可能性があり、実行されたファイルシステム操作と直接一致しない場合があります。 + + タイムスタンプの変更を伴わないインプレースファイル変更 + SnapRAIDは、ファイルサイズと変更タイムスタンプ（mtime）を比較することによって + ファイルの変更を検出します。 + + アプリケーションがファイルサイズを変更せず、変更タイムスタンプも更新せずに + インプレースでファイルを変更した場合、"diff" および "sync" はファイルが + 変更されたことを検出できず、そのパリティは更新されません。 + + SnapRAIDにそのような変更を確実に認識させるには、ファイルの変更タイムスタンプ + を更新してください（たとえば、"touch" ユーティリティなどを使用）。そうしない + 場合、その差分は後続の "scrub" または "check" 中のハッシュ不一致としてのみ + 検出されます。 + 翻訳 (Translation) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 543b8721..96b963d7 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1755,20 +1755,77 @@ SnapRAIDは以下のエラーコードで終了します： 2 - `diff` コマンドはすべて正常であると判定しましたが、 `sync` が必要です。 -16 翻訳 (TRANSLATION) +16 既知の問題 (KNOWN ISSUES) +======================= + +16.1 ファイルシステムの境界 +---------------- + +SnapRAIDは、データディスクのスキャン中にファイルシステム、マウントポイント、 +またはサブボリュームの境界を越えません。そのような境界が検出された場合、 +SnapRAIDは警告（WARNING）を報告し、その先をスキャンしません。 + +そのような境界の先にあるファイルはデータディスクに含まれないため、保護する +必要がある場合は個別に設定する必要があります。 + +16.2 ファイルシステムスナップショット使用時のマウントポイント +--------------------------------- + +ファイルシステムスナップショットが有効になっている場合、データディスク内の +ネストされたマウントポイントおよびバインドマウントはサポートされません。 + +マウントポイントは稼働中システムのマウント名前空間の一部であり、ファイルシステムの +スナップショットには保持されません。その結果、スナップショットをスキャンする際、 +稼働中ファイルシステムでマウントポイントによって隠されていたディレクトリが +見えるようになる場合があります。 + +ファイルシステムスナップショットが有効な場合は、データディスク内にネストされた +マウントポイントやバインドマウントを配置しないでください。 + +16.3 ハードリンク +----------- + +SnapRAIDは、1つのハードリンクを元のファイルとして識別し、他のハードリンクを +それへの参照として表します。どのリンクが元のファイルとして選択されるかは、 +ディレクトリエントリがスキャンされる順序によって決まります。 + +ファイルの名前変更、復元、またはディレクトリの再作成などによってこの順序が +変化した場合、リンクされたファイルが依然として同じデータを表していても、 +"diff" が見かけ上の移動、更新、追加、または削除を報告することがあります。 + +これはデータの破損を示すものではありませんが、報告される差分は混乱を招く +可能性があり、実行されたファイルシステム操作と直接一致しない場合があります。 + +16.4 タイムスタンプの変更を伴わないインプレースファイル変更 +-------------------------------- + +SnapRAIDは、ファイルサイズと変更タイムスタンプ（mtime）を比較することによって +ファイルの変更を検出します。 + +アプリケーションがファイルサイズを変更せず、変更タイムスタンプも更新せずに +インプレースでファイルを変更した場合、"diff" および "sync" はファイルが +変更されたことを検出できず、そのパリティは更新されません。 + +SnapRAIDにそのような変更を確実に認識させるには、ファイルの変更タイムスタンプ +を更新してください（たとえば、"touch" ユーティリティなどを使用）。そうしない +場合、その差分は後続の "scrub" または "check" 中のハッシュ不一致としてのみ +検出されます。 + + +17 翻訳 (TRANSLATION) =================== この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 -17 著作権 (COPYRIGHT) +18 著作権 (COPYRIGHT) ================== This file is Copyright (C) 2026 Andrea Mazzoleni -18 関連項目 (SEE ALSO) +19 関連項目 (SEE ALSO) ================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 86f57dc2..4fec5b92 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -2157,6 +2157,45 @@ SnapRAID는 다음과 같은 오류 코드로 종료됩니다: \`diff\` 명령으로 모두 정상임을 확인했으나 \`sync\`가 필요합니다. .PD .RE +.SH 알려진 문제 (KNOWN ISSUES) +.SS 파일 시스템 경계 +SnapRAID는 데이터 디스크를 스캔하는 동안 파일 시스템, 마운트 또는 서브볼륨 경계를 +넘지 않습니다. 이러한 경계가 감지되면 SnapRAID는 경고(WARNING)를 보고하고 +그 너머를 스캔하지 않습니다. +.PP +이러한 경계 너머에 있는 파일은 데이터 디스크에 포함되지 않으며, 보호해야 하는 경우 +별도로 구성해야 합니다. +.SS 파일 시스템 스냅샷 사용 시 마운트 지점 +파일 시스템 스냅샷이 활성화된 경우, 데이터 디스크 내부의 중첩된 마운트 지점 및 +바인드 마운트는 지원되지 않습니다. +.PP +마운트 지점은 라이브 시스템 마운트 네임스페이스의 일부이며 파일 시스템 스냅샷에 +보존되지 않습니다. 따라서 스냅샷을 스캔할 때 라이브 파일 시스템에서 마운트 지점에 +의해 숨겨졌던 디렉터리가 보일 수 있습니다. +.PP +파일 시스템 스냅샷이 활성화된 경우 데이터 디스크 내에 중첩된 마운트 지점이나 +바인드 마운트를 배치하지 마십시오. +.SS 하드 링크 +SnapRAID는 하나의 하드 링크를 원본 파일로 식별하고 다른 하드 링크를 이에 대한 +참조로 표시합니다. 어떤 링크가 원본 파일로 선택되는지는 디렉터리 항목이 스캔되는 +순서에 따라 달라집니다. +.PP +파일 이름 변경, 복원 또는 디렉터리 재생성 등으로 인해 이 순서가 변경되면, +하드 링크된 파일이 여전히 동일한 데이터를 나타내더라도 \[dq]diff\[dq]에서 겉보기 이동, +업데이트, 추가 또는 제거를 보고할 수 있습니다. +.PP +이는 데이터 손상을 의미하지 않지만, 보고된 차이점이 혼란을 줄 수 있으며 수행된 +파일 시스템 작업과 직접 일치하지 않을 수 있습니다. +.SS 타임스탬프 변경 없는 인플레이스 파일 수정 +SnapRAID는 파일 크기와 수정 타임스탬프(mtime)를 비교하여 파일 수정을 감지합니다. +.PP +애플리케이션이 파일 크기를 변경하지 않고 수정 타임스탬프도 업데이트하지 않은 채 +인플레이스로 파일을 수정하는 경우, \[dq]diff\[dq] 및 \[dq]sync\[dq]는 파일이 변경되었음을 감지하지 +못하며 패리티가 업데이트되지 않습니다. +.PP +SnapRAID가 이러한 변경 사항을 인식하도록 하려면 파일의 수정 타임스탬프를 +업데이트하십시오(예: \[dq]touch\[dq] 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 +\[dq]scrub\[dq] 또는 \[dq]check\[dq] 중에 해시 불일치로만 감지됩니다. .SH 번역 (TRANSLATION) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index a0deee7c..1e16c9c2 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1673,6 +1673,49 @@ Name{number} 1 - 명령 실행 중 오류가 발생했습니다. 2 - `diff` 명령으로 모두 정상임을 확인했으나 `sync`가 필요합니다. +알려진 문제 (Known Issues) + 파일 시스템 경계 + SnapRAID는 데이터 디스크를 스캔하는 동안 파일 시스템, 마운트 또는 서브볼륨 경계를 + 넘지 않습니다. 이러한 경계가 감지되면 SnapRAID는 경고(WARNING)를 보고하고 + 그 너머를 스캔하지 않습니다. + + 이러한 경계 너머에 있는 파일은 데이터 디스크에 포함되지 않으며, 보호해야 하는 경우 + 별도로 구성해야 합니다. + + 파일 시스템 스냅샷 사용 시 마운트 지점 + 파일 시스템 스냅샷이 활성화된 경우, 데이터 디스크 내부의 중첩된 마운트 지점 및 + 바인드 마운트는 지원되지 않습니다. + + 마운트 지점은 라이브 시스템 마운트 네임스페이스의 일부이며 파일 시스템 스냅샷에 + 보존되지 않습니다. 따라서 스냅샷을 스캔할 때 라이브 파일 시스템에서 마운트 지점에 + 의해 숨겨졌던 디렉터리가 보일 수 있습니다. + + 파일 시스템 스냅샷이 활성화된 경우 데이터 디스크 내에 중첩된 마운트 지점이나 + 바인드 마운트를 배치하지 마십시오. + + 하드 링크 + SnapRAID는 하나의 하드 링크를 원본 파일로 식별하고 다른 하드 링크를 이에 대한 + 참조로 표시합니다. 어떤 링크가 원본 파일로 선택되는지는 디렉터리 항목이 스캔되는 + 순서에 따라 달라집니다. + + 파일 이름 변경, 복원 또는 디렉터리 재생성 등으로 인해 이 순서가 변경되면, + 하드 링크된 파일이 여전히 동일한 데이터를 나타내더라도 "diff"에서 겉보기 이동, + 업데이트, 추가 또는 제거를 보고할 수 있습니다. + + 이는 데이터 손상을 의미하지 않지만, 보고된 차이점이 혼란을 줄 수 있으며 수행된 + 파일 시스템 작업과 직접 일치하지 않을 수 있습니다. + + 타임스탬프 변경 없는 인플레이스 파일 수정 + SnapRAID는 파일 크기와 수정 타임스탬프(mtime)를 비교하여 파일 수정을 감지합니다. + + 애플리케이션이 파일 크기를 변경하지 않고 수정 타임스탬프도 업데이트하지 않은 채 + 인플레이스로 파일을 수정하는 경우, "diff" 및 "sync"는 파일이 변경되었음을 감지하지 + 못하며 패리티가 업데이트되지 않습니다. + + SnapRAID가 이러한 변경 사항을 인식하도록 하려면 파일의 수정 타임스탬프를 + 업데이트하십시오(예: "touch" 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 + "scrub" 또는 "check" 중에 해시 불일치로만 감지됩니다. + 번역 (Translation) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index fac8be2e..d2cc419e 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1802,20 +1802,74 @@ SnapRAID는 다음과 같은 오류 코드로 종료됩니다: 2 - `diff` 명령으로 모두 정상임을 확인했으나 `sync`가 필요합니다. -16 번역 (TRANSLATION) +16 알려진 문제 (KNOWN ISSUES) +======================== + +16.1 파일 시스템 경계 +-------------- + +SnapRAID는 데이터 디스크를 스캔하는 동안 파일 시스템, 마운트 또는 서브볼륨 경계를 +넘지 않습니다. 이러한 경계가 감지되면 SnapRAID는 경고(WARNING)를 보고하고 +그 너머를 스캔하지 않습니다. + +이러한 경계 너머에 있는 파일은 데이터 디스크에 포함되지 않으며, 보호해야 하는 경우 +별도로 구성해야 합니다. + +16.2 파일 시스템 스냅샷 사용 시 마운트 지점 +--------------------------- + +파일 시스템 스냅샷이 활성화된 경우, 데이터 디스크 내부의 중첩된 마운트 지점 및 +바인드 마운트는 지원되지 않습니다. + +마운트 지점은 라이브 시스템 마운트 네임스페이스의 일부이며 파일 시스템 스냅샷에 +보존되지 않습니다. 따라서 스냅샷을 스캔할 때 라이브 파일 시스템에서 마운트 지점에 +의해 숨겨졌던 디렉터리가 보일 수 있습니다. + +파일 시스템 스냅샷이 활성화된 경우 데이터 디스크 내에 중첩된 마운트 지점이나 +바인드 마운트를 배치하지 마십시오. + +16.3 하드 링크 +---------- + +SnapRAID는 하나의 하드 링크를 원본 파일로 식별하고 다른 하드 링크를 이에 대한 +참조로 표시합니다. 어떤 링크가 원본 파일로 선택되는지는 디렉터리 항목이 스캔되는 +순서에 따라 달라집니다. + +파일 이름 변경, 복원 또는 디렉터리 재생성 등으로 인해 이 순서가 변경되면, +하드 링크된 파일이 여전히 동일한 데이터를 나타내더라도 "diff"에서 겉보기 이동, +업데이트, 추가 또는 제거를 보고할 수 있습니다. + +이는 데이터 손상을 의미하지 않지만, 보고된 차이점이 혼란을 줄 수 있으며 수행된 +파일 시스템 작업과 직접 일치하지 않을 수 있습니다. + +16.4 타임스탬프 변경 없는 인플레이스 파일 수정 +---------------------------- + +SnapRAID는 파일 크기와 수정 타임스탬프(mtime)를 비교하여 파일 수정을 감지합니다. + +애플리케이션이 파일 크기를 변경하지 않고 수정 타임스탬프도 업데이트하지 않은 채 +인플레이스로 파일을 수정하는 경우, "diff" 및 "sync"는 파일이 변경되었음을 감지하지 +못하며 패리티가 업데이트되지 않습니다. + +SnapRAID가 이러한 변경 사항을 인식하도록 하려면 파일의 수정 타임스탬프를 +업데이트하십시오(예: "touch" 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 +"scrub" 또는 "check" 중에 해시 불일치로만 감지됩니다. + + +17 번역 (TRANSLATION) =================== 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. -17 저작권 (COPYRIGHT) +18 저작권 (COPYRIGHT) ================== This file is Copyright (C) 2026 Andrea Mazzoleni -18 참고 (SEE ALSO) +19 참고 (SEE ALSO) ================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 884e0446..cd1e776e 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -2239,6 +2239,50 @@ Polecenie napotkało błędy. Polecenie \`diff\` wykazało, że wszystko jest w porządku, ale wymagane jest \`sync\`. .PD .RE +.SH ZNANE PROBLEMY (KNOWN ISSUES) +.SS Granice systemu plików +SnapRAID nie przekracza granic systemów plików, punktów montowania ani +podwolumenów podczas skanowania dysku z danymi. Po wykryciu takiej granicy +SnapRAID zgłasza OSTRZEŻENIE i nie skanuje dalej. +.PP +Pliki znajdujące się poza takimi granicami nie są uwzględniane na dysku +z danymi i muszą zostać skonfigurowane oddzielnie, jeśli mają być chronione. +.SS Punkty montowania z migawkami systemu plików +Gdy migawki systemu plików są włączone, zagnieżdżone punkty montowania oraz +montowania bind wewnątrz dysku z danymi nie są obsługiwane. +.PP +Punkty montowania są częścią przestrzeni nazw montowania działającego +systemu i nie są zachowywane w migawkach systemu plików. W związku z tym +podczas skanowania migawki katalog ukryty przez punkt montowania w aktywnym +systemie plików może stać się widoczny. +.PP +Nie umieszczaj zagnieżdżonych punktów montowania ani montowań bind wewnątrz +dysków z danymi, gdy migawki systemu plików są włączone. +.SS Twarde dowiązania (Hard links) +SnapRAID identyfikuje jedno twarde dowiązanie jako plik oryginalny, a +pozostałe twarde dowiązania reprezentuje jako odwołania do niego. To, które +dowiązanie zostanie wybrane jako plik oryginalny, zależy od kolejności +skanowania wpisów w katalogu. +.PP +Jeśli ta kolejność ulegnie zmianie, na przykład po zmianie nazwy, +przywróceniu plików lub ponownym utworzeniu katalogów, polecenie \[dq]diff\[dq] +może zgłaszać pozorne przeniesienia, aktualizacje, dodania lub usunięcia, +nawet jeśli dowiązane pliki nadal reprezentują te same dane. +.PP +Nie oznacza to uszkodzenia danych, ale zgłaszane różnice mogą być mylące i +mogą nie odpowiadać bezpośrednio operacjom wykonanym w systemie plików. +.SS Modyfikacje plików w miejscu bez zmiany znacznika czasu +SnapRAID wykrywa modyfikacje plików, porównując rozmiary plików oraz +znaczniki czasu modyfikacji (mtime). +.PP +Jeśli aplikacja modyfikuje plik w miejscu bez zmiany jego rozmiaru ani +aktualizacji znacznika czasu modyfikacji, polecenia \[dq]diff\[dq] i \[dq]sync\[dq] nie +wykryją zmiany pliku, a jego parzystość nie zostanie zaktualizowana. +.PP +Aby SnapRAID rozpoznał takie zmiany, zaktualizuj znacznik czasu modyfikacji +pliku (na przykład za pomocą narzędzia \[dq]touch\[dq]). W przeciwnym razie różnica +zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego \[dq]scrub\[dq] +lub \[dq]check\[dq]. .SH TłUMACZENIE (TRANSLATION) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index de01efa7..e18263d0 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1755,6 +1755,54 @@ Kod wyjścia (Exit Code) 1 - Polecenie napotkało błędy. 2 - Polecenie `diff` wykazało, że wszystko jest w porządku, ale wymagane jest `sync`. +Znane problemy (Known Issues) + Granice systemu plików + SnapRAID nie przekracza granic systemów plików, punktów montowania ani + podwolumenów podczas skanowania dysku z danymi. Po wykryciu takiej granicy + SnapRAID zgłasza OSTRZEŻENIE i nie skanuje dalej. + + Pliki znajdujące się poza takimi granicami nie są uwzględniane na dysku + z danymi i muszą zostać skonfigurowane oddzielnie, jeśli mają być chronione. + + Punkty montowania z migawkami systemu plików + Gdy migawki systemu plików są włączone, zagnieżdżone punkty montowania oraz + montowania bind wewnątrz dysku z danymi nie są obsługiwane. + + Punkty montowania są częścią przestrzeni nazw montowania działającego + systemu i nie są zachowywane w migawkach systemu plików. W związku z tym + podczas skanowania migawki katalog ukryty przez punkt montowania w aktywnym + systemie plików może stać się widoczny. + + Nie umieszczaj zagnieżdżonych punktów montowania ani montowań bind wewnątrz + dysków z danymi, gdy migawki systemu plików są włączone. + + Twarde dowiązania (Hard links) + SnapRAID identyfikuje jedno twarde dowiązanie jako plik oryginalny, a + pozostałe twarde dowiązania reprezentuje jako odwołania do niego. To, które + dowiązanie zostanie wybrane jako plik oryginalny, zależy od kolejności + skanowania wpisów w katalogu. + + Jeśli ta kolejność ulegnie zmianie, na przykład po zmianie nazwy, + przywróceniu plików lub ponownym utworzeniu katalogów, polecenie "diff" + może zgłaszać pozorne przeniesienia, aktualizacje, dodania lub usunięcia, + nawet jeśli dowiązane pliki nadal reprezentują te same dane. + + Nie oznacza to uszkodzenia danych, ale zgłaszane różnice mogą być mylące i + mogą nie odpowiadać bezpośrednio operacjom wykonanym w systemie plików. + + Modyfikacje plików w miejscu bez zmiany znacznika czasu + SnapRAID wykrywa modyfikacje plików, porównując rozmiary plików oraz + znaczniki czasu modyfikacji (mtime). + + Jeśli aplikacja modyfikuje plik w miejscu bez zmiany jego rozmiaru ani + aktualizacji znacznika czasu modyfikacji, polecenia "diff" i "sync" nie + wykryją zmiany pliku, a jego parzystość nie zostanie zaktualizowana. + + Aby SnapRAID rozpoznał takie zmiany, zaktualizuj znacznik czasu modyfikacji + pliku (na przykład za pomocą narzędzia "touch"). W przeciwnym razie różnica + zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego "scrub" + lub "check". + Tłumaczenie (Translation) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 0b19fc28..af9bd695 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1884,20 +1884,79 @@ SnapRAID kończy działanie z następującymi kodami błędów: 2 - Polecenie `diff` wykazało, że wszystko jest w porządku, ale wymagane jest `sync`. -16 TłUMACZENIE (TRANSLATION) +16 ZNANE PROBLEMY (KNOWN ISSUES) +================================ + +16.1 Granice systemu plików +--------------------------- + +SnapRAID nie przekracza granic systemów plików, punktów montowania ani +podwolumenów podczas skanowania dysku z danymi. Po wykryciu takiej granicy +SnapRAID zgłasza OSTRZEŻENIE i nie skanuje dalej. + +Pliki znajdujące się poza takimi granicami nie są uwzględniane na dysku +z danymi i muszą zostać skonfigurowane oddzielnie, jeśli mają być chronione. + +16.2 Punkty montowania z migawkami systemu plików +------------------------------------------------- + +Gdy migawki systemu plików są włączone, zagnieżdżone punkty montowania oraz +montowania bind wewnątrz dysku z danymi nie są obsługiwane. + +Punkty montowania są częścią przestrzeni nazw montowania działającego +systemu i nie są zachowywane w migawkach systemu plików. W związku z tym +podczas skanowania migawki katalog ukryty przez punkt montowania w aktywnym +systemie plików może stać się widoczny. + +Nie umieszczaj zagnieżdżonych punktów montowania ani montowań bind wewnątrz +dysków z danymi, gdy migawki systemu plików są włączone. + +16.3 Twarde dowiązania (Hard links) +----------------------------------- + +SnapRAID identyfikuje jedno twarde dowiązanie jako plik oryginalny, a +pozostałe twarde dowiązania reprezentuje jako odwołania do niego. To, które +dowiązanie zostanie wybrane jako plik oryginalny, zależy od kolejności +skanowania wpisów w katalogu. + +Jeśli ta kolejność ulegnie zmianie, na przykład po zmianie nazwy, +przywróceniu plików lub ponownym utworzeniu katalogów, polecenie "diff" +może zgłaszać pozorne przeniesienia, aktualizacje, dodania lub usunięcia, +nawet jeśli dowiązane pliki nadal reprezentują te same dane. + +Nie oznacza to uszkodzenia danych, ale zgłaszane różnice mogą być mylące i +mogą nie odpowiadać bezpośrednio operacjom wykonanym w systemie plików. + +16.4 Modyfikacje plików w miejscu bez zmiany znacznika czasu +------------------------------------------------------------ + +SnapRAID wykrywa modyfikacje plików, porównując rozmiary plików oraz +znaczniki czasu modyfikacji (mtime). + +Jeśli aplikacja modyfikuje plik w miejscu bez zmiany jego rozmiaru ani +aktualizacji znacznika czasu modyfikacji, polecenia "diff" i "sync" nie +wykryją zmiany pliku, a jego parzystość nie zostanie zaktualizowana. + +Aby SnapRAID rozpoznał takie zmiany, zaktualizuj znacznik czasu modyfikacji +pliku (na przykład za pomocą narzędzia "touch"). W przeciwnym razie różnica +zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego "scrub" +lub "check". + + +17 TłUMACZENIE (TRANSLATION) ============================ Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. -17 PRAWA AUTORSKIE (COPYRIGHT) +18 PRAWA AUTORSKIE (COPYRIGHT) ============================== Ten plik jest chroniony prawem autorskim (C) 2026 Andrea Mazzoleni -18 ZOBACZ RóWNIEż (SEE ALSO) +19 ZOBACZ RóWNIEż (SEE ALSO) ============================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index 47a709bc..ea985ceb 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -2275,6 +2275,52 @@ O comando encontrou alguns erros. O comando \`diff\` determinou que tudo está OK, mas é necessário um \`sync\`. .PD .RE +.SH PROBLEMAS CONHECIDOS (KNOWN ISSUES) +.SS Limites do sistema de arquivos +O SnapRAID não cruza limites de sistema de arquivos, pontos de montagem ou +subvolumes ao verificar um disco de dados. Quando tal limite é detectado, +o SnapRAID relata um AVISO e não verifica além dele. +.PP +Arquivos localizados além desses limites não são incluídos no disco de +dados e devem ser configurados separadamente se precisarem ser protegidos. +.SS Pontos de montagem com instantâneos do sistema de arquivos +Quando os instantâneos do sistema de arquivos estão ativados, pontos de +montagem aninhados e montagens bind dentro de um disco de dados não são +suportados. +.PP +Os pontos de montagem fazem parte do namespace de montagem do sistema ativo +e não são preservados em instantâneos do sistema de arquivos. Consequentemente, +ao verificar um instantâneo, um diretório oculto por um ponto de montagem no +sistema de arquivos ativo pode se tornar visível. +.PP +Não coloque pontos de montagem aninhados ou montagens bind dentro de discos +de dados quando os instantâneos do sistema de arquivos estiverem ativados. +.SS Links físicos (Hard links) +O SnapRAID identifica um link físico como o arquivo original e representa +os outros links físicos como referências a ele. Qual link é selecionado +como o arquivo original depende da ordem em que as entradas do diretório +são verificadas. +.PP +Se essa ordem mudar, por exemplo, após arquivos serem renomeados, +restaurados ou diretórios serem recriados, o \[dq]diff\[dq] poderá relatar aparentes +movimentações, atualizações, adições ou remoções, mesmo quando os arquivos +vinculados ainda representarem os mesmos dados. +.PP +Isso não indica corrupção de dados, mas as diferenças relatadas podem ser +confusas e podem não corresponder diretamente às operações executadas no +sistema de arquivos. +.SS Modificações de arquivo no local sem alteração de data/hora +O SnapRAID detecta modificações em arquivos comparando tamanhos de arquivo e +carimbos de data/hora de modificação (mtime). +.PP +Se um aplicativo modificar um arquivo no local sem alterar seu tamanho nem +atualizar seu carimbo de data/hora de modificação, o \[dq]diff\[dq] e o \[dq]sync\[dq] não +detectarão que o arquivo foi alterado e sua paridade não será atualizada. +.PP +Para garantir que o SnapRAID reconheça essas alterações, atualize o carimbo +de data/hora de modificação do arquivo (por exemplo, com o utilitário \[dq]touch\[dq]). +Caso contrário, a diferença só será detectada como uma incompatibilidade de +hash durante um \[dq]scrub\[dq] ou \[dq]check\[dq] subsequente. .SH TRADUçãO (TRANSLATION) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index 1d60d906..fb7c3f1d 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1791,6 +1791,56 @@ Código de Saída (Exit Code) 1 - O comando encontrou alguns erros. 2 - O comando `diff` determinou que tudo está OK, mas é necessário um `sync`. +Problemas Conhecidos (Known Issues) + Limites do sistema de arquivos + O SnapRAID não cruza limites de sistema de arquivos, pontos de montagem ou + subvolumes ao verificar um disco de dados. Quando tal limite é detectado, + o SnapRAID relata um AVISO e não verifica além dele. + + Arquivos localizados além desses limites não são incluídos no disco de + dados e devem ser configurados separadamente se precisarem ser protegidos. + + Pontos de montagem com instantâneos do sistema de arquivos + Quando os instantâneos do sistema de arquivos estão ativados, pontos de + montagem aninhados e montagens bind dentro de um disco de dados não são + suportados. + + Os pontos de montagem fazem parte do namespace de montagem do sistema ativo + e não são preservados em instantâneos do sistema de arquivos. Consequentemente, + ao verificar um instantâneo, um diretório oculto por um ponto de montagem no + sistema de arquivos ativo pode se tornar visível. + + Não coloque pontos de montagem aninhados ou montagens bind dentro de discos + de dados quando os instantâneos do sistema de arquivos estiverem ativados. + + Links físicos (Hard links) + O SnapRAID identifica um link físico como o arquivo original e representa + os outros links físicos como referências a ele. Qual link é selecionado + como o arquivo original depende da ordem em que as entradas do diretório + são verificadas. + + Se essa ordem mudar, por exemplo, após arquivos serem renomeados, + restaurados ou diretórios serem recriados, o "diff" poderá relatar aparentes + movimentações, atualizações, adições ou remoções, mesmo quando os arquivos + vinculados ainda representarem os mesmos dados. + + Isso não indica corrupção de dados, mas as diferenças relatadas podem ser + confusas e podem não corresponder diretamente às operações executadas no + sistema de arquivos. + + Modificações de arquivo no local sem alteração de data/hora + O SnapRAID detecta modificações em arquivos comparando tamanhos de arquivo e + carimbos de data/hora de modificação (mtime). + + Se um aplicativo modificar um arquivo no local sem alterar seu tamanho nem + atualizar seu carimbo de data/hora de modificação, o "diff" e o "sync" não + detectarão que o arquivo foi alterado e sua paridade não será atualizada. + + Para garantir que o SnapRAID reconheça essas alterações, atualize o carimbo + de data/hora de modificação do arquivo (por exemplo, com o utilitário "touch"). + Caso contrário, a diferença só será detectada como uma incompatibilidade de + hash durante um "scrub" ou "check" subsequente. + Tradução (Translation) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index 2f2463b1..38bee717 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -1920,20 +1920,81 @@ O SnapRAID termina com os seguintes códigos de erro: 2 - O comando `diff` determinou que tudo está OK, mas é necessário um `sync`. -16 TRADUçãO (TRANSLATION) +16 PROBLEMAS CONHECIDOS (KNOWN ISSUES) +====================================== + +16.1 Limites do sistema de arquivos +----------------------------------- + +O SnapRAID não cruza limites de sistema de arquivos, pontos de montagem ou +subvolumes ao verificar um disco de dados. Quando tal limite é detectado, +o SnapRAID relata um AVISO e não verifica além dele. + +Arquivos localizados além desses limites não são incluídos no disco de +dados e devem ser configurados separadamente se precisarem ser protegidos. + +16.2 Pontos de montagem com instantâneos do sistema de arquivos +--------------------------------------------------------------- + +Quando os instantâneos do sistema de arquivos estão ativados, pontos de +montagem aninhados e montagens bind dentro de um disco de dados não são +suportados. + +Os pontos de montagem fazem parte do namespace de montagem do sistema ativo +e não são preservados em instantâneos do sistema de arquivos. Consequentemente, +ao verificar um instantâneo, um diretório oculto por um ponto de montagem no +sistema de arquivos ativo pode se tornar visível. + +Não coloque pontos de montagem aninhados ou montagens bind dentro de discos +de dados quando os instantâneos do sistema de arquivos estiverem ativados. + +16.3 Links físicos (Hard links) +------------------------------- + +O SnapRAID identifica um link físico como o arquivo original e representa +os outros links físicos como referências a ele. Qual link é selecionado +como o arquivo original depende da ordem em que as entradas do diretório +são verificadas. + +Se essa ordem mudar, por exemplo, após arquivos serem renomeados, +restaurados ou diretórios serem recriados, o "diff" poderá relatar aparentes +movimentações, atualizações, adições ou remoções, mesmo quando os arquivos +vinculados ainda representarem os mesmos dados. + +Isso não indica corrupção de dados, mas as diferenças relatadas podem ser +confusas e podem não corresponder diretamente às operações executadas no +sistema de arquivos. + +16.4 Modificações de arquivo no local sem alteração de data/hora +---------------------------------------------------------------- + +O SnapRAID detecta modificações em arquivos comparando tamanhos de arquivo e +carimbos de data/hora de modificação (mtime). + +Se um aplicativo modificar um arquivo no local sem alterar seu tamanho nem +atualizar seu carimbo de data/hora de modificação, o "diff" e o "sync" não +detectarão que o arquivo foi alterado e sua paridade não será atualizada. + +Para garantir que o SnapRAID reconheça essas alterações, atualize o carimbo +de data/hora de modificação do arquivo (por exemplo, com o utilitário "touch"). +Caso contrário, a diferença só será detectada como uma incompatibilidade de +hash durante um "scrub" ou "check" subsequente. + + +17 TRADUçãO (TRANSLATION) ========================= Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. -17 DIREITOS AUTORAIS (COPYRIGHT) +18 DIREITOS AUTORAIS (COPYRIGHT) ================================ Este arquivo é Copyright (C) 2026 Andrea Mazzoleni -18 VEJA TAMBéM (SEE ALSO) +19 VEJA TAMBéM (SEE ALSO) ========================= snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 4d4458fe..19a3c68e 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -2235,6 +2235,51 @@ Comanda a întâmpinat unele erori. Comanda \`diff\` a constatat că totul este OK, dar este necesar un \`sync\`. .PD .RE +.SH PROBLEME CUNOSCUTE (KNOWN ISSUES) +.SS Limitele sistemului de fișiere +SnapRAID nu traversează limitele sistemului de fișiere, punctelor de montare +sau subvolumelor în timpul scanării unui disc de date. Când este detectată +o astfel de limită, SnapRAID raportează un AVERTISMENT și nu scanează dincolo de ea. +.PP +Fișierele situate dincolo de aceste limite nu sunt incluse pe discul de date +și trebuie configurate separat dacă trebuie protejate. +.SS Puncte de montare cu instantanee ale sistemului de fișiere +Când instantanee ale sistemului de fișiere sunt activate, punctele de montare +imbricate și montările bind din interiorul unui disc de date nu sunt acceptate. +.PP +Punctele de montare fac parte din spațiul de nume de montare al sistemului +activ și nu sunt păstrate în instantaneele sistemului de fișiere. În consecință, +la scanarea unui instantaneu, un director ascuns de un punct de montare în +sistemul de fișiere activ poate deveni vizibil. +.PP +Nu plasați puncte de montare imbricate sau montări bind în interiorul discurilor +de date când instantaneele sistemului de fișiere sunt activate. +.SS Legături dure (Hard links) +SnapRAID identifică o legătură dură ca fișier original și reprezintă celelalte +legături dure ca referințe la acesta. Care legătură este selectată ca fișier +original depinde de ordinea în care sunt scanate intrările din director. +.PP +Dacă această ordine se modifică, de exemplu după redenumirea, restaurarea +fișierelor sau recrearea directoarelor, \[dq]diff\[dq] poate raporta mutări, +actualizări, adăugiri sau eliminări aparente chiar și atunci când fișierele +legate reprezintă în continuare aceleași date. +.PP +Acest lucru nu indică coruperea datelor, dar diferențele raportate pot fi +confuze și s\-ar putea să nu corespundă direct operațiunilor efectuate în +sistemul de fișiere. +.SS Modificări ale fișierelor pe loc fără schimbarea marcajului temporal +SnapRAID detectează modificările fișierelor comparând dimensiunile fișierelor +și marcajele temporale de modificare (mtime). +.PP +Dacă o aplicație modifică un fișier pe loc fără a\-i modifica dimensiunea +și fără a\-i actualiza marcajul temporal de modificare, \[dq]diff\[dq] și \[dq]sync\[dq] nu +vor detecta că fișierul s\-a modificat, iar paritatea acestuia nu va fi +actualizată. +.PP +Pentru a vă asigura că SnapRAID recunoaște astfel de modificări, actualizați +marcajul temporal de modificare al fișierului (de exemplu, cu utilitarul +\[dq]touch\[dq]). În caz contrar, diferența va fi detectată doar ca o neconcordanță +de hash în timpul unui \[dq]scrub\[dq] sau \[dq]check\[dq] ulterior. .SH TRADUCERE (TRANSLATION) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index 723adda7..e56721b9 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1751,6 +1751,55 @@ Cod de ieșire (Exit Code) 1 - Comanda a întâmpinat unele erori. 2 - Comanda `diff` a constatat că totul este OK, dar este necesar un `sync`. +Probleme Cunoscute (Known Issues) + Limitele sistemului de fișiere + SnapRAID nu traversează limitele sistemului de fișiere, punctelor de montare + sau subvolumelor în timpul scanării unui disc de date. Când este detectată + o astfel de limită, SnapRAID raportează un AVERTISMENT și nu scanează dincolo de ea. + + Fișierele situate dincolo de aceste limite nu sunt incluse pe discul de date + și trebuie configurate separat dacă trebuie protejate. + + Puncte de montare cu instantanee ale sistemului de fișiere + Când instantanee ale sistemului de fișiere sunt activate, punctele de montare + imbricate și montările bind din interiorul unui disc de date nu sunt acceptate. + + Punctele de montare fac parte din spațiul de nume de montare al sistemului + activ și nu sunt păstrate în instantaneele sistemului de fișiere. În consecință, + la scanarea unui instantaneu, un director ascuns de un punct de montare în + sistemul de fișiere activ poate deveni vizibil. + + Nu plasați puncte de montare imbricate sau montări bind în interiorul discurilor + de date când instantaneele sistemului de fișiere sunt activate. + + Legături dure (Hard links) + SnapRAID identifică o legătură dură ca fișier original și reprezintă celelalte + legături dure ca referințe la acesta. Care legătură este selectată ca fișier + original depinde de ordinea în care sunt scanate intrările din director. + + Dacă această ordine se modifică, de exemplu după redenumirea, restaurarea + fișierelor sau recrearea directoarelor, "diff" poate raporta mutări, + actualizări, adăugiri sau eliminări aparente chiar și atunci când fișierele + legate reprezintă în continuare aceleași date. + + Acest lucru nu indică coruperea datelor, dar diferențele raportate pot fi + confuze și s-ar putea să nu corespundă direct operațiunilor efectuate în + sistemul de fișiere. + + Modificări ale fișierelor pe loc fără schimbarea marcajului temporal + SnapRAID detectează modificările fișierelor comparând dimensiunile fișierelor + și marcajele temporale de modificare (mtime). + + Dacă o aplicație modifică un fișier pe loc fără a-i modifica dimensiunea + și fără a-i actualiza marcajul temporal de modificare, "diff" și "sync" nu + vor detecta că fișierul s-a modificat, iar paritatea acestuia nu va fi + actualizată. + + Pentru a vă asigura că SnapRAID recunoaște astfel de modificări, actualizați + marcajul temporal de modificare al fișierului (de exemplu, cu utilitarul + "touch"). În caz contrar, diferența va fi detectată doar ca o neconcordanță + de hash în timpul unui "scrub" sau "check" ulterior. + Traducere (Translation) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 5a6225a8..00bb0574 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -1880,20 +1880,80 @@ SnapRAID se termină cu următoarele coduri de eroare: 2 - Comanda `diff` a constatat că totul este OK, dar este necesar un `sync`. -16 TRADUCERE (TRANSLATION) +16 PROBLEME CUNOSCUTE (KNOWN ISSUES) +==================================== + +16.1 Limitele sistemului de fișiere +----------------------------------- + +SnapRAID nu traversează limitele sistemului de fișiere, punctelor de montare +sau subvolumelor în timpul scanării unui disc de date. Când este detectată +o astfel de limită, SnapRAID raportează un AVERTISMENT și nu scanează dincolo de ea. + +Fișierele situate dincolo de aceste limite nu sunt incluse pe discul de date +și trebuie configurate separat dacă trebuie protejate. + +16.2 Puncte de montare cu instantanee ale sistemului de fișiere +--------------------------------------------------------------- + +Când instantanee ale sistemului de fișiere sunt activate, punctele de montare +imbricate și montările bind din interiorul unui disc de date nu sunt acceptate. + +Punctele de montare fac parte din spațiul de nume de montare al sistemului +activ și nu sunt păstrate în instantaneele sistemului de fișiere. În consecință, +la scanarea unui instantaneu, un director ascuns de un punct de montare în +sistemul de fișiere activ poate deveni vizibil. + +Nu plasați puncte de montare imbricate sau montări bind în interiorul discurilor +de date când instantaneele sistemului de fișiere sunt activate. + +16.3 Legături dure (Hard links) +------------------------------- + +SnapRAID identifică o legătură dură ca fișier original și reprezintă celelalte +legături dure ca referințe la acesta. Care legătură este selectată ca fișier +original depinde de ordinea în care sunt scanate intrările din director. + +Dacă această ordine se modifică, de exemplu după redenumirea, restaurarea +fișierelor sau recrearea directoarelor, "diff" poate raporta mutări, +actualizări, adăugiri sau eliminări aparente chiar și atunci când fișierele +legate reprezintă în continuare aceleași date. + +Acest lucru nu indică coruperea datelor, dar diferențele raportate pot fi +confuze și s-ar putea să nu corespundă direct operațiunilor efectuate în +sistemul de fișiere. + +16.4 Modificări ale fișierelor pe loc fără schimbarea marcajului temporal +------------------------------------------------------------------------- + +SnapRAID detectează modificările fișierelor comparând dimensiunile fișierelor +și marcajele temporale de modificare (mtime). + +Dacă o aplicație modifică un fișier pe loc fără a-i modifica dimensiunea +și fără a-i actualiza marcajul temporal de modificare, "diff" și "sync" nu +vor detecta că fișierul s-a modificat, iar paritatea acestuia nu va fi +actualizată. + +Pentru a vă asigura că SnapRAID recunoaște astfel de modificări, actualizați +marcajul temporal de modificare al fișierului (de exemplu, cu utilitarul +"touch"). În caz contrar, diferența va fi detectată doar ca o neconcordanță +de hash în timpul unui "scrub" sau "check" ulterior. + + +17 TRADUCERE (TRANSLATION) ========================== Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. -17 DREPT DE AUTOR (COPYRIGHT) +18 DREPT DE AUTOR (COPYRIGHT) ============================= Acest fișier este Copyright (C) 2026 Andrea Mazzoleni -18 VEZI șI (SEE ALSO) +19 VEZI șI (SEE ALSO) ===================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 17e8c810..46aea19a 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -2240,6 +2240,50 @@ SnapRAID завершает работу со следующими кодами Команда \`diff\` определила, что все в порядке, но требуется \`sync\`. .PD .RE +.SH Известные проблемы (KNOWN ISSUES) +.SS Границы файловой системы +SnapRAID не пересекает границы файловых систем, точек монтирования или +подтомов при сканировании диска данных. При обнаружении такой границы +SnapRAID сообщает ПРЕДУПРЕЖДЕНИЕ и не выполняет сканирование за ее пределами. +.PP +Файлы, расположенные за такими границами, не включаются в диск данных и +должны настраиваться отдельно, если их необходимо защитить. +.SS Точки монтирования со снимками файловой системы +Когда снимки файловой системы включены, вложенные точки монтирования и +bind\-монтирования внутри диска данных не поддерживаются. +.PP +Точки монтирования являются частью пространства имен монтирования работающей +системы и не сохраняются в снимках файловой системы. Следовательно, при +сканировании снимка каталог, скрытый точкой монтирования в активной файловой +системе, может стать видимым. +.PP +Не размещайте вложенные точки монтирования или bind\-монтирования внутри дисков +данных, когда включены снимки файловой системы. +.SS Жесткие ссылки (Hard links) +SnapRAID определяет одну жесткую ссылку как исходный файл и представляет +другие жесткие ссылки как ссылки на него. Какая ссылка выбирается в качестве +исходного файла, зависит от порядка сканирования записей каталога. +.PP +Если этот порядок изменяется, например, после переименования, восстановления +файлов или повторного создания каталогов, команда \[dq]diff\[dq] может сообщать о +видимых перемещениях, обновлениях, добавлениях или удалениях, даже когда +связанные файлы по\-прежнему представляют те же данные. +.PP +Это не указывает на повреждение данных, но сообщаемые различия могут сбивать +с толку и могут не соответствовать напрямую операциям, выполненным в файловой +системе. +.SS Изменения файлов на месте без изменения временных меток +SnapRAID обнаруживает изменения файлов путем сравнения размеров файлов и +временных меток модификации (mtime). +.PP +Если приложение изменяет файл на месте без изменения его размера или +обновления временной метки модификации, \[dq]diff\[dq] и \[dq]sync\[dq] не обнаружат +изменение файла, и его четность не будет обновлена. +.PP +Чтобы SnapRAID гарантированно распознал такие изменения, обновите временную +метку модификации файла (например, с помощью утилиты \[dq]touch\[dq]). В противном +случае различие будет обнаружено только как несоответствие хэша во время +последующего \[dq]scrub\[dq] или \[dq]check\[dq]. .SH Перевод (TRANSLATION) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index a5d454ee..8f92a4ef 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1758,6 +1758,54 @@ Name{number} 1 - Команда обнаружила ошибки. 2 - Команда `diff` определила, что все в порядке, но требуется `sync`. +Известные проблемы (Known Issues) + Границы файловой системы + SnapRAID не пересекает границы файловых систем, точек монтирования или + подтомов при сканировании диска данных. При обнаружении такой границы + SnapRAID сообщает ПРЕДУПРЕЖДЕНИЕ и не выполняет сканирование за ее пределами. + + Файлы, расположенные за такими границами, не включаются в диск данных и + должны настраиваться отдельно, если их необходимо защитить. + + Точки монтирования со снимками файловой системы + Когда снимки файловой системы включены, вложенные точки монтирования и + bind-монтирования внутри диска данных не поддерживаются. + + Точки монтирования являются частью пространства имен монтирования работающей + системы и не сохраняются в снимках файловой системы. Следовательно, при + сканировании снимка каталог, скрытый точкой монтирования в активной файловой + системе, может стать видимым. + + Не размещайте вложенные точки монтирования или bind-монтирования внутри дисков + данных, когда включены снимки файловой системы. + + Жесткие ссылки (Hard links) + SnapRAID определяет одну жесткую ссылку как исходный файл и представляет + другие жесткие ссылки как ссылки на него. Какая ссылка выбирается в качестве + исходного файла, зависит от порядка сканирования записей каталога. + + Если этот порядок изменяется, например, после переименования, восстановления + файлов или повторного создания каталогов, команда "diff" может сообщать о + видимых перемещениях, обновлениях, добавлениях или удалениях, даже когда + связанные файлы по-прежнему представляют те же данные. + + Это не указывает на повреждение данных, но сообщаемые различия могут сбивать + с толку и могут не соответствовать напрямую операциям, выполненным в файловой + системе. + + Изменения файлов на месте без изменения временных меток + SnapRAID обнаруживает изменения файлов путем сравнения размеров файлов и + временных меток модификации (mtime). + + Если приложение изменяет файл на месте без изменения его размера или + обновления временной метки модификации, "diff" и "sync" не обнаружат + изменение файла, и его четность не будет обновлена. + + Чтобы SnapRAID гарантированно распознал такие изменения, обновите временную + метку модификации файла (например, с помощью утилиты "touch"). В противном + случае различие будет обнаружено только как несоответствие хэша во время + последующего "scrub" или "check". + Перевод (Translation) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index 952231f5..366ce581 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -1887,20 +1887,79 @@ SnapRAID завершает работу со следующими кодами 2 - Команда `diff` определила, что все в порядке, но требуется `sync`. -16 Перевод (TRANSLATION) +16 Известные проблемы (KNOWN ISSUES) +==================================== + +16.1 Границы файловой системы +----------------------------- + +SnapRAID не пересекает границы файловых систем, точек монтирования или +подтомов при сканировании диска данных. При обнаружении такой границы +SnapRAID сообщает ПРЕДУПРЕЖДЕНИЕ и не выполняет сканирование за ее пределами. + +Файлы, расположенные за такими границами, не включаются в диск данных и +должны настраиваться отдельно, если их необходимо защитить. + +16.2 Точки монтирования со снимками файловой системы +---------------------------------------------------- + +Когда снимки файловой системы включены, вложенные точки монтирования и +bind-монтирования внутри диска данных не поддерживаются. + +Точки монтирования являются частью пространства имен монтирования работающей +системы и не сохраняются в снимках файловой системы. Следовательно, при +сканировании снимка каталог, скрытый точкой монтирования в активной файловой +системе, может стать видимым. + +Не размещайте вложенные точки монтирования или bind-монтирования внутри дисков +данных, когда включены снимки файловой системы. + +16.3 Жесткие ссылки (Hard links) +-------------------------------- + +SnapRAID определяет одну жесткую ссылку как исходный файл и представляет +другие жесткие ссылки как ссылки на него. Какая ссылка выбирается в качестве +исходного файла, зависит от порядка сканирования записей каталога. + +Если этот порядок изменяется, например, после переименования, восстановления +файлов или повторного создания каталогов, команда "diff" может сообщать о +видимых перемещениях, обновлениях, добавлениях или удалениях, даже когда +связанные файлы по-прежнему представляют те же данные. + +Это не указывает на повреждение данных, но сообщаемые различия могут сбивать +с толку и могут не соответствовать напрямую операциям, выполненным в файловой +системе. + +16.4 Изменения файлов на месте без изменения временных меток +------------------------------------------------------------ + +SnapRAID обнаруживает изменения файлов путем сравнения размеров файлов и +временных меток модификации (mtime). + +Если приложение изменяет файл на месте без изменения его размера или +обновления временной метки модификации, "diff" и "sync" не обнаружат +изменение файла, и его четность не будет обновлена. + +Чтобы SnapRAID гарантированно распознал такие изменения, обновите временную +метку модификации файла (например, с помощью утилиты "touch"). В противном +случае различие будет обнаружено только как несоответствие хэша во время +последующего "scrub" или "check". + + +17 Перевод (TRANSLATION) ======================== Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. -17 Авторские права (COPYRIGHT) +18 Авторские права (COPYRIGHT) ============================== Этот файл защищен авторским правом (C) 2026 Andrea Mazzoleni -18 См. также (SEE ALSO) +19 См. также (SEE ALSO) ======================= snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 378770dd..70db64a2 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -2239,6 +2239,50 @@ Kommandot stötte på fel. Kommandot \`diff\` fann att allt är OK, men en \`sync\` behövs. .PD .RE +.SH KäNDA PROBLEM (KNOWN ISSUES) +.SS Filsystemgränser +SnapRAID korsar inte filsystems\-, monterings\- eller undervolymsgränser vid +skanning av en datadisk. När en sådan gräns upptäcks rapporterar SnapRAID +en VARNING och skannar inte bortom den. +.PP +Filer som finns bortom sådana gränser inkluderas inte i datadisken och +måste konfigureras separat om de ska skyddas. +.SS Monteringspunkter med filsystemögonblicksbilder +När filsystemögonblicksbilder är aktiverade stöds inte kapslade +monteringspunkter och bind\-monteringar inuti en datadisk. +.PP +Monteringspunkter är en del av det aktiva systemets monteringsnamnrymd och +bevaras inte i filsystemögonblicksbilder. Följaktligen kan en katalog som +dolts av en monteringspunkt i det aktiva filsystemet bli synlig vid +skanning av en ögonblicksbild. +.PP +Placera inte kapslade monteringspunkter eller bind\-monteringar inuti +datadiskar när filsystemögonblicksbilder är aktiverade. +.SS Hårda länkar (Hard links) +SnapRAID identifierar en hård länk som originalfilen och representerar de +andra hårda länkarna som referenser till den. Vilken länk som väljs som +originalfil beror på i vilken ordning katalogposterna skannas. +.PP +Om denna ordning ändras, till exempel efter att filer bytt namn, återställts +eller kataloger återskapats, kan \[dq]diff\[dq] rapportera skenbara flyttar, +uppdateringar, tillägg eller borttagningar även när de länkade filerna +fortfarande representerar samma data. +.PP +Detta indikerar inte datakorruption, men de rapporterade skillnaderna kan +vara förvirrande och kanske inte direkt motsvarar de filsystemsoperationer +som utfördes. +.SS Filändringar på plats utan tidsstämpeländringar +SnapRAID upptäcker filändringar genom att jämföra filstorlekar och +ändringstidsstämplar (mtime). +.PP +Om ett program ändrar en fil på plats utan att ändra dess storlek eller +uppdatera dess ändringstidsstämpel, kommer \[dq]diff\[dq] och \[dq]sync\[dq] inte att +upptäcka att filen har ändrats, och dess paritet kommer inte att uppdateras. +.PP +För att säkerställa att SnapRAID känner igen sådana ändringar, uppdatera +filens ändringstidsstämpel (till exempel med verktyget \[dq]touch\[dq]). Annars +kommer skillnaden endast att upptäckas som en hash\-avvikelse under en +efterföljande \[dq]scrub\[dq] eller \[dq]check\[dq]. .SH ÖVERSäTTNING (TRANSLATION) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index 76c629b5..d2c5c114 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1755,6 +1755,54 @@ Slutkod (Exit Code) 1 - Kommandot stötte på fel. 2 - Kommandot `diff` fann att allt är OK, men en `sync` behövs. +Kända problem (Known Issues) + Filsystemgränser + SnapRAID korsar inte filsystems-, monterings- eller undervolymsgränser vid + skanning av en datadisk. När en sådan gräns upptäcks rapporterar SnapRAID + en VARNING och skannar inte bortom den. + + Filer som finns bortom sådana gränser inkluderas inte i datadisken och + måste konfigureras separat om de ska skyddas. + + Monteringspunkter med filsystemögonblicksbilder + När filsystemögonblicksbilder är aktiverade stöds inte kapslade + monteringspunkter och bind-monteringar inuti en datadisk. + + Monteringspunkter är en del av det aktiva systemets monteringsnamnrymd och + bevaras inte i filsystemögonblicksbilder. Följaktligen kan en katalog som + dolts av en monteringspunkt i det aktiva filsystemet bli synlig vid + skanning av en ögonblicksbild. + + Placera inte kapslade monteringspunkter eller bind-monteringar inuti + datadiskar när filsystemögonblicksbilder är aktiverade. + + Hårda länkar (Hard links) + SnapRAID identifierar en hård länk som originalfilen och representerar de + andra hårda länkarna som referenser till den. Vilken länk som väljs som + originalfil beror på i vilken ordning katalogposterna skannas. + + Om denna ordning ändras, till exempel efter att filer bytt namn, återställts + eller kataloger återskapats, kan "diff" rapportera skenbara flyttar, + uppdateringar, tillägg eller borttagningar även när de länkade filerna + fortfarande representerar samma data. + + Detta indikerar inte datakorruption, men de rapporterade skillnaderna kan + vara förvirrande och kanske inte direkt motsvarar de filsystemsoperationer + som utfördes. + + Filändringar på plats utan tidsstämpeländringar + SnapRAID upptäcker filändringar genom att jämföra filstorlekar och + ändringstidsstämplar (mtime). + + Om ett program ändrar en fil på plats utan att ändra dess storlek eller + uppdatera dess ändringstidsstämpel, kommer "diff" och "sync" inte att + upptäcka att filen har ändrats, och dess paritet kommer inte att uppdateras. + + För att säkerställa att SnapRAID känner igen sådana ändringar, uppdatera + filens ändringstidsstämpel (till exempel med verktyget "touch"). Annars + kommer skillnaden endast att upptäckas som en hash-avvikelse under en + efterföljande "scrub" eller "check". + Översättning (Translation) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 4a51765f..12e3b83b 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -1884,20 +1884,79 @@ SnapRAID avslutas med följande statuskoder: 2 - Kommandot `diff` fann att allt är OK, men en `sync` behövs. -16 ÖVERSäTTNING (TRANSLATION) +16 KäNDA PROBLEM (KNOWN ISSUES) +=============================== + +16.1 Filsystemgränser +--------------------- + +SnapRAID korsar inte filsystems-, monterings- eller undervolymsgränser vid +skanning av en datadisk. När en sådan gräns upptäcks rapporterar SnapRAID +en VARNING och skannar inte bortom den. + +Filer som finns bortom sådana gränser inkluderas inte i datadisken och +måste konfigureras separat om de ska skyddas. + +16.2 Monteringspunkter med filsystemögonblicksbilder +---------------------------------------------------- + +När filsystemögonblicksbilder är aktiverade stöds inte kapslade +monteringspunkter och bind-monteringar inuti en datadisk. + +Monteringspunkter är en del av det aktiva systemets monteringsnamnrymd och +bevaras inte i filsystemögonblicksbilder. Följaktligen kan en katalog som +dolts av en monteringspunkt i det aktiva filsystemet bli synlig vid +skanning av en ögonblicksbild. + +Placera inte kapslade monteringspunkter eller bind-monteringar inuti +datadiskar när filsystemögonblicksbilder är aktiverade. + +16.3 Hårda länkar (Hard links) +------------------------------ + +SnapRAID identifierar en hård länk som originalfilen och representerar de +andra hårda länkarna som referenser till den. Vilken länk som väljs som +originalfil beror på i vilken ordning katalogposterna skannas. + +Om denna ordning ändras, till exempel efter att filer bytt namn, återställts +eller kataloger återskapats, kan "diff" rapportera skenbara flyttar, +uppdateringar, tillägg eller borttagningar även när de länkade filerna +fortfarande representerar samma data. + +Detta indikerar inte datakorruption, men de rapporterade skillnaderna kan +vara förvirrande och kanske inte direkt motsvarar de filsystemsoperationer +som utfördes. + +16.4 Filändringar på plats utan tidsstämpeländringar +---------------------------------------------------- + +SnapRAID upptäcker filändringar genom att jämföra filstorlekar och +ändringstidsstämplar (mtime). + +Om ett program ändrar en fil på plats utan att ändra dess storlek eller +uppdatera dess ändringstidsstämpel, kommer "diff" och "sync" inte att +upptäcka att filen har ändrats, och dess paritet kommer inte att uppdateras. + +För att säkerställa att SnapRAID känner igen sådana ändringar, uppdatera +filens ändringstidsstämpel (till exempel med verktyget "touch"). Annars +kommer skillnaden endast att upptäckas som en hash-avvikelse under en +efterföljande "scrub" eller "check". + + +17 ÖVERSäTTNING (TRANSLATION) ============================= Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. -17 UPPHOVSRäTT (COPYRIGHT) +18 UPPHOVSRäTT (COPYRIGHT) ========================== Denna fil är Copyright (C) 2026 Andrea Mazzoleni -18 SE äVEN (SEE ALSO) +19 SE äVEN (SEE ALSO) ===================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 3828923e..a36c580f 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -2442,6 +2442,50 @@ SnapRAID завершує роботу з такими кодами помило Команда \`diff\` визначила, що все в порядку, але потрібен \`sync\`. .PD .RE +.SH Відомі проблеми (KNOWN ISSUES) +.SS Межі файлової системи +SnapRAID не перетинає межі файлових систем, точок монтування або підтомів +під час сканування диска даних. Коли виявляється така межа, SnapRAID +повідомляє ПОПЕРЕДЖЕННЯ і не виконує сканування за її межами. +.PP +Файли, розташовані за такими межами, не включаються до диска даних і +повинні бути налаштовані окремо, якщо їх потрібно захистити. +.SS Точки монтування зі знімками файлової системи +Коли знімки файлової системи увімкнено, вкладені точки монтування та +bind\-монтування всередині диска даних не підтримуються. +.PP +Точки монтування є частиною простору імен монтування працюючої системи і +не зберігаються у знімках файлової системи. Отже, під час сканування знімка +каталог, прихований точкою монтування в активній файловій системі, може +стати видимим. +.PP +Не розміщуйте вкладені точки монтування або bind\-монтування всередині дисків +даних, коли ввімкнено знімки файлової системи. +.SS Жорсткі посилання (Hard links) +SnapRAID визначає одне жорстке посилання як оригінальний файл і представляє +інші жорсткі посилання як посилання на нього. Яке саме посилання вибирається +як оригінальний файл, залежить від порядку сканування записів каталогу. +.PP +Якщо цей порядок змінюється, наприклад, після перейменування, відновлення +файлів або повторного створення каталогів, команда \[dq]diff\[dq] може повідомляти +про уявні переміщення, оновлення, додавання або видалення, навіть коли +пов\'язані файли все ще представляють ті самі дані. +.PP +Це не свідчить про пошкодження даних, але повідомлені відмінності можуть +викликати плутанину і можуть не відповідати безпосередньо операціям, +виконаним у файловій системі. +.SS Модифікації файлів на місці без зміни позначок часу +SnapRAID виявляє модифікації файлів шляхом порівняння розмірів файлів та +позначок часу модифікації (mtime). +.PP +Якщо програма змінює файл на місці без зміни його розміру або оновлення +позначки часу модифікації, \[dq]diff\[dq] та \[dq]sync\[dq] не виявлять, що файл змінився, +і його парність не буде оновлено. +.PP +Щоб гарантувати, що SnapRAID розпізнає такі зміни, оновіть позначку часу +модифікації файлу (наприклад, за допомогою утиліти \[dq]touch\[dq]). В іншому +випадку різниця буде виявлена лише як невідповідність хешу під час +наступного \[dq]scrub\[dq] або \[dq]check\[dq]. .SH Переклад (TRANSLATION) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index c5dbf1ee..bf528903 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -1946,6 +1946,54 @@ Name{number} 1 - Команда виявила помилки. 2 - Команда `diff` визначила, що все в порядку, але потрібен `sync`. +Відомі проблеми (Known Issues) + Межі файлової системи + SnapRAID не перетинає межі файлових систем, точок монтування або підтомів + під час сканування диска даних. Коли виявляється така межа, SnapRAID + повідомляє ПОПЕРЕДЖЕННЯ і не виконує сканування за її межами. + + Файли, розташовані за такими межами, не включаються до диска даних і + повинні бути налаштовані окремо, якщо їх потрібно захистити. + + Точки монтування зі знімками файлової системи + Коли знімки файлової системи увімкнено, вкладені точки монтування та + bind-монтування всередині диска даних не підтримуються. + + Точки монтування є частиною простору імен монтування працюючої системи і + не зберігаються у знімках файлової системи. Отже, під час сканування знімка + каталог, прихований точкою монтування в активній файловій системі, може + стати видимим. + + Не розміщуйте вкладені точки монтування або bind-монтування всередині дисків + даних, коли ввімкнено знімки файлової системи. + + Жорсткі посилання (Hard links) + SnapRAID визначає одне жорстке посилання як оригінальний файл і представляє + інші жорсткі посилання як посилання на нього. Яке саме посилання вибирається + як оригінальний файл, залежить від порядку сканування записів каталогу. + + Якщо цей порядок змінюється, наприклад, після перейменування, відновлення + файлів або повторного створення каталогів, команда "diff" може повідомляти + про уявні переміщення, оновлення, додавання або видалення, навіть коли + пов'язані файли все ще представляють ті самі дані. + + Це не свідчить про пошкодження даних, але повідомлені відмінності можуть + викликати плутанину і можуть не відповідати безпосередньо операціям, + виконаним у файловій системі. + + Модифікації файлів на місці без зміни позначок часу + SnapRAID виявляє модифікації файлів шляхом порівняння розмірів файлів та + позначок часу модифікації (mtime). + + Якщо програма змінює файл на місці без зміни його розміру або оновлення + позначки часу модифікації, "diff" та "sync" не виявлять, що файл змінився, + і його парність не буде оновлено. + + Щоб гарантувати, що SnapRAID розпізнає такі зміни, оновіть позначку часу + модифікації файлу (наприклад, за допомогою утиліти "touch"). В іншому + випадку різниця буде виявлена лише як невідповідність хешу під час + наступного "scrub" або "check". + Переклад (Translation) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 0b0ecb52..1cba97ac 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -2075,20 +2075,79 @@ SnapRAID завершує роботу з такими кодами помило 2 - Команда `diff` визначила, що все в порядку, але потрібен `sync`. -16 Переклад (TRANSLATION) +16 Відомі проблеми (KNOWN ISSUES) +================================= + +16.1 Межі файлової системи +-------------------------- + +SnapRAID не перетинає межі файлових систем, точок монтування або підтомів +під час сканування диска даних. Коли виявляється така межа, SnapRAID +повідомляє ПОПЕРЕДЖЕННЯ і не виконує сканування за її межами. + +Файли, розташовані за такими межами, не включаються до диска даних і +повинні бути налаштовані окремо, якщо їх потрібно захистити. + +16.2 Точки монтування зі знімками файлової системи +-------------------------------------------------- + +Коли знімки файлової системи увімкнено, вкладені точки монтування та +bind-монтування всередині диска даних не підтримуються. + +Точки монтування є частиною простору імен монтування працюючої системи і +не зберігаються у знімках файлової системи. Отже, під час сканування знімка +каталог, прихований точкою монтування в активній файловій системі, може +стати видимим. + +Не розміщуйте вкладені точки монтування або bind-монтування всередині дисків +даних, коли ввімкнено знімки файлової системи. + +16.3 Жорсткі посилання (Hard links) +----------------------------------- + +SnapRAID визначає одне жорстке посилання як оригінальний файл і представляє +інші жорсткі посилання як посилання на нього. Яке саме посилання вибирається +як оригінальний файл, залежить від порядку сканування записів каталогу. + +Якщо цей порядок змінюється, наприклад, після перейменування, відновлення +файлів або повторного створення каталогів, команда "diff" може повідомляти +про уявні переміщення, оновлення, додавання або видалення, навіть коли +пов'язані файли все ще представляють ті самі дані. + +Це не свідчить про пошкодження даних, але повідомлені відмінності можуть +викликати плутанину і можуть не відповідати безпосередньо операціям, +виконаним у файловій системі. + +16.4 Модифікації файлів на місці без зміни позначок часу +-------------------------------------------------------- + +SnapRAID виявляє модифікації файлів шляхом порівняння розмірів файлів та +позначок часу модифікації (mtime). + +Якщо програма змінює файл на місці без зміни його розміру або оновлення +позначки часу модифікації, "diff" та "sync" не виявлять, що файл змінився, +і його парність не буде оновлено. + +Щоб гарантувати, що SnapRAID розпізнає такі зміни, оновіть позначку часу +модифікації файлу (наприклад, за допомогою утиліти "touch"). В іншому +випадку різниця буде виявлена лише як невідповідність хешу під час +наступного "scrub" або "check". + + +17 Переклад (TRANSLATION) ========================= Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. -17 Авторське право (COPYRIGHT) +18 Авторське право (COPYRIGHT) ============================== Цей файл захищений авторським правом (C) 2026 Andrea Mazzoleni -18 Див. також (SEE ALSO) +19 Див. також (SEE ALSO) ======================== snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index 15629cd7..e386c763 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -2020,6 +2020,37 @@ SnapRAID 终止并返回以下错误代码： \`diff\` 命令发现一切正常，但需要进行 \`sync\`。 .PD .RE +.SH 已知问题 (KNOWN ISSUES) +.SS 文件系统边界 +SnapRAID 在扫描数据磁盘时不会跨越文件系统、挂载点或子卷边界。 +当检测到此类边界时，SnapRAID 会报告警告（WARNING）并且不会扫描其范围之外的内容。 +.PP +位于此类边界之外的文件不包含在数据磁盘中，如果需要保护它们，则必须单独配置。 +.SS 带有文件系统快照的挂载点 +启用文件系统快照时，不支持数据磁盘内的嵌套挂载点和 bind 挂载。 +.PP +挂载点属于活动系统的挂载命名空间，不会保存在文件系统快照中。 +因此，在扫描快照时，活动文件系统中被挂载点隐藏的目录可能会变为可见。 +.PP +启用文件系统快照时，请勿在数据磁盘内放置嵌套挂载点或 bind 挂载。 +.SS 硬链接 +SnapRAID 将一个硬链接标识为原始文件，并将其他硬链接表示为对它的引用。 +选择哪个链接作为原始文件取决于扫描目录条目的顺序。 +.PP +如果此顺序发生更改（例如在重命名、恢复文件或重新创建目录之后）， +即使链接的文件仍然表示相同的数据，“diff” 也可能会报告表面上的移动、更新、 +添加或删除。 +.PP +这并不表示数据损坏，但报告的差异可能会令人困惑，并且可能与在文件系统上 +执行的操作不直接对应。 +.SS 未更改时间戳的原地文件修改 +SnapRAID 通过比较文件大小和修改时间戳（mtime）来检测文件修改。 +.PP +如果应用程序在不更改文件大小或不更新其修改时间戳的情况下原地修改文件， +则 “diff” 和 “sync” 将不会检测到文件已更改，并且其奇偶校验也不会更新。 +.PP +为确保 SnapRAID 识别此类更改，请更新文件的修改时间戳（例如使用 “touch” 实用程序）。 +否则，该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 .SH 翻译 (TRANSLATION) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 18001940..40a11835 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1536,6 +1536,41 @@ Name{number} 1 - 命令遇到一些错误。 2 - `diff` 命令发现一切正常，但需要进行 `sync`。 +已知问题 (Known Issues) + 文件系统边界 + SnapRAID 在扫描数据磁盘时不会跨越文件系统、挂载点或子卷边界。 + 当检测到此类边界时，SnapRAID 会报告警告（WARNING）并且不会扫描其范围之外的内容。 + + 位于此类边界之外的文件不包含在数据磁盘中，如果需要保护它们，则必须单独配置。 + + 带有文件系统快照的挂载点 + 启用文件系统快照时，不支持数据磁盘内的嵌套挂载点和 bind 挂载。 + + 挂载点属于活动系统的挂载命名空间，不会保存在文件系统快照中。 + 因此，在扫描快照时，活动文件系统中被挂载点隐藏的目录可能会变为可见。 + + 启用文件系统快照时，请勿在数据磁盘内放置嵌套挂载点或 bind 挂载。 + + 硬链接 + SnapRAID 将一个硬链接标识为原始文件，并将其他硬链接表示为对它的引用。 + 选择哪个链接作为原始文件取决于扫描目录条目的顺序。 + + 如果此顺序发生更改（例如在重命名、恢复文件或重新创建目录之后）， + 即使链接的文件仍然表示相同的数据，“diff” 也可能会报告表面上的移动、更新、 + 添加或删除。 + + 这并不表示数据损坏，但报告的差异可能会令人困惑，并且可能与在文件系统上 + 执行的操作不直接对应。 + + 未更改时间戳的原地文件修改 + SnapRAID 通过比较文件大小和修改时间戳（mtime）来检测文件修改。 + + 如果应用程序在不更改文件大小或不更新其修改时间戳的情况下原地修改文件， + 则 “diff” 和 “sync” 将不会检测到文件已更改，并且其奇偶校验也不会更新。 + + 为确保 SnapRAID 识别此类更改，请更新文件的修改时间戳（例如使用 “touch” 实用程序）。 + 否则，该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 + 翻译 (Translation) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 2629501d..8f799519 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1665,20 +1665,66 @@ SnapRAID 终止并返回以下错误代码： 2 - `diff` 命令发现一切正常，但需要进行 `sync`。 -16 翻译 (TRANSLATION) +16 已知问题 (KNOWN ISSUES) +====================== + +16.1 文件系统边界 +----------- + +SnapRAID 在扫描数据磁盘时不会跨越文件系统、挂载点或子卷边界。 +当检测到此类边界时，SnapRAID 会报告警告（WARNING）并且不会扫描其范围之外的内容。 + +位于此类边界之外的文件不包含在数据磁盘中，如果需要保护它们，则必须单独配置。 + +16.2 带有文件系统快照的挂载点 +----------------- + +启用文件系统快照时，不支持数据磁盘内的嵌套挂载点和 bind 挂载。 + +挂载点属于活动系统的挂载命名空间，不会保存在文件系统快照中。 +因此，在扫描快照时，活动文件系统中被挂载点隐藏的目录可能会变为可见。 + +启用文件系统快照时，请勿在数据磁盘内放置嵌套挂载点或 bind 挂载。 + +16.3 硬链接 +-------- + +SnapRAID 将一个硬链接标识为原始文件，并将其他硬链接表示为对它的引用。 +选择哪个链接作为原始文件取决于扫描目录条目的顺序。 + +如果此顺序发生更改（例如在重命名、恢复文件或重新创建目录之后）， +即使链接的文件仍然表示相同的数据，“diff” 也可能会报告表面上的移动、更新、 +添加或删除。 + +这并不表示数据损坏，但报告的差异可能会令人困惑，并且可能与在文件系统上 +执行的操作不直接对应。 + +16.4 未更改时间戳的原地文件修改 +------------------ + +SnapRAID 通过比较文件大小和修改时间戳（mtime）来检测文件修改。 + +如果应用程序在不更改文件大小或不更新其修改时间戳的情况下原地修改文件， +则 “diff” 和 “sync” 将不会检测到文件已更改，并且其奇偶校验也不会更新。 + +为确保 SnapRAID 识别此类更改，请更新文件的修改时间戳（例如使用 “touch” 实用程序）。 +否则，该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 + + +17 翻译 (TRANSLATION) =================== 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 -17 版权 (COPYRIGHT) +18 版权 (COPYRIGHT) ================= 此文件版权所有 (C) 2026 Andrea Mazzoleni -18 参见 (SEE ALSO) +19 参见 (SEE ALSO) ================ snapraid_log(1), snapraidd(1), rsync(1) diff --git a/doc/snapraid.1 b/doc/snapraid.1 index 5366b47a..6dbaf485 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -2245,6 +2245,50 @@ The \`diff\` command found everything is OK, but a \`sync\` is needed. .PD .RE +.SH KNOWN ISSUES +.SS Filesystem boundaries +SnapRAID does not cross filesystem, mount, or subvolume boundaries while +scanning a data disk. When such a boundary is detected, SnapRAID reports +a WARNING and does not scan beyond it. +.PP +Files located beyond such boundaries are not included in the data disk and +must be configured separately if they have to be protected. +.SS Mount points with filesystem snapshots +When filesystem snapshots are enabled, nested mount points and bind mounts +inside a data disk are not supported. +.PP +Mount points are part of the live system mount namespace and are not +preserved in filesystem snapshots. Consequently, when scanning a snapshot, +a directory hidden by a mount point in the live filesystem may become +visible. +.PP +Do not place nested mount points or bind mounts inside data disks when +filesystem snapshots are enabled. +.SS Hard links +SnapRAID identifies one hard link as the original file and represents the +other hard links as references to it. Which link is selected as the original +file depends on the order in which directory entries are scanned. +.PP +If this order changes, for example after files are renamed, restored, or +directories are recreated, \[dq]diff\[dq] may report apparent moves, updates, +additions, or removals even when the hard\-linked files still represent the +same data. +.PP +This does not indicate data corruption, but the reported differences may be +confusing and may not correspond directly to the filesystem operations that +were performed. +.SS In\-place file modifications without timestamp changes +SnapRAID detects file modifications by comparing file sizes and +modification timestamps (mtime). +.PP +If an application modifies a file in\-place without altering its size +or updating its modification timestamp, \[dq]diff\[dq] and \[dq]sync\[dq] will not +detect that the file has changed, and its parity will not be updated. +.PP +To ensure SnapRAID recognizes such changes, update the file\'s +modification timestamp (for example, with the \[dq]touch\[dq] utility). +Otherwise, the difference will only be detected as a hash mismatch +during a subsequent \[dq]scrub\[dq] or \[dq]check\[dq]. .SH COPYRIGHT This file is Copyright (C) 2026 Andrea Mazzoleni .SH SEE ALSO diff --git a/doc/snapraid.d b/doc/snapraid.d index e4934baa..0baf0a81 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1761,6 +1761,54 @@ Exit Code 2 - The `diff` command found everything is OK, but a `sync` is needed. +Known Issues + Filesystem boundaries + SnapRAID does not cross filesystem, mount, or subvolume boundaries while + scanning a data disk. When such a boundary is detected, SnapRAID reports + a WARNING and does not scan beyond it. + + Files located beyond such boundaries are not included in the data disk and + must be configured separately if they have to be protected. + + Mount points with filesystem snapshots + When filesystem snapshots are enabled, nested mount points and bind mounts + inside a data disk are not supported. + + Mount points are part of the live system mount namespace and are not + preserved in filesystem snapshots. Consequently, when scanning a snapshot, + a directory hidden by a mount point in the live filesystem may become + visible. + + Do not place nested mount points or bind mounts inside data disks when + filesystem snapshots are enabled. + + Hard links + SnapRAID identifies one hard link as the original file and represents the + other hard links as references to it. Which link is selected as the original + file depends on the order in which directory entries are scanned. + + If this order changes, for example after files are renamed, restored, or + directories are recreated, "diff" may report apparent moves, updates, + additions, or removals even when the hard-linked files still represent the + same data. + + This does not indicate data corruption, but the reported differences may be + confusing and may not correspond directly to the filesystem operations that + were performed. + + In-place file modifications without timestamp changes + SnapRAID detects file modifications by comparing file sizes and + modification timestamps (mtime). + + If an application modifies a file in-place without altering its size + or updating its modification timestamp, "diff" and "sync" will not + detect that the file has changed, and its parity will not be updated. + + To ensure SnapRAID recognizes such changes, update the file's + modification timestamp (for example, with the "touch" utility). + Otherwise, the difference will only be detected as a hash mismatch + during a subsequent "scrub" or "check". + Copyright This file is Copyright (C) 2026 Andrea Mazzoleni diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 187737f6..f1d09f19 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1890,13 +1890,72 @@ SnapRAID terminates with the following error codes: needed. -16 COPYRIGHT +16 KNOWN ISSUES +=============== + +16.1 Filesystem boundaries +-------------------------- + +SnapRAID does not cross filesystem, mount, or subvolume boundaries while +scanning a data disk. When such a boundary is detected, SnapRAID reports +a WARNING and does not scan beyond it. + +Files located beyond such boundaries are not included in the data disk and +must be configured separately if they have to be protected. + +16.2 Mount points with filesystem snapshots +------------------------------------------- + +When filesystem snapshots are enabled, nested mount points and bind mounts +inside a data disk are not supported. + +Mount points are part of the live system mount namespace and are not +preserved in filesystem snapshots. Consequently, when scanning a snapshot, +a directory hidden by a mount point in the live filesystem may become +visible. + +Do not place nested mount points or bind mounts inside data disks when +filesystem snapshots are enabled. + +16.3 Hard links +--------------- + +SnapRAID identifies one hard link as the original file and represents the +other hard links as references to it. Which link is selected as the original +file depends on the order in which directory entries are scanned. + +If this order changes, for example after files are renamed, restored, or +directories are recreated, "diff" may report apparent moves, updates, +additions, or removals even when the hard-linked files still represent the +same data. + +This does not indicate data corruption, but the reported differences may be +confusing and may not correspond directly to the filesystem operations that +were performed. + +16.4 In-place file modifications without timestamp changes +---------------------------------------------------------- + +SnapRAID detects file modifications by comparing file sizes and +modification timestamps (mtime). + +If an application modifies a file in-place without altering its size +or updating its modification timestamp, "diff" and "sync" will not +detect that the file has changed, and its parity will not be updated. + +To ensure SnapRAID recognizes such changes, update the file's +modification timestamp (for example, with the "touch" utility). +Otherwise, the difference will only be detected as a hash mismatch +during a subsequent "scrub" or "check". + + +17 COPYRIGHT ============ This file is Copyright (C) 2026 Andrea Mazzoleni -17 SEE ALSO +18 SEE ALSO =========== snapraid_log(1), snapraidd(1), rsync(1)