Skip to content

Commit 4d11f77

Browse files
committed
manpages: Document the new details of --nofilesystem behaviour.
1 parent 445bdde commit 4d11f77

File tree

4 files changed

+29
-0
lines changed

4 files changed

+29
-0
lines changed

Diff for: doc/flatpak-build-finish.xml

+7
Original file line numberDiff line numberDiff line change
@@ -258,6 +258,13 @@
258258
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
259259
an absolute path, or a homedir-relative path like ~/dir.
260260
This option can be used multiple times.
261+
</para><para>
262+
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
263+
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
264+
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
265+
and "--nofilesystem=host" will remove access to all previously granted locations.
266+
Note: absolute paths that happen to be inside the current users home directory are not considered for
267+
this special case.
261268
</para></listitem>
262269
</varlistentry>
263270

Diff for: doc/flatpak-build.xml

+7
Original file line numberDiff line numberDiff line change
@@ -247,6 +247,13 @@
247247
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
248248
an absolute path, or a homedir-relative path like ~/dir.
249249
This option can be used multiple times.
250+
</para><para>
251+
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
252+
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
253+
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
254+
and "--nofilesystem=host" will remove access to all previously granted locations.
255+
Note: absolute paths that happen to be inside the current users home directory are not considered for
256+
this special case.
250257
</para></listitem>
251258
</varlistentry>
252259

Diff for: doc/flatpak-override.xml

+7
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,13 @@
230230
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
231231
an absolute path, or a homedir-relative path like ~/dir.
232232
This option can be used multiple times.
233+
</para><para>
234+
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
235+
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
236+
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
237+
and "--nofilesystem=host" will remove access to all previously granted locations.
238+
Note: absolute paths that happen to be inside the current users home directory are not considered for
239+
this special case.
233240
</para></listitem>
234241
</varlistentry>
235242

Diff for: doc/flatpak-run.xml

+8
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,15 @@
381381
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
382382
an absolute path, or a homedir-relative path like ~/dir.
383383
This option can be used multiple times.
384+
</para><para>
385+
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
386+
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
387+
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
388+
and "--nofilesystem=host" will remove access to all previously granted locations.
389+
Note: absolute paths that happen to be inside the current users home directory are not considered for
390+
this special case.
384391
</para></listitem>
392+
385393
</varlistentry>
386394

387395
<varlistentry>

0 commit comments

Comments
 (0)