'\" t
.\"     Title: mkvinfo
.\"    Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-08-24
.\"    Manual: User Commands
.\"    Source: MKVToolNix 101.0
.\"  Language: English
.\"
.TH "MKVINFO" "1" "2026\-08\-24" "MKVToolNix 101\&.0" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
mkvinfo \- چاپ اطلاعات مربوط به عناصر موجود در فایل‌های Matroska(TM)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmkvinfo\fR\ 'u
\fBmkvinfo\fR [options] {source\-filename}
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه تمام عناصر موجود در یک
Matroska(TM)\&
را فهرست می‌کند\&. خروجی را می‌توان به فهرستی از ترک‌های موجود در فایل، شامل اطلاعات مربوط به کدک‌های استفاده‌شده، محدود کرد\&.
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
به‌طور پیش‌فرض،
\fBmkvinfo\fR(1)
هنگامی که با نخستین کلاستر (cluster) مواجه می‌شود متوقف می‌گردد\&. علاوه بر این، برخی از عناصری را که به‌کرات تکرار می‌شوند نمایش نمی‌دهد\&. با این گزینه،
\fBmkvinfo\fR(1)
صرف‌نظر از سطح پرگویی (verbosity level) به پردازش ادامه داده و تمام عناصر را نمایش می‌دهد\&.
.RE
.PP
\fB\-c\fR, \fB\-\-checksums\fR
.RS 4
چک‌سام
\fBAdler\-32\fR
را برای هر فریم محاسبه و نمایش می‌دهد\&. تنها برای اشکال‌زدایی مفید است\&.
.RE
.PP
\fB\-o\fR, \fB\-\-continue\fR
.RS 4
به‌طور پیش‌فرض،
\fBmkvinfo\fR(1)
هنگامی که با نخستین کلاستر مواجه می‌شود متوقف می‌گردد\&. با این گزینه،
\fBmkvinfo\fR(1)
صرف‌نظر از سطح پرگویی به پردازش ادامه خواهد داد\&.
.RE
.PP
\fB\-p\fR, \fB\-\-hex\-positions\fR
.RS 4
موقعیت تمام عناصر را صرف‌نظر از سطح پرگویی به‌صورت هگزادسیمال نمایش می‌دهد\&.
.RE
.PP
\fB\-P\fR, \fB\-\-positions\fR
.RS 4
موقعیت تمام عناصر را صرف‌نظر از سطح پرگویی به‌صورت ده‌دهی (decimal) نمایش می‌دهد\&.
.RE
.PP
\fB\-s\fR, \fB\-\-summary\fR
.RS 4
تنها یک خلاصهٔ مختصر از آنچه
\fBmkvinfo\fR(1)
می‌یابد را نمایش می‌دهد، نه تک‌تک عناصر را\&.
.RE
.PP
\fB\-t\fR, \fB\-\-track\-info\fR
.RS 4
آمار هر ترک را در حالت پرگو (verbose) نمایش می‌دهد\&. همچنین در صورتی که پرگویی پیش‌تر روی سطح 0 بوده باشد، آن را روی 1 تنظیم می‌کند\&.
.RE
.PP
\fB\-x\fR, \fB\-\-hexdump\fR
.RS 4
16 بایت نخست هر فریم را به‌صورت یک hex dump نمایش می‌دهد\&.
.RE
.PP
\fB\-X\fR, \fB\-\-full\-hexdump\fR
.RS 4
تمام بایت‌های هر فریم را به‌صورت یک hex dump نمایش می‌دهد\&.
.RE
.PP
\fB\-z\fR, \fB\-\-size\fR
.RS 4
اندازه هر عنصر را به همراه سرآیند (header) آن نمایش می‌دهد\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های ارائه‌شده در خط فرمان از آن تبدیل شوند\&. پیش‌فرض آن، مجموعه نویسه‌ای ارائه‌شده توسط لوکال فعلی سیستم است\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های خروجی به آن تبدیل شوند\&. پیش‌فرض آن، مجموعه نویسه‌ای ارائه‌شده توسط لوکال فعلی سیستم است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIfile\-name\fR
.RS 4
تمام پیام‌ها را به جای کنسول در فایل
\fIfile\-name\fR
می‌نویسد\&. اگرچه این کار به‌سادگی با تغییر مسیر خروجی (redirection) ممکن است، مواردی وجود دارد که به این گزینه نیاز است: زمانی که ترمینال پیش از نوشتن خروجی در فایل، آن را مجدداً تفسیر می‌کند\&. مجموعه نویسهٔ تعیین‌شده با
\fB\-\-output\-charset\fR
رعایت می‌شود\&.
.RE
.PP
\fB\-\-no\-bom\fR
.RS 4
به‌طور معمول فایل‌های متنی که در یکی از انواع UTF ایجاد و کدگذاری می‌شوند با یک نشانگر ترتیب بایت‌ها (BOM) آغاز می‌شوند\&. استفاده از این گزینه نوشتن آن نشانگر ترتیب بایت‌ها را غیرفعال می‌کند\&.
.RE
.PP
\fB\-\-ui\-language\fR \fIcode\fR
.RS 4
استفاده از ترجمه‌های زبانِ
\fIcode\fR
را اجبار می‌کند (برای مثال \*(Aqde_DE\*(Aq برای ترجمه آلمانی)\&. وارد کردن \*(Aqlist\*(Aq به عنوان
\fIcode\fR
باعث می‌شود برنامه فهرستی از ترجمه‌های موجود را در خروجی نمایش دهد\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
به برنامه دستور می‌دهد که پس از صدور نخستین هشدار متوقف شود\&. کد وضعیت خروج برنامه 1 خواهد بود\&.
.RE
.PP
\fB\-\-debug\fR \fItopic\fR
.RS 4
اشکال‌زدایی را برای یک قابلیت خاص فعال می‌کند\&. این گزینه فقط برای توسعه‌دهندگان مفید است\&.
.RE
.PP
\fB\-\-engage\fR \fIfeature\fR
.RS 4
ویژگی‌های آزمایشی را فعال می‌کند\&. فهرستی از ویژگی‌های موجود را می‌توان با
\fBmkvinfo \-\-engage list\fR
درخواست کرد\&. این ویژگی‌ها برای استفاده در شرایط عادی در نظر گرفته نشده‌اند\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
حالت واسط گرافیکی (GUI) را فعال می‌کند\&. در این حالت ممکن است خطوطی با قالب‌بندی ویژه خروجی داده شوند که به یک واسط گرافیکی کنترل‌کننده گزارش دهند چه اتفاقی در حال رخ دادن است\&. این پیام‌ها از قالب \*(Aq#GUI#message\*(Aq پیروی می‌کنند\&. پیام ممکن است با جفت‌های کلید/مقدار دنبال شود، مانند \*(Aq#GUI#message#key1=value1#key2=value2\&...\*(Aq\&. پیام‌ها و کلیدها هرگز ترجمه نمی‌شوند و همیشه به زبان انگلیسی نمایش داده می‌شوند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
پرگویی بیشتر\&. برای شرح این‌که چه اطلاعاتی در چه سطحی خروجی داده می‌شوند، بخش مربوط به
سطوح پرگویی (verbosity levels)
را ببینید\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش اطلاعات نحوه استفاده و خروج\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخه و خروج\&.
.RE
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
آرگومان‌های خط فرمان اضافی را از فایل
\fIoptions\-file\fR
می‌خواند\&. برای توضیحات کامل در مورد قالب‌های پشتیبانی‌شده برای چنین فایل‌هایی، بخش «Option files» را در صفحه راهنمای
\fBmkvmerge\fR(1)
ببینید\&.
.RE.SH "سطوح جزئیات (VERBOSITY LEVELS)"
.PP
گزینهٔ
\fB\-v\fR
می‌تواند برای افزایش سطح پرگویی (جزئیات)
\fBmkvinfo\fR(1)
و چاپ اطلاعات بیشتر دربارهٔ فایل فعلی به کار رود\&.
.PP
در سطح 0،
\fBmkvinfo\fR(1)
تنها سرآیندهای شیار (track headers) یافته‌شده و نوع آن‌ها را چاپ می‌کند\&.
به محض اینکه سرآیندها به طور کامل تجزیه شوند (از دید فنی‌تر: به محض برخورد با نخستین کلاستر)،
\fBmkvinfo\fR(1)
خارج خواهد شد\&. در این سطح، مدخل‌های seek head و نشانه‌ها (cues) نمایش داده نخواهند شد \-\- حتی اگر پیش از اطلاعات شیار قرار گرفته باشند\&.
.PP
در سطح 1،
\fBmkvinfo\fR(1)
همچنین تمام عنصرهای
Matroska(TM)
مشاهده‌شده در کل فایل به جز مدخل‌های seek head و مدخل‌های cue را چاپ می‌کند\&. اگر حالت خلاصه‌سازی فعال باشد،
\fBmkvinfo\fR(1)
موقعیت فریم را نیز در خروجی می‌آورد\&.
.PP
همین اثر را می‌توان با گزینهٔ
\fB\-\-continue\fR
به دست آورد\&.
.PP
در سطح 2،
\fBmkvinfo\fR(1)
علاوه بر این مدخل‌های seek head، مدخل‌های cue و موقعیت فایلی را که هر عنصر
Matroska(TM)
در آن قرار دارد چاپ خواهد کرد\&.
.PP
همین اثر را می‌توان با گزینه‌های
\fB\-\-all \-\-positions\fR
به دست آورد\&.
.PP
در سطح 3 و بالاتر،
\fBmkvinfo\fR(1)
برخی اطلاعات را که ارتباط مستقیمی با یک عنصر
Matroska(TM)
ندارند چاپ خواهد کرد\&. در تمامی سطوح دیگر، تنها اطلاعات مربوط به عنصرهایی که به‌تازگی پیدا شده‌اند چاپ می‌شود\&. سطح 3 اطلاعات اضافه (متادیتا) را برای تسهیل اشکال‌زدایی می‌افزاید (بخوانید: تنها برای توسعه‌دهندگان در نظر گرفته شده است)\&. تمام خطوط نوشته‌شده توسط سطح 3 در قلاب‌ها (کروشه‌ها) محصور شده‌اند تا فیلتر کردن آن‌ها آسان باشد\&.
.SH "فایل‌های متنی و تبدیل‌های مجموعه‌نویسه (TEXT FILES AND CHARACTER SET CONVERSIONS)"
.PP
برای بررسی دقیق دربارهٔ چگونگی مدیریت تبدیل‌های مجموعه‌نویسه، کدگذاری ورودی/خروجی، کدگذاری خط فرمان و کدگذاری کنسول در تمامی ابزارهای مجموعهٔ MKVToolNix، لطفاً بخشی با همین نام را در صفحهٔ راهنمای
\fBmkvmerge\fR(1)
ببینید\&.
.SH "کدهای خروج (EXIT CODES)"
.PP
\fBmkvinfo\fR(1)
با یکی از این سه کد خروج پایان می‌یابد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\-\- این کد خروج به این معناست که اجرا با موفقیت کامل شده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\-\- در این حالت
\fBmkvinfo\fR(1)
دست‌کم یک هشدار چاپ کرده است، اما اجرا ادامه یافته است\&. پیشوند هر هشدار متن \*(AqWarning:\*(Aq است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\-\- این کد خروج پس از وقوع یک خطا استفاده می‌شود\&.
\fBmkvinfo\fR(1)
بلافاصله پس از چاپ پیام خطا متوقف می‌شود\&. پیام‌های خطا طیفی از آرگومان‌های اشتباه خط فرمان گرفته تا خطاهای خواندن/نوشتن و فایل‌های خراب را شامل می‌شوند\&.
.RE.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBmkvinfo\fR(1)
از متغیرهای پیش‌فرضی که مشخص‌کنندهٔ تنظیمات محلی (locale) سیستم هستند (مانند
\fILANG\fR
و خانوادهٔ
\fILC_*\fR)
استفاده می‌کند\&. متغیرهای اضافی:
.PP
\fIMKVINFO_DEBUG\fR، \fIMKVTOOLNIX_DEBUG\fR و شکل کوتاه‌شدهٔ آن \fIMTX_DEBUG\fR
.RS 4
با محتوای آن طوری رفتار می‌شود که گویی از طریق گزینهٔ
\fB\-\-debug\fR
ارسال شده است\&.
.RE
.PP
\fIMKVINFO_ENGAGE\fR، \fIMKVTOOLNIX_ENGAGE\fR و شکل کوتاه‌شدهٔ آن \fIMTX_ENGAGE\fR
.RS 4
با محتوای آن طوری رفتار می‌شود که گویی از طریق گزینهٔ
\fB\-\-engage\fR
ارسال شده است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBmkvmerge\fR(1),
\fBmkvextract\fR(1),
\fBmkvpropedit\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "وبگاه (WWW)"
.PP
جدیدترین نسخه را همیشه می‌توان در
\m[blue]\fBوبگاه MKVToolNix\fR\m[]\&\s-2\u[1]\d\s+2
یافت\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
توسعه‌دهنده
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
وبگاه MKVToolNix
.RS 4
\%https://mkvtoolnix.download
.RE