Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add dev symbolic links in runtime_linux.md #449

Merged
merged 2 commits into from
Jun 1, 2016

Conversation

hqhq
Copy link
Contributor

@hqhq hqhq commented May 24, 2016

Some fixes in runtime_linux.md, and added dev symbolic links.

It's adapted from:
https://github.com/opencontainers/runc/blob/master/libcontainer/SPEC.md

Addresses: opencontainers/runc#760

Signed-off-by: Qiang Huang h.huangqiang@huawei.com

hqhq added 2 commits May 24, 2016 14:43
Signed-off-by: Qiang Huang <h.huangqiang@huawei.com>
@vbatts
Copy link
Member

vbatts commented May 24, 2016

SGTM, though i'll defer to others


The runtime may pass additional file descriptors to the application to support features such as [socket activation](http://0pointer.de/blog/projects/socket-activated-containers.html).
After the container has `/proc` mounted, the following standard symlinks MUST be setup within `/dev/` for the io.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd recommend wording like the existing “MUST be made available” or “MUST … supply” instead of “MUST be setup”. Config authors and runtime callers should only care about the links being there, and shouldn't care about whether it was the runtime that set them up. And runtimes that bind-mount /dev (or similar) into the container may already have these links and not need to create them themselves. I'd also like to make the timing for these required objects explicit (see the third bullet here). And cross-links between these “paths the runtime must setup if missing” sections would be good too.

@wking
Copy link
Contributor

wking commented May 24, 2016

On Tue, May 24, 2016 at 01:13:45AM -0700, Qiang Huang wrote:

  • Add dev symbolic links in runtime_linux.md

We probably want to cite proc(5) here, which has:

Most Linux MAKEDEV scripts symbolically link /dev/fd to
/proc/self/fd, in fact.

and:

Most systems provide symbolic links /dev/stdin, /dev/stdout, and
/dev/stderr, which respectively link to the files 0, 1, and 2 in
/proc/self/fd.

@crosbymichael
Copy link
Member

LGTM

@crosbymichael crosbymichael added this to the 1.0.0 milestone May 25, 2016
@mrunalp
Copy link
Contributor

mrunalp commented Jun 1, 2016

LGTM but needs rebase.

Approved with PullApprove

@crosbymichael
Copy link
Member

crosbymichael commented Jun 1, 2016

LGTM

Approved with PullApprove

@crosbymichael crosbymichael merged commit 3b166cd into opencontainers:master Jun 1, 2016
@hqhq hqhq deleted the hq_enrich_runtime_linux branch June 2, 2016 01:59
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.

None yet

5 participants