Apple - Delete all backups of specific file/folder with tmutil

I found this SU Q&A titled: How can I delete Time Machine files using the commandline which demonstrates a method for deleting specific files from the CLI. This answer highlighted a method that sounds like what you want:

My backup disk is full. I have a very large file (many gigabytes) that has been backed up for months. There is one physical copy of it, but many snapshots with hard links to that copy. To actually get rid of that file, I need to remove the hard link from every backup.

In that answer it was shown that one could use this method to delete a file:

$ cd /Volumes/WD\ 500G\ USB/Backups.backupdb/csm-laptop
$ ls -li */Macintosh\ HD/Users/csm/vm.img
...
2740350 -rw-r--r--@ 28 csm  staff  42949672960 Feb 17 16:12 2015-05-08-005636/Macintosh HD/Users/csm/vm.img
2740350 -rw-r--r--@ 28 csm  staff  42949672960 Feb 17 16:12 2015-05-08-015812/Macintosh HD/Users/csm/vm.img
2740350 -rw-r--r--@ 28 csm  staff  42949672960 Feb 17 16:12 2015-05-08-030036/Macintosh HD/Users/csm/vm.img
2740350 -rw-r--r--@ 28 csm  staff  42949672960 Feb 17 16:12 2015-05-08-041307/Macintosh HD/Users/csm/vm.img
2740350 -rw-r--r--@ 28 csm  staff  42949672960 Feb 17 16:12 Latest/Macintosh HD/Users/csm/vm.img

The method to delete the file uses a helper CLI tool included with Time Machine called bypass:

$ sudo bypass rm -f */Macintosh\ HD/Users/csm/vm.img

bypass's location

Since bypass is considered a helper script to Time Machine, it's location is not typically on your $PATH. Therefore you'll need to specify the full path to the executable. Additionally Apple has relocated it for different versions of macOS.

$ sudo /System/Library/Extensions/TMSafetyNet.kext/Contents/MacOS/bypass \
    rm -rfv /Volumes/[disk]/Backups.backupdb/[path]

In 10.8 Mountain Lion, bypass moved into 'Helpers':

$ /System/Library/Extensions/TMSafetyNet.kext/Helpers/bypass

In 10.10 Yosemite, bypass moved here:

$ /System/Library/Extensions/TMSafetyNet.kext/Contents/Helpers/bypass

References

  • How can I delete Time Machine files using the commandline

According to man tmutil, the tmutil delete command can be used to delete one or more snapshots, machine directories, or backup stores. The terms are defined at the beginning of the same man page:

  • snapshot: A directory inside a machine directory that represents a single initial or incremental backup of one computer (e.g. /Volumes/Chronoton/Backups.backupdb/thermopylae/2011-07-03-123456)
  • machine directory: A directory inside a backup store that contains all the backups for a particular computer (e.g. /Volumes/Chronoton/Backups.backupdb/thermopylae)
  • backup store: The top-level "Backups.backupdb" directory at the root of a backup disk (e.g. /Volumes/Chronoton/Backups.backupdb)

So it seems as if it is unfortunately not possible to use tmutil to delete specific items within a snapshot.