Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2017
 
 

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) identified by the thread handle, th_p. Since ps_lstop() and ps_lcontinue() must be provided by the caller's application (see proc_service(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)