'\" t
.\"     Title: vfs_shell_snap
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/16/2026
.\"    Manual: System Administration tools
.\"    Source: Samba 4.24.6
.\"  Language: Persian
.\"
.TH "VFS_SHELL_SNAP" "8" "08/16/2026" "Samba 4\&.24\&.6" "System Administration tools"
.\" -----------------------------------------------------------------
.\" * 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)"
vfs_shell_snap \- فراخوانی‌های اسکریپت شل برای ایجاد و حذف اسنپ‌شات
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\ 'u
vfs objects = shell_snap
.SH "توضیحات (DESCRIPTION)"
.PP
این ماژول VFS بخشی از مجموعهٔ
\fBsamba\fR(8)
است\&.
.PP
ماژول VFS با نام
vfs_shell_snap
فراخوانی‌های اسکریپت شل را برای عملیات ایجاد و حذف اسنپ‌شات که توسط کلاینت‌های راه دور با استفاده از پروتکل File Server Remote VSS Protocol (FSRVP) صادر شده‌اند، فراهم می‌کند\&.
.PP
فراخوانی‌های شل زیر را می‌توان در smb\&.conf پیکربندی کرد:
.PP
\m[blue]\fBshell_snap:check path command\fR\m[]
.RS
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد پشتیبانی یک اشتراک معین از درخواست‌های ایجاد/حذف اسنپ‌شات را بررسی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور با یک آرگومان منفرد
\fIshare_path\fR
فراخوانی می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در صورتی که
\fIshare_path\fR
قابلیت ایجاد اسنپ‌شات را داشته باشد، دستور باید 0 را برگرداند\&.
.RE
.sp
.RE
.PP
\m[blue]\fBshell_snap:create command\fR\m[]
.RS
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد یک اسنپ‌شات ایجاد کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور با یک آرگومان منفرد
\fIshare_path\fR
فراخوانی می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر اسنپ‌شات با موفقیت گرفته شد، دستور باید وضعیت 0 را برگرداند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور باید مسیر اسنپ‌شات تازه ایجادشده را در خروجی استاندارد (stdout) چاپ کند\&.
.RE
.sp
.RE
.PP
\m[blue]\fBshell_snap:delete command\fR\m[]
.RS
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد یک اسنپ‌شات را حذف کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دستور با آرگومان‌های
\fIbase_share_path\fR
و
\fIsnapshot_share_path\fR
فراخوانی می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر اسنپ‌شات با موفقیت حذف شد، دستور باید وضعیت 0 را برگرداند\&.
.RE
.sp
.RE
تمام دستورها با هویت کاربر احراز هویت‌شدهٔ کلاینت FSRVP اجرا می‌شوند\&.
.PP
این ماژول پشته‌پذیر (stackable) است\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
.if n \{\
.RS 4
.\}
.nf
		\fI[share]\fR
		\m[blue]\fBvfs objects = shell_snap\fR\m[]
		\m[blue]\fBshell_snap:check path command = snap_check_path\&.sh\fR\m[]
		\m[blue]\fBshell_snap:create command = snap_create\&.sh\fR\m[]
		\m[blue]\fBshell_snap:delete command = snap_delete\&.sh\fR\m[]
.fi
.if n \{\
.RE
.\}
.PP
سرور FSRVP سامبا باید در بخش [global] پیکربندی شود:
.sp
.if n \{\
.RS 4
.\}
.nf
		\fI[global]\fR
		\m[blue]\fBregistry shares = yes\fR\m[]
		\m[blue]\fBinclude = registry\fR\m[]
.fi
.if n \{\
.RE
.\}
.SH "نسخه (VERSION)"
.PP
این صفحه راهنما بخشی از نسخهٔ 4\&.24\&.6 مجموعهٔ Samba است\&.
.SH "نویسنده (AUTHOR)"
.PP
نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط Andrew Tridgell ساخته شده‌اند\&. سامبا اکنون توسط Samba Team به‌صورت یک پروژه متن‌باز مشابه روش توسعهٔ هسته لینوکس توسعه داده می‌شود\&.