-Noteworthy changes in release ?.?
-=================================
+Noteworthy changes in release ?.?? (????-??-??)
+===============================================
-Noteworthy changes in release 4.7
-=================================
+* Improvements
+ * Enhanced decoding of personality, sched_getaffinity,
+ and sched_setaffinity syscalls.
+ * Enhanced decoding of getxpid, getxuid, and getxgid syscalls on alpha.
+ * Added decoding of bind, listen, and setsockopt direct syscalls on sparc.
+
+* Bug fixes
+ * Fixed build on arc, metag, nios2, or1k, and tile architectures.
+ * Fixed decoding of 32-bit times syscall return value on 64-bit architectures.
+ * Fixed decoding of mlock2 syscall on sparc.
+ * Fixed decoding of syscalls unknown to the kernel on s390/s390x.
+ (addresses Debian bug #485979 and Fedora bug #1298294).
+ * Fixed decoding and dumping of readv syscall in case of short read.
+
+Noteworthy changes in release 4.11 (2015-12-21)
+===============================================
+
+* Changes in behavior
+ * Some syscalls have different names depending on architecture and
+ personality. In these cases, syscall filtering and printing now
+ consistently uses the names that match corresponding __NR_* kernel
+ macros of the tracee's architecture and personality.
+ * Added strace prefix to all diagnostic messages.
+
+* Improvements
+ * Enhanced and extended test suite.
+ * Implemented reliable tracing of processes whose personality differs
+ from the personality of strace, fixed decoding of 32-bit personality
+ syscalls on 64-bit architectures.
+ * When some data referenced by syscall arguments is irrelevant or cannot
+ be read from tracee's memory, strace now prints its address consistently.
+ * When a syscall is restarted using restart_syscall mechanism, strace now
+ shows the syscall name on architectures that expose this information.
+ * Print values returned by epoll_create1, eventfd, eventfd2, fanotify_init,
+ inotify_init1, perf_event_open, pipe, pipe2, signalfd, signalfd4, socket,
+ socketpair, timerfd, and timerfd_create syscalls, as well as F_DUPFD and
+ F_DUPFD_CLOEXEC fcntl commands, as file descriptors.
+ * Optimized decoding of indirect socket syscalls.
+ * Implemented decoding of nanoseconds along with seconds in stat family
+ syscalls (addresses Fedora bug #1251176).
+ * Implemented decoding of struct statfs.f_flags in statfs syscall.
+ * Implemented decoding of siginfo_t.si_syscall and siginfo_t.si_arch
+ in SIGSYS signal.
+ * Implemented decoding of indirect syscall on mips o32.
+ * Implemented decoding of IPPROTO_IP control messages.
+ * Implemented decoding of setsockopt syscall multicast arguments.
+ * Enhanced decoding of struct sigevent.
+ * Enhanced decoding of block, loop, mtd, ptp, rtc, SG_IO, socket, tty,
+ and v4l2 ioctl syscall arguments.
+ * Enhanced decoding of epoll_create, fcntl, fcntl64, futex, getdents,
+ getdents64, getsockopt, io_*, mount, msgctl, prctl, quotactl, recvfrom,
+ sendfile, setsockopt, and shmctl syscalls.
+ * Implemented decoding of bpf, execveat, ioperm, iopl, kcmp, kexec_file_load,
+ lookup_dcookie, membarrier, memfd_create, mlock2, name_to_handle_at,
+ open_by_handle_at, sched_getattr, sched_setattr, and userfaultfd syscalls.
+ * Updated lists of AF_*, EPOLL_*, FALLOC_FL_*, F_*, INPUT_PROP_*, IPPROTO_*,
+ IPV6_*, IP_*, KEY_*, LOCK_*, MNT_*, MS_*, PACKET_*, PERF_FLAG_*, PF_*,
+ PR_*, PTRACE_O_*, RENAME_*, SCTP_*, SECBIT_*, SO_*, TCP_*, and siginfo_t
+ constants.
+ * Added Nios II architecture support.
+ * Added new syscall entries to match Linux 4.4.
+
+* Bug fixes
+ * Fixed potential short read of strings from tracee's memory.
+ * Fixed -qq option in conjunction with -o option.
+ * Fixed filtering of <unavailable> syscalls.
+ * Fixed decoding of ioctl syscall command on aarch64 and 32-bit architectures
+ with 64-bit aligned structures.
+ * Fixed decoding of eventfd2, epoll_create1, signalfd4, and sync_file_range2
+ syscall flags arguments.
+ * Fixed decoding of 4th argument of clock_nanosleep syscall.
+ * Fixed decoding of getpagesize syscall on m68k.
+ * Fixed decoding of getrandom and seccomp syscalls on aarch64.
+ * Fixed decoding of timezone argument of gettimeofday and settimeofday
+ * syscalls.
+ * Fixed decoding of offset argument of mmap2 syscall on arm, sparc,
+ and sparc64.
+ * Fixed decoding of pipe syscall on alpha and mips.
+ * Fixed decoding of pipe2 syscall on ia64, sh, sparc, and sparc64.
+ * Fixed decoding of signal mask argument of pselect6 syscall on x32.
+ * Fixed decoding of signal mask of rt_sigreturn syscall on aarch64, m68k,
+ and x32.
+ * Fixed decoding of 4th argument of semctl indirect syscall.
+ * Fixed decoding of sa_restorer and sa_mask of sigaction syscall on m68k.
+ * Fixed decoding of statfs64 and fstatfs64 syscalls on arm eabi.
+ * Fixed decoding of struct dirent on x32.
+ * Fixed decoding of times syscall return value on mips n32 and x32.
+ * Fixed decoding of path argument of umount2 syscall
+ (addresses Debian bug #785050).
+ * Worked around a kernel bug in tracing privileged executables.
+ * Fixed various errors in mapping between syscall numbers and associated
+ information like the number of syscall arguments, the name of syscall,
+ and syscall decoder.
+
+Noteworthy changes in release 4.10 (2015-03-06)
+===============================================
+
+* Improvements
+ * Added -yy option to print protocol and address information associated with
+ socket descriptors.
+ * Extended "-e read=set" and "-e write=set" options to cover sendmsg,
+ recvmsg, sendmmsg, and recvmmsg syscalls.
+ * Implemented full 32-bit decoding of ioctl commands
+ (addresses Debian bug #692913 and Fedora bug #902788).
+ * Implemented PTRACE_GETREGS API support on ia64.
+ * Implemented PTRACE_GETREGS API support on mips.
+ * Implemented PTRACE_GETREGSET API support on s390/s390x.
+ * Implemented decoding of getrandom and seccomp syscalls.
+ * Implemented full decoding of 64-bit capability sets.
+ * Implemented decoding of all prctl commands.
+ * Implemented decoding of parametrized ioctl commands.
+ * Implemented decoding of evdev ioctl commands.
+ * Implemented decoding of v4l ioctl commands.
+ * Implemented decoding of SG_IO v4 ioctl commands.
+ * Implemented decoding of FIFREEZE/FITHAW/FITRIM ioctl commands.
+ * Implemented decoding of FALLOC_FL_* fallocate flags.
+ * Implemented decoding of rt_sigreturn signal mask on aarch64,
+ x32, and x86_64.
+ * Enhanced socket decoder to support bluetooth sockets.
+ * Enhanced decoding of unlisted ioctl commands.
+ * Enhanced decoding of getsockopt and setsockopt syscall.
+ * Enhanced decoding of sysinfo syscall.
+ * Enhanced decoding of struct cmsghdr.
+ * Enhanced decoding of wait status.
+ * Enhanced aio support on non-x86 architectures by using external libaio.h.
+ * Added O_TMPFILE to the list of recognized open mode flags.
+ * Updated the list of filesystem type constants that is used in decoding
+ statfs family syscalls.
+ * Updated lists of CAP_*, PR_*, PTRACE_*, SCHED_*, SO_*, SOL_*, SWAP_FLAG_*,
+ and TFD_* constants.
+ * Updated lists of signal constants from Linux 3.19.
+ * Updated lists of errno constants from Linux 3.19.
+ * Updated lists of ioctl commands from Linux 3.9.
+ * Added new syscall entries to match Linux 3.19.
+
+* Bug fixes
+ * Fixed various errors in mapping between syscall numbers and associated
+ information like the number of syscall arguments, the name of syscall,
+ and syscall decoder.
+ * Fixed quoting issues in printing descriptors, filenames, network interface
+ names, struct utsname members, device/volume names of BLK* ioctl commands.
+ * Fixed uid_t/git_t decoding.
+ * Fixed potential out-of-bounds read issues in getdents/getdents64 decoders.
+ * Fixed potential open flags truncation on some architectures.
+ * Fixed decoding of struct ifreq.ifr_name.
+ * Fixed decoding of SIOCSIFNAME ioctl command.
+ * Fixed decoding of RENAME_* renameat2 flags.
+ * Fixed decoding of UTIME_NOW/UTIME_OMIT timeval structures.
+ * Fixed decoding of indirect ipc subcalls on some architectures.
+ * Fixed decoding of fanotify_mark syscall on 32-bit architectures.
+ * Fixed decoding of 32-bit stat structures on 64-bit architectures.
+ * Fixed decoding of 32-bit struct cmsghdr on 64-bit architectures.
+ * Fixed decoding of 32-bit preadv/pwritev offset on 64-bit architectures.
+ * Fixed decoding of sigreturn/rt_sigreturn signal mask on ia64, ppc, ppc64,
+ sparc, sparc64, mips, and s390.
+ * Fixed instruction pointer output (-i option) on architectures that support
+ several personalities.
+ * Fixed behaviour of "-e read=set" and "-e write=set" when read and write
+ sets intersect.
+ * Fixed build on systems where struct sigaction has no sa_restorer member.
+ * Fixed build with uclibc and musl libc.
+
+* Portability
+ * Linux kernel >= 2.5.46 is required.
+ Older versions without a decent PTRACE_SETOPTIONS support will not work.
+ * On mips, linux kernel >= 2.6.15 is required.
+ Older versions without a decent PTRACE_GETREGS support will not work.
+ * On s390 and s390x, linux kernel >= 2.6.27 is required.
+ Older versions without a decent PTRACE_GETREGSET support will not work.
+
+Noteworthy changes in release 4.9 (2014-08-15)
+==============================================
+
+* Changes in behavior
+ * Disabled OABI support on ARM EABI systems by default,
+ added --enable-arm-oabi option to enable it at configure time.
+
+* Improvements
+ * Added experimental -k option to print stack trace after each traced syscall.
+ * Added -w option to produce stats on syscall latency.
+ (addresses Debian bug #457497).
+ * Added ARC architecture support.
+ * Added PTRACE_GETREGS API support on PowerPC.
+ * Enhanced Bionic libc and musl libc support.
+ * Enhanced tracing of x86 personality processes on x86_64 and x32.
+ * Enhanced tracing of ARM personality processes on AArch64.
+ * Enhanced 32/64bit personality detection on PowerPC.
+ * Implemented decoding of add_key, ioprio_get, ioprio_set, kexec_load, keyctl,
+ renameat2, and request_key syscalls.
+ * Robustified decoding of select, pselect, and io_submit syscalls.
+ * Enhanced decoding of delete_module, fanotify_init, fanotify_mark, fcntl,
+ setdomainname, sethostname, setns, and sync_file_range syscalls.
+ * Enhanced decoding of signal bitmasks.
+ * Enhanced decoding of file descriptors.
+ * Enhanced siginfo_t decoding.
+ * Enhanced PF_NETLINK decoding.
+ * Updated CLOCK_* constants
+ (addresses Fedora bug #1088455).
+ * Added new syscall entries to match Linux 3.16.
+
+* Bug fixes
+ * Added shmat and shmdt to the set of memory mapping related syscalls.
+ * Fixed detaching from stopped processes.
+ * Fixed fanotify_mark decoding on 32bit architectures.
+ * Fixed offset decoding in preadv and pwritev syscalls.
+ * Fixed select decoding for glibc in _FORTIFY_SOURCE mode.
+ * Fixed decoding of epoll_ctl syscall with EPOLL_CTL_DEL argument.
+ * Fixed build when <sys/ptrace.h> and <linux/ptrace.h> conflict
+ (addresses Fedora bug #993384).
+ * Miscellaneous corrections in the manual page.
+ (Addresses Debian bug #725987).
+
+Noteworthy changes in release 4.8 (2013-06-03)
+==============================================
+
+* Changes in behavior
+ * In case of normal strace termination, when the trace output is
+ redirected to a pipe, strace now closes it and waits for the pipe
+ process termination before exit.
+
+* Improvements
+ * Implemented tracing using PTRACE_SEIZE API (when available).
+ * Implemented more reliable PTRACE_GETREGSET-based process personality
+ detection on x86-64 and x32 (when available).
+ * Added -e trace=memory option for tracing memory mapping related syscalls.
+ * Documented -b option.
+ * Allowed exit status messages to be suppressed by giving -q option twice.
+ * Added AArch64 architecture support
+ (addresses Debian bug #693074 and Fedora bug #969858).
+ * Added support for OpenRISC 1000, Meta, and Xtensa architectures.
+ * Added tilegx personality support for Tile.
+ * Enhanced support of NOMMU architectures.
+ * Enhanced decoding of getdents, mmap, perf_event_open, ptrace, and
+ quotactl syscalls.
+ * Added new syscall entries to match Linux 3.9.
+ * Regenerated the list of common ioctl names from Linux 3.9.
+ * Updated the list of errno constants.
+ * Updated lists of AF_*, MADV_*, MAP_*, MSG_*, MS_*, PF_*, PR_*,
+ PTRACE_O_*, and TCP_* constants.
+ * Implemented decoding of UBI ioctls.
+ * Removed redundant "*32" ioctl names.
+
+* Bug fixes
+ * Fixed ERESTARTNOINTR leaking to userspace on ancient kernels
+ (addresses Fedora bug #659382).
+ * Fixed kernel release string parsing
+ (addresses Debian bug #702309).
+ * Fixed decoding of *xattr syscalls
+ (addresses Fedora bug #885233).
+ * Fixed handling of files with 64-bit inode numbers by 32-bit strace
+ (addresses Fedora bug #912790).
+ * Fixed tracing forks on SPARC.
+ * Fixed decoding of fadvise64, fallocate, ftruncate64, io_submit, pread,
+ preadv, pwrite, pwritev, readahead, sigaltstack, sync_file_range, sysctl,
+ and truncate64 syscalls.
+ * Fixed categories of multiple syscalls on most of supported architectures.
+ * Fixed decoding of non-native 32-bit personality recv[m]msg syscalls.
+ * Fixed decoding of multiple 32-bit personality syscalls on x32.
+ * Fixed decoding of long long syscall arguments on ARM, MIPS/o32, PowerPC,
+ S390x, and Tile architectures.
+ * Fixed semtimedop decoding on S390x.
+ * Fixed sram_alloc decoding on Blackfin.
+ * Fixed build when process_vm_readv is a stab.
+ * Fixed build with older versions of libaio.h.
+
+Noteworthy changes in release 4.7 (2012-05-02)
+==============================================
* Changes in behavior
* strace no longer suspends waitpid until there is a child
* Linux kernel >= 2.6.18 is recommended. Older versions might still
work but they haven't been thoroughly tested with this release.
-Noteworthy changes in release 4.6
-=================================
+Noteworthy changes in release 4.6 (2011-03-15)
+==============================================
* Changes in behavior
* Print diagnostic information about changes in personality mode to
* Fixed misleading italics in the manual page.
(Addresses Debian bug #589323).
-Noteworthy changes in release 4.5.20
-====================================
+Noteworthy changes in release 4.5.20 (2010-04-13)
+=================================================
* Improvements
* Implemented decoding of new linux syscalls: inotify_init1, recvmmsg.
(Addresses Debian bug #513014)
* Corrected handling of killed threads.
-Noteworthy changes in release 4.5.19
-====================================
+Noteworthy changes in release 4.5.19 (2009-10-21)
+=================================================
* Changes in behavior
* When command exits, strace now exits with the same exit status.