Skip to content

Commit 66a0543

Browse files
committed
config: Require a new UTS namespace for config.json's hostname
The UTS namespace is for hostnames and NIS domain names [1]. Without a new namespace, the hostname entry would clobber the host environment's hostname. Clobbering the host's hostname or a joined-namespace's hostname might be acceptable for folks who trust their bundles, but it's not allowed by the "error out if the config specifies anything else related to that namespace" language that landed in 02b456e (Clarify behavior around namespaces paths, 2015-09-08, #158). [1]: http://man7.org/linux/man-pages/man7/namespaces.7.html Signed-off-by: W. Trevor King <[email protected]>
1 parent 98e5ff7 commit 66a0543

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

config.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ For Linux-based systems the user structure has the following fields:
104104

105105
## Hostname
106106

107-
* **`hostname`** (string, optional) as it is accessible to processes running inside.
107+
* **`hostname`** (string, optional) as it is accessible to processes running inside. On Linux, you can only set this if your bundle creates a new [UTS namespace][uts-namespace].
108108

109109
*Example*
110110

@@ -126,3 +126,5 @@ For Linux-based systems the user structure has the following fields:
126126

127127
Interpretation of the platform section of the JSON file is used to find which platform-specific sections may be available in the document.
128128
For example, if `os` is set to `linux`, then a JSON object conforming to the [Linux-specific schema](config-linux.md) SHOULD be found at the key `linux` in the `config.json`.
129+
130+
[uts-namespace]: http://man7.org/linux/man-pages/man7/namespaces.7.html

0 commit comments

Comments
 (0)