Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 con-
     tent-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  oggzd-
	       iff(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 pream-
	       bles  in  the  oggz-dump,  as  well  as any bos or eos markers if
	       present, are used to structure  the  packets  into  logical  bit-
	       streams.  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, --helpDisplay 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 (C) 2003 CSIRO Australia

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

								    oggz-dump(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oggz-dump&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help