diff options
Diffstat (limited to 'src/man')
-rw-r--r-- | src/man/firecfg.txt | 42 | ||||
-rw-r--r-- | src/man/firejail.txt | 2 |
2 files changed, 35 insertions, 9 deletions
diff --git a/src/man/firecfg.txt b/src/man/firecfg.txt index 369c3a7e0..979d4fc06 100644 --- a/src/man/firecfg.txt +++ b/src/man/firecfg.txt | |||
@@ -1,24 +1,50 @@ | |||
1 | .TH FIRECFG 1 "MONTH YEAR" "VERSION" "firecfg man page" | 1 | .TH FIRECFG 1 "MONTH YEAR" "VERSION" "firecfg man page" |
2 | .SH NAME | 2 | .SH NAME |
3 | Firecfg \- Desktop configuration program for Firejail software. | 3 | Firecfg \- Desktop integration utility for Firejail software. |
4 | .SH SYNOPSIS | 4 | .SH SYNOPSIS |
5 | firecfg [OPTIONS] | 5 | firecfg [OPTIONS] |
6 | .SH DESCRIPTION | 6 | .SH DESCRIPTION |
7 | Firecfg is the desktop configuration utility for Firejail software. The utility | 7 | Firecfg is the desktop integration utility for Firejail sandbox. |
8 | creates several symbolic links to firejail executable in /usr/local/bin. | 8 | It allows the user to sandbox applications automatically by |
9 | clicking on desktop manager icons and menus. | ||
9 | 10 | ||
10 | Firecfg also checks .desktop files in /usr/share/applications/, | 11 | The integration covers: |
11 | replaces the full path by program name, and writes the result to $HOME/.local/share/applications/. | 12 | .br |
12 | This allows the user to sandbox applications automatically, just by clicking on regular desktop | 13 | .PP |
13 | menus and icons. | 14 | .RS |
15 | - programs started in a terminal - typing "firefox" would be enough to start a sandboxed Firefox browser | ||
16 | .br | ||
14 | 17 | ||
15 | For more information, see \fBDESKTOP INTEGRATION\fR section in \fBman 1 firejail\fR. | 18 | .br |
19 | - programs started by clicking on desktop manager menus - all major desktop managers are supported | ||
20 | .br | ||
21 | |||
22 | .br | ||
23 | - programs started by clicking on file icons in file manager - only Cinnamon, KDE, LXDE, MATE and XFCE | ||
24 | desktop managers are supported in this moment | ||
25 | .RE | ||
26 | |||
27 | This brings us as very close to full desktop integration. | ||
28 | |||
29 | To set it up, run "sudo firecfg" after installing | ||
30 | Firejail software, and logout/login for the integration to take effect. "sudo firecfg" should also be run after | ||
31 | you install new programs. If the program is supported by Firejail, the symbolic link in /usr/local/bin | ||
32 | will be created. For a list of programs supported by default run "ls /etc/firejail". | ||
33 | |||
34 | For user-driven manual integration, see \fBDESKTOP INTEGRATION\fR section in \fBman 1 firejail\fR. | ||
16 | 35 | ||
17 | .SH OPTIONS | 36 | .SH OPTIONS |
18 | .TP | 37 | .TP |
19 | \fB\-\-clean | 38 | \fB\-\-clean |
20 | Remove all firejail symbolic links. | 39 | Remove all firejail symbolic links. |
21 | .TP | 40 | .TP |
41 | \fB\-\-fix-sound | ||
42 | Create a proper ~/.config/pulse/client.conf file without shm support. On some PulseAudio versions, | ||
43 | shared memory support (shm) breaks the process ID namespace. PulseAudio software was designed | ||
44 | a long time ago, and the introduction of PID namespace in Linux kernel breaks their design. This was | ||
45 | reportedly fixed in PulseAudio version 9. If you have sound problems on your system, run | ||
46 | "firecfg --fix-sound" command in a terminal, followed by logout/login in order to apply the changes. | ||
47 | .TP | ||
22 | \fB\-\-debug | 48 | \fB\-\-debug |
23 | Print debug messages. | 49 | Print debug messages. |
24 | .TP | 50 | .TP |
diff --git a/src/man/firejail.txt b/src/man/firejail.txt index bc4c3f19a..915a0d50d 100644 --- a/src/man/firejail.txt +++ b/src/man/firejail.txt | |||
@@ -1997,7 +1997,7 @@ $ firejail --tree | |||
1997 | 1221:netblue:/usr/lib/firefox/firefox | 1997 | 1221:netblue:/usr/lib/firefox/firefox |
1998 | .RE | 1998 | .RE |
1999 | 1999 | ||
2000 | For more information, see \fBman 1 firecfg\fR. | 2000 | We provide a tool that automates all this integration, please see \fBman 1 firecfg\fR for more details. |
2001 | 2001 | ||
2002 | .SH APPARMOR | 2002 | .SH APPARMOR |
2003 | .TP | 2003 | .TP |