From f9d8fe038c9b82b812ebd2bfdc1f3c707130ad1d Mon Sep 17 00:00:00 2001
From: mohithshuka <YOUR_ID+mohithshuka@users.noreply.github.com>
Date: Sun, 14 Jun 2026 16:55:01 +0000
Subject: [PATCH] fix(volume/prune): document and test label! filter support

The --filter flag description for 'docker volume prune' only mentioned
'label=<label>' but not 'label!=<label>', even though the label!
filter is supported and handled correctly by the underlying
PruneFilters function.

This commit:
- Updates the --filter flag description to include label!=<label>
- Adds a unit test for the label! filter to match the existing
  label filter test

Fixes #6918

Signed-off-by: mohithshuka <YOUR_ID+mohithshuka@users.noreply.github.com>
---
 cli/command/volume/prune.go                              | 2 +-
 cli/command/volume/prune_test.go                         | 9 +++++++++
 .../volume-prune-success.label-not-filter.golden         | 2 ++
 3 files changed, 12 insertions(+), 1 deletion(-)
 create mode 100644 cli/command/volume/testdata/volume-prune-success.label-not-filter.golden

diff --git a/cli/command/volume/prune.go b/cli/command/volume/prune.go
index 53c218203aaf..e4da39b808b0 100644
--- a/cli/command/volume/prune.go
+++ b/cli/command/volume/prune.go
@@ -57,7 +57,7 @@ func newPruneCommand(dockerCLI command.Cli) *cobra.Command {
 	flags.BoolVarP(&options.all, "all", "a", false, "Remove all unused volumes, not just anonymous ones")
 	flags.SetAnnotation("all", "version", []string{"1.42"})
 	flags.BoolVarP(&options.force, "force", "f", false, "Do not prompt for confirmation")
-	flags.Var(&options.filter, "filter", `Provide filter values (e.g. "label=<label>")`)
+	flags.Var(&options.filter, "filter", `Provide filter values (e.g. "label=<label>" or "label!=<label>")`)
 
 	return cmd
 }
diff --git a/cli/command/volume/prune_test.go b/cli/command/volume/prune_test.go
index cbce72d22199..44d64ab27210 100644
--- a/cli/command/volume/prune_test.go
+++ b/cli/command/volume/prune_test.go
@@ -101,6 +101,15 @@ func TestVolumePruneSuccess(t *testing.T) {
 				return client.VolumePruneResult{}, nil
 			},
 		},
+		{
+			name:  "label-not-filter",
+			args:  []string{"--filter", "label!=foobar"},
+			input: "y",
+			pruneFunc: func(opts client.VolumePruneOptions) (client.VolumePruneResult, error) {
+				assert.Check(t, is.DeepEqual(opts.Filters["label!"], map[string]bool{"foobar": true}))
+				return client.VolumePruneResult{}, nil
+			},
+		},
 	}
 	for _, tc := range testCases {
 		t.Run(tc.name, func(t *testing.T) {
diff --git a/cli/command/volume/testdata/volume-prune-success.label-not-filter.golden b/cli/command/volume/testdata/volume-prune-success.label-not-filter.golden
new file mode 100644
index 000000000000..5ae0766b0075
--- /dev/null
+++ b/cli/command/volume/testdata/volume-prune-success.label-not-filter.golden
@@ -0,0 +1,2 @@
+WARNING! This will remove anonymous local volumes not used by at least one container.
+Are you sure you want to continue? [y/N] Total reclaimed space: 0B