doc: Mention --check --no-grafts as a way to force-rebuild packages.

* doc/guix.texi (On Trusting Binaries): Document that combining --check and
--no-grafts with 'guix build' forces the rebuild of a package.

Change-Id: I4eb6be04243a52f70d0fc298f76e62f10e3d376e
Co-authored-by: Leo Famulari <leo@famulari.name>
Signed-off-by: Leo Famulari <leo@famulari.name>
This commit is contained in:
Rostislav Svoboda 2025-02-06 23:55:44 +01:00 committed by Leo Famulari
parent 8455e44cbb
commit 8e9bceda87
No known key found for this signature in database
GPG key ID: 6AAC1963757F47FF

View file

@ -29,7 +29,7 @@ Copyright @copyright{} 2014, 2015, 2016 Alex Kost@*
Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@*
Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2014 Pierre-Antoine Rault@*
Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@*
Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021, 2023 Leo Famulari@* Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021, 2023, 2025 Leo Famulari@*
Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Ricardo Wurmus@* Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Ricardo Wurmus@*
Copyright @copyright{} 2016 Ben Woodcroft@* Copyright @copyright{} 2016 Ben Woodcroft@*
Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@* Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@*
@ -136,6 +136,7 @@ Copyright @copyright{} 2024 Troy Figiel@*
Copyright @copyright{} 2024 Sharlatan Hellseher@* Copyright @copyright{} 2024 Sharlatan Hellseher@*
Copyright @copyright{} 2024 45mg@* Copyright @copyright{} 2024 45mg@*
Copyright @copyright{} 2025 Sören Tempel@* Copyright @copyright{} 2025 Sören Tempel@*
Copyright @copyright{} 2025 Rostislav Svoboda@*
Permission is granted to copy, distribute and/or modify this document Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or under the terms of the GNU Free Documentation License, Version 1.3 or
@ -3978,7 +3979,14 @@ finding out about non-deterministic package builds (@pxref{Invoking guix
challenge}). Similarly, the @option{--check} option of @command{guix challenge}). Similarly, the @option{--check} option of @command{guix
build} allows users to check whether previously-installed substitutes build} allows users to check whether previously-installed substitutes
are genuine by rebuilding them locally (@pxref{build-check, are genuine by rebuilding them locally (@pxref{build-check,
@command{guix build --check}}). @command{guix build --check}}). To force a full rebuild of a package
(ignoring security updates via grafts (@pxref{Security Updates}), if any
grafts exist—which is not always the case), use @option{--check}
together with @option{--no-grafts} (@pxref{Common Build Options,
@option{--no-grafts}}). Because grafts are built as their own
derivation, if the package you want to rebuild is subject to being
grafted, merely using @option{--check} will only rebuild the grafting
derivation, and not actually recompile the package.
In the future, we want Guix to have support to publish and retrieve In the future, we want Guix to have support to publish and retrieve
binaries to/from other users, in a peer-to-peer fashion. If you would binaries to/from other users, in a peer-to-peer fashion. If you would