rt/snapraid
1
0
Fork 0
mirror of https://github.com/amadvance/snapraid.git synced 2026-10-25 18:40:19 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

New .snapraidignore feature

Browse source
This commit is contained in:
Andrea Mazzoleni 2026-01-10 16:30:35 +01:00
parent 6a912b4726
commit 36cef9ee89
52 changed files with 2278 additions and 158 deletions
Download patch file Download diff file Expand all files Collapse all files

4
HISTORY
View file

@ -3,6 +3,10 @@ SnapRAID HISTORY
13.1 WIP
========
* Added support for local exclusion rules via .snapraidignore files placed
directly within the array directory tree. This allows for granular,
directory-level control over which files and folders are excluded from
parity, mirroring the workflow of .gitignore.
* Added detection of the smartctl executable. Improves reliability when running
under sudo or in environments where /sbin and /usr/sbin are not in PATH.
* Avoided saving the content file when it was not strictly necessary.

47
TODO
View file

@ -5,53 +5,6 @@ This is the list of TODO items for SnapRAID.
- Next
* Distributed Exclusion Support (.snapraidignore)
See https://sourceforge.net/p/snapraid/discussion/1677233/thread/09ed63eca7/?limit=25#d058
Support decentralized exclusion rules by allowing users to place ignore files
deeper in the directory tree. This mirrors the behavior of .gitignore but
maintains the strict pathing logic of SnapRAID.
1. FILE NAME & PLACEMENT
* FILENAME: .snapraidignore
* WHY: Avoids naming conflict with Ubuntu's "snap" application ecosystem.
* PLACEMENT: Any directory within the array.
2. COMPARISON WITH .GITIGNORE
* Anchor (/): Both anchor to the local directory where the file resides.
* Folder Logic: SnapRAID is STRICT (must end in /). Git is AMBIGUOUS.
* File Logic: SnapRAID is STRICT (no / targets files). Git matches both.
* Recursive Search: Both match in current folder and all subfolders.
* Negation (!): SnapRAID does NOT SUPPORT. Git supports.
* Globbing: Both support *, ?, [a-z]. Git adds **.
3. PATTERN RULES (INTEGRATION WITH EXISTING SYNTAX)
Patterns inside .snapraidignore are treated as relative to the file location:
FILE Selects any file named FILE in this directory or below.
DIR/ Selects any directory named DIR and its contents in this
directory or below.
/PATH/FILE Selects the exact specified file relative to the
.snapraidignore location.
/PATH/DIR/ Selects the exact specified directory relative to the
.snapraidignore location.
4. EXAMPLES
If .snapraidignore is placed in: /mnt/disk1/projects/
/output.bin -> Ignores ONLY /mnt/disk1/projects/output.bin
build/ -> Ignores any folder named 'build' inside projects/
*.tmp -> Ignores any .tmp file inside projects/ or its subfolders
5. IMPLEMENTATION NOTES
* PERFORMANCE: No significant overhead. SnapRAID already performs a full
directory traversal during sync/diff; it just needs to check for the presence
of .snapraidignore in the current DIR handle.
* PRECEDENCE: Exclusions are additive. If a file is excluded by EITHER the
global snapraid.conf OR any local .snapraidignore in its path, it is excluded.
* SCOPE: A .snapraidignore file affects its parent directory and all
subdirectories beneath it.
* Integration with MergeFS ?
* Support BTRFS subvolumes. Keep track of the subvolumeid, along with the inode, and use it when searching/comparing inodes.

31
cmdline/elem.c
View file

