From c844f2793afa3b9832437bbdc52d6b017051f4f3 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Sun, 31 Aug 2025 14:17:55 +0530 Subject: [PATCH 1/5] Mention that Flathub flatpak-builder may contain downstream changes Closes https://github.com/flatpak/flatpak-docs/issues/599 --- docs/building-introduction.rst | 3 ++- docs/first-build.rst | 2 +- docs/flatpak-builder.rst | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/building-introduction.rst b/docs/building-introduction.rst index 367dceec..9a494348 100644 --- a/docs/building-introduction.rst +++ b/docs/building-introduction.rst @@ -21,7 +21,8 @@ at the same time, which get bundled into the build. It is packaged by several distributions and there is also a `Flatpak package `_ called -``org.flatpak.Builder`` available for it on Flathub. +``org.flatpak.Builder`` available for it on Flathub (this may contain +Flathub specific downstream modifications). The input to ``flatpak-builder`` is a manifest file. This specifies the parameters for the application that will be built, such as its name and diff --git a/docs/first-build.rst b/docs/first-build.rst index 22c79982..2c268ee0 100644 --- a/docs/first-build.rst +++ b/docs/first-build.rst @@ -16,7 +16,7 @@ popular distributions. Please also install ``flatpak-builder`` from your distribution. There is also a flatpak-builder `Flatpak package `_ -on Flathub. +on Flathub (this may contain Flathub specific downstream modifications). Then install the Flathub repository `userwide`:: diff --git a/docs/flatpak-builder.rst b/docs/flatpak-builder.rst index 4094cf8c..ae371c96 100644 --- a/docs/flatpak-builder.rst +++ b/docs/flatpak-builder.rst @@ -4,7 +4,7 @@ Flatpak Builder ``flatpak-builder`` has already been introduced in :doc:`first-build` and :doc:`building-introduction`. It is packaged by most of the popular distributions and there is also a flatpak-builder `Flatpak package `_ -on Flathub. +on Flathub (this may contain Flathub specific downstream modifications). This page provides additional details on how to use ``flatpak-builder``, including the various command options that are available. From 5888591408c9f8b8136770833ad0ad74af9280b0 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Sun, 31 Aug 2025 14:28:35 +0530 Subject: [PATCH 2/5] sandbox-permissions: Clarify security of sockets --- docs/sandbox-permissions.rst | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/docs/sandbox-permissions.rst b/docs/sandbox-permissions.rst index 345c730f..94803003 100644 --- a/docs/sandbox-permissions.rst +++ b/docs/sandbox-permissions.rst @@ -77,18 +77,28 @@ which can be used on an as-needed basis, and which should be avoided. Standard permissions ```````````````````` -The following permissions provide access to basic resources that applications -commonly require, and can therefore be freely used. +The following permissions are commonly used by applications. - ``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) sockets - ``--device=dri`` - OpenGL rendering - ``--share=ipc`` - Share IPC namespace with the host [#f1]_ - ``--share=network`` - Access the network [#f2]_ -- ``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or server defined in CUPS's ``client.conf``. Falls back to ``/var/run/cups/cups.sock``) -- ``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf --list-dir agent-socket``) -- ``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME`` -- ``--socket=pulseaudio`` - Access to PulseAudio, includes sound input (mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd`` -- ``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK`` +- ``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input + (mic), sound output/playback, MIDI and ALSA sound devices in + ``/dev/snd``. This permission can be sensitive in certain situations. +- ``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` + or server defined in CUPS's ``client.conf``. Falls back to + ``/var/run/cups/cups.sock``. +- ``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``. +- ``--socket=gpg-agent`` - Talk to the GPG agent running on host. This + may allow acquiring additional permissions that can be used to perform + priviledged GPG operations. The gives access to the socket in + ``gpgconf --list-dir agent-socket``. This is not commonly needed + unless the application interacts with GPG such as e-mail clients or + GPG frontends. +- ``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not + commonly needed unless the application interacts with SSH such as + Git clients or SSH frontends. .. note:: From 773705e69169031a565e8bea67b52dd29073f4c8 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Sun, 31 Aug 2025 14:33:00 +0530 Subject: [PATCH 3/5] extension: Document that locale extensions are only partially installed Closes https://github.com/flatpak/flatpak-docs/issues/597 --- docs/extension.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/extension.rst b/docs/extension.rst index 67ecc49a..c6fe482c 100644 --- a/docs/extension.rst +++ b/docs/extension.rst @@ -26,6 +26,11 @@ manifest. not need to be specified manually. These are automaitcally created and loaded if installed. +Note that, ``.Locale`` extensions are by default only partially +installed (only for the configued languages) by Flatpak. To install the +full locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` +can be used. + Extension point --------------- From 0ae36a0220619abe3a2e1403937fcda52e263e53 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Sun, 31 Aug 2025 14:39:31 +0530 Subject: [PATCH 4/5] extension: Document that extensions are autoloaded Fixes https://github.com/flatpak/flatpak-docs/issues/598 --- docs/extension.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/extension.rst b/docs/extension.rst index c6fe482c..c6b49940 100644 --- a/docs/extension.rst +++ b/docs/extension.rst @@ -195,6 +195,15 @@ enable-if. to ``false`` the extension will be considered unused and removed automatically when doing ``flatpak uninstall --unused``. +Extensions are automatically mounted inside the runtime or app sandbox +provided the correct branch of the extension is installed, the +extension point for that extension is specified in the app or runtime +manifest and all the conditionals in the extension point match. + +The list of loaded extensions can be found by inspecting the +``app-extensions`` and ``runtime-extensions`` keys of the ``Instance`` +group in ``/.flatpak-info`` of a running Flatpak. + Loading existing extensions --------------------------- From 0ca47132a122b6a1a8522922fd6ff4bb01eeef2a Mon Sep 17 00:00:00 2001 From: bbhtt Date: Sun, 31 Aug 2025 14:40:43 +0530 Subject: [PATCH 5/5] Update translations --- po/de/LC_MESSAGES/building-introduction.po | 43 +- po/de/LC_MESSAGES/extension.po | 227 +++++----- po/de/LC_MESSAGES/first-build.po | 13 +- po/de/LC_MESSAGES/flatpak-builder.po | 16 +- po/de/LC_MESSAGES/sandbox-permissions.po | 416 +++++++++-------- po/es/LC_MESSAGES/building-introduction.po | 43 +- po/es/LC_MESSAGES/extension.po | 227 +++++----- po/es/LC_MESSAGES/first-build.po | 13 +- po/es/LC_MESSAGES/flatpak-builder.po | 16 +- po/es/LC_MESSAGES/sandbox-permissions.po | 416 +++++++++-------- po/fr/LC_MESSAGES/building-introduction.po | 43 +- po/fr/LC_MESSAGES/extension.po | 227 +++++----- po/fr/LC_MESSAGES/first-build.po | 13 +- po/fr/LC_MESSAGES/flatpak-builder.po | 16 +- po/fr/LC_MESSAGES/sandbox-permissions.po | 416 +++++++++-------- po/ko/LC_MESSAGES/building-introduction.po | 43 +- po/ko/LC_MESSAGES/extension.po | 227 +++++----- po/ko/LC_MESSAGES/first-build.po | 13 +- po/ko/LC_MESSAGES/flatpak-builder.po | 16 +- po/ko/LC_MESSAGES/sandbox-permissions.po | 416 +++++++++-------- po/pt_BR/LC_MESSAGES/building-introduction.po | 43 +- po/pt_BR/LC_MESSAGES/extension.po | 227 +++++----- po/pt_BR/LC_MESSAGES/first-build.po | 13 +- po/pt_BR/LC_MESSAGES/flatpak-builder.po | 5 +- po/pt_BR/LC_MESSAGES/sandbox-permissions.po | 423 ++++++++++-------- po/ru/LC_MESSAGES/building-introduction.po | 43 +- po/ru/LC_MESSAGES/extension.po | 227 +++++----- po/ru/LC_MESSAGES/first-build.po | 13 +- po/ru/LC_MESSAGES/flatpak-builder.po | 5 +- po/ru/LC_MESSAGES/sandbox-permissions.po | 423 ++++++++++-------- po/zh_CN/LC_MESSAGES/building-introduction.po | 43 +- po/zh_CN/LC_MESSAGES/extension.po | 227 +++++----- po/zh_CN/LC_MESSAGES/first-build.po | 13 +- po/zh_CN/LC_MESSAGES/flatpak-builder.po | 5 +- po/zh_CN/LC_MESSAGES/sandbox-permissions.po | 419 +++++++++-------- 35 files changed, 2797 insertions(+), 2192 deletions(-) diff --git a/po/de/LC_MESSAGES/building-introduction.po b/po/de/LC_MESSAGES/building-introduction.po index 8212cb47..24394586 100644 --- a/po/de/LC_MESSAGES/building-introduction.po +++ b/po/de/LC_MESSAGES/building-introduction.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2019-06-26 05:15-0400\n" "Last-Translator: Markus Richter \n" "Language: de\n" @@ -62,10 +62,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -85,13 +86,13 @@ msgstr "" "Eines der Module (gewöhnlich das Letzte) ist der Programmcode der " "Anwendung selbst." -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "" "Das zugrundeliegende Format für den Aufruf von ``flatpak-builder`` sieht " "so aus::" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -103,30 +104,30 @@ msgstr "" "Der Inhalt von ```` kann zum Testen und Debuggen nützlich " "sein, wird aber generell als Artefakt des Build-Prozesses behandelt." -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "Das Ausführen von ``flatpak-builder`` setzt folgende Prozesse in Gang::" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "Das Build-Verzeichnis wird erzeugt, sofern es noch nicht existiert." -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "Der Quellcode wird für jedes Modul heruntergeladen und verifiziert." -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "Der Quellcode wird für jedes Modul kompiliert und installiert." -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 #, fuzzy msgid "The build is finished by setting sandbox permissions" msgstr "" "Der Erstellungsvorgang wird mit dem Setzen der Sandbox-Berechtigungen " "abgeschlossen." -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" @@ -134,17 +135,17 @@ msgstr "" "Das Resultat des Erstellungsprozesses wird zu einem Repository exportiert" " (welches erzeugt wird, wenn es nicht bereits existiert)." -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "" "Die Anwendung kann vom Repository aus installiert und anschließend " "gestartet werden." -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "Software Development Kits (SDKs)" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." @@ -153,7 +154,7 @@ msgstr "" "dessen werden Flatpak-Anwendungen innerhalb einer separaten Umgebung " "erzeugt, dem SDK." -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -166,7 +167,7 @@ msgstr "" "zu erzeugen, sowie Tools für die Erstellung und Paketierung, Header-" "Dateien, Compiler und Debugger." -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 #, fuzzy msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " @@ -178,7 +179,7 @@ msgstr "" "3.26 SDK. Anwendungen, die diese Laufzeitumgebung verwenden, werden mit " "dem zugehörigen SDK erstellt." -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 #, fuzzy msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " @@ -215,3 +216,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/extension.po b/po/de/LC_MESSAGES/extension.po index 70314481..68903d70 100644 --- a/po/de/LC_MESSAGES/extension.po +++ b/po/de/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: de\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/de/LC_MESSAGES/first-build.po b/po/de/LC_MESSAGES/first-build.po index f2c9c62d..f970ffdd 100644 --- a/po/de/LC_MESSAGES/first-build.po +++ b/po/de/LC_MESSAGES/first-build.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2019-06-26 12:05-0400\n" "Last-Translator: Markus Richter \n" "Language: de\n" @@ -52,7 +52,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -422,3 +423,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/flatpak-builder.po b/po/de/LC_MESSAGES/flatpak-builder.po index beb1532f..8dae6645 100644 --- a/po/de/LC_MESSAGES/flatpak-builder.po +++ b/po/de/LC_MESSAGES/flatpak-builder.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -27,7 +27,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../flatpak-builder.rst:9 @@ -133,3 +134,14 @@ msgstr "" #~ "available." #~ msgstr "" +#~ msgid "" +#~ "``flatpak-builder`` has already been " +#~ "introduced in :doc:`first-build` and " +#~ ":doc:`building-introduction`. It is packaged" +#~ " by most of the popular distributions" +#~ " and there is also a flatpak-" +#~ "builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/de/LC_MESSAGES/sandbox-permissions.po b/po/de/LC_MESSAGES/sandbox-permissions.po index 030a0dba..243b5c10 100644 --- a/po/de/LC_MESSAGES/sandbox-permissions.po +++ b/po/de/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -174,57 +174,62 @@ msgid "Standard permissions" msgstr "" #: ../../sandbox-permissions.rst:80 -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 msgid "``--share=network`` - Access the network [#f2]_" msgstr "" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -233,26 +238,26 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 msgid "``--socket=x11`` - Show windows using X11" msgstr "" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " "available, overrides ``x11`` socket permission. Note that you must still " "use ``--socket=wayland`` for wayland permission" msgstr "" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -264,315 +269,315 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" "=session-bus`` stops the filtering and using them is a security risk. So " "they must be avoided, unless the application is a development tool." msgstr "" -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 msgid "" "As a general rule, static and permanent filesystem access should be " "limited as much as possible. This includes:" msgstr "" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." msgstr "" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "" -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Access the home directory" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 msgid "" "The ``--persist=DIR`` option can be used to map directories from the " "user's home directory into the sandbox filesystem. This only works if the" @@ -580,7 +585,7 @@ msgid "" "includes ``home``." msgstr "" -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -591,48 +596,48 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 msgid "" "This makes it possible to avoid configuring access to the entire home " "directory, and can be useful for applications that hardcode file paths in" " ``~/``." msgstr "" -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " "add a wrapper script that sets it to ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``" " (tmpfs) or ``/var/tmp`` (persistent on host)." msgstr "" -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." msgstr "" -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -640,44 +645,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -687,96 +692,96 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 msgid "" "While not ideal, ``--device=all`` can be used to access devices like " "webcams, CD/DVD drives etc." msgstr "" -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 msgid "USB portal" msgstr "" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -785,59 +790,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -848,17 +853,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -868,63 +873,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -934,24 +939,24 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." msgstr "" -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " "newer." msgstr "" -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -960,17 +965,17 @@ msgid "" " (case is ignored and ``_`` and ``-`` are treated equal)." msgstr "" -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" msgstr "" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "" -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -978,11 +983,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -990,47 +995,47 @@ msgid "" "application's sandbox." msgstr "" -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." msgstr "" -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." msgstr "" -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " "FUSE paths." msgstr "" -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " "native files appear under ``/run/user/`id -u`/gvfs/``." msgstr "" -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1046,11 +1051,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1058,30 +1063,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1090,7 +1095,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1407,3 +1412,36 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/building-introduction.po b/po/es/LC_MESSAGES/building-introduction.po index 27aeac0a..86533015 100644 --- a/po/es/LC_MESSAGES/building-introduction.po +++ b/po/es/LC_MESSAGES/building-introduction.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -54,10 +54,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -68,11 +69,11 @@ msgid "" "application code itself." msgstr "" -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -80,47 +81,47 @@ msgid "" "purposes, but is generally treated as an artifact of the build process." msgstr "" -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 msgid "The build is finished by setting sandbox permissions" msgstr "" -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" msgstr "" -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "" -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." msgstr "" -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -128,14 +129,14 @@ msgid "" "packaging tools, header files, compilers and debuggers." msgstr "" -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " "43 runtime and a GNOME 43 SDK. Applications that use the runtime are " "built with the matching SDK." msgstr "" -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " "but if you do need to manually install them, they are installed in the " @@ -188,3 +189,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/extension.po b/po/es/LC_MESSAGES/extension.po index e2e88fe4..050e4ee3 100644 --- a/po/es/LC_MESSAGES/extension.po +++ b/po/es/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: es\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/es/LC_MESSAGES/first-build.po b/po/es/LC_MESSAGES/first-build.po index 775a43ea..09b6b6cc 100644 --- a/po/es/LC_MESSAGES/first-build.po +++ b/po/es/LC_MESSAGES/first-build.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -47,7 +47,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -425,3 +426,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/flatpak-builder.po b/po/es/LC_MESSAGES/flatpak-builder.po index c1e4d143..a16ddfd5 100644 --- a/po/es/LC_MESSAGES/flatpak-builder.po +++ b/po/es/LC_MESSAGES/flatpak-builder.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -27,7 +27,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../flatpak-builder.rst:9 @@ -133,3 +134,14 @@ msgstr "" #~ "available." #~ msgstr "" +#~ msgid "" +#~ "``flatpak-builder`` has already been " +#~ "introduced in :doc:`first-build` and " +#~ ":doc:`building-introduction`. It is packaged" +#~ " by most of the popular distributions" +#~ " and there is also a flatpak-" +#~ "builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/es/LC_MESSAGES/sandbox-permissions.po b/po/es/LC_MESSAGES/sandbox-permissions.po index dcb8150a..4367ddc3 100644 --- a/po/es/LC_MESSAGES/sandbox-permissions.po +++ b/po/es/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -174,57 +174,62 @@ msgid "Standard permissions" msgstr "" #: ../../sandbox-permissions.rst:80 -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 msgid "``--share=network`` - Access the network [#f2]_" msgstr "" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -233,26 +238,26 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 msgid "``--socket=x11`` - Show windows using X11" msgstr "" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " "available, overrides ``x11`` socket permission. Note that you must still " "use ``--socket=wayland`` for wayland permission" msgstr "" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -264,315 +269,315 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" "=session-bus`` stops the filtering and using them is a security risk. So " "they must be avoided, unless the application is a development tool." msgstr "" -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 msgid "" "As a general rule, static and permanent filesystem access should be " "limited as much as possible. This includes:" msgstr "" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." msgstr "" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "" -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Access the home directory" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 msgid "" "The ``--persist=DIR`` option can be used to map directories from the " "user's home directory into the sandbox filesystem. This only works if the" @@ -580,7 +585,7 @@ msgid "" "includes ``home``." msgstr "" -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -591,48 +596,48 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 msgid "" "This makes it possible to avoid configuring access to the entire home " "directory, and can be useful for applications that hardcode file paths in" " ``~/``." msgstr "" -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " "add a wrapper script that sets it to ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``" " (tmpfs) or ``/var/tmp`` (persistent on host)." msgstr "" -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." msgstr "" -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -640,44 +645,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -687,96 +692,96 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 msgid "" "While not ideal, ``--device=all`` can be used to access devices like " "webcams, CD/DVD drives etc." msgstr "" -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 msgid "USB portal" msgstr "" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -785,59 +790,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -848,17 +853,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -868,63 +873,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -934,24 +939,24 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." msgstr "" -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " "newer." msgstr "" -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -960,17 +965,17 @@ msgid "" " (case is ignored and ``_`` and ``-`` are treated equal)." msgstr "" -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" msgstr "" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "" -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -978,11 +983,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -990,47 +995,47 @@ msgid "" "application's sandbox." msgstr "" -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." msgstr "" -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." msgstr "" -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " "FUSE paths." msgstr "" -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " "native files appear under ``/run/user/`id -u`/gvfs/``." msgstr "" -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1046,11 +1051,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1058,30 +1063,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1090,7 +1095,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1407,3 +1412,36 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/building-introduction.po b/po/fr/LC_MESSAGES/building-introduction.po index 2a589e85..212474c0 100644 --- a/po/fr/LC_MESSAGES/building-introduction.po +++ b/po/fr/LC_MESSAGES/building-introduction.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 11:20-0400\n" "Last-Translator: Baptiste Mille-Mathias " "\n" @@ -56,10 +56,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -70,11 +71,11 @@ msgid "" "application code itself." msgstr "" -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -82,47 +83,47 @@ msgid "" "purposes, but is generally treated as an artifact of the build process." msgstr "" -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 msgid "The build is finished by setting sandbox permissions" msgstr "" -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" msgstr "" -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "" -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." msgstr "" -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -130,14 +131,14 @@ msgid "" "packaging tools, header files, compilers and debuggers." msgstr "" -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " "43 runtime and a GNOME 43 SDK. Applications that use the runtime are " "built with the matching SDK." msgstr "" -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " "but if you do need to manually install them, they are installed in the " @@ -190,3 +191,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/extension.po b/po/fr/LC_MESSAGES/extension.po index f58ee1a5..13b3b594 100644 --- a/po/fr/LC_MESSAGES/extension.po +++ b/po/fr/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: fr\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/fr/LC_MESSAGES/first-build.po b/po/fr/LC_MESSAGES/first-build.po index 66432a1e..2a0a1568 100644 --- a/po/fr/LC_MESSAGES/first-build.po +++ b/po/fr/LC_MESSAGES/first-build.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 05:13-0400\n" "Last-Translator: Baptiste Mille-Mathias " "\n" @@ -53,7 +53,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -393,3 +394,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/flatpak-builder.po b/po/fr/LC_MESSAGES/flatpak-builder.po index 8e1b88de..e5866f32 100644 --- a/po/fr/LC_MESSAGES/flatpak-builder.po +++ b/po/fr/LC_MESSAGES/flatpak-builder.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 04:48-0400\n" "Last-Translator: Baptiste Mille-Mathias " "\n" @@ -29,7 +29,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../flatpak-builder.rst:9 @@ -135,3 +136,14 @@ msgstr "" #~ "available." #~ msgstr "" +#~ msgid "" +#~ "``flatpak-builder`` has already been " +#~ "introduced in :doc:`first-build` and " +#~ ":doc:`building-introduction`. It is packaged" +#~ " by most of the popular distributions" +#~ " and there is also a flatpak-" +#~ "builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/fr/LC_MESSAGES/sandbox-permissions.po b/po/fr/LC_MESSAGES/sandbox-permissions.po index 7b941c90..ce8b1efd 100644 --- a/po/fr/LC_MESSAGES/sandbox-permissions.po +++ b/po/fr/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -174,57 +174,62 @@ msgid "Standard permissions" msgstr "" #: ../../sandbox-permissions.rst:80 -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 msgid "``--share=network`` - Access the network [#f2]_" msgstr "" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -233,26 +238,26 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 msgid "``--socket=x11`` - Show windows using X11" msgstr "" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " "available, overrides ``x11`` socket permission. Note that you must still " "use ``--socket=wayland`` for wayland permission" msgstr "" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -264,315 +269,315 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" "=session-bus`` stops the filtering and using them is a security risk. So " "they must be avoided, unless the application is a development tool." msgstr "" -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 msgid "" "As a general rule, static and permanent filesystem access should be " "limited as much as possible. This includes:" msgstr "" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." msgstr "" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "" -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Access the home directory" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 msgid "" "The ``--persist=DIR`` option can be used to map directories from the " "user's home directory into the sandbox filesystem. This only works if the" @@ -580,7 +585,7 @@ msgid "" "includes ``home``." msgstr "" -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -591,48 +596,48 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 msgid "" "This makes it possible to avoid configuring access to the entire home " "directory, and can be useful for applications that hardcode file paths in" " ``~/``." msgstr "" -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " "add a wrapper script that sets it to ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``" " (tmpfs) or ``/var/tmp`` (persistent on host)." msgstr "" -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." msgstr "" -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -640,44 +645,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -687,96 +692,96 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 msgid "" "While not ideal, ``--device=all`` can be used to access devices like " "webcams, CD/DVD drives etc." msgstr "" -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 msgid "USB portal" msgstr "" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -785,59 +790,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -848,17 +853,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -868,63 +873,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -934,24 +939,24 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." msgstr "" -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " "newer." msgstr "" -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -960,17 +965,17 @@ msgid "" " (case is ignored and ``_`` and ``-`` are treated equal)." msgstr "" -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" msgstr "" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "" -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -978,11 +983,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -990,47 +995,47 @@ msgid "" "application's sandbox." msgstr "" -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." msgstr "" -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." msgstr "" -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " "FUSE paths." msgstr "" -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " "native files appear under ``/run/user/`id -u`/gvfs/``." msgstr "" -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1046,11 +1051,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1058,30 +1063,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1090,7 +1095,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1407,3 +1412,36 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/building-introduction.po b/po/ko/LC_MESSAGES/building-introduction.po index ef99e41c..863226e0 100644 --- a/po/ko/LC_MESSAGES/building-introduction.po +++ b/po/ko/LC_MESSAGES/building-introduction.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -54,10 +54,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -68,11 +69,11 @@ msgid "" "application code itself." msgstr "" -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -80,47 +81,47 @@ msgid "" "purposes, but is generally treated as an artifact of the build process." msgstr "" -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 msgid "The build is finished by setting sandbox permissions" msgstr "" -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" msgstr "" -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "" -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." msgstr "" -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -128,14 +129,14 @@ msgid "" "packaging tools, header files, compilers and debuggers." msgstr "" -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " "43 runtime and a GNOME 43 SDK. Applications that use the runtime are " "built with the matching SDK." msgstr "" -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " "but if you do need to manually install them, they are installed in the " @@ -188,3 +189,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/extension.po b/po/ko/LC_MESSAGES/extension.po index 9bb3f127..8a8c5104 100644 --- a/po/ko/LC_MESSAGES/extension.po +++ b/po/ko/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ko\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/ko/LC_MESSAGES/first-build.po b/po/ko/LC_MESSAGES/first-build.po index 3c9a2c89..5f6173b2 100644 --- a/po/ko/LC_MESSAGES/first-build.po +++ b/po/ko/LC_MESSAGES/first-build.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -48,7 +48,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -386,3 +387,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/flatpak-builder.po b/po/ko/LC_MESSAGES/flatpak-builder.po index 178c6752..0da11b73 100644 --- a/po/ko/LC_MESSAGES/flatpak-builder.po +++ b/po/ko/LC_MESSAGES/flatpak-builder.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -28,7 +28,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../flatpak-builder.rst:9 @@ -145,3 +146,14 @@ msgstr "" #~ "available." #~ msgstr "" +#~ msgid "" +#~ "``flatpak-builder`` has already been " +#~ "introduced in :doc:`first-build` and " +#~ ":doc:`building-introduction`. It is packaged" +#~ " by most of the popular distributions" +#~ " and there is also a flatpak-" +#~ "builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/ko/LC_MESSAGES/sandbox-permissions.po b/po/ko/LC_MESSAGES/sandbox-permissions.po index 42d0b0c5..a9c6de03 100644 --- a/po/ko/LC_MESSAGES/sandbox-permissions.po +++ b/po/ko/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -177,59 +177,64 @@ msgid "Standard permissions" msgstr "샌드박스 권한" #: ../../sandbox-permissions.rst:80 -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 #, fuzzy msgid "``--device=dri`` - OpenGL rendering" msgstr "``—device=dri``" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 #, fuzzy msgid "``--share=network`` - Access the network [#f2]_" msgstr "``—share=network``" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -238,27 +243,27 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 #, fuzzy msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "``—socket=pulseaudio``" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 msgid "``--socket=x11`` - Show windows using X11" msgstr "" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " "available, overrides ``x11`` socket permission. Note that you must still " "use ``--socket=wayland`` for wayland permission" msgstr "" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -270,316 +275,316 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" "=session-bus`` stops the filtering and using them is a security risk. So " "they must be avoided, unless the application is a development tool." msgstr "" -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 msgid "" "As a general rule, static and permanent filesystem access should be " "limited as much as possible. This includes:" msgstr "" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." msgstr "" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "" -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 #, fuzzy msgid "Access the home directory" msgstr "네트워크 [#f2]_ 접근" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 msgid "" "The ``--persist=DIR`` option can be used to map directories from the " "user's home directory into the sandbox filesystem. This only works if the" @@ -587,7 +592,7 @@ msgid "" "includes ``home``." msgstr "" -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -598,48 +603,48 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 msgid "" "This makes it possible to avoid configuring access to the entire home " "directory, and can be useful for applications that hardcode file paths in" " ``~/``." msgstr "" -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " "add a wrapper script that sets it to ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``" " (tmpfs) or ``/var/tmp`` (persistent on host)." msgstr "" -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." msgstr "" -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -647,44 +652,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -694,96 +699,96 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 msgid "" "While not ideal, ``--device=all`` can be used to access devices like " "webcams, CD/DVD drives etc." msgstr "" -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 msgid "USB portal" msgstr "" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -792,59 +797,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -855,17 +860,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -875,63 +880,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -941,24 +946,24 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." msgstr "" -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " "newer." msgstr "" -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -967,17 +972,17 @@ msgid "" " (case is ignored and ``_`` and ``-`` are treated equal)." msgstr "" -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" msgstr "" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "" -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -985,11 +990,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -997,47 +1002,47 @@ msgid "" "application's sandbox." msgstr "" -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." msgstr "" -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." msgstr "" -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " "FUSE paths." msgstr "" -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " "native files appear under ``/run/user/`id -u`/gvfs/``." msgstr "" -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1053,11 +1058,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1065,30 +1070,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1097,7 +1102,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1411,3 +1416,36 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/building-introduction.po b/po/pt_BR/LC_MESSAGES/building-introduction.po index 66e78a2e..5a9824ee 100644 --- a/po/pt_BR/LC_MESSAGES/building-introduction.po +++ b/po/pt_BR/LC_MESSAGES/building-introduction.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-05-31 14:21-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -62,10 +62,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -83,11 +84,11 @@ msgstr "" "arquivos ou repositórios de controle de versão. Um dos módulos " "(geralmente o último) é o próprio código do aplicativo." -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "O formato básico usado para chamar o ``flatpak-builder`` é::" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -99,27 +100,27 @@ msgstr "" "conteúdo de ```` pode ser útil para fins de teste e depuração," " mas geralmente é tratado como um artefato do processo de compilação." -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "Quando ``flatpak-builder`` é executado:" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "O diretório de compilação é criado, se ainda não existir" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "O código-fonte de cada módulo é baixado e verificado" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "O código-fonte de cada módulo é compilado e instalado" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 msgid "The build is finished by setting sandbox permissions" msgstr "A compilação é concluída definindo permissões de sandbox" -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" @@ -127,15 +128,15 @@ msgstr "" "O resultado da compilação é exportado para um repositório (que será " "criado se ele ainda não existir)" -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "O aplicativo pode ser instalado a partir do repositório e executado." -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "Kit de desenvolvimento de software (SDKs)" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." @@ -144,7 +145,7 @@ msgstr "" "são criados dentro de um ambiente separado, chamado SDK (do inglês, " "“Software Development Kit”)." -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -157,7 +158,7 @@ msgstr "" "ferramentas de compilação e empacotamento, arquivos de cabeçalho, " "compiladores e depuradores." -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " "43 runtime and a GNOME 43 SDK. Applications that use the runtime are " @@ -167,7 +168,7 @@ msgstr "" "runtime do GNOME 43 e um SDK do GNOME 43. Os aplicativos que usam o " "runtime são criados com o SDK correspondente." -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " "but if you do need to manually install them, they are installed in the " @@ -202,3 +203,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/extension.po b/po/pt_BR/LC_MESSAGES/extension.po index 25dec47c..28fda0fb 100644 --- a/po/pt_BR/LC_MESSAGES/extension.po +++ b/po/pt_BR/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: pt_BR\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/pt_BR/LC_MESSAGES/first-build.po b/po/pt_BR/LC_MESSAGES/first-build.po index 59c2a811..2d1c5113 100644 --- a/po/pt_BR/LC_MESSAGES/first-build.po +++ b/po/pt_BR/LC_MESSAGES/first-build.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2022-11-03 12:06-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -51,7 +51,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -424,3 +425,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/pt_BR/LC_MESSAGES/flatpak-builder.po b/po/pt_BR/LC_MESSAGES/flatpak-builder.po index 9ed68c17..e79a6d5a 100644 --- a/po/pt_BR/LC_MESSAGES/flatpak-builder.po +++ b/po/pt_BR/LC_MESSAGES/flatpak-builder.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2022-09-29 15:20-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -29,7 +29,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" "``flatpak-builder`` já foi introduzido em :doc:`first-build` e :doc" ":`building-introduction`. Esta página fornece detalhes adicionais sobre " diff --git a/po/pt_BR/LC_MESSAGES/sandbox-permissions.po b/po/pt_BR/LC_MESSAGES/sandbox-permissions.po index 6f053331..8e880f15 100644 --- a/po/pt_BR/LC_MESSAGES/sandbox-permissions.po +++ b/po/pt_BR/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-05-31 14:38-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -222,64 +222,66 @@ msgid "Standard permissions" msgstr "Permissões padrão" #: ../../sandbox-permissions.rst:80 -#, fuzzy -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -"As seguintes permissões fornecem acesso aos recursos básicos que os " -"aplicativos geralmente exigem e, portanto, podem ser usados livremente:" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "``--device=dri`` – renderização OpenGL" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 #, fuzzy msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" "``--share=ipc`` – compartilha espaço de nome IPC com o host (necessário " "para X11)" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 #, fuzzy msgid "``--share=network`` - Access the network [#f2]_" msgstr "``--share=network`` – acessa a rede" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -288,17 +290,17 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 #, fuzzy msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "``--socket=wayland`` – mostra janelas com Wayland" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 #, fuzzy msgid "``--socket=x11`` - Show windows using X11" msgstr "``--socket=x11`` – mostra janelas usando X11" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 #, fuzzy msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " @@ -309,11 +311,11 @@ msgstr "" "estiver disponível, substitui a permissão de soquete ``x11``. Observe que" " você ainda deve usar ``--socket=wayland`` para permissão de wayland" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "Acesso a D-Bus" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -325,7 +327,7 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 #, fuzzy msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" @@ -336,37 +338,37 @@ msgstr "" "=session-bus`` deve ser evitado, a menos que o aplicativo seja uma " "ferramenta de desenvolvimento." -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "**Propriedade**" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "**Conversa**" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "Acesso ao sistema de arquivos" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 #, fuzzy msgid "" "As a general rule, static and permanent filesystem access should be " @@ -375,7 +377,7 @@ msgstr "" "Como regra geral, o acesso ao sistema de arquivos deve ser limitado o " "máximo possível. Isso inclui o uso de:" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." @@ -383,267 +385,267 @@ msgstr "" "Usar portais como uma alternativa ao acesso geral ao sistema de arquivos," " sempre que possível" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "Usar acesso somente leitura sempre que possível, usando a opção ``:ro``." -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 #, fuzzy msgid "Access the home directory" msgstr "``--filesystem=home`` – acessa a pasta pessoal (home) do usuário" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 #, fuzzy msgid "" "The ``--persist=DIR`` option can be used to map directories from the " @@ -657,7 +659,7 @@ msgstr "" " e pode ser útil para aplicativos que codificam os caminhos do arquivo em" " ``~/``." -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -668,18 +670,18 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 #, fuzzy msgid "" "This makes it possible to avoid configuring access to the entire home " @@ -692,7 +694,7 @@ msgstr "" " e pode ser útil para aplicativos que codificam os caminhos do arquivo em" " ``~/``." -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 #, fuzzy msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " @@ -703,7 +705,7 @@ msgstr "" " querer adicionar um script wrapper que o defina como " "``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``." -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." @@ -711,17 +713,17 @@ msgstr "" "Reter e compartilhar a configuração com instalações que não sejam do " "Flatpak deve ser evitado." -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -729,44 +731,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -776,76 +778,76 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "Acesso a dispositivo" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 #, fuzzy msgid "" "While not ideal, ``--device=all`` can be used to access devices like " @@ -854,22 +856,22 @@ msgstr "" "Embora não seja o ideal, ``--device=all`` pode ser usado para acessar " "dispositivos como controladores ou webcams." -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 #, fuzzy msgid "USB portal" msgstr "Portais" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -878,59 +880,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -941,17 +943,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -961,63 +963,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -1027,11 +1029,11 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "Acesso a dconf" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." @@ -1039,7 +1041,7 @@ msgstr "" "No xdg-desktop-portal 1.1.0 e glib 2.60.5 (no runtime), você não precisa " "de acesso direto ao DConf na maioria dos casos." -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " @@ -1049,7 +1051,7 @@ msgstr "" "``org.freedesktop.Platform//19.08`` e ``org.gnome.Platform//3.34`` e mais" " novos." -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -1064,7 +1066,7 @@ msgstr "" "semelhante ao seu ID de aplicativo ou não será permitido (não diferencia " "maiúsculo de minúsculo, e ``_`` e `` -`` são tratados da mesma forma)." -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" @@ -1072,11 +1074,11 @@ msgstr "" "Se você estiver direcionando runtimes mais antigos ou precisar de acesso " "direto ao DConf por outros motivos, poderá usar estas permissões::" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "Com essas permissões, o glib continuará usando o dconf diretamente." -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -1084,11 +1086,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "Acesso a gvfs" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -1100,7 +1102,7 @@ msgstr "" "infraestrutura do gvfs ainda funcione quando o suporte à rede estiver " "desabilitado no isolamento do aplicativo." -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." @@ -1108,7 +1110,7 @@ msgstr "" "Várias opções diferentes precisam ser passadas dependendo do uso de gvfs " "do aplicativo." -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." @@ -1116,7 +1118,7 @@ msgstr "" "``--talk-name=org.gtk.vfs.*`` é necessário para falar com os daemons do " "gvfs sobre D-Bus e listar montagens usando as APIs do GIO." -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " @@ -1126,7 +1128,7 @@ msgstr "" "listar e acessar arquivos não nativos usando as APIs do GIO, usando URLs " "em vez de caminhos FUSE." -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " @@ -1136,15 +1138,15 @@ msgstr "" "FUSE não-GIO e aplicativos legados podem usar. Isto é o que fará com que " "os arquivos nativos apareçam em ``/run/user/`id -u`/gvfs/``." -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "Os aplicativos GNOME e GTK típicos devem usar::" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "Os aplicativos não-GNOME e não-GTK típicos devem usar::" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." @@ -1152,7 +1154,7 @@ msgstr "" "Nenhum aplicativo deve usar ``--talk-name=org.gtk.vfs`` em seu manifesto," " pois não há serviços D-Bus chamados ``org.gtk.vfs``." -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1168,11 +1170,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1180,30 +1182,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1212,7 +1214,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1437,3 +1439,40 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" +#~ "As seguintes permissões fornecem acesso " +#~ "aos recursos básicos que os aplicativos" +#~ " geralmente exigem e, portanto, podem " +#~ "ser usados livremente:" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/building-introduction.po b/po/ru/LC_MESSAGES/building-introduction.po index 5b6d508f..ba774051 100644 --- a/po/ru/LC_MESSAGES/building-introduction.po +++ b/po/ru/LC_MESSAGES/building-introduction.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-02-03 23:03+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -62,10 +62,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -83,11 +84,11 @@ msgstr "" "ссылки на файловые архивы или репозитории системы контроля версий. Один " "из модулей (обычно последний) - это сам код приложения." -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "Основной формат, используемый для вызова ``flatpak-builder``::" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -99,27 +100,27 @@ msgstr "" "```` может быть полезно для целей тестирования и отладки, но " "обычно рассматривается как артефакт процесса сборки." -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "При запуске ``Flatpak-builder``:" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "Каталог сборки создается, если он еще не существует" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "Исходный код для каждого модуля загружается и проверяется" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "Исходный код для каждого модуля собран и установлен" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 msgid "The build is finished by setting sandbox permissions" msgstr "Сборка завершается установкой разрешений для песочницы." -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" @@ -127,15 +128,15 @@ msgstr "" "Результат сборки экспортируется в репозиторий (который будет создан, если" " он еще не существует)." -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "Затем приложение можно установить из репозитория и запустить." -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "Наборы для разработки программного обеспечения (SDK)" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." @@ -143,7 +144,7 @@ msgstr "" "Вместо создания с использованием среды хоста, приложения Flatpak " "создаются в отдельной среде, называемой SDK." -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -155,7 +156,7 @@ msgstr "" "разработки, необходимые для создания приложения, такие как средства " "сборки и упаковки, файлы заголовков, компиляторы и отладчики." -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " "43 runtime and a GNOME 43 SDK. Applications that use the runtime are " @@ -165,7 +166,7 @@ msgstr "" " среда выполнения GNOME 43, так и SDK GNOME 43. Приложения, использующие " "среду выполнения, создаются с использованием соответствующего SDK." -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " "but if you do need to manually install them, they are installed in the " @@ -200,3 +201,11 @@ msgstr "" #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/extension.po b/po/ru/LC_MESSAGES/extension.po index 6c16c551..6a6f0976 100644 --- a/po/ru/LC_MESSAGES/extension.po +++ b/po/ru/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ru\n" @@ -67,35 +67,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -103,13 +111,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -118,7 +126,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -126,7 +134,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -135,7 +143,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -145,7 +153,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -153,25 +161,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -181,11 +189,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -194,7 +202,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -202,7 +210,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -520,7 +543,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -528,17 +551,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -548,11 +571,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -562,7 +585,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -572,11 +595,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -592,34 +615,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -627,11 +650,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -640,7 +663,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -651,11 +674,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/ru/LC_MESSAGES/first-build.po b/po/ru/LC_MESSAGES/first-build.po index 7f9f50d6..6050dca0 100644 --- a/po/ru/LC_MESSAGES/first-build.po +++ b/po/ru/LC_MESSAGES/first-build.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-02-04 00:38+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -52,7 +52,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -407,3 +408,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/ru/LC_MESSAGES/flatpak-builder.po b/po/ru/LC_MESSAGES/flatpak-builder.po index a0d1e4d7..0a7e65dd 100644 --- a/po/ru/LC_MESSAGES/flatpak-builder.po +++ b/po/ru/LC_MESSAGES/flatpak-builder.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-02-04 00:45+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -30,7 +30,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" "``flatpak-builder`` уже был представлен в :doc:`first-build` и :doc" ":`building-Introduction`. На этой странице представлены дополнительные " diff --git a/po/ru/LC_MESSAGES/sandbox-permissions.po b/po/ru/LC_MESSAGES/sandbox-permissions.po index 7685a9e5..f595ba84 100644 --- a/po/ru/LC_MESSAGES/sandbox-permissions.po +++ b/po/ru/LC_MESSAGES/sandbox-permissions.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: https://github.com/flatpak/flatpak-docs/issues\n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2023-11-06 23:55+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -223,64 +223,66 @@ msgid "Standard permissions" msgstr "Стандартные разрешения" #: ../../sandbox-permissions.rst:80 -#, fuzzy -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." +msgid "The following permissions are commonly used by applications." msgstr "" -"Следующие разрешения обеспечивают доступ к основным ресурсам, которые " -"обычно требуются приложениям и поэтому могут быть свободно использованы:" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "``--device=dri`` - отрисовка OpenGL" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 #, fuzzy msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "" "``--share=ipc`` - совместно использовать пространство имен IPC с хостом " "(необходимо для X11)" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 #, fuzzy msgid "``--share=network`` - Access the network [#f2]_" msgstr "``--share=network`` - доступ к сети" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -289,17 +291,17 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 #, fuzzy msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "``--socket=wayland`` - показать окна Wayland" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 #, fuzzy msgid "``--socket=x11`` - Show windows using X11" msgstr "``--socket=x11`` - показать окна с помощью X11" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 #, fuzzy msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " @@ -311,11 +313,11 @@ msgstr "" "внимание, что вы все равно должны использовать ``--socket=wayland`` для " "разрешения wayland" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "Доступ к D-Bus" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -327,7 +329,7 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 #, fuzzy msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" @@ -338,37 +340,37 @@ msgstr "" "или ``--socket=session-bus`` если только приложение не является " "инструментом разработки." -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "**Право собственности**" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "**Разговор**" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "Доступ к файловой системе" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 #, fuzzy msgid "" "As a general rule, static and permanent filesystem access should be " @@ -377,7 +379,7 @@ msgstr "" "Как правило, доступ к файловой системе должен быть максимально ограничен." " Это включает:" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." @@ -385,269 +387,269 @@ msgstr "" "Использование порталов в качестве альтернативы общему доступу к файловой " "системе везде, где это возможно." -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "" "Использование доступа только для чтения везде, где это возможно, с " "использованием параметра ``:ro``." -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 #, fuzzy msgid "Access the home directory" msgstr "``--filesystem=home`` - доступ к домашнему каталогу пользователя" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 #, fuzzy msgid "" "The ``--persist=DIR`` option can be used to map directories from the " @@ -661,7 +663,7 @@ msgstr "" "быть полезно для приложений, которые жестко шифруют пути к файлам в " "``~/``." -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -672,18 +674,18 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 #, fuzzy msgid "" "This makes it possible to avoid configuring access to the entire home " @@ -696,7 +698,7 @@ msgstr "" "быть полезно для приложений, которые жестко шифруют пути к файлам в " "``~/``." -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 #, fuzzy msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " @@ -707,7 +709,7 @@ msgstr "" "блокировки, вы можете добавить скрипт обертки, который устанавливает его " "на ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``." -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." @@ -715,17 +717,17 @@ msgstr "" "Сохранение и совместное использование конфигурация с установкой отличной " "от Flatpak следует избегать." -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -733,44 +735,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -780,76 +782,76 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "Доступ к устройству" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 #, fuzzy msgid "" "While not ideal, ``--device=all`` can be used to access devices like " @@ -858,22 +860,22 @@ msgstr "" "Хотя это и не совсем хорошо, ``--device=all`` можно использовать для " "доступа к таким устройствам, как контроллеры или веб-камеры." -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 #, fuzzy msgid "USB portal" msgstr "Порталы" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -882,59 +884,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -945,17 +947,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -965,63 +967,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -1031,11 +1033,11 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "доступ к dconf" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." @@ -1043,7 +1045,7 @@ msgstr "" "По состоянию на xdg-desktop-portal 1.1.0 и glib 2.60.5 (во время " "выполнения) вам не нужен прямой доступ DConf в большинстве случаев." -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " @@ -1053,7 +1055,7 @@ msgstr "" "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` и " "новее." -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -1067,7 +1069,7 @@ msgstr "" "args``. Путь должен быть похож на ваше ID приложения или его не допущено" " (случай игнорируется и ``_`` и ``-`` , обработанные одинаково)." -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" @@ -1075,11 +1077,11 @@ msgstr "" "Если вы нацеливаете более старые runtimes или требуют прямых доступа " "DConf по другим причинам, вы можете использовать эти разрешения::" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "С этими разрешениями glib продолжит использовать dconf напрямую." -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -1087,11 +1089,11 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 msgid "gvfs access" msgstr "gvfs-доступ" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -1103,7 +1105,7 @@ msgstr "" "работать, когда поддержка сети отключена в изолированной программной " "среде приложения." -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." @@ -1111,7 +1113,7 @@ msgstr "" "В зависимости от того, как приложение использует gvfs, необходимо " "передать ряд различных параметров." -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." @@ -1119,7 +1121,7 @@ msgstr "" "``--talk-name=org.gtk.vfs.*`` необходим для связи с демонами gvfs через " "D-Bus и составления списка подключений с использованием GIO APIs." -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " @@ -1129,7 +1131,7 @@ msgstr "" " для просмотра и доступа к неродным файлам с использованием " "API-интерфейсов GIO, используя URL-адреса, а не пути FUSE." -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " @@ -1140,15 +1142,15 @@ msgstr "" "приложения. Это то, что заставит родные файлы появиться в ``/run/user/`id" " -u`/gvfs/``." -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "Типичные приложения GNOME и GTK должны использовать::" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "Типичные приложения, отличные от GNOME и GTK, должны использовать::" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." @@ -1156,7 +1158,7 @@ msgstr "" "Ни одно приложение не должно использовать ``--talk-name=org.gtk.vfs`` в " "своем манифесте, так как нет сервисов D-Bus с именем ``org.gtk.vfs``." -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1172,11 +1174,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1184,30 +1186,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1216,7 +1218,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1458,3 +1460,40 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "" +#~ "Следующие разрешения обеспечивают доступ к " +#~ "основным ресурсам, которые обычно требуются" +#~ " приложениям и поэтому могут быть " +#~ "свободно использованы:" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/building-introduction.po b/po/zh_CN/LC_MESSAGES/building-introduction.po index cb306c22..851d37f0 100644 --- a/po/zh_CN/LC_MESSAGES/building-introduction.po +++ b/po/zh_CN/LC_MESSAGES/building-introduction.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 09:37+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-11-03 11:05-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -55,10 +55,11 @@ msgstr "" msgid "" "It is packaged by several distributions and there is also a `Flatpak " "package `_ called " -"``org.flatpak.Builder`` available for it on Flathub." +"``org.flatpak.Builder`` available for it on Flathub (this may contain " +"Flathub specific downstream modifications)." msgstr "" -#: ../../building-introduction.rst:26 +#: ../../building-introduction.rst:27 msgid "" "The input to ``flatpak-builder`` is a manifest file. This specifies the " "parameters for the application that will be built, such as its name and " @@ -71,11 +72,11 @@ msgstr "" "输入给 ``flatpak-builder`` " "的是一个清单文件。它指定了要构建应用的参数，例如它的名字和依赖的运行时。这个清单还列出了作为构建过程的一部分构建的所有模块（不是很确定，译者注）。可以指定每个模块的源，包括指向文件存档或版本控制存储库的链接。某个模块（通常是最后一个）是应用代码它本身。" -#: ../../building-introduction.rst:34 +#: ../../building-introduction.rst:35 msgid "The basic format used to invoke ``flatpak-builder`` is::" msgstr "调用 ``flatpak-builder`` 的基本格式是:" -#: ../../building-introduction.rst:38 +#: ../../building-introduction.rst:39 msgid "" "Where ```` is the path to the directory that the application " "will be built into, and ```` is the path to a manifest file. " @@ -85,48 +86,48 @@ msgstr "" "其中 ```` 是构建应用程序的目标文件夹，```` 是清单文件的路径。```` " "中的内容可以被用来调试和测试应用程序，不过大多数情况下它只是构建过程的中间产物。" -#: ../../building-introduction.rst:43 +#: ../../building-introduction.rst:44 msgid "When ``flatpak-builder`` is run:" msgstr "当 ``flatpak-builder`` 运行的时候：" -#: ../../building-introduction.rst:45 +#: ../../building-introduction.rst:46 msgid "The build directory is created, if it doesn't already exist" msgstr "构建目录如果不存在则进行创建" -#: ../../building-introduction.rst:46 +#: ../../building-introduction.rst:47 msgid "The source code for each module is downloaded and verified" msgstr "下载和验证每个模块的源代码" -#: ../../building-introduction.rst:47 +#: ../../building-introduction.rst:48 msgid "The source code for each module is built and installed" msgstr "构建和安装每个模块的源代码" -#: ../../building-introduction.rst:48 +#: ../../building-introduction.rst:49 #, fuzzy msgid "The build is finished by setting sandbox permissions" msgstr "设置沙箱的权限并完成构建" -#: ../../building-introduction.rst:49 +#: ../../building-introduction.rst:50 msgid "" "The build result is exported to a repository (which will be created if it" " doesn't exist already)" msgstr "构建结果会被导出到仓库（如果不存在将会被创建）" -#: ../../building-introduction.rst:52 +#: ../../building-introduction.rst:53 msgid "The application can then be installed from the repository and run." msgstr "然后这个应用就可以从仓库进行安装和运行了" -#: ../../building-introduction.rst:55 +#: ../../building-introduction.rst:56 msgid "Software Development Kits (SDKs)" msgstr "软件开发套件（SDKs）" -#: ../../building-introduction.rst:57 +#: ../../building-introduction.rst:58 msgid "" "Instead of being built using the host environment, Flatpak applications " "are built inside a separate environment, called an SDK." msgstr "Flatpak应用是在一个称作SDK的隔离环境中，而不是宿主的环境中构建的。" -#: ../../building-introduction.rst:60 +#: ../../building-introduction.rst:61 msgid "" "SDKs are like the regular runtime that applications run in. The " "difference is that SDKs also include all the development resources and " @@ -134,7 +135,7 @@ msgid "" "packaging tools, header files, compilers and debuggers." msgstr "这些SDK类似与应用所运行在的常规运行时。不同的是，这些SDK还包含了构建一个应用需要的所有开发资源和工具，例如构建和打包工具、头文件、编译器和调试器" -#: ../../building-introduction.rst:65 +#: ../../building-introduction.rst:66 #, fuzzy msgid "" "Each runtime has an accompanying SDK. For example, there is both a GNOME " @@ -144,7 +145,7 @@ msgstr "" "每个运行时都有一个附带的SDK。例如，一个GNOME 3.26 runtime和一个GNOME 3.26 " "SDK同时存在。使用这个运行时的是用这个对应的SDK构建的。" -#: ../../building-introduction.rst:69 +#: ../../building-introduction.rst:70 #, fuzzy msgid "" "Like runtimes, SDKs will sometimes be automatically installed for you, " @@ -177,3 +178,11 @@ msgstr "和运行时一样，一般SDK会自动地进行安装。但是如果你 #~ "for details." #~ msgstr "" +#~ msgid "" +#~ "It is packaged by several distributions" +#~ " and there is also a `Flatpak " +#~ "package `_ " +#~ "called ``org.flatpak.Builder`` available for " +#~ "it on Flathub." +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/extension.po b/po/zh_CN/LC_MESSAGES/extension.po index d7bb14ca..9b5bb5f9 100644 --- a/po/zh_CN/LC_MESSAGES/extension.po +++ b/po/zh_CN/LC_MESSAGES/extension.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-07-21 08:16+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: zh_CN\n" @@ -66,35 +66,43 @@ msgid "" "loaded if installed." msgstr "" -#: ../../extension.rst:30 +#: ../../extension.rst:29 +msgid "" +"Note that, ``.Locale`` extensions are by default only partially installed" +" (only for the configued languages) by Flatpak. To install the full " +"locale extension ``flatpak update --subpath= $FLATPAK_ID.Locale`` can be " +"used." +msgstr "" + +#: ../../extension.rst:35 msgid "Extension point" msgstr "" -#: ../../extension.rst:32 +#: ../../extension.rst:37 msgid "" "Now to define an extension point the ``add-extensions`` property can be " "used in the manifest." msgstr "" -#: ../../extension.rst:35 +#: ../../extension.rst:40 msgid "This is a typical example of an application extension point." msgstr "" -#: ../../extension.rst:56 +#: ../../extension.rst:61 msgid "" "The details of these properties are documented in the \"Extension NAME\" " "section of :doc:`flatpak-command-reference`. Some of it is discussed " "further below." msgstr "" -#: ../../extension.rst:60 +#: ../../extension.rst:65 msgid "" "``org.flatpak.app.plugin`` is the name of the extension point. Extensions" " using this extension point must start their ID with the same prefix, for" " example ``org.flatpak.app.plugin.foo``." msgstr "" -#: ../../extension.rst:64 +#: ../../extension.rst:69 msgid "" "``version`` is the branch to use when looking for the extension. This is " "useful to have parallel installations of the same extension in case of an" @@ -102,13 +110,13 @@ msgid "" "extension manifest." msgstr "" -#: ../../extension.rst:69 +#: ../../extension.rst:74 msgid "" "If not specified it defaults to the ``runtime`` branch, that the " "extension point belongs to. So in the above example it is ``45``." msgstr "" -#: ../../extension.rst:73 +#: ../../extension.rst:78 msgid "" "``versions`` is same as ``version`` but can be used for specifying " "multiple versions. For example, if an extension is published in the " @@ -117,7 +125,7 @@ msgid "" " the application needs to have ``versions: 'stable;beta'``." msgstr "" -#: ../../extension.rst:79 +#: ../../extension.rst:84 msgid "" "``directory`` is the path relative to prefix where everything is mounted " "by flatpak. For a runtime this will be relative to ``/usr`` and for an " @@ -125,7 +133,7 @@ msgid "" "value." msgstr "" -#: ../../extension.rst:84 +#: ../../extension.rst:89 msgid "" "``add-ld-path`` adds a path relative to the extension prefix " "``/app/extension_directory/foo/lib``, so that a library residing there " @@ -134,7 +142,7 @@ msgid "" "it is put in a ld config file in ``/run/flatpak/ld.so.conf.d``." msgstr "" -#: ../../extension.rst:90 +#: ../../extension.rst:95 msgid "" "``merge-dirs: plug-ins;help`` will merge the contents of these " "directories from multiple extensions using the same extension point. For " @@ -144,7 +152,7 @@ msgid "" "``help``." msgstr "" -#: ../../extension.rst:97 +#: ../../extension.rst:102 msgid "" "``subdirectories: true`` allows to have multiple extensions under the " "same ``directory``. So two extensions like ``org.flatpak.app.plugin.foo``" @@ -152,25 +160,25 @@ msgid "" "``/app/extension_directory/foo`` and ``/app/extension_directory/bar``." msgstr "" -#: ../../extension.rst:103 +#: ../../extension.rst:108 msgid "" "``no-autodownload: true`` will prevent installing all extensions under " "this extension point. This is the default." msgstr "" -#: ../../extension.rst:106 +#: ../../extension.rst:111 msgid "" "``autodelete: true`` will remove all extensions under this extension " "point when the application is removed." msgstr "" -#: ../../extension.rst:109 +#: ../../extension.rst:114 msgid "" "``.Debug`` and ``.Locale`` extensions are created with ``autodelete: " "true`` by default." msgstr "" -#: ../../extension.rst:112 +#: ../../extension.rst:117 #, python-brace-format msgid "" "``mkdir -p ${FLATPAK_DEST}/extension_directory`` runs during the cleanup " @@ -180,11 +188,11 @@ msgid "" " If it is missing, there will be an error while running the application." msgstr "" -#: ../../extension.rst:118 +#: ../../extension.rst:123 msgid "There is no extension property to extend the ``PATH``." msgstr "" -#: ../../extension.rst:122 +#: ../../extension.rst:127 msgid "" "If the extension point is defined in a base runtime or SDK manifest " "``add-extensions`` will make the extension point land in both ``.Sdk`` " @@ -193,7 +201,7 @@ msgid "" "should be used which is discussed below." msgstr "" -#: ../../extension.rst:128 +#: ../../extension.rst:133 msgid "" "There are other properties like ``download-if``, ``enable-if``, " "``autoprune-unless`` etc. These are conditionals which must be ``true`` " @@ -201,7 +209,7 @@ msgid "" "extension points." msgstr "" -#: ../../extension.rst:133 +#: ../../extension.rst:138 msgid "" "An example of an extension point defined in runtime is the GL extension " "point used in `Freedesktop SDK = 1.3.4), can compose metadata for extensions " "automatically and it is no longer required to manually compose them " "through commands in the manifest." msgstr "" -#: ../../extension.rst:419 +#: ../../extension.rst:433 #, python-brace-format msgid "" "In case a manual compose is still required ``appstream-compose " @@ -519,7 +542,7 @@ msgid "" "compose: false`` in the top." msgstr "" -#: ../../extension.rst:424 +#: ../../extension.rst:438 msgid "" "Note that the extension prefix or location of pkg-config files will not " "be in ``$PATH`` or ``$PKG_CONFIG_PATH`` by default. Any such additional " @@ -527,17 +550,17 @@ msgid "" "``prefix`` and ``prepend-*`` properties." msgstr "" -#: ../../extension.rst:429 +#: ../../extension.rst:443 msgid "" "A MetaInfo file should be provided for discoverability in software " "stores. This is a typical example of an extension MetaInfo file." msgstr "" -#: ../../extension.rst:462 +#: ../../extension.rst:476 msgid "Bundled extensions" msgstr "" -#: ../../extension.rst:464 +#: ../../extension.rst:478 msgid "" "Extensions can also be built directly from the application manifest " "instead of creating a separate extension manifest. The ``bundle: true`` " @@ -547,11 +570,11 @@ msgid "" "``directory`` will be exported into that extension." msgstr "" -#: ../../extension.rst:496 +#: ../../extension.rst:510 msgid "Unmaintained Flatpak extensions" msgstr "" -#: ../../extension.rst:498 +#: ../../extension.rst:512 msgid "" "Flatpak also supports `unmaintained extensions` that allows loading " "extensions installed externally into ``/var/lib/flatpak/extension`` and " @@ -561,7 +584,7 @@ msgid "" "the same as above." msgstr "" -#: ../../extension.rst:505 +#: ../../extension.rst:519 msgid "" "An example of an unmaintained extension can be found in browsers such as " "`Chromium " @@ -571,11 +594,11 @@ msgid "" "/firefox-flatpak/runme.sh>`_ on Flathub." msgstr "" -#: ../../extension.rst:510 +#: ../../extension.rst:524 msgid "The Firefox snippet translates to:" msgstr "" -#: ../../extension.rst:521 +#: ../../extension.rst:535 msgid "" "Now the required policy files for Firefox ``pref`` and ``policies.json`` " "can be placed in " @@ -591,34 +614,34 @@ msgid "" " reading policies from ``/app/etc``)" msgstr "" -#: ../../extension.rst:530 +#: ../../extension.rst:544 msgid "" "For details on Chromium, please look at the `readme " "`_." msgstr "" -#: ../../extension.rst:534 +#: ../../extension.rst:548 msgid "Creating an unmaintained Gtk theme extension" msgstr "" -#: ../../extension.rst:536 +#: ../../extension.rst:550 msgid "" "The following script can be used to create an unmaintained extension for " "the host's Gtk 3 theme. This is useful when the theme is not packaged as " "an extension in a remote." msgstr "" -#: ../../extension.rst:540 +#: ../../extension.rst:554 msgid "" "The script expects the theme to be installed in ``/usr/share/themes`` or " "``$XDG_DATA_HOME/themes``." msgstr "" -#: ../../extension.rst:565 +#: ../../extension.rst:579 msgid "Extensions or extension points defined by runtime" msgstr "" -#: ../../extension.rst:567 +#: ../../extension.rst:581 msgid "" "The following extensions and extension points are defined in the " "Freedesktop runtime/SDK or are shipped along with it. Most of these are " @@ -626,11 +649,11 @@ msgid "" "time, please check the respective project." msgstr "" -#: ../../extension.rst:572 +#: ../../extension.rst:586 msgid "These are common to the Freedesktop SDK and runtime:" msgstr "" -#: ../../extension.rst:574 +#: ../../extension.rst:588 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL`` – Extension for graphics drivers managed " @@ -639,7 +662,7 @@ msgid "" " latter containing support for patented codecs." msgstr "" -#: ../../extension.rst:580 +#: ../../extension.rst:594 #, python-brace-format msgid "" "``org.freedesktop.Platform.GL.Debug`` – Debug extension point for " @@ -650,11 +673,11 @@ msgid "" "to have the debug symbols available." msgstr "" -#: ../../extension.rst:586 +#: ../../extension.rst:600 msgid "The following extensions utilise the above two extension points::" msgstr "" -#: ../../extension.rst:601 +#: ../../extension.rst:615 msgid "" "``org.freedesktop.Platform.VulkanLayer`` – Extension point for `Vulkan " "layers `_." msgstr "" -#: ../../extension.rst:653 +#: ../../extension.rst:667 msgid "" "The application developer needs to explicitly add these extensions in the" " manifest by using ``sdk-extensions`` when building an app." msgstr "" -#: ../../extension.rst:656 +#: ../../extension.rst:670 msgid "" "Extensions marked as ``Compat`` in the name or ``GL32`` provide compat " "support for extra architectures and needs to explicitly requested." msgstr "" -#: ../../extension.rst:659 +#: ../../extension.rst:673 msgid "Additionally all SDKs provide a ``.Docs`` extension for documentation." msgstr "" diff --git a/po/zh_CN/LC_MESSAGES/first-build.po b/po/zh_CN/LC_MESSAGES/first-build.po index 0d99af57..42de892f 100644 --- a/po/zh_CN/LC_MESSAGES/first-build.po +++ b/po/zh_CN/LC_MESSAGES/first-build.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-11-03 01:28-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -45,7 +45,8 @@ msgstr "" msgid "" "Please also install ``flatpak-builder`` from your distribution. There is " "also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" #: ../../first-build.rst:21 @@ -332,3 +333,11 @@ msgstr "" #~ "popular distributions." #~ msgstr "" +#~ msgid "" +#~ "Please also install ``flatpak-builder`` " +#~ "from your distribution. There is also" +#~ " a flatpak-builder `Flatpak package " +#~ "`_ on " +#~ "Flathub." +#~ msgstr "" + diff --git a/po/zh_CN/LC_MESSAGES/flatpak-builder.po b/po/zh_CN/LC_MESSAGES/flatpak-builder.po index e9a45004..b8fcfb0a 100644 --- a/po/zh_CN/LC_MESSAGES/flatpak-builder.po +++ b/po/zh_CN/LC_MESSAGES/flatpak-builder.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-12 23:23+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-11-03 01:37-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -25,7 +25,8 @@ msgid "" "``flatpak-builder`` has already been introduced in :doc:`first-build` and" " :doc:`building-introduction`. It is packaged by most of the popular " "distributions and there is also a flatpak-builder `Flatpak package " -"`_ on Flathub." +"`_ on Flathub (this may " +"contain Flathub specific downstream modifications)." msgstr "" "``flatpak-builder`` 在 :doc:`first-build` 和 :doc:`building-" "introduction` 有过介绍。这个页面提供了更为详尽的 ``flatpak-builder`` 命令使用方法，如可用的命令行选项。" diff --git a/po/zh_CN/LC_MESSAGES/sandbox-permissions.po b/po/zh_CN/LC_MESSAGES/sandbox-permissions.po index ccb530c3..58ad466c 100644 --- a/po/zh_CN/LC_MESSAGES/sandbox-permissions.po +++ b/po/zh_CN/LC_MESSAGES/sandbox-permissions.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-03-13 09:30+0530\n" +"POT-Creation-Date: 2025-08-31 14:40+0530\n" "PO-Revision-Date: 2018-11-03 02:03-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -180,60 +180,64 @@ msgid "Standard permissions" msgstr "标准权限" #: ../../sandbox-permissions.rst:80 -#, fuzzy -msgid "" -"The following permissions provide access to basic resources that " -"applications commonly require, and can therefore be freely used." -msgstr "以下权限提供了应用通常需要访问的基本资源，因此可以自由使用：" +msgid "The following permissions are commonly used by applications." +msgstr "" -#: ../../sandbox-permissions.rst:83 +#: ../../sandbox-permissions.rst:82 msgid "" "``--allow=bluetooth`` - Allow access to Bluetooth (``AF_BLUETOOTH``) " "sockets" msgstr "" -#: ../../sandbox-permissions.rst:84 +#: ../../sandbox-permissions.rst:83 msgid "``--device=dri`` - OpenGL rendering" msgstr "``--device=dri`` - OpenGL 渲染" -#: ../../sandbox-permissions.rst:85 +#: ../../sandbox-permissions.rst:84 #, fuzzy msgid "``--share=ipc`` - Share IPC namespace with the host [#f1]_" msgstr "``--share=ipc`` - 和主机共享IPC命名空间 (对于X11是必要的)" -#: ../../sandbox-permissions.rst:86 +#: ../../sandbox-permissions.rst:85 #, fuzzy msgid "``--share=network`` - Access the network [#f2]_" msgstr "``--share=network`` - 访问网络" -#: ../../sandbox-permissions.rst:87 +#: ../../sandbox-permissions.rst:86 msgid "" -"``--socket=cups`` - Talk to the CUPS printing system (``$CUPS_SERVER`` or" -" server defined in CUPS's ``client.conf``. Falls back to " -"``/var/run/cups/cups.sock``)" +"``--socket=pulseaudio`` - Access to PulseAudio. It includes sound input " +"(mic), sound output/playback, MIDI and ALSA sound devices in " +"``/dev/snd``. This permission can be sensitive in certain situations." msgstr "" -#: ../../sandbox-permissions.rst:88 +#: ../../sandbox-permissions.rst:89 msgid "" -"``--socket=gpg-agent`` - Talk to the GPG agent (The socket in ``gpgconf " -"--list-dir agent-socket``)" +"``--socket=cups`` - Talk to the CUPS printing system. ``$CUPS_SERVER`` or" +" server defined in CUPS's ``client.conf``. Falls back to " +"``/var/run/cups/cups.sock``." msgstr "" -#: ../../sandbox-permissions.rst:89 -msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#: ../../sandbox-permissions.rst:92 +msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``." msgstr "" -#: ../../sandbox-permissions.rst:90 +#: ../../sandbox-permissions.rst:93 msgid "" -"``--socket=pulseaudio`` - Access to PulseAudio, includes sound input " -"(mic), sound output/playback, MIDI and ALSA sound devices in ``/dev/snd``" +"``--socket=gpg-agent`` - Talk to the GPG agent running on host. This may " +"allow acquiring additional permissions that can be used to perform " +"priviledged GPG operations. The gives access to the socket in ``gpgconf " +"--list-dir agent-socket``. This is not commonly needed unless the " +"application interacts with GPG such as e-mail clients or GPG frontends." msgstr "" -#: ../../sandbox-permissions.rst:91 -msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#: ../../sandbox-permissions.rst:99 +msgid "" +"``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``. This is not " +"commonly needed unless the application interacts with SSH such as Git " +"clients or SSH frontends." msgstr "" -#: ../../sandbox-permissions.rst:95 +#: ../../sandbox-permissions.rst:105 msgid "" "Applications that do not support native Wayland should use only " "``--socket=x11`` and applications that do, should use " @@ -242,17 +246,17 @@ msgid "" "Wayland sessions of the desktop environment." msgstr "" -#: ../../sandbox-permissions.rst:101 +#: ../../sandbox-permissions.rst:111 #, fuzzy msgid "``--socket=wayland`` - Show windows with Wayland" msgstr "``--socket=wayland`` - 使用Wayland显示窗口" -#: ../../sandbox-permissions.rst:102 +#: ../../sandbox-permissions.rst:112 #, fuzzy msgid "``--socket=x11`` - Show windows using X11" msgstr " ``--socket=x11`` - 用X11显示窗口" -#: ../../sandbox-permissions.rst:103 +#: ../../sandbox-permissions.rst:113 #, fuzzy msgid "" "``--socket=fallback-x11`` - Show windows using X11, if Wayland is not " @@ -260,11 +264,11 @@ msgid "" "use ``--socket=wayland`` for wayland permission" msgstr "``--socket=fallback-x11`` - 如果Wayland不可用，使用X11显示窗口" -#: ../../sandbox-permissions.rst:108 +#: ../../sandbox-permissions.rst:118 msgid "D-Bus access" msgstr "D-Bus访问" -#: ../../sandbox-permissions.rst:110 +#: ../../sandbox-permissions.rst:120 msgid "" "D-Bus access is filtered by default. The default policy for the session " "bus only allows the application to own its own namespace named by " @@ -276,7 +280,7 @@ msgid "" "``org.freedesktop.portal.*``." msgstr "" -#: ../../sandbox-permissions.rst:118 +#: ../../sandbox-permissions.rst:128 #, fuzzy msgid "" "Access to the entire bus with ``--socket=system-bus`` or ``--socket" @@ -286,310 +290,310 @@ msgstr "" "避免使用 ``--socket=system-bus`` 或 ``--socket=session-bus`` " "访问整个总线，除非应用是一个开发工具。" -#: ../../sandbox-permissions.rst:123 +#: ../../sandbox-permissions.rst:133 msgid "" "``flatpak run --log-session-bus $FLATPAK_ID`` can be used to find the " "specific D-Bus permissions needed. See :ref:`debugging:Audit session or " "system bus traffic` for more information." msgstr "" -#: ../../sandbox-permissions.rst:127 +#: ../../sandbox-permissions.rst:137 msgid "**Ownership**" msgstr "**Ownership**" -#: ../../sandbox-permissions.rst:129 +#: ../../sandbox-permissions.rst:139 msgid "" "Any ownership beyond what is granted by default ie. own namespace and " "``org.mpris.MediaPlayer2.$FLATPAK_ID`` is typically unnecessary although " "there can be exceptions." msgstr "" -#: ../../sandbox-permissions.rst:133 +#: ../../sandbox-permissions.rst:143 msgid "**Talk**" msgstr "**Talk**" -#: ../../sandbox-permissions.rst:135 +#: ../../sandbox-permissions.rst:145 msgid "It is recommended to use the minimum required talk-name permissions." msgstr "" -#: ../../sandbox-permissions.rst:138 +#: ../../sandbox-permissions.rst:148 msgid "Filesystem access" msgstr "文件系统访问" -#: ../../sandbox-permissions.rst:140 +#: ../../sandbox-permissions.rst:150 #, fuzzy msgid "" "As a general rule, static and permanent filesystem access should be " "limited as much as possible. This includes:" msgstr "作为一个通用规则，对文件系统的访问应该尽可能地进行限制。这包括：" -#: ../../sandbox-permissions.rst:143 +#: ../../sandbox-permissions.rst:153 msgid "" "Using portals as an alternative to blanket filesystem access, wherever " "possible." msgstr "尽量使用门户来代替文件系统访问。" -#: ../../sandbox-permissions.rst:145 +#: ../../sandbox-permissions.rst:155 msgid "Using read-only access wherever possible, using the ``:ro`` option." msgstr "尽量使用读取权限来访问，使用 ``:ro`` 选项。" -#: ../../sandbox-permissions.rst:146 +#: ../../sandbox-permissions.rst:156 msgid "" "Using :ref:`conventions:XDG base directories` to store application's " "cache, config and state. Then no additional filesystem access would be " "required." msgstr "" -#: ../../sandbox-permissions.rst:149 +#: ../../sandbox-permissions.rst:159 msgid "" "Avoiding full home access and instead using XDG directories such as " "``xdg-music`` or ``xdg-download`` etc." msgstr "" -#: ../../sandbox-permissions.rst:152 +#: ../../sandbox-permissions.rst:162 msgid "The following permission options are available:" msgstr "" -#: ../../sandbox-permissions.rst:154 +#: ../../sandbox-permissions.rst:164 msgid "``:ro`` - read-only access" msgstr "" -#: ../../sandbox-permissions.rst:155 +#: ../../sandbox-permissions.rst:165 msgid "" "``:create`` - read/write access, and create the directory if it doesn't " "exist" msgstr "" -#: ../../sandbox-permissions.rst:158 +#: ../../sandbox-permissions.rst:168 msgid "Additionally the following permissions are available:" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "``host``" msgstr "" -#: ../../sandbox-permissions.rst:161 +#: ../../sandbox-permissions.rst:171 msgid "" "Access to ``/home, /media, /opt, /run/media, /srv`` and everything " "provided by ``host-os, host-etc`` mounted in ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:161 ../../sandbox-permissions.rst:165 -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:171 ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:176 msgid "Includes any subpaths" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "``host-etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc``" msgstr "" -#: ../../sandbox-permissions.rst:162 +#: ../../sandbox-permissions.rst:172 msgid "Host's ``/etc`` is mounted at ``/run/host/etc``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "``host-os``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 #, python-brace-format msgid "" "Host's ``/usr, /bin, /sbin, /lib{32, 64}, /etc/ld.so.cache, " "/etc/alternatives``" msgstr "" -#: ../../sandbox-permissions.rst:163 +#: ../../sandbox-permissions.rst:173 msgid "Mounted at ``/run/host``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "``home``" msgstr "" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 #, fuzzy msgid "Access the home directory" msgstr "``--filesystem=home`` - 访问用户home目录" -#: ../../sandbox-permissions.rst:164 +#: ../../sandbox-permissions.rst:174 msgid "Except ``~/.var/app``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "``/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:165 +#: ../../sandbox-permissions.rst:175 msgid "Access an arbitrary path except any reserved path" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "``~/some/dir``" msgstr "" -#: ../../sandbox-permissions.rst:166 +#: ../../sandbox-permissions.rst:176 msgid "Arbitrary path relative to the home directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``xdg-desktop``" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "Access the XDG desktop directory" msgstr "" -#: ../../sandbox-permissions.rst:167 +#: ../../sandbox-permissions.rst:177 msgid "``$XDG_DESKTOP_DIR`` or ``$HOME/Desktop``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``xdg-documents``" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "Access the XDG documents directory" msgstr "" -#: ../../sandbox-permissions.rst:168 +#: ../../sandbox-permissions.rst:178 msgid "``$XDG_DOCUMENTS_DIR`` or ``$HOME/Documents``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``xdg-download``" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "Access the XDG download directory" msgstr "" -#: ../../sandbox-permissions.rst:169 +#: ../../sandbox-permissions.rst:179 msgid "``$XDG_DOWNLOAD_DIR`` or ``$HOME/Downloads``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``xdg-music``" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "Access the XDG music directory" msgstr "" -#: ../../sandbox-permissions.rst:170 +#: ../../sandbox-permissions.rst:180 msgid "``$XDG_MUSIC_DIR`` or ``$HOME/Music``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``xdg-pictures``" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "Access the XDG pictures directory" msgstr "" -#: ../../sandbox-permissions.rst:171 +#: ../../sandbox-permissions.rst:181 msgid "``$XDG_PICTURES_DIR`` or ``$HOME/Pictures``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``xdg-public-share``" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "Access the XDG public directory" msgstr "" -#: ../../sandbox-permissions.rst:172 +#: ../../sandbox-permissions.rst:182 msgid "``$XDG_PUBLICSHARE_DIR`` or ``$HOME/Public``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``xdg-videos``" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "Access the XDG videos directory" msgstr "" -#: ../../sandbox-permissions.rst:173 +#: ../../sandbox-permissions.rst:183 msgid "``$XDG_VIDEOS_DIR`` or ``$HOME/Videos``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``xdg-templates``" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "Access the XDG templates directory" msgstr "" -#: ../../sandbox-permissions.rst:174 +#: ../../sandbox-permissions.rst:184 msgid "``$XDG_TEMPLATES_DIR`` or ``$HOME/Templates``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``xdg-config``" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "Access the XDG config directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:175 +#: ../../sandbox-permissions.rst:185 msgid "``$XDG_CONFIG_HOME`` or ``$HOME/.config``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``xdg-cache``" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "Access the XDG cache directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:176 +#: ../../sandbox-permissions.rst:186 msgid "``$XDG_CACHE_HOME`` or ``$HOME/.cache``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``xdg-data``" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "Access the XDG data directory [#f3]_" msgstr "" -#: ../../sandbox-permissions.rst:177 +#: ../../sandbox-permissions.rst:187 msgid "``$XDG_DATA_HOME`` or ``$HOME/.local/share``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``xdg-run/path``" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "Access subdirectories of the XDG runtime directory" msgstr "" -#: ../../sandbox-permissions.rst:178 +#: ../../sandbox-permissions.rst:188 msgid "``$XDG_RUNTIME_DIR/path`` (``/run/user/$UID/path``)" msgstr "" -#: ../../sandbox-permissions.rst:181 +#: ../../sandbox-permissions.rst:191 msgid "" "Except ``host, host-etc, host-os`` paths can be added to all the above " "filesystem options. For example, ``--filesystem=xdg-documents/path``." msgstr "" -#: ../../sandbox-permissions.rst:184 +#: ../../sandbox-permissions.rst:194 msgid "Other filesystem access guidelines include:" msgstr "" -#: ../../sandbox-permissions.rst:186 +#: ../../sandbox-permissions.rst:196 #, fuzzy msgid "" "The ``--persist=DIR`` option can be used to map directories from the " @@ -600,7 +604,7 @@ msgstr "" "``--persist=path`` 选项可以用来将用户目录映射到沙箱的文件系统。这可以避免配置整个home目录访问权限。并且对于在硬编码使用 " "``~/`` 文件路径的应用程序非常有用。" -#: ../../sandbox-permissions.rst:191 +#: ../../sandbox-permissions.rst:201 msgid "" "For example, if an application hardcodes the directory ``~/.foo``, " "without any ``home`` access and no ``--persist`` the directory will be " @@ -611,18 +615,18 @@ msgid "" "``~/.var/app/$FLATPAK_ID/.foo`` which would otherwise be lost." msgstr "" -#: ../../sandbox-permissions.rst:199 +#: ../../sandbox-permissions.rst:209 msgid "A ``--persist=.`` will `persist` all directories." msgstr "" -#: ../../sandbox-permissions.rst:201 +#: ../../sandbox-permissions.rst:211 msgid "" "This does not support ``:create, :ro, :rw`` suffixes or special values " "like ``xdg-documents``. However, the directory will be created by flatpak" " if it doesn't already exist." msgstr "" -#: ../../sandbox-permissions.rst:205 +#: ../../sandbox-permissions.rst:215 #, fuzzy msgid "" "This makes it possible to avoid configuring access to the entire home " @@ -632,30 +636,30 @@ msgstr "" "``--persist=path`` 选项可以用来将用户目录映射到沙箱的文件系统。这可以避免配置整个home目录访问权限。并且对于在硬编码使用 " "``~/`` 文件路径的应用程序非常有用。" -#: ../../sandbox-permissions.rst:208 +#: ../../sandbox-permissions.rst:218 msgid "" "If an application uses ``$TMPDIR`` to contain lock files you may want to " "add a wrapper script that sets it to ``$XDG_RUNTIME_DIR/app/$FLATPAK_ID``" " (tmpfs) or ``/var/tmp`` (persistent on host)." msgstr "" -#: ../../sandbox-permissions.rst:212 +#: ../../sandbox-permissions.rst:222 msgid "" "Retaining and sharing configuration with non-Flatpak installations is to " "be avoided." msgstr "应该避免与非flatpak安装的应用共享配置。" -#: ../../sandbox-permissions.rst:216 +#: ../../sandbox-permissions.rst:226 msgid "Reserved Paths" msgstr "" -#: ../../sandbox-permissions.rst:218 +#: ../../sandbox-permissions.rst:228 msgid "" "The following paths and subpaths of them are reserved and asking access " "to them with ``--filesystem`` will have no effect::" msgstr "" -#: ../../sandbox-permissions.rst:223 +#: ../../sandbox-permissions.rst:233 msgid "" "The entire ``/run`` is not allowed but all subpaths of ``/run`` except " "``/run/flatpak, /run/host`` are allowed to be exposed via " @@ -663,44 +667,44 @@ msgid "" "to ``../run``, exposing it or a subpath of it, is not allowed." msgstr "" -#: ../../sandbox-permissions.rst:228 +#: ../../sandbox-permissions.rst:238 msgid "" "Additionally the following directories from host need to be explicitly " "requested with ``--filesystem`` and are not available with ``home, host, " "host-os, host-etc`` by default:" msgstr "" -#: ../../sandbox-permissions.rst:232 +#: ../../sandbox-permissions.rst:242 msgid "" "``~/.var/app`` - The app can access only its own directory in " "``~/.var/app/$FLATPAK_ID``" msgstr "" -#: ../../sandbox-permissions.rst:233 +#: ../../sandbox-permissions.rst:243 msgid "``$XDG_DATA_HOME/flatpak`` (``~/.local/share/flatpak``)" msgstr "" -#: ../../sandbox-permissions.rst:234 +#: ../../sandbox-permissions.rst:244 msgid "``/boot``" msgstr "" -#: ../../sandbox-permissions.rst:235 +#: ../../sandbox-permissions.rst:245 msgid "``/efi``" msgstr "" -#: ../../sandbox-permissions.rst:236 +#: ../../sandbox-permissions.rst:246 msgid "``/root``" msgstr "" -#: ../../sandbox-permissions.rst:237 +#: ../../sandbox-permissions.rst:247 msgid "``/sys``" msgstr "" -#: ../../sandbox-permissions.rst:238 +#: ../../sandbox-permissions.rst:248 msgid "``/tmp``" msgstr "" -#: ../../sandbox-permissions.rst:239 +#: ../../sandbox-permissions.rst:249 #, python-brace-format msgid "" "``/var`` - Note that by default ``/var/{cache, config, data, tmp}`` " @@ -710,98 +714,98 @@ msgid "" "available." msgstr "" -#: ../../sandbox-permissions.rst:243 +#: ../../sandbox-permissions.rst:253 msgid "``/var/lib/flatpak`` - ``/var`` does not give access to this." msgstr "" -#: ../../sandbox-permissions.rst:246 +#: ../../sandbox-permissions.rst:256 msgid "Device access" msgstr "设备访问" -#: ../../sandbox-permissions.rst:247 +#: ../../sandbox-permissions.rst:257 msgid "You can provide the following device permissions:" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "``dri``" msgstr "" -#: ../../sandbox-permissions.rst:250 +#: ../../sandbox-permissions.rst:260 msgid "Direct Rendering Interface. Necessary for GL." msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "``kvm``" msgstr "" -#: ../../sandbox-permissions.rst:251 +#: ../../sandbox-permissions.rst:261 msgid "Kernel based Virtual Machine ``/dev/kvm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "``shm``" msgstr "" -#: ../../sandbox-permissions.rst:252 +#: ../../sandbox-permissions.rst:262 msgid "Shared Memory in ``/dev/shm``." msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "``input``" msgstr "" -#: ../../sandbox-permissions.rst:253 +#: ../../sandbox-permissions.rst:263 msgid "" "Input devices as exposed in ``/dev/input``. This includes game " "controllers. Since Flatpak 1.15.6." msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "``usb``" msgstr "" -#: ../../sandbox-permissions.rst:254 +#: ../../sandbox-permissions.rst:264 msgid "Raw USB devices as exposed in ``/dev/bus/usb``. Since Flatpak 1.15.11." msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "``all``" msgstr "" -#: ../../sandbox-permissions.rst:255 +#: ../../sandbox-permissions.rst:265 msgid "All devices, including all of the above except ``shm``" msgstr "" -#: ../../sandbox-permissions.rst:260 +#: ../../sandbox-permissions.rst:270 msgid "" "Using newer permissions like ``input`` or ``usb`` will have no effect on " "older Flatpak versions and will fail when used through Flatpak " "commandline." msgstr "" -#: ../../sandbox-permissions.rst:264 +#: ../../sandbox-permissions.rst:274 #, fuzzy msgid "" "While not ideal, ``--device=all`` can be used to access devices like " "webcams, CD/DVD drives etc." msgstr "尽管不理想， ``--device=all`` 可以用来访问控制器和网络摄像头之类的设备。" -#: ../../sandbox-permissions.rst:268 +#: ../../sandbox-permissions.rst:278 #, fuzzy msgid "USB portal" msgstr "门户（译者注：英文portals）" -#: ../../sandbox-permissions.rst:270 +#: ../../sandbox-permissions.rst:280 msgid "Since 1.5.11." msgstr "" -#: ../../sandbox-permissions.rst:272 +#: ../../sandbox-permissions.rst:282 msgid "" "Sandboxed access to individual USB devices can be controlled by portals. " "Flatpak allows specifying enumerable USB devices to allow access." msgstr "" -#: ../../sandbox-permissions.rst:276 +#: ../../sandbox-permissions.rst:286 msgid "" "Like ``--device=usb``, this is just about accessing the raw USB device, " "that needs libusb (or equivalent). By using the portal, you can restrict " @@ -810,59 +814,59 @@ msgid "" "no reason for USB security devices to be accessible." msgstr "" -#: ../../sandbox-permissions.rst:283 +#: ../../sandbox-permissions.rst:293 msgid "" "A list of valid use cases includes scanners (handled, for example by " "SANE), photo cameras (handled by libgphoto2), flashing devices, etc." msgstr "" -#: ../../sandbox-permissions.rst:286 +#: ../../sandbox-permissions.rst:296 msgid "" "While this is portal dependent and ``xdg-desktop-portal`` is currently " "the only portal implementation, the overall permission flow is as " "follows:" msgstr "" -#: ../../sandbox-permissions.rst:290 +#: ../../sandbox-permissions.rst:300 msgid "" "The Flatpak package specifies the devices it wishes to enumerate through " "``finish-args``." msgstr "" -#: ../../sandbox-permissions.rst:292 +#: ../../sandbox-permissions.rst:302 msgid "" "The application requests the portal to enumerate the available USB " "devices based on that list. If the list is empty it will enumerate all " "USB devices." msgstr "" -#: ../../sandbox-permissions.rst:295 +#: ../../sandbox-permissions.rst:305 msgid "" "When the application wants to access the device, it will make a request " "for the device it wants to access via the portal." msgstr "" -#: ../../sandbox-permissions.rst:297 +#: ../../sandbox-permissions.rst:307 msgid "The portal then requests permission from the user if not already granted." msgstr "" -#: ../../sandbox-permissions.rst:299 +#: ../../sandbox-permissions.rst:309 msgid "" "If the permission was granted, a file descriptor for the device is passed" " back to the application." msgstr "" -#: ../../sandbox-permissions.rst:302 +#: ../../sandbox-permissions.rst:312 msgid "" "The application is then able to open the devices it is supposed to use " "while the others would be hidden." msgstr "" -#: ../../sandbox-permissions.rst:306 +#: ../../sandbox-permissions.rst:316 msgid "Specifying the enumerable devices" msgstr "" -#: ../../sandbox-permissions.rst:308 +#: ../../sandbox-permissions.rst:318 msgid "" "You can specify devices on the ``flatpak`` command line, and by extension" " in the finish arguments for Flatpak Builder. Enumerable devices are " @@ -873,17 +877,17 @@ msgid "" " shall not be enumerated." msgstr "" -#: ../../sandbox-permissions.rst:316 +#: ../../sandbox-permissions.rst:326 msgid "Queries are made out of rules. These rules are composable with ``+``." msgstr "" -#: ../../sandbox-permissions.rst:318 +#: ../../sandbox-permissions.rst:328 msgid "" "The rule ``all`` enumerates every USB device. There is no further rule " "allowed in the query." msgstr "" -#: ../../sandbox-permissions.rst:321 +#: ../../sandbox-permissions.rst:331 msgid "" "The ``vnd`` and ``dev`` rules specify a USB vendor and a USB device ID " "respectively. A vendor can be specified alone, but a device rule always " @@ -893,63 +897,63 @@ msgid "" "repository `_" msgstr "" -#: ../../sandbox-permissions.rst:328 +#: ../../sandbox-permissions.rst:338 msgid "" "``cls`` specifies the device USB class and subclass. Both class and " "subclass are two digit hex numbers separated by a colon ``:``. You can " "use ``*`` to specify any subclass within the class." msgstr "" -#: ../../sandbox-permissions.rst:332 +#: ../../sandbox-permissions.rst:342 msgid "Some examples of the syntax:" msgstr "" -#: ../../sandbox-permissions.rst:334 +#: ../../sandbox-permissions.rst:344 msgid "``vnd:1234``: Devices from vendor ``1234``" msgstr "" -#: ../../sandbox-permissions.rst:335 +#: ../../sandbox-permissions.rst:345 msgid "``vnd:1234+dev:3456``: Only device ``3456`` from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:336 +#: ../../sandbox-permissions.rst:346 msgid "``vnd:1234+cls:06:*``: All the PTP devices from vendor ``1234``." msgstr "" -#: ../../sandbox-permissions.rst:337 +#: ../../sandbox-permissions.rst:347 msgid "``cls:06:*``: All the PTP devices." msgstr "" -#: ../../sandbox-permissions.rst:339 +#: ../../sandbox-permissions.rst:349 msgid "" "This permission only allows to enumerate devices. To open them, " "permission must be requested from the portal. It is not possible to open " "a device that is not enumerable." msgstr "" -#: ../../sandbox-permissions.rst:345 +#: ../../sandbox-permissions.rst:355 msgid "" "The ``--device=usb`` permission is broader than what the USB portal is " "supposed to provide and allows unfettered access to any USB device on the" " bus." msgstr "" -#: ../../sandbox-permissions.rst:349 +#: ../../sandbox-permissions.rst:359 msgid "In some situations you may need to specify a very long list of devices." msgstr "" -#: ../../sandbox-permissions.rst:351 +#: ../../sandbox-permissions.rst:361 msgid "Device lists can be passed in one single argument, or through a file." msgstr "" -#: ../../sandbox-permissions.rst:353 +#: ../../sandbox-permissions.rst:363 msgid "" "When using ``--usb-list``, the queries are separated by a semi-colon " "``;``, with queries for hidden devices (i.e. those that would be passed " "with ``--nousb``) prefixed with ``!``." msgstr "" -#: ../../sandbox-permissions.rst:357 +#: ../../sandbox-permissions.rst:367 msgid "" "When using ``--usb-list-file``, the filename of the file containing USB " "queries is passed line by line. Like with ``--usb-list`` queries for " @@ -959,24 +963,24 @@ msgid "" "list is persisted internally." msgstr "" -#: ../../sandbox-permissions.rst:365 +#: ../../sandbox-permissions.rst:375 msgid "dconf access" msgstr "dconf访问" -#: ../../sandbox-permissions.rst:367 +#: ../../sandbox-permissions.rst:377 msgid "" "As of xdg-desktop-portal 1.1.0 and glib 2.60.5 (in the runtime) you do " "not need direct DConf access in most cases." msgstr "" -#: ../../sandbox-permissions.rst:370 +#: ../../sandbox-permissions.rst:380 msgid "" "As of now this glib version is included in " "``org.freedesktop.Platform//19.08`` and ``org.gnome.Platform//3.34`` and " "newer." msgstr "" -#: ../../sandbox-permissions.rst:373 +#: ../../sandbox-permissions.rst:383 msgid "" "If an application existed prior to these runtimes you can tell Flatpak " "(>= 1.3.4) to migrate the DConf settings on the host into the sandbox by " @@ -985,17 +989,17 @@ msgid "" " (case is ignored and ``_`` and ``-`` are treated equal)." msgstr "" -#: ../../sandbox-permissions.rst:380 +#: ../../sandbox-permissions.rst:390 msgid "" "If you are targeting older runtimes or require direct DConf access for " "other reasons you can use these permissions::" msgstr "" -#: ../../sandbox-permissions.rst:388 +#: ../../sandbox-permissions.rst:398 msgid "With those permissions glib will continue using dconf directly." msgstr "" -#: ../../sandbox-permissions.rst:390 +#: ../../sandbox-permissions.rst:400 msgid "" "If you use a newer runtime where dconf is no longer built and still need " "it you will have to build the `dconf " @@ -1003,12 +1007,12 @@ msgid "" "``--env=GIO_EXTRA_MODULES=/app/lib/gio/modules/``." msgstr "" -#: ../../sandbox-permissions.rst:395 +#: ../../sandbox-permissions.rst:405 #, fuzzy msgid "gvfs access" msgstr "dconf访问" -#: ../../sandbox-permissions.rst:397 +#: ../../sandbox-permissions.rst:407 msgid "" "As of gvfs 1.48, the gvfs daemons and applications use an on-disk socket " "to communicate, rather than an abstract socket so that the gvfs " @@ -1016,47 +1020,47 @@ msgid "" "application's sandbox." msgstr "" -#: ../../sandbox-permissions.rst:401 +#: ../../sandbox-permissions.rst:411 msgid "" "A number of different options need to be passed depending on the " "application's use of gvfs." msgstr "" -#: ../../sandbox-permissions.rst:404 +#: ../../sandbox-permissions.rst:414 msgid "" "``--talk-name=org.gtk.vfs.*`` is necessary to talk to the gvfs daemons " "over D-Bus and list mounts using the GIO APIs." msgstr "" -#: ../../sandbox-permissions.rst:407 +#: ../../sandbox-permissions.rst:417 msgid "" "``--filesystem=xdg-run/gvfsd`` is necessary to use the GIO APIs to list " "and access non-native files using the GIO APIs, using URLs rather than " "FUSE paths." msgstr "" -#: ../../sandbox-permissions.rst:410 +#: ../../sandbox-permissions.rst:420 msgid "" "``--filesystem=xdg-run/gvfs`` is necessary to give access to the FUSE " "mounts non-GIO and legacy applications can use. This is what will make " "native files appear under ``/run/user/`id -u`/gvfs/``." msgstr "" -#: ../../sandbox-permissions.rst:414 +#: ../../sandbox-permissions.rst:424 msgid "Typical GNOME and GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:419 +#: ../../sandbox-permissions.rst:429 msgid "Typical non-GNOME and non-GTK applications should use::" msgstr "" -#: ../../sandbox-permissions.rst:423 +#: ../../sandbox-permissions.rst:433 msgid "" "No application should be using ``--talk-name=org.gtk.vfs`` in its " "manifest, as there are no D-Bus services named ``org.gtk.vfs``." msgstr "" -#: ../../sandbox-permissions.rst:426 +#: ../../sandbox-permissions.rst:436 msgid "" "These permission grants the app, the ability to communicate with the gvfs" " daemon and backends running on host. Depending on the backends installed" @@ -1072,11 +1076,11 @@ msgid "" "host." msgstr "" -#: ../../sandbox-permissions.rst:440 +#: ../../sandbox-permissions.rst:450 msgid "External drive access" msgstr "" -#: ../../sandbox-permissions.rst:442 +#: ../../sandbox-permissions.rst:452 msgid "" "External drives are mounted by the host system using systemd, udev, udisk" " fstab etc. and each of them can have different defaults. Flatpak has no " @@ -1084,30 +1088,30 @@ msgid "" "permissions should work in most cases::" msgstr "" -#: ../../sandbox-permissions.rst:451 +#: ../../sandbox-permissions.rst:461 msgid "" "If ``--filesystem=host`` is used ``/media, /run/media`` is shared " "automatically if they exist." msgstr "" -#: ../../sandbox-permissions.rst:454 +#: ../../sandbox-permissions.rst:464 msgid "" "Note that these should not have subpaths in them unless the value of the " "subpath can be consistently pre-determined. Block device naming depends " "on the kernel/fstab configuration and cannot be pre-determined." msgstr "" -#: ../../sandbox-permissions.rst:459 +#: ../../sandbox-permissions.rst:469 msgid "Footnotes" msgstr "" -#: ../../sandbox-permissions.rst:460 +#: ../../sandbox-permissions.rst:470 msgid "" "This is not necessarily required, but without it the X11 shared memory " "extension will not work, which is very bad for X11 performance." msgstr "" -#: ../../sandbox-permissions.rst:462 +#: ../../sandbox-permissions.rst:472 msgid "" "Giving network access also grants access to all host services listening " "on abstract Unix sockets (due to how network namespaces work), and these " @@ -1116,7 +1120,7 @@ msgid "" "secure distribution should disable these and just use regular sockets." msgstr "" -#: ../../sandbox-permissions.rst:467 +#: ../../sandbox-permissions.rst:477 #, python-brace-format msgid "" "``xdg-{cache, config, data}`` bind mounts the paths from host to the per-" @@ -1301,3 +1305,36 @@ msgstr "" #~ "allowed." #~ msgstr "" +#~ msgid "" +#~ "The following permissions provide access " +#~ "to basic resources that applications " +#~ "commonly require, and can therefore be" +#~ " freely used." +#~ msgstr "以下权限提供了应用通常需要访问的基本资源，因此可以自由使用：" + +#~ msgid "" +#~ "``--socket=cups`` - Talk to the CUPS " +#~ "printing system (``$CUPS_SERVER`` or server" +#~ " defined in CUPS's ``client.conf``. Falls" +#~ " back to ``/var/run/cups/cups.sock``)" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=gpg-agent`` - Talk to the " +#~ "GPG agent (The socket in ``gpgconf " +#~ "--list-dir agent-socket``)" +#~ msgstr "" + +#~ msgid "``--socket=pcsc`` - Smart card access ``$PCSCLITE_CSOCK_NAME``" +#~ msgstr "" + +#~ msgid "" +#~ "``--socket=pulseaudio`` - Access to " +#~ "PulseAudio, includes sound input (mic), " +#~ "sound output/playback, MIDI and ALSA " +#~ "sound devices in ``/dev/snd``" +#~ msgstr "" + +#~ msgid "``--socket=ssh-auth``- Allow access to ``$SSH_AUTH_SOCK``" +#~ msgstr "" +