oggz-dump (1) Linux Manual Page
oggz-dump — Hexdump packets of an Ogg file, or revert an Ogg file from such a hexdump
Synopsis
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 ]
Description
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
- -x, –hexadecimal
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.
- -c content-type, –content-type content-type
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.
- 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.
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.
- -h, –help
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