Skip to content
Permalink
Browse files Browse the repository at this point in the history
manpages: Document the new details of --nofilesystem behaviour.
  • Loading branch information
alexlarsson committed Jan 12, 2022
1 parent 445bdde commit 4d11f77
Show file tree
Hide file tree
Showing 4 changed files with 29 additions and 0 deletions.
7 changes: 7 additions & 0 deletions doc/flatpak-build-finish.xml
Expand Up @@ -258,6 +258,13 @@
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</para><para>
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
and "--nofilesystem=host" will remove access to all previously granted locations.
Note: absolute paths that happen to be inside the current users home directory are not considered for
this special case.
</para></listitem>
</varlistentry>

Expand Down
7 changes: 7 additions & 0 deletions doc/flatpak-build.xml
Expand Up @@ -247,6 +247,13 @@
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</para><para>
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
and "--nofilesystem=host" will remove access to all previously granted locations.
Note: absolute paths that happen to be inside the current users home directory are not considered for
this special case.
</para></listitem>
</varlistentry>

Expand Down
7 changes: 7 additions & 0 deletions doc/flatpak-override.xml
Expand Up @@ -230,6 +230,13 @@
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</para><para>
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
and "--nofilesystem=host" will remove access to all previously granted locations.
Note: absolute paths that happen to be inside the current users home directory are not considered for
this special case.
</para></listitem>
</varlistentry>

Expand Down
8 changes: 8 additions & 0 deletions doc/flatpak-run.xml
Expand Up @@ -381,7 +381,15 @@
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</para><para>
In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
and "--nofilesystem=host" will remove access to all previously granted locations.
Note: absolute paths that happen to be inside the current users home directory are not considered for
this special case.
</para></listitem>

</varlistentry>

<varlistentry>
Expand Down

0 comments on commit 4d11f77

Please sign in to comment.