oggz-dump(1)

Usage

oggz-dump [{-b | --binary}] [{-x | --hexadecimal}] [{-n | --new}] [{-o filename | --output filename}] [{-c content-type | --content-type content-type}] [{-s serialno | --serialno serialno}] [{-O | --hide-offset}] [{-S | --hide-serialno}] [{-G | --hide-granulepos}] [{-P | --hide-packetno}] filename

oggz-dump [{-r | --revert}] [{-o filename | --output filename}] filename

oggz-dump [{-h | --help}] [{-v | --version}]

Overview

oggz-dump generates a hexadecimal or binary dump of packets in an Ogg file, or creates an Ogg file from a hexadecimal oggz-dump file.

Options

oggz-dump accepts the following options:

Dump format options

-b, --binary: Generate a binary dump of each packet

-x, --hexadecimal: Generate a hexadecimal dump of each packet

Filtering options

-n, --new: Only dump the first packet of each new logical bitstream found; for correctly formed Ogg files, this dumps only the beginning-of-stream packets.

-c content-type, --content-type content-type: Dump only the logical bitstreams for a specific content-type. Run oggz-known-codecs(1) for a full list of codecs known by the installed version of oggz.

-s serialno, --serialno serialno: Dump only the logical bitstream with specified serialno.

-O, --hide-offset: Hide the byte offset field of the preamble for each packet dumped. This is particularly useful in conjunction with oggzdiff(1) when comparing Ogg bitstreams that differ only in page structure.

-S, --hide-serialno: Hide the serialno field of the preamble for each packet dumped. This is particularly useful in conjunction with oggzdiff(1) when comparing Ogg bitstreams that differ only in serialno assignment.

-G, --hide-granulepos: Hide the granulepos field of the preamble for each packet dumped.

-P, --hide-packetno: Hide the packetno field of the preamble for each packet dumped.

Mode options

-r, --revert: Revert an oggz-dump. Generates an Ogg bitstream as prescribed in the input oggz-dump.

: The serialno, granulepos and packetno fields of the packet preambles in the oggz-dump, as well as any bos or eos markers if present, are used to structure the packets into logical bitstreams. Hence it is advised that the original input oggz-dump not be generated with any hiding filters.

: Only the hexadecimal data columns of the input oggz-dump are parsed when generating Ogg packet data; the printable character representation is ignored.

Miscellaneous options

-o filename, --output filename: Write output to the specified filename instead of printing it to standard output.

-h, --help: Display usage information and exit.

-v, --version: Output version information and exit.

Examples

Dump all bitstreams in file.ogg:

oggz dump file.ogg

Dump only the Theora bitstream in file.ogv:

oggz dump -c theora file.ogv

Releases

Unchanged in 9 releases since Debian 6.0 (Squeeze).

6.0–Arch

Referred to by

oggz-rip(1) Extract one or more logical bitstreams from an Ogg file. oggz-chop(1) Extract the part of an Ogg file between given start and/or end times. oggz-diff(1) Hexdump the packets of two Ogg files and output differences oggz-info(1) Display information about one or more Ogg files and their bitstreams. oggz-scan(1) Scan an Ogg file and output characteristic landmarks oggz-sort(1) Sort the pages of an Ogg file in order of presentation time. oggz-merge(1) Merge Ogg files together, interleaving pages in order of presentation time. oggz-validate(1) Validate the Ogg framing of one or more files