@ -42,7 +42,7 @@ void content_free(struct snapraid_content* content)
free(content);
}
struct snapraid_filter* filter_alloc_file(int direction, const char* pattern)
struct snapraid_filter* filter_alloc_file(int direction, const char* root, const char* pattern)
{
struct snapraid_filter* filter;
char* i;
@ -53,11 +53,13 @@ struct snapraid_filter* filter_alloc_file(int direction, const char* pattern)
filter = malloc_nofail(sizeof(struct snapraid_filter));
pathimport(filter->pattern, sizeof(filter->pattern), pattern);
pathimport(filter->root, sizeof(filter->root), root);
filter->direction = direction;
/* find first and last slash */
first = 0;
last = 0;
/* reject invalid tokens, like "<empty>", ".", ".." and more dots */
token_is_valid = 0;
token_is_filled = 0;
@ -145,7 +147,7 @@ struct snapraid_filter* filter_alloc_disk(int direction, const char* pattern)
return filter;
}
void filter_free(struct snapraid_filter* filter)
void filter_free(void* filter)
{
free(filter);
}
@ -200,9 +202,16 @@ static int filter_recurse(struct snapraid_filter* filter, struct snapraid_filter
char* name;
unsigned i;
if (filter->root[0] != 0) { /* if it's a local filter */
if (!path_is_root_of(filter->root, const_path)) /* applies it only if it matches the root */
return 0;
/* advance the path to compare to make it local */
const_path += strlen(filter->root);
}
pathcpy(path, sizeof(path), const_path);
/* filter for all the directories */
/* filter all the dir/subdir until we reach the final file/dir */
name = path;
for (i = 0; path[i] != 0; ++i) {
if (path[i] == '/') {
@ -221,7 +230,7 @@ static int filter_recurse(struct snapraid_filter* filter, struct snapraid_filter
}
}
/* filter the final file */
/* filter the final file/dir */
if (filter_apply(filter, reason, path, name, is_dir) != 0)
return filter->direction;
@ -232,7 +241,7 @@ static int filter_element(tommy_list* filterlist, struct snapraid_filter** reaso
{
tommy_node* i;
int direction = 1; /* by default include all */
int default_direction = 1; /* by default include all */
/* for each filter */
for (i = tommy_list_head(filterlist); i != 0; i = i->next) {
@ -256,10 +265,10 @@ static int filter_element(tommy_list* filterlist, struct snapraid_filter** reaso
} else if (ret < 0) {
/* exclude the file */
return -1;
} else {
/* default is opposite of the last filter */
direction = -filter->direction;
if (reason != 0 && direction < 0)
} else if (filter->root[0] == 0) {
/* default is opposite of the last global rule (not counting local rules) */
default_direction = -filter->direction;
if (reason != 0 && default_direction < 0)
*reason = filter;
/* continue with the next one */
}
@ -270,8 +279,8 @@ static int filter_element(tommy_list* filterlist, struct snapraid_filter** reaso
if (is_def_include)
return 0;
/* files are excluded/included depending of the last rule processed */
if (direction < 0)
/* files are excluded/included depending of the last rule processed (not counting local filters) */
if (default_direction < 0)
return -1;
return 0;

13
cmdline/elem.h
View file

@ -60,9 +60,10 @@ struct snapraid_content {
*/
struct snapraid_filter {
char pattern[PATH_MAX]; /**< Filter pattern. */
int is_disk; /**< If the pattern is a disk one. */
int is_path; /**< If the pattern is only for the complete path. */
int is_dir; /**< If the pattern is only for dir. */
char root[PATH_MAX]; /**< If empty, it's a global pattern. If not empty, it's a local pattern that applies only to that dir. */
int is_disk; /**< If the pattern is a disk one, otherwise it's a file pattern */
int is_path; /**< If the pattern is a complete path, otherwise it's just a file name */
int is_dir; /**< If the pattern is only for dir, otherwise it's only for file. */
int direction; /**< If it's an inclusion (=1) or an exclusion (=-1). */
tommy_node node; /**< Next node in the list. */
};
@ -374,7 +375,7 @@ struct snapraid_disk {
/**
* Mutex for protecting the scan process.
*
* It's used during the scan process to protect the stampset to identity copy of files
* It's used during the scan process to protect the stampset to identify copy of files
*/
thread_mutex_t stamp_mutex;
#endif
@ -500,7 +501,7 @@ void content_free(struct snapraid_content* content);
/**
* Allocate a filter pattern for files and directories.
*/
struct snapraid_filter* filter_alloc_file(int is_include, const char* pattern);
struct snapraid_filter* filter_alloc_file(int is_include, const char* root, const char* pattern);
/**
* Allocate a filter pattern for disks.
@ -510,7 +511,7 @@ struct snapraid_filter* filter_alloc_disk(int is_include, const char* pattern);
/**
* Deallocate an exclusion.
*/
void filter_free(struct snapraid_filter* filter);
void filter_free(void* filter);
/**
* Filter type description.

20
cmdline/scan.c
View file

@ -51,6 +51,7 @@ struct snapraid_scan {
tommy_list file_insert_list; /**< Files to insert. */
tommy_list link_insert_list; /**< Links to insert. */
tommy_list dir_insert_list; /**< Dirs to insert. */
tommy_list local_filter_list; /**< Filter list specific for the disk. */
/* nodes for data structures */
tommy_node node;
@ -73,6 +74,7 @@ static struct snapraid_scan* scan_alloc(struct snapraid_state* state, struct sna
tommy_list_init(&scan->file_insert_list);
tommy_list_init(&scan->link_insert_list);
tommy_list_init(&scan->dir_insert_list);
tommy_list_init(&scan->local_filter_list);
scan->is_diff = is_diff;
scan->need_write = 0;
@ -88,7 +90,7 @@ static void scan_free(struct snapraid_scan* scan)
#if HAVE_THREAD
thread_mutex_destroy(&scan->disk->stamp_mutex);
#endif
tommy_list_foreach(&scan->local_filter_list, filter_free);
free(scan);
}
@ -1346,6 +1348,10 @@ static int scan_sub(struct snapraid_scan* scan, int level, int is_diff, char* pa
/* insert in the list */
tommy_list_insert_tail(&list, &entry->node, entry);
/* process ignore files */
if (strcmp(".snapraidignore", dd->d_name) == 0)
state_load_ignore_file(&scan->local_filter_list, path_next, sub_next);
}
if (closedir(d) != 0) {
@ -1434,7 +1440,8 @@ static int scan_sub(struct snapraid_scan* scan, int level, int is_diff, char* pa
}
if (type == 0) { /* REG */
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0) {
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0
&& filter_path(&scan->local_filter_list, &reason, disk->name, sub_next) == 0) {
/* late stat, if not yet called */
if (!st)
@ -1459,7 +1466,8 @@ static int scan_sub(struct snapraid_scan* scan, int level, int is_diff, char* pa
msg_verbose("Excluding file '%s' for rule '%s'\n", path_next, filter_type(reason, tmp, PATH_MAX));
}
} else if (type == 1) { /* LNK */
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0) {
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0
&& filter_path(&scan->local_filter_list, &reason, disk->name, sub_next) == 0) {
int ret;
ret = readlink(path_next, tmp, PATH_MAX);
@ -1488,7 +1496,8 @@ static int scan_sub(struct snapraid_scan* scan, int level, int is_diff, char* pa
msg_verbose("Excluding link '%s' for rule '%s'\n", path_next, filter_type(reason, tmp, PATH_MAX));
}
} else if (type == 2) { /* DIR */
if (filter_subdir(&state->filterlist, &reason, disk->name, sub_next) == 0) {
if (filter_subdir(&state->filterlist, &reason, disk->name, sub_next) == 0
&& filter_subdir(&scan->local_filter_list, &reason, disk->name, sub_next) == 0) {
#ifndef _WIN32
/* late stat, if not yet called */
if (!st)
@ -1517,7 +1526,8 @@ static int scan_sub(struct snapraid_scan* scan, int level, int is_diff, char* pa
msg_verbose("Excluding directory '%s' for rule '%s'\n", path_next, filter_type(reason, tmp, PATH_MAX));
}
} else {
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0) {
if (filter_path(&state->filterlist, &reason, disk->name, sub_next) == 0
&& filter_path(&scan->local_filter_list, &reason, disk->name, sub_next) == 0) {
/* late stat, if not yet called */
if (!st)
st = DSTAT(path_next, dd, &st_buf);

2
cmdline/snapraid.c
View file

@ -996,7 +996,7 @@ int snapraid_main(int argc, char* argv[])
pathimport(conf, sizeof(conf), optarg);
break;
case 'f' : {
struct snapraid_filter* filter = filter_alloc_file(1, optarg);
struct snapraid_filter* filter = filter_alloc_file(1, "", optarg);
if (!filter) {
/* LCOV_EXCL_START */
log_fatal("Invalid filter specification '%s'\n", optarg);

72
cmdline/state.c
View file

@ -1230,7 +1230,7 @@ void state_config(struct snapraid_state* state, const char* path, const char* co
/* LCOV_EXCL_STOP */
}
filter = filter_alloc_file(-1, buffer);
filter = filter_alloc_file(-1, "", buffer);
if (!filter) {
/* LCOV_EXCL_START */
log_fatal("Invalid 'exclude' specification '%s' in '%s' at line %u\n", buffer, path, line);
@ -1257,7 +1257,7 @@ void state_config(struct snapraid_state* state, const char* path, const char* co
/* LCOV_EXCL_STOP */
}
filter = filter_alloc_file(1, buffer);
filter = filter_alloc_file(1, "", buffer);
if (!filter) {
/* LCOV_EXCL_START */
log_fatal("Invalid 'include' specification '%s' in '%s' at line %u\n", buffer, path, line);
@ -5113,3 +5113,71 @@ int state_flush(struct snapraid_state* state, struct snapraid_io* io, struct sna
return 0;
}
void state_load_ignore_file(tommy_list* filter_list, const char* path, const char* sub)
{
STREAM* f;
int line;
f = sopen_read(path, 0);
if (!f) {
/* LCOV_EXCL_START */
log_error("Error opening the ignore file '%s'. %s.\n", path, strerror(errno));
/* LCOV_EXCL_STOP */
}
line = 1;
while (1) {
char buffer[PATH_MAX];
int ret;
int c;
/* skip initial spaces */
sgetspace(f);
/* get the whole line */
ret = sgetline(f, buffer, sizeof(buffer));
if (ret < 0) {
/* LCOV_EXCL_START */
log_error("Too long line in '%s' at line %u\n", path, line);
/* LCOV_EXCL_STOP */
}
if (buffer[0] == 0) {
/* allow empty lines */
} else if (buffer[0] == '#') {
/* ignore comment lines */
} else {
struct snapraid_filter* filter;
filter = filter_alloc_file(-1, sub, buffer);
if (!filter) {
/* LCOV_EXCL_START */
log_error("Invalid ignore specification '%s' in '%s' at line %u\n", buffer, path, line);
/* LCOV_EXCL_STOP */
}
tommy_list_insert_tail(filter_list, &filter->node, filter);
}
/* next line */
c = sgeteol(f);
if (c == EOF) {
break;
}
if (c != '\n') {
/* LCOV_EXCL_START */
log_error("Extra data in '%s' at line %u\n", path, line);
/* LCOV_EXCL_STOP */
}
++line;
}
if (serror(f)) {
/* LCOV_EXCL_START */
log_error("Error reading the ignore file '%s' at line %u\n", path, line);
/* LCOV_EXCL_STOP */
}
sclose(f);
}

5
cmdline/state.h
View file

@ -403,6 +403,11 @@ void state_thermal_cooldown(struct snapraid_state* state);
*/
int state_thermal_begin(struct snapraid_state* state, time_t now);
/**
* Load the ignore file .snapraidignore
*/
void state_load_ignore_file(tommy_list* filter_list, const char* path, const char* sub);
/****************************************************************************/
/* misc */

28
cmdline/support.c
View file

@ -911,8 +911,8 @@ void pathimport(char* dst, size_t size, const char* src)
pathcpy(dst, size, src);
#ifdef _WIN32
/* convert the Windows dir separator '\' to C '/', */
/* and the Windows escaping char '^' to the fnmatch '\' */
/* convert the Windows dir separator '\' to C '/', */
/* and the Windows escaping char '^' to the fnmatch '\' */
while (*dst) {
switch (*dst) {
case '\\' :
@ -1013,6 +1013,30 @@ int pathcmp(const char* a, const char* b)
#endif
}
int path_is_root_of(const char* root, const char* path)
{
while (*root && *path) {
#ifdef _WIN32
/* case insensitive compare in Windows */
char r = tolower((unsigned char)*root);
char p = tolower((unsigned char)*path);
if (r == '\\')
r = '/';
if (p == '\\')
p = '/';
if (r != p)
return 0;
#else
if (*root != *path)
return 0;
#endif
++root;
++path;
}
return *root == 0 && *path != 0;
}
/****************************************************************************/
/* file-system */

9
cmdline/support.h
View file

@ -352,6 +352,15 @@ void pathcut(char* dst);
*/
int pathcmp(const char* a, const char* b);
/**
* Check if the root is matching the start of the specified path.
*
* The root MUST end with a /.
*
* In Windows it's case insensitive and assumes \ equal at /.
*/
int path_is_root_of(const char* root, const char* path);
/****************************************************************************/
/* file-system */

60
doc/snapraid-de.1
View file

@ -1979,6 +1979,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
Unter Unix müssen Sie Globbing\-Zeichen in der Befehlszeile in
Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert.
.SH DATEIEN IGNORIEREN
Zusätzlich zu den globalen Regeln in der Konfigurationsdatei können Sie
\`.snapraidignore\`\-Dateien in jedem Verzeichnis innerhalb des Arrays platzieren,
um dezentrale Ausschlussregeln zu definieren.
.PP
Regeln, die in \`.snapraidignore\` definiert sind, werden nach den Regeln in der
Konfigurationsdatei angewendet. Dies bedeutet, dass sie eine höhere Priorität haben
und verwendet werden können, um Dateien auszuschließen, die zuvor durch die globale
Konfiguration eingeschlossen wurden. Effektiv wird eine Datei ausgeschlossen, wenn
eine lokale Regel zutrifft, unabhängig von den globalen Include\-Einstellungen.
.PP
Die Musterlogik in \`.snapraidignore\` spiegelt die globale Konfiguration wider,
verankert die Muster jedoch an dem Verzeichnis, in dem sich die Datei befindet:
.TP
.B FILE
Wählt jede Datei namens FILE in diesem Verzeichnis oder darunter aus.
Dies folgt denselben Globbing\-Regeln wie das globale Muster.
.TP
.B DIR/
Wählt jedes Verzeichnis namens DIR und alles darin aus, das sich
in diesem Verzeichnis oder darunter befindet.
.TP
.B /PATH/FILE
Wählt die exakt angegebene Datei relativ zum Speicherort
der \`.snapraidignore\`\-Datei aus.
.TP
.B /PATH/DIR/
Wählt das exakt angegebene Verzeichnis und alles darin aus,
relativ zum Speicherort der \`.snapraidignore\`\-Datei.
.PP
Im Gegensatz zur globalen Konfiguration unterstützen \`.snapraidignore\`\-Dateien nur
Ausschlussregeln; Sie können keine \`include\`\-Muster oder Negationen (!) verwenden.
.PP
Wenn Sie beispielsweise eine \`.snapraidignore\` in \`/mnt/disk1/projects/\` haben:
.PP
.RS 4
# Schließt NUR /mnt/disk1/projects/output.bin aus
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Schließt jedes Verzeichnis namens \'build\' innerhalb von projects/ aus
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Schließt jede .tmp\-Datei innerhalb von projects/ oder deren Unterordnern aus
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der
Content\-Datei.

42
doc/snapraid-de.d
View file

@ -1529,6 +1529,48 @@ Pattern
Unter Unix müssen Sie Globbing-Zeichen in der Befehlszeile in
Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert.
Dateien Ignorieren
Zusätzlich zu den globalen Regeln in der Konfigurationsdatei können Sie
`.snapraidignore`-Dateien in jedem Verzeichnis innerhalb des Arrays platzieren,
um dezentrale Ausschlussregeln zu definieren.
Regeln, die in `.snapraidignore` definiert sind, werden nach den Regeln in der
Konfigurationsdatei angewendet. Dies bedeutet, dass sie eine höhere Priorität haben
und verwendet werden können, um Dateien auszuschließen, die zuvor durch die globale
Konfiguration eingeschlossen wurden. Effektiv wird eine Datei ausgeschlossen, wenn
eine lokale Regel zutrifft, unabhängig von den globalen Include-Einstellungen.
Die Musterlogik in `.snapraidignore` spiegelt die globale Konfiguration wider,
verankert die Muster jedoch an dem Verzeichnis, in dem sich die Datei befindet:
=FILE
Wählt jede Datei namens FILE in diesem Verzeichnis oder darunter aus.
Dies folgt denselben Globbing-Regeln wie das globale Muster.
=DIR/
Wählt jedes Verzeichnis namens DIR und alles darin aus, das sich
in diesem Verzeichnis oder darunter befindet.
=/PATH/FILE
Wählt die exakt angegebene Datei relativ zum Speicherort
der `.snapraidignore`-Datei aus.
=/PATH/DIR/
Wählt das exakt angegebene Verzeichnis und alles darin aus,
relativ zum Speicherort der `.snapraidignore`-Datei.
Im Gegensatz zur globalen Konfiguration unterstützen `.snapraidignore`-Dateien nur
Ausschlussregeln; Sie können keine `include`-Muster oder Negationen (!) verwenden.
Wenn Sie beispielsweise eine `.snapraidignore` in `/mnt/disk1/projects/` haben:
:# Schließt NUR /mnt/disk1/projects/output.bin aus
:/output.bin
:# Schließt jedes Verzeichnis namens 'build' innerhalb von projects/ aus
:build/
:# Schließt jede .tmp-Datei innerhalb von projects/ oder deren Unterordnern aus
:*.tmp
Content
SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der
Content-Datei.

57
doc/snapraid-de.txt
View file

@ -1629,8 +1629,53 @@ Unter Unix müssen Sie Globbing-Zeichen in der Befehlszeile in
Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert.
9 CONTENT
=========
9 DATEIEN IGNORIEREN
====================
Zusätzlich zu den globalen Regeln in der Konfigurationsdatei können Sie
`.snapraidignore`-Dateien in jedem Verzeichnis innerhalb des Arrays platzieren,
um dezentrale Ausschlussregeln zu definieren.
Regeln, die in `.snapraidignore` definiert sind, werden nach den Regeln in der
Konfigurationsdatei angewendet. Dies bedeutet, dass sie eine höhere Priorität haben
und verwendet werden können, um Dateien auszuschließen, die zuvor durch die globale
Konfiguration eingeschlossen wurden. Effektiv wird eine Datei ausgeschlossen, wenn
eine lokale Regel zutrifft, unabhängig von den globalen Include-Einstellungen.
Die Musterlogik in `.snapraidignore` spiegelt die globale Konfiguration wider,
verankert die Muster jedoch an dem Verzeichnis, in dem sich die Datei befindet:
FILE
Wählt jede Datei namens FILE in diesem Verzeichnis oder darunter aus.
Dies folgt denselben Globbing-Regeln wie das globale Muster.
DIR/
Wählt jedes Verzeichnis namens DIR und alles darin aus, das sich
in diesem Verzeichnis oder darunter befindet.
/PATH/FILE
Wählt die exakt angegebene Datei relativ zum Speicherort
der `.snapraidignore`-Datei aus.
/PATH/DIR/
Wählt das exakt angegebene Verzeichnis und alles darin aus,
relativ zum Speicherort der `.snapraidignore`-Datei.
Im Gegensatz zur globalen Konfiguration unterstützen `.snapraidignore`-Dateien nur
Ausschlussregeln; Sie können keine `include`-Muster oder Negationen (!) verwenden.
Wenn Sie beispielsweise eine `.snapraidignore` in `/mnt/disk1/projects/` haben:
# Schließt NUR /mnt/disk1/projects/output.bin aus
/output.bin
# Schließt jedes Verzeichnis namens 'build' innerhalb von projects/ aus
build/
# Schließt jede .tmp-Datei innerhalb von projects/ oder deren Unterordnern aus
*.tmp
10 CONTENT
==========
SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der
Content-Datei.
@ -1643,7 +1688,7 @@ Diese Datei wird von den Befehlen `sync` und `scrub` gelesen und
geschrieben und von den Befehlen `fix`, `check` und `status` gelesen.
10 PARITY
11 PARITY
=========
SnapRAID speichert die Paritätsinformationen Ihres Arrays in den
@ -1656,7 +1701,7 @@ Diese Dateien werden von den Befehlen `sync` und `fix` gelesen
und geschrieben und nur von den Befehlen `scrub` und `check` gelesen.
11 ENCODING
12 ENCODING
===========
SnapRAID ignoriert unter Unix jede Kodierung. Es liest und speichert
@ -1674,13 +1719,13 @@ die Konsolenausgabe in eine Datei umleiten, ist die resultierende
Datei immer im UTF-8-Format.
12 COPYRIGHT
13 COPYRIGHT
============
Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid-es.1
View file

@ -1927,6 +1927,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
En Unix, al usar caracteres globbing en la línea de comandos, debe
ponerlos entre comillas para evitar que el shell los expanda.
.SH IGNORAR ARCHIVOS
Además de las reglas globales en el archivo de configuración, puedes
colocar archivos \`.snapraidignore\` en cualquier directorio dentro del array
para definir reglas de exclusión descentralizadas.
.PP
Las reglas definidas en \`.snapraidignore\` se aplican después de las reglas del
archivo de configuración. Esto significa que tienen una prioridad más alta y pueden
usarse para excluir archivos que fueron incluidos previamente por la configuración
global. Efectivamente, si una regla local coincide, el archivo se excluye
independientemente de los ajustes de inclusión globales.
.PP
La lógica de patrones en \`.snapraidignore\` refleja la configuración global
pero ancla los patrones al directorio donde se encuentra el archivo:
.TP
.B FILE
Selecciona cualquier archivo llamado FILE en este directorio o por debajo.
Esto sigue las mismas reglas de globbing que el patrón global.
.TP
.B DIR/
Selecciona cualquier directorio llamado DIR y todo su contenido,
ubicado en este directorio o por debajo.
.TP
.B /PATH/FILE
Selecciona el archivo exacto especificado relativo a la ubicación
del archivo \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Selecciona el directorio exacto especificado y todo su contenido,
relativo a la ubicación del archivo \`.snapraidignore\`.
.PP
A diferencia de la configuración global, los archivos \`.snapraidignore\` solo admiten
reglas de exclusión; no se pueden usar patrones \`include\` o negación (!).
.PP
Por ejemplo, si tienes un \`.snapraidignore\` en \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Excluye SOLO /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Excluye cualquier directorio llamado \'build\' dentro de projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Excluye cualquier archivo .tmp dentro de projects/ o sus subcarpetas
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID almacena la lista y las sumas de comprobación de sus
archivos en el archivo de contenido.

42
doc/snapraid-es.d
View file

@ -1488,6 +1488,48 @@ Pattern
En Unix, al usar caracteres globbing en la línea de comandos, debe
ponerlos entre comillas para evitar que el shell los expanda.
Ignorar Archivos
Además de las reglas globales en el archivo de configuración, puedes
colocar archivos `.snapraidignore` en cualquier directorio dentro del array
para definir reglas de exclusión descentralizadas.
Las reglas definidas en `.snapraidignore` se aplican después de las reglas del
archivo de configuración. Esto significa que tienen una prioridad más alta y pueden
usarse para excluir archivos que fueron incluidos previamente por la configuración
global. Efectivamente, si una regla local coincide, el archivo se excluye
independientemente de los ajustes de inclusión globales.
La lógica de patrones en `.snapraidignore` refleja la configuración global
pero ancla los patrones al directorio donde se encuentra el archivo:
=FILE
Selecciona cualquier archivo llamado FILE en este directorio o por debajo.
Esto sigue las mismas reglas de globbing que el patrón global.
=DIR/
Selecciona cualquier directorio llamado DIR y todo su contenido,
ubicado en este directorio o por debajo.
=/PATH/FILE
Selecciona el archivo exacto especificado relativo a la ubicación
del archivo `.snapraidignore`.
=/PATH/DIR/
Selecciona el directorio exacto especificado y todo su contenido,
relativo a la ubicación del archivo `.snapraidignore`.
A diferencia de la configuración global, los archivos `.snapraidignore` solo admiten
reglas de exclusión; no se pueden usar patrones `include` o negación (!).
Por ejemplo, si tienes un `.snapraidignore` en `/mnt/disk1/projects/`:
:# Excluye SOLO /mnt/disk1/projects/output.bin
:/output.bin
:# Excluye cualquier directorio llamado 'build' dentro de projects/
:build/
:# Excluye cualquier archivo .tmp dentro de projects/ o sus subcarpetas
:*.tmp
Content
SnapRAID almacena la lista y las sumas de comprobación de sus
archivos en el archivo de contenido.

57
doc/snapraid-es.txt
View file

@ -1588,8 +1588,53 @@ En Unix, al usar caracteres globbing en la línea de comandos, debe
ponerlos entre comillas para evitar que el shell los expanda.
9 CONTENT
=========
9 IGNORAR ARCHIVOS
==================
Además de las reglas globales en el archivo de configuración, puedes
colocar archivos `.snapraidignore` en cualquier directorio dentro del array
para definir reglas de exclusión descentralizadas.
Las reglas definidas en `.snapraidignore` se aplican después de las reglas del
archivo de configuración. Esto significa que tienen una prioridad más alta y pueden
usarse para excluir archivos que fueron incluidos previamente por la configuración
global. Efectivamente, si una regla local coincide, el archivo se excluye
independientemente de los ajustes de inclusión globales.
La lógica de patrones en `.snapraidignore` refleja la configuración global
pero ancla los patrones al directorio donde se encuentra el archivo:
FILE
Selecciona cualquier archivo llamado FILE en este directorio o por debajo.
Esto sigue las mismas reglas de globbing que el patrón global.
DIR/
Selecciona cualquier directorio llamado DIR y todo su contenido,
ubicado en este directorio o por debajo.
/PATH/FILE
Selecciona el archivo exacto especificado relativo a la ubicación
del archivo `.snapraidignore`.
/PATH/DIR/
Selecciona el directorio exacto especificado y todo su contenido,
relativo a la ubicación del archivo `.snapraidignore`.
A diferencia de la configuración global, los archivos `.snapraidignore` solo admiten
reglas de exclusión; no se pueden usar patrones `include` o negación (!).
Por ejemplo, si tienes un `.snapraidignore` en `/mnt/disk1/projects/`:
# Excluye SOLO /mnt/disk1/projects/output.bin
/output.bin
# Excluye cualquier directorio llamado 'build' dentro de projects/
build/
# Excluye cualquier archivo .tmp dentro de projects/ o sus subcarpetas
*.tmp
10 CONTENT
==========
SnapRAID almacena la lista y las sumas de comprobación de sus
archivos en el archivo de contenido.
@ -1602,7 +1647,7 @@ Este archivo es leído y escrito por los comandos `sync` y `scrub`
y leído por los comandos `fix`, `check` y `status`.
10 PARITY
11 PARITY
=========
SnapRAID almacena la información de paridad de su array en los
@ -1615,7 +1660,7 @@ Estos archivos son leídos y escritos por los comandos `sync` y `fix`
y solo leídos por los comandos `scrub` y `check`.
11 ENCODING
12 ENCODING
===========
SnapRAID en Unix ignora cualquier codificación. Lee y almacena los
@ -1633,13 +1678,13 @@ archivo impresos; si redirige la salida de la consola a un archivo,
el archivo resultante siempre está en formato UTF-8.
12 COPYRIGHT
13 COPYRIGHT
============
Este archivo es Copyright (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid-fr.1
View file

@ -1973,6 +1973,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
Sous Unix, lorsque vous utilisez des caractères de globbing sur la
ligne de commande, vous devez les mettre entre guillemets pour empêcher
le shell de les développer.
.SH IGNORER DES FICHIERS (IGNORE FILES)
En plus des règles globales du fichier de configuration, vous pouvez
placer des fichiers \`.snapraidignore\` dans n\'importe quel répertoire de la grappe
pour définir des règles d\'exclusion décentralisées.
.PP
Les règles définies dans \`.snapraidignore\` sont appliquées après les règles du
fichier de configuration. Cela signifie qu\'elles ont une priorité plus élevée et peuvent
être utilisées pour exclure des fichiers qui étaient précédemment inclus par la
configuration globale. En pratique, si une règle locale correspond, le fichier est
exclu quels que soient les paramètres d\'inclusion globaux.
.PP
La logique des motifs dans \`.snapraidignore\` reflète la configuration globale
mais ancre les motifs au répertoire où se trouve le fichier :
.TP
.B FILE
Sélectionne n\'importe quel fichier nommé FILE dans ce répertoire ou en dessous.
Cela suit les mêmes règles de globbing que le motif global.
.TP
.B DIR/
Sélectionne n\'importe quel répertoire nommé DIR et tout son contenu,
résidant dans ce répertoire ou en dessous.
.TP
.B /PATH/FILE
Sélectionne le fichier exact spécifié par rapport à l\'emplacement
du fichier \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Sélectionne le répertoire exact spécifié et tout son contenu,
par rapport à l\'emplacement du fichier \`.snapraidignore\`.
.PP
Contrairement à la configuration globale, les fichiers \`.snapraidignore\` ne prennent
en charge que les règles d\'exclusion ; vous ne pouvez pas utiliser de motifs \`include\` ou de négation (!).
.PP
Par exemple, si vous avez un \`.snapraidignore\` dans \`/mnt/disk1/projects/\` :
.PP
.RS 4
# Exclut UNIQUEMENT /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Exclut tout répertoire nommé \'build\' dans projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Exclut tout fichier .tmp dans projects/ ou ses sous\-dossiers
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENU (CONTENT)
SnapRAID stocke la liste et les sommes de contrôle de vos fichiers
dans le fichier de contenu.

42
doc/snapraid-fr.d
View file

@ -1531,6 +1531,48 @@ Motif (Pattern)
ligne de commande, vous devez les mettre entre guillemets pour empêcher
le shell de les développer.
Ignorer des Fichiers (Ignore Files)
En plus des règles globales du fichier de configuration, vous pouvez
placer des fichiers `.snapraidignore` dans n'importe quel répertoire de la grappe
pour définir des règles d'exclusion décentralisées.
Les règles définies dans `.snapraidignore` sont appliquées après les règles du
fichier de configuration. Cela signifie qu'elles ont une priorité plus élevée et peuvent
être utilisées pour exclure des fichiers qui étaient précédemment inclus par la
configuration globale. En pratique, si une règle locale correspond, le fichier est
exclu quels que soient les paramètres d'inclusion globaux.
La logique des motifs dans `.snapraidignore` reflète la configuration globale
mais ancre les motifs au répertoire où se trouve le fichier :
=FILE
Sélectionne n'importe quel fichier nommé FILE dans ce répertoire ou en dessous.
Cela suit les mêmes règles de globbing que le motif global.
=DIR/
Sélectionne n'importe quel répertoire nommé DIR et tout son contenu,
résidant dans ce répertoire ou en dessous.
=/PATH/FILE
Sélectionne le fichier exact spécifié par rapport à l'emplacement
du fichier `.snapraidignore`.
=/PATH/DIR/
Sélectionne le répertoire exact spécifié et tout son contenu,
par rapport à l'emplacement du fichier `.snapraidignore`.
Contrairement à la configuration globale, les fichiers `.snapraidignore` ne prennent
en charge que les règles d'exclusion ; vous ne pouvez pas utiliser de motifs `include` ou de négation (!).
Par exemple, si vous avez un `.snapraidignore` dans `/mnt/disk1/projects/` :
:# Exclut UNIQUEMENT /mnt/disk1/projects/output.bin
:/output.bin
:# Exclut tout répertoire nommé 'build' dans projects/
:build/
:# Exclut tout fichier .tmp dans projects/ ou ses sous-dossiers
:*.tmp
Contenu (Content)
SnapRAID stocke la liste et les sommes de contrôle de vos fichiers
dans le fichier de contenu.

57
doc/snapraid-fr.txt
View file

@ -1631,8 +1631,53 @@ ligne de commande, vous devez les mettre entre guillemets pour empêcher
le shell de les développer.
9 CONTENU (CONTENT)
===================
9 IGNORER DES FICHIERS (IGNORE FILES)
=====================================
En plus des règles globales du fichier de configuration, vous pouvez
placer des fichiers `.snapraidignore` dans n'importe quel répertoire de la grappe
pour définir des règles d'exclusion décentralisées.
Les règles définies dans `.snapraidignore` sont appliquées après les règles du
fichier de configuration. Cela signifie qu'elles ont une priorité plus élevée et peuvent
être utilisées pour exclure des fichiers qui étaient précédemment inclus par la
configuration globale. En pratique, si une règle locale correspond, le fichier est
exclu quels que soient les paramètres d'inclusion globaux.
La logique des motifs dans `.snapraidignore` reflète la configuration globale
mais ancre les motifs au répertoire où se trouve le fichier :
FILE
Sélectionne n'importe quel fichier nommé FILE dans ce répertoire ou en dessous.
Cela suit les mêmes règles de globbing que le motif global.
DIR/
Sélectionne n'importe quel répertoire nommé DIR et tout son contenu,
résidant dans ce répertoire ou en dessous.
/PATH/FILE
Sélectionne le fichier exact spécifié par rapport à l'emplacement
du fichier `.snapraidignore`.
/PATH/DIR/
Sélectionne le répertoire exact spécifié et tout son contenu,
par rapport à l'emplacement du fichier `.snapraidignore`.
Contrairement à la configuration globale, les fichiers `.snapraidignore` ne prennent
en charge que les règles d'exclusion ; vous ne pouvez pas utiliser de motifs `include` ou de négation (!).
Par exemple, si vous avez un `.snapraidignore` dans `/mnt/disk1/projects/` :
# Exclut UNIQUEMENT /mnt/disk1/projects/output.bin
/output.bin
# Exclut tout répertoire nommé 'build' dans projects/
build/
# Exclut tout fichier .tmp dans projects/ ou ses sous-dossiers
*.tmp
10 CONTENU (CONTENT)
====================
SnapRAID stocke la liste et les sommes de contrôle de vos fichiers
dans le fichier de contenu.
@ -1645,7 +1690,7 @@ Ce fichier est lu et écrit par les commandes `sync` et `scrub` et
lu par les commandes `fix`, `check` et `status`.
10 PARITé (PARITY)
11 PARITé (PARITY)
==================
SnapRAID stocke les informations de parité de votre baie dans
@ -1658,7 +1703,7 @@ Ces fichiers sont lus et écrits par les commandes `sync` et `fix` et
lus uniquement par les commandes `scrub` et `check`.
11 ENCODAGE
12 ENCODAGE
===========
SnapRAID sous Unix ignore tout encodage. Il lit et stocke les
@ -1677,13 +1722,13 @@ redirigez la sortie de la console vers un fichier, le fichier
résultant est toujours au format UTF-8.
12 DROITS D'AUTEUR (COPYRIGHT)
13 DROITS D'AUTEUR (COPYRIGHT)
==============================
Ce fichier est Copyright (C) 2025 Andrea Mazzoleni
13 VOIR AUSSI (SEE ALSO)
14 VOIR AUSSI (SEE ALSO)
========================
snapraid_log(1), rsync(1)

60
doc/snapraid-it.1
View file

@ -1957,6 +1957,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
In Unix, quando si utilizzano caratteri di globbing sulla riga di
comando, è necessario citarli per impedire alla shell di espanderli.
.SH IGNORE FILE
In aggiunta alle regole globali nel file di configurazione, è possibile
inserire file \`.snapraidignore\` in qualsiasi directory all\'interno dell\'array
per definire regole di esclusione decentralizzate.
.PP
Le regole definite in \`.snapraidignore\` vengono applicate dopo le regole nel
file di configurazione. Ciò significa che hanno una priorità più alta e possono
essere utilizzate per escludere file che erano stati precedentemente inclusi dalla
configurazione globale. In pratica, se una regola locale corrisponde, il file viene
escluso indipendentemente dalle impostazioni di inclusione globali.
.PP
La logica dei pattern in \`.snapraidignore\` rispecchia la configurazione globale
ma ancora i pattern alla directory in cui si trova il file:
.TP
.B FILE
Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa.
Segue le stesse regole di globbing del pattern globale.
.TP
.B DIR/
Seleziona qualsiasi directory chiamata DIR e tutto ciò che contiene,
che risieda in questa directory o sotto di essa.
.TP
.B /PATH/FILE
Seleziona l\'esatto file specificato relativo alla posizione
del file \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Seleziona l\'esatta directory specificata e tutto ciò che contiene,
relativa alla posizione del file \`.snapraidignore\`.
.PP
A differenza della configurazione globale, i file \`.snapraidignore\` supportano
solo regole di esclusione; non è possibile utilizzare pattern \`include\` o negazioni (!).
.PP
Ad esempio, se hai un \`.snapraidignore\` in \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Esclude SOLO /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Esclude qualsiasi directory chiamata \'build\' all\'interno di projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Esclude qualsiasi file .tmp all\'interno di projects/ o delle sue sottocartelle
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID memorizza l\'elenco e i checksum dei file nel file di contenuto.
.PP

42
doc/snapraid-it.d
View file

@ -1504,6 +1504,48 @@ Pattern
In Unix, quando si utilizzano caratteri di globbing sulla riga di
comando, è necessario citarli per impedire alla shell di espanderli.
Ignore File
In aggiunta alle regole globali nel file di configurazione, è possibile
inserire file `.snapraidignore` in qualsiasi directory all'interno dell'array
per definire regole di esclusione decentralizzate.
Le regole definite in `.snapraidignore` vengono applicate dopo le regole nel
file di configurazione. Ciò significa che hanno una priorità più alta e possono
essere utilizzate per escludere file che erano stati precedentemente inclusi dalla
configurazione globale. In pratica, se una regola locale corrisponde, il file viene
escluso indipendentemente dalle impostazioni di inclusione globali.
La logica dei pattern in `.snapraidignore` rispecchia la configurazione globale
ma ancora i pattern alla directory in cui si trova il file:
=FILE
Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa.
Segue le stesse regole di globbing del pattern globale.
=DIR/
Seleziona qualsiasi directory chiamata DIR e tutto ciò che contiene,
che risieda in questa directory o sotto di essa.
=/PATH/FILE
Seleziona l'esatto file specificato relativo alla posizione
del file `.snapraidignore`.
=/PATH/DIR/
Seleziona l'esatta directory specificata e tutto ciò che contiene,
relativa alla posizione del file `.snapraidignore`.
A differenza della configurazione globale, i file `.snapraidignore` supportano
solo regole di esclusione; non è possibile utilizzare pattern `include` o negazioni (!).
Ad esempio, se hai un `.snapraidignore` in `/mnt/disk1/projects/`:
:# Esclude SOLO /mnt/disk1/projects/output.bin
:/output.bin
:# Esclude qualsiasi directory chiamata 'build' all'interno di projects/
:build/
:# Esclude qualsiasi file .tmp all'interno di projects/ o delle sue sottocartelle
:*.tmp
Content
SnapRAID memorizza l'elenco e i checksum dei file nel file di contenuto.

57
doc/snapraid-it.txt
View file

@ -1604,8 +1604,53 @@ In Unix, quando si utilizzano caratteri di globbing sulla riga di
comando, è necessario citarli per impedire alla shell di espanderli.
9 CONTENT
=========
9 IGNORE FILE
=============
In aggiunta alle regole globali nel file di configurazione, è possibile
inserire file `.snapraidignore` in qualsiasi directory all'interno dell'array
per definire regole di esclusione decentralizzate.
Le regole definite in `.snapraidignore` vengono applicate dopo le regole nel
file di configurazione. Ciò significa che hanno una priorità più alta e possono
essere utilizzate per escludere file che erano stati precedentemente inclusi dalla
configurazione globale. In pratica, se una regola locale corrisponde, il file viene
escluso indipendentemente dalle impostazioni di inclusione globali.
La logica dei pattern in `.snapraidignore` rispecchia la configurazione globale
ma ancora i pattern alla directory in cui si trova il file:
FILE
Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa.
Segue le stesse regole di globbing del pattern globale.
DIR/
Seleziona qualsiasi directory chiamata DIR e tutto ciò che contiene,
che risieda in questa directory o sotto di essa.
/PATH/FILE
Seleziona l'esatto file specificato relativo alla posizione
del file `.snapraidignore`.
/PATH/DIR/
Seleziona l'esatta directory specificata e tutto ciò che contiene,
relativa alla posizione del file `.snapraidignore`.
A differenza della configurazione globale, i file `.snapraidignore` supportano
solo regole di esclusione; non è possibile utilizzare pattern `include` o negazioni (!).
Ad esempio, se hai un `.snapraidignore` in `/mnt/disk1/projects/`:
# Esclude SOLO /mnt/disk1/projects/output.bin
/output.bin
# Esclude qualsiasi directory chiamata 'build' all'interno di projects/
build/
# Esclude qualsiasi file .tmp all'interno di projects/ o delle sue sottocartelle
*.tmp
10 CONTENT
==========
SnapRAID memorizza l'elenco e i checksum dei file nel file di contenuto.
@ -1616,7 +1661,7 @@ Questo file viene letto e scritto dai comandi `sync` e `scrub` e
letto dai comandi `fix`, `check` e `status`.
10 PARITY
11 PARITY
=========
SnapRAID memorizza le informazioni di parità dell'array nei file di
@ -1629,7 +1674,7 @@ Questi file vengono letti e scritti dai comandi `sync` e `fix` e
solo letti dai comandi `scrub` e `check`.
11 CODIFICA
12 CODIFICA
===========
SnapRAID in Unix ignora qualsiasi codifica. Legge e memorizza i
@ -1647,13 +1692,13 @@ reindirizza l'output della console a un file, il file risultante è
sempre in formato UTF-8.
12 COPYRIGHT
13 COPYRIGHT
============
Questo file è Copyright (C) 2025 Andrea Mazzoleni
13 VEDI ANCHE
14 VEDI ANCHE
=============
snapraid_log(1), rsync(1)

59
doc/snapraid-ja.1
View file

@ -1748,6 +1748,65 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
Unixでは、コマンドラインでグロブ文字を使用する場合、シェルがそれらを展開するのを
防ぐために引用符で囲む必要があります。
.SH IGNORE FILE
設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに
.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。
.PP
\`.snapraidignore\` で定義されたルールは、設定ファイルのルールの後に
適用されます。これは、それらがより高い優先度を持ち、グローバル設定で
以前に含まれていたファイルを除外するために使用できることを意味します。
事実上、ローカルルールが一致する場合、グローバルな包含設定に関係なく、
ファイルは除外されます。
.PP
\`.snapraidignore\` のパターンロジックはグローバル設定を反映していますが、
パターンはそのファイルが配置されているディレクトリに固定されます：
.TP
.B FILE
このディレクトリまたはその下にある、FILE という名前の任意のファイルを
選択します。これは、グローバルパターンと同じグロッビングルールに従います。
.TP
.B DIR/
このディレクトリまたはその下にある、DIR という名前の任意のディレクトリと
その中のすべてを選択します。
.TP
.B /PATH/FILE
\`.snapraidignore\` ファイルの場所を基準にして、指定された正確な
ファイルを選択します。
.TP
.B /PATH/DIR/
\`.snapraidignore\` ファイルの場所を基準にして、指定された正確な
ディレクトリとその中のすべてを選択します。
.PP
グローバル設定とは異なり、\`.snapraidignore\` ファイルは除外ルールのみを
サポートします。\`include\` パターンや否定 (!) は使用できません。
.PP
たとえば、\`/mnt/disk1/projects/\` に \`.snapraidignore\` がある場合：
.PP
.RS 4
# /mnt/disk1/projects/output.bin のみを除外
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# projects/ 内の \'build\' という名前のディレクトリをすべて除外
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# projects/ またはそのサブフォルダ内のすべての .tmp ファイルを除外
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファイルに保存します。
.PP

41
doc/snapraid-ja.d
View file

@ -1309,6 +1309,47 @@ Pattern
Unixでは、コマンドラインでグロブ文字を使用する場合、シェルがそれらを展開するのを
防ぐために引用符で囲む必要があります。
Ignore File
設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに
.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。
`.snapraidignore` で定義されたルールは、設定ファイルのルールの後に
適用されます。これは、それらがより高い優先度を持ち、グローバル設定で
以前に含まれていたファイルを除外するために使用できることを意味します。
事実上、ローカルルールが一致する場合、グローバルな包含設定に関係なく、
ファイルは除外されます。
`.snapraidignore` のパターンロジックはグローバル設定を反映していますが、
パターンはそのファイルが配置されているディレクトリに固定されます：
=FILE
このディレクトリまたはその下にある、FILE という名前の任意のファイルを
選択します。これは、グローバルパターンと同じグロッビングルールに従います。
=DIR/
このディレクトリまたはその下にある、DIR という名前の任意のディレクトリと
その中のすべてを選択します。
=/PATH/FILE
`.snapraidignore` ファイルの場所を基準にして、指定された正確な
ファイルを選択します。
=/PATH/DIR/
`.snapraidignore` ファイルの場所を基準にして、指定された正確な
ディレクトリとその中のすべてを選択します。
グローバル設定とは異なり、`.snapraidignore` ファイルは除外ルールのみを
サポートします。`include` パターンや否定 (!) は使用できません。
たとえば、`/mnt/disk1/projects/` に `.snapraidignore` がある場合：
:# /mnt/disk1/projects/output.bin のみを除外
:/output.bin
:# projects/ 内の 'build' という名前のディレクトリをすべて除外
:build/
:# projects/ またはそのサブフォルダ内のすべての .tmp ファイルを除外
:*.tmp
Content
SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファイルに保存します。

56
doc/snapraid-ja.txt
View file

@ -1409,8 +1409,52 @@ Unixでは、コマンドラインでグロブ文字を使用する場合、シ
防ぐために引用符で囲む必要があります。
9 CONTENT
=========
9 IGNORE FILE
=============
設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに
.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。
`.snapraidignore` で定義されたルールは、設定ファイルのルールの後に
適用されます。これは、それらがより高い優先度を持ち、グローバル設定で
以前に含まれていたファイルを除外するために使用できることを意味します。
事実上、ローカルルールが一致する場合、グローバルな包含設定に関係なく、
ファイルは除外されます。
`.snapraidignore` のパターンロジックはグローバル設定を反映していますが、
パターンはそのファイルが配置されているディレクトリに固定されます：
FILE
このディレクトリまたはその下にある、FILE という名前の任意のファイルを
選択します。これは、グローバルパターンと同じグロッビングルールに従います。
DIR/
このディレクトリまたはその下にある、DIR という名前の任意のディレクトリと
その中のすべてを選択します。
/PATH/FILE
`.snapraidignore` ファイルの場所を基準にして、指定された正確な
ファイルを選択します。
/PATH/DIR/
`.snapraidignore` ファイルの場所を基準にして、指定された正確な
ディレクトリとその中のすべてを選択します。
グローバル設定とは異なり、`.snapraidignore` ファイルは除外ルールのみを
サポートします。`include` パターンや否定 (!) は使用できません。
たとえば、`/mnt/disk1/projects/` に `.snapraidignore` がある場合：
# /mnt/disk1/projects/output.bin のみを除外
/output.bin
# projects/ 内の 'build' という名前のディレクトリをすべて除外
build/
# projects/ またはそのサブフォルダ内のすべての .tmp ファイルを除外
*.tmp
10 CONTENT
==========
SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファイルに保存します。
@ -1421,7 +1465,7 @@ SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファ
`fix`、`check`、および `status` コマンドによって読み取られます。
10 PARITY
11 PARITY
=========
SnapRAIDは、アレイのパリティ情報をパリティファイルに保存します。
@ -1433,7 +1477,7 @@ SnapRAIDは、アレイのパリティ情報をパリティファイルに保存
`scrub` および `check` コマンドによって**読み取られるだけ**です。
11 ENCODING
12 ENCODING
===========
UnixのSnapRAIDは、エンコーディングを無視します。ファイルシステムで使用されている
@ -1448,13 +1492,13 @@ Windowsでは、ファイルシステムから読み取られたすべての名
結果のファイルは常にUTF-8形式になります。
12 COPYRIGHT
13 COPYRIGHT
============
This file is Copyright (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

58
doc/snapraid-ko.1
View file

@ -1801,6 +1801,64 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
Unix에서는 명령줄에서 글로빙 문자를 사용할 때 셸이 확장하는 것을
방지하기 위해 따옴표로 묶어야 합니다.
.SH IGNORE FILE
설정 파일의 전역 규칙 외에도, 배열 내의 모든 디렉토리에 \`.snapraidignore\`
파일을 배치하여 분산된 제외 규칙을 정의할 수 있습니다.
.PP
\`.snapraidignore\`에 정의된 규칙은 설정 파일의 규칙 다음에 적용됩니다.
이는 해당 규칙들이 더 높은 우선순위를 가지며, 전역 설정에 의해 이전에
포함되었던 파일들을 제외하는 데 사용될 수 있음을 의미합니다. 사실상
로컬 규칙이 일치하면, 전역 포함 설정과 관계없이 해당 파일은 제외됩니다.
.PP
\`.snapraidignore\`의 패턴 로직은 전역 설정을 따르지만, 패턴은 해당 파일이
위치한 디렉토리를 기준으로 고정됩니다:
.TP
.B FILE
이 디렉토리 또는 그 하위에서 FILE이라는 이름의 모든 파일을 선택합니다.
이는 전역 패턴과 동일한 글로빙(globbing) 규칙을 따릅니다.
.TP
.B DIR/
이 디렉토리 또는 그 하위에서 DIR이라는 이름의 모든 디렉토리와
그 안의 모든 항목을 선택합니다.
.TP
.B /PATH/FILE
\`.snapraidignore\` 파일의 위치를 기준으로 지정된 정확한 파일을
선택합니다.
.TP
.B /PATH/DIR/
\`.snapraidignore\` 파일의 위치를 기준으로 지정된 정확한 디렉토리와
그 안의 모든 항목을 선택합니다.
.PP
전역 설정과 달리, \`.snapraidignore\` 파일은 제외 규칙만 지원합니다.
\`include\` 패턴이나 부정(!)은 사용할 수 없습니다.
.PP
예를 들어, \`/mnt/disk1/projects/\`에 \`.snapraidignore\`가 있는 경우:
.PP
.RS 4
# /mnt/disk1/projects/output.bin만 제외
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# projects/ 내부의 \'build\'라는 이름의 모든 디렉토리 제외
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# projects/ 또는 그 하위 폴더의 모든 .tmp 파일 제외
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.
.PP

40
doc/snapraid-ko.d
View file

@ -1362,6 +1362,46 @@ Pattern
Unix에서는 명령줄에서 글로빙 문자를 사용할 때 셸이 확장하는 것을
방지하기 위해 따옴표로 묶어야 합니다.
Ignore File
설정 파일의 전역 규칙 외에도, 배열 내의 모든 디렉토리에 `.snapraidignore`
파일을 배치하여 분산된 제외 규칙을 정의할 수 있습니다.
`.snapraidignore`에 정의된 규칙은 설정 파일의 규칙 다음에 적용됩니다.
이는 해당 규칙들이 더 높은 우선순위를 가지며, 전역 설정에 의해 이전에
포함되었던 파일들을 제외하는 데 사용될 수 있음을 의미합니다. 사실상
로컬 규칙이 일치하면, 전역 포함 설정과 관계없이 해당 파일은 제외됩니다.
`.snapraidignore`의 패턴 로직은 전역 설정을 따르지만, 패턴은 해당 파일이
위치한 디렉토리를 기준으로 고정됩니다:
=FILE
이 디렉토리 또는 그 하위에서 FILE이라는 이름의 모든 파일을 선택합니다.
이는 전역 패턴과 동일한 글로빙(globbing) 규칙을 따릅니다.
=DIR/
이 디렉토리 또는 그 하위에서 DIR이라는 이름의 모든 디렉토리와
그 안의 모든 항목을 선택합니다.
=/PATH/FILE
`.snapraidignore` 파일의 위치를 기준으로 지정된 정확한 파일을
선택합니다.
=/PATH/DIR/
`.snapraidignore` 파일의 위치를 기준으로 지정된 정확한 디렉토리와
그 안의 모든 항목을 선택합니다.
전역 설정과 달리, `.snapraidignore` 파일은 제외 규칙만 지원합니다.
`include` 패턴이나 부정(!)은 사용할 수 없습니다.
예를 들어, `/mnt/disk1/projects/`에 `.snapraidignore`가 있는 경우:
:# /mnt/disk1/projects/output.bin만 제외
:/output.bin
:# projects/ 내부의 'build'라는 이름의 모든 디렉토리 제외
:build/
:# projects/ 또는 그 하위 폴더의 모든 .tmp 파일 제외
:*.tmp
Content
SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.

55
doc/snapraid-ko.txt
View file

@ -1462,8 +1462,51 @@ Unix에서는 명령줄에서 글로빙 문자를 사용할 때 셸이 확장하
방지하기 위해 따옴표로 묶어야 합니다.
9 CONTENT
=========
9 IGNORE FILE
=============
설정 파일의 전역 규칙 외에도, 배열 내의 모든 디렉토리에 `.snapraidignore`
파일을 배치하여 분산된 제외 규칙을 정의할 수 있습니다.
`.snapraidignore`에 정의된 규칙은 설정 파일의 규칙 다음에 적용됩니다.
이는 해당 규칙들이 더 높은 우선순위를 가지며, 전역 설정에 의해 이전에
포함되었던 파일들을 제외하는 데 사용될 수 있음을 의미합니다. 사실상
로컬 규칙이 일치하면, 전역 포함 설정과 관계없이 해당 파일은 제외됩니다.
`.snapraidignore`의 패턴 로직은 전역 설정을 따르지만, 패턴은 해당 파일이
위치한 디렉토리를 기준으로 고정됩니다:
FILE
이 디렉토리 또는 그 하위에서 FILE이라는 이름의 모든 파일을 선택합니다.
이는 전역 패턴과 동일한 글로빙(globbing) 규칙을 따릅니다.
DIR/
이 디렉토리 또는 그 하위에서 DIR이라는 이름의 모든 디렉토리와
그 안의 모든 항목을 선택합니다.
/PATH/FILE
`.snapraidignore` 파일의 위치를 기준으로 지정된 정확한 파일을
선택합니다.
/PATH/DIR/
`.snapraidignore` 파일의 위치를 기준으로 지정된 정확한 디렉토리와
그 안의 모든 항목을 선택합니다.
전역 설정과 달리, `.snapraidignore` 파일은 제외 규칙만 지원합니다.
`include` 패턴이나 부정(!)은 사용할 수 없습니다.
예를 들어, `/mnt/disk1/projects/`에 `.snapraidignore`가 있는 경우:
# /mnt/disk1/projects/output.bin만 제외
/output.bin
# projects/ 내부의 'build'라는 이름의 모든 디렉토리 제외
build/
# projects/ 또는 그 하위 폴더의 모든 .tmp 파일 제외
*.tmp
10 CONTENT
==========
SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.
@ -1474,7 +1517,7 @@ SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.
`fix`, `check`, 및 `status` 명령에 의해 읽혀집니다.
10 PARITY
11 PARITY
=========
SnapRAID는 패리티 파일에 어레이의 패리티 정보를 저장합니다.
@ -1486,7 +1529,7 @@ SnapRAID는 패리티 파일에 어레이의 패리티 정보를 저장합니다
`scrub` 및 `check` 명령에 의해서만 읽혀집니다.
11 ENCODING
12 ENCODING
===========
Unix의 SnapRAID는 인코딩을 무시합니다. 파일 시스템에서 사용되는
@ -1502,13 +1545,13 @@ Windows 콘솔을 UTF-8 모드로 설정하고 콘솔 글꼴로 `Lucida Console`
리디렉션하는 경우 결과 파일은 항상 UTF-8 형식입니다.
12 COPYRIGHT
13 COPYRIGHT
============
This file is Copyright (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid-pl.1
View file

@ -1843,6 +1843,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
W systemie Unix, używając znaków globbing w wierszu poleceń, musisz
je cytować, aby zapobiec ich rozszerzeniu przez powłokę.
.SH IGNORE FILE
Oprócz reguł globalnych w pliku konfiguracyjnym, możesz umieścić pliki
\`.snapraidignore\` w dowolnym katalogu w macierzy, aby zdefiniować
zdecentralizowane reguły wykluczania.
.PP
Reguły zdefiniowane w \`.snapraidignore\` są stosowane po regułach w pliku
konfiguracyjnym. Oznacza to, że mają one wyższy priorytet i mogą być używane
do wykluczania plików, które zostały wcześniej uwzględnione przez konfigurację
globalną. Skutecznie, jeśli reguła lokalna pasuje, plik jest wykluczany bez
względu na globalne ustawienia uwzględniania.
.PP
Logika wzorców w \`.snapraidignore\` odzwierciedla konfigurację globalną, ale
zakotwicza wzorce w katalogu, w którym znajduje się plik:
.TP
.B FILE
Wybiera dowolny plik o nazwie FILE w tym katalogu lub poniżej.
Podlega to tym samym zasadom dopasowywania (globbing) co wzorzec globalny.
.TP
.B DIR/
Wybiera dowolny katalog o nazwie DIR i wszystko w jego wnętrzu,
znajdujący się w tym katalogu lub poniżej.
.TP
.B /PATH/FILE
Wybiera dokładnie określony plik względem lokalizacji
pliku \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Wybiera dokładnie określony katalog i wszystko w jego wnętrzu,
względem lokalizacji pliku \`.snapraidignore\`.
.PP
W przeciwieństwie do konfiguracji globalnej, pliki \`.snapraidignore\` obsługują
tylko reguły wykluczania; nie można używać wzorców \`include\` ani negacji (!).
.PP
Na przykład, jeśli masz \`.snapraidignore\` w \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Wyklucza TYLKO /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Wyklucza każdy katalog o nazwie \'build\' wewnątrz projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Wyklucza każdy plik .tmp wewnątrz projects/ lub jego podfolderach
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości.
.PP

42
doc/snapraid-pl.d
View file

@ -1404,6 +1404,48 @@ Pattern
W systemie Unix, używając znaków globbing w wierszu poleceń, musisz
je cytować, aby zapobiec ich rozszerzeniu przez powłokę.
Ignore File
Oprócz reguł globalnych w pliku konfiguracyjnym, możesz umieścić pliki
`.snapraidignore` w dowolnym katalogu w macierzy, aby zdefiniować
zdecentralizowane reguły wykluczania.
Reguły zdefiniowane w `.snapraidignore` są stosowane po regułach w pliku
konfiguracyjnym. Oznacza to, że mają one wyższy priorytet i mogą być używane
do wykluczania plików, które zostały wcześniej uwzględnione przez konfigurację
globalną. Skutecznie, jeśli reguła lokalna pasuje, plik jest wykluczany bez
względu na globalne ustawienia uwzględniania.
Logika wzorców w `.snapraidignore` odzwierciedla konfigurację globalną, ale
zakotwicza wzorce w katalogu, w którym znajduje się plik:
=FILE
Wybiera dowolny plik o nazwie FILE w tym katalogu lub poniżej.
Podlega to tym samym zasadom dopasowywania (globbing) co wzorzec globalny.
=DIR/
Wybiera dowolny katalog o nazwie DIR i wszystko w jego wnętrzu,
znajdujący się w tym katalogu lub poniżej.
=/PATH/FILE
Wybiera dokładnie określony plik względem lokalizacji
pliku `.snapraidignore`.
=/PATH/DIR/
Wybiera dokładnie określony katalog i wszystko w jego wnętrzu,
względem lokalizacji pliku `.snapraidignore`.
W przeciwieństwie do konfiguracji globalnej, pliki `.snapraidignore` obsługują
tylko reguły wykluczania; nie można używać wzorców `include` ani negacji (!).
Na przykład, jeśli masz `.snapraidignore` w `/mnt/disk1/projects/`:
:# Wyklucza TYLKO /mnt/disk1/projects/output.bin
:/output.bin
:# Wyklucza każdy katalog o nazwie 'build' wewnątrz projects/
:build/
:# Wyklucza każdy plik .tmp wewnątrz projects/ lub jego podfolderach
:*.tmp
Content
SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości.

57
doc/snapraid-pl.txt
View file

@ -1504,8 +1504,53 @@ W systemie Unix, używając znaków globbing w wierszu poleceń, musisz
je cytować, aby zapobiec ich rozszerzeniu przez powłokę.
9 CONTENT
=========
9 IGNORE FILE
=============
Oprócz reguł globalnych w pliku konfiguracyjnym, możesz umieścić pliki
`.snapraidignore` w dowolnym katalogu w macierzy, aby zdefiniować
zdecentralizowane reguły wykluczania.
Reguły zdefiniowane w `.snapraidignore` są stosowane po regułach w pliku
konfiguracyjnym. Oznacza to, że mają one wyższy priorytet i mogą być używane
do wykluczania plików, które zostały wcześniej uwzględnione przez konfigurację
globalną. Skutecznie, jeśli reguła lokalna pasuje, plik jest wykluczany bez
względu na globalne ustawienia uwzględniania.
Logika wzorców w `.snapraidignore` odzwierciedla konfigurację globalną, ale
zakotwicza wzorce w katalogu, w którym znajduje się plik:
FILE
Wybiera dowolny plik o nazwie FILE w tym katalogu lub poniżej.
Podlega to tym samym zasadom dopasowywania (globbing) co wzorzec globalny.
DIR/
Wybiera dowolny katalog o nazwie DIR i wszystko w jego wnętrzu,
znajdujący się w tym katalogu lub poniżej.
/PATH/FILE
Wybiera dokładnie określony plik względem lokalizacji
pliku `.snapraidignore`.
/PATH/DIR/
Wybiera dokładnie określony katalog i wszystko w jego wnętrzu,
względem lokalizacji pliku `.snapraidignore`.
W przeciwieństwie do konfiguracji globalnej, pliki `.snapraidignore` obsługują
tylko reguły wykluczania; nie można używać wzorców `include` ani negacji (!).
Na przykład, jeśli masz `.snapraidignore` w `/mnt/disk1/projects/`:
# Wyklucza TYLKO /mnt/disk1/projects/output.bin
/output.bin
# Wyklucza każdy katalog o nazwie 'build' wewnątrz projects/
build/
# Wyklucza każdy plik .tmp wewnątrz projects/ lub jego podfolderach
*.tmp
10 CONTENT
==========
SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości.
@ -1516,7 +1561,7 @@ Ten plik jest odczytywany i zapisywany przez polecenia `sync` i `scrub`
oraz odczytywany przez polecenia `fix`, `check` i `status`.
10 PARITY
11 PARITY
=========
SnapRAID przechowuje informacje o parzystości Twojej macierzy w plikach
@ -1529,7 +1574,7 @@ Pliki te są odczytywane i zapisywane przez polecenia `sync` i `fix`
oraz tylko odczytywane przez polecenia `scrub` i `check`.
11 ENCODING
12 ENCODING
===========
SnapRAID w systemie Unix ignoruje wszelkie kodowanie. Odczytuje i przechowuje
@ -1546,13 +1591,13 @@ przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze
w formacie UTF-8.
12 COPYRIGHT
13 COPYRIGHT
============
Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid-pt.1
View file

@ -1882,6 +1882,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
No Unix, ao usar caracteres globbing na linha de comando, você deve
citá\-los para evitar que o shell os expanda.
.SH IGNORAR ARQUIVOS (IGNORE FILE)
Além das regras globais no arquivo de configuração, você pode colocar
arquivos \`.snapraidignore\` em qualquer diretório dentro do array para definir
regras de exclusão descentralizadas.
.PP
As regras definidas em \`.snapraidignore\` são aplicadas após as regras no
arquivo de configuração. Isso significa que elas têm uma prioridade maior e
podem ser usadas para excluir arquivos que foram anteriormente incluídos pela
configuração global. Efetivamente, se uma regra local corresponder, o arquivo
é excluído independentemente das configurações globais de inclusão.
.PP
A lógica de padrões no \`.snapraidignore\` espelha a configuração global, mas
ancora os padrões ao diretório onde o arquivo está localizado:
.TP
.B FILE
Seleciona qualquer arquivo chamado FILE neste diretório ou abaixo.
Isso segue as mesmas regras de globbing do padrão global.
.TP
.B DIR/
Seleciona qualquer diretório chamado DIR e tudo dentro dele,
residente neste diretório ou abaixo.
.TP
.B /PATH/FILE
Seleciona o arquivo exato especificado relativo à localização
do arquivo \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Seleciona o diretório exato especificado e tudo dentro dele,
relativo à localização do arquivo \`.snapraidignore\`.
.PP
Ao contrário da configuração global, os arquivos \`.snapraidignore\` suportam
apenas regras de exclusão; você não pode usar padrões \`include\` ou negação (!).
.PP
Por exemplo, se você tiver um \`.snapraidignore\` em \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Exclui APENAS /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Exclui qualquer diretório chamado \'build\' dentro de projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Exclui qualquer arquivo .tmp dentro de projects/ ou suas subpastas
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTEúDO (CONTENT)
SnapRAID armazena a lista e os checksums de seus arquivos no arquivo content.
.PP

42
doc/snapraid-pt.d
View file

@ -1443,6 +1443,48 @@ Padrão (Pattern)
No Unix, ao usar caracteres globbing na linha de comando, você deve
citá-los para evitar que o shell os expanda.
Ignorar Arquivos (Ignore File)
Além das regras globais no arquivo de configuração, você pode colocar
arquivos `.snapraidignore` em qualquer diretório dentro do array para definir
regras de exclusão descentralizadas.
As regras definidas em `.snapraidignore` são aplicadas após as regras no
arquivo de configuração. Isso significa que elas têm uma prioridade maior e
podem ser usadas para excluir arquivos que foram anteriormente incluídos pela
configuração global. Efetivamente, se uma regra local corresponder, o arquivo
é excluído independentemente das configurações globais de inclusão.
A lógica de padrões no `.snapraidignore` espelha a configuração global, mas
ancora os padrões ao diretório onde o arquivo está localizado:
=FILE
Seleciona qualquer arquivo chamado FILE neste diretório ou abaixo.
Isso segue as mesmas regras de globbing do padrão global.
=DIR/
Seleciona qualquer diretório chamado DIR e tudo dentro dele,
residente neste diretório ou abaixo.
=/PATH/FILE
Seleciona o arquivo exato especificado relativo à localização
do arquivo `.snapraidignore`.
=/PATH/DIR/
Seleciona o diretório exato especificado e tudo dentro dele,
relativo à localização do arquivo `.snapraidignore`.
Ao contrário da configuração global, os arquivos `.snapraidignore` suportam
apenas regras de exclusão; você não pode usar padrões `include` ou negação (!).
Por exemplo, se você tiver um `.snapraidignore` em `/mnt/disk1/projects/`:
:# Exclui APENAS /mnt/disk1/projects/output.bin
:/output.bin
:# Exclui qualquer diretório chamado 'build' dentro de projects/
:build/
:# Exclui qualquer arquivo .tmp dentro de projects/ ou suas subpastas
:*.tmp
Conteúdo (Content)
SnapRAID armazena a lista e os checksums de seus arquivos no arquivo content.

57
doc/snapraid-pt.txt
View file

@ -1543,8 +1543,53 @@ No Unix, ao usar caracteres globbing na linha de comando, você deve
citá-los para evitar que o shell os expanda.
9 CONTEúDO (CONTENT)
====================
9 IGNORAR ARQUIVOS (IGNORE FILE)
================================
Além das regras globais no arquivo de configuração, você pode colocar
arquivos `.snapraidignore` em qualquer diretório dentro do array para definir
regras de exclusão descentralizadas.
As regras definidas em `.snapraidignore` são aplicadas após as regras no
arquivo de configuração. Isso significa que elas têm uma prioridade maior e
podem ser usadas para excluir arquivos que foram anteriormente incluídos pela
configuração global. Efetivamente, se uma regra local corresponder, o arquivo
é excluído independentemente das configurações globais de inclusão.
A lógica de padrões no `.snapraidignore` espelha a configuração global, mas
ancora os padrões ao diretório onde o arquivo está localizado:
FILE
Seleciona qualquer arquivo chamado FILE neste diretório ou abaixo.
Isso segue as mesmas regras de globbing do padrão global.
DIR/
Seleciona qualquer diretório chamado DIR e tudo dentro dele,
residente neste diretório ou abaixo.
/PATH/FILE
Seleciona o arquivo exato especificado relativo à localização
do arquivo `.snapraidignore`.
/PATH/DIR/
Seleciona o diretório exato especificado e tudo dentro dele,
relativo à localização do arquivo `.snapraidignore`.
Ao contrário da configuração global, os arquivos `.snapraidignore` suportam
apenas regras de exclusão; você não pode usar padrões `include` ou negação (!).
Por exemplo, se você tiver um `.snapraidignore` em `/mnt/disk1/projects/`:
# Exclui APENAS /mnt/disk1/projects/output.bin
/output.bin
# Exclui qualquer diretório chamado 'build' dentro de projects/
build/
# Exclui qualquer arquivo .tmp dentro de projects/ ou suas subpastas
*.tmp
10 CONTEúDO (CONTENT)
=====================
SnapRAID armazena a lista e os checksums de seus arquivos no arquivo content.
@ -1555,7 +1600,7 @@ Este arquivo é lido e escrito pelos comandos `sync` e `scrub` e
lido pelos comandos `fix`, `check` e `status`.
10 PARIDADE (PARITY)
11 PARIDADE (PARITY)
====================
SnapRAID armazena as informações de paridade do seu array nos arquivos parity.
@ -1567,7 +1612,7 @@ Estes arquivos são lidos e escritos pelos comandos `sync` e `fix` e
apenas lidos pelos comandos `scrub` e `check`.
11 CODIFICAçãO (ENCODING)
12 CODIFICAçãO (ENCODING)
=========================
SnapRAID no Unix ignora qualquer codificação. Ele lê e armazena os
@ -1584,13 +1629,13 @@ redirecionar a saída do console para um arquivo, o arquivo resultante
estará sempre no formato UTF-8.
12 DIREITOS AUTORAIS (COPYRIGHT)
13 DIREITOS AUTORAIS (COPYRIGHT)
================================
Este arquivo é Copyright (C) 2025 Andrea Mazzoleni
13 VEJA TAMBéM (SEE ALSO)
14 VEJA TAMBéM (SEE ALSO)
=========================
snapraid_log(1), rsync(1)

60
doc/snapraid-ro.1
View file

@ -1845,6 +1845,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
În Unix, când utilizați caractere globbing pe linia de comandă, trebuie
să le citați pentru a împiedica shell\-ul să le extindă.
.SH FIșIERE DE IGNORAT (IGNORE FILE)
Pe lângă regulile globale din fișierul de configurare, puteți plasa fișiere
\`.snapraidignore\` în orice director din array pentru a defini reguli de excludere
descentralizate.
.PP
Regulile definite în \`.snapraidignore\` sunt aplicate după regulile din fișierul
de configurare. Acest lucru înseamnă că au o prioritate mai mare și pot fi
utilizate pentru a exclude fișiere care au fost incluse anterior de configurația
globală. Efectiv, dacă o regulă locală se potrivește, fișierul este exclus
indiferent de setările globale de includere.
.PP
Logica modelelor în \`.snapraidignore\` oglindește configurația globală, dar
ancorează modelele de directorul în care se află fișierul:
.TP
.B FILE
Selectează orice fișier numit FILE în acest director sau mai jos.
Acesta urmează aceleași reguli de globbing ca modelul global.
.TP
.B DIR/
Selectează orice director numit DIR și tot ce se află în interior,
aflat în acest director sau mai jos.
.TP
.B /PATH/FILE
Selectează fișierul exact specificat raportat la locația
fișierului \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Selectează directorul exact specificat și tot ce se află în interior,
raportat la locația fișierului \`.snapraidignore\`.
.PP
Spre deosebire de configurația globală, fișierele \`.snapraidignore\` suportă
doar reguli de excludere; nu puteți utiliza modele de \`include\` sau negația (!).
.PP
De exemplu, dacă aveți un \`.snapraidignore\` în \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Exclude DOAR /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Exclude orice director numit \'build\' în interiorul projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Exclude orice fișier .tmp în interiorul projects/ sau subfolderele sale
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONțINUT (CONTENT)
SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut.
.PP

42
doc/snapraid-ro.d
View file

@ -1406,6 +1406,48 @@ Model (Pattern)
În Unix, când utilizați caractere globbing pe linia de comandă, trebuie
să le citați pentru a împiedica shell-ul să le extindă.
Fișiere de Ignorat (Ignore File)
Pe lângă regulile globale din fișierul de configurare, puteți plasa fișiere
`.snapraidignore` în orice director din array pentru a defini reguli de excludere
descentralizate.
Regulile definite în `.snapraidignore` sunt aplicate după regulile din fișierul
de configurare. Acest lucru înseamnă că au o prioritate mai mare și pot fi
utilizate pentru a exclude fișiere care au fost incluse anterior de configurația
globală. Efectiv, dacă o regulă locală se potrivește, fișierul este exclus
indiferent de setările globale de includere.
Logica modelelor în `.snapraidignore` oglindește configurația globală, dar
ancorează modelele de directorul în care se află fișierul:
=FILE
Selectează orice fișier numit FILE în acest director sau mai jos.
Acesta urmează aceleași reguli de globbing ca modelul global.
=DIR/
Selectează orice director numit DIR și tot ce se află în interior,
aflat în acest director sau mai jos.
=/PATH/FILE
Selectează fișierul exact specificat raportat la locația
fișierului `.snapraidignore`.
=/PATH/DIR/
Selectează directorul exact specificat și tot ce se află în interior,
raportat la locația fișierului `.snapraidignore`.
Spre deosebire de configurația globală, fișierele `.snapraidignore` suportă
doar reguli de excludere; nu puteți utiliza modele de `include` sau negația (!).
De exemplu, dacă aveți un `.snapraidignore` în `/mnt/disk1/projects/`:
:# Exclude DOAR /mnt/disk1/projects/output.bin
:/output.bin
:# Exclude orice director numit 'build' în interiorul projects/
:build/
:# Exclude orice fișier .tmp în interiorul projects/ sau subfolderele sale
:*.tmp
Conținut (Content)
SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut.

57
doc/snapraid-ro.txt
View file

@ -1506,8 +1506,53 @@ De exemplu:
să le citați pentru a împiedica shell-ul să le extindă.
9 CONțINUT (CONTENT)
====================
9 FIșIERE DE IGNORAT (IGNORE FILE)
==================================
Pe lângă regulile globale din fișierul de configurare, puteți plasa fișiere
`.snapraidignore` în orice director din array pentru a defini reguli de excludere
descentralizate.
Regulile definite în `.snapraidignore` sunt aplicate după regulile din fișierul
de configurare. Acest lucru înseamnă că au o prioritate mai mare și pot fi
utilizate pentru a exclude fișiere care au fost incluse anterior de configurația
globală. Efectiv, dacă o regulă locală se potrivește, fișierul este exclus
indiferent de setările globale de includere.
Logica modelelor în `.snapraidignore` oglindește configurația globală, dar
ancorează modelele de directorul în care se află fișierul:
FILE
Selectează orice fișier numit FILE în acest director sau mai jos.
Acesta urmează aceleași reguli de globbing ca modelul global.
DIR/
Selectează orice director numit DIR și tot ce se află în interior,
aflat în acest director sau mai jos.
/PATH/FILE
Selectează fișierul exact specificat raportat la locația
fișierului `.snapraidignore`.
/PATH/DIR/
Selectează directorul exact specificat și tot ce se află în interior,
raportat la locația fișierului `.snapraidignore`.
Spre deosebire de configurația globală, fișierele `.snapraidignore` suportă
doar reguli de excludere; nu puteți utiliza modele de `include` sau negația (!).
De exemplu, dacă aveți un `.snapraidignore` în `/mnt/disk1/projects/`:
# Exclude DOAR /mnt/disk1/projects/output.bin
/output.bin
# Exclude orice director numit 'build' în interiorul projects/
build/
# Exclude orice fișier .tmp în interiorul projects/ sau subfolderele sale
*.tmp
10 CONțINUT (CONTENT)
=====================
SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut.
@ -1518,7 +1563,7 @@ Acest fișier este citit și scris de comenzile `sync` și `scrub` și
citit de comenzile `fix`, `check` și `status`.
10 PARITATE (PARITY)
11 PARITATE (PARITY)
====================
SnapRAID stochează informațiile de paritate ale matricei dvs. în fișierele de paritate.
@ -1530,7 +1575,7 @@ Aceste fișiere sunt citite și scrise de comenzile `sync` și `fix` și
doar citite de comenzile `scrub` și `check`.
11 CODARE (ENCODING)
12 CODARE (ENCODING)
====================
SnapRAID în Unix ignoră orice codare. Citește și stochează
@ -1547,13 +1592,13 @@ redirecționați ieșirea consolei către un fișier, fișierul rezultat este î
în format UTF-8.
12 DREPT DE AUTOR (COPYRIGHT)
13 DREPT DE AUTOR (COPYRIGHT)
=============================
Acest fișier este Copyright (C) 2025 Andrea Mazzoleni
13 VEZI șI (SEE ALSO)
14 VEZI șI (SEE ALSO)
=====================
snapraid_log(1), rsync(1)

60
doc/snapraid-ru.1
View file

@ -1849,6 +1849,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
В Unix при использовании символов глоббинга в командной строке вы должны
заключить их в кавычки, чтобы предотвратить их расширение оболочкой.
.SH IGNORE FILE
В дополнение к глобальным правилам в файле конфигурации, вы можете
размещать файлы \`.snapraidignore\` в любом каталоге внутри массива для
определения децентрализованных правил исключения.
.PP
Правила, определенные в \`.snapraidignore\`, применяются после правил в
конфигурационном файле. Это означает, что они имеют более высокий приоритет
и могут использоваться для исключения файлов, которые ранее были включены
глобальной конфигурацией. Фактически, если локальное правило совпадает, файл
исключается независимо от глобальных настроек включения.
.PP
Логика шаблонов в \`.snapraidignore\` повторяет глобальную конфигурацию, но
привязывает шаблоны к каталогу, в котором находится файл:
.TP
.B FILE
Выбирает любой файл с именем FILE в этом каталоге или ниже.
Здесь действуют те же правила подстановки, что и в глобальном шаблоне.
.TP
.B DIR/
Выбирает любой каталог с именем DIR и все его содержимое,
находящееся в этом каталоге или ниже.
.TP
.B /PATH/FILE
Выбирает точно указанный файл относительно местоположения
файла \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Выбирает точно указанный каталог и все его содержимое
относительно местоположения файла \`.snapraidignore\`.
.PP
В отличие от глобальной конфигурации, файлы \`.snapraidignore\` поддерживают
только правила исключения; вы не можете использовать шаблоны \`include\` или отрицание (!).
.PP
Например, если у вас есть \`.snapraidignore\` в \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Исключает ТОЛЬКО /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Исключает любой каталог с именем \'build\' внутри projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Исключает любой .tmp файл внутри projects/ или его подпапок
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID хранит список и контрольные суммы ваших файлов в файле content.
.PP

42
doc/snapraid-ru.d
View file

@ -1410,6 +1410,48 @@ Pattern
В Unix при использовании символов глоббинга в командной строке вы должны
заключить их в кавычки, чтобы предотвратить их расширение оболочкой.
Ignore File
В дополнение к глобальным правилам в файле конфигурации, вы можете
размещать файлы `.snapraidignore` в любом каталоге внутри массива для
определения децентрализованных правил исключения.
Правила, определенные в `.snapraidignore`, применяются после правил в
конфигурационном файле. Это означает, что они имеют более высокий приоритет
и могут использоваться для исключения файлов, которые ранее были включены
глобальной конфигурацией. Фактически, если локальное правило совпадает, файл
исключается независимо от глобальных настроек включения.
Логика шаблонов в `.snapraidignore` повторяет глобальную конфигурацию, но
привязывает шаблоны к каталогу, в котором находится файл:
=FILE
Выбирает любой файл с именем FILE в этом каталоге или ниже.
Здесь действуют те же правила подстановки, что и в глобальном шаблоне.
=DIR/
Выбирает любой каталог с именем DIR и все его содержимое,
находящееся в этом каталоге или ниже.
=/PATH/FILE
Выбирает точно указанный файл относительно местоположения
файла `.snapraidignore`.
=/PATH/DIR/
Выбирает точно указанный каталог и все его содержимое
относительно местоположения файла `.snapraidignore`.
В отличие от глобальной конфигурации, файлы `.snapraidignore` поддерживают
только правила исключения; вы не можете использовать шаблоны `include` или отрицание (!).
Например, если у вас есть `.snapraidignore` в `/mnt/disk1/projects/`:
:# Исключает ТОЛЬКО /mnt/disk1/projects/output.bin
:/output.bin
:# Исключает любой каталог с именем 'build' внутри projects/
:build/
:# Исключает любой .tmp файл внутри projects/ или его подпапок
:*.tmp
Content
SnapRAID хранит список и контрольные суммы ваших файлов в файле content.

57
doc/snapraid-ru.txt
View file

@ -1510,8 +1510,53 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
заключить их в кавычки, чтобы предотвратить их расширение оболочкой.
9 CONTENT
=========
9 IGNORE FILE
=============
В дополнение к глобальным правилам в файле конфигурации, вы можете
размещать файлы `.snapraidignore` в любом каталоге внутри массива для
определения децентрализованных правил исключения.
Правила, определенные в `.snapraidignore`, применяются после правил в
конфигурационном файле. Это означает, что они имеют более высокий приоритет
и могут использоваться для исключения файлов, которые ранее были включены
глобальной конфигурацией. Фактически, если локальное правило совпадает, файл
исключается независимо от глобальных настроек включения.
Логика шаблонов в `.snapraidignore` повторяет глобальную конфигурацию, но
привязывает шаблоны к каталогу, в котором находится файл:
FILE
Выбирает любой файл с именем FILE в этом каталоге или ниже.
Здесь действуют те же правила подстановки, что и в глобальном шаблоне.
DIR/
Выбирает любой каталог с именем DIR и все его содержимое,
находящееся в этом каталоге или ниже.
/PATH/FILE
Выбирает точно указанный файл относительно местоположения
файла `.snapraidignore`.
/PATH/DIR/
Выбирает точно указанный каталог и все его содержимое
относительно местоположения файла `.snapraidignore`.
В отличие от глобальной конфигурации, файлы `.snapraidignore` поддерживают
только правила исключения; вы не можете использовать шаблоны `include` или отрицание (!).
Например, если у вас есть `.snapraidignore` в `/mnt/disk1/projects/`:
# Исключает ТОЛЬКО /mnt/disk1/projects/output.bin
/output.bin
# Исключает любой каталог с именем 'build' внутри projects/
build/
# Исключает любой .tmp файл внутри projects/ или его подпапок
*.tmp
10 CONTENT
==========
SnapRAID хранит список и контрольные суммы ваших файлов в файле content.
@ -1522,7 +1567,7 @@ SnapRAID хранит список и контрольные суммы ваши
считывается командами `fix`, `check` и `status`.
10 PARITY
11 PARITY
=========
SnapRAID хранит информацию четности вашего массива в файлах parity.
@ -1534,7 +1579,7 @@ SnapRAID хранит информацию четности вашего мас
только считываются командами `scrub` и `check`.
11 ENCODING
12 ENCODING
===========
SnapRAID в Unix игнорирует любое кодирование. Он считывает и хранит
@ -1551,13 +1596,13 @@ SnapRAID в Unix игнорирует любое кодирование. Он с
в формате UTF-8.
12 COPYRIGHT
13 COPYRIGHT
============
Этот файл защищен авторским правом (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid-sv.1
View file

@ -1850,6 +1850,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
I Unix, när du använder globbing\-tecken på kommandoraden, måste du
citattecken dem för att förhindra att skalet expanderar dem.
.SH IGNORERA FILER (IGNORE FILE)
Utöver de globala reglerna i konfigurationsfilen kan du placera
\`.snapraidignore\`\-filer i vilken katalog som helst i arrayen för att definiera
decentraliserade exkluderingsregler.
.PP
Regler som definieras i \`.snapraidignore\` tillämpas efter reglerna i
konfigurationsfilen. Detta innebär att de har högre prioritet och kan
användas för att exkludera filer som tidigare inkluderats av den globala
konfigurationen. I praktiken innebär det att om en lokal regel matchar, så
exkluderas filen oavsett de globala inkluderingsinställningarna.
.PP
Mönsterlogiken i \`.snapraidignore\` speglar den globala konfigurationen men
förankrar mönstren till den katalog där filen finns:
.TP
.B FILE
Väljer alla filer med namnet FILE i denna katalog eller under.
Detta följer samma globbing\-regler som det globala mönstret.
.TP
.B DIR/
Väljer alla kataloger med namnet DIR och allt innehåll, som finns
i denna katalog eller under.
.TP
.B /PATH/FILE
Väljer den exakt angivna filen relativt platsen för
\`.snapraidignore\`\-filen.
.TP
.B /PATH/DIR/
Väljer den exakt angivna katalogen och allt innehåll, relativt
platsen för \`.snapraidignore\`\-filen.
.PP
Till skillnad från den globala konfigurationen stöder \`.snapraidignore\`\-filer
endast exkluderingsregler; du kan inte använda \`include\`\-mönster eller negation (!).
.PP
Till exempel, om du har en \`.snapraidignore\` i \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Exkluderar ENDAST /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Exkluderar alla kataloger med namnet \'build\' inuti projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Exkluderar alla .tmp\-filer inuti projects/ eller dess undermappar
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH INNEHåLL (CONTENT)
SnapRAID lagrar listan och checksummorna för dina filer i content\-filen.
.PP

42
doc/snapraid-sv.d
View file

@ -1411,6 +1411,48 @@ Mönster
I Unix, när du använder globbing-tecken på kommandoraden, måste du
citattecken dem för att förhindra att skalet expanderar dem.
Ignorera filer (Ignore File)
Utöver de globala reglerna i konfigurationsfilen kan du placera
`.snapraidignore`-filer i vilken katalog som helst i arrayen för att definiera
decentraliserade exkluderingsregler.
Regler som definieras i `.snapraidignore` tillämpas efter reglerna i
konfigurationsfilen. Detta innebär att de har högre prioritet och kan
användas för att exkludera filer som tidigare inkluderats av den globala
konfigurationen. I praktiken innebär det att om en lokal regel matchar, så
exkluderas filen oavsett de globala inkluderingsinställningarna.
Mönsterlogiken i `.snapraidignore` speglar den globala konfigurationen men
förankrar mönstren till den katalog där filen finns:
=FILE
Väljer alla filer med namnet FILE i denna katalog eller under.
Detta följer samma globbing-regler som det globala mönstret.
=DIR/
Väljer alla kataloger med namnet DIR och allt innehåll, som finns
i denna katalog eller under.
=/PATH/FILE
Väljer den exakt angivna filen relativt platsen för
`.snapraidignore`-filen.
=/PATH/DIR/
Väljer den exakt angivna katalogen och allt innehåll, relativt
platsen för `.snapraidignore`-filen.
Till skillnad från den globala konfigurationen stöder `.snapraidignore`-filer
endast exkluderingsregler; du kan inte använda `include`-mönster eller negation (!).
Till exempel, om du har en `.snapraidignore` i `/mnt/disk1/projects/`:
:# Exkluderar ENDAST /mnt/disk1/projects/output.bin
:/output.bin
:# Exkluderar alla kataloger med namnet 'build' inuti projects/
:build/
:# Exkluderar alla .tmp-filer inuti projects/ eller dess undermappar
:*.tmp
Innehåll (Content)
SnapRAID lagrar listan och checksummorna för dina filer i content-filen.

57
doc/snapraid-sv.txt
View file

@ -1511,8 +1511,53 @@ I Unix, när du använder globbing-tecken på kommandoraden, måste du
citattecken dem för att förhindra att skalet expanderar dem.
9 INNEHåLL (CONTENT)
====================
9 IGNORERA FILER (IGNORE FILE)
==============================
Utöver de globala reglerna i konfigurationsfilen kan du placera
`.snapraidignore`-filer i vilken katalog som helst i arrayen för att definiera
decentraliserade exkluderingsregler.
Regler som definieras i `.snapraidignore` tillämpas efter reglerna i
konfigurationsfilen. Detta innebär att de har högre prioritet och kan
användas för att exkludera filer som tidigare inkluderats av den globala
konfigurationen. I praktiken innebär det att om en lokal regel matchar, så
exkluderas filen oavsett de globala inkluderingsinställningarna.
Mönsterlogiken i `.snapraidignore` speglar den globala konfigurationen men
förankrar mönstren till den katalog där filen finns:
FILE
Väljer alla filer med namnet FILE i denna katalog eller under.
Detta följer samma globbing-regler som det globala mönstret.
DIR/
Väljer alla kataloger med namnet DIR och allt innehåll, som finns
i denna katalog eller under.
/PATH/FILE
Väljer den exakt angivna filen relativt platsen för
`.snapraidignore`-filen.
/PATH/DIR/
Väljer den exakt angivna katalogen och allt innehåll, relativt
platsen för `.snapraidignore`-filen.
Till skillnad från den globala konfigurationen stöder `.snapraidignore`-filer
endast exkluderingsregler; du kan inte använda `include`-mönster eller negation (!).
Till exempel, om du har en `.snapraidignore` i `/mnt/disk1/projects/`:
# Exkluderar ENDAST /mnt/disk1/projects/output.bin
/output.bin
# Exkluderar alla kataloger med namnet 'build' inuti projects/
build/
# Exkluderar alla .tmp-filer inuti projects/ eller dess undermappar
*.tmp
10 INNEHåLL (CONTENT)
=====================
SnapRAID lagrar listan och checksummorna för dina filer i content-filen.
@ -1523,7 +1568,7 @@ Denna fil läses och skrivs av kommandona `sync` och `scrub` och
läses av kommandona `fix`, `check` och `status`.
10 PARITET (PARITY)
11 PARITET (PARITY)
===================
SnapRAID lagrar paritetsinformationen för din array i parity-
@ -1536,7 +1581,7 @@ Dessa filer läses och skrivs av kommandona `sync` och `fix` och
läses endast av kommandona `scrub` och `check`.
11 KODNING
12 KODNING
==========
SnapRAID i Unix ignorerar all kodning. Det läser och lagrar
@ -1553,13 +1598,13 @@ omdirigerar konsolutdata till en fil, är den resulterande filen alltid
i UTF-8-format.
12 UPPHOVSRäTT (COPYRIGHT)
13 UPPHOVSRäTT (COPYRIGHT)
==========================
Denna fil är Copyright (C) 2025 Andrea Mazzoleni
13 SE ÄVEN (SEE ALSO)
14 SE ÄVEN (SEE ALSO)
=====================
snapraid_log(1), rsync(1)

60
doc/snapraid-uk.1
View file

@ -2056,6 +2056,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
В Unix, при використанні символів глоббінгу в
командному рядку, ви повинні взяти їх у лапки,
щоб запобігти їх розширенню оболонкою.
.SH Ігнорування файлів (IGNORE FILE)
На додаток до глобальних правил у файлі конфігурації, ви можете розміщувати
файли \`.snapraidignore\` в будь\-якому каталозі всередині масиву для визначення
децентралізованих правил виключення.
.PP
Правила, визначені в \`.snapraidignore\`, застосовуються після правил у файлі
конфігурації. Це означає, що вони мають вищий пріоритет і можуть бути використані
для виключення файлів, які раніше були включені глобальною конфігурацією.
Фактично, якщо локальне правило збігається, файл виключається незалежно від
глобальних налаштувань включення.
.PP
Логіка шаблонів у \`.snapraidignore\` повторює глобальну конфігурацію, але
прив\'язує шаблони до каталогу, в якому знаходиться файл:
.TP
.B FILE
Вибирає будь\-який файл із ім\'ям FILE у цьому каталозі або нижче.
Це відповідає тим самим правилам підстановки, що і в глобальному шаблоні.
.TP
.B DIR/
Вибирає будь\-який каталог із ім\'ям DIR та весь його вміст, що
знаходиться в цьому каталозі або нижче.
.TP
.B /PATH/FILE
Вибирає точно вказаний файл відносно розташування
файлу \`.snapraidignore\`.
.TP
.B /PATH/DIR/
Вибирає точно вказаний каталог та весь його вміст відносно
розташування файлу \`.snapraidignore\`.
.PP
На відміну від глобальної конфігурації, файли \`.snapraidignore\` підтримують
лише правила виключення; ви не можете використовувати шаблони \`include\` або заперечення (!).
.PP
Наприклад, якщо у вас є \`.snapraidignore\` у \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Виключає ТІЛЬКИ /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Виключає будь\-який каталог із назвою \'build\' всередині projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Виключає будь\-який .tmp файл всередині projects/ або його підпапок
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH Вміст (CONTENT)
SnapRAID зберігає список та контрольні суми
ваших файлів у файлі вмісту.

42
doc/snapraid-uk.d
View file

@ -1603,6 +1603,48 @@ Name{number}
командному рядку, ви повинні взяти їх у лапки,
щоб запобігти їх розширенню оболонкою.
Ігнорування файлів (Ignore File)
На додаток до глобальних правил у файлі конфігурації, ви можете розміщувати
файли `.snapraidignore` в будь-якому каталозі всередині масиву для визначення
децентралізованих правил виключення.
Правила, визначені в `.snapraidignore`, застосовуються після правил у файлі
конфігурації. Це означає, що вони мають вищий пріоритет і можуть бути використані
для виключення файлів, які раніше були включені глобальною конфігурацією.
Фактично, якщо локальне правило збігається, файл виключається незалежно від
глобальних налаштувань включення.
Логіка шаблонів у `.snapraidignore` повторює глобальну конфігурацію, але
прив'язує шаблони до каталогу, в якому знаходиться файл:
=FILE
Вибирає будь-який файл із ім'ям FILE у цьому каталозі або нижче.
Це відповідає тим самим правилам підстановки, що і в глобальному шаблоні.
=DIR/
Вибирає будь-який каталог із ім'ям DIR та весь його вміст, що
знаходиться в цьому каталозі або нижче.
=/PATH/FILE
Вибирає точно вказаний файл відносно розташування
файлу `.snapraidignore`.
=/PATH/DIR/
Вибирає точно вказаний каталог та весь його вміст відносно
розташування файлу `.snapraidignore`.
На відміну від глобальної конфігурації, файли `.snapraidignore` підтримують
лише правила виключення; ви не можете використовувати шаблони `include` або заперечення (!).
Наприклад, якщо у вас є `.snapraidignore` у `/mnt/disk1/projects/`:
:# Виключає ТІЛЬКИ /mnt/disk1/projects/output.bin
:/output.bin
:# Виключає будь-який каталог із назвою 'build' всередині projects/
:build/
:# Виключає будь-який .tmp файл всередині projects/ або його підпапок
:*.tmp
Вміст (Content)
SnapRAID зберігає список та контрольні суми
ваших файлів у файлі вмісту.

57
doc/snapraid-uk.txt
View file

@ -1703,8 +1703,53 @@ PARITY — це одне з імен парності: `parity`,
щоб запобігти їх розширенню оболонкою.
9 Вміст (CONTENT)
=================
9 Ігнорування файлів (IGNORE FILE)
==================================
На додаток до глобальних правил у файлі конфігурації, ви можете розміщувати
файли `.snapraidignore` в будь-якому каталозі всередині масиву для визначення
децентралізованих правил виключення.
Правила, визначені в `.snapraidignore`, застосовуються після правил у файлі
конфігурації. Це означає, що вони мають вищий пріоритет і можуть бути використані
для виключення файлів, які раніше були включені глобальною конфігурацією.
Фактично, якщо локальне правило збігається, файл виключається незалежно від
глобальних налаштувань включення.
Логіка шаблонів у `.snapraidignore` повторює глобальну конфігурацію, але
прив'язує шаблони до каталогу, в якому знаходиться файл:
FILE
Вибирає будь-який файл із ім'ям FILE у цьому каталозі або нижче.
Це відповідає тим самим правилам підстановки, що і в глобальному шаблоні.
DIR/
Вибирає будь-який каталог із ім'ям DIR та весь його вміст, що
знаходиться в цьому каталозі або нижче.
/PATH/FILE
Вибирає точно вказаний файл відносно розташування
файлу `.snapraidignore`.
/PATH/DIR/
Вибирає точно вказаний каталог та весь його вміст відносно
розташування файлу `.snapraidignore`.
На відміну від глобальної конфігурації, файли `.snapraidignore` підтримують
лише правила виключення; ви не можете використовувати шаблони `include` або заперечення (!).
Наприклад, якщо у вас є `.snapraidignore` у `/mnt/disk1/projects/`:
# Виключає ТІЛЬКИ /mnt/disk1/projects/output.bin
/output.bin
# Виключає будь-який каталог із назвою 'build' всередині projects/
build/
# Виключає будь-який .tmp файл всередині projects/ або його підпапок
*.tmp
10 Вміст (CONTENT)
==================
SnapRAID зберігає список та контрольні суми
ваших файлів у файлі вмісту.
@ -1719,7 +1764,7 @@ SnapRAID зберігає список та контрольні суми
`check` та `status`.
10 Парність (PARITY)
11 Парність (PARITY)
====================
SnapRAID зберігає інформацію парності вашого
@ -1734,7 +1779,7 @@ SnapRAID зберігає інформацію парності вашого
`scrub` та `check`.
11 Кодування (ENCODING)
12 Кодування (ENCODING)
=======================
SnapRAID в Unix ігнорує будь-яке кодування.
@ -1758,13 +1803,13 @@ TrueType, такий як `Lucida Console`, як
буде у форматі UTF-8.
12 Авторське право (COPYRIGHT)
13 Авторське право (COPYRIGHT)
==============================
Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni
13 Див. також (SEE ALSO)
14 Див. також (SEE ALSO)
========================
snapraid_log(1), rsync(1)

56
doc/snapraid-zh.1
View file

@ -1700,6 +1700,62 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
在 Unix 中，在命令行上使用 globbing 字符时，必须
引用它们以防止 shell 扩展它们。
.SH IGNORE FILE
除了配置文件中的全局规则外，您还可以在阵列内的任何目录中放置
\`.snapraidignore\` 文件，以定义分散的排除规则。
.PP
在 \`.snapraidignore\` 中定义的规则会在配置文件中的规则之后应用。
这意味着它们具有更高的优先级，可用于排除先前由全局配置包含的文件。
实际上，如果本地规则匹配，则无论全局包含设置如何，该文件都会被排除。
.PP
\`.snapraidignore\` 中的模式逻辑与全局配置相同，但模式锚定在
该文件所在的目录：
.TP
.B FILE
选择此目录或其下方任何名为 FILE 的文件。
这遵循与全局模式相同的通配符规则。
.TP
.B DIR/
选择任何名为 DIR 的目录及其内部的所有内容，
位于此目录或其下方。
.TP
.B /PATH/FILE
选择相对于 \`.snapraidignore\` 文件位置指定的精确文件。
.TP
.B /PATH/DIR/
选择相对于 \`.snapraidignore\` 文件位置指定的精确目录
及其内部的所有内容。
.PP
与全局配置不同，\`.snapraidignore\` 文件仅支持排除规则；
您不能使用 \`include\` 模式或否定符号 (!)。
.PP
例如，如果您在 \`/mnt/disk1/projects/\` 中有一个 \`.snapraidignore\`：
.PP
.RS 4
# 仅排除 /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# 排除 projects/ 中任何名为 \'build\' 的目录
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# 排除 projects/ 或其子文件夹中任何 .tmp 文件
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID 将文件列表和校验和存储在 content 文件中。
.PP

38
doc/snapraid-zh.d
View file

@ -1261,6 +1261,44 @@ Pattern
在 Unix 中，在命令行上使用 globbing 字符时，必须
引用它们以防止 shell 扩展它们。
Ignore File
除了配置文件中的全局规则外，您还可以在阵列内的任何目录中放置
`.snapraidignore` 文件，以定义分散的排除规则。
在 `.snapraidignore` 中定义的规则会在配置文件中的规则之后应用。
这意味着它们具有更高的优先级，可用于排除先前由全局配置包含的文件。
实际上，如果本地规则匹配，则无论全局包含设置如何，该文件都会被排除。
`.snapraidignore` 中的模式逻辑与全局配置相同，但模式锚定在
该文件所在的目录：
=FILE
选择此目录或其下方任何名为 FILE 的文件。
这遵循与全局模式相同的通配符规则。
=DIR/
选择任何名为 DIR 的目录及其内部的所有内容，
位于此目录或其下方。
=/PATH/FILE
选择相对于 `.snapraidignore` 文件位置指定的精确文件。
=/PATH/DIR/
选择相对于 `.snapraidignore` 文件位置指定的精确目录
及其内部的所有内容。
与全局配置不同，`.snapraidignore` 文件仅支持排除规则；
您不能使用 `include` 模式或否定符号 (!)。
例如，如果您在 `/mnt/disk1/projects/` 中有一个 `.snapraidignore`：
:# 仅排除 /mnt/disk1/projects/output.bin
:/output.bin
:# 排除 projects/ 中任何名为 'build' 的目录
:build/
:# 排除 projects/ 或其子文件夹中任何 .tmp 文件
:*.tmp
Content
SnapRAID 将文件列表和校验和存储在 content 文件中。

53
doc/snapraid-zh.txt
View file

@ -1361,8 +1361,49 @@ globbing 字符。在 Unix 中，转义字符是 '\'；在 Windows 中，它是
引用它们以防止 shell 扩展它们。
9 CONTENT
=========
9 IGNORE FILE
=============
除了配置文件中的全局规则外，您还可以在阵列内的任何目录中放置
`.snapraidignore` 文件，以定义分散的排除规则。
在 `.snapraidignore` 中定义的规则会在配置文件中的规则之后应用。
这意味着它们具有更高的优先级，可用于排除先前由全局配置包含的文件。
实际上，如果本地规则匹配，则无论全局包含设置如何，该文件都会被排除。
`.snapraidignore` 中的模式逻辑与全局配置相同，但模式锚定在
该文件所在的目录：
FILE
选择此目录或其下方任何名为 FILE 的文件。
这遵循与全局模式相同的通配符规则。
DIR/
选择任何名为 DIR 的目录及其内部的所有内容，
位于此目录或其下方。
/PATH/FILE
选择相对于 `.snapraidignore` 文件位置指定的精确文件。
/PATH/DIR/
选择相对于 `.snapraidignore` 文件位置指定的精确目录
及其内部的所有内容。
与全局配置不同，`.snapraidignore` 文件仅支持排除规则；
您不能使用 `include` 模式或否定符号 (!)。
例如，如果您在 `/mnt/disk1/projects/` 中有一个 `.snapraidignore`：
# 仅排除 /mnt/disk1/projects/output.bin
/output.bin
# 排除 projects/ 中任何名为 'build' 的目录
build/
# 排除 projects/ 或其子文件夹中任何 .tmp 文件
*.tmp
10 CONTENT
==========
SnapRAID 将文件列表和校验和存储在 content 文件中。
@ -1373,7 +1414,7 @@ SnapRAID 将文件列表和校验和存储在 content 文件中。
`fix`、`check` 和 `status` 命令读取。
10 PARITY
11 PARITY
=========
SnapRAID 将阵列的奇偶校验信息存储在 parity 文件中。
@ -1385,7 +1426,7 @@ SnapRAID 将阵列的奇偶校验信息存储在 parity 文件中。
并且仅由 `scrub` 和 `check` 命令读取。
11 ENCODING
12 ENCODING
===========
SnapRAID 在 Unix 中忽略任何编码。它读取并存储
@ -1401,13 +1442,13 @@ SnapRAID 在 Unix 中忽略任何编码。它读取并存储
采用 UTF-8 格式。
12 COPYRIGHT
13 COPYRIGHT
============
此文件版权所有 (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)

60
doc/snapraid.1
View file

@ -1852,6 +1852,66 @@ snapraid \-f \[dq]*.mp3\[dq] check
.PP
In Unix, when using globbing characters on the command line, you must
quote them to prevent the shell from expanding them.
.SH IGNORE FILE
In addition to the global rules in the configuration file, you can
place \`.snapraidignore\` files in any directory within the array to
define decentralized exclusion rules.
.PP
Rules defined in \`.snapraidignore\` are applied after the rules in the
configuration file. This means they have a higher priority and can be
used to exclude files that were previously included by the global
configuration. Effectively, if a local rule matches, the file is
excluded regardless of the global include settings.
.PP
The pattern logic in \`.snapraidignore\` mirrors the global configuration
but anchors patterns to the directory where the file is located:
.TP
.B FILE
Selects any file named FILE in this directory or below.
This follows the same globbing rules as the global pattern.
.TP
.B DIR/
Selects any directory named DIR and everything inside,
residing in this directory or below.
.TP
.B /PATH/FILE
Selects the exact specified file relative to the location
of the \`.snapraidignore\` file.
.TP
.B /PATH/DIR/
Selects the exact specified directory and everything inside,
relative to the location of the \`.snapraidignore\` file.
.PP
Unlike the global configuration, \`.snapraidignore\` files only support
exclusion rules; you cannot use \`include\` patterns or negation (!).
.PP
For example, if you have a \`.snapraidignore\` in \`/mnt/disk1/projects/\`:
.PP
.RS 4
# Excludes ONLY /mnt/disk1/projects/output.bin
.PD 0
.PP
.PD
/output.bin
.PD 0
.PP
.PD
# Excludes any directory named \'build\' inside projects/
.PD 0
.PP
.PD
build/
.PD 0
.PP
.PD
# Excludes any .tmp file inside projects/ or its subfolders
.PD 0
.PP
.PD
*.tmp
.PD 0
.PD
.RE
.SH CONTENT
SnapRAID stores the list and checksums of your files in the content file.
.PP

42
doc/snapraid.d
View file

@ -1413,6 +1413,48 @@ Pattern
In Unix, when using globbing characters on the command line, you must
quote them to prevent the shell from expanding them.
Ignore File
In addition to the global rules in the configuration file, you can
place `.snapraidignore` files in any directory within the array to
define decentralized exclusion rules.
Rules defined in `.snapraidignore` are applied after the rules in the
configuration file. This means they have a higher priority and can be
used to exclude files that were previously included by the global
configuration. Effectively, if a local rule matches, the file is
excluded regardless of the global include settings.
The pattern logic in `.snapraidignore` mirrors the global configuration
but anchors patterns to the directory where the file is located:
=FILE
Selects any file named FILE in this directory or below.
This follows the same globbing rules as the global pattern.
=DIR/
Selects any directory named DIR and everything inside,
residing in this directory or below.
=/PATH/FILE
Selects the exact specified file relative to the location
of the `.snapraidignore` file.
=/PATH/DIR/
Selects the exact specified directory and everything inside,
relative to the location of the `.snapraidignore` file.
Unlike the global configuration, `.snapraidignore` files only support
exclusion rules; you cannot use `include` patterns or negation (!).
For example, if you have a `.snapraidignore` in `/mnt/disk1/projects/`:
:# Excludes ONLY /mnt/disk1/projects/output.bin
:/output.bin
:# Excludes any directory named 'build' inside projects/
:build/
:# Excludes any .tmp file inside projects/ or its subfolders
:*.tmp
Content
SnapRAID stores the list and checksums of your files in the content file.

57
doc/snapraid.txt
View file

@ -1513,8 +1513,53 @@ In Unix, when using globbing characters on the command line, you must
quote them to prevent the shell from expanding them.
9 CONTENT
=========
9 IGNORE FILE
=============
In addition to the global rules in the configuration file, you can
place `.snapraidignore` files in any directory within the array to
define decentralized exclusion rules.
Rules defined in `.snapraidignore` are applied after the rules in the
configuration file. This means they have a higher priority and can be
used to exclude files that were previously included by the global
configuration. Effectively, if a local rule matches, the file is
excluded regardless of the global include settings.
The pattern logic in `.snapraidignore` mirrors the global configuration
but anchors patterns to the directory where the file is located:
FILE
Selects any file named FILE in this directory or below.
This follows the same globbing rules as the global pattern.
DIR/
Selects any directory named DIR and everything inside,
residing in this directory or below.
/PATH/FILE
Selects the exact specified file relative to the location
of the `.snapraidignore` file.
/PATH/DIR/
Selects the exact specified directory and everything inside,
relative to the location of the `.snapraidignore` file.
Unlike the global configuration, `.snapraidignore` files only support
exclusion rules; you cannot use `include` patterns or negation (!).
For example, if you have a `.snapraidignore` in `/mnt/disk1/projects/`:
# Excludes ONLY /mnt/disk1/projects/output.bin
/output.bin
# Excludes any directory named 'build' inside projects/
build/
# Excludes any .tmp file inside projects/ or its subfolders
*.tmp
10 CONTENT
==========
SnapRAID stores the list and checksums of your files in the content file.
@ -1525,7 +1570,7 @@ This file is read and written by the `sync` and `scrub` commands and
read by the `fix`, `check`, and `status` commands.
10 PARITY
11 PARITY
=========
SnapRAID stores the parity information of your array in the parity
@ -1538,7 +1583,7 @@ These files are read and written by the `sync` and `fix` commands and
only read by the `scrub` and `check` commands.
11 ENCODING
12 ENCODING
===========
SnapRAID in Unix ignores any encoding. It reads and stores the
@ -1555,13 +1600,13 @@ redirect the console output to a file, the resulting file is always
in UTF-8 format.
12 COPYRIGHT
13 COPYRIGHT
============
This file is Copyright (C) 2025 Andrea Mazzoleni
13 SEE ALSO
14 SEE ALSO
===========
snapraid_log(1), rsync(1)