summaryrefslogtreecommitdiff
path: root/docs/markdown/Cross-compilation.md
AgeCommit message (Collapse)Author
2025-06-17docs: use backticks for envvarsSam James
2025-06-17docs: fix formatting of pkg_config_libdir propertySam James
2025-05-03docs: disambiguate exe_wrapperAndy MacGregor
As of this commit, meson has three different pathways to set an exe_wrapper field. exe_wrapper set through `meson test --wrapper` CLI arg or `add_test_setup()` meson function argument are treated equally. Only one wrapper through either of these routes may be set though. The exe_wrapper field set in the cross file is handled separately internally in mtest.py, and holds a little more consequence over meson test behavior than the other two fields. Perhaps a future version of meson should treat these fields equally and explicitly document how they are combined. For now, I think its a better first step to document current behavior to generate discussion about how exactly the future version should behave.
2025-03-06doc: fix sentence about cross-compilation.Charles Brunet
Fixes #14338
2024-10-05docs: Add windres to cross-compiling exampleandy5995
2024-02-25Avoid use of deprecated command form on the cross compilation doc pageRalf Gommers
2023-08-01Fix typo in Cross-compilation.mdAlex Rao
2023-06-19Add kernel and subsystem properties to machine objects.Jussi Pakkanen
2022-08-16docs: fix various references to "meson builddir"Eli Schwartz
This is wrong, it should use "meson setup builddir".
2022-07-14docs: add some function linkification in code snippetsEli Schwartz
Let people easily find the documentation for concepts we are trying to teach.
2022-07-11docs: add cross-file exampleMichael Davidsaver
2022-06-29docs: update various function references to be linkifiedEli Schwartz
2021-10-10Fix typos discovered by codespellChristian Clauss
2021-02-25deprecated `meson.get_cross_property`Dylan Baker
It's a pure subset of `get_external_property`, and has odd behavior in host == build configurations. `get_external_property` is clear, and uses the standard `native : bool` syntax to control host vs build properties
2021-01-31Capitalize "Meson" consistently as it is a proper name. [skip ci]Jussi Pakkanen
2021-01-30Rewrap long text lines in docs. [skip ci]Jussi Pakkanen
2021-01-13Fix misspellsAntonin Décimo
Signed-off-by: Antonin Décimo <antonin.decimo@gmail.com>
2020-08-18Interpreter: Fix c_stdlib usageXavier Claessens
- Exceptions raised during subproject setup were ignored. - Allow c_stdlib in native file, was already half supported. - Eliminate usage of subproject variable name by overriding '<lang>_stdlib' dependency name.
2020-06-18docs: replaced `ninja` with appropriate `meson` commands [skip ci]TheQwertiest
2020-05-14interpreter: Rename has_exe_wrapper -> can_run_host_binariesDylan Baker
The implementation of this function has changed enough that the name doesn't really reflect what it actually does. It basically returns true unless you're cross compiling, need and exe_wrapper, and don't have one. The original function remains but is marked as deprecated. This makes one small change the meson source language, which is that it defines that can_run_host_binaries will return true in build == host compilation, which was the behavior that already existed. Previously this was undefined in build == host compilation.
2020-04-21docs/cross-compilation: Note appropriate values for cpu_family [skip ci]Dylan Baker
Also note that meson doesn't use `el` on the end of the cpu_family to mark endianness, that the endian field needs to be set appropriately.
2020-03-28docs: Add a new page with common cross/native file options [skip ci]Dylan Baker
Rather than having two separate sections with duplicated information lets just have one for the common settings, and only document sections specific to each file in separately
2020-03-19Update cross compilation documentation to reference new ld variablesPhillip Johnston
2020-01-22envconfig: add pkg_config_libdir propertyStéphane Cerveau
In order to unify the use of sysroot in the cross-file, the pkg_config_libdir can now be passed directly in the file.
2019-12-11Merge pull request #6207 from dcbaker/linker-optionJussi Pakkanen
Add a way to select the dynamic linker meson uses
2019-12-10docs: explain cross-compilation names sooner [skip ci]Marc Herbert
Meson's documentation about cross-compilation made me finally understand why the typical confusion about machine names. Thanks, but let's make it even better. Don't wait until the very end of the section to reveal the most important information: that machine names are relative. For suspense we already have TV shows; spill the beans much earlier. Also fix the first, simplest cross-compilation example: target is irrelevant.
2019-12-02docs: Update docs for LD and ld entriesDylan Baker
2019-11-05docs: Document that meson 0.52.0 allows layering cross files [skip ci]Dylan Baker
2019-08-08docs: meson -> Meson in one placeJohn Ericson
2019-06-26dependencies/base: Set PKG_CONFIG_SYSROOT_DIR from cross fileDylan Baker
In some cases it may be necessary to set PKG_CONFIG_SYSROOT_DIR, like when you've mounted a host architecture system in an arbitrary path. Meson will now check the cross files for a [properties]:sys_root variable and set the PKG_CONFIG_SYSROOT_DIR environment variable based on that variable. Fixes #3801 Fixes #4057
2019-02-11allow paths to be set in the cross fileDylan Baker
Just like the previous patch, but for cross files Fixes #1433
2018-03-29docs: Expand on compiler vs compilee build host and target (#3308) [skip ci]John Ericson
2018-03-23docs: fix one 'target' that should be 'host' [skip ci]John Ericson
The target platform of cross compiler is the host platform of the project being built.
2018-03-11docs: update system cross file documentationJon Turney
Works on all non-Windows since cf98f5e3 (PR #3119)
2017-11-30cross: Implement support for loading cross files from system pathsDylan Baker
One thing that makes cross compiling with meson a pain is the need for cross files. The problem is not with cross files themselves (they're actually rather brilliant in that they allow for a much greater deal of flexibility than autotools hardcoded paths approach) but that each user needs to reimplement them themselves, when for most people what they really want is a cross file that could be provided by their distro, all they really want is the correct toolchain. This patch is the first stop to making it easier for distros to ship their own cross files (and for users to put their's somewhere safe so they don't get `git clean`ed. It allows the cross files (on Linux and *BSD) to be stored in home and system paths (~/.config/meson/cross, /usr/share/meson/cross, and /usr/local/share/meson/cross), and to be loaded by simply by specificying --cross-file. With this patch meson will check the locations its always checked first, (is cross file absolute, or is it relative to $PWD), then will check ~/.config/meson/cross, /usr/local/share/meson/cross, /usr/share/meson/cross, (or $XDG_CONFIG_PATH and $XDG_DATA_DIRS) for the files, raising an exception if it cannot find the specified cross file. Fixes #2283
2017-10-26docs: add pkgconfig to cross file exampleMike Gilbert
2017-08-21Rewrapped lines of a few more files.Jussi Pakkanen
2017-05-29environment: Add needs_exe_wrapper for overriding auto-detection.Ole André Vadla Ravnås
This is useful when build_machine appears to be compatible with host_machine, but actually isn't. For example when: - build_machine is macOS and host_machine is the iOS Simulator - the build_machine's libc is glibc but the host_machine libc is uClibc - code relies on kernel features not available on the build_machine
2017-05-03doc: Fix several minor typos.Elliott Sales de Andrade
2017-05-03docs: add a short description for all top pages in the ManualPeter Hutterer
2017-04-26docs: Import the website and wiki and build with hotdocThibault Saunier
This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it.