Merge pull request #1156 from cdoern/domainname

add domainname spec entity
opencontainers · Aug 25, 2022 · 86290f6 · 86290f6
2 parents 9ee22ab + 744912b
commit 86290f6
Show file tree

Hide file tree

Showing 4 changed files with 18 additions and 0 deletions.
diff --git a/config.md b/config.md
@@ -355,6 +355,18 @@ For Windows based systems the user structure has the following fields:
 "hostname": "mrsdalloway"
 ```
 
+## <a name="configDomainname" />Domainname
+
+* **`domainname`** (string, OPTIONAL) specifies the container's domainname as seen by processes running inside the container.
+    On Linux, for example, this will change the domainname in the [container](glossary.md#container-namespace) [UTS namespace][uts-namespace.7].
+    Depending on your [namespace configuration](config-linux.md#namespaces), the container UTS namespace may be the [runtime](glossary.md#runtime-namespace) [UTS namespace][uts-namespace.7].
+
+### Example
+
+```json
+"domainname": "foobarbaz.test"
+```
+
 ## <a name="configPlatformSpecificConfiguration" />Platform-specific configuration
 
 * **`linux`** (object, OPTIONAL) [Linux-specific configuration](config-linux.md).

diff --git a/schema/config-schema.json b/schema/config-schema.json
@@ -35,6 +35,9 @@
         "hostname": {
             "type": "string"
         },
+        "domainname": {
+            "type": "string"
+        },
         "mounts": {
             "type": "array",
             "items": {

diff --git a/schema/test/config/good/spec-example.json b/schema/test/config/good/spec-example.json
@@ -63,6 +63,7 @@
         "readonly": true
     },
     "hostname": "slartibartfast",
+    "domainname": "foobarbaz.test",
     "mounts": [
         {
             "destination": "/proc",

diff --git a/specs-go/config.go b/specs-go/config.go
@@ -12,6 +12,8 @@ type Spec struct {
 	Root *Root `json:"root,omitempty"`
 	// Hostname configures the container's hostname.
 	Hostname string `json:"hostname,omitempty"`
+	// Domainname configures the container's domainname.
+	Domainname string `json:"domainname,omitempty"`
 	// Mounts configures additional mounts (on top of Root).
 	Mounts []Mount `json:"mounts,omitempty"`
 	// Hooks configures callbacks for container lifecycle events.