mkvtoolnix/doc/man/de/mkvinfo.1
2014-05-24 20:28:21 +02:00

335 lines
12 KiB
Groff

'\" t
.\" Title: mkvinfo
.\" Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 2014-04-18
.\" Manual: Benutzerbefehle
.\" Source: MKVToolNix 6.9.1
.\" Language: German
.\"
.TH "MKVINFO" "1" "2014\-04\-18" "MKVToolNix 6\&.9\&.1" "Benutzerbefehle"
.\" -----------------------------------------------------------------
.\" * 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 \- gibt Informationen \(:uber Elemente der Matroska(TM)\-Dateien aus\&.
.SH "\(:UBERSICHT"
.HP \w'\fBmkvinfo\fR\ 'u
\fBmkvinfo\fR [Optionen] {Quelldateiname}
.SH "BESCHREIBUNG"
.PP
Dieses Programm f\(:uhrt alle in
Matroska(TM)\-Dateien enthaltenen Elemente auf\&. Die Ausgabe kann kann auf eine Liste von Spuren in der Datei, einschlie\(sslich Informationen \(:uber die benutzten Codecs, begrenzt werden\&.
.PP
\fB\-g\fR, \fB\-\-gui\fR
.RS 4
startet das
GUI\&. Diese Option ist nur verf\(:ugbar, falls Mkvinfo mit
GUI\-Unterst\(:utzung kompiliert wurde\&.
.RE
.PP
\fB\-c\fR, \fB\-\-checksums\fR
.RS 4
berechnet f\(:ur jedes Bild die
\fBAdler32\fR\-Pr\(:ufsumme und zeigt sie an\&. Nur n\(:utzlich zur Fehlersuche\&.
.RE
.PP
\fB\-s\fR, \fB\-\-summary\fR
.RS 4
zeigt nur eine knappe Zusammenfassung, was
\fBmkvinfo\fR(1)
findet und nicht jedes Element\&.
.RE
.PP
\fB\-t\fR, \fB\-\-track\-info\fR
.RS 4
Zeigt detailliert Statistiken f\(:ur jede Spur an\&. Au\(sserdem wird die Detailstufe auf 1 gesetzt, falls sie vorher auf 0 war\&.
.RE
.PP
\fB\-x\fR, \fB\-\-hexdump\fR
.RS 4
zeigt die ersten 16 Byte jedes Bilds als hexadezimale Ausgabe an\&.
.RE
.PP
\fB\-X\fR, \fB\-\-full\-hexdump\fR
.RS 4
zeigt alle Byte von jedem Bild als hexadezimale Ausgabe an\&.
.RE
.PP
\fB\-z\fR, \fB\-\-size\fR
.RS 4
zeigt die Gr\(:o\(sse jedes Elements einschlie\(sslich seiner Kopfdaten an\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIZeichensatz\fR
.RS 4
setzt den Zeichensatz, um auf der Befehlszeile angegebene Zeichenketten umzuwandeln\&. Voreinstellung ist der Zeichensatz der aktuellen Locale des Systems\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIZeichensatz\fR
.RS 4
setzt den Zeichensatz, in den Zeichenketten zur Ausgabe umgewandelt werden\&. Voreinstellung ist der Zeichensatz der aktuellen Locale des Systems\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIDateiname\fR
.RS 4
schreibt alle Nachrichten in die Datei
\fIDateiname\fR
statt auf die Konsole\&. Obwohl dies einfach durch Ausgabeumleitung erledigt werden kann, gibt es F\(:alle, in denen diese Option ben\(:otigt wird: wenn das Terminal die Ausgabe vor dem Schreiben in eine Datei neu auswertet\&. Der mit
\fB\-\-output\-charset\fR
gesetzte Zeichensatz wird dabei ber\(:ucksichtigt\&.
.RE
.PP
\fB\-\-ui\-language\fR \fICode\fR
.RS 4
erzwingt, dass die \(:Ubersetzungen f\(:ur die Sprache
\fICode\fR
benutzt werden (z\&.B\&. \(Fcde_DE\(Fo f\(:ur die deutschen \(:Ubersetzungen)\&. Vorzugsweise sollten jedoch die Umgebungsvariablen
\fILANG\fR,
\fILC_MESSAGES\fR
und
\fILC_ALL\fR
benutzt werden\&. Die Eingabe von \(Fclist\(Fo als
\fICode\fR
wird
\fBmkvinfo\fR(1)
veranlassen, eine Liste der verf\(:ugbaren \(:Ubersetzungen auszugeben\&.
.RE
.PP
\fB\-\-debug\fR \fIThema\fR
.RS 4
schaltet die Fehlersuche f\(:ur eine bestimmte Funktionalit\(:at ein\&. Diese Option ist nur f\(:ur Entwicker n\(:utzlich\&.
.RE
.PP
\fB\-\-engage\fR \fIFunktionalit\(:at\fR
.RS 4
schaltet experimentelle Funktionalit\(:aten ein\&. Eine Liste verf\(:ugbarer Funktionalit\(:aten kann mit
\fBmkvinfo \-\-engage list\fR
abgefragt werden\&. Diese Funktionalit\(:aten sind nicht f\(:ur die Verwendung in Alltagssituationen gedacht\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
Schaltet den Modus f\(:ur graphische Benutzeroberfl\(:achen an\&. In diesem Modus k\(:onnen auf bestimmte Art formatierte Zeilen ausgegeben werden, die einem aufrufenden Programm mitteilen, was
\fBmkvmerge\fR(1)
gerade tut\&. Diese Nachrichten haben das folgende Format: \*(Aq#GUI#Nachricht\*(Aq\&. Der Nachricht folgen potenziell Schl\(:ussel/Wert\-Paare wie z\&.B\&. \*(Aq#GUI#Nachricht#schluessel1=wert1#schluessel2=wert2\&...\*(Aq\&. Weder die Nachricht selber noch die Schl\(:ussel werden jemals \(:ubersetzt sondern immer in Englisch ausgegeben\&.
.sp
Diese Option hat nichts mit der Option
\fB\-\-gui\fR
zu tun, welche daf\(:ur sorgt, dass
\fBmkvinfo\fR(1)
seine graphische Benutzeroberfl\(:ache anzeigt\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
erh\(:oht die Dateilstufe\&. Welche Beschreibung auf welcher Stufe ausgegeben wird, finden Sie im Abschnitt
Detailstufen\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
zeigt Benutzungsinformationen und beendet sich\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
zeigt Versionsinformationen und beendet sich\&.
.RE
.PP
\fB\-\-check\-for\-updates\fR
.RS 4
pr\(:uft online durch Herunterladen der URL
\m[blue]\fBhttp://mkvtoolnix\-releases\&.bunkus\&.org/latest\-release\&.xml\fR\m[], ob es neue Ver\(:offentlichungen gibt\&. Vier Zeilen werden im Stil
Schl\(:ussel=Wert
ausgegeben: die URL, von der die Informationen bezogen wurden (Schl\(:ussel
version_check_url), die aktuell laufende Version (Schl\(:ussel
running_version), die Version der neusten Ver\(:offentlichung (Schl\(:ussel
available_version) und die Download\-URL (Schl\(:ussel
download_url)\&.
.sp
Anschlie\(ssend beendet sich das Programm mit einem R\(:uckgabewert von 0, falls keine neuere Ver\(:offentlichung verf\(:ugbar ist, mit 1, wenn eine neuere Ver\(:offentlichung verf\(:ugbar ist und mit 2, falls ein Fehler auftritt (z\&.B\&., wenn die Aktualisierungsinformationen nicht abgefragt werden konnten)\&.
.sp
Diese Option ist nur verf\(:ugbar, falls das Programm mit Unterst\(:utzung f\(:ur Libcurl gebaut wurde\&.
.RE
.PP
\fB@\fR\fIOptionsdatei\fR
.RS 4
liest zus\(:atzliche Befehlszeilenargumente aus der Datei
\fIOptionsdatei\fR\&. Zeilen, deren erstes Nichtleerraumzeichen ein Rautenzeichen (\(Fc#\(Fo) ist, werden als Kommentare betrachtet und ignoriert\&. Leerr\(:aume am Anfang und Ende einer Zeile werden abgeschnitten\&. Jede Zeile darf genau eine Option enthalten\&.
.sp
Verschiedene Zeichen k\(:onnen maskiert werden, z\&.B\&. falls Sie m\(:ochten, dass eine Nichtkommentarzeile mit einem \(Fc#\(Fo beginnt\&. Die Regeln werden im
Abschnitt \(:uber Maskieren von Text
beschrieben\&.
.sp
Die Befehlszeile \(Fc\fBmkvinfo \-v \-v Eingabe\&.mkv \-\-redirect\-output Info\&.txt\fR
kann in die folgende Optionsdatei umgewandelt werden:
.sp
.if n \{\
.RS 4
.\}
.nf
# Detailstufe erh\(:ohen
\-v
\-v
# Eingabe\&.mkv auswerten
Eingabe\&.mkv
# und die Ausgabe in Info\&.txt schreiben
\-\-redirect\-output
Info\&.txt
.fi
.if n \{\
.RE
.\}
.RE
.SH "DETAILSTUFEN"
.PP
Die Option
\fB\-v\fR
kann benutzt werden, um die Detailstufe von
\fBmkvinfo\fR(1)
zu erh\(:ohen und weitere Informationen \(:uber die aktuelle Datei auszugeben\&.
.PP
Auf Stufe 0 wird
\fBmkvinfo\fR(1)
nur die Spurkopfdaten, die es findet und deren Typen, ausgeben\&. Sobald die Kopfdaten vollst\(:andig ausgewertet sind, wird sich
\fBmkvinfo\fR(1)
beenden (technischer ausgedr\(:uckt: sobald der erste Cluster gefunden wird)\&. Auf dieser Stufe werden die Suchkopfeintr\(:age und Indizes nicht angezeigt \(en selbst wenn sie vor den Spurinformationen liegen\&.
.PP
Auf Stufe 1 wird
\fBmkvinfo\fR(1)
ebenfalls alle f\(:ur die vollst\(:andige Datei gefundenen
Matroska(TM)\-Elemente au\(sser den Suchkopf\- und Indexeintr\(:agen ausgeben\&. Falls der Zusammenfassungsmodus aktiviert ist, wird
\fBmkvinfo\fR(1)
obendrein die Bildposition ausgeben\&.
.PP
Auf Stufe 2 wird
\fBmkvinfo\fR(1)
auch die Suchkopfeintr\(:age, die Indexeintr\(:age und die Dateiposition ausgeben, an der jedes
Matroska(TM)\-Element gefunden werden kann\&.
.PP
Auf Stufe 3 und dar\(:uber wird
\fBmkvinfo\fR(1)
einige Informationen ausgeben, die nicht direkt mit einem
Matroska(TM)\-Element verbunden sind\&. Alle anderen Elemente geben nur Zeug \(:uber Elemente aus, die soeben gefunden wurden\&. Stufe 3 f\(:ugt Metainformationen zur Erleichterung der Fehlersuche hinzu (sprich: Sie ist nur f\(:ur Entwickler gedacht)\&. Alle Zeilen, die durch Stufe 3 geschrieben werden, sind in eckige Klammern eingeschlossen, um ihre Filterung zu erleichtern\&.
.SH "UMWANDLUNGEN VON TEXTDATEIEN UND ZEICHENS\(:ATZEN"
.PP
F\(:ur eine tiefer gehende Diskussion dar\(:uber, wie die Programme in der MKVToolNix\-Sammlung die Umwandlung von Zeichens\(:atzen, Eingabe\-/Ausgabecodierung, Kommandozeilenzeichens\(:atze und Konsolenzeichens\(:atze handhaben, sei auf den Abschnitt \(FcUmwandlungen von Textdateien und Zeichens\(:atzen\(Fo in der Handbuchseite von
\fBmkvmerge\fR(1)
verwiesen\&.
.SH "R\(:UCKGABEWERTE"
.PP
\fBmkvinfo\fR(1)
beendet sich mit einem von drei R\(:uckgabewerten:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\(en dieser R\(:uckgabewert bedeutet, dass der Durchlauf erfolgreich abgeschlossen wurde\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\(en in diesem Fall hat
\fBmkvinfo\fR(1)
mindestens eine Warnung ausgegeben, die Ausf\(:uhrung wurde aber fortgesetzt\&. Einer Warnung wird der Text \(FcWarning:\(Fo vorangestellt\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\(en dieser R\(:uckgabewert wird benutzt, nachdem ein Fehler aufgetreten ist\&.
\fBmkvinfo\fR(1)
wird gleich nach der Ausgabe der Fehlermeldung abgebrochen\&. Fehlermeldungen reichen von falschen Befehlszeilenargumenten \(:uber Lese\-/Schreibfehler bis hin zu besch\(:adigten Dateien\&.
.RE
.SH "SONDERZEICHEN IN TEXT MASKIEREN"
.PP
Es gibt ein paar Stellen, an denen Sonderzeichen in Text maskiert werden m\(:ussen oder sollen\&. Die Regeln zum Maskieren sind einfach: Jedes Zeichen, das maskiert werden soll, wird durch einen R\(:uckw\(:artsschr\(:agstrich gefolgt von einem weiteren Zeichen ersetzt\&.
.PP
Die Regeln lauten: \(Fc \(Fo (ein Leerzeichen) wird \(Fc\es\(Fo, \(Fc"\(Fo (doppeltes Anf\(:uhrungszeichen) wird \(Fc\e2\(Fo, \(Fc:\(Fo wird \(Fc\ec\(Fo, \(Fc#\(Fo wird \(Fc\eh\(Fo und \(Fc\e\(Fo (ein einfacher R\(:uckw\(:artsschr\(:agstrich selbst) wird \(Fc\e\e\(Fo\&.
.SH "UMGEBUNGSVARIABLEN"
.PP
\fBmkvinfo\fR(1)
verwendet die Standardvariablen, um die Locale des Systems zu bestimmen (z\&.B\&.
\fILANG\fR
und die
\fILC_*\fR\-Familie)\&. Zus\(:atzliche Variablen:
.PP
\fIMKVTOOLNIX_DEBUG\fR und ihre Kurzform \fIMTX_DEBUG\fR
.RS 4
Der Inhalt wird behandelt, als ob er mit der Option
\fB\-\-debug\fR
\(:ubergeben worden w\(:are\&.
.RE
.PP
\fIMKVTOOLNIX_ENGAGE\fR und ihre Kurzform \fIMTX_ENGAGE\fR
.RS 4
Der Inhalt wird behandelt, als ob er mit der Option
\fB\-\-engage\fR
\(:ubergeben worden w\(:are\&.
.RE
.PP
\fIMKVTOOLNIX_OPTIONS\fR und ihre Kurzform \fIMTX_OPTIONS\fR
.RS 4
Der Inhalt wird bei Leerr\(:aumen aufgeteilt\&. Die resultierenden Teilzeichenketten werden behandelt, als ob sie als Befehlszeilenoptionen \(:ubergeben worden w\(:aren\&. Falls Sie Sonderzeichen \(:ubergeben m\(:ochten (z\&.B\&. Leerzeichen), m\(:ussen Sie sie maskieren (siehe
den Abschnitt \(:uber Maskieren von Sonderzeichen in Text)\&.
.RE
.SH "SIEHE AUCH"
.PP
\fBmkvmerge\fR(1),
\fBmkvextract\fR(1),
\fBmkvpropedit\fR(1),
\fBmmg\fR(1)
.SH "WWW"
.PP
Die neuste Version kann immer auf
\m[blue]\fBder MKVToolNix\-Homepage\fR\m[]\&\s-2\u[1]\d\s+2
gefunden werden\&.
.SH "AUTOR"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
Entwickler
.RE
.SH "FU\(ssNOTEN"
.IP " 1." 4
der MKVToolNix-Homepage
.RS 4
\%http://www.bunkus.org/videotools/mkvtoolnix/
.RE