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:

              oggz dump file.ogg

       Dump only the Theora bitstream in file.ogv:

              oggz dump -c theora file.ogv

AUTHOR

       Conrad Parker        November 17, 2003;

COPYRIGHT

       Copyright © 2003 CSIRO Australia

SEE ALSO

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

                                                                                     oggz-dump(1)