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) {..