X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fguides%2Fwindows_gsg%2Fbuild_dpdk.rst;h=8083227ea465aeecef8c3b423758bd18e4ab16c6;hb=0f5ee447f5c5bc98d1ce9010ad7d22a270b0dd7e;hp=a0e51dfcb359f77e459b6a85bf88a044c73158fb;hpb=4816484bab8eeb05e83bcf4787772eb3b75fa6ee;p=dpdk.git diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst index a0e51dfcb3..8083227ea4 100644 --- a/doc/guides/windows_gsg/build_dpdk.rst +++ b/doc/guides/windows_gsg/build_dpdk.rst @@ -44,14 +44,16 @@ and ensure the Windows SDK is selected. Option 2. MinGW-w64 Toolchain ----------------------------- -Obtain the latest version from -`MinGW-w64 website `_. -On Windows, install to a folder without spaces in its name, like ``C:\MinGW``. -This path is assumed for the rest of this guide. - +On Linux, i.e. for cross-compilation, install MinGW-w64 via a package manager. Version 4.0.4 for Ubuntu 16.04 cannot be used due to a `MinGW-w64 bug `_. +On Windows, obtain the latest version installer from +`MinGW-w64 repository `_. +Any thread model (POSIX or Win32) can be chosen, DPDK does not rely on it. +Install to a folder without spaces in its name, like ``C:\MinGW``. +This path is assumed for the rest of this guide. + Install the Build System ------------------------ @@ -62,7 +64,7 @@ A good option to choose is the MSI installer for both meson and ninja together:: http://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer%22 -Recommended version is either Meson 0.47.1 (baseline) or the latest release. +Recommended version is either Meson 0.57.0 (baseline) or the latest release. Install the Backend ------------------- @@ -101,22 +103,13 @@ To compile the examples, the flag ``-Dexamples`` is required. meson -Dexamples=helloworld build ninja -C build +Option 2. Cross-Compile with MinGW-w64 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Run the helloworld example -========================== - -Navigate to the examples in the build directory and run `dpdk-helloworld.exe`. +The cross-file option must be specified for Meson. +Depending on the distribution, paths in this file may need adjustments. .. code-block:: console - cd C:\Users\me\dpdk\build\examples - dpdk-helloworld.exe - hello from core 1 - hello from core 3 - hello from core 0 - hello from core 2 - -Note for MinGW-w64: applications are linked to ``libwinpthread-1.dll`` -by default. To run the example, either add toolchain executables directory -to the PATH or copy the library to the working directory. -Alternatively, static linking may be used (mind the LGPLv2.1 license). + meson --cross-file config/x86/cross-mingw -Dexamples=helloworld build + ninja -C build