'\" t
.\"     Title: mkvinfo
.\"    Author: Мориц Бункус <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-01-04
.\"    Manual: Команды пользователя
.\"    Source: MKVToolNix 52.0.0
.\"  Language: Russian
.\"
.TH "mkvinfo" "1" "2021\-01\-04" "MKVToolNix 52\&.0\&.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 "НАЗВАНИЕ"
mkvinfo \- Запись информации об элементах в файлы Matroska
.SH "КРАТКОЕ СОДЕРЖАНИЕ"
.HP \w'\fBmkvinfo\fR\ 'u
\fBmkvinfo\fR [параметры] {исходный\-файл}
.SH "ОПИСАНИЕ"
.PP
Эта программа выводит список всех элементы, содержащихся в
Matroska\&. Выходные данные, включая информацию об используемых кодеках, могут быть ограничены списком дорожек в файле\&.
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
By default
\fBmkvinfo\fR(1)
stops when it encounters the first cluster\&. Additionally it doesn\*(Aqt show certain often occurring elements\&. With this option
\fBmkvinfo\fR(1)
will continue processing regardless of the verbosity level and show all elements\&.
.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
языка (напр\&. "de_DE" для немецкого)\&. Если указать "list" вместо
\fIкода\fR, то отобразится список доступных переводов\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
Указывает mkvmerge прерывание после появления первого предупреждения\&. Код завершения программы будет 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\&. Полное описание поддерживаемых форматов для таких файлов смотрите в разделе "Файлы параметров" на странице документации
\fBmkvmerge\fR(1)\&.
.RE
.SH "УРОВНИ ДЕТАЛИЗАЦИИ"
.PP
Параметр
\fB\-v\fR
может быть использован для повышения уровня детализации
\fBmkvinfo\fR(1)
и для вывода большей информации о текущем файле\&.
.PP
At level 0
\fBmkvinfo\fR(1)
will print only the track headers it finds and their types\&.
\fBmkvinfo\fR(1)
will exit as soon as the headers are parsed completely (more technical: as soon as the first cluster is encountered)\&. In this level the seek head entries and the cues will not be displayed \-\- even if they\*(Aqre located in front of the track information\&.
.PP
На уровне 1
\fBmkvinfo\fR(1)
также будет печатать все элементы
Matroska, встречающиеся для полного файла, кроме записей заголовка поиска и записей cue\&. Если включён режим сводки, то
\fBmkvinfo\fR(1)
также выведет положение кадра\&.
.PP
Тот же эффект достигается параметром
\fB\-\-continue\fR\&.
.PP
На уровне 2
\fBmkvinfo\fR(1)
также выведет записи заголовков поиска, записи cue и позицию в файле, на которой каждый элемент
Matroska
может быть найден\&.
.PP
Тот же эффект достигается параметром
\fB\-\-all \-\-positions\fR\&.
.PP
At level 3 and above
\fBmkvinfo\fR(1)
will print some information that is not directly connected to a
Matroska
element\&. All other elements only print stuff about the elements that were just found\&. Level 3 adds meta information to ease debugging (read: it\*(Aqs intended for developers only)\&. All lines written by level 3 are enclosed in square brackets to make filtering them out easy\&.
.SH "ПРЕОБРАЗОВАНИЕ ТЕКСТОВЫХ ФАЙЛОВ И КОДИРОВОК"
.PP
For an in\-depth discussion about how all tools in the MKVToolNix suite handle character set conversions, input/output encoding, command line encoding and console encoding please see the identically\-named section in the
\fBmkvmerge\fR(1)
man page\&.
.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 "АВТОР"
.PP
\fBМориц Бункус\fR <\&moritz@bunkus\&.org\&>
.RS 4
Разработчик
.RE
.SH "ПРИМЕЧАНИЯ"
.IP " 1." 4
домашней странице MKVToolNix
.RS 4
\%https://mkvtoolnix.download/
.RE