Tcl Source Code

Hex Artifact Content
Login

Artifact ad7bf044922b44ae4a4d084217b8bb98b2615fff:

Attachment "thread-cleanup-doc.patch" to ticket [3cc1d91345] added by gustafn2 2016-10-07 13:12:11. (unpublished)
0000: 49 6e 64 65 78 3a 20 67 65 6e 65 72 69 63 2f 74  Index: generic/t
0010: 63 6c 54 68 72 65 61 64 41 6c 6c 6f 63 2e 63 0a  clThreadAlloc.c.
0020: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0030: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0040: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0050: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0060: 3d 3d 0a 2d 2d 2d 20 67 65 6e 65 72 69 63 2f 74  ==.--- generic/t
0070: 63 6c 54 68 72 65 61 64 41 6c 6c 6f 63 2e 63 0a  clThreadAlloc.c.
0080: 2b 2b 2b 20 67 65 6e 65 72 69 63 2f 74 63 6c 54  +++ generic/tclT
0090: 68 72 65 61 64 41 6c 6c 6f 63 2e 63 0a 40 40 20  hreadAlloc.c.@@ 
00a0: 2d 31 31 30 34 2c 31 33 20 2b 31 31 30 34 2c 31  -1104,13 +1104,1
00b0: 33 20 40 40 0a 20 2f 2a 0a 20 20 2a 2d 2d 2d 2d  3 @@. /*.  *----
00c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
00d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
00e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
00f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0100: 2d 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c 46 69  --.  *.  * TclFi
0110: 6e 61 6c 69 7a 65 54 68 72 65 61 64 41 6c 6c 6f  nalizeThreadAllo
0120: 63 54 68 72 65 61 64 20 2d 2d 0a 20 20 2a 0a 2d  cThread --.  *.-
0130: 20 2a 09 54 68 69 73 20 70 72 6f 63 65 64 75 72   *.This procedur
0140: 65 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 73  e is used to des
0150: 74 72 6f 79 20 73 69 6e 67 6c 65 20 74 68 72 65  troy single thre
0160: 61 64 20 70 72 69 76 61 74 65 20 72 65 73 6f 75  ad private resou
0170: 72 63 65 73 20 75 73 65 64 0a 2d 20 2a 09 69 6e  rces used.- *.in
0180: 20 74 68 69 73 20 66 69 6c 65 2e 0a 2d 20 2a 20   this file..- * 
0190: 43 61 6c 6c 65 64 20 69 6e 20 54 63 6c 70 46 69  Called in TclpFi
01a0: 6e 61 6c 69 7a 65 54 68 72 65 61 64 44 61 74 61  nalizeThreadData
01b0: 20 77 68 65 6e 20 61 20 74 68 72 65 61 64 20 65   when a thread e
01c0: 78 69 74 73 20 28 54 63 6c 5f 46 69 6e 61 6c 69  xits (Tcl_Finali
01d0: 7a 65 54 68 72 65 61 64 29 2e 0a 2b 20 2a 09 54  zeThread)..+ *.T
01e0: 68 69 73 20 70 72 6f 63 65 64 75 72 65 20 69 73  his procedure is
01f0: 20 75 73 65 64 20 74 6f 20 64 65 73 74 72 6f 79   used to destroy
0200: 20 73 69 6e 67 6c 65 20 74 68 72 65 61 64 20 70   single thread p
0210: 72 69 76 61 74 65 20 72 65 73 6f 75 72 63 65 73  rivate resources
0220: 0a 2b 20 2a 09 64 65 66 69 6e 65 64 20 69 6e 20  .+ *.defined in 
0230: 74 68 69 73 20 66 69 6c 65 2e 20 43 61 6c 6c 65  this file. Calle
0240: 64 20 65 69 74 68 65 72 20 64 75 72 69 6e 67 20  d either during 
0250: 54 63 6c 5f 46 69 6e 61 6c 69 7a 65 54 68 72 65  Tcl_FinalizeThre
0260: 61 64 28 29 20 6f 72 0a 2b 20 2a 09 54 63 6c 5f  ad() or.+ *.Tcl_
0270: 46 69 6e 61 6c 69 7a 65 28 29 2e 0a 20 20 2a 0a  Finalize()..  *.
0280: 20 20 2a 20 52 65 73 75 6c 74 73 3a 0a 20 20 2a    * Results:.  *
0290: 09 4e 6f 6e 65 2e 0a 20 20 2a 0a 20 20 2a 20 53  .None..  *.  * S
02a0: 69 64 65 20 65 66 66 65 63 74 73 3a 0a 0a 49 6e  ide effects:..In
02b0: 64 65 78 3a 20 77 69 6e 2f 74 63 6c 57 69 6e 54  dex: win/tclWinT
02c0: 68 72 64 2e 63 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  hrd.c.==========
02d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
02e0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
02f0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ================
0300: 3d 3d 3d 3d 3d 3d 3d 3d 0a 2d 2d 2d 20 77 69 6e  ========.--- win
0310: 2f 74 63 6c 57 69 6e 54 68 72 64 2e 63 0a 2b 2b  /tclWinThrd.c.++
0320: 2b 20 77 69 6e 2f 74 63 6c 57 69 6e 54 68 72 64  + win/tclWinThrd
0330: 2e 63 0a 40 40 20 2d 31 30 31 30 2c 31 32 20 2b  .c.@@ -1010,12 +
0340: 31 30 31 30 2c 31 34 20 40 40 0a 20 7b 0a 20 20  1010,14 @@. {.  
0350: 20 20 20 42 4f 4f 4c 20 73 75 63 63 65 73 73 3b     BOOL success;
0360: 0a 20 0a 20 20 20 20 20 69 66 20 28 70 74 72 20  . .     if (ptr 
0370: 21 3d 20 4e 55 4c 4c 29 20 7b 0a 20 09 2f 2a 0a  != NULL) {. ./*.
0380: 2d 09 20 2a 20 43 61 6c 6c 65 64 20 62 79 20 75  -. * Called by u
0390: 73 20 69 6e 20 54 63 6c 70 46 69 6e 61 6c 69 7a  s in TclpFinaliz
03a0: 65 54 68 72 65 61 64 44 61 74 61 20 77 68 65 6e  eThreadData when
03b0: 20 61 20 74 68 72 65 61 64 20 65 78 69 74 73 20   a thread exits 
03c0: 61 6e 64 0a 2d 09 20 2a 20 64 65 73 74 72 6f 79  and.-. * destroy
03d0: 73 20 74 68 65 20 74 73 64 20 6b 65 79 20 77 68  s the tsd key wh
03e0: 69 63 68 20 73 74 6f 72 65 73 20 61 6c 6c 6f 63  ich stores alloc
03f0: 61 74 6f 72 20 63 61 63 68 65 73 2e 0a 2b 09 20  ator caches..+. 
0400: 2a 20 43 61 6c 6c 65 64 20 62 79 20 54 63 6c 46  * Called by TclF
0410: 69 6e 61 6c 69 7a 65 54 68 72 65 61 64 41 6c 6c  inalizeThreadAll
0420: 6f 63 28 29 20 61 6e 64 0a 2b 09 20 2a 20 54 63  oc() and.+. * Tc
0430: 6c 46 69 6e 61 6c 69 7a 65 54 68 72 65 61 64 41  lFinalizeThreadA
0440: 6c 6c 6f 63 54 68 72 65 61 64 28 29 20 64 75 72  llocThread() dur
0450: 69 6e 67 20 54 63 6c 5f 46 69 6e 61 6c 69 7a 65  ing Tcl_Finalize
0460: 28 29 20 6f 72 0a 2b 09 20 2a 20 54 63 6c 5f 46  () or.+. * Tcl_F
0470: 69 6e 61 6c 69 7a 65 54 68 72 65 61 64 28 29 2e  inalizeThread().
0480: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 64   This function d
0490: 65 73 74 72 6f 79 73 20 74 68 65 20 74 73 64 20  estroys the tsd 
04a0: 6b 65 79 20 77 68 69 63 68 0a 2b 09 20 2a 20 73  key which.+. * s
04b0: 74 6f 72 65 73 20 61 6c 6c 6f 63 61 74 6f 72 20  tores allocator 
04c0: 63 61 63 68 65 73 20 69 6e 20 74 68 72 65 61 64  caches in thread
04d0: 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 2e 0a   local storage..
04e0: 20 09 20 2a 2f 0a 20 0a 20 09 54 63 6c 46 72 65   . */. . .TclFre
04f0: 65 41 6c 6c 6f 63 43 61 63 68 65 28 70 74 72 29  eAllocCache(ptr)
0500: 3b 0a 20 09 73 75 63 63 65 73 73 20 3d 20 54 6c  ;. .success = Tl
0510: 73 53 65 74 56 61 6c 75 65 28 74 6c 73 4b 65 79  sSetValue(tlsKey
0520: 2c 20 4e 55 4c 4c 29 3b 0a 20 09 69 66 20 28 21  , NULL);. .if (!
0530: 73 75 63 63 65 73 73 29 20 7b 0a 0a              success) {..