Skip to content

Commit

Permalink
docs: note that blacklist/whitelist follow symlinks
Browse files Browse the repository at this point in the history
Make it more explicit that they do and add an example for each command.

Relates to netblue30#5338.
  • Loading branch information
kmk3 committed Aug 29, 2022
1 parent 8e04409 commit c78c2b4
Showing 1 changed file with 13 additions and 2 deletions.
15 changes: 13 additions & 2 deletions src/man/firejail.txt
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,13 @@ Example:
Blacklist directory or file. File globbing is supported, see \fBFILE GLOBBING\fR section for more details.
.br

.br
Symbolic link handling: Blacklisting a path that is a symbolic link will also
blacklist the path that it points to.
For example, if ~/foo is blacklisted and it points to /foo, then /foo will also
be blacklisted.
.br

.br
Example:
.br
Expand Down Expand Up @@ -2922,8 +2929,12 @@ all directories in /usr.
.br

.br
Symbolic link handling: With the exception of the user home directory, both the
link and the real file should be in the same top directory.
Symbolic link handling: Whitelisting a path that is a symbolic link will also
whitelist the path that it points to.
For example, if ~/foo is whitelisted and it points to ~/bar, then ~/bar will
also be whitelisted.
Restrictions: With the exception of the user home directory, both the link and
the real file should be in the same top directory.
For symbolic links in the user home directory, both the link and the real file
should be owned by the user.
.br
Expand Down

0 comments on commit c78c2b4

Please sign in to comment.