VFS_SHELL_SNAP(8)         System Administration tools        VFS_SHELL_SNAP(8)

نام (NAME)
       vfs_shell_snap - فراخوانی‌های اسکریپت شل برای ایجاد و حذف اسنپ‌شات

خلاصه دستور (SYNOPSIS)
       vfs objects = shell_snap

توضیحات (DESCRIPTION)
       این ماژول VFS بخشی از مجموعهٔ samba(8) است.

       ماژول VFS با نام vfs_shell_snap فراخوانی‌های اسکریپت شل را برای عملیات
       ایجاد و حذف اسنپ‌شات که توسط کلاینت‌های راه دور با استفاده از پروتکل File
       Server Remote VSS Protocol (FSRVP) صادر شده‌اند، فراهم می‌کند.

       فراخوانی‌های شل زیر را می‌توان در smb.conf پیکربندی کرد:

       shell_snap:check path command

              •   هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد پشتیبانی یک
                  اشتراک معین از درخواست‌های ایجاد/حذف اسنپ‌شات را بررسی کند.

              •   دستور با یک آرگومان منفرد share_path فراخوانی می‌شود.

              •   در صورتی که share_path قابلیت ایجاد اسنپ‌شات را داشته باشد،
                  دستور باید 0 را برگرداند.


       shell_snap:create command

              •   هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد یک اسنپ‌شات
                  ایجاد کند.

              •   دستور با یک آرگومان منفرد share_path فراخوانی می‌شود.

              •   اگر اسنپ‌شات با موفقیت گرفته شد، دستور باید وضعیت 0 را
                  برگرداند.

              •   دستور باید مسیر اسنپ‌شات تازه ایجادشده را در خروجی استاندارد
                  (stdout) چاپ کند.


       shell_snap:delete command

              •   هنگامی فراخوانی می‌شود که یک کلاینت FSRVP بخواهد یک اسنپ‌شات
                  را حذف کند.

              •   دستور با آرگومان‌های base_share_path و snapshot_share_path
                  فراخوانی می‌شود.

              •   اگر اسنپ‌شات با موفقیت حذف شد، دستور باید وضعیت 0 را
                  برگرداند.

       تمام دستورها با هویت کاربر احراز هویت‌شدهٔ کلاینت FSRVP اجرا می‌شوند.

       این ماژول پشته‌پذیر (stackable) است.

پیکربندی (CONFIGURATION)
                     [share]
                     vfs objects = shell_snap
                     shell_snap:check path command = snap_check_path.sh
                     shell_snap:create command = snap_create.sh
                     shell_snap:delete command = snap_delete.sh

       سرور FSRVP سامبا باید در بخش [global] پیکربندی شود:

                     [global]
                     registry shares = yes
                     include = registry

نسخه (VERSION)
       این صفحه راهنما بخشی از نسخهٔ 4.24.6 مجموعهٔ Samba است.

نویسنده (AUTHOR)
       نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط Andrew Tridgell ساخته
       شده‌اند. سامبا اکنون توسط Samba Team به‌صورت یک پروژه متن‌باز مشابه روش
       توسعهٔ هسته لینوکس توسعه داده می‌شود.

Samba 4.24.6                      08/16/2026                 VFS_SHELL_SNAP(8)