Просмотр исходного текста страницы Анализ gnome-shell с помощью Valgrind

Для того, чтобы с помощью [http://valgrind.org Valgrind] искать ошибки (утечки памяти, некорректные обращения к памяти, и т.п.) в gnome-shell нужно выполнить несколько не очень очевидных операций. Вот как всё делается.

== Подготовка ==

Чтобы не набирать длинные команды каждый раз, полезно подготовить пару скриптов и положить их, скажем, в ''~/bin/'' на той системе, где нужно проверить gnome-shell.

''xenv.sh'' - этот скрипт установит необходимые переменные окружения:
<pre>
gnome_session=$(pgrep -u $USER gnome-session)
eval export $(sed 's/\o000/\n/g;' < /proc/$gnome_session/environ | grep DISPLAY)
eval export $(sed 's/\o000/\n/g;' < /proc/$gnome_session/environ | grep XAUTHORITY)
eval export $(sed 's/\o000/\n/g;' < /proc/$gnome_session/environ | grep DBUS_SESSION_BUS_ADDRESS)
</pre>

''vg_gnome_shell.sh'' - этот скрипт запускает gnome-shell под Valgrind с нужными параметрами (подробности ниже):
<pre>
G_SLICE=always-malloc G_DEBUG=gc-friendly valgrind --leak-check=full --show-reachable=yes \
  --fullpath-after= --num-callers=40 --trace-children=yes --log-file=vg.log \
  --suppressions=clutter-2.0.suppressions \
  gnome-shell --replace
</pre>

То, что Valgrind считает ошибками, - не всегда ошибки. Некоторые ложные сообщения об ошибках можно убрать, передав Valgrind'у при запуске файл(ы) с соотв. данными (suppression files).
* [https://git.gnome.org/browse/clutter/tree/tests/data/clutter-2.0.suppressions Suppression file для Clutter]
* [https://git.gnome.org/browse/cogl/tree/tests/data/valgrind.suppressions Suppression file для Cogl]

В скрипте ''vg_gnome_shell.sh'' используется suppression file ''clutter-2.0.suppressions'', предполагается, что он лежит в текущем каталоге.

Чтобы в call stack в отчёте Valgrind были указаны строки кода, а не просто адреса, стоит установить пакеты с отладочной информацией. Вот список с одной из систем, где проводится анализ gnome-shell:

<pre>
    gnome-shell-debuginfo
    gnome-desktop3-debuginfo
    gnome-session-debuginfo
    gnome-settings-daemon-debuginfo
    gnome-themes-standard-debuginfo
    gnome-utils-debuginfo
    gnome-vfs2-debuginfo
    gtk+3.0-debuginfo
    gtk-css-engine-debuginfo
    gtkmm3.0-debuginfo
    dbus-glib-debuginfo
    glib2.0-debuginfo
    glibc-debuginfo
    js-debuginfo
    pbmtozjs-debuginfo
    libjsw-debuginfo
    gjs-debuginfo
    json-glib-debuginfo
    libsvg-cairo-debuginfo
    cairo-dock-debuginfo
    gtkcairo-debuginfo
    librsvg-debuginfo
    cairo-debuginfo
    cairo-dock-plugins-debuginfo
    cairomm-debuginfo
    pixman-debuginfo
    cogl-debuginfo
    gegl-debuginfo
    mesa-debuginfo
    glew-debuginfo
    clutter-debuginfo
    clutter-gtk-debuginfo
    pango-debuginfo
    harfbuzz-debuginfo
    fontconfig-debuginfo
    mutter-debuginfo
    dconf-debuginfo
</pre>

Какие-то из них, вероятно, не нужны, но кашу маслом не испортишь.

== Запуск ==

Стоит залогиниться в системе, как обычно. Затем - перейти, например, в вирт. консоль №2 (<tt>ctrl-alt-f2</tt>) и залогиниться там '''тем же''' пользователем.

Теперь надо установить нужные переменные среды, используя подготовленный выше скрипт:
<pre>
$ . ~/bin/xenv.sh
</pre>

Соотв. переменные будут выставлены так же, как для данного пользователя они стоят в X11-сессии. Обратите внимание: точка перед <tt>~/bin/xenv.sh</tt> нужна. Скрипт не выполняется в новом shell'е, а "source'ится" в текущий.

Если нужно для использовать suppression файлы для Valgrind, стоит проверить, что в ''vg_gnome_shell.sh'' правильно указаны пути к ним.

Теперь можно запускать gnome-shell под Valgrind.

<pre>
$ sh ~/bin/vg_gnome_shell.sh
</pre>

Запуск может занять несколько минут: Valgrind может достаточно сильно замедлить загрузку и работу анализируемого приложения. Когда gnome-shell выведет сообщение о том, что она запустилась, можно переключаться в вирт. консоль, где запущены X11. Вероятно, после этого придётся подождать ещё несколько минут пока там появится всё необходимое.

После этого можно работать с gnome-shell. В конце - выйти из системы или убить gnome-shell каким-то другим способом.

Отчёт Valgrind будет в файле ''vg.log'' в текущем каталоге.