-Noteworthy changes in release ?.? (????-??-??)
+Noteworthy changes in release ?.?? (????-??-??)
+===============================================
+
+Noteworthy changes in release 4.15 (2016-12-14)
+===============================================
+
+* Changes in behavior
+ * Time stamps are now printed according to ISO 8601.
+ * Changed output format of val3 parameter of futex FUTEX_WAKE_OP operation.
+ * The last argument of mincore, sched_getaffinity, and sched_setaffinity
+ syscalls is now formatted as an array.
+
+* Improvements
+ * Implemented syscall fault injection (-e fault=... option).
+ * Implemented decoding of DM_* ioctl commands.
+ * Implemented decoding of attr parameter of perf_event_open syscall.
+ * Implemented decoding of pkey_alloc, pkey_free, and pkey_mprotect syscalls.
+ * Implemented dumping of mq_timedsend and mq_timedreceive syscalls.
+ * Implemented decoding of PR_SET_FP_MODE and PR_GET_FP_MODE operations
+ of prctl syscall.
+ * Implemented PTRACE_GETREGS API support on m68k.
+ * Updated lists of ARCH_*, BPF_*, BTRFS_*, FALLOC_*, MS_*, *_MAGIC,
+ and V4L2_* constants.
+ * Updated lists of ioctl commands from Linux 4.9.
+ * Added decoding of recently added syscalls on arc, x32, and xtensa.
+ * Enhanced manual page.
+
+* Bug fixes
+ * Fixed corner cases in decoding of exit, exit_group, futimesat, getgroups,
+ getresuid, init_module, inotify_init1, kcmp, kexec_load, lookup_dcookie,
+ mq_getsetattr, mq_notify, mq_open, mq_timedreceive, mq_timedsend,
+ name_to_handle_at, prctl, process_vm_readv, process_vm_writev, setfsuid,
+ setgroups, setns, unshare, and utimes syscalls.
+ * Fixed handling of verbose flag in printing of controls array
+ of struct v4l2_ext_controls.
+ * Fixed omission of field names in the output of capability, sigaction,
+ sigevent, statfs, timespec, timeval, and utimbuf structures.
+ * Fixed printing of unknown syscalls in siginfo structure.
+ * Fixed decoding of ioctl constants on m68k.
+ * Fixed cris architecture support.
+ * Fixed cross build when host compiler does not support the same
+ set of warning flags as the cross compiler.
+ * Fixed build on SLE10 and SLE11.
+
+Noteworthy changes in release 4.14 (2016-10-04)
+===============================================
+
+* Changes in behavior
+ * When using -p option without a command and no processes has been attached,
+ strace exits with exit status 1.
+
+* Improvements
+ * Added printing of the mode argument of open and openat syscalls
+ when O_TMPFILE flag is set. (Addresses Fedora bug #1377846).
+ * Enhanced -e abbrev=set, -e raw=set, and -e verbose=set.
+ * Enhanced decoding of futex, keyctl, quotactl, timerfd_settime,
+ and aio family syscalls.
+ * Implemented fetching of the 7th subcall argument on mips o32.
+ * Updated lists of BPF_*, ETH_P_*, KEXEC_ARCH_*, SCTP_*, TCP_*, and *_MAGIC
+ constants.
+ * Updated lists of ioctl commands from Linux 4.8.
+ * Added decoding of new syscalls on sh and sh64.
+ * Added RISC-V architecture support.
+
+* Bug fixes
+ * Marked io_setup and io_destroy as memory mapping related syscalls.
+ * Fixed leakage of placeholder descriptors to tracees.
+ * Fixed printing of mode_t, umode_t, and umask types.
+ * Fixed decoding of iovec arrays without a limit on total data size.
+ * Fixed decoding of fadvise64, fallocate, futex, keyctl, quotactl, readahead,
+ and ipc family syscalls.
+ * Fixed decoding of invalid syscalls mapped to indirect subcalls.
+ * Fixed decoding of struct btrfs_ioctl_vol_args_v2 on non-native
+ personalities.
+ * Fixed decoding of PTRACE_DETACH on sparc and sparc64.
+ * Fixed decoding of struct stat64 on sparc64.
+ * Fixed decoding of uid and gid-related syscalls on sparc64.
+ * Fixed decoding of the forth argument of semctl syscall on sparc64.
+ * Fixed values of tty ioctl constants on sparc64.
+ * Fixed sparc personality support on sparc64.
+
+Noteworthy changes in release 4.13 (2016-07-26)
+===============================================
+
+* Improvements
+ * Implemented a general netlink socket parser.
+ * Enhanced decoding of socket addresses.
+ * Enhanced decoding of cmsghdr, msghdr, and mmsghdr structures.
+ * Enhanced decoding of accept, accept4, bind, getpeername, getsockname,
+ ipc, recvfrom, recvmsg, recvmmsg, sendto, sendmmsg, and socketcall syscalls.
+ * Updated lists of AF_*, BPF_MAP_TYPE_*, KEY_*, KEYCTL_*, RWF_*, SS_*,
+ and *_MAGIC constants.
+ * Updated lists of ioctl commands from Linux 4.7.
+
+* Bug fixes
+ * Fixed decoding of pid_t argument of prlimit64 syscall.
+ * Fixed sign extension issues in the parser of struct rusage.
+ * Fixed race condition in decoding of timeout argument of recvmmsg and
+ rt_sigtimedwait syscalls.
+ * Fixed build with fresh linux kernel headers.
+
+Noteworthy changes in release 4.12 (2016-05-31)
+===============================================
+
+* Improvements
+ * Implemented simultaneous use of -p option and tracing of a command.
+ (addresses Debian bug #549942).
+ * Implemented caching of netlink conversations to reduce amount of time
+ spent in decoding socket details in -yy mode.
+ * Implemented -yy mode decoding of protocol:portid pairs associated with
+ netlink socket descriptors.
+ * Implemented decoding of copy_file_range, preadv2, and pwritev2 syscalls.
+ * Implemented dumping of preadv, preadv2, pwritev, pwritev2, and vmsplice
+ syscalls.
+ * Implemented decoding of BTRFS_* and UFFDIO_* ioctl commands.
+ * Enhanced decoding of BLK*, EVIOC*, RTC_*, and VIDIOC_* ioctl commands.
+ * Enhanced decoding of fstatfs, fstatfs64, get_mempolicy, getdents,
+ getdents64, getgroups, getpriority, kill, mbind, migrate_pages, mknod,
+ mknodat, personality, poll, ppoll, quotactl, rt_sigpending,
+ rt_sigqueueinfo, rt_sigtimedwait, rt_tgsigqueueinfo, sched_getaffinity,
+ sched_setaffinity, seccomp, set_mempolicy, setgroups, setpriority, statfs,
+ statfs64, tgkill, waitid, and xattr family syscalls.
+ * Enhanced decoding of getxpid, getxuid, and getxgid syscalls on alpha.
+ * Enhanced decoding of pipe syscall on alpha, ia64, mips, sh, and sparc.
+ * Added decoding of bind, listen, and setsockopt direct syscalls on sparc.
+ * Added decoding of osf_statfs64 and osf_fstatfs64 syscalls on alpha.
+ * Added decoding of fadvise64 and fadvise64_64 on s390.
+ * Updated lists of AF_*, BPF_MAP_TYPE_*, CLONE_*, EPOLL*, IPV6_*, MADV_*,
+ MSG_*, PTRACE_*, SEGV_*, SO_*, SOL_*, *_MAGIC, and quotactl constants.
+ * Updated lists of ioctl commands from Linux 4.6.
+
+* 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 osf_shmat syscall on alpha.
+ * Fixed decoding of syscalls unknown to the kernel on s390/s390x.
+ (addresses Debian bug #485979 and Fedora bug #1298294).
+ * Fixed decoding of preadv syscall in case of short read.
+ * Fixed decoding and dumping of readv syscall in case of short read.
+ * Fixed dumping of recvmsg and recvmmsg syscalls in case of short read.
+ * Fixed decoding of mincore syscall's last argument.
+ * Fixed remaining errors in mapping between syscall numbers and numbers
+ of syscall arguments.
+ * Applied various fixes to strace-graph script.
+
+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)
==============================================