--- a/doc/gdb.texinfo +++ b/doc/gdb.texinfo @@ -12069,6 +12069,7 @@ of trace data, via the @code{target tfil @kindex tsave @item tsave [ -r ] @var{filename} +@itemx tsave [-ctf] @var{dirname} Save the trace data to @var{filename}. By default, this command assumes that @var{filename} refers to the host filesystem, so if necessary @value{GDBN} will copy raw trace data up from the target and @@ -12077,16 +12078,45 @@ optional argument @code{-r} (``remote'') the data directly into @var{filename} in its own filesystem, which may be more efficient if the trace buffer is very large. (Note, however, that @code{target tfile} can only read from files accessible to the host.) +By default, this command will save trace frame into tfile format. +You can supply the optional argument @code{-ctf} to save date in CTF +format. The @dfn{Common Trace Format} (CTF) is proposed as a trace format +that suits the needs of the embedded, telecom, high-performance +and kernel communities. Please goto @indicateurl{http://www.efficios.com/ctf} +to get more information. @kindex target tfile @kindex tfile @item target tfile @var{filename} -Use the file named @var{filename} as a source of trace data. Commands -that examine data work as they do with a live target, but it is not -possible to run any new trace experiments. @code{tstatus} will report -the state of the trace run at the moment the data was saved, as well -as the current trace frame you are examining. @var{filename} must be -on a filesystem accessible to the host. +@kindex target ctf +@kindex ctf +@itemx target ctf @var{dirname} +Use the file named @var{filename} or directory named @var{dirname} as +a source of trace data. Commands that examine data work as they do with +a live target, but it is not possible to run any new trace experiments. +@code{tstatus} will report the state of the trace run at the moment +the data was saved, as well as the current trace frame you are examining. +@var{filename} or @var{dirname} must be on a filesystem accessible to +the host. + +@smallexample +(@value{GDBP}) target ctf ctf.ctf +(@value{GDBP}) tfind +warning: $d is not support. +warning: $c is not support. +warning: $d is not support. +warning: $c is not support. +Found trace frame 0, tracepoint 2 +../../../gdb/gdb/testsuite/gdb.trace/ctf.c:24 +(@value{GDBP}) tdump +$d = void +$c = void +$b = 1 +$a = 0 +$i = 0 +(@value{GDBP}) p $b +$1 = 1 +@end smallexample @end table