'\" t
.\"     Title: snapper-backup-configs
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2025-10-13
.\"    Manual: Filesystem Snapshot Management
.\"    Source: 0.13.1
.\"  Language: Persian
.\"
.TH "SNAPPER\-BACKUP\-CON" "5" "2025\-10\-13" "0\&.13\&.1" "Filesystem Snapshot Management"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
snapper-backup-configs \- فایل‌های پیکربندی برای پشتیبان‌گیری اسنپر
.SH "شرح (DESCRIPTION)"
.PP
هر فایل
/etc/snapper/backup\-configs/*\&.json
یک پیکربندی پشتیبان‌گیری
.B snapper
را توصیف می‌کند\&.
.PP
این فایل از نحو JSON شامل یک شیء واحد با جفت‌های کلید\-مقدار استفاده می‌کند\&.
.SH "جفت‌های کلید\-مقدار (KEY VALUE PAIRS)"
.PP
در ادامه فهرستی از کلیدهایی که می‌توانند در فایل پیکربندی وجود داشته باشند آمده است\&.
.PP
\fBconfig\fR
.RS 4
نام پیکربندی
.BR snapper \&.
.RE
.PP
\fBtarget\-mode\fR
.RS 4
یا
.B local
یا
.BR ssh\-push \&.
.RE
.PP
\fBsource\-path\fR
.RS 4
مسیر زیرحجم (subvolume) مبدا\&. این مسیر باید با زیرحجم پیکربندی متناظر در
.B snapper
همخوانی داشته باشد\&.
.RE
.PP
\fBtarget\-path\fR
.RS 4
مسیر زیرحجم یا نقطه اتصال (mount point) مقصد\&.
.RE
.PP
\fBautomatic\fR
.RS 4
مقدار بولی (Boolean) برای فعال‌سازی انتقال و حذف خودکار برای پیکربندی پشتیبان‌گیری با استفاده از سرویس تایمر
.BR systemd \&.
.RE
.PP
\fBssh\-host\fR
.RS 4
نام میزبان مقصد\&. برای حالت مقصد
.B ssh\-push
الزامی است\&.
.RE
.PP
\fBssh\-port\fR
.RS 4
درگاه میزبان مقصد\&. برای حالت مقصد
.B ssh\-push
اختیاری است\&.
.RE
.PP
\fBssh\-user\fR
.RS 4
کاربر روی میزبان مقصد\&. برای حالت مقصد
.B ssh\-push
اختیاری است\&.
.RE
.PP
\fBssh\-identity\fR
.RS 4
یک هویت ssh (شناسه ssh-identity) برای دسترسی به میزبان بدون نیاز به گذرواژه یا عبارت عبور\&. برای حالت مقصد
.B ssh\-push
اختیاری است\&.
.RE
.PP
\fBsend\-compressed\-data\fR
.RS 4
به‌طور پیش‌فرض
.B snbk
در صورتی که سیستم مبدا و مقصد پشتیبانی کنند گزینه
.B \-\-compressed\-data
را اضافه می‌کند\&. با تنظیم این مقدار روی
.B false
می‌توان آن را غیرفعال کرد\&.
.RE
.PP
\fBsend\-options\fR
.RS 4
گزینه‌های اضافی برای دستور
.B btrfs send
به‌صورت آرایه‌ای از رشته‌ها\&. اختیاری است\&.
.sp
به‌طور پیش‌فرض
.B snbk
در صورتی که هر دو مبدا و مقصد پشتیبانی کنند به‌طور خودکار
.B \-\-proto
و
.B \-\-compressed\-data
را اضافه می‌کند\&.
.RE
.PP
\fBreceive\-options\fR
.RS 4
گزینه‌های اضافی برای دستور
.B btrfs receive
به‌صورت آرایه‌ای از رشته‌ها\&. اختیاری است\&.
.RE
.PP
\fBtarget\-btrfs\-bin\fR
.RS 4
محل فایل اجرایی
.B btrfs
روی مقصد\&. همچنین می‌تواند برای نصب اسکریپت‌های پوششی (wrapper scripts) استفاده شود\&. اختیاری است\&.
.RE
.PP
\fBtarget\-ls\-bin\fR
.RS 4
محل فایل اجرایی
.B ls
روی مقصد\&. همچنین می‌تواند برای نصب اسکریپت‌های پوششی استفاده شود\&. اختیاری است\&.
.RE
.PP
\fBtarget\-mkdir\-bin\fR
.RS 4
محل فایل اجرایی
.B mkdir
روی مقصد\&. همچنین می‌تواند برای نصب اسکریپت‌های پوششی استفاده شود\&. اختیاری است\&.
.RE
.PP
\fBtarget\-rm\-bin\fR
.RS 4
محل فایل اجرایی
.B rm
روی مقصد\&. همچنین می‌تواند برای نصب اسکریپت‌های پوششی استفاده شود\&. اختیاری است\&.
.RE
.PP
\fBtarget\-rmdir\-bin\fR
.RS 4
محل فایل اجرایی
.B rmdir
روی مقصد\&. همچنین می‌تواند برای نصب اسکریپت‌های پوششی استفاده شود\&. اختیاری است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
یک نمونه پیکربندی برای پشتیبان‌گیری‌های محلی:
.sp
.if n \{\
.RS 4
.\}
.nf
{
    "config": "root",
    "target\-mode": "local",
    "automatic": true,
    "source\-path": "/",
    "target\-path": "/backups/root"
}

.fi
.if n \{\
.RE
.\}
.PP
یک نمونه پیکربندی برای پشتیبان‌گیری‌های از راه دور از طریق ssh\-push:
.sp
.if n \{\
.RS 4
.\}
.nf
{
    "config": "root",
    "target\-mode": "ssh\-push",
    "automatic": false,
    "source\-path": "/",
    "target\-path": "/backups/eberich/root",
    "ssh\-host": "backups\&.example\&.com",
    "ssh\-identity": "/etc/snapper/certs/id_ecdsa"
}

.fi
.if n \{\
.RE
.\}
.sp
.SH "صفحه خانگی (HOMEPAGE)"
.PP
\m[blue]\fBhttp://snapper\&.io\fR\m[]
.SH "نویسندگان (AUTHORS)"
.PP
Arvin Schnell
<aschnell@suse\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsnbk\fR(8),
\fBsnapper\fR(8)