Merge pull request #1985 from minrk/doc-rpath

mention rpath, ldconfig in build docs
zeromq · May 1, 2024 · a08bcf3 · a08bcf3
2 parents 5a45683 + e82220b
commit a08bcf3
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/docs/source/howto/build.md b/docs/source/howto/build.md
@@ -83,6 +83,14 @@ If pyzmq doesn't find your libzmq via the default search, or you want to skip th
 ZMQ_PREFIX=/path/to/zmq  # should contain 'include', 'lib', etc.
 ```
 
+You may also need to add:
+
+```bash
+export LDFLAGS="-Wl,-rpath,${ZMQ_PREFIX}/lib"
+```
+
+to make sure that your libzmq is found at _runtime_.
+
 ### Disabling bundled build fallback
 
 You may want to keep the default search,

diff --git a/docs/source/howto/draft.md b/docs/source/howto/draft.md
@@ -24,13 +24,17 @@ tar -xzf libzmq.tar.gz
 cd zeromq-${ZMQ_VERSION}
 ./configure --prefix=${PREFIX} --enable-drafts
 make -j${CPU_COUNT} && make install
+sudo ldconfig
 ```
 
 And then build pyzmq with draft support:
 
 ```bash
 export ZMQ_PREFIX=${PREFIX}
 export ZMQ_DRAFT_API=1
+# rpath may be needed to find libzmq at runtime,
+# depending on installation
+export LDFLAGS="${LDFLAGS:-} -Wl,-rpath,${ZMQ_PREFIX}/lib"
 pip install -v pyzmq --no-binary pyzmq
 ```