oggz-dump man 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

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

Author

Conrad Parker        November 17, 2003;      

See Also

oggz-diff(1),  hogg(1)       xxd(1),  hexdump(1)      

Referenced By

oggz-chop(1), oggz-diff(1), oggz-info(1), oggz-merge(1), oggz-rip(1), oggz-scan(1), oggz-sort(1), oggz-validate(1).