diff options
| author | Heinrich Schuchardt <heinrich.schuchardt@canonical.com> | 2023-01-25 19:15:00 +0100 |
|---|---|---|
| committer | Heinrich Schuchardt <heinrich.schuchardt@canonical.com> | 2023-01-27 18:32:00 +0100 |
| commit | 2042365acf0e4620b97a9e519430376d15e95d27 (patch) | |
| tree | e4743017d4e245797bbe4cb791b50a17ab3b22aa | |
| parent | 0c4759fbfd5be481d14ebb8b7c2d085ec649d04d (diff) | |
| download | u-boot-2042365acf0e4620b97a9e519430376d15e95d27.zip u-boot-2042365acf0e4620b97a9e519430376d15e95d27.tar.gz u-boot-2042365acf0e4620b97a9e519430376d15e95d27.tar.bz2 | |
doc: move 'Reproducible builds'
Move the README section to the HTML documentation.
Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
Reviewed-by: Tom Rini <trini@konsulko.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
| -rw-r--r-- | README | 11 | ||||
| -rw-r--r-- | doc/build/index.rst | 1 | ||||
| -rw-r--r-- | doc/build/reproducible.rst | 25 |
3 files changed, 26 insertions, 11 deletions
@@ -1713,17 +1713,6 @@ This firmware often needs to be loaded during U-Boot booting. - CONFIG_SYS_MC_RSV_MEM_ALIGN Define alignment of reserved memory MC requires -Reproducible builds -------------------- - -In order to achieve reproducible builds, timestamps used in the U-Boot build -process have to be set to a fixed value. - -This is done using the SOURCE_DATE_EPOCH environment variable. -SOURCE_DATE_EPOCH is to be set on the build host's shell, not as a configuration -option for U-Boot or an environment variable in U-Boot. - -SOURCE_DATE_EPOCH should be set to a number of seconds since the epoch, in UTC. Building the Software: ====================== diff --git a/doc/build/index.rst b/doc/build/index.rst index dc9cde4..64e6649 100644 --- a/doc/build/index.rst +++ b/doc/build/index.rst @@ -9,6 +9,7 @@ Build U-Boot source gcc clang + reproducible docker tools buildman diff --git a/doc/build/reproducible.rst b/doc/build/reproducible.rst new file mode 100644 index 0000000..5423080 --- /dev/null +++ b/doc/build/reproducible.rst @@ -0,0 +1,25 @@ +Reproducible builds +=================== + +In order to achieve reproducible builds, timestamps used in the U-Boot build +process have to be set to a fixed value. + +This is done using the SOURCE_DATE_EPOCH environment variable which specifies +the number of seconds since 1970-01-01T00:00:00Z. + +Example +------- + +To build the sandbox with 2023-01-01T00:00:00Z as timestamp we can use: + +.. code-block:: bash + + make sandbox_defconfig + SOURCE_DATE_EPOCH=1672531200 make + +This date is shown when we launch U-Boot: + +.. code-block:: console + + ./u-boot -T + U-Boot 2023.01 (Jan 01 2023 - 00:00:00 +0000) |