borg-placeholders(1) borg backup tool borg-placeholders(1)

borg-placeholders - متغیرهای جایگزین در نام‌گذاری و قالب‌بندی Borg

آدرس‌های URL مخزن (یا بایگانی)، مقادیر --prefix، --glob-archives، --comment و --remote-path از این متغیرهای جایگزین پشتیبانی می‌کنند:

{hostname}
نام میزبان (کوتاه) دستگاه.
{fqdn}
نام کامل دستگاه (FQDN).
{reverse-fqdn}
نام کامل دستگاه با نشانه‌گذاری معکوس نام دامنه.
{now}
تاریخ و زمان محلی فعلی، به‌طور پیش‌فرض در قالب ISO-8601. همچنین می‌توانید رشته قالب‌بندی دلخواه خود را مشخص کنید https://docs.python.org/3.10/library/datetime.html#strftime-and-strptime-behavior، مانند {now:%Y-%m-%d_%H:%M:%S}
{utcnow}
تاریخ و زمان فعلی بر حسب UTC، به‌طور پیش‌فرض در قالب ISO-8601. همچنین می‌توانید رشته قالب‌بندی دلخواه خود را مشخص کنید https://docs.python.org/3.10/library/datetime.html#strftime-and-strptime-behavior، مانند {utcnow:%Y-%m-%d_%H:%M:%S}
{user}
نام کاربری (یا UID در صورتی که نامی در دسترس نباشد) کاربری که borg را اجرا می‌کند.
{pid}
شناسه فرایند فعلی (PID).
{borgversion}
نسخه borg، مانند: 1.0.8rc1
{borgmajor}
نسخه borg، فقط بخش اصلی نسخه (major)، مانند: 1
{borgminor}
نسخه borg، فقط بخش اصلی و فرعی نسخه (major و minor)، مانند: 1.0
{borgpatch}
نسخه borg، فقط نسخه اصلی، فرعی و وصله (patch)، مانند: 1.0.8

اگر نیاز است از آکولادهای واقعی استفاده شود، آن‌ها را برای گریز (escaping) دو بار بنویسید:

borg create /path/to/repo::{{literal_text}}

مثال‌ها:

borg create /path/to/repo::{hostname}-{user}-{utcnow} ...
borg create /path/to/repo::{hostname}-{now:%Y-%m-%d_%H:%M:%S} ...
borg prune --glob-archives '{hostname}-*' ...

نکته:

نرم‌افزار systemd از یک نحو دشوار و غیر استاندارد برای خطوط فرمان در فایل‌های واحد (unit files) استفاده می‌کند (به صفحه راهنمای systemd.unit(5) مراجعه کنید).

هنگام فراخوانی borg از فایل‌های واحد، به گریز (escaping) توجه ویژه‌ای داشته باشید، به‌خصوص هنگام استفاده از متغیرهای جایگزین now/utcnow، زیرا systemd فرآیند جایگزینی متغیرهای مبتنی بر % را حتی در متون داخل نقل‌قول انجام می‌دهد. برای جلوگیری از تداخل systemd، تمام علامت‌های درصد را دو برابر کنید ({hostname}-{now:%Y-%m-%d_%H:%M:%S} به {hostname}-{now:%%Y-%%m-%%d_%%H:%%M:%%S} تبدیل می‌شود).

The Borg Collective

2026-07-18