Skip to content

Commit

Permalink
man: document explicitly tha ReadWritePaths= cannot undo superblock r…
Browse files Browse the repository at this point in the history
…ead-only settings

Fixes: #29266
(cherry picked from commit b6be6a6)
  • Loading branch information
poettering authored and bluca committed Nov 9, 2023
1 parent 8fbc282 commit d782f37
Showing 1 changed file with 6 additions and 1 deletion.
7 changes: 6 additions & 1 deletion man/systemd.exec.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1556,7 +1556,12 @@ StateDirectory=aaa/bbb ccc</programlisting>
permit this. Nest <varname>ReadWritePaths=</varname> inside of <varname>ReadOnlyPaths=</varname> in
order to provide writable subdirectories within read-only directories. Use
<varname>ReadWritePaths=</varname> in order to allow-list specific paths for write access if
<varname>ProtectSystem=strict</varname> is used.</para>
<varname>ProtectSystem=strict</varname> is used. Note that <varname>ReadWritePaths=</varname> cannot
be used to gain write access to a file system whose superblock is mounted read-only. On Linux, for
each mount point write access is granted only if the mount point itself <emphasis>and</emphasis> the
file system superblock backing it are not marked read-only. <varname>ReadWritePaths=</varname> only
controls the former, not the latter, hence a read-only file system superblock remains
protected.</para>

<para>Paths listed in <varname>InaccessiblePaths=</varname> will be made inaccessible for processes inside
the namespace along with everything below them in the file system hierarchy. This may be more restrictive than
Expand Down

0 comments on commit d782f37

Please sign in to comment.