X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;ds=sidebyside;f=ltt%2Fbranches%2Fpoly%2Fdoc%2Fdeveloper%2Fformat.html;h=254700af8f61cc5bf013073da06dc5a356dc9b19;hb=75f5d93b7d1336908118ba95f8b9a90052756bc4;hp=0fa8c4a57a96bc41c5aa866dc4ac6ef4ecb4aad9;hpb=a25fb9c4048f4f413eb1677da8fe762b5ce51356;p=lttv.git diff --git a/ltt/branches/poly/doc/developer/format.html b/ltt/branches/poly/doc/developer/format.html index 0fa8c4a5..254700af 100644 --- a/ltt/branches/poly/doc/developer/format.html +++ b/ltt/branches/poly/doc/developer/format.html @@ -24,7 +24,7 @@ foo/ |-- eventdefs | |-- core.xml | |-- fs.xml -| |-- ipc.xml +| |-- ipc.xml | |-- kernel.xml | |-- memory.xml | |-- network.xml @@ -125,24 +125,16 @@ The block start/end header
begin * the beginning of buffer information - timestamp - * Used only when no TSC is available. - uint32 seconds - uint32 microseconds uint64 cycle_count * TSC at the beginning of the buffer uint64 freq * frequency of the CPUs at the beginning of the buffer. end * the end of buffer information - timestamp - * Used only when no TSC is available. - uint32 seconds - uint32 microseconds uint64 cycle_count * TSC at the beginning of the buffer uint64 freq - * frequency of the CPUs at the beginning of the buffer. + * frequency of the CPUs at the end of the buffer. uint32 lost_size * number of bytes of padding at the end of the buffer. uint32 buf_size @@ -181,15 +173,9 @@ uint8 has_alignment * Is the information in this trace aligned ? Yes (1) -> aligned on min(arch size, atomic data size). No (0) -> data is packed. -uint8 has_tsc - * Does the traced machine has a working TSC ? - Yes (1) -> event time is calculated from : - trace_start_time + ((event_tsc - trace_start_tsc) * freq) - No (0) -> event time is calculated from : - trace_start_time - + (buffer start timestamp - trace start_monotonic) - + (event_time_delta) - (not supported) +uint32 freq_scale + event time is always calculated from : + trace_start_time + ((event_tsc - trace_start_tsc) * (freq / freq_scale)) uint64 start_freq * CPUs clock frequency at the beginnig of the trace. uint64 start_tsc @@ -222,9 +208,6 @@ Event header : uint64 timestamp } * if has_heartbeat : 32 LSB of the cycle counter at the event record time. * else : 64 bits complete cycle counter. - * note : if there is no working TSC (has_tsc == 0), then this field contains - either the complete monotonically increasing time or the time delta from the - previous heartbeat event. (unsupported) uint8 facility_id * Numerical ID of the facility corresponding to the event. See the facility tracefile to know which facility ID matches which facility name and @@ -373,10 +356,10 @@ Finally the type structure may be defined by referencing a named type. <typeref name=type_name/>-
-The facility named "builtin" is always present and contains at least the +The facility named "core" is always present and contains at least the following event types.
@@ -385,18 +368,27 @@ following event types. <struct> <field name="name"><string/></field> <field name="checksum"><uint size=4/></field> - <field name="base_code"><uint size=4/></field> + <field name="id"><uint size=4/></field> + <field name="int_size"><uint size=4/></field> + <field name="long_size"><uint size=4/></field> + <field name="pointer_size"><uint size=4/></field> + <field name="size_t_size"><uint size=4/></field> + <field name="has_alignment"><uint size=4/></field> </struct> </event> -<event name=block_start> - <description>Block start timestamp</description> - <typeref name=block_timestamp/> -</event> - -<event name=block_end> - <description>Block end timestamp</description> - <typeref name=block_timestamp/> +<event name=state_dump_facility_load> + <description>Facility used in the trace</description> + <struct> + <field name="name"><string/></field> + <field name="checksum"><uint size=4/></field> + <field name="id"><uint size=4/></field> + <field name="int_size"><uint size=4/></field> + <field name="long_size"><uint size=4/></field> + <field name="pointer_size"><uint size=4/></field> + <field name="size_t_size"><uint size=4/></field> + <field name="has_alignment"><uint size=4/></field> + </struct> </event> <event name=time_heartbeat> @@ -407,26 +399,14 @@ following event types. <typeref name=timestamp/> </event> -<type name=block_timestamp> - <struct> - <field name=timestamp><typeref name=timestamp></field> - <field name=block_id><uint size=4/></field> - </struct> -</type> - <type name=timestamp> <struct> - <field name=time><typeref name=timespec/></event> + <field name="seconds"><uint size=4/></field> + <field name="nanoseconds"><uint size=4/></field> <field name="cycle_count"><uint size=8/></field> </struct> </event> -<type name=timespec> - <struct> - <field name="seconds"><uint size=4/></field> - <field name="nanoseconds"><uint size=4/></field> - </struct> -</type>