Skip to content

Commit 7ab816a

Browse files
committed
glossary: Explicit PID-hierarchy example for container/runtime namespaces
On today's call, Brandon asked for clarification for the namespace terminology [1]. [1]: http://ircbot.wl.linuxfoundation.org/meetings/opencontainers/2016/opencontainers.2016-05-04-17.00.log.html#l-58 Although I was running my mouth at that point, so I didn't get his statement down in the logs directly ;). Signed-off-by: W. Trevor King <[email protected]>
1 parent cbea66a commit 7ab816a

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

glossary.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,15 @@ For example, namespaces, resource limits, and mounts are all part of the contain
1616
## Container namespace
1717

1818
On Linux, a leaf in the [namespace][namespaces.7] hierarchy in which the [configured process](config.md#process-configuration) executes.
19+
For example, with a PID namespace hierarchy like:
20+
21+
| PID namespace | Parent namespace | Runtime process PID | Container process PID |
22+
| ------------- | -----------------| ------------------- | --------------------- |
23+
| *A* | - | 123 | 678 |
24+
| *B* | *A* | 45 | 90 |
25+
| *C* | *B* | 0 | 1 |
26+
27+
where the container process was launched in a new [PID namespace][pid_namespaces.7], namespace *C* (in which the container process is executing) would be the container PID namespace.
1928

2029
## JSON
2130

@@ -29,8 +38,12 @@ It reads the [configuration files](#configuration) from a [bundle](#bundle), use
2938
## Runtime namespace
3039

3140
On Linux, a leaf in the [namespace][namespaces.7] hierarchy from which the [runtime](#runtime) process is executed.
41+
With the hierarchy example in the [container namespace section](#container-namespace), namespace *B* (in which the runtime process handling [start][] is execting) would be the runtime PID namespace.
3242
New container namespaces will be created as children of the runtime namespaces.
3343

44+
[start]: runtime.md#start
45+
3446
[JSON]: http://json.org/
3547
[UTF-8]: http://www.unicode.org/versions/Unicode8.0.0/ch03.pdf
3648
[namespaces.7]: http://man7.org/linux/man-pages/man7/namespaces.7.html
49+
[pid_namespaces.7]: http://man7.org/linux/man-pages/man7/pid_namespaces.7.html

0 commit comments

Comments
 (0)