1Noteworthy changes in release 4.25 (2018-10-30)
2===============================================
3
4* Improvements
5  * Implemented decoding of KVM_CHECK_EXTENSION and NBD_* ioctl commands.
6  * Implemented decoding of SOL_XDP socket option names.
7  * Implemented decoding of AF_PACKET protocols in socket syscall.
8  * Implemented decoding of AF_AX25 and AF_X25 addresses, protocols,
9    and options.
10  * Implemented stack trace printing on receiving signals.
11  * Enhanced xlat styles support configured by -X option.
12  * Enhanced decoding of IFLA_*, NETCONFA_*, and SMC_DIAG_* netlink attributes.
13  * Wired up io_pgetevents syscall on arm, sparc, and sparc64.
14  * Updated lists of AF_*, AUDIT_*, BPF_*, IFLA_*, IN_*, IPSTATS_*,
15    IPV4_DEVCONF_*, NT_*, SCTP_*, SO_*, SOCK_*, SOL_*, and V4L2_* constants.
16  * Updated lists of ioctl commands from Linux 4.19.
17
18* Bug fixes
19  * Fixed decoding of bit sets in evdev ioctl commands.
20  * Fixed decoding of EVIOCGBIT(0, ...) ioctl commands.
21  * Fixed test suite for the case when mlockall and unimplemented syscalls
22    are explicitly disabled by a seccomp filter.
23
24Noteworthy changes in release 4.24 (2018-08-14)
25===============================================
26
27* Improvements
28  * Implemented decoding of kvm vcpu exit reason (-e kvm=vcpu option),
29    requires Linux kernel version 4.16.0 or higher.
30  * Implemented decoding of KVM_SET_CPUID2 and KVM_GET_*_CPUID ioctl commands.
31  * Enhanced decoding of corner cases of SO_LINGER, SO_PEERCRED,
32    and PACKET_STATISTICS getsockopt options.
33  * Wired up io_pgetevents and rseq syscalls on hppa, microblaze, mips, powerpc,
34    and s390.
35  * Updated lists of AUDIT_*, BPF_*, IFA_*, IFLA_*, RTA_*, RTPROT_*, TCP_*,
36    TRAP_*, and UDP_* constants.
37  * Updated lists of ioctl commands from Linux 4.18.
38
39* Bug fixes
40  * Fixed decoding of Q_XGETQSTAT on non-native personalities.
41  * Fixed race condition in aio test.
42  * Fixed build with Bionic libc.
43  * Fixed build with glibc-2.28.
44  * Fixed build in exotic systemd-nspawn based environments.
45  * Fixed build on s390 with kernel headers that do not contain Linux commit
46    v3.10-rc1~201^2~11.
47
48Noteworthy changes in release 4.23 (2018-06-14)
49===============================================
50
51* Changes in behaviour
52  * On x32 personality, 64-bit syscalls (such as readv) are now shown with "#64"
53    suffix instead of "64:" prefix.  Unlike the old names, these new names
54    can be used in syscall qualification expressions.
55  * Changed error number output format: error numbers are consistently
56    printed as "-1 ECONST (Error description)"
57    for known errors and as "-1 (errno 123)" for unknown errors,
58    regardless of -e raw qualification settings.  One can specify
59    -X raw for displaying raw error numbers unconditionally.
60  * Unfetchable addresses inside arrays are now printed as comments.
61  * Obsolete IA-32 mode syscall names are no longer printed on ia64.
62
63* Improvements
64  * Implemented libdw backend for -k option, configured at build time
65    using --with-libdw option.
66    Whether -k option is compiled is now configured at build time
67    using --enable-stacktrace option.
68  * Added -X option for configuring xlat output formatting (addresses
69    Debian bug #692915).
70  * Added support for personality designation ("64", "32", or "x32") to syscall
71    qualifications in -e trace expressions.
72  * Implemented injection of syscalls with no side effects as an alternative
73    to injection of an invalid syscall (-e inject=SET:syscall= expression).
74  * Improved support for reproducible builds (addresses Debian bug #896016).
75  * Implemented decoding of BPF_PROG_QUERY and BPF_RAW_TRACEPOINT_OPEN bpf
76    syscall commands.
77  * Implemented decoding of INOTIFY_IOC_SETNEXTWD and PERF_EVENT_IOC_* ioctl
78    commands.
79  * Implemented decoding of PR_GET_SPECULATION_CTRL and PR_SET_SPECULATION_CTRL
80    prctl syscall options.
81  * Enhanced decoding of bpf, getsockopt, setsockopt, and socket syscalls.
82  * Enhanced decoding of NETLINK_KOBJECT_UEVENT and NETLINK_ROUTE protocols.
83  * Enhanced decoding of *_DIAG_MEMINFO netlink attributes.
84  * Enhanced decoding of BTRFS_*, FS_IOC_*, SIOCGIFHWADDR, and SIOCSIFHWADDR
85    ioctl commands.
86  * Enhanced decoding of AF_BLUETOOTH socket addresses.
87  * Implemented decoding of io_pgetevent syscall.
88  * Wired up rseq syscall.
89  * Updated lists of ADJ_*, BPF_*, BPF_F_*, BPF_PROG_TYPE_*, ETH_P_*, FPE_*,
90    IFF_*, IPPROTO_*, MAP_*, MS_*, MSG_*, NETLINK_*, PACKET_*, PROT_*, SCTP_*,
91    SECCOMP_FILTER_FLAG_*, SEGV_*, SEM_*, SHM_*, SW_*, V4L2_CID_*,
92    V4L2_CTRL_CLASS_*, and V4L2_PIX_FMT_* constants.
93  * Updated lists of ioctl commands from Linux 4.17.
94
95* Bug fixes
96  * Fixed decoding of msgtyp argument of msgrcv syscall.
97  * Fixed fallback definitions for F_*, MCL_*, MSG_ZEROCOPY, SI_*,
98    and SOL_SOCKET constants.
99  * Fixed -e trace=%pure expression on mips.
100
101Noteworthy changes in release 4.22 (2018-04-05)
102===============================================
103
104* Changes in infrastructure
105  * The mailing list was moved to strace-devel@lists.strace.io.
106  * SourceForge git repository
107    (https://sourceforge.net/p/strace/code/ci/master/tree/) is no longer
108    maintained.  Please use GitLab (https://gitlab.com/strace/strace/)
109    or GitHub (https://github.com/strace/strace/) repository instead.
110
111* Changes in behaviour
112  * When printing string data, '8' and '9' following an octal escape sequence
113    no longer lead to unabbreviated octal escape sequence output, as they used
114    to do.
115  * Angle brackets are now printed as octal number escape sequences
116    in the output of paths associated with file descriptors.
117  * Data dump for write syscalls (-e write) is performed regardless
118    of successfulness of these syscall (addresses Debian bug #436284).
119  * -r and -t options are now affect output independently.  Previously,
120    -r option led to ignoring of the -t option (addresses Debian bug #466195).
121
122* Improvements
123  * Implemented delay injection (-e inject=SET:delay_enter= and
124    -e inject=SET:delay_exit= options).
125  * Added -A option for opening output files in append mode
126    (addresses Debian bug #528488).
127  * IPv6 addresses shown in socket information in -yy mode are now printed
128    in brackets.
129  * Enhanced decoding of bpf, prctl and ptrace syscalls.
130  * Enhanced decoding of BTRFS_IOC_INO_PATHS, BTRFS_IOC_LOGICAL_INO, and PTP_*
131    ioctl commands.
132  * Enhanced NETLINK_ROUTE protocol decoding.
133  * Updated lists of signal codes.
134  * Updated lists of BPF_*, BTN_*, ETH_P_*, INET_DIAG_BC_*, KEY_*, POLL*, RWF_*,
135    SCHED_FLAG_*, SCTP_* and error constants.
136  * Implemented block/character device number printing in -yy mode.
137  * Known pixel/SDR format names are printed as comments for pixelformat fields
138    in v4l2 structures.
139  * Enhanced decoding of kern_features syscall.
140  * Enhanced NETLINK_NETFILTER netlink protocol decoder.
141  * Optimized handling of large number of tracees.
142  * Improved wall clock time measurement in syscall count statistics
143    (-c -w option).
144  * Extended the range of allowed values in -e inject=...:retval= expression.
145  * Added i18n support.
146  * Updated lists of ioctl commands from Linux 4.16.
147  * Enhanced manual page.
148
149* Bug fixes
150  * Fixed build on m68k.
151  * Fixed v4l2 pixelformat decoding on big-endian architectures.
152  * Fixed -O option.
153
154Noteworthy changes in release 4.21 (2018-02-13)
155===============================================
156
157* Changes in behaviour
158  * Warning is now issued when -F option is used.
159  * Warning is now issued when a tracee with unsupported personality
160    is attached.
161  * Unknown syscall numbers are now printed in hexadecimal form.
162
163* Improvements
164  * Implemented decoding of netlink descriptor attributes as file descriptors.
165  * Implemented decoding of hugetlb page size selection flags.
166  * Implemented decoding of BPF_PROG_TEST_RUN, BPF_PROG_GET_NEXT_ID,
167    BPF_MAP_GET_NEXT_ID, BPF_PROG_GET_FD_BY_ID, BPF_MAP_GET_FD_BY_ID,
168    and BPF_OBJ_GET_INFO_BY_FD commands of bpf syscall.
169  * Enhanced decoding of get_thread_area, memfd_create, modify_ldt,
170    perf_event_open, reboot, s390_guarded_storage, s390_pcio_mmio_read,
171    s390_pci_mmio_write, s390_runtime_instr, s390_sthyi, set_thread_area,
172    and shmget syscalls.
173  * Implemented decoding of KVM_* and DM_LIST_DEVICES ioctl commands.
174  * Implemented decoding of riscv_flush_icache syscall.
175  * Enhanced decoding of getsockopt and setsockopt syscalls for SOL_NETLINK
176    level.
177  * Enhanced decoding of BPF_MAP_CREATE command of bpf syscall.
178  * Print values returned by mq_open syscall and first arguments
179    of mq_getsetattr, mq_notify, mq_timedreceive, and mq_timedsend syscalls
180    as file descriptors.
181  * Added decoding of get_tls syscall on arm.
182  * Added -e trace=%pure option for tracing system calls with no arguments that
183    never fail.
184  * Updated lists of IPV6_*, MAP_*, MEMBARRIER_CMD_*, MSG_*, NT_*, PKEY_*,
185    SHM_*, and TCP_* constants.
186  * Added manual page for the strace-log-merge command.
187  * Updated lists of ioctl commands from Linux 4.15.
188  * Implemented biarch support for s390x.
189  * Implemented an optional support for symbol demangling in strace -k output
190    (activated by --with-libiberty configure option).
191  * Information about availability of demangling and reliable personality
192    decoding (on architectures with multiple personalities) is now available
193    in strace -V output.
194  * Added decoding of pkey_alloc, pkey_free, and pkey_mprotect syscalls on
195    powerpc and powerpc64.
196  * Enhanced manual page.
197
198* Bug fixes
199  * Fixed multi-personality support in cross builds.
200  * Added mq_getsetattr, mq_notify, mq_open, mq_timedreceive, and mq_timedsend
201    syscalls to %desc tracing set.
202  * Fixed path tracing support for mmap syscalls with indirect arguments and
203    for old select syscall.
204  * Fixed decoding of arm-specific (__ARM_NR_*) syscalls.
205  * Fixed open mode flags decoding.
206  * Fixed corner cases in handling of strace -ff -ttt logs by strace-log-merge.
207  * Error counts that exceed one billion are now printed correctly in call
208    summary output.
209  * Fixed call summary header for x32 personality.
210  * Changes of tracee personalities are reported more reliably.
211  * Fixed the case when strace attaches to a tracee being inside exec and its
212    first syscall stop is syscall-exit-stop instead of syscall-enter-stop,
213    which messed up all the syscall state tracking.
214  * Fixed printing of higher 32 bits of the return value for x32 personality.
215
216* Portability
217  * A C compiler that supports "for" loop initial declarations is now required.
218  * Inability to configure multiple personality support on architectures where
219    multiple personalities are supported leads to configuration failure during
220    build now.  Use --enable-mpers=check to revert to the old behaviour.
221  * Build-time requirement for the mpers support has been lowered from gawk 4
222    to gawk 3.
223  * Removed incomplete and non-functional support for the CRIS architecture.
224  * Removed incomplete and unused support for IA-32 mode on the IA-64
225    architecture.
226
227Noteworthy changes in release 4.20 (2017-11-13)
228===============================================
229
230* Improvements
231  * Implemented decoding of NETLINK_NETFILTER netlink message types and flags.
232  * Implemented decoding of SECCOMP_GET_ACTION_AVAIL operation of seccomp
233    syscall.
234  * Updated lists of ARPHRD_*, BPF_*, ETH_P_*, LOOP_*, MADV_*,
235    MEMBARRIER_CMD_*, MFD_*, SECCOMP_*, SO_*, SOL_*, TCP_*, and UFFD_FEATURE_*
236    constants.
237  * Added decoding of statx syscall on hppa.
238  * Updated lists of ioctl commands from Linux 4.14.
239
240* Bug fixes
241  * Fixed powerpc personality support on powerpc64.
242
243Noteworthy changes in release 4.19 (2017-09-05)
244===============================================
245
246* Changes in behaviour
247  * Changed formatting of personality names on tile architecture in order
248    to make it in line with other multi-personality architectures.
249  * Changed field output order in struct v4l2_requestbuffers to improve in/out
250    field formatting.
251  * Changed handling of multiple signal= specifications in an injection
252    expression: multiple specification now leads to error instead of implicit
253    usage the last specification.
254
255* Improvements
256  * Enhanced decoding of optlen argument of getsockopt syscall.
257  * Enhanced decoding of SO_LINGER option of getsockopt and setsockopt syscalls.
258  * Enhanced decoding of SO_PEERCRED option of getsockopt syscall.
259  * Enhanced decoding of IP_ADD_MEMBERSHIP, IP_DROP_MEMBERSHIP,
260    IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP, IPV6_JOIN_ANYCAST,
261    IPV6_LEAVE_ANYCAST, MCAST_JOIN_GROUP, and MCAST_LEAVE_GROUP options
262    of setsockopt syscall.
263  * Enhanced decoding of KEYCTL_DH_COMPUTE operation of keyctl syscall
264    (KDF parameters decoding).
265  * Implemented decoding of KEYCTL_RESTRICT_KEYRING operation of keyctl syscall.
266  * Enhanced decoding of UFFDIO_API ioctl command.
267  * Enhanced decoding of BPF_PROG_LOAD, BPF_MAP_CREATE, BPF_MAP_LOOKUP_ELEM,
268    and BPF_MAP_GET_NEXT_KEY commands of bpf syscall.
269  * Implemented decoding of linux socket filter programs specified
270    for SO_ATTACH_FILTER and SO_ATTACH_REUSEPORT_CBPF socket options.
271  * Implemented decoding of inet_diag_req_v2, inet_diag_req_compat,
272    packet_diag_msg, and smc_diag_msg netlink attributes of NETLINK_SOCK_DIAG.
273  * Implemented NETLINK_SELINUX protocol specific decoding.
274  * Implemented decoding of netlink message ack flags.
275  * Implemented decoding of nlmsgerr netlink attributes.
276  * Implemented basic protocol specific decoding of NETLINK_CRYPTO.
277  * Implemented decoding of crypto_user_alg netlink attributes
278    of NETLINK_CRYPTO.
279  * Implemented basic protocol specific decoding of addr, addrlabel, dcb, link,
280    mdb, neigh, neightbl, netconf, nsid, route, rule, tc, and tca messages
281    of NETLINK_ROUTE.
282  * Implemented decoding of NETLINK_KOBJECT_UEVENT messages.
283  * Improved handling of unexpected tracees (the ones that cloned with
284    CLONE_PARENT/CLONE_PTRACE or called PTRACE_TRACEME on themselves): they
285    are now PTRACE_DETACH'ed instead of PTRACE_CONT'ed.
286  * Updated lists of BPF_*, KEY_*, RWF_*, SCM_*, SO_*, and *_MAGIC constants.
287  * Added decoding of arch_prctl syscall on x86.
288  * Added decoding of seccomp, bpf, userfaultfd, membarrier, mlock2,
289    copy_file_range, preadv2, pwritev2, and statx on alpha.
290  * Added decoding of statx syscall on microblaze.
291  * Added decoding of s390_guarded_storage syscall on s390.
292  * Updated lists of ioctl commands from Linux 4.13.
293  * Enhanced manual page.
294
295* Bug fixes
296  * Fixed printing of group_req structure on non-native personalities.
297  * Fixed output formatting of blkpg_ioctl_arg, dm_name_list, and iocb
298    structures.
299  * Fixed formatting of nul-terminated strings which have kernel-imposed size
300    limit.
301  * Fixed printing of paths that hit PATM_MAX limit in order to match kernel's
302    behaviour.
303  * Fixed build warnings on Android mips64.
304  * Fixed unused function "is_negated_errno" build warning when built
305    with clang.
306  * Fixed syscall number and arguments retrieval behaviour on sparc64 and
307    mips o32 after prctl(PR_SET_DUMPABLE, 0) makes PTRACE_PEEKTEXT impossible
308    to use if Linux kernel has commit v4.10-rc1~114^2~2.
309  * Fixed path tracing for execveat, symlink, symlinkat, inotify_add_watch,
310    and inotify_init syscalls.
311  * Fixed personality switch printing on sparc64 and risc-v.
312
313Noteworthy changes in release 4.18 (2017-07-05)
314===============================================
315
316* Improvements
317  * Implemented decoding of SCM_TIMESTAMP* control messages.
318  * Implemented decoding of netlink NLMSG_DONE messages.
319  * Implemented decoding of netlink generic nlmsg_type and nlmsg_flags.
320  * Implemented decoding of NETLINK_AUDIT, NETLINK_NETFILTER, NETLINK_ROUTE,
321    NETLINK_SELINUX, NETLINK_SOCK_DIAG, and NETLINK_XFRM message types.
322  * Implemented decoding of NETLINK_GENERIC protocol families.
323  * Implemented basic protocol specific decoding of AF_INET, AF_INET6,
324    AF_NETLINK, AF_PACKET, AF_SMC, and AF_UNIX messages of NETLINK_SOCK_DIAG.
325  * Implemented basic decoding of netlink attributes.
326  * Implemented basic protocol specific decoding of AF_INET, AF_NETLINK,
327    AF_PACKET, AF_SMC, and AF_UNIX netlink attributes of NETLINK_SOCK_DIAG.
328  * Implemented decoding of inet_diag_msg, netlink_diag_msg, and unix_diag_msg
329    netlink attributes of NETLINK_SOCK_DIAG.
330  * Updated lists of ARPHRD_*, KEYCTL_*, NDIAG_SHOW_*, RTM_*, SCM_*, SCTP_*,
331    SO_*, V4L2_*, and prctl ARCH_* constants.
332  * Updated lists of ioctl commands from Linux 4.12.
333
334* Bug fixes
335  * In interactive mode (-I2), those signals that were blocked at startup
336    will remain blocked for the whole period of strace execution.
337  * strace no longer resets SIGCHLD handler in tracees to the default action.
338  * When traced command is terminated by a blocked signal, strace unblocks
339    that signal to ensure its own termination with the same signal.
340  * Fixed corner cases in decoding of old sigaction syscall.
341  * Fixed build with old kernel headers on mips.
342  * Fixed build on aarch64 and tile with glibc >= 2.26.
343  * Fixed build on arc and nios2.
344
345Noteworthy changes in release 4.17 (2017-05-24)
346===============================================
347
348* Changes in command line syntax
349  * Syscall classes specified in -e trace= option now have % prefix (like
350    -e trace=%process).  Old style class names without leading % are still
351    supported, but considered deprecated now.
352
353* Improvements
354  * Optimized syscall filtering.
355  * Improved representation of timestamps.
356  * Enhanced decoding of sched_setattr syscall.
357  * Added -e trace=%stat option for tracing variants of stat syscall.
358  * Added -e trace=%lstat option for tracing variants of lstat syscall.
359  * Added -e trace=%fstat option for tracing variants of fstat and fstatat
360    syscalls.
361  * Added -e trace=%%stat option for tracing syscalls used for querying file
362    status information (stat, lstat, fstat, fstatat, statx, and their
363    variations).
364  * Added -e trace=%statfs option for tracing statfs, statfs64 and statvfs
365    syscalls.
366  * Added -e trace=%fstatfs option for tracing fstatfs, fstatfs64 and fstatvfs
367    syscalls.
368  * Added -e trace=%%statfs option for tracing syscalls used for querying file
369    system statistics information (statfs-like, fstatfs-like and ustat).
370  * Added -e trace=/regex option for filtering syscalls using regular
371    expressions.
372  * Added support for prepending of question mark before syscall qualification
373    in -e trace expressions in order to suppress error in case no syscalls
374    matched the provided qualification.
375  * Implemented decoding of signal mask in rt_sigreturn syscall on alpha, arc,
376    arm, avr32, bfin, cris, hppa, m68k, metag, microblaze, mips, nios2, or1k,
377    powerpc, powerpc64, riscv, sh, sh64, sparc, sparc64, tile, x86, and xtensa
378    architectures.
379  * Implemented decoding of statx syscall.
380  * Implemented decoding of NS_* ioctl commands.
381  * Implemented decoding of the remaining V4L2_BUF_TYPE_* types.
382  * Implemented decoding of VIDIOC_[SG]_TUNER ioctl commands.
383  * Implemented decoding of NLMSG_ERROR netlink messages.
384  * Improved decoding of BPF_PROG_ATTACH command of bpf syscall.
385  * Improved decoding of misplaced parts in DM_* ioctl commands.
386  * Updated lists of ioctl commands from Linux 4.11.
387
388* Bug fixes
389  * Fixed decoding of flags argument of preadv2 and pwritev2 syscalls on x32.
390  * Fixed the number of arguments and tracing flags of alpha specific syscalls.
391  * Fixed decoding of old sigsuspend syscall on alpha, cris, mips, powerpc,
392    powerpc64, sh, sh64, sparc, and sparc64.
393  * Fixed decoding of sgetmask and ssetmask syscalls on 64-bit architectures.
394  * Fixed decoding of netlink messages received within struct msghdr.
395  * Worked around a bug in miscompiled aarch64 kernels leading to the 3rd
396    argument of sched_getattr syscall being not quite 32-bit.
397  * Fixed corner cases of printing inaccessible times argument of utimes
398    and futimesat syscalls.
399
400Noteworthy changes in release 4.16 (2017-02-14)
401===============================================
402
403* Improvements
404  * Implemented syscall return value injection (-e inject=SET:retval= option).
405  * Implemented signal injection (-e inject=SET:signal= option).
406  * Implemented decoding of SUID_DUMP_* constants in PR_[GS]ET_DUMPABLE.
407  * Implemented decoding of all SG_* ioctl commands.
408  * Implemented decoding of ustat syscall.
409  * Implemented decoding of BPF_OBJ_PIN, BPF_OBJ_GET, BPF_PROG_ATTACH,
410    and BPF_PROG_DETACH commands of bpf syscall.
411  * Enhanced decoding of sg_io_hdr and sg_io_v4 structures.
412  * Enhanced decoding of get_robust_list, getrandom, io_submit, set_robust_list
413    syscalls.
414  * Enhanced decoding of entities of kernel long type on x32 and mips n32 ABIs.
415  * Updated lists of IP_*, IPV6_*, and LOOP_* constants.
416  * Updated lists of ioctl commands from Linux 4.10.
417  * Added decoding of recently added syscalls on avr32, microblaze, ppc,
418    and ppc64.
419
420* Bug fixes
421  * Fixed pathmatch of oldselect syscall on 64-bit architectures.
422  * Fixed decoding of mmap2 syscall on s390 when arguments are not available.
423  * Fixed decoding of kexec_file_load, mprotect, pkey_mprotect, prctl, preadv*,
424    and pwritev* syscalls on x32.
425  * Fixed printing of string arguments of getxattr and setxattr syscalls
426    when -s option is used to limit the printed string size.
427  * Fixed decoding of ifconf, ifreq, and loop_info structures on non-native
428    personalities.
429  * Fixed decoding of SG_* and LOOP_* ioctl commands.
430  * Fixed build on mips with musl libc.
431  * Fixed cross-building of ioctlsort.
432  * Applied minor formatting fixes to the manual page.
433
434Noteworthy changes in release 4.15 (2016-12-14)
435===============================================
436
437* Changes in behavior
438  * Time stamps are now printed according to ISO 8601.
439  * Changed output format of val3 parameter of futex FUTEX_WAKE_OP operation.
440  * The last argument of mincore, sched_getaffinity, and sched_setaffinity
441    syscalls is now formatted as an array.
442
443* Improvements
444  * Implemented syscall fault injection (-e fault=... option).
445  * Implemented decoding of DM_* ioctl commands.
446  * Implemented decoding of attr parameter of perf_event_open syscall.
447  * Implemented decoding of pkey_alloc, pkey_free, and pkey_mprotect syscalls.
448  * Implemented dumping of mq_timedsend and mq_timedreceive syscalls.
449  * Implemented decoding of PR_SET_FP_MODE and PR_GET_FP_MODE operations
450    of prctl syscall.
451  * Implemented PTRACE_GETREGS API support on m68k.
452  * Updated lists of ARCH_*, BPF_*, BTRFS_*, FALLOC_*, MS_*, *_MAGIC,
453    and V4L2_* constants.
454  * Updated lists of ioctl commands from Linux 4.9.
455  * Added decoding of recently added syscalls on arc, x32, and xtensa.
456  * Enhanced manual page.
457
458* Bug fixes
459  * Fixed corner cases in decoding of exit, exit_group, futimesat, getgroups,
460    getresuid, init_module, inotify_init1, kcmp, kexec_load, lookup_dcookie,
461    mq_getsetattr, mq_notify, mq_open, mq_timedreceive, mq_timedsend,
462    name_to_handle_at, prctl, process_vm_readv, process_vm_writev, setfsuid,
463    setgroups, setns, unshare, and utimes syscalls.
464  * Fixed handling of verbose flag in printing of controls array
465    of struct v4l2_ext_controls.
466  * Fixed omission of field names in the output of capability, sigaction,
467    sigevent, statfs, timespec, timeval, and utimbuf structures.
468  * Fixed printing of unknown syscalls in siginfo structure.
469  * Fixed decoding of ioctl constants on m68k.
470  * Fixed cris architecture support.
471  * Fixed cross build when host compiler does not support the same
472    set of warning flags as the cross compiler.
473  * Fixed build on SLE10 and SLE11.
474
475Noteworthy changes in release 4.14 (2016-10-04)
476===============================================
477
478* Changes in behavior
479  * When using -p option without a command and no processes has been attached,
480    strace exits with exit status 1.
481
482* Improvements
483  * Added printing of the mode argument of open and openat syscalls
484    when O_TMPFILE flag is set.  (Addresses Fedora bug #1377846).
485  * Enhanced -e abbrev=set, -e raw=set, and -e verbose=set.
486  * Enhanced decoding of futex, keyctl, quotactl, timerfd_settime,
487    and aio family syscalls.
488  * Implemented fetching of the 7th subcall argument on mips o32.
489  * Updated lists of BPF_*, ETH_P_*, KEXEC_ARCH_*, SCTP_*, TCP_*, and *_MAGIC
490    constants.
491  * Updated lists of ioctl commands from Linux 4.8.
492  * Added decoding of new syscalls on sh and sh64.
493  * Added RISC-V architecture support.
494
495* Bug fixes
496  * Marked io_setup and io_destroy as memory mapping related syscalls.
497  * Fixed leakage of placeholder descriptors to tracees.
498  * Fixed printing of mode_t, umode_t, and umask types.
499  * Fixed decoding of iovec arrays without a limit on total data size.
500  * Fixed decoding of fadvise64, fallocate, futex, keyctl, quotactl, readahead,
501    and ipc family syscalls.
502  * Fixed decoding of invalid syscalls mapped to indirect subcalls.
503  * Fixed decoding of struct btrfs_ioctl_vol_args_v2 on non-native
504    personalities.
505  * Fixed decoding of PTRACE_DETACH on sparc and sparc64.
506  * Fixed decoding of struct stat64 on sparc64.
507  * Fixed decoding of uid and gid-related syscalls on sparc64.
508  * Fixed decoding of the forth argument of semctl syscall on sparc64.
509  * Fixed values of tty ioctl constants on sparc64.
510  * Fixed sparc personality support on sparc64.
511
512Noteworthy changes in release 4.13 (2016-07-26)
513===============================================
514
515* Improvements
516  * Implemented a general netlink socket parser.
517  * Enhanced decoding of socket addresses.
518  * Enhanced decoding of cmsghdr, msghdr, and mmsghdr structures.
519  * Enhanced decoding of accept, accept4, bind, getpeername, getsockname,
520    ipc, recvfrom, recvmsg, recvmmsg, sendto, sendmmsg, and socketcall syscalls.
521  * Updated lists of AF_*, BPF_MAP_TYPE_*, KEY_*, KEYCTL_*, RWF_*, SS_*,
522    and *_MAGIC constants.
523  * Updated lists of ioctl commands from Linux 4.7.
524
525* Bug fixes
526  * Fixed decoding of pid_t argument of prlimit64 syscall.
527  * Fixed sign extension issues in the parser of struct rusage.
528  * Fixed race condition in decoding of timeout argument of recvmmsg and
529    rt_sigtimedwait syscalls.
530  * Fixed build with fresh linux kernel headers.
531
532Noteworthy changes in release 4.12 (2016-05-31)
533===============================================
534
535* Improvements
536  * Implemented simultaneous use of -p option and tracing of a command.
537    (addresses Debian bug #549942).
538  * Implemented caching of netlink conversations to reduce amount of time
539    spent in decoding socket details in -yy mode.
540  * Implemented -yy mode decoding of protocol:portid pairs associated with
541    netlink socket descriptors.
542  * Implemented decoding of copy_file_range, preadv2, and pwritev2 syscalls.
543  * Implemented dumping of preadv, preadv2, pwritev, pwritev2, and vmsplice
544    syscalls.
545  * Implemented decoding of BTRFS_* and UFFDIO_* ioctl commands.
546  * Enhanced decoding of BLK*, EVIOC*, RTC_*, and VIDIOC_* ioctl commands.
547  * Enhanced decoding of fstatfs, fstatfs64, get_mempolicy, getdents,
548    getdents64, getgroups, getpriority, kill, mbind, migrate_pages, mknod,
549    mknodat, personality, poll, ppoll, quotactl, rt_sigpending,
550    rt_sigqueueinfo, rt_sigtimedwait, rt_tgsigqueueinfo, sched_getaffinity,
551    sched_setaffinity, seccomp, set_mempolicy, setgroups, setpriority, statfs,
552    statfs64, tgkill, waitid, and xattr family syscalls.
553  * Enhanced decoding of getxpid, getxuid, and getxgid syscalls on alpha.
554  * Enhanced decoding of pipe syscall on alpha, ia64, mips, sh, and sparc.
555  * Added decoding of bind, listen, and setsockopt direct syscalls on sparc.
556  * Added decoding of osf_statfs64 and osf_fstatfs64 syscalls on alpha.
557  * Added decoding of fadvise64 and fadvise64_64 on s390.
558  * Updated lists of AF_*, BPF_MAP_TYPE_*, CLONE_*, EPOLL*, IPV6_*, MADV_*,
559    MSG_*, PTRACE_*, SEGV_*, SO_*, SOL_*, *_MAGIC, and quotactl constants.
560  * Updated lists of ioctl commands from Linux 4.6.
561
562* Bug fixes
563  * Fixed build on arc, metag, nios2, or1k, and tile architectures.
564  * Fixed decoding of 32-bit times syscall return value on 64-bit architectures.
565  * Fixed decoding of mlock2 syscall on sparc.
566  * Fixed decoding of osf_shmat syscall on alpha.
567  * Fixed decoding of syscalls unknown to the kernel on s390/s390x.
568    (addresses Debian bug #485979 and Fedora bug #1298294).
569  * Fixed decoding of preadv syscall in case of short read.
570  * Fixed decoding and dumping of readv syscall in case of short read.
571  * Fixed dumping of recvmsg and recvmmsg syscalls in case of short read.
572  * Fixed decoding of mincore syscall's last argument.
573  * Fixed remaining errors in mapping between syscall numbers and numbers
574    of syscall arguments.
575  * Applied various fixes to strace-graph script.
576
577Noteworthy changes in release 4.11 (2015-12-21)
578===============================================
579
580* Changes in behavior
581  * Some syscalls have different names depending on architecture and
582    personality.  In these cases, syscall filtering and printing now
583    consistently uses the names that match corresponding __NR_* kernel
584    macros of the tracee's architecture and personality.
585  * Added strace prefix to all diagnostic messages.
586
587* Improvements
588  * Enhanced and extended test suite.
589  * Implemented reliable tracing of processes whose personality differs
590    from the personality of strace, fixed decoding of 32-bit personality
591    syscalls on 64-bit architectures.
592  * When some data referenced by syscall arguments is irrelevant or cannot
593    be read from tracee's memory, strace now prints its address consistently.
594  * When a syscall is restarted using restart_syscall mechanism, strace now
595    shows the syscall name on architectures that expose this information.
596  * Print values returned by epoll_create1, eventfd, eventfd2, fanotify_init,
597    inotify_init1, perf_event_open, pipe, pipe2, signalfd, signalfd4, socket,
598    socketpair, timerfd, and timerfd_create syscalls, as well as F_DUPFD and
599    F_DUPFD_CLOEXEC fcntl commands, as file descriptors.
600  * Optimized decoding of indirect socket syscalls.
601  * Implemented decoding of nanoseconds along with seconds in stat family
602    syscalls (addresses Fedora bug #1251176).
603  * Implemented decoding of struct statfs.f_flags in statfs syscall.
604  * Implemented decoding of siginfo_t.si_syscall and siginfo_t.si_arch
605    in SIGSYS signal.
606  * Implemented decoding of indirect syscall on mips o32.
607  * Implemented decoding of IPPROTO_IP control messages.
608  * Implemented decoding of setsockopt syscall multicast arguments.
609  * Enhanced decoding of struct sigevent.
610  * Enhanced decoding of block, loop, mtd, ptp, rtc, SG_IO, socket, tty,
611    and v4l2 ioctl syscall arguments.
612  * Enhanced decoding of epoll_create, fcntl, fcntl64, futex, getdents,
613    getdents64, getsockopt, io_*, mount, msgctl, prctl, quotactl, recvfrom,
614    sendfile, setsockopt, and shmctl syscalls.
615  * Implemented decoding of bpf, execveat, ioperm, iopl, kcmp, kexec_file_load,
616    lookup_dcookie, membarrier, memfd_create, mlock2, name_to_handle_at,
617    open_by_handle_at, sched_getattr, sched_setattr, and userfaultfd syscalls.
618  * Updated lists of AF_*, EPOLL_*, FALLOC_FL_*, F_*, INPUT_PROP_*, IPPROTO_*,
619    IPV6_*, IP_*, KEY_*, LOCK_*, MNT_*, MS_*, PACKET_*, PERF_FLAG_*, PF_*,
620    PR_*, PTRACE_O_*, RENAME_*, SCTP_*, SECBIT_*, SO_*, TCP_*, and siginfo_t
621    constants.
622  * Added Nios II architecture support.
623  * Added new syscall entries to match Linux 4.4.
624
625* Bug fixes
626  * Fixed potential short read of strings from tracee's memory.
627  * Fixed -qq option in conjunction with -o option.
628  * Fixed filtering of <unavailable> syscalls.
629  * Fixed decoding of ioctl syscall command on aarch64 and 32-bit architectures
630    with 64-bit aligned structures.
631  * Fixed decoding of eventfd2, epoll_create1, signalfd4, and sync_file_range2
632    syscall flags arguments.
633  * Fixed decoding of 4th argument of clock_nanosleep syscall.
634  * Fixed decoding of getpagesize syscall on m68k.
635  * Fixed decoding of getrandom and seccomp syscalls on aarch64.
636  * Fixed decoding of timezone argument of gettimeofday and settimeofday
637  * syscalls.
638  * Fixed decoding of offset argument of mmap2 syscall on arm, sparc,
639    and sparc64.
640  * Fixed decoding of pipe syscall on alpha and mips.
641  * Fixed decoding of pipe2 syscall on ia64, sh, sparc, and sparc64.
642  * Fixed decoding of signal mask argument of pselect6 syscall on x32.
643  * Fixed decoding of signal mask of rt_sigreturn syscall on aarch64, m68k,
644    and x32.
645  * Fixed decoding of 4th argument of semctl indirect syscall.
646  * Fixed decoding of sa_restorer and sa_mask of sigaction syscall on m68k.
647  * Fixed decoding of statfs64 and fstatfs64 syscalls on arm eabi.
648  * Fixed decoding of struct dirent on x32.
649  * Fixed decoding of times syscall return value on mips n32 and x32.
650  * Fixed decoding of path argument of umount2 syscall
651    (addresses Debian bug #785050).
652  * Worked around a kernel bug in tracing privileged executables.
653  * Fixed various errors in mapping between syscall numbers and associated
654    information like the number of syscall arguments, the name of syscall,
655    and syscall decoder.
656
657Noteworthy changes in release 4.10 (2015-03-06)
658===============================================
659
660* Improvements
661  * Added -yy option to print protocol and address information associated with
662    socket descriptors.
663  * Extended "-e read=set" and "-e write=set" options to cover sendmsg,
664    recvmsg, sendmmsg, and recvmmsg syscalls.
665  * Implemented full 32-bit decoding of ioctl commands
666    (addresses Debian bug #692913 and Fedora bug #902788).
667  * Implemented PTRACE_GETREGS API support on ia64.
668  * Implemented PTRACE_GETREGS API support on mips.
669  * Implemented PTRACE_GETREGSET API support on s390/s390x.
670  * Implemented decoding of getrandom and seccomp syscalls.
671  * Implemented full decoding of 64-bit capability sets.
672  * Implemented decoding of all prctl commands.
673  * Implemented decoding of parametrized ioctl commands.
674  * Implemented decoding of evdev ioctl commands.
675  * Implemented decoding of v4l ioctl commands.
676  * Implemented decoding of SG_IO v4 ioctl commands.
677  * Implemented decoding of FIFREEZE/FITHAW/FITRIM ioctl commands.
678  * Implemented decoding of FALLOC_FL_* fallocate flags.
679  * Implemented decoding of rt_sigreturn signal mask on aarch64,
680    x32, and x86_64.
681  * Enhanced socket decoder to support bluetooth sockets.
682  * Enhanced decoding of unlisted ioctl commands.
683  * Enhanced decoding of getsockopt and setsockopt syscall.
684  * Enhanced decoding of sysinfo syscall.
685  * Enhanced decoding of struct cmsghdr.
686  * Enhanced decoding of wait status.
687  * Enhanced aio support on non-x86 architectures by using external libaio.h.
688  * Added O_TMPFILE to the list of recognized open mode flags.
689  * Updated the list of filesystem type constants that is used in decoding
690    statfs family syscalls.
691  * Updated lists of CAP_*, PR_*, PTRACE_*, SCHED_*, SO_*, SOL_*, SWAP_FLAG_*,
692    and TFD_* constants.
693  * Updated lists of signal constants from Linux 3.19.
694  * Updated lists of errno constants from Linux 3.19.
695  * Updated lists of ioctl commands from Linux 3.9.
696  * Added new syscall entries to match Linux 3.19.
697
698* Bug fixes
699  * Fixed various errors in mapping between syscall numbers and associated
700    information like the number of syscall arguments, the name of syscall,
701    and syscall decoder.
702  * Fixed quoting issues in printing descriptors, filenames, network interface
703    names, struct utsname members, device/volume names of BLK* ioctl commands.
704  * Fixed uid_t/git_t decoding.
705  * Fixed potential out-of-bounds read issues in getdents/getdents64 decoders.
706  * Fixed potential open flags truncation on some architectures.
707  * Fixed decoding of struct ifreq.ifr_name.
708  * Fixed decoding of SIOCSIFNAME ioctl command.
709  * Fixed decoding of RENAME_* renameat2 flags.
710  * Fixed decoding of UTIME_NOW/UTIME_OMIT timeval structures.
711  * Fixed decoding of indirect ipc subcalls on some architectures.
712  * Fixed decoding of fanotify_mark syscall on 32-bit architectures.
713  * Fixed decoding of 32-bit stat structures on 64-bit architectures.
714  * Fixed decoding of 32-bit struct cmsghdr on 64-bit architectures.
715  * Fixed decoding of 32-bit preadv/pwritev offset on 64-bit architectures.
716  * Fixed decoding of sigreturn/rt_sigreturn signal mask on ia64, ppc, ppc64,
717    sparc, sparc64, mips, and s390.
718  * Fixed instruction pointer output (-i option) on architectures that support
719    several personalities.
720  * Fixed behaviour of "-e read=set" and "-e write=set" when read and write
721    sets intersect.
722  * Fixed build on systems where struct sigaction has no sa_restorer member.
723  * Fixed build with uclibc and musl libc.
724
725* Portability
726  * Linux kernel >= 2.5.46 is required.
727    Older versions without a decent PTRACE_SETOPTIONS support will not work.
728  * On mips, linux kernel >= 2.6.15 is required.
729    Older versions without a decent PTRACE_GETREGS support will not work.
730  * On s390 and s390x, linux kernel >= 2.6.27 is required.
731    Older versions without a decent PTRACE_GETREGSET support will not work.
732
733Noteworthy changes in release 4.9 (2014-08-15)
734==============================================
735
736* Changes in behavior
737  * Disabled OABI support on ARM EABI systems by default,
738    added --enable-arm-oabi option to enable it at configure time.
739
740* Improvements
741  * Added experimental -k option to print stack trace after each traced syscall.
742  * Added -w option to produce stats on syscall latency.
743    (addresses Debian bug #457497).
744  * Added ARC architecture support.
745  * Added PTRACE_GETREGS API support on PowerPC.
746  * Enhanced Bionic libc and musl libc support.
747  * Enhanced tracing of x86 personality processes on x86_64 and x32.
748  * Enhanced tracing of ARM personality processes on AArch64.
749  * Enhanced 32/64bit personality detection on PowerPC.
750  * Implemented decoding of add_key, ioprio_get, ioprio_set, kexec_load, keyctl,
751    renameat2, and request_key syscalls.
752  * Robustified decoding of select, pselect, and io_submit syscalls.
753  * Enhanced decoding of delete_module, fanotify_init, fanotify_mark, fcntl,
754    setdomainname, sethostname, setns, and sync_file_range syscalls.
755  * Enhanced decoding of signal bitmasks.
756  * Enhanced decoding of file descriptors.
757  * Enhanced siginfo_t decoding.
758  * Enhanced PF_NETLINK decoding.
759  * Updated CLOCK_* constants
760    (addresses Fedora bug #1088455).
761  * Added new syscall entries to match Linux 3.16.
762
763* Bug fixes
764  * Added shmat and shmdt to the set of memory mapping related syscalls.
765  * Fixed detaching from stopped processes.
766  * Fixed fanotify_mark decoding on 32bit architectures.
767  * Fixed offset decoding in preadv and pwritev syscalls.
768  * Fixed select decoding for glibc in _FORTIFY_SOURCE mode.
769  * Fixed decoding of epoll_ctl syscall with EPOLL_CTL_DEL argument.
770  * Fixed build when <sys/ptrace.h> and <linux/ptrace.h> conflict
771    (addresses Fedora bug #993384).
772  * Miscellaneous corrections in the manual page.
773    (Addresses Debian bug #725987).
774
775Noteworthy changes in release 4.8 (2013-06-03)
776==============================================
777
778* Changes in behavior
779  * In case of normal strace termination, when the trace output is
780    redirected to a pipe, strace now closes it and waits for the pipe
781    process termination before exit.
782
783* Improvements
784  * Implemented tracing using PTRACE_SEIZE API (when available).
785  * Implemented more reliable PTRACE_GETREGSET-based process personality
786    detection on x86-64 and x32 (when available).
787  * Added -e trace=memory option for tracing memory mapping related syscalls.
788  * Documented -b option.
789  * Allowed exit status messages to be suppressed by giving -q option twice.
790  * Added AArch64 architecture support
791    (addresses Debian bug #693074 and Fedora bug #969858).
792  * Added support for OpenRISC 1000, Meta, and Xtensa architectures.
793  * Added tilegx personality support for Tile.
794  * Enhanced support of NOMMU architectures.
795  * Enhanced decoding of getdents, mmap, perf_event_open, ptrace, and
796    quotactl syscalls.
797  * Added new syscall entries to match Linux 3.9.
798  * Regenerated the list of common ioctl names from Linux 3.9.
799  * Updated the list of errno constants.
800  * Updated lists of AF_*, MADV_*, MAP_*, MSG_*, MS_*, PF_*, PR_*,
801    PTRACE_O_*, and TCP_* constants.
802  * Implemented decoding of UBI ioctls.
803  * Removed redundant "*32" ioctl names.
804
805* Bug fixes
806  * Fixed ERESTARTNOINTR leaking to userspace on ancient kernels
807    (addresses Fedora bug #659382).
808  * Fixed kernel release string parsing
809    (addresses Debian bug #702309).
810  * Fixed decoding of *xattr syscalls
811    (addresses Fedora bug #885233).
812  * Fixed handling of files with 64-bit inode numbers by 32-bit strace
813    (addresses Fedora bug #912790).
814  * Fixed tracing forks on SPARC.
815  * Fixed decoding of fadvise64, fallocate, ftruncate64, io_submit, pread,
816    preadv, pwrite, pwritev, readahead, sigaltstack, sync_file_range, sysctl,
817    and truncate64 syscalls.
818  * Fixed categories of multiple syscalls on most of supported architectures.
819  * Fixed decoding of non-native 32-bit personality recv[m]msg syscalls.
820  * Fixed decoding of multiple 32-bit personality syscalls on x32.
821  * Fixed decoding of long long syscall arguments on ARM, MIPS/o32, PowerPC,
822    S390x, and Tile architectures.
823  * Fixed semtimedop decoding on S390x.
824  * Fixed sram_alloc decoding on Blackfin.
825  * Fixed build when process_vm_readv is a stab.
826  * Fixed build with older versions of libaio.h.
827
828Noteworthy changes in release 4.7 (2012-05-02)
829==============================================
830
831* Changes in behavior
832  * strace no longer suspends waitpid until there is a child
833    for waitpid'ing process to collect status from.
834  * strace no longer detaches from a tracee which is supposed
835    to be going to die.
836  * strace now issues a new message: "+++ exited with EXITCODE +++"
837    which shows exact moment strace got exit notification,
838    analogous to existing "+++ killed by SIG +++" message.
839
840* Improvements
841  * Added x32 personality support (x86_64 architecture).
842  * Added -y and -P options to print file descriptor paths and
843    filter by those paths.
844  * Added -I option to control strace interactivity.
845  * Allowed -p option to take comma or whitespace-separated list of PIDs.
846  * Added strace_log_merge script helper to merge timestamped "strace -ff"
847    log files.
848  * Implemented decoding of clock_adjtime, get_robust_list, migrate_pages,
849    preadv, prlimit64, process_vm_readv, process_vm_writev, pwritev,
850    recvmmsg, recvmsg, rt_tgsigqueueinfo, sendmmsg, setns, set_robust_list,
851    sched_rr_get_interval, splice, syslog, tee and vmsplice syscalls.
852  * Enhanced decoding of capget, capset, getrlimit, flistxattr, io_submit,
853    listxattr, setrlimit and swapon syscalls.
854  * Implemented decoding of loop and mtd ioctls.
855  * Added syscall entries for new linux syscalls.
856  * Added syscall entries for direct socket system calls on powerpc.
857  * Updated the list of errno constants.
858  * Updated lists of MSG_*, STA_*, and TCP_* constants.
859  * Regenerated the list of ioctl names from Linux 3.3.
860  * Enhanced switching between processes with different personalities.
861  * Enhanced signals reporting by using short signal names.
862  * Made ERESTART* messages more descriptive.
863  * Made parsing of numbers from strings more robust.
864  * Added support for compat_statfs64 and statfs64.f_flags.
865  * Changed read of data blocks to use single process_vm_readv syscall
866    (when available) instead of several PTRACE_PEEKDATA operations.
867  * Changed read of registers on x86 and x86-64 to use single PTRACE_GETREGS
868    operation instead of several PTRACE_PEEKUSER operations.
869  * Applied various optimizations to make strace work faster.
870
871* Bug fixes
872  * Implemented proper handling of real SIGTRAPs on kernels supporting
873    PTRACE_O_TRACESYSGOOD.
874    (Addresses Fedora bug #162774).
875  * Fixed sockaddr_un.sun_path name in decoded output.
876    (Addresses Debian bug #554946).
877  * Fixed to avoid potential core file clobbering on exit.
878    (Addresses Debian bug #656398).
879  * Fixed a typo in documentation.
880    (Addresses Debian bug #653309).
881  * Fixed decoding of timer id returned by timer_create.
882  * Fixed epoll_create1, epoll_wait and epoll_pwait decoding.
883  * Fixed *at syscalls flags decoding.
884  * Fixed ARM EABI 64-bit syscall's arguments decoding.
885  * Fixed semtimedop decoding on s390.
886  * Fixed osf_sigprocmask decoding on alpha.
887  * Fixed ipc and socket subcall decoding on several architectures.
888  * Corrected syscall entries for epoll_pwait, epoll_create, epoll_ctl,
889    epoll_wait, mincore, mlockall, prctl, reboot, sendfile, sendfile64,
890    sendmsg, sgetmask, ssetmask, swapon, tgkill and tkill syscalls.
891  * Corrected io_* syscall entries on ARM.
892  * Fixed PID prefix printing in "strace -oLOG -ff -p1 -p2 -p3" case.
893  * Fixed logging of unfinished lines in "strace -oLOG -ff" case.
894  * Fixed build when libaio-devel is not available.
895  * Fixed configure checks for PTRACE_* constants.
896  * Fixed compilation warnings remained on several architectures.
897
898* Portability
899  * Removed all non-Linux code.  After years of neglect, that dead code
900    just hampered further strace development.
901  * Linux kernel >= 2.6.18 is recommended.  Older versions might still
902    work but they haven't been thoroughly tested with this release.
903
904Noteworthy changes in release 4.6 (2011-03-15)
905==============================================
906
907* Changes in behavior
908  * Print diagnostic information about changes in personality mode to
909    standard error instead of standard output.
910
911* Improvements
912  * Implemented a new method of following clone, fork, and vfork
913    syscalls using the Linux kernel's explicit facilities for tracing
914    creation of threads and child processes.
915  * Implemented CLONE_PARENT and CLONE_UNTRACED flags handling.
916  * Implemented decoding of TLS syscalls on m68k.
917  * Implemented biarch support on powerpc64.
918  * Implemented biarch support for getrlimit() and setrlimit().
919  * Implemented decoding of struct ucred in getsockopt SO_PEERCRED.
920  * Implemented SOL_SCTP socket options decoding.
921  * Added HDIO_* ioctl names.
922    (Addresses Debian bug #450953).
923  * Added LOOP_* ioctl names.
924  * Updated lists of CLOCK_*, CLONE_*, MS_*, and SOL_* constants
925    to match Linux 2.6.37.
926  * Updated the list of IPPROTO_* constants to match netinet/in.h.
927  * Implemented decoding of HDIO_* and BLK* ioctls.
928  * Added MicroBlaze architecture support.
929  * Added new syscall entries to match Linux 2.6.37.
930  * Regenerated list of ioctl names from Linux 2.6.37.
931  * Enhanced signal notification decoding.
932  * Documented -C and -D options.
933
934* Bug fixes
935  * Fixed fetching syscall arguments on m68k.
936  * Fixed an error when judging whether a process has children.
937  * Fixed get/set_robust_list syscall numbers for powerpc.
938  * Fixed a corner case in printing clone flags.
939  * Fixed cross-compiling issues.
940  * Fixed build issues on powerpc64, SH and SPARC.
941  * Fixed syscall flags of fstatat*, mmap, mmap2, fadvise64*, swapoff,
942    fgetxattr, flistxattr, fremovexattr, epoll_create, fallocate,
943    fanotify_init, and fanotify_mark syscalls.
944  * Fixed decoding of get[ug]id, gete[ug]id and setfs[ug]id return values.
945  * Fixed biarch support in IO dumping.
946  * Fixed raw exit_group decoding.
947  * Fixed decoding of file descriptors on 64-bit architectures.
948  * Fixed a corner case in waitpid handling.
949    (Addresses Red Hat bug #663547).
950  * Fixed stat64 decoding on mips
951    (Addresses Debian bug #599028).
952  * Fixed misleading italics in the manual page.
953    (Addresses Debian bug #589323).
954
955Noteworthy changes in release 4.5.20 (2010-04-13)
956=================================================
957
958* Improvements
959  * Implemented decoding of new linux syscalls: inotify_init1, recvmmsg.
960  * Implemented basic decoding of new linux syscalls: preadv, pwritev,
961    rt_tgsigqueueinfo, perf_event_open.
962  * Enhanced decoding of recently added syscalls on non-x86 architectures
963    by replacing a bare decoder with elaborate parsers enabled earlier
964    for x86/x86-64.
965  * Implemented -C option to combine regular and -c output.
966    (Addresses Debian bug #466196)
967  * Enhanced decoding of mbind and mremap syscalls.
968  * Enhanced SOL_PACKET socket options decoding.
969  * Regenerated list of ioctl names from linux 2.6.33.
970  * Added TILE architecture support.
971
972* Bug fixes
973  * Fixed build with Linux kernel headers 2.6.32-rc5+.
974    (Addresses Debian bug #560516 and Fedora bug #539044)
975  * Fixed build on mips.
976  * Fixed handling of Linux systems without struct statfs64.
977  * Fixed reporting signal mask by sigreturn on powerpc.
978  * Fixed potential stack buffer overflow in select decoder.
979    (Addresses Fedora bug #556678)
980  * Corrected msgsnd indirect ipccall decoding.
981  * Corrected decoding of 64bit syscalls.
982    (Addresses Debian bug #570603)
983  * Corrected getsockopt decoding on architectures where
984    sizeof(long) > sizeof(int).
985    (Addresses Debian bug #494844)
986  * Corrected decoding of epoll_pwait.
987    (Addresses Debian bug #513014)
988  * Corrected handling of killed threads.
989
990Noteworthy changes in release 4.5.19 (2009-10-21)
991=================================================
992
993* Changes in behavior
994  * When command exits, strace now exits with the same exit status.
995    If command is terminated by a signal, strace terminates itself
996    with the same signal, so that strace can be used as a wrapper
997    process transparent to the invoking parent process.
998    When using -p option, the exit status of strace is zero unless
999    there was an unexpected error in doing the tracing.
1000    (Addresses Fedora bug #105371 and Debian bug #37665)
1001
1002* Improvements
1003  * Implemented decoding of new Linux syscalls: accept4, dup3,
1004    epoll_create1, eventfd2, inotify_init1, pipe2, signalfd4.
1005  * Implemented decoding of socket type flags introduced in Linux 2.6.27.
1006  * Implemented decoding of accept4 socketcall.
1007  * Enhanced prctl decoding.
1008  * Enhanced nanosleep decoding.
1009  * Enhanced ptrace decoding.
1010  * Enhanced futex decoding.
1011  * Enhanced CAP_* decoding.
1012  * Enhanced SIOCS* ioctls decoding.
1013  * Enhanced fcntl F_* flags decoding.
1014  * Enhanced semop/semtimedop decoding.
1015  * Updated ARM architecture support.
1016  * Added Blackfin architecture support.
1017  * Added AVR32 architecture support.
1018  * Added CRIS architecture support.
1019  * Made strace detect when traced process suddenly disappeared.
1020
1021* Bug fixes
1022  * Fixed syscall numbers for tee and sync_file_range.
1023    (Addresses Debian bug #503124)
1024  * Fixed several bugs in strings decoder, including potential heap
1025    memory corruption.
1026    (Addresses Fedora bugs #470529, #478324 and #511035)
1027  * Marked sendfile(2) as a network syscall.
1028    (Addresses Debian bug #509499)
1029  * Fixed accept(2) decoding.
1030    (Addresses Debian bug #507573)
1031  * Fixed sigtimedwait(2) decoding.
1032  * Fixed build on ARM EABI.
1033    (Addresses Debian bugs #520084 and #535564, and Fedora bug #507576)
1034  * Fixed display of 32-bit fcntl(F_SETLK) on 64-bit architectures.
1035    (Addresses Red Hat bug #471169)
1036  * Fixed display of 32-bit argv array on 64-bit architectures.
1037    (Addresses Fedora bug #519480)
1038  * Fixed display of 32-bit struct sigaction on 64-bit architectures.
1039  * Fixed HPPA architecture support.
1040    (Addresses Debian bugs #437928 and #546619)
1041
1042Changes in 4.5.18
1043==============
1044* Bug fixes.
1045* Support new Linux/PPC system call subpage_prot and PROT_SAO flag.
1046* In sigaction system call, display sa_flags value along with SIG_DFL/SIG_IGN.
1047
1048Changes in 4.5.17
1049==============
1050* Many bug fixes.
1051* -F is now deprecated, -f has traced vfork too on Linux for a long time now.
1052* Print O_CLOEXEC, MSG_CMSG_CLOEXEC flag bits.
1053* Improved output for prctl system call on Linux.
1054* Improved support for Linux/ARM.
1055* SA_NOMASK is now spelled SA_NODEFER, and SA_ONESHOT is spelled SA_RESETHAND.
1056
1057Changes in 4.5.16
1058==============
1059* Bug fixes.
1060* Improved output for delete_module, futex, and mbind system calls on Linux.
1061* Improved output for SG_IO ioctls on Linux.
1062* Support new Linux system calls move_pages, utimensat, signalfd, timerfd,
1063  eventfd, getcpu, epoll_pwait.
1064
1065Changes in 4.5.15
1066==============
1067* Bug fixes.
1068* Several biarch improvements.
1069* Improved output for adjtimex, sysctl, quotactl, mount, umount.
1070* Support new Linux system calls *at, inotify*, pselect6, ppoll and unshare.
1071
1072Changes in 4.5.14
1073==============
1074* Bug fixes.
1075* Accept numeric system calls in -e.
1076
1077Changes in 4.5.13
1078==============
1079* Bug fixes.
1080* Introduce "-e trace=desc".
1081
1082Changes in 4.5.12
1083==============
1084* Bug fixes.
1085* Better x86-64 support for IA32 processes.
1086* Update PowerPC system calls.
1087* Better printing for Linux aio system calls.
1088
1089Changes in 4.5.11
1090==============
1091* Quick fix release for build issues.
1092* One fix for Linux/ARM system call table.
1093
1094Changes in 4.5.10
1095==============
1096* Bug fixes.
1097* Print fault address for SIGSEGV/SIGBUS signals when available.
1098
1099Changes in 4.5.9
1100==============
1101* Bug fixes.
1102* Improve socket ioctl printing.
1103* Update Linux/IA64 syscall list.
1104* Fix Linux/x86-64 syscall argument extraction for 32-bit processes.
1105* Improve mount flags printing.
1106* Support symbolic printing of x86_64 arch_prctl parameters.
1107
1108Changes in 4.5.8
1109==============
1110* Bug fixes.
1111* Update syscall tables for Alpha, ARM, HPPA.
1112* Support new Linux syscalls mbind, set_mempolicy, get_mempolicy, waitid.
1113* Support Linux syscalls fadvise64, fadvise64_64, and epoll_*.
1114* Improve ioctl command name matching.
1115* Print RTC_* ioctl structure contents.
1116* Support newer RLIMIT_* values.
1117* Print struct cmsghdr details in sendmsg.
1118
1119Changes in 4.5.7
1120==============
1121* Bug fixes.
1122* Print attribute values in *xattr system calls on Linux.
1123* Include pread and pwrite calls in -e read and -e write tracing.
1124* Update SO_* and IP_* value lists and add IPV6_* values for socket options.
1125* Print clock_t values symbolically in Linux clock_* system calls.
1126
1127Changes in 4.5.6
1128==============
1129* Bug fixes, Linux ioctl updates.
1130* David Miller contributed support for Linux/SPARC64.
1131
1132Changes in 4.5.5
1133==============
1134* Just bug fixes.
1135
1136Changes in 4.5.4
1137==============
1138* Update Linux ioctl lists.
1139* Update PF_* and AF_* value lists.
1140* The 4.5.3 -p behavior for NPTL threads applies only under -f, and got fixed.
1141
1142Changes in 4.5.3
1143==============
1144* Bug fixes.
1145* On Linux using NPTL threads, -p will now attach to all threads in a process.
1146* Handle new mq_* system calls in Linux 2.6.6 and later.
1147
1148Changes in 4.5.2
1149==============
1150* Bug fixes.
1151* Report some new VM_* bit values on Linux.
1152* Better output for Linux sched_* system calls.
1153
1154Changes in 4.5.1
1155==============
1156* Bug fixes.
1157* Display multiple ioctl name matches on Linux.
1158
1159Changes in 4.5
1160==============
1161* New port to AMD's x86-64 architecture. One strace binary can
1162  handle both new x86-64 and old i386 processes.
1163* Fixed support for LFS64 calls.
1164* New switch -E to add/remove environment variables for the command.
1165* Merged s390/s390x port.
1166* Trace an unbounded number of processes.
1167* Handle numerous new system calls in Linux 2.5, and new threads semantics.
1168* Fixed bugs with attach/detach leaving things stopped.
1169* Fixed traced process seeing ECHILD despite live, traced children
1170  in waitpid calls with WNOHANG.
1171* Stuart Menefy contributed a port to Linux/SH.
1172* Stephen Thomas contributed a port to Linux/SH64.
1173* Many other bug fixes.
1174
1175Changes in 4.4
1176==============
1177* Fix Linux/ia64 support, looks like someone renamed a few things on us
1178* Fix the ioctl setup for Linux, turned out it did not really work.
1179  Improve the ioctl extractor as well so we decode some more ones.
1180
1181Changes in 4.3.1
1182================
1183* compile fixes for Linux/mips
1184
1185Changes in 4.3
1186==============
1187* Linux ia64 and hppa ports added
1188* The usual Linux syscall updates (includes 32bit uid/gid support),
1189* Linux ioctl list updated
1190* Support IPv6 scope ids
1191* FreeBSD/i386 port added
1192* UnixWare and Solaris updates
1193* Better support for tracing multithreaded processes in Linux
1194
1195Changes in 4.2
1196==============
1197* Compiles on glibc2.0 systems again
1198* Linux/S390 port added
1199* The usual Linux syscall updates
1200* we can follow fork on arm now
1201
1202Changes in 4.1
1203================
1204* Linux/MIPS port added
1205* Lots of Linux updates again
1206* Improved IPv6 support
1207* Add strace-graph
1208
1209Changes in 4.0.1
1210================
1211* Minor bugfixes
1212* Compiles on glibc2.0 systems again
1213
1214Changes in 4.0
1215==============
1216* Get stat structure properly on Linux 64bit archs
1217* Personalities work again
1218* Compile correctly on SunOS again
1219* IRIX64 updates
1220* Solaris updates
1221
1222Changes in 3.99.1
1223=================
1224* Linux (ultra)sparc fixes
1225* Linux alpha fixes
1226* Minor cleanups
1227
1228Changes in 3.99
1229===============
1230* New maintainer
1231* add support for more Linux architectures (powerpc, sparc, arm)
1232* support lots more Linux syscalls
1233* fix signal handling
1234* add IPX and IPIP support
1235* check stray syscall after execv
1236* fix hanging children
1237
1238Changes in version 3.1
1239======================
1240
1241* Irix5 is supported
1242* Linux 68k is supported
1243* Linux alpha is supported
1244* configure is upgraded to autoconf 2.x
1245* using -f in combination with -e now works correctly
1246* output can be piped to a program
1247* tracing setuid programs works better
1248* it is now reasonable to install strace setuid to root in some circumstances
1249* new useful tracing names like file and process to trace whole
1250  classes of system calls, e.g. -efile traces all system calls that
1251  take a file name as an argument
1252* IPC calls on SunOS 4.1.x are decoded
1253* Linux program memory is reliably dereferenced
1254* Linux decodes at least the name of all syscalls as of pre2.0.4
1255* various cosmetic changes and bug fixes
1256
1257Changes from versions 2.x to version 3.0
1258========================================
1259
1260* filename arguments are neither abbreviated nor stringified
1261* string arguments are now true C strings using octal instead of hex by default
1262* preprocessor constants are never shortened (e.g. was RDONLY => now O_RDONLY)
1263* by default the output for multiple processes now goes into one file
1264* all structures, vectors, bitsets, etc. use consistent output formats
1265* the -c option now means count calls, -i does what the old -c used to do
1266
1267New Features in version 3.0
1268===========================
1269
1270* non-ascii strings can be optionally printed entirely in hex
1271* the output format is readable when multiple processes are generating output
1272* exit values are printed in an alignment column
1273* is is possible to suppress messages about attaching and detaching
1274* various tracing features can be enabled on a per syscall/signal/desc basis
1275* selective tracing of syscalls
1276* selective printing of syscall structures
1277* selective abbreviation of long structures on a per syscall basis
1278* selective printing of raw syscall arguments and results
1279* selective tracing of signals
1280* selective dumping of all I/O read from file descriptors
1281* selective dumping of all I/O written to file descriptors
1282* optional counting of time, calls, and errors for each syscall
1283