Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Threads Library Functionstd_thr_setsigpending(3THR)


NAME

 td_thr_setsigpending, td_thr_sigsetmask - manage thread signals for libthread_db

SYNOPSIS

 
cc [ flag ... ] file ... -lthread_db [ library ... ]

#include <proc_service.h>
#include <thread_db.h>
td_err_e td_thr_setsigpending(const td_thrhandle_t * th_p, const uchar_ t ti_sigpending_flag, const sigset_t ti_sigmask;);
 td_err_e td_thr_sigsetmask(const td_thrhandle_t *th_p, const sigset_t ti_sigmask);

DESCRIPTION

 

The td_thr_setsigpending() and td_thr_setsigmask() operations affect the signal state of the thread identified by th_p.

td_thr_setsigpending() sets the set of pending signals for thread th_p to ti_sigpending. The value of the libthread-internal field that indicates whether a thread has any signal pending is set to ti_sigpending_flag. To be consistent, ti_sigpending_flag should be zero if and only if all of the bits in ti_sigpending are zero.

td_thr_sigsetmask() sets the signal mask of the thread th_p as if the thread had set its own signal mask by way of thr_sigsetmask(3THR). The new signal mask is the value of ti_sigmask.

There is no equivalent to the SIG_BLOCK or SIG_UNBLOCK operations of thr_sigsetmask(3THR), which mask or unmask specific signals without affecting the mask state of other signals. To block or unblock specific signals, either stop the whole process, or the thread, if necessary, by td_thr_dbsuspend(). Then determine the thread's existing signal mask by calling td_thr_get_info() and reading the ti_sigmask field of the td_thrinfo_t structure returned. Modify it as desired, and set the new signal mask with td_thr_sigsetmask().

RETURN VALUES

 
TD_OK
The call completed successfully.
TD_BADTH
An invalid thread handle was passed in.
TD_DBERR
A call to one of the imported interface routines failed.
TD_ERR
A libthread_db internal error occurred.

ATTRIBUTES

 

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

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelSafe

SEE ALSO

 

libthread_db(3THR), td_thr_dbsuspend(3THR), td_thr_get_info(3THR), libthread_db(3LIB), attributes(5)


SunOS 5.9Go To TopLast Changed 20 Oct 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.