{"action":"created","issue":{"url":"https://api.github.com/repos/opencontainers/image-spec/issues/130","repository_url":"https://api.github.com/repos/opencontainers/image-spec","labels_url":"https://api.github.com/repos/opencontainers/image-spec/issues/130/labels{/name}","comments_url":"https://api.github.com/repos/opencontainers/image-spec/issues/130/comments","events_url":"https://api.github.com/repos/opencontainers/image-spec/issues/130/events","html_url":"https://github.com/opencontainers/image-spec/issues/130","id":159537781,"number":130,"title":"Describe format and application of whiteout files","user":{"login":"stevvooe","id":120601,"avatar_url":"https://avatars.githubusercontent.com/u/120601?v=3","gravatar_id":"","url":"https://api.github.com/users/stevvooe","html_url":"https://github.com/stevvooe","followers_url":"https://api.github.com/users/stevvooe/followers","following_url":"https://api.github.com/users/stevvooe/following{/other_user}","gists_url":"https://api.github.com/users/stevvooe/gists{/gist_id}","starred_url":"https://api.github.com/users/stevvooe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevvooe/subscriptions","organizations_url":"https://api.github.com/users/stevvooe/orgs","repos_url":"https://api.github.com/users/stevvooe/repos","events_url":"https://api.github.com/users/stevvooe/events{/privacy}","received_events_url":"https://api.github.com/users/stevvooe/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/opencontainers/image-spec/labels/1.0-release-blocker","name":"1.0-release-blocker","color":"5319e7"},{"url":"https://api.github.com/repos/opencontainers/image-spec/labels/component/serialization%20spec","name":"component/serialization spec","color":"0052cc"},{"url":"https://api.github.com/repos/opencontainers/image-spec/labels/priority/P0","name":"priority/P0","color":"df0101"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-06-10T00:35:23Z","updated_at":"2016-06-10T14:36:19Z","closed_at":null,"body":"Whiteout files allow layers higher in the stack to control how base layer content appears in a container filesystem. Much of the whiteout format comes from the AUFS implementation, but certain files are not transmitted. There are many details about format and application that are currently missing from the specification.\r\n\r\nEnsuring that these whiteouts are handled consistently is critical to a portable image format.\r\n\r\nThe docker implementation can inform this specification. Several details on the whiteout files are available [here](https://github.com/docker/docker/blob/3d13fddd2bc4d679f0eaa68b0be877e5a816ad53/pkg/archive/whiteouts.go). Change calculation is [here](https://github.com/docker/docker/blob/3d13fddd2bc4d679f0eaa68b0be877e5a816ad53/pkg/archive/changes.go#L83).\r\n\r\nIt would be good to examine other implementations to inform this, as well.\r\n\r\nSupercedes #127"},"comment":{"url":"https://api.github.com/repos/opencontainers/image-spec/issues/comments/225199417","html_url":"https://github.com/opencontainers/image-spec/issues/130#issuecomment-225199417","issue_url":"https://api.github.com/repos/opencontainers/image-spec/issues/130","id":225199417,"user":{"login":"vbatts","id":67049,"avatar_url":"https://avatars.githubusercontent.com/u/67049?v=3","gravatar_id":"","url":"https://api.github.com/users/vbatts","html_url":"https://github.com/vbatts","followers_url":"https://api.github.com/users/vbatts/followers","following_url":"https://api.github.com/users/vbatts/following{/other_user}","gists_url":"https://api.github.com/users/vbatts/gists{/gist_id}","starred_url":"https://api.github.com/users/vbatts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vbatts/subscriptions","organizations_url":"https://api.github.com/users/vbatts/orgs","repos_url":"https://api.github.com/users/vbatts/repos","events_url":"https://api.github.com/users/vbatts/events{/privacy}","received_events_url":"https://api.github.com/users/vbatts/received_events","type":"User","site_admin":false},"created_at":"2016-06-10T14:36:19Z","updated_at":"2016-06-10T14:36:19Z","body":"This is specifically referring to the `*.wh.*` entries in a tar archive? or also a whiteout list?"}}
{"actor":{"display_login":"vbatts"}}