1 Noteworthy changes in release ?.? (????-??-??)
2 ==============================================
4 Noteworthy changes in release 4.9 (2014-08-15)
5 ==============================================
8 * Disabled OABI support on ARM EABI systems by default,
9 added --enable-arm-oabi option to enable it at configure time.
12 * Added experimental -k option to print stack trace after each traced syscall.
13 * Added -w option to produce stats on syscall latency.
14 (addresses Debian bug #457497).
15 * Added ARC architecture support.
16 * Added PTRACE_GETREGS API support on PowerPC.
17 * Enhanced Bionic libc and musl libc support.
18 * Enhanced tracing of x86 personality processes on x86_64 and x32.
19 * Enhanced tracing of ARM personality processes on AArch64.
20 * Enhanced 32/64bit personality detection on PowerPC.
21 * Implemented decoding of add_key, ioprio_get, ioprio_set, kexec_load, keyctl,
22 renameat2, and request_key syscalls.
23 * Robustified decoding of select, pselect, and io_submit syscalls.
24 * Enhanced decoding of delete_module, fanotify_init, fanotify_mark, fcntl,
25 setdomainname, sethostname, setns, and sync_file_range syscalls.
26 * Enhanced decoding of signal bitmasks.
27 * Enhanced decoding of file descriptors.
28 * Enhanced siginfo_t decoding.
29 * Enhanced PF_NETLINK decoding.
30 * Updated CLOCK_* constants
31 (addresses Fedora bug #1088455).
32 * Added new syscall entries to match Linux 3.16.
35 * Added shmat and shmdt to the set of memory mapping related syscalls.
36 * Fixed detaching from stopped processes.
37 * Fixed fanotify_mark decoding on 32bit architectures.
38 * Fixed offset decoding in preadv and pwritev syscalls.
39 * Fixed select decoding for glibc in _FORTIFY_SOURCE mode.
40 * Fixed decoding of epoll_ctl syscall with EPOLL_CTL_DEL argument.
41 * Fixed build when <sys/ptrace.h> and <linux/ptrace.h> conflict
42 (addresses Fedora bug #993384).
43 * Miscellaneous corrections in the manual page.
44 (Addresses Debian bug #725987).
46 Noteworthy changes in release 4.8 (2013-06-03)
47 ==============================================
50 * In case of normal strace termination, when the trace output is
51 redirected to a pipe, strace now closes it and waits for the pipe
52 process termination before exit.
55 * Implemented tracing using PTRACE_SEIZE API (when available).
56 * Implemented more reliable PTRACE_GETREGSET-based process personality
57 detection on x86-64 and x32 (when available).
58 * Added -e trace=memory option for tracing memory mapping related syscalls.
59 * Documented -b option.
60 * Allowed exit status messages to be suppressed by giving -q option twice.
61 * Added AArch64 architecture support
62 (addresses Debian bug #693074 and Fedora bug #969858).
63 * Added support for OpenRISC 1000, Meta, and Xtensa architectures.
64 * Added tilegx personality support for Tile.
65 * Enhanced support of NOMMU architectures.
66 * Enhanced decoding of getdents, mmap, perf_event_open, ptrace, and
68 * Added new syscall entries to match Linux 3.9.
69 * Regenerated the list of common ioctl names from Linux 3.9.
70 * Updated the list of errno constants.
71 * Updated lists of AF_*, MADV_*, MAP_*, MSG_*, MS_*, PF_*, PR_*,
72 PTRACE_O_*, and TCP_* constants.
73 * Implemented decoding of UBI ioctls.
74 * Removed redundant "*32" ioctl names.
77 * Fixed ERESTARTNOINTR leaking to userspace on ancient kernels
78 (addresses Fedora bug #659382).
79 * Fixed kernel release string parsing
80 (addresses Debian bug #702309).
81 * Fixed decoding of *xattr syscalls
82 (addresses Fedora bug #885233).
83 * Fixed handling of files with 64-bit inode numbers by 32-bit strace
84 (addresses Fedora bug #912790).
85 * Fixed tracing forks on SPARC.
86 * Fixed decoding of fadvise64, fallocate, ftruncate64, io_submit, pread,
87 preadv, pwrite, pwritev, readahead, sigaltstack, sync_file_range, sysctl,
88 and truncate64 syscalls.
89 * Fixed categories of multiple syscalls on most of supported architectures.
90 * Fixed decoding of non-native 32-bit personality recv[m]msg syscalls.
91 * Fixed decoding of multiple 32-bit personality syscalls on x32.
92 * Fixed decoding of long long syscall arguments on ARM, MIPS/o32, PowerPC,
93 S390x, and Tile architectures.
94 * Fixed semtimedop decoding on S390x.
95 * Fixed sram_alloc decoding on Blackfin.
96 * Fixed build when process_vm_readv is a stab.
97 * Fixed build with older versions of libaio.h.
99 Noteworthy changes in release 4.7 (2012-05-02)
100 ==============================================
102 * Changes in behavior
103 * strace no longer suspends waitpid until there is a child
104 for waitpid'ing process to collect status from.
105 * strace no longer detaches from a tracee which is supposed
107 * strace now issues a new message: "+++ exited with EXITCODE +++"
108 which shows exact moment strace got exit notification,
109 analogous to existing "+++ killed by SIG +++" message.
112 * Added x32 personality support (x86_64 architecture).
113 * Added -y and -P options to print file descriptor paths and
114 filter by those paths.
115 * Added -I option to control strace interactivity.
116 * Allowed -p option to take comma or whitespace-separated list of PIDs.
117 * Added strace_log_merge script helper to merge timestamped "strace -ff"
119 * Implemented decoding of clock_adjtime, get_robust_list, migrate_pages,
120 preadv, prlimit64, process_vm_readv, process_vm_writev, pwritev,
121 recvmmsg, recvmsg, rt_tgsigqueueinfo, sendmmsg, setns, set_robust_list,
122 sched_rr_get_interval, splice, syslog, tee and vmsplice syscalls.
123 * Enhanced decoding of capget, capset, getrlimit, flistxattr, io_submit,
124 listxattr, setrlimit and swapon syscalls.
125 * Implemented decoding of loop and mtd ioctls.
126 * Added syscall entries for new linux syscalls.
127 * Added syscall entries for direct socket system calls on powerpc.
128 * Updated the list of errno constants.
129 * Updated lists of MSG_*, STA_*, and TCP_* constants.
130 * Regenerated the list of ioctl names from Linux 3.3.
131 * Enhanced switching between processes with different personalities.
132 * Enhanced signals reporting by using short signal names.
133 * Made ERESTART* messages more descriptive.
134 * Made parsing of numbers from strings more robust.
135 * Added support for compat_statfs64 and statfs64.f_flags.
136 * Changed read of data blocks to use single process_vm_readv syscall
137 (when available) instead of several PTRACE_PEEKDATA operations.
138 * Changed read of registers on x86 and x86-64 to use single PTRACE_GETREGS
139 operation instead of several PTRACE_PEEKUSER operations.
140 * Applied various optimizations to make strace work faster.
143 * Implemented proper handling of real SIGTRAPs on kernels supporting
144 PTRACE_O_TRACESYSGOOD.
145 (Addresses Fedora bug #162774).
146 * Fixed sockaddr_un.sun_path name in decoded output.
147 (Addresses Debian bug #554946).
148 * Fixed to avoid potential core file clobbering on exit.
149 (Addresses Debian bug #656398).
150 * Fixed a typo in documentation.
151 (Addresses Debian bug #653309).
152 * Fixed decoding of timer id returned by timer_create.
153 * Fixed epoll_create1, epoll_wait and epoll_pwait decoding.
154 * Fixed *at syscalls flags decoding.
155 * Fixed ARM EABI 64-bit syscall's arguments decoding.
156 * Fixed semtimedop decoding on s390.
157 * Fixed osf_sigprocmask decoding on alpha.
158 * Fixed ipc and socket subcall decoding on several architectures.
159 * Corrected syscall entries for epoll_pwait, epoll_create, epoll_ctl,
160 epoll_wait, mincore, mlockall, prctl, reboot, sendfile, sendfile64,
161 sendmsg, sgetmask, ssetmask, swapon, tgkill and tkill syscalls.
162 * Corrected io_* syscall entries on ARM.
163 * Fixed PID prefix printing in "strace -oLOG -ff -p1 -p2 -p3" case.
164 * Fixed logging of unfinished lines in "strace -oLOG -ff" case.
165 * Fixed build when libaio-devel is not available.
166 * Fixed configure checks for PTRACE_* constants.
167 * Fixed compilation warnings remained on several architectures.
170 * Removed all non-Linux code. After years of neglect, that dead code
171 just hampered further strace development.
172 * Linux kernel >= 2.6.18 is recommended. Older versions might still
173 work but they haven't been thoroughly tested with this release.
175 Noteworthy changes in release 4.6 (2011-03-15)
176 ==============================================
178 * Changes in behavior
179 * Print diagnostic information about changes in personality mode to
180 standard error instead of standard output.
183 * Implemented a new method of following clone, fork, and vfork
184 syscalls using the Linux kernel's explicit facilities for tracing
185 creation of threads and child processes.
186 * Implemented CLONE_PARENT and CLONE_UNTRACED flags handling.
187 * Implemented decoding of TLS syscalls on m68k.
188 * Implemented biarch support on powerpc64.
189 * Implemented biarch support for getrlimit() and setrlimit().
190 * Implemented decoding of struct ucred in getsockopt SO_PEERCRED.
191 * Implemented SOL_SCTP socket options decoding.
192 * Added HDIO_* ioctl names.
193 (Addresses Debian bug #450953).
194 * Added LOOP_* ioctl names.
195 * Updated lists of CLOCK_*, CLONE_*, MS_*, and SOL_* constants
196 to match Linux 2.6.37.
197 * Updated the list of IPPROTO_* constants to match netinet/in.h.
198 * Implemented decoding of HDIO_* and BLK* ioctls.
199 * Added MicroBlaze architecture support.
200 * Added new syscall entries to match Linux 2.6.37.
201 * Regenerated list of ioctl names from Linux 2.6.37.
202 * Enhanced signal notification decoding.
203 * Documented -C and -D options.
206 * Fixed fetching syscall arguments on m68k.
207 * Fixed an error when judging whether a process has children.
208 * Fixed get/set_robust_list syscall numbers for powerpc.
209 * Fixed a corner case in printing clone flags.
210 * Fixed cross-compiling issues.
211 * Fixed build issues on powerpc64, SH and SPARC.
212 * Fixed syscall flags of fstatat*, mmap, mmap2, fadvise64*, swapoff,
213 fgetxattr, flistxattr, fremovexattr, epoll_create, fallocate,
214 fanotify_init, and fanotify_mark syscalls.
215 * Fixed decoding of get[ug]id, gete[ug]id and setfs[ug]id return values.
216 * Fixed biarch support in IO dumping.
217 * Fixed raw exit_group decoding.
218 * Fixed decoding of file descriptors on 64-bit architectures.
219 * Fixed a corner case in waitpid handling.
220 (Addresses Red Hat bug #663547).
221 * Fixed stat64 decoding on mips
222 (Addresses Debian bug #599028).
223 * Fixed misleading italics in the manual page.
224 (Addresses Debian bug #589323).
226 Noteworthy changes in release 4.5.20 (2010-04-13)
227 =================================================
230 * Implemented decoding of new linux syscalls: inotify_init1, recvmmsg.
231 * Implemented basic decoding of new linux syscalls: preadv, pwritev,
232 rt_tgsigqueueinfo, perf_event_open.
233 * Enhanced decoding of recently added syscalls on non-x86 architectures
234 by replacing a bare decoder with elaborate parsers enabled earlier
236 * Implemented -C option to combine regular and -c output.
237 (Addresses Debian bug #466196)
238 * Enhanced decoding of mbind and mremap syscalls.
239 * Enhanced SOL_PACKET socket options decoding.
240 * Regenerated list of ioctl names from linux 2.6.33.
241 * Added TILE architecture support.
244 * Fixed build with Linux kernel headers 2.6.32-rc5+.
245 (Addresses Debian bug #560516 and Fedora bug #539044)
246 * Fixed build on mips.
247 * Fixed handling of Linux systems without struct statfs64.
248 * Fixed reporting signal mask by sigreturn on powerpc.
249 * Fixed potential stack buffer overflow in select decoder.
250 (Addresses Fedora bug #556678)
251 * Corrected msgsnd indirect ipccall decoding.
252 * Corrected decoding of 64bit syscalls.
253 (Addresses Debian bug #570603)
254 * Corrected getsockopt decoding on architectures where
255 sizeof(long) > sizeof(int).
256 (Addresses Debian bug #494844)
257 * Corrected decoding of epoll_pwait.
258 (Addresses Debian bug #513014)
259 * Corrected handling of killed threads.
261 Noteworthy changes in release 4.5.19 (2009-10-21)
262 =================================================
264 * Changes in behavior
265 * When command exits, strace now exits with the same exit status.
266 If command is terminated by a signal, strace terminates itself
267 with the same signal, so that strace can be used as a wrapper
268 process transparent to the invoking parent process.
269 When using -p option, the exit status of strace is zero unless
270 there was an unexpected error in doing the tracing.
271 (Addresses Fedora bug #105371 and Debian bug #37665)
274 * Implemented decoding of new Linux syscalls: accept4, dup3,
275 epoll_create1, eventfd2, inotify_init1, pipe2, signalfd4.
276 * Implemented decoding of socket type flags introduced in Linux 2.6.27.
277 * Implemented decoding of accept4 socketcall.
278 * Enhanced prctl decoding.
279 * Enhanced nanosleep decoding.
280 * Enhanced ptrace decoding.
281 * Enhanced futex decoding.
282 * Enhanced CAP_* decoding.
283 * Enhanced SIOCS* ioctls decoding.
284 * Enhanced fcntl F_* flags decoding.
285 * Enhanced semop/semtimedop decoding.
286 * Updated ARM architecture support.
287 * Added Blackfin architecture support.
288 * Added AVR32 architecture support.
289 * Added CRIS architecture support.
290 * Made strace detect when traced process suddenly disappeared.
293 * Fixed syscall numbers for tee and sync_file_range.
294 (Addresses Debian bug #503124)
295 * Fixed several bugs in strings decoder, including potential heap
297 (Addresses Fedora bugs #470529, #478324 and #511035)
298 * Marked sendfile(2) as a network syscall.
299 (Addresses Debian bug #509499)
300 * Fixed accept(2) decoding.
301 (Addresses Debian bug #507573)
302 * Fixed sigtimedwait(2) decoding.
303 * Fixed build on ARM EABI.
304 (Addresses Debian bugs #520084 and #535564, and Fedora bug #507576)
305 * Fixed display of 32-bit fcntl(F_SETLK) on 64-bit architectures.
306 (Addresses Red Hat bug #471169)
307 * Fixed display of 32-bit argv array on 64-bit architectures.
308 (Addresses Fedora bug #519480)
309 * Fixed display of 32-bit struct sigaction on 64-bit architectures.
310 * Fixed HPPA architecture support.
311 (Addresses Debian bugs #437928 and #546619)
316 * Support new Linux/PPC system call subpage_prot and PROT_SAO flag.
317 * In sigaction system call, display sa_flags value along with SIG_DFL/SIG_IGN.
322 * -F is now deprecated, -f has traced vfork too on Linux for a long time now.
323 * Print O_CLOEXEC, MSG_CMSG_CLOEXEC flag bits.
324 * Improved output for prctl system call on Linux.
325 * Improved support for Linux/ARM.
326 * SA_NOMASK is now spelled SA_NODEFER, and SA_ONESHOT is spelled SA_RESETHAND.
331 * Improved output for delete_module, futex, and mbind system calls on Linux.
332 * Improved output for SG_IO ioctls on Linux.
333 * Support new Linux system calls move_pages, utimensat, signalfd, timerfd,
334 eventfd, getcpu, epoll_pwait.
339 * Several biarch improvements.
340 * Improved output for adjtimex, sysctl, quotactl, mount, umount.
341 * Support new Linux system calls *at, inotify*, pselect6, ppoll and unshare.
346 * Accept numeric system calls in -e.
351 * Introduce "-e trace=desc".
356 * Better x86-64 support for IA32 processes.
357 * Update PowerPC system calls.
358 * Better printing for Linux aio system calls.
362 * Quick fix release for build issues.
363 * One fix for Linux/ARM system call table.
368 * Print fault address for SIGSEGV/SIGBUS signals when available.
373 * Improve socket ioctl printing.
374 * Update Linux/IA64 syscall list.
375 * Fix Linux/x86-64 syscall argument extraction for 32-bit processes.
376 * Improve mount flags printing.
377 * Support symbolic printing of x86_64 arch_prctl parameters.
382 * Update syscall tables for Alpha, ARM, HPPA.
383 * Support new Linux syscalls mbind, set_mempolicy, get_mempolicy, waitid.
384 * Support Linux syscalls fadvise64, fadvise64_64, and epoll_*.
385 * Improve ioctl command name matching.
386 * Print RTC_* ioctl structure contents.
387 * Support newer RLIMIT_* values.
388 * Print struct cmsghdr details in sendmsg.
393 * Print attribute values in *xattr system calls on Linux.
394 * Include pread and pwrite calls in -e read and -e write tracing.
395 * Update SO_* and IP_* value lists and add IPV6_* values for socket options.
396 * Print clock_t values symbolically in Linux clock_* system calls.
400 * Bug fixes, Linux ioctl updates.
401 * David Miller contributed support for Linux/SPARC64.
409 * Update Linux ioctl lists.
410 * Update PF_* and AF_* value lists.
411 * The 4.5.3 -p behavior for NPTL threads applies only under -f, and got fixed.
416 * On Linux using NPTL threads, -p will now attach to all threads in a process.
417 * Handle new mq_* system calls in Linux 2.6.6 and later.
422 * Report some new VM_* bit values on Linux.
423 * Better output for Linux sched_* system calls.
428 * Display multiple ioctl name matches on Linux.
432 * New port to AMD's x86-64 architecture. One strace binary can
433 handle both new x86-64 and old i386 processes.
434 * Fixed support for LFS64 calls.
435 * New switch -E to add/remove environment variables for the command.
436 * Merged s390/s390x port.
437 * Trace an unbounded number of processes.
438 * Handle numerous new system calls in Linux 2.5, and new threads semantics.
439 * Fixed bugs with attach/detach leaving things stopped.
440 * Fixed traced process seeing ECHILD despite live, traced children
441 in waitpid calls with WNOHANG.
442 * Stuart Menefy contributed a port to Linux/SH.
443 * Stephen Thomas contributed a port to Linux/SH64.
444 * Many other bug fixes.
448 * Fix Linux/ia64 support, looks like someone renamed a few things on us
449 * Fix the ioctl setup for Linux, turned out it did not really work.
450 Improve the ioctl extracter as well so we decode some more ones.
454 * compile fixes for Linux/mips
458 * Linux ia64 and hppa ports added
459 * The usual Linux syscall updates (includes 32bit uid/gid support),
460 * Linux ioctl list updated
461 * Support IPv6 scope ids
462 * FreeBSD/i386 port added
463 * UnixWare and Solaris updates
464 * Better support for tracing multithreaded processes in Linux
468 * Compiles on glibc2.0 systems again
469 * Linux/S390 port added
470 * The usual Linux syscall updates
471 * we can follow fork on arm now
475 * Linux/MIPS port added
476 * Lots of Linux updates again
477 * Improved IPv6 support
483 * Compiles on glibc2.0 systems again
487 * Get stat structure properly on Linux 64bit archs
488 * Personalities work again
489 * Compile correctly on SunOS again
495 * Linux (ultra)sparc fixes
502 * add support for more Linux architectures (powerpc, sparc, arm)
503 * support lots more Linux syscalls
504 * fix signal handling
505 * add IPX and IPIP support
506 * check stray syscall after execv
507 * fix hanging children
509 Changes in version 3.1
510 ======================
513 * Linux 68k is supported
514 * Linux alpha is supported
515 * configure is upgraded to autoconf 2.x
516 * using -f in combination with -e now works correctly
517 * output can be piped to a program
518 * tracing setuid programs works better
519 * it is now reasonable to install strace setuid to root in some circumstances
520 * new useful tracing names like file and process to trace whole
521 classes of system calls, e.g. -efile traces all system calls that
522 take a file name as an argument
523 * IPC calls on SunOS 4.1.x are decoded
524 * Linux program memory is reliably dereferenced
525 * Linux decodes at least the name of all syscalls as of pre2.0.4
526 * various cosmetic changes and bug fixes
528 Changes from versions 2.x to version 3.0
529 ========================================
531 * filename arguments are neither abbreviated nor stringified
532 * string arguments are now true C strings using octal instead of hex by default
533 * preprocessor constants are never shortened (e.g. was RDONLY => now O_RDONLY)
534 * by default the output for multiple processes now goes into one file
535 * all structures, vectors, bitsets, etc. use consistent output formats
536 * the -c option now means count calls, -i does what the old -c used to do
538 New Features in version 3.0
539 ===========================
541 * non-ascii strings can be optionally printed entirely in hex
542 * the output format is readable when mutiple processes are generating output
543 * exit values are printed in an alignment column
544 * is is possible to suppress messages about attaching and detaching
545 * various tracing features can be enabled on a per syscall/signal/desc basis
546 * selective tracing of syscalls
547 * selective printing of syscall structures
548 * selective abbreviation of long structures on a per syscall basis
549 * selective printing of raw syscall arguments and results
550 * selective tracing of signals
551 * selective dumping of all I/O read from file descriptors
552 * selective dumping of all I/O written to file descriptors
553 * optional counting of time, calls, and errors for each syscall