'\" t
.\"     Title: sssd-systemtap
.\"    Author: Восходящий источник (\(Foапстрим\(Fc) SSSD \(em https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 05/17/2024
.\"    Manual: Форматы файлов и рекомендации
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSSD\-SYSTEMTAP" "5" "05/17/2024" "SSSD" "Форматы файлов и рекомендации"
.\" -----------------------------------------------------------------
.\" * 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 \- Информация о systemtap SSSD
.SH "ОПИСАНИЕ"
.PP
На этой справочной странице представлена информация о функциональных возможностях systemtap в
\fBsssd\fR(8)\&.
.PP
В различные места кода SSSD были добавлены точки зондирования SystemTap для упрощения анализа и устранения проблем с производительностью\&.
.PP
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Примеры сценариев SystemTap: /usr/share/sssd/systemtap/
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Зонды и прочие функции определены, соответственно, в /usr/share/systemtap/tapset/sssd\&.stp и /usr/share/systemtap/tapset/sssd_functions\&.stp\&.
.RE
.sp
.SH "ТОЧКИ ЗОНДИРОВАНИЯ"
.PP
Далее приводится список точек зондирования и аргументов, которые доступны в следующем формате:
.PP
probe $name
.RS 4
Описание точки зондирования
.sp
.if n \{\
.RS 4
.\}
.nf
variable1:datatype
variable2:datatype
variable3:datatype
\&.\&.\&.
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонды транзакций базы данных"
.PP
.PP
probe sssd_transaction_start
.RS 4
Начало транзакции sysdb, зондирует функцию sysdb_transaction_start()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:целое число
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_cancel
.RS 4
Отмена транзакции sysdb, зондирует функцию sysdb_transaction_cancel()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:целое число
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_commit_before
.RS 4
Зондирует функцию sysdb_transaction_commit_before()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:целое число
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sssd_transaction_commit_after
.RS 4
Зондирует функцию sysdb_transaction_commit_after()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:целое число
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонды поиска LDAP"
.PP
.PP
probe sdap_search_send
.RS 4
Зондирует функцию sdap_get_generic_ext_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:строка
scope:целое число
filter:строка
attrs:строка
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_recv
.RS 4
Зондирует функцию sdap_get_generic_ext_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:строка
scope:целое число
filter:строка
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_parse_entry
.RS 4
Зондирует функцию sdap_parse_entry()\&. Вызывается повторно для каждого полученного атрибута\&.
.sp
.if n \{\
.RS 4
.\}
.nf
attr:строка
value:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_parse_entry_done
.RS 4
Зондирует функцию sdap_parse_entry()\&. Вызывается по завершении обработки полученного объекта\&.
.RE
.PP
probe sdap_deref_send
.RS 4
Зондирует функцию sdap_deref_search_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base_dn:строка
deref_attr:строка
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_deref_recv
.RS 4
Зондирует функцию sdap_deref_search_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
base:строка
scope:целое число
filter:строка
probestr:строка
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонды запросов учётных записей LDAP"
.PP
.PP
probe sdap_acct_req_send
.RS 4
Зондирует функцию sdap_acct_req_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
entry_type:целое число
filter_type:целое число
filter_value:строка
extra_value:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_acct_req_recv
.RS 4
Зондирует функцию sdap_acct_req_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
entry_type:целое число
filter_type:целое число
filter_value:строка
extra_value:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонды поиска пользователей LDAP"
.PP
.PP
probe sdap_search_user_send
.RS 4
Зондирует функцию sdap_search_user_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_recv
.RS 4
Зондирует функцию sdap_search_user_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_save_begin
.RS 4
Зондирует функцию sdap_search_user_save_begin()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe sdap_search_user_save_end
.RS 4
Зондирует функцию sdap_search_user_save_end()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонды запросов поставщика данных"
.PP
.PP
probe dp_req_send
.RS 4
Запрос поставщика данных отправлен\&.
.sp
.if n \{\
.RS 4
.\}
.nf
dp_req_domain:строка
dp_req_name:строка
dp_req_target:целое число
dp_req_method:целое число
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
probe dp_req_done
.RS 4
Запрос поставщика данных завершён\&.
.sp
.if n \{\
.RS 4
.\}
.nf
dp_req_name:строка
dp_req_target:целое число
dp_req_method:целое число
dp_ret:целое число
dp_errorstr:строка
                       
.fi
.if n \{\
.RE
.\}
.RE
.SS "ПРОЧИЕ ФУНКЦИИ"
.PP
Далее приводится список точек зондирования и аргументов, которые доступны в следующем формате:
.PP
function acct_req_desc(entry_type)
.RS 4
Преобразовать entry_type в строку и вернуть строку
.RE
.PP
function sssd_acct_req_probestr(fc_name, entry_type, filter_type, filter_value, extra_value)
.RS 4
Создать строку зондирования на основании типа фильтра
.RE
.PP
function dp_target_str(target)
.RS 4
Преобразовать цель в строку и вернуть строку
.RE
.PP
function dp_method_str(target)
.RS 4
Преобразовать метод в строку и вернуть строку
.RE
.SH "ПРИМЕРЫ СЦЕНАРИЕВ SYSTEMTAP"
.PP
Запустите сценарий SystemTap (\fBstap /usr/share/sssd/systemtap/<script_name>\&.stp\fR), затем выполните операцию идентификации, и сценарий соберёт данные с помощью зондов\&.
.PP
Предоставляемые пакетом сценарии SystemTap:
.PP
dp_request\&.stp
.RS 4
Отслеживание скорости обработки запросов поставщиком данных\&.
.RE
.PP
id_perf\&.stp
.RS 4
Отслеживание скорости выполнения команды
\fBid\fR\&.
.RE
.PP
ldap_perf\&.stp
.RS 4
Отслеживание запросов LDAP\&.
.RE
.PP
nested_group_perf\&.stp
.RS 4
Скорость разрешения вложенных групп\&.
.RE
.SH "СМ\&. ТАКЖЕ"
.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
\fBВосходящий источник (\(Foапстрим\(Fc)
SSSD \(em https://github\&.com/SSSD/sssd/\fR