Clarify number of files per stream
[ctf.git] / common-trace-format-specification.txt
index 86060dae584ab9c0602df0b1aad065b32eb3a64c..9cd39ded0b898159da9672b4262014b0b924ee88 100644 (file)
@@ -1,4 +1,4 @@
-Common Trace Format (CTF) Specification (v1.7)
+Common Trace Format (CTF) Specification (pre-v1.8)
 
 Mathieu Desnoyers, EfficiOS Inc.
 
@@ -94,7 +94,8 @@ The final output of the trace, after its generation and optional transport over
 the network, is expected to be either on permanent or temporary storage in a
 virtual file system. Because each event stream is appended to while a trace is
 being recorded, each is associated with a separate file for output.  Therefore,
-a stored trace can be represented as a directory containing one file per stream.
+a stored trace can be represented as a directory containing zero, one or
+more files per stream.
 
 Meta-data description associated with the trace contains information on
 trace event types expressed in the Trace Stream Description Language
@@ -662,9 +663,9 @@ Event packet header (all fields are optional, specified by TSDL meta-data):
 
 Event packet context (all fields are optional, specified by TSDL meta-data):
 
-- Event packet content size (in bytes).
-- Event packet size (in bytes, includes padding).
-- Event packet content checksum (optional). Checksum excludes the event packet
+- Event packet content size (in bits).
+- Event packet size (in bits, includes padding).
+- Event packet content checksum. Checksum excludes the event packet
   header.
 - Per-stream event packet sequence count (to deal with UDP packet loss). The
   number of significant sequence counter bits should also be present, so
@@ -1026,8 +1027,9 @@ event context to define a variant referring to the "id" field of the
 event header as selector.
 
 The target dynamic scope must be specified explicitly when referring to
-a field outside of the local static scope. The dynamic scope prefixes
-are thus:
+a field outside of the local static scope (a local static scope contains
+all fields present within the same scope, at the same nesting level).
+The dynamic scope prefixes are thus:
 
  - Trace Packet Header: <trace.packet.header. >,
  - Stream Packet Context: <stream.packet.context. >,
This page took 0.024063 seconds and 4 git commands to generate.