.TH ssllatency.bt 8  "2021-12-28" "USER COMMANDS"
.SH "نام (NAME)"
ssllatency.bt \- نمایش هیستوگرام تاخیر دست‌تکانی SSL/TLS با استفاده از bpftrace/eBPF
.SH "خلاصه دستور (SYNOPSIS)"
.B ssllatency.bt
.SH "توضیحات (DESCRIPTION)"
دستور ssllatency توزیع تاخیر توابع دست‌تکانی OpenSSL را نمایش می‌دهد.\& این ابزار برای تحلیل کارایی با مجموعه‌های رمزنگاری (cipher suites) مختلف، شتاب‌بخشی ناهمگام SSL توسط CPU یا دستگاه‌های تخلیه بار (offload) و غیره مفید است.\&
.PP
این ابزار با ردیابی پویای uprobes در OpenSSL و کتابخانه‌های رمزنگاری مرتبط کار می‌کند، و ممکن است برای هماهنگی با تغییرات آتی این توابع نیاز به به‌روزرسانی داشته باشد.\&
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده نماید.\&
.SH "پیش‌نیازها (REQUIREMENTS)"
CONFIG_BPF و bpftrace.\&
.SH "مثال‌ها (EXAMPLES)"
.TP
ردیابی تاخیر دست‌تکانی SSL/TLS و چاپ هیستوگرام با زدن کلیدهای Ctrl-C:
#
.B ssllatency.bt
.SH "فیلدها (FIELDS)"
.TP
0th
نام تابع در "@hist[...]" و به دنبال آن هیستوگرام تاخیر، و در "@stat[...]" به دنبال آن تعداد کل فراخوانی‌ها، میانگین و تاخیر کل بر حسب میکروثانیه نشان داده می‌شود.\& برای برخی توابع، فراخوانی‌های ناموفق غیرصفر به‌طور جداگانه (در "@histF[]" و "@statF[]") ردیابی می‌شوند.\&
.TP
1st, 2nd
این یک بازه تاخیر بر حسب میکروثانیه است (که با نماد مجموعه‌ای "[...)" نمایش داده می‌شود).\&
.TP
3rd
ستونی که تعداد عملیات‌ها را در این بازه نشان می‌دهد.\&
.TP
4th
یک هیستوگرام اسکی (ASCII) که ستون تعداد را نشان می‌دهد.\&
.SH "بار پردازشی (OVERHEAD)"
دست‌تکانی SSL/TLS معمولاً شامل تاخیر شبکه است و توابع رمزنگاری ردیابی‌شده کارهای فشرده محاسباتی CPU هستند، بنابراین بسامد فراخوانی باید پایین باشد و انتظار می‌رود بار پردازشی این ابزار ناچیز باشد.\&
.SH "منبع (SOURCE)"
این ابزار برگرفته از bpftrace است.\&
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین برای مشاهده نمونه‌های نحوه استفاده، خروجی و توضیحات این ابزار، به فایل _examples.txt همراه در توزیع bpftrace مراجعه کنید.\&
.PP
یک ابزار bcc به نام sslsniff وجود دارد که می‌تواند تاخیر رویداد دست‌تکانی SSL/TLS را پیش از شنود متن خام در SSL_read/write نشان دهد.\& ابزار حاضر توزیع جزئی‌تر تاخیر رمزنگاری را در طول رویداد دست‌تکانی ارائه می‌دهد.\&
.IP
https://github.com/iovisor/bcc
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.\&
.SH "نویسنده (AUTHOR)"
Tao Xu
.SH "همچنین ببینید (SEE ALSO)"
sslsnoop.bt(8)