build: fix symlink of drivers for Windows
Checks
Commit Message
The symlink-drivers-solibs.sh script was disabled as part of 'install'
for Windows because there is no support for shell scripts. However,
this means that driver related DLLs are not present in the installed
'libdir' directory.
Replace the shell script with a python script to perform the symbolic
linking to improve cross platform support. On Linux the functionality
is unchanged.
On Windows, symbolic links are somewhat problematic since the
SeCreateSymbolicLinkPrivilege is required to be able to create them.
In addition, different cross-compilation environments handle symbolic
links differently, e.g. WSL, Msys2, Cygwin. Rather than trying to
distinguish these scenarios, the python script will perform a file copy
for any Windows specific names.
On Windows, the shared library outputs have different names depending
upon which toolset has been used to build them. The script currently
handles Clang and GCC.
Fixes: 5c7d86948764 ("build: fix install on Windows")
Cc: stable@dpdk.org
Signed-off-by: Nick Connolly <nick.connolly@mayadata.io>
---
buildtools/symlink-drivers-solibs.py | 49 ++++++++++++++++++++++++++++
buildtools/symlink-drivers-solibs.sh | 13 --------
config/meson.build | 7 ++--
3 files changed, 51 insertions(+), 18 deletions(-)
create mode 100644 buildtools/symlink-drivers-solibs.py
delete mode 100644 buildtools/symlink-drivers-solibs.sh
Comments
2021-04-01 13:27 (UTC+0100), Nick Connolly:
[...]
> +def copy_pmd_files(pattern, to_dir):
> + for file in glob.glob(os.path.join(pmd_dir, pattern)):
> + to = os.path.join(to_dir, os.path.basename(file))
> + shutil.copy2(file, to)
> + print(to + ' -> ' + file)
> +
> +copy_pmd_files('*rte_*.dll', bin_dir)
> +copy_pmd_files('*rte_*.pdb', bin_dir)
PDB (debuginfo) files can be quite large, do we want to install them?
[...]
> diff --git a/config/meson.build b/config/meson.build
> index 66a2edcc4..c51669b7d 100644
> --- a/config/meson.build
> +++ b/config/meson.build
> @@ -57,11 +57,8 @@ eal_pmd_path = join_paths(get_option('prefix'), driver_install_path)
> # driver .so files often depend upon the bus drivers for their connect bus,
> # e.g. ixgbe depends on librte_bus_pci. This means that the bus drivers need
> # to be in the library path, so symlink the drivers from the main lib directory.
> -if not is_windows
> - meson.add_install_script('../buildtools/symlink-drivers-solibs.sh',
> - get_option('libdir'),
> - pmd_subdir_opt)
> -endif
> +meson.add_install_script(py3, '../buildtools/symlink-drivers-solibs.py',
> + get_option('libdir'), pmd_subdir_opt, get_option('bindir'))
>
> # set the machine type and cflags for it
> if meson.is_cross_build()
As you may have seen, build fails because find_program() result cannot be
used in meson.add_install_script() until 0.55. Since your script has
Unix-specific part anyway and Windows recommends Meson 0.56, maybe Unices
should continue using shell variant and Python script can be Windows-only.
> PDB (debuginfo) files can be quite large, do we want to install them?
The script copies will only copy the .pdb files if they have already
been installed into
lib/dpdk/pmds-*/. If they haven't, we'll just skip the step.
Whether they should be installed is a different question :-) Installing
them seems to
be a deliberate choice by meson
(https://github.com/mesonbuild/meson/issues/1442).
In my opinion, it's probably best to have them there.
I looked at options apart from copying (including hard links) but in the
end decided to
keep it as simple as possible so it will 'just work' for cross builds
from Linux, WSL-1,
WSL-2, Msys, Cygnus etc.
> +meson.add_install_script(py3, '../buildtools/symlink-drivers-solibs.py',
> + get_option('libdir'), pmd_subdir_opt, get_option('bindir'))
>
> # set the machine type and cflags for it
> if meson.is_cross_build()
> As you may have seen, build fails because find_program() result cannot be
> used in meson.add_install_script() until 0.55. Since your script has
> Unix-specific part anyway and Windows recommends Meson 0.56, maybe Unices
> should continue using shell variant and Python script can be Windows-only.
Yes, I 'd been thinking about the best way to handle this. Your
suggestion of having both
scripts may well be the best option in the short term.
Thanks,
Nick
new file mode 100644
@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2021 Intel Corporation
+
+import os
+import sys
+import glob
+import shutil
+
+# post-install script for meson/ninja builds to symlink the PMDs stored in
+# $libdir/dpdk/pmds-*/ to $libdir. This is needed as some PMDs depend on
+# others, e.g. PCI device PMDs depending on the PCI bus driver.
+
+# parameters to script are paths relative to install prefix:
+# 1. directory for installed regular libs e.g. lib64
+# 2. subdirectory of libdir where the pmds are
+# 3. directory for installed regular binaries e.g. bin
+
+os.chdir(os.environ['MESON_INSTALL_DESTDIR_PREFIX'])
+
+lib_dir = sys.argv[1]
+pmd_subdir = sys.argv[2]
+bin_dir = sys.argv[3]
+pmd_dir = os.path.join(lib_dir, pmd_subdir)
+
+# copy Windows PMDs to avoid any issues with symlinks since the
+# build could be a cross-compilation under WSL, Msys or Cygnus.
+# the filenames are dependent upon the specific toolchain in use.
+
+def copy_pmd_files(pattern, to_dir):
+ for file in glob.glob(os.path.join(pmd_dir, pattern)):
+ to = os.path.join(to_dir, os.path.basename(file))
+ shutil.copy2(file, to)
+ print(to + ' -> ' + file)
+
+copy_pmd_files('*rte_*.dll', bin_dir)
+copy_pmd_files('*rte_*.pdb', bin_dir)
+copy_pmd_files('*rte_*.lib', lib_dir)
+copy_pmd_files('*rte_*.dll.a', lib_dir)
+
+# symlink shared objects
+
+os.chdir(lib_dir)
+for file in glob.glob(os.path.join(pmd_subdir, 'librte_*.so*')):
+ to = os.path.basename(file)
+ if os.path.exists(to):
+ os.remove(to)
+ os.symlink(file, to)
+ print(to + ' -> ' + file)
deleted file mode 100644
@@ -1,13 +0,0 @@
-#! /bin/sh
-# SPDX-License-Identifier: BSD-3-Clause
-# Copyright(c) 2017 Intel Corporation
-
-# post-install script for meson/ninja builds to symlink the PMDs stored in
-# $libdir/dpdk/drivers/ to $libdir. This is needed as some PMDs depend on
-# others, e.g. PCI device PMDs depending on the PCI bus driver.
-
-# parameters to script are paths relative to install prefix:
-# 1. directory for installed regular libs e.g. lib64
-# 2. subdirectory of libdir where the pmds are
-
-cd ${MESON_INSTALL_DESTDIR_PREFIX}/$1 && ln -sfv $2/librte_*.so* .
@@ -57,11 +57,8 @@ eal_pmd_path = join_paths(get_option('prefix'), driver_install_path)
# driver .so files often depend upon the bus drivers for their connect bus,
# e.g. ixgbe depends on librte_bus_pci. This means that the bus drivers need
# to be in the library path, so symlink the drivers from the main lib directory.
-if not is_windows
- meson.add_install_script('../buildtools/symlink-drivers-solibs.sh',
- get_option('libdir'),
- pmd_subdir_opt)
-endif
+meson.add_install_script(py3, '../buildtools/symlink-drivers-solibs.py',
+ get_option('libdir'), pmd_subdir_opt, get_option('bindir'))
# set the machine type and cflags for it
if meson.is_cross_build()