1oggz-dump(1)                General Commands Manual               oggz-dump(1)
2
3
4

NAME

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

SYNOPSIS

11       oggz-dump [-b  | --binary ]  [-x  | --hexadecimal ]   [-n   |  --new  ]
12       [-o filename  | --output filename ]  [-c content-type  | --content-type
13       content-type ]  [-s serialno  | --serialno serialno ]  [-O   |  --hide-
14       offset  ]  [-S  | --hide-serialno ]  [-G  | --hide-granulepos ]  [-P  |
15       --hide-packetno ] filename
16
17       oggz-dump [-r  | --revert ]  [-o filename  | --output filename ]  file‐
18       name
19
20       oggz-dump [-h  | --help ]  [-v  | --version ]
21

Description

23       oggz-dump  generates  a hexadecimal or binary dump of packets in an Ogg
24       file, or creates an Ogg file from a hexadecimal oggz-dump file.
25
26

Options

28       oggz-dump accepts the following options:
29
30
31   Dump format options
32       -b, --binary
33                 Generate a binary dump of each packet
34
35
36       -x, --hexadecimal
37                 Generate a hexadecimal dump of each packet
38
39
40   Filtering options
41       -n, --new Only dump the first packet  of  each  new  logical  bitstream
42                 found;  for  correctly  formed Ogg files, this dumps only the
43                 beginning-of-stream packets.
44
45
46       -c content-type, --content-type content-type
47                 Dump only the logical bitstreams for a specific content-type.
48                 Run  oggz-known-codecs(1)  for a full list of codecs known by
49                 the installed version of oggz.
50
51
52       -s serialno, --serialno serialno
53                 Dump only the logical bitstream with specified serialno.
54
55
56       -O, --hide-offset
57                 Hide the byte offset field of the preamble  for  each  packet
58                 dumped.  This  is  particularly  useful  in  conjunction with
59                 oggzdiff(1) when comparing Ogg bitstreams that differ only in
60                 page structure.
61
62
63       -S, --hide-serialno
64                 Hide  the  serialno  field  of  the  preamble for each packet
65                 dumped. This  is  particularly  useful  in  conjunction  with
66                 oggzdiff(1) when comparing Ogg bitstreams that differ only in
67                 serialno assignment.
68
69
70       -G, --hide-granulepos
71                 Hide the granulepos field of the  preamble  for  each  packet
72                 dumped.
73
74
75       -P, --hide-packetno
76                 Hide  the  packetno  field  of  the  preamble for each packet
77                 dumped.
78
79
80   Mode options
81       -r, --revert
82                 Revert an oggz-dump. Generates an Ogg bitstream as prescribed
83                 in the input oggz-dump.
84
85
86                 The  serialno,  granulepos  and packetno fields of the packet
87                 preambles in the oggz-dump, as well as any bos or eos markers
88                 if  present,  are  used to structure the packets into logical
89                 bitstreams. Hence it is advised that the original input oggz-
90                 dump not be generated with any hiding filters.
91
92
93                 Only  the hexadecimal data columns of the input oggz-dump are
94                 parsed when generating Ogg packet data; the printable charac‐
95                 ter representation is ignored.
96
97
98   Miscellaneous options
99       -o filename, --output filename
100                 Write output to the specified filename instead of printing it
101                 to standard output.
102
103
104       -h, --help
105                 Display usage information and exit.
106
107       -v, --version
108                 Output version information and exit.
109
110

EXAMPLES

112       Dump all bitstreams in file.ogg:
113
114              oggz dump file.ogg
115
116       Dump only the Theora bitstream in file.ogv:
117
118              oggz dump -c theora file.ogv
119
120

AUTHOR

122       Conrad Parker        November 17, 2003;
123

125       Copyright © 2003 CSIRO Australia
126
127

SEE ALSO

129       oggz-diff(1), hogg(1)       xxd(1), hexdump(1)
130
131
132
133                                                                  oggz-dump(1)
Impressum