'\" t
.\"     Title: sssd-systemtap
.\"    Author: Основна гілка розробки SSSD \(em https://pagure.io/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
Точки зондування SystemTap додано до різноманітних частин коду SSSD, щоб полегшити усування вад та аналіз пов\*(Aqязаних зі швидкодією проблем\&.
.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
зонд $назва
.RS 4
Опис точки зондування
.sp
.if n \{\
.RS 4
.\}
.nf
змінна1:тип даних
змінна2:тип даних
змінна3:тип даних
\&.\&.\&.
                        
.fi
.if n \{\
.RE
.\}
.RE
.SS "Зонди операцій із базою даних"
.PP
.PP
зонд sssd_transaction_start
.RS 4
Розпочати операцію sysdb, зондує функцію sysdb_transaction_start()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:ціле число
probestr:рядок
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
зонд sssd_transaction_cancel
.RS 4
Скасовування операції sysdb, зондує функцію sysdb_transaction_cancel() \&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:ціле число
probestr:рядок
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
зонд sssd_transaction_commit_before
.RS 4
Зондує функцію sysdb_transaction_commit_before()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
nesting:ціле число
probestr:рядок
                        
.fi
.if n \{\
.RE
.\}
.RE
.PP
зонд 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
зонд 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
зонд 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
зонд 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()\&. Викликається після завершення обробки отриманого об\*(Aqєкта\&.
.RE
.PP
зонд 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
зонд 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
зонд 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
зонд 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
зонд sdap_search_user_send
.RS 4
Зондує функцію sdap_search_user_send()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:рядок
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
зонд sdap_search_user_recv
.RS 4
Зондує функцію sdap_search_user_recv()\&.
.sp
.if n \{\
.RS 4
.\}
.nf
filter:рядок
                       
.fi
.if n \{\
.RE
.\}
.RE
.PP
зонд 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
зонд 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
зонд 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
зонд 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
функція acct_req_desc(entry_type)
.RS 4
Перетворення entry_type на рядок і повернення рядка
.RE
.PP
функція sssd_acct_req_probestr(fc_name, entry_type, filter_type, filter_value, extra_value)
.RS 4
Створення рядка зонду на основі типу фільтрування
.RE
.PP
функція dp_target_str(target)
.RS 4
Перетворення target на рядок і повернення рядка
.RE
.PP
функція dp_method_str(target)
.RS 4
Перетворення методу на рядок і повернення рядка
.RE
.SH "ЗРАЗКИ СКРИПТІВ SYSTEMTAP"
.PP
Запустіть скрипт SystemTap (\fBstap /usr/share/sssd/systemtap/<назва_скрипту>\&.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Основна гілка розробки SSSD \(em
https://pagure\&.io/SSSD/sssd/\fR