unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



System Calls                                      _lwp_suspend(2)



NAME
     _lwp_suspend, _lwp_continue - continue or suspend LWP execu-
     tion

SYNOPSIS
     #include <sys/lwp.h>

     int _lwp_suspend(lwpid_t target_lwp);

     int _lwp_continue(lwpid_t target_lwp);

DESCRIPTION
     The _lwp_suspend() function immediately suspends the  execu-
     tion  of  the  LWP  specified  by  target_lwp. On successful
     return from _lwp_suspend(), target_lwp is no longer  execut-
     ing.  Once  a  thread  is  suspended,  subsequent  calls  to
     _lwp_suspend() have no affect.

     The _lwp_continue() function  resumes  the  execution  of  a
     suspended LWP. Once a suspended LWP is continued, subsequent
     calls to _lwp_continue() have no effect.

     A suspended LWP will not be awakened by a signal. The signal
     stays  pending  until the execution of the LWP is resumed by
     _lwp_continue().

RETURN VALUES
     Upon successful completion, 0 is returned. A non-zero  value
     indicates an error.

ERRORS
     If  the  following  condition  occurs,  _lwp_suspend()   and
     _lwp_continue() fail and return the corresponding value:

     ESRCH The target_lwpid  argument  cannot  be  found  in  the
           current process.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     _lwp_create(2), attributes(5)





SunOS 5.9           Last change: 13 Aug 2001                    1