diff options
author | Carlos Garnacho <carlosg@gnome.org> | 2020-01-24 15:31:38 +0100 |
---|---|---|
committer | Carlos Garnacho <carlosg@gnome.org> | 2020-07-17 13:41:02 +0200 |
commit | 160f706b5a3f9da45ad6a3d6e0de4d205e61a0ac (patch) | |
tree | fcadacc16d9357187b53e812ba7dd13f03b1b2a0 /docs/manpages | |
parent | 69506ee6af9ebcf60fb32f38b6d4f837e962e950 (diff) | |
download | tracker-160f706b5a3f9da45ad6a3d6e0de4d205e61a0ac.tar.gz |
docs: Add tracker3-xdg-portal manpage
Diffstat (limited to 'docs/manpages')
-rw-r--r-- | docs/manpages/meson.build | 3 | ||||
-rw-r--r-- | docs/manpages/tracker-xdg-portal.1.txt | 43 |
2 files changed, 45 insertions, 1 deletions
diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build index be2fa58b5..bef5205e2 100644 --- a/docs/manpages/meson.build +++ b/docs/manpages/meson.build @@ -4,7 +4,8 @@ manpages = [ 'import', 'info', 'sparql', - 'sql' + 'sql', + 'xdg-portal', ] foreach m : manpages diff --git a/docs/manpages/tracker-xdg-portal.1.txt b/docs/manpages/tracker-xdg-portal.1.txt new file mode 100644 index 000000000..29d2ceb65 --- /dev/null +++ b/docs/manpages/tracker-xdg-portal.1.txt @@ -0,0 +1,43 @@ +tracker-xdg-portal(1) +===================== + +== NAME + +tracker-xdg-portal - Portal to Tracker endpoints + +== SYNOPSIS + +.... +tracker-xdg-portal [--version | -v] +.... + +== DESCRIPTION + +This daemon allows access to Tracker endpoints in a controlled manner. +By default access to every service is disallowed, services may be whitelisted +through additional policy in the _.flatpak-info_ file. + +When whitelisting services, the policy may define specific graph names to +allow access to, the _default_ keyword to allow access to the default +unnamed graph, or _*_ keyword to allow access to all graphs. + +== CONFIGURATION + +When interacting with sandboxed clients, the service expects the following format in the _.flatpak-info_ file: + + [Policy Tracker3] + dbus:org.example.SparqlEndpoint1=graphA;graphB;default + dbus:org.example.SparqlEndpoint2=* + +This will allow access to the endpoints behind the *org.example.SparqlEndpoint1* and *org.example.SparqlEndpoint2* bus names. Only to the *graphA* and *graphB* graph IRIs and the default unnamed graph on the first endpoint, and to all graphs in the second. + +This policy can be set when building or running the sandboxed application through the --add-policy option. This can be set via **finish-args** in the flatpak manifest, specified along the build chain in *flatpak-build-finish*(1), or modified at start time with *flatpak-run*(1). For example: + + $ flatpak run \ + --add-policy=Tracker3.dbus:org.example.SparqlEndpoint1=graphA;graphB;default \ + --add-policy=Tracker3.dbus:org.example.SparqlEndpoint2=* \ + org.freedesktop.TrackerSandbox + +== SEE ALSO + +*flatpak-build-finish*(1), *flatpak-override*(1), *flatpak-run*(1) |