.\" Copyright (c) 2017-2025 The strace developers.
.\" All rights reserved.
.\"
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.\"
.\" Required option.
.de OR
.  ie \\n(.$-1 \
.    RI "\fB\\$1\fP" "\ \\$2"
.  el \
.    BR "\\$1"
..
.\"
.TH STRACE-LOG-MERGE 1 "2025-07-02" "strace 7.0"
.\"
.SH "نام (NAME)"
strace\-log\-merge \- ادغام خروجی‌های strace \-ff \-tt
.\"
.SH "خلاصه دستور (SYNOPSIS)"
.SY strace\-log\-merge
.IR STRACE_LOG
.YS
.SY strace\-log\-merge
.OR \-\-help
.YS
.\"
.SH "توضیحات (DESCRIPTION)"

.B strace\-log\-merge
فایل‌های لاگ تولید شده توسط دستور
.B strace \-ff \-tt[t]
را ادغام می‌کند.
این ابزار شناسه فرایند (PID) را به ابتدای هر خط اضافه کرده و
خروجی ترکیب‌شده را بر اساس برچسب زمانی به‌ترتیب زمانی مرتب می‌کند.
.\"
.SH "گزینه‌ها (OPTIONS)"
.\"
.TP
.B \-\-help
نمایش نحوه استفاده از برنامه و خروج.
.TP
.I STRACE_LOG
پیشوند نام فایل‌ها را برای لاگ‌های تولید شده توسط دستور
.B strace \-ff \-tt[t]
مشخص می‌کند.
این ابزار تمام فایل‌های منطبق با الگوی STRACE_LOG.* را خواهد خواند.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.B 0
موفقیت‌آمیز
.TP
.B Non-zero
خطایی رخ داده است.
این خطا می‌تواند به دلیل مشخص نکردن آرگومان
(که در این حالت اطلاعات نحوه استفاده چاپ می‌شود)
یا بروز خطا در حین پردازش فایل‌های
.IR STRACE_LOG ".*"
باشد.
.\"
.SH "مثال‌ها (EXAMPLES)"
.sp
.nf
.ft CW
$ strace -o sleepy -ff -tt -e trace=execve,nanosleep \\
        sh -c 'sleep 0.1 & sleep 0.2 & sleep 0.3'
$ strace-log-merge sleepy | fold -w 72 -s
13475 21:13:52.040837 execve("/bin/sh", ["sh", "-c", "sleep 0.1 & sleep
0.2 & sleep 0."...], 0x7ffde54b2450 /* 33 vars */) = 0
13478 21:13:52.044050 execve("/bin/sleep", ["sleep", "0.3"],
0x5631be4f87a8 /* 33 vars */) = 0
13476 21:13:52.044269 execve("/bin/sleep", ["sleep", "0.1"],
0x5631be4f87a8 /* 33 vars */) = 0
13477 21:13:52.044389 execve("/bin/sleep", ["sleep", "0.2"],
0x5631be4f87a8 /* 33 vars */) = 0
13478 21:13:52.046207 nanosleep({tv_sec=0, tv_nsec=300000000}, NULL) = 0
13476 21:13:52.046303 nanosleep({tv_sec=0, tv_nsec=100000000}, NULL) = 0
13477 21:13:52.046318 nanosleep({tv_sec=0, tv_nsec=200000000}, NULL) = 0
13476 21:13:52.146852 +++ exited with 0 +++
13475 21:13:52.146942 --- SIGCHLD {si_signo=SIGCHLD,
si_code=CLD_EXITED, si_pid=13476, si_uid=1000, si_status=0, si_utime=0,
si_stime=0} ---
13477 21:13:52.247782 +++ exited with 0 +++
13475 21:13:52.247885 --- SIGCHLD {si_signo=SIGCHLD,
si_code=CLD_EXITED, si_pid=13477, si_uid=1000, si_status=0, si_utime=0,
si_stime=0} ---
13478 21:13:52.347680 +++ exited with 0 +++
13475 21:13:52.347786 --- SIGCHLD {si_signo=SIGCHLD,
si_code=CLD_EXITED, si_pid=13478, si_uid=1000, si_status=0, si_utime=0,
si_stime=0} ---
13475 21:13:52.348069 +++ exited with 0 +++
.ft R
.fi
.sp
.\"
.SH "نکات (NOTES)"
.I strace\-log\-merge
ممکن است در مرتب‌سازی صحیح لاگ‌هایی که با
.B \-tt
تولید شده و از نیمه‌شب عبور می‌کنند، با مشکل مواجه شود.
دلیل این امر آن است که برچسب زمانی استاندارد
.B \-tt
فاقد اطلاعات مربوط به تاریخ است، در حالی که برای مرتب‌سازی درست به این اطلاعات نیاز است.
استفاده از گزینه
.B \-ttt
همراه با
.B strace
این مشکل را برطرف می‌کند، زیرا قالب برچسب زمانی آن شامل تاریخ نیز می‌شود.
.\"
.SH "اشکالات (BUGS)"
.I strace\-log\-merge
قالب فایل‌های ورودی را اعتبارسنجی نمی‌کند.
این ابزار فرض می‌کند تمام فایل‌های منطبق با الگوی
.IR STRACE_LOG ".*"
فایل‌های لاگ با قالب‌بندی صحیح مربوط به یک نشست واحد
.B strace
هستند.
.\"
.SH "تاریخچه (HISTORY)"
نسخه اولیه
.I strace-log-merge
در سال ۲۰۱۲ توسط Denys Vlasenko نوشته شد.
.\"
.SH "گزارش باگ‌ها (REPORTING BUGS)"
مشکلات مربوط به
.B strace-log-merge
باید به فهرست پستی
.B strace
به نشانی <strace\-devel@lists.strace.io> گزارش شوند.
.\"
.SH "همچنین ببینید (SEE ALSO)"
.BR strace (1)