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>
/testlibraw.c?h=v2.0.8&id=22487936468d60ee02b3f7ad83506dc3a903cb2e&follow=1'>Fix compiler warnings.Gravatar bencollins 4-12/+22 2003-07-13Updates from 0.10.0 release.Gravatar bencollins 4-5/+14 2003-04-23add libtoolize to bootstrapGravatar ddennedy 1-1/+10 2003-04-21added Dan Maas' rawiso docsGravatar ddennedy 1-32/+295 2003-04-07new_handle_on_port() error path fix from Jim RadfordGravatar dmaas 1-1/+3 2003-03-26add raw1394_new_handle_on_port() convenience functionGravatar dmaas 2-1/+41 2003-02-22Updates for new rawiso ioctl interface.Gravatar bencollins 3-37/+125 2003-01-15add iso_xmit_sync() and iso_xmit_write(); clean up iso handling a bitGravatar dmaas 5-39/+161 2003-01-15implement tag matching for rawiso receptionGravatar dmaas 3-4/+12 2003-01-06back out previous commit - don't drop the legacy API just yetGravatar dmaas 6-173/+130 2003-01-05emulate legacy ISO reception API on top of new rawiso APIGravatar dmaas 7-131/+174 2002-12-24update iso API for multi-channel reception and new packet buffer layoutGravatar dmaas 4-123/+236 2002-12-20oops, irq_interval needs to be signedGravatar anonymous 1-1/+1 2002-12-20dmaas - renamed exported arm definitions into the raw1394_ namespace; brought...Gravatar anonymous 3-124/+48 2002-12-16rawiso updates:Gravatar dmaas 3-18/+25 2002-11-18fix cplusplus extern C blockGravatar ddennedy 1-4/+4 2002-11-18merged rawiso branchGravatar ddennedy 7-6/+488