'\" t
.\"     Title: trace-cmd-hist
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 03/09/2026
.\"    Manual: libtracefs Manual
.\"    Source: libtracefs
.\"  Language: Persian
.\"
.TH "TRACE\-CMD\-HIST" "1" "03/09/2026" "libtracefs" "libtracefs Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
trace\-cmd\-hist \- نمایش هیستوگرام رویدادها در فایل trace\&.dat
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd hist\fR [\fIOPTIONS\fR][\fIinput\-file\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBtrace\-cmd\fR(1) hist شکلی از هیستوگرام را از فایل \fItrace\&.dat\fR نمایش می‌دهد\&. این دستور به جای نمایش رویدادها بر اساس ترتیبی که رخ داده‌اند، یک هیستوگرام ایجاد می‌کند که می‌تواند به ازای هر وظیفه یا برای تمامی وظایف نمایش داده شود، به‌گونه‌ای که متداول‌ترین رویدادها در ابتدا ظاهر می‌شوند\&. این ابزار از ردیاب توابع (function tracer) و پشته‌های فراخوانی (call stacks) که می‌یابد، برای تشکیل یک گراف فراخوانی (call graph) از رویدادها استفاده می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-i\fR \fIinput\-file\fR
.RS 4
به‌طور پیش‌فرض، \fBtrace\-cmd hist\fR فایل
\fItrace\&.dat\fR
را می‌خواند؛ اما گزینهٔ
\fB\-i\fR
به جای آن،
\fIinput\-file\fR
مشخص‌شده را باز می‌کند\&. توجه داشته باشید که فایل ورودی را می‌توان به عنوان آخرین مورد در خط فرمان نیز مشخص کرد\&.
.RE
.PP
\fB\-P\fR
.RS 4
برای فشرده‌سازی همهٔ رویدادها و نمایش گراف‌های فراخوانی با نادیده گرفتن وظایف و PIDهای مختلف، گزینهٔ
\fB\-P\fR
را اضافه کنید\&. این گزینه به جای نمایش نام وظیفه، تمام زنجیره‌ها را با هم گروه‌بندی کرده و «<all pids>» را نمایش می‌دهد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
trace\-cmd(1), trace\-cmd\-record(1), trace\-cmd\-report(1), trace\-cmd\-start(1), trace\-cmd\-stop(1), trace\-cmd\-extract(1), trace\-cmd\-reset(1), trace\-cmd\-split(1), trace\-cmd\-listen(1)
.SH "نویسندگان (AUTHORS)"
.sp
نوشته‌شده توسط Steven Rostedt، <\m[blue]\fBrostedt@goodmis\&.org\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "منابع (RESOURCES)"
.sp
\m[blue]\fBhttps://git\&.kernel\&.org/pub/scm/utils/trace\-cmd/trace\-cmd\&.git\fR\m[]
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
کپی‌رایت (C) ۲۰۱۰ متعلق به Red Hat, Inc است\&. استفادهٔ آزاد از این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GPL) مجاز است\&.
.SH "نکات (NOTES)"
.IP " 1." 4
rostedt@goodmis.org
.RS 4
\%mailto:rostedt@goodmis.org
.RE