Skip to content

cosign clean subcmd: misleading warning about cleaning "referrers" type #4908

Description

@swivelmargarita

Description
The warning/suggestion when the --type is attestation or signature and we have referrers type is also present for an image, we get this warning "WARNING: image has referrers, consider using --referrer".

But no such option --referrer exists for cosign clean subcommand:

$ COSIGN_PASSWORD='' cosign attest --predicate <(echo '{"a": "b"}') --key cosign.key  --type custom $IMG_TTL 2>/dev/null

$ cosign clean --force --type attestation $IMG_TTL
WARNING: image has referrers, consider using --referrer

$ cosign clean --force --type attestation  --referrer $IMG_TTL
Error: unknown flag: --referrer
error during command execution: unknown flag: --referrer

I think the warning should be WARNING: image has referrers, consider using --type referrer instead. (--type referrer instead of --referrer):

$ cosign clean --force --type referrer $IMG_TTL
Removed ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7@sha256:ea00e606996adf71d5a4b44ea31cf4fa4149dbd010a91d5b091e2fbff8274e33 from ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7:1h
Removed ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7@sha256:1ec624564991564b4bdbec3c2f06d5706337c8fb520b6173adc955e704a10b45 from ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7:1h
Removed ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7@sha256:343bf08c8cc4bfcfd9f2ebbea99075ba1cf8299257715d8eb58f957c5d9626f6 from ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7:1h
Removed ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7@sha256:de4a3c014ea771ea02d618fb51c6704096d1170642bee63ea62678ef43d14d37 from ttl.sh/edee8e54-bb58-47c8-bdd5-99299d91d8f7:1h

Version

$ cosign version
  ______   ______        _______. __    _______ .__   __.
 /      | /  __  \      /       ||  |  /  _____||  \ |  |
|  ,----'|  |  |  |    |   (----`|  | |  |  __  |   \|  |
|  |     |  |  |  |     \   \    |  | |  | |_ | |  . `  |
|  `----.|  `--'  | .----)   |   |  | |  |__| | |  |\   |
 \______| \______/  |_______/    |__|  \______| |__| \__|
cosign: A tool for Container Signing, Verification and Storage in an OCI registry.

GitVersion:    v3.0.7-0.20260601193450-8cedfdeddb69
GitCommit:     8cedfdeddb69594522af4b24ea9102a84fb4c9c4
GitTreeState:  clean
BuildDate:     2026-06-01T19:34:50Z
GoVersion:     go1.26.3-X:nodwarf5
Compiler:      gc
Platform:      linux/amd64

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions