GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  OGGZ-DUMP (1)

NAME

oggz-dump — Hexdump packets of an Ogg file, or revert an Ogg file from such a hexdump

CONTENTS

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)

Search for    or go to Top of page |  Section 1 |  Main Index


OGGZ-DUMP (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.