1 PDELBKPT(3PROC)        Process Control Library Functions       PDELBKPT(3PROC)
   2 
   3 NAME
   4      Pdelbkpt - clear a breakpoint in a process
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      int
  13      Pdelbkpt(struct ps_prochandle *P, uintptr_t address, ulong_t saved);
  14 
  15 DESCRIPTION
  16      The Pdelbkpt() function removes the breakpoint installed at address from
  17      process P.  Restoring the instruction present in saved.
  18 
  19      If the instruction at address is no longer the architecture-specific
  20      breakpoint instruction, then saved is not restored, but the function
  21      still returns successfully.  This behavior is done due to the presence of
  22      setting breakpoints in self-modifying code, e.g. procedure linkage
  23      tables.
  24 
  25      The Pdelbkpt() function only works on running processes, such as those
  26      created through Pgrab(3PROC) and Pcreate(3PROC).  Attempting to remove a
  27      breakpoint from process handles to core files, zombie processes, or ELF
  28      objects will fail.
  29 
  30 RETURN VALUES
  31      Upon successful completion, the Pdelbkpt() function removes the
  32      breakpoint and returns 0.  Otherwise, -1 is returned, and errno is set to
  33      indicate the error.
  34 
  35 ERRORS
  36      For a full list of possible errors see the DIAGNOSTICS section in
  37      proc(4).
  38 
  39      The Pdelbkpt() function will fail with:
  40 
  41      ENOENT             The handle P refers to a grabbed core file, a zombie
  42                         process, or an ELF object.
  43 
  44 INTERFACE STABILITY
  45      Uncommitted
  46 
  47 MT-LEVEL
  48      See LOCKING in libproc(3LIB).
  49 
  50 SEE ALSO
  51      libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC),
  52      Pgrab_file(3PROC), Psetbkpt(3PROC), proc(4)
  53 
  54 illumos                          May 11, 2016                          illumos