{"action":"created","comment":{"url":"https://api.github.com/repos/opencontainers/image-spec/pulls/comments/77826808","id":77826808,"diff_hunk":"@@ -1,63 +1,129 @@\n-# Creating an Image Filesystem Changeset\n+# Filesystem Layer Changeset\n \n-An example of creating an Image Filesystem Changeset follows.\n+A layer changeset is the distributable difference between filesystems.\n+A layer changeset is not directly extracted, but applied to a filesystem.\n \n-An image root filesystem is first created as an empty directory.\n-Here is the initial empty directory structure for a changeset using the randomly-generated directory name `c3167915dc9d` ([actual layer DiffIDs are generated based on the content](#id_desc)).\n+## Distributable Format\n+\n+Layer Changesets for the [mediatype](./media-types.md) `application/vnd.oci.image.layer.tar+gzip` MUST be packaged in [tar archive][tar-archive].\n+Layer Changesets for the [mediatype](./media-types.md) `application/vnd.oci.image.layer.tar+gzip` MUST NOT include duplicate entries for file paths in the resulting [tar archive][tar-archive].\n+\n+## Change Types\n+\n+Types of changes that can occur in a changeset are:\n+\n+* Additions\n+* Modifications\n+* Removals\n+\n+Additions and Modifications are reflected the same in the changeset tar archive.\n+\n+Removals are reflected using \"[whiteout](#whiteouts)\" file entries (See [Representing Changes](#representing-changes)).\n+\n+### File Attributes\n+\n+File attributes that are provided for Additions and Modifications include:\n+\n+* Modification Time (`mtime`)\n+* User ID (`uid`)\n+ * User Name (`uname`) is secondary to `uid`\n+* Group ID (`gid `)\n+ * Group Name (`gname`) is secondary to `gid`\n+* Mode (`mode`)\n+* Extended Attributes (`xattrs`)","path":"layer.md","position":37,"original_position":37,"commit_id":"728e772563840e3dbe01b420467b219c226f015e","original_commit_id":"728e772563840e3dbe01b420467b219c226f015e","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},"body":"that's why i did not link the libarchive man page, because it's support is varying.\r\nxattrs support in GNU tar was carried patches for a long time by various linux distros, but now it is in upstream GNU tar. Reflected in http://linux.die.net/man/1/tar\r\nThere is no particular tar spec.","created_at":"2016-09-07T13:58:27Z","updated_at":"2016-09-07T13:58:27Z","html_url":"https://github.com/opencontainers/image-spec/pull/255#discussion_r77826808","pull_request_url":"https://api.github.com/repos/opencontainers/image-spec/pulls/255","_links":{"self":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/comments/77826808"},"html":{"href":"https://github.com/opencontainers/image-spec/pull/255#discussion_r77826808"},"pull_request":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/255"}}},"pull_request":{"url":"https://api.github.com/repos/opencontainers/image-spec/pulls/255","id":83921615,"html_url":"https://github.com/opencontainers/image-spec/pull/255","diff_url":"https://github.com/opencontainers/image-spec/pull/255.diff","patch_url":"https://github.com/opencontainers/image-spec/pull/255.patch","issue_url":"https://api.github.com/repos/opencontainers/image-spec/issues/255","number":255,"state":"open","locked":false,"title":"layer: revamp for readability","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},"body":"When adding verbiage for restriction on duplicate entries in the tar\r\narchive, it was not immediately clear where this information would be\r\norganized.\r\n\r\nThis revamp seeks to make the document on the whole more suitable for\r\nimplementors and be interpretable for compliance.\r\n\r\nSigned-off-by: Vincent Batts <vbatts@hashbangbash.com>","created_at":"2016-09-04T12:33:28Z","updated_at":"2016-09-07T13:58:27Z","closed_at":null,"merged_at":null,"merge_commit_sha":"2c5c0580e60ef087ab85111b30f342d91ad7cedd","assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/opencontainers/image-spec/milestones/7","html_url":"https://github.com/opencontainers/image-spec/milestones/v0.5.0","labels_url":"https://api.github.com/repos/opencontainers/image-spec/milestones/7/labels","id":1935746,"number":7,"title":"v0.5.0","description":"","creator":{"login":"philips","id":33544,"avatar_url":"https://avatars.githubusercontent.com/u/33544?v=3","gravatar_id":"","url":"https://api.github.com/users/philips","html_url":"https://github.com/philips","followers_url":"https://api.github.com/users/philips/followers","following_url":"https://api.github.com/users/philips/following{/other_user}","gists_url":"https://api.github.com/users/philips/gists{/gist_id}","starred_url":"https://api.github.com/users/philips/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/philips/subscriptions","organizations_url":"https://api.github.com/users/philips/orgs","repos_url":"https://api.github.com/users/philips/repos","events_url":"https://api.github.com/users/philips/events{/privacy}","received_events_url":"https://api.github.com/users/philips/received_events","type":"User","site_admin":false},"open_issues":2,"closed_issues":10,"state":"open","created_at":"2016-08-10T21:42:57Z","updated_at":"2016-09-04T12:39:53Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/opencontainers/image-spec/pulls/255/commits","review_comments_url":"https://api.github.com/repos/opencontainers/image-spec/pulls/255/comments","review_comment_url":"https://api.github.com/repos/opencontainers/image-spec/pulls/comments{/number}","comments_url":"https://api.github.com/repos/opencontainers/image-spec/issues/255/comments","statuses_url":"https://api.github.com/repos/opencontainers/image-spec/statuses/728e772563840e3dbe01b420467b219c226f015e","head":{"label":"vbatts:clarify_tar_entry_order","ref":"clarify_tar_entry_order","sha":"728e772563840e3dbe01b420467b219c226f015e","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},"repo":{"id":55434231,"name":"oci-image-spec","full_name":"vbatts/oci-image-spec","owner":{"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},"private":false,"html_url":"https://github.com/vbatts/oci-image-spec","description":"OCI Image Format","fork":true,"url":"https://api.github.com/repos/vbatts/oci-image-spec","forks_url":"https://api.github.com/repos/vbatts/oci-image-spec/forks","keys_url":"https://api.github.com/repos/vbatts/oci-image-spec/keys{/key_id}","collaborators_url":"https://api.github.com/repos/vbatts/oci-image-spec/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/vbatts/oci-image-spec/teams","hooks_url":"https://api.github.com/repos/vbatts/oci-image-spec/hooks","issue_events_url":"https://api.github.com/repos/vbatts/oci-image-spec/issues/events{/number}","events_url":"https://api.github.com/repos/vbatts/oci-image-spec/events","assignees_url":"https://api.github.com/repos/vbatts/oci-image-spec/assignees{/user}","branches_url":"https://api.github.com/repos/vbatts/oci-image-spec/branches{/branch}","tags_url":"https://api.github.com/repos/vbatts/oci-image-spec/tags","blobs_url":"https://api.github.com/repos/vbatts/oci-image-spec/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/vbatts/oci-image-spec/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/vbatts/oci-image-spec/git/refs{/sha}","trees_url":"https://api.github.com/repos/vbatts/oci-image-spec/git/trees{/sha}","statuses_url":"https://api.github.com/repos/vbatts/oci-image-spec/statuses/{sha}","languages_url":"https://api.github.com/repos/vbatts/oci-image-spec/languages","stargazers_url":"https://api.github.com/repos/vbatts/oci-image-spec/stargazers","contributors_url":"https://api.github.com/repos/vbatts/oci-image-spec/contributors","subscribers_url":"https://api.github.com/repos/vbatts/oci-image-spec/subscribers","subscription_url":"https://api.github.com/repos/vbatts/oci-image-spec/subscription","commits_url":"https://api.github.com/repos/vbatts/oci-image-spec/commits{/sha}","git_commits_url":"https://api.github.com/repos/vbatts/oci-image-spec/git/commits{/sha}","comments_url":"https://api.github.com/repos/vbatts/oci-image-spec/comments{/number}","issue_comment_url":"https://api.github.com/repos/vbatts/oci-image-spec/issues/comments{/number}","contents_url":"https://api.github.com/repos/vbatts/oci-image-spec/contents/{+path}","compare_url":"https://api.github.com/repos/vbatts/oci-image-spec/compare/{base}...{head}","merges_url":"https://api.github.com/repos/vbatts/oci-image-spec/merges","archive_url":"https://api.github.com/repos/vbatts/oci-image-spec/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/vbatts/oci-image-spec/downloads","issues_url":"https://api.github.com/repos/vbatts/oci-image-spec/issues{/number}","pulls_url":"https://api.github.com/repos/vbatts/oci-image-spec/pulls{/number}","milestones_url":"https://api.github.com/repos/vbatts/oci-image-spec/milestones{/number}","notifications_url":"https://api.github.com/repos/vbatts/oci-image-spec/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/vbatts/oci-image-spec/labels{/name}","releases_url":"https://api.github.com/repos/vbatts/oci-image-spec/releases{/id}","deployments_url":"https://api.github.com/repos/vbatts/oci-image-spec/deployments","created_at":"2016-04-04T18:18:32Z","updated_at":"2016-08-26T14:31:25Z","pushed_at":"2016-09-06T21:25:40Z","git_url":"git://github.com/vbatts/oci-image-spec.git","ssh_url":"git@github.com:vbatts/oci-image-spec.git","clone_url":"https://github.com/vbatts/oci-image-spec.git","svn_url":"https://github.com/vbatts/oci-image-spec","homepage":"https://www.opencontainers.org/","size":663,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"opencontainers:master","ref":"master","sha":"f3a8be2fffca47fcb15c0fd20786bafc5928761a","user":{"login":"opencontainers","id":12563465,"avatar_url":"https://avatars.githubusercontent.com/u/12563465?v=3","gravatar_id":"","url":"https://api.github.com/users/opencontainers","html_url":"https://github.com/opencontainers","followers_url":"https://api.github.com/users/opencontainers/followers","following_url":"https://api.github.com/users/opencontainers/following{/other_user}","gists_url":"https://api.github.com/users/opencontainers/gists{/gist_id}","starred_url":"https://api.github.com/users/opencontainers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opencontainers/subscriptions","organizations_url":"https://api.github.com/users/opencontainers/orgs","repos_url":"https://api.github.com/users/opencontainers/repos","events_url":"https://api.github.com/users/opencontainers/events{/privacy}","received_events_url":"https://api.github.com/users/opencontainers/received_events","type":"Organization","site_admin":false},"repo":{"id":54503347,"name":"image-spec","full_name":"opencontainers/image-spec","owner":{"login":"opencontainers","id":12563465,"avatar_url":"https://avatars.githubusercontent.com/u/12563465?v=3","gravatar_id":"","url":"https://api.github.com/users/opencontainers","html_url":"https://github.com/opencontainers","followers_url":"https://api.github.com/users/opencontainers/followers","following_url":"https://api.github.com/users/opencontainers/following{/other_user}","gists_url":"https://api.github.com/users/opencontainers/gists{/gist_id}","starred_url":"https://api.github.com/users/opencontainers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opencontainers/subscriptions","organizations_url":"https://api.github.com/users/opencontainers/orgs","repos_url":"https://api.github.com/users/opencontainers/repos","events_url":"https://api.github.com/users/opencontainers/events{/privacy}","received_events_url":"https://api.github.com/users/opencontainers/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/opencontainers/image-spec","description":"OCI Image Format","fork":false,"url":"https://api.github.com/repos/opencontainers/image-spec","forks_url":"https://api.github.com/repos/opencontainers/image-spec/forks","keys_url":"https://api.github.com/repos/opencontainers/image-spec/keys{/key_id}","collaborators_url":"https://api.github.com/repos/opencontainers/image-spec/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/opencontainers/image-spec/teams","hooks_url":"https://api.github.com/repos/opencontainers/image-spec/hooks","issue_events_url":"https://api.github.com/repos/opencontainers/image-spec/issues/events{/number}","events_url":"https://api.github.com/repos/opencontainers/image-spec/events","assignees_url":"https://api.github.com/repos/opencontainers/image-spec/assignees{/user}","branches_url":"https://api.github.com/repos/opencontainers/image-spec/branches{/branch}","tags_url":"https://api.github.com/repos/opencontainers/image-spec/tags","blobs_url":"https://api.github.com/repos/opencontainers/image-spec/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/opencontainers/image-spec/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/opencontainers/image-spec/git/refs{/sha}","trees_url":"https://api.github.com/repos/opencontainers/image-spec/git/trees{/sha}","statuses_url":"https://api.github.com/repos/opencontainers/image-spec/statuses/{sha}","languages_url":"https://api.github.com/repos/opencontainers/image-spec/languages","stargazers_url":"https://api.github.com/repos/opencontainers/image-spec/stargazers","contributors_url":"https://api.github.com/repos/opencontainers/image-spec/contributors","subscribers_url":"https://api.github.com/repos/opencontainers/image-spec/subscribers","subscription_url":"https://api.github.com/repos/opencontainers/image-spec/subscription","commits_url":"https://api.github.com/repos/opencontainers/image-spec/commits{/sha}","git_commits_url":"https://api.github.com/repos/opencontainers/image-spec/git/commits{/sha}","comments_url":"https://api.github.com/repos/opencontainers/image-spec/comments{/number}","issue_comment_url":"https://api.github.com/repos/opencontainers/image-spec/issues/comments{/number}","contents_url":"https://api.github.com/repos/opencontainers/image-spec/contents/{+path}","compare_url":"https://api.github.com/repos/opencontainers/image-spec/compare/{base}...{head}","merges_url":"https://api.github.com/repos/opencontainers/image-spec/merges","archive_url":"https://api.github.com/repos/opencontainers/image-spec/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/opencontainers/image-spec/downloads","issues_url":"https://api.github.com/repos/opencontainers/image-spec/issues{/number}","pulls_url":"https://api.github.com/repos/opencontainers/image-spec/pulls{/number}","milestones_url":"https://api.github.com/repos/opencontainers/image-spec/milestones{/number}","notifications_url":"https://api.github.com/repos/opencontainers/image-spec/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/opencontainers/image-spec/labels{/name}","releases_url":"https://api.github.com/repos/opencontainers/image-spec/releases{/id}","deployments_url":"https://api.github.com/repos/opencontainers/image-spec/deployments","created_at":"2016-03-22T19:34:41Z","updated_at":"2016-09-07T01:18:10Z","pushed_at":"2016-09-07T13:52:50Z","git_url":"git://github.com/opencontainers/image-spec.git","ssh_url":"git@github.com:opencontainers/image-spec.git","clone_url":"https://github.com/opencontainers/image-spec.git","svn_url":"https://github.com/opencontainers/image-spec","homepage":"https://www.opencontainers.org/","size":796,"stargazers_count":120,"watchers_count":120,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":34,"mirror_url":null,"open_issues_count":50,"forks":34,"open_issues":50,"watchers":120,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/255"},"html":{"href":"https://github.com/opencontainers/image-spec/pull/255"},"issue":{"href":"https://api.github.com/repos/opencontainers/image-spec/issues/255"},"comments":{"href":"https://api.github.com/repos/opencontainers/image-spec/issues/255/comments"},"review_comments":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/255/comments"},"review_comment":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/opencontainers/image-spec/pulls/255/commits"},"statuses":{"href":"https://api.github.com/repos/opencontainers/image-spec/statuses/728e772563840e3dbe01b420467b219c226f015e"}}}}
{"actor":{"display_login":"vbatts"}}