'\" t
.\"     Title: sssd-systemtap
.\"    Author: SSSD uppströms \(en https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 05/17/2024
.\"    Manual: Filformat och konventioner
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSSD\-SYSTEMTAP" "5" "05/17/2024" "SSSD" "Filformat och konventioner"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sssd-systemtap \- SSSD systemtap\-information
.SH "BESKRIVNING"
.PP
Denna manualsida innehåller information om systemtap\-funktionen i
\fBsssd\fR(8)\&.
.PP
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\&.
.PP
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Exempel på SystemTap\-skript finns i /usr/share/sssd/systemtap/
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Testpunkter och diverse funktioner definieras i /usr/share/systemtap/tapset/sssd\&.stp respektive /usr/share/systemtap/tapset/sssd_functions\&.stp\&.
.RE
.sp
.SH "TESTPUNKTER"
.PP
Informationen nedan räknar upp testpunkterna och argumenten som är tillgängliga i följande format:
.PP
probe $name
.RS 4
Beskrivning av testpunkten
.sp
.if n \{\
.RS 4
.\}
.nf
variabel1:datatyp
variabel2:datatyp
variabel3:datatyp
\&...
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Databastransaktionstestpunkter"
.PP
.PP
probe sssd_transaction_start
.RS 4
Start av en sysdb\-transaktion, känner av funktionen sysdb_transaction_start()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:heltal
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_cancel
.RS 4
Annullering av en sysdb\-transaktion, känner av funktionen sysdb_transaction_cancel()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:heltal
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_commit_before
.RS 4
Känner av funktionen sysdb_transaction_commit_before()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:heltal
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_commit_after
.RS 4
Känner av funktionen sysdb_transaction_commit_after()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:heltal
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "LDAP\-sökningstestpunkter"
.PP
.PP
probe sdap_search_send
.RS 4
Känner av funktionen sdap_get_generic_ext_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:sträng
scope:heltal
filter:sträng
attrs:sträng
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_recv
.RS 4
Känner av funktionen sdap_get_generic_ext_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:sträng
scope:heltal
filter:sträng
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_parse_entry
.RS 4
Känner av funktionen sdap_parse_entry()\&. Den anropas upprepat för varje mottaget attribut\&.
.sp
.if n \{\
.RS 4
.\}
.nf
attr:sträng
value:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_parse_entry_done
.RS 4
Känner av funktionen sdap_parse_entry()\&. Den anropas när tolkning av mottagna objekt är klar\&.
.RE
.PP
probe sdap_deref_send
.RS 4
Känner av funktionen sdap_deref_search_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base_dn:sträng
deref_attr:sträng
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_deref_recv
.RS 4
Känner av funktionen sdap_deref_search_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:sträng
scope:heltal
filter:sträng
probestr:sträng
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Testpunkter av LDAP\-kontobegäranden"
.PP
.PP
probe sdap_acct_req_send
.RS 4
Känner av funktionen sdap_acct_req_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
entry_type:heltal
filter_type:heltal
filter_value:sträng
extra_value:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_acct_req_recv
.RS 4
Känner av funktionen sdap_acct_req_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
entry_type:heltal
filter_type:heltal
filter_value:sträng
extra_value:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "Testpunkter av LDAP\-användarsökningar"
.PP
.PP
probe sdap_search_user_send
.RS 4
Känner av funktionen sdap_search_user_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_recv
.RS 4
Känner av funktionen sdap_search_user_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_save_begin
.RS 4
Känner av funktionen sdap_search_user_save_begin()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_save_end
.RS 4
Känner av funktionen sdap_search_user_save_end()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "Testpunkter av dataleverantörsbegäranden"
.PP
.PP
probe dp_req_send
.RS 4
En dataleverantörsbegäran skickas\&.
.sp
.if n \{\
.RS 4
.\}
.nf
dp_req_domain:sträng
dp_req_name:sträng
dp_req_target:heltal
dp_req_method:heltal
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe dp_req_done
.RS 4
En dataleverantörsbegäran avslutas\&.
.sp
.if n \{\
.RS 4
.\}
.nf
dp_req_name:sträng
dp_req_target:heltal
dp_req_method:heltal
dp_ret:heltal
dp_errorstr:sträng
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "DIVERSE FUNKTIONER"
.PP
Informationen nedan räknar upp testpunkterna och argumenten som är tillgängliga i följande format:
.PP
funktionen acct_req_desc(posttyp)
.RS 4
Konvertera posttyp till en sträng och returnera strängen
.RE
.PP
function sssd_acct_req_probestr(fc_namn, posttyp, filtertyp, filtervärde, extravärde)
.RS 4
Skapa testpunktsträng baserad på filtertyp
.RE
.PP
funktionen dp_target_str(mål)
.RS 4
Konvertera målet till en sträng och returnera strängen
.RE
.PP
funktionen dp_method_str(mål)
.RS 4
Konvertera metoden till en sträng och returnera strängen
.RE
.SH "PROV PÅ SYSTEMTAP\-SKRIPT"
.PP
Starta SystemTap\-skriptet (\fBstap /usr/share/sssd/systemtap/<skriptnamn>\&.stp\fR), utför sedan en identitetsåtgärd och skriptet kommer samla information från sonder\&.
.PP
Levererade SystemTap\-skript är:
.PP
dp_request\&.stp
.RS 4
Övervakning av prestanda hos dataleverantörbegäranden\&.
.RE
.PP
id_perf\&.stp
.RS 4
Övervakning av prestanda hos kommandot
\fBid\fR\&.
.RE
.PP
ldap_perf\&.stp
.RS 4
Övervakning av LDAP\-begäranden\&.
.RE
.PP
nested_group_perf\&.stp
.RS 4
Prestanda vid uppslagning av nästade grupper\&.
.RE
.SH "SE ÄVEN"
.PP
\fBsssd\fR(8),
\fBsssd.conf\fR(5),
\fBsssd-ldap\fR(5),
\fBsssd-ldap-attributes\fR(5),
\fBsssd-krb5\fR(5),
\fBsssd-simple\fR(5),
\fBsssd-ipa\fR(5),
\fBsssd-ad\fR(5),
\fBsssd-files\fR(5),
\fBsssd-sudo\fR(5),
\fBsssd-session-recording\fR(5),
\fBsss_cache\fR(8),
\fBsss_debuglevel\fR(8),
\fBsss_obfuscate\fR(8),
\fBsss_seed\fR(8),
\fBsssd_krb5_locator_plugin\fR(8),
\fBsss_ssh_authorizedkeys\fR(8), \fBsss_ssh_knownhostsproxy\fR(8),
\fBsssd-ifp\fR(5),
\fBpam_sss\fR(8)\&.
\fBsss_rpcidmapd\fR(5)
.SH "AUTHORS"
.PP
\fBSSSD uppströms \(en
https://github\&.com/SSSD/sssd/\fR