From d203fe67af73ef0a52a248b8b85839359682823b Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Wed, 5 Nov 2025 20:57:31 +0000
Subject:  Advise rngseed -rw at boot

---
 doc/rngseed.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/rngseed.html b/doc/rngseed.html
index d08f56c..cbd29ab 100644
--- a/doc/rngseed.html
+++ b/doc/rngseed.html
@@ -125,6 +125,11 @@ seed file management. </li>
 point of view.
 <tt>rngseed -r</tt> reads from the file (and unlinks it) and writes to the kernel
 RNG. <tt>rngseed -w</tt> reads from the kernel RNG and writes to the file. </li>
+ <li> It is a good idea to use <tt>rngseed -rw</tt> at boot time, rather than
+<tt>rngseed -r</tt>. This ensures that a seed file will be present on next boot
+even if the system doesn't undergo a clean shutdown (e.g. the power fails).
+Of course, this does not preclude running <tt>rngseed -w</tt> in the shutdown
+sequence, so the next boot runs with the freshest possible seed. </li>
  <li> <tt>rngseed</tt> is inspired by Jason Donenfeld's
 <a href="https://git.zx2c4.com/seedrng/about/">seedrng</a> program. It is,
 however, an independent implementation of the same concept. </li>
-- 
cgit v1.3.1