From fbc2107735fc1837ea8deb777e37167061f8d403 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Fri, 25 Sep 2026 17:09:49 +0200 Subject: [PATCH] Document reserved SnapRAID file, directory, and snapshot names including Windows case-insensitive variants --- doc/snapraid-de.1 | 39 +++++++++++++++++++++++++++++++++++++++ doc/snapraid-de.d | 23 +++++++++++++++++++++++ doc/snapraid-de.txt | 25 +++++++++++++++++++++++++ doc/snapraid-es.1 | 39 +++++++++++++++++++++++++++++++++++++++ doc/snapraid-es.d | 23 +++++++++++++++++++++++ doc/snapraid-es.txt | 25 +++++++++++++++++++++++++ doc/snapraid-fr.1 | 38 ++++++++++++++++++++++++++++++++++++++ doc/snapraid-fr.d | 22 ++++++++++++++++++++++ doc/snapraid-fr.txt | 24 ++++++++++++++++++++++++ doc/snapraid-it.1 | 38 ++++++++++++++++++++++++++++++++++++++ doc/snapraid-it.d | 22 ++++++++++++++++++++++ doc/snapraid-it.txt | 24 ++++++++++++++++++++++++ doc/snapraid-ja.1 | 39 +++++++++++++++++++++++++++++++++++++++ doc/snapraid-ja.d | 23 +++++++++++++++++++++++ doc/snapraid-ja.txt | 25 +++++++++++++++++++++++++ doc/snapraid-ko.1 | 37 +++++++++++++++++++++++++++++++++++++ doc/snapraid-ko.d | 21 +++++++++++++++++++++ doc/snapraid-ko.txt | 23 +++++++++++++++++++++++ doc/snapraid-pl.1 | 37 +++++++++++++++++++++++++++++++++++++ doc/snapraid-pl.d | 21 +++++++++++++++++++++ doc/snapraid-pl.txt | 23 +++++++++++++++++++++++ doc/snapraid-pt.1 | 38 ++++++++++++++++++++++++++++++++++++++ doc/snapraid-pt.d | 22 ++++++++++++++++++++++ doc/snapraid-pt.txt | 24 ++++++++++++++++++++++++ doc/snapraid-ro.1 | 37 +++++++++++++++++++++++++++++++++++++ doc/snapraid-ro.d | 21 +++++++++++++++++++++ doc/snapraid-ro.txt | 23 +++++++++++++++++++++++ doc/snapraid-ru.1 | 39 +++++++++++++++++++++++++++++++++++++++ doc/snapraid-ru.d | 23 +++++++++++++++++++++++ doc/snapraid-ru.txt | 25 +++++++++++++++++++++++++ doc/snapraid-sv.1 | 36 ++++++++++++++++++++++++++++++++++++ doc/snapraid-sv.d | 20 ++++++++++++++++++++ doc/snapraid-sv.txt | 22 ++++++++++++++++++++++ doc/snapraid-uk.1 | 38 ++++++++++++++++++++++++++++++++++++++ doc/snapraid-uk.d | 22 ++++++++++++++++++++++ doc/snapraid-uk.txt | 24 ++++++++++++++++++++++++ doc/snapraid-zh.1 | 35 +++++++++++++++++++++++++++++++++++ doc/snapraid-zh.d | 19 +++++++++++++++++++ doc/snapraid-zh.txt | 21 +++++++++++++++++++++ doc/snapraid.1 | 36 ++++++++++++++++++++++++++++++++++++ doc/snapraid.d | 20 ++++++++++++++++++++ doc/snapraid.txt | 22 ++++++++++++++++++++++ 42 files changed, 1158 insertions(+) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 882c72dc..f2714b9f 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -2565,6 +2565,45 @@ unterbrochenen \`sync\` vor weiteren Änderungen diese Unklarheit. Wenn eine Festplatte ausgefallen ist und eine Wiederherstellung erforderlich ist, sollten vor dem Ausführen von \`check\` oder \`fix\` keine Änderungen an den Datenfestplatten vorgenommen werden. +.SS Reservierte Datei\- und Verzeichnisnamen +SnapRAID reserviert einige Datei\-, Verzeichnis\- und Snapshot\-Namen für seine +internen Operationen. Verwenden Sie diese Namen nicht für Benutzerdaten: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Lokale Ausschlussregeldatei. +.HP 4 +.I .snapraid +Snapshot\-Container\-Verzeichnis. +.HP 4 +.I snapraid\-* +Von SnapRAID verwaltete ZFS\-Snapshot\-Namen. +.HP 4 +.I *.unrecoverable +Beschädigte Dateien, die während der Wiederherstellung +unter Quarantäne gestellt wurden. +.HP 4 +.I CONTENT.tmp +Temporäre Datei für Content\-Aktualisierungen. +.HP 4 +.I CONTENT.lock +Content\-Sperrdatei. +.HP 4 +.I PARITY.spaceholder +Temporäre Platzhalterdatei während der +Paritätszuweisung unter Windows. +.PD +.RE +.PP +Die Verwendung dieser Namen für nicht zugehörige Daten kann dazu führen, +dass Dateien oder Snapshots ignoriert, als Metadaten fehlinterpretiert, +überschrieben, umbenannt oder gelöscht werden. +.PP +Unter Windows sind alle Varianten der Groß\- und Kleinschreibung ebenfalls +reserviert, selbst in NTFS\-Verzeichnissen, die für die Unterscheidung von +Groß\- und Kleinschreibung konfiguriert sind (z. B. .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP und CONTENT.Lock). .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 504ec020..70c33437 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -2056,6 +2056,29 @@ Bekannte Probleme (Known Issues) sollten vor dem Ausführen von `check` oder `fix` keine Änderungen an den Datenfestplatten vorgenommen werden. + Reservierte Datei- und Verzeichnisnamen + SnapRAID reserviert einige Datei-, Verzeichnis- und Snapshot-Namen für seine + internen Operationen. Verwenden Sie diese Namen nicht für Benutzerdaten: + + .snapraidignore - Lokale Ausschlussregeldatei. + .snapraid - Snapshot-Container-Verzeichnis. + snapraid-* - Von SnapRAID verwaltete ZFS-Snapshot-Namen. + *.unrecoverable - Beschädigte Dateien, die während der Wiederherstellung + unter Quarantäne gestellt wurden. + CONTENT.tmp - Temporäre Datei für Content-Aktualisierungen. + CONTENT.lock - Content-Sperrdatei. + PARITY.spaceholder - Temporäre Platzhalterdatei während der + Paritätszuweisung unter Windows. + + Die Verwendung dieser Namen für nicht zugehörige Daten kann dazu führen, + dass Dateien oder Snapshots ignoriert, als Metadaten fehlinterpretiert, + überschrieben, umbenannt oder gelöscht werden. + + Unter Windows sind alle Varianten der Groß- und Kleinschreibung ebenfalls + reserviert, selbst in NTFS-Verzeichnissen, die für die Unterscheidung von + Groß- und Kleinschreibung konfiguriert sind (z. B. .SNAPRAIDIGNORE, + .SnapRaid, CONTENT.TMP und CONTENT.Lock). + Ü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 6a475e85..4793db60 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -2203,6 +2203,31 @@ Festplatte ausgefallen ist und eine Wiederherstellung erforderlich ist, sollten vor dem Ausführen von `check` oder `fix` keine Änderungen an den Datenfestplatten vorgenommen werden. +16.9 Reservierte Datei- und Verzeichnisnamen +-------------------------------------------- + +SnapRAID reserviert einige Datei-, Verzeichnis- und Snapshot-Namen für seine +internen Operationen. Verwenden Sie diese Namen nicht für Benutzerdaten: + +.snapraidignore - Lokale Ausschlussregeldatei. +.snapraid - Snapshot-Container-Verzeichnis. +snapraid-* - Von SnapRAID verwaltete ZFS-Snapshot-Namen. +*.unrecoverable - Beschädigte Dateien, die während der Wiederherstellung + unter Quarantäne gestellt wurden. +CONTENT.tmp - Temporäre Datei für Content-Aktualisierungen. +CONTENT.lock - Content-Sperrdatei. +PARITY.spaceholder - Temporäre Platzhalterdatei während der + Paritätszuweisung unter Windows. + +Die Verwendung dieser Namen für nicht zugehörige Daten kann dazu führen, +dass Dateien oder Snapshots ignoriert, als Metadaten fehlinterpretiert, +überschrieben, umbenannt oder gelöscht werden. + +Unter Windows sind alle Varianten der Groß- und Kleinschreibung ebenfalls +reserviert, selbst in NTFS-Verzeichnissen, die für die Unterscheidung von +Groß- und Kleinschreibung konfiguriert sind (z. B. .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP und CONTENT.Lock). + 17 ÜBERSETZUNG (TRANSLATION) ============================ diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index a2a40aed..ff245ca7 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -2515,6 +2515,45 @@ Si todos los discos están sanos, completar el \`sync\` interrumpido antes de realizar más cambios elimina esta ambigüedad. Si un disco ha fallado y se requiere recuperación, evite modificar los discos de datos antes de ejecutar \`check\` o \`fix\`. +.SS Nombres de archivos y directorios reservados +SnapRAID reserva algunos nombres de archivos, directorios e instantáneas para +sus operaciones internas. No use estos nombres para datos de usuario: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Archivo local de reglas de exclusión. +.HP 4 +.I .snapraid +Directorio contenedor de instantáneas. +.HP 4 +.I snapraid\-* +Nombres de instantáneas ZFS gestionadas por SnapRAID. +.HP 4 +.I *.unrecoverable +Archivos dañados puestos en cuarentena durante la +recuperación. +.HP 4 +.I CONTENT.tmp +Archivo temporal para actualizaciones de content. +.HP 4 +.I CONTENT.lock +Archivo de bloqueo de content. +.HP 4 +.I PARITY.spaceholder +Archivo temporal de reserva de espacio durante la +asignación de paridad en Windows. +.PD +.RE +.PP +El uso de estos nombres para datos no relacionados puede hacer que los archivos +o instantáneas sean ignorados, interpretados erróneamente como metadatos, +sobrescritos, renombrados o eliminados. +.PP +En Windows, todas las variantes de mayúsculas y minúsculas también están +reservadas, incluso en directorios NTFS configurados para distinguir entre +mayúsculas y minúsculas (por ejemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP +y CONTENT.Lock). .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 76d64249..4eb03b86 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -2017,6 +2017,29 @@ Problemas conocidos (Known Issues) y se requiere recuperación, evite modificar los discos de datos antes de ejecutar `check` o `fix`. + Nombres de archivos y directorios reservados + SnapRAID reserva algunos nombres de archivos, directorios e instantáneas para + sus operaciones internas. No use estos nombres para datos de usuario: + + .snapraidignore - Archivo local de reglas de exclusión. + .snapraid - Directorio contenedor de instantáneas. + snapraid-* - Nombres de instantáneas ZFS gestionadas por SnapRAID. + *.unrecoverable - Archivos dañados puestos en cuarentena durante la + recuperación. + CONTENT.tmp - Archivo temporal para actualizaciones de content. + CONTENT.lock - Archivo de bloqueo de content. + PARITY.spaceholder - Archivo temporal de reserva de espacio durante la + asignación de paridad en Windows. + + El uso de estos nombres para datos no relacionados puede hacer que los archivos + o instantáneas sean ignorados, interpretados erróneamente como metadatos, + sobrescritos, renombrados o eliminados. + + En Windows, todas las variantes de mayúsculas y minúsculas también están + reservadas, incluso en directorios NTFS configurados para distinguir entre + mayúsculas y minúsculas (por ejemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP + y CONTENT.Lock). + 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 af325c65..b4e08684 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -2164,6 +2164,31 @@ de realizar más cambios elimina esta ambigüedad. Si un disco ha fallado y se requiere recuperación, evite modificar los discos de datos antes de ejecutar `check` o `fix`. +16.9 Nombres de archivos y directorios reservados +------------------------------------------------- + +SnapRAID reserva algunos nombres de archivos, directorios e instantáneas para +sus operaciones internas. No use estos nombres para datos de usuario: + +.snapraidignore - Archivo local de reglas de exclusión. +.snapraid - Directorio contenedor de instantáneas. +snapraid-* - Nombres de instantáneas ZFS gestionadas por SnapRAID. +*.unrecoverable - Archivos dañados puestos en cuarentena durante la + recuperación. +CONTENT.tmp - Archivo temporal para actualizaciones de content. +CONTENT.lock - Archivo de bloqueo de content. +PARITY.spaceholder - Archivo temporal de reserva de espacio durante la + asignación de paridad en Windows. + +El uso de estos nombres para datos no relacionados puede hacer que los archivos +o instantáneas sean ignorados, interpretados erróneamente como metadatos, +sobrescritos, renombrados o eliminados. + +En Windows, todas las variantes de mayúsculas y minúsculas también están +reservadas, incluso en directorios NTFS configurados para distinguir entre +mayúsculas y minúsculas (por ejemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP +y CONTENT.Lock). + 17 TRADUCCIóN (TRANSLATION) =========================== diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 4333515e..03482ca6 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -2563,6 +2563,44 @@ Si tous les disques sont sains, achever le \`sync\` interrompu avant d\'apporter d\'autres modifications élimine cette ambiguïté. Si un disque est tombé en panne et qu\'une récupération est requise, évitez de modifier les disques de données avant d\'exécuter \`check\` ou \`fix\`. +.SS Noms de fichiers et de répertoires réservés +SnapRAID réserve certains noms de fichiers, répertoires et instantanés pour son +fonctionnement interne. N\'utilisez pas ces noms pour des données utilisateur : +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Fichier local de règles d\'exclusion. +.HP 4 +.I .snapraid +Répertoire conteneur d\'instantanés. +.HP 4 +.I snapraid\-* +Noms d\'instantanés ZFS gérés par SnapRAID. +.HP 4 +.I *.unrecoverable +Fichiers endommagés mis en quarantaine lors de la +récupération. +.HP 4 +.I CONTENT.tmp +Fichier temporaire pour les mises à jour du fichier content. +.HP 4 +.I CONTENT.lock +Fichier de verrouillage du fichier content. +.HP 4 +.I PARITY.spaceholder +Fichier temporaire réservant de l\'espace lors de +l\'allocation de parité sous Windows. +.PD +.RE +.PP +L\'utilisation de ces noms pour des données non liées peut entraîner l\'ignorance, +une mauvaise interprétation en tant que métadonnées, l\'écrasement, le renommage +ou la suppression de fichiers ou d\'instantanés. +.PP +Sous Windows, toutes les variantes de casse sont également réservées, même +dans les répertoires NTFS configurés pour respecter la casse (par exemple, +.SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP et CONTENT.Lock). .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 162a0a88..39b5c8d1 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -2062,6 +2062,28 @@ Problèmes connus (Known Issues) est tombé en panne et qu'une récupération est requise, évitez de modifier les disques de données avant d'exécuter `check` ou `fix`. + Noms de fichiers et de répertoires réservés + SnapRAID réserve certains noms de fichiers, répertoires et instantanés pour son + fonctionnement interne. N'utilisez pas ces noms pour des données utilisateur : + + .snapraidignore - Fichier local de règles d'exclusion. + .snapraid - Répertoire conteneur d'instantanés. + snapraid-* - Noms d'instantanés ZFS gérés par SnapRAID. + *.unrecoverable - Fichiers endommagés mis en quarantaine lors de la + récupération. + CONTENT.tmp - Fichier temporaire pour les mises à jour du fichier content. + CONTENT.lock - Fichier de verrouillage du fichier content. + PARITY.spaceholder - Fichier temporaire réservant de l'espace lors de + l'allocation de parité sous Windows. + + L'utilisation de ces noms pour des données non liées peut entraîner l'ignorance, + une mauvaise interprétation en tant que métadonnées, l'écrasement, le renommage + ou la suppression de fichiers ou d'instantanés. + + Sous Windows, toutes les variantes de casse sont également réservées, même + dans les répertoires NTFS configurés pour respecter la casse (par exemple, + .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP et CONTENT.Lock). + 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 dc94de93..9169b1fc 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -2209,6 +2209,30 @@ d'apporter d'autres modifications élimine cette ambiguïté. Si un disque est tombé en panne et qu'une récupération est requise, évitez de modifier les disques de données avant d'exécuter `check` ou `fix`. +16.9 Noms de fichiers et de répertoires réservés +------------------------------------------------ + +SnapRAID réserve certains noms de fichiers, répertoires et instantanés pour son +fonctionnement interne. N'utilisez pas ces noms pour des données utilisateur : + +.snapraidignore - Fichier local de règles d'exclusion. +.snapraid - Répertoire conteneur d'instantanés. +snapraid-* - Noms d'instantanés ZFS gérés par SnapRAID. +*.unrecoverable - Fichiers endommagés mis en quarantaine lors de la + récupération. +CONTENT.tmp - Fichier temporaire pour les mises à jour du fichier content. +CONTENT.lock - Fichier de verrouillage du fichier content. +PARITY.spaceholder - Fichier temporaire réservant de l'espace lors de + l'allocation de parité sous Windows. + +L'utilisation de ces noms pour des données non liées peut entraîner l'ignorance, +une mauvaise interprétation en tant que métadonnées, l'écrasement, le renommage +ou la suppression de fichiers ou d'instantanés. + +Sous Windows, toutes les variantes de casse sont également réservées, même +dans les répertoires NTFS configurés pour respecter la casse (par exemple, +.SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP et CONTENT.Lock). + 17 TRADUCTION (TRANSLATION) =========================== diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index a86e45b5..ab7aff8d 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -2536,6 +2536,44 @@ Se tutti i dischi sono integri, completare il \`sync\` interrotto prima di apportare ulteriori modifiche rimuove questa ambiguità. Se un disco si è guastato ed è necessario il recupero, evitare di modificare i dischi dati prima di eseguire \`check\` o \`fix\`. +.SS Nomi di file e directory riservati +SnapRAID riserva alcuni nomi di file, directory e snapshot per le proprie +operazioni interne. Non usare questi nomi per i dati utente: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +File locale delle regole di esclusione. +.HP 4 +.I .snapraid +Directory contenitore degli snapshot. +.HP 4 +.I snapraid\-* +Nomi degli snapshot ZFS gestiti da SnapRAID. +.HP 4 +.I *.unrecoverable +File danneggiati messi in quarantena durante il ripristino. +.HP 4 +.I CONTENT.tmp +File temporaneo per gli aggiornamenti del content. +.HP 4 +.I CONTENT.lock +File di blocco per il content. +.HP 4 +.I PARITY.spaceholder +File segnaposto temporaneo durante l\'allocazione +della parità su Windows. +.PD +.RE +.PP +L\'uso di questi nomi per dati non correlati può causare l\'ignoramento, +l\'errata interpretazione come metadati, la sovrascrittura, la ridenominazione +o l\'eliminazione di file o snapshot. +.PP +Su Windows, tutte le varianti di maiuscole e minuscole sono anch\'esse +riservate, anche nelle directory NTFS configurate per il funzionamento con +distinzione tra maiuscole e minuscole (ad esempio, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP e CONTENT.Lock). .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 9e14de58..a300db88 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -2024,6 +2024,28 @@ Problemi noti (Known Issues) si è guastato ed è necessario il recupero, evitare di modificare i dischi dati prima di eseguire `check` o `fix`. + Nomi di file e directory riservati + SnapRAID riserva alcuni nomi di file, directory e snapshot per le proprie + operazioni interne. Non usare questi nomi per i dati utente: + + .snapraidignore - File locale delle regole di esclusione. + .snapraid - Directory contenitore degli snapshot. + snapraid-* - Nomi degli snapshot ZFS gestiti da SnapRAID. + *.unrecoverable - File danneggiati messi in quarantena durante il ripristino. + CONTENT.tmp - File temporaneo per gli aggiornamenti del content. + CONTENT.lock - File di blocco per il content. + PARITY.spaceholder - File segnaposto temporaneo durante l'allocazione + della parità su Windows. + + L'uso di questi nomi per dati non correlati può causare l'ignoramento, + l'errata interpretazione come metadati, la sovrascrittura, la ridenominazione + o l'eliminazione di file o snapshot. + + Su Windows, tutte le varianti di maiuscole e minuscole sono anch'esse + riservate, anche nelle directory NTFS configurate per il funzionamento con + distinzione tra maiuscole e minuscole (ad esempio, .SNAPRAIDIGNORE, + .SnapRaid, CONTENT.TMP e CONTENT.Lock). + 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 b39fdc7a..bf0b3c36 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -2171,6 +2171,30 @@ di apportare ulteriori modifiche rimuove questa ambiguità. Se un disco si è guastato ed è necessario il recupero, evitare di modificare i dischi dati prima di eseguire `check` o `fix`. +16.9 Nomi di file e directory riservati +--------------------------------------- + +SnapRAID riserva alcuni nomi di file, directory e snapshot per le proprie +operazioni interne. Non usare questi nomi per i dati utente: + +.snapraidignore - File locale delle regole di esclusione. +.snapraid - Directory contenitore degli snapshot. +snapraid-* - Nomi degli snapshot ZFS gestiti da SnapRAID. +*.unrecoverable - File danneggiati messi in quarantena durante il ripristino. +CONTENT.tmp - File temporaneo per gli aggiornamenti del content. +CONTENT.lock - File di blocco per il content. +PARITY.spaceholder - File segnaposto temporaneo durante l'allocazione + della parità su Windows. + +L'uso di questi nomi per dati non correlati può causare l'ignoramento, +l'errata interpretazione come metadati, la sovrascrittura, la ridenominazione +o l'eliminazione di file o snapshot. + +Su Windows, tutte le varianti di maiuscole e minuscole sono anch'esse +riservate, anche nelle directory NTFS configurate per il funzionamento con +distinzione tra maiuscole e minuscole (ad esempio, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP e CONTENT.Lock). + 17 TRADUZIONE (TRANSLATION) =========================== diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index 63ec8afb..efdca0e8 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -2282,6 +2282,45 @@ SnapRAID が新旧のパリティが混在する不整合な組み合わせを を完了させることで、この不確実性を排除できます。ディスクに障害が発生して 回復が必要な場合は、\`check\` または \`fix\` を実行する前にデータディスクを 変更しないようにしてください。 +.SS 予約済みのファイル名およびディレクトリ名 +SnapRAID は内部処理のために一部のファイル名、ディレクトリ名、 +スナップショット名を予約しています。これらの名前をユーザーデータに +使用しないでください: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +ローカル除外ルールファイル。 +.HP 4 +.I .snapraid +スナップショットコンテナディレクトリ。 +.HP 4 +.I snapraid\-* +SnapRAID が管理する ZFS スナップショット名。 +.HP 4 +.I *.unrecoverable +回復中に隔離された破損ファイル。 +.HP 4 +.I CONTENT.tmp +content 更新用の一時ファイル。 +.HP 4 +.I CONTENT.lock +content ロックファイル。 +.HP 4 +.I PARITY.spaceholder +Windows でのパリティ割り当て時の一時的な +プレースホルダーファイル。 +.PD +.RE +.PP +これらの名前を無関係なデータに使用すると、ファイルやスナップショットが +無視されたり、メタデータとして誤認されたり、上書き、名前変更、または +削除されたりする可能性があります。 +.PP +Windows では、大文字と小文字を区別するように構成された NTFS +ディレクトリであっても、すべての大文字・小文字のバリエーションが +同様に予約されます(例: .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP、 +CONTENT.Lock)。 .SH 翻訳 (TRANSLATION) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 2877363e..3931aefe 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1784,6 +1784,29 @@ Name{number} 回復が必要な場合は、`check` または `fix` を実行する前にデータディスクを 変更しないようにしてください。 + 予約済みのファイル名およびディレクトリ名 + SnapRAID は内部処理のために一部のファイル名、ディレクトリ名、 + スナップショット名を予約しています。これらの名前をユーザーデータに + 使用しないでください: + + .snapraidignore - ローカル除外ルールファイル。 + .snapraid - スナップショットコンテナディレクトリ。 + snapraid-* - SnapRAID が管理する ZFS スナップショット名。 + *.unrecoverable - 回復中に隔離された破損ファイル。 + CONTENT.tmp - content 更新用の一時ファイル。 + CONTENT.lock - content ロックファイル。 + PARITY.spaceholder - Windows でのパリティ割り当て時の一時的な + プレースホルダーファイル。 + + これらの名前を無関係なデータに使用すると、ファイルやスナップショットが + 無視されたり、メタデータとして誤認されたり、上書き、名前変更、または + 削除されたりする可能性があります。 + + Windows では、大文字と小文字を区別するように構成された NTFS + ディレクトリであっても、すべての大文字・小文字のバリエーションが + 同様に予約されます(例: .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP、 + CONTENT.Lock)。 + 翻訳 (Translation) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 79f7d95d..f8b28a74 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1931,6 +1931,31 @@ SnapRAID が新旧のパリティが混在する不整合な組み合わせを 回復が必要な場合は、`check` または `fix` を実行する前にデータディスクを 変更しないようにしてください。 +16.9 予約済みのファイル名およびディレクトリ名 +------------------------- + +SnapRAID は内部処理のために一部のファイル名、ディレクトリ名、 +スナップショット名を予約しています。これらの名前をユーザーデータに +使用しないでください: + +.snapraidignore - ローカル除外ルールファイル。 +.snapraid - スナップショットコンテナディレクトリ。 +snapraid-* - SnapRAID が管理する ZFS スナップショット名。 +*.unrecoverable - 回復中に隔離された破損ファイル。 +CONTENT.tmp - content 更新用の一時ファイル。 +CONTENT.lock - content ロックファイル。 +PARITY.spaceholder - Windows でのパリティ割り当て時の一時的な + プレースホルダーファイル。 + +これらの名前を無関係なデータに使用すると、ファイルやスナップショットが +無視されたり、メタデータとして誤認されたり、上書き、名前変更、または +削除されたりする可能性があります。 + +Windows では、大文字と小文字を区別するように構成された NTFS +ディレクトリであっても、すべての大文字・小文字のバリエーションが +同様に予約されます(例: .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP、 +CONTENT.Lock)。 + 17 翻訳 (TRANSLATION) =================== diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 1a72d30f..c5af4752 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -2320,6 +2320,43 @@ SnapRAID가 이전 패리티와 새 패리티의 일치하지 않는 혼합을 완료하면 이러한 불확실성이 제거됩니다. 디스크에 오류가 발생하여 복구가 필요한 경우 \`check\` 또는 \`fix\`를 실행하기 전에 데이터 디스크를 수정하지 마십시오. +.SS 예약된 파일 및 디렉터리 이름 +SnapRAID는 내부 작업을 위해 일부 파일, 디렉터리 및 스냅샷 이름을 +예약합니다. 사용자 데이터에 이러한 이름을 사용하지 마십시오: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +로컬 제외 규칙 파일. +.HP 4 +.I .snapraid +스냅샷 컨테이너 디렉터리. +.HP 4 +.I snapraid\-* +SnapRAID에서 관리하는 ZFS 스냅샷 이름. +.HP 4 +.I *.unrecoverable +복구 중 격리된 손상된 파일. +.HP 4 +.I CONTENT.tmp +content 업데이트용 임시 파일. +.HP 4 +.I CONTENT.lock +content 잠금 파일. +.HP 4 +.I PARITY.spaceholder +Windows 패리티 할당 중 사용되는 임시 +공간 확보 파일. +.PD +.RE +.PP +관련 없는 데이터에 이러한 이름을 사용하면 파일이나 스냅샷이 무시되거나, +메타데이터로 잘못 해석되거나, 덮어쓰기되거나, 이름이 바뀌거나, 삭제될 수 +있습니다. +.PP +Windows에서는 대소문자를 구분하도록 구성된 NTFS 디렉터리에서도 모든 +대소문자 변형이 마찬가지로 예약됩니다(예: .SNAPRAIDIGNORE, .SnapRaid, +CONTENT.TMP, CONTENT.Lock). .SH 번역 (TRANSLATION) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index e118e651..896fc3f7 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1822,6 +1822,27 @@ Name{number} 필요한 경우 `check` 또는 `fix`를 실행하기 전에 데이터 디스크를 수정하지 마십시오. + 예약된 파일 및 디렉터리 이름 + SnapRAID는 내부 작업을 위해 일부 파일, 디렉터리 및 스냅샷 이름을 + 예약합니다. 사용자 데이터에 이러한 이름을 사용하지 마십시오: + + .snapraidignore - 로컬 제외 규칙 파일. + .snapraid - 스냅샷 컨테이너 디렉터리. + snapraid-* - SnapRAID에서 관리하는 ZFS 스냅샷 이름. + *.unrecoverable - 복구 중 격리된 손상된 파일. + CONTENT.tmp - content 업데이트용 임시 파일. + CONTENT.lock - content 잠금 파일. + PARITY.spaceholder - Windows 패리티 할당 중 사용되는 임시 + 공간 확보 파일. + + 관련 없는 데이터에 이러한 이름을 사용하면 파일이나 스냅샷이 무시되거나, + 메타데이터로 잘못 해석되거나, 덮어쓰기되거나, 이름이 바뀌거나, 삭제될 수 + 있습니다. + + Windows에서는 대소문자를 구분하도록 구성된 NTFS 디렉터리에서도 모든 + 대소문자 변형이 마찬가지로 예약됩니다(예: .SNAPRAIDIGNORE, .SnapRaid, + CONTENT.TMP, CONTENT.Lock). + 번역 (Translation) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index 6e2e7016..db1e385d 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1969,6 +1969,29 @@ SnapRAID가 이전 패리티와 새 패리티의 일치하지 않는 혼합을 필요한 경우 `check` 또는 `fix`를 실행하기 전에 데이터 디스크를 수정하지 마십시오. +16.9 예약된 파일 및 디렉터리 이름 +--------------------- + +SnapRAID는 내부 작업을 위해 일부 파일, 디렉터리 및 스냅샷 이름을 +예약합니다. 사용자 데이터에 이러한 이름을 사용하지 마십시오: + +.snapraidignore - 로컬 제외 규칙 파일. +.snapraid - 스냅샷 컨테이너 디렉터리. +snapraid-* - SnapRAID에서 관리하는 ZFS 스냅샷 이름. +*.unrecoverable - 복구 중 격리된 손상된 파일. +CONTENT.tmp - content 업데이트용 임시 파일. +CONTENT.lock - content 잠금 파일. +PARITY.spaceholder - Windows 패리티 할당 중 사용되는 임시 + 공간 확보 파일. + +관련 없는 데이터에 이러한 이름을 사용하면 파일이나 스냅샷이 무시되거나, +메타데이터로 잘못 해석되거나, 덮어쓰기되거나, 이름이 바뀌거나, 삭제될 수 +있습니다. + +Windows에서는 대소문자를 구분하도록 구성된 NTFS 디렉터리에서도 모든 +대소문자 변형이 마찬가지로 예약됩니다(예: .SNAPRAIDIGNORE, .SnapRaid, +CONTENT.TMP, CONTENT.Lock). + 17 번역 (TRANSLATION) =================== diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 4b9febe0..be4409c7 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -2427,6 +2427,43 @@ Jeśli wszystkie dyski są sprawne, dokończenie przerwanego \`sync\` przed wprowadzeniem dalszych zmian usuwa tę niejednoznaczność. Jeśli nastąpiła awaria dysku i konieczne jest odzyskanie danych, należy unikać modyfikacji dysków danych przed uruchomieniem \`check\` lub \`fix\`. +.SS Zastrzeżone nazwy plików i katalogów +SnapRAID rezerwuje niektóre nazwy plików, katalogów i migawek do swoich +wewnętrznych operacji. Nie używaj tych nazw dla danych użytkownika: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Lokalny plik reguł wykluczeń. +.HP 4 +.I .snapraid +Katalog kontenera migawek. +.HP 4 +.I snapraid\-* +Nazwy migawek ZFS zarządzanych przez SnapRAID. +.HP 4 +.I *.unrecoverable +Uszkodzone pliki objęte kwarantanną podczas odzyskiwania. +.HP 4 +.I CONTENT.tmp +Plik tymczasowy do aktualizacji pliku content. +.HP 4 +.I CONTENT.lock +Plik blokady pliku content. +.HP 4 +.I PARITY.spaceholder +Tymczasowy plik rezerwacji miejsca podczas alokacji +parzystości w systemie Windows. +.PD +.RE +.PP +Użycie tych nazw dla niepowiązanych danych może spowodować, że pliki lub +migawki zostaną zignorowane, błędnie zinterpretowane jako metadane, +nadpisane, przemianowane lub usunięte. +.PP +W systemie Windows wszystkie warianty wielkości liter są również zastrzeżone, +nawet w katalogach NTFS skonfigurowanych do rozróżniania wielkości liter +(na przykład .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP i CONTENT.Lock). .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 0b8754f9..164a97ab 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1929,6 +1929,27 @@ Znane problemy (Known Issues) awaria dysku i konieczne jest odzyskanie danych, należy unikać modyfikacji dysków danych przed uruchomieniem `check` lub `fix`. + Zastrzeżone nazwy plików i katalogów + SnapRAID rezerwuje niektóre nazwy plików, katalogów i migawek do swoich + wewnętrznych operacji. Nie używaj tych nazw dla danych użytkownika: + + .snapraidignore - Lokalny plik reguł wykluczeń. + .snapraid - Katalog kontenera migawek. + snapraid-* - Nazwy migawek ZFS zarządzanych przez SnapRAID. + *.unrecoverable - Uszkodzone pliki objęte kwarantanną podczas odzyskiwania. + CONTENT.tmp - Plik tymczasowy do aktualizacji pliku content. + CONTENT.lock - Plik blokady pliku content. + PARITY.spaceholder - Tymczasowy plik rezerwacji miejsca podczas alokacji + parzystości w systemie Windows. + + Użycie tych nazw dla niepowiązanych danych może spowodować, że pliki lub + migawki zostaną zignorowane, błędnie zinterpretowane jako metadane, + nadpisane, przemianowane lub usunięte. + + W systemie Windows wszystkie warianty wielkości liter są również zastrzeżone, + nawet w katalogach NTFS skonfigurowanych do rozróżniania wielkości liter + (na przykład .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP i CONTENT.Lock). + 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 ba098327..8b7af044 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -2076,6 +2076,29 @@ wprowadzeniem dalszych zmian usuwa tę niejednoznaczność. Jeśli nastąpiła awaria dysku i konieczne jest odzyskanie danych, należy unikać modyfikacji dysków danych przed uruchomieniem `check` lub `fix`. +16.9 Zastrzeżone nazwy plików i katalogów +----------------------------------------- + +SnapRAID rezerwuje niektóre nazwy plików, katalogów i migawek do swoich +wewnętrznych operacji. Nie używaj tych nazw dla danych użytkownika: + +.snapraidignore - Lokalny plik reguł wykluczeń. +.snapraid - Katalog kontenera migawek. +snapraid-* - Nazwy migawek ZFS zarządzanych przez SnapRAID. +*.unrecoverable - Uszkodzone pliki objęte kwarantanną podczas odzyskiwania. +CONTENT.tmp - Plik tymczasowy do aktualizacji pliku content. +CONTENT.lock - Plik blokady pliku content. +PARITY.spaceholder - Tymczasowy plik rezerwacji miejsca podczas alokacji + parzystości w systemie Windows. + +Użycie tych nazw dla niepowiązanych danych może spowodować, że pliki lub +migawki zostaną zignorowane, błędnie zinterpretowane jako metadane, +nadpisane, przemianowane lub usunięte. + +W systemie Windows wszystkie warianty wielkości liter są również zastrzeżone, +nawet w katalogach NTFS skonfigurowanych do rozróżniania wielkości liter +(na przykład .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP i CONTENT.Lock). + 17 TłUMACZENIE (TRANSLATION) ============================ diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index 63b73621..08ad589a 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -2462,6 +2462,44 @@ Se todos os discos estiverem íntegros, concluir o \`sync\` interrompido antes de fazer novas alterações remove essa ambiguidade. Se um disco tiver falhado e a recuperação for necessária, evite modificar os discos de dados antes de executar \`check\` ou \`fix\`. +.SS Nomes reservados de arquivos e diretórios +O SnapRAID reserva alguns nomes de arquivos, diretórios e snapshots para +suas operações internas. Não use esses nomes para dados do usuário: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Arquivo local de regras de exclusão. +.HP 4 +.I .snapraid +Diretório contêiner de snapshots. +.HP 4 +.I snapraid\-* +Nomes de snapshots ZFS gerenciados pelo SnapRAID. +.HP 4 +.I *.unrecoverable +Arquivos danificados colocados em quarentena durante +a recuperação. +.HP 4 +.I CONTENT.tmp +Arquivo temporário para atualizações do content. +.HP 4 +.I CONTENT.lock +Arquivo de bloqueio do content. +.HP 4 +.I PARITY.spaceholder +Arquivo temporário de reserva de espaço durante a +alocação de paridade no Windows. +.PD +.RE +.PP +O uso desses nomes para dados não relacionados pode fazer com que arquivos ou +snapshots sejam ignorados, interpretados incorretamente como metadados, +sobrescritos, renomeados ou excluídos. +.PP +No Windows, todas as variações de maiúsculas e minúsculas também são reservadas, +mesmo em diretórios NTFS configurados para diferenciar maiúsculas de minúsculas +(por exemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP e CONTENT.Lock). .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 1d79eb15..e18a4cbd 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1964,6 +1964,28 @@ Problemas Conhecidos (Known Issues) falhado e a recuperação for necessária, evite modificar os discos de dados antes de executar `check` ou `fix`. + Nomes reservados de arquivos e diretórios + O SnapRAID reserva alguns nomes de arquivos, diretórios e snapshots para + suas operações internas. Não use esses nomes para dados do usuário: + + .snapraidignore - Arquivo local de regras de exclusão. + .snapraid - Diretório contêiner de snapshots. + snapraid-* - Nomes de snapshots ZFS gerenciados pelo SnapRAID. + *.unrecoverable - Arquivos danificados colocados em quarentena durante + a recuperação. + CONTENT.tmp - Arquivo temporário para atualizações do content. + CONTENT.lock - Arquivo de bloqueio do content. + PARITY.spaceholder - Arquivo temporário de reserva de espaço durante a + alocação de paridade no Windows. + + O uso desses nomes para dados não relacionados pode fazer com que arquivos ou + snapshots sejam ignorados, interpretados incorretamente como metadados, + sobrescritos, renomeados ou excluídos. + + No Windows, todas as variações de maiúsculas e minúsculas também são reservadas, + mesmo em diretórios NTFS configurados para diferenciar maiúsculas de minúsculas + (por exemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP e CONTENT.Lock). + 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 b0eeac1e..a6d6edb4 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -2111,6 +2111,30 @@ antes de fazer novas alterações remove essa ambiguidade. Se um disco tiver falhado e a recuperação for necessária, evite modificar os discos de dados antes de executar `check` ou `fix`. +16.9 Nomes reservados de arquivos e diretórios +---------------------------------------------- + +O SnapRAID reserva alguns nomes de arquivos, diretórios e snapshots para +suas operações internas. Não use esses nomes para dados do usuário: + +.snapraidignore - Arquivo local de regras de exclusão. +.snapraid - Diretório contêiner de snapshots. +snapraid-* - Nomes de snapshots ZFS gerenciados pelo SnapRAID. +*.unrecoverable - Arquivos danificados colocados em quarentena durante + a recuperação. +CONTENT.tmp - Arquivo temporário para atualizações do content. +CONTENT.lock - Arquivo de bloqueio do content. +PARITY.spaceholder - Arquivo temporário de reserva de espaço durante a + alocação de paridade no Windows. + +O uso desses nomes para dados não relacionados pode fazer com que arquivos ou +snapshots sejam ignorados, interpretados incorretamente como metadados, +sobrescritos, renomeados ou excluídos. + +No Windows, todas as variações de maiúsculas e minúsculas também são reservadas, +mesmo em diretórios NTFS configurados para diferenciar maiúsculas de minúsculas +(por exemplo, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP e CONTENT.Lock). + 17 TRADUçãO (TRANSLATION) ========================= diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 4708a9cc..a9036c6f 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -2422,6 +2422,43 @@ Dacă toate discurile sunt integre, finalizarea \`sync\`\-ului întrerupt înainte de a face alte modificări elimină această ambiguitate. Dacă un disc a cedat și este necesară recuperarea, evitați modificarea discurilor de date înainte de a rula \`check\` sau \`fix\`. +.SS Nume rezervate de fișiere și directoare +SnapRAID rezervă anumite nume de fișiere, directoare și snapshot\-uri pentru +operațiunile sale interne. Nu utilizați aceste nume pentru datele utilizatorului: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Fișier local cu reguli de excludere. +.HP 4 +.I .snapraid +Director container pentru snapshot\-uri. +.HP 4 +.I snapraid\-* +Nume de snapshot\-uri ZFS gestionate de SnapRAID. +.HP 4 +.I *.unrecoverable +Fișiere deteriorate puse în carantină în timpul recuperării. +.HP 4 +.I CONTENT.tmp +Fișier temporar pentru actualizările fișierului content. +.HP 4 +.I CONTENT.lock +Fișier de blocare pentru fișierul content. +.HP 4 +.I PARITY.spaceholder +Fișier temporar pentru rezervarea spațiului în timpul +alocării parității pe Windows. +.PD +.RE +.PP +Utilizarea acestor nume pentru date fără legătură poate face ca fișierele sau +snapshot\-urile să fie ignorate, interpretate eronat ca metadate, suprascrise, +redenumite sau șterse. +.PP +Pe Windows, toate variantele majuscule/minuscule sunt de asemenea rezervate, +chiar și în directoarele NTFS configurate pentru diferențierea majusculelor de +minuscule (de exemplu, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP și CONTENT.Lock). .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 8cf59795..3da8a3a9 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1924,6 +1924,27 @@ Probleme Cunoscute (Known Issues) disc a cedat și este necesară recuperarea, evitați modificarea discurilor de date înainte de a rula `check` sau `fix`. + Nume rezervate de fișiere și directoare + SnapRAID rezervă anumite nume de fișiere, directoare și snapshot-uri pentru + operațiunile sale interne. Nu utilizați aceste nume pentru datele utilizatorului: + + .snapraidignore - Fișier local cu reguli de excludere. + .snapraid - Director container pentru snapshot-uri. + snapraid-* - Nume de snapshot-uri ZFS gestionate de SnapRAID. + *.unrecoverable - Fișiere deteriorate puse în carantină în timpul recuperării. + CONTENT.tmp - Fișier temporar pentru actualizările fișierului content. + CONTENT.lock - Fișier de blocare pentru fișierul content. + PARITY.spaceholder - Fișier temporar pentru rezervarea spațiului în timpul + alocării parității pe Windows. + + Utilizarea acestor nume pentru date fără legătură poate face ca fișierele sau + snapshot-urile să fie ignorate, interpretate eronat ca metadate, suprascrise, + redenumite sau șterse. + + Pe Windows, toate variantele majuscule/minuscule sunt de asemenea rezervate, + chiar și în directoarele NTFS configurate pentru diferențierea majusculelor de + minuscule (de exemplu, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP și CONTENT.Lock). + 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 1307afa6..6a3e3880 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -2071,6 +2071,29 @@ Dacă toate discurile sunt integre, finalizarea `sync`-ului întrerupt disc a cedat și este necesară recuperarea, evitați modificarea discurilor de date înainte de a rula `check` sau `fix`. +16.9 Nume rezervate de fișiere și directoare +-------------------------------------------- + +SnapRAID rezervă anumite nume de fișiere, directoare și snapshot-uri pentru +operațiunile sale interne. Nu utilizați aceste nume pentru datele utilizatorului: + +.snapraidignore - Fișier local cu reguli de excludere. +.snapraid - Director container pentru snapshot-uri. +snapraid-* - Nume de snapshot-uri ZFS gestionate de SnapRAID. +*.unrecoverable - Fișiere deteriorate puse în carantină în timpul recuperării. +CONTENT.tmp - Fișier temporar pentru actualizările fișierului content. +CONTENT.lock - Fișier de blocare pentru fișierul content. +PARITY.spaceholder - Fișier temporar pentru rezervarea spațiului în timpul + alocării parității pe Windows. + +Utilizarea acestor nume pentru date fără legătură poate face ca fișierele sau +snapshot-urile să fie ignorate, interpretate eronat ca metadate, suprascrise, +redenumite sau șterse. + +Pe Windows, toate variantele majuscule/minuscule sunt de asemenea rezervate, +chiar și în directoarele NTFS configurate pentru diferențierea majusculelor de +minuscule (de exemplu, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP și CONTENT.Lock). + 17 TRADUCERE (TRANSLATION) ========================== diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 19207059..bcfb9ca0 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -2424,6 +2424,45 @@ SnapRAID автоматически обнаруживает и нормализ дальнейших изменений устраняет эту неоднозначность. Если диск вышел из строя и требуется восстановление, избегайте изменения дисков данных перед запуском \`check\` или \`fix\`. +.SS Зарезервированные имена файлов и каталогов +SnapRAID резервирует некоторые имена файлов, каталогов и снимков для +своих внутренних операций. Не используйте эти имена для пользовательских +данных: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Локальный файл правил исключения. +.HP 4 +.I .snapraid +Каталог\-контейнер снимков. +.HP 4 +.I snapraid\-* +Имена снимков ZFS, управляемых SnapRAID. +.HP 4 +.I *.unrecoverable +Поврежденные файлы, помещенные в карантин во время +восстановления. +.HP 4 +.I CONTENT.tmp +Временный файл для обновлений файла content. +.HP 4 +.I CONTENT.lock +Файл блокировки файла content. +.HP 4 +.I PARITY.spaceholder +Временный файл резервирования места при выделении +четности в Windows. +.PD +.RE +.PP +Использование этих имен для несвязанных данных может привести к тому, +что файлы или снимки будут проигнорированы, ошибочно приняты за метаданные, +перезаписаны, переименованы или удалены. +.PP +В Windows все варианты регистра также зарезервированы, даже в каталогах +NTFS, настроенных с учетом регистра (например, .SNAPRAIDIGNORE, .SnapRaid, +CONTENT.TMP и CONTENT.Lock). .SH Перевод (TRANSLATION) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index cdadfa36..c2097a95 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1928,6 +1928,29 @@ Name{number} строя и требуется восстановление, избегайте изменения дисков данных перед запуском `check` или `fix`. + Зарезервированные имена файлов и каталогов + SnapRAID резервирует некоторые имена файлов, каталогов и снимков для + своих внутренних операций. Не используйте эти имена для пользовательских + данных: + + .snapraidignore - Локальный файл правил исключения. + .snapraid - Каталог-контейнер снимков. + snapraid-* - Имена снимков ZFS, управляемых SnapRAID. + *.unrecoverable - Поврежденные файлы, помещенные в карантин во время + восстановления. + CONTENT.tmp - Временный файл для обновлений файла content. + CONTENT.lock - Файл блокировки файла content. + PARITY.spaceholder - Временный файл резервирования места при выделении + четности в Windows. + + Использование этих имен для несвязанных данных может привести к тому, + что файлы или снимки будут проигнорированы, ошибочно приняты за метаданные, + перезаписаны, переименованы или удалены. + + В Windows все варианты регистра также зарезервированы, даже в каталогах + NTFS, настроенных с учетом регистра (например, .SNAPRAIDIGNORE, .SnapRaid, + CONTENT.TMP и CONTENT.Lock). + Перевод (Translation) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index d1346bcb..7133e41b 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -2075,6 +2075,31 @@ SnapRAID автоматически обнаруживает и нормализ строя и требуется восстановление, избегайте изменения дисков данных перед запуском `check` или `fix`. +16.9 Зарезервированные имена файлов и каталогов +----------------------------------------------- + +SnapRAID резервирует некоторые имена файлов, каталогов и снимков для +своих внутренних операций. Не используйте эти имена для пользовательских +данных: + +.snapraidignore - Локальный файл правил исключения. +.snapraid - Каталог-контейнер снимков. +snapraid-* - Имена снимков ZFS, управляемых SnapRAID. +*.unrecoverable - Поврежденные файлы, помещенные в карантин во время + восстановления. +CONTENT.tmp - Временный файл для обновлений файла content. +CONTENT.lock - Файл блокировки файла content. +PARITY.spaceholder - Временный файл резервирования места при выделении + четности в Windows. + +Использование этих имен для несвязанных данных может привести к тому, +что файлы или снимки будут проигнорированы, ошибочно приняты за метаданные, +перезаписаны, переименованы или удалены. + +В Windows все варианты регистра также зарезервированы, даже в каталогах +NTFS, настроенных с учетом регистра (например, .SNAPRAIDIGNORE, .SnapRaid, +CONTENT.TMP и CONTENT.Lock). + 17 Перевод (TRANSLATION) ======================== diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 48029dc4..9173ff54 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -2413,6 +2413,42 @@ Om alla diskar är felfria elimineras denna tvetydighet genom att slutföra det avbrutna \`sync\` innan fler ändringar görs. Om en disk har gått sönder och återställning krävs bör du undvika att ändra datadiskarna innan du kör \`check\` eller \`fix\`. +.SS Reserverade fil\- och katalognamn +SnapRAID reserverar vissa fil\-, katalog\- och ögonblicksbildnamn för sina +interna operationer. Använd inte dessa namn för användardata: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Lokal fil med exkluderingsregler. +.HP 4 +.I .snapraid +Katalog för container av ögonblicksbilder. +.HP 4 +.I snapraid\-* +ZFS\-ögonblicksbildnamn som hanteras av SnapRAID. +.HP 4 +.I *.unrecoverable +Skadade filer satta i karantän under återställning. +.HP 4 +.I CONTENT.tmp +Temporär fil för content\-uppdateringar. +.HP 4 +.I CONTENT.lock +Content\-låsfil. +.HP 4 +.I PARITY.spaceholder +Temporär platshållarfil under paritetstilldelning +i Windows. +.PD +.RE +.PP +Om du använder dessa namn för orelaterade data kan filer eller ögonblicksbilder +ignoreras, feltolkas som metadata, skrivas över, döpas om eller raderas. +.PP +I Windows är även alla skiftlägesvarianter reserverade, även i NTFS\-kataloger +som konfigurerats för att skilja på stora och små bokstäver (till exempel +.SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP och CONTENT.Lock). .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 81faa931..cba81745 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1915,6 +1915,26 @@ Kända problem (Known Issues) och återställning krävs bör du undvika att ändra datadiskarna innan du kör `check` eller `fix`. + Reserverade fil- och katalognamn + SnapRAID reserverar vissa fil-, katalog- och ögonblicksbildnamn för sina + interna operationer. Använd inte dessa namn för användardata: + + .snapraidignore - Lokal fil med exkluderingsregler. + .snapraid - Katalog för container av ögonblicksbilder. + snapraid-* - ZFS-ögonblicksbildnamn som hanteras av SnapRAID. + *.unrecoverable - Skadade filer satta i karantän under återställning. + CONTENT.tmp - Temporär fil för content-uppdateringar. + CONTENT.lock - Content-låsfil. + PARITY.spaceholder - Temporär platshållarfil under paritetstilldelning + i Windows. + + Om du använder dessa namn för orelaterade data kan filer eller ögonblicksbilder + ignoreras, feltolkas som metadata, skrivas över, döpas om eller raderas. + + I Windows är även alla skiftlägesvarianter reserverade, även i NTFS-kataloger + som konfigurerats för att skilja på stora och små bokstäver (till exempel + .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP och CONTENT.Lock). + Ö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 b429350f..beb8e6a1 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -2062,6 +2062,28 @@ det avbrutna `sync` innan fler ändringar görs. Om en disk har gått sönder och återställning krävs bör du undvika att ändra datadiskarna innan du kör `check` eller `fix`. +16.9 Reserverade fil- och katalognamn +------------------------------------- + +SnapRAID reserverar vissa fil-, katalog- och ögonblicksbildnamn för sina +interna operationer. Använd inte dessa namn för användardata: + +.snapraidignore - Lokal fil med exkluderingsregler. +.snapraid - Katalog för container av ögonblicksbilder. +snapraid-* - ZFS-ögonblicksbildnamn som hanteras av SnapRAID. +*.unrecoverable - Skadade filer satta i karantän under återställning. +CONTENT.tmp - Temporär fil för content-uppdateringar. +CONTENT.lock - Content-låsfil. +PARITY.spaceholder - Temporär platshållarfil under paritetstilldelning + i Windows. + +Om du använder dessa namn för orelaterade data kan filer eller ögonblicksbilder +ignoreras, feltolkas som metadata, skrivas över, döpas om eller raderas. + +I Windows är även alla skiftlägesvarianter reserverade, även i NTFS-kataloger +som konfigurerats för att skilja på stora och små bokstäver (till exempel +.SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP och CONTENT.Lock). + 17 ÖVERSäTTNING (TRANSLATION) ============================= diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 12d41f33..766ceae0 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -2621,6 +2621,44 @@ SnapRAID автоматично виявляє та нормалізує цей подальших змін усуває цю неоднозначність. Якщо диск вийшов з ладу і потрібне відновлення, уникайте змін на дисках даних перед запуском \`check\` або \`fix\`. +.SS Зарезервовані імена файлів і каталогів +SnapRAID резервує деякі імена файлів, каталогів і знімків для своїх +внутрішніх операцій. Не використовуйте ці імена для даних користувача: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Локальний файл правил виключення. +.HP 4 +.I .snapraid +Каталог\-контейнер знімків. +.HP 4 +.I snapraid\-* +Імена знімків ZFS, керованих SnapRAID. +.HP 4 +.I *.unrecoverable +Пошкоджені файли, поміщені в карантин під час +відновлення. +.HP 4 +.I CONTENT.tmp +Тимчасовий файл для оновлень файлу content. +.HP 4 +.I CONTENT.lock +Файл блокування файлу content. +.HP 4 +.I PARITY.spaceholder +Тимчасовий файл резервування місця під час виділення +парності у Windows. +.PD +.RE +.PP +Використання цих імен для непов\'язаних даних може призвести до того, що +файли або знімки будуть проігноровані, помилково сприйняті як метадані, +перезаписані, перейменовані або видалені. +.PP +У Windows усі варіанти регістру також зарезервовані, навіть у каталогах +NTFS, налаштованих з урахуванням регістру (наприклад, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP та CONTENT.Lock). .SH Переклад (TRANSLATION) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index 092ad5b4..9e6df76c 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -2111,6 +2111,28 @@ Name{number} потрібне відновлення, уникайте змін на дисках даних перед запуском `check` або `fix`. + Зарезервовані імена файлів і каталогів + SnapRAID резервує деякі імена файлів, каталогів і знімків для своїх + внутрішніх операцій. Не використовуйте ці імена для даних користувача: + + .snapraidignore - Локальний файл правил виключення. + .snapraid - Каталог-контейнер знімків. + snapraid-* - Імена знімків ZFS, керованих SnapRAID. + *.unrecoverable - Пошкоджені файли, поміщені в карантин під час + відновлення. + CONTENT.tmp - Тимчасовий файл для оновлень файлу content. + CONTENT.lock - Файл блокування файлу content. + PARITY.spaceholder - Тимчасовий файл резервування місця під час виділення + парності у Windows. + + Використання цих імен для непов'язаних даних може призвести до того, що + файли або знімки будуть проігноровані, помилково сприйняті як метадані, + перезаписані, перейменовані або видалені. + + У Windows усі варіанти регістру також зарезервовані, навіть у каталогах + NTFS, налаштованих з урахуванням регістру (наприклад, .SNAPRAIDIGNORE, + .SnapRaid, CONTENT.TMP та CONTENT.Lock). + Переклад (Translation) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index ac88e486..95d034d8 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -2258,6 +2258,30 @@ SnapRAID автоматично виявляє та нормалізує цей потрібне відновлення, уникайте змін на дисках даних перед запуском `check` або `fix`. +16.9 Зарезервовані імена файлів і каталогів +------------------------------------------- + +SnapRAID резервує деякі імена файлів, каталогів і знімків для своїх +внутрішніх операцій. Не використовуйте ці імена для даних користувача: + +.snapraidignore - Локальний файл правил виключення. +.snapraid - Каталог-контейнер знімків. +snapraid-* - Імена знімків ZFS, керованих SnapRAID. +*.unrecoverable - Пошкоджені файли, поміщені в карантин під час + відновлення. +CONTENT.tmp - Тимчасовий файл для оновлень файлу content. +CONTENT.lock - Файл блокування файлу content. +PARITY.spaceholder - Тимчасовий файл резервування місця під час виділення + парності у Windows. + +Використання цих імен для непов'язаних даних може призвести до того, що +файли або знімки будуть проігноровані, помилково сприйняті як метадані, +перезаписані, перейменовані або видалені. + +У Windows усі варіанти регістру також зарезервовані, навіть у каталогах +NTFS, налаштованих з урахуванням регістру (наприклад, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP та CONTENT.Lock). + 17 Переклад (TRANSLATION) ========================= diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index d09f6232..1359424b 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -2159,6 +2159,41 @@ SnapRAID 仅对选定的块进行操作,而不执行文件级别的最终化 如果所有磁盘都运行良好,在进行进一步更改之前完成中断的 \`sync\` 可以消除 这种不确定性。如果磁盘发生故障且需要恢复,在运行 \`check\` 或 \`fix\` 之前 请避免修改任何数据磁盘。 +.SS 保留的文件和目录名称 +SnapRAID 保留了一些文件、目录和快照名称用于其内部操作。请勿将这些名称 +用于用户数据: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +本地排除规则文件。 +.HP 4 +.I .snapraid +快照容器目录。 +.HP 4 +.I snapraid\-* +由 SnapRAID 管理的 ZFS 快照名称。 +.HP 4 +.I *.unrecoverable +在恢复过程中被隔离的受损文件。 +.HP 4 +.I CONTENT.tmp +用于 content 更新的临时文件。 +.HP 4 +.I CONTENT.lock +content 锁定文件。 +.HP 4 +.I PARITY.spaceholder +在 Windows 上分配奇偶校验期间使用的临时占位文件。 +.PD +.RE +.PP +将这些名称用于无关数据可能会导致文件或快照被忽略、被误认为是元数据、 +被覆盖、重命名或删除。 +.PP +在 Windows 上,所有大小写变体也都被保留,即使在配置为区分大小写的 NTFS +目录中也是如此(例如 .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP 和 +CONTENT.Lock)。 .SH 翻译 (TRANSLATION) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 77da5b93..324c5511 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1661,6 +1661,25 @@ Name{number} 这种不确定性。如果磁盘发生故障且需要恢复,在运行 `check` 或 `fix` 之前 请避免修改任何数据磁盘。 + 保留的文件和目录名称 + SnapRAID 保留了一些文件、目录和快照名称用于其内部操作。请勿将这些名称 + 用于用户数据: + + .snapraidignore - 本地排除规则文件。 + .snapraid - 快照容器目录。 + snapraid-* - 由 SnapRAID 管理的 ZFS 快照名称。 + *.unrecoverable - 在恢复过程中被隔离的受损文件。 + CONTENT.tmp - 用于 content 更新的临时文件。 + CONTENT.lock - content 锁定文件。 + PARITY.spaceholder - 在 Windows 上分配奇偶校验期间使用的临时占位文件。 + + 将这些名称用于无关数据可能会导致文件或快照被忽略、被误认为是元数据、 + 被覆盖、重命名或删除。 + + 在 Windows 上,所有大小写变体也都被保留,即使在配置为区分大小写的 NTFS + 目录中也是如此(例如 .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP 和 + CONTENT.Lock)。 + 翻译 (Translation) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 2c044ffb..76a04230 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1808,6 +1808,27 @@ SnapRAID 仅对选定的块进行操作,而不执行文件级别的最终化 这种不确定性。如果磁盘发生故障且需要恢复,在运行 `check` 或 `fix` 之前 请避免修改任何数据磁盘。 +16.9 保留的文件和目录名称 +--------------- + +SnapRAID 保留了一些文件、目录和快照名称用于其内部操作。请勿将这些名称 +用于用户数据: + +.snapraidignore - 本地排除规则文件。 +.snapraid - 快照容器目录。 +snapraid-* - 由 SnapRAID 管理的 ZFS 快照名称。 +*.unrecoverable - 在恢复过程中被隔离的受损文件。 +CONTENT.tmp - 用于 content 更新的临时文件。 +CONTENT.lock - content 锁定文件。 +PARITY.spaceholder - 在 Windows 上分配奇偶校验期间使用的临时占位文件。 + +将这些名称用于无关数据可能会导致文件或快照被忽略、被误认为是元数据、 +被覆盖、重命名或删除。 + +在 Windows 上,所有大小写变体也都被保留,即使在配置为区分大小写的 NTFS +目录中也是如此(例如 .SNAPRAIDIGNORE、.SnapRaid、CONTENT.TMP 和 +CONTENT.Lock)。 + 17 翻译 (TRANSLATION) =================== diff --git a/doc/snapraid.1 b/doc/snapraid.1 index 151c1e22..e361f5f9 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -2422,6 +2422,42 @@ If all disks are healthy, completing the interrupted \`sync\` before making further changes removes this ambiguity. If a disk has failed and recovery is required, avoid modifying any data disks before running \`check\` or \`fix\`. +.SS Reserved file and directory names +SnapRAID reserves some file, directory, and snapshot names for its internal +operation. Do not use these names for user data: +.RS 0 +.PD 0 +.HP 4 +.I .snapraidignore +Local exclusion\-rules file. +.HP 4 +.I .snapraid +Snapshot container directory. +.HP 4 +.I snapraid\-* +SnapRAID\-managed ZFS snapshot names. +.HP 4 +.I *.unrecoverable +Damaged files quarantined during recovery. +.HP 4 +.I CONTENT.tmp +Temporary file for content updates. +.HP 4 +.I CONTENT.lock +Content lock file. +.HP 4 +.I PARITY.spaceholder +Temporary space\-holder file during Windows parity +allocation. +.PD +.RE +.PP +Using these names for unrelated data may cause files or snapshots to be +ignored, misinterpreted as metadata, overwritten, renamed, or deleted. +.PP +On Windows, all case variants are reserved as well, even in NTFS directories +configured for case\-sensitive operation (for example, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP, and CONTENT.Lock). .SH COPYRIGHT This file is Copyright (C) 2026 Andrea Mazzoleni .SH SEE ALSO diff --git a/doc/snapraid.d b/doc/snapraid.d index ff89b1d9..920ac71d 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1924,6 +1924,26 @@ Known Issues is required, avoid modifying any data disks before running `check` or `fix`. + Reserved file and directory names + SnapRAID reserves some file, directory, and snapshot names for its internal + operation. Do not use these names for user data: + + .snapraidignore - Local exclusion-rules file. + .snapraid - Snapshot container directory. + snapraid-* - SnapRAID-managed ZFS snapshot names. + *.unrecoverable - Damaged files quarantined during recovery. + CONTENT.tmp - Temporary file for content updates. + CONTENT.lock - Content lock file. + PARITY.spaceholder - Temporary space-holder file during Windows parity + allocation. + + Using these names for unrelated data may cause files or snapshots to be + ignored, misinterpreted as metadata, overwritten, renamed, or deleted. + + On Windows, all case variants are reserved as well, even in NTFS directories + configured for case-sensitive operation (for example, .SNAPRAIDIGNORE, + .SnapRaid, CONTENT.TMP, and CONTENT.Lock). + Copyright This file is Copyright (C) 2026 Andrea Mazzoleni diff --git a/doc/snapraid.txt b/doc/snapraid.txt index e49bb0ac..4f425fd3 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -2071,6 +2071,28 @@ further changes removes this ambiguity. If a disk has failed and recovery is required, avoid modifying any data disks before running `check` or `fix`. +16.9 Reserved file and directory names +-------------------------------------- + +SnapRAID reserves some file, directory, and snapshot names for its internal +operation. Do not use these names for user data: + +.snapraidignore - Local exclusion-rules file. +.snapraid - Snapshot container directory. +snapraid-* - SnapRAID-managed ZFS snapshot names. +*.unrecoverable - Damaged files quarantined during recovery. +CONTENT.tmp - Temporary file for content updates. +CONTENT.lock - Content lock file. +PARITY.spaceholder - Temporary space-holder file during Windows parity + allocation. + +Using these names for unrelated data may cause files or snapshots to be +ignored, misinterpreted as metadata, overwritten, renamed, or deleted. + +On Windows, all case variants are reserved as well, even in NTFS directories +configured for case-sensitive operation (for example, .SNAPRAIDIGNORE, +.SnapRaid, CONTENT.TMP, and CONTENT.Lock). + 17 COPYRIGHT ============