1 /* SPDX-License-Identifier: GPL-2.0-only */ 1 2 /* 3 * Access to user system call parameters and r 4 * 5 * Copyright (C) 2008-2009 Red Hat, Inc. All 6 * 7 * This file is a stub providing documentation 8 * asm-ARCH/syscall.h files need to define. M 9 * will be simple inlines. 10 * 11 * All of these functions expect to be called 12 * and only when the caller is sure that the t 13 * cannot return to user mode while we are loo 14 */ 15 16 #ifndef _ASM_SYSCALL_H 17 #define _ASM_SYSCALL_H 1 18 19 struct task_struct; 20 struct pt_regs; 21 22 /** 23 * syscall_get_nr - find what system call a ta 24 * @task: task of interest, must be bloc 25 * @regs: task_pt_regs() of @task 26 * 27 * If @task is executing a system call or is a 28 * tracing about to attempt one, returns the s 29 * If @task is not executing a system call, i. 30 * inside the kernel for a fault or signal, re 31 * 32 * Note this returns int even on 64-bit machin 33 * system call number can be meaningful. If t 34 * is 64 bits, this truncates to 32 bits so 0x 35 * 36 * It's only valid to call this when @task is 37 */ 38 int syscall_get_nr(struct task_struct *task, s 39 40 /** 41 * syscall_rollback - roll back registers afte 42 * @task: task of interest, must be in s 43 * @regs: task_pt_regs() of @task 44 * 45 * It's only valid to call this when @task is 46 * call exit tracing (due to %SYSCALL_WORK_SYS 47 * %SYSCALL_WORK_SYSCALL_AUDIT), after ptrace_ 48 * returned nonzero to prevent the system call 49 * 50 * This rolls back the register state in @regs 51 * system call instruction was a no-op. The r 52 * the system call number and arguments are as 53 * system call instruction. This may not be t 54 * register state looked like at system call e 55 */ 56 void syscall_rollback(struct task_struct *task 57 58 /** 59 * syscall_get_error - check result of traced 60 * @task: task of interest, must be bloc 61 * @regs: task_pt_regs() of @task 62 * 63 * Returns 0 if the system call succeeded, or 64 * 65 * It's only valid to call this when @task is 66 * from a system call, due to %SYSCALL_WORK_SY 67 * %SYSCALL_WORK_SYSCALL_AUDIT. 68 */ 69 long syscall_get_error(struct task_struct *tas 70 71 /** 72 * syscall_get_return_value - get the return v 73 * @task: task of interest, must be bloc 74 * @regs: task_pt_regs() of @task 75 * 76 * Returns the return value of the successful 77 * This value is meaningless if syscall_get_er 78 * 79 * It's only valid to call this when @task is 80 * from a system call, due to %SYSCALL_WORK_SY 81 * %SYSCALL_WORK_SYSCALL_AUDIT. 82 */ 83 long syscall_get_return_value(struct task_stru 84 85 /** 86 * syscall_set_return_value - change the retur 87 * @task: task of interest, must be bloc 88 * @regs: task_pt_regs() of @task 89 * @error: negative error code, or zero t 90 * @val: user return value if @error is 91 * 92 * This changes the results of the system call 93 * If @error is zero, the user sees a successf 94 * return value of @val. If @error is nonzero 95 * code; the user sees a failed system call wi 96 * 97 * It's only valid to call this when @task is 98 * from a system call, due to %SYSCALL_WORK_SY 99 * %SYSCALL_WORK_SYSCALL_AUDIT. 100 */ 101 void syscall_set_return_value(struct task_stru 102 int error, long 103 104 /** 105 * syscall_get_arguments - extract system call 106 * @task: task of interest, must be bloc 107 * @regs: task_pt_regs() of @task 108 * @args: array filled with argument val 109 * 110 * Fetches 6 arguments to the system call. Fi 111 * @args[0], and so on. 112 * 113 * It's only valid to call this when @task is 114 * entry to a system call, due to %SYSCALL_WOR 115 * %SYSCALL_WORK_SYSCALL_AUDIT. 116 */ 117 void syscall_get_arguments(struct task_struct 118 unsigned long *args 119 120 /** 121 * syscall_get_arch - return the AUDIT_ARCH fo 122 * @task: task of interest, must be bloc 123 * 124 * Returns the AUDIT_ARCH_* based on the syste 125 * 126 * It's only valid to call this when @task is 127 * call, due to %SYSCALL_WORK_SYSCALL_TRACE, % 128 * %SYSCALL_WORK_SECCOMP. 129 * 130 * Architectures which permit CONFIG_HAVE_ARCH 131 * provide an implementation of this. 132 */ 133 int syscall_get_arch(struct task_struct *task) 134 #endif /* _ASM_SYSCALL_H */ 135
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.