.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-save" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup-save \- ذخیره یک درخت دایرکتوری در مخزن bup
.SH "خلاصه دستور (SYNOPSIS)"
bup save [\-r \f[I]host\f[R]:\f[I]path\f[R]] <\-t|\-c|\-n
\f[I]name\f[R]> [\-#] [\-f \f[I]indexfile\f[R]] [\-v] [\-q]
[\-\-smaller=\f[I]maxsize\f[R]] <paths\&...>;
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]bup save\f[R] محتویات فایل‌ها یا مسیرهای داده‌شده را در یک
مجموعه پشتیبان جدید ذخیره می‌کند و به‌صورت اختیاری روی آن مجموعه پشتیبان نام‌گذاری انجام می‌دهد.
.PP
توجه داشته باشید که برای ارجاع به مجموعه پشتیبان خود در آینده (مثلاً برای
بازیابی)، باید یا گزینه \f[CR]\-\-name\f[R] را مشخص کنید (حالت معمول)، یا شناسه درخت
(tree id) یا شناسه کامیت (commit id) چاپ‌شده توسط \f[CR]\-\-tree\f[R] یا
\f[CR]\-\-commit\f[R] را ذخیره نمایید.
.PP
پیش از اقدام به ذخیره فایل‌ها با استفاده از \f[CR]bup save\f[R]، ابتدا باید نمایه
را با استفاده از \f[CR]bup index\f[R] به‌روزرسانی کنید.
دلایل تفکیک این دو مرحله در صفحه راهنمای
\f[CR]bup\-index\f[R](1) شرح داده شده است.
.PP
به‌طور پیش‌فرض، متاداده برای هر مسیر ذخیره می‌شود، و متاداده برای هر
دایرکتوری والد نمایه‌نشده از مسیرهای دارای نمایه، مستقیماً از سیستم‌فایل برداشته خواهد شد.
با این حال، اگر \f[CR]\-\-strip\f[R]، \f[CR]\-\-strip\-path\f[R]، یا
\f[CR]\-\-graft\f[R] مشخص شده باشد، متاداده برای دایرکتوری ریشه
(\f[I]/\f[R]) ذخیره نخواهد شد.
برای اطلاعات بیشتر در مورد مدیریت متاداده‌ها، \f[CR]bup\-restore\f[R](1) را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-r, \-\-remote=[\f[I]user\f[R]\(at]\f[I]host\f[R]:[\f[I]path\f[R]], \-\-remote=URL
داده‌ها را در مخزن دوردست مشخص‌شده ذخیره می‌کند، به‌طور پیش‌فرض از طریق SSH.
برای اطلاعات بیشتر به بخش REMOTE OPTIONS در bup(1) مراجعه کنید.
.TP
\-t, \-\-tree
پس از ایجاد مجموعه پشتیبان، شناسه درخت گیت (git tree id) نسخه پشتیبان حاصل را چاپ می‌کند.
.TP
\-c, \-\-commit
پس از ایجاد مجموعه پشتیبان، شناسه کامیت گیت (git commit id) نسخه پشتیبان حاصل را چاپ می‌کند.
.TP
\-n, \-\-name=\f[I]name\f[R]
پس از ایجاد مجموعه پشتیبان، یک شاخه گیت با نام \f[I]name\f[R] ایجاد می‌کند
تا بتوان با استفاده از آن نام به پشتیبان دسترسی پیدا کرد.
اگر \f[I]name\f[R] از قبل وجود داشته باشد، پشتیبان جدید به‌عنوان فرزندی از \f[I]name\f[R] قدیمی در نظر گرفته می‌شود.
(بنابراین، می‌توانید مرتباً مجموعه‌های پشتیبان جدیدی با همان نام ایجاد کنید،
و بعداً تاریخچه آن مجموعه پشتیبان را بررسی کنید تا ببینید فایل‌ها در طول زمان چگونه تغییر کرده‌اند.)
.TP
\-d, \-\-date=\f[I]date\f[R]
تاریخ پشتیبان‌گیری را برحسب ثانیه‌های گذشته از مبدأ زمان (epoch)، به‌جای زمان کنونی مشخص می‌کند.
.TP
\-f, \-\-indexfile=\f[I]indexfile\f[R]
استفاده از یک نام فایل نمایه متفاوت به‌جای \f[CR]$BUP_DIR/bupindex\f[R].
.TP
\-v, \-\-verbose
افزایش پرگویی گزارش رویدادها (می‌توان بیش از یک بار از آن استفاده کرد).
با یک بار استفاده از \-v، نام هر دایرکتوری هنگام پشتیبان‌گیری چاپ می‌شود.
با دو بار استفاده از \-v، نام تمامی فایل‌ها نیز چاپ خواهد شد.
.TP
\-q, \-\-quiet
غیرفعال کردن پیام‌های پیشرفت کار.
.TP
\-\-smaller=\f[I]maxsize\f[R]
از فایل‌هایی با اندازه بزرگ‌تر یا مساوی \f[I]maxsize\f[R] بایت پشتیبان‌گیری نمی‌کند.
می‌توانید از این گزینه برای پشتیبان‌گیری افزایشی متناوب و سریع از فایل‌های کوچک خود
استفاده کنید، و فایل‌های بزرگی (مانند ایمیج‌های ماشین مجازی) را که زمان بیشتری می‌برند نادیده بگیرید.
سپس می‌توانید از فایل‌های بزرگ در فواصل زمانی طولانی‌تری پشتیبان تهیه کنید.
برای مشخص کردن مضارب ۱۰۲۴، ۱۰۲۴*۱۰۲۴، یا ۱۰۲۴*۱۰۲۴*۱۰۲۴ به‌ترتیب از پسوندهایی مانند k، M یا G استفاده کنید.
.TP
\-\-bwlimit=\f[I]bytes/sec\f[R]
بیش از \f[I]bytes/sec\f[R] بایت در ثانیه به سرور ارسال نمی‌کند.
این گزینه برای جلوگیری از مصرف تمام پهنای باند شبکه شما توسط فرآیند پشتیبان‌گیری مناسب است.
برای مشخص کردن مضارب ۱۰۲۴، ۱۰۲۴*۱۰۲۴، یا ۱۰۲۴*۱۰۲۴*۱۰۲۴ به‌ترتیب از پسوندهایی مانند k، M یا G استفاده کنید.
.TP
\-\-strip
مسیر داده‌شده را از تمامی فایل‌ها و دایرکتوری‌ها می‌پیراید (حذف می‌کند).
.RS
یک دایرکتوری \f[I]/root/chroot/etc\f[R] که با \(lqbup save \-n
chroot \-\-strip /root/chroot\(rq ذخیره شده باشد، به‌صورت \f[I]/etc\f[R] ذخیره خواهد شد.
توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه
(\f[I]/\f[R]) ذخیره نخواهد شد.
.RE
.TP
\-\-strip\-path=\f[I]path\-prefix\f[R]
پیشوند مسیر داده‌شده \f[I]path\-prefix\f[R] را از تمامی فایل‌ها و دایرکتوری‌ها حذف می‌کند.
.RS
یک دایرکتوری \f[I]/root/chroot/webserver/etc\f[R] که با \(lqbup save
\-n webserver \-\-strip\-path=/root/chroot
/root/chroot/webserver/etc\(rq ذخیره شده باشد، به‌صورت
\f[I]/webserver/etc\f[R] ذخیره خواهد شد.
توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه
(\f[I]/\f[R]) ذخیره نخواهد شد.
.RE
.TP
\-\-graft=\f[I]old_path\f[R]=\f[I]new_path\f[R]
یک نقطه پیوند \f[I]old_path\f[R]=\f[I]new_path\f[R] تعیین می‌کند (می‌تواند بیش از یک بار استفاده شود).
.RS
یک دایرکتوری \f[I]/root/chroot/a/etc\f[R] که با \(lqbup save \-n
chroot \-\-graft /root/chroot/a=/chroot/a\(rq ذخیره شده باشد، به‌صورت
\f[I]/chroot/a/etc\f[R] ذخیره خواهد شد.
توجه داشته باشید که در حال حاضر، هنگام مشخص شدن این گزینه، متاداده برای دایرکتوری ریشه
(\f[I]/\f[R]) ذخیره نخواهد شد.
.RE
.TP
\-\f[I]#\f[R], \-\-compress=\f[I]#\f[R]
سطح فشرده‌سازی را روی # تنظیم می‌کند (مقداری از ۰ تا ۹، که ۹ بالاترین سطح و ۰ بدون فشرده‌سازی است).
پیش‌فرض بر روی pack.compression یا core.compression پیکربندی‌شده، یا ۱ (فشرده‌سازی سریع و سبک) است.
.SH "تنظیمات (SETTINGS)"
دستور \f[CR]bup save\f[R] از گزینه پیکربندی \f[CR]bup.split.trees\f[R] تبعیت می‌کند
(صفحه راهنمای \f[CR]bup\-config(5)\f[R] را ببینید).
توجه داشته باشید که این گزینه باید در مخزنی که در حال نوشتن روی آن است تنظیم شود؛ بنابراین برای مثال،
در مخزن \f[CR]BUP_DIR\f[R] یا مخزن تعیین‌شده با \f[CR]\-d\f[R] برای
\f[CR]bup save ...\f[R] بدون \f[CR]\-r\f[R]، و در مخزن دوردست برای
\f[CR]bup save \-r ...\f[R].
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
$ bup index \-ux /etc
Indexing: 1981, done.

$ bup save \-r myserver: \-n my\-pc\-backup \-\-bwlimit=50k /etc
Reading index: 1981, done.
Saving: 100.00% (998/998k, 1981/1981 files), done.



$ ls /home/joe/chroot/httpd
bin var

$ bup index \-ux /home/joe/chroot/httpd
Indexing: 1337, done.

$ bup save \-\-strip \-n joes\-httpd\-chroot /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joes\-httpd\-chroot/latest/
bin/
var/


$ bup save \-\-strip\-path=/home/joe/chroot \-n joes\-chroot \(rs
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joes\-chroot/latest/
httpd/


$ bup save \-\-graft /home/joe/chroot/httpd=/http\-chroot \(rs
     \-n joe
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joe/latest/
http\-chroot/
.EE
.SH "همچنین ببینید (SEE ALSO)"
\f[CR]bup\-index\f[R](1), \f[CR]bup\-split\f[R](1),
\f[CR]bup\-on\f[R](1), \f[CR]bup\-restore\f[R](1),
\f[CR]ssh_config\f[R](5)
.SH "درباره BUP (BUP)"
بخشی از مجموعه \f[CR]bup\f[R](1).
.SH "نویسندگان (AUTHORS)"
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.