15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pthread_setcancelstate.c 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Description: 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * POSIX thread functions related to thread cancellation. 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * -------------------------------------------------------------------------- 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Pthreads-win32 - POSIX Threads Library for Win32 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copyright(C) 1998 John E. Bossom 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copyright(C) 1999,2005 Pthreads-win32 contributors 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Contact Email: rpj@callisto.canberra.edu.au 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The current list of contributors is contained 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in the file CONTRIBUTORS included with the source 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * code distribution. The list can also be seen at the 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * following World Wide Web location: 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * http://sources.redhat.com/pthreads-win32/contributors.html 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This library is free software; you can redistribute it and/or 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * modify it under the terms of the GNU Lesser General Public 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * License as published by the Free Software Foundation; either 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * version 2 of the License, or (at your option) any later version. 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This library is distributed in the hope that it will be useful, 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * but WITHOUT ANY WARRANTY; without even the implied warranty of 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Lesser General Public License for more details. 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * You should have received a copy of the GNU Lesser General Public 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * License along with this library in the file COPYING.LIB; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if not, write to the Free Software Foundation, Inc., 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "pthread.h" 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "implement.h" 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)pthread_setcancelstate (int state, int *oldstate) 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * ------------------------------------------------------ 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * DOCPUBLIC 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function atomically sets the calling thread's 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancelability state to 'state' and returns the previous 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancelability state at the location referenced by 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 'oldstate' 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * PARAMETERS 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * state, 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * oldstate 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * PTHREAD_CANCEL_ENABLE 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancellation is enabled, 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * PTHREAD_CANCEL_DISABLE 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancellation is disabled 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * DESCRIPTION 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function atomically sets the calling thread's 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancelability state to 'state' and returns the previous 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * cancelability state at the location referenced by 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 'oldstate'. 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * NOTES: 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1) Use to disable cancellation around 'atomic' code that 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * includes cancellation points 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * COMPATIBILITY ADDITIONS 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If 'oldstate' is NULL then the previous state is not returned 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * but the function still succeeds. (Solaris) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * RESULTS 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 0 successfully set cancelability type, 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * EINVAL 'state' is invalid 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * ------------------------------------------------------ 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_mcs_local_node_t stateLock; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int result = 0; 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) pthread_t self = pthread_self (); 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_thread_t * sp = (ptw32_thread_t *) self.p; 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (sp == NULL 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) || (state != PTHREAD_CANCEL_ENABLE && state != PTHREAD_CANCEL_DISABLE)) 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) { 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return EINVAL; 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Lock for async-cancel safety. 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_mcs_lock_acquire (&sp->stateLock, &stateLock); 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (oldstate != NULL) 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) { 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *oldstate = sp->cancelState; 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) sp->cancelState = state; 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Check if there is a pending asynchronous cancel 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (state == PTHREAD_CANCEL_ENABLE 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) && sp->cancelType == PTHREAD_CANCEL_ASYNCHRONOUS 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) && WaitForSingleObject (sp->cancelEvent, 0) == WAIT_OBJECT_0) 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) { 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) sp->state = PThreadStateCanceling; 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) sp->cancelState = PTHREAD_CANCEL_DISABLE; 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ResetEvent (sp->cancelEvent); 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_mcs_lock_release (&stateLock); 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_throw (PTW32_EPS_CANCEL); 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* Never reached */ 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ptw32_mcs_lock_release (&stateLock); 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return (result); 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} /* pthread_setcancelstate */ 126