1 LIBC_DB(3LIB)                 Interface Libraries                LIBC_DB(3LIB)
   2 
   3 
   4 
   5 NAME
   6        libc_db - threads debugging library
   7 
   8 SYNOPSIS
   9        cc [ flag ... ] file ... -lc_db [ library ... ]
  10        #include <proc_service.h>
  11        #include <thread_db.h>
  12 
  13 
  14 DESCRIPTION
  15        The libc_db library provides support for monitoring and manipulating
  16        threads-related aspects of a multithreaded program. There are at least
  17        two processes involved,  the controlling process and one or more target
  18        processes.  The controlling process is the libc_db client, which links
  19        with libc_db and uses libc_db to inspect or modify threads-related
  20        aspects of one or more target processes. The target processes must be
  21        multithreaded processes that use libc. The controlling process mignt or
  22        might not be multithreaded itself.
  23 
  24 
  25        The most commonly anticipated use for libc_db is that the controlling
  26        process will be a debugger for a multithreaded program, hence the "db"
  27        in libc_db.
  28 
  29 
  30        The libc_db library is dependent on the internal implementation details
  31        of libc. It is a "friend" of libc in the C++ sense, which is precisely
  32        the "value added" by libc_db. It encapsulates the knowledge of libc
  33        internals that a debugger needs to manipulate the threads-related state
  34        of a target process.
  35 
  36 
  37        To be able to inspect and manipulate target processes, libc_db makes
  38        use of certain process control primitives that must be  provided by the
  39        process using libc_db. The imported interfaces are defined in
  40        proc_service(3PROC). In other words, the controlling process is linked
  41        with libc_db and calls routines in libc_db. In turn, libc_db calls

 117        /lib/64/libc_db.so.1
 118                                64-bit shared object
 119 
 120 
 121 ATTRIBUTES
 122        See attributes(5) for description of the following attributes:
 123 
 124 
 125 
 126 
 127        +---------------+-----------------+
 128        |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
 129        |MT-Level       | Safe            |
 130        +---------------+-----------------+
 131 
 132 SEE ALSO
 133        Intro(3), td_ta_new(3C_DB), attributes(5), threads(5)
 134 
 135 
 136 
 137                                 March 24, 2004                   LIBC_DB(3LIB)

   1 LIBC_DB(3LIB)                 Interface Libraries                LIBC_DB(3LIB)
   2 
   3 
   4 
   5 NAME
   6        libc_db - threads debugging library
   7 
   8 SYNOPSIS
   9        cc [ flag... ] file... -lc_db [ library... ]
  10        #include <proc_service.h>
  11        #include <thread_db.h>
  12 
  13 
  14 DESCRIPTION
  15        The libc_db library provides support for monitoring and manipulating
  16        threads-related aspects of a multithreaded program. There are at least
  17        two processes involved,  the controlling process and one or more target
  18        processes.  The controlling process is the libc_db client, which links
  19        with libc_db and uses libc_db to inspect or modify threads-related
  20        aspects of one or more target processes. The target processes must be
  21        multithreaded processes that use libc. The controlling process might or
  22        might not be multithreaded itself.
  23 
  24 
  25        The most commonly anticipated use for libc_db is that the controlling
  26        process will be a debugger for a multithreaded program, hence the "db"
  27        in libc_db.
  28 
  29 
  30        The libc_db library is dependent on the internal implementation details
  31        of libc. It is a "friend" of libc in the C++ sense, which is precisely
  32        the "value added" by libc_db. It encapsulates the knowledge of libc
  33        internals that a debugger needs to manipulate the threads-related state
  34        of a target process.
  35 
  36 
  37        To be able to inspect and manipulate target processes, libc_db makes
  38        use of certain process control primitives that must be  provided by the
  39        process using libc_db. The imported interfaces are defined in
  40        proc_service(3PROC). In other words, the controlling process is linked
  41        with libc_db and calls routines in libc_db. In turn, libc_db calls

 117        /lib/64/libc_db.so.1
 118                                64-bit shared object
 119 
 120 
 121 ATTRIBUTES
 122        See attributes(5) for description of the following attributes:
 123 
 124 
 125 
 126 
 127        +---------------+-----------------+
 128        |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
 129        |MT-Level       | Safe            |
 130        +---------------+-----------------+
 131 
 132 SEE ALSO
 133        Intro(3), td_ta_new(3C_DB), attributes(5), threads(5)
 134 
 135 
 136 
 137                                 August 19, 2019                  LIBC_DB(3LIB)