Issue Description
The buildah pull man page documents --policy=newer, but the command's
policy map accepts --policy=ifnewer.
|
**--policy**=**always**|**missing**|**never**|**newer** |
|
- **newer**: Pull if the image on the registry is newer than the one in the local containers storage. An image is considered to be newer when the digests are different. Comparing the time stamps is prone to errors. Pull errors are suppressed if a local image was found. |
Steps to reproduce the issue
Steps to reproduce the issue:
newer is rejected by the CLI.
lm00@lm00:~/src/buildah$ sudo ./bin/buildah pull --policy newer ubuntu:latest
Error: unsupported pull policy "newer"
ifnewer works as expected.
lm00@lm00:~/src/buildah$ sudo ./bin/buildah pull --policy ifnewer ubuntu:latest
Resolved "ubuntu" as an alias (/etc/containers/registries.conf.d/000-shortnames.conf)
Trying to pull docker.io/library/ubuntu:latest...
Getting image source signatures
Copying blob a3679419df18 done |
Describe the results you received
Unrecognized policy:
Error: unsupported pull policy "newer".
Describe the results you expected
I would expect it to accept, but the documentation is wrong.
buildah version output
lm00@lm00:~/src/buildah$ ./bin/buildah version
Version: 1.45.0-dev
Go Version: go1.25.11 X:nodwarf5
Image Spec: 1.1.1
Runtime Spec: 1.3.0
image Version: 5.41.0-dev
Git Commit: dda82a185a1ceaa27df569fce5c83befeb5a43a4
Built: Mon Jul 13 16:37:22 2026
OS/Arch: linux/amd64
BuildPlatform: linux/amd64
buildah info output
lm00@lm00:~/src/buildah$ sudo ./bin/buildah info
{
"host": {
"Distribution": {
"distribution": "fedora",
"version": "43"
},
"MemFree": 3329839104,
"MemTotal": 33559252992,
"OCIRuntime": "crun",
"SwapFree": 8589930496,
"SwapTotal": 8589930496,
"arch": "amd64",
"cpus": 16,
"hostname": "lm00.device",
"kernel": "7.1.3-101.fc43.x86_64",
"os": "linux",
"rootless": false,
"uptime": "39m 9.4s",
"variant": ""
},
"store": {
"ContainerStore": {
"number": 0
},
"GraphDriverName": "overlay",
"GraphImageStore": "",
"GraphOptions": [
"imagestore=/usr/lib/containers/storage",
"overlay.mountopt=nodev,metacopy=on"
],
"GraphRoot": "/var/lib/containers/storage",
"GraphStatus": {
"Backing Filesystem": "btrfs",
"Native Overlay Diff": "false",
"Supports d_type": "true",
"Supports shifting": "true",
"Supports volatile": "true",
"Using metacopy": "true"
},
"GraphTransientStore": false,
"ImageStore": {
"number": 3
},
"RunRoot": "/run/containers/storage"
}
}Provide your storage.conf
Upstream Latest Release
Yes
Additional environment details
No response
Additional information
No response
Issue Description
The
buildah pullman page documents--policy=newer, but the command'spolicy map accepts
--policy=ifnewer.buildah/docs/buildah-pull.1.md
Line 73 in 18bf8e3
buildah/docs/buildah-pull.1.md
Line 80 in 18bf8e3
Steps to reproduce the issue
Steps to reproduce the issue:
neweris rejected by the CLI.ifnewerworks as expected.Describe the results you received
Unrecognized policy:
Error: unsupported pull policy "newer".Describe the results you expected
I would expect it to accept, but the documentation is wrong.
buildah version output
buildah info output
Provide your storage.conf
-Upstream Latest Release
Yes
Additional environment details
No response
Additional information
No response