xref: /illumos-gate/usr/src/man/man3c_db/td_thr_dbsuspend.3c_db (revision dd72704bd9e794056c558153663c739e2012d721)
te
Copyright (c) 1998 Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
TD_THR_DBSUSPEND 3C_DB "Oct 20, 1998"
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(7) for description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level Safe
SEE ALSO

libc_db (3LIB), attributes (7)