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 /doc | |
parent | 0c4759fbfd5be481d14ebb8b7c2d085ec649d04d (diff) | |
download | u-boot-2042365acf0e4620b97a9e519430376d15e95d27.tar.gz |
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>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/build/index.rst | 1 | ||||
-rw-r--r-- | doc/build/reproducible.rst | 25 |
2 files changed, 26 insertions, 0 deletions
diff --git a/doc/build/index.rst b/doc/build/index.rst index dc9cde4001..64e66491bd 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 0000000000..5423080633 --- /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) |