---
name: "vfs_shell_snap"
section: "8"
platform: "linux"
package: "samba"
version: "2:4.25.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/vfs_shell_snap"
---

# vfs\_shell\_snap(8)

Shell script callouts for snapshot creation and deletion

## NAME

vfs\_shell\_snap - Shell script callouts for snapshot creation and deletion

## SYNOPSIS

vfs objects = shell\_snap

## DESCRIPTION

This VFS module is part of the [**samba**(8)](/samba/8.md) suite.

The vfs\_shell\_snap VFS provides shell-script callouts for snapshot creation and deletion operations issued by remote clients using the File Server Remote VSS Protocol (FSRVP).

The following shell callouts may be configured in smb.conf:

**shell\_snap:check path command**

• Called when an FSRVP client wishes to check whether a given share supports snapshot create/delete requests.

• The command is called with a single *share\_path* argument.

• The command must return 0 if *share\_path* is capable of being snapshotted.

**shell\_snap:create command**

• Called when an FSRVP client wishes to create a snapshot.

• The command is called with a single *share\_path* argument.

• The command must return 0 status if the snapshot was successfully taken.

• The command must output the path of the newly created snapshot to stdout.

**shell\_snap:delete command**

• Called when an FSRVP client wishes to delete a snapshot.

• The command is called with *base\_share\_path* and *snapshot\_share\_path* arguments.

• The command must return 0 status if the snapshot was successfully removed.

All commands are executed as the authenticated FSRVP client user.

This module is 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
```

Samba's FSRVP server must be configured in the \[global\] section:

```
		[global]
		registry shares = yes
		include = registry
```

## VERSION

This man page is part of version 4.25.1 of the Samba suite.

## AUTHOR

The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.