summaryrefslogtreecommitdiffstats
path: root/README.windows.rst
diff options
context:
space:
mode:
authorLucian Petrut <lpetrut@cloudbasesolutions.com>2021-01-07 14:14:00 +0100
committerLucian Petrut <lpetrut@cloudbasesolutions.com>2021-01-26 09:41:51 +0100
commit5c008725db7c5b7ae22ae64e3b3e6309c501c6db (patch)
treefac301290fe36dd969cda8a3bdb2f4e8e530ba91 /README.windows.rst
parentMerge PR #32027 into master (diff)
downloadceph-5c008725db7c5b7ae22ae64e3b3e6309c501c6db.tar.xz
ceph-5c008725db7c5b7ae22ae64e3b3e6309c501c6db.zip
cmake,win32*.sh: Windows DLL support
At the moment, the Windows binaries can only be linked statically. This is less than ideal since: * the resulting binaries can be quite large, especially when including debug symbols * librados and librbd cannot be used directly by 3rd party apps * the build duration is increased In order to do a dynamic build, we'll: * add an option to win32_build.sh * fix link order * dynamically link boost * disable the "-pie" flag when using Mingw, which generates incorrect executable entry points * by default, cmake generates import libs for executables. The issue is that for rados.exe, it generates librados.dll.a, thus overriding the librados.dll import library, which breaks the build process. We'll configure cmake to skip generating import libs for executables. Signed-off-by: Lucian Petrut <lpetrut@cloudbasesolutions.com>
Diffstat (limited to 'README.windows.rst')
-rw-r--r--README.windows.rst53
1 files changed, 25 insertions, 28 deletions
diff --git a/README.windows.rst b/README.windows.rst
index b7e2426500c..fd682ff9f38 100644
--- a/README.windows.rst
+++ b/README.windows.rst
@@ -24,30 +24,31 @@ account different package managers, package names or paths (e.g. mingw paths).
The script accepts the following flags:
-============ =============================== ===============================
-Flag Description Default value
-============ =============================== ===============================
-OS Host OS distribution, for mingw ubuntu (also valid: suse)
- and other OS specific settings.
-CEPH_DIR The Ceph source code directory. The same as the script.
-BUILD_DIR The directory where the $CEPH_DIR/build
- generated artifacts will be
- placed.
-DEPS_DIR The directory where the Ceph $CEPH_DIR/build.deps
- dependencies will be built.
-NUM_WORKERS The number of workers to use The number of vcpus
- when building Ceph. available
-CLEAN_BUILD Clean the build directory.
-SKIP_BUILD Run cmake without actually
- performing the build.
-SKIP_TESTS Skip building Ceph tests.
-BUILD_ZIP Build a zip archive containing
- the generated binaries.
-ZIP_DEST Where to put a zip containing $BUILD_DIR/ceph.zip
- the generated binaries.
-STRIP_ZIPPED If set, the zip will contain
- stripped binaries.
-============ =============================== ===============================
+============= =============================== ===============================
+Flag Description Default value
+============= =============================== ===============================
+OS Host OS distribution, for mingw ubuntu (also valid: suse)
+ and other OS specific settings.
+CEPH_DIR The Ceph source code directory. The same as the script.
+BUILD_DIR The directory where the $CEPH_DIR/build
+ generated artifacts will be
+ placed.
+DEPS_DIR The directory where the Ceph $CEPH_DIR/build.deps
+ dependencies will be built.
+NUM_WORKERS The number of workers to use The number of vcpus
+ when building Ceph. available
+CLEAN_BUILD Clean the build directory.
+SKIP_BUILD Run cmake without actually
+ performing the build.
+SKIP_TESTS Skip building Ceph tests.
+BUILD_ZIP Build a zip archive containing
+ the generated binaries.
+ZIP_DEST Where to put a zip containing $BUILD_DIR/ceph.zip
+ the generated binaries.
+STRIP_ZIPPED If set, the zip will contain
+ stripped binaries.
+ENABLE_SHARED Dynamically link Ceph libs. False
+============= =============================== ===============================
In order to build debug binaries as well as an archive containing stripped
binaries that may be easily moved around, one may use the following:
@@ -86,10 +87,6 @@ in userspace, pretty much like Fuse.
RBD images can be mounted using the ``rbd`` or ``rbd-wnbd`` commands. The
``WNBD`` driver is required for mapping RBD images on Windows.
-The libraries have to be built statically at the moment. The reason is that
-there are a few circular library dependencies or unspecified dependencies,
-which isn't supported when building DLLs. This mostly affects ``cls`` libraries.
-
A significant number of tests from the ``tests`` directory have been ported,
providing adequate coverage.