From 0f37944592a2c9ea701d82da142c0d4931a2f6f5 Mon Sep 17 00:00:00 2001 From: David Malcolm Date: Mon, 8 Dec 2014 18:56:21 +0000 Subject: Make jit/notes.txt better reflect current status quo gcc/jit/ChangeLog: * notes.txt: Show the beginning and ending of recording::context::compile vs playback::context::compile. Show the creation and unlinking of the tempdir. Show toplev::finalize. Move "RELEASE MUTEX" to the correct location. Show gcc_jit_result_release, and indicate where the dlopen/dlsym/dlclose occur. From-SVN: r218488 --- gcc/jit/notes.txt | 38 ++++++++++++++++++++++++++++++++++---- 1 file changed, 34 insertions(+), 4 deletions(-) (limited to 'gcc/jit/notes.txt') diff --git a/gcc/jit/notes.txt b/gcc/jit/notes.txt index d337cb4..12bb6d6 100644 --- a/gcc/jit/notes.txt +++ b/gcc/jit/notes.txt @@ -18,9 +18,13 @@ Client Code . Generated . libgccjit.so │ . . . . V . . gcc_jit_context_compile . ──────────────────────────> . . + . . │ start of recording::context::compile () . . │ . . . . │ ACQUIRE MUTEX . . . │ . . + . . │ start of playback::context::compile () + . . │ (create tempdir) . + . . │ . . . . V───────────────────────> toplev::main (for now) . . . . │ . . . . (various code) @@ -65,13 +69,33 @@ Client Code . Generated . libgccjit.so . . . . (the middle─end and backend) . . . . ↓ . . <───────────────────────────── end of toplev::main - . . │ RELEASE MUTEX . . . │ . . - . . │ Convert assembler to DSO + . . V───────────────────────> toplev::finalize + . . . . │ (purge internal state) + . . <──────────────────────── end of toplev::finalize + . . │ . . + . . │ Convert assembler to DSO ("fake.so") + . . │ . . + . . │ Load DSO (dlopen "fake.so") . . │ . . - . . │ Load DSO . + . . │ end of playback::context::compile () + . . │ . . + . . │ playback::context dtor + . . ──> . . + . . │ Cleanup tempdir . + . . │ ("fake.so" is unlinked from the + . . │ filesystem at this point) + . . <── . . + . . │ . . + . . │ RELEASE MUTEX . + . . │ . . + . . │ end of recording::context::compile () <─────────────────────────── . . │ . . . . + V . . gcc_jit_result_get_code . + ──────────────────────────> . . + . . │ dlsym () within loaded DSO + <─────────────────────────── . . Get (void*). . . . │ . . . . │ Call it . . . . @@ -80,5 +104,11 @@ Client Code . Generated . libgccjit.so . │ . . . <─────────────── . . . │ . . . . +etc│ . . . . + │ . . . . + V . . gcc_jit_result_release . + ──────────────────────────> . . + . . │ dlclose () the loaded DSO + . . │ (code becomes uncallable) + <─────────────────────────── . . │ . . . . -etc -- cgit v1.1