usr/src/man/man3proc/Pissyscall.3proc

   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
  36 The
  37 .Fn Pissyscall
  38 function determines whether or not the instructions at
  39 .Fa addr
  40 in the process handle
  41 .Fa P
  42 corresponds to one of the architecture's system call instructions.
  43 .Pp
  44 the
  45 .Fn Pissyscall_prev
  46 function determines whether or not the instruction before
  47 .Fa addr
  48 in the process handle
  49 .Fa P
  50 corresponds to one of the architecture's system call instructions.
  51 If it does, and
  52 .Fa dst
  53 is a
  54 .Pf non- Dv NULL
  55 pointer, then the address of the system call instruction will be copied
  56 into the location pointed to by
  57 .Fa dst .
  58 .Sh RETURN VALUES
  59 Upon successful completion, the
  60 .Fn Pissyscall
  61 function returns
  62 .Sy non-zero
  63 if
  64 .Fa addr
  65 corresponds to a system call instruction.
  66 Otherwise,
  67 .Sy 0
  68 is returned.
  69 .Pp
  70 Upon successful completion, the
  71 .Fn Pissyscall_prev
  72 function returns
  73 .Sy non-zero
  74 if
  75 .Fa addr
  76 corresponds to a system call instruction and if
  77 .Fa dst
  78 is
  79 .Pf non- Dv NULL ,
  80 .Fa dst
  81 is updated.
  82 Otherwise,
  83 .Sy 0
  84 is returned.
  85 .Sh INTERFACE STABILITY
  86 .Sy Uncommitted
  87 .Sh MT-LEVEL
  88 See
  89 .Sy LOCKING
  90 in
  91 .Xr libproc 3LIB .
  92 .Sh SEE ALSO
  93 .Xr libproc 3LIB