{"id":2684,"date":"2022-12-20T15:17:02","date_gmt":"2022-12-20T18:17:02","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/vfs_shell_snap-man8\/"},"modified":"2022-12-20T15:17:02","modified_gmt":"2022-12-20T18:17:02","slug":"vfs_shell_snap-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/vfs_shell_snap-man8\/","title":{"rendered":"VFS_SHELL_SNAP (man8)"},"content":{"rendered":"<h1 align=\"center\">VFS_SHELL_SNAP<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#SYNOPSIS\">SYNOPSIS<\/a><br \/> <a href=\"#DESCRIPTION\">DESCRIPTION<\/a><br \/> <a href=\"#CONFIGURATION\">CONFIGURATION<\/a><br \/> <a href=\"#VERSION\">VERSION<\/a><br \/> <a href=\"#AUTHOR\">AUTHOR<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">vfs_shell_snap \u2212 Shell script callouts for snapshot creation and deletion<\/p>\n<h2>SYNOPSIS <a name=\"SYNOPSIS\"><\/a> <\/h2>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"37%\">\n<p style=\"margin-top: 1em\">vfs objects = shell_snap<\/p>\n<\/td>\n<td width=\"52%\"> <\/td>\n<\/tr>\n<\/table>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">This VFS module is part of the <b>samba<\/b>(8) suite.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">The vfs_shell_snap VFS provides shell\u2212script callouts for snapshot creation and deletion operations issued by remote clients using the File Server Remote VSS Protocol (FSRVP).<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">The following shell callouts may be configured in smb.conf:<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b><font color=\"#0000FF\">shell_snap:check path command<\/font><\/b><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 Called when an FSRVP client wishes to check whether a given share supports snapshot create\/delete requests.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command is called with a single <i>share_path<\/i> argument.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command must return 0 if <i>share_path<\/i> is capable of being snapshotted.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b><font color=\"#0000FF\">shell_snap:create command<\/font><\/b><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 Called when an FSRVP client wishes to create a snapshot.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command is called with a single <i>share_path<\/i> argument.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command must return 0 status if the snapshot was successfully taken.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command must output the path of the newly created snapshot to stdout.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b><font color=\"#0000FF\">shell_snap:delete command<\/font><\/b><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 Called when an FSRVP client wishes to delete a snapshot.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command is called with <i>base_share_path<\/i> and <i>snapshot_share_path<\/i> arguments.<\/font><\/p>\n<p style=\"margin-left:28%; margin-top: 1em\"><font color=\"#000000\">\u2022 The command must return 0 status if the snapshot was successfully removed.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">All commands are executed as the authenticated FSRVP client user.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">This module is stackable.<\/font><\/p>\n<h2>CONFIGURATION <a name=\"CONFIGURATION\"><\/a> <\/h2>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><font color=\"#000000\"><i>[share]<\/i><\/font><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">vfs objects = shell_snap<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">shell_snap:check path command = snap_check_path.sh<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">shell_snap:create command = snap_create.sh<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">shell_snap:delete command = snap_delete.sh<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">Samba&#8217;s FSRVP server must be configured in the [global] section:<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\"><i>[global]<\/i><\/font><\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">rpc_daemon:fssd = fork<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">registry shares = yes<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"> <\/td>\n<td width=\"77%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"8%\"><\/td>\n<td width=\"7%\"><\/td>\n<td width=\"8%\"><\/td>\n<td width=\"77%\">\n<p><b><font color=\"#0000FF\">include = registry<\/font><\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n<h2>VERSION <a name=\"VERSION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">This man page is part of version 4.14.14 of the Samba suite.<\/font><\/p>\n<h2>AUTHOR <a name=\"AUTHOR\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">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.<\/font><\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  vfs_shell_snap \u2212 Shell script callouts for snapshot creation and deletion <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,36],"class_list":["post-2684","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-vfs_shell_snap"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/2684","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=2684"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/2684\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=2684"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=2684"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=2684"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}