From c3300bf468bb910ff8e7285337cf85fc47eecd4b Mon Sep 17 00:00:00 2001
From: Managor <42655600+Managor@users.noreply.github.com>
Date: Sun, 25 May 2025 17:14:10 +0300
Subject: [PATCH] fwupdtool: add page, fwupdmgr: refer to fwupdtool and add
 example (#16577)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
---
 pages/linux/fwupdmgr.md  |  9 +++++++--
 pages/linux/fwupdtool.md | 17 +++++++++++++++++
 2 files changed, 24 insertions(+), 2 deletions(-)
 create mode 100644 pages/linux/fwupdtool.md

diff --git a/pages/linux/fwupdmgr.md b/pages/linux/fwupdmgr.md
index 6a8b1bf2ef..7aea3f50b3 100644
--- a/pages/linux/fwupdmgr.md
+++ b/pages/linux/fwupdmgr.md
@@ -1,9 +1,10 @@
 # fwupdmgr
 
 > Update device firmware, including UEFI, using `fwupd`.
-> More information: <https://fwupd.org/>.
+> See also: `fwupdtool`.
+> More information: <https://github.com/fwupd/fwupd/blob/main/src/fwupdmgr.md>.
 
-- Display all devices detected by fwupd:
+- Display all devices detected by `fwupd`:
 
 `fwupdmgr get-devices`
 
@@ -18,3 +19,7 @@
 - Install firmware updates:
 
 `fwupdmgr update`
+
+- Remount `/boot` with more privileges if update complains about a read-only filesystem:
+
+`sudo mount {{[-o|--options]}} uid=1000,gid=1000,umask=0022 {{/dev/sdX}} /boot`
diff --git a/pages/linux/fwupdtool.md b/pages/linux/fwupdtool.md
new file mode 100644
index 0000000000..43070f5af3
--- /dev/null
+++ b/pages/linux/fwupdtool.md
@@ -0,0 +1,17 @@
+# fwupdtool
+
+> Update device firmware manually or manipulate firmware files.
+> See also: `fwupdmgr`.
+> More information: <https://github.com/fwupd/fwupd/blob/main/src/fwupdtool.md>.
+
+- Display all devices detected by `fwupd`:
+
+`fwupdtool get-devices`
+
+- Install firmware from a file:
+
+`fwupdtool install {{path/to/firmware}}`
+
+- Display help:
+
+`fwupdtool {{[-h|--help]}}`