1 2001-03-06 John Hughes <john@Calva.COM>
3 * file.c: Implement truncate64 and ftruncate64
4 * svr4/dummy.h: add dummies for truncate64 and ftruncate64 for non
6 * svr4/syscall.h: add declarations for truncate64 and ftruncate64.
8 2001-03-06 John Hughes <john@Calva.COM>
10 * freebsd/syscalls.pl: fix for FreeBSD 4.1 (new optional field in
13 2001-03-06 John Hughes <john@Calva.COM>
15 * syscall.c: fix for FreeBSD 4.1 (SYS_semconfig has disappeared). Also
16 zap incorrect syscall subarg range check.
18 2001-03-06 John Hughes <john@Calva.COM>
20 * configure.in, defs.h, desc.c, file.c, io.c, mem.c, net.c, resource.c,
21 signal.c, syscall.c, svr4/dummy.h, svr4/syscall.h, svr4/syscallent.h:
22 merge Harald Böhme's solaris patches (_LFS64_LARGEFILE and kernel aio
25 2001-03-06 John Hughes <john@Calva.COM>
27 * dummy.h: add unimplemented UW sycalls
28 * syscall.h: we can do settimeofday for UW, whopee!
29 * syscallent.h: fix unimplemented UW syscalls
31 2001-03-06 John Hughes <john@Calva.COM>
33 * aclocal.m4: look for pr_syscall in pr_lwp if we HAVE_MP_PROCFS
34 * defs.h: add PR_SYSCALL to allow use of pr_lwp.pr_syscall if it exists.
35 * syscall.c: use PR_SYSCALL instead of pr_syscall, fix up UnixWare code
36 so it doesn't try to use pr_sysarg.
38 2001-03-06 John Hughes <john@Calva.COM>
40 * aclocal.m4: on systems other than linux look for stat64 in sys/stat.h
41 * file.c: handle xstat version _STAT64_VER, aka stat64.
43 2001-03-06 John Hughes <john@Calva.COM>
45 * net.c: make sure SOL_ options are defined before using.
46 * signal.c: declare sigset variable, only used on linux, inside #ifdef.
48 2001-02-21 Wichert Akkerman <wakkerma@debian.org>
50 * net.c: fix format for printing Unix domain sockets
52 2001-02-19 Wichert Akkerman <wakkerma@debian.org>
54 * linux/mips/syscallent.h: use new sys_sysmips
55 * system.c: add sys_sysmips decoding
57 2001-02-16 Wichert Akkerman <wakkerma@debian.org>
59 * CREDITS: add Arkadiusz Miskiewicz <misiek@pld.org.pl> who
60 submitted the IP6 scope ID updates
61 * acconfig.h: add HAVE_SIN6_SCOPE_ID and HAVE_SIN6_SCOPE_ID_LINUX
62 * aclocal.m4: add AC_SIN6_SCOPE_ID to check if sin6_scope_id is
64 * configure.in: check for if_indextoname function and sin6_scope_id
65 * net.c: teach printsock about IP6 scope ids
67 2001-02-16 Wichert Akkerman <wakkerma@debian.org>
69 * configure.in: test for netinet/tcp.h and netinet/udp.h existance
70 * net.c: include netinet/tcp.h and netinet/udp.h if they exist
71 * Makefile.in: use @mandir@ and @bindir@
73 2000-11-26 Wichert Akkerman <wakkerma@debian.org>
75 * net.c: fix formating error in sys_setsockopt
76 * net.c: add list of socketlayers and use that for [gs]etsockopt
78 2000-10-12 Wichert Akkerman <wakkerma@debian.org>
80 * time.c: use sys/timex.h so things compile with 2.2 kernels
81 * stream.c: test if MSG_* constants are #defined
83 2000-09-03 Wichert Akkerman <wakkerma@debian.org>
85 * process.c: perform bpt trick for clone as well so we can get the
86 pid of the child before it starts doing something
87 * file.c: rename dirent64 struct to kernel_dirent64 so things compile
88 again with newer libcs
89 * test/clone.c: improve our testcase a bit
90 * Merge another patch from Gäel Roualland with FreeBSD updates
92 2000-09-01 Wichert Akkerman <wakkerma@debian.org>
94 * lots of files: merge patch from Gaël Roualland to add
97 2000-08-09 Wichert Akkerman <wakkerma@debian.org>
99 * file.c: update to reflect that st_ino suddenly became a long long
100 in the in Linux 2.4.0-test6
102 2000-08-09 Wichert Akkerman <wakkerma@debian.org>
104 * test/clone.c: minor fixup
105 * Another bunch of patches from John Hughes merged:
107 + SVR4 printcontext(): sigset_t != sigset_t*
108 + getcontext returns a value, so print on exit of syscall
109 + add UC_FP to ucontext_flags for OS writers that can't spell
110 + sys_signal(): special case SIG_{ERR,DFL,IGN}
111 + decode_subcall(): only do subcall range checking when needed
112 * bunch of UnixWare updates
113 * aclocal.m4, acconfig.h, configure.in: add test for long long type
115 2000-07-04 Wichert Akkerman <wakkerma@debian.org>
117 * net.c: add SOL_PACKET and SOL_RAW socket options, update
120 2000-06-23 Wichert Akkerman <wakkerma@debian.org>
122 * strace.c: close outf before we exec a child process
124 2000-06-09 Ulrich Drepper <drepper@redhat.com>
126 * configure.in: Don't link against libnsl on Linux, it's unnecessary.
127 * defs.h (struct tcb): Make auxstr member const.
128 * file.c (fsmagic): And many more magic numbers.
129 * util.c: Don't include <linux/ptrace.h> for glibc 2.1 and up.
131 2000-04-26 Wichert Akkerman <wakkerma@debian.org>
133 * defs.h: balance #if/#endif again
134 * system.c: fix return statements in sys_capget()
135 * Merge updates from Topi Miettinen <Topi.Miettinen@nic.fi>:
136 + file.c: add F_[SG]ETSIG to fcntl flags
137 + strace.c: don't setre[gu]id if not needed
138 + system.c: handle sys_reboot for Linux
139 + term.c: add baudrate constants up to B4000000
140 + linux/**/syscallent.h: note that munlockall has no arguments
142 2000-04-25 David Mosberger <davidm@hpl.hp.com>
144 * CREDITS: fix email address
145 * process.c: handle PR_[GS]ET_UNALIGN and PR_[GS]ET_KEEPCAPS
146 * signal.c: honour offset of sigconfig in sigframe structure for
148 * linux/ia64/syscallent.h: Add perfmonctl, pivotroot, mincore, and
150 * syscall.c (syscall_enter): With Kevin's latest ptrace patches,
151 AR_BSP points to the _end_ of the active register frame, so we need
152 to adjust bsp by moving it back by the size of the active frame
155 2000-04-24 Wichert Akkerman <wakkerma@debian.org>
157 * process.c: add sparc support to change_syscall
159 2000-04-22 Wichert Akkerman <wakkerma@debian.org>
161 * linux/mips/syscallent.h: fix some typos
163 2000-04-14 Wichert Akkerman <wakkerma@debian.org>
165 * linux/mips/syscallent.h: added names for SVR4, SYSV, BSD4.3 and POSIX
168 2000-04-13 Wichert Akkerman <wakkerma@debian.org>
170 * defs.h: Linux/MIPS uses syscalls up to >4k, so set MAX_QUALS to
173 2000-04-09 Wichert Akkerman <wakkerma@debian.org>
175 * README-linux: updated to note that strace might not compile
176 with development kernels
177 * bjm.c: sys_query_module: check if malloc succeeds
178 * system.c: sys_cap[gs]et(): check if malloc succeeds, only malloc once
179 * linux/syscallent.h: updated for 2.3.99pre3
180 * linux/alpha/syscallent.h: updated for 2.3.99pre3, add all osf syscalls
181 even though Linux doesn't implement them
182 * syscall.c: add global variables for MIPS registers as well
183 * syscall.c: move global variables to before get_scno since that uses them
184 * util.c: oops, misspelled defined
185 * process.c: fix ptrace calls in change_syscall
186 * mem.c: decode sys_madvise
187 * Merge patch from Topi Miettinen <Topi.Miettinen@nic.fi>
188 + add support for quotactl, fdatasync, mlock, mlockall, munlockall & acct
189 + small fix for RLIMIT_* and RUSAGE_BOTH
190 + enhace support for capget and capset
192 2000-02-19 Wichert Akkerman <wakkerma@debian.org>
194 * test/vfork.c: new file to test vfork traces
195 * test/.cvsignore: new file
196 * defs.h: Up maximum number of traced processed to 64
197 * strace.c: Disable some debugging code from davidm
198 * implement setarg for more architectures
199 * implement change_syscall
201 1999-12-27 Morten Welinder <terra@diku.dk>
203 * syscall.c (lookup_signal, lookup_desc): isdigit requires an
204 _unsigned_ char parameter.
206 2000-02-14 Wichert Akkerman <wakkerma@debian.org>
210 2000-02-03 Wichert Akkerman <wakkerma@debian.org>
212 * Merge Linux/ia64 patches
214 2000-01-02 Pavel Machek <pavel@ucw.cz>
216 * probe if sys/poll.h exists in configure + minor cleanups
218 * syscall.c: split trace_syscall into few pieces to make code readable
220 2000-01-21 Wichert Akkerman <wakkerma@debian.org>
222 * Release version 4.2 to get the current updates out and so
223 we can concentrate in finishing the clone support.
225 2000-01-11 Wichert Akkerman <wakkerma@debian.org>
227 * Add 1900 to tm_year in sprinttime
229 1999-12-24 Wichert Akkerman <wakkerma@debian.org>
231 * file.c: protect printstat64 with STAT64 instead of linux so we can
232 compile on Linux architectures that don't have it
233 * util.c: fix LOOP for ARM
235 Fri Dec 24 18:05:00 EST 1999
237 1999-12-23 Ulrich Drepper <drepper@cygnus.com>
239 * file.c: Use ugly libc_stat trick also for stat64.
240 Implement sys_stat64, sys_fstat64, sys_lstat64, and printstat64.
241 * process.c (internal_clone): Fix a few typos and add definitions to make
243 * linux/syscall.h: Declare sys_stat64, sys_lstat64, and sys_fstat64.
244 * linux/syscallent.h: Define table entries for sys_stat64, sys_lstat64,
246 * aclocal.m4: Define AC_STAT64.
247 * acconfig.h: Define HAVE_STAT64.
248 * configure.in: Add AC_STAT64.
250 Thu Dec 23 15:01:37 CET 1999 Wichert Akkerman <wakkerma@debian.org>
252 * Merge patch from ftp://oss.software.ibm.com/linux390/ to add
253 support for Linux on the IBM S/390 architecture
254 * process.c: add internal_clone(), currently only shows the options
255 * syscall.c: use internal_clone to handle SYS_clone
257 Mon Dec 20 00:27:50 CET 1999 Wichert Akkerman <wakkerma@debian.org>
259 * Rewrite mmap-handling to support mmap2 on Linux
261 Tue Dec 14 11:35:16 CET 1999 Wichert Akkerman <wakkerma@debian.org>
263 * Note that Linux can handle sys_semop() as well
265 Tue Nov 30 11:05:26 CET 1999 Wichert Akkerman <wakkerma@debian.org>
267 * Include linux/in6.h for glibc2.0 and older
269 Mon Nov 29 16:33:04 CET 1999 Wichert Akkerman <wakkerma@debian.org>
271 * Merge patches from John Hughes to make configure support UnixWare
273 Sat Nov 27 21:38:17 CET 1999 Wichert Akkerman <wakkerma@debian.org>
275 * Enhance sys_query_module
277 Fri Nov 26 10:51:55 CET 1999 Wichert Akkerman <wakkerma@debian.org>
279 * Patches from John Hughes:
280 + cosmectic fix in sys_getpmsg
281 + allow net.c to compile on systems without AF_INET6
282 + Only use long_to_sigset on Linux systems
283 + UnixWare treats sigmask_t and sigmask_t* as the same thing
285 + Parse mount arguments for UnixWare
286 + ACL fixes for UnixWare
288 Fri Nov 26 01:28:09 CET 1999 Wichert Akkerman <wakkerma@debian.org>
290 * Release 4.1 to get all the changes made out there
292 Thu Nov 18 18:04:04 CET 1999 Wichert Akkerman <wakkerma@debian.org>
294 * Merge stracefork from Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>
295 + Socket calls parsed better
296 + bunch of alpha OSF syscalls added
297 + Fix alpha 32/64 bit issues
299 Mon Nov 1 20:52:08 CET 1999 Wichert Akkerman <wakkerma@debian.org>
301 * Move Linux kernelmodule-functions from system.c to bjm.c and
302 remove duplicate for sys_create_module
303 * Linux MIPS updates:
304 + Play with #ifdef's in net.c to get IPv6 right
305 + Use printargs for vm86-syscall
307 Sun Oct 31 22:03:00 CET 1999 Wichert Akkerman <wakkerma@debian.org>
309 * Merge Linux mips patch from Florian Lohoff <flo@rfc822.org>
311 Mon Oct 11 00:36:25 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
313 * Merge patch from Keith Owens <kaos@ocs.com.au> to sys_query_module
314 and sys_delete_module correctly
316 Wed Oct 6 02:00:33 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
318 * Update cvsbuild to give a better error if autoconf isn't installed
319 * Add test for linux/ptrace.h to configure
320 * Since we define GNU_SOURCE in the Makefile we don't need to define
321 USE_GNU in file.c anymore
323 Fri Sep 10 04:35:16 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
325 * #define USE_GNU before including file.c so we get some extra O_* flags
327 Tue Aug 31 16:27:21 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
329 * Add missing } in IPv6 output
331 Tue Aug 31 01:23:08 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
333 * Update copyright for strace-graph to BSD to be consistent with
336 Mon Aug 30 00:53:57 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
338 * Merge patch from Daniel Jacobowitz: KERN_JAVA_* and KERN_SECURELVL aren't
339 defined for all kernelversions
340 * Add strace-graph, written by Richard Braakman <dark@xs4all.nl>
342 Thu Aug 19 13:10:15 CEST 1999 Jakub Jelinek <jj@ultra.linux.cz>
344 * linux/sparc/syscall.h: Declare create_module/init_module.
345 * configure.in: Allow compilation in a different directory
347 * signal.c: Use asm/reg.h and struct regs instead of pt_regs
348 so that we don't depend on asm/ptrace.h which clashes with
351 * syscall.c: Likewise.
353 Wed Aug 4 18:01:50 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
355 * Syscall 94 on Linux alpha is sys_poll
357 Sun Jul 25 14:38:33 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
359 * Merge in UnixWare patches from John Hughes <john@Calva.COM>
361 Thu Jul 15 23:00:32 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
363 * Merge patch from Maciej W. Rozycki <macro@ds2.pg.gda.pl>:
364 + Correctly implement fix sys_createmodule (Linux)
365 + Add limited handlig of sys_initmodule (Linux)
367 Tue Jul 13 17:07:50 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
369 * Add configure-test for sys/reg.h and use that
370 * Use sys/reg.h instead of asm/ptrace.h
372 Sat Jul 10 01:46:10 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
374 * Remove hack in signal.c for arm architecture
375 * Add hack so we compile correctly on powerpc
377 Fri Jul 9 02:28:16 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
379 * Add a corrected patch from Daniel Jacobowitz
381 Thu Jul 8 16:00:04 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
383 * Merge patch from Daniel Jacobowitz to allow us to use the kernel types
384 for the stat structure
386 Thu Jun 24 15:54:18 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
388 * Fix test for sys/reg include
390 Tue Jun 22 17:26:33 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
392 * Fixed some Linux/powerpc sillyness, thanks to Daniel Jacobowitz
393 * Fixed some SunOS compile problems earlier that I forgot to include
396 Mon Jun 14 12:44:25 CEST 1999
398 * Avoid leakint fd into child when forking, patch from
399 John Hughes <john@Calva.COM>
401 Fri Jun 11 14:54:47 CEST 1999
403 * Applied IRIX64 patch from Thomas E. Dickey <dickey@clark.net>
404 * Applied Solaris and manpage updates from Guy Harris <guy@netapp.com>
406 Wed Jun 9 14:48:49 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
408 * Brought syscall list for alpha up to date
410 Wed Jun 2 18:30:12 CEST 1999 Jakub Jelinek <jj@ultra.linux.cz>
412 * system.c: sys_umount2 syscall support.
413 * linux/sparc/errnoent.h: Update sparc-linux errnos.
414 * linux/sparc/syscall.h: Update used sparc-linux syscalls.
415 * linux/sparc/syscallent.h: Match 2.2.9 system calls.
416 * file.c: sparc-linux asm/stat.h uses dev_t etc. types,
417 so it needs strace's own copy of the stat structure.
418 * util.c: Make it compile on sparc-linux.
419 * strace.c: Fix strace -f and -ff operation on sparc-linux.
420 * signal.c: rt_sigaction has different arguments on sparc*-linux
422 * syscall.c: Recognize sparc64-linux binaries.
424 Fri May 28 21:09:00 PST Ulrich Drepper <drepper@cygnus.com>
426 * configure.in: Fix typo (CFLAG -> CFLAGS).
428 * syscall.c: Don't include linux/ptrace.h explicitly for glibc.
430 Thu May 27 13:59:27 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
432 * Add some sysctl support, patch from Ulrich Drepper
434 Wed May 26 01:04:34 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
436 * Use kernel dirent structure for Linux
438 Sun May 9 02:18:30 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
440 * Merge in patches from Andreas Schwab <schwab@issan.cs.uni-dortmund.de>
441 + some layout and other minor fixes
442 + add some m68k-specific things to linux/syscallent.h. Note that m68k
443 is similar enough to i386 to not need it's own subdirectory
444 + add support for sendfile and mremap syscalls for Linux
445 * Merge in patches from Sascha Schumann <sascha@schumann.2ns.de>
446 + ioctls.h vs sys/ioctl.h on Alpha platform
447 + pointer was casted to an int in stream.c
448 + strsignal() needs -D_GNU_SOURCE in CFLAGS
449 + several other casts changed
450 + correct ARM/POWERPC architecture defines in acconfig.h
451 * Merge in patches from Morten Welinder <terra@diku.dk>
452 + add some autoconf-tests for includefiles
453 + handle solaris version of sigcontext struct (actually I hacked this
454 up again, but the idea is his :)
456 Sun Apr 18 22:32:42 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
458 * Update syscalls for linux alpha, patch from Bart Warmerdam
460 * Update sparc code so it actually compiles
462 Fri Apr 16 02:18:05 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
464 * Add support for old_*stat functions for Linux. Please note you need
465 to use reasonably recent kernel headers to compile strace now.
466 * Change references to LINUX into linux in file.c
467 * Fix include for LDT in mem.c
469 Thu Apr 15 22:28:15 CEST 1999 Wichert Akkerman <wakkerma@debian.org>
471 * Change in strace maintainership, jrs passed the torch to me.
473 * Incorporate all changes already made in the Debian strace package:
474 + compiles with more Linux kernels
475 + added support for more Linux architectures
476 + add support for a lot of extra syscalls
477 + fix some problems with hanging children
478 + check stray syscall after execv
479 + decode capget and capset arguments
480 + add more constants to net.c
481 + detect ROSE networking
482 + add more protocol families to domains
484 + added MSG_PROXY and MSG_CTRUNC to msg_flags
485 + added SO_BSDCOMPAT and SO_REUSEPORT to sockoptions
486 + added IP, IPX and TCP-options
487 + added IP, IPX and TCP support to get-/setsockopt()
489 + updated handling of signals
491 Sun Oct 27 22:28:00 1996 J. Richard Sladkey <jrs@world.std.com>
493 * util.c (umovestr) [LINUX]: Handle Linux like SunOS4
494 instead of SVR4. That is, read a few bytes at a time
495 to avoid overrunning the end of the stack.
497 Fri May 31 01:48:49 1996 J. Richard Sladkey <jrs@world.std.com>
499 * version.c: Version 3.1 is released.
501 Thu May 23 01:04:43 1996 J. Richard Sladkey <jrs@world.std.com>
503 * aclocal.m4 (AC_DECL_SYS_ERRLIST): Try looking in stdio.h
504 as well since that's where glibc declares it. Go figure.
505 * signal.c (sys_sigreturn) [ALPHA]: Use sigcontext
506 instead of sigcontext_struct since glibc v5+ apparently
507 plays games with the native OS namespace.
508 From David Mosberger-Tang <davidm@AZStarNet.com>.
510 Mon May 20 23:17:14 1996 J. Richard Sladkey <jrs@world.std.com>
512 * version.c: Version 3.0.14 is released.
514 * aclocal.m4 (AC_STRUCT_MSG_CONTROL): New macro.
515 * configure.in: Add call to AC_STRUCT_MSG_CONTROL.
516 * net.c (printmsghdr): Handle BSD 4.3 and 4.4 msghdr members
518 Reported by Henrik Storner <storner@osiris.ping.dk>.
520 * configure.in: (AC_CHECK_{HEADERS,FUNCS}): Add checks for
521 sys/filio.h and sys/stream.h and remove check for poll.
522 * desc.c (decode_select, sys_select, sys_oldselect) [LINUX]:
523 Handle old and new styles of argument passing for select on Linux.
524 * ioctl.c, stream.c: Conditionalize stream code on presence of
525 sys/stream.h instead of poll because glibc implements poll but
526 not the rest of the stream interface.
527 * signal.c [LINUX]: Standardize on the name sigcontext_struct.
528 (sys_sigprocmask) [ALPHA]: Handle OSF flavor which is more like
530 * term.c (term_ioctl): Use _VMIN, if present, for TC{G,S}ETA*.
531 * util.c (umoven, umovestr): Move data in long-sized chunks
532 at a time, instead of hard coding it to be 4.
533 From David Mosberger-Tang <davidm@AZStarNet.com>.
535 Mon May 20 01:19:36 1996 J. Richard Sladkey <jrs@world.std.com>
537 * version.c: Version 3.0.13 is released.
539 * configure.in (AC_CHECK_HEADERS): Add check for asm/sigcontext.h.
540 * signal.c [HAVE_ASM_SIGCONTEXT_H]: Conditionally include
541 asm/sigcontext.h to define sigcontext_struct and don't define it
542 locally if the header is present.
544 * syscall.c (nerrnos{0,2}): Correct size computation.
546 * Makefile.in: Remove dependencies and rules relating to files
547 normally found in the os directory. Because of the new scheme we
548 don't know precisely where they come from. Sigh.
549 * signalent.sh: Make it work for sunos4, linux, and svr4.
550 * {sunos4,linux{,/alpha},svr4}/Makefile.in: Make rules correspond
551 to traditional make syntax. Add signalent.h to files which can
552 unconditionally be rebuilt. Prevent signalent.h from being
553 unconditionally being rebuilt since it's customized.
554 * {sunos4,linux{,/alpha},svr4}/{ioctlent,errnoent,signalent}.h:
555 Use versions built by {ioctlent,errnoent,signaltent}.sh.
556 * sunos4/ioctlent.sh: Work around sprintf troubles with SunOS
559 Sun May 19 17:14:09 1996 J. Richard Sladkey <jrs@world.std.com>
561 * configure.in, Makefile.in: Add OSARCH concept to finish
562 build support for the alpha.
563 * Makefile.in, linux/Makefile.in: Rewrite clean, distclean,
564 and maintainer-clean rules.
565 * defs.h, ioctlsort.c: Make ioctl code member unsigned.
566 * ioctl.c, ioctlsort.c (compare): Perform explicit checking
567 for less, greater, and equal since subtraction on two's
568 complement numbers isn't an order relation (it isn't transitive)!
569 * linux/Makefile.in: Add rules for the signalent.h file.
570 * linux/alpha/Makefile.in: New file.
572 Sun May 19 01:12:28 1996 J. Richard Sladkey <jrs@world.std.com>
574 * version.c: Version 3.0.12 is released.
576 * linux{,alpha}/ioctlent.sh: Tweak for recent kernels.
577 From Michael E Chastain <mec@duracef.shout.net>.
579 * defs.h (SUPPORTED_PERSONALITES, DEFAULT_PERSONALITY): New.
580 * syscall.c (set_personality): New.
581 * strace.c (main): Call set_personality.
582 * defs.h, syscall.c, ioctl.c, signal.c: Make sysent, errnoent,
583 ioctlent, and signalent indirect pointers and redirect them
584 based on personality.
585 * {sunos4,svr4,linux{,/alpha}}/signalent.h: New files.
586 Suggested by Tom Dyas <tdyas@eden.rutgers.edu>.
588 * util.c (upeek): Handle case where ptrace returns a long
589 and sizeof(long) != sizeof(int).
590 From Richard Henderson <richard@twiddle.tamu.edu>
592 Fri May 17 21:03:36 1996 J. Richard Sladkey <jrs@world.std.com>
594 * version.c: Version 3.0.11 is released.
596 * many files: Fix more printf warnings for other platforms.
598 * ipc.c (sys_msgrcv) [LINUX]: Conditionalize definition of ipc_wrapper.
600 * linux/dummy.h: Handle missing library support for {send,recv}msg.
601 Reported by Thomas Bogendoerfer <tsbogend@bigbug.franken.de>.
603 * linux/syscall.h (sys_utimes): Fix a typo in the declaration.
604 From Thomas Bogendoerfer <tsbogend@bigbug.franken.de>.
606 Fri May 17 00:50:06 1996 J. Richard Sladkey <jrs@world.std.com>
608 * version.c: Version 3.0.10 is released.
610 * Makfile.in: Add os/arch to includes so that a given arch
611 (like alpha) can override the native arch (like i386).
612 * configure.in: Check for sendmsg.
614 * net.c: Make sendmsg and recvmsg dependent on an autoconf
615 test. Reported by Michael E Chastain <mec@duracef.shout.net>.
617 * acconfig.h, configure.in: Detect the alpha.
618 * ioctl.c: Handle the alpha.
619 * defs.h: Make some members long for the alpha. Define
620 some register nicknames. Add support for WAITEXECVE.
621 * file.c [ALPHA]: Support the alpha for statfs. Add
622 osf_statfs and osf_fstatfs for the alpha. Make damn sure
623 major and minor results are suitable for passing to printf.
624 * signal.c, syscall.c: Support the alpha.
625 * process.c: Add alpha user offsets.
626 * most files: Use %l? for printf arguments since
627 most are now longs for the alpha.
628 * linux/alpha/{errnoent.h,ioctlent.{h,sh},syscallent.h}:
630 From Thomas Bogendoerfer <tsbogend@bigbug.franken.de>.
632 Wed May 15 00:29:37 1996 J. Richard Sladkey <jrs@world.std.com>
634 * version.c: Version 3.0.9 is released.
636 * config.in, config.sub, install-sh: Upgrade to autoconf 2.10.
638 * linux/dummy.h, linux/syscallent.h, linux/syscall.h: Add recent
639 Linux kernel version system calls.
641 Wed Mar 13 01:03:38 1996 J. Richard Sladkey <jrs@world.std.com>
643 * ipc.c [SUNOS4]: Add SunOS support for decoding IPC calls.
644 * syscall.c [SUNOS4]: Compile decode_subcall on SunOS and
645 decode IPC calls using it.
646 * sunos4/dummy.h: Alias sys_semop to printargs.
647 * sunos4/syscall.h: Add new pseudo syscalls for IPC.
648 * sunos4/syscallent.h: Include new subcalls for IPC.
649 From Matthias Pfaller <leo@dachau.marco.de>.
651 Tue Feb 13 22:08:25 1996 J. Richard Sladkey <jrs@world.std.com>
653 * version.c: Version 3.0.8 is released.
655 * time.c [LINUX]: Explicitly include linux/version.h.
657 * strace.c (main): Don't let them even *try* to
658 get strace to attach to itself since some systems
659 don't handle this case very gracefully.
660 Reported by David S. Miller <davem@caip.rutgers.edu>.
662 * Makefile.in (distclean): Fix it for subdirectories.
664 * sunos4/syscallent.h, svr4/syscallent.h: Fill in the new
665 sys_flags member for each defined system call.
667 Fri Dec 8 01:17:28 1995 Rick Sladkey <jrs@world.std.com>
669 * defs.h (TRACE_*): New flags to describe what class
670 of system call each system call is.
671 (sysent): Add sys_flags member.
672 * syscall.c (sysent): Define (and later undef) abbreviations
673 for the system call class flags.
674 (lookup_class): New function to translate strings to
675 system call class flags.
676 (qualify): Handle new system call class mechanism.
677 * linux/syscallent.h: Fill in the new sys_flags member
678 for each defined system call.
680 * defs.h (print_sock): Remove redundant and non-K&R C
681 compatible prototype. From Juergen Weigert
682 <jnweiger@immd4.informatik.uni-erlangen.de>.
684 Thu Dec 7 01:17:40 1995 Rick Sladkey <jrs@world.std.com>
686 * linux/ioctlent.sh: Tweak to improve ioctl accuracy.
687 From Michael E Chastain <mec@duracef.shout.net>.
689 * system.c (includes) [LINUX]: Add linux/nfs.h for recent
690 kernels. From Michael E Chastain <mec@duracef.shout.net>.
692 Wed Dec 6 21:52:28 1995 Rick Sladkey <jrs@world.std.com>
694 * file.c (sprintfstype): Enclose string result in double
697 * time.c (sys_adjtimex) [LINUX]: Conditionalize
698 constantly evolving timex structure.
699 From Aaron Ucko <UCKO@VAX1.ROCKHURST.EDU>.
701 * defs.h, syscall.c, strace.c: Rename syscall to
702 trace_syscall and change prototype and all callers
703 because of broken Linux shared libraries.
704 From Aaron Ucko <UCKO@VAX1.ROCKHURST.EDU>.
706 * Makefile.in (clean): Check for a file with test -f not
707 test -d. From Aaron Ucko <UCKO@VAX1.ROCKHURST.EDU>.
709 Tue Sep 26 02:32:31 1995 Rick Sladkey <jrs@world.std.com>
711 * version.c: Version 3.0.7 is released.
713 * util.c (string_quote): Fix thinko which caused core
714 dumps for strings with quotes in them.
715 Reported by Marty Leisner <leisner@sdsp.mc.xerox.com>.
717 * linux/Makefile.in (errnoent.h rule): Grab all errno.h
718 files from /usr/include, not just the linux one.
719 From Michael E Chastain <mec@duracef.shout.net>.
721 * linux/errnoent.sh: Total rewrite to handle more ioctls with
722 fewer false positives on more kernel flavors.
723 From Michael E Chastain <mec@duracef.shout.net>.
725 Mon Sep 4 01:29:22 1995 Rick Sladkey <jrs@world.std.com>
727 * version.c: Version 3.0.6 is released.
729 * linux/dummy.h, linux/syscall.h, linux/syscallent.h: Add
731 * mem.c (mctl_funcs, mctl_lockas, sys_mctl): Conditionalize
732 on MC_SYNC instead of HAVE_MCTL.
733 (mctl_sync): Conditionalize on MS_ASYNC instead of HAVE_MCTL.
734 (sys_msync): New function.
736 Sat Sep 2 12:06:04 1995 Rick Sladkey <jrs@world.std.com>
738 * linux/dummy.h, linux/syscall.h, linux/syscallent.h: Add
739 sys_flock and sys_getdents.
740 * desc.c (flockcmds, sys_flock): Conditionalize on LOCK_SH
742 * file.c (sys_getdents): Define unconditionally and handle
744 * strace.c (main): Disallow username option unless both real
745 and effective uids are root.
747 Wed Aug 30 01:29:58 1995 Rick Sladkey <jrs@world.std.com>
749 * strace.c (main): Ensure that run_uid and run_gid are
750 always set to something meaningful.
751 (main, newoutf) [!SVR4]: Swap real and effective uids while
752 opening any output files.
753 (main) [!SVR4]: Treat effective uid of root as a request
754 to handle suid binaries correctly using the real uid of
757 Sat Aug 19 00:06:08 1995 Rick Sladkey <jrs@world.std.com>
759 * Makefile.in: Add `|| true' to clean rule because
760 although GNU make 3.74 uses `sh -c' to invoke commands
761 every other make in the world uses `sh -ec'.
763 * syscall.c (syscall) [SVR4, MIPS]: The fifth and subsequent
764 arguments appear to be stored on the stack, not in the
765 registers following A3 (empirical result).
767 * defs.h: Add prototype for printsock.
768 * svr4/dummy.h: Remove generic handling of sys_mount.
769 * system.c [SVR4, MIPS]: Include several system headers to cleanly
770 get access to SGI mount information.
771 (mount_flags, nfs_flags) [SVR4, MIPS]: New objects.
772 (sys_mount) [SVR4, MIPS]: New function.
773 (sys_mount) [SVR4, !MIPS]: New function.
775 Tue Jul 4 00:30:34 1995 Rick Sladkey <jrs@world.std.com>
777 * version.c: Version 3.0.5 is released.
779 * desc.c, resource.c, strace.c, syscall.c, time.c: Cast tv_sec and
780 tv_usec members to long when using printf.
782 * ipc.c: Omit define of __KERNEL__.
783 ({MSG,SEM,SHM}_{STAT,INFO}): Explicitly define those things we
784 want which __KERNEL__ used to provide.
785 (sys_msgrcv): Change reference to ipc_kludge structure to
786 look-alike ipc_wrapper to avoid dependence on __KERNEL__.
788 mem.c (mmap_flags) [MAP_{GROWSDOWN,DENYWRITE,EXECUTABLE}]: Add
789 Linux specific options.
791 syscall.c: Use SYS_ERRLIST_DECLARED instead of guessing.
792 [E{RESTART{SYS,NO{INTR,HAND}},NOIOCTLCMD}]: Explicitly define
793 instead of depending of __KERNEL__.
795 term.c: Cast c_{i,o,c,l}flag to long when using printf.
797 Tue Jun 6 00:27:48 1995 Rick Sladkey <jrs@world.std.com>
799 * aclocal.m4 (AC_DECL_SYS_ERRLIST, AC_DECL__SYS_SIGLIST): New.
800 * configure.in: Call AC_DECL_SYS_ERRLIST, AC_DECL_SYS_SIGLIST,
801 and AC_DECL__SYS_SIGLIST.
802 * acconfig.h (SYS_ERRLIST_DECLARED): New.
803 * strace.c (strerror): Use SYS_ERRLIST_DECLARED.
804 (strsignal): Use SYS_SIGLIST_DECLARED.
806 net.c (sys_socket): Omit inadvertent surplus comma when
807 protocol family isn't PF_INET.
809 util.c (dumpstr): Fix incorrect printing of one too many
810 characters when the length is not an even multiple of 16 bytes.
811 Reported by Juergen Weigert
812 <jnweiger@immd4.informatik.uni-erlangen.de>.
814 Thu May 4 23:37:47 1995 Rick Sladkey <jrs@world.std.com>
816 * ioctl.c (compare): Change prototype to match POSIX qsort.
817 * signal.c (sigishandled) [SVR4]: Omit everything after return.
818 * strace.c (trace) [SVR4]: Break out of for loop instead of
819 returning when finished so final return statement is executed.
820 * syscall.c (internal_syscall): Add more SYS_wait* variations.
821 (syscall) [LINUX]: Correct typo which commented out the M68K
823 * util.c (printstr): Cast unsigned char pointer argument
824 to char pointer in umovestr call.
825 (dumpstr): Likewise for umoven.
827 Wed May 3 01:10:56 1995 Rick Sladkey <jrs@world.std.com>
829 * version.c: Version 3.0.4 is released.
831 * signal.c (sys_sigblock): Move after the definition of
832 sys_sigsetmask that it calls to avoid an implicit declaration.
833 * stream.c (transport_user_options, transport_server_options):
834 Only needed if TI_BIND is defined.
835 * configure.in: Add -Wno-implicit to WARNFLAGS on SunOS 4.x.
837 * process.c (internal_fork) [SVR4]: Fix a typo that omitted
838 the tcp arguement from the call to exiting. Add getrval2
839 check so no fork processing is done in the child.
840 (printwaitn): Initialize exited so that its value is defined
841 for all flows of execution.
843 Tue May 2 22:39:42 1995 Rick Sladkey <jrs@world.std.com>
845 * linux/dummy.h: Add aliases for sysfs, personality, afs_syscall,
846 setfsuid, setfsgid, and _llseek syscalls.
847 * linux/syscall.h: Add prototypes for them.
848 * linux/syscallent.h: Add them to the syscall entries table.
849 * system.c (headers) [LINUX]: Include linux/unistd.h to get __NR_*
850 defines and conditionally include linux/personality.h if
851 __NR_personality is defined.
852 (personality_options) [LINUX]: New table.
853 (sys_personality) [LINUX]: New function.
855 Tue May 2 00:20:39 1995 Rick Sladkey <jrs@world.std.com>
857 * strace.c (trace) [!SVR4]: Change forever loop to one predicated
858 on the number of traced processes so that we can have untraced
859 children (e.g. via popen).
861 * strace (main) [!SVR4]: Call fake_execve to get the actual
862 exec and its arguments into the trace.
863 (environ): Declare it.
864 * process.c (fake_execve): New function.
865 (headers): Include sys/syscall.h to get SYS_* defines.
867 * process.c (sys_execv, sys_execve): Surround argument annotations
868 with C comment delimiters.
869 (printargv, printargc): The arg vector is an array of char pointers
872 * strace.c (printleader): Also check for multiple -p arguments
873 when deciding whether to print the pid field.
875 * strace.c (strerror) [!HAVE_STRERROR]: New function.
876 * defs.h (strerror, strsignal): Add these prototypes if we provide
878 * configure.in (AC_CHECK_FUNCS): Add strerror.
880 * strace.c (main, proc_poller): Add SIGPIPE to the list of caught
883 * strace.c (main): Add username option. Verify they are root before
884 letting them use it. Look up the ids in the password file. Set
885 them just before executing the program.
886 From Reuben Sumner <rasumner@undergrad.math.uwaterloo.ca>.
888 Sat Apr 29 00:09:56 1995 Rick Sladkey <jrs@world.std.com>
890 * version.c: Version 3.0.3 is released.
892 * system.c (mount_flags) [LINUX]: Omit duplicated MS_NOSUID entry.
893 From Reuben Sumner <rasumner@undergrad.math.uwaterloo.ca>.
895 * strace.c (outfname): Initialize to NULL.
896 (main): Defer output file processing until after arguments.
897 Allow either a pipe or a bang for command arguments.
898 Check if outfname is NULL instead of checking outf for stderr.
899 Reinitialize each startup TCB's outf to fix -p/-o ordering bug.
900 (droptcb): Reset close TCB's outf to NULL instead of stderr.
901 (tprintf): Avoid calling vfprintf if outf is NULL.
903 * strace.c (main): Use popen if -o argument begins with a pipe.
904 From Marty Leisner <leisner@sdsp.mc.xerox.com>.
906 * process.c (printstatus): Fix a typo where WIFSIGNALED was meant
907 but WIFSTOPPED was used.
909 * Makefile.in: Add an EXTRA_DEFS variable and use it in the .c.o
910 rule to prevent the comment from being untrue.
912 Fri Apr 28 22:01:56 1995 Rick Sladkey <jrs@world.std.com>
914 * strace.c (sys_exit): Move follow fork code to internal_exit.
915 (sys_fork): Move follow fork code to internal_fork.
916 (sys_execv, sys_execve): Move follow fork code to internal_exec.
917 (sys_waitpid, sys_wait4): Move follow fork code to internal_wait.
918 (vforking): Remove this static variable and check scno in
919 internal_fork instead.
920 (internal_exit, internal_fork, internal_exec, internal_wait): New
922 * defs.h: Add prototypes for the new internal_* functions.
923 * syscall.c (syscall): Move syscall entering trace qualifier check
924 and reprint checking after context decoding and precede them with
925 a call to internal_syscall. Precede syscall exiting trace
926 qualifier check with a call to internal_syscall.
927 (internal_syscall): New function.
929 * defs.h (struct tcb): Make scno signed.
930 * strace.c (syscall) Make u_error signed.
931 [LINUX, I386]: Avoid unsigned cast in eax check.
932 * syscall.c (sys_indir): Make i, scno, and nargs signed.
933 * desc.c (sys_select): Make cumlen unsigned
935 Mon Apr 24 23:52:47 1995 Rick Sladkey <jrs@world.std.com>
937 * net.c (socktypes): Add SOCK_PACKET.
939 Sun Apr 2 23:50:39 1995 Rick Sladkey <jrs@world.std.com>
941 * Makefile (clean): Check explicitly for a Makefile in subdirs
942 before running make in them.
944 Sun Mar 26 12:37:21 1995 Rick Sladkey <jrs@world.std.com>
946 * strace.c [MIPS] (proc_open): Conditionalize run on MIPS.
947 [MIPS] (detach): Initialize error for MIPS case.
948 (trace): Initialize ioctl_result and ioctl_errno for overly helpful
950 * syscall.c (decode_subcall): Move variable i into conditionals
952 * system.c (syssgi_options): Conditionalize SGI_RECVLMSG and
953 SGI_SET_FPDEBUG that SGI decided to drop. I don't have the stomach
955 * term.c (term_ioctl): Force [c_[iocl]flags members to long before
956 printing since we don't know what the size of their type is.
957 * util.c [SVR4, MIPS] (umoven): Prevent MIPS from using pread even
958 if autoconf detects it since it seems to either not work or do
959 something else entirely on Irix 5.3.
961 Sun Mar 26 00:01:11 1995 Rick Sladkey <jrs@world.std.com>
963 * version.c: Version 3.0.2 is released.
964 * linux/dummy.h: Make sys_fchdir like sys_close instead of printargs
965 so that the file descriptor arg is decimal.
967 Sat Mar 25 22:50:13 1995 Rick Sladkey <jrs@world.std.com>
969 * net.c [LINUX] (protocols): Explicitly define all IPPROTO_* entries
970 because on Linux they are enumerators.
972 * system.c [LINUX] (mount_flags): Handle renaming of MS_SYNC to
975 * util.c (printxval): When there is no translation, print the actual
976 number first and the the default value as a C comment.
978 * net.c (sys_send, sys_sendto, sys_sendmsg, sys_getsockopt,
979 sys_setsockopt): Change first argument from unsigned to signed to
980 cater to the frequent practice of calling system calls with a file
982 * mem.c (sys_mmap): Likewise.
984 Sun Mar 19 13:53:52 1995 Rick Sladkey <jrs@world.std.com>
986 * signal.c [LINUX] (signalent): Handle old and new values of SIGIO.
988 Sun Dec 11 22:51:51 1994 Rick Sladkey <jrs@world.std.com>
990 * version.c: Version 3.0.1 is released.
991 * Makefile.in, configure.in, aclocal.m4: Changes for autoconf 2.0.
992 * config.guess, config.guess: Update from the FSF.
993 * install-sh: New from the FSF.
995 Mon Dec 5 20:51:29 1994 Rick Sladkey <jrs@world.std.com>
997 * Makefile.in: Add m68k arch.
998 * acconfig.h (M68K): Add m68k define.
999 * configure.in: Add detection of arch m68k.
1000 * process.c [M68K] (struct_user_offsets): Support m68k registers and
1002 * signal.c [M68K] (sigcontext_struct): Support m68k sigcontext
1004 [M68K] (sys_sigreturn): Support m68k sigreturn handling.
1005 * syscall.c [M68K] (syscall): Support m68k syscall number register
1006 and errno in d0 instead of eax.
1007 * util.c [M68K] (getpc, printcall, setbpt, clearbpt): Support m68k
1008 program counter in PT_PC instead of EIP.
1009 [M68K] (LOOP): Support m68k loop instruction.
1010 From Andreas Schwab <schwab@issan.informatik.uni-dortmund.de>.
1012 * mem.c [MAP_ANONYMOUS] (mmap_flags): Correct inadvertent reference
1013 to MAP_FIXED instead of MAP_ANONYMOUS.
1014 From Andreas Schwab <schwab@issan.informatik.uni-dortmund.de>.
1016 * signal.c [LINUX] (signalent): Signal 30 is now SIGPWR.
1017 From Andreas Schwab <schwab@issan.informatik.uni-dortmund.de>.
1019 Mon Dec 5 01:05:46 1994 Rick Sladkey <jrs@world.std.com>
1021 * defs.h (tprintf): Fix typo in non-gcc ansi prototype for tprintf.
1022 Reported by Thanh Ma <tma@encore.com>.
1024 * strace.c (cleanup): Send SIGCONT before SIGTERM because Linux
1025 1.1.62 doesn't continue a traced child when the parent exits.
1026 Reported by Matt Day <mday@artisoft.com>.
1028 * system.c [LINUX]: Include netinet/in.h before arpa/inet.h.
1030 * util.c (printstr): Fix longstanding bug in notating string
1033 * strace.c [SVR4] (proc_open): Specifically wait for the child the
1034 child to go into the execve syscall to avoid spurious traces.
1035 [LINUX] (detach): Conditionalize the status variable.
1037 Sun Dec 4 23:21:42 1994 Rick Sladkey <jrs@world.std.com>
1039 * Makefile.in: Add mips arch.
1040 * acconfig.h (MIPS): Add mips define.
1041 * configure.in: Add detection of opsys irix5 and arch mips. Check
1043 Check for sys/sysconfig.h header.
1044 * defs.h (MAX_ARGS): Bump maximum syscall arguments from 8 to 32.
1045 * file.c [SVR4]: Include sys/cred.h.
1046 (access_flags): Update access flags for SGI.
1047 (sprinttime): Change type of sprinttime argument from unsigned
1049 * process.c [HAVE_PRCTL]: Include sys/prctl.h.
1050 [HAVE_PRCTL] (prctl_options, sys_prctl): New for SGI.
1051 (printsiginfo): Conditionally compile SI_TIMER and SI_MESGQ.
1052 Cast si_band member to long before printing.
1053 * signal.c (sigact_flags): Add _SA_BSDCALL for SGI.
1054 (sigprocmaskcmds): Add SIG_SETMASK32 for SGI.
1055 * strace.c [SVR4] [MIPS]:
1056 (foobar): New dummy signal handler.
1057 (main): Install a dummy signal handler in the child before pausing
1058 to work around an SGI bug in PRSABORT.
1059 (proc_open): Send a interrupt to the child instead of aborting the
1060 syscall which doesn't work on Irix5.2.
1061 * svr4/dummy.h: Add new unfinished SGI syscalls
1062 (e.g. sys_sysmp, sys_sginap, etc.). Handle some SGI syscalls like
1063 existing calls (e.g. sys_ksigaction like sys_sigaction).
1064 Printargs does the print thing for sys_sethostid.
1065 * svr4/syscall.h: Declare all new SGI syscalls.
1066 (SGI_KLUDGE): Define syscall table starting index to be 1 for SGI
1067 and add it to all subcall entry points.
1068 (SYS_pgrpsys_subcall, SYS_sigcall_subcall, SYS_context): Don't
1069 decode as subcalls on MIPS. Instead, use the normal syscalls.
1070 * svr4/syscallent.h [MIPS]: Lead syscall table with a dummy entry
1071 since SGI syscall numbers are off by one.
1072 [MIPS] (sys_pgrpsys): Rename to sys_setpgrp on SGI.
1073 [MIPS] (sys_xenix): Rename to sys_syssgi on SGI.
1074 [MIPS] (sys_sysmachine): Rename to sys_sysmips on SGI.
1075 [MIPS]: Conditionalize SVR4 extension into SGI and Solaris classes.
1076 * syscall.c (dumpio): Validate descriptor against MAX_QUALS.
1077 [HAVE_PR_SYSCALL] (syscall): Conditionalize SYS_vfork.
1078 [MIPS] (syscall): Add SGI section for decoding u_error and u_rval.
1079 Add workaround for broken SGI pr_sysarg on syscall entry.
1080 [SVR4] (syscall): Conditionalize subcall decoding for
1081 SYS_ptrpsys_subcall, SYS_sigcall_subcall and SYS_context_subcall.
1082 [SVR4] [MIPS] (getrval2): Handle SGI.
1083 * syscallent.sh: Dork the sed line to be choosier about SYS_ lines.
1084 * system.c [HAVE_SYSCONFIG_H]: Include sys/sysconfig.h.
1085 [MIPS] (syssgi_options, sys_syssgi): New for SGI.