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