'\" t
.\"     Title: snapper-configs
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2022-07-12
.\"    Manual: Filesystem Snapshot Management
.\"    Source: 0.13.1
.\"  Language: Persian
.\"
.TH "SNAPPER\-CONFIGS" "5" "2022\-07\-12" "0\&.13\&.1" "مدیریت اسنپ‌شات‌های فایل‌سیستم"
.\" -----------------------------------------------------------------
.\" * 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-configs \- فایل‌های پیکربندی برای تنظیمات snapper
.SH "توضیحات (DESCRIPTION)"
.PP
هر فایل در مسیر
/etc/snapper/configs/*
یک پیکربندی snapper را شرح می‌دهد\&.
.SH "متغیرها (VARIABLES)"
.PP
فهرست زیر متغیرهایی هستند که می‌توانند در فایل پیکربندی وجود داشته باشند\&. مقادیر بولی باید "yes" یا "no" باشند\&.
.PP
\fBSUBVOLUME=\fR\fB\fIpath\fR\fR
.RS 4
مسیر زیرحجم (subvolume) یا نقطه اتصال (mount point)\&.
.sp
مقدار پیش‌فرضی وجود ندارد\&. مقدار باید همیشه مشخص شود\&.
.RE
.PP
\fBFSTYPE=\fR\fB\fIvalue\fR\fR
.RS 4
نوع فایل‌سیستم برای زیرحجم\&.
.sp
مقدار پیش‌فرض "btrfs" است اما توصیه می‌شود نوع فایل‌سیستم همیشه مشخص شود\&.
.RE
.PP
\fBQGROUP=\fR\fB\fIqgroup\fR\fR
.RS 4
گروه سهمیه‌بندی (quota group) btrfs که برای الگوریتم‌های پاک‌سازی حساس به فضا استفاده می‌شود\&.
.sp
تنها در btrfs پشتیبانی می‌شود\&.
.RE
.PP
\fBSPACE_LIMIT=\fR\fB\fIfloat\fR\fR\fB or \fR\fB\fIsize\fR\fR
.RS 4
آستانه بیشینه فضایی که اسنپ‌شات‌ها می‌توانند روی فایل‌سیستم استفاده کنند\&. هنگامی که اسنپ‌شات‌ها از این حد فراتر روند (خواه کسری از کل فایل‌سیستم یا مقداری مطلق باشد)، snapper در جریان عملیات پاک‌سازی اسنپ‌شات‌های قدیمی‌تر را حذف خواهد کرد\&. مقدار مطلق باید از لوکال C استفاده کند\&.
.sp
تنها در btrfs پشتیبانی می‌شود\&.
.sp
مقدار پیش‌فرض "0\&.5" (۵۰٪ کل فایل‌سیستم) است\&.
.sp
از نسخه 0\&.3\&.0 اضافه شده، مقدار مطلق از نسخه 0\&.9\&.0 اضافه شده است\&.
.RE
.PP
\fBFREE_LIMIT=\fR\fB\fIfloat\fR\fR\fB or \fR\fB\fIsize\fR\fR
.RS 4
آستانه کمینه فضای خالی که باید روی فایل‌سیستم باقی بماند\&. هنگامی که فضای خالی به زیر این حد برسد (خواه کسری از کل فایل‌سیستم یا مقداری مطلق باشد)، snapper در جریان عملیات پاک‌سازی اسنپ‌شات‌های قدیمی‌تر را برای آزادسازی فضا حذف خواهد کرد\&. مقدار مطلق باید از لوکال C استفاده کند\&.
.sp
تنها در btrfs پشتیبانی می‌شود\&.
.sp
مقدار پیش‌فرض "0\&.2" (۲۰٪ کل فایل‌سیستم) است\&.
.sp
از نسخه 0\&.8\&.0 اضافه شده، مقدار مطلق از نسخه 0\&.9\&.0 اضافه شده است\&.
.RE
.PP
\fBALLOW_USERS=\fR\fB\fIusers\fR\fR
.RS 4
فهرستی از کاربرانی که مجاز به کار با این پیکربندی هستند\&. نام‌های کاربری باید با فاصله از هم جدا شوند\&. فاصله‌ها در نام‌های کاربری را می‌توان با یک "\e" اسکیپ کرد\&.
.sp
همچنین بخش PERMISSIONS را در
\fBsnapper\fR(8)
ببینید\&.
.sp
از استفاده از کاربران شبکه‌ای باید خودداری شود، زیرا در زمان قطعی شبکه می‌تواند اکثر دستورات از جمله rollback را مختل کند\&.
.sp
مقدار پیش‌فرض "" است اما کاربر "root" همیشه به صورت ضمنی گنجانده شده است\&.
.RE
.PP
\fBALLOW_GROUPS=\fR\fB\fIgroups\fR\fR
.RS 4
فهرستی از گروه‌هایی که مجاز به کار با این پیکربندی هستند\&. نام‌های گروه‌ها باید با فاصله از هم جدا شوند\&. فاصله‌ها در نام‌های گروه‌ها را می‌توان با یک "\e" اسکیپ کرد\&.
.sp
همچنین بخش PERMISSIONS را در
\fBsnapper\fR(8)
ببینید\&.
.sp
از استفاده از گروه‌های شبکه‌ای باید خودداری شود، زیرا در زمان قطعی شبکه می‌تواند اکثر دستورات از جمله rollback را مختل کند\&.
.sp
مقدار پیش‌فرض "" است\&.
.RE
.PP
\fBSYNC_ACL=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا snapper کاربران و گروه‌های موجود در ALLOW_USERS و ALLOW_GROUPS را با ACL دایرکتوری
\&.snapshots
همگام‌سازی کند یا خیر\&.
.sp
همچنین بخش PERMISSIONS را در
\fBsnapper\fR(8)
ببینید\&.
.sp
مقدار پیش‌فرض "no" است\&.
.sp
از نسخه 0\&.2\&.0 اضافه شده است\&.
.RE
.PP
\fBBACKGROUND_COMPARISON=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا اسنپ‌شات‌های pre و post پس از ایجاد در پس‌زمینه با یکدیگر مقایسه شوند یا خیر\&.
.sp
مقدار پیش‌فرض "yes" است\&.
.RE
.PP
\fBCOMPRESSION=\fR\fB\fIalgorithm\fR\fR
.RS 4
الگوریتم فشرده‌سازی مورد استفاده برای ذخیره فهرست فایل‌ها را مشخص می‌کند\&. مقادیر مجاز "none" و "gzip" هستند\&. بسته به کتابخانه‌های نصب‌شده، ممکن است برخی الگوریتم‌های فشرده‌سازی در دسترس نباشند\&.
.sp
مقدار پیش‌فرض "gzip" است\&.
.sp
از نسخه 0\&.10\&.1 اضافه شده است\&.
.RE
.PP
\fBNUMBER_CLEANUP=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا الگوریتم پاک‌سازی بر پایه تعداد (number cleanup) برای این پیکربندی اجرا شود یا خیر\&.
.sp
مقدار پیش‌فرض "no" است\&.
.RE
.PP
\fBNUMBER_MIN_AGE=\fR\fB\fIseconds\fR\fR
.RS 4
حداقل سن اسنپ‌شات‌ها بر حسب ثانیه جهت واجد شرایط بودن برای حذف توسط الگوریتم پاک‌سازی بر پایه تعداد\&.
.sp
مقدار پیش‌فرض "3600" است\&.
.RE
.PP
\fBNUMBER_LIMIT=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی بر پایه تعداد چه تعداد اسنپ‌شات را باید نگه دارد\&. جدیدترین اسنپ‌شات‌ها حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "50" است\&.
.RE
.PP
\fBNUMBER_LIMIT_IMPORTANT=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی بر پایه تعداد چه تعداد اسنپ‌شات مهم را باید نگه دارد\&. اسنپ‌شات‌های مهم در داده‌های کاربری (userdata) دارای important=yes هستند\&. جدیدترین اسنپ‌شات‌های مهم حفظ خواهند شد\&.
.sp
تعداد اسنپ‌شات‌های عادی و مهم به صورت مستقل شمرده می‌شود\&.
.sp
مقدار پیش‌فرض "10" است\&.
.sp
از نسخه 0\&.1\&.8 اضافه شده است\&.
.RE
.PP
\fBTIMELINE_CREATE=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا اسنپ‌شات‌های ساعتی ایجاد شوند یا خیر\&.
.sp
همراه با الگوریتم پاک‌سازی خط زمانی (timeline cleanup)، این گزینه مجموعه‌ای از اسنپ‌شات‌ها را می‌سازد که اسنپ‌شات‌های بیشتری در گذشته نزدیک و اسنپ‌شات‌های کمتری در گذشته دور قرار دارند\&.
.sp
مقدار پیش‌فرض "no" است\&.
.RE
.PP
\fBTIMELINE_CLEANUP=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا الگوریتم پاک‌سازی خط زمانی برای این پیکربندی اجرا شود یا خیر\&.
.sp
مقدار پیش‌فرض "no" است\&.
.RE
.PP
\fBTIMELINE_MIN_AGE=\fR\fB\fIseconds\fR\fR
.RS 4
حداقل سن اسنپ‌شات‌ها بر حسب ثانیه جهت واجد شرایط بودن برای حذف توسط الگوریتم پاک‌سازی خط زمانی\&.
.sp
مقدار پیش‌فرض "3600" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_HOURLY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات ساعتی را باید نگه دارد\&. اسنپ‌شات ساعتی اولین اسنپ‌شات در طول یک ساعت است\&. جدیدترین اسنپ‌شات‌های ساعتی حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "10" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_DAILY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات روزانه را باید نگه دارد\&. اسنپ‌شات روزانه اولین اسنپ‌شات در طول یک روز است\&. جدیدترین اسنپ‌شات‌های روزانه حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "10" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_WEEKLY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات هفتگی را باید نگه دارد\&. اسنپ‌شات هفتگی اولین اسنپ‌شات در طول یک هفته است\&. جدیدترین اسنپ‌شات‌های هفتگی حفظ خواهند شد\&. مطابق با استاندارد ISO 8601 هفته‌ها از دوشنبه آغاز می‌شوند\&.
.sp
مقدار پیش‌فرض "0" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_MONTHLY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات ماهانه را باید نگه دارد\&. اسنپ‌شات ماهانه اولین اسنپ‌شات در طول یک ماه است\&. جدیدترین اسنپ‌شات‌های ماهانه حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "10" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_QUARTERLY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات فصلی (سه‌ماهه) را باید نگه دارد\&. اسنپ‌شات فصلی اولین اسنپ‌شات در طول یک فصل است\&. جدیدترین اسنپ‌شات‌های فصلی حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "0" است\&.
.RE
.PP
\fBTIMELINE_LIMIT_YEARLY=\fR\fB\fInumber\fR\fR\fB or \fR\fB\fIrange\fR\fR
.RS 4
مشخص می‌کند که الگوریتم پاک‌سازی خط زمانی چه تعداد اسنپ‌شات سالانه را باید نگه دارد\&. اسنپ‌شات سالانه اولین اسنپ‌شات در طول یک سال است\&. جدیدترین اسنپ‌شات‌های سالانه حفظ خواهند شد\&.
.sp
مقدار پیش‌فرض "10" است\&.
.RE
.PP
\fBEMPTY_PRE_POST_CLEANUP=\fR\fB\fIboolean\fR\fR
.RS 4
مشخص می‌کند که آیا الگوریتم پاک‌سازی پیش/پس خالی (empty\-pre\-post) برای این پیکربندی اجرا شود یا خیر\&.
.sp
مقدار پیش‌فرض "no" است\&.
.RE
.PP
\fBEMPTY_PRE_POST_MIN_AGE=\fR\fB\fIseconds\fR\fR
.RS 4
حداقل سن اسنپ‌شات‌ها بر حسب ثانیه جهت واجد شرایط بودن برای حذف توسط الگوریتم پاک‌سازی پیش/پس خالی\&.
.sp
مقدار پیش‌فرض "3600" است\&.
.RE
.SH "انواع (TYPES)"
.PP
برخی از انواع مورد استفاده برای متغیرها شایسته توضیح هستند\&.
.PP
range
.RS 4
محدوده‌ای از اعداد که به صورت
\fImin\-value\fR\-\fImax\-value\fR، مانند "10\-20" مشخص می‌شود\&.
.RE
.PP
qgroup
.RS 4
یک qgroup مربوط به btrfs به شکل استاندارد
\fIlevel\fR\-\fIid\fR، مانند "1/0"\&.
.RE
.SH "نکات (NOTES)"
.PP
مقادیر پیش‌فرض ذکر شده در اینجا مقادیری هستند که snapper در صورت عدم وجود مدخل در فایل پیکربندی از آن‌ها استفاده می‌کند\&. برخی از آن‌ها با مقادیر موجود در الگوی فایل پیکربندی یکسان نیستند\&.
.SH "صفحه خانگی (HOMEPAGE)"
.PP
\m[blue]\fBhttp://snapper\&.io\fR\m[]
.SH "نویسندگان (AUTHORS)"
.PP
Arvin Schnell
<aschnell@suse\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsnapper\fR(8),
\fBsnapperd\fR(8)