From 7b2007e50325c5719332a2552529ed07e01f65e5 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Wed, 26 Aug 2026 12:29:13 +0200 Subject: [PATCH] Clarify directory pruning semantics and nested exclusion/inclusion rules --- doc/snapraid-de.1 | 49 +++++++++++++++++++++++++++++++++++++++++++++ doc/snapraid-de.d | 29 +++++++++++++++++++++++++++ doc/snapraid-de.txt | 29 +++++++++++++++++++++++++++ doc/snapraid-es.1 | 46 ++++++++++++++++++++++++++++++++++++++++++ doc/snapraid-es.d | 26 ++++++++++++++++++++++++ doc/snapraid-es.txt | 26 ++++++++++++++++++++++++ doc/snapraid-fr.1 | 46 ++++++++++++++++++++++++++++++++++++++++++ doc/snapraid-fr.d | 26 ++++++++++++++++++++++++ doc/snapraid-fr.txt | 26 ++++++++++++++++++++++++ doc/snapraid-it.1 | 46 ++++++++++++++++++++++++++++++++++++++++++ doc/snapraid-it.d | 26 ++++++++++++++++++++++++ doc/snapraid-it.txt | 26 ++++++++++++++++++++++++ doc/snapraid-ja.1 | 42 ++++++++++++++++++++++++++++++++++++++ doc/snapraid-ja.d | 22 ++++++++++++++++++++ doc/snapraid-ja.txt | 22 ++++++++++++++++++++ doc/snapraid-ko.1 | 43 +++++++++++++++++++++++++++++++++++++++ doc/snapraid-ko.d | 23 +++++++++++++++++++++ doc/snapraid-ko.txt | 23 +++++++++++++++++++++ doc/snapraid-pl.1 | 46 ++++++++++++++++++++++++++++++++++++++++++ doc/snapraid-pl.d | 26 ++++++++++++++++++++++++ doc/snapraid-pl.txt | 26 ++++++++++++++++++++++++ doc/snapraid-pt.1 | 45 +++++++++++++++++++++++++++++++++++++++++ doc/snapraid-pt.d | 25 +++++++++++++++++++++++ doc/snapraid-pt.txt | 25 +++++++++++++++++++++++ doc/snapraid-ro.1 | 45 +++++++++++++++++++++++++++++++++++++++++ doc/snapraid-ro.d | 25 +++++++++++++++++++++++ doc/snapraid-ro.txt | 25 +++++++++++++++++++++++ doc/snapraid-ru.1 | 45 +++++++++++++++++++++++++++++++++++++++++ doc/snapraid-ru.d | 25 +++++++++++++++++++++++ doc/snapraid-ru.txt | 25 +++++++++++++++++++++++ doc/snapraid-sv.1 | 45 +++++++++++++++++++++++++++++++++++++++++ doc/snapraid-sv.d | 25 +++++++++++++++++++++++ doc/snapraid-sv.txt | 25 +++++++++++++++++++++++ doc/snapraid-uk.1 | 44 ++++++++++++++++++++++++++++++++++++++++ doc/snapraid-uk.d | 24 ++++++++++++++++++++++ doc/snapraid-uk.txt | 24 ++++++++++++++++++++++ doc/snapraid-zh.1 | 39 ++++++++++++++++++++++++++++++++++++ doc/snapraid-zh.d | 19 ++++++++++++++++++ doc/snapraid-zh.txt | 19 ++++++++++++++++++ doc/snapraid.1 | 44 ++++++++++++++++++++++++++++++++++++++++ doc/snapraid.d | 24 ++++++++++++++++++++++ doc/snapraid.txt | 24 ++++++++++++++++++++++ 42 files changed, 1315 insertions(+) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 30c5da61..f0053f67 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -1588,6 +1588,12 @@ wird die Datei ausgeschlossen, wenn das zuletzt angegebene Muster ein \`include\` ist, oder eingeschlossen, wenn das zuletzt angegebene Muster ein \`exclude\` ist. .PP +Beachten Sie, dass die Filterung hierarchisch beim Durchlaufen der +Verzeichnisse erfolgt. Wenn ein Verzeichnis mit einer \`exclude\`\-Regel +übereinstimmt, wird das gesamte Verzeichnis übersprungen (verworfen), +und alle \`include\`\-Regeln für darin enthaltene Dateien oder +Unterverzeichnisse werden nicht ausgewertet. +.PP Weitere Details zu Musterspezifikationen finden Sie im Abschnitt PATTERN. .PP @@ -2237,6 +2243,49 @@ include /pictures/ .PD .RE .PP +Beachten Sie, dass das Ausschließen eines Verzeichnisses (mit DIR/ +oder /PFAD/DIR/) verhindert, dass SnapRAID dieses Verzeichnis betritt +und durchsucht. Daher ist es nicht möglich, eine Datei oder ein +Unterverzeichnis innerhalb eines ausgeschlossenen übergeordneten +Verzeichnisses wieder einzuschließen, da der Scanner dieses niemals +durchläuft. +.PP +Beispielsweise wird bei folgender Konfiguration \`file.dat\` NICHT +eingeschlossen, da \`/keep/\` verworfen wird, bevor \`file.dat\` gesehen +werden kann: +.PP +.RS 4 +# Funktioniert NICHT: /keep/ wird vollständig übersprungen +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Um Dateien innerhalb eines Verzeichnisses auszuschließen und bestimmte +Dateien beizubehalten, schließen Sie die Dateien im Verzeichnis aus, +anstatt das Verzeichnis selbst auszuschließen: +.PP +.RS 4 +# Funktioniert: /keep/ wird durchlaufen, aber andere Dateien darin werden ausgeschlossen +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP In der Befehlszeile können Sie mit der Option \-f nur \`include\`\-Muster verwenden. Zum Beispiel: .PP diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 2fd96cc9..35188b39 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -1295,6 +1295,12 @@ Konfiguration (Configuration) ein `include` ist, oder eingeschlossen, wenn das zuletzt angegebene Muster ein `exclude` ist. + Beachten Sie, dass die Filterung hierarchisch beim Durchlaufen der + Verzeichnisse erfolgt. Wenn ein Verzeichnis mit einer `exclude`-Regel + übereinstimmt, wird das gesamte Verzeichnis übersprungen (verworfen), + und alle `include`-Regeln für darin enthaltene Dateien oder + Unterverzeichnisse werden nicht ausgewertet. + Weitere Details zu Musterspezifikationen finden Sie im Abschnitt PATTERN. @@ -1774,6 +1780,29 @@ Muster (Pattern) :include /musics/ :include /pictures/ + Beachten Sie, dass das Ausschließen eines Verzeichnisses (mit DIR/ + oder /PFAD/DIR/) verhindert, dass SnapRAID dieses Verzeichnis betritt + und durchsucht. Daher ist es nicht möglich, eine Datei oder ein + Unterverzeichnis innerhalb eines ausgeschlossenen übergeordneten + Verzeichnisses wieder einzuschließen, da der Scanner dieses niemals + durchläuft. + + Beispielsweise wird bei folgender Konfiguration `file.dat` NICHT + eingeschlossen, da `/keep/` verworfen wird, bevor `file.dat` gesehen + werden kann: + + :# Funktioniert NICHT: /keep/ wird vollständig übersprungen + :include /keep/file.dat + :exclude /keep/ + + Um Dateien innerhalb eines Verzeichnisses auszuschließen und bestimmte + Dateien beizubehalten, schließen Sie die Dateien im Verzeichnis aus, + anstatt das Verzeichnis selbst auszuschließen: + + :# Funktioniert: /keep/ wird durchlaufen, aber andere Dateien darin werden ausgeschlossen + :include /keep/file.dat + :exclude /keep/* + In der Befehlszeile können Sie mit der Option -f nur `include`-Muster verwenden. Zum Beispiel: diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index a0fa191f..e3e7a785 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -1377,6 +1377,12 @@ wird die Datei ausgeschlossen, wenn das zuletzt angegebene Muster ein `include` ist, oder eingeschlossen, wenn das zuletzt angegebene Muster ein `exclude` ist. +Beachten Sie, dass die Filterung hierarchisch beim Durchlaufen der +Verzeichnisse erfolgt. Wenn ein Verzeichnis mit einer `exclude`-Regel +übereinstimmt, wird das gesamte Verzeichnis übersprungen (verworfen), +und alle `include`-Regeln für darin enthaltene Dateien oder +Unterverzeichnisse werden nicht ausgewertet. + Weitere Details zu Musterspezifikationen finden Sie im Abschnitt PATTERN. @@ -1887,6 +1893,29 @@ dann alle `include`-Regeln auflisten. Zum Beispiel: include /musics/ include /pictures/ +Beachten Sie, dass das Ausschließen eines Verzeichnisses (mit DIR/ +oder /PFAD/DIR/) verhindert, dass SnapRAID dieses Verzeichnis betritt +und durchsucht. Daher ist es nicht möglich, eine Datei oder ein +Unterverzeichnis innerhalb eines ausgeschlossenen übergeordneten +Verzeichnisses wieder einzuschließen, da der Scanner dieses niemals +durchläuft. + +Beispielsweise wird bei folgender Konfiguration `file.dat` NICHT +eingeschlossen, da `/keep/` verworfen wird, bevor `file.dat` gesehen +werden kann: + + # Funktioniert NICHT: /keep/ wird vollständig übersprungen + include /keep/file.dat + exclude /keep/ + +Um Dateien innerhalb eines Verzeichnisses auszuschließen und bestimmte +Dateien beizubehalten, schließen Sie die Dateien im Verzeichnis aus, +anstatt das Verzeichnis selbst auszuschließen: + + # Funktioniert: /keep/ wird durchlaufen, aber andere Dateien darin werden ausgeschlossen + include /keep/file.dat + exclude /keep/* + In der Befehlszeile können Sie mit der Option -f nur `include`-Muster verwenden. Zum Beispiel: diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index 78d60bf2..a60db17f 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -1541,6 +1541,11 @@ Si ningún patrón coincide, el archivo se excluye si el último patrón especificado es un \`include\`, o se incluye si el último patrón especificado es un \`exclude\`. .PP +Tenga en cuenta que el filtrado se produce jerárquicamente durante +el recorrido de los directorios. Si un directorio coincide con una +regla \`exclude\`, se omite (poda) todo el directorio y no se evaluará +ninguna regla \`include\` para los archivos o subdirectorios que contenga. +.PP Consulte la sección PATTERN para obtener más detalles sobre las especificaciones de patrones. .PP @@ -2196,6 +2201,47 @@ include /pictures/ .PD .RE .PP +Tenga en cuenta que excluir un directorio (usando DIR/ o /RUTA/DIR/) +impide que SnapRAID entre y examine ese directorio. En consecuencia, +no es posible volver a incluir un archivo o subdirectorio ubicado +dentro de un directorio principal excluido, ya que el escáner nunca lo +recorre. +.PP +Por ejemplo, la siguiente configuración NO incluirá \`file.dat\` +porque \`/keep/\` se poda antes de que \`file.dat\` pueda ser evaluado: +.PP +.RS 4 +# NO funciona: /keep/ se omite por completo +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Para excluir archivos dentro de un directorio conservando algunos +específicos, excluya el patrón de archivos dentro del directorio en +lugar de excluir el directorio en sí: +.PP +.RS 4 +# Funciona: /keep/ se recorre, pero los demás archivos dentro se excluyen +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP En la línea de comandos, usando la opción \-f, solo puede usar patrones \`include\`. Por ejemplo: .PP diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 0f6a67e6..d89a9b0c 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -1259,6 +1259,11 @@ Configuración (Configuration) patrón especificado es un `include`, o se incluye si el último patrón especificado es un `exclude`. + Tenga en cuenta que el filtrado se produce jerárquicamente durante + el recorrido de los directorios. Si un directorio coincide con una + regla `exclude`, se omite (poda) todo el directorio y no se evaluará + ninguna regla `include` para los archivos o subdirectorios que contenga. + Consulte la sección PATTERN para obtener más detalles sobre las especificaciones de patrones. @@ -1744,6 +1749,27 @@ Patrones (Pattern) :include /musics/ :include /pictures/ + Tenga en cuenta que excluir un directorio (usando DIR/ o /RUTA/DIR/) + impide que SnapRAID entre y examine ese directorio. En consecuencia, + no es posible volver a incluir un archivo o subdirectorio ubicado + dentro de un directorio principal excluido, ya que el escáner nunca lo + recorre. + + Por ejemplo, la siguiente configuración NO incluirá `file.dat` + porque `/keep/` se poda antes de que `file.dat` pueda ser evaluado: + + :# NO funciona: /keep/ se omite por completo + :include /keep/file.dat + :exclude /keep/ + + Para excluir archivos dentro de un directorio conservando algunos + específicos, excluya el patrón de archivos dentro del directorio en + lugar de excluir el directorio en sí: + + :# Funciona: /keep/ se recorre, pero los demás archivos dentro se excluyen + :include /keep/file.dat + :exclude /keep/* + En la línea de comandos, usando la opción -f, solo puede usar patrones `include`. Por ejemplo: diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 73a8e7c0..8fdeaf51 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -1341,6 +1341,11 @@ Si ningún patrón coincide, el archivo se excluye si el último patrón especificado es un `include`, o se incluye si el último patrón especificado es un `exclude`. +Tenga en cuenta que el filtrado se produce jerárquicamente durante +el recorrido de los directorios. Si un directorio coincide con una +regla `exclude`, se omite (poda) todo el directorio y no se evaluará +ninguna regla `include` para los archivos o subdirectorios que contenga. + Consulte la sección PATTERN para obtener más detalles sobre las especificaciones de patrones. @@ -1857,6 +1862,27 @@ y luego todas las reglas `include`. Por ejemplo: include /musics/ include /pictures/ +Tenga en cuenta que excluir un directorio (usando DIR/ o /RUTA/DIR/) +impide que SnapRAID entre y examine ese directorio. En consecuencia, +no es posible volver a incluir un archivo o subdirectorio ubicado +dentro de un directorio principal excluido, ya que el escáner nunca lo +recorre. + +Por ejemplo, la siguiente configuración NO incluirá `file.dat` +porque `/keep/` se poda antes de que `file.dat` pueda ser evaluado: + + # NO funciona: /keep/ se omite por completo + include /keep/file.dat + exclude /keep/ + +Para excluir archivos dentro de un directorio conservando algunos +específicos, excluya el patrón de archivos dentro del directorio en +lugar de excluir el directorio en sí: + + # Funciona: /keep/ se recorre, pero los demás archivos dentro se excluyen + include /keep/file.dat + exclude /keep/* + En la línea de comandos, usando la opción -f, solo puede usar patrones `include`. Por ejemplo: diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index c30ea6f4..98f6ca06 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -1579,6 +1579,12 @@ Si aucun motif ne correspond, le fichier est exclu si le dernier motif spécifié est un \`include\`, ou inclus si le dernier motif spécifié est un \`exclude\`. .PP +Notez que le filtrage s\'effectue de manière hiérarchique lors du +parcours des répertoires. Si un répertoire correspond à une règle +\`exclude\`, l\'ensemble du répertoire est ignoré (élagué), et aucune règle +\`include\` pour les fichiers ou sous\-répertoires qu\'il contient ne sera +évaluée. +.PP Voir la section PATTERN pour plus de détails sur les spécifications de motifs. .PP @@ -2235,6 +2241,46 @@ include /pictures/ .PD .RE .PP +Notez que l\'exclusion d\'un répertoire (en utilisant DIR/ ou /CHEMIN/DIR/) +empêche SnapRAID d\'entrer et de parcourir ce répertoire. Par conséquent, +il n\'est pas possible de réinclure un fichier ou un sous\-répertoire situé +dans un répertoire parent exclu, car le scanner ne le parcourt jamais. +.PP +Par exemple, la configuration suivante n\'inclura PAS \`file.dat\` car +\`/keep/\` est élagué avant que \`file.dat\` ne puisse être examiné : +.PP +.RS 4 +# Ne fonctionne PAS : /keep/ est entièrement ignoré +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Pour exclure les fichiers d\'un répertoire tout en conservant certains +fichiers spécifiques, appliquez le motif d\'exclusion aux fichiers du +répertoire plutôt que d\'exclure le répertoire lui\-même : +.PP +.RS 4 +# Fonctionne : /keep/ est parcouru, mais les autres fichiers qu\'il contient sont exclus +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP Sur la ligne de commande, en utilisant l\'option \-f, vous ne pouvez utiliser que des motifs \`include\`. Par exemple : .PP diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index ea5f5a8b..92f536a8 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -1297,6 +1297,12 @@ Configuration spécifié est un `include`, ou inclus si le dernier motif spécifié est un `exclude`. + Notez que le filtrage s'effectue de manière hiérarchique lors du + parcours des répertoires. Si un répertoire correspond à une règle + `exclude`, l'ensemble du répertoire est ignoré (élagué), et aucune règle + `include` pour les fichiers ou sous-répertoires qu'il contient ne sera + évaluée. + Voir la section PATTERN pour plus de détails sur les spécifications de motifs. @@ -1783,6 +1789,26 @@ Motif (Pattern) :include /musics/ :include /pictures/ + Notez que l'exclusion d'un répertoire (en utilisant DIR/ ou /CHEMIN/DIR/) + empêche SnapRAID d'entrer et de parcourir ce répertoire. Par conséquent, + il n'est pas possible de réinclure un fichier ou un sous-répertoire situé + dans un répertoire parent exclu, car le scanner ne le parcourt jamais. + + Par exemple, la configuration suivante n'inclura PAS `file.dat` car + `/keep/` est élagué avant que `file.dat` ne puisse être examiné : + + :# Ne fonctionne PAS : /keep/ est entièrement ignoré + :include /keep/file.dat + :exclude /keep/ + + Pour exclure les fichiers d'un répertoire tout en conservant certains + fichiers spécifiques, appliquez le motif d'exclusion aux fichiers du + répertoire plutôt que d'exclure le répertoire lui-même : + + :# Fonctionne : /keep/ est parcouru, mais les autres fichiers qu'il contient sont exclus + :include /keep/file.dat + :exclude /keep/* + Sur la ligne de commande, en utilisant l'option -f, vous ne pouvez utiliser que des motifs `include`. Par exemple : diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 3f804bd2..7525b773 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -1379,6 +1379,12 @@ Si aucun motif ne correspond, le fichier est exclu si le dernier motif spécifié est un `include`, ou inclus si le dernier motif spécifié est un `exclude`. +Notez que le filtrage s'effectue de manière hiérarchique lors du +parcours des répertoires. Si un répertoire correspond à une règle +`exclude`, l'ensemble du répertoire est ignoré (élagué), et aucune règle +`include` pour les fichiers ou sous-répertoires qu'il contient ne sera +évaluée. + Voir la section PATTERN pour plus de détails sur les spécifications de motifs. @@ -1896,6 +1902,26 @@ d'abord, puis toutes les règles `include`. Par exemple : include /musics/ include /pictures/ +Notez que l'exclusion d'un répertoire (en utilisant DIR/ ou /CHEMIN/DIR/) +empêche SnapRAID d'entrer et de parcourir ce répertoire. Par conséquent, +il n'est pas possible de réinclure un fichier ou un sous-répertoire situé +dans un répertoire parent exclu, car le scanner ne le parcourt jamais. + +Par exemple, la configuration suivante n'inclura PAS `file.dat` car +`/keep/` est élagué avant que `file.dat` ne puisse être examiné : + + # Ne fonctionne PAS : /keep/ est entièrement ignoré + include /keep/file.dat + exclude /keep/ + +Pour exclure les fichiers d'un répertoire tout en conservant certains +fichiers spécifiques, appliquez le motif d'exclusion aux fichiers du +répertoire plutôt que d'exclure le répertoire lui-même : + + # Fonctionne : /keep/ est parcouru, mais les autres fichiers qu'il contient sont exclus + include /keep/file.dat + exclude /keep/* + Sur la ligne de commande, en utilisant l'option -f, vous ne pouvez utiliser que des motifs `include`. Par exemple : diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index e2f8cb58..70c7e187 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -1564,6 +1564,11 @@ Se nessun pattern corrisponde, il file viene escluso se l\'ultimo pattern specificato è un \`include\`, o incluso se l\'ultimo pattern specificato è un \`exclude\`. .PP +Si noti che il filtraggio avviene gerarchicamente durante l\'attraversamento +delle directory. Se una directory corrisponde a una regola \`exclude\`, +l\'intero sottoalbero viene saltato (potato), e le regole \`include\` per file +o sottocartelle al suo interno non verranno valutate. +.PP Vedere la sezione PATTERN per maggiori dettagli sulle specifiche del pattern. .PP @@ -2219,6 +2224,47 @@ include /pictures/ .PD .RE .PP +Si noti che l\'esclusione di una directory (utilizzando DIR/ o /PATH/DIR/) +impedisce a SnapRAID di entrare e scansionare quella directory. +Pertanto, non è possibile re\-includere un file o una sottodirectory +all\'interno di una cartella genitore esclusa, poiché il suo contenuto +non viene mai scansionato. +.PP +Ad esempio, la seguente configurazione NON includerà \`file.dat\` perché +\`/keep/\` viene saltata prima che \`file.dat\` possa essere esaminato: +.PP +.RS 4 +# NON funziona: /keep/ viene saltata completamente +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Per escludere i file all\'interno di una cartella mantenendone alcuni +specifici, specificare il pattern dei file anziché escludere la directory +stessa: +.PP +.RS 4 +# Funziona: /keep/ viene attraversata, ma gli altri file sono esclusi +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP Sulla riga di comando, utilizzando l\'opzione \-f, è possibile utilizzare solo pattern \`include\`. Ad esempio: .PP diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index ab89d879..212c508b 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -1271,6 +1271,11 @@ Configurazione (Configuration) pattern specificato è un `include`, o incluso se l'ultimo pattern specificato è un `exclude`. + Si noti che il filtraggio avviene gerarchicamente durante l'attraversamento + delle directory. Se una directory corrisponde a una regola `exclude`, + l'intero sottoalbero viene saltato (potato), e le regole `include` per file + o sottocartelle al suo interno non verranno valutate. + Vedere la sezione PATTERN per maggiori dettagli sulle specifiche del pattern. @@ -1756,6 +1761,27 @@ Pattern :include /musics/ :include /pictures/ + Si noti che l'esclusione di una directory (utilizzando DIR/ o /PATH/DIR/) + impedisce a SnapRAID di entrare e scansionare quella directory. + Pertanto, non è possibile re-includere un file o una sottodirectory + all'interno di una cartella genitore esclusa, poiché il suo contenuto + non viene mai scansionato. + + Ad esempio, la seguente configurazione NON includerà `file.dat` perché + `/keep/` viene saltata prima che `file.dat` possa essere esaminato: + + :# NON funziona: /keep/ viene saltata completamente + :include /keep/file.dat + :exclude /keep/ + + Per escludere i file all'interno di una cartella mantenendone alcuni + specifici, specificare il pattern dei file anziché escludere la directory + stessa: + + :# Funziona: /keep/ viene attraversata, ma gli altri file sono esclusi + :include /keep/file.dat + :exclude /keep/* + Sulla riga di comando, utilizzando l'opzione -f, è possibile utilizzare solo pattern `include`. Ad esempio: diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index 6f5da6ff..7c09e3aa 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -1353,6 +1353,11 @@ Se nessun pattern corrisponde, il file viene escluso se l'ultimo pattern specificato è un `include`, o incluso se l'ultimo pattern specificato è un `exclude`. +Si noti che il filtraggio avviene gerarchicamente durante l'attraversamento +delle directory. Se una directory corrisponde a una regola `exclude`, +l'intero sottoalbero viene saltato (potato), e le regole `include` per file +o sottocartelle al suo interno non verranno valutate. + Vedere la sezione PATTERN per maggiori dettagli sulle specifiche del pattern. @@ -1869,6 +1874,27 @@ e poi tutte le regole `include`. Ad esempio: include /musics/ include /pictures/ +Si noti che l'esclusione di una directory (utilizzando DIR/ o /PATH/DIR/) +impedisce a SnapRAID di entrare e scansionare quella directory. +Pertanto, non è possibile re-includere un file o una sottodirectory +all'interno di una cartella genitore esclusa, poiché il suo contenuto +non viene mai scansionato. + +Ad esempio, la seguente configurazione NON includerà `file.dat` perché +`/keep/` viene saltata prima che `file.dat` possa essere esaminato: + + # NON funziona: /keep/ viene saltata completamente + include /keep/file.dat + exclude /keep/ + +Per escludere i file all'interno di una cartella mantenendone alcuni +specifici, specificare il pattern dei file anziché escludere la directory +stessa: + + # Funziona: /keep/ viene attraversata, ma gli altri file sono esclusi + include /keep/file.dat + exclude /keep/* + Sulla riga di comando, utilizzando l'opzione -f, è possibile utilizzare solo pattern `include`. Ad esempio: diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index 22e4e7e5..0cd47ae7 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -1404,6 +1404,10 @@ syncプロセスで除外または含めるファイルまたはディレクト パターンが一致しない場合、最後に指定されたパターンが \`include\` の場合はファイルは除外され、 \`exclude\` の場合は含まれます。 .PP +フィルタリングはディレクトリの走査時に階層的に実行されることに注意してください。 +ディレクトリが \`exclude\` ルールに一致した場合、そのディレクトリ全体がスキップ（プルーニング）され、 +その内部にあるファイルやサブディレクトリに対する \`include\` ルールは評価されません。 +.PP パターン仕様の詳細については、PATTERNセクションを参照してください。 .PP このオプションは複数回使用できます。 @@ -1987,6 +1991,44 @@ include /pictures/ .PD .RE .PP +ディレクトリを除外すると（DIR/ または /PATH/DIR/ を使用）、SnapRAID がそのディレクトリに入って +スキャンすることが防止されることに注意してください。したがって、除外された親ディレクトリ内に +存在するファイルやサブディレクトリを \`include\` ルールで再度含めることはできません（スキャナが +そのディレクトリ内を走査しないため）。 +.PP +例えば、以下の設定では \`/keep/\` がプルーニングされるため、\`file.dat\` は含まれません： +.PP +.RS 4 +# 意図通りに動作しません: /keep/ は完全にスキップされます +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +特定のファイルを残しつつディレクトリ内のファイルを一括除外するには、ディレクトリ自体を除外するのではなく、 +ディレクトリ内のファイルパターンを除外してください： +.PP +.RS 4 +# 意図通りに動作します: /keep/ は走査され、内部の他のファイルのみが除外されます +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP コマンドラインで \-f オプションを使用する場合、\`include\` パターンのみを 使用できます。例： .PP diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 756de00e..60958f85 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1122,6 +1122,10 @@ Name{number} パターンが一致しない場合、最後に指定されたパターンが `include` の場合はファイルは除外され、 `exclude` の場合は含まれます。 + フィルタリングはディレクトリの走査時に階層的に実行されることに注意してください。 + ディレクトリが `exclude` ルールに一致した場合、そのディレクトリ全体がスキップ（プルーニング）され、 + その内部にあるファイルやサブディレクトリに対する `include` ルールは評価されません。 + パターン仕様の詳細については、PATTERNセクションを参照してください。 このオプションは複数回使用できます。 @@ -1535,6 +1539,24 @@ Name{number} :include /musics/ :include /pictures/ + ディレクトリを除外すると（DIR/ または /PATH/DIR/ を使用）、SnapRAID がそのディレクトリに入って + スキャンすることが防止されることに注意してください。したがって、除外された親ディレクトリ内に + 存在するファイルやサブディレクトリを `include` ルールで再度含めることはできません（スキャナが + そのディレクトリ内を走査しないため）。 + + 例えば、以下の設定では `/keep/` がプルーニングされるため、`file.dat` は含まれません： + + :# 意図通りに動作しません: /keep/ は完全にスキップされます + :include /keep/file.dat + :exclude /keep/ + + 特定のファイルを残しつつディレクトリ内のファイルを一括除外するには、ディレクトリ自体を除外するのではなく、 + ディレクトリ内のファイルパターンを除外してください： + + :# 意図通りに動作します: /keep/ は走査され、内部の他のファイルのみが除外されます + :include /keep/file.dat + :exclude /keep/* + コマンドラインで -f オプションを使用する場合、`include` パターンのみを 使用できます。例： diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 96b963d7..49d2eba9 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1204,6 +1204,10 @@ syncプロセスで除外または含めるファイルまたはディレクト パターンが一致しない場合、最後に指定されたパターンが `include` の場合はファイルは除外され、 `exclude` の場合は含まれます。 +フィルタリングはディレクトリの走査時に階層的に実行されることに注意してください。 +ディレクトリが `exclude` ルールに一致した場合、そのディレクトリ全体がスキップ（プルーニング）され、 +その内部にあるファイルやサブディレクトリに対する `include` ルールは評価されません。 + パターン仕様の詳細については、PATTERNセクションを参照してください。 このオプションは複数回使用できます。 @@ -1648,6 +1652,24 @@ Unixではエスケープ文字は `\` です。Windowsでは `^` です。 include /musics/ include /pictures/ +ディレクトリを除外すると（DIR/ または /PATH/DIR/ を使用）、SnapRAID がそのディレクトリに入って +スキャンすることが防止されることに注意してください。したがって、除外された親ディレクトリ内に +存在するファイルやサブディレクトリを `include` ルールで再度含めることはできません（スキャナが +そのディレクトリ内を走査しないため）。 + +例えば、以下の設定では `/keep/` がプルーニングされるため、`file.dat` は含まれません： + + # 意図通りに動作しません: /keep/ は完全にスキップされます + include /keep/file.dat + exclude /keep/ + +特定のファイルを残しつつディレクトリ内のファイルを一括除外するには、ディレクトリ自体を除外するのではなく、 +ディレクトリ内のファイルパターンを除外してください： + + # 意図通りに動作します: /keep/ は走査され、内部の他のファイルのみが除外されます + include /keep/file.dat + exclude /keep/* + コマンドラインで -f オプションを使用する場合、`include` パターンのみを 使用できます。例： diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 4fec5b92..54655994 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -1441,6 +1441,10 @@ sync 프로세스에서 제외하거나 포함할 파일 또는 디렉토리 패 일치하는 패턴이 없으면, 지정된 마지막 패턴이 \`include\`이면 파일은 제외되고, \`exclude\`이면 포함됩니다. .PP +필터링은 디렉토리 순회 중에 계층적으로 수행됩니다. 디렉토리가 \`exclude\` +규칙과 일치하면 해당 디렉토리 전체가 건너뛰어지며(가지치기됨), 그 안에 +있는 파일이나 하위 디렉토리에 대한 \`include\` 규칙은 평가되지 않습니다. +.PP 패턴 사양에 대한 자세한 내용은 PATTERN 섹션을 참조하십시오. .PP 이 옵션은 여러 번 사용될 수 있습니다. @@ -2035,6 +2039,45 @@ include /pictures/ .PD .RE .PP +디렉토리를 제외하면(DIR/ 또는 /PATH/DIR/ 사용) SnapRAID가 해당 디렉토리에 +진입하여 스캔하는 것이 차단됩니다. 따라서 제외된 상위 디렉토리 내에 있는 +파일이나 하위 디렉토리는 스캐너가 탐색하지 않으므로 \`include\` 규칙으로 다시 +포함할 수 없습니다. +.PP +예를 들어, 다음 설정에서는 \`/keep/\`이 가지치기되므로 \`file.dat\`가 포함되지 +않습니다: +.PP +.RS 4 +# 의도대로 작동하지 않음: /keep/ 전체를 건너뜀 +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +디렉토리 자체를 제외하지 않고 특정 파일만 유지하면서 내부 파일들을 제외하려면, +디렉토리 자체가 아니라 내부의 파일 패턴을 제외하십시오: +.PP +.RS 4 +# 의도대로 작동함: /keep/을 순회하지만 내부의 다른 파일들은 제외됨 +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP 명령줄에서 \-f 옵션을 사용할 때 \`include\` 패턴만 사용할 수 있습니다. 예를 들어: .PP diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 1e16c9c2..694b0e74 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1159,6 +1159,10 @@ Name{number} 일치하는 패턴이 없으면, 지정된 마지막 패턴이 `include`이면 파일은 제외되고, `exclude`이면 포함됩니다. + 필터링은 디렉토리 순회 중에 계층적으로 수행됩니다. 디렉토리가 `exclude` + 규칙과 일치하면 해당 디렉토리 전체가 건너뛰어지며(가지치기됨), 그 안에 + 있는 파일이나 하위 디렉토리에 대한 `include` 규칙은 평가되지 않습니다. + 패턴 사양에 대한 자세한 내용은 PATTERN 섹션을 참조하십시오. 이 옵션은 여러 번 사용될 수 있습니다. @@ -1583,6 +1587,25 @@ Name{number} :include /musics/ :include /pictures/ + 디렉토리를 제외하면(DIR/ 또는 /PATH/DIR/ 사용) SnapRAID가 해당 디렉토리에 + 진입하여 스캔하는 것이 차단됩니다. 따라서 제외된 상위 디렉토리 내에 있는 + 파일이나 하위 디렉토리는 스캐너가 탐색하지 않으므로 `include` 규칙으로 다시 + 포함할 수 없습니다. + + 예를 들어, 다음 설정에서는 `/keep/`이 가지치기되므로 `file.dat`가 포함되지 + 않습니다: + + :# 의도대로 작동하지 않음: /keep/ 전체를 건너뜀 + :include /keep/file.dat + :exclude /keep/ + + 디렉토리 자체를 제외하지 않고 특정 파일만 유지하면서 내부 파일들을 제외하려면, + 디렉토리 자체가 아니라 내부의 파일 패턴을 제외하십시오: + + :# 의도대로 작동함: /keep/을 순회하지만 내부의 다른 파일들은 제외됨 + :include /keep/file.dat + :exclude /keep/* + 명령줄에서 -f 옵션을 사용할 때 `include` 패턴만 사용할 수 있습니다. 예를 들어: diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index d2cc419e..ca56cc98 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1241,6 +1241,10 @@ sync 프로세스에서 제외하거나 포함할 파일 또는 디렉토리 패 일치하는 패턴이 없으면, 지정된 마지막 패턴이 `include`이면 파일은 제외되고, `exclude`이면 포함됩니다. +필터링은 디렉토리 순회 중에 계층적으로 수행됩니다. 디렉토리가 `exclude` +규칙과 일치하면 해당 디렉토리 전체가 건너뛰어지며(가지치기됨), 그 안에 +있는 파일이나 하위 디렉토리에 대한 `include` 규칙은 평가되지 않습니다. + 패턴 사양에 대한 자세한 내용은 PATTERN 섹션을 참조하십시오. 이 옵션은 여러 번 사용될 수 있습니다. @@ -1696,6 +1700,25 @@ Windows에서는 `^`입니다. include /musics/ include /pictures/ +디렉토리를 제외하면(DIR/ 또는 /PATH/DIR/ 사용) SnapRAID가 해당 디렉토리에 +진입하여 스캔하는 것이 차단됩니다. 따라서 제외된 상위 디렉토리 내에 있는 +파일이나 하위 디렉토리는 스캐너가 탐색하지 않으므로 `include` 규칙으로 다시 +포함할 수 없습니다. + +예를 들어, 다음 설정에서는 `/keep/`이 가지치기되므로 `file.dat`가 포함되지 +않습니다: + + # 의도대로 작동하지 않음: /keep/ 전체를 건너뜀 + include /keep/file.dat + exclude /keep/ + +디렉토리 자체를 제외하지 않고 특정 파일만 유지하면서 내부 파일들을 제외하려면, +디렉토리 자체가 아니라 내부의 파일 패턴을 제외하십시오: + + # 의도대로 작동함: /keep/을 순회하지만 내부의 다른 파일들은 제외됨 + include /keep/file.dat + exclude /keep/* + 명령줄에서 -f 옵션을 사용할 때 `include` 패턴만 사용할 수 있습니다. 예를 들어: diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index cd1e776e..2ffd2f9a 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -1483,6 +1483,11 @@ jest wykluczony. Jeśli jest to \`include\`, plik jest włączony. Jeśli żaden wzorzec nie pasuje, plik jest wykluczony, jeśli ostatni określony wzorzec to \`include\`, lub włączony, jeśli ostatni określony wzorzec to \`exclude\`. .PP +Należy pamiętać, że filtrowanie odbywa się hierarchicznie podczas +przechodzenia katalogów. Jeśli katalog pasuje do reguły \`exclude\`, cały +katalog jest pomijany (odrzucany), a wszelkie reguły \`include\` dla plików +lub podkatalogów w nim zawartych nie będą oceniane. +.PP Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji wzorców. .PP @@ -2112,6 +2117,47 @@ include /pictures/ .PD .RE .PP +Należy pamiętać, że wykluczenie katalogu (za pomocą DIR/ lub /PATH/DIR/) +uniemożliwia programowi SnapRAID wejście i skanowanie tego katalogu. +W konsekwencji nie jest możliwe ponowne włączenie pliku lub podkatalogu +znajdującego się w wykluczonym katalogu nadrzędnym, ponieważ skaner nigdy +do niego nie przechodzi. +.PP +Na przykład poniższa konfiguracja NIE uwzględni pliku \`file.dat\`, +ponieważ katalog \`/keep/\` zostanie odrzucony, zanim \`file.dat\` będzie +mógł zostać sprawdzony: +.PP +.RS 4 +# NIE działa zgodnie z oczekiwaniami: /keep/ jest całkowicie pomijany +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Aby wykluczyć pliki wewnątrz katalogu, zachowując wybrane, należy dopasować +wzorzec plików wewnątrz katalogu, zamiast wykluczać sam katalog: +.PP +.RS 4 +# Działa: /keep/ jest przeszukiwany, ale pozostałe pliki są wykluczane +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP W wierszu poleceń, używając opcji \-f, możesz użyć tylko wzorców \`include\`. Na przykład: .PP diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index e18263d0..0effe1cb 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1201,6 +1201,11 @@ Konfiguracja (Configuration) Jeśli żaden wzorzec nie pasuje, plik jest wykluczony, jeśli ostatni określony wzorzec to `include`, lub włączony, jeśli ostatni określony wzorzec to `exclude`. + Należy pamiętać, że filtrowanie odbywa się hierarchicznie podczas + przechodzenia katalogów. Jeśli katalog pasuje do reguły `exclude`, cały + katalog jest pomijany (odrzucany), a wszelkie reguły `include` dla plików + lub podkatalogów w nim zawartych nie będą oceniane. + Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji wzorców. @@ -1660,6 +1665,27 @@ Wzorce (Pattern) :include /musics/ :include /pictures/ + Należy pamiętać, że wykluczenie katalogu (za pomocą DIR/ lub /PATH/DIR/) + uniemożliwia programowi SnapRAID wejście i skanowanie tego katalogu. + W konsekwencji nie jest możliwe ponowne włączenie pliku lub podkatalogu + znajdującego się w wykluczonym katalogu nadrzędnym, ponieważ skaner nigdy + do niego nie przechodzi. + + Na przykład poniższa konfiguracja NIE uwzględni pliku `file.dat`, + ponieważ katalog `/keep/` zostanie odrzucony, zanim `file.dat` będzie + mógł zostać sprawdzony: + + :# NIE działa zgodnie z oczekiwaniami: /keep/ jest całkowicie pomijany + :include /keep/file.dat + :exclude /keep/ + + Aby wykluczyć pliki wewnątrz katalogu, zachowując wybrane, należy dopasować + wzorzec plików wewnątrz katalogu, zamiast wykluczać sam katalog: + + :# Działa: /keep/ jest przeszukiwany, ale pozostałe pliki są wykluczane + :include /keep/file.dat + :exclude /keep/* + W wierszu poleceń, używając opcji -f, możesz użyć tylko wzorców `include`. Na przykład: diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index af9bd695..2dd45901 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1283,6 +1283,11 @@ jest wykluczony. Jeśli jest to `include`, plik jest włączony. Jeśli żaden wzorzec nie pasuje, plik jest wykluczony, jeśli ostatni określony wzorzec to `include`, lub włączony, jeśli ostatni określony wzorzec to `exclude`. +Należy pamiętać, że filtrowanie odbywa się hierarchicznie podczas +przechodzenia katalogów. Jeśli katalog pasuje do reguły `exclude`, cały +katalog jest pomijany (odrzucany), a wszelkie reguły `include` dla plików +lub podkatalogów w nim zawartych nie będą oceniane. + Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji wzorców. @@ -1773,6 +1778,27 @@ wszystkie reguły `include`. Na przykład: include /musics/ include /pictures/ +Należy pamiętać, że wykluczenie katalogu (za pomocą DIR/ lub /PATH/DIR/) +uniemożliwia programowi SnapRAID wejście i skanowanie tego katalogu. +W konsekwencji nie jest możliwe ponowne włączenie pliku lub podkatalogu +znajdującego się w wykluczonym katalogu nadrzędnym, ponieważ skaner nigdy +do niego nie przechodzi. + +Na przykład poniższa konfiguracja NIE uwzględni pliku `file.dat`, +ponieważ katalog `/keep/` zostanie odrzucony, zanim `file.dat` będzie +mógł zostać sprawdzony: + + # NIE działa zgodnie z oczekiwaniami: /keep/ jest całkowicie pomijany + include /keep/file.dat + exclude /keep/ + +Aby wykluczyć pliki wewnątrz katalogu, zachowując wybrane, należy dopasować +wzorzec plików wewnątrz katalogu, zamiast wykluczać sam katalog: + + # Działa: /keep/ jest przeszukiwany, ale pozostałe pliki są wykluczane + include /keep/file.dat + exclude /keep/* + W wierszu poleceń, używając opcji -f, możesz użyć tylko wzorców `include`. Na przykład: diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index ea985ceb..6f2d3e8c 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -1514,6 +1514,11 @@ Se nenhum padrão corresponder, o arquivo é excluído se o último padrão especificado for um \`include\`, ou incluído se o último padrão especificado for um \`exclude\`. .PP +Observe que a filtragem ocorre hierarquicamente durante o percurso +dos diretórios. Se um diretório corresponder a uma regra \`exclude\`, +todo o diretório será ignorado (podado) e nenhuma regra \`include\` para +arquivos ou subdiretórios dentro dele será avaliada. +.PP Consulte a seção PATTERN para obter mais detalhes sobre especificações de padrão. .PP @@ -2150,6 +2155,46 @@ include /pictures/ .PD .RE .PP +Observe que a exclusão de um diretório (usando DIR/ ou /CAMINHO/DIR/) +impede que o SnapRAID entre e examine esse diretório. Consequentemente, +não é possível reincluir um arquivo ou subdiretório localizado dentro +de um diretório pai excluído, porque o verificador nunca entra nele. +.PP +Por exemplo, a seguinte configuração NÃO incluirá \`file.dat\` porque +\`/keep/\` é podado antes que \`file.dat\` possa ser examinado: +.PP +.RS 4 +# NÃO funciona: /keep/ é ignorado completamente +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Para excluir arquivos dentro de um diretório mantendo arquivos específicos, +aplique o padrão aos arquivos dentro do diretório em vez de excluir o +próprio diretório: +.PP +.RS 4 +# Funciona: /keep/ é percorrido, mas os outros arquivos nele são excluídos +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP Na linha de comando, usando a opção \-f, você pode usar apenas padrões \`include\`. Por exemplo: .PP diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index fb7c3f1d..a4993a78 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1232,6 +1232,11 @@ Configuração (Configuration) especificado for um `include`, ou incluído se o último padrão especificado for um `exclude`. + Observe que a filtragem ocorre hierarquicamente durante o percurso + dos diretórios. Se um diretório corresponder a uma regra `exclude`, + todo o diretório será ignorado (podado) e nenhuma regra `include` para + arquivos ou subdiretórios dentro dele será avaliada. + Consulte a seção PATTERN para obter mais detalhes sobre especificações de padrão. @@ -1698,6 +1703,26 @@ Padrão (Pattern) :include /musics/ :include /pictures/ + Observe que a exclusão de um diretório (usando DIR/ ou /CAMINHO/DIR/) + impede que o SnapRAID entre e examine esse diretório. Consequentemente, + não é possível reincluir um arquivo ou subdiretório localizado dentro + de um diretório pai excluído, porque o verificador nunca entra nele. + + Por exemplo, a seguinte configuração NÃO incluirá `file.dat` porque + `/keep/` é podado antes que `file.dat` possa ser examinado: + + :# NÃO funciona: /keep/ é ignorado completamente + :include /keep/file.dat + :exclude /keep/ + + Para excluir arquivos dentro de um diretório mantendo arquivos específicos, + aplique o padrão aos arquivos dentro do diretório em vez de excluir o + próprio diretório: + + :# Funciona: /keep/ é percorrido, mas os outros arquivos nele são excluídos + :include /keep/file.dat + :exclude /keep/* + Na linha de comando, usando a opção -f, você pode usar apenas padrões `include`. Por exemplo: diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index 38bee717..57936d1e 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -1314,6 +1314,11 @@ Se nenhum padrão corresponder, o arquivo é excluído se o último padrão especificado for um `include`, ou incluído se o último padrão especificado for um `exclude`. +Observe que a filtragem ocorre hierarquicamente durante o percurso +dos diretórios. Se um diretório corresponder a uma regra `exclude`, +todo o diretório será ignorado (podado) e nenhuma regra `include` para +arquivos ou subdiretórios dentro dele será avaliada. + Consulte a seção PATTERN para obter mais detalhes sobre especificações de padrão. @@ -1811,6 +1816,26 @@ depois todas as regras `include`. Por exemplo: include /musics/ include /pictures/ +Observe que a exclusão de um diretório (usando DIR/ ou /CAMINHO/DIR/) +impede que o SnapRAID entre e examine esse diretório. Consequentemente, +não é possível reincluir um arquivo ou subdiretório localizado dentro +de um diretório pai excluído, porque o verificador nunca entra nele. + +Por exemplo, a seguinte configuração NÃO incluirá `file.dat` porque +`/keep/` é podado antes que `file.dat` possa ser examinado: + + # NÃO funciona: /keep/ é ignorado completamente + include /keep/file.dat + exclude /keep/ + +Para excluir arquivos dentro de um diretório mantendo arquivos específicos, +aplique o padrão aos arquivos dentro do diretório em vez de excluir o +próprio diretório: + + # Funciona: /keep/ é percorrido, mas os outros arquivos nele são excluídos + include /keep/file.dat + exclude /keep/* + Na linha de comando, usando a opção -f, você pode usar apenas padrões `include`. Por exemplo: diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 19a3c68e..e8417488 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -1480,6 +1480,11 @@ Dacă niciun model nu se potrivește, fișierul este exclus dacă ultimul model specificat este un \`include\`, sau inclus dacă ultimul model specificat este un \`exclude\`. .PP +Rețineți că filtrarea se produce ierarhic în timpul parcurgerii +directoarelor. Dacă un director se potrivește cu o regulă \`exclude\`, +întregul director este omis (eliminat), iar regulile \`include\` pentru +fișierele sau subdirectoarele din interiorul său nu vor fi evaluate. +.PP Vedeți secțiunea PATTERN pentru mai multe detalii despre specificațiile modelului. .PP @@ -2110,6 +2115,46 @@ include /pictures/ .PD .RE .PP +Rețineți că excluderea unui director (folosind DIR/ sau /CALE/DIR/) +împiedică SnapRAID să intre și să scaneze acel director. Prin urmare, +nu este posibil să reincludeți un fișier sau un subdirector situat +într\-un director părinte exclus, deoarece scanerul nu îl parcurge niciodată. +.PP +De exemplu, următoarea configurație NU va include \`file.dat\` deoarece +\`/keep/\` este eliminat înainte ca \`file.dat\` să poată fi examinat: +.PP +.RS 4 +# NU funcționează: /keep/ este omis complet +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Pentru a exclude fișierele dintr\-un director păstrând anumite fișiere +specifice, excludeți modelul fișierelor din interiorul directorului, +în loc să excludeți directorul în sine: +.PP +.RS 4 +# Funcționează: /keep/ este parcurs, dar celelalte fișiere din interior sunt excluse +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP Pe linia de comandă, utilizând opțiunea \-f, puteți utiliza doar modele \`include\`. De exemplu: .PP diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index e56721b9..01d0fdf3 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1198,6 +1198,11 @@ Configurare (Configuration) specificat este un `include`, sau inclus dacă ultimul model specificat este un `exclude`. + Rețineți că filtrarea se produce ierarhic în timpul parcurgerii + directoarelor. Dacă un director se potrivește cu o regulă `exclude`, + întregul director este omis (eliminat), iar regulile `include` pentru + fișierele sau subdirectoarele din interiorul său nu vor fi evaluate. + Vedeți secțiunea PATTERN pentru mai multe detalii despre specificațiile modelului. @@ -1658,6 +1663,26 @@ Model (Pattern) :include /musics/ :include /pictures/ + Rețineți că excluderea unui director (folosind DIR/ sau /CALE/DIR/) + împiedică SnapRAID să intre și să scaneze acel director. Prin urmare, + nu este posibil să reincludeți un fișier sau un subdirector situat + într-un director părinte exclus, deoarece scanerul nu îl parcurge niciodată. + + De exemplu, următoarea configurație NU va include `file.dat` deoarece + `/keep/` este eliminat înainte ca `file.dat` să poată fi examinat: + + :# NU funcționează: /keep/ este omis complet + :include /keep/file.dat + :exclude /keep/ + + Pentru a exclude fișierele dintr-un director păstrând anumite fișiere + specifice, excludeți modelul fișierelor din interiorul directorului, + în loc să excludeți directorul în sine: + + :# Funcționează: /keep/ este parcurs, dar celelalte fișiere din interior sunt excluse + :include /keep/file.dat + :exclude /keep/* + Pe linia de comandă, utilizând opțiunea -f, puteți utiliza doar modele `include`. De exemplu: diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 00bb0574..31d1ca74 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -1280,6 +1280,11 @@ Dacă niciun model nu se potrivește, fișierul este exclus dacă ultimul model specificat este un `include`, sau inclus dacă ultimul model specificat este un `exclude`. +Rețineți că filtrarea se produce ierarhic în timpul parcurgerii +directoarelor. Dacă un director se potrivește cu o regulă `exclude`, +întregul director este omis (eliminat), iar regulile `include` pentru +fișierele sau subdirectoarele din interiorul său nu vor fi evaluate. + Vedeți secțiunea PATTERN pentru mai multe detalii despre specificațiile modelului. @@ -1771,6 +1776,26 @@ toate regulile `include`. De exemplu: include /musics/ include /pictures/ +Rețineți că excluderea unui director (folosind DIR/ sau /CALE/DIR/) +împiedică SnapRAID să intre și să scaneze acel director. Prin urmare, +nu este posibil să reincludeți un fișier sau un subdirector situat +într-un director părinte exclus, deoarece scanerul nu îl parcurge niciodată. + +De exemplu, următoarea configurație NU va include `file.dat` deoarece +`/keep/` este eliminat înainte ca `file.dat` să poată fi examinat: + + # NU funcționează: /keep/ este omis complet + include /keep/file.dat + exclude /keep/ + +Pentru a exclude fișierele dintr-un director păstrând anumite fișiere +specifice, excludeți modelul fișierelor din interiorul directorului, +în loc să excludeți directorul în sine: + + # Funcționează: /keep/ este parcurs, dar celelalte fișiere din interior sunt excluse + include /keep/file.dat + exclude /keep/* + Pe linia de comandă, utilizând opțiunea -f, puteți utiliza doar modele `include`. De exemplu: diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 46aea19a..9269d29a 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -1485,6 +1485,11 @@ UUID дисков. указанный шаблон — это \`include\`, или включается, если последний шаблон — это \`exclude\`. .PP +Обратите внимание, что фильтрация выполняется иерархически во время +обхода каталогов. Если каталог совпадает с правилом \`exclude\`, весь +каталог пропускается (отсекается), и любые правила \`include\` для +файлов или подкаталогов внутри него не будут оцениваться. +.PP Подробнее о спецификациях шаблонов см. в разделе PATTERN. .PP Эту опцию можно использовать несколько раз. @@ -2115,6 +2120,46 @@ include /pictures/ .PD .RE .PP +Обратите внимание, что исключение каталога (с помощью DIR/ или /PATH/DIR/) +предотвращает вход SnapRAID в этот каталог и его сканирование. +Следовательно, невозможно повторно включить файл или подкаталог, +находящийся внутри исключенного родительского каталога, поскольку сканер +никогда не переходит в него. +.PP +Например, следующая конфигурация НЕ включит \`file.dat\`, поскольку +\`/keep/\` отсекается до того, как \`file.dat\` сможет быть проверен: +.PP +.RS 4 +# НЕ работает как ожидается: /keep/ полностью пропускается +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Чтобы исключить файлы внутри каталога, сохранив определенные файлы, +исключайте шаблон файлов внутри каталога, а не сам каталог: +.PP +.RS 4 +# Работает: /keep/ сканируется, но остальные файлы внутри него исключаются +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP В командной строке, используя опцию \-f, вы можете использовать только шаблоны \`include\`. Например: .PP diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index 8f92a4ef..8abf8cf8 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1203,6 +1203,11 @@ Name{number} указанный шаблон — это `include`, или включается, если последний шаблон — это `exclude`. + Обратите внимание, что фильтрация выполняется иерархически во время + обхода каталогов. Если каталог совпадает с правилом `exclude`, весь + каталог пропускается (отсекается), и любые правила `include` для + файлов или подкаталогов внутри него не будут оцениваться. + Подробнее о спецификациях шаблонов см. в разделе PATTERN. Эту опцию можно использовать несколько раз. @@ -1665,6 +1670,26 @@ Name{number} :include /musics/ :include /pictures/ + Обратите внимание, что исключение каталога (с помощью DIR/ или /PATH/DIR/) + предотвращает вход SnapRAID в этот каталог и его сканирование. + Следовательно, невозможно повторно включить файл или подкаталог, + находящийся внутри исключенного родительского каталога, поскольку сканер + никогда не переходит в него. + + Например, следующая конфигурация НЕ включит `file.dat`, поскольку + `/keep/` отсекается до того, как `file.dat` сможет быть проверен: + + :# НЕ работает как ожидается: /keep/ полностью пропускается + :include /keep/file.dat + :exclude /keep/ + + Чтобы исключить файлы внутри каталога, сохранив определенные файлы, + исключайте шаблон файлов внутри каталога, а не сам каталог: + + :# Работает: /keep/ сканируется, но остальные файлы внутри него исключаются + :include /keep/file.dat + :exclude /keep/* + В командной строке, используя опцию -f, вы можете использовать только шаблоны `include`. Например: diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index 366ce581..a4384be5 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -1285,6 +1285,11 @@ UUID дисков. указанный шаблон — это `include`, или включается, если последний шаблон — это `exclude`. +Обратите внимание, что фильтрация выполняется иерархически во время +обхода каталогов. Если каталог совпадает с правилом `exclude`, весь +каталог пропускается (отсекается), и любые правила `include` для +файлов или подкаталогов внутри него не будут оцениваться. + Подробнее о спецификациях шаблонов см. в разделе PATTERN. Эту опцию можно использовать несколько раз. @@ -1778,6 +1783,26 @@ SnapRAID управляет тремя конкретными снимками, include /musics/ include /pictures/ +Обратите внимание, что исключение каталога (с помощью DIR/ или /PATH/DIR/) +предотвращает вход SnapRAID в этот каталог и его сканирование. +Следовательно, невозможно повторно включить файл или подкаталог, +находящийся внутри исключенного родительского каталога, поскольку сканер +никогда не переходит в него. + +Например, следующая конфигурация НЕ включит `file.dat`, поскольку +`/keep/` отсекается до того, как `file.dat` сможет быть проверен: + + # НЕ работает как ожидается: /keep/ полностью пропускается + include /keep/file.dat + exclude /keep/ + +Чтобы исключить файлы внутри каталога, сохранив определенные файлы, +исключайте шаблон файлов внутри каталога, а не сам каталог: + + # Работает: /keep/ сканируется, но остальные файлы внутри него исключаются + include /keep/file.dat + exclude /keep/* + В командной строке, используя опцию -f, вы можете использовать только шаблоны `include`. Например: diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 70db64a2..d9990953 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -1486,6 +1486,11 @@ Om inget mönster matchar, exkluderas filen om det sista mönstret som specificerats är ett \`include\`\-mönster, eller inkluderas om det sista mönstret som specificerats är ett \`exclude\`\-mönster. .PP +Observera att filtrering sker hierarkiskt under kataloggenomgång. +Om en katalog matchar en \`exclude\`\-regel hoppas hela katalogen över +(beskärs), och eventuella \`include\`\-regler för filer eller underkataloger +inuti den kommer inte att utvärderas. +.PP Se avsnittet PATTERN för mer information om mönster\- specifikationer. .PP @@ -2113,6 +2118,46 @@ include /pictures/ .PD .RE .PP +Observera att exkludering av en katalog (med DIR/ eller /SÖKVÄG/DIR/) +förhindrar SnapRAID från att gå in i och skanna den katalogen. +Följaktligen är det inte möjligt att åter inkludera en fil eller +underkatalog som finns i en exkluderad överordnad katalog, eftersom +skannern aldrig går in i den. +.PP +Till exempel kommer följande konfiguration INTE att inkludera \`file.dat\` +eftersom \`/keep/\` beskärs innan \`file.dat\` kan utvärderas: +.PP +.RS 4 +# Fungerar INTE: /keep/ hoppas över helt +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +För att exkludera filer i en katalog men behålla specifika filer, +matcha filmönstret inuti katalogen istället för att exkludera själva katalogen: +.PP +.RS 4 +# Fungerar: /keep/ genomsöks, men övriga filer inuti exkluderas +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP På kommandoraden, med hjälp av alternativet \-f, kan du bara använda \`include\`\- mönster. Till exempel: .PP diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index d2c5c114..d0bb3864 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1204,6 +1204,11 @@ Konfiguration (Configuration) som specificerats är ett `include`-mönster, eller inkluderas om det sista mönstret som specificerats är ett `exclude`-mönster. + Observera att filtrering sker hierarkiskt under kataloggenomgång. + Om en katalog matchar en `exclude`-regel hoppas hela katalogen över + (beskärs), och eventuella `include`-regler för filer eller underkataloger + inuti den kommer inte att utvärderas. + Se avsnittet PATTERN för mer information om mönster- specifikationer. @@ -1661,6 +1666,26 @@ Mönster (Pattern) :include /musics/ :include /pictures/ + Observera att exkludering av en katalog (med DIR/ eller /SÖKVÄG/DIR/) + förhindrar SnapRAID från att gå in i och skanna den katalogen. + Följaktligen är det inte möjligt att åter inkludera en fil eller + underkatalog som finns i en exkluderad överordnad katalog, eftersom + skannern aldrig går in i den. + + Till exempel kommer följande konfiguration INTE att inkludera `file.dat` + eftersom `/keep/` beskärs innan `file.dat` kan utvärderas: + + :# Fungerar INTE: /keep/ hoppas över helt + :include /keep/file.dat + :exclude /keep/ + + För att exkludera filer i en katalog men behålla specifika filer, + matcha filmönstret inuti katalogen istället för att exkludera själva katalogen: + + :# Fungerar: /keep/ genomsöks, men övriga filer inuti exkluderas + :include /keep/file.dat + :exclude /keep/* + På kommandoraden, med hjälp av alternativet -f, kan du bara använda `include`- mönster. Till exempel: diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 12e3b83b..ed0e7036 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -1286,6 +1286,11 @@ Om inget mönster matchar, exkluderas filen om det sista mönstret som specificerats är ett `include`-mönster, eller inkluderas om det sista mönstret som specificerats är ett `exclude`-mönster. +Observera att filtrering sker hierarkiskt under kataloggenomgång. +Om en katalog matchar en `exclude`-regel hoppas hela katalogen över +(beskärs), och eventuella `include`-regler för filer eller underkataloger +inuti den kommer inte att utvärderas. + Se avsnittet PATTERN för mer information om mönster- specifikationer. @@ -1774,6 +1779,26 @@ alla `include`-regler. Till exempel: include /musics/ include /pictures/ +Observera att exkludering av en katalog (med DIR/ eller /SÖKVÄG/DIR/) +förhindrar SnapRAID från att gå in i och skanna den katalogen. +Följaktligen är det inte möjligt att åter inkludera en fil eller +underkatalog som finns i en exkluderad överordnad katalog, eftersom +skannern aldrig går in i den. + +Till exempel kommer följande konfiguration INTE att inkludera `file.dat` +eftersom `/keep/` beskärs innan `file.dat` kan utvärderas: + + # Fungerar INTE: /keep/ hoppas över helt + include /keep/file.dat + exclude /keep/ + +För att exkludera filer i en katalog men behålla specifika filer, +matcha filmönstret inuti katalogen istället för att exkludera själva katalogen: + + # Fungerar: /keep/ genomsöks, men övriga filer inuti exkluderas + include /keep/file.dat + exclude /keep/* + På kommandoraden, med hjälp av alternativet -f, kan du bara använda `include`- mönster. Till exempel: diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index a36c580f..602aa050 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -1612,6 +1612,11 @@ UUID дисків. якщо останній вказаний шаблон є \`include\`, або включається, якщо останній вказаний шаблон є \`exclude\`. .PP +Зверніть увагу, що фільтрація відбувається ієрархічно під час +обходу каталогів. Якщо каталог відповідає правилу \`exclude\`, весь +каталог пропускається (відсікається), і будь\-які правила \`include\` +для файлів або підкаталогів у ньому не оцінюватимуться. +.PP Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. .PP @@ -2298,6 +2303,45 @@ include /pictures/ .PD .RE .PP +Зверніть увагу, що виключення каталогу (за допомогою DIR/ або /ШЛЯХ/DIR/) +запобігає входу SnapRAID у цей каталог та його скануванню. Відповідно, +неможливо повторно включити файл або підкаталог, розташований усередині +виключеного батьківського каталогу, оскільки сканер ніколи не переходить у нього. +.PP +Наприклад, наступна конфігурація НЕ включить \`file.dat\`, оскільки +\`/keep/\` відсікається до того, як \`file.dat\` буде перевірено: +.PP +.RS 4 +# НЕ працює як очікується: /keep/ повністю пропускається +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +Щоб виключити файли всередині каталогу, зберігши конкретні файли, +виключайте шаблон файлів усередині каталогу замість виключення самого каталогу: +.PP +.RS 4 +# Працює: /keep/ сканується, але інші файли всередині виключаються +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP У командному рядку, використовуючи опцію \-f, ви можете використовувати лише шаблони \`include\`. Наприклад: diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index bf528903..83a2b76b 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -1319,6 +1319,11 @@ Name{number} якщо останній вказаний шаблон є `include`, або включається, якщо останній вказаний шаблон є `exclude`. + Зверніть увагу, що фільтрація відбувається ієрархічно під час + обходу каталогів. Якщо каталог відповідає правилу `exclude`, весь + каталог пропускається (відсікається), і будь-які правила `include` + для файлів або підкаталогів у ньому не оцінюватимуться. + Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. @@ -1837,6 +1842,25 @@ Name{number} :include /musics/ :include /pictures/ + Зверніть увагу, що виключення каталогу (за допомогою DIR/ або /ШЛЯХ/DIR/) + запобігає входу SnapRAID у цей каталог та його скануванню. Відповідно, + неможливо повторно включити файл або підкаталог, розташований усередині + виключеного батьківського каталогу, оскільки сканер ніколи не переходить у нього. + + Наприклад, наступна конфігурація НЕ включить `file.dat`, оскільки + `/keep/` відсікається до того, як `file.dat` буде перевірено: + + :# НЕ працює як очікується: /keep/ повністю пропускається + :include /keep/file.dat + :exclude /keep/ + + Щоб виключити файли всередині каталогу, зберігши конкретні файли, + виключайте шаблон файлів усередині каталогу замість виключення самого каталогу: + + :# Працює: /keep/ сканується, але інші файли всередині виключаються + :include /keep/file.dat + :exclude /keep/* + У командному рядку, використовуючи опцію -f, ви можете використовувати лише шаблони `include`. Наприклад: diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 1cba97ac..060b643f 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -1401,6 +1401,11 @@ UUID дисків. якщо останній вказаний шаблон є `include`, або включається, якщо останній вказаний шаблон є `exclude`. +Зверніть увагу, що фільтрація відбувається ієрархічно під час +обходу каталогів. Якщо каталог відповідає правилу `exclude`, весь +каталог пропускається (відсікається), і будь-які правила `include` +для файлів або підкаталогів у ньому не оцінюватимуться. + Дивіться розділ PATTERN для отримання додаткової інформації про специфікації шаблонів. @@ -1950,6 +1955,25 @@ SnapRAID керує трьома конкретними знімками, `stabl include /musics/ include /pictures/ +Зверніть увагу, що виключення каталогу (за допомогою DIR/ або /ШЛЯХ/DIR/) +запобігає входу SnapRAID у цей каталог та його скануванню. Відповідно, +неможливо повторно включити файл або підкаталог, розташований усередині +виключеного батьківського каталогу, оскільки сканер ніколи не переходить у нього. + +Наприклад, наступна конфігурація НЕ включить `file.dat`, оскільки +`/keep/` відсікається до того, як `file.dat` буде перевірено: + + # НЕ працює як очікується: /keep/ повністю пропускається + include /keep/file.dat + exclude /keep/ + +Щоб виключити файли всередині каталогу, зберігши конкретні файли, +виключайте шаблон файлів усередині каталогу замість виключення самого каталогу: + + # Працює: /keep/ сканується, але інші файли всередині виключаються + include /keep/file.dat + exclude /keep/* + У командному рядку, використовуючи опцію -f, ви можете використовувати лише шаблони `include`. Наприклад: diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index e386c763..06394666 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -1329,6 +1329,9 @@ DIR 是磁盘在文件系统中的挂载点。 如果没有模式匹配，则如果指定的最后一个模式是 \`include\`，则排除该文件， 或者如果指定的最后一个模式是 \`exclude\`，则包含该文件。 .PP +请注意，过滤是在目录遍历期间分层进行的。如果目录匹配 \`exclude\` 规则， +则整个目录将被跳过（修剪），并且不会评估其内部文件或子目录的任何 \`include\` 规则。 +.PP 有关模式规范的更多详细信息，请参阅 PATTERN 部分。 .PP 此选项可以多次使用。 @@ -1900,6 +1903,42 @@ include /pictures/ .PD .RE .PP +请注意，排除目录（使用 DIR/ 或 /PATH/DIR/）会阻止 SnapRAID 进入并扫描该目录。 +因此，无法使用 \`include\` 规则重新包含位于已排除父目录内的文件或子目录， +因为扫描器根本不会遍历到该目录中。 +.PP +例如，以下配置将不会包含 \`file.dat\`，因为 \`/keep/\` 在看到 \`file.dat\` 之前已被修剪： +.PP +.RS 4 +# 无法按预期工作: /keep/ 会被完全跳过 +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +若要排除目录中的文件但保留特定文件，请匹配目录内的文件模式，而不是排除目录本身： +.PP +.RS 4 +# 可以正常工作: 会遍历 /keep/，但其中的其他文件会被排除 +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP 在命令行上，使用 \-f 选项，您只能使用 \`include\` 模式。例如： .PP diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 40a11835..be7a6121 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1047,6 +1047,9 @@ Name{number} 如果没有模式匹配，则如果指定的最后一个模式是 `include`，则排除该文件， 或者如果指定的最后一个模式是 `exclude`，则包含该文件。 + 请注意，过滤是在目录遍历期间分层进行的。如果目录匹配 `exclude` 规则， + 则整个目录将被跳过（修剪），并且不会评估其内部文件或子目录的任何 `include` 规则。 + 有关模式规范的更多详细信息，请参阅 PATTERN 部分。 此选项可以多次使用。 @@ -1448,6 +1451,22 @@ Name{number} :include /musics/ :include /pictures/ + 请注意，排除目录（使用 DIR/ 或 /PATH/DIR/）会阻止 SnapRAID 进入并扫描该目录。 + 因此，无法使用 `include` 规则重新包含位于已排除父目录内的文件或子目录， + 因为扫描器根本不会遍历到该目录中。 + + 例如，以下配置将不会包含 `file.dat`，因为 `/keep/` 在看到 `file.dat` 之前已被修剪： + + :# 无法按预期工作: /keep/ 会被完全跳过 + :include /keep/file.dat + :exclude /keep/ + + 若要排除目录中的文件但保留特定文件，请匹配目录内的文件模式，而不是排除目录本身： + + :# 可以正常工作: 会遍历 /keep/，但其中的其他文件会被排除 + :include /keep/file.dat + :exclude /keep/* + 在命令行上，使用 -f 选项，您只能使用 `include` 模式。例如： diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index 8f799519..6d306cd5 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1129,6 +1129,9 @@ DIR 是磁盘在文件系统中的挂载点。 如果没有模式匹配，则如果指定的最后一个模式是 `include`，则排除该文件， 或者如果指定的最后一个模式是 `exclude`，则包含该文件。 +请注意，过滤是在目录遍历期间分层进行的。如果目录匹配 `exclude` 规则， +则整个目录将被跳过（修剪），并且不会评估其内部文件或子目录的任何 `include` 规则。 + 有关模式规范的更多详细信息，请参阅 PATTERN 部分。 此选项可以多次使用。 @@ -1561,6 +1564,22 @@ globbing 字符。在 Unix 中，转义字符是 `\`；在 Windows 中，它是 include /musics/ include /pictures/ +请注意，排除目录（使用 DIR/ 或 /PATH/DIR/）会阻止 SnapRAID 进入并扫描该目录。 +因此，无法使用 `include` 规则重新包含位于已排除父目录内的文件或子目录， +因为扫描器根本不会遍历到该目录中。 + +例如，以下配置将不会包含 `file.dat`，因为 `/keep/` 在看到 `file.dat` 之前已被修剪： + + # 无法按预期工作: /keep/ 会被完全跳过 + include /keep/file.dat + exclude /keep/ + +若要排除目录中的文件但保留特定文件，请匹配目录内的文件模式，而不是排除目录本身： + + # 可以正常工作: 会遍历 /keep/，但其中的其他文件会被排除 + include /keep/file.dat + exclude /keep/* + 在命令行上，使用 -f 选项，您只能使用 `include` 模式。例如： diff --git a/doc/snapraid.1 b/doc/snapraid.1 index 6dbaf485..7ad62a93 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -1487,6 +1487,11 @@ If no pattern matches, the file is excluded if the last pattern specified is an \`include\`, or included if the last pattern specified is an \`exclude\`. .PP +Note that filtering occurs hierarchically during directory traversal. +If a directory matches an \`exclude\` rule, the entire directory is +skipped (pruned), and any \`include\` rules for files or subdirectories +inside it will not be evaluated. +.PP See the PATTERN section for more details on pattern specifications. .PP @@ -2118,6 +2123,45 @@ include /pictures/ .PD .RE .PP +Note that excluding a directory (using DIR/ or /PATH/DIR/) prevents +SnapRAID from entering and scanning that directory. Consequently, it is +not possible to re\-include a file or subdirectory located inside an +excluded parent directory, because the scanner never traverses into it. +.PP +For example, the following configuration will NOT include \`file.dat\` +because \`/keep/\` is pruned before \`file.dat\` can be seen: +.PP +.RS 4 +# Does NOT work: /keep/ is skipped entirely +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/ +.PD 0 +.PD +.RE +.PP +To exclude files inside a directory while keeping specific ones, match +the files within the directory rather than excluding the directory itself: +.PP +.RS 4 +# Works: /keep/ is traversed, but other files inside are excluded +.PD 0 +.PP +.PD +include /keep/file.dat +.PD 0 +.PP +.PD +exclude /keep/* +.PD 0 +.PD +.RE +.PP On the command line, using the \-f option, you can only use \`include\` patterns. For example: .PP diff --git a/doc/snapraid.d b/doc/snapraid.d index 0baf0a81..6d5692ab 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1205,6 +1205,11 @@ Configuration specified is an `include`, or included if the last pattern specified is an `exclude`. + Note that filtering occurs hierarchically during directory traversal. + If a directory matches an `exclude` rule, the entire directory is + skipped (pruned), and any `include` rules for files or subdirectories + inside it will not be evaluated. + See the PATTERN section for more details on pattern specifications. @@ -1666,6 +1671,25 @@ Pattern :include /musics/ :include /pictures/ + Note that excluding a directory (using DIR/ or /PATH/DIR/) prevents + SnapRAID from entering and scanning that directory. Consequently, it is + not possible to re-include a file or subdirectory located inside an + excluded parent directory, because the scanner never traverses into it. + + For example, the following configuration will NOT include `file.dat` + because `/keep/` is pruned before `file.dat` can be seen: + + :# Does NOT work: /keep/ is skipped entirely + :include /keep/file.dat + :exclude /keep/ + + To exclude files inside a directory while keeping specific ones, match + the files within the directory rather than excluding the directory itself: + + :# Works: /keep/ is traversed, but other files inside are excluded + :include /keep/file.dat + :exclude /keep/* + On the command line, using the -f option, you can only use `include` patterns. For example: diff --git a/doc/snapraid.txt b/doc/snapraid.txt index f1d09f19..f01f78c9 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1287,6 +1287,11 @@ If no pattern matches, the file is excluded if the last pattern specified is an `include`, or included if the last pattern specified is an `exclude`. +Note that filtering occurs hierarchically during directory traversal. +If a directory matches an `exclude` rule, the entire directory is +skipped (pruned), and any `include` rules for files or subdirectories +inside it will not be evaluated. + See the PATTERN section for more details on pattern specifications. @@ -1779,6 +1784,25 @@ all the `include` rules. For example: include /musics/ include /pictures/ +Note that excluding a directory (using DIR/ or /PATH/DIR/) prevents +SnapRAID from entering and scanning that directory. Consequently, it is +not possible to re-include a file or subdirectory located inside an +excluded parent directory, because the scanner never traverses into it. + +For example, the following configuration will NOT include `file.dat` +because `/keep/` is pruned before `file.dat` can be seen: + + # Does NOT work: /keep/ is skipped entirely + include /keep/file.dat + exclude /keep/ + +To exclude files inside a directory while keeping specific ones, match +the files within the directory rather than excluding the directory itself: + + # Works: /keep/ is traversed, but other files inside are excluded + include /keep/file.dat + exclude /keep/* + On the command line, using the -f option, you can only use `include` patterns. For example: