From 5ba2191916c5948e1d54db625e19553c1a087e15 Mon Sep 17 00:00:00 2001 From: bbhtt Date: Tue, 18 Feb 2025 06:53:10 +0530 Subject: [PATCH 1/2] debugging: Add info on installing GL debug extension these do not get included with --include-debug --- docs/debugging.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/debugging.rst b/docs/debugging.rst index bad3bcc9..1c213098 100644 --- a/docs/debugging.rst +++ b/docs/debugging.rst @@ -15,6 +15,22 @@ the application. This can be done by:: This will install the SDK, the Debug SDK and the Debug extension for the application. +If it's a crash in the graphics stack, the GL debug extension will also +be needed. + +First, note down the runtime branch used by the application:: + + $ flatpak info --show-runtime $FLATPAK_ID + org.freedesktop.Platform/x86_64/24.08 + +In the above example it is the Freedesktop SDK and the branch is +``24.08``. Then install the ``GL.debug`` extension for the above branch:: + + $ flatpak install org.freedesktop.Platform.{GL,GL32}.Debug.default//24.08 + +The same process should be followed for any extension or baseapp used +by the app. + Debug shell ----------- From a8f481509fed8629c1ff035cd6e0172c241d742c Mon Sep 17 00:00:00 2001 From: bbhtt Date: Tue, 18 Feb 2025 06:55:28 +0530 Subject: [PATCH 2/2] Update po files --- po/de/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/es/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/fr/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/ko/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/pt_BR/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/ru/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ po/zh_CN/LC_MESSAGES/debugging.po | 108 ++++++++++++++++++------------ 7 files changed, 455 insertions(+), 301 deletions(-) diff --git a/po/de/LC_MESSAGES/debugging.po b/po/de/LC_MESSAGES/debugging.po index bd666d7e..5b58b1af 100644 --- a/po/de/LC_MESSAGES/debugging.po +++ b/po/de/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2018-05-20 10:36-0400\n" "Last-Translator: Copied by Zanata \n" "Language: de\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -43,17 +43,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 msgid "" "This creates a sandbox for the application with the given ID and, instead" " of running the application, runs a shell inside the sandbox. The " @@ -62,41 +84,41 @@ msgid "" " enable debugging." msgstr "" -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " "option::" msgstr "" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." msgstr "" -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -105,32 +127,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 msgid "Creating a Debug extension" msgstr "" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 msgid "" "Like many other packaging systems, Flatpak separates bulky debug " "information from regular content and ships it separately, in a Debug " "extension." msgstr "" -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" " Debug extension. This can be disabled with the ``no-debuginfo`` option." msgstr "" -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " "are accepted by the run command. For example::" msgstr "" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." msgstr "" -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." msgstr "" -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" msgstr "" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/es/LC_MESSAGES/debugging.po b/po/es/LC_MESSAGES/debugging.po index b0328c0b..5fd507f5 100644 --- a/po/es/LC_MESSAGES/debugging.po +++ b/po/es/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: es\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -43,17 +43,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 msgid "" "This creates a sandbox for the application with the given ID and, instead" " of running the application, runs a shell inside the sandbox. The " @@ -62,41 +84,41 @@ msgid "" " enable debugging." msgstr "" -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " "option::" msgstr "" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." msgstr "" -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -105,32 +127,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 msgid "Creating a Debug extension" msgstr "" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 msgid "" "Like many other packaging systems, Flatpak separates bulky debug " "information from regular content and ships it separately, in a Debug " "extension." msgstr "" -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" " Debug extension. This can be disabled with the ``no-debuginfo`` option." msgstr "" -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " "are accepted by the run command. For example::" msgstr "" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." msgstr "" -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." msgstr "" -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" msgstr "" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/fr/LC_MESSAGES/debugging.po b/po/fr/LC_MESSAGES/debugging.po index 67bd237d..849de83b 100644 --- a/po/fr/LC_MESSAGES/debugging.po +++ b/po/fr/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: fr\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -43,17 +43,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 msgid "" "This creates a sandbox for the application with the given ID and, instead" " of running the application, runs a shell inside the sandbox. The " @@ -62,41 +84,41 @@ msgid "" " enable debugging." msgstr "" -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " "option::" msgstr "" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." msgstr "" -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -105,32 +127,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 msgid "Creating a Debug extension" msgstr "" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 msgid "" "Like many other packaging systems, Flatpak separates bulky debug " "information from regular content and ships it separately, in a Debug " "extension." msgstr "" -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" " Debug extension. This can be disabled with the ``no-debuginfo`` option." msgstr "" -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " "are accepted by the run command. For example::" msgstr "" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." msgstr "" -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." msgstr "" -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" msgstr "" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/ko/LC_MESSAGES/debugging.po b/po/ko/LC_MESSAGES/debugging.po index e866f3f5..9ff9b2f3 100644 --- a/po/ko/LC_MESSAGES/debugging.po +++ b/po/ko/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2018-05-20 10:37-0400\n" "Last-Translator: Copied by Zanata \n" "Language: ko\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -43,17 +43,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 msgid "" "This creates a sandbox for the application with the given ID and, instead" " of running the application, runs a shell inside the sandbox. The " @@ -62,41 +84,41 @@ msgid "" " enable debugging." msgstr "" -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " "option::" msgstr "" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." msgstr "" -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -105,32 +127,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 msgid "Creating a Debug extension" msgstr "" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 msgid "" "Like many other packaging systems, Flatpak separates bulky debug " "information from regular content and ships it separately, in a Debug " "extension." msgstr "" -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" " Debug extension. This can be disabled with the ``no-debuginfo`` option." msgstr "" -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " "are accepted by the run command. For example::" msgstr "" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." msgstr "" -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." msgstr "" -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" msgstr "" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/pt_BR/LC_MESSAGES/debugging.po b/po/pt_BR/LC_MESSAGES/debugging.po index a6c1058f..61355ea1 100644 --- a/po/pt_BR/LC_MESSAGES/debugging.po +++ b/po/pt_BR/LC_MESSAGES/debugging.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-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2022-10-04 10:58-0300\n" "Last-Translator: Rafael Fontenelle \n" "Language: pt_BR\n" @@ -17,7 +17,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -43,17 +43,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 #, fuzzy msgid "" "This creates a sandbox for the application with the given ID and, instead" @@ -67,7 +89,7 @@ msgstr "" " ``--devel`` também ajusta a configuração da sandbox para ativar a " "depuração." -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " @@ -77,7 +99,7 @@ msgstr "" "precisar instalá-lo. Isso é feito usando a opção ``--run`` do ``flatpak-" "builder``::" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." @@ -86,28 +108,28 @@ msgstr "" "compilação encontrados no diretório de compilação e executa um shell " "dentro dele." -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -116,32 +138,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 #, fuzzy msgid "Creating a Debug extension" msgstr "Criando uma extensão .Debug" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 #, fuzzy msgid "" "Like many other packaging systems, Flatpak separates bulky debug " @@ -195,7 +217,7 @@ msgstr "" "informações volumosas de depuração do conteúdo normal e as envia " "separadamente, no que é chamado de extensão ``.Debug``." -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 #, fuzzy msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" @@ -205,22 +227,22 @@ msgstr "" "automaticamente uma extensão ``.Debug``. Isso pode ser desativado com a " "opção ``no-debuginfo``." -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "Sobrepondo permissões de sandbox" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " @@ -230,7 +252,7 @@ msgstr "" "depuração. Isso pode ser alcançado usando as várias opções de sandbox que" " são aceitas pelo comando de execução. Por exemplo::" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." @@ -239,11 +261,11 @@ msgstr "" "concedendo a ele acesso ao barramento do sistema ao nome do barramento " "pertencente a logind." -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "Inspecionando permissões do portal" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." @@ -251,19 +273,19 @@ msgstr "" "O Flatpak possui vários comandos que permitem gerenciar permissões do " "portal para aplicativos." -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "Para ver todas as permissões de portal de um aplicativo, use::" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "Para redefinir todas as permissões do portal de um aplicativo, use::" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "Interagindo com sandboxes em execução" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" @@ -271,34 +293,34 @@ msgstr "" "Você pode ver todos os aplicativos atualmente em execução nos sandboxes " "do Flatpak (desde a versão 1.2)::" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "E, se necessário, você pode encerrar um à força (desde a versão 1.2)::" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/ru/LC_MESSAGES/debugging.po b/po/ru/LC_MESSAGES/debugging.po index 9078502f..afc74e49 100644 --- a/po/ru/LC_MESSAGES/debugging.po +++ b/po/ru/LC_MESSAGES/debugging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2023-01-04 21:32+0700\n" "Last-Translator: Dmitry \n" "Language: ru\n" @@ -18,7 +18,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -44,17 +44,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 #, fuzzy msgid "" "This creates a sandbox for the application with the given ID and, instead" @@ -68,7 +90,7 @@ msgstr "" "такие как ``gdb``. Параметр ``--devel`` также регулирует настройку " "песочницы для включения отладки." -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " @@ -78,7 +100,7 @@ msgstr "" "установки. Это делается с помощью параметра ``flatpak-builder``'s " "``--run``::" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." @@ -86,28 +108,28 @@ msgstr "" "Это устанавливает песочницу, которая заполняется результатами сборки, " "найденными в каталоге сборки, и запускает оболочку внутри нее." -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -116,32 +138,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 #, fuzzy msgid "Creating a Debug extension" msgstr "Создание расширения .Debug" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 #, fuzzy msgid "" "Like many other packaging systems, Flatpak separates bulky debug " @@ -195,7 +217,7 @@ msgstr "" "отладочную информацию от обычного контента и отправляет ее отдельно в так" " называемом расширении .Debug." -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 #, fuzzy msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" @@ -205,22 +227,22 @@ msgstr "" "расширение ``.Debug``. Это можно отключить с помощью опции ``no-" "debuginfo``." -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "Переопределение разрешений песочницы" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " @@ -230,7 +252,7 @@ msgstr "" "отладке. Этого можно добиться с помощью различных параметров песочницы, " "которые принимает команда запуска. Например::" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." @@ -239,11 +261,11 @@ msgstr "" "данного приложения, предоставляя ему доступ к системной шине с именем " "шины, принадлежащим logind." -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 msgid "Inspecting portal permissions" msgstr "Проверка разрешений портала" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." @@ -251,19 +273,19 @@ msgstr "" "Flatpak имеет ряд команд, позволяющих управлять разрешениями портала для " "приложений." -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "Чтобы увидеть все права доступа приложения к порталу, используйте::" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "Чтобы сбросить все права доступа приложения к порталу, используйте::" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "Взаимодействие с запущенными песочницами" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" @@ -271,36 +293,36 @@ msgstr "" "Вы можете увидеть все приложения, которые в настоящее время работают в " "песочницах Flatpak (начиная с версии 1.2)::" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" "И, при необходимости, вы можете прекратить его принудительно (начиная с " "версии 1.2)::" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be " diff --git a/po/zh_CN/LC_MESSAGES/debugging.po b/po/zh_CN/LC_MESSAGES/debugging.po index 12da6670..0a026a98 100644 --- a/po/zh_CN/LC_MESSAGES/debugging.po +++ b/po/zh_CN/LC_MESSAGES/debugging.po @@ -4,7 +4,7 @@ msgid "" msgstr "" "Project-Id-Version: Flatpak\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-05 01:10+0530\n" +"POT-Creation-Date: 2025-02-18 06:55+0530\n" "PO-Revision-Date: 2018-11-03 01:03-0400\n" "Last-Translator: PikachuHy \n" "Language: zh_Hans_CN\n" @@ -13,7 +13,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" #: ../../debugging.rst:2 msgid "Debugging" @@ -39,17 +39,39 @@ msgid "" "application." msgstr "" -#: ../../debugging.rst:19 -msgid "Debug shell" +#: ../../debugging.rst:18 +msgid "" +"If it's a crash in the graphics stack, the GL debug extension will also " +"be needed." msgstr "" #: ../../debugging.rst:21 +msgid "First, note down the runtime branch used by the application::" +msgstr "" + +#: ../../debugging.rst:26 +msgid "" +"In the above example it is the Freedesktop SDK and the branch is " +"``24.08``. Then install the ``GL.debug`` extension for the above branch::" +msgstr "" + +#: ../../debugging.rst:31 +msgid "" +"The same process should be followed for any extension or baseapp used by " +"the app." +msgstr "" + +#: ../../debugging.rst:35 +msgid "Debug shell" +msgstr "" + +#: ../../debugging.rst:37 msgid "" "A debugging environment can be created by starting a shell inside the " "sandbox::" msgstr "" -#: ../../debugging.rst:26 +#: ../../debugging.rst:42 #, fuzzy msgid "" "This creates a sandbox for the application with the given ID and, instead" @@ -61,41 +83,41 @@ msgstr "" "这是如何工作的呢？ ``--devel`` 选项告诉Flatpak使用SDK作为运行时，而SDK含有像 ``gdb`` 这样的调试工具。 " "``--devel`` 选项也让沙盒初始化时启动调试。" -#: ../../debugging.rst:32 +#: ../../debugging.rst:48 msgid "" "It is also possible to get a shell inside an application sandbox without " "having to install it. This is done using ``flatpak-builder``'s ``--run`` " "option::" msgstr "在没有安装调试扩展的情况下，也可以在应用沙盒中运行shell。这通过使用 ``flatpak-builder`` 的 ``--run`` 选项完成：" -#: ../../debugging.rst:38 +#: ../../debugging.rst:54 msgid "" "This sets up a sandbox that is populated with the build results found in " "the build directory, and runs a shell inside it." msgstr "启动一个含有构建结果的沙盒，然后在沙盒里运行shell。" -#: ../../debugging.rst:42 +#: ../../debugging.rst:58 msgid "Using GDB in the sandbox" msgstr "" -#: ../../debugging.rst:44 +#: ../../debugging.rst:60 msgid "" "Note that :ref:`debugging:Debug packages` must be installed to get " "meaningful traces from GDB. Once inside the :ref:`debugging:Debug shell` " "to run the application with ``gdb`` ::" msgstr "" -#: ../../debugging.rst:50 +#: ../../debugging.rst:66 msgid "To pass arguments to the application::" msgstr "" -#: ../../debugging.rst:55 +#: ../../debugging.rst:71 msgid "" "A breakpoint can also be set for example on the ``main`` function and " "once it is reached the source code can be listed::" msgstr "" -#: ../../debugging.rst:62 +#: ../../debugging.rst:78 msgid "" "Once the bug is reproduced, if it is a crash it will automatically return" " to the gdb prompt. In case of a freeze pressing Ctrl+c will cause it to " @@ -104,32 +126,32 @@ msgid "" " that ``--filesystem=$(pwd)``)::" msgstr "" -#: ../../debugging.rst:70 +#: ../../debugging.rst:86 msgid "Then to get the backtrace::" msgstr "" -#: ../../debugging.rst:74 +#: ../../debugging.rst:90 msgid "Or for all threads, in case of a multi-threaded program::" msgstr "" -#: ../../debugging.rst:78 +#: ../../debugging.rst:94 msgid "" "Note that ``gdb`` inside the sandbox cannot use debug symbols from host's" " `debuginfod servers `_." msgstr "" -#: ../../debugging.rst:81 +#: ../../debugging.rst:97 msgid "" "Please also see the `GDB user manual " "`_ for a more " "complete overview on how to use GDB." msgstr "" -#: ../../debugging.rst:85 +#: ../../debugging.rst:101 msgid "Getting stacktraces from a crash" msgstr "" -#: ../../debugging.rst:87 +#: ../../debugging.rst:103 msgid "" "If an application crashed and the system has coredumps and `systemd-" "coredump `_ which is useful to find memory leaks." " Once inside the :ref:`debugging:Debug shell`, it can be run with::" msgstr "" -#: ../../debugging.rst:108 +#: ../../debugging.rst:124 msgid "" "`Strace `_ can be useful to check what an application" " is doing. For example, to trace ``openat(), read()`` calls::" msgstr "" -#: ../../debugging.rst:113 +#: ../../debugging.rst:129 msgid "" "`Perf `_ requires access to " "``--filesystem=/sys`` to run::" msgstr "" -#: ../../debugging.rst:119 +#: ../../debugging.rst:135 #, fuzzy msgid "Creating a Debug extension" msgstr "创建调试扩展" -#: ../../debugging.rst:121 +#: ../../debugging.rst:137 #, fuzzy msgid "" "Like many other packaging systems, Flatpak separates bulky debug " @@ -180,7 +202,7 @@ msgid "" "extension." msgstr "像其他的包系统一样，Flatpak也把笨重的调试信息和常规内容分离，作为 ``.Debug`` 扩展单独使用。" -#: ../../debugging.rst:124 +#: ../../debugging.rst:140 #, fuzzy msgid "" "When an application is built, ``flatpak-builder`` automatically creates a" @@ -189,91 +211,91 @@ msgstr "" "当构建一个应用时， ``flatpak-builder`` 自动创建一个 ``.Debug`` 扩展。可以使用 ``no-debuginfo`` " "选项禁止这个行为。" -#: ../../debugging.rst:128 +#: ../../debugging.rst:144 msgid "" "To install the Debug extension created locally, pass ``--install`` to " "``flatpak-builder`` which will set up a new remote for the build. The " "remotes available can be checked with::" msgstr "" -#: ../../debugging.rst:134 +#: ../../debugging.rst:150 msgid "Then install the Debug extension from that remote::" msgstr "" -#: ../../debugging.rst:139 +#: ../../debugging.rst:155 msgid "Overriding sandbox permissions" msgstr "覆盖沙盒权限" -#: ../../debugging.rst:141 +#: ../../debugging.rst:157 msgid "" "It is sometimes useful to have extra permissions in a sandbox when " "debugging. This can be achieved using the various sandbox options that " "are accepted by the run command. For example::" msgstr "当调试的时候，使用额外的权限有时是很有用的。这可以通过使用运行命令接受的各种选项实现。如：" -#: ../../debugging.rst:147 +#: ../../debugging.rst:163 msgid "" "This command runs a shell in the sandbox for the given application, " "granting it system bus access to the bus name owned by logind." msgstr "此命令在给定应用程序的沙箱中运行shell，授予它访问logind对应的D-Bus服务的权限。" -#: ../../debugging.rst:151 +#: ../../debugging.rst:167 #, fuzzy msgid "Inspecting portal permissions" msgstr "覆盖沙盒权限" -#: ../../debugging.rst:153 +#: ../../debugging.rst:169 msgid "" "Flatpak has a number of commands that allow to manage portal permissions " "for applications." msgstr "" -#: ../../debugging.rst:156 +#: ../../debugging.rst:172 msgid "To see all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:160 +#: ../../debugging.rst:176 msgid "To reset all portal permissions of an application, use::" msgstr "" -#: ../../debugging.rst:166 +#: ../../debugging.rst:182 msgid "Interacting with running sandboxes" msgstr "" -#: ../../debugging.rst:168 +#: ../../debugging.rst:184 msgid "" "You can see all the apps that are currently running in Flatpak sandboxes " "(since 1.2)::" msgstr "" -#: ../../debugging.rst:173 +#: ../../debugging.rst:189 msgid "And, if you need to, you can terminate one by force (since 1.2)::" msgstr "" -#: ../../debugging.rst:178 +#: ../../debugging.rst:194 msgid "Audit session or system bus traffic" msgstr "" -#: ../../debugging.rst:180 +#: ../../debugging.rst:196 msgid "" "A ``--socket=session-bus`` or a ``--socket=system-bus`` permission must " "not be present for the logging to work." msgstr "" -#: ../../debugging.rst:183 +#: ../../debugging.rst:199 msgid "" "Session bus traffic can be audited by passing ``--log-session-bus`` to " "``flatpak run``::" msgstr "" -#: ../../debugging.rst:188 +#: ../../debugging.rst:204 msgid "" "This can be useful to figure out the bus names used by an application and" " the corresponding ``--talk-name`` or ``--own-name`` permissions " "required::" msgstr "" -#: ../../debugging.rst:194 +#: ../../debugging.rst:210 msgid "" "Similarly, system bus traffic can be audited by passing ``--log-system-" "bus`` to ``flatpak run``. This also requires a system bus name to be "