blob: 8c1e2c307e3fd3b8071efc72074418bef5e19226 [file] [log] [blame]
Dmitry V. Levincbde4e22015-12-22 04:26:56 +00001Noteworthy changes in release ?.?? (????-??-??)
2===============================================
3
Dmitry V. Levin97cbf692015-12-24 16:53:07 +00004* Improvements
Dmitry V. Levinfa8c2862016-01-22 14:37:14 +00005 * Implemented simultaneous use of -p option and tracing of a command.
6 (addresses Debian bug #549942).
Dmitry V. Levin6bf08e32016-01-07 00:31:33 +00007 * Enhanced decoding of personality, sched_getaffinity,
Dmitry V. Levin67c2f672016-04-26 00:21:26 +00008 sched_setaffinity, statfs, statfs64, fstatfs, and fstatfs64 syscalls.
Dmitry V. Levin2720a612016-01-09 00:06:06 +00009 * Enhanced decoding of getxpid, getxuid, and getxgid syscalls on alpha.
Dmitry V. Levinb1110542016-01-09 21:50:30 +000010 * Added decoding of bind, listen, and setsockopt direct syscalls on sparc.
Dmitry V. Levin3c17d1b2016-02-01 23:14:59 +000011 * Implemented caching of netlink conversations to reduce amount of time
12 spent in decoding socket details in -yy mode.
Dmitry V. Levina6dd0942016-05-11 00:42:10 +000013 * Implemented decoding of copy_file_range, preadv2, and pwritev2 syscalls.
14 * Implemented dumping of preadv, preadv2, pwritev, pwritev2, and vmsplice
15 syscalls.
Dmitry V. Levin91647222016-05-17 16:19:48 +000016 * Updated lists of ioctl commands from Linux 4.6.
Dmitry V. Levin97cbf692015-12-24 16:53:07 +000017
Dmitry V. Levindd1a80c2015-12-24 15:40:55 +000018* Bug fixes
19 * Fixed build on arc, metag, nios2, or1k, and tile architectures.
Dmitry V. Levinbe1cb922016-01-07 14:20:17 +000020 * Fixed decoding of 32-bit times syscall return value on 64-bit architectures.
Dmitry V. Levinb1110542016-01-09 21:50:30 +000021 * Fixed decoding of mlock2 syscall on sparc.
Dmitry V. Levin1763fa52016-01-13 20:53:41 +000022 * Fixed decoding of syscalls unknown to the kernel on s390/s390x.
23 (addresses Debian bug #485979 and Fedora bug #1298294).
Dmitry V. Levinc98ab882016-03-30 18:04:00 +000024 * Fixed decoding of preadv syscall in case of short read.
Dmitry V. Levin05a0af62016-01-20 00:17:02 +000025 * Fixed decoding and dumping of readv syscall in case of short read.
Dmitry V. Levind44707d2016-01-20 04:56:25 +000026 * Fixed dumping of recvmsg and recvmmsg syscalls in case of short read.
Dmitry V. Levindfea1da2016-01-29 01:51:54 +000027 * Fixed decoding of mincore syscall's last argument.
Dmitry V. Levin4ab20402016-02-12 19:50:38 +000028 * Fixed remaining errors in mapping between syscall numbers and numbers
29 of syscall arguments.
Dmitry V. Levindd1a80c2015-12-24 15:40:55 +000030
Dmitry V. Levin2acb0652015-12-21 20:21:22 +000031Noteworthy changes in release 4.11 (2015-12-21)
Dmitry V. Levin91bdbb42015-03-09 22:05:40 +000032===============================================
33
Dmitry V. Levin7405b122015-12-19 20:57:30 +000034* Changes in behavior
35 * Some syscalls have different names depending on architecture and
36 personality. In these cases, syscall filtering and printing now
37 consistently uses the names that match corresponding __NR_* kernel
38 macros of the tracee's architecture and personality.
39 * Added strace prefix to all diagnostic messages.
40
41* Improvements
42 * Enhanced and extended test suite.
43 * Implemented reliable tracing of processes whose personality differs
44 from the personality of strace, fixed decoding of 32-bit personality
45 syscalls on 64-bit architectures.
46 * When some data referenced by syscall arguments is irrelevant or cannot
47 be read from tracee's memory, strace now prints its address consistently.
48 * When a syscall is restarted using restart_syscall mechanism, strace now
49 shows the syscall name on architectures that expose this information.
50 * Print values returned by epoll_create1, eventfd, eventfd2, fanotify_init,
51 inotify_init1, perf_event_open, pipe, pipe2, signalfd, signalfd4, socket,
52 socketpair, timerfd, and timerfd_create syscalls, as well as F_DUPFD and
53 F_DUPFD_CLOEXEC fcntl commands, as file descriptors.
54 * Optimized decoding of indirect socket syscalls.
55 * Implemented decoding of nanoseconds along with seconds in stat family
56 syscalls (addresses Fedora bug #1251176).
57 * Implemented decoding of struct statfs.f_flags in statfs syscall.
58 * Implemented decoding of siginfo_t.si_syscall and siginfo_t.si_arch
59 in SIGSYS signal.
60 * Implemented decoding of indirect syscall on mips o32.
61 * Implemented decoding of IPPROTO_IP control messages.
62 * Implemented decoding of setsockopt syscall multicast arguments.
63 * Enhanced decoding of struct sigevent.
64 * Enhanced decoding of block, loop, mtd, ptp, rtc, SG_IO, socket, tty,
65 and v4l2 ioctl syscall arguments.
66 * Enhanced decoding of epoll_create, fcntl, fcntl64, futex, getdents,
67 getdents64, getsockopt, io_*, mount, msgctl, prctl, quotactl, recvfrom,
68 sendfile, setsockopt, and shmctl syscalls.
69 * Implemented decoding of bpf, execveat, ioperm, iopl, kcmp, kexec_file_load,
70 lookup_dcookie, membarrier, memfd_create, mlock2, name_to_handle_at,
71 open_by_handle_at, sched_getattr, sched_setattr, and userfaultfd syscalls.
72 * Updated lists of AF_*, EPOLL_*, FALLOC_FL_*, F_*, INPUT_PROP_*, IPPROTO_*,
73 IPV6_*, IP_*, KEY_*, LOCK_*, MNT_*, MS_*, PACKET_*, PERF_FLAG_*, PF_*,
74 PR_*, PTRACE_O_*, RENAME_*, SCTP_*, SECBIT_*, SO_*, TCP_*, and siginfo_t
75 constants.
76 * Added Nios II architecture support.
77 * Added new syscall entries to match Linux 4.4.
78
79* Bug fixes
80 * Fixed potential short read of strings from tracee's memory.
81 * Fixed -qq option in conjunction with -o option.
82 * Fixed filtering of <unavailable> syscalls.
83 * Fixed decoding of ioctl syscall command on aarch64 and 32-bit architectures
84 with 64-bit aligned structures.
85 * Fixed decoding of eventfd2, epoll_create1, signalfd4, and sync_file_range2
86 syscall flags arguments.
87 * Fixed decoding of 4th argument of clock_nanosleep syscall.
88 * Fixed decoding of getpagesize syscall on m68k.
89 * Fixed decoding of getrandom and seccomp syscalls on aarch64.
90 * Fixed decoding of timezone argument of gettimeofday and settimeofday
91 * syscalls.
92 * Fixed decoding of offset argument of mmap2 syscall on arm, sparc,
93 and sparc64.
94 * Fixed decoding of pipe syscall on alpha and mips.
95 * Fixed decoding of pipe2 syscall on ia64, sh, sparc, and sparc64.
96 * Fixed decoding of signal mask argument of pselect6 syscall on x32.
97 * Fixed decoding of signal mask of rt_sigreturn syscall on aarch64, m68k,
98 and x32.
99 * Fixed decoding of 4th argument of semctl indirect syscall.
100 * Fixed decoding of sa_restorer and sa_mask of sigaction syscall on m68k.
101 * Fixed decoding of statfs64 and fstatfs64 syscalls on arm eabi.
102 * Fixed decoding of struct dirent on x32.
103 * Fixed decoding of times syscall return value on mips n32 and x32.
104 * Fixed decoding of path argument of umount2 syscall
105 (addresses Debian bug #785050).
106 * Worked around a kernel bug in tracing privileged executables.
107 * Fixed various errors in mapping between syscall numbers and associated
108 information like the number of syscall arguments, the name of syscall,
109 and syscall decoder.
110
Dmitry V. Levindfabccf2015-03-06 13:14:15 +0000111Noteworthy changes in release 4.10 (2015-03-06)
112===============================================
Dmitry V. Levine277a902014-08-19 11:34:44 +0000113
Dmitry V. Levina671a2c2015-02-23 20:24:00 +0000114* Improvements
115 * Added -yy option to print protocol and address information associated with
116 socket descriptors.
117 * Extended "-e read=set" and "-e write=set" options to cover sendmsg,
118 recvmsg, sendmmsg, and recvmmsg syscalls.
119 * Implemented full 32-bit decoding of ioctl commands
Dmitry V. Levindfabccf2015-03-06 13:14:15 +0000120 (addresses Debian bug #692913 and Fedora bug #902788).
121 * Implemented PTRACE_GETREGS API support on ia64.
122 * Implemented PTRACE_GETREGS API support on mips.
123 * Implemented PTRACE_GETREGSET API support on s390/s390x.
Dmitry V. Levina671a2c2015-02-23 20:24:00 +0000124 * Implemented decoding of getrandom and seccomp syscalls.
125 * Implemented full decoding of 64-bit capability sets.
126 * Implemented decoding of all prctl commands.
127 * Implemented decoding of parametrized ioctl commands.
128 * Implemented decoding of evdev ioctl commands.
129 * Implemented decoding of v4l ioctl commands.
130 * Implemented decoding of SG_IO v4 ioctl commands.
131 * Implemented decoding of FIFREEZE/FITHAW/FITRIM ioctl commands.
132 * Implemented decoding of FALLOC_FL_* fallocate flags.
Dmitry V. Levindfabccf2015-03-06 13:14:15 +0000133 * Implemented decoding of rt_sigreturn signal mask on aarch64,
134 x32, and x86_64.
Dmitry V. Levina671a2c2015-02-23 20:24:00 +0000135 * Enhanced socket decoder to support bluetooth sockets.
136 * Enhanced decoding of unlisted ioctl commands.
137 * Enhanced decoding of getsockopt and setsockopt syscall.
138 * Enhanced decoding of sysinfo syscall.
139 * Enhanced decoding of struct cmsghdr.
140 * Enhanced decoding of wait status.
141 * Enhanced aio support on non-x86 architectures by using external libaio.h.
142 * Added O_TMPFILE to the list of recognized open mode flags.
143 * Updated the list of filesystem type constants that is used in decoding
144 statfs family syscalls.
145 * Updated lists of CAP_*, PR_*, PTRACE_*, SCHED_*, SO_*, SOL_*, SWAP_FLAG_*,
146 and TFD_* constants.
147 * Updated lists of signal constants from Linux 3.19.
148 * Updated lists of errno constants from Linux 3.19.
149 * Updated lists of ioctl commands from Linux 3.9.
150 * Added new syscall entries to match Linux 3.19.
151
152* Bug fixes
153 * Fixed various errors in mapping between syscall numbers and associated
154 information like the number of syscall arguments, the name of syscall,
155 and syscall decoder.
156 * Fixed quoting issues in printing descriptors, filenames, network interface
157 names, struct utsname members, device/volume names of BLK* ioctl commands.
158 * Fixed uid_t/git_t decoding.
159 * Fixed potential out-of-bounds read issues in getdents/getdents64 decoders.
160 * Fixed potential open flags truncation on some architectures.
161 * Fixed decoding of struct ifreq.ifr_name.
162 * Fixed decoding of SIOCSIFNAME ioctl command.
163 * Fixed decoding of RENAME_* renameat2 flags.
164 * Fixed decoding of UTIME_NOW/UTIME_OMIT timeval structures.
165 * Fixed decoding of indirect ipc subcalls on some architectures.
166 * Fixed decoding of fanotify_mark syscall on 32-bit architectures.
167 * Fixed decoding of 32-bit stat structures on 64-bit architectures.
168 * Fixed decoding of 32-bit struct cmsghdr on 64-bit architectures.
169 * Fixed decoding of 32-bit preadv/pwritev offset on 64-bit architectures.
Dmitry V. Levindfabccf2015-03-06 13:14:15 +0000170 * Fixed decoding of sigreturn/rt_sigreturn signal mask on ia64, ppc, ppc64,
171 sparc, sparc64, mips, and s390.
Dmitry V. Levina671a2c2015-02-23 20:24:00 +0000172 * Fixed instruction pointer output (-i option) on architectures that support
173 several personalities.
174 * Fixed behaviour of "-e read=set" and "-e write=set" when read and write
175 sets intersect.
176 * Fixed build on systems where struct sigaction has no sa_restorer member.
177 * Fixed build with uclibc and musl libc.
178
179* Portability
180 * Linux kernel >= 2.5.46 is required.
181 Older versions without a decent PTRACE_SETOPTIONS support will not work.
Dmitry V. Levindfabccf2015-03-06 13:14:15 +0000182 * On mips, linux kernel >= 2.6.15 is required.
183 Older versions without a decent PTRACE_GETREGS support will not work.
184 * On s390 and s390x, linux kernel >= 2.6.27 is required.
185 Older versions without a decent PTRACE_GETREGSET support will not work.
Dmitry V. Levina671a2c2015-02-23 20:24:00 +0000186
Dmitry V. Levine4db4c42014-08-15 13:14:15 +0000187Noteworthy changes in release 4.9 (2014-08-15)
Dmitry V. Levin02d2c702013-06-05 21:33:45 +0000188==============================================
189
Dmitry V. Levin327102c2014-06-03 13:31:37 +0000190* Changes in behavior
191 * Disabled OABI support on ARM EABI systems by default,
192 added --enable-arm-oabi option to enable it at configure time.
193
Mark Hillse53bf232014-05-28 17:52:40 +0100194* Improvements
Dmitry V. Levin2734a702014-06-18 15:34:27 +0000195 * Added experimental -k option to print stack trace after each traced syscall.
Dmitry V. Levin327102c2014-06-03 13:31:37 +0000196 * Added -w option to produce stats on syscall latency.
197 (addresses Debian bug #457497).
198 * Added ARC architecture support.
199 * Added PTRACE_GETREGS API support on PowerPC.
200 * Enhanced Bionic libc and musl libc support.
201 * Enhanced tracing of x86 personality processes on x86_64 and x32.
202 * Enhanced tracing of ARM personality processes on AArch64.
203 * Enhanced 32/64bit personality detection on PowerPC.
Dmitry V. Levin6d32e462014-08-15 00:36:36 +0000204 * Implemented decoding of add_key, ioprio_get, ioprio_set, kexec_load, keyctl,
205 renameat2, and request_key syscalls.
Dmitry V. Levin327102c2014-06-03 13:31:37 +0000206 * Robustified decoding of select, pselect, and io_submit syscalls.
Dmitry V. Levin6d32e462014-08-15 00:36:36 +0000207 * Enhanced decoding of delete_module, fanotify_init, fanotify_mark, fcntl,
208 setdomainname, sethostname, setns, and sync_file_range syscalls.
Dmitry V. Levin327102c2014-06-03 13:31:37 +0000209 * Enhanced decoding of signal bitmasks.
210 * Enhanced decoding of file descriptors.
211 * Enhanced siginfo_t decoding.
212 * Enhanced PF_NETLINK decoding.
213 * Updated CLOCK_* constants
214 (addresses Fedora bug #1088455).
Dmitry V. Levin6d32e462014-08-15 00:36:36 +0000215 * Added new syscall entries to match Linux 3.16.
Dmitry V. Levin327102c2014-06-03 13:31:37 +0000216
217* Bug fixes
218 * Added shmat and shmdt to the set of memory mapping related syscalls.
219 * Fixed detaching from stopped processes.
220 * Fixed fanotify_mark decoding on 32bit architectures.
221 * Fixed offset decoding in preadv and pwritev syscalls.
222 * Fixed select decoding for glibc in _FORTIFY_SOURCE mode.
223 * Fixed decoding of epoll_ctl syscall with EPOLL_CTL_DEL argument.
224 * Fixed build when <sys/ptrace.h> and <linux/ptrace.h> conflict
225 (addresses Fedora bug #993384).
226 * Miscellaneous corrections in the manual page.
227 (Addresses Debian bug #725987).
Mark Hillse53bf232014-05-28 17:52:40 +0100228
Dmitry V. Levind8454112013-06-03 12:34:56 +0000229Noteworthy changes in release 4.8 (2013-06-03)
Dmitry V. Levindce75932013-04-30 23:52:12 +0000230==============================================
Dmitry V. Levin503faaa2012-05-02 23:00:34 +0000231
Dmitry V. Levind8454112013-06-03 12:34:56 +0000232* Changes in behavior
233 * In case of normal strace termination, when the trace output is
234 redirected to a pipe, strace now closes it and waits for the pipe
235 process termination before exit.
236
237* Improvements
238 * Implemented tracing using PTRACE_SEIZE API (when available).
239 * Implemented more reliable PTRACE_GETREGSET-based process personality
240 detection on x86-64 and x32 (when available).
241 * Added -e trace=memory option for tracing memory mapping related syscalls.
242 * Documented -b option.
243 * Allowed exit status messages to be suppressed by giving -q option twice.
244 * Added AArch64 architecture support
245 (addresses Debian bug #693074 and Fedora bug #969858).
246 * Added support for OpenRISC 1000, Meta, and Xtensa architectures.
247 * Added tilegx personality support for Tile.
248 * Enhanced support of NOMMU architectures.
249 * Enhanced decoding of getdents, mmap, perf_event_open, ptrace, and
250 quotactl syscalls.
251 * Added new syscall entries to match Linux 3.9.
Dmitry V. Levin1cd3f5f2013-06-03 16:24:53 +0000252 * Regenerated the list of common ioctl names from Linux 3.9.
Dmitry V. Levind8454112013-06-03 12:34:56 +0000253 * Updated the list of errno constants.
254 * Updated lists of AF_*, MADV_*, MAP_*, MSG_*, MS_*, PF_*, PR_*,
255 PTRACE_O_*, and TCP_* constants.
256 * Implemented decoding of UBI ioctls.
257 * Removed redundant "*32" ioctl names.
258
259* Bug fixes
260 * Fixed ERESTARTNOINTR leaking to userspace on ancient kernels
261 (addresses Fedora bug #659382).
262 * Fixed kernel release string parsing
263 (addresses Debian bug #702309).
264 * Fixed decoding of *xattr syscalls
265 (addresses Fedora bug #885233).
266 * Fixed handling of files with 64-bit inode numbers by 32-bit strace
267 (addresses Fedora bug #912790).
268 * Fixed tracing forks on SPARC.
269 * Fixed decoding of fadvise64, fallocate, ftruncate64, io_submit, pread,
270 preadv, pwrite, pwritev, readahead, sigaltstack, sync_file_range, sysctl,
271 and truncate64 syscalls.
272 * Fixed categories of multiple syscalls on most of supported architectures.
273 * Fixed decoding of non-native 32-bit personality recv[m]msg syscalls.
274 * Fixed decoding of multiple 32-bit personality syscalls on x32.
275 * Fixed decoding of long long syscall arguments on ARM, MIPS/o32, PowerPC,
276 S390x, and Tile architectures.
277 * Fixed semtimedop decoding on S390x.
278 * Fixed sram_alloc decoding on Blackfin.
279 * Fixed build when process_vm_readv is a stab.
280 * Fixed build with older versions of libaio.h.
281
Dmitry V. Levindce75932013-04-30 23:52:12 +0000282Noteworthy changes in release 4.7 (2012-05-02)
283==============================================
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000284
285* Changes in behavior
286 * strace no longer suspends waitpid until there is a child
287 for waitpid'ing process to collect status from.
288 * strace no longer detaches from a tracee which is supposed
289 to be going to die.
290 * strace now issues a new message: "+++ exited with EXITCODE +++"
291 which shows exact moment strace got exit notification,
292 analogous to existing "+++ killed by SIG +++" message.
293
294* Improvements
Mike Frysinger9b4fca22012-04-27 19:13:55 -0400295 * Added x32 personality support (x86_64 architecture).
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000296 * Added -y and -P options to print file descriptor paths and
297 filter by those paths.
298 * Added -I option to control strace interactivity.
299 * Allowed -p option to take comma or whitespace-separated list of PIDs.
300 * Added strace_log_merge script helper to merge timestamped "strace -ff"
301 log files.
302 * Implemented decoding of clock_adjtime, get_robust_list, migrate_pages,
303 preadv, prlimit64, process_vm_readv, process_vm_writev, pwritev,
Dmitry V. Levin4ef30632012-05-01 21:04:18 +0000304 recvmmsg, recvmsg, rt_tgsigqueueinfo, sendmmsg, setns, set_robust_list,
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000305 sched_rr_get_interval, splice, syslog, tee and vmsplice syscalls.
306 * Enhanced decoding of capget, capset, getrlimit, flistxattr, io_submit,
307 listxattr, setrlimit and swapon syscalls.
308 * Implemented decoding of loop and mtd ioctls.
309 * Added syscall entries for new linux syscalls.
310 * Added syscall entries for direct socket system calls on powerpc.
311 * Updated the list of errno constants.
Dmitry V. Levina28fbfd2012-05-01 21:17:51 +0000312 * Updated lists of MSG_*, STA_*, and TCP_* constants.
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000313 * Regenerated the list of ioctl names from Linux 3.3.
314 * Enhanced switching between processes with different personalities.
315 * Enhanced signals reporting by using short signal names.
316 * Made ERESTART* messages more descriptive.
317 * Made parsing of numbers from strings more robust.
318 * Added support for compat_statfs64 and statfs64.f_flags.
319 * Changed read of data blocks to use single process_vm_readv syscall
320 (when available) instead of several PTRACE_PEEKDATA operations.
321 * Changed read of registers on x86 and x86-64 to use single PTRACE_GETREGS
322 operation instead of several PTRACE_PEEKUSER operations.
323 * Applied various optimizations to make strace work faster.
324
325* Bug fixes
326 * Implemented proper handling of real SIGTRAPs on kernels supporting
327 PTRACE_O_TRACESYSGOOD.
328 (Addresses Fedora bug #162774).
329 * Fixed sockaddr_un.sun_path name in decoded output.
330 (Addresses Debian bug #554946).
331 * Fixed to avoid potential core file clobbering on exit.
332 (Addresses Debian bug #656398).
333 * Fixed a typo in documentation.
334 (Addresses Debian bug #653309).
335 * Fixed decoding of timer id returned by timer_create.
336 * Fixed epoll_create1, epoll_wait and epoll_pwait decoding.
337 * Fixed *at syscalls flags decoding.
338 * Fixed ARM EABI 64-bit syscall's arguments decoding.
339 * Fixed semtimedop decoding on s390.
340 * Fixed osf_sigprocmask decoding on alpha.
341 * Fixed ipc and socket subcall decoding on several architectures.
342 * Corrected syscall entries for epoll_pwait, epoll_create, epoll_ctl,
343 epoll_wait, mincore, mlockall, prctl, reboot, sendfile, sendfile64,
344 sendmsg, sgetmask, ssetmask, swapon, tgkill and tkill syscalls.
Mike Frysinger9b4fca22012-04-27 19:13:55 -0400345 * Corrected io_* syscall entries on ARM.
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000346 * Fixed PID prefix printing in "strace -oLOG -ff -p1 -p2 -p3" case.
347 * Fixed logging of unfinished lines in "strace -oLOG -ff" case.
348 * Fixed build when libaio-devel is not available.
349 * Fixed configure checks for PTRACE_* constants.
350 * Fixed compilation warnings remained on several architectures.
351
352* Portability
353 * Removed all non-Linux code. After years of neglect, that dead code
354 just hampered further strace development.
Dmitry V. Levin4ef30632012-05-01 21:04:18 +0000355 * Linux kernel >= 2.6.18 is recommended. Older versions might still
356 work but they haven't been thoroughly tested with this release.
Dmitry V. Levin84e50fc2012-04-20 17:32:50 +0000357
Dmitry V. Levindce75932013-04-30 23:52:12 +0000358Noteworthy changes in release 4.6 (2011-03-15)
359==============================================
Dmitry V. Levin50e69cb2011-02-21 22:58:59 +0000360
361* Changes in behavior
362 * Print diagnostic information about changes in personality mode to
363 standard error instead of standard output.
364
365* Improvements
366 * Implemented a new method of following clone, fork, and vfork
367 syscalls using the Linux kernel's explicit facilities for tracing
368 creation of threads and child processes.
369 * Implemented CLONE_PARENT and CLONE_UNTRACED flags handling.
370 * Implemented decoding of TLS syscalls on m68k.
371 * Implemented biarch support on powerpc64.
372 * Implemented biarch support for getrlimit() and setrlimit().
373 * Implemented decoding of struct ucred in getsockopt SO_PEERCRED.
374 * Implemented SOL_SCTP socket options decoding.
375 * Added HDIO_* ioctl names.
376 (Addresses Debian bug #450953).
377 * Added LOOP_* ioctl names.
378 * Updated lists of CLOCK_*, CLONE_*, MS_*, and SOL_* constants
379 to match Linux 2.6.37.
380 * Updated the list of IPPROTO_* constants to match netinet/in.h.
381 * Implemented decoding of HDIO_* and BLK* ioctls.
382 * Added MicroBlaze architecture support.
383 * Added new syscall entries to match Linux 2.6.37.
384 * Regenerated list of ioctl names from Linux 2.6.37.
385 * Enhanced signal notification decoding.
386 * Documented -C and -D options.
387
388* Bug fixes
389 * Fixed fetching syscall arguments on m68k.
390 * Fixed an error when judging whether a process has children.
391 * Fixed get/set_robust_list syscall numbers for powerpc.
392 * Fixed a corner case in printing clone flags.
393 * Fixed cross-compiling issues.
394 * Fixed build issues on powerpc64, SH and SPARC.
395 * Fixed syscall flags of fstatat*, mmap, mmap2, fadvise64*, swapoff,
396 fgetxattr, flistxattr, fremovexattr, epoll_create, fallocate,
397 fanotify_init, and fanotify_mark syscalls.
398 * Fixed decoding of get[ug]id, gete[ug]id and setfs[ug]id return values.
399 * Fixed biarch support in IO dumping.
400 * Fixed raw exit_group decoding.
401 * Fixed decoding of file descriptors on 64-bit architectures.
402 * Fixed a corner case in waitpid handling.
403 (Addresses Red Hat bug #663547).
404 * Fixed stat64 decoding on mips
405 (Addresses Debian bug #599028).
406 * Fixed misleading italics in the manual page.
407 (Addresses Debian bug #589323).
408
Dmitry V. Levindce75932013-04-30 23:52:12 +0000409Noteworthy changes in release 4.5.20 (2010-04-13)
410=================================================
Dmitry V. Levinacbe5182010-04-06 23:46:43 +0000411
412* Improvements
413 * Implemented decoding of new linux syscalls: inotify_init1, recvmmsg.
414 * Implemented basic decoding of new linux syscalls: preadv, pwritev,
415 rt_tgsigqueueinfo, perf_event_open.
416 * Enhanced decoding of recently added syscalls on non-x86 architectures
417 by replacing a bare decoder with elaborate parsers enabled earlier
418 for x86/x86-64.
419 * Implemented -C option to combine regular and -c output.
420 (Addresses Debian bug #466196)
421 * Enhanced decoding of mbind and mremap syscalls.
422 * Enhanced SOL_PACKET socket options decoding.
423 * Regenerated list of ioctl names from linux 2.6.33.
424 * Added TILE architecture support.
425
426* Bug fixes
427 * Fixed build with Linux kernel headers 2.6.32-rc5+.
428 (Addresses Debian bug #560516 and Fedora bug #539044)
429 * Fixed build on mips.
430 * Fixed handling of Linux systems without struct statfs64.
431 * Fixed reporting signal mask by sigreturn on powerpc.
432 * Fixed potential stack buffer overflow in select decoder.
433 (Addresses Fedora bug #556678)
434 * Corrected msgsnd indirect ipccall decoding.
435 * Corrected decoding of 64bit syscalls.
436 (Addresses Debian bug #570603)
437 * Corrected getsockopt decoding on architectures where
438 sizeof(long) > sizeof(int).
439 (Addresses Debian bug #494844)
440 * Corrected decoding of epoll_pwait.
441 (Addresses Debian bug #513014)
442 * Corrected handling of killed threads.
443
Dmitry V. Levindce75932013-04-30 23:52:12 +0000444Noteworthy changes in release 4.5.19 (2009-10-21)
445=================================================
Dmitry V. Levinfbfed222009-09-14 16:34:34 +0000446
447* Changes in behavior
448 * When command exits, strace now exits with the same exit status.
449 If command is terminated by a signal, strace terminates itself
450 with the same signal, so that strace can be used as a wrapper
451 process transparent to the invoking parent process.
452 When using -p option, the exit status of strace is zero unless
453 there was an unexpected error in doing the tracing.
454 (Addresses Fedora bug #105371 and Debian bug #37665)
455
456* Improvements
457 * Implemented decoding of new Linux syscalls: accept4, dup3,
458 epoll_create1, eventfd2, inotify_init1, pipe2, signalfd4.
459 * Implemented decoding of socket type flags introduced in Linux 2.6.27.
460 * Implemented decoding of accept4 socketcall.
461 * Enhanced prctl decoding.
462 * Enhanced nanosleep decoding.
463 * Enhanced ptrace decoding.
464 * Enhanced futex decoding.
465 * Enhanced CAP_* decoding.
466 * Enhanced SIOCS* ioctls decoding.
467 * Enhanced fcntl F_* flags decoding.
Dmitry V. Levind7bb8b42009-10-08 22:28:57 +0000468 * Enhanced semop/semtimedop decoding.
Dmitry V. Levinfbfed222009-09-14 16:34:34 +0000469 * Updated ARM architecture support.
470 * Added Blackfin architecture support.
471 * Added AVR32 architecture support.
472 * Added CRIS architecture support.
473 * Made strace detect when traced process suddenly disappeared.
474
475* Bug fixes
476 * Fixed syscall numbers for tee and sync_file_range.
477 (Addresses Debian bug #503124)
478 * Fixed several bugs in strings decoder, including potential heap
479 memory corruption.
480 (Addresses Fedora bugs #470529, #478324 and #511035)
481 * Marked sendfile(2) as a network syscall.
482 (Addresses Debian bug #509499)
483 * Fixed accept(2) decoding.
Dmitry V. Levinacbe5182010-04-06 23:46:43 +0000484 (Addresses Debian bug #507573)
Dmitry V. Levinfbfed222009-09-14 16:34:34 +0000485 * Fixed sigtimedwait(2) decoding.
486 * Fixed build on ARM EABI.
487 (Addresses Debian bugs #520084 and #535564, and Fedora bug #507576)
488 * Fixed display of 32-bit fcntl(F_SETLK) on 64-bit architectures.
489 (Addresses Red Hat bug #471169)
490 * Fixed display of 32-bit argv array on 64-bit architectures.
491 (Addresses Fedora bug #519480)
492 * Fixed display of 32-bit struct sigaction on 64-bit architectures.
Dmitry V. Levin84c693e2009-10-06 10:40:17 +0000493 * Fixed HPPA architecture support.
494 (Addresses Debian bugs #437928 and #546619)
Dmitry V. Levinfbfed222009-09-14 16:34:34 +0000495
Roland McGrath09db7052008-08-28 22:00:46 +0000496Changes in 4.5.18
497==============
498* Bug fixes.
499* Support new Linux/PPC system call subpage_prot and PROT_SAO flag.
500* In sigaction system call, display sa_flags value along with SIG_DFL/SIG_IGN.
501
Roland McGrath55dd2782008-07-18 02:21:11 +0000502Changes in 4.5.17
503==============
504* Many bug fixes.
505* -F is now deprecated, -f has traced vfork too on Linux for a long time now.
506* Print O_CLOEXEC, MSG_CMSG_CLOEXEC flag bits.
507* Improved output for prctl system call on Linux.
508* Improved support for Linux/ARM.
509* SA_NOMASK is now spelled SA_NODEFER, and SA_ONESHOT is spelled SA_RESETHAND.
510
Roland McGrath47d32232007-08-03 10:28:55 +0000511Changes in 4.5.16
512==============
513* Bug fixes.
514* Improved output for delete_module, futex, and mbind system calls on Linux.
515* Improved output for SG_IO ioctls on Linux.
516* Support new Linux system calls move_pages, utimensat, signalfd, timerfd,
517 eventfd, getcpu, epoll_pwait.
518
Roland McGrath16a3a522007-01-11 22:22:42 +0000519Changes in 4.5.15
520==============
521* Bug fixes.
522* Several biarch improvements.
Roland McGrath0a45fae2007-01-16 23:25:34 +0000523* Improved output for adjtimex, sysctl, quotactl, mount, umount.
Roland McGrath16a3a522007-01-11 22:22:42 +0000524* Support new Linux system calls *at, inotify*, pselect6, ppoll and unshare.
525
Roland McGrathf4d9b492006-01-17 06:22:57 +0000526Changes in 4.5.14
527==============
528* Bug fixes.
529* Accept numeric system calls in -e.
530
Roland McGrathcab43802005-08-03 11:42:35 +0000531Changes in 4.5.13
532==============
533* Bug fixes.
534* Introduce "-e trace=desc".
535
Roland McGrath182cbf42005-06-10 03:56:16 +0000536Changes in 4.5.12
537==============
538* Bug fixes.
539* Better x86-64 support for IA32 processes.
540* Update PowerPC system calls.
541* Better printing for Linux aio system calls.
542
Roland McGrath7147a3d2005-03-22 23:12:39 +0000543Changes in 4.5.11
544==============
545* Quick fix release for build issues.
546* One fix for Linux/ARM system call table.
547
Roland McGrathd8184032005-03-15 02:40:12 +0000548Changes in 4.5.10
549==============
550* Bug fixes.
551* Print fault address for SIGSEGV/SIGBUS signals when available.
552
Roland McGrathd63311a2005-02-04 09:29:04 +0000553Changes in 4.5.9
554==============
555* Bug fixes.
556* Improve socket ioctl printing.
557* Update Linux/IA64 syscall list.
558* Fix Linux/x86-64 syscall argument extraction for 32-bit processes.
559* Improve mount flags printing.
560* Support symbolic printing of x86_64 arch_prctl parameters.
561
Roland McGrathf041d472004-10-20 02:17:52 +0000562Changes in 4.5.8
563==============
564* Bug fixes.
565* Update syscall tables for Alpha, ARM, HPPA.
566* Support new Linux syscalls mbind, set_mempolicy, get_mempolicy, waitid.
567* Support Linux syscalls fadvise64, fadvise64_64, and epoll_*.
568* Improve ioctl command name matching.
569* Print RTC_* ioctl structure contents.
570* Support newer RLIMIT_* values.
571* Print struct cmsghdr details in sendmsg.
572
Roland McGrathb93f9182004-08-31 08:17:20 +0000573Changes in 4.5.7
574==============
575* Bug fixes.
576* Print attribute values in *xattr system calls on Linux.
577* Include pread and pwrite calls in -e read and -e write tracing.
578* Update SO_* and IP_* value lists and add IPV6_* values for socket options.
579* Print clock_t values symbolically in Linux clock_* system calls.
580
Roland McGrath785a0262004-07-12 07:55:48 +0000581Changes in 4.5.6
582==============
583* Bug fixes, Linux ioctl updates.
584* David Miller contributed support for Linux/SPARC64.
585
Roland McGrathb7e2ca12004-06-28 05:24:29 +0000586Changes in 4.5.5
587==============
588* Just bug fixes.
589
Roland McGrathed8e77e2004-06-04 02:35:58 +0000590Changes in 4.5.4
591==============
592* Update Linux ioctl lists.
593* Update PF_* and AF_* value lists.
594* The 4.5.3 -p behavior for NPTL threads applies only under -f, and got fixed.
595
Roland McGrath62412202004-04-09 00:25:38 +0000596Changes in 4.5.3
597==============
598* Bug fixes.
599* On Linux using NPTL threads, -p will now attach to all threads in a process.
Roland McGrath5e169a12004-04-16 21:54:56 +0000600* Handle new mq_* system calls in Linux 2.6.6 and later.
Roland McGrath62412202004-04-09 00:25:38 +0000601
Roland McGrathb66e9362004-03-02 06:38:35 +0000602Changes in 4.5.2
603==============
604* Bug fixes.
605* Report some new VM_* bit values on Linux.
606* Better output for Linux sched_* system calls.
607
Roland McGrath00eb84e2003-11-14 02:57:22 +0000608Changes in 4.5.1
609==============
610* Bug fixes.
611* Display multiple ioctl name matches on Linux.
612
Roland McGratha3bc12e2003-09-24 22:22:38 +0000613Changes in 4.5
Michal Ludvig53b320f2002-09-23 13:30:09 +0000614==============
Roland McGrathf57204d2002-12-18 04:36:59 +0000615* New port to AMD's x86-64 architecture. One strace binary can
Michal Ludvig53b320f2002-09-23 13:30:09 +0000616 handle both new x86-64 and old i386 processes.
617* Fixed support for LFS64 calls.
Roland McGrathde6e5332003-01-24 04:31:23 +0000618* New switch -E to add/remove environment variables for the command.
Michal Ludvig81a3a9a2002-11-06 13:19:15 +0000619* Merged s390/s390x port.
Roland McGrathf57204d2002-12-18 04:36:59 +0000620* Trace an unbounded number of processes.
Roland McGrath5694e802003-01-09 06:56:39 +0000621* Handle numerous new system calls in Linux 2.5, and new threads semantics.
Roland McGrathf57204d2002-12-18 04:36:59 +0000622* Fixed bugs with attach/detach leaving things stopped.
Roland McGrath044c8d22002-12-22 03:36:03 +0000623* Fixed traced process seeing ECHILD despite live, traced children
624 in waitpid calls with WNOHANG.
Roland McGrath1b86e2d2003-03-31 01:21:36 +0000625* Stuart Menefy contributed a port to Linux/SH.
Roland McGrathcb612142003-07-17 09:23:56 +0000626* Stephen Thomas contributed a port to Linux/SH64.
Roland McGrathacd3cd72003-06-11 05:37:56 +0000627* Many other bug fixes.
Michal Ludvig53b320f2002-09-23 13:30:09 +0000628
Wichert Akkermand22c4a12001-08-19 11:57:48 +0000629Changes in 4.4
630==============
631* Fix Linux/ia64 support, looks like someone renamed a few things on us
632* Fix the ioctl setup for Linux, turned out it did not really work.
633 Improve the ioctl extracter as well so we decode some more ones.
634
Wichert Akkermane70bbe52001-04-07 21:47:30 +0000635Changes in 4.3.1
636================
637* compile fixes for Linux/mips
638
Wichert Akkerman12f75d12000-02-14 16:23:40 +0000639Changes in 4.3
640==============
Wichert Akkermanb07296a2001-04-01 14:05:04 +0000641* Linux ia64 and hppa ports added
Wichert Akkerman7987cdf2000-07-05 16:05:39 +0000642* The usual Linux syscall updates (includes 32bit uid/gid support),
Wichert Akkermana9667852001-03-17 17:26:34 +0000643* Linux ioctl list updated
Wichert Akkermanf1850652001-02-16 20:29:03 +0000644* Support IPv6 scope ids
Wichert Akkermanb07296a2001-04-01 14:05:04 +0000645* FreeBSD/i386 port added
646* UnixWare and Solaris updates
647* Better support for tracing multithreaded processes in Linux
Wichert Akkerman12f75d12000-02-14 16:23:40 +0000648
Wichert Akkerman4dc8a2a1999-12-23 14:20:14 +0000649Changes in 4.2
650==============
651* Compiles on glibc2.0 systems again
652* Linux/S390 port added
Roland McGrathf57204d2002-12-18 04:36:59 +0000653* The usual Linux syscall updates
Wichert Akkerman9148a3b1999-12-24 23:13:55 +0000654* we can follow fork on arm now
Wichert Akkerman4dc8a2a1999-12-23 14:20:14 +0000655
Wichert Akkerman2a64b431999-11-26 00:29:05 +0000656Changes in 4.1
657================
658* Linux/MIPS port added
659* Lots of Linux updates again
660* Improved IPv6 support
661* Add strace-graph
662
Wichert Akkerman4a01ca01999-07-25 12:29:49 +0000663Changes in 4.0.1
664================
665* Minor bugfixes
666* Compiles on glibc2.0 systems again
667
Wichert Akkerman8dc9a1a1999-07-09 14:08:14 +0000668Changes in 4.0
669==============
670* Get stat structure properly on Linux 64bit archs
671* Personalities work again
672* Compile correctly on SunOS again
673* IRIX64 updates
674* Solaris updates
675
Wichert Akkerman3f7f49d1999-06-09 13:12:11 +0000676Changes in 3.99.1
Wichert Akkerman8dc9a1a1999-07-09 14:08:14 +0000677=================
Wichert Akkerman3f7f49d1999-06-09 13:12:11 +0000678* Linux (ultra)sparc fixes
679* Linux alpha fixes
680* Minor cleanups
681
Wichert Akkermanb859bea1999-04-18 22:50:50 +0000682Changes in 3.99
683===============
Wichert Akkerman1786d811999-04-15 20:34:14 +0000684* New maintainer
685* add support for more Linux architectures (powerpc, sparc, arm)
686* support lots more Linux syscalls
687* fix signal handling
688* add IPX and IPIP support
689* check stray syscall after execv
690* fix hanging children
691
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000692Changes in version 3.1
693======================
694
695* Irix5 is supported
696* Linux 68k is supported
697* Linux alpha is supported
698* configure is upgraded to autoconf 2.x
699* using -f in combination with -e now works correctly
700* output can be piped to a program
701* tracing setuid programs works better
702* it is now reasonable to install strace setuid to root in some circumstances
703* new useful tracing names like file and process to trace whole
704 classes of system calls, e.g. -efile traces all system calls that
705 take a file name as an argument
706* IPC calls on SunOS 4.1.x are decoded
707* Linux program memory is reliably dereferenced
708* Linux decodes at least the name of all syscalls as of pre2.0.4
709* various cosmetic changes and bug fixes
710
711Changes from versions 2.x to version 3.0
712========================================
713
714* filename arguments are neither abbreviated nor stringified
715* string arguments are now true C strings using octal instead of hex by default
716* preprocessor constants are never shortened (e.g. was RDONLY => now O_RDONLY)
717* by default the output for multiple processes now goes into one file
718* all structures, vectors, bitsets, etc. use consistent output formats
719* the -c option now means count calls, -i does what the old -c used to do
720
721New Features in version 3.0
722===========================
723
724* non-ascii strings can be optionally printed entirely in hex
725* the output format is readable when mutiple processes are generating output
726* exit values are printed in an alignment column
727* is is possible to suppress messages about attaching and detaching
728* various tracing features can be enabled on a per syscall/signal/desc basis
729* selective tracing of syscalls
730* selective printing of syscall structures
731* selective abbreviation of long structures on a per syscall basis
732* selective printing of raw syscall arguments and results
733* selective tracing of signals
734* selective dumping of all I/O read from file descriptors
735* selective dumping of all I/O written to file descriptors
736* optional counting of time, calls, and errors for each syscall