MKVINFO(1)

User Commands

MKVINFO(1)

نام (NAME)

mkvinfo - چاپ اطلاعات مربوط به عناصر موجود در فایل‌های Matroska(TM)

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

mkvinfo [options] {source-filename}

توضیحات (DESCRIPTION)

این برنامه تمام عناصر موجود در یک Matroska(TM) را فهرست می‌کند. خروجی را می‌توان به فهرستی از ترک‌های موجود در فایل، شامل اطلاعات مربوط به کدک‌های استفاده‌شده، محدود کرد.

-a, --all

به‌طور پیش‌فرض، mkvinfo(1) هنگامی که با نخستین کلاستر (cluster) مواجه می‌شود متوقف می‌گردد. علاوه بر این، برخی از عناصری را که به‌کرات تکرار می‌شوند نمایش نمی‌دهد. با این گزینه، mkvinfo(1) صرف‌نظر از سطح پرگویی (verbosity level) به پردازش ادامه داده و تمام عناصر را نمایش می‌دهد.

-c, --checksums

چک‌سام Adler-32 را برای هر فریم محاسبه و نمایش می‌دهد. تنها برای اشکال‌زدایی مفید است.

-o, --continue

به‌طور پیش‌فرض، mkvinfo(1) هنگامی که با نخستین کلاستر مواجه می‌شود متوقف می‌گردد. با این گزینه، mkvinfo(1) صرف‌نظر از سطح پرگویی به پردازش ادامه خواهد داد.

-p, --hex-positions

موقعیت تمام عناصر را صرف‌نظر از سطح پرگویی به‌صورت هگزادسیمال نمایش می‌دهد.

-P, --positions

موقعیت تمام عناصر را صرف‌نظر از سطح پرگویی به‌صورت ده‌دهی (decimal) نمایش می‌دهد.

-s, --summary

تنها یک خلاصهٔ مختصر از آنچه mkvinfo(1) می‌یابد را نمایش می‌دهد، نه تک‌تک عناصر را.

-t, --track-info

آمار هر ترک را در حالت پرگو (verbose) نمایش می‌دهد. همچنین در صورتی که پرگویی پیش‌تر روی سطح 0 بوده باشد، آن را روی 1 تنظیم می‌کند.

-x, --hexdump

16 بایت نخست هر فریم را به‌صورت یک hex dump نمایش می‌دهد.

-X, --full-hexdump

تمام بایت‌های هر فریم را به‌صورت یک hex dump نمایش می‌دهد.

-z, --size

اندازه هر عنصر را به همراه سرآیند (header) آن نمایش می‌دهد.

--command-line-charset character-set

مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های ارائه‌شده در خط فرمان از آن تبدیل شوند. پیش‌فرض آن، مجموعه نویسه‌ای ارائه‌شده توسط لوکال فعلی سیستم است.

--output-charset character-set

مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های خروجی به آن تبدیل شوند. پیش‌فرض آن، مجموعه نویسه‌ای ارائه‌شده توسط لوکال فعلی سیستم است.

-r, --redirect-output file-name

تمام پیام‌ها را به جای کنسول در فایل file-name می‌نویسد. اگرچه این کار به‌سادگی با تغییر مسیر خروجی (redirection) ممکن است، مواردی وجود دارد که به این گزینه نیاز است: زمانی که ترمینال پیش از نوشتن خروجی در فایل، آن را مجدداً تفسیر می‌کند. مجموعه نویسهٔ تعیین‌شده با --output-charset رعایت می‌شود.

--no-bom

به‌طور معمول فایل‌های متنی که در یکی از انواع UTF ایجاد و کدگذاری می‌شوند با یک نشانگر ترتیب بایت‌ها (BOM) آغاز می‌شوند. استفاده از این گزینه نوشتن آن نشانگر ترتیب بایت‌ها را غیرفعال می‌کند.

--ui-language code

استفاده از ترجمه‌های زبانِ code را اجبار می‌کند (برای مثال 'de_DE' برای ترجمه آلمانی). وارد کردن 'list' به عنوان code باعث می‌شود برنامه فهرستی از ترجمه‌های موجود را در خروجی نمایش دهد.

--abort-on-warnings

به برنامه دستور می‌دهد که پس از صدور نخستین هشدار متوقف شود. کد وضعیت خروج برنامه 1 خواهد بود.

--debug topic

اشکال‌زدایی را برای یک قابلیت خاص فعال می‌کند. این گزینه فقط برای توسعه‌دهندگان مفید است.

--engage feature

ویژگی‌های آزمایشی را فعال می‌کند. فهرستی از ویژگی‌های موجود را می‌توان با mkvinfo --engage list درخواست کرد. این ویژگی‌ها برای استفاده در شرایط عادی در نظر گرفته نشده‌اند.

--gui-mode

حالت واسط گرافیکی (GUI) را فعال می‌کند. در این حالت ممکن است خطوطی با قالب‌بندی ویژه خروجی داده شوند که به یک واسط گرافیکی کنترل‌کننده گزارش دهند چه اتفاقی در حال رخ دادن است. این پیام‌ها از قالب '#GUI#message' پیروی می‌کنند. پیام ممکن است با جفت‌های کلید/مقدار دنبال شود، مانند '#GUI#message#key1=value1#key2=value2...'. پیام‌ها و کلیدها هرگز ترجمه نمی‌شوند و همیشه به زبان انگلیسی نمایش داده می‌شوند.

