Banner file for linuxthread_db library.
[kopensolaris-gnu/glibc.git] / linuxthreads_db / thread_db.h
index b1b6221..6301d7f 100644 (file)
 #include <pthread.h>
 #include <stdint.h>
 #include <sys/types.h>
-#include <sys/ucontext.h>
+#include <sys/procfs.h>
 
 
 /* Error codes of the library.  */
 typedef enum
 {
-  TD_OK,       /* No error.  */
-  TD_ERR,      /* No further specified error.  */
-  TD_NOTHR,    /* No matching thread found.  */
-  TD_NOSV,     /* No matching synchronization handle found.  */
-  TD_NOLWP,    /* No matching light-weighted process found.  */
-  TD_BADPH,    /* Invalid process handle.  */
-  TD_BADTH,    /* Invalid thread handle.  */
-  TD_BADSH,    /* Invalid synchronization handle.  */
-  TD_BADTA,    /* Invalid thread agent.  */
-  TD_BADKEY,   /* Invalid key.  */
-  TD_NOMSG,    /* No event available.  */
-  TD_NOFPREGS, /* No floating-point register content available.  */
-  TD_LIBTHREAD,        /* Application not linked with thread library.  */
-  TD_NOEVENT,  /* Requested event is not supported.  */
-  TD_NOCAPAB,  /* Capability not available.  */
-  TD_DBERR,    /* Internal debug library error.  */
-  TD_NOAPLIC,  /* Operation is not applicable.  */
-  TD_NOTSD,    /* No thread-specific data available.  */
-  TD_MALLOC,   /* Out of memory.  */
-  TD_PARTIALREG,/* Not entire register set was read or written.  */
-  TD_NOXREGS   /* X register set not available for given thread.  */
+  TD_OK,         /* No error.  */
+  TD_ERR,        /* No further specified error.  */
+  TD_NOTHR,      /* No matching thread found.  */
+  TD_NOSV,       /* No matching synchronization handle found.  */
+  TD_NOLWP,      /* No matching light-weighted process found.  */
+  TD_BADPH,      /* Invalid process handle.  */
+  TD_BADTH,      /* Invalid thread handle.  */
+  TD_BADSH,      /* Invalid synchronization handle.  */
+  TD_BADTA,      /* Invalid thread agent.  */
+  TD_BADKEY,     /* Invalid key.  */
+  TD_NOMSG,      /* No event available.  */
+  TD_NOFPREGS,   /* No floating-point register content available.  */
+  TD_NOLIBTHREAD, /* Application not linked with thread library.  */
+  TD_NOEVENT,    /* Requested event is not supported.  */
+  TD_NOCAPAB,    /* Capability not available.  */
+  TD_DBERR,      /* Internal debug library error.  */
+  TD_NOAPLIC,    /* Operation is not applicable.  */
+  TD_NOTSD,      /* No thread-specific data available.  */
+  TD_MALLOC,     /* Out of memory.  */
+  TD_PARTIALREG,  /* Not entire register set was read or written.  */
+  TD_NOXREGS     /* X register set not available for given thread.  */
 } td_err_e;
 
 
@@ -81,9 +81,6 @@ typedef enum
 
 /* Types of the debugging library.  */
 
-/* Addresses.  */
-typedef void *psaddr_t;
-
 /* Handle for a process.  This type is opaque.  */
 typedef struct td_thragent td_thragent_t;
 
@@ -203,6 +200,14 @@ typedef struct td_event_msg
   } msg;
 } td_event_msg_t;
 
+/* Structure containing event data available in each thread structure.  */
+typedef struct
+{
+  td_thr_events_t eventmask;   /* Mask of enabled events.  */
+  td_event_e eventnum;         /* Number of last event.  */
+  void *eventdata;             /* Data associated with event.  */
+} td_eventbuf_t;
+
 
 /* Gathered statistics about the process.  */
 typedef struct td_ta_stats
@@ -229,26 +234,18 @@ typedef struct td_ta_stats
 typedef pthread_t thread_t;
 typedef pthread_key_t thread_key_t;
 
-/* Linux has different names for the register set types.  */
-typedef gregset_t prgregset_t;
-typedef fpregset_t prfpregset_t;
-
 
 /* Callback for iteration over threads.  */
-typedef int td_thr_iter_f __P ((const td_thrhandle_t *, void *));
+typedef int td_thr_iter_f (const td_thrhandle_t *, void *);
 
 /* Callback for iteration over thread local data.  */
-typedef int td_key_iter_f __P ((thread_key_t, void (*) (void *), void *));
+typedef int td_key_iter_f (thread_key_t, void (*) (void *), void *);
 
 
 
 /* Forward declaration.  This has to be defined by the user.  */
 struct ps_prochandle;
 
-/* We don't have any differences between processes and threads, therefore
-   have only one PID type.  */
-typedef pid_t lwpid_t;
-
 
 /* Information about the thread.  */
 typedef struct td_thrinfo
@@ -334,6 +331,18 @@ extern td_err_e td_ta_tsd_iter (const td_thragent_t *__ta, td_key_iter_f *__ki,
 extern td_err_e td_ta_event_addr (const td_thragent_t *__ta,
                                  td_event_e __event, td_notify_t *__ptr);
 
+/* Enable EVENT in global mask.  */
+extern td_err_e td_ta_set_event (const td_thragent_t *__ta,
+                                td_thr_events_t *__event);
+
+/* Disable EVENT in global mask.  */
+extern td_err_e td_ta_clear_event (const td_thragent_t *__ta,
+                                  td_thr_events_t *__event);
+
+/* Return information about last event.  */
+extern td_err_e td_ta_event_getmsg (const td_thragent_t *__ta,
+                                   td_event_msg_t *msg);
+
 
 /* Set suggested concurrency level for process associated with TA.  */
 extern td_err_e td_ta_setconcurrency (const td_thragent_t *__ta, int __level);