X-Git-Url: http://git.efficios.com/?p=ctf.git;a=blobdiff_plain;f=common-trace-format-specification.txt;h=dd00ca14da40cef273255f121dbe8e9092c9c396;hp=532094434798bce2376e0e621cf26281c3fd93c1;hb=7409082d5b87159a0b2caefb8a631f8529fb2b61;hpb=2a0bae9ec1c7b488839280f285cbf16a8d8ab9c0 diff --git a/common-trace-format-specification.txt b/common-trace-format-specification.txt index 5320944..dd00ca1 100644 --- a/common-trace-format-specification.txt +++ b/common-trace-format-specification.txt @@ -248,7 +248,7 @@ TSDL meta-data representation: size = value; /* value in bits, no default */ align = value; /* value in bits */ /* based used for pretty-printing output, default: decimal. */ - base = decimal OR dec OR OR d OR i OR u OR 10 OR hexadecimal OR hex OR x OR X OR p OR 16 + base = decimal OR dec OR d OR i OR u OR 10 OR hexadecimal OR hex OR x OR X OR p OR 16 OR octal OR oct OR o OR 8 OR binary OR b OR 2; /* character encoding, default: none */ encoding = none or UTF8 or ASCII; @@ -717,7 +717,11 @@ Event packet context (all fields are optional, specified by TSDL meta-data): while (or before) writing the first event and while (or after) writing the last event in the packet. The inclusive range between these timestamps should include all event timestamps assigned to events contained within the packet. - See Section 8. Clocks for more detail. + The timestamp at the beginning of an event packet is guaranteed to be + below or equal the timestamp at the end of that event packet. + The timestamp at the end of an event packet is guaranteed to be below + or equal the timestamps at the end of any following packet within the + same stream. See Section 8. Clocks for more detail. - Events discarded count - Snapshot of a per-stream free-running counter, counting the number of events discarded that were supposed to be written in the stream after @@ -812,6 +816,12 @@ located in inner structures (those with a higher number in the listing above) can refer to the fields of outer structures (with lower number in the listing above). See Section 7.3 TSDL Scopes for more detail. +The total length of an event is defined as the difference between the +end of its Event Payload and the end of the previous event's Event +Payload. Therefore, it includes the event header alignment padding, and +all its fields and their respective alignment padding. Events of length +0 are forbidden. + 6.1 Event Header Event headers can be described within the meta-data. We hereby propose, as an