aboutsummaryrefslogtreecommitdiffstats
path: root/src/man/firejail.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/man/firejail.txt')
-rw-r--r--src/man/firejail.txt136
1 files changed, 136 insertions, 0 deletions
diff --git a/src/man/firejail.txt b/src/man/firejail.txt
index fae97ceb7..982b40d89 100644
--- a/src/man/firejail.txt
+++ b/src/man/firejail.txt
@@ -326,6 +326,22 @@ $ firejail \-\-list
326$ firejail \-\-cpu.print=3272 326$ firejail \-\-cpu.print=3272
327 327
328.TP 328.TP
329\fB\-\-dbus-log=file
330Specify the location for the DBus log file.
331.br
332
333.br
334The log file contains events for both the system and session buses if both of
335the --dbus-sysem.log and --dbus-user.log options are specified. If no log file
336path is given, logs are written to the standard output instead.
337.br
338
339.br
340Example:
341.br
342$ firejail --dbus-system=filter --dbus-system.log --dbus-log=dbus.txt
343
344.TP
329\fB\-\-dbus-system=filter|none 345\fB\-\-dbus-system=filter|none
330Set system DBus sandboxing policy. 346Set system DBus sandboxing policy.
331.br 347.br
@@ -353,6 +369,52 @@ Example:
353$ firejail \-\-dbus-system=none 369$ firejail \-\-dbus-system=none
354 370
355.TP 371.TP
372\fB\-\-dbus-system.broadcast=name=[member][@path]
373Allows the application to receive broadcast signals from theindicated interface
374member at the indicated object path exposed by the indicated bus name on the
375system DBus.
376The name may have a .* suffix to match all names underneath it, including
377itself.
378The interface member may have a .* to match all members of an interface, or be * to match all interfaces.
379The path may have a /* suffix to indicate all objects underneath it, including
380itself.
381Omitting the interface member or the object path will match all members and
382object paths, respectively.
383.br
384
385.br
386Example:
387.br
388$ firejail --dbus-system=filter --dbus-system.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications
389
390.TP
391\fB\-\-dbus-system.call=name=[member][@path]
392Allows the application to call the indicated interface member at the indicated
393object path exposed by the indicated bus name on the system DBus.
394The name may have a .* suffix to match all names underneath it, including
395itself.
396The interface member may have a .* to match all members of an interface, or be * to match all interfaces.
397The path may have a /* suffix to indicate all objects underneath it, including
398itself.
399Omitting the interface member or the object path will match all members and
400object paths, respectively.
401.br
402
403.br
404Example:
405.br
406$ firejail --dbus-system=filter --dbus-system.call=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications
407
408.TP
409\fB\-\-dbus-system.log
410Turn on DBus logging for the system DBus. This option requires --dbus-system=log.
411
412.br
413Example:
414.br
415$ firejail --dbus-system=filter --dbus-system.log
416
417.TP
356\fB\-\-dbus-system.own=name 418\fB\-\-dbus-system.own=name
357Allows the application to own the specified well-known name on the system DBus. 419Allows the application to own the specified well-known name on the system DBus.
358The name may have a .* suffix to match all names underneath it, including itself 420The name may have a .* suffix to match all names underneath it, including itself
@@ -366,6 +428,20 @@ Example:
366$ firejail --dbus-system=filter --dbus-system.own=org.gnome.ghex.* 428$ firejail --dbus-system=filter --dbus-system.own=org.gnome.ghex.*
367 429
368.TP 430.TP
431\fB\-\-dbus-system.see=name
432Allows the application to see, but not talk to the specified well-known name on
433the system DBus.
434The name may have a .* suffix to match all names underneath it, including itself
435(e.g. "foo.bar.*" matches "foo.bar", "foo.bar.baz" and "foo.bar.baz.quux", but
436not "foobar").
437.br
438
439.br
440Example:
441.br
442$ firejail --dbus-system=filter --dbus-system.see=org.freedesktop.Notifications
443
444.TP
369\fB\-\-dbus-system.talk=name 445\fB\-\-dbus-system.talk=name
370Allows the application to talk to the specified well-known name on the system DBus. 446Allows the application to talk to the specified well-known name on the system DBus.
371The name may have a .* suffix to match all names underneath it, including itself 447The name may have a .* suffix to match all names underneath it, including itself
@@ -406,6 +482,52 @@ Example:
406$ firejail \-\-dbus-user=none 482$ firejail \-\-dbus-user=none
407 483
408.TP 484.TP
485\fB\-\-dbus-user.broadcast=name=[member][@path]
486Allows the application to receive broadcast signals from theindicated interface
487member at the indicated object path exposed by the indicated bus name on the
488session DBus.
489The name may have a .* suffix to match all names underneath it, including
490itself.
491The interface member may have a .* to match all members of an interface, or be * to match all interfaces.
492The path may have a /* suffix to indicate all objects underneath it, including
493itself.
494Omitting the interface member or the object path will match all members and
495object paths, respectively.
496.br
497
498.br
499Example:
500.br
501$ firejail --dbus-user=filter --dbus-user.broadcast=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications
502
503.TP
504\fB\-\-dbus-user.call=name=[member][@path]
505Allows the application to call the indicated interface member at the indicated
506object path exposed by the indicated bus name on the session DBus.
507The name may have a .* suffix to match all names underneath it, including
508itself.
509The interface member may have a .* to match all members of an interface, or be * to match all interfaces.
510The path may have a /* suffix to indicate all objects underneath it, including
511itself.
512Omitting the interface member or the object path will match all members and
513object paths, respectively.
514.br
515
516.br
517Example:
518.br
519$ firejail --dbus-user=filter --dbus-user.call=org.freedesktop.Notifications=org.freedesktop.Notifications.*@/org/freedesktop/Notifications
520
521.TP
522\fB\-\-dbus-user.log
523Turn on DBus logging for the session DBus. This option requires --dbus-user=log.
524
525.br
526Example:
527.br
528$ firejail --dbus-user=filter --dbus-user.log
529
530.TP
409\fB\-\-dbus-user.own=name 531\fB\-\-dbus-user.own=name
410Allows the application to own the specified well-known name on the session DBus. 532Allows the application to own the specified well-known name on the session DBus.
411The name may have a .* suffix to match all names underneath it, including itself 533The name may have a .* suffix to match all names underneath it, including itself
@@ -432,6 +554,20 @@ Example:
432$ firejail --dbus-user=filter --dbus-user.talk=org.freedesktop.Notifications 554$ firejail --dbus-user=filter --dbus-user.talk=org.freedesktop.Notifications
433 555
434.TP 556.TP
557\fB\-\-dbus-user.see=name
558Allows the application to see, but not talk to the specified well-known name on
559the session DBus.
560The name may have a .* suffix to match all names underneath it, including itself
561(e.g. "foo.bar.*" matches "foo.bar", "foo.bar.baz" and "foo.bar.baz.quux", but
562not "foobar").
563.br
564
565.br
566Example:
567.br
568$ firejail --dbus-user=filter --dbus-user.see=org.freedesktop.Notifications
569
570.TP
435\fB\-\-debug\fR 571\fB\-\-debug\fR
436Print debug messages. 572Print debug messages.
437.br 573.br