diff options
Diffstat (limited to 'src/man/ru/sssd-systemtap.5.xml')
| -rw-r--r-- | src/man/ru/sssd-systemtap.5.xml | 434 |
1 files changed, 434 insertions, 0 deletions
diff --git a/src/man/ru/sssd-systemtap.5.xml b/src/man/ru/sssd-systemtap.5.xml new file mode 100644 index 0000000..7a26bb4 --- /dev/null +++ b/src/man/ru/sssd-systemtap.5.xml @@ -0,0 +1,434 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.4//EN" +"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"> +<reference> +<title>Справка по SSSD</title> +<refentry> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/upstream.xml" /> + + <refmeta> + <refentrytitle>sssd-systemtap</refentrytitle> + <manvolnum>5</manvolnum> + <refmiscinfo class="manual">Форматы файлов и рекомендации</refmiscinfo> + </refmeta> + + <refnamediv id='name'> + <refname>sssd-systemtap</refname> + <refpurpose>Информация о systemtap SSSD</refpurpose> + </refnamediv> + + <refsect1 id='description'> + <title>ОПИСАНИЕ</title> + <para> + На этой справочной странице представлена информация о функциональных +возможностях systemtap в <citerefentry> <refentrytitle>sssd</refentrytitle> +<manvolnum>8</manvolnum> </citerefentry>. + </para> + <para> + В различные места кода SSSD были добавлены точки зондирования SystemTap для +упрощения анализа и устранения проблем с производительностью. + </para> + <para> + <itemizedlist> + <listitem> + <para> + Примеры сценариев SystemTap: /usr/share/sssd/systemtap/ + </para> + </listitem> + <listitem> + <para> + Зонды и прочие функции определены, соответственно, в +/usr/share/systemtap/tapset/sssd.stp и +/usr/share/systemtap/tapset/sssd_functions.stp. + </para> + </listitem> + </itemizedlist> + </para> + </refsect1> + + <refsect1 id='probe-points'> + <title>ТОЧКИ ЗОНДИРОВАНИЯ</title> + <para> + Далее приводится список точек зондирования и аргументов, которые доступны в +следующем формате: + </para> + <variablelist> + <varlistentry> + <term>probe $name</term> + <listitem> + <para> + Описание точки зондирования + </para> + <programlisting> +variable1:datatype +variable2:datatype +variable3:datatype +... + </programlisting> + </listitem> + </varlistentry> + </variablelist> + + <refsect2 id='database-transaction-probes'> + <title>Зонды транзакций базы данных</title> + <para> + <variablelist> + <varlistentry> + <term>probe sssd_transaction_start</term> + <listitem> + <para> + Начало транзакции sysdb, зондирует функцию sysdb_transaction_start(). + </para> + <programlisting> +nesting:целое число +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_cancel</term> + <listitem> + <para> + Отмена транзакции sysdb, зондирует функцию sysdb_transaction_cancel(). + </para> + <programlisting> +nesting:целое число +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_commit_before</term> + <listitem> + <para> + Зондирует функцию sysdb_transaction_commit_before(). + </para> + <programlisting> +nesting:целое число +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_commit_after</term> + <listitem> + <para> + Зондирует функцию sysdb_transaction_commit_after(). + </para> + <programlisting> +nesting:целое число +probestr:строка + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-search-probes'> + <title>Зонды поиска LDAP</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_search_send</term> + <listitem> + <para> + Зондирует функцию sdap_get_generic_ext_send(). + </para> + <programlisting> +base:строка +scope:целое число +filter:строка +attrs:строка +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_recv</term> + <listitem> + <para> + Зондирует функцию sdap_get_generic_ext_recv(). + </para> + <programlisting> +base:строка +scope:целое число +filter:строка +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_parse_entry</term> + <listitem> + <para> + Зондирует функцию sdap_parse_entry(). Вызывается повторно для каждого +полученного атрибута. + </para> + <programlisting> +attr:строка +value:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_parse_entry_done</term> + <listitem> + <para> + Зондирует функцию sdap_parse_entry(). Вызывается по завершении обработки +полученного объекта. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_deref_send</term> + <listitem> + <para> + Зондирует функцию sdap_deref_search_send(). + </para> + <programlisting> +base_dn:строка +deref_attr:строка +probestr:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_deref_recv</term> + <listitem> + <para> + Зондирует функцию sdap_deref_search_recv(). + </para> + <programlisting> +base:строка +scope:целое число +filter:строка +probestr:строка + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-account-req-probes'> + <title>Зонды запросов учётных записей LDAP</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_acct_req_send</term> + <listitem> + <para> + Зондирует функцию sdap_acct_req_send(). + </para> + <programlisting> +entry_type:целое число +filter_type:целое число +filter_value:строка +extra_value:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_acct_req_recv</term> + <listitem> + <para> + Зондирует функцию sdap_acct_req_recv(). + </para> + <programlisting> +entry_type:целое число +filter_type:целое число +filter_value:строка +extra_value:строка + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-user-search-probes'> + <title>Зонды поиска пользователей LDAP</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_search_user_send</term> + <listitem> + <para> + Зондирует функцию sdap_search_user_send(). + </para> + <programlisting> +filter:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_recv</term> + <listitem> + <para> + Зондирует функцию sdap_search_user_recv(). + </para> + <programlisting> +filter:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_save_begin</term> + <listitem> + <para> + Зондирует функцию sdap_search_user_save_begin(). + </para> + <programlisting> +filter:строка + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_save_end</term> + <listitem> + <para> + Зондирует функцию sdap_search_user_save_end(). + </para> + <programlisting> +filter:строка + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='data-provider-request-probes'> + <title>Зонды запросов поставщика данных</title> + <para> + <variablelist> + <varlistentry> + <term>probe dp_req_send</term> + <listitem> + <para> + Запрос поставщика данных отправлен. + </para> + <programlisting> +dp_req_domain:строка +dp_req_name:строка +dp_req_target:целое число +dp_req_method:целое число + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe dp_req_done</term> + <listitem> + <para> + Запрос поставщика данных завершён. + </para> + <programlisting> +dp_req_name:строка +dp_req_target:целое число +dp_req_method:целое число +dp_ret:целое число +dp_errorstr:строка + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='miscellaneous-functions'> + <title>ПРОЧИЕ ФУНКЦИИ</title> + <para> + Далее приводится список точек зондирования и аргументов, которые доступны в +следующем формате: + </para> + <variablelist> + <varlistentry> + <term>function acct_req_desc(entry_type)</term> + <listitem> + <para> + Преобразовать entry_type в строку и вернуть строку + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>function sssd_acct_req_probestr(fc_name, entry_type, filter_type, +filter_value, extra_value)</term> + <listitem> + <para> + Создать строку зондирования на основании типа фильтра + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>function dp_target_str(target)</term> + <listitem> + <para> + Преобразовать цель в строку и вернуть строку + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>function dp_method_str(target)</term> + <listitem> + <para> + Преобразовать метод в строку и вернуть строку + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + + <refsect1 id='sample-systemtap-scripts'> + <title>ПРИМЕРЫ СЦЕНАРИЕВ SYSTEMTAP</title> + <para> + Запустите сценарий SystemTap (<command>stap +/usr/share/sssd/systemtap/<script_name>.stp</command>), затем +выполните операцию идентификации, и сценарий соберёт данные с помощью +зондов. + </para> + <para> + Предоставляемые пакетом сценарии SystemTap: + </para> + <variablelist> + <varlistentry> + <term>dp_request.stp</term> + <listitem> + <para> + Отслеживание скорости обработки запросов поставщиком данных. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>id_perf.stp</term> + <listitem> + <para> + Отслеживание скорости выполнения команды <command>id</command>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ldap_perf.stp</term> + <listitem> + <para> + Отслеживание запросов LDAP. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>nested_group_perf.stp</term> + <listitem> + <para> + Скорость разрешения вложенных групп. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" /> + +</refentry> +</reference> |