SSSD-SYSTEMTAP(5)

📦
version 2.13.1 · 18 versions
, in fedora 43, fedora 44

💅 SSSD-SYSTEMTAP(5) — File Formats and Conventions 🦋

okay bestie, so this is the sssd-systemtap page, and it lives in section 5 of the manual (that's the File Formats and Conventions girlies ✨). If you've ever been like "why is my SSSD doing That™", this page is the backstage pass. Let's get into it 🎀

✨ NAME ✨

sssd-systemtap — the whole tea on SSSD's SystemTap situation ☕💖

🌸 DESCRIPTION 🌸

So basically this manual page is your little info dump about the systemtap functionality inside sssd(8). That's the vibe. 💫

SystemTap Probe points have been sprinkled into various locations all over the SSSD code — lowkey everywhere, main character energy — and their whole job is to help you troubleshoot and analyze performance related issues. iykyk 🔥

  • Sample SystemTap scripts are provided in /usr/share/sssd/systemtap/ 🎀
  • Probes and miscellaneous functions are defined in /usr/share/systemtap/tapset/sssd.stp and /usr/share/systemtap/tapset/sssd_functions.stp respectively. (yes, two files, they're a duo, iconic 💅)

👑 PROBE POINTS 👑

The info below lists the probe points and arguments available, in the following format — memorize it, it's the whole pattern:

probe $name
    Description of probe point

        variable1:datatype
        variable2:datatype
        variable3:datatype
        ...

🗄️ Database Transaction Probes

  • probe sssd_transaction_start — Start of a sysdb transaction. Probes the sysdb_transaction_start() function.
nesting:integer
probestr:string
  • probe sssd_transaction_cancel — Cancellation of a sysdb transaction. Probes the sysdb_transaction_cancel() function.
nesting:integer
probestr:string
  • probe sssd_transaction_commit_before — Probes the sysdb_transaction_commit_before() function.
nesting:integer
probestr:string
  • probe sssd_transaction_commit_after — Probes the sysdb_transaction_commit_after() function.
nesting:integer
probestr:string

🔍 LDAP Search Probes

  • probe sdap_search_send — Probes the sdap_get_generic_ext_send() function.
base:string
scope:integer
filter:string
attrs:string
probestr:string
  • probe sdap_search_recv — Probes the sdap_get_generic_ext_recv() function.
base:string
scope:integer
filter:string
probestr:string
  • probe sdap_parse_entry — Probes the sdap_parse_entry() function. It is called repeatedly with every received attribute. (every single one, it's thorough like that 💅)
attr:string
value:string
  • probe sdap_parse_entry_done — Probes the sdap_parse_entry() function. It is called when parsing of received object is finished. ✨
  • probe sdap_deref_send — Probes the sdap_deref_search_send() function.
base_dn:string
deref_attr:string
probestr:string
  • probe sdap_deref_recv — Probes the sdap_deref_search_recv() function.
base:string
scope:integer
filter:string
probestr:string

🫶 LDAP Account Request Probes

  • probe sdap_acct_req_send — Probes the sdap_acct_req_send() function.
entry_type:int
filter_type:int
filter_value:string
extra_value:string
  • probe sdap_acct_req_recv — Probes the sdap_acct_req_recv() function.
entry_type:int
filter_type:int
filter_value:string
extra_value:string

🧚 LDAP User Search Probes

  • probe sdap_search_user_send — Probes the sdap_search_user_send() function.
filter:string
  • probe sdap_search_user_recv — Probes the sdap_search_user_recv() function.
filter:string
  • probe sdap_search_user_save_begin — Probes the sdap_search_user_save_begin() function.
filter:string
  • probe sdap_search_user_save_end — Probes the sdap_search_user_save_end() function.
filter:string

💜 Data Provider Request Probes

  • probe dp_req_send — A Data Provider request is submitted. (sending it, slay 🚀)
dp_req_domain:string
dp_req_name:string
dp_req_target:int
dp_req_method:int
  • probe dp_req_done — A Data Provider request is completed. ✅
dp_req_name:string
dp_req_target:int
dp_req_method:int
dp_ret:int
dp_errorstr:string

🎀 MISCELLANEOUS FUNCTIONS 🎀

Same deal as before — the info below lists the probe points and arguments available in the following format:

  • function acct_req_desc(entry_type) — Convert entry_type to string and return string 💫
  • function sssd_acct_req_probestr(fc_name, entry_type, filter_type, filter_value, extra_value) — Create probe string based on filter type 🔥
  • function dp_target_str(target) — Convert target to string and return string ⭐
  • function dp_method_str(target) — Convert target to string and return string 🌈

🦋 SAMPLE SYSTEMTAP SCRIPTS 🦋

Here's how you run one, bestie: start the SystemTap script

stap /usr/share/sssd/systemtap/<script_name>.stp

then perform an identity operation, and the script will collect information from probes. that's it, that's the whole ritual 🕯️✨

Provided SystemTap scripts are:

  • dp_request.stp — Monitoring of data provider request performance. 👑
  • id_perf.stp — Monitoring of id command performance. 🔍
  • ldap_perf.stp — Monitoring of LDAP queries. 🌐
  • nested_group_perf.stp — Performance of nested groups resolving. 🪆

👀 SEE ALSO 👀

the whole friend group, fr fr:

sssd(8), sssd.conf(5), sssd-ldap(5), sssd-ldap-attributes(5), sssd-krb5(5), sssd-simple(5), sssd-ipa(5), sssd-ad(5), sssd-idp(5), sssd-sudo(5), sssd-session-recording(5), sss_cache(8), sss_debuglevel(8), sss_obfuscate(8), sss_seed(8), sssd_krb5_locator_plugin(8), sss_ssh_authorizedkeys(1), sss_ssh_knownhosts(1), sssd-ifp(5), pam_sss(8). sss_rpcidmapd(5) sssd-systemtap(5)

💖 AUTHORS 💖

The SSSD upstream — https://github.com/SSSD/sssd/ 🫶

and that's a wrap on the SSSD-SYSTEMTAP(5) page, bestie 💅✨ this whole thing came from SSSD, version/date stamp 07/08/2026, and it's filed under SSSD-SYSTEMTAP(5) — go probe something iconic, you got this 🎀💖
📦 where this page comes from