carta
vfs_worm(8)

vfs_worm8

Disallows writes for older file

Usage

vfs objects = worm

Overview

This VFS module is part of the samba(7) suite.

The vfs_worm module controls the writability of files and folders depending on their change time and a adjustable grace period.

If the change time of a file or directory is older than the specified grace period, the write access will be denied, independent of further access controls (e.g. by the filesystem).

In the case that the grace period is not exceed, the worm module will not impact any access controls.

Options

worm:grace_period = SECONDS

Period in seconds which defines the time how long the write access should be handled by the normal access controls. After this grace period the file or directory becomes read only.

Examples

Deny the write access to files and folders, which are older than five minutes (300 seconds):

	[wormshare]
	vfs objects = worm
	worm:grace_period = 300

Version

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

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)
  • Debian 8 (Jessie)

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.

From samba 2:4.25.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.