-v, --verbose

پرگویی بیشتر. برای شرح این‌که چه اطلاعاتی در چه سطحی خروجی داده می‌شوند، بخش مربوط به سطوح پرگویی (verbosity levels) را ببینید.

-h, --help

نمایش اطلاعات نحوه استفاده و خروج.

-V, --version

نمایش اطلاعات نسخه و خروج.

@options-file.json

آرگومان‌های خط فرمان اضافی را از فایل options-file می‌خواند. برای توضیحات کامل در مورد قالب‌های پشتیبانی‌شده برای چنین فایل‌هایی، بخش «Option files» را در صفحه راهنمای mkvmerge(1) ببینید.

گزینهٔ -v می‌تواند برای افزایش سطح پرگویی (جزئیات) mkvinfo(1) و چاپ اطلاعات بیشتر دربارهٔ فایل فعلی به کار رود.

در سطح 0، mkvinfo(1) تنها سرآیندهای شیار (track headers) یافته‌شده و نوع آن‌ها را چاپ می‌کند. به محض اینکه سرآیندها به طور کامل تجزیه شوند (از دید فنی‌تر: به محض برخورد با نخستین کلاستر)، mkvinfo(1) خارج خواهد شد. در این سطح، مدخل‌های seek head و نشانه‌ها (cues) نمایش داده نخواهند شد -- حتی اگر پیش از اطلاعات شیار قرار گرفته باشند.

در سطح 1، mkvinfo(1) همچنین تمام عنصرهای Matroska(TM) مشاهده‌شده در کل فایل به جز مدخل‌های seek head و مدخل‌های cue را چاپ می‌کند. اگر حالت خلاصه‌سازی فعال باشد، mkvinfo(1) موقعیت فریم را نیز در خروجی می‌آورد.

همین اثر را می‌توان با گزینهٔ --continue به دست آورد.

در سطح 2، mkvinfo(1) علاوه بر این مدخل‌های seek head، مدخل‌های cue و موقعیت فایلی را که هر عنصر Matroska(TM) در آن قرار دارد چاپ خواهد کرد.

همین اثر را می‌توان با گزینه‌های --all --positions به دست آورد.

در سطح 3 و بالاتر، mkvinfo(1) برخی اطلاعات را که ارتباط مستقیمی با یک عنصر Matroska(TM) ندارند چاپ خواهد کرد. در تمامی سطوح دیگر، تنها اطلاعات مربوط به عنصرهایی که به‌تازگی پیدا شده‌اند چاپ می‌شود. سطح 3 اطلاعات اضافه (متادیتا) را برای تسهیل اشکال‌زدایی می‌افزاید (بخوانید: تنها برای توسعه‌دهندگان در نظر گرفته شده است). تمام خطوط نوشته‌شده توسط سطح 3 در قلاب‌ها (کروشه‌ها) محصور شده‌اند تا فیلتر کردن آن‌ها آسان باشد.

فایل‌های متنی و تبدیل‌های مجموعه‌نویسه (TEXT FILES AND CHARACTER SET CONVERSIONS)

برای بررسی دقیق دربارهٔ چگونگی مدیریت تبدیل‌های مجموعه‌نویسه، کدگذاری ورودی/خروجی، کدگذاری خط فرمان و کدگذاری کنسول در تمامی ابزارهای مجموعهٔ MKVToolNix، لطفاً بخشی با همین نام را در صفحهٔ راهنمای mkvmerge(1) ببینید.

کدهای خروج (EXIT CODES)

mkvinfo(1) با یکی از این سه کد خروج پایان می‌یابد:

•0 -- این کد خروج به این معناست که اجرا با موفقیت کامل شده است.

•1 -- در این حالت mkvinfo(1) دست‌کم یک هشدار چاپ کرده است، اما اجرا ادامه یافته است. پیشوند هر هشدار متن 'Warning:' است.

•2 -- این کد خروج پس از وقوع یک خطا استفاده می‌شود. mkvinfo(1) بلافاصله پس از چاپ پیام خطا متوقف می‌شود. پیام‌های خطا طیفی از آرگومان‌های اشتباه خط فرمان گرفته تا خطاهای خواندن/نوشتن و فایل‌های خراب را شامل می‌شوند.

mkvinfo(1) از متغیرهای پیش‌فرضی که مشخص‌کنندهٔ تنظیمات محلی (locale) سیستم هستند (مانند LANG و خانوادهٔ LC_*) استفاده می‌کند. متغیرهای اضافی:

MKVINFO_DEBUG، MKVTOOLNIX_DEBUG و شکل کوتاه‌شدهٔ آن MTX_DEBUG

با محتوای آن طوری رفتار می‌شود که گویی از طریق گزینهٔ --debug ارسال شده است.

MKVINFO_ENGAGE، MKVTOOLNIX_ENGAGE و شکل کوتاه‌شدهٔ آن MTX_ENGAGE

با محتوای آن طوری رفتار می‌شود که گویی از طریق گزینهٔ --engage ارسال شده است.