---
name: "sssd-systemtap"
section: "5"
platform: "linux"
package: "sssd-common"
version: "2.10.1-2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sssd-systemtap"
---

# sssd-systemtap(5)

SSSD systemtap information

## NAME

sssd-systemtap - SSSD systemtap information

## DESCRIPTION

This manual page provides information about the systemtap functionality in [**sssd**(8)](/sssd/8.md).

SystemTap Probe points have been added into various locations in SSSD code to assist in troubleshooting and analyzing performance related issues.

• 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.

## PROBE POINTS

The information below lists the probe points and arguments available in the following format:

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.

```
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.

```
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

The information 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 method to string and return string

## SAMPLE SYSTEMTAP SCRIPTS

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.

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

[**sssd**(8)](/sssd/8.md), [**sssd.conf**(5)](/sssd.conf/5.md), [**sssd-ldap**(5)](/sssd-ldap/5.md), [**sssd-ldap-attributes**(5)](/sssd-ldap-attributes/5.md), [**sssd-krb5**(5)](/sssd-krb5/5.md), [**sssd-simple**(5)](/sssd-simple/5.md), [**sssd-ipa**(5)](/sssd-ipa/5.md), [**sssd-ad**(5)](/sssd-ad/5.md), [**sssd-files**(5)](/sssd-files/5.md), [**sssd-sudo**(5)](/sssd-sudo/5.md), [**sssd-session-recording**(5)](/sssd-session-recording/5.md), [**sss\_cache**(8)](/sss_cache/8.md), [**sss\_debuglevel**(8)](/sss_debuglevel/8.md), [**sss\_obfuscate**(8)](/sss_obfuscate/8.md), [**sss\_seed**(8)](/sss_seed/8.md), [**sssd\_krb5\_locator\_plugin**(8)](/sssd_krb5_locator_plugin/8.md), [**sss\_ssh\_authorizedkeys**(1)](/sss_ssh_authorizedkeys/1.md), [**sss\_ssh\_knownhosts**(1)](/sss_ssh_knownhosts/1.md), [**sssd-ifp**(5)](/sssd-ifp/5.md), [**pam\_sss**(8)](/pam_sss/8.md). [**sss\_rpcidmapd**(5)](/sss_rpcidmapd/5.md) [**sssd-systemtap**(5)](/sssd-systemtap/5.md)

## AUTHORS

**The SSSD upstream - https://github.com/SSSD/sssd/**