'\" t .\" Title: pam_snapper .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2013-05-23 .\" Manual: Filesystem Snapshot Management .\" Source: 0.13.1 .\" Language: Persian .\" .TH "PAM_SNAPPER" "8" "2013\-05\-23" "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)" pam_snapper \- ماژول PAM جهت ایجاد اسنپ‌شات‌های سیستم‌فایل از طریق snapper .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBpam_snapper\&.so\fR\ 'u \fBpam_snapper\&.so\fR [debug] [homeprefix=\fIprefix\fR] [ignoreservices=\fIservices\fR] [ignoreusers=\fIusers\fR] [rootasroot] [ignoreroot] [openonly] [closeonly] [cleanup=\fIalgorithm\fR] .SH "توضیحات (DESCRIPTION)" .PP در هر بار ورود کاربر یک اسنپ‌شات ایجاد می‌کند، تا کاربران همواره یک نقطه شروع امن در اختیار داشته باشند\&. .PP از آنجا که بسیاری از کاربران برای مدتی طولانی از سیستم خارج نمی‌شوند، پیشنهاد می‌شود علاوه بر این، اسنپ‌شات‌های مبتنی بر زمان snapper را نیز فعال کنید\&. .SH "گزینه‌ها (OPTIONS)" .PP \fBdebug\fR .RS 4 فعال‌سازی حالت اشکال‌زدایی (debugging) در ماژول\&. .RE .PP \fBhomeprefix=\fR\fB\fIprefix\fR\fR .RS 4 پیشوند برای نام پیکربندی snapper\&. نام کاربری به انتهای این پیشوند افزوده خواهد شد\&. .sp پیش‌فرض: "home_" .RE .PP \fBignoreservices=\fR\fB\fIcomma separated list of services\fR\fR .RS 4 فهرستی از سرویس‌های جداشده با کاما که باید نادیده گرفته شوند\&. .sp پیش‌فرض: "crond" .RE .PP \fBignoreusers=\fR\fB\fIcomma separated list of users\fR\fR .RS 4 فهرستی از کاربران جداشده با کاما که باید نادیده گرفته شوند\&. .sp پیش‌فرض: (هیچ) .RE .PP \fBrootasroot\fR .RS 4 در صورتی که کاربر «root» وارد شود، با استفاده از پیکربندی snapper با نام "root" یک اسنپ‌شات ایجاد می‌کند\&. به بیان دیگر: در این حالت از homeprefix استفاده نمی‌شود\&. از آنجا که پیکربندی snapper با نام "root" برای کل سیستم (سیستم‌فایل ریشه) استفاده می‌شود، این بدان معناست که با هر بار ورود کاربر «root»، از کل سیستم‌فایل "/" اسنپ‌شات گرفته خواهد شد\&. این امر می‌تواند به مدیران سیستم کمک کند تا در صورتی که فعالیت‌ها یا تغییرات پیکربندی آن‌ها اشتباهاً نادرست بوده است، سیستم را به وضعیت پیشین بازگردانی (rollback) کنند\&. .sp گزینه‌های "rootasroot" و "ignoreroot" ناسازگار با یکدیگر (مانعة‌الجمع) هستند\&. .RE .PP \fBignoreroot\fR .RS 4 در صورتی که کاربر «root» نشستی را باز کند یا ببندد، هیچ اسنپ‌شاتی گرفته نمی‌شود\&. .sp گزینه‌های "rootasroot" و "ignoreroot" ناسازگار با یکدیگر هستند\&. .RE .PP \fBopenonly\fR .RS 4 تنها هنگام باز کردن نشست PAM، یک اسنپ‌شات منفرد ایجاد می‌کند\&. .sp پیش‌فرض: ایجاد اسنپ‌شات‌های پیش و پس از رویداد (pre\- و post\-snapshots) .RE .PP \fBcloseonly\fR .RS 4 تنها هنگام بستن نشست PAM، یک اسنپ‌شات منفرد ایجاد می‌کند\&. .sp پیش‌فرض: ایجاد اسنپ‌شات‌های پیش و پس از رویداد (pre\- و post\-snapshots) .RE .PP \fBcleanup=\fR\fB\fIcleanup\-algorithm\fR\fR .RS 4 تنظیم الگوریتم پاک‌سازی snapper\&. .sp پیش‌فرض: (هیچ) .RE .SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)" .PP تنها نوع ماژول "session" ارائه شده است\&. .SH "مقادیر بازگشتی (RETURN VALUES)" .PP PAM_SUCCESS .RS 4 ماژول pam_snapper همواره مقدار PAM_SUCCESS را برمی‌گرداند تا در صورت بروز خطا در ایجاد اسنپ‌شات، مانع از ورود کاربران به سیستم نشود\&. ممکن است این رفتار در آینده تغییر کند\&. .RE .SH "مثال‌ها (EXAMPLES)" .SS "کاربرد پایه (Basic usage)" .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} یک زیرحجم (subvolume) سامانه btrfs برای کاربر جدید و یک پیکربندی snapper ایجاد کنید؛ به عنوان نمونه با استفاده از ابزار /usr/lib/pam_snapper/pam_snapper_useradd\&.sh\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} خط زیر را به فایل /etc/pam\&.d/common\-session اضافه کنید: .sp .if n \{\ .RS 4 .\} .nf session optional pam_snapper\&.so .fi .if n \{\ .RE .\} .sp .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBsnapper\fR(8), \fBpam.conf\fR(5), \fBpam\fR(8), pam_snapper_homeconvert, pam_snapper_pamconfig, pam_snapper_useradd, pam_snapper_userdel .SH "صفحه خانگی (HOMEPAGE)" .PP \m[blue]\fBhttp://snapper\&.io\fR\m[] .SH "نویسندگان (AUTHORS)" .PP ماژول pam\-snapper توسط Matthias G\&. Eckermann به عنوان بخشی از SUSE Hackweek#9 در آوریل ۲۰۱۳ نوشته شده است\&. .PP این ماژول بدون تلاش‌های Arvin Schnell در پروژه snapper امکان‌پذیر نبود\&. ماژول pam\-snapper مدیریت DBUS را از "snapper_dbus_cli\&.c" اثر David Disseldorp به ارث برده است\&. .PP این ماژول بر پایه پشته Linux PAM و مستندات آن، نگارش Thorsten Kukuk، توسعه یافته است\&. .SH "مجوز (LICENSE)" .PP حق نشر \(co 2013 SUSE .PP تمامی حقوق محفوظ است\&. .PP این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط نسخه ۲ از «مجوز عمومی همگانی گنو» که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید\&. .PP این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص\&. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید\&. .PP شما باید همراه با این برنامه یک نسخه از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت با SUSE تماس بگیرید\&. .PP جهت تماس با SUSE درباره این فایل از طریق پست معمولی یا الکترونیکی، می‌توانید اطلاعات تماس کنونی را در www\&.suse\&.com بیابید\&.