Skip to content

Commit 693a16e

Browse files
committed
doc: Clarify that intermediate directories are created for files/directories
For files it looks like `root:root` and moe `0755` parents. For directories we use the target's perms.
1 parent 96f8aae commit 693a16e

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

doc/configuration-v3_0-experimental.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ The Ignition configuration is a JSON document conforming to the following specif
6060
* **_path_** (string): the mount-point of the filesystem. A non-null entry indicates that the filesystem has already been mounted by the system at the specified path. This is really only useful for "/sysroot".
6161
* **_files_** (list of objects): the list of files to be written.
6262
* **filesystem** (string): the internal identifier of the filesystem in which to write the file. This matches the last filesystem with the given identifier.
63-
* **path** (string): the absolute path to the file.
63+
* **path** (string): the absolute path to the file; any nonexistent intermediate directories will be created owned by uid 0 and mode 0755.
6464
* **_overwrite_** (boolean): whether to delete preexisting nodes at the path. Defaults to true.
6565
* **_append_** (boolean): whether to append to the specified file. Creates a new file if nothing exists at the path. Cannot be set if overwrite is set to true.
6666
* **_contents_** (object): options related to the contents of the file.
@@ -77,7 +77,7 @@ The Ignition configuration is a JSON document conforming to the following specif
7777
* **_name_** (string): the group name of the owner.
7878
* **_directories_** (list of objects): the list of directories to be created.
7979
* **filesystem** (string): the internal identifier of the filesystem in which to create the directory. This matches the last filesystem with the given identifier.
80-
* **path** (string): the absolute path to the directory.
80+
* **path** (string): the absolute path to the file; any nonexistent intermediate directories will be created with the same owner and mode.
8181
* **_overwrite_** (boolean): whether to delete preexisting nodes at the path.
8282
* **_mode_** (integer): the directory's permission mode. Note that the mode must be properly specified as a **decimal** value (i.e. 0755 -> 493).
8383
* **_user_** (object): specifies the directory's owner.

0 commit comments

Comments
 (0)