BUPSTASH-INIT(1) User Commands BUPSTASH-INIT(1)

bupstash-init - مقداردهی اولیه و ایجاد یک مخزن bupstash

مقداردهی اولیه یک مخزن bupstash.

bupstash init [گزینه‌ها]

دستور bupstash init یک مخزن را مقداردهی اولیه می‌کند. اگر REPOSITORY از قبل وجود داشته باشد، دستور با خطا مواجه خواهد شد.

در حال حاضر استفاده از bupstash روی سیستم‌فایل‌های تحت شبکه توصیه نمی‌شود.

برای جزئیات درباره محتویات مخزن بسته پس از مقداردهی اولیه، به bupstash-repository(7) مراجعه کنید.

مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh، برای مخازن راه دور می‌تواند به شکل ssh://$SERVER/$PATH باشد. اگر مشخص نشود، از متغیر BUPSTASH_REPOSITORY استفاده می‌شود.
مقدار 'dir' یا مشخصات ذخیره‌سازی json را می‌پذیرد. حالت پیش‌فرض ذخیره‌سازی 'dir' است و بلوک‌های داده رمزگذاری‌شده را در دایرکتوری محلی داده مخزن ذخیره می‌کند.
برای مشخصات json پشتیبانی‌شده و مثال‌ها، بخش مشخصات ذخیره‌سازی JSON را مشاهده کنید.

مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh، برای مخازن راه دور می‌تواند به شکل ssh://$SERVER/$PATH باشد.
دستوری که برای اتصال به یک نمونه از bupstash-serve(1) اجرا می‌شود. این متغیر امکان برقراری ارتباطات پیچیده‌تر با مخزن را برای موارد کاربرد کمتر متداول فراهم می‌کند.

$ export BUPSTASH_REPOSITORY=./my-repository
$ bupstash init
$ export BUPSTASH_REPOSITORY=ssh://$SERVER/home/backups/bupstash-backups
$ bupstash init

هر مشخصه ذخیره‌سازی از یک شناسه نوع و مجموعه‌ای از پارامترهای خاص آن نوع تشکیل شده است.

ذخیره‌سازی Dir نام مستعاری برای --storage dir است و عموماً نیازی به استفاده صریح از آن نیست.

مثال:

$ bupstash init --storage '{"Dir" : {}}'

موتور ذخیره‌سازی خارجی داده‌ها را از طریق یک سوکت خارجی ذخیره می‌کند؛ مستندات آن در انتظار پایدار شدن رابط برنامه‌نویسی است.

مثال:

$ bupstash init --storage '{"External" : {"socket_path" : "/plugin/socket.sock", "path" : "plugin-specific-path"}}'

bupstash(1), bupstash-repository(7)

2026-09-01 bupstash