opensolaris man page for td_thr_dbsuspend

td_thr_dbsuspend(3C_DB) 				Threads Debugging Library Functions				   td_thr_dbsuspend(3C_DB)

NAME
       td_thr_dbsuspend, td_thr_dbresume - suspend and resume threads in libc_db

SYNOPSIS
       cc [ flag... ] file... -lc_db [ library... ]
       #include <proc_service.h>
       #include <thread_db.h>

       td_err_e td_thr_dbsuspend(const td_thrhandle_t *th_p);

       td_err_e td_thr_dbresume(const td_thrhandle_t *th_p);

DESCRIPTION
       These operations do nothing other than call ps_lstop(3PROC) and ps_lcontinue(3PROC), respectively, on the lightweight process (LWP) identi-
       fied by the thread handle, th_p. Since ps_lstop()  and  ps_lcontinue()  must  be  provided  by  the  caller's  application  (see  proc_ser-
       vice(3PROC)),  and  the	application  (a  debugger-like entity) has full control over the stopped state of the process and all of its LWPs,
       td_thr_dbsuspend() and td_thr_dbresume() are unnecessary interfaces. They exist only to maintain interface compatibility with the past.

RETURN VALUES
       TD_OK	    The call completed successfully.

       TD_BADTH     An invalid thread handle was passed in.

       TD_DBERR     A call to ps_lstop() or ps_lcontinue() failed.

       TD_ERR	    A libc_db internal error occurred.

ATTRIBUTES
       See attributes(5) for description of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       libc_db(3LIB), attributes(5)

SunOS 5.11							    20 Oct 1998 					   td_thr_dbsuspend(3C_DB)