نام (NAME)

borg-patterns - جزئیات مربوط به الگوهای تطبیق در بورگ

توضیحات (DESCRIPTION)

نام‌ها و مسیرهای پرونده‌هایی که به عنوان ورودی برای تطبیق الگو استفاده می‌شوند، با ریشه بازگشت (recursion root) فعال فعلی آغاز می‌گردند. شما معمولاً ریشه(های) بازگشت را هنگام فراخوانی borg مشخص می‌کنید و این‌ها می‌توانند مسیرهای نسبی یا مطلق باشند.

دقت کنید، الگوهای شما باید با مسیرهای بایگانی‌شده مطابقت داشته باشند:

الگوی استثنا کردن شاخه (دایرکتوری) می‌تواند با یک اسلش ('/') ختم شود یا نشود. اگر با اسلش ختم شود (مانند some/path/)، خود شاخه گنجانده می‌شود اما محتویات آن مستثنی می‌گردند. اگر با اسلش ختم نشود (مانند some/path)، هم خود شاخه و هم محتویات آن مستثنی خواهند شد.

بورگ از سبک‌های مختلف الگو پشتیبانی می‌کند. برای تعیین سبکی غیر از پیش‌فرض برای یک الگوی خاص، دو نویسه به همراه دونقطه ':' را به عنوان پیشوند قرار دهید (مانند fm:path/* یا sh:path/**).

سبک الگوی پیش‌فرض برای --exclude با --pattern متفاوت است؛ توضیحات زیر را ببینید.

نکته:

استثناها را می‌توان از طریق گزینه خط فرمان --exclude وارد کرد. هنگام استفاده در محیط پوسته (شل)، الگوها باید داخل علامت نقل‌قول قرار گیرند تا از بسط آن‌ها جلوگیری شود.

الگوهای دارای نویسه‌های خاص، مثلاً فاصله خالی (space)، ممکن است نیازمند قرار گرفتن در علامت نقل‌قول باشند. مثال: در bash، گزینه خط فرمان زیر با "item name" مطابقت یافته و آن را مستثنی می‌کند: --pattern='-path/item name' توجه داشته باشید هنگامی که الگوها در پرونده الگویی که مستقیماً توسط بورگ خوانده می‌شود قرار دارند (مثلاً با استفاده از --exclude-from یا --patterns-from)، پای پوسته در میان نیست و نیازی به نقل‌قول نیست.

گزینه --exclude-from امکان بارگذاری الگوهای استثنا را از یک پرونده متنی به صورت یک الگو در هر سطر فراهم می‌آورد. سطرهای خالی یا سطرهایی که پس از حذف فاصله‌های ابتدا و انتها با علامت ('#') شروع می‌شوند، نادیده گرفته می‌شوند. پیشوند اختیاری انتخاب سبک نیز در پرونده‌ها پشتیبانی می‌شود. به دلیل حذف فواصل خالی، مسیرهایی با فاصله در ابتدا یا انتها فقط با عبارات باقاعده قابل استثنا هستند.

برای آزمایش الگوهای استثنای خود بدون انجام پشتیبان‌گیری واقعی می‌توانید دستور borg create --list --dry-run ... را اجرا کنید.

مثال‌ها:

# استثنا کردن شاخه‌ای در هر کجای درخت با نام steamapps/common (و زیرمجموعه‌های آن):
$ borg create -e 'sh:**/steamapps/common/**' backup /
# استثنا کردن محتویات /home/user/.cache:
$ borg create -e 'sh:home/user/.cache/**' backup /home/user
$ borg create -e home/user/.cache/ backup /home/user
# پرونده /home/user/.cache/important پشتیبان‌گیری نمی‌شود:
$ borg create -e home/user/.cache/ backup / /home/user/.cache/important
# استثنا کردن /home/user/file.o اما نه /home/user/file.odt:
$ borg create -e '*.o' backup /
# استثنا کردن junk در home/user و زیرشاخه‌های آن:
$ borg create -e 'home/*/junk' backup /
# استثنا کردن محتویات شاخه‌هایی در home که به tmp. ختم می‌شوند:
$ borg create --exclude 're:^home/[^/]+\.tmp/' backup /
# بارگذاری الگوهای استثنا از پرونده
$ cat >exclude.txt <<EOF
# سطر توضیحات
home/*/junk
*.tmp
fm:aa:something/*
re:^home/[^/]+\.tmp/
sh:home/*/.thumbnails
# مثال با فاصله، نیازی به اسکیپ نیست
some file with spaces.txt
EOF
$ borg create --exclude-from exclude.txt backup /

روش عمومی‌تر و ساده‌تری برای تعریف الگوهای تطبیق پرونده از طریق گزینه‌های --pattern و --patterns-from وجود دارد. با استفاده از این‌ها، می‌توانید ریشه‌های پشتیبان‌گیری، سبک‌های الگوی پیش‌فرض و الگوهای شمول و استثنا را تعیین کنید.

نکته:

نخستین الگوی منطبق اعمال می‌شود؛ بنابراین اگر یک الگوی شمول پیش از یک الگوی استثنا تطبیق یابد، از پرونده پشتیبان تهیه می‌شود. توجه داشته باشید که استثنای بدون بازگشت بررسی زیرشاخه‌ها را متوقف می‌کند به گونه‌ای که موارد شمول احتمالی درون آن‌ها نیز تطبیق نخواهند یافت؛ برای چنین مواردی از استثناهای عادی استفاده کنید.

مثال:

# تعریف ریشه بازگشت
R /
# استثنا کردن تمام پرونده‌های iso در هر شاخه‌ای
- **/*.iso
# شمول صریح تمام محتویات etc و root
+ etc/**
+ root/**
# استثنا کردن شاخه‌ای مشخص در شاخه خانگی هر کاربر
- home/*/.cache
# شمول صریح تمام محتویات /home
+ home/**
# استثنای صریح برخی شاخه‌ها بدون پیمایش زیرشاخه‌های آنها
! re:^(dev|proc|run|sys|tmp)
# استثنا کردن سایر پرونده‌ها و شاخه‌ها
# که پیش‌تر به صورت صریح گنجانده نشده‌اند.
- **

نکته:

توجه داشته باشید که سبک پیش‌فرض الگو برای --pattern و --patterns-from سبک پوسته (sh:) است، بنابراین عملکرد آن‌ها مشابه الگوهای include/exclude در rsync است. این سبک با پیشوند P قابل تنظیم است.

الگوها (--pattern) و استثناها (--exclude) از خط فرمان اولویت اول را دارند (به ترتیبی که وارد شده‌اند). سپس الگوهای برگرفته از --patterns-from اضافه می‌شوند. در نهایت، الگوهای استثنای پرونده‌های --exclude-from اضافه می‌گردند.

مثال‌ها:

# پشتیبان‌گیری از تصاویر، به جز موارد سال ۲۰۱۸، مگر عکس‌های منتخب:
# توجه: استفاده از = برای جلوگیری از مشکلات پردازش آرگومان خط فرمان ضروری است.
borg create --pattern=+pics/2018/good --pattern=-pics/2018 repo::arch pics
# استفاده از پرونده حاوی الگوها:
borg create --patterns-from patterns.lst repo::arch

پرونده patterns.lst می‌تواند به شکل زیر باشد:

# سبک "sh:" پیش‌فرض است، بنابراین سطر زیر الزامی نیست:
P sh
R /
# می‌توان مجدداً ایجاد کرد
- home/*/.cache
# بارگیری‌ها نیازی به پشتیبان ندارند
- home/*/Downloads
# سوزان کاربر مهمی است
# خانه سوزان گنجانده شود
+ home/susan
# همچنین این پرونده خاص پشتیبان‌گیری شود
+ pf:home/bobby/specialfile.txt
# از شاخه‌های خانگی سایر کاربران پشتیبان گرفته نشود
- home/*
# اصلاً مسیر proc/ بررسی نشود
! proc

می‌توانید ریشه‌های بازگشت را در خط فرمان یا درون یک پرونده الگو مشخص کنید:

# این دو دستور عملکرد یکسانی دارند
borg create --exclude home/bobby/junk repo::arch /home/bobby /home/susan
borg create --patterns-from patternfile.lst repo::arch

نمونه پرونده الگو:

# توجه داشته باشید excludes به طور پیش‌فرض از fm: و پرونده‌های الگو از sh: استفاده می‌کنند.
# بنابراین برای داشتن رفتار کاملاً یکسان باید fm: را صریحاً ذکر کنیم.
P fm
R /home/bobby
R /home/susan
- home/bobby/junk

این قابلیت به شما امکان می‌دهد الگوهای یکسانی را بدون نیاز به بازنویسی در خط فرمان، میان چندین مخزن مختلف به اشتراک بگذارید.

نویسنده (AUTHOR)

The Borg Collective