diff options
Diffstat (limited to 'src/man/sv/sssd-systemtap.5.xml')
| -rw-r--r-- | src/man/sv/sssd-systemtap.5.xml | 435 |
1 files changed, 435 insertions, 0 deletions
diff --git a/src/man/sv/sssd-systemtap.5.xml b/src/man/sv/sssd-systemtap.5.xml new file mode 100644 index 0000000..0e1dc1d --- /dev/null +++ b/src/man/sv/sssd-systemtap.5.xml @@ -0,0 +1,435 @@ +<?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 manualsidor</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">Filformat och konventioner</refmiscinfo> + </refmeta> + + <refnamediv id='name'> + <refname>sssd-systemtap</refname> + <refpurpose>SSSD systemtap-information</refpurpose> + </refnamediv> + + <refsect1 id='description'> + <title>BESKRIVNING</title> + <para> + Denna manualsida innehåller information om systemtap-funktionen i +<citerefentry> <refentrytitle>sssd</refentrytitle> <manvolnum>8</manvolnum> +</citerefentry>. + </para> + <para> + SystemTap-testpunkter har lagts till på diverse platser i SSSD-koden för att +hjälpa till i felsökning och analys av prestandarelaterade problem. + </para> + <para> + <itemizedlist> + <listitem> + <para> + Exempel på SystemTap-skript finns i /usr/share/sssd/systemtap/ + </para> + </listitem> + <listitem> + <para> + Testpunkter och diverse funktioner definieras i +/usr/share/systemtap/tapset/sssd.stp respektive +/usr/share/systemtap/tapset/sssd_functions.stp. + </para> + </listitem> + </itemizedlist> + </para> + </refsect1> + + <refsect1 id='probe-points'> + <title>TESTPUNKTER</title> + <para> + Informationen nedan räknar upp testpunkterna och argumenten som är +tillgängliga i följande format: + </para> + <variablelist> + <varlistentry> + <term>probe $name</term> + <listitem> + <para> + Beskrivning av testpunkten + </para> + <programlisting> +variabel1:datatyp +variabel2:datatyp +variabel3:datatyp +… + </programlisting> + </listitem> + </varlistentry> + </variablelist> + + <refsect2 id='database-transaction-probes'> + <title>Databastransaktionstestpunkter</title> + <para> + <variablelist> + <varlistentry> + <term>probe sssd_transaction_start</term> + <listitem> + <para> + Start av en sysdb-transaktion, känner av funktionen +sysdb_transaction_start(). + </para> + <programlisting> +nesting:heltal +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_cancel</term> + <listitem> + <para> + Annullering av en sysdb-transaktion, känner av funktionen +sysdb_transaction_cancel(). + </para> + <programlisting> +nesting:heltal +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_commit_before</term> + <listitem> + <para> + Känner av funktionen sysdb_transaction_commit_before(). + </para> + <programlisting> +nesting:heltal +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sssd_transaction_commit_after</term> + <listitem> + <para> + Känner av funktionen sysdb_transaction_commit_after(). + </para> + <programlisting> +nesting:heltal +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-search-probes'> + <title>LDAP-sökningstestpunkter</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_search_send</term> + <listitem> + <para> + Känner av funktionen sdap_get_generic_ext_send(). + </para> + <programlisting> +base:sträng +scope:heltal +filter:sträng +attrs:sträng +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_recv</term> + <listitem> + <para> + Känner av funktionen sdap_get_generic_ext_recv(). + </para> + <programlisting> +base:sträng +scope:heltal +filter:sträng +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_parse_entry</term> + <listitem> + <para> + Känner av funktionen sdap_parse_entry(). Den anropas upprepat för varje +mottaget attribut. + </para> + <programlisting> +attr:sträng +value:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_parse_entry_done</term> + <listitem> + <para> + Känner av funktionen sdap_parse_entry(). Den anropas när tolkning av +mottagna objekt är klar. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_deref_send</term> + <listitem> + <para> + Känner av funktionen sdap_deref_search_send(). + </para> + <programlisting> +base_dn:sträng +deref_attr:sträng +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_deref_recv</term> + <listitem> + <para> + Känner av funktionen sdap_deref_search_recv(). + </para> + <programlisting> +base:sträng +scope:heltal +filter:sträng +probestr:sträng + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-account-req-probes'> + <title>Testpunkter av LDAP-kontobegäranden</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_acct_req_send</term> + <listitem> + <para> + Känner av funktionen sdap_acct_req_send(). + </para> + <programlisting> +entry_type:heltal +filter_type:heltal +filter_value:sträng +extra_value:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_acct_req_recv</term> + <listitem> + <para> + Känner av funktionen sdap_acct_req_recv(). + </para> + <programlisting> +entry_type:heltal +filter_type:heltal +filter_value:sträng +extra_value:sträng + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='ldap-user-search-probes'> + <title>Testpunkter av LDAP-användarsökningar</title> + <para> + <variablelist> + <varlistentry> + <term>probe sdap_search_user_send</term> + <listitem> + <para> + Känner av funktionen sdap_search_user_send(). + </para> + <programlisting> +filter:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_recv</term> + <listitem> + <para> + Känner av funktionen sdap_search_user_recv(). + </para> + <programlisting> +filter:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_save_begin</term> + <listitem> + <para> + Känner av funktionen sdap_search_user_save_begin(). + </para> + <programlisting> +filter:sträng + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe sdap_search_user_save_end</term> + <listitem> + <para> + Känner av funktionen sdap_search_user_save_end(). + </para> + <programlisting> +filter:sträng + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='data-provider-request-probes'> + <title>Testpunkter av dataleverantörsbegäranden</title> + <para> + <variablelist> + <varlistentry> + <term>probe dp_req_send</term> + <listitem> + <para> + En dataleverantörsbegäran skickas. + </para> + <programlisting> +dp_req_domain:sträng +dp_req_name:sträng +dp_req_target:heltal +dp_req_method:heltal + </programlisting> + </listitem> + </varlistentry> + <varlistentry> + <term>probe dp_req_done</term> + <listitem> + <para> + En dataleverantörsbegäran avslutas. + </para> + <programlisting> +dp_req_name:sträng +dp_req_target:heltal +dp_req_method:heltal +dp_ret:heltal +dp_errorstr:sträng + </programlisting> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect2> + + <refsect2 id='miscellaneous-functions'> + <title>DIVERSE FUNKTIONER</title> + <para> + Informationen nedan räknar upp testpunkterna och argumenten som är +tillgängliga i följande format: + </para> + <variablelist> + <varlistentry> + <term>funktionen acct_req_desc(posttyp)</term> + <listitem> + <para> + Konvertera posttyp till en sträng och returnera strängen + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>function sssd_acct_req_probestr(fc_namn, posttyp, filtertyp, filtervärde, +extravärde)</term> + <listitem> + <para> + Skapa testpunktsträng baserad på filtertyp + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>funktionen dp_target_str(mål)</term> + <listitem> + <para> + Konvertera målet till en sträng och returnera strängen + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>funktionen dp_method_str(mål)</term> + <listitem> + <para> + Konvertera metoden till en sträng och returnera strängen + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect2> + + </refsect1> + + <refsect1 id='sample-systemtap-scripts'> + <title>PROV PÅ SYSTEMTAP-SKRIPT</title> + <para> + Starta SystemTap-skriptet (<command>stap +/usr/share/sssd/systemtap/<skriptnamn>.stp</command>), utför sedan en +identitetsåtgärd och skriptet kommer samla information från sonder. + </para> + <para> + Levererade SystemTap-skript är: + </para> + <variablelist> + <varlistentry> + <term>dp_request.stp</term> + <listitem> + <para> + Övervakning av prestanda hos dataleverantörbegäranden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>id_perf.stp</term> + <listitem> + <para> + Övervakning av prestanda hos kommandot <command>id</command>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ldap_perf.stp</term> + <listitem> + <para> + Övervakning av LDAP-begäranden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>nested_group_perf.stp</term> + <listitem> + <para> + Prestanda vid uppslagning av nästade grupper. + </para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/seealso.xml" /> + +</refentry> +</reference> |