1 /* 2 * Copyright (c) 2017 The strace developers. 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #ifndef STRACE_TRACE_EVENT_H 29 #define STRACE_TRACE_EVENT_H 30 31 /* Possible trace event loop states. Returned by next_event() and dispatched by 32 * dispatch_event(). */ 33 enum trace_event { 34 /* Break the main loop. */ 35 TE_BREAK, 36 37 /* Call next_event() again. */ 38 TE_NEXT, 39 40 /* Restart the tracee with signal 0 and call next_event() again. */ 41 TE_RESTART, 42 43 /* 44 * For all the events below, current_tcp is set to current tracee's 45 * tcb. All the suggested actions imply that you want to continue 46 * tracing of the current tracee; alternatively, you can detach it. 47 */ 48 49 /* 50 * Syscall entry or exit. 51 * Restart the tracee with signal 0, or with an injected signal number. 52 */ 53 TE_SYSCALL_STOP, 54 55 /* 56 * Tracee received signal with number WSTOPSIG(*pstatus); signal info 57 * is written to *si. Restart the tracee (with that signal number 58 * if you want to deliver it). 59 */ 60 TE_SIGNAL_DELIVERY_STOP, 61 62 /* 63 * Tracee was killed by a signal with number WTERMSIG(*pstatus). 64 */ 65 TE_SIGNALLED, 66 67 /* 68 * Tracee was stopped by a signal with number WSTOPSIG(*pstatus). 69 * Restart the tracee with that signal number. 70 */ 71 TE_GROUP_STOP, 72 73 /* 74 * Tracee exited with status WEXITSTATUS(*pstatus). 75 */ 76 TE_EXITED, 77 78 /* 79 * Tracee is going to perform execve(). 80 * Restart the tracee with signal 0. 81 */ 82 TE_STOP_BEFORE_EXECVE, 83 84 /* 85 * Tracee is going to terminate. 86 * Restart the tracee with signal 0. 87 */ 88 TE_STOP_BEFORE_EXIT, 89 }; 90 91 #endif /* !STRACE_TRACE_EVENT_H */ 92