.TH BUPSTASH-INIT 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-init \- مقداردهی اولیه و ایجاد یک مخزن bupstash
.SH "خلاصه دستور (SYNOPSIS)"
مقداردهی اولیه یک مخزن bupstash.
.PP
.B bupstash init
[\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B bupstash init
یک مخزن را مقداردهی اولیه می‌کند. اگر
.B REPOSITORY
از قبل وجود داشته باشد، دستور با خطا مواجه خواهد شد.
.PP
در حال حاضر استفاده از bupstash روی سیستم‌فایل‌های تحت شبکه توصیه نمی‌شود.
.PP
برای جزئیات درباره محتویات مخزن بسته پس از مقداردهی اولیه، به
.BR bupstash\-repository (7)
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-r ", " \-\-repository " " \fIREPO\fR
مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh، برای مخازن راه دور می‌تواند به شکل
.B ssh://$SERVER/$PATH
باشد. اگر مشخص نشود، از متغیر
.B BUPSTASH_REPOSITORY
استفاده می‌شود.
.TP
.BR \-\-storage " " \fISPEC\fR
مقدار 'dir' یا مشخصات ذخیره‌سازی json را می‌پذیرد. حالت پیش‌فرض ذخیره‌سازی 'dir' است و بلوک‌های داده رمزگذاری‌شده را در دایرکتوری محلی داده مخزن ذخیره می‌کند.
.IP
برای مشخصات json پشتیبانی‌شده و مثال‌ها، بخش مشخصات ذخیره‌سازی JSON را مشاهده کنید.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B BUPSTASH_REPOSITORY
مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh، برای مخازن راه دور می‌تواند به شکل
.B ssh://$SERVER/$PATH
باشد.
.TP
.B BUPSTASH_REPOSITORY_COMMAND
دستوری که برای اتصال به یک نمونه از
.BR bupstash\-serve (1)
اجرا می‌شود. این متغیر امکان برقراری ارتباطات پیچیده‌تر با مخزن را برای موارد کاربرد کمتر متداول فراهم می‌کند.
.SH "مثال‌ها (EXAMPLES)"
.nf
$ export BUPSTASH_REPOSITORY=\./my\-repository
$ bupstash init

$ export BUPSTASH_REPOSITORY=ssh://$SERVER/home/backups/bupstash\-backups
$ bupstash init
.fi
.SH "مشخصات ذخیره‌سازی JSON (JSON STORAGE SPECS)"
هر مشخصه ذخیره‌سازی از یک شناسه نوع و مجموعه‌ای از پارامترهای خاص آن نوع تشکیل شده است.
.SS "ذخیره‌سازی دایرکتوری (Dir storage)"
ذخیره‌سازی Dir نام مستعاری برای
.B \-\-storage dir
است و عموماً نیازی به استفاده صریح از آن نیست.
.PP
مثال:
.IP "" 4
.nf
$ bupstash init \-\-storage '{"Dir" : {}}'
.fi
.IP "" 0
.SS "ذخیره‌سازی خارجی (External storage)"
موتور ذخیره‌سازی خارجی داده‌ها را از طریق یک سوکت خارجی ذخیره می‌کند؛ مستندات آن در انتظار پایدار شدن رابط برنامه‌نویسی است.
.PP
مثال:
.IP "" 4
.nf
$ bupstash init \-\-storage '{"External" : {"socket_path" : "/plugin/socket\.sock", "path" : "plugin\-specific\-path"}}'
.fi
.IP "" 0
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-repository (7)