Update

Author: github-actions

Cross-compilation.html

@@ -329,6 +329,20 @@ <h3 id="binaries">Binaries</h3>
 of a wrapper, these lines are all you need to write. Meson will
 automatically use the given wrapper when it needs to run host
 binaries. This happens e.g. when running the project's test suite.</p>
+<p>Note that <code>exe_wrapper</code> in the cross file is handled separately
+from the <code>exe_wrapper</code> argument in
+<a href="Reference-manual_functions.html#add_test_setup_exe_wrapper"><code>add_test_setup</code></a>
+and <a href="Unit-tests.html#other-test-options"><code>meson test --wrapper</code></a>
+command line argument. Meson must have <code>exe_wrapper</code> specified in the
+cross file or else it will skip tests that attempt to run cross
+compiled binaries. Only the cross file <code>exe_wrapper</code> value will be
+stored in the <code>MESON_EXE_WRAPPER</code> environment variable. If another
+wrapper is given in the test setup with <code>exe_wrapper</code> or as a
+<code>meson test --wrapper</code> command line argument, then meson will prepend
+the additional wrapper before the cross file wrapper like the
+following command:</p>
+<pre><code>[prepend_wrapper] &lt;cross_file_wrapper&gt; &lt;exe_binary&gt; &lt;args...&gt;
+</code></pre>
 <h3 id="properties">Properties</h3>
 <p>In addition to the properties allowed in <a href="Machine-files.html#properties">all machine
 files</a>, the cross file may contain

assets/js/search/MESON_EXE_WRAPPER

