pthread_cancel man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

pthread_cancel(3T)					    pthread_cancel(3T)

NAME
       pthread_cancel() - cancel execution of a thread

SYNOPSIS

PARAMETERS
	      thread	Target thread to be canceled.

DESCRIPTION
       requests that thread (hereby referred to as target thread) be canceled.
       It allows a thread to terminate the execution  of  any  thread  in  the
       process in a controlled manner.

       The  target  thread's  cancelability  state and type determine when the
       cancellation takes effect.  Cancellation only occurs  when  the	target
       thread's	 cancelability state is When the target thread's cancelability
       state is cancellation requests against the target thread are held pend‐
       ing and will be acted upon when cancellation is enabled.

       When  the  cancelability	 type is for the target thread, new or pending
       cancellation requests are acted upon at	any  time.   When  the	target
       thread's	 cancelability	type is cancellation requests are held pending
       until the target thread reaches a cancellation point (see below).

       If the target thread's cancelability state is disabled, the cancelabil‐
       ity  type does not matter.  When cancelability is enabled, the cancela‐
       bility type will take effect.

       When the cancellation is acted on, the  cancellation  cleanup  handlers
       for thread are called.  The cancellation cleanup handlers are called in
       the opposite order in which they were installed.	 When the last cancel‐
       lation  cleanup	handler	 returns,  the thread-specific data destructor
       functions for thread are called.	 When  the  last  destructor  function
       returns, thread shall be terminated.

       The caller of will not wait for the target thread to be canceled.

   Cancellation Points
       are  points  inside of certain functions where a thread must act on any
       pending cancellation request when cancelability is enabled if the func‐
       tion would block.

RETURN VALUE
       Upon  successful	 completion, returns zero.  Otherwise, an error number
       is returned to indicate the error (the variable is not set).

ERRORS
       For each of the following conditions, if the condition is detected, the
       function returns the corresponding error number:

	      [ESRCH]	     No thread could be found corresponding to thread.

WARNINGS
       Use  of asynchronous cancelability while holding resources that need to
       be released may result in resource loss.	 Applications  must  carefully
       follow  static  lexical scoping rules in their execution behavior.  For
       instance, the use of return, goto, etc., to leave user-defined  cancel‐
       lation  scopes  without	doing  the  necessary scope pop will result in
       undefined behavior.

AUTHOR
       was derived from the IEEE POSIX P1003.1c standard.

SEE ALSO
       pthread_exit(3T),     pthread_join(3T),	   pthread_setcancelstate(3T),
       pthread_cleanup_pop(3T), pthread_cond_wait(3T).

STANDARDS CONFORMANCE
				Pthread Library		    pthread_cancel(3T)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net