Home | History | Annotate | Download | only in pthreads-win32
      1 /*
      2  * pthread_attr_setdetachstate.c
      3  *
      4  * Description:
      5  * This translation unit implements operations on thread attribute objects.
      6  *
      7  * --------------------------------------------------------------------------
      8  *
      9  *      Pthreads-win32 - POSIX Threads Library for Win32
     10  *      Copyright(C) 1998 John E. Bossom
     11  *      Copyright(C) 1999,2005 Pthreads-win32 contributors
     12  *
     13  *      Contact Email: rpj (at) callisto.canberra.edu.au
     14  *
     15  *      The current list of contributors is contained
     16  *      in the file CONTRIBUTORS included with the source
     17  *      code distribution. The list can also be seen at the
     18  *      following World Wide Web location:
     19  *      http://sources.redhat.com/pthreads-win32/contributors.html
     20  *
     21  *      This library is free software; you can redistribute it and/or
     22  *      modify it under the terms of the GNU Lesser General Public
     23  *      License as published by the Free Software Foundation; either
     24  *      version 2 of the License, or (at your option) any later version.
     25  *
     26  *      This library is distributed in the hope that it will be useful,
     27  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
     28  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     29  *      Lesser General Public License for more details.
     30  *
     31  *      You should have received a copy of the GNU Lesser General Public
     32  *      License along with this library in the file COPYING.LIB;
     33  *      if not, write to the Free Software Foundation, Inc.,
     34  *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
     35  */
     36 
     37 #include "pthread.h"
     38 #include "implement.h"
     39 
     40 
     41 int
     42 pthread_attr_setdetachstate (pthread_attr_t * attr, int detachstate)
     43      /*
     44       * ------------------------------------------------------
     45       * DOCPUBLIC
     46       *      This function specifies whether threads created with
     47       *      'attr' will run detached.
     48       *
     49       * PARAMETERS
     50       *      attr
     51       *              pointer to an instance of pthread_attr_t
     52       *
     53       *      detachstate
     54       *              an integer containing one of:
     55       *
     56       *              PTHREAD_CREATE_JOINABLE
     57       *                              Thread ID is valid, must be joined
     58       *
     59       *              PTHREAD_CREATE_DETACHED
     60       *                              Thread ID is invalid, cannot be joined,
     61       *                              canceled, or modified
     62       *
     63       *
     64       * DESCRIPTION
     65       *      This function specifies whether threads created with
     66       *      'attr' will run detached.
     67       *
     68       *      NOTES:
     69       *              1)      You cannot join or cancel detached threads.
     70       *
     71       * RESULTS
     72       *              0               successfully set detach state,
     73       *              EINVAL          'attr' or 'detachstate' is invalid
     74       *
     75       * ------------------------------------------------------
     76       */
     77 {
     78   if (ptw32_is_attr (attr) != 0)
     79     {
     80       return EINVAL;
     81     }
     82 
     83   if (detachstate != PTHREAD_CREATE_JOINABLE &&
     84       detachstate != PTHREAD_CREATE_DETACHED)
     85     {
     86       return EINVAL;
     87     }
     88 
     89   (*attr)->detachstate = detachstate;
     90   return 0;
     91 }
     92