From 12dd1d0807d5422198c45a0cf4c995ad90c4934e Mon Sep 17 00:00:00 2001 From: netblue30 Date: Wed, 3 May 2017 07:43:41 -0400 Subject: --fix-sound support in firecfg --- src/man/firecfg.txt | 42 ++++++++++++++++++++++++++++++++++-------- 1 file changed, 34 insertions(+), 8 deletions(-) (limited to 'src/man/firecfg.txt') 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 @@ .TH FIRECFG 1 "MONTH YEAR" "VERSION" "firecfg man page" .SH NAME -Firecfg \- Desktop configuration program for Firejail software. +Firecfg \- Desktop integration utility for Firejail software. .SH SYNOPSIS firecfg [OPTIONS] .SH DESCRIPTION -Firecfg is the desktop configuration utility for Firejail software. The utility -creates several symbolic links to firejail executable in /usr/local/bin. +Firecfg is the desktop integration utility for Firejail sandbox. +It allows the user to sandbox applications automatically by +clicking on desktop manager icons and menus. -Firecfg also checks .desktop files in /usr/share/applications/, -replaces the full path by program name, and writes the result to $HOME/.local/share/applications/. -This allows the user to sandbox applications automatically, just by clicking on regular desktop -menus and icons. +The integration covers: +.br +.PP +.RS +- programs started in a terminal - typing "firefox" would be enough to start a sandboxed Firefox browser +.br -For more information, see \fBDESKTOP INTEGRATION\fR section in \fBman 1 firejail\fR. +.br +- programs started by clicking on desktop manager menus - all major desktop managers are supported +.br + +.br +- programs started by clicking on file icons in file manager - only Cinnamon, KDE, LXDE, MATE and XFCE +desktop managers are supported in this moment +.RE + +This brings us as very close to full desktop integration. + +To set it up, run "sudo firecfg" after installing +Firejail software, and logout/login for the integration to take effect. "sudo firecfg" should also be run after +you install new programs. If the program is supported by Firejail, the symbolic link in /usr/local/bin +will be created. For a list of programs supported by default run "ls /etc/firejail". + +For user-driven manual integration, see \fBDESKTOP INTEGRATION\fR section in \fBman 1 firejail\fR. .SH OPTIONS .TP \fB\-\-clean Remove all firejail symbolic links. .TP +\fB\-\-fix-sound +Create a proper ~/.config/pulse/client.conf file without shm support. On some PulseAudio versions, +shared memory support (shm) breaks the process ID namespace. PulseAudio software was designed +a long time ago, and the introduction of PID namespace in Linux kernel breaks their design. This was +reportedly fixed in PulseAudio version 9. If you have sound problems on your system, run +"firecfg --fix-sound" command in a terminal, followed by logout/login in order to apply the changes. +.TP \fB\-\-debug Print debug messages. .TP -- cgit v1.2.3-54-g00ecf