'\" t
.\"     Title: mkvinfo
.\"    Author: Морыц Бункус <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2024-03-10
.\"    Manual: Карыстальніцкія каманды
.\"    Source: MKVToolNix 83.0
.\"  Language: English
.\"
.TH "MKVINFO" "1" "2024\-03\-10" "MKVToolNix 83\&.0" "Карыстальніцкія каманды"
.\" -----------------------------------------------------------------
.\" * 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 "Кароткі змест"
.HP \w'\fBmkvinfo\fR\ 'u
\fBmkvinfo\fR [параметры] {зыходны\-файл}
.SH "Апісанне"
.PP
Гэтая праграма выводзіць спіс усіх элементаў, якія ўтрымліваюцца ў
Matroska(TM)\&. Выхадныя даныя, уключаючы звесткі аб скарыстаных кадзіроўшчыках, могуць быць абмежаваныя спісам трэкаў у файле\&.
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
Па змаўчанні
\fBmkvinfo\fR(1)
спыняецца, калі сустракае першы кластар\&. Акрамя таго, ён не паказвае некаторыя часта заўважаныя элементы\&. Праз гэты параметр
\fBmkvinfo\fR(1)
працягне апрацоўку незалежна ад узроўня дэталізацыі і пакажа ўсе элементы\&.
.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
Паказваць пазіцыю кожнага элемента ў дзесятковым выглядзе незалежна ад узроўня дэталізацыі\&.
.RE
.PP
\fB\-s\fR, \fB\-\-summary\fR
.RS 4
Паказваць толькі кароткія звесткі і не кожны элемент у выніках пошуку
\fBmkvinfo\fR(1)\&.
.RE
.PP
\fB\-t\fR, \fB\-\-track\-info\fR
.RS 4
Паказаць статыстыку для кожнага трэка ў пашыраным рэжыме\&. Таксама задае рэжым пашыранасці ў 1, калі ён быўя 0 да гэтага\&.
.RE
.PP
\fB\-x\fR, \fB\-\-hexdump\fR
.RS 4
Паказаць 16 першых байтоаў кожнага кадра ў шаснаццатковым выглядзе\&.
.RE
.PP
\fB\-X\fR, \fB\-\-full\-hexdump\fR
.RS 4
Паказаць усе байты кожнага кадра ў шаснаццатковым выглядзе\&.
.RE
.PP
\fB\-z\fR, \fB\-\-size\fR
.RS 4
Паказаць памер кожнага элемента, у тым ліку яго загалоўка\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIкадзіроўка\fR
.RS 4
Задае кадзіроўку для канвертацыі радкоў, зададзеных у камандным радку\&. Стандартная кадзіроўка прывязаная да сістэмнай лакалізацыі\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIкадзіроўка\fR
.RS 4
Задае кадзіроўку, у якой канвертуюцца выхадныя радкі\&. Па змаўчанні выкарыстоўваецца бягучая кадзіроўка сістэмнай мовы\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIімя\-файла\fR
.RS 4
Усе паведамленні запісваюцца ў файл
\fIімя\-файла\fR
замест кансолі\&. Хаця гэта можна зрабіць і праз перанакіраванне вываду, ёсць асобныя выпадкі ўжывання менавіта гэтага параметра: калі тэрмінал інтэрпрэтуе ў іншы спосаб вываду перад запісам файла\&. Набор сімвалаў, зададзены праз
\fB \-\-output\-charset\fR, улічваецца\&.
.RE
.PP
\fB\-\-ui\-language\fR \fIкод\fR
.RS 4
Прымусова выкарыстоўваць пераклад на
\fIкод\fR
мовы (напр\&., \(Fode_DE\(Fc для нямецкай)\&. Калі задаць \(Folist\(Fc замест
\fIкода\fR, то будзе выведзены спіс даступных перакладаў\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
Задае mkvmerge перапыненне пасля з\*(Aqяўлення першага папярэджання\&. Код завяршэння праграмы будзе 1\&.
.RE
.PP
\fB\-\-debug\fR \fIтэматыка\fR
.RS 4
Уключыць рэжым адладкі для зададзенай функцыі\&. Гэты параметр карысны толькі для распрацоўшчыкаў\&.
.RE
.PP
\fB\-\-engage\fR \fIфункцыя\fR
.RS 4
Уключыць эксперыментальныя функцыі\&. Спіс даступных функцый можа быць выкліканы з дапамогай
\fBmkvinfo \-\-engage list\fR\&. Гэтыя функцыі не прызначаныя для штодзённага выкарыстання\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
Уключае рэжым графічнага інтэрфейса\&. У гэтым рэжыме могуць выводзіцца спецыяльна адфармаціраваныя радкі для адпраўкі кантрольных паведамленняў інтэрфейсу\&. Фармат паведмленняў \(em \*(Aq#GUI#message\*(Aq\&. За паведамленнем могуць быць зададзеныя пары ключа і значэння, напрыклад \*(Aq#GUI#message#key1=value1#key2=value2\&...\*(Aq\&. Паведамленні і ключы не перакладаюцца і заўжды выводзяцца на англійскай\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Больш падрабязнасцяў\&. Глядзіце секцыю аб
узроўнях дэталізацыі
з апісаннем інфармацыі, якая выводзіцца на кожным узроўні\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Паказаць звесткі аб выкарыстанні і выйсці\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
Паказаць звесткі аб версіі і выйсці\&.
.RE
.PP
\fB@\fR\fIфайл\-параметраў\&.json\fR
.RS 4
Счытвае дадатковыя аргументы каманднага радка з файла
\fIoptions\-file\fR\&. Поўнае апісанне падтрымліваных фарматаў для такіх файлаў глядзіце ў секцыі \(FoФайлы параметраў\(Fc на старонцы дакументацыі
\fBmkvmerge\fR(1)\&.
.RE
.SH "Узроўні дэталізацыі"
.PP
Параметр
\fB\-v\fR
можа быць выкарыстаны для павышэння ўзроўня дэталізацыі
\fBmkvinfo\fR(1)
і для вываду большых звестак аб бягучым файле\&.
.PP
На ўзроўні 0
\fBmkvinfo\fR(1)
надрукуе толькі загалоўкі знойдзеных трэкаў і іхнія тыпы\&.
\fBmkvinfo\fR(1)
завершыцца, як толькі загалоўкі будуць цалкам прааналізаваныя (больш тэхнічна: як толькі будзе выяўлены першы кластар)\&. На гэтым узроўні запісы загалоўка пошуку і Сue не будуць паказвацца \(em нават калі яны размешчаныя перад звесткамі аб трэку\&.
.PP
На ўзроўні 1
\fBmkvinfo\fR(1)
таксама будзе друкаваць усе элементы
Matroska(TM), якія сустракаюцца для поўнага файла, акрамя запісаў загалоўка пошуку і запісаў Сue\&. Калі ўключаны рэжым зводкі, то
\fBmkvinfo\fR(1)
таксама выведзе пазіцыю кадра\&.
.PP
Той жа эфект дасягаецца параметрам
\fB\-\-continue\fR\&.
.PP
На ўзроўні 2
\fBmkvinfo\fR(1)
таксама выведзе запісы загалоўкаў пошуку, запісы Сue і пазіцыю ў файле, на якой кожны элемент
Matroska(TM)
можа быць знойдзены\&.
.PP
Той жа эфект дасягаецца параметрам
\fB\-\-all \-\-positions\fR\&.
.PP
На ўзроўні 3 і вышэй
\fBmkvinfo\fR(1)
надрукуе некаторыя звесткі, якія не звязаныя напрамую з элементам
Matroska(TM)\&. Усе астатнія элементы друкуюць толькі тыя элементы, якія былі толькі што знойдзеныя\&. Узровень 3 дадае метададзеныя для аблягчэння адладкі (чытай: прызначаная толькі для распрацоўшчыкаў)\&. Усе радкі, напісаныя на ўзроўні 3, заключаныя ў квадратныя дужкі, каб іх было лёгка адфільтраваць\&.
.SH "Канвертацыя тэкставых файлаў і кадзіровак"
.PP
Падрабязнае абмеркаванне таго, як усе інструменты пакета MKVToolNix апрацоўваюць канвертацыю набораў сімвалаў, кадзіроўку ўводу/вываду, кадзіроўку каманднага радка і кадзіроўку кансолі, глядзіце ў секцыі з ідэнтычнай назвай у даведкавай старонцы
\fBmkvmerge\fR(1)\&.
.SH "Коды завяршэння"
.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 "Пераменныя асяроддзя"
.PP
\fBmkvinfo\fR(1)
выкарыстоўвае стандартныя пераменныя, якія вызначаюць сістэмную мову (напрыклад:
\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 "Глядзіце таксама"
.PP
\fBmkvmerge\fR(1),
\fBmkvextract\fR(1),
\fBmkvpropedit\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "Хатняя старонка"
.PP
Апошняя версія праграмы заўсёды даступная на
\m[blue]\fBхатняй старонцы MKVToolNix\fR\m[]\&\s-2\u[1]\d\s+2\&.
.SH "AUTHOR"
.PP
\fBМорыц Бункус\fR <\&moritz@bunkus\&.org\&>
.RS 4
Распрацоўшчык
.RE
.SH "NOTES"
.IP " 1." 4
хатняй старонцы MKVToolNix
.RS 4
\%https://mkvtoolnix.download/
.RE