@@ -1 +1 @@
-urls_downloaded_cb({"token":"MESON_EXE_WRAPPER","urls":[{"url":"Reference-manual_functions.html#test","node_type":"p","page":"Functions","sections":["Functions","test()"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-55-0.html#test-scripts-are-given-the-exe-wrapper-if-needed","node_type":"p","page":"Release 0.55.0","sections":["New features","Test scripts are given the exe wrapper if needed"],"context":{"gi-language":["default"]}}]});
+urls_downloaded_cb({"token":"MESON_EXE_WRAPPER","urls":[{"url":"Cross-compilation.html#binaries","node_type":"p","page":"Cross compilation","sections":["Cross compilation","Defining the environment","Binaries"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#test","node_type":"p","page":"Functions","sections":["Functions","test()"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-55-0.html#test-scripts-are-given-the-exe-wrapper-if-needed","node_type":"p","page":"Release 0.55.0","sections":["New features","Test scripts are given the exe wrapper if needed"],"context":{"gi-language":["default"]}}]});

assets/js/search/Note

@@ -1 +1 @@
-urls_downloaded_cb({"token":"add_test_setup","urls":[{"url":"Reference-manual.html#functions","node_type":"ul","page":"Reference manual","sections":["Reference manual","Functions"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_elementary_void.html#returned-by","node_type":"ul","page":"void","sections":["void (void)","Returned by"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#add_test_setup","node_type":"h2","page":"Functions","sections":["Functions","add_test_setup()"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#add_test_setup_exclude_suites","node_type":"p","page":"Functions","sections":["Functions","add_test_setup()","Arguments"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#arguments6","node_type":"table","page":"Functions","sections":["Functions","add_test_setup()","Arguments"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-49-0.html#new-keyword-argument-is_default-to-add_test_setup","node_type":"h2","page":"Release 0.49","sections":["New features","New keyword argument is_default to add_test_setup()\n"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-57-0.html#test-timeout-and-timeout_multiplier-value-0","node_type":"p","page":"Release 0.57.0","sections":["New features","\ntest() timeout and timeout_multiplier value <= 0"],"context":{"gi-language":["default"]}}]});
+urls_downloaded_cb({"token":"add_test_setup","urls":[{"url":"Cross-compilation.html#binaries","node_type":"p","page":"Cross compilation","sections":["Cross compilation","Defining the environment","Binaries"],"context":{"gi-language":["default"]}},{"url":"Reference-manual.html#functions","node_type":"ul","page":"Reference manual","sections":["Reference manual","Functions"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_elementary_void.html#returned-by","node_type":"ul","page":"void","sections":["void (void)","Returned by"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#add_test_setup","node_type":"h2","page":"Functions","sections":["Functions","add_test_setup()"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#add_test_setup_exclude_suites","node_type":"p","page":"Functions","sections":["Functions","add_test_setup()","Arguments"],"context":{"gi-language":["default"]}},{"url":"Reference-manual_functions.html#arguments6","node_type":"table","page":"Functions","sections":["Functions","add_test_setup()","Arguments"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-49-0.html#new-keyword-argument-is_default-to-add_test_setup","node_type":"h2","page":"Release 0.49","sections":["New features","New keyword argument is_default to add_test_setup()\n"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-57-0.html#test-timeout-and-timeout_multiplier-value-0","node_type":"p","page":"Release 0.57.0","sections":["New features","\ntest() timeout and timeout_multiplier value <= 0"],"context":{"gi-language":["default"]}}]});

assets/js/search/add_test_setup

@@ -1 +1 @@
-urls_downloaded_cb({"token":"attempt","urls":[{"url":"Builtin-options.html#python-module","node_type":"p","page":"Built-in options","sections":["Built-in options","Module options","Python module"],"context":{"gi-language":["default"]}},{"url":"Dependencies.html#shaderc","node_type":"p","page":"Dependencies","sections":["Dependencies with custom lookup functionality","Shaderc"],"context":{"gi-language":["default"]}},{"url":"FAQ.html#why-dont-the-arguments-passed-to-add_project_link_arguments-affect-anything","node_type":"p","page":"FAQ","sections":["Meson Frequently Asked Questions","Why don't the arguments passed to add_project_link_arguments affect anything?"],"context":{"gi-language":["default"]}},{"url":"Installing.html#installing-as-the-superuser","node_type":"p","page":"Installing","sections":["Installing","Installing as the superuser"],"context":{"gi-language":["default"]}},{"url":"Keyval-module.html#keyvalload","node_type":"p","page":"keyval module","sections":["keyval module","Usage","keyval.load()"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-47-0.html#polkit-support-for-privileged-installation","node_type":"p","page":"Release 0.47","sections":["New features","Polkit support for privileged installation"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-56-0.html#preliminary-aix-support","node_type":"p","page":"Release 0.56.0","sections":["New features","Preliminary AIX support"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-62-0.html#new-custom-dependency-for-openssl","node_type":"ul","page":"Release 0.62.0","sections":["New features","New custom dependency for OpenSSL"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#allow-reconfigure-and-wipe-of-empty-builddir","node_type":"p","page":"Release 1.1.0","sections":["New features","Allow --reconfigure and --wipe of empty builddir"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#meson-install-now-supports-userpreferred-root-elevation-tools","node_type":"p","page":"Release 1.1.0","sections":["New features","\nmeson install now supports user-preferred root elevation tools"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#sudo-meson-install-now-drops-privileges-when-rebuilding-targets","node_type":"p","page":"Release 1.1.0","sections":["New features","\nsudo meson install now drops privileges when rebuilding targets"],"context":{"gi-language":["default"]}},{"url":"Rust.html#mixing-generated-and-static-sources","node_type":"p","page":"Rust","sections":["Using Rust with Meson","Mixing Generated and Static sources"],"context":{"gi-language":["default"]}},{"url":"Using-with-Visual-Studio.html#using-with-visual-studio","node_type":"p","page":"Using with Visual Studio","sections":["Using with Visual Studio"],"context":{"gi-language":["default"]}}]});
+urls_downloaded_cb({"token":"attempt","urls":[{"url":"Builtin-options.html#python-module","node_type":"p","page":"Built-in options","sections":["Built-in options","Module options","Python module"],"context":{"gi-language":["default"]}},{"url":"Cross-compilation.html#binaries","node_type":"p","page":"Cross compilation","sections":["Cross compilation","Defining the environment","Binaries"],"context":{"gi-language":["default"]}},{"url":"Dependencies.html#shaderc","node_type":"p","page":"Dependencies","sections":["Dependencies with custom lookup functionality","Shaderc"],"context":{"gi-language":["default"]}},{"url":"FAQ.html#why-dont-the-arguments-passed-to-add_project_link_arguments-affect-anything","node_type":"p","page":"FAQ","sections":["Meson Frequently Asked Questions","Why don't the arguments passed to add_project_link_arguments affect anything?"],"context":{"gi-language":["default"]}},{"url":"Installing.html#installing-as-the-superuser","node_type":"p","page":"Installing","sections":["Installing","Installing as the superuser"],"context":{"gi-language":["default"]}},{"url":"Keyval-module.html#keyvalload","node_type":"p","page":"keyval module","sections":["keyval module","Usage","keyval.load()"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-47-0.html#polkit-support-for-privileged-installation","node_type":"p","page":"Release 0.47","sections":["New features","Polkit support for privileged installation"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-56-0.html#preliminary-aix-support","node_type":"p","page":"Release 0.56.0","sections":["New features","Preliminary AIX support"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-0-62-0.html#new-custom-dependency-for-openssl","node_type":"ul","page":"Release 0.62.0","sections":["New features","New custom dependency for OpenSSL"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#allow-reconfigure-and-wipe-of-empty-builddir","node_type":"p","page":"Release 1.1.0","sections":["New features","Allow --reconfigure and --wipe of empty builddir"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#meson-install-now-supports-userpreferred-root-elevation-tools","node_type":"p","page":"Release 1.1.0","sections":["New features","\nmeson install now supports user-preferred root elevation tools"],"context":{"gi-language":["default"]}},{"url":"Release-notes-for-1-1-0.html#sudo-meson-install-now-drops-privileges-when-rebuilding-targets","node_type":"p","page":"Release 1.1.0","sections":["New features","\nsudo meson install now drops privileges when rebuilding targets"],"context":{"gi-language":["default"]}},{"url":"Rust.html#mixing-generated-and-static-sources","node_type":"p","page":"Rust","sections":["Using Rust with Meson","Mixing Generated and Static sources"],"context":{"gi-language":["default"]}},{"url":"Using-with-Visual-Studio.html#using-with-visual-studio","node_type":"p","page":"Using with Visual Studio","sections":["Using with Visual Studio"],"context":{"gi-language":["default"]}}]});