From 6d5ea0f127e60ca6c7ecc83eff4618111b7c831b Mon Sep 17 00:00:00 2001
From: Robert-L-Turner <37597024+Robert-L-Turner@users.noreply.github.com>
Date: Mon, 22 Nov 2021 19:43:44 +0800
Subject: [PATCH] FIDO2 device removal instructions (#21426)

* man: document FIDO2 device removal

Indicate to users how to remove FIDO2 device in the --fido2-device=path section by setting path to an empty string ("").  Tested on systemd 249 (249.6-3-arch)
---
 man/homectl.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/man/homectl.xml b/man/homectl.xml
index 6ed8e90bf1e..89af3d77c7f 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -376,6 +376,9 @@
         <para>Note that FIDO2 devices suitable for this option must implement the
         <literal>hmac-secret</literal> extension. Most current devices (such as the YubiKey 5 series) do. If
         the extension is not implemented the device cannot be used for unlocking home directories.</para>
+          
+        <para>The FIDO2 device may be subsequently removed by setting the device path to an empty string 
+        (e.g. <command>homectl update $USER --fido2-device=""</command>).</para>
 
         <para>Note that many hardware security tokens implement both FIDO2 and PKCS#11/PIV (and thus may be
         used with either <option>--fido2-device=</option> or <option>--pkcs11-token-uri=</option>), for a
-- 
2.47.3