diff options
| author | Florian Weimer <fweimer@redhat.com> | 2024-06-03 19:04:58 +0200 |
|---|---|---|
| committer | Florian Weimer <fweimer@redhat.com> | 2024-06-03 19:04:58 +0200 |
| commit | 992daa0b4b5fa8a9f403c9575638cec288e12bfa (patch) | |
| tree | 2e073fc0a7e4d08ccaa749895640dc5ed24a0927 | |
| parent | afe42e935b3ee97bac9a7064157587777259c60e (diff) | |
| download | glibc-992daa0b4b5fa8a9f403c9575638cec288e12bfa.zip glibc-992daa0b4b5fa8a9f403c9575638cec288e12bfa.tar.gz glibc-992daa0b4b5fa8a9f403c9575638cec288e12bfa.tar.bz2 | |
stdlib: Describe __cxa_finalize usage in function comment
Reviewed-by: Jonathan Wakely <jwakely@redhat.com>
| -rw-r--r-- | stdlib/cxa_finalize.c | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/stdlib/cxa_finalize.c b/stdlib/cxa_finalize.c index 258fa56..496141d 100644 --- a/stdlib/cxa_finalize.c +++ b/stdlib/cxa_finalize.c @@ -24,7 +24,22 @@ /* If D is non-NULL, call all functions registered with `__cxa_atexit' with the same dso handle. Otherwise, if D is NULL, call all of the - registered handlers. */ + registered handlers. + + A __cxa_finalize function is declared in the libstdc++ <cxxabi.h> + header, and the libstdc++ implementation calls this function. GCC + calls the glibc variant directly from its CRT files, from an ELF + destructor. this call always passes a non-null D argument. In the + current implementation, the GCC-provided __cxa_finalize call is + responsible for removing the registered __cxa_atexit (C++) + destructors of an object that is undergoing dlclose. Note that + this is specific to dlclose. During process termination, glibc + invokes the __run_exit_handlers, which calls registered + __cxa_atexit (C++) destructors in reverse registration order, + across all objects. The subsequent GCC-provided __cxa_finalize + calls (which are ordered according to ELF object dependencies, not + __cxa_atexit call order, and group destructor calls per object + during dlclose) do not result in further destructor invocations. */ void __cxa_finalize (void *d) { |