summaryrefslogtreecommitdiffstats
path: root/doc/isodump.5.in
blob: 7ab20a61767c7fbe03ee46d9fb3afb83518ab8d7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
.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>
pan>/+130 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@100 53a565d1-3bb7-0310-b661-cf11e63c67ab 2003-01-05emulate legacy ISO reception API on top of new rawiso APIGravatar dmaas 7-131/+174 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@99 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-12-24update iso API for multi-channel reception and new packet buffer layoutGravatar dmaas 4-123/+236 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@98 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-12-20oops, irq_interval needs to be signedGravatar anonymous 1-1/+1 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@97 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-12-20dmaas - renamed exported arm definitions into the raw1394_ namespace; ↵Gravatar anonymous 3-124/+48 brought kernel-raw1394.h back in sync with the kernel version git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@96 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-12-16rawiso updates:Gravatar dmaas 3-18/+25 - changed return type of rawiso xmit/recv handlers from int to enum raw1394_iso_disposition - added an ioctl (RAW1394_ISO_QUEUE_ACTIVITY) to force an ISO_ACTIVITY event into the queue. This is needed for handling RAW1394_ISO_DEFER, to kick us out of the next read() instead of sleeping forever. - removed references to "8-byte" isochronous header - this is an OHCI-specific implementation detail git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@95 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-11-18fix cplusplus extern C blockGravatar ddennedy 1-4/+4 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@94 53a565d1-3bb7-0310-b661-cf11e63c67ab 2002-11-18merged rawiso branchGravatar ddennedy 7-6/+488 git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@93 53a565d1-3bb7-0310-b661-cf11e63c67ab