Skip to content

Clarify that whiteout filenames require a non-empty basename#1314

Open
mahitha-ada wants to merge 2 commits intoopencontainers:mainfrom
mahitha-ada:clarify-whiteout-basename-requirement
Open

Clarify that whiteout filenames require a non-empty basename#1314
mahitha-ada wants to merge 2 commits intoopencontainers:mainfrom
mahitha-ada:clarify-whiteout-basename-requirement

Conversation

@mahitha-ada
Copy link
Copy Markdown

Description

Fixes #1301.

Clarifies in the whiteout specification that a .wh. prefix MUST be
followed by a non-empty basename. The current spec does not explicitly
address the edge case of a bare .wh. entry (with no basename), which
leads to inconsistent behavior across implementations — for example,
containerd rejects it with "invalid whiteout name: .wh." while other
runtimes may handle it unpredictably.

This change:

  • Adds an explicit requirement that the basename must be non-empty
  • Specifies that implementations MUST error on bare .wh. entries
  • Points readers to opaque whiteouts for directory-level deletion

Signed-off-by: Mahitha Adapa mahitha.ada@gmail.com

Signed-off-by: Mahitha Adapa <mahitha.ada@gmail.com>
Comment thread layer.md
extensions](https://github.com/libarchive/libarchive/wiki/ManPageTar5#pax-interchange-format) as follows:

- [Windows file attributes](https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117(v=vs.85).aspx) (`MSWINDOWS.fileattr`)
- [Windows file attributes](<https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117(v=vs.85).aspx>) (`MSWINDOWS.fileattr`)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this change needed?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not needed

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [Windows file attributes](<https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117(v=vs.85).aspx>) (`MSWINDOWS.fileattr`)
- [Windows file attributes](https://msdn.microsoft.com/en-us/library/windows/desktop/gg258117(v=vs.85).aspx) (`MSWINDOWS.fileattr`)

In that case, lets revert it for consistency.

Comment thread layer.md Outdated
Co-authored-by: Brandon Mitchell <git@bmitch.net>
Signed-off-by: Mahitha Adapa <mahitha.ada@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

clarify what a .wh. file does

2 participants