oggz-diff.1 3.43 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
.TH "oggz-diff" "1" 
.SH "NAME" 
oggz-diff \(em Hexdump the packets of two Ogg files and output differences 
 
.SH "SYNOPSIS" 
.PP 
\fBoggz-diff\fR [options]  [OGGZDUMP_OPTIONS]  [DIFF_OPTIONS] file1.ogg file2.ogg  
.PP 
\fB\fBoptions:\fR\fR [\-\-verbose ]  [\-v  | \-\-version ]  [\-h  | \-\-help ]  
.PP 
\fB\fBOGGZDUMP_OPTIONS:\fR\fR [\-b  | \-\-binary ]  [\-x  | \-\-hexadecimal ]  [\-c content-type  | \-\-content-type content-type ]  [\-s serialno  | \-\-serialno serialno ]  [\-O  | \-\-hide-offset ]  [\-S  | \-\-hide-serialno ]  [\-G  | \-\-hide-granulepos ]  [\-P  | \-\-hide-packetno ]  
.PP 
\fB\fBDIFF_OPTIONS:\fR\fR [\-q  | \-\-brief ]  [\-C NUM  | \-\-context[=NUM] ]  [\-u  | \-U NUM  | \-\-unified[=NUM] ]  [\-e  | \-\-ed ]  [\-\-normal ]  [\-\-rcs ]  [\-y  | \-\-side-by-side ]  [\-l  | \-\-paginate ]  
.SH "Description" 
.PP 
\fBoggz-diff\fR is a \fBsh\fR script which 
17
uses \fBoggz-dump\fR to generate hexadecimal packet dumps 
18 19 20 21 22 23
of each input file, then outputs the difference between these dumps 
using \fBdiff\fR. 
 
.SH "Options" 
.PP 
\fBoggz-diff\fR forwards a subset of options 
24
accepted by \fBoggz-dump\fR and \fBdiff\fR. 
25
See 
26
\fBoggz-dump\fP\fB(1)\fP and 
27 28
\fBdiff\fP\fB(1)\fP for more detail. 
 
29
.SS "oggz-dump format options" 
30 31 32 33 34 35
.IP "\-b, \-\-binary" 10 
Generate a binary dump of each packet 
 
.IP "\-x, \-\-hexadeciaml" 10 
Generate a hexadecimal dump of each packet 
 
36
.SS "oggz-dump filtering options" 
37 38
.IP "\-c \fBcontent-type\fR, \-\-content-type \fBcontent-type\fR" 10 
Dump only the logical bitstreams for a specific 
39 40 41
\fBcontent-type\fR.
Run \fBoggz-known-codecs\fP\fB(1)\fP for a full list
of codecs known by the installed version of oggz.
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
 
.IP "\-s \fBserialno\fR, \-\-serialno \fBserialno\fR" 10 
Dump only the logical bitstream with specified 
\fBserialno\fR. 
 
.IP "\-O, \-\-hide-offset" 10 
Hide the byte offset field of the preamble for 
each packet dumped. This is particularly useful when comparing 
Ogg bitstreams that differ only in page structure. 
 
.IP "\-S, \-\-hide-serialno" 10 
Hide the serialno field of the preamble for 
each packet dumped. This is particularly useful when comparing 
Ogg bitstreams that differ only in serialno assignment. 
 
.IP "\-G, \-\-hide-granulepos" 10 
Hide the granulepos field of the preamble for 
each packet dumped. 
 
.IP "\-P, \-\-hide-packetno" 10 
Hide the packetno field of the preamble for 
each packet dumped. 
 
.SS "diff options" 
.PP 
The \-w (\-\-ignore-all-space) option to \fBdiff\fR 	is always implied. 
 
.IP "\-q, \-\-brief" 10 
Output only whether files differ. 
 
.IP "\-C \fBNUM\fR, \-\-context[=\fBNUM\fR]" 10 
Output NUM lines of copied context. 
 
.IP "\-u, \-U \fBNUM\fR, \-\-unified[=\fBNUM\fR]" 10 
Output NUM (default 3) lines of unified context. 
 
.IP "\-e, \-\-ed" 10 
Output an ed script. 
 
.IP "\-\-normal" 10 
Output a normal diff. 
 
.IP "\-\-rcs" 10 
Output an RCS format diff. 
 
.IP "\-y, \-\-side-by-side" 10 
Output in two columns. 
 
.IP "\-l, \-\-paginate" 10 
Pass the output through \fBpr\fR to 
paginate it. 
 
.SS "Miscellaneous options" 
.IP "\-\-verbose" 10 
Display verbose messages. 
.IP "\-v, \-\-version" 10 
Display version information and exit. 
.IP "\-h, \-\-help" 10 
Display usage information and exit. 
.SH "AUTHOR" 
.PP 
Conrad Parker       
.SH "COPYRIGHT" 
.PP 
Copyright \(co 2003 CSIRO Australia 
 
.SH "SEE ALSO" 
.PP 
110
\fBoggz-dump\fP\fB(1)\fP, 
111 112 113
\fBdiff\fP\fB(1)\fP, 
\fBpatch\fP\fB(1)\fP      
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35