/* * Access to user system call parameters and results * * Copyright (C) 2008-2009 Red Hat, Inc. All rights reserved. * * This copyrighted material is made available to anyone wishing to use, * modify, copy, or redistribute it subject to the terms and conditions * of the GNU General Public License v.2. * * This file is a stub providing documentation for what functions * asm-ARCH/syscall.h files need to define. Most arch definitions * will be simple inlines. * * All of these functions expect to be called with no locks, * and only when the caller is sure that the task of interest * cannot return to user mode while we are looking at it. */ #ifndef _ASM_SYSCALL_H #define _ASM_SYSCALL_H 1 struct task_struct; struct pt_regs; /** * syscall_get_nr - find what system call a task is executing * @task: task of interest, must be blocked * @regs: task_pt_regs() of @task * * If @task is executing a system call or is at system call * tracing about to attempt one, returns the system call number. * If @task is not executing a system call, i.e. it's blocked * inside the kernel for a fault or signal, returns -1. * * Note this returns int even on 64-bit machines. Only 32 bits of * system call number can be meaningful. If the actual arch value * is 64 bits, this truncates to 32 bits so 0xffffffff means -1. * * It's only valid to call this when @task is known to be blocked. */ int syscall_get_nr(struct task_struct *task, struct pt_regs *regs); /** * syscall_rollback - roll back registers after an aborted system call * @task: task of interest, must be in system call exit tracing * @regs: task_pt_regs() of @task * * It's only valid to call this when @task is stopped for system * call exit tracing (due to TIF_SYSCALL_TRACE or TIF_SYSCALL_AUDIT), * after tracehook_report_syscall_entry() returned nonzero to prevent * the system call from taking place. * * This rolls back the register state in @regs so it's as if the * system call instruction was a no-op. The registers containing * the system call number and arguments are as they were before the * system call instruction. This may not be the same as what the * register state looked like at system call entry tracing. */ void syscall_rollback(struct task_struct *task, struct pt_regs *regs); /** * syscall_get_error - check result of traced system call * @task: task of interest, must be blocked * @regs: task_pt_regs() of @task * * Returns 0 if the system call succeeded, or -ERRORCODE if it failed. * * It's only valid to call this when @task is stopped for tracing on exit * from a system call, due to %TIF_SYSCALL_TRACE or %TIF_SYSCALL_AUDIT. */ long syscall_get_error(struct task_struct *task, struct pt_regs *regs); /** * syscall_get_return_value - get the return value of a traced system call * @task: task of interest, must be blocked * @regs: task_pt_regs() of @task * * Returns the return value of the successful system call. * This value is meaningless if syscall_get_error() returned nonzero. * * It's only valid to call this when @task is stopped for tracing on exit * from a system call, due to %TIF_SYSCALL_TRACE or %TIF_SYSCALL_AUDIT. */ long syscall_get_return_value(struct task_struct *task, struct pt_regs *regs); /** * syscall_set_return_value - change the return value of a traced system call * @task: task of interest, must be blocked * @regs: task_pt_regs() of @task * @error: negative error code, or zero to indicate success * @val: user return value if @error is zero * * This changes the results of the system call that user mode will see. * If @error is zero, the user sees a successful system call with a * return value of @val. If @error is nonzero, it's a negated errno * code; the user sees a failed system call with this errno code. * * It's only valid to call this when @task is stopped for tracing on exit * from a system call, due to %TIF_SYSCALL_TRACE or %TIF_SYSCALL_AUDIT. */ void syscall_set_return_value(struct task_struct *task, struct pt_regs *regs, int error, long val); /** * syscall_get_arguments - extract system call parameter values * @task: task of interest, must be blocked * @regs: task_pt_regs() of @task * @i: argument index [0,5] * @n: number of arguments; n+i must be [1,6]. * @args: array filled with argument values * * Fetches @n arguments to the system call starting with the @i'th argument * (from 0 through 5). Argument @i is stored in @args[0], and so on. * An arch inline version is probably optimal when @i and @n are constants. * * It's only valid to call this when @task is stopped for tracing on * entry to a system call, due to %TIF_SYSCALL_TRACE or %TIF_SYSCALL_AUDIT. * It's invalid to call this with @i + @n > 6; we only support system calls * taking up to 6 arguments. */ void syscall_get_arguments(struct task_struct *task, struct pt_regs *regs, unsigned int i, unsigned int n, unsigned long *args); /** * syscall_set_arguments - change system call parameter value * @task: task of interest, must be in system call entry tracing * @regs: task_pt_regs() of @task * @i: argument index [0,5] * @n: number of arguments; n+i must be [1,6]. * @args: array of argument values to store * * Changes @n arguments to the system call starting with the @i'th argument. * Argument @i gets value @args[0], and so on. * An arch inline version is probably optimal when @i and @n are constants. * * It's only valid to call this when @task is stopped for tracing on * entry to a system call, due to %TIF_SYSCALL_TRACE or %TIF_SYSCALL_AUDIT. * It's invalid to call this with @i + @n > 6; we only support system calls * taking up to 6 arguments. */ void syscall_set_arguments(struct task_struct *task, struct pt_regs *regs, unsigned int i, unsigned int n, const unsigned long *args); /** * syscall_get_arch - return the AUDIT_ARCH for the current system call * * Returns the AUDIT_ARCH_* based on the system call convention in use. * * It's only valid to call this when current is stopped on entry to a system * call, due to %TIF_SYSCALL_TRACE, %TIF_SYSCALL_AUDIT, or %TIF_SECCOMP. * * Architectures which permit CONFIG_HAVE_ARCH_SECCOMP_FILTER must * provide an implementation of this. */ int syscall_get_arch(void); #endif /* _ASM_SYSCALL_H */
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
bitops | Folder | 0755 |
|
|
4level-fixup.h | File | 1.07 KB | 0644 |
|
5level-fixup.h | File | 1.15 KB | 0644 |
|
asm-offsets.h | File | 35 B | 0644 |
|
asm-prototypes.h | File | 507 B | 0644 |
|
atomic-long.h | File | 7.09 KB | 0644 |
|
atomic.h | File | 5.11 KB | 0644 |
|
atomic64.h | File | 2.26 KB | 0644 |
|
audit_change_attr.h | File | 484 B | 0644 |
|
audit_dir_write.h | File | 500 B | 0644 |
|
audit_read.h | File | 241 B | 0644 |
|
audit_signal.h | File | 36 B | 0644 |
|
audit_write.h | File | 461 B | 0644 |
|
barrier.h | File | 6.01 KB | 0644 |
|
bitops.h | File | 1.09 KB | 0644 |
|
bitsperlong.h | File | 592 B | 0644 |
|
bug.h | File | 6.6 KB | 0644 |
|
bugs.h | File | 267 B | 0644 |
|
cache.h | File | 384 B | 0644 |
|
cacheflush.h | File | 1.31 KB | 0644 |
|
checksum.h | File | 2.27 KB | 0644 |
|
clkdev.h | File | 706 B | 0644 |
|
cmpxchg-local.h | File | 1.43 KB | 0644 |
|
cmpxchg.h | File | 2.23 KB | 0644 |
|
current.h | File | 256 B | 0644 |
|
delay.h | File | 1.13 KB | 0644 |
|
device.h | File | 245 B | 0644 |
|
div64.h | File | 7.28 KB | 0644 |
|
dma-contiguous.h | File | 238 B | 0644 |
|
dma.h | File | 553 B | 0644 |
|
early_ioremap.h | File | 1.66 KB | 0644 |
|
emergency-restart.h | File | 248 B | 0644 |
|
exec.h | File | 697 B | 0644 |
|
export.h | File | 2.2 KB | 0644 |
|
extable.h | File | 802 B | 0644 |
|
fb.h | File | 271 B | 0644 |
|
fixmap.h | File | 2.84 KB | 0644 |
|
ftrace.h | File | 460 B | 0644 |
|
futex.h | File | 2.88 KB | 0644 |
|
getorder.h | File | 1.22 KB | 0644 |
|
gpio.h | File | 4.45 KB | 0644 |
|
hardirq.h | File | 532 B | 0644 |
|
hugetlb.h | File | 845 B | 0644 |
|
hw_irq.h | File | 270 B | 0644 |
|
ide_iops.h | File | 791 B | 0644 |
|
int-ll64.h | File | 932 B | 0644 |
|
io.h | File | 20.39 KB | 0644 |
|
ioctl.h | File | 506 B | 0644 |
|
iomap.h | File | 3.16 KB | 0644 |
|
irq.h | File | 403 B | 0644 |
|
irq_regs.h | File | 980 B | 0644 |
|
irq_work.h | File | 194 B | 0644 |
|
irqflags.h | File | 1.51 KB | 0644 |
|
kdebug.h | File | 182 B | 0644 |
|
kmap_types.h | File | 198 B | 0644 |
|
kprobes.h | File | 868 B | 0644 |
|
kvm_para.h | File | 480 B | 0644 |
|
linkage.h | File | 225 B | 0644 |
|
local.h | File | 2.23 KB | 0644 |
|
local64.h | File | 3.8 KB | 0644 |
|
mcs_spinlock.h | File | 260 B | 0644 |
|
memory_model.h | File | 2.16 KB | 0644 |
|
mm-arch-hooks.h | File | 388 B | 0644 |
|
mm_hooks.h | File | 885 B | 0644 |
|
mmu.h | File | 449 B | 0644 |
|
mmu_context.h | File | 881 B | 0644 |
|
module.h | File | 1.09 KB | 0644 |
|
msi.h | File | 838 B | 0644 |
|
page.h | File | 2.4 KB | 0644 |
|
param.h | File | 367 B | 0644 |
|
parport.h | File | 604 B | 0644 |
|
pci.h | File | 581 B | 0644 |
|
pci_iomap.h | File | 1.96 KB | 0644 |
|
percpu.h | File | 12.72 KB | 0644 |
|
pgalloc.h | File | 342 B | 0644 |
|
pgtable-nop4d-hack.h | File | 1.86 KB | 0644 |
|
pgtable-nop4d.h | File | 1.64 KB | 0644 |
|
pgtable-nopmd.h | File | 1.9 KB | 0644 |
|
pgtable-nopud.h | File | 1.97 KB | 0644 |
|
pgtable.h | File | 29.5 KB | 0644 |
|
preempt.h | File | 1.94 KB | 0644 |
|
ptrace.h | File | 1.58 KB | 0644 |
|
qrwlock.h | File | 3.78 KB | 0644 |
|
qrwlock_types.h | File | 655 B | 0644 |
|
qspinlock.h | File | 3.67 KB | 0644 |
|
qspinlock_types.h | File | 2.77 KB | 0644 |
|
resource.h | File | 1.07 KB | 0644 |
|
rwsem.h | File | 3.21 KB | 0644 |
|
seccomp.h | File | 1.3 KB | 0644 |
|
sections.h | File | 4.8 KB | 0644 |
|
segment.h | File | 249 B | 0644 |
|
serial.h | File | 345 B | 0644 |
|
set_memory.h | File | 362 B | 0644 |
|
signal.h | File | 308 B | 0644 |
|
simd.h | File | 436 B | 0644 |
|
sizes.h | File | 78 B | 0644 |
|
spinlock.h | File | 329 B | 0644 |
|
statfs.h | File | 169 B | 0644 |
|
string.h | File | 281 B | 0644 |
|
switch_to.h | File | 992 B | 0644 |
|
syscall.h | File | 6.18 KB | 0644 |
|
syscalls.h | File | 739 B | 0644 |
|
termios-base.h | File | 2.11 KB | 0644 |
|
termios.h | File | 2.81 KB | 0644 |
|
timex.h | File | 508 B | 0644 |
|
tlb.h | File | 9.4 KB | 0644 |
|
tlbflush.h | File | 485 B | 0644 |
|
topology.h | File | 2.18 KB | 0644 |
|
trace_clock.h | File | 391 B | 0644 |
|
uaccess.h | File | 5.22 KB | 0644 |
|
unaligned.h | File | 1.05 KB | 0644 |
|
unistd.h | File | 318 B | 0644 |
|
user.h | File | 242 B | 0644 |
|
vga.h | File | 587 B | 0644 |
|
vmlinux.lds.h | File | 29.17 KB | 0644 |
|
vtime.h | File | 52 B | 0644 |
|
word-at-a-time.h | File | 2.75 KB | 0644 |
|
xor.h | File | 13.63 KB | 0644 |
|