NAME

oggz-dump — Hexdump packets of an Ogg file, or revert an Ogg file from such a hexdump

SYNOPSIS

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

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

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.

oggz-dump accepts the following 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.

-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.

-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.

Dump all bitstreams in file.ogg:

oggz dump file.ogg

Dump only the Theora bitstream in file.ogv:

oggz dump -c theora file.ogv

Conrad Parker November 17, 2003;