xref: /illumos-gate/usr/src/man/man3proc/Pissyscall.3proc (revision 4585130b259133a26efae68275dbe56b08366deb)
1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright 2015 Joyent, Inc.
13.\"
14.Dd May 11, 2016
15.Dt PISSYSCALL 3PROC
16.Os
17.Sh NAME
18.Nm Pissyscall ,
19.Nm Pissyscall_prev
20.Nd determine if instructions are system call instructions
21.Sh SYNOPSIS
22.Lb libproc
23.In libproc.h
24.Ft int
25.Fo Pissyscall
26.Fa "struct ps_prochandle *P"
27.Fa "uintptr_t addr"
28.Fc
29.Ft int
30.Fo Pissyscall_prev
31.Fa "struct ps_prochandle *P"
32.Fa "uintptr_t addr"
33.Fa "uintptr_t *dst"
34.Fc
35.Sh DESCRIPTION
36The
37.Fn Pissyscall
38function determines whether or not the instructions at
39.Fa addr
40in the process handle
41.Fa P
42corresponds to one of the architecture's system call instructions.
43.Pp
44the
45.Fn Pissyscall_prev
46function determines whether or not the instruction before
47.Fa addr
48in the process handle
49.Fa P
50corresponds to one of the architecture's system call instructions.
51If it does, and
52.Fa dst
53is a
54.Pf non- Dv NULL
55pointer, then the address of the system call instruction will be copied
56into the location pointed to by
57.Fa dst .
58.Sh RETURN VALUES
59Upon successful completion, the
60.Fn Pissyscall
61function returns
62.Sy non-zero
63if
64.Fa addr
65corresponds to a system call instruction.
66Otherwise,
67.Sy 0
68is returned.
69.Pp
70Upon successful completion, the
71.Fn Pissyscall_prev
72function returns
73.Sy non-zero
74if
75.Fa addr
76corresponds to a system call instruction and if
77.Fa dst
78is
79.Pf non- Dv NULL ,
80.Fa dst
81is updated.
82Otherwise,
83.Sy 0
84is returned.
85.Sh INTERFACE STABILITY
86.Sy Uncommitted
87.Sh MT-LEVEL
88See
89.Sy LOCKING
90in
91.Xr libproc 3LIB .
92.Sh SEE ALSO
93.Xr libproc 3LIB
94