| ... |
... |
@@ -294,8 +294,10 @@ can be viewed in detail in the :ref:`builtin public data <public_builtin>` secti |
|
294
|
294
|
Sandbox
|
|
295
|
295
|
~~~~~~~
|
|
296
|
296
|
Configuration for the build sandbox (other than :ref:`environment variables <format_environment>`)
|
|
297
|
|
-can be placed in the ``sandbox`` configuration. At present, only the
|
|
298
|
|
-UID and GID used by the user in the group can be specified.
|
|
|
297
|
+can be placed in the ``sandbox`` configuration. The UID and GID used by the user
|
|
|
298
|
+in the group can be specified, as well as the desired OS and machine
|
|
|
299
|
+architecture. Possible machine architecture follow the same list as specified in
|
|
|
300
|
+the :ref:`architecture option <project_options_arch>`.
|
|
299
|
301
|
|
|
300
|
302
|
.. code:: yaml
|
|
301
|
303
|
|
| ... |
... |
@@ -311,6 +313,23 @@ you can supply a different uid or gid for the sandbox. Only |
|
311
|
313
|
bwrap-style sandboxes support custom user IDs at the moment, and hence
|
|
312
|
314
|
this will only work on Linux host platforms.
|
|
313
|
315
|
|
|
|
316
|
+.. code:: yaml
|
|
|
317
|
+
|
|
|
318
|
+ # Specify build OS and architecuter
|
|
|
319
|
+ sandbox:
|
|
|
320
|
+ build-os: AIX
|
|
|
321
|
+ build-arch: Power-ISA-BE
|
|
|
322
|
+
|
|
|
323
|
+When building locally, if these don't match the host machine then generally the
|
|
|
324
|
+build will fail. The exception is when the OS is Linux and the architecture
|
|
|
325
|
+specifies an ``x86-32`` build on an ``x86-64`` machine, in which case the
|
|
|
326
|
+``linux32`` command is prepended to the bubblewrap command.
|
|
|
327
|
+
|
|
|
328
|
+When building remotely, the OS and architecture are added to the ``Platform``
|
|
|
329
|
+field in the ``Command`` uploaded. Whether this actually results in a building
|
|
|
330
|
+the element for the desired OS and architecture is dependent on the server
|
|
|
331
|
+having implemented these options the same as buildstream.
|
|
|
332
|
+
|
|
314
|
333
|
.. note::
|
|
315
|
334
|
|
|
316
|
335
|
The ``sandbox`` configuration is available since :ref:`format version 6 <project_format_version>`
|
