X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=common-trace-format-proposal.txt;h=71d9140704eb049dba1032c11c392f209f802b21;hb=350bb6335058137e1984fad8a39b07e862d2d830;hp=f2f7e232b4b7b0a23513a74ac24490b8286664ce;hpb=969f30c0f23e7a169d534315b4fcc07ca58362b9;p=ctf.git

diff --git a/common-trace-format-proposal.txt b/common-trace-format-proposal.txt
index f2f7e23..71d9140 100644
--- a/common-trace-format-proposal.txt
+++ b/common-trace-format-proposal.txt
@@ -597,6 +597,17 @@ trace {
   packet.header := struct event_packet_header;
 };
 
+If a packet header lacks the "magic" number field, the trace endianness
+needs to be specified in the trace "endian" metadata attribute.
+
+If the trace_uuid is not present, no validation that the metadata
+actually corresponds to the stream is performed.
+
+If the stream_id packet header field is missing, the trace can only
+contain a single stream. Its "id" field can be left out, and its events
+don't need to declare a "stream_id" field.
+
+
 5.2 Event Packet Context Description
 
 Event packet context example. These are declared within the stream declaration
@@ -894,6 +905,10 @@ Note that the trace endianness is usually extracted from the packet
 header magic number. The "endian" field is only needed when the magic
 number packet header field is not present.
 
+The stream "id" can be left out if there is only one stream in the
+trace. The event "id" field can be left out if there is only one event
+in a stream.
+
 trace {
   major = value;				/* Trace format version */
   minor = value;