From 6cab8e39092876452a12e95de45029a03d3ae014 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Wed, 12 Aug 2026 14:53:58 +0200 Subject: [PATCH] Defer pending snapshot promotion until parity sync --- cmdline/app.h | 1 + cmdline/mingwapp.c | 5 +++++ cmdline/snapraid.c | 2 +- cmdline/state.c | 54 ++++++++++++++++++++++++++++++++++++--------- cmdline/state.h | 9 ++++++-- cmdline/sync.c | 9 ++++++-- doc/snapraid-de.1 | 10 ++++++--- doc/snapraid-de.d | 10 ++++++--- doc/snapraid-de.txt | 10 ++++++--- doc/snapraid-es.1 | 10 ++++++--- doc/snapraid-es.d | 10 ++++++--- doc/snapraid-es.txt | 10 ++++++--- doc/snapraid-fr.1 | 10 ++++++--- doc/snapraid-fr.d | 10 ++++++--- doc/snapraid-fr.txt | 10 ++++++--- doc/snapraid-it.1 | 10 ++++++--- doc/snapraid-it.d | 10 ++++++--- doc/snapraid-it.txt | 10 ++++++--- doc/snapraid-ja.1 | 7 ++++-- doc/snapraid-ja.d | 7 ++++-- doc/snapraid-ja.txt | 7 ++++-- doc/snapraid-ko.1 | 7 ++++-- doc/snapraid-ko.d | 7 ++++-- doc/snapraid-ko.txt | 7 ++++-- doc/snapraid-pl.1 | 10 ++++++--- doc/snapraid-pl.d | 10 ++++++--- doc/snapraid-pl.txt | 10 ++++++--- doc/snapraid-pt.1 | 10 ++++++--- doc/snapraid-pt.d | 10 ++++++--- doc/snapraid-pt.txt | 10 ++++++--- doc/snapraid-ro.1 | 10 ++++++--- doc/snapraid-ro.d | 10 ++++++--- doc/snapraid-ro.txt | 10 ++++++--- doc/snapraid-ru.1 | 10 ++++++--- doc/snapraid-ru.d | 10 ++++++--- doc/snapraid-ru.txt | 10 ++++++--- doc/snapraid-sv.1 | 10 ++++++--- doc/snapraid-sv.d | 10 ++++++--- doc/snapraid-sv.txt | 10 ++++++--- doc/snapraid-uk.1 | 10 ++++++--- doc/snapraid-uk.d | 10 ++++++--- doc/snapraid-uk.txt | 10 ++++++--- doc/snapraid-zh.1 | 15 ++++++++----- doc/snapraid-zh.d | 15 ++++++++----- doc/snapraid-zh.txt | 15 ++++++++----- doc/snapraid.1 | 10 ++++++--- doc/snapraid.d | 10 ++++++--- doc/snapraid.txt | 10 ++++++--- 48 files changed, 352 insertions(+), 145 deletions(-) diff --git a/cmdline/app.h b/cmdline/app.h index c0e8cc25..28584a06 100644 --- a/cmdline/app.h +++ b/cmdline/app.h @@ -61,6 +61,7 @@ int fsinfo(const char* path, int* has_persistent_inode, int* has_syncronized_har */ #define SNAPSHOT_PENDING "pending" #define SNAPSHOT_STABLE "stable" +#define SNAPSHOT_SCAN "scan" /* * Snapshots context diff --git a/cmdline/mingwapp.c b/cmdline/mingwapp.c index 01e9e543..df10bccc 100644 --- a/cmdline/mingwapp.c +++ b/cmdline/mingwapp.c @@ -487,6 +487,10 @@ int fssnapshot_mount(const char* dir, struct fssnapshot_struct* fss) return -1; } + if (windows_rebuild_link(fss, SNAPSHOT_SCAN) != 0) { + return -1; + } + fss->magic = magic; return 0; @@ -678,6 +682,7 @@ void fssnapshot_unmount(const struct fssnapshot_struct* fss) */ windows_delete_link(fss, SNAPSHOT_PENDING); windows_delete_link(fss, SNAPSHOT_STABLE); + windows_delete_link(fss, SNAPSHOT_SCAN); } /****************************************************************************/ diff --git a/cmdline/snapraid.c b/cmdline/snapraid.c index d4b4e5f6..4b37a723 100644 --- a/cmdline/snapraid.c +++ b/cmdline/snapraid.c @@ -1806,7 +1806,7 @@ int snapraid_main(int argc, char* argv[]) state_write(&state); } - ret = state_snapshot_new(&state); + ret = state_snapshot_scan(&state); if (ret != 0) { exit(EXIT_FAILURE); } diff --git a/cmdline/state.c b/cmdline/state.c index 7ff7d838..e8914296 100644 --- a/cmdline/state.c +++ b/cmdline/state.c @@ -5956,7 +5956,7 @@ static int state_snapshot_dir(struct fssnapshot_struct* fss, const char* name, c return 0; } -int state_snapshot_new(struct snapraid_state* state) +int state_snapshot_scan(struct snapraid_state* state) { if (!state->snapshot) return 0; @@ -5970,7 +5970,45 @@ int state_snapshot_new(struct snapraid_state* state) size_t root_len = strlen(disk->fss.root_dir); - /* delete a potential previous pending snapshot */ + /* delete a potential previous scan snapshot */ + if (state_snapshot_dir(&disk->fss, SNAPSHOT_SCAN, 0, 0) == 0) { + if (fssnapshot_delete(&disk->fss, SNAPSHOT_SCAN) != 0) { + log_fatal(errno, "Failed to delete scan snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + } + + /* create a new snapshot for scanning */ + if (fssnapshot_create(&disk->fss, SNAPSHOT_SCAN) != 0) { + log_fatal(errno, "Failed to create scan snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + + msg_progress("Created disk %s scan snapshot...\n", disk->name); + + /* setup the snapshot in use */ + if (state_snapshot_dir(&disk->fss, SNAPSHOT_SCAN, disk->mount_point + root_len, disk) != 0) { + log_error(errno, "Error stating scan snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + } + + return 0; +} + +int state_snapshot_pending(struct snapraid_state* state) +{ + if (!state->snapshot) + return 0; + + for (tommy_node* i = state->disklist; i != 0; i = i->next) { + struct snapraid_disk* disk = i->data; + + /* check if it supports snapshot */ + if (disk->fss.magic == 0) + continue; + + /* delete the pending snapshot only after the content state was saved */ if (state_snapshot_dir(&disk->fss, SNAPSHOT_PENDING, 0, 0) == 0) { if (fssnapshot_delete(&disk->fss, SNAPSHOT_PENDING) != 0) { log_fatal(errno, "Failed to delete pending snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); @@ -5978,19 +6016,13 @@ int state_snapshot_new(struct snapraid_state* state) } } - /* create a new snapshot */ - if (fssnapshot_create(&disk->fss, SNAPSHOT_PENDING) != 0) { - log_fatal(errno, "Failed to create pending snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + /* make the scan snapshot available for recovery */ + if (fssnapshot_rename(&disk->fss, SNAPSHOT_SCAN, SNAPSHOT_PENDING) != 0) { + log_fatal(errno, "Failed to rename scan snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); return -1; } msg_progress("Created disk %s pending snapshot...\n", disk->name); - - /* setup the snapshot in use */ - if (state_snapshot_dir(&disk->fss, SNAPSHOT_PENDING, disk->mount_point + root_len, disk) != 0) { - log_error(errno, "Error stating pending snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); - return -1; - } } return 0; diff --git a/cmdline/state.h b/cmdline/state.h index 5a2d4f9e..5801c339 100644 --- a/cmdline/state.h +++ b/cmdline/state.h @@ -426,9 +426,14 @@ void state_load_ignore_file(tommy_list* filter_list, const char* path, const cha void state_attr(struct snapraid_state* state, tommy_list* low); /** - * Create (or reuse existing) pending snapshots + * Create (or reuse existing) scan snapshots */ -int state_snapshot_new(struct snapraid_state* state); +int state_snapshot_scan(struct snapraid_state* state); + +/** + * Promote scan snapshots to pending before starting parity processing. + */ +int state_snapshot_pending(struct snapraid_state* state); /** * Make the pending snapshots as stable diff --git a/cmdline/sync.c b/cmdline/sync.c index 59a379e3..cbddf8af 100644 --- a/cmdline/sync.c +++ b/cmdline/sync.c @@ -1691,8 +1691,13 @@ int state_sync(struct snapraid_state* state, block_off_t blockstart, block_off_t exit(EXIT_SUCCESS); } - /* skip degenerated cases of empty parity, or skipping all */ - if (blockstart < blockmax) { + /* make the scanned state available for recovery before changing parity */ + if (state_snapshot_pending(state) != 0) { + /* LCOV_EXCL_START */ + ++process_error; + /* continue, as we are already exiting */ + /* LCOV_EXCL_STOP */ + } else if (blockstart < blockmax) { ret = state_sync_process(state, parity_handle, blockstart, blockmax); if (ret == -1) { /* LCOV_EXCL_START */ diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index e034b2ea..3ed00861 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -2016,7 +2016,7 @@ In diesem Fall verwenden \`check\` und \`fix\` ausschließlich die Live\-Dateisy .PP Alle anderen Befehle arbeiten ausschließlich auf dem Live\-Dateisystem. .SH LEBENSZYKLUS VON SNAPSHOTS (SNAPSHOTS LIFECYCLE) -SnapRAID verwaltet zwei spezifische Snapshots, \`stable\` und \`pending\`, +SnapRAID verwaltet drei spezifische Snapshots, \`stable\`, \`pending\` und \`scan\`, in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten\-Subvolumes. Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis \`.snapraid/\` verwendet, unter ZFS das Standardverzeichnis \`.zfs/snapshot/\`. @@ -2026,8 +2026,12 @@ erfolgreich abgeschlossenen \`sync\` und enthält die genauen Daten, die zur Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle für die Befehle \`scrub\`, \`check\` und \`fix\`. .PP -Der \`pending\`\-Snapshot ist ein temporäres Abbild, das zu Beginn eines \`sync\` -erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen. +Der \`scan\`\-Snapshot ist ein temporäres Abbild, das zu Beginn eines \`sync\` +erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. +Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen +\`pending\`\-Snapshot. +.PP +Der \`pending\`\-Snapshot ist das Abbild, das von einem unterbrochenen \`sync\` verwendet wird. Nach erfolgreichem Abschluss des Vorgangs wird der vorherige \`stable\`\-Snapshot gelöscht und der \`pending\`\-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen. .PP diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 24a5416f..10d5480d 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -1609,7 +1609,7 @@ Snapshots Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem. Lebenszyklus von Snapshots (Snapshots Lifecycle) - SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`, + SnapRAID verwaltet drei spezifische Snapshots, `stable`, `pending` und `scan`, in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten-Subvolumes. Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis `.snapraid/` verwendet, unter ZFS das Standardverzeichnis `.zfs/snapshot/`. @@ -1619,8 +1619,12 @@ Lebenszyklus von Snapshots (Snapshots Lifecycle) Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle für die Befehle `scrub`, `check` und `fix`. - Der `pending`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` - erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen. + Der `scan`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` + erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. + Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen + `pending`-Snapshot. + + Der `pending`-Snapshot ist das Abbild, das von einem unterbrochenen `sync` verwendet wird. Nach erfolgreichem Abschluss des Vorgangs wird der vorherige `stable`-Snapshot gelöscht und der `pending`-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen. diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 930490d4..4d621688 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -1719,7 +1719,7 @@ Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem. 9 LEBENSZYKLUS VON SNAPSHOTS (SNAPSHOTS LIFECYCLE) ================================================== -SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`, +SnapRAID verwaltet drei spezifische Snapshots, `stable`, `pending` und `scan`, in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten-Subvolumes. Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis `.snapraid/` verwendet, unter ZFS das Standardverzeichnis `.zfs/snapshot/`. @@ -1729,8 +1729,12 @@ erfolgreich abgeschlossenen `sync` und enthält die genauen Daten, die zur Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle für die Befehle `scrub`, `check` und `fix`. -Der `pending`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` -erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen. +Der `scan`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` +erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. +Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen +`pending`-Snapshot. + +Der `pending`-Snapshot ist das Abbild, das von einem unterbrochenen `sync` verwendet wird. Nach erfolgreichem Abschluss des Vorgangs wird der vorherige `stable`-Snapshot gelöscht und der `pending`-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen. diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index a72b4e33..223f01b4 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -1975,7 +1975,7 @@ de archivos activos exclusivamente. .PP Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. .SH CICLO DE VIDA DE LAS INSTANTáNEAS (SNAPSHOTS LIFECYCLE) -SnapRAID gestiona dos instantáneas específicas, \`stable\` y \`pending\`, +SnapRAID gestiona tres instantáneas específicas, \`stable\`, \`pending\` y \`scan\`, dentro de un directorio oculto en la raíz de cada subvolumen de datos. En Btrfs, Bcachefs y NTFS se utiliza el directorio \`.snapraid/\`, en ZFS el estándar \`.zfs/snapshot/\`. @@ -1985,8 +1985,12 @@ La instantánea \`stable\` representa el estado del último calcular la paridad actual. Sirve como fuente de datos principal para los comandos \`scrub\`, \`check\` y \`fix\`. .PP -La instantánea \`pending\` es una imagen temporal creada al inicio -de un \`sync\` para proporcionar un estado congelado para el cómputo de paridad. +La instantánea \`scan\` es una imagen temporal creada al inicio +de un \`sync\` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. +Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea +\`pending\` anterior. +.PP +La instantánea \`pending\` es la imagen utilizada por un \`sync\` interrumpido. Una vez completada con éxito la operación, la instantánea \`stable\` anterior se elimina y la instantánea \`pending\` se promueve para tomar su lugar como la nueva referencia estable. diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index eaf7a167..62978e12 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -1579,7 +1579,7 @@ Instantáneas (Snapshots) Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. Ciclo de vida de las instantáneas (Snapshots Lifecycle) - SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`, + SnapRAID gestiona tres instantáneas específicas, `stable`, `pending` y `scan`, dentro de un directorio oculto en la raíz de cada subvolumen de datos. En Btrfs, Bcachefs y NTFS se utiliza el directorio `.snapraid/`, en ZFS el estándar `.zfs/snapshot/`. @@ -1589,8 +1589,12 @@ Ciclo de vida de las instantáneas (Snapshots Lifecycle) calcular la paridad actual. Sirve como fuente de datos principal para los comandos `scrub`, `check` y `fix`. - La instantánea `pending` es una imagen temporal creada al inicio - de un `sync` para proporcionar un estado congelado para el cómputo de paridad. + La instantánea `scan` es una imagen temporal creada al inicio + de un `sync` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. + Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea + `pending` anterior. + + La instantánea `pending` es la imagen utilizada por un `sync` interrumpido. Una vez completada con éxito la operación, la instantánea `stable` anterior se elimina y la instantánea `pending` se promueve para tomar su lugar como la nueva referencia estable. diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 0f06e902..663f3ee2 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -1689,7 +1689,7 @@ Todos los demás comandos funcionan exclusivamente en el sistema de archivos act 9 CICLO DE VIDA DE LAS INSTANTáNEAS (SNAPSHOTS LIFECYCLE) ========================================================= -SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`, +SnapRAID gestiona tres instantáneas específicas, `stable`, `pending` y `scan`, dentro de un directorio oculto en la raíz de cada subvolumen de datos. En Btrfs, Bcachefs y NTFS se utiliza el directorio `.snapraid/`, en ZFS el estándar `.zfs/snapshot/`. @@ -1699,8 +1699,12 @@ La instantánea `stable` representa el estado del último calcular la paridad actual. Sirve como fuente de datos principal para los comandos `scrub`, `check` y `fix`. -La instantánea `pending` es una imagen temporal creada al inicio -de un `sync` para proporcionar un estado congelado para el cómputo de paridad. +La instantánea `scan` es una imagen temporal creada al inicio +de un `sync` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. +Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea +`pending` anterior. + +La instantánea `pending` es la imagen utilizada por un `sync` interrumpido. Una vez completada con éxito la operación, la instantánea `stable` anterior se elimina y la instantánea `pending` se promueve para tomar su lugar como la nueva referencia estable. diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 8d91a8c4..70a7fc96 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -2011,7 +2011,7 @@ les systèmes de fichiers actifs. .PP Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif. .SH CYCLE DE VIE DES INSTANTANéS (SNAPSHOTS LIFECYCLE) -SnapRAID gère deux instantanés spécifiques, \`stable\` et \`pending\`, +SnapRAID gère trois instantanés spécifiques, \`stable\`, \`pending\` et \`scan\`, dans un répertoire caché à la racine de chaque sous\-volume de données. Dans Btrfs, Bcachefs et NTFS, le répertoire \`.snapraid/\` est utilisé, dans ZFS, le répertoire standard \`.zfs/snapshot/\`. @@ -2021,8 +2021,12 @@ L\'instantané \`stable\` représente l\'état du dernier calculer la parité actuelle. Il sert de source de données principale pour les commandes \`scrub\`, \`check\` et \`fix\`. .PP -L\'instantané \`pending\` est une image temporaire créée au début -d\'un \`sync\` pour fournir un état figé pour le calcul de la parité. +L\'instantané \`scan\` est une image temporaire créée au début +d\'un \`sync\` pour fournir un état figé pour le balayage et le calcul de la parité. +Après le balayage et l\'enregistrement du nouvel état du contenu, il remplace l\'instantané +\`pending\` précédent. +.PP +L\'instantané \`pending\` est l\'image utilisée par un \`sync\` interrompu. Une fois l\'opération terminée avec succès, l\'instantané \`stable\` précédent est supprimé, et l\'instantané \`pending\` est promu pour prendre sa place en tant que nouvelle référence stable. diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 25fcf135..fdfb717b 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -1615,7 +1615,7 @@ Snapshots Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif. Cycle de vie des instantanés (Snapshots Lifecycle) - SnapRAID gère deux instantanés spécifiques, `stable` et `pending`, + SnapRAID gère trois instantanés spécifiques, `stable`, `pending` et `scan`, dans un répertoire caché à la racine de chaque sous-volume de données. Dans Btrfs, Bcachefs et NTFS, le répertoire `.snapraid/` est utilisé, dans ZFS, le répertoire standard `.zfs/snapshot/`. @@ -1625,8 +1625,12 @@ Cycle de vie des instantanés (Snapshots Lifecycle) calculer la parité actuelle. Il sert de source de données principale pour les commandes `scrub`, `check` et `fix`. - L'instantané `pending` est une image temporaire créée au début - d'un `sync` pour fournir un état figé pour le calcul de la parité. + L'instantané `scan` est une image temporaire créée au début + d'un `sync` pour fournir un état figé pour le balayage et le calcul de la parité. + Après le balayage et l'enregistrement du nouvel état du contenu, il remplace l'instantané + `pending` précédent. + + L'instantané `pending` est l'image utilisée par un `sync` interrompu. Une fois l'opération terminée avec succès, l'instantané `stable` précédent est supprimé, et l'instantané `pending` est promu pour prendre sa place en tant que nouvelle référence stable. diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 5232cc98..30c11364 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -1725,7 +1725,7 @@ Toutes les autres commandes fonctionnent exclusivement sur le système de fichie 9 CYCLE DE VIE DES INSTANTANéS (SNAPSHOTS LIFECYCLE) ==================================================== -SnapRAID gère deux instantanés spécifiques, `stable` et `pending`, +SnapRAID gère trois instantanés spécifiques, `stable`, `pending` et `scan`, dans un répertoire caché à la racine de chaque sous-volume de données. Dans Btrfs, Bcachefs et NTFS, le répertoire `.snapraid/` est utilisé, dans ZFS, le répertoire standard `.zfs/snapshot/`. @@ -1735,8 +1735,12 @@ L'instantané `stable` représente l'état du dernier calculer la parité actuelle. Il sert de source de données principale pour les commandes `scrub`, `check` et `fix`. -L'instantané `pending` est une image temporaire créée au début -d'un `sync` pour fournir un état figé pour le calcul de la parité. +L'instantané `scan` est une image temporaire créée au début +d'un `sync` pour fournir un état figé pour le balayage et le calcul de la parité. +Après le balayage et l'enregistrement du nouvel état du contenu, il remplace l'instantané +`pending` précédent. + +L'instantané `pending` est l'image utilisée par un `sync` interrompu. Une fois l'opération terminée avec succès, l'instantané `stable` précédent est supprimé, et l'instantané `pending` est promu pour prendre sa place en tant que nouvelle référence stable. diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index a134763b..c8ffa407 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -1997,7 +1997,7 @@ i file system live. .PP Tutti gli altri comandi operano esclusivamente sul file system live. .SH CICLO DI VITA DEGLI SNAPSHOT (SNAPSHOTS LIFECYCLE) -SnapRAID gestisce due snapshot specifici, \`stable\` e \`pending\`, +SnapRAID gestisce tre snapshot specifici, \`stable\`, \`pending\` e \`scan\`, all\'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory \`.snapraid/\`, in ZFS quella standard \`.zfs/snapshot/\`. @@ -2007,8 +2007,12 @@ Lo snapshot \`stable\` rappresenta lo stato dell\'ultimo computare la parità corrente. Funge da fonte di dati primaria per i comandi \`scrub\`, \`check\` e \`fix\`. .PP -Lo snapshot \`pending\` è un\'immagine temporanea creata all\'inizio -di un \`sync\` per fornire uno stato congelato per il calcolo della parità. +Lo snapshot \`scan\` è un\'immagine temporanea creata all\'inizio +di un \`sync\` per fornire uno stato congelato per la scansione e il calcolo della parità. +Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente +snapshot \`pending\`. +.PP +Lo snapshot \`pending\` è l\'immagine utilizzata da un \`sync\` interrotto. Al completamento con successo dell\'operazione, il precedente snapshot \`stable\` viene eliminato e lo snapshot \`pending\` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 859e4cbb..27892e70 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -1590,7 +1590,7 @@ Snapshot (Snapshots) Tutti gli altri comandi operano esclusivamente sul file system live. Ciclo di vita degli snapshot (Snapshots Lifecycle) - SnapRAID gestisce due snapshot specifici, `stable` e `pending`, + SnapRAID gestisce tre snapshot specifici, `stable`, `pending` e `scan`, all'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory `.snapraid/`, in ZFS quella standard `.zfs/snapshot/`. @@ -1600,8 +1600,12 @@ Ciclo di vita degli snapshot (Snapshots Lifecycle) computare la parità corrente. Funge da fonte di dati primaria per i comandi `scrub`, `check` e `fix`. - Lo snapshot `pending` è un'immagine temporanea creata all'inizio - di un `sync` per fornire uno stato congelato per il calcolo della parità. + Lo snapshot `scan` è un'immagine temporanea creata all'inizio + di un `sync` per fornire uno stato congelato per la scansione e il calcolo della parità. + Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente + snapshot `pending`. + + Lo snapshot `pending` è l'immagine utilizzata da un `sync` interrotto. Al completamento con successo dell'operazione, il precedente snapshot `stable` viene eliminato e lo snapshot `pending` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index ec59da23..95c8d6de 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -1700,7 +1700,7 @@ Tutti gli altri comandi operano esclusivamente sul file system live. 9 CICLO DI VITA DEGLI SNAPSHOT (SNAPSHOTS LIFECYCLE) ==================================================== -SnapRAID gestisce due snapshot specifici, `stable` e `pending`, +SnapRAID gestisce tre snapshot specifici, `stable`, `pending` e `scan`, all'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory `.snapraid/`, in ZFS quella standard `.zfs/snapshot/`. @@ -1710,8 +1710,12 @@ Lo snapshot `stable` rappresenta lo stato dell'ultimo computare la parità corrente. Funge da fonte di dati primaria per i comandi `scrub`, `check` e `fix`. -Lo snapshot `pending` è un'immagine temporanea creata all'inizio -di un `sync` per fornire uno stato congelato per il calcolo della parità. +Lo snapshot `scan` è un'immagine temporanea creata all'inizio +di un `sync` per fornire uno stato congelato per la scansione e il calcolo della parità. +Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente +snapshot `pending`. + +Lo snapshot `pending` è l'immagine utilizzata da un `sync` interrotto. Al completamento con successo dell'operazione, il precedente snapshot `stable` viene eliminato e lo snapshot `pending` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index af893ffd..ed922017 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -1787,7 +1787,7 @@ SnapRAIDはライブファイルシステム上での同時ファイル変更に 他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。 .SH スナップショットのライフサイクル (SNAPSHOTS LIFECYCLE) SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 -\`stable\`（安定）と \`pending\`（保留）という2つの特定のスナップショットを管理します。 +\`stable\`（安定）、\`pending\`（保留）、および \`scan\`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは \`.snapraid/\` ディレクトリが使用され、 ZFSでは標準の \`.zfs/snapshot/\` が使用されます。 .PP @@ -1795,8 +1795,11 @@ ZFSでは標準の \`.zfs/snapshot/\` が使用されます。 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 \`scrub\`、\`check\`、および \`fix\` コマンドの主要なデータソースとして機能します。 .PP -\`pending\` スナップショットは、パリティ計算のための凍結された状態を提供するために、 +\`scan\` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 \`sync\` の開始時に作成される一時的なイメージです。 +スキャンを実行し、新しいコンテンツ状態を保存した後、以前の \`pending\` スナップショットを置き換えます。 +.PP +\`pending\` スナップショットは、中断された \`sync\` によって使用されるイメージです。 操作が正常に完了すると、以前の \`stable\` スナップショットが削除され、 \`pending\` スナップショットが新しい安定した参照として昇格します。 .PP diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 30289db9..8ab93439 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1391,7 +1391,7 @@ Name{number} スナップショットのライフサイクル (Snapshots Lifecycle) SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 - `stable`（安定）と `pending`（保留）という2つの特定のスナップショットを管理します。 + `stable`（安定）、`pending`（保留）、および `scan`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、 ZFSでは標準の `.zfs/snapshot/` が使用されます。 @@ -1399,8 +1399,11 @@ Name{number} 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 `scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。 - `pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、 + `scan` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 `sync` の開始時に作成される一時的なイメージです。 + スキャンを実行し、新しいコンテンツ状態を保存した後、以前の `pending` スナップショットを置き換えます。 + + `pending` スナップショットは、中断された `sync` によって使用されるイメージです。 操作が正常に完了すると、以前の `stable` スナップショットが削除され、 `pending` スナップショットが新しい安定した参照として昇格します。 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 0390845d..e2ca8f4d 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1501,7 +1501,7 @@ SnapRAIDはライブファイルシステム上での同時ファイル変更に ======================================== SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 -`stable`（安定）と `pending`（保留）という2つの特定のスナップショットを管理します。 +`stable`（安定）、`pending`（保留）、および `scan`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、 ZFSでは標準の `.zfs/snapshot/` が使用されます。 @@ -1509,8 +1509,11 @@ ZFSでは標準の `.zfs/snapshot/` が使用されます。 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 `scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。 -`pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、 +`scan` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 `sync` の開始時に作成される一時的なイメージです。 +スキャンを実行し、新しいコンテンツ状態を保存した後、以前の `pending` スナップショットを置き換えます。 + +`pending` スナップショットは、中断された `sync` によって使用されるイメージです。 操作が正常に完了すると、以前の `stable` スナップショットが削除され、 `pending` スナップショットが新しい安定した参照として昇格します。 diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 56425914..5b78c7e3 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -1833,7 +1833,7 @@ SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에 다른 모든 명령어는 라이브 파일시스템에서만 독점적으로 작동합니다. .SH 스냅샷 수명 주기 (SNAPSHOTS LIFECYCLE) SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 -\`stable\`(안정)과 \`pending\`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. +\`stable\`(안정), \`pending\`(보류) 및 \`scan\`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 \`.snapraid/\` 디렉터리가 사용되며, ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. .PP @@ -1841,8 +1841,11 @@ ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 \`scrub\`, \`check\` 및 \`fix\` 명령어의 기본 데이터 소스 역할을 합니다. .PP -\`pending\` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 +\`scan\` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 생성되는 임시 이미지입니다. +검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 \`pending\` 스냅샷을 대체합니다. +.PP +\`pending\` 스냅샷은 중단된 \`sync\` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 \`stable\` 스냅샷은 삭제되고, \`pending\` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. .PP diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 21e5ab25..d24227b1 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1437,7 +1437,7 @@ Name{number} 스냅샷 수명 주기 (Snapshots Lifecycle) SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 - `stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. + `stable`(안정), `pending`(보류) 및 `scan`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며, ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. @@ -1445,8 +1445,11 @@ Name{number} 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. - `pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 + `scan` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. + 검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 `pending` 스냅샷을 대체합니다. + + `pending` 스냅샷은 중단된 `sync` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index 81c375b6..362bd70a 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1547,7 +1547,7 @@ Windows의 일반적인 설정 예는 다음과 같습니다: ================================= SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 -`stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. +`stable`(안정), `pending`(보류) 및 `scan`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며, ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. @@ -1555,8 +1555,11 @@ ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. -`pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 +`scan` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. +검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 `pending` 스냅샷을 대체합니다. + +`pending` 스냅샷은 중단된 `sync` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 1afcfda4..0007420b 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -1896,7 +1896,7 @@ aktywnych systemów plików. .PP Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. .SH CYKL żYCIA MIGAWEK (SNAPSHOTS LIFECYCLE) -SnapRAID zarządza dwoma określonymi migawkami, \`stable\` (stabilną) oraz \`pending\` (oczekującą), +SnapRAID zarządza trzema określonymi migawkami, \`stable\` (stabilną), \`pending\` (oczekującą) oraz \`scan\` (skanowania), w ukrytym katalogu w katalogu głównym każdego podwolumenu danych. W systemach Btrfs, Bcachefs i NTFS używany jest katalog \`.snapraid/\`, w systemie ZFS standardowy \`.zfs/snapshot/\`. @@ -1906,8 +1906,12 @@ pomyślnie zakończonej operacji \`sync\`, zawierając dokładne dane użyte do obliczenia bieżącej parzystości. Służy ona jako główne źródło danych dla poleceń \`scrub\`, \`check\` i \`fix\`. .PP -Migawka \`pending\` to tymczasowy obraz tworzony na początku -operacji \`sync\` w celu zapewnienia zamrożonego stanu do obliczenia parzystości. +Migawka \`scan\` to tymczasowy obraz tworzony na początku +operacji \`sync\` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. +Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią +migawkę \`pending\`. +.PP +Migawka \`pending\` to obraz używany przez przerwaną operację \`sync\`. Po pomyślnym zakończeniu operacji poprzednia migawka \`stable\` jest usuwana, a migawka \`pending\` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 94185e0f..9ad83a7b 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1500,7 +1500,7 @@ Migawki (Snapshots) Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. Cykl życia migawek (Snapshots Lifecycle) - SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą), + SnapRAID zarządza trzema określonymi migawkami, `stable` (stabilną), `pending` (oczekującą) oraz `scan` (skanowania), w ukrytym katalogu w katalogu głównym każdego podwolumenu danych. W systemach Btrfs, Bcachefs i NTFS używany jest katalog `.snapraid/`, w systemie ZFS standardowy `.zfs/snapshot/`. @@ -1510,8 +1510,12 @@ Cykl życia migawek (Snapshots Lifecycle) obliczenia bieżącej parzystości. Służy ona jako główne źródło danych dla poleceń `scrub`, `check` i `fix`. - Migawka `pending` to tymczasowy obraz tworzony na początku - operacji `sync` w celu zapewnienia zamrożonego stanu do obliczenia parzystości. + Migawka `scan` to tymczasowy obraz tworzony na początku + operacji `sync` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. + Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią + migawkę `pending`. + + Migawka `pending` to obraz używany przez przerwaną operację `sync`. Po pomyślnym zakończeniu operacji poprzednia migawka `stable` jest usuwana, a migawka `pending` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 6b705df4..a08ec727 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1610,7 +1610,7 @@ Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. 9 CYKL żYCIA MIGAWEK (SNAPSHOTS LIFECYCLE) ========================================== -SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą), +SnapRAID zarządza trzema określonymi migawkami, `stable` (stabilną), `pending` (oczekującą) oraz `scan` (skanowania), w ukrytym katalogu w katalogu głównym każdego podwolumenu danych. W systemach Btrfs, Bcachefs i NTFS używany jest katalog `.snapraid/`, w systemie ZFS standardowy `.zfs/snapshot/`. @@ -1620,8 +1620,12 @@ pomyślnie zakończonej operacji `sync`, zawierając dokładne dane użyte do obliczenia bieżącej parzystości. Służy ona jako główne źródło danych dla poleceń `scrub`, `check` i `fix`. -Migawka `pending` to tymczasowy obraz tworzony na początku -operacji `sync` w celu zapewnienia zamrożonego stanu do obliczenia parzystości. +Migawka `scan` to tymczasowy obraz tworzony na początku +operacji `sync` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. +Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią +migawkę `pending`. + +Migawka `pending` to obraz używany przez przerwaną operację `sync`. Po pomyślnym zakończeniu operacji poprzednia migawka `stable` jest usuwana, a migawka `pending` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index a86d2c26..2df4f8d6 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -1933,7 +1933,7 @@ de arquivos ativos exclusivamente. .PP Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. .SH CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) -O SnapRAID gerencia dois instantâneos específicos, \`stable\` (estável) e \`pending\` (pendente), +O SnapRAID gerencia três instantâneos específicos, \`stable\` (estável), \`pending\` (pendente) e \`scan\` (verificação), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório \`.snapraid/\`, em ZFS o padrão \`.zfs/snapshot/\`. @@ -1943,8 +1943,12 @@ O instantâneo \`stable\` representa o estado do último computar a paridade atual. Serve como a principal fonte de dados para os comandos \`scrub\`, \`check\` e \`fix\`. .PP -O instantâneo \`pending\` é uma imagem temporária criada ao início -de um \`sync\` para fornecer um estado congelado para a computação da paridade. +O instantâneo \`scan\` é uma imagem temporária criada ao início +de um \`sync\` para fornecer um estado congelado para a verificação e a computação da paridade. +Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo +\`pending\` anterior. +.PP +O instantâneo \`pending\` é a imagem usada por um \`sync\` interrompido. Após a conclusão bem\-sucedida da operação, o instantâneo \`stable\` anterior é excluído, e o instantâneo \`pending\` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index 1714badc..32e91a1f 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1537,7 +1537,7 @@ Instantâneos (Snapshots) Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) - O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), + O SnapRAID gerencia três instantâneos específicos, `stable` (estável), `pending` (pendente) e `scan` (verificação), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`, em ZFS o padrão `.zfs/snapshot/`. @@ -1547,8 +1547,12 @@ Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) computar a paridade atual. Serve como a principal fonte de dados para os comandos `scrub`, `check` e `fix`. - O instantâneo `pending` é uma imagem temporária criada ao início - de um `sync` para fornecer um estado congelado para a computação da paridade. + O instantâneo `scan` é uma imagem temporária criada ao início + de um `sync` para fornecer um estado congelado para a verificação e a computação da paridade. + Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo + `pending` anterior. + + O instantâneo `pending` é a imagem usada por um `sync` interrompido. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index eaf8a557..5cc9c9a2 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -1647,7 +1647,7 @@ Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. 9 CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) ====================================================== -O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), +O SnapRAID gerencia três instantâneos específicos, `stable` (estável), `pending` (pendente) e `scan` (verificação), dentro de um diretório oculto na raiz de cada subvolume de dados. Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`, em ZFS o padrão `.zfs/snapshot/`. @@ -1657,8 +1657,12 @@ O instantâneo `stable` representa o estado do último computar a paridade atual. Serve como a principal fonte de dados para os comandos `scrub`, `check` e `fix`. -O instantâneo `pending` é uma imagem temporária criada ao início -de um `sync` para fornecer um estado congelado para a computação da paridade. +O instantâneo `scan` é uma imagem temporária criada ao início +de um `sync` para fornecer um estado congelado para a verificação e a computação da paridade. +Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo +`pending` anterior. + +O instantâneo `pending` é a imagem usada por um `sync` interrompido. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index f7d6e61a..3092336f 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -1894,7 +1894,7 @@ sistemele de fișiere live. .PP Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. .SH CICLUL DE VIAță AL SNAPSHOT\-URILOR (SNAPSHOTS LIFECYCLE) -SnapRAID gestionează două snapshot\-uri specifice, \`stable\` și \`pending\`, +SnapRAID gestionează trei snapshot\-uri specifice, \`stable\`, \`pending\` și \`scan\`, într\-un director ascuns la rădăcina fiecărui subvolum de date. În Btrfs, Bcachefs și NTFS se folosește directorul \`.snapraid/\`, în ZFS cel standard \`.zfs/snapshot/\`. @@ -1904,8 +1904,12 @@ Snapshot\-ul \`stable\` reprezintă starea ultimului a calcula paritatea curentă. Acesta servește ca sursă principală de date pentru comenzile \`scrub\`, \`check\` și \`fix\`. .PP -Snapshot\-ul \`pending\` este o imagine temporară creată la începutul -unui \`sync\` pentru a oferi o stare înghețată pentru calculul parității. +Snapshot\-ul \`scan\` este o imagine temporară creată la începutul +unui \`sync\` pentru a oferi o stare înghețată pentru scanare și calculul parității. +După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot\-ul +\`pending\` anterior. +.PP +Snapshot\-ul \`pending\` este imaginea utilizată de un \`sync\` întrerupt. După finalizarea cu succes a operațiunii, snapshot\-ul \`stable\` anterior este șters, iar snapshot\-ul \`pending\` este promovat pentru a\-i lua locul ca nouă referință stabilă. diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index a9247729..82db5974 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1498,7 +1498,7 @@ Snapshot-uri (Snapshots) Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. Ciclul de viață al snapshot-urilor (Snapshots Lifecycle) - SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`, + SnapRAID gestionează trei snapshot-uri specifice, `stable`, `pending` și `scan`, într-un director ascuns la rădăcina fiecărui subvolum de date. În Btrfs, Bcachefs și NTFS se folosește directorul `.snapraid/`, în ZFS cel standard `.zfs/snapshot/`. @@ -1508,8 +1508,12 @@ Ciclul de viață al snapshot-urilor (Snapshots Lifecycle) a calcula paritatea curentă. Acesta servește ca sursă principală de date pentru comenzile `scrub`, `check` și `fix`. - Snapshot-ul `pending` este o imagine temporară creată la începutul - unui `sync` pentru a oferi o stare înghețată pentru calculul parității. + Snapshot-ul `scan` este o imagine temporară creată la începutul + unui `sync` pentru a oferi o stare înghețată pentru scanare și calculul parității. + După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot-ul + `pending` anterior. + + Snapshot-ul `pending` este imaginea utilizată de un `sync` întrerupt. După finalizarea cu succes a operațiunii, snapshot-ul `stable` anterior este șters, iar snapshot-ul `pending` este promovat pentru a-i lua locul ca nouă referință stabilă. diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 8ea6f639..3a29efe5 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -1608,7 +1608,7 @@ Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. 9 CICLUL DE VIAță AL SNAPSHOT-URILOR (SNAPSHOTS LIFECYCLE) ========================================================== -SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`, +SnapRAID gestionează trei snapshot-uri specifice, `stable`, `pending` și `scan`, într-un director ascuns la rădăcina fiecărui subvolum de date. În Btrfs, Bcachefs și NTFS se folosește directorul `.snapraid/`, în ZFS cel standard `.zfs/snapshot/`. @@ -1618,8 +1618,12 @@ Snapshot-ul `stable` reprezintă starea ultimului a calcula paritatea curentă. Acesta servește ca sursă principală de date pentru comenzile `scrub`, `check` și `fix`. -Snapshot-ul `pending` este o imagine temporară creată la începutul -unui `sync` pentru a oferi o stare înghețată pentru calculul parității. +Snapshot-ul `scan` este o imagine temporară creată la începutul +unui `sync` pentru a oferi o stare înghețată pentru scanare și calculul parității. +După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot-ul +`pending` anterior. + +Snapshot-ul `pending` este imaginea utilizată de un `sync` întrerupt. După finalizarea cu succes a operațiunii, snapshot-ul `stable` anterior este șters, iar snapshot-ul `pending` este promovat pentru a-i lua locul ca nouă referință stabilă. diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 8eec30ff..761a2ccc 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -1898,7 +1898,7 @@ SnapRAID также может автоматически читать как и .PP Все остальные команды работают исключительно с живой файловой системой. .SH Жизненный цикл снимков (SNAPSHOTS LIFECYCLE) -SnapRAID управляет двумя конкретными снимками, \`stable\` и \`pending\`, +SnapRAID управляет тремя конкретными снимками, \`stable\`, \`pending\` и \`scan\`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог \`.snapraid/\`, в ZFS — стандартный \`.zfs/snapshot/\`. @@ -1908,8 +1908,12 @@ SnapRAID управляет двумя конкретными снимками, вычисления текущей четности. Он служит основным источником данных для команд \`scrub\`, \`check\` и \`fix\`. .PP -Снимок \`pending\` — это временный образ, создаваемый в начале -\`sync\` для обеспечения замороженного состояния для вычисления четности. +Снимок \`scan\` — это временный образ, создаваемый в начале +\`sync\` для обеспечения замороженного состояния для сканирования и вычисления четности. +После сканирования и сохранения нового состояния содержимого он заменяет предыдущий +снимок \`pending\`. +.PP +Снимок \`pending\` — это образ, используемый прерванной синхронизацией \`sync\`. После успешного завершения операции предыдущий снимок \`stable\` удаляется, а снимок \`pending\` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index e08681a4..07094ba4 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1504,7 +1504,7 @@ Name{number} Все остальные команды работают исключительно с живой файловой системой. Жизненный цикл снимков (Snapshots Lifecycle) - SnapRAID управляет двумя конкретными снимками, `stable` и `pending`, + SnapRAID управляет тремя конкретными снимками, `stable`, `pending` и `scan`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`, в ZFS — стандартный `.zfs/snapshot/`. @@ -1514,8 +1514,12 @@ Name{number} вычисления текущей четности. Он служит основным источником данных для команд `scrub`, `check` и `fix`. - Снимок `pending` — это временный образ, создаваемый в начале - `sync` для обеспечения замороженного состояния для вычисления четности. + Снимок `scan` — это временный образ, создаваемый в начале + `sync` для обеспечения замороженного состояния для сканирования и вычисления четности. + После сканирования и сохранения нового состояния содержимого он заменяет предыдущий + снимок `pending`. + + Снимок `pending` — это образ, используемый прерванной синхронизацией `sync`. После успешного завершения операции предыдущий снимок `stable` удаляется, а снимок `pending` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index c08f7f63..35dc84c9 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -1614,7 +1614,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, 9 Жизненный цикл снимков (SNAPSHOTS LIFECYCLE) ============================================== -SnapRAID управляет двумя конкретными снимками, `stable` и `pending`, +SnapRAID управляет тремя конкретными снимками, `stable`, `pending` и `scan`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`, в ZFS — стандартный `.zfs/snapshot/`. @@ -1624,8 +1624,12 @@ SnapRAID управляет двумя конкретными снимками, вычисления текущей четности. Он служит основным источником данных для команд `scrub`, `check` и `fix`. -Снимок `pending` — это временный образ, создаваемый в начале -`sync` для обеспечения замороженного состояния для вычисления четности. +Снимок `scan` — это временный образ, создаваемый в начале +`sync` для обеспечения замороженного состояния для сканирования и вычисления четности. +После сканирования и сохранения нового состояния содержимого он заменяет предыдущий +снимок `pending`. + +Снимок `pending` — это образ, используемый прерванной синхронизацией `sync`. После успешного завершения операции предыдущий снимок `stable` удаляется, а снимок `pending` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 640bc7d1..d91bfcbf 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -1898,7 +1898,7 @@ aktiva filsystemen uteslutande. .PP Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. .SH LIVSCYKEL FöR öGONBLICKSBILDER (SNAPSHOTS LIFECYCLE) -SnapRAID hanterar två specifika ögonblicksbilder, \`stable\` och \`pending\`, +SnapRAID hanterar tre specifika ögonblicksbilder, \`stable\`, \`pending\` och \`scan\`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen \`.snapraid/\`, i ZFS standardkatalogen \`.zfs/snapshot/\`. @@ -1908,8 +1908,12 @@ framgångsrikt slutförda \`sync\`\-iseringen, och innehåller exakt den data so att beräkna den aktuella pariteten. Den fungerar som den primära datakällan för kommandona \`scrub\`, \`check\` och \`fix\`. .PP -Ögonblicksbilden \`pending\` är en tillfällig bild som skapas i början -av en \`sync\` för att tillhandahålla ett fruset tillstånd för paritetsberäkning. +Ögonblicksbilden \`scan\` är en tillfällig bild som skapas i början +av en \`sync\` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. +Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående +\`pending\`\-ögonblicksbilden. +.PP +Ögonblicksbilden \`pending\` är bilden som används av en avbruten \`sync\`. Efter framgångsrik slutförande av operationen raderas den föregående \`stable\` ögonblicksbilden, och \`pending\`\-ögonblicksbilden upphöjs till att ta dess plats som den nya stabila referensen. diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index cd74c84e..444909d2 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1502,7 +1502,7 @@ Konfiguration (Configuration) Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. Livscykel för ögonblicksbilder (Snapshots Lifecycle) - SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`, + SnapRAID hanterar tre specifika ögonblicksbilder, `stable`, `pending` och `scan`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`, i ZFS standardkatalogen `.zfs/snapshot/`. @@ -1512,8 +1512,12 @@ Livscykel för ögonblicksbilder (Snapshots Lifecycle) att beräkna den aktuella pariteten. Den fungerar som den primära datakällan för kommandona `scrub`, `check` och `fix`. - Ögonblicksbilden `pending` är en tillfällig bild som skapas i början - av en `sync` för att tillhandahålla ett fruset tillstånd för paritetsberäkning. + Ögonblicksbilden `scan` är en tillfällig bild som skapas i början + av en `sync` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. + Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående + `pending`-ögonblicksbilden. + + Ögonblicksbilden `pending` är bilden som används av en avbruten `sync`. Efter framgångsrik slutförande av operationen raderas den föregående `stable` ögonblicksbilden, och `pending`-ögonblicksbilden upphöjs till att ta dess plats som den nya stabila referensen. diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 010151d5..f19cf592 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -1612,7 +1612,7 @@ Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. 9 LIVSCYKEL FöR öGONBLICKSBILDER (SNAPSHOTS LIFECYCLE) ====================================================== -SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`, +SnapRAID hanterar tre specifika ögonblicksbilder, `stable`, `pending` och `scan`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`, i ZFS standardkatalogen `.zfs/snapshot/`. @@ -1622,8 +1622,12 @@ framgångsrikt slutförda `sync`-iseringen, och innehåller exakt den data som a att beräkna den aktuella pariteten. Den fungerar som den primära datakällan för kommandona `scrub`, `check` och `fix`. -Ögonblicksbilden `pending` är en tillfällig bild som skapas i början -av en `sync` för att tillhandahålla ett fruset tillstånd för paritetsberäkning. +Ögonblicksbilden `scan` är en tillfällig bild som skapas i början +av en `sync` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. +Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående +`pending`-ögonblicksbilden. + +Ögonblicksbilden `pending` är bilden som används av en avbruten `sync`. Efter framgångsrik slutförande av operationen raderas den föregående `stable` ögonblicksbilden, och `pending`-ögonblicksbilden upphöjs till att ta dess plats som den nya stabila referensen. diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 5ea6921b..4ab50066 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -2070,7 +2070,7 @@ SnapRAID також може автоматично читати як зі зн .PP Усі інші команди працюють виключно з живою файловою системою. .SH Життєвий цикл знімків (SNAPSHOTS LIFECYCLE) -SnapRAID керує двома конкретними знімками, \`stable\` та \`pending\`, +SnapRAID керує трьома конкретними знімками, \`stable\`, \`pending\` та \`scan\`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог \`.snapraid/\`, у ZFS — стандартний \`.zfs/snapshot/\`. @@ -2080,8 +2080,12 @@ SnapRAID керує двома конкретними знімками, \`stable обчислення поточної парності. Він служить основним джерелом даних для команд \`scrub\`, \`check\` та \`fix\`. .PP -Знімок \`pending\` — це тимчасовий образ, що створюється на початку -\`sync\` для забезпечення замороженого стану для обчислення парності. +Знімок \`scan\` — це тимчасовий образ, що створюється на початку +\`sync\` для забезпечення замороженого стану для сканування та обчислення парності. +Після сканування та збереження нового стану вмісту він замінює попередній +знімок \`pending\`. +.PP +Знімок \`pending\` — це образ, використовуваний перерваною синхронізацією \`sync\`. Після успішного завершення операції попередній знімок \`stable\` видаляється, а знімок \`pending\` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index ac0f5a71..8df8b621 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -1665,7 +1665,7 @@ Name{number} Усі інші команди працюють виключно з живою файловою системою. Життєвий цикл знімків (Snapshots Lifecycle) - SnapRAID керує двома конкретними знімками, `stable` та `pending`, + SnapRAID керує трьома конкретними знімками, `stable`, `pending` та `scan`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`, у ZFS — стандартний `.zfs/snapshot/`. @@ -1675,8 +1675,12 @@ Name{number} обчислення поточної парності. Він служить основним джерелом даних для команд `scrub`, `check` та `fix`. - Знімок `pending` — це тимчасовий образ, що створюється на початку - `sync` для забезпечення замороженого стану для обчислення парності. + Знімок `scan` — це тимчасовий образ, що створюється на початку + `sync` для забезпечення замороженого стану для сканування та обчислення парності. + Після сканування та збереження нового стану вмісту він замінює попередній + знімок `pending`. + + Знімок `pending` — це образ, використовуваний перерваною синхронізацією `sync`. Після успішного завершення операції попередній знімок `stable` видаляється, а знімок `pending` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 605aab47..f5a5af30 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -1775,7 +1775,7 @@ PARITY — це одне з імен парності: `parity`, 9 Життєвий цикл знімків (SNAPSHOTS LIFECYCLE) ============================================= -SnapRAID керує двома конкретними знімками, `stable` та `pending`, +SnapRAID керує трьома конкретними знімками, `stable`, `pending` та `scan`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`, у ZFS — стандартний `.zfs/snapshot/`. @@ -1785,8 +1785,12 @@ SnapRAID керує двома конкретними знімками, `stable` обчислення поточної парності. Він служить основним джерелом даних для команд `scrub`, `check` та `fix`. -Знімок `pending` — це тимчасовий образ, що створюється на початку -`sync` для забезпечення замороженого стану для обчислення парності. +Знімок `scan` — це тимчасовий образ, що створюється на початку +`sync` для забезпечення замороженого стану для сканування та обчислення парності. +Після сканування та збереження нового стану вмісту він замінює попередній +знімок `pending`. + +Знімок `pending` — це образ, використовуваний перерваною синхронізацією `sync`. Після успішного завершення операції попередній знімок `stable` видаляється, а знімок `pending` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index aee9cd07..2a0a02b7 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -1713,8 +1713,8 @@ SnapRAID 也有一个稳定、冻结的参考来求解校验方程。 .PP 所有其他命令完全在实时文件系统上运行。 .SH 快照生命周期 (SNAPSHOTS LIFECYCLE) -SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： -\`stable\`（稳定）和 \`pending\`（待定）。 +SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： +\`stable\`（稳定）、\`pending\`（待定）和 \`scan\`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 \`.snapraid/\` 目录， 在 ZFS 中使用标准的 \`.zfs/snapshot/\`。 .PP @@ -1722,10 +1722,13 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 \`scrub\`、\`check\` 和 \`fix\` 命令的主要数据源。 .PP -\`pending\` 快照是在 \`sync\` 开始时创建的临时镜像， -用于为校验计算提供冻结状态。在操作成功完成后， -以前的 \`stable\` 快照将被删除，并且 \`pending\` 快照将被提升 -以接替其作为新的稳定参考。 +\`scan\` 快照是在 \`sync\` 开始时创建的临时镜像， +用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， +它将替换以前的 \`pending\` 快照。 +.PP +\`pending\` 快照是中断的 \`sync\` 所使用的镜像。 +在操作成功完成后，以前的 \`stable\` 快照将被删除， +并且 \`pending\` 快照将被提升以接替其作为新的稳定参考。 .PP 如果 \`sync\` 中断，\`pending\` 快照将被保留。 随后的 \`scrub\`、\`check\` 和 \`fix\` 命令将使用此待定快照， diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index b072f983..71abfc31 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1317,8 +1317,8 @@ Name{number} 所有其他命令完全在实时文件系统上运行。 快照生命周期 (Snapshots Lifecycle) - SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： - `stable`（稳定）和 `pending`（待定）。 + SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： + `stable`（稳定）、`pending`（待定）和 `scan`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录， 在 ZFS 中使用标准的 `.zfs/snapshot/`。 @@ -1326,10 +1326,13 @@ Name{number} 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 - `pending` 快照是在 `sync` 开始时创建的临时镜像， - 用于为校验计算提供冻结状态。在操作成功完成后， - 以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 - 以接替其作为新的稳定参考。 + `scan` 快照是在 `sync` 开始时创建的临时镜像， + 用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， + 它将替换以前的 `pending` 快照。 + + `pending` 快照是中断的 `sync` 所使用的镜像。 + 在操作成功完成后，以前的 `stable` 快照将被删除， + 并且 `pending` 快照将被提升以接替其作为新的稳定参考。 如果 `sync` 中断，`pending` 快照将被保留。 随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照， diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index b90ef351..d950a4ea 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1427,8 +1427,8 @@ SnapRAID 也有一个稳定、冻结的参考来求解校验方程。 9 快照生命周期 (SNAPSHOTS LIFECYCLE) ============================== -SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： -`stable`（稳定）和 `pending`（待定）。 +SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： +`stable`（稳定）、`pending`（待定）和 `scan`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录， 在 ZFS 中使用标准的 `.zfs/snapshot/`。 @@ -1436,10 +1436,13 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 -`pending` 快照是在 `sync` 开始时创建的临时镜像， -用于为校验计算提供冻结状态。在操作成功完成后， -以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 -以接替其作为新的稳定参考。 +`scan` 快照是在 `sync` 开始时创建的临时镜像， +用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， +它将替换以前的 `pending` 快照。 + +`pending` 快照是中断的 `sync` 所使用的镜像。 +在操作成功完成后，以前的 `stable` 快照将被删除， +并且 `pending` 快照将被提升以接替其作为新的稳定参考。 如果 `sync` 中断，`pending` 快照将被保留。 随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照， diff --git a/doc/snapraid.1 b/doc/snapraid.1 index a306f52b..de05b1b3 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -1903,7 +1903,7 @@ live filesystems exclusively. .PP All other commands operate exclusively on the live filesystem. .SH SNAPSHOTS LIFECYCLE -SnapRAID manages two specific snapshots, \`stable\` and \`pending\`, +SnapRAID manages three specific snapshots, \`stable\`, \`pending\`, and \`scan\`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it\'s used the \`.snapraid/\` directory, in ZFS the standard \`.zfs/snapshot/\`. @@ -1913,8 +1913,12 @@ successfully completed \`sync\`, containing the exact data used to compute the current parity. It serves as the primary data source for \`scrub\`, \`check\`, and \`fix\` commands. .PP -The \`pending\` snapshot is a temporary image created at the start -of a \`sync\` to provide a frozen state for parity computation. +The \`scan\` snapshot is a temporary image created at the start +of a \`sync\` to provide a frozen state for scanning and parity computation. +After scanning and saving the new content state, it replaces the previous +\`pending\` snapshot. +.PP +The \`pending\` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous \`stable\` snapshot is deleted, and the \`pending\` snapshot is promoted to take its place as the new stable reference. diff --git a/doc/snapraid.d b/doc/snapraid.d index 3970ddd5..9c4dfb85 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1507,7 +1507,7 @@ Snapshots All other commands operate exclusively on the live filesystem. Snapshots Lifecycle - SnapRAID manages two specific snapshots, `stable` and `pending`, + SnapRAID manages three specific snapshots, `stable`, `pending`, and `scan`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it's used the `.snapraid/` directory, in ZFS the standard `.zfs/snapshot/`. @@ -1517,8 +1517,12 @@ Snapshots Lifecycle compute the current parity. It serves as the primary data source for `scrub`, `check`, and `fix` commands. - The `pending` snapshot is a temporary image created at the start - of a `sync` to provide a frozen state for parity computation. + The `scan` snapshot is a temporary image created at the start + of a `sync` to provide a frozen state for scanning and parity computation. + After scanning and saving the new content state, it replaces the previous + `pending` snapshot. + + The `pending` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous `stable` snapshot is deleted, and the `pending` snapshot is promoted to take its place as the new stable reference. diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 72646941..0decd0eb 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1617,7 +1617,7 @@ All other commands operate exclusively on the live filesystem. 9 SNAPSHOTS LIFECYCLE ===================== -SnapRAID manages two specific snapshots, `stable` and `pending`, +SnapRAID manages three specific snapshots, `stable`, `pending`, and `scan`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it's used the `.snapraid/` directory, in ZFS the standard `.zfs/snapshot/`. @@ -1627,8 +1627,12 @@ successfully completed `sync`, containing the exact data used to compute the current parity. It serves as the primary data source for `scrub`, `check`, and `fix` commands. -The `pending` snapshot is a temporary image created at the start -of a `sync` to provide a frozen state for parity computation. +The `scan` snapshot is a temporary image created at the start +of a `sync` to provide a frozen state for scanning and parity computation. +After scanning and saving the new content state, it replaces the previous +`pending` snapshot. + +The `pending` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous `stable` snapshot is deleted, and the `pending` snapshot is promoted to take its place as the new stable reference.