.\" -*- nroff -*-
.TH STAPBPF 8
.SH "نام (NAME)"
stapbpf \- زمان‌اجرای BPF ابزار systemtap

.\" macros
.de SAMPLE

.nr oldin \\n(.i
.br
.RS
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
.in \\n[oldin]u

..


.SH "خلاصه دستور (SYNOPSIS)"

.br
.B stapbpf
[
.I OPTIONS
]
.I MODULE

.SH "توضیحات (DESCRIPTION)"

برنامه
.I stapbpf
بخش پشتی (بک‌اند) مبتنی بر BPF برای ابزار Systemtap است. این برنامه انتظار یک فایل bpf-elf تولیدشده توسط ابزار فرانت‌اند
.I stap
(هنگام اجرا با گزینه
.IR \-\-runtime=bpf )
را دارد.

.PP
تفکیک ابزار systemtap به یک بخش فرانت‌اند و یک بخش بک‌اند به کاربر اجازه می‌دهد تا یک اسکریپت systemtap را روی یک سیستم توسعه که دارای اطلاعات اشکال‌زدایی مورد نیاز برای کامپایل اسکریپت است کامپایل کند و سپس شیء مشترک (shared object) حاصل را به یک سیستم عملیاتی که هیچ‌گونه ابزار توسعه یا اطلاعات اشکال‌زدایی روی آن نصب نیست، انتقال دهد.
.PP
لطفاً برای آگاهی از شماره نسخه به
.IR stappaths (7)
مراجعه کنید، یا دستورات زیر را اجرا نمایید:
.PP
\& $ rpm \-q systemtap # (برای Fedora/RHEL)
.br
\& $ apt\-get \-v systemtap # (برای Ubuntu)

.SH "گزینه‌ها (OPTIONS)"
برنامه
.I stapbpf
از گزینه‌های زیر پشتیبانی می‌کند. هر گزینه دیگری فهرستی از گزینه‌های پشتیبانی‌شده را چاپ می‌کند.
.TP
.B \-v
حالت پرگو (نمایش با جزئیات کامل).
.TP
.B \-V
چاپ شماره نسخه و خروج.
.TP
.B \-w
نادیده گرفتن هشدارهای اسکریپت.
.TP
.B \-h
چاپ پیام راهنما.
.TP
.B \-x PID
متغیر '_stp_target' به PID داده‌شده مقداردهی خواهد شد.
.TP
.B \-o FILE
ارسال خروجی به FILE.

.SH "آرگومان‌ها (ARGUMENTS)"
.B MODULE
مسیر یک فایل bpf-elf تولیدشده توسط ابزار فرانت‌اند
.I stap
(هنگام اجرا با گزینه
.IR \-\-runtime=bpf )
است.

.SH "مثال‌ها (EXAMPLES)"
در اینجا یک مثال بسیار ابتدایی از نحوه تولید یک ماژول
.IR stapbpf
آورده شده است.
ابتدا از
.I stap
برای کامپایل یک اسکریپت استفاده کنید. برنامه
.I stap
نام ماژول حاصل را در دایرکتوری کاری جاری گزارش خواهد داد.
.PP
\& $ stap \-\-runtime=bpf \-p4 \-e \[aq]probe begin { printf("Hello World!\\n"); exit() }\[aq]
.br
\& stap_28784.bo
.PP
برنامه
.I stapbpf
را با مسیر ماژول به عنوان آرگومان اجرا کنید.
.PP
\& $ stapbpf ./stap_28784.bo
.br
\& Hello World!
.PP
اگر گزینه
.I \-p4
حذف شود،
.I stap
به‌طور خودکار
.I stapbpf
را فراخوانی خواهد کرد.

.SH "محدودیت‌ها (LIMITATIONS)"
این محیط زمان‌اجرا در مراحل اولیه توسعه قرار دارد و در حال حاضر فاقد پشتیبانی از تعدادی از قابلیت‌های موجود در زمان‌اجرای پیش‌فرض است.
زیرمجموعه‌ای از نقاط کاوش (probe points) زیر پشتیبانی می‌شوند:

.SAMPLE
begin
end
kernel.*
process.*
timer.*
perf.*
procfs.*
.ESAMPLE

.PP
به‌طور کلی، کاوش‌های مبتنی بر زیرساخت‌های kprobes، uprobes، tracepoint و perf پشتیبانی می‌شوند. برای اطلاعات بیشتر درباره نقاط کاوش و زیرساخت‌های ردیابی که این نقاط بر آنها مبتنی هستند، به
.IR stapprobes (3stap)
مراجعه کنید.
.PP
حلقه‌های
.BR for ،
حلقه‌های
.B foreach
و حلقه‌های
.B while
فقط در کاوش‌های
.B begin
و
.B end
قابل استفاده هستند. عبارات
.B try
پشتیبانی نمی‌شوند.
.PP
پشتیبانی محدودی از عملیات رشته‌ای وجود دارد. متغیرها و مقادیر مستقیم رشته‌ای (literals) به ۶۴ کاراکتر محدود شده‌اند، به‌جز رشته‌های قالب‌بندی
.BR printf
که حداکثر تا ۲۵۶ کاراکتر مجاز هستند.
.PP
زیرمجموعه‌ای از قابلیت‌های تجمیع آماری در دسترس است و تنها از توابع استخراج‌کننده
.IR @count() ", " @sum() ", " @avg()
پشتیبانی می‌شود.
.PP
نام فایل bpf-elf تولیدشده توسط ابزار فرانت‌اند
.I stap
نباید تغییر داده شود.

.SH "ایمنی و امنیت (SAFETY AND SECURITY)"
برای اطلاعات بیشتر در مورد ایمنی و امنیت، به صفحه راهنمای
.IR stap (1)
مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
.IR stap (1),
.IR stapprobes (3stap),
.IR staprun (8),
.IR stapex (3stap)

.SH "اشکالات (BUGS)"
از پیوند Bugzilla در صفحه وب پروژه یا فهرست پستی ما استفاده کنید.
.nh
.BR http://sourceware.org/systemtap ", " <systemtap@sourceware.org> .
.hy