.\" -*- nroff -*-
.TH STAP\-MERGE 1
.SH "نام (NAME)"
stap\-merge \- ادغام‌کننده دودویی به ازای هر پردازنده در systemtap

.\" macros
.\" do not nest SAMPLEs
.de SAMPLE
.br

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

..

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

.br
.B stap\-merge
[
.I OPTIONS
]
[
.I INPUT FILENAMES
]

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

برنامه اجرایی stap\-merge زمانی کاربرد دارد که هنگام اجرای یک اسکریپت
.IR stap 
از گزینه \-b استفاده شده باشد. گزینه \-b فایل‌ها را بر اساس فیلد برچسب زمانی (timestamp) به ازای هر پردازنده (per\-cpu) تولید می‌کند. سپس stap\-merge این فایل‌های per-cpu را بر اساس فیلد برچسب زمانی ادغام و مرتب‌سازی می‌کند.

.SH "گزینه‌ها (OPTIONS)"

برنامه اجرایی ادغام systemtap از گزینه‌های زیر پشتیبانی می‌کند:
.TP
.B \-v
حالت پرگو (verbose)، سه فیلد اضافی را به ازای هر مجموعه از داده‌های جمع‌آوری‌شده نمایش می‌دهد.
.SAMPLE
.BR [cpu number, sequence number of data, the length of the data set]
.ESAMPLE
.TP
.BI \-o " OUTPUT_FILENAME"

نام فایلی را مشخص می‌کند که مایلید خروجی به آن هدایت شود. اگر این گزینه مشخص نشود، خروجی به خروجی استاندارد فرستاده خواهد شد.

.SH "مثال‌ها (EXAMPLES)"
.SAMPLE
$ stap \-v \-b \-e 'probe syscall.open { printf("%s(%d) open\\n",
execname(), pid()) }' 

.ESAMPLE

این دستور باید منجر به ایجاد چند فایل
.I stpd_cpu
شود (که هرکدام با عددی برچسب‌گذاری شده‌اند که نشان‌دهنده پردازنده‌ای است که فایل از آن تولید شده است).

.SAMPLE
$ stap\-merge \-v stpd_cpu0 stpd_cpu1

.ESAMPLE

اجرای برنامه stap\-merge در همان دایرکتوری اسکریپت stap در مثال قبل، دنباله‌ای مرتب از بسته‌ها را با برچسب سه‌بخشی برای هر مجموعه داده تولید می‌کند. این نتیجه به خروجی استاندارد ارسال خواهد شد. همچنین می‌شد با استفاده از گزینه «\-o» یک فایل خروجی مشخص کرد.

.SH "فایل‌ها (FILES)"

.TP
فایل‌های مهم و مسیرهای مربوط به آن‌ها را می‌توان در صفحه راهنمای
.IR stappaths (7)
یافت.

.SH "همچنین ببینید (SEE ALSO)"
.nh
.nf
.IR stapprobes (3stap),
.IR stappaths (7),
.IR staprun (8),
.IR stapvars (3stap),
.IR stapex (3stap),
.IR stap\-server (8),
.IR gdb (1)

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