CONTRIBUTING.d/patches: Please provide a git-range-diff(1)
[man-pages.git] / man5 / proc_pid_syscall.5
blob1b2aa682bb5ab41cb797003cf869dfbc19ed9c63
1 .\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
2 .\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
3 .\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
4 .\"
5 .\" SPDX-License-Identifier: GPL-3.0-or-later
6 .\"
7 .TH proc_pid_syscall 5 (date) "Linux man-pages (unreleased)"
8 .SH NAME
9 /proc/pid/syscall \- currently executed system call
10 .SH DESCRIPTION
11 .TP
12 .IR /proc/ pid /syscall " (since Linux 2.6.27)"
13 .\" commit ebcb67341fee34061430f3367f2e507e52ee051b
14 This file exposes the system call number and argument registers for the
15 system call currently being executed by the process,
16 followed by the values of the stack pointer and program counter registers.
17 The values of all six argument registers are exposed,
18 although most system calls use fewer registers.
19 .IP
20 If the process is blocked, but not in a system call,
21 then the file displays \-1 in place of the system call number,
22 followed by just the values of the stack pointer and program counter.
23 If process is not blocked, then the file contains just the string "running".
24 .IP
25 This file is present only if the kernel was configured with
26 .BR CONFIG_HAVE_ARCH_TRACEHOOK .
27 .IP
28 Permission to access this file is governed by a ptrace access mode
29 .B PTRACE_MODE_ATTACH_FSCREDS
30 check; see
31 .BR ptrace (2).
32 .SH SEE ALSO
33 .BR proc (5)