| oggz-dump(1) | General Commands Manual | oggz-dump(1) |
NAME¶
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
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:
Dump only the Theora bitstream in file.ogv:
AUTHOR¶
Conrad Parker November 17, 2003;
COPYRIGHT¶
Copyright © 2003 CSIRO Australia
SEE ALSO¶
oggz-diff(1), hogg(1) xxd(1), hexdump(1)