Clarify directory pruning semantics and nested exclusion/inclusion rules

This commit is contained in:
Andrea Mazzoleni 2026-08-26 12:29:13 +02:00
parent 932b5e567e
commit 7b2007e503
42 changed files with 1315 additions and 0 deletions

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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 :

View file

@ -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 :

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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` パターンのみを
使用できます。例:

View file

@ -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` パターンのみを
使用できます。例:

View file

@ -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

View file

@ -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` 패턴만 사용할 수 있습니다.
예를 들어:

View file

@ -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` 패턴만 사용할 수 있습니다.
예를 들어:

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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

View file

@ -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`.
Например:

View file

@ -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`.
Например:

View file

@ -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

View file

@ -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:

View file

@ -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:

View file

@ -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\`.
Наприклад:

View file

@ -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`.
Наприклад:

View file

@ -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`.
Наприклад:

View file

@ -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

View file

@ -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`
模式。例如:

View file

@ -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`
模式。例如:

View file

@ -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

View file

@ -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:

View file

@ -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: