.TH isodump 5 "isodump v1" "libraw1394 @VERSION@" "Linux IEEE 1394"
.SH NAME
isodump \- format of IEEE 1394 isochronous packets dump file
.SH DESCRIPTION
The isodump format stores a series of IEEE 1394 isochronous stream
packets (possibly from multiple channels), including their headers.
Its main use is as the output format of \fBdumpiso\fR(1) and the input
format of \fBsendiso\fR(1).
.PP
The 32 byte header starts at offset 0 with the string "1394 isodump
v1" followed by a zero byte.  The next 8 bytes form a 64 bit big
endian integer, which represents a bit mask of the channels that were
dumped.  A set bit at position (1 << x) signifies that channel x was
being listened on.  The following 8 bytes are set to zero.
.PP
The iso packets follow the header and are appended to the data stream
in the order they were received.  The packets consist of the header
quadlet as originally received and the data quadlets following
directly.  The CRC quadlets after header and data do not appear and
everything is in big endian, as seen on the bus.
.PP
There is no further framing of the packets in the format, packet
boundaries can be found by looking at the data size field in the
header quadlet of each packet.  The data size field appears in the
most significant 16 bits of the header quadlet, contain the size in
bytes (the actual packet is padded to a multiple of four bytes) and do
not include the header packet.
.SH COMPATIBILITY
This format was introduced with the iso send and dump tools
distributed with libraw1394.  No one else uses it so far.
.SH SEE ALSO
.B sendiso\fR(1),
.B dumpiso\fR(1)
.SH AUTHOR
Andreas Bombe <aeb@debian.org>