{"action":"created","issue":{"url":"https://api.github.com/repos/opencontainers/specs/issues/118","labels_url":"https://api.github.com/repos/opencontainers/specs/issues/118/labels{/name}","comments_url":"https://api.github.com/repos/opencontainers/specs/issues/118/comments","events_url":"https://api.github.com/repos/opencontainers/specs/issues/118/events","html_url":"https://github.com/opencontainers/specs/pull/118","id":103362556,"number":118,"title":"runtime: Document args[0] and the no-usable-args fallback","user":{"login":"wking","id":209920,"avatar_url":"https://avatars.githubusercontent.com/u/209920?v=3","gravatar_id":"","url":"https://api.github.com/users/wking","html_url":"https://github.com/wking","followers_url":"https://api.github.com/users/wking/followers","following_url":"https://api.github.com/users/wking/following{/other_user}","gists_url":"https://api.github.com/users/wking/gists{/gist_id}","starred_url":"https://api.github.com/users/wking/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wking/subscriptions","organizations_url":"https://api.github.com/users/wking/orgs","repos_url":"https://api.github.com/users/wking/repos","events_url":"https://api.github.com/users/wking/events{/privacy}","received_events_url":"https://api.github.com/users/wking/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":7,"created_at":"2015-08-26T20:57:58Z","updated_at":"2015-08-27T22:49:23Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/opencontainers/specs/pulls/118","html_url":"https://github.com/opencontainers/specs/pull/118","diff_url":"https://github.com/opencontainers/specs/pull/118.diff","patch_url":"https://github.com/opencontainers/specs/pull/118.patch"},"body":"Leaning on [Go's docs][1]:\n\n> `Args` holds command line arguments, including the command as\n> `Args[0]`. If the `Args` field is empty or `nil`, `Run` uses\n> `{Path}`.\n\nfor the fallback wording.\n\nThis restores the ability to explicitly set `args[0]` independent of the\npath, which [was requested in #34][2] and ack-ed by [Micheal][3] and\n[Mrunal][4], but didn't match the examples that landed with #34.\n\nThis new wording matches the implementation that's currently in flight\nas opencontainers/runc#160.  I also [raised this issue on the mailing\nlist][5], but didn't have any discussion there before we reached a\nconsensus in the runC PR.\n\n[1]: http://golang.org/pkg/os/exec/#Cmd\n[2]: https://github.com/opencontainers/specs/pull/34#issuecomment-126116173\n[3]: https://github.com/opencontainers/specs/pull/34#issuecomment-127335834\n[4]: https://github.com/opencontainers/specs/pull/34#issuecomment-127350235\n[5]: https://groups.google.com/a/opencontainers.org/forum/#!topic/dev/luaaorsya10"},"comment":{"url":"https://api.github.com/repos/opencontainers/specs/issues/comments/135576628","html_url":"https://github.com/opencontainers/specs/pull/118#issuecomment-135576628","issue_url":"https://api.github.com/repos/opencontainers/specs/issues/118","id":135576628,"user":{"login":"wking","id":209920,"avatar_url":"https://avatars.githubusercontent.com/u/209920?v=3","gravatar_id":"","url":"https://api.github.com/users/wking","html_url":"https://github.com/wking","followers_url":"https://api.github.com/users/wking/followers","following_url":"https://api.github.com/users/wking/following{/other_user}","gists_url":"https://api.github.com/users/wking/gists{/gist_id}","starred_url":"https://api.github.com/users/wking/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wking/subscriptions","organizations_url":"https://api.github.com/users/wking/orgs","repos_url":"https://api.github.com/users/wking/repos","events_url":"https://api.github.com/users/wking/events{/privacy}","received_events_url":"https://api.github.com/users/wking/received_events","type":"User","site_admin":false},"created_at":"2015-08-27T22:49:23Z","updated_at":"2015-08-27T22:49:23Z","body":"On Thu, Aug 27, 2015 at 01:50:11PM -0700, Brandon Philips wrote:\n> Ehhh, I don't think we need this level of flexibility. If a plugin\n> intends to be invoked with a different arg0 it should symlink itself\n> to that path.\n\nThat's what BusyBox usually does, but thte #34 comments were for\n‘setup-namespace’ as args[0] for /usr/bin/docker [1].  I'm not sure if\nit's traditional to setup that symlink, but I don't have it with\nGentoo's default app-emulation/docker-1.7.1.\n\n[1]: https://github.com/opencontainers/specs/pull/34#issuecomment-126115600\n"}}