emscripten-core/emscripten

dlopen() documentation is wrong, and related issue should not be closed

Open

#15,795 opened on Dec 16, 2021

View on GitHub
 (8 comments) (0 reactions) (0 assignees)C++ (27,361 stars) (3,519 forks)batch import
docsgood first bughelp wanted

Description

In particular, from https://emscripten.org/docs/compiling/Dynamic-Linking.html?highlight=dlopen:

Runtime dynamic linking can be performed by the calling the dlopen() function ... That’s basically it - you can then use dlopen(), dlsym(), etc. normally. (emphasis mine)

The second part of that statement is 100% false

Issue #11753 still exists.

Could the documentation please be corrected, and issue #11753 re-opened until a solution has been put into place?

Contributor guide

Tech stack
cppwasmjavascript
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic understanding of EmscriptenFamiliarity with dlopen()
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Review the documentation at https://emscripten.org/docs/compiling/Dynamic Linking.html and examine issue #11753 to understand the correct behavior of dlopen() in Emscripten. Correct the misleading statement and add necessary caveats about limitations. Consider updating the example or adding a note about the unresolved issue.
dlopen() documentation is wrong, and related issue should not be closed · emscripten-core/emscripten#15795 | Good First Issue