.TH tcplife.bt 8  "2019-07-03" "USER COMMANDS"
.SH "نام (NAME)"
tcplife.bt \- ردیابی طول عمر نشستهای TCP همراه با آمار اتصال
.SH "خلاصه دستور (SYNOPSIS)"
.B tcplife.bt
.SH "توضیحات (DESCRIPTION)"
این ابزار طول عمر نشست‌های TCP را که در طول ردیابی باز و بسته می‌شوند نشان می‌دهد و آمار مربوط به مدت زمان و توان عملیاتی (throughput) را نمایش می‌دهد. به منظور افزایش کارایی، این ابزار به‌جای ردیابی تک‌تک بسته‌ها، تنها تغییرات وضعیت TCP را ردیابی و ابزارگذاری (instrument) می‌کند.
.PP
این ابزار با استفاده از نقطه ردیابی (tracepoint) به نام
.B sock:inet_sock_set_state
کار می‌کند که در لینوکس ۴.۱۶ اضافه شده است.
.PP
از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.
.SH "الزامات (REQUIREMENTS)"
CONFIG_BPF، ابزار bpftrace و نقطه ردیابی sock:inet_sock_set_state (لینوکس ۴.۱۶ به بعد).
.SH "مثال‌ها (EXAMPLES)"
.TP
نمایش نشست‌های TCP همراه با جزئیات:
#
.B tcplife.bt
.SH "فیلدها (FIELDS)"
.TP
PID
شناسه فرآیند (Process ID).
.TP
COMM
نام فرآیند.
.TP
LADDR
نشانی IP محلی.
.TP
LPORT
درگاه محلی.
.TP
RADDR
نشانی IP راه دور.
.TP
RPORT
درگاه راه دور.
.TP
TX_KB
مجموع کیلوبایت‌های ارسالی.
.TP
RX_KB
مجموع کیلوبایت‌های دریافتی.
.TP
MS
طول عمر نشست، بر حسب میلی‌ثانیه.
.SH "سربار (OVERHEAD)"
این ابزار تابع تغییر وضعیت TCP در هسته را ردیابی می‌کند که بسیار کمتر از ردیابی ارسال/دریافت فراخوانی می‌شود و در نتیجه سربار کمتری دارد. سربار این ابزار متناسب با نرخ نشست‌های جدید TCP است: اگر این نرخ بالا باشد (بیش از ۱۰٬۰۰۰ نشست در ثانیه)، ممکن است صرفاً به دلیل چاپ ۱۰ هزار خط خروجی قالب‌بندی‌شده در هر ثانیه، سربار قابل توجهی ایجاد شود.
.PP
می‌توانید نرخ نشست‌های جدید TCP را با استفاده از دستور
.B "sar \-n TCP 1"
و جمع زدن ستون‌های
.B active/s
و
.B passive/s
به دست آورید.
.PP
همانند همیشه، پیش از استفاده در محیط عملیاتی، سربار این ابزار را متناسب با نوع بار کاری خود آزمایش کرده و ارزیابی نمایید.
.SH "منبع (SOURCE)"
این ابزار ابتدا در مخزن BCC پدید آمد:
.IP
https://github.com/iovisor/bcc
.PP
نسخه BCC گزینه‌های خط فرمان متعددی برای سفارشی‌سازی خروجی دارد.
.PP
این نسخه bpftrace برگرفته از کتاب "BPF Performance Tools"، منتشر شده توسط انتشارات Addison Wesley (سال ۲۰۱۹) است:
.IP
http://www.brendangregg.com/bpf-performance-tools-book.html
.PP
برای مستندات بیشتر درباره این ابزار به کتاب مراجعه کنید.
.PP
این نسخه bpftrace در مخزن bpftrace قرار دارد:
.IP
https://github.com/bpftrace/bpftrace
.PP
همچنین در توزیع bpftrace به فایل همراه _examples.txt که شامل نمونه‌های کاربرد، خروجی و توضیحات تکمیلی این ابزار است مراجعه کنید.
.SH "سیستم‌عامل (OS)"
Linux
.SH "پایداری (STABILITY)"
ناپایدار \- در حال توسعه.
.SH "نویسنده (AUTHOR)"
Brendan Gregg
.SH "همچنین ببینید (SEE ALSO)"
tcptop(8)