From 8b6eb8bd5b9b5fc7e108173e9ba39006e288a035 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Sat, 24 Feb 2024 16:46:39 -0300
Subject: Fix: TPC: additional details

---
 docs/tpc.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/tpc.md b/docs/tpc.md
index 969b5bb..54f707f 100644
--- a/docs/tpc.md
+++ b/docs/tpc.md
@@ -90,12 +90,15 @@ the TPS and setup the base Operating System:
 After installation, make sure to save metadata from the disk layout and LUKS headers, which
 can be useful during recovery procedures.
 
+0. Turn off the cartridge, and then plug it again in the TPC you're using. This will make sure
+   device information is properly refreshed.
+
 1. Write down UUIDS, models and serials from the new disk. Examples:
 
         lsblk $DEVICE -n -o +UUID | keyringer $HYDRA encrypt nodes/$VOLNAME.$DOMAIN/lsblk
         udevadm info --query=all --name=$DEVICE | keyringer $HYDRA encrypt nodes/$VOLNAME.$DOMAIN/udevadm
 
-        # For non-USB disks only
+        # For non-USB and non-microSD disks only
         $SUDO hdparm -I $DEVICE   | keyringer $HYDRA encrypt nodes/$VOLNAME.$DOMAIN/hdparm
         $SUDO smartctl -i $DEVICE | keyringer $HYDRA encrypt nodes/$VOLNAME.$DOMAIN/smartctl
 
@@ -165,6 +168,14 @@ From another system, and with the cartridge mounted:
 
     hydractl sync-tpc $VOLNAME
 
+This might involve a lot of data being transmitted.  If you want `sync-tpc` to
+ignore all your QEMU virtual machine images hosted at `/var/cache/quemu`, setup
+a `.sync-tpc-ignore` like the following:
+
+    $SUDO mkdir -p $DEST/var/cache/qemu
+    $SUDO chown $USER: $DEST/var/cache/qemu
+    touch $DEST/var/cache/qemu/.sync-tpc-ignore
+
 Check the [backups](backups.md) for additional information.
 
 ## Unmounting
-- 
cgit v1.2.3