NEWS

uftrace v0.14
=============
* new options
  --trigger option is restored
  --trace=(on|off) option to deprecate --disable
  filters and triggers can be deleted with @clear action (with agent)

* new features
  python tracing  (#436, #1640, #1641, #1676)
  change options at runtime with agent  (#1665, #1678, #1643, #1644, #1645, #1646)

* bug fixes
  Lots of fixes for the test infra  (#1628)

* other changes
  Android build support  (#1605)
  Update symbol file format to add symbol size  (#1616)
  Improve Rust symbol demangling  (#1625)
  Change default library install path  (#1618)
  Use C11 + GNU extensions for compilation  (#1642)

And many other fixes and improvements.  Thanks all contributors:
  Bernhard Kaindl, ChoKyuWon, Clément Guidi, Honggyu Kim, Kang Minchul,
  Khem Raj, Michelle Jin, Namhyung Kim, Sangwon Hong, Yi Hong, Yuri Gribov


uftrace v0.13
=============
* new options
  -L/--loc-filter option to filter by source location  (#1395)
  --mermaid option for uftrace dump  (#1511)
  --no-sched-preempt option to disable preempted schedule events  (#1587)

* new features
  make -Z/--size-filter option work in general  (#1600)
  optionally spawn a background agent to talk using a socket  (#1543)
  add "size" field for uftrace report  (#1495)

* bug fixes
  handle different tracefs mount points  (#1476)
  fix timestamp parsing for external data  (#1549)

* other changes
  add clang-format support
  change to use Github actions
  test both GCC and LLVM/clang  (#1523)

And many other fixes and improvements.  Thanks all contributors:
  Andrew Woo, Clément Guidi, Daero Lee, Euiseo Park, Eunseon Lee, Honggyu Kim,
  JHH20, JaeSang Yoo, JeongWan Gho, Jia Ha, JongHyeon Hwang, Jonghyeon An,
  Joonho Seo, Kang Minchul, Namhyung Kim, Paran Lee, Sangwon Hong, Seonghee Jin,
  Seonghyun Park, Yuri Gribov, Yusun Choi, valdaarhun


uftrace v0.12
=============
* new options
  --no-args to hide arguments and return values
  --clock option to set clock source other than monotonic

* new features
  support events in uftrace script
  enable --with-syms for uftrace record
  adjust sample time for flame graph dump  (#1257)

* dynamic tracing updates
  support binaries built with -fpatchable-function-entry  (#1238)
  documentation updates

* bug fixes
  fix segfault in uftrace record on a large machine  (#1418)
  various fixes for ARM build failures

* other changes
  allow -s option to set a sort key for TUI report
  remove -L option for later use
  add func-histogram.py script
  a couple of update in the travis CI setup

And many other fixes and improvements.  Thanks all contributors:
  Eunseon Lee, Honggyu Kim, ihsinme, Kang Minchul, Nobuhiro Iwamatsu,
  Paul Cannon, Sangwon Hong, Thomas Petazzoni


uftrace v0.11
=============
* new options
  --format=html to print a html page directly  (#1308)
  --with-syms to replay/report with existing symbol data  (#1228)

* new features
  support note.txt in the data directory to put extra notes  (#1307)
  improve debugging with stacktrace using libunwind  (#1177)
  support customizing output fields in TUI report (#1270)

* dynamic tracing updates
  support -mfentry -mnop-mcount on i386  (#1296)
  dynamic tracing for clang XRay v2  (#1265)
  SONAME support for library patterns in dynamic tracing  (#1216)

* bug fixes
  fix two similar struct arguments are used  (#1281)
  fix struct argument is used in uftrace script  (#1282)
  fix TUI info mode crash in a large screen
  fix crash in the USDT event tracing  (#1286)

* other changes
  update and fix build with python3  (#1271, #1344)
  ignore remaining schedule events in replay  (#1293)
  enable undefined-behavior sanitizer (ubsan) with ASAN=1  (#1295)

And many other fixes and improvements.  Thanks all contributors:
  Bernhard Kaindl, Gabriel-Andrew Pollo-Guilbert, Hanbum Park
  Honggyu Kim, Kang Minchul, Kun-Chuan Hsieh, Michael Sartain
  Sangwon Hong


uftrace v0.10
=============
* new options
  --estimate-return to avoid return address hooking
  -H/--hide to not display unwanted symbols
  --no-sched to suppress scheduler events
  --srcline supports report/replay/graph (by Eunseon)

* dynamic tracing update (mostly by Hanbum)
  convert to hash map to find saved code
  it can trace functions in libraries loaded by dlopen()
  support patching MOV instruction in x86

* other changes
  convert from argparse to getopt_long
  check binary build-id (for binaries have same name)
  struct argument/return value (pass-by-value) support
  support customizing output fields in TUI graph (by Sangwon)

* bug fixes
  fix floating-point register access on AArch64
  fix issues with Intel CET technology on x86
  handle zero PLT entry size on AArch64
  fix crash when C++ object is passed indirectly

And many other fixes and improvements.  Thanks all contributors:
  Anas Blaboul, Daniel T. Lee, Dohyung Kim, Eunseon Lee,
  Hanbum Park, Honggyu Kim, Kang Minchul, Lei Maohui,
  Nathan Lanza, Sang-Heon Jeon, Sangwon Hong, SeokHoon Yoon,
  Sungho Bae, Tim Gates


uftrace v0.9.4
--------------
* dynamic tracing update
  improve success rate on x86_64
  dynamic unpatch on x86_64 (for -mfentry or -mrecord-mcount)
  add -U/--unpatch option for dynamic tracing
  experimental support for aarch64

* script update
  luaJIT (lua 5.1) support by Byeonggon
  python3 support

* build change
  update configure script for better compatibility
  handle common cross compile settings

* tui change
  add 's' key to sort column in tui report mode by Hyoungjong
  use --report option to start tui with report mode

* other changes
  task level analysis for graph and info command
  add Korean documentation
  a lot of memory leak fixes

And many bug fixes and improvements.  Thanks for all contributors:
  Anas Balboul, Byeonggon Lee, Colin Lord, George Karlos, GwanYeong Kim,
  Haeun Jeon, Hanbum Park, Handong Choi, Honggyu Kim, Hyoungjong Kim,
  Jeesoo Min, Joonho Ryu, Jungkeun Cho, Jungwoo Jo, Junil Kim,
  Minchul Kang, MinJeong Kim, Sang-Heon Jeon, Sangyun Han,
  SeoYoung Kim, Sungho Yoon, Yeomin Nam


uftrace v0.9.3
--------------
* dynamic tracing update
  add (optional) dependency of capstone disassembly engine
  support tracing executables w/o instrumentation on x86_64
  add -Z/--size-filter option not to select small functions

* external event support
  support display user-defined events in uftrace.data/extern.dat
  it's a text file which has timestamp and message for each line

* other changes
  allow tracing (system) binaries in the PATH
  add --srcline option to save debug info only if necessary
  apply --time-filter for analysis commands by default
  allow tracing execution of shell (interpreter)

And many bug fixes and improvements.  Thanks for all contributors:
  Daniel T. Lee, Hanbum Park, Honggyu Kim, Taeung Song


uftrace v0.9.2
--------------
* trigger update
  add --signal option to support trigger by signal

* TUI update
  add C/E key to collapse/expand all child nodes
  make R/r key to go to report window separately
  add z key to align screen to center

* other changes
  display data symbols in argument/return value
  trace library calls even without PLT
  add -l short option for --nest-libcall
  rudimentary support for Rust programs

And many bug fixes and improvements.  Thanks for all contributors:
  Anas Balboul, Claudia J. Kang, Daniel T. Lee, Honggyu Kim


uftrace v0.9.1
--------------
* filter update
  add --caller-filter option

* script changes
  rename context in uftrace_begin: "args" -> "cmds"
  rename context in uftrace_begin: "recording" -> "record"

* other changes
  add --watch option to trace cpu task is running
  add --graphviz option to produce output in DOT format
  filter 'do_syscall_64' kernel function by default

And many bug fixes and improvements.  Thanks for all contributors:
  Ahn Seung-rye, Claudia J. Kang, Daniel T. Lee, GwanYeong Kim,
  Hanbum Park, Honggyu Kim, Leah Neukirchen, Rikard Falkeborn


uftrace v0.9
============
* argument update
  automatic argument using DWARF debug info
  display enum constants properly
  add -a short option for --auto-args

* TUI implementation
  graph, report and info commands using ncurses
  redraw graph for a selected function
  fold/unfold and search nodes in graph

* build changes
  configure script shows status of dependencies
  add --without-XXX option to the configure script
  allow build without libelf

* filter changes
  add --match option to select pattern matching method: regex or glob
  add --no-event option to disable default events
  apply recover trigger for every function automatically

* other changes
  pass runtime info to script
  add -h short option for help message
  add --no-randomize-addr option to disable ASLR
  enable task scheduling events by default
  use gray color for comments and green for events
  add basic gdb (python) script to help debugging
  add misc/symbols tool to show symbol name from address

And many bug fixes and improvements.  Thanks for all contributors:
  GwanYeong Kim, Hanbum Park, Honggyu Kim, Taeguk Kwon, Taeung Song,
  Khem Raj


uftrace v0.8.3
--------------
* i386 arch support (by Hanbum Park):
  support arguments and dynamic tracing

* graph update (by Honggyu Kim):
  add -f/--output-fields option to control output
  share common code/behavior with replay command

* event update:
  add task events (fork/comm/exit) using Linux perf subsystem
  enable task events always if supported

* trigger change:
  change 'read' trigger action to read events twice (at entry and exit)
  support some pmu-related events using read trigger (with perf syscall)
  allow 'd' format specifier for default behavior with different size

* other changes:
  add misc/demangler to test demangling easily
  add --libname option to show library names for PLT functions

And many bug fixes and improvements.  Thanks for all contributors:
  Hanbum Park, Honggyu Kim, Taeung Song


uftrace v0.8.2
--------------
* trigger update
  add 'p' format for function pointer
  add --auto-args option for automatic argument/return value
  support enum type for auto-args

* diff change
  add 'compact' policy and make it default
  old behavior is supported on 'full' policy

* graph change
  show full graph when no function given
  support fork+exec properly

* script change
  flush stdout buffer before fork
  serialize execution using a mutex

And many bug fixes and improvements.  Thanks for all contributors:
  Andrew Slough, Hansuk Hong, Hanbum Park, Honggyu Kim, JangSoJin,
  Myungjin Ko, MyungSik Ji, Sangwon Hong, Taeung Song,
  Vincent LE GARREC, Yujeong Kim


uftrace v0.8.1
--------------
* trigger update
  apply filter/trigger to all libraries by default
  save symbol tables of all libraries
  -T/--trigger option supports filtering and argument/return value

* other changes
  make --nest-libcall option imply --force option
  add --record option to script command
  replay show 's' suffix for std::string arguments
  allow reading data in current directory

And many bug fixes and improvements.  Thanks for all contributors:
  Honggyu Kim, Taeung Song


uftrace v0.8
============
* event tracing support:
  enable tracing events as well as functions.  following events are
  supported using -E/--event option
    - SystemTap SDT (x86_64 only)
    - kernel tracepoint
    - scheduler (using perf syscall)
  list available events using --list-event option
  new read trigger also creates 'proc/statm' and 'page-fault' events

* libcall tracing update:
  fix to trace already resolved functions too
  trace nested calls from other libraries using --nest-libcall option
  handle BIND-NOW + PIE properly

* python scripting support:
  add new 'script' command with -S/--script option
  also support record-time scripting
  support additional filter for script execution
  allow to specify options for recording

* report diff change:
  sort by (absolute) diff
  add --diff-policy option to control behavior
  add 'func' sort key
  change color setting

* other changes:
  std::string argument display
  add elapsed time info
  "uftrace recv --run-cmd" can execute user-given command
  add "finish" trigger action to tracing
  add --opt-file option to allow reading options from file
  add --keep-pid option to preserve pid when running program

And many bug fixes and improvements.  Thanks for all contributors:
  Changhyeok Bae, Honggyu Kim, JeongBong Seo, SeongJae Park,
  Taeung Song, Paul Cannon


uftrace v0.7
============
* dynamic tracing support (x86_64 only)
  enable tracing for selected functions with -P option
  it needs some compiler support though
  - gcc with -mnop-mcount option
  - clang (X-ray) with -fxray-instrument option

* AArch64 support
  add preliminary support for ARM v8 (64-bit)
  first integer argument is missing

* kernel tracing change
  show recorded kernel functions by default
  partial support for event tracing
  fix to send/receive kernel data via network
  filter out sys_clock_gettime() for non-VDSO systems

* dump change:
  show arguments and return values properly
  show more kernel tracing info
  fix file offset printing

* build change:
  fix various problems on GCC 7
  update configure script for better distro packaging

And many bug fixes and improvements.  Thanks for all contributors:
  Dridi Boukelmoune, Honggyu Kim, Taeung Song, Wonseok Ko


uftrace v0.6.2
--------------
* dlopen() support:
  can show functions from dynamic loaded library using dlopen()

* kernel tracing update:
  save kernel metadata so that it can be viewed from a different machine
  adjust tracer settings to reduce lost kernel data

* filter change:
  remove '+' sign in elapsed time for --time-range option
  allow to use 'm' or 'min' to specify elapsed time

And many bug fixes and improvements.  Thanks for all contributors:
  Abder Benbachir, Geneviève Bastien, Honggyu Kim, Taeung Song,
  Wonseok Ko


uftrace v0.6.1
--------------
* kernel option change:
  The -K option is same as --kernel-depth
  The --kernel-skip-out is deprecated and use
  The --kernel-full is to show kernel functions outside of user functions
  The --kernel-only option was added

* replay change:
  add --output-fields option to customize the info on the left side
  currently time, delta, elapsed, duration, tid and addr fields are supported

* filter change:
  apply time filter on replay
  add --time-range option to limit data analysis
  report, graph and dump honors same filter on replay
  add 'time' trigger to set a different threshold on specific functions

* flame-graph support:
  "uftrace dump --flame-graph" creates a SVG file
  use --sample-time option to control sampling frequency in the output

* build change:
  improve build process to facilitate distro packaging
  configure script checks dependency and shows warning


uftrace v0.6
============
* project open!