X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Fgettingstarted%2Fdevelopers%2Fcross_compile_macos.rst;fp=docs%2Fgettingstarted%2Fdevelopers%2Fcross_compile_macos.rst;h=0000000000000000000000000000000000000000;hb=9ad39c026c8a3c945a7003c4aa4f5cb1d4c80160;hp=5eec5569a8ba97924651ec82a1eef81a5b4ac0e7;hpb=f47122e07e1ecd0151902a3cabe46c60a99bee8e;p=vpp.git diff --git a/docs/gettingstarted/developers/cross_compile_macos.rst b/docs/gettingstarted/developers/cross_compile_macos.rst deleted file mode 100644 index 5eec5569a8b..00000000000 --- a/docs/gettingstarted/developers/cross_compile_macos.rst +++ /dev/null @@ -1,70 +0,0 @@ -.. _cross_compile_macos : - -Cross compilation on MacOS -========================== - -This is a first attempt to support Cross compilation of VPP on MacOS for development (linting, completion, compile_commands.json) - - -**Prerequisites** - -* You'll need to install the following packages - -.. code-block:: console - - $ pip3 install ply pyyaml jsonschema - $ brew install gnu-sed pkg-config ninja crosstool-ng - -* You'll also need to install ``clang-format 10.0.0`` to be able to ``make checkstyle``. This can be done with :ref:`this doc` -* You should link the binaries to make them available in your path with their original names e.g. : - -.. code-block:: console - - $ ln -s $(which gsed) /usr/local/bin/sed - -**Setup** - -* Create a `cross compile toolchain `_ -* Create a case sensitive volume and mount the toolchain in it e.g. in ``/Volumes/xchain`` -* Create a xchain.toolchain file with ``$VPP_DIR/extras/scripts/cross_compile_macos.sh conf /Volumes/xchan`` - -For now we don't support e-build so dpdk, rdma, quicly won't be compiled as part of ``make build`` - -To build with the toolchain do: - -.. code-block:: console - - $ $VPP_DIR/extras/scripts/cross_compile_macos.sh build - - -To get the compile_commands.json do - -.. code-block:: console - - $ $VPP_DIR/extras/scripts/cross_compile_macos.sh cc - $ >> ./build-root/build-vpp[_debug]-native/vpp/compile_commands.json - - - -This should build vpp on MacOS - - -Good luck :) - -.. _install_clang_format_10_0_0 : - -Installing clang-format 10.0.0 ------------------------------- - -In order to install clang-format on macos : - -.. code-block:: bash - - $ wget https://github.com/llvm/llvm-project/releases/download/llvmorg-10.0.0/clang-10.0.0.src.tar.xz - $ tar -xvf clang+llvm-10.0.0-x86_64-apple-darwin.tar.xz - $ mv clang+llvm-10.0.0-x86_64-apple-darwin /usr/local/Cellar/ - $ sudo ln -s ../Cellar/clang+llvm-10.0.0-x86_64-apple-darwin/bin/clang-format /usr/local/bin/clang-format - $ sudo ln -s ../Cellar/clang+llvm-10.0.0-x86_64-apple-darwin/bin/clang-format /usr/local/bin/clang-format-10 - $ sudo ln -s ../Cellar/clang+llvm-10.0.0-x86_64-apple-darwin/share/clang/clang-format-diff.py /usr/local/bin/clang-format-diff-10 - -Source `Clang website `_