xref: /illumos-gate/usr/src/man/man3proc/Pissyscall.3proc (revision dcbf3bd6a1f1360fc1afcee9e22c6dcff7844bf2)
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. If it
51does, 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. Otherwise,
66.Sy 0
67is returned.
68.Pp
69Upon successful completion, the
70.Fn Pissyscall_prev
71function returns
72.Sy non-zero
73if
74.Fa addr
75corresponds to a system call instruction and if
76.Fa dst
77is
78.Pf non- Dv NULL ,
79.Fa dst
80is updated. Otherwise,
81.Sy 0
82is returned.
83.Sh INTERFACE STABILITY
84.Sy Uncommitted
85.Sh MT-LEVEL
86See
87.Sy LOCKING
88in
89.Xr libproc 3LIB .
90.Sh SEE ALSO
91.Xr libproc 3LIB
92