1 /* 2 * ptw32_tkAssocCreate.c 3 * 4 * Description: 5 * This translation unit implements routines which are private to 6 * the implementation and may be used throughout it. 7 * 8 * -------------------------------------------------------------------------- 9 * 10 * Pthreads-win32 - POSIX Threads Library for Win32 11 * Copyright(C) 1998 John E. Bossom 12 * Copyright(C) 1999,2005 Pthreads-win32 contributors 13 * 14 * Contact Email: rpj (at) callisto.canberra.edu.au 15 * 16 * The current list of contributors is contained 17 * in the file CONTRIBUTORS included with the source 18 * code distribution. The list can also be seen at the 19 * following World Wide Web location: 20 * http://sources.redhat.com/pthreads-win32/contributors.html 21 * 22 * This library is free software; you can redistribute it and/or 23 * modify it under the terms of the GNU Lesser General Public 24 * License as published by the Free Software Foundation; either 25 * version 2 of the License, or (at your option) any later version. 26 * 27 * This library is distributed in the hope that it will be useful, 28 * but WITHOUT ANY WARRANTY; without even the implied warranty of 29 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 30 * Lesser General Public License for more details. 31 * 32 * You should have received a copy of the GNU Lesser General Public 33 * License along with this library in the file COPYING.LIB; 34 * if not, write to the Free Software Foundation, Inc., 35 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA 36 */ 37 38 #include "pthread.h" 39 #include "implement.h" 40 41 42 int 43 ptw32_tkAssocCreate (ptw32_thread_t * sp, pthread_key_t key) 44 /* 45 * ------------------------------------------------------------------- 46 * This routine creates an association that 47 * is unique for the given (thread,key) combination.The association 48 * is referenced by both the thread and the key. 49 * This association allows us to determine what keys the 50 * current thread references and what threads a given key 51 * references. 52 * See the detailed description 53 * at the beginning of this file for further details. 54 * 55 * Notes: 56 * 1) New associations are pushed to the beginning of the 57 * chain so that the internal ptw32_selfThreadKey association 58 * is always last, thus allowing selfThreadExit to 59 * be implicitly called last by pthread_exit. 60 * 2) 61 * 62 * Parameters: 63 * thread 64 * current running thread. 65 * key 66 * key on which to create an association. 67 * Returns: 68 * 0 - if successful, 69 * ENOMEM - not enough memory to create assoc or other object 70 * EINVAL - an internal error occurred 71 * ENOSYS - an internal error occurred 72 * ------------------------------------------------------------------- 73 */ 74 { 75 ThreadKeyAssoc *assoc; 76 77 /* 78 * Have to create an association and add it 79 * to both the key and the thread. 80 * 81 * Both key->keyLock and thread->threadLock are locked before 82 * entry to this routine. 83 */ 84 assoc = (ThreadKeyAssoc *) calloc (1, sizeof (*assoc)); 85 86 if (assoc == NULL) 87 { 88 return ENOMEM; 89 } 90 91 assoc->thread = sp; 92 assoc->key = key; 93 94 /* 95 * Register assoc with key 96 */ 97 assoc->prevThread = NULL; 98 assoc->nextThread = (ThreadKeyAssoc *) key->threads; 99 if (assoc->nextThread != NULL) 100 { 101 assoc->nextThread->prevThread = assoc; 102 } 103 key->threads = (void *) assoc; 104 105 /* 106 * Register assoc with thread 107 */ 108 assoc->prevKey = NULL; 109 assoc->nextKey = (ThreadKeyAssoc *) sp->keys; 110 if (assoc->nextKey != NULL) 111 { 112 assoc->nextKey->prevKey = assoc; 113 } 114 sp->keys = (void *) assoc; 115 116 return (0); 117 118 } /* ptw32_tkAssocCreate */